home *** CD-ROM | disk | FTP | other *** search
/ The Very Best of Atari Inside / The Very Best of Atari Inside 1.iso / sharew / astronom / starchrt / starchrt.fmt < prev    next >
Encoding:
Text File  |  1988-10-01  |  13.3 KB  |  265 lines
  1.  
  2.  
  3.  
  4.      S✓S✓S✓ST✓T✓T✓TA✓A✓A✓AR✓R✓R✓RC✓C✓C✓CH✓H✓H✓HA✓A✓A✓AR✓R✓R✓RT✓T✓T✓T(✓(✓(✓(1✓1✓1✓1L✓L✓L✓L)✓)✓)✓)            9✓9✓9✓9/✓/✓/✓/2✓2✓2✓22✓2✓2✓2/✓/✓/✓/8✓8✓8✓87✓7✓7✓7 (✓(✓(✓(L✓L✓L✓LO✓O✓O✓OC✓C✓C✓CA✓A✓A✓AL✓L✓L✓L)✓)✓)✓)            S✓S✓S✓ST✓T✓T✓TA✓A✓A✓AR✓R✓R✓RC✓C✓C✓CH✓H✓H✓HA✓A✓A✓AR✓R✓R✓RT✓T✓T✓T(✓(✓(✓(1✓1✓1✓1L✓L✓L✓L)✓)✓)✓)
  5.  
  6.  
  7.  
  8.      N✓N✓N✓NA✓A✓A✓AM✓M✓M✓ME✓E✓E✓E
  9.           stardsp, starpic, starpost, staruplot, startek, stariris,
  10.           starhp, starlaser - print astronomical star charts using
  11.           Yale database.
  12.  
  13.      S✓S✓S✓SY✓Y✓Y✓YN✓N✓N✓NO✓O✓O✓OP✓P✓P✓PS✓S✓S✓SI✓I✓I✓IS✓S✓S✓S
  14.           s✓s✓s✓st✓t✓t✓ta✓a✓a✓ar✓r✓r✓r*✓*✓*✓* RA DE [ scale title maglim lbllim ]
  15.           or
  16.           -✓-✓-✓-c✓c✓c✓c _✓c_✓o_✓n_✓s_✓t_✓e_✓l_✓l_✓a_✓t_✓i_✓o_✓n.✓.✓.✓..✓.✓.✓..✓.✓.✓.
  17.           or
  18.           -✓-✓-✓-r✓r✓r✓r _✓R_✓a -✓-✓-✓-d✓d✓d✓d _✓D_✓l [ -✓-✓-✓-s✓s✓s✓s _✓s_✓c_✓a_✓l_✓e -✓-✓-✓-t✓t✓t✓t _✓t_✓i_✓t_✓l_✓e -✓-✓-✓-m✓m✓m✓m _✓m_✓a_✓g_✓l_✓i_✓m -✓-✓-✓-l✓l✓l✓l _✓l_✓b_✓l_✓l_✓i_✓m
  19.           -✓-✓-✓-g✓g✓g✓g _✓g_✓r_✓k_✓l_✓i_✓m -✓-✓-✓-a✓a✓a✓a (_✓a_✓n_✓n_✓o_✓t_✓a_✓t_✓e) -✓-✓-✓-o✓o✓o✓o (_✓o_✓b_✓j_✓e_✓c_✓t_✓s) -✓-✓-✓-b✓b✓b✓b (_✓b_✓i_✓g_✓c_✓h_✓a_✓r_✓t)
  20.           -✓-✓-✓-f✓f✓f✓f _✓e_✓p_✓h_✓e_✓m._✓s_✓t_✓a_✓r...  -✓-✓-✓-y✓y✓y✓y _✓y_✓a_✓l_✓e._✓s_✓t_✓a_✓r -✓-✓-✓-n✓n✓n✓n _✓m_✓e_✓s_✓s_✓i_✓e_✓r._✓s_✓t_✓a_✓r
  21.           -✓-✓-✓-w✓w✓w✓w _✓p_✓l_✓a_✓n_✓e_✓t._✓s_✓t_✓a_✓r ]
  22.  
  23.      D✓D✓D✓DE✓E✓E✓ES✓S✓S✓SC✓C✓C✓CR✓R✓R✓RI✓I✓I✓IP✓P✓P✓PT✓T✓T✓TI✓I✓I✓IO✓O✓O✓ON✓N✓N✓N
  24.           These programs generate star charts based on data extracted
  25.           from the Yale public domain star catalog.  Output is to the
  26.           terminal (_✓s_✓t_✓a_✓r_✓d_✓s_✓p), Unix PIC file format (_✓s_✓t_✓a_✓r_✓p_✓i_✓c),
  27.           PostScript format (_✓s_✓t_✓a_✓r_✓p_✓o_✓s_✓t), Unix Plot(5) format
  28.           (_✓s_✓t_✓a_✓r_✓u_✓p_✓l_✓o_✓t), Tektronix vector format (_✓s_✓t_✓a_✓r_✓t_✓e_✓k), Silicon
  29.           Graphics Iris format (_✓s_✓t_✓a_✓r_✓i_✓r_✓i_✓s), Hewlett-Packard terminal
  30.           vector format (starhp) or in Hewlett-Packard Laserjet
  31.           printer format (_✓s_✓t_✓a_✓r_✓l_✓a_✓s_✓e_✓r).
  32.  
  33.           Star data is optionally overlayed with other cosmic objects,
  34.           such as planets.  If limiting magnitudes are properly set
  35.           and the Messier database is available, Messier objects and
  36.           some NGC objects are also printed.
  37.  
  38.           The starchart center is specified by two parameters: Right
  39.           Ascension [0.00 to 24.00 hours] and Declination [-90.00 to
  40.           +90.00 degrees].  An optional third parameter defines the
  41.           N/S range of the output window, in degrees of declination.
  42.           Digits after decimal point are taken as minutes:  object
  43.           positions can therefore be taken directly from a star
  44.           catalog.
  45.  
  46.           An optional fourth parameter gives a title.  This conforms
  47.           to the 'old' Yale star chart format.  Two new parameters can
  48.           be added after title, defining the magnitude limit and label
  49.           printing magnitude limit.  These are discussed below.  All
  50.           parameters can be given by using options, which offers more
  51.           flexibility.  Parameters are:
  52.  
  53.           -✓-✓-✓-r✓r✓r✓r   Right ascension.
  54.  
  55.           -✓-✓-✓-d✓d✓d✓d   Declination.
  56.  
  57.           -✓-✓-✓-s✓s✓s✓s   Scale.
  58.  
  59.           -✓-✓-✓-t✓t✓t✓t   Title. All these work as described above. Additional
  60.  
  61.  
  62.  
  63.      Page 1                                         (printed 12/18/87)
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.      S✓S✓S✓ST✓T✓T✓TA✓A✓A✓AR✓R✓R✓RC✓C✓C✓CH✓H✓H✓HA✓A✓A✓AR✓R✓R✓RT✓T✓T✓T(✓(✓(✓(1✓1✓1✓1L✓L✓L✓L)✓)✓)✓)            9✓9✓9✓9/✓/✓/✓/2✓2✓2✓22✓2✓2✓2/✓/✓/✓/8✓8✓8✓87✓7✓7✓7 (✓(✓(✓(L✓L✓L✓LO✓O✓O✓OC✓C✓C✓CA✓A✓A✓AL✓L✓L✓L)✓)✓)✓)            S✓S✓S✓ST✓T✓T✓TA✓A✓A✓AR✓R✓R✓RC✓C✓C✓CH✓H✓H✓HA✓A✓A✓AR✓R✓R✓RT✓T✓T✓T(✓(✓(✓(1✓1✓1✓1L✓L✓L✓L)✓)✓)✓)
  71.  
  72.  
  73.  
  74.                switches:
  75.  
  76.           -✓-✓-✓-m✓m✓m✓m   Star limiting magnitude. This sets limits on the
  77.                faintest stars displayed on the ``master'' view.
  78.                Default limits are device driver dependent (more
  79.                below).  The ``thumbnail'' finder view is set to a
  80.                related limit.
  81.  
  82.           -✓-✓-✓-l✓l✓l✓l   Label limiting magnitude. The new Yale database
  83.                contains both a small set of familiar names (for stars
  84.                and special objects), plus an extensive list of labels
  85.                (Greek Bayer letter or Flamsteed numbers). Star names
  86.                (including planet names) always print for this small
  87.                set. To avoid clutter, the labels may be omitted below
  88.                a cut-off magnitude by specifying this value.
  89.  
  90.           -✓-✓-✓-g✓g✓g✓g   Greek/Flamsteed annotation magnitude. Labels printed
  91.                for stars dimmer than this value will use a Bayer or
  92.                numerical label in favor of a proper name.  The default
  93.                (2.05) includes nearly all well-known proper names
  94.                including Polaris, and excludes but a small number
  95.                (such as Algol). Large values generate charts full of
  96.                obscure Arabian names, small (zero or negative) values
  97.                produce non-verbose charts, eg. ``a'', in Greek where
  98.                possible, instead of ``Sirius''.
  99.  
  100.           -✓-✓-✓-c✓c✓c✓c   A three or four character mnemonic follows, which is a
  101.                search string for a matching line-item entry in the
  102.                file _✓c_✓o_✓n._✓l_✓o_✓c_✓s.  If found, then the initial values for
  103.                Ra, Decl, Scale and Title are taken from that file.
  104.                Because the command line is parsed from left to right,
  105.                subsequent switches might change the scale, title, or
  106.                otherwise fine-tune the new defaults.
  107.  
  108.           -✓-✓-✓-f✓f✓f✓f   A list of files follow, each containing ephemerides in
  109.                the .star format, which will overlay the output. This
  110.                is also useful for generating constellation boundaries,
  111.                Milky Way isophots, and planet or satellite tracks.
  112.                (The .star format additionally includes records for
  113.                vector and text annotation). Files are processed
  114.                sequentially. Thus, order may take on meaning for
  115.                devices which provide a 2-1/2D page description, such
  116.                as PostScript.
  117.  
  118.           -✓-✓-✓-b✓b✓b✓b   This switch provides a single full-page of output,
  119.                without a thumbnail-sized finder chart. The legend
  120.                placard is replaced with a single line banner giving
  121.                title, right ascension, declination and limiting
  122.                magnitude. This mode is useful for the construction of
  123.                atlas pages. Because the page depicts the same vertical
  124.                scale in degrees of declination, the output will cover
  125.                a slightly reduced extent in right ascention.
  126.  
  127.  
  128.  
  129.      Page 2                                         (printed 12/18/87)
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.      S✓S✓S✓ST✓T✓T✓TA✓A✓A✓AR✓R✓R✓RC✓C✓C✓CH✓H✓H✓HA✓A✓A✓AR✓R✓R✓RT✓T✓T✓T(✓(✓(✓(1✓1✓1✓1L✓L✓L✓L)✓)✓)✓)            9✓9✓9✓9/✓/✓/✓/2✓2✓2✓22✓2✓2✓2/✓/✓/✓/8✓8✓8✓87✓7✓7✓7 (✓(✓(✓(L✓L✓L✓LO✓O✓O✓OC✓C✓C✓CA✓A✓A✓AL✓L✓L✓L)✓)✓)✓)            S✓S✓S✓ST✓T✓T✓TA✓A✓A✓AR✓R✓R✓RC✓C✓C✓CH✓H✓H✓HA✓A✓A✓AR✓R✓R✓RT✓T✓T✓T(✓(✓(✓(1✓1✓1✓1L✓L✓L✓L)✓)✓)✓)
  137.  
  138.  
  139.  
  140.           -✓-✓-✓-a✓a✓a✓a   This switch provides annotation-only (text) output: all
  141.                stars and non-stellar objects are omitted (including
  142.                objects normally rendered by using alpha characters).
  143.                Borders and legends are left undisturbed. This feature
  144.                is useful in separating output detail, as when making
  145.                (color) overhead transparencies.
  146.  
  147.           -✓-✓-✓-o✓o✓o✓o   This switch provides object-only output, and is the
  148.                complement of the above switch. When both switches
  149.                appear together, all output is displayed.  This
  150.                resembles the default case (neither switch), except in
  151.                that case object and annotation detail are written
  152.                together. Here the software makes two consecutive
  153.                passes through all datasets and arranges output detail
  154.                to be written with all cosmic objects prefacing all
  155.                related text annotations.  This is useful in providing
  156.                data for PostScript files in which rendering happens in
  157.                a 2-1/2D back-to-front order, thus providing for a
  158.                cleaner overlaying of output.
  159.  
  160.           -✓-✓-✓-y✓y✓y✓y -✓-✓-✓-w✓w✓w✓w -✓-✓-✓-p✓p✓p✓p
  161.                These switches allow for the redefinition of the files
  162.                yale.star, messier.star and planet.star, respectively.
  163.  
  164.      O✓O✓O✓OU✓U✓U✓UT✓T✓T✓TP✓P✓P✓PU✓U✓U✓UT✓T✓T✓T
  165.           The present implementations draw two viewports: a ``master''
  166.           chart plus a ``thumbnail'' overview with low limiting
  167.           magnitude.  Their location and the limiting magnitude is
  168.           specified by records in the device driver, allowing the
  169.           chart layout be tuned on a per-device basis.  In all cases,
  170.           the output is annotated with viewport boundaries, a legend
  171.           and axis labels. Variations are described for the -✓-✓-✓-a✓a✓a✓a -✓-✓-✓-o✓o✓o✓o and
  172.           -✓-✓-✓-b✓b✓b✓b switches, above.
  173.  
  174.           Objects are drawn in glyphs defined by each display driver.
  175.           Vector-only devices rely on the parent module
  176.           ``starimages.c'' to provide shape tables; other devices plot
  177.           special characters (stardsp or starpic) or private symbols
  178.           (PostScript). The latter additionally provides distinctions
  179.           between object subclasses, e.g. planetary vs diffuse nebula.
  180.           The code provides for this generally, creation of new
  181.           glyphs.
  182.  
  183.           Sanson's sinusoidal projection is used to map coordinates.
  184.           This projection preserves both area and linearity in
  185.           Declination (y axis).  It gives good conformality (angle
  186.           correctness) near the equator, so it is useful along the
  187.           Ecliptic.  Lines of RA converge at the poles (unlike
  188.           cylindrical projections), though Cassiopeia and the Dipper
  189.           reproduce well.
  190.  
  191.      E✓E✓E✓EX✓X✓X✓XA✓A✓A✓AM✓M✓M✓MP✓P✓P✓PL✓L✓L✓LE✓E✓E✓ES✓S✓S✓S
  192.  
  193.  
  194.  
  195.      P✓P✓P✓Pa✓a✓a✓ag✓g✓g✓ge✓e✓e✓e 3✓3✓3✓3                                         (✓(✓(✓(p✓p✓p✓pr✓r✓r✓ri✓i✓i✓in✓n✓n✓nt✓t✓t✓te✓e✓e✓ed✓d✓d✓d 1✓1✓1✓12✓2✓2✓2/✓/✓/✓/1✓1✓1✓18✓8✓8✓8/✓/✓/✓/8✓8✓8✓87✓7✓7✓7)✓)✓)✓)
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.      S✓S✓S✓ST✓T✓T✓TA✓A✓A✓AR✓R✓R✓RC✓C✓C✓CH✓H✓H✓HA✓A✓A✓AR✓R✓R✓RT✓T✓T✓T(✓(✓(✓(1✓1✓1✓1L✓L✓L✓L)✓)✓)✓)            9✓9✓9✓9/✓/✓/✓/2✓2✓2✓22✓2✓2✓2/✓/✓/✓/8✓8✓8✓87✓7✓7✓7 (✓(✓(✓(L✓L✓L✓LO✓O✓O✓OC✓C✓C✓CA✓A✓A✓AL✓L✓L✓L)✓)✓)✓)            S✓S✓S✓ST✓T✓T✓TA✓A✓A✓AR✓R✓R✓RC✓C✓C✓CH✓H✓H✓HA✓A✓A✓AR✓R✓R✓RT✓T✓T✓T(✓(✓(✓(1✓1✓1✓1L✓L✓L✓L)✓)✓)✓)
  203.  
  204.  
  205.  
  206.           # Sagittarius: a nice bunch of Messier objects.
  207.           starpost -c sgr -a -o -t Sagittarius >sag.ps
  208.  
  209.           # Orion: the belt lies near 5h40m in RA, just below the CE.
  210.           stardsp 5.32 -5 12 "Trapezium (Orion)" 8 5 | more
  211.  
  212.      F✓F✓F✓FI✓I✓I✓IL✓L✓L✓LE✓E✓E✓ES✓S✓S✓S
  213.           yale.star       stellar information (mandatory)
  214.           messier.star    Messier objects (optional)
  215.           planet.star     Planets (optional)
  216.           con.locs        default mnemonic locations
  217.  
  218.           These default paths can be easily changed in the Makefile.
  219.  
  220.      B✓B✓B✓BU✓U✓U✓UG✓G✓G✓GS✓S✓S✓S
  221.           The present implementation expects _✓y_✓a_✓l_✓e._✓s_✓t_✓a_✓r sorted by
  222.           decreasing magnitude so that output is sequential, and then
  223.           cuts off below a limiting magnitude.  For more detailed
  224.           charts spatial sorting might be more appropriate.  No cutoff
  225.           is performed for other .star files.
  226.  
  227.           If <minutes> part of the parameters is greater than 59 it is
  228.           silently truncated to 59.
  229.  
  230.           All .star file coordinates are for epoch E2000.0.  The
  231.           Messier objects in _✓m_✓e_✓s_✓s_✓i_✓e_✓r._✓s_✓t_✓a_✓r were taken from precessed
  232.           E1975.0 data.  The additional NGC objects were taken from
  233.           data in the star atlas by _✓N_✓o_✓r_✓t_✓o_✓n and precessed from E1950.0.
  234.           Descriptions and accurate magnitude values of all Messier
  235.           objects were taken from the 1988 edition of the Royal
  236.           Astronomical Society of Canada (RASC) handbook.
  237.  
  238.      F✓F✓F✓FU✓U✓U✓UT✓T✓T✓TU✓U✓U✓UR✓R✓R✓RE✓E✓E✓E E✓E✓E✓EX✓X✓X✓XT✓T✓T✓TE✓E✓E✓EN✓N✓N✓NT✓T✓T✓TI✓I✓I✓IO✓O✓O✓ON✓N✓N✓NS✓S✓S✓S
  239.           A -✓-✓-✓-p✓p✓p✓p switch will provide polar plotting; early code attempts
  240.           using Stereographic projection have lacked the ability to
  241.           draw the horizon lines and tick marks correctly. This and
  242.           other extensions are discussed at the end of
  243.           ``starchart.c'', and is suggested reading for anyone wishing
  244.           to enhance the software.
  245.  
  246.      A✓A✓A✓AU✓U✓U✓UT✓T✓T✓TH✓H✓H✓HO✓O✓O✓OR✓R✓R✓R/✓/✓/✓/E✓E✓E✓ED✓D✓D✓DI✓I✓I✓IT✓T✓T✓TO✓O✓O✓OR✓R✓R✓R
  247.           Alan Paeth, University of Waterloo (AWPaeth@watCGL)
  248.  
  249.      M✓M✓M✓MA✓A✓A✓AJ✓J✓J✓JO✓O✓O✓OR✓R✓R✓R C✓C✓C✓CO✓O✓O✓ON✓N✓N✓NT✓T✓T✓TR✓R✓R✓RI✓I✓I✓IB✓B✓B✓BU✓U✓U✓UT✓T✓T✓TO✓O✓O✓OR✓R✓R✓RS✓S✓S✓S
  250.           Petri Launiainen (pl@intrin.FI)
  251.           Jyrki Yli-Nokari (jty@intrin.FI)
  252.           Robert Tidd (inp@violet.berkeley.edu)
  253.           Craig Counterman (ccount@royal.mit.edu)
  254.  
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261.      Page 4                                         (printed 12/18/87)
  262.  
  263.  
  264.  
  265. ə