NAME

       pymoctool - manipulate Multi-Order Coverage maps

SYNOPSIS

       pymoctool [INPUT] [COMMAND [FILE]] [--output OUTPUT]

DESCRIPTION

       pymoctool  can be used to manupulate Multi-Order Coverage (MOC) tools for the Virtual Observatory.  It is
       a command-line tool and can handle files encoded as FITS, JSON, or ASCII.  The tool maintains builds up a
       MOC stack using union, intersection and subtraction, with the pipeline  processed  in  the  order  it  is
       passed on the command-line.

       Internally pymoctool uses and exposes the the PyMOC library found in the python-pymoc Debian package.

COMMANDS

       --catalog coords.txt [order NN] [radius NN]
              Render  a circles using the flood-fill method on top of the MOC stack.  The input text file should
              be whitespace records containing either RA+Dec pairs or Lat+Lon pairs.

       --help, -h
              Show top-level help

       --id   Set new identifier for MOC stack

       --info, -i
              Display information about the MOC stack

       --intersection
              Intersect another MOC with the existing MOC stack

       --name Set new name for the MOC stack

       --normalize 0-29
              Set the maximum depth order of a MOC in the range 0-29

       --output, -o
              Output filename MOC

       --plot Project and render the MOC as a flattened all-sky map

       --subtract
              Subtract the a MOC from the existing MOC stack

       --version
              Show the backend PyMOC library version number

       Detailed help for individuals commands can be found with pymoctool --help COMMAND

EXAMPLES

       pymoctool foo.fits --output foo.json bar.txt --output both.fits
              Load foo.fits then convert and the save a copy to foo.json perform a  union  merge  with  a  text-
              format MOC called bar.txt and save the result both.fits

AUTHORS

       pymoctool  and  PyMOC were written by Graham Bell with support from the Science and Technology Facilities
       Council, and the East Asian Obsevatory.

       This manual page was written for the  Debian  Project  by  Paul  Sladen  with  support  from  the  German
       Astronomical Virtual Observatory (GAVO) at the University of Heidelberg.

                                                                                                     pymoctool()