As you can see, we need to upgrade `setuptools` to at least `14.3.1` _first_.This is because `healpy` requires it, and pip internally uses `setuptools` too.This may not hold true with future versions of healpy if they get patched.

### Install

Simply run :

```$ python setup.py install```

You might need to be superuser for it to work if you are not in avirtualenv :

- `UnicodeEncodeError` Make sure the directory in which you uncompressed drizzlib does not contain non-ascii characters in its path.

HOW TO USE==========

As a library------------

See `doc/TUTORIAL.md` for a more extensive example.

``` pythonfrom drizzlib import healpix2wcs

# Reads `my_healpix.fits`, extracts a subset of its data described by the# header in `wcs_config.fits`, and writes the result into `my_wcs.fits`.healpix2wcs('my_healpix.fits', header='wcs_config.fits', output='my_wcs.fits')```

As a binary-----------

In the shell, run :

```$ bin/healpix2wcs -h```

or, if you installed the package, simply :

```$ healpix2wcs -h```

It will show you how to use it, which is like this:

```$ healpix2wcs [-h] [-f] <healpix> <header> <out>```

HOW TO DISTRIBUTE=================

Bump the `VERSION`, and then run :

```$ python setup.py sdist```

It will create a source distribution tarball in the `dist` directory.It uses `MANIFEST.in` to exclude files we want to exclude.