packages icon



 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 26, 2024






 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 26, 2024






 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 26, 2024






 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 26, 2024






 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 26, 2024






 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 26, 2024






 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 26, 2024






 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 26, 2024