<commit_before>geoutil
=======

Utilities for working with objects from the geometry subpackage of `shapely
<https://github.com/Toblerity/Shapely>`_.

This package defines a custom data structure called a *geoset* that enables
basic grouping and attribution of objects from `shapely.geometry`. The
geoset structure is implemented using nested classes: `Geo` instances are
stored in `Item` instances, and `Item` instances are stored in a `Geoset`
instance. See the `Geoset` class for a full description of the geoset
model.

This package also contains the `geosetxml` module for interfacing with the
`Geoset` class. It defines the *geoset XML format*, an XML representation
of the geoset data structure (see `geosetxml.toxml`).

There are also some functions for processing `shapely.geometry.Polygon`
instances.

`geoutil` depends on the following packages:

- `astropy <http://www.astropy.org>`_
- `numpy <http://www.numpy.org>`_
- `shapely <https://github.com/Toblerity/Shapely>`_

Documentation build instructions (requires `sphinx <http://sphinx-doc.org/>`_
and `numpydoc <https://github.com/numpy/numpydoc>`_)::

  cd geoutil/docs
  make html
  open _build/html/index.html<commit_msg>Replaced with the correct README<commit_after>imgpoly
=======

Determine footprints for FITS images.

This package is centered on the `find_borders` function, which calculates
the border of an input boolean array using a technique inspired by the
`marching squares algorithm <wikipedia.org/wiki/Marching_squares>`_. This
is particularly useful for astronomical CCD images, which often have a
"vignette" of non-data pixels around the edge.

A small set of helper functions is provided, each tailored to FITS images
from a particular instrument. HST/ACS/WFC, HST/WFC3, and GALEX are
currently supported. The main difference between analyses for any two
instruments is how the boolean arrays (data pixels vs. border pixels) for
`find_borders` are constructed as different detectors have different
shapes.

`imgpoly` depends on the following packages:

- `astropy <http://www.astropy.org>`_
- `numpy <http://www.numpy.org>`_
- `shapely <https://github.com/Toblerity/Shapely>`_
- `geoutil <https://github.com/jesaerys/geoutil>`_

Documentation build instructions (requires `sphinx <http://sphinx-doc.org/>`_
and `numpydoc <https://github.com/numpy/numpydoc>`_)::

  cd imgpoly/docs
  make html
  open _build/html/index.html
{'fraction_non_alphanumeric': 0.09808811305070657, 'fraction_numerical': 0.00041562759767248546, 'mean_word_length': 4.972704714640199, 'pattern_counts': {'":': 0, '<': 16, '<?xml version=': 0, '>': 16, 'https://': 6, 'lorem ipsum': 0, 'www.': 4, 'xml': 3}, 'pii_count': 0, 'substrings_counts': 0, 'word_list_counts': {'cursed_substrings.json': 0, 'profanity_word_list.json': 0, 'sexual_word_list.json': 0, 'zh_pornsignals.json': 0}}
{'dir': 'git-commits-cleaned', 'id': '4059233', 'n_tokens_mistral': 765, 'n_tokens_neox': 729, 'n_words': 271}