home *** CD-ROM | disk | FTP | other *** search
/ Usenet 1994 October / usenetsourcesnewsgroupsinfomagicoctober1994disk2.iso / misc / volume11 / starchart / part30 < prev    next >
Text File  |  1990-03-25  |  44KB  |  1,153 lines
  1. Newsgroups: comp.sources.misc
  2. subject: v11i058: starchart 3.2 Part 30/32
  3. from: ccount@ATHENA.MIT.EDU
  4. Sender: allbery@uunet.UU.NET (Brandon S. Allbery - comp.sources.misc)
  5.  
  6. Posting-number: Volume 11, Issue 58
  7. Submitted-by: ccount@ATHENA.MIT.EDU
  8. Archive-name: starchart/part30
  9.  
  10. #! /bin/sh
  11. # This is a shell archive.  Remove anything before this line, then unpack
  12. # it by saving it into a file and typing "sh file".  To overwrite existing
  13. # files, type "sh file -c".  You can also feed this as standard input via
  14. # unshar, or by typing "sh <file", e.g..  If this archive is complete, you
  15. # will see the following message at the end:
  16. #        "End of archive 30 (of 32)."
  17. # Contents:  doc/as.texi.ab
  18. PATH=/bin:/usr/bin:/usr/ucb ; export PATH
  19. if test -f 'doc/as.texi.ab' -a "${1}" != "-c" ; then 
  20.   echo shar: Will not clobber existing file \"'doc/as.texi.ab'\"
  21. else
  22. echo shar: Extracting \"'doc/as.texi.ab'\" \(41161 characters\)
  23. sed "s/^X//" >'doc/as.texi.ab' <<'END_OF_FILE'
  24. X                   the file is searched for an entry
  25. X                   corresponding to that mnemonic: the entry
  26. X                   specifies the RA DEC Scale and Title.
  27. X-v    float float           Variable finder: labels stars with their
  28. X                   magnitudes if they are within
  29. X                   arg2 mags. of arg1
  30. X-x    float float [float float]  X grid: grid in RA and DEC,
  31. X                   spacing arg1 and arg2, origin at arg3 arg4
  32. X-e    string               Extra: chart control file.
  33. X-u    --none--           User input.  Allow keyboard-based user input
  34. X-a    string               Additional Argument string:
  35. X                   passed to driver for additional control.
  36. X@end ifinfo
  37. X
  38. X@node Control and specification files, Interaction, Command line, Charts
  39. X@comment  node-name,  next,  previous,  up
  40. X@subsection Control and Specification Files
  41. X@cindex starrc
  42. X@cindex mapwin
  43. X
  44. XThe controlling variables of the chart are set by default at compile
  45. Xtime, and many may be overridden by command line arguments.  However,
  46. Xmore control is afforded by @samp{.starrc} and @samp{-e @var{extra}}
  47. Xfiles.  The starchart programs attempt to read an initialization file,
  48. Xwhose name is set at compile time (default @file{./.starrc}).
  49. XAdditional such files may be read through the @samp{-e} commandline
  50. Xargument.  The file contains lines of the form @samp{@var{variable}
  51. X@var{value}} or @samp{@var{variable}=@var{value}}, with comments
  52. Xbeginning with @samp{#} ignored.  The variables and their values are
  53. Xgiven below.  These definitions reset the values of program variables,
  54. Xoverriding their current value.  These may in turn be overridden by
  55. Xlater command line arguments or additional @samp{.starrc} files
  56. Xspecified with @samp{-e}.  Any variables not understood by the main
  57. Xprogram are passed to a driver specific function which may interpret it.
  58. X
  59. X@tex
  60. X{
  61. X\settabs 4 \columns
  62. X\+Variable &    Value type(s) & comment \cr
  63. X\+ra &        float &    \# same as -r \cr
  64. X\+dec &        float &    \# same as -d \cr
  65. X\+scale &    float &    \# same as -s \cr
  66. X\+title &    string &    \# same as -t \cr
  67. X\+findconst &    string &    \# same as first argument of -c \cr
  68. X\+constfile &    string &    \# same as second argument of -c \cr
  69. X\+namelim &    float &    \# same as -l \cr
  70. X\+lbllim &    float &    \# same as -l \cr
  71. X\+maglim &    float &    \# same as -m \cr
  72. X\+gklim &    float &    \# same as -g \cr
  73. X\+starfile &    string &    \# same as -y \cr
  74. X\+indexfile &    string &    \# same as -h \cr
  75. X\+nebfile &    string &    \# same as -n \cr
  76. X\+planetfile &    string &    \# same as -w \cr
  77. X\+userfile &    string &    \# same as -f \cr
  78. X\+mapfile &    string string&    \# set mapfile array in main routines: \cr
  79. X\+& &                    \#       sets elements in order \cr
  80. X\+& &                    \#       overrides previous settings \cr
  81. X\+& &                    \#    overrides default yale.star, etc. \cr
  82. X\+& &                    \#    second arg is type of file \cr
  83. X\+& &                    \#    as specified in index.indx \cr
  84. X\+boundfile &    string &    \# sets file for ``boundaries'' layer \cr
  85. X\+patternfile &    string &    \# sets file for ``patterns'' layer \cr
  86. X\+constlnamefile &    string &    \# sets file for ``constlnames'' layer \cr
  87. X\+layers &        string &    \# same as all\_layer: \cr
  88. X\+all\_layer &        string &    \# sets array of layers in main routines: \cr
  89. X\+& &                    \#     sets elements in order \cr
  90. X\+& &                    \#     overrides previous settings \cr
  91. X\+& &                    \# possible values : \cr
  92. X\+& &                    \# ``outline'' ``ra\_grid'' ``dec\_grid'' \cr
  93. X\+& &                    \# ``ecliptic'' ``boundaries'' ``patterns'' \cr
  94. X\+& &                    \# ``constlnames'' ``allfiles'' ``allglyphs'' \cr
  95. X\+& &                    \# ``allnames'' ``allmaglbls'' ``allvectors'' \cr
  96. X\+& &                    \# ``allareas'' ``legends'' \cr
  97. X\+polarmode &        logical &    \# same as -p if logical is nonzero or is TRUE \cr
  98. X\+bigflag &        logical &    \# same as -b if logical is nonzero or is TRUE \cr
  99. X\+projection\_mode &    string &    \# set projection mode:\cr
  100. X\+& &                    \# may be ``sansons'', ``stereographic'',\cr
  101. X\+& &                     \# ``orthographic'', ``gnomonic'' \cr
  102. X\+& &                     \# or ``rectangular'' \cr
  103. X\+invert &    logical &    \# same as -i if logical is nonzero or is TRUE \cr
  104. X\+precess\_to &  float    &      \# Precess to equinox and ecliptic of year.\cr
  105. X\+chart\_type &        string &    \# set chart type: ``fullpage'' or ``threepart'' \cr
  106. X\+& &                    \# ``threepart'' is default: Large window, \cr
  107. X\+& &                    \# thumbnail, and legend \cr
  108. X\+& &                    \# ``fullpage'' is same as -b flag \cr
  109. X\+vrange &    float float &        \# same as -v \cr
  110. X\+vmags &    float float &        \# set magnitude labeling maximum \cr
  111. X\+&    &                \# and minimum magnitudes \cr
  112. X\+grid &    float float [float float] & \# same as -x \cr
  113. X\+nogrid &    logical &    \# turn off display of all grids \cr
  114. X\+nogrid\_ra &    logical &    \# turn off display of RA grid \cr
  115. X\+nogrid\_dec &    logical    &    \# turn off display of DEC grid \cr
  116. X\+nomaglbls &    logical &    \# turn off display of magnitude labels \cr
  117. X\+drivercontrol &    string &    \# same as -a flag \cr
  118. X\+driver\_control &    string &    \# same as -a flag \cr
  119. X\+additional &         string &    \# same as -a flag \cr
  120. X
  121. X\+For interactive control, the following commands are also active:\cr
  122. X
  123. X\+exit &        --none-- &      \# Exit the program\cr
  124. X\+quit &        --none-- &      \# Exit the program\cr
  125. X\+end\_input &    --none-- &      \# End input, display chart\cr
  126. X\+done\_input &    --none-- &      \# End input, display chart\cr
  127. X\+done &        --none-- &      \# End input, display chart\cr
  128. X\+draw &        --none-- &      \# End input, display chart\cr
  129. X\+help &        --none-- &      \# Give help\cr
  130. X\+? &            --none-- &      \# Give help\cr
  131. X\+show &        --none-- &      \# Show value of variables\cr
  132. X\+write\_rc\_file &    string &      \# Write current state to .starrc file\cr
  133. X\+write\_mapwin\_file &  string &      \# Write detailed specification of\cr
  134. X\+&&                  \# chart to given filename\cr
  135. X\+read\_mapwin\_file &   string &      \# Read detailed specification of\cr
  136. X\+&&                  \# chart from given filename\cr
  137. X}
  138. X@end tex
  139. X@ifinfo
  140. X@comment .nf .br  , .fi
  141. XVariable        Value type(s)     comment
  142. Xra            float      # same as -r
  143. Xdec            float      # same as -d
  144. Xscale            float      # same as -s
  145. Xtitle            string      # same as -t
  146. Xfindconst        string      # same as first argument of -c
  147. Xconstfile        string      # same as second argument of -c
  148. Xnamelim            float      # same as -l
  149. Xlbllim            float      # same as -l
  150. Xmaglim            float      # same as -m
  151. Xgklim            float      # same as -g
  152. Xstarfile        string      # same as -y
  153. Xindexfile        string      # same as -h
  154. Xnebfile            string      # same as -n
  155. Xplanetfile        string      # same as -w
  156. Xuserfile        string      # same as -f
  157. Xmapfile            string string # set mapfile array in main routines:
  158. X                  #       sets elements in order
  159. X                  #       overrides previous settings
  160. X                  #    overrides default yale.star, etc.
  161. X                  #    second arg is type of file
  162. X                  #    as specified in index.indx
  163. Xboundfile        string      # sets file for "boundaries" layer
  164. Xpatternfile        string      # sets file for "patterns" layer
  165. Xconstlnamefile        string      # sets file for "constlnames" layer
  166. Xlayers            string      # same as all_layer:
  167. Xall_layer        string      # sets array of layers in main routines:
  168. X                  #     sets elements in order
  169. X                  #     overrides previous settings
  170. X                  # possible values :
  171. X                  # "outline" "ra_grid" "dec_grid" "ecliptic"
  172. X                  # "boundaries" "patterns" "constlnames"
  173. X                  # "allfiles" "allglyphs" "allnames"
  174. X                  # "allmaglbls" "allvectors" "allareas"
  175. X                  # "legends"
  176. Xpolarmode        logical      # same as -p if logical is nonzero or is TRUE
  177. Xbigflag            logical      # same as -b if logical is nonzero or is TRUE
  178. Xprojection_mode        string      # set projection mode
  179. X                  # may be "sansons", "stereographic"
  180. X                  # "orthographic", "gnomonic"
  181. X                  # or "rectangular"
  182. Xinvert            logical      # same as -i if logical is nonzero or is TRUE
  183. Xprecess_to          float      # Precess to equinox and ecliptic of year.
  184. Xchart_type        string      # set chart type: "fullpage" or "threepart"
  185. X                  # "threepart" is default: Large window,
  186. X                  # thumbnail, and legend
  187. X                  # "fullpage" is same as -b flag
  188. Xvrange            float float      # same as -v
  189. Xvmags            float float      # set magnitude labeling maximum
  190. X                  # and minimum magnitudes
  191. Xgrid            float float [float float]
  192. X                  # same as -x
  193. Xnogrid            logical      # turn off display of all grids
  194. Xnogrid_ra        logical      # turn off display of RA grid
  195. Xnogrid_dec        logical      # turn off display of DEC grid
  196. Xnomaglbls        logical      # turn off display of magnitude labels
  197. Xdrivercontrol        string      # same as -a flag
  198. Xdriver_control        string      # same as -a flag
  199. Xadditional        string      # same as -a flag
  200. X
  201. XFor interactive control, the following commands are also active:
  202. X
  203. Xexit            --none--      # Exit the program
  204. Xquit            --none--      # Exit the program
  205. Xend_input        --none--      # End input, display chart
  206. Xdone_input        --none--      # End input, display chart
  207. Xdone            --none--      # End input, display chart
  208. Xdraw            --none--      # End input, display chart
  209. Xhelp            --none--      # Give help
  210. X?            --none--      # Give help
  211. Xshow            --none--      # Show value of variables
  212. Xwrite_rc_file        string      # Write current state to .starrc file
  213. Xwrite_mapwin_file   string      # Write detailed specification of
  214. X                  # chart to given filename
  215. Xread_mapwin_file    string      # Read detailed specification of
  216. X                  # chart from given filename
  217. X@end ifinfo
  218. X
  219. X@node Interaction, Standard data files, Control and specification files, User controls
  220. X@comment  node-name,  next,  previous,  up
  221. X@subsection Interactive Controls
  222. X@cindex starchart interactive
  223. X@cindex interactive starchart
  224. X
  225. XThe @samp{-u} option activates interactive mode, where the same commands
  226. Xas in the @samp{.starrc} file may be typed to control the program
  227. Xoptions.  In addition, @samp{end_input} ends interactive input and draws
  228. Xthe chart.  After the chart is drawn, control returns to the keyboard.
  229. XThe @samp{quit} command exits the program.  The command @samp{show}
  230. Xshows the current state of the control variables.  The command
  231. X@samp{help} may be used to get a brief description of the commands and
  232. Xcontrols available.
  233. X
  234. XSome, especially window based, versions will allow the user final
  235. Xcontrol over each map of the chart.  The chart is specified by an
  236. Xarray of large @b{C} structures, one for each map on the page.  The
  237. X@samp{mapwin} file contains the values in this structure.  Advanced
  238. Xinteractive versions of starchart, such as @code{starXaw}, allow the
  239. Xcomponents of the structures to be edited individually, providing full
  240. Xaccess to the flexible controls of the program.
  241. X
  242. XThe sequence of control of the program is:
  243. X
  244. X1) read the @file{./.starrc} file.
  245. X
  246. X2) process the command line: options are processed in order, later
  247. Xarguments may override earlier arguments, additional @samp{.starrc}
  248. Xformat files are read as they are encountered in @samp{-e} options.
  249. XHowever, if the file specified in the @samp{-e} option is in @samp{mapwin}
  250. Xformat, it is read later.  After the command line is processed, if the
  251. X@samp{-u} option is active, keyboard interaction is performed.  Next,
  252. Xany @samp{mapwin} format files are read.  If there is more interaction
  253. Xavailable (e.g. as in @code{starXaw}), the details of the chart may now be
  254. Xcontrolled.  If a @samp{mapwin} file is to be written, it is written now.
  255. XThen the chart is drawn to specification.  Finally, after the chart is
  256. Xdrawn, the program returns to the first interaction (i.e. returns to
  257. Xthe point after the command line has been processed).
  258. X
  259. XOne more form of interaction is available on some systems:  A mouse or
  260. Xother pointing device may be used to either select points on a map and
  261. Xthe coordinates of that point are displayed, or the databases may be
  262. Xsearched for objects near the selected point and the database entries
  263. Xfor the objects found are displayed.
  264. X
  265. X@node Standard data files, Particular versions, User controls, Charts
  266. X@comment  node-name,  next,  previous,  up
  267. X@section Standard Data Files
  268. X
  269. XAll are in equinox 2000.0 coordinates, and should also be in epoch
  270. X2000.0.
  271. X
  272. X@table @file
  273. X@itemx yale.star
  274. Xstellar information (mandatory)
  275. X
  276. X@itemx neb.star
  277. Xnebulae (optional)
  278. X
  279. X@itemx planet.star
  280. Xplanets (optional)
  281. X
  282. X@itemx boundaries.star
  283. Xconstellation boundaries (optional)
  284. X
  285. X@itemx cnames.star
  286. Xconstellation names (optional)
  287. X
  288. X@itemx patterns.star
  289. Xconstellation patterns (optional)
  290. X
  291. X@itemx index.indx
  292. Xindex file for additional star files (optional)
  293. X
  294. X@itemx con.locs
  295. Xdefault mnemonic locations
  296. X
  297. X@end table
  298. X
  299. X@node Particular versions, Writing a new version, Standard data files, Charts
  300. X@comment  node-name,  next,  previous,  up
  301. X@section Particular Starchart Programs
  302. X
  303. XSome starchart programs have coadditional driver-specific controls
  304. Xwhich are accessed throught the @samp{-a} command line option, or the
  305. X@samp{additional} (= @samp{driver_control}) variable.
  306. X
  307. XThese programs and other versions of starchart with special needs are
  308. Xdocumented in this section.
  309. X
  310. X@menu
  311. X* starX11::
  312. X* starXaw::
  313. X* starpost::
  314. X* startool::
  315. X@end menu
  316. X
  317. X@node starX11, starXaw, Particular versions, Particular versions
  318. X@comment  node-name,  next,  previous,  up
  319. X@subsection @code{starX11}
  320. X@pindex starX11
  321. X
  322. X@code{starX11} is the X11 version of starchart.  It has the following
  323. Xspecial arguments which are accessed through @samp{-a}, e.g.@*
  324. X@samp{-a p}.
  325. X
  326. X@table @samp
  327. X@itemx p
  328. XPostScript preview: use screen size and shape to approximate coverage of
  329. X@code{starpost} chart. @refill
  330. X@itemx l
  331. XPostScript landscape preview: use screen size and shape to approximate
  332. Xcoverage of @code{starpost} landscape format chart. @refill
  333. X@itemx h
  334. Xhide: display is generated invisibly, which may save time. @refill
  335. X@itemx b
  336. Xbackup: use backup pixmap, allows window to be hidden and redrawn. @refill
  337. X@itemx m
  338. Xmonochrome: prevents use of color on displays otherwise capable of it. @refill
  339. X@end table
  340. X
  341. XUsage example:@*
  342. X@samp{starX11 -c ori -g 5 -a p}.
  343. X
  344. X@node starXaw, starpost, starX11, Particular versions
  345. X@comment  node-name,  next,  previous,  up
  346. X@subsection @code{starXaw}
  347. X@pindex starXaw
  348. X
  349. X@code{starXaw} is the X11 version of starchart with interactive control
  350. Xusing Athena Widgets.  In addition to the controls for @code{starX11},
  351. Xit has the following special arguments which are accessed through
  352. X@samp{-a}, e.g. @*
  353. X@samp{-a "t -geometry -0-0"}.
  354. X
  355. X@table @samp
  356. X@itemx t
  357. X" toolkit_args" for access to the standard X toolkit controls, such as
  358. Xfor geometry, fonts, etc. @refill
  359. X@end table
  360. X
  361. XUsage example:@*
  362. X@samp{starXaw -c sgr -a p -a "t -geometry -0-0 -bg red"}.
  363. X
  364. X@node starpost, startool, starXaw, Particular versions
  365. X@comment  node-name,  next,  previous,  up
  366. X@subsection @code{starpost}
  367. X@pindex starpost
  368. X@pindex postconv.awk
  369. X
  370. X@code{starpost} is the PostScript version of starchart.  It has the
  371. Xfollowing special arguments which are accessed through @samp{-a}, e.g.@*
  372. X@samp{-a "m9 8 7 6 5 4 3.5 2.5 2 1.5 1 0.5"}. @refill
  373. X
  374. X@table @samp
  375. X@itemx n
  376. Xnotebook: The chart is shifted to the right on the page, and the
  377. X``thumbnail'' map is replaced with prompts and space for recording
  378. Xobserving conditions.  The rest of the argument string is taken to be a
  379. Xlist of floating point numbers separated by `:' or ` '.  These are taken
  380. Xto be the radii in degrees of fields of view of the instrument or
  381. Xfinder.  Circles with these radii are drawn, centered on the center of
  382. Xthe chart. @refill
  383. X@itemx m
  384. Xmagnitude: 0.1 magnitude quanta are to be used (the default is 1.0
  385. Xmagnitude, e.g. a 4.6 magnitude star is represented by the same symbol
  386. Xas a star of magnitude 5.4).  The rest of the argument string is taken
  387. Xto be a list of floating point numbers separated by `:' or ` '.  These
  388. Xare taken to be the radii of the symbols for stars of magnitude -1, 0,
  389. X1, 2, 3 etc. The sizes of symbols for stars with magnitudes between
  390. Xthese magnitudes are determined by linear interpolation.  Note that the
  391. Xlast value given is the value assigned to all magnitudes fainter than
  392. Xthat magnitude.  Current default sizes are "9 8 7 6 5 4 3.25 2.5 2 1.5 1
  393. X0.5". @refill 
  394. X@itemx s
  395. Xsize: this argument provides an alternative way of specifying
  396. Xmagnitude symbol sizes, using a formula proposed by Andrew Young in
  397. XSky and Telescope, March 1990, p. 311, D = D0 * 10^(k*(v0 - v)).
  398. XHe proposes a k of between 0.07 and 0.16, with 0.11 as probably the
  399. Xbest.  If @samp{s} uses 0.1 magnitude quanta as does @samp{m}.  The
  400. Xdefault values for @var{D0}, @var{v0}, and @var{k} are 0.5 (points),
  401. Xthe limiting magnitude of the first main map, and 0.11, respectively.
  402. XThese may be altered with the optional arguments to @samp{s}, which set
  403. X@var{D0}, @var{v0} and @var{k} in that order, e.g. @samp{s 0.7 6.6} sets
  404. X@var{D0} to 0.7 point, and @var{v0} to magnitude 6.6 so that a magnitude
  405. X6.6 star will be printed as 0.7 point in diameter, and @var{k} will
  406. Xremain 0.11.  @samp{s 0.7 6.6 0.07} will set @var{D0} and @var{v0} as
  407. Xabove, and also set @var{k} to 0.07. @refill
  408. X@itemx f
  409. X@samp{f @var{file}} may be used to specify an output file, otherwise the
  410. XPostScript produced is sent to the standard output. @refill
  411. X@itemx c
  412. Xmay be used to produce color postscript output. @refill
  413. X@itemx l
  414. Xmay be used to specify landscape mode (as opposed to the default
  415. Xportrait orientation).  Landscape mode can only used with a
  416. Xfullpage map.  @refill
  417. X@end table
  418. X
  419. XSince the resolution of PostScript is much higher than other common
  420. Xdevices, @samp{mapwin} files must be edited when transferred between
  421. Xstarpost and other drivers.  The controls for window @samp{width},
  422. X@samp{height}, @samp{x_offset} and @samp{y_offset} must be changed. @refill
  423. X
  424. XThe @samp{-a p} or @samp{-a l} option used with @code{starX11} or
  425. X@code{starXaw} can be used to produce a @samp{mapwin} file which can be
  426. Xconverted for use in @code{starpost} through an @code{awk} script named
  427. X@code{postconv.awk}, provided with the source to this program. @refill
  428. X
  429. XUsage example:@*
  430. X@samp{starpost -a "n 6:1.5:.5" -a "m9 8 7 6 5 4 3.5 2.5 2 1.5 1 0.5" -a "f orion.PS" -c ori -g 5}.
  431. X
  432. X@node startool, Writing a new version, starpost, Particular versions
  433. X@comment  node-name,  next,  previous,  up
  434. X@subsection @code{startool}
  435. X@pindex startool
  436. X@pindex starsunv
  437. X
  438. X@code{startool} uses the @code{tooltool} program, not included in the
  439. Xstarchart distribution, to provide an interface to @code{starsunv}.
  440. X@code{ttooltool} is available from your local Sun sources archive.
  441. X
  442. X@node Writing a new version, Data files, Particular versions, Charts
  443. X@comment  node-name,  next,  previous,  up
  444. X@section Writing a New Version for a New Device
  445. X@subsection Organization
  446. X
  447. XThere are several layers of functions in starchart.  The top level is in
  448. X@file{starmain.c}, @file{starm2.c}, and @file{readfile.c}.  It is (I
  449. Xhope) general enough to enable any additions to be made by users in the
  450. Xform of modified drivers, leaving these files stable.  @file{starmain.c}
  451. Xand @file{starm2.c} are in charge of the user interface and file
  452. Xreading, with @file{readfile.c}.  Generally, this top level controls
  453. X@emph{what} is to be drawn, and @emph{where} it appears.  The device
  454. Xspecific section controls @emph{how} it appears.
  455. X@refill
  456. X
  457. XInformation is passed to the drivers via externs and function
  458. Xparameters.  The externs are for runtime values, the function parameters
  459. Xare for values taken from the data files.  Information is passed from
  460. Xthe driver to the starchart.c routines via externs.
  461. X
  462. XThere are three layers of functions, in several source files.  The top
  463. Xlevel functions are in @file{starmain.c} and @file{starm2.c}.  You
  464. Xshould not have to change anything in this file, except perhaps #defines
  465. Xfor default file names and file types, and these may also be set in the
  466. XMakefile.
  467. X
  468. XThe @file{starcust.c} file contains customizing functions, including functions
  469. Xto define additional command line flags, which may apply to several
  470. Xdrivers.
  471. X
  472. XThe @file{starXXXX.c} or @file{starimages.c} + @file{starXXXX.c} files
  473. Xdefine the more device dependent functions.  There is one function,
  474. Xcalled @samp{drawobj}, which is the interface between the top level
  475. Xfunctions and the device for drawing the stars, planets, and other
  476. Xobjects read from a database file.  In addition, standard functions to
  477. Xopen and close the device, draw a line, move without drawing, etc. are
  478. Xrequired.  These may then call the lowest level device dependent
  479. Xfunctions.  The @file{starimages.c} file provides a standard definition
  480. Xfor @code{drawobj} and supporting functions for bitmapped devices; the
  481. Xdevice dependent code remaining (e.g. line drawing), is in the file
  482. X@file{starXXXX.c}.
  483. X
  484. XUser input functions also may be defined in @file{starXXXX.c}.
  485. X
  486. XThe layer currently being drawn and/or the subroutine currently active
  487. Xis passed to the driver in an extern.  This allows the driver to for
  488. Xexample draw vectors differently for the constellation boundaries.
  489. XAdditionally, each window has a map type field which is for efficiency
  490. Xalso passed as an extern, which may be used by the driver to for example
  491. Xdraw certain layers differently in certain windows.
  492. X
  493. XThe source to other drivers, especially @code{starXaw} and
  494. X@code{starpost}, should be a valuable reference to developing new
  495. Xdrivers.
  496. X
  497. X@subsection Customization
  498. X
  499. XFor the drivers distributed, there are many @samp{#defines} and global
  500. Xvariables whose values may be altered to suit your tastes and your
  501. Xparticular piece of hardware.  Default file names are @samp{#defined} in
  502. Xthe code, and may also be set in the Makefile.
  503. X
  504. XIt is easy to write a driver for other devices, based on the drivers and
  505. Xthe driver skeleton provided.
  506. X
  507. XMore extensive customization is possible through modifying the driver
  508. Xfunctions to take fullest advantage of the device you are using.  It is
  509. Xalso possible to add controls accessed through the @samp{-a} command
  510. Xline option and the @samp{additional} (= @samp{driver_control}) variables.
  511. X
  512. XPlease try to send me (ccount) a note before writing any new drivers, so
  513. XI can let you know if a driver for that device is in the works.  Any
  514. Ximprovements to drivers should be sent to me or the author (if they are
  515. Xnot the same), when you're sure they work and are happy with the
  516. Xchanges.
  517. X
  518. XThings you define in @file{starcust.c}, if you think they are generally
  519. Xuseful, should be sent to me.  If possible, they may be incorporated in
  520. Xfuture releases.
  521. X
  522. XImprovements to top level routines should be made with great caution.
  523. XSuch changes will make it harder for you to use future refinements.  If
  524. Xyou're sure you're change (a) works and (b) is better/stronger/faster,
  525. Xplease send it to me.
  526. X
  527. XDo report any bugs/problems.
  528. X
  529. X@node Data files, Support programs, Charts, Top
  530. X@comment  node-name,  next,  previous,  up
  531. X@chapter The Data Files and Their Formats
  532. X@cindex Data files
  533. X@cindex starchart data formats
  534. X
  535. XThis section discusses file formats used by the programs.
  536. X
  537. X@menu
  538. X* Contents::            The data contained in a data file
  539. X* File formats::        Formats for data files
  540. X@end menu
  541. X
  542. X@node Contents, File formats, Data files, Data files    
  543. X@comment  node-name,  next,  previous,  up
  544. X@section Contents of Data Files
  545. X
  546. XEach line of file contains:
  547. X@table @var
  548. X@itemx ra, dec, mag
  549. XRequired.  Right ascension, Declination, and magnitude (V or visual).  6
  550. Xchars for RA, one for sign of DEC, 4 for DEC, 3 for mag. @refill
  551. X
  552. X@itemx object type
  553. XDefines what the object is: star, galaxy, cluster, nebula, planet,
  554. Xother, unknown, vector, area, comment, or invisible, with subtypes for
  555. Xeach (Two chars).  Defaults to type star subtype single. @refill
  556. X
  557. X@itemx spectral class or color
  558. XDefines the color of the object, as spectral class for stars or directly
  559. Xfor other objects (Two chars). @refill
  560. X
  561. X@itemx letter or flamsteed number or size
  562. XDefines either the Bayer letter or Flamsteed number of a star, or the
  563. Xsize of an extended object encoded in two chars. @refill
  564. X
  565. X@itemx constellation
  566. XThe constellation field contains the IAU designation of the
  567. Xconstellation the object is in (three chars). @refill
  568. X
  569. X@itemx name
  570. XName or other labeling string.  Terminated by comma. @refill
  571. X
  572. X@itemx comment field
  573. XRemainder of line after the comma which terminates the name.  This
  574. Xcomment field may be used for special information about the object, e.g.
  575. Xthe phase of the moon. @refill
  576. X@end table
  577. X
  578. XMagnitude is encoded into three fields as follows: the first character
  579. Xmay be a @samp{-}, in which case the next two characters are the magnitude
  580. Xtimes 10, e.g. @samp{-16} means @samp{-1.6}.  The first character is a digit,
  581. Xthe three characters are the magnitude times 100, e.g. @samp{563} means
  582. X@samp{5.63}.  Finally, if the first character is a capital letter, this is
  583. Xtaken as the base-36 value of the integral part of the magnitude, and
  584. Xthe remaining two characters are the fractional part times 100, e.g.
  585. X@samp{B34} means @samp{11.34}.
  586. X
  587. XThe Bayer letter or Flamsteed numbers are applicable only to stars.  The
  588. Xfield is two characters wide.  Greek letters are a single lowercase
  589. Xletter followed by a space or a number, encoded as in the PostScript
  590. XSymbol font:
  591. X@tex
  592. X{
  593. X\settabs 4 \columns
  594. X\+$\alpha$ - a & $\beta$ - b & $\gamma$ - g & $\delta$ - d \cr
  595. X\+$\varepsilon$ - e & $\zeta$ - z & $\eta$ - h & $\theta$ - q \cr
  596. X\+$\iota$ - i & $\kappa$ - k & $\lambda$ - l & $\mu$ - m \cr
  597. X\+$\nu$ - n & $\xi$ - x & $o$ - o & $\pi$ - p \cr
  598. X\+$\rho$ - r & $\sigma$ - s & $\tau$ - t & $\upsilon$ - u \cr
  599. X\+$\phi$ - f & $\chi$ - c & $\psi$ - y & $\omega$ - w \cr
  600. X}
  601. X@end tex
  602. X@ifinfo
  603. X@comment .nf .br  , .fi
  604. Xalpha    - a    beta    - b    gamma    - g    delta    - d
  605. Xepsilon    - e    zeta    - z    eta    - h    theta    - q
  606. Xiota    - i    kappa    - k    lambda    - l    mu    - m
  607. Xnu    - n    xi    - x    omicron - o    pi    - p
  608. Xrho    - r    sigma    - s    tau    - t    upsilon    - u
  609. Xphi    - f    chi    - c    psi    - y    omega    - w
  610. X@end ifinfo
  611. X
  612. X@iftex
  613. X@tex
  614. XNote that $\theta$, $\xi$, $\phi$, $\chi$, and $\psi$ have changed from
  615. X@end tex
  616. Xthe original definitions, which were @@, E, 0, x, and % respectively.
  617. X@tex
  618. XNote also that the variant version of phi, $\varphi$, is mapped to j.
  619. X@end tex
  620. X@end iftex
  621. X@ifinfo
  622. XNote that theta, xi, phi, chi, and psi have changed from the original
  623. Xdefinitions, which were @@, E, 0, x, and % respectively.  Note also that
  624. Xa variant version of phi is mapped to j. 
  625. X@end ifinfo
  626. X
  627. XAn uppercase letter followed by any character or two non-numeric
  628. Xcharacters is the roman letter designation for the star, e.g. @samp{CY}.
  629. XTwo numbers or a space and a number is the Flamsteed number of the star.
  630. X
  631. XThe size of nonstellar objects is encoded in seconds of arc in the size
  632. Xfield to two significant digits.  The second character is always a
  633. Xdecimal digit.  Sizes from 0 to 99 arc seconds are encoded as two
  634. Xdecimal digits.  For larger objects the first character is a capital
  635. Xletter, interpreted as follows, with the second character as the next
  636. Xdigit:
  637. X@tex
  638. X{
  639. X\settabs 6 \columns
  640. X\+First character && Value \cr
  641. X\+0 - 9 && 00 - 90 \cr
  642. X\+A - I && 100 - 900 \cr
  643. X\+J - R && 1000 - 9000 \cr
  644. X\+S - Z && 10000 - 80000 \cr
  645. X}
  646. X@end tex
  647. X@ifinfo
  648. XFirst character        Value
  649. X0 - 9            00 - 90
  650. XA - I            100 - 900
  651. XJ - R            1000 - 9000
  652. XS - Z            10000 - 80000
  653. X@end ifinfo
  654. X
  655. XExamples:
  656. X@tex
  657. X{
  658. X\settabs 10 \columns
  659. X\+Size field & Value \cr
  660. X\+ 6 & 6 \cr
  661. X\+09 & 9 \cr
  662. X\+73 & 73 \cr
  663. X\+A0 & 100 \cr
  664. X\+C3 & 330 \cr
  665. X\+D5 & 450 \cr
  666. X\+I6 & 960 \cr
  667. X\+J2 & 1200 \cr
  668. X\+R3 & 9300 \cr
  669. X\+S6 & 16000 \cr
  670. X\+Z0 & 80000 \cr
  671. X\+Z9 & 89000 \cr
  672. X}
  673. X@end tex
  674. X@ifinfo
  675. X@comment .nf .br  , .fi
  676. XSize field    Value
  677. X 6        6
  678. X09        9
  679. X73        73
  680. XA0        100
  681. XC3        330
  682. XD5        450
  683. XI6        960
  684. XJ2        1200
  685. XR3        9300
  686. XS6        16000
  687. XZ0        80000
  688. XZ9        89000
  689. X@end ifinfo
  690. X
  691. XThe types and subtypes implemented are:
  692. X@tex
  693. X{
  694. X\settabs 4 \columns
  695. X\+Type[0]xxxxx &    Main typexxxxx & Type[1]xxxxx &    Subtype    \cr
  696. X\+Type[0]    &    main type &    type[1] &    subtype    \cr
  697. X\+C    &    cluster \cr
  698. X\+&&                G    &    globular \cr
  699. X\+&&                O    &    open \cr
  700. X\+&&                (other) &    other \cr
  701. X\+G    &    galaxy \cr
  702. X\+&&                a    &    spiral Sa \cr
  703. X\+&&                b    &    spiral Sb \cr
  704. X\+&&                c    &    spiral Sc \cr
  705. X\+&&                d    &    spiral Sd \cr
  706. X\+&&                p    &    spiral Sp \cr
  707. X\+&&                Z    &    spiral S0 \cr
  708. X\+&&                s    &    spiral unspecified \cr
  709. X\+&&                A    &    barred spiral SBa \cr
  710. X\+&&                B    &    barred spiral SBb \cr
  711. X\+&&                C    &    barred spiral SBc \cr
  712. X\+&&                D    &    barred spiral SBd \cr
  713. X\+&&                P    &    barred spiral SBp \cr
  714. X\+&&                S    &    barred spiral unspecified \cr
  715. X\+&&                0-7    &    elliptical E0-E7 \cr
  716. X\+&&                E    &    elliptical \cr
  717. X\+&&                I    &    irregular I \cr
  718. X\+&&                Q    &    quasar \cr
  719. X\+&&                U    &    unknown \cr
  720. X\+&&                !    &    peculiar \cr
  721. X\+&&                     &    unspecified \cr
  722. X\+&&                (other) &    other \cr
  723. X\+N    &    nebula \cr
  724. X\+&&                D    &    diffuse \cr
  725. X\+&&                P    &    planetary \cr
  726. X\+&&                (other) &    other \cr
  727. X
  728. X\+P    &    planet \cr
  729. X\+&&                M    &    Mercury \cr
  730. X\+&&                V    &    Venus \cr
  731. X\+&&                m    &    Mars \cr
  732. X\+&&                J    &    Jupiter \cr
  733. X\+&&                s    &    Saturn \cr
  734. X\+&&                U    &    Uranus \cr
  735. X\+&&                N    &    Neptune \cr
  736. X\+&&                P    &    Pluto \cr
  737. X\+&&                A    &    Asteroid \cr
  738. X\+&&                C    &    Comet \cr
  739. X\+&&                S    &    Sun (Sol)\cr
  740. X\+&&                L    &    Moon (Luna)\cr
  741. X\+&&                (other) &    other \cr
  742. X
  743. X\+S    &    star \cr
  744. X\+&&                S    &    single \cr
  745. X\+&&                D    &    double \cr
  746. X\+&&                V    &    variable \cr
  747. X
  748. X\+O    &    other \cr
  749. X\+&&                (any)    &    other object \cr
  750. X
  751. X\+U    &    unknown \cr
  752. X\+&&                (any)    &    unknown object \cr
  753. X
  754. X\+V    &    vector \cr
  755. X\+&&                M    &    moveto (begin, no line drawn)\cr
  756. X\+&&                S    &    solid lineto via great circle\cr
  757. X\+&&                D    &    dotted lineto via great circle\cr
  758. X\+&&                H    &    hyphened (dashed) lineto g. c.\cr
  759. X
  760. X\+&&                m    &    moveto linear\cr
  761. X\+&&                s    &    solid lineto linear\cr
  762. X\+&&                d    &    dotted lineto linear\cr
  763. X\+&&                h    &    hyphened lineto linear\cr
  764. X
  765. X\+I    &    invisible \cr
  766. X\+&&                (any)    &    for labels \cr
  767. X
  768. X\+\#    &    data comment \cr
  769. X\+&&                (any)    &    for comment in file \cr
  770. X
  771. X\+A    &    area \cr
  772. X\+&&                M    &    moveto (begin)\cr
  773. X\+&&                A    &    add great circle border segment\cr
  774. X\+&&                F    &    fill region and end region \cr
  775. X\+&&                m    &    moveto (begin) \cr
  776. X\+&&                a    &    add linear border segment \cr
  777. X\+&&                f    &    fill region and end region \cr
  778. X}
  779. X@end tex
  780. X@ifinfo
  781. X@comment .nf .br  , .fi
  782. XType[0]        main type    type[1]        subtype
  783. XC        cluster
  784. X                G        globular
  785. X                O        open
  786. X                (other)     other
  787. X
  788. XG        galaxy
  789. X                a        spiral Sa
  790. X                b        spiral Sb
  791. X                c        spiral Sc
  792. X                d        spiral Sd
  793. X                p        spiral Sp
  794. X                Z        spiral S0
  795. X                s        spiral unspecified
  796. X                A        barred spiral SBa
  797. X                B        barred spiral SBb
  798. X                C        barred spiral SBc
  799. X                D        barred spiral SBd
  800. X                P        barred spiral SBp
  801. X                S        barred spiral unspecified
  802. X                0-7        elliptical E0-E7
  803. X                E        elliptical
  804. X                I        irregular I
  805. X                Q        quasar
  806. X                U        unknown
  807. X                !        peculiar
  808. X                         unspecified
  809. X                (other)     other
  810. X
  811. XN        nebula
  812. X                D        diffuse
  813. X                P        planetary
  814. X                (other)     other
  815. X
  816. XP        planet
  817. X                M        Mercury
  818. X                V        Venus
  819. X                m        Mars
  820. X                J        Jupiter
  821. X                s        Saturn
  822. X                U        Uranus
  823. X                N        Neptune
  824. X                P        Pluto
  825. X                A        Asteroid
  826. X                C        Comet
  827. X                S        Sun (Sol)
  828. X                L        Moon (Luna)
  829. X                (other)     other
  830. X
  831. XS        star
  832. X                S        single
  833. X                D        double
  834. X                V        variable
  835. X
  836. XO        other
  837. X                (any)        other object
  838. X
  839. XU        unknown
  840. X                (any)        unknown object
  841. X
  842. XV        vector
  843. X                M        moveto (begin, no line drawn)
  844. X                S        solid lineto via great circle
  845. X                D        dotted lineto via great circle
  846. X                H        hyphened (dashed) lineto g. c.
  847. X                m        moveto linear
  848. X                s        solid lineto linear
  849. X                d        dotted lineto linear
  850. X                h        hyphened lineto linear
  851. X
  852. XI        invisible
  853. X                (any)        for labels
  854. X
  855. X#        data comment
  856. X                (any)        for comment in file
  857. X
  858. XA        area
  859. X                M        moveto (begin)
  860. X                A        add great circle border segment
  861. X                F        fill region and end region
  862. X                m        moveto (begin)
  863. X                a        add linear border segment
  864. X                f        fill region and end region
  865. X@end ifinfo
  866. X
  867. XThe magnitude of an object determines what information is displayed.
  868. XThree magnitude limits are defined for each file in each map window.  If
  869. Xthe magnitude is greater (dimmer) than the first limit, nothing is
  870. Xdrawn.  If the object is brighter than a second limit, the label (Bayer
  871. Xor Flamsteed) is printed (if present).  If it is brighter than the third
  872. Xlimit, the name is printed (if present; if not, the label is printed if
  873. Xpresent).  These text strings generally appear to the right of the
  874. Xobject, but the driver can change this.  Note: the label string only
  875. Xapplies to stars.
  876. X
  877. XFor nonstellar objects, the label field defines the size of the object
  878. Xin arc seconds.
  879. X
  880. XFor magnitudes within a range defined for the mapwindow, a magnitude
  881. Xtag, the magnitude to one decimal place as in variable star and asteroid
  882. Xfinding charts, may be displayed.  This will generally be below and to
  883. Xthe right of the object, but this is controlled by the driver.
  884. X
  885. XThe symbol drawn for the object is determined by the type field.
  886. X
  887. XFor devices supporting color, the spectral class or color field defines
  888. Xthe color of the object, and perhaps the associated text.  The spectral
  889. Xclass of stars is mapped to display color, and for other objects, this
  890. Xfield may contain direct color specifications, e.g. 'r3' for an object
  891. Xcolored red level 3.  All this is controlled by the device driver.
  892. XStandards for color definitions are yet to be defined.
  893. X
  894. XThe constellation field is not currently used in the display.
  895. X
  896. XThe comment field is also not generally used, but some drivers may use
  897. Xit to contain special information such as the phase of the moon or
  898. Xposition angle of a comet's tail.
  899. X
  900. X@node File formats, Support programs, Contents, Data files
  901. X@comment  node-name,  next,  previous,  up
  902. X@section Data file formats
  903. X@cindex starchart data file formats
  904. X
  905. X@menu
  906. X* lineread::    yale.star or lineread format
  907. X* sif::        starchart interchange format
  908. X* binary::    binary formats
  909. X* index::    index meta-format
  910. X@end menu
  911. X
  912. X@node lineread, sif, File formats, File formats
  913. X@comment  node-name,  next,  previous,  up
  914. X@subsection @samp{lineread}
  915. X
  916. XThis text format, called @dfn{lineread}, is the original data file format.
  917. XData for each object is on a single line, stored in character fields.
  918. XCurrently, an older variant is also supported, one which has 4
  919. Xcharacters for the magnitude and omits the color and letter/number
  920. Xfields.  Both of these formats are designated as type @dfn{lineread},
  921. Xsince each line is read individually and these two types are easily
  922. Xdistinguished on a line by line basis.  In all formats, if a value is
  923. Xunknown, it should be spaces, or a null string in the case of the name
  924. Xand comment fields.  The RA, DEC and mag. must always be provided for an
  925. Xobject.
  926. X
  927. XSince it is a text format, it may be mailed safely and be used on many
  928. Xdifferent computer architectures without change.  However, it is slow,
  929. Xand uses more file space than it ought.
  930. X
  931. X
  932. X@node sif, binary, lineread, File formats    
  933. X@comment  node-name,  next,  previous,  up
  934. X@subsection @samp{sif}: Starchart Interchange Format
  935. X
  936. XThe @dfn{sif} format was introduced to allow data to be exchanged as text,
  937. Xwith greater precision in the location and magnitude fields, and greater
  938. Xreadability compared to the @dfn{lineread} format.  The format is too slow
  939. Xfor use as input to the starchart programs.  A data conversion program
  940. Xis provided to convert between formats, and to precess coordinates
  941. Xduring the conversion.
  942. X
  943. XEach object is represented by a single line in the file.  This line
  944. Xcontains fields each of which corresponds to a field in the
  945. X@dfn{lineread} format.  The fields are separated by a single character,
  946. Xusually @samp{;}.  Fields may be omitted from the end of the line;
  947. Xomitted fields are assigned their default values.  Fields may be empty,
  948. Xand again are assigned their default values.  As with the other formats,
  949. Xthe RA, DEC, and mag. must be present.
  950. X
  951. XThe RA may be given as a decimal hour, hour and decimal minute, or hour
  952. Xminute and decimal second.  The DEC may be given in the same format.
  953. XThe magnitude is a floating point number.
  954. X
  955. XThe type, and color, fields are empty or one or two characters, as in
  956. Xthe @dfn{lineread} format.
  957. X
  958. XThe label field is also the same as in the @dfn{lineread} format, and
  959. Xencodes the size of non-stellar objects in two characters.  There is a
  960. Xbit of ``magic'' in this field.  Since @samp{X } or @samp{ X} are both
  961. Xvalid, and whitespace is normally ignored, iff this field is two
  962. Xcharacters wide, and both characters are printing characters, it is
  963. Xtaken verbatim as the label field.  That is, @samp{... ; X; ...} is
  964. X@samp{ X}, while @samp{... ; X ; ...} is read as one character and left
  965. Xjustified to become @samp{X }. @refill
  966. X
  967. XThe constellation field is the IAU abbreviation for the constellation
  968. Xand is always blank or three characters.
  969. X
  970. XThe name and comment are two separate fields.  Commas should not be used
  971. Xin the name field, since when this name is placed in the other formats a
  972. Xcomma is used to separate the name from comments.
  973. X
  974. X@node binary, gsc, sif, File formats    
  975. X@comment  node-name,  next,  previous,  up
  976. X@subsection Binary Formats
  977. X
  978. XThree binary input formats are supported.  These formats provide greater
  979. Xposition and magnitude accuracy, with faster input, and varying degrees
  980. Xof storage space reduction.  The files are inherently unportable,
  981. Xhowever, and should not be exchanged between machines and operating
  982. Xsystems, or even different compilers.  The @dfn{sif} format, described
  983. Xabove, provides a general data exchange format.
  984. X
  985. XThe three formats provide different storage sizes.  The most general
  986. Xformat, which contains all the data in the @dfn{lineread} format, is the
  987. X@dfn{binfull} format.  A smaller format, @dfn{binobj} stores only the
  988. XRA, DEC, mag. and object type fields, all other fields become their
  989. Xdefaults (usually spaces).  The smallest format, @dfn{binstar} stores
  990. Xonly the RA, DEC and mag., all other fields become their defaults,
  991. Xnotably the @var{object type} is @samp{SS}.
  992. X
  993. XThe binary formats are described as @b{C} structures.  How the data in
  994. Xthe structure is stored is therefore highly variable between compilers,
  995. Xoperating systems and machines.  However, most machines should be able
  996. Xto take advantage of these formats for local storage.
  997. X
  998. X@node gsc, index, binary, File formats    
  999. X@comment  node-name,  next,  previous,  up
  1000. X@subsection The Guide Star Catalog
  1001. X
  1002. XThe Hubble Space Telescope Guide Star Catalog, available on 2 CD-ROMs,
  1003. Xmay be used as a stellar database.  This format may be read by
  1004. X@code{dataconv} and the starchart programs, but now written.  An index
  1005. Xfile is used to specify which files on which CD-ROM should be read.
  1006. X
  1007. X@node index, Support programs, binary, File formats
  1008. X@comment  node-name,  next,  previous,  up
  1009. X@subsection The Index File index.indx, @samp{indextype}
  1010. X
  1011. XThe @dfn{indextype} file is a special file format added to support larger
  1012. Xdatabases of dimmer stars.  It provides an index mapping location to
  1013. Xfilenames of files containing star data as above.  Each indexed file
  1014. Xcovers a rectangle of sky in RA and DEC.  The areas may be different
  1015. Xsizes for different files.  The area covered is given as the RA and DEC
  1016. Xof the upper left and lower right corners, followed by the filename and
  1017. Xa string indicating the type of the file.  This is all on one line in
  1018. Xthe file.  The format is then:
  1019. X
  1020. X@tex
  1021. X{
  1022. X\settabs 6 \columns
  1023. X\+upper left & upper left & lower right & lower right & filename & filetype \cr
  1024. X\+RA & DEC & RA & DEC & filename & filetype \cr
  1025. X\+e.g.\cr
  1026. X\+02.0 &    -30.0 &    00.0 &    -90.0 &  SAO00-90 & lineread \cr
  1027. X\+04.0 &    -30.0 &    02.0 &    -90.0 &  SAO02-90 & lineread \cr
  1028. X\+06.0 &    -30.0 &    04.0 &    -90.0 &  SAO04-90 & lineread \cr
  1029. X\+08.0 &    -30.0 &    06.0 &    -90.0 &  SAO06-90 & lineread \cr
  1030. X\+10.0 &    -30.0 &    08.0 &    -90.0 &  SAO08-90 & lineread \cr
  1031. X}
  1032. X@end tex
  1033. X@ifinfo
  1034. Xupper left   upper left   lower right   lower right   filename   filetype
  1035. XRA         DEC      RA        DEC          filename     filetype
  1036. X
  1037. Xe.g.
  1038. X02.0         -30.0       00.0            -90.0          SAO00-90     lineread
  1039. X04.0         -30.0       02.0            -90.0          SAO02-90     lineread
  1040. X06.0         -30.0       04.0            -90.0          SAO04-90     lineread
  1041. X08.0         -30.0       06.0            -90.0          SAO06-90     lineread
  1042. X10.0         -30.0       08.0            -90.0          SAO08-90     lineread
  1043. X@end ifinfo
  1044. X
  1045. X@node Support programs, Acknowledgments, Data files, Top
  1046. X@comment  node-name,  next,  previous,  up
  1047. X@chapter The Support Programs
  1048. X@cindex Support programs
  1049. X
  1050. XSeveral support programs are provided for use with the primary
  1051. X@code{observe} and starchart programs.
  1052. X
  1053. X@menu
  1054. X* dataconv::
  1055. X* sif-to-text::
  1056. X* tosize::
  1057. X@end menu
  1058. X
  1059. X@node dataconv, sif-to-text, Support programs, Support programs
  1060. X@comment  node-name,  next,  previous,  up
  1061. X@section @code{dataconv}
  1062. X@pindex dataconv
  1063. X
  1064. XThis program is used to convert between file formats, especially to
  1065. Xgenerate binary format files.  It can precess coordinates as desired.
  1066. XRemember, input data files for starchart programs should be in 2000.0
  1067. Xcoordinates.
  1068. X
  1069. X@node sif-to-text, tosize, dataconv, Support programs
  1070. X@comment  node-name,  next,  previous,  up
  1071. X@section @code{sif-to-text}
  1072. X@pindex sif-to-text
  1073. X
  1074. XThe @code{sif-to-text} or @code{sif_to_text} program converts sif format
  1075. Xfiles to more readable text tables.
  1076. X
  1077. X@node tosize, Acknowledgments, sif-to-text, Support programs
  1078. X@comment  node-name,  next,  previous,  up
  1079. X@section @code{tosize}
  1080. X@pindex tosize
  1081. X
  1082. XThis program is used to encode the size of objects, for development of
  1083. Xnew databases.
  1084. X
  1085. X@node Acknowledgments, , Support programs, Top    
  1086. X@comment  node-name,  next,  previous,  up
  1087. X@chapter Acknowledgements
  1088. X
  1089. XThe previous versions of starchart were developed by Alan Paeth.
  1090. X
  1091. XSteve Kennedy contributed to @file{starimages.c}.
  1092. X
  1093. XRobert Tidd provided the original @file{yale.star} and the format.
  1094. X
  1095. XDave Van't Hof provided most of the other databases (in particular boundaries,
  1096. Xpatterns, and names).
  1097. X
  1098. XMichael Campanella provided vms support.
  1099. X
  1100. XThe Atari ST version was developed by Holger Zessel and Markus Kempf.
  1101. X
  1102. XTom Horsley contributed the ibm PC driver.
  1103. X
  1104. XMike Daly helped with the Macintosh version.
  1105. X
  1106. XJoe Wang helped with the X11 version.
  1107. X
  1108. XDean Payne provided the original code for @samp{.starrc} processing.
  1109. X
  1110. XOther contributions are from Petri Launiainen, Jyrki Yli-Nokari, Sjoerd
  1111. XMullender, David Smith, Tim Pointing, and others.
  1112. X
  1113. X
  1114. X@node     Program Index,     ,  Previous Node,  Top
  1115. X@comment  node-name,     next,  previous,      up
  1116. X@unnumbered Program Index
  1117. X
  1118. X@printindex pg
  1119. X
  1120. X@node     Concept Index,     ,  Previous Node,  Top
  1121. X@comment  node-name,     next,  previous,      up
  1122. X@unnumbered Concept Index
  1123. X
  1124. X@printindex cp
  1125. X
  1126. X@contents
  1127. X@bye
  1128. X
  1129. END_OF_FILE
  1130. if test 41161 -ne `wc -c <'doc/as.texi.ab'`; then
  1131.     echo shar: \"'doc/as.texi.ab'\" unpacked with wrong size!
  1132. fi
  1133. # end of 'doc/as.texi.ab'
  1134. fi
  1135. echo shar: End of archive 30 \(of 32\).
  1136. cp /dev/null ark30isdone
  1137. MISSING=""
  1138. for I in 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 ; do
  1139.     if test ! -f ark${I}isdone ; then
  1140.     MISSING="${MISSING} ${I}"
  1141.     fi
  1142. done
  1143. if test "${MISSING}" = "" ; then
  1144.     echo You have unpacked all 32 archives.
  1145.     rm -f ark[1-9]isdone ark[1-9][0-9]isdone
  1146. else
  1147.     echo You still need to unpack the following archives:
  1148.     echo "        " ${MISSING}
  1149. fi
  1150. ##  End of shell archive.
  1151. exit 0
  1152.  
  1153.