GAX(1) Version 1.0 GAX(1)
Galaxy Galaxy
May 6, 1998
NAME
gax - Galaxy, astronomy database
SYNOPSIS
gax -rMin,Max -dMin,Max -ennnn.n -unnn -c[!]Con -Cx.. -h
-v|p|a|sMin,Max -x|yMin,Max -C[!]xxx -fx.. -1x.. -mnn -L+ddmmss
-G+dddmmss -E+nn -H+nn -Dmmdd -Yyyyy -zMin,Max -R|T|SMin,Max -V -oout
@file inp
DESCRIPTION
gax is a UNIX command line program used to search and display
astronomical galaxy information with user control of search criteria
and display format.
OPTIONS
There are three kinds of options, 1) query, 2) display, and 3) file.
The query options specify the constraints on selecting items from the
database. The display option controls the report output format. The
file options specify canned file input, optional database output file,
and the database input file. The details of each option is given
below. Note that whenever a Min,Max pair is allowed, either of the
limits may be omitted, however, if the Max is specified then the
separating comma is mandatory for obvious reasons.
-rMin,Max
Specify the minimum and/or maximum right ascension using the
format 'hhmmss'.
-dMin,Max
Specify the minimum and/or maximum declination using the format
'+ddmmss' or '-ddmmss'.
-xMin,Max
Specify the minimum and/or maximum major axis size in minutes of
arc using the format 'nnn.n'.
-yMin,Max
Specify the minimum and/or maximum minor axis size in minutes of
arc using the format 'nnn.n'.
-vMin,Max
Specify the minimum and/or maximum visual magnitude using the
format 'nn.n'.
-pMin,Max
Specify the minimum and/or maximum photographic magnitude using
the format 'nn.n'.
-aMin,Max
- 1 - Formatted: November 27, 2025
GAX(1) Version 1.0 GAX(1)
Galaxy Galaxy
May 6, 1998
Specify the minimum and/or maximum absolute magnitude using the
format 'nn.n'.
-sMin,Max
Specify the minimum and/or maximum surface brightness using the
format 'nn.n'.
-zMin,Max
Specify the minimum and/or maximum recession velocity using the
format 'nnnnn'.
-mMax
Specify the maximum distance from the RA/Dec point in minutes of
arc using the format 'nn'.
-c[!]Con
Specify the constellation to be searched using the 3 character
constellation abbreviation. Multiple -c options are allowed up
to a maximum of 36. If ! is given, the specified constellation
will not be searched. Additional online help is available for
this option using '-hc'
-ONam
Specify the name of a specific object using its catalog
designation. Multiple -O options are allowed up to a maximum of
10. You may have to use quotation marks to obtain the desired
results.
-uMap
Specify the Uranometria 2000 map number to be searched using the
format 'nnn'.
-RMin,Max
Specify the minimum and/or maximum rise time for an object using
the format 'hhmmss'. [not yet implemented]
-TMin,Max
Specify the minimum and/or maximum transit time for an object
using the format 'hhmmss'.
-SMin,Max
Specify the minimum and/or maximum set time for an object using
the format 'hhmmss'. [not yet implemented]
-C[!]cat
Specify the catalog to be searched using the format 'a'. If ! is
given, objects in the specified catalogs will be ignored.
Additional online help is available for this option using '-hC'.
The currently supported catalogs are:
- 2 - Formatted: November 27, 2025
GAX(1) Version 1.0 GAX(1)
Galaxy Galaxy
May 6, 1998
C Catalog FORMAT
- ------- -----------
M Messier Mnnn
N NGC Nnnnna
I IC Innnna
U UGC Unnnnna
U UGCA UAnnnna
G MCG G+nn-nn-nnna
E ESO Ennn-nnna
A ARP Annnna
K MK Knnnna
V VV Vnnnna
-h Print online help. Additional online help for constellation
abbreviations is available using '-hc' and for catalog mnemonics
using '-hC'.
-1Seq
Specify which catalogs are to be searched and in what order. The
format is a sequence of catalog designators. (see '-hC')
-Eele
Specify the observing site elevation in feet.
-Hang
Specify the observing site horizon angle in degrees.
-Llat
Specify the observing site latitude using the format '+ddmmss' or
'-ddmmss'.
-Glon
Specify the observing site longitude using the format '+dddmmss'
for west and '-dddmmss' for east.
-e Epoch Year
-D Date
-Y Year
-V Print version and catalog information
-o Create .gax file
@ Command File
-fFmt
- 3 - Formatted: November 27, 2025
GAX(1) Version 1.0 GAX(1)
Galaxy Galaxy
May 6, 1998
Specify the output report format. The format of this option is a
sequence of characters, each character representing one column of
information in the report. A particular character can appear
more than once in the sequence. The allowable option characters
and their meaning is as follows.
r right ascension
d declination
x major diameter
y minor diameter
b position angle
v visual magnitude
p photograpic magnitude [no data available]
a absolute magnitude [no data available]
s surface brightness
z recession velocity
c constellation
C catalog name
1,2,3,4,5
nth object name
u U2000 map #
R rise time [not yet implemented]
T transit time
S set time [not yet implemented]
e elevation [not yet implemented]
. space
m distance (see -m)
COMMAND EXAMPLES
The following are a few examples of the use of the gax command to
select objects from the database and examples of the use of the report
formatting options.
gax -f1rdxybvuT -ON7331 agc.gax
Quickly locate object NGC 7331 in the database.
NAME 1 RA DEC MAJ MIN PA Mv U2K TTim
------------ ------ ------- ----- ----- --- ---- --- ----
N 7331 223705 +342511 10.2 4.2 171 10.3 123 0329
gax -f1rdxy.v.mT -r223705 -d+342511 -m30 -v14.9
Find all objects within 30' of NGC 7331 that are brighter than
magnitude 14.9.
NAME 1 RA DEC MAJ MIN Mv arc' TTim
------------ ------ ------- ----- ----- ---- ---- ----
N 7319 223603 +335835 1.4 1.1 14.1 30 0328
N 7331 223705 +342511 10.2 4.2 10.3 0 0329
- 4 - Formatted: November 27, 2025
GAX(1) Version 1.0 GAX(1)
Galaxy Galaxy
May 6, 1998
N 7335 223719 +342652 1.3 .6 14.4 3 0329
U 12121 223740 +345049 1.0 .5 14.8 27 0329
N 7340 223744 +342437 .9 .6 14.7 8 0329
223830 +341426 14.9 21 0330
N 7343 223837 +340423 1.0 .8 14.3 28 0330
gax -f1rdxy.v.mT -r223705 -d+342511 -m30 -CN
Find all objects in the NGC catalog that are within 30' of NGC
7331.
NAME 1 RA DEC MAJ MIN Mv arc' TTim
------------ ------ ------- ----- ----- ---- ---- ----
N 7319 223603 +335835 1.4 1.1 14.1 30 0328
N 7320C 223620 +335907 .4 .4 16.7 28 0328
N 7326 223626 +343247 11 0328
N 7325 223632 +342947 8 0328
N 7331 223705 +342511 10.2 4.2 10.3 0 0329
N 7336 223717 +342636 .4 .3 16.8 3 0329
N 7335 223719 +342652 1.3 .6 14.4 3 0329
N 7337 223726 +342224 1.0 .8 15.4 5 0329
N 7340 223744 +342437 .9 .6 14.7 8 0329
N 7343 223837 +340423 1.0 .8 14.3 28 0330
gax -f1rdxy.v.mT -r223705 -d+342511 -m30 -CN
Find all objects in the NGC catalog that are within 30' of NGC
7331 and have a major axis 1' or larger.
NAME 1 RA DEC MAJ MIN Mv arc' TTim
------------ ------ ------- ----- ----- ---- ---- ----
N 7319 223603 +335835 1.4 1.1 14.1 30 0328
N 7331 223705 +342511 10.2 4.2 10.3 0 0329
N 7335 223719 +342652 1.3 .6 14.4 3 0329
N 7337 223726 +342224 1.0 .8 15.4 5 0329
N 7343 223837 +340423 1.0 .8 14.3 28 0330
gax -f1rdxyu.v.mT -u1 -y002.0 agc.gax
Find all objects on Uranometria 2000 map number 1 that have a
minor axis of 2' or larger.
NAME 1 RA DEC MAJ MIN U2K Mv TTim
------------ ------ ------- ----- ----- --- ---- ----
N 2268 071415 +842250 3.3 2.0 1 12.2 1206
- 5 - Formatted: November 27, 2025
GAX(1) Version 1.0 GAX(1)
Galaxy Galaxy
May 6, 1998
N 2276 072713 +854520 2.8 2.7 1 12.0 1219
N 2300 073220 +854231 3.5 2.4 1 12.1 1224
I 512 090351 +853005 2.9 2.3 1 13.0 1355
gax -f1rdxyu.v.mT -u91 -v12.5 agc.gax
Find all objects on Uranometria 2000 map number 91 that are
brighter than magnitude 12.5.
NAME 1 RA DEC MAJ MIN U2K Mv TTim
------------ ------ ------- ----- ----- --- ---- ----
N 404 010926 +354304 3.9 3.9 91 11.2 0601
N 410 011058 +330906 2.3 1.8 91 12.5 0603
N 507 012340 +331522 4.0 4.0 91 12.3 0615
M 33 013350 +303937 68.7 41.6 91 6.2 0625
gax -f1rdxyu.vs.m -r010000,030000 -d+300000,+400000 -s13.0 -x001.0
Find all objects within the square RA [01h00m00s,03h00m00s], Dec
[+30d00m00s,+40h00m00s] that have a surface brightness greater
than magnitude 13.0 and a major axis 1' or larger.
NAME 1 RA DEC MAJ MIN U2K Mv SB
------------ ------ ------- ----- ----- --- ---- ----
I 1652 011456 +315654 1.1 .3 91 14.5 13.0
N 653 014225 +353819 1.5 .2 92 14.3 12.7
N 834 021101 +373959 1.1 .5 92 13.8 12.8
U 1772 021827 +380126 1.0 .5 92 13.9 12.8
N 980 023524 +405211 1.5 .6 62 13.4 13.0
gax -f12rdxyvm -cTri -v12.5 -x001.0 agc.gax
Find all objects in the constellation Triangulum that are
brighter than magnitude 12.5 and have a major axis 1' or larger.
Print out their first two most well know names.
NAME 1 NAME 2 RA DEC MAJ MIN Mv
------------ ------------ ------ ------- ----- ----- ----
M 33 N 598 013350 +303937 68.7 41.6 6.2
I 1727 U 1249 014730 +271952 7.1 2.8 12.0
N 672 U 1256 014753 +272601 7.5 2.6 11.4
N 777 U 1476 020015 +312547 2.8 2.2 12.5
N 784 U 1501 020116 +285038 6.6 1.6 12.1
N 890 U 1823 022201 +331557 2.9 2.3 12.3
N 925 U 1913 022716 +333442 10.9 6.2 10.6
N 949 U 1983 023048 +370809 2.7 1.7 12.4
- 6 - Formatted: November 27, 2025
GAX(1) Version 1.0 GAX(1)
Galaxy Galaxy
May 6, 1998
gax -f1rdxyv -CM -v09.0 agc.gax
Find all objects in the Messier catalog that are brighter than
magnitude 9.0.
NAME 1 RA DEC MAJ MIN Mv
------------ ------ ------- ----- ----- ----
M 110 004022 +414112 19.5 11.5 8.9
M 31 004244 +411609 189.1 61.7 4.3
M 33 013350 +303937 68.7 41.6 6.2
M 81 095533 +690400 24.9 11.5 7.8
M 94 125053 +410709 12.3 10.8 8.9
M 51 132953 +471148 10.8 6.6 8.9
M 83 133700 -295204 13.1 12.2 8.0
M 101 140312 +542102 28.5 28.3 8.2
gax -f1rdxyv -CN -ongc.gax agc.gax
Select all objects in the NGC catalog and write them to a new gax
file called ngc.gax. This allows faster searching of the NGC
catalog by itself.
FILES
agc.gax A galaxy catalog in gax format
FEATURES
The following input arguments to gax are required in the exact format
as shown on this manual page, i.e., you will need to have leading
zeroes. (rdxyOvps)
COPYING
Copyright (C) 1998 Mark Anderson
Permission is granted to make and distribute verbatim copies of this
manual provided the copyright notice and this permission notice are
preserved on all copies.
Permission is granted to copy and distribute modified versions of this
manual under the conditions for verbatim copying, provided that the
entire resulting derived work is distributed under the terms of a
permission notice identical to this one.
Permission is granted to copy and distribute translations of this
manual into another language, under the above conditions for modified
versions, except that this permission notice may be included in
translations approved by the author instead of in the original
English.
- 7 - Formatted: November 27, 2025
GAX(1) Version 1.0 GAX(1)
Galaxy Galaxy
May 6, 1998
AUTHOR
Mark Anderson - manders1@csc.com
SEE ALSO
gac(1),
- 8 - Formatted: November 27, 2025
