This is original README, it is obsolete now.

Installation
------------

* Make sure you have the numpy library installed
  (http://www.stsci.edu/resources/software_hardware/numarray)

* Execute the setup.py script and read the help:
  $ python setup.py install --help
  Once confident with the options, execute:
  $ python setup.py install

* Make sure that the fchart module library  resides in a directory
  that is in your PYTHONPATH. The default settings ensure this.

* Run:
  $ fchart3 m45
  $ ls

  and see what happened

* If there are complaints that certain python modules cannot be found,
  make shure that the directory containing astrocalc.py, revngc.py are
  in your PYTHONPATH environment variable.

  type
  $ man `echo $SHELL | sed -e"s/.*\/\(.*\)/\1/g"`
  if you do not know how to set environment variables.

* fchart --help dumps a short manual to your screen.

That's all.  You can view the output using ghostview, gv, or whatever
postscript viewer you prefer.


Michiel
------------------------------------------------------

*The* manual:

usage: fchart3 [-h] [-o [OUTPUT_DIR]] [-f [OUTPUT_FILE]] [-limdso [LIMITING_MAGNITUDE_DEEPSKY]] [-limstar [LIMITING_MAGNITUDE_STARS]] [-width [WIDTH]] [-size [FIELDSIZE]] [-fmessier] [-fasterism] [-funknown] [-lang [LANGUAGE]] [-sc [SHOW_CATALOGS]]
               [-x [CROSS_MARKS]] [-capt [CAPTION]] [--hide-star-labels] [--hide-flamsteed] [--show-equatorial-grid] [--show-enhanced-milky-way] [--show-nebula-outlines]
               [--hide-mag-scale-legend] [--hide-map-scale-legend] [--hide-map-orientation-legend] [--show-dso-legend] [--show-coords-legend] [--hide-field-border]
               [-mx] [-my]
               [--color-background BACKGROUND_COLOR] [--color-draw DRAW_COLOR] [--color-label LABEL_COLOR] [--star-colors] [--color-constellation-lines CONSTELLATION_LINES_COLOR] [--color-constellation-border CONSTELLATION_BORDER_COLOR] [--color-deepsky DSO_COLOR]
               [--color-nebula [NEBULA_COLOR]] [--color-galaxy [GALAXY_COLOR]] [--color-star-cluster [STAR_CLUSTER_COLOR]] [--color-galaxy-cluster [GALAXY_CLUSTER_COLOR]] [--color-milky_way [MILKY_WAY_COLOR]] [--color-grid [GRID_COLOR]]
               [--linewidth-constellation [CONSTELLATION_LINEWIDTH]] [--linewidth-constellation-border [constellation_border_linewidth]] [--linewidth-nebula [NEBULA_LINEWIDTH]] [--linewidth-open-cluster [OPEN_CLUSTER_LINEWIDTH]]
               [--linewidth-deepsky [DSO_LINEWIDTH]] [--linewidth-galaxy-cluster [GALAXY_CLUSTER_LINEWIDTH]] [--linewidth-milky-way [MILKY_WAY_LINEWIDTH]]
               [--linewidth-legend [LEGEND_LINEWIDTH]] [--linewidth-grid [GRID_LINEWIDTH]] [--no-margin]
               [--font FONT] [--font-size FONT_SIZE] [--legend_font_scale LEGEND_FONT_SCALE]
               [--FOV-telrad]
               [--extra-data-dir EXTRA_DATA_DIR]
               [-v]
               [sourcelist ...]

fchart3

positional arguments:
  sourcelist

optional arguments:
  -h, --help            show this help message and exit
  -o [OUTPUT_DIR], --output-dir [OUTPUT_DIR]
                        Specify the output directory (default: .)
  -f [OUTPUT_FILE], --output-file [OUTPUT_FILE]
                        Specify output file name. (default: name of dso object). Image format is defined by extension.Supported format/extensions are pdf, png and svg.
  -limdso [LIMITING_MAGNITUDE_DEEPSKY]
                        Deepsky limiting magnitude (default: 12.5)
  -limstar [LIMITING_MAGNITUDE_STARS]
                        Stellar limiting magnitude (default: 13.8)
  -usno-nomad [USNO_NOMAD_FILE]
                        Path to USNO NOMAD catalog (file USNO-NOMAD-1e8.dat)
  -width [WIDTH]        Width of the drawing area in mm.
  -size [FIELDSIZE]     Diameter of the field of view in degrees (default: 7.0)
  -fmessier, --force-messier
                        Select all Messier objects, regardless of the limiting magnitude for deepsky objects
  -fasterism, --force-asterisms
                        Force plotting of  asterisms in map. By default, only "Messier" asterisms are plotted.All others are ignored. The default setting helps cleaning up especially Virgo cluster maps.
  -funknown, --force-unknown
                        By default, objects in external galaxies are plotted only if their magnitude is known and lower than the limiting magnitude of deepsky objects. If this option is given, also objects in external galaxies of which the magnitude is not known are plotted. This option will clutter some galaxies like M 101 and NGC 4559.
  -lang [LANGUAGE], --language [LANGUAGE]
                        Specify language on the maps, either 'en','es, 'fr', 'nl' (default: en)
  -sc [SHOW_CATALOGS], --show-catalogs [SHOW_CATALOGS]
                        Comma separated list of additional catalogs to be show on the map. (e.g. LBN).
  -x [CROSS_MARKS], --add-cross [CROSS_MARKS]
                        Add a cross in the map at a specified position. The format of the argument of this option is: "rah:ram:ras,+/-decd:decm:decs,label,labelposition" For example: -x"20:35:25.4,+60:07:17.7,SN,t" for the supernova sn2004et in NGC 6946. The label position can be 't' for top, 'b' for bottom, 'l' for left, or 'r' for right. The label and label position may be omitted.
  -capt [CAPTION], --caption [CAPTION]
                        Force a specific caption for the maps. All maps will get the same caption.
  --hide-star-labels    Hide star labels.
  --hide-flamsteed      Hide Flamsteed designation.
  --hide-mag-scale-legend
                        Hide magnitude scale legend.
  --hide-map-scale-legend
                        Hide map scale legend.
  --hide-map-orientation-legend
                        Hide orientation legend.
  --show-dso-legend     Show deepsky object legend.
  --show-equatorial-grid
                        Show equatorial grid.
  --show-enhanced-milky-way
                        Show enhanced milky way.
  --show-nebula-outlines
                        Show nebula outlines
  --show-coords-legend  Show coordinations legend.
  --hide-field-border   Hide field border.
  --FOV-telrad          Show telrad circles at FOV.
  -mx, --mirror-x       Mirror in x axis.
  -my, --mirror-y       Mirror in y axis.
  --star-colors         Colorify stars according spectral type.
  --color-background [BACKGROUND_COLOR]
                        Background color. (default white)
  --color-draw [DRAW_COLOR]
                        Drawing color for stars. (default black)
  --color-label [LABEL_COLOR]
                        Label color. (default black)
  --color-constellation-lines [CONSTELLATION_LINES_COLOR]
                        Constellation border color.
  --color-constellation-border [CONSTELLATION_BORDER_COLOR]
                        Constellation lines color.
  --color-deepsky [DSO_COLOR]
                        Unclassified deepsky color.
  --color-nebula [NEBULA_COLOR]
                        Nebula color.
  --color-galaxy [GALAXY_COLOR]
                        Galaxy color.
  --color-star-cluster [STAR_CLUSTER_COLOR]
                        Star cluster color.
  --color-galaxy-cluster [GALAXY_CLUSTER_COLOR]
                        Galaxy cluster color.
  --color-milky_way [MILKY_WAY_COLOR]
                        Milky way color.
  --color-grid GRID_COLOR
                        Star cluster color.
  --linewidth-constellation [CONSTELLATION_LINEWIDTH]
                        Constellation line width (default: 0.5)
  --linewidth-constellation-border [constellation_border_linewidth]
                        Constellation border line width (default: 0.2)
  --linewidth-nebula [NEBULA_LINEWIDTH]
                        Nebula line width (default: 0.3)
  --linewidth-open-cluster [OPEN_CLUSTER_LINEWIDTH]
                        Line width of open cluster (default: 0.3)
  --linewidth-deepsky [DSO_LINEWIDTH]
                        Line width of open cluster (default: 0.2)
  --linewidth-galaxy-cluster [GALAXY_CLUSTER_LINEWIDTH]
                        Line width of galaxy cluster (default: 0.2)
  --linewidth-milky-way [MILKY_WAY_LINEWIDTH]
                        Line width of Milky Way (default: 0.2)
  --linewidth-legend [LEGEND_LINEWIDTH]
                        Line width of open cluster (default: 0.3)
  --linewidth-grid [GRID_LINEWIDTH]
                        Line width of equatorial grid (default: 0.2)
  --no-margin           Star cluster color.
  --font FONT           Font (Arial)
  --font-size FONT_SIZE
  --extra-data-dir      Path to extra data files (Stellarium star catalogues)
                        Font size
  --legend_font_scale LEGEND_FONT_SCALE
                        Scale of font used in legend related to chart font size.
  -v, --version         display version information and exit.

Sourcenames:
   Valid sourcenames are for example:
   - NGC891, NgC891, n891 or 891 for NGC objects
   - IC1396, i1396, iC1396, I1396 for IC objects
   - m110, M3 for Messier objects
   - "9:35:00.8,-34:15:33,SomeCaption" for other positions

   There is one special sourcename, which is "allmessier". When this name
   is encountered, fchart dumps maps of all messier objects to the output
   directory.

------------------------------------------------------
Catalogs included: HnSky

Preferred names:
M
NGC
IC
other

All catalogs:
Abell      - George Abell (planetary nebulae and galaxy clusters)
ADS        - Aitken Double Star catalog
AM         - Arp-Madore (globular clusters)
Antalova   - (open clusters)
Ap         - Apriamasvili (planetary nebulae)
Arp        - Halton Arp (interacting galaxies)
Bark       - Barkhatova (open clusters)
B          - Barnard (dark nebulae)
Basel      - (open clusters)
BD         - Bonner Durchmusterung (stars)
Berk       - Berkeley (open clusters)
Be         - Bernes (dark nebulae)
Biur       - Biurakan (open clusters)
Blanco     - (open clusters)
Bochum     - (open clusters)
Ced        - Cederblad (bright nebulae)
Cr         - Collinder (open clusters)
Czernik    - (open clusters)
DDO        - David Dunlap Observatory (dwarf galaxies)
Do         - Dolidze (open clusters)
DoDz       - Dolidze-Dzimselejsvili (open clusters)
Dun        - Dunlop (globular clusters)
Fein       - Feinstein (open clusters)
Frolov     - (open clusters)
Gum        - (bright nebulae)
H          - William Herschel (globular clusters)
Haffner    - (open clusters)
Harvard    - (open clusters)
He         - Henize (planetary nebulae)
Hogg       - (open clusters)
HP         - Haute Provence (globular clusters)
Hu         - Humason (planetary nebulae)
IC         - 1st and 2nd Index Catalogs to the NGC
                  (All types of objects except dark nebulae)
Isk        - Iskudarian (open clusters)
J          - Jonckheere (planetary nebulae)
K          - Kohoutek (planetary nebulae)
King       - (open clusters)
Kr         - Krasnogorskaja (planetary nebulae)
Lac        - Lacaille (globular clusters)
Loden      - (open clusters)
LDN        - Lynds (dark nebulae)
Lynga      - (open clusters)
M          - Messier (all types of objects except dark nebula)
MCG        - Morphological Catalog of Galaxies
Me         - Merrill (plantary nebulae)
Mrk        - Markarian (open clusters and galaxies)
Mel        - Melotte (open clusters)
M1 thru M4 - Minkowski (planetary nebulae)
NGC        - New General Catalog of Nebulae & Clusters of Stars.
                  (All types of objects except dark nebulae)
Pal        - Palomar (globular clusters)
PC         - Peimbert and Costero (planetary nebulae)
Pismis     - (open clusters)
PK         - Perek & Kohoutek (planetary nebulae)
RCW        - Rodgers, Campbell, & Whiteoak (bright nebulae)
Roslund    - (open clusters)
Ru         - Ruprecht (open clusters)
Sa         - Sandqvist (dark nebulae)
Sher       - (open clusters)
Sh         - Sharpless (bright nebulae)
SL         - Sandqvist & Lindroos (dark nebulae)
SL         - Shapley & Lindsay (clusters in LMC)
Steph      - Stephenson (open clusters)
Stock      - (open clusters)
Ter        - Terzan (globular clusters)
Tombaugh   - (open clusters)
Ton        - Tonantzintla (globular clusters)
Tr         - Trumpler (open clusters)
UA         - Catalog of selected Non-UGC galaxies
UGC        - Uppsala General Catalog (galaxies)
UKS        - United Kingdom Schmidt (globular clusters)
Upgren     - (open clusters)
VV         - Vorontsov-Velyaminov (interacting galaxies)
vdB        - van den Bergh (open clusters, bright nebulae)
vdBH       - van den Bergh & Herbst (bright nebulae)
vdB-Ha     - van den Bergh-Hagen (open clusters)
Vy         - Vyssotsky (planetary nebulae)
Waterloo   - (open clusters)
Westr      - Westerlund (open clusters)
Zw         - Zwicky (galaxies)
