-
Notifications
You must be signed in to change notification settings - Fork 5
/
README
263 lines (241 loc) · 12.4 KB
/
README
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
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)