YMSCRIPT: PYTHON+NUMPY REIMPLEMENTATION OF SOME IMSCRIPT FUNCTIONS
==================================================================

Just some handy functions from imscript implemented in python+numpy,
with similar semantics.


DOCUMENTATION
-------------

Install with "pip install ymscript"

- qauto : quantize an image to 8 bits
- sauto : quantize and apply a signed palette
- vauto : quantize a vector field to rgb
- translate,rotate,shearx,sheary : resamplers using exact fourier interpolation
- zoomin, zoomout : rescalers with various techniques
- random : random images of various distributions
- backflow : warp an image by a vector field
- lap,grad,div : differential operators (by finite differences)
- ntiply : enlarge pixels by an integer factor
- blur : blur by various kernels (gauss,cauchy,laplace,riesz,disk,square)
- gauss : blur using the gaussian semigroup
- riesz : riesz semigroup
- laplace : smooth interpolation
- poisson : poisson editing

There are no explicit requirements, but most functions require numpy or some
numpy-mocking arrays.  The requirements are "soft".  The package will install
correctly no matter what, but some functions will fail at runtime if their
requirements are not satisfied.

The differential operators require imgra.

The blur requires numpy.fft

Poisson editing requires imgra and scipy.linalg

Suggestion: for shell use, do alias y="python `locate ymscript.py`" and then
cat lena.png | y blur | y laplacian | ...


RELEASING
---------

To update the pypi hub, you need an account on pypi, and then run the following
commands:

        # update version number on file setup.py
        # update version number on file ymscript.py
	python -m build
	python -m twine upload dist/ymscript-X-py3-none-any.whl
	rm -rf build dist ymscript.egg-info