     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:  April 18, 2001

     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:  April 18, 2001

     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:  April 18, 2001

     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:  April 18, 2001

     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:  April 18, 2001

     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:  April 18, 2001

     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:  April 18, 2001

     GAX(1)                          Version 1.0                          GAX(1)
     Galaxy                                                               Galaxy

                                     May 6, 1998

     AUTHOR
          Mark Anderson - manders1@csc.com

     SEE ALSO
          gac(1),

                                        - 8 -         Formatted:  April 18, 2001