home *** CD-ROM | disk | FTP | other *** search
/ Source Code 1994 March / Source_Code_CD-ROM_Walnut_Creek_March_1994.iso / compsrcs / misc / volume30 / astrolog / part05 < prev    next >
Encoding:
Text File  |  1992-06-18  |  59.5 KB  |  1,113 lines

  1. Newsgroups: comp.sources.misc
  2. From: cruiser1@u.washington.edu (Walter D. Pullen)
  3. Subject:  v30i066:  astrolog - Generation of astrology charts v2.25, Part05/08
  4. Message-ID: <1992Jun18.191943.14637@sparky.imd.sterling.com>
  5. X-Md4-Signature: 7d7118a57e74cf8336b79a9068144d04
  6. Date: Thu, 18 Jun 1992 19:19:43 GMT
  7. Approved: kent@sparky.imd.sterling.com
  8.  
  9. Submitted-by: cruiser1@u.washington.edu (Walter D. Pullen)
  10. Posting-number: Volume 30, Issue 66
  11. Archive-name: astrolog/part05
  12. Environment: UNIX, VMS
  13. Supersedes: astrolog: Volume 28, Issue 104-109
  14.  
  15. #! /bin/sh
  16. # This is a shell archive.  Remove anything before this line, then unpack
  17. # it by saving it into a file and typing "sh file".  To overwrite existing
  18. # files, type "sh file -c".  You can also feed this as standard input via
  19. # unshar, or by typing "sh <file", e.g..  If this archive is complete, you
  20. # will see the following message at the end:
  21. #        "End of archive 5 (of 8)."
  22. # Contents:  Helpfile.p1
  23. # Wrapped by cruiser1@milton.u.washington.edu on Thu Jun 11 21:53:38 1992
  24. PATH=/bin:/usr/bin:/usr/ucb ; export PATH
  25. if test -f 'Helpfile.p1' -a "${1}" != "-c" ; then 
  26.   echo shar: Will not clobber existing file \"'Helpfile.p1'\"
  27. else
  28. echo shar: Extracting \"'Helpfile.p1'\" \(57907 characters\)
  29. sed "s/^X//" >'Helpfile.p1' <<'END_OF_FILE'
  30. XThis file contains a complete list of all the features available in
  31. XAstrolog version 2.25, and documentation on how to use each option.
  32. XThe file is divided into four parts:
  33. X
  34. X1) A summary list of all the main features which are accessed via
  35. Xcommand line parameter switches, along with a list of single keypress
  36. Xcommands that can be given in an X window (assuming you have X
  37. Xwindows) to change the display in various ways.
  38. X
  39. X2) The list of command switches and keypresses is repeated, but after
  40. Xeach option is listed a more lengthy description of the details of
  41. Xthis feature.
  42. X
  43. X3) Additional things such as some important compile time options, the
  44. Xdefault parameter file, and descriptions of the things that appear in
  45. Xthe Astrolog text displays, are described.
  46. X
  47. X4) Finally, there is a description of the different X window chart
  48. Xdisplays and how they are organized, and the X windows features in
  49. Xgeneral. (Looking for a quick impressive display to prove that this
  50. Xwas worth compiling? In unix try: astrolog -Xn -XG -Xw 400. :)
  51. X
  52. X
  53. X************************
  54. XLIST OF COMMAND SWITCHES
  55. X************************
  56. X
  57. XAstrolog command switches (version 2.25) (June 1992):
  58. X -H: Display this help message.
  59. X -O: Display available planets and other celestial objects.
  60. X -O0: Line -O but ignore any restrictions.
  61. X -R [<obj1> [<obj2> ..]: Restrict specific bodies from displays.
  62. X -R0 [<obj1> ..]: Like -R but restrict everything first.
  63. X -R[C,u,U]: Restrict all minor cusps, all uranians, or stars.
  64. X -C: Include non-angular house cusps in charts.
  65. X -u: Include transneptunian/uranian bodies in charts.
  66. X -U: Include locations of fixed background stars in charts.
  67. X -U[z,l,n,b]: Order by azimuth, altitude, name, or brightness.
  68. X -A [<0-18>]: Display available aspects or limit their number.
  69. X -Ao <orb1> [<orb2> ..]: Specify max orbs for each aspect.
  70. X -AO [..]: Like -Ao but suspend objects' max orb restrictions.
  71. X
  72. XSwitches which affect how a chart is computed:
  73. X -c <value>: Select a different default system of houses.
  74. X     (0 = Placidus, 1 = Koch, 2 = Equal, 3 = Campanus, 4 = Meridian,
  75. X     5 = Regiomontanus, 6 = Porphry, 7 = Morinus, 8 = Topocentric, 9 = None.)
  76. X -s: Compute siderial instead of the normal tropical chart.
  77. X -s0: Display locations as right ascension instead of degrees.
  78. X -h [<objnum>]: Compute positions centered on specified object.
  79. X -p <month> <day> <year>: Cast progressed chart based for date.
  80. X -pn: Cast progressed chart based on current date now.
  81. X -p0 <days>: Set no. of days to progress / day (default 365.25).
  82. X -x <1-360>: Cast harmonic chart based on specified factor.
  83. X -1 [<objnum>]: Cast chart with specified object on ascendant.
  84. X -3: Display objects in their zodiac decan positions.
  85. X -f: Display houses as sign positions (flip them).
  86. X -G: Display houses based on geographic location only.
  87. X -+ <days>: Cast chart for specified no. of days in the future.
  88. X -- <days>: Cast chart for specified no. of days in the past.
  89. X
  90. XSwitches which determine in what format the chart is displayed:
  91. X -v: Display list of object positions (chosen by default).
  92. X -v0: Like -v but express velocities relative to average speed.
  93. X -w: Display chart on screen in a graphic house wheel format.
  94. X -w0: Like -w but show objects in houses 4..9 in reverse order.
  95. X -g: Display aspect and midpoint grid among planets.
  96. X -g0: Like -g but flag aspect configurations (e.g. Yod's) too.
  97. X -g0: For comparison charts, show midpoints instead of aspects.
  98. X -ga: Like -g but indicate applying instead of difference orbs.
  99. X -Z: Display planet locations with respect to the local horizon.
  100. X -S: Display x,y,z coordinate positions of planets.
  101. X -I: Display interpretation of planetary influences.
  102. X -L [<step>]: Display astro-graph locations of planetary angles.
  103. X -L0 [..]: Like -L but display list of latitude crossings too.
  104. X -d: Print all aspects and changes occurring in a day.
  105. X -d0: Like -d but print all aspects for the entire month.
  106. X -dp <month> <year>: Print aspects within progressed chart.
  107. X -e: Print all options for chart (i.e. -v-w-g0-Z-S-I-L0-d).
  108. X
  109. XSwitches which affect how the chart parameters are obtained:
  110. X -n: Compute chart for this exact moment using current time.
  111. X -a <month> <date> <year> <time> <zone> <long> <lat>:
  112. X     Compute chart automatically given specified data.
  113. X -z: Assume Daylight time (change default zone appropriately).
  114. X -z <zone>: Change the default time zone (for -d-q-T-E options).
  115. X -l <long> <lat>: Change the default longitude & latitude.
  116. X -q <month> <date> <year>: Compute chart for noon on date.
  117. X -q0 <month> <date> <year> <time>: Like -q but include time too.
  118. X -i <file>: Compute chart based on info in file.
  119. X -o <file> [..]: Write parameters of current chart to file.
  120. X -o0 <file> [..]: Like -o but output planet/house positions.
  121. X
  122. XOther features or major modes:
  123. X -r <file1> <file2>: Compute a relationship synastry chart.
  124. X -rc <file1> <file2>: Compute a composite chart.
  125. X -rm <file1> <file2>: Compute a time space midpoint chart.
  126. X -r0 <file1> <file2>: Keep the charts separate in comparison.
  127. X -t <file>: Compute current house transits for particular chart.
  128. X -T <file> <month> <year>: Compute all transits in month for chart.
  129. X -T0 <..>: Like -T but include transits of the Moon as well.
  130. X -Tp <file> <month> <year>: Compute all progressions in month for chart.
  131. X -E <month> <year>: Display ephemeris for given month.
  132. X -E0 <..>: Like -E but include Chiron and the asteroids as well.
  133. X
  134. XSwitches to access X window options:
  135. X -X: Create a graphics chart instead of displaying it as text.
  136. X -Xb: Create X bitmap instead of putting graphics in window.
  137. X -XB: Display X chart on root instead of in a separate window.
  138. X -Xm: For color monitors, display charts in black and white.
  139. X -Xr: Create window or bitmap in reversed colors (B on W).
  140. X -Xw <hor> [<ver>]: Change the size of the chart window.
  141. X -Xs <percentage>: Change the size of characters by n%.
  142. X -Xi: Display chart in slightly modified form.
  143. X -XT: Inhibit display of chart info at bottom of window.
  144. X -XW: Simply create the bitmap of the world.
  145. X -XP: Create the bitmap of the world, but as a polar projection.
  146. X -XG [<degrees>]: Display the bitmap of the world as a globe.
  147. X -Xn: Start up chart or globe display in animation mode.
  148. X -Xo <file>: Write output bitmap to specified file.
  149. XAlso, press 'H' within X window for list of key press options.
  150. X
  151. X
  152. XAstrolog window keypress options (version 2.25):
  153. X Press 'H' to display this list of key options.
  154. X Press 'p' to toggle pause status on or off.
  155. X Press 'x' to toggle fg/bg colors in window.
  156. X Press 'm' to toggle color/monochrome display in window.
  157. X Press 'T' to toggle header info on current chart in window.
  158. X Press 'i' to toggle status of the minor chart modification.
  159. X Press 'l' to toggle labeling of object points in chart.
  160. X Press 'v' to display current chart in window on text screen.
  161. X Press 'R' to toggle restriction status of minor objects.
  162. X Press 'C' to toggle restriction status of minor house cusps.
  163. X Press 'u' to toggle restriction status of uranian planets.
  164. X Press 'U' to toggle restriction status of fixed stars.
  165. X Press 's', 'h', 'f', 'F' to toggle status of siderial zodiac,
  166. X        heliocentric charts, domal charts, and decan charts.
  167. X Press 'O' and 'o' to recall/store a previous chart from memory.
  168. X Press 'Q' to resize wheel chart display to a square.
  169. X Press 'B' to dump current window contents to root background.
  170. X Press '<' and '>' to decrease/increase the scale size of the
  171. X       glyphs and the size of world map.
  172. X Press '[' and ']' to decrease/increase tilt in globe display.
  173. X Press 'N' to toggle animation status on or off. Charts will
  174. X       be updated to current status and globe will rotate.
  175. X Press '!'-'(' to begin updating current chart by adding times.
  176. X       !: seconds, @: minutes, #: hours, $: days, : months,
  177. X       ^: years, &: years*10, *: years*100, (: years*1000.
  178. X Press 'r' to reverse direction of time-lapse or animation.
  179. X Press '1'-'9' to set rate of animation to 'n' degrees, etc.
  180. X Press 'V','L','A','Z','S','W','G','P' to switch to normal (-v),
  181. X       astrograph (-L), grid (-g), local (-Z), space (-S),
  182. X       world (-XW), globe (-XG), and polar (-XP) modes.
  183. X Press 'q' to terminate the window and program.
  184. X
  185. X Left   mouse button: Draw lines on chart in window.
  186. X Middle mouse button: Print coordinates of pointer on world map.
  187. X Right  mouse button: Terminate the window and program.
  188. X
  189. X
  190. X**********************************
  191. XDESCRIPTION OF EACH COMMAND SWITCH
  192. X**********************************
  193. X
  194. XNote: When specifying command switches, the leading dashes are
  195. Xoptional, and aren't necessary. For example, the command "astrolog -i
  196. Xchartfile -R -u -U -Z -Xs 300 -Xi -XB" can be abbreviated as "astrolog
  197. Xi chartfile R u U Z Xs 300 Xi XB". (This is subject to a couple of
  198. Xminor limitations, in that one can't have the -1 or -3 option follow a
  199. X-R restriction list of numbers, for obvious reasons.)
  200. X
  201. X----
  202. X
  203. XAstrolog command switches (version 2.25) (June 1992):
  204. X
  205. X-H: Display this help message.
  206. X
  207. X  This option displays a list exactly like the one given above on the
  208. X  screen.
  209. X
  210. X-O: Display available planets and other celestial objects.
  211. X
  212. X  Similar to the -A option below, the -O option will list all the
  213. X  planets and other celestial objects used by the program, and their
  214. X  numbers as recognized by the -R restrictions mentioned below. This
  215. X  list will also show the zodiac signs that planets rule, fall in, are
  216. X  exalted in, and debilitated in. (Remember that when -O is encountered,
  217. X  it immediately executes and terminates the program, so any modifying
  218. X  switches must be before it.)
  219. X
  220. X-O0: Line -O but ignore any restrictions.
  221. X
  222. X  The -O switch above simply displays a list of all the objects, cusps,
  223. X  uranians, and stars, along with their index numbers. This list can be
  224. X  affected by the -R restrictions, and the -C, -u, and -U switches must
  225. X  be included in order for all of Astrolog's objects to get listed. In
  226. X  order to make it easier to simply display a list of all 78 objects
  227. X  Astrolog recognizes, the new -O0 option is just like -O (and is
  228. X  equivalent to "-C -u -U -O") except that it will ignore all
  229. X  restrictions and always list every object. Stars are printed in the
  230. X  list along with their azimuth, altitude, and brightness values.
  231. X
  232. X-R [<obj1> [<obj2> ..]: Restrict specific bodies from displays.
  233. X
  234. X  The ability to restrict the transit (-T) and daily aspect (-d) scans
  235. X  to just certain bodies has been implemented with the -R switch. Using
  236. X  -R by itself will prevent the asteroids, Chiron, the Part of Fortune
  237. X  and the Vertex from being in any of the lists. One may also give a
  238. X  list of one or more numbers representing planets to be ignored (e.g. 1
  239. X  = Sun, 2 = Moon, 3 = Mercury, etc) so that a complete custom setup can
  240. X  be obtained (e.g. -R 1 2 3 4 5 will cause all of the inner planets to
  241. X  be ignored). More than one -R switch can be combined (e.g. -R -R 16
  242. X  will cause the asteroids, etc, and the North Node to be ignored; the
  243. X  first -R gets rid of the asteroids, etc, and the second one deletes
  244. X  the North Node.) Also, specifying the same particular body more than
  245. X  once will cause it to be included again, or in other words, -R
  246. X  <objectnum> complements the status of whether it is to be ignored or
  247. X  not (e.g. -R -R 15 will cause all of the asteroids, etc, excluding
  248. X  Vesta, to be ignored; the first -R makes causes the asteroids to be
  249. X  ignored, and specifying Vesta in the second -R makes it reappear.)
  250. X
  251. X-R0 [<obj1> ..]: Like -R but restrict everything first.
  252. X
  253. X  The -R0 option will cause ALL of the bodies to be ignored, which is
  254. X  useful if you are looking for just the transits/aspects of a few
  255. X  planets (e.g. -R0 6 7 will cause everything but Juptier and Saturn to
  256. X  be ignored.) Combining all these methods can cause whatever you are
  257. X  looking for in transits and aspects to be quickly found without having
  258. X  to wade through lots of stuff you aren't interested in.
  259. X
  260. X-R[C,u,U]: Restrict all minor cusps, all uranians, or stars.
  261. X
  262. X  These three switches are similar to the -R0 option in that they
  263. X  initially restrict objects, i.e. all the minor cusps, Uranians, and
  264. X  stars, (described below) respectively from appearing. For example, if
  265. X  you want to include only the star Sirius in an X window chart without
  266. X  having to also include all the other stars (or having to enter a very
  267. X  long restriction list), do: "astrolog -U -RU 48 -X", which will
  268. X  include the stars, and then restrict them all except Sirius, before
  269. X  making the chart.
  270. X
  271. X-C: Include non-angular house cusps in charts.
  272. X
  273. X  This option must be indicated to include the four minor house cusps
  274. X  (i.e. 11th, 12th, 2nd, 3rd) in the various chart options, such as the
  275. X  -g aspect grids, -T transit searches, the X wheel chart, etc. This
  276. X  option of course won't have any effect on certain charts where only
  277. X  physical bodies are shown (e.g. -Z, -S, -L) or where all house cusps
  278. X  are already indicated in the chart (e.g. -v, -w).
  279. X
  280. X-u: Include transneptunian/uranian bodies in charts.
  281. X
  282. X  Display the locations of the "Uranian" planets with the -u switch.
  283. X  Transneptunian or Uranian planets are an interesting subset of
  284. X  astrology which includes various objects alleged to be beyond Pluto.
  285. X  (Do: astrolog -u -O to list the eight Uranian bodies.) Anyway,
  286. X  Astrolog will display the zodiac positions of these planets as well if
  287. X  one includes this option, and will print their positions after the
  288. X  main planets, or include them in the other chart types. (Note: the
  289. X  Uranians don't have any formal glyphs that I'm aware of, so therefore
  290. X  they are displayed in the X charts as three letter abbreviations of
  291. X  their name.)
  292. X
  293. X-U: Include locations of fixed background stars in charts.
  294. X
  295. X  Astrolog has the ability to display the positions of 46 of the
  296. X  brightest and most important stars in the sky. To include these stars
  297. X  in a chart, use the -U "universe" option. The 43 brightest stars, i.e.
  298. X  all those with apparent magnitude values < 2.0 are included, in
  299. X  addition to three dimmer stars which are considered significant, i.e.:
  300. X  Polaris the North star, the Pleiades star cluster (home of our
  301. X  extraterrestrial cousins), and Zeta Reticuli (home of the Grey
  302. X  aliens.) One bright star is called "Orion", which is formally Alnilam,
  303. X  the middle star of Orion's belt. Since stars are fixed in the sky,
  304. X  they will never change position in the -s siderial zodiac, although
  305. X  they will slowly precess forward in the normal tropical zodiac. The -R
  306. X  restriction option can be used to determine which stars are actually
  307. X  included, although the -U option needs to be included to get any stars
  308. X  at all. In X windows, the stars are denoted by three letter
  309. X  abbreviations (as are the uranians and minor house cusps), and are
  310. X  colored according to their brightness: yellow for stars brighter than
  311. X  (less than) magnitude 0.0, gold for dimmer ones from 0.0 to 1.0,
  312. X  orange for those from 1.0 to 2.0, and finally the dimmest special
  313. X  stars with a magnitude greater than 2.0 are red.
  314. X
  315. X-U[z,l,n,b]: Order by azimuth, altitude, name, or brightness.
  316. X
  317. X  In the -v standard chart, -Z horizon chart, and in the -O object list,
  318. X  where all the stars are printed sequentially, it can sometimes be
  319. X  confusing to locate the star you want among 42 others. The -U option
  320. X  can be modified to sort the stars in various ways. If one uses -Ub
  321. X  instead of just -U, the stars will be listed in order from brightest
  322. X  to dimmest. Doing -Un instead of -U will alphabetize the stars by
  323. X  name. -Ul will sort them by their altitude from highest in the sky to
  324. X  lowest, while -Uz will sort them by their zodiac position. Note that
  325. X  any star ordering will have no visible effect in X windows, and one
  326. X  must still use the default ordering when passing numbers to the -R
  327. X  option to restrict various stars.
  328. X
  329. X-A [<0-18>]: Display available aspects or limit their number.
  330. X
  331. X  The '-A' command switch gives a list of all 18 supported aspects,
  332. X  their abbreviations as used in the aspect grids, their angles, and
  333. X  their orbs. It will list the number of each aspect in addition to all
  334. X  the other info already there (e.g. conjunct = 1, opposition = 2, etc.)
  335. X  so one can easily figure out what exact number to pass to the -A
  336. X  option when changing the number of aspects used (see below). Finally,
  337. X  it will display a brief verbal description of what each aspect glyph
  338. X  look like. This is in case one doesn't know what aspects the weird
  339. X  symbols in the -g -X window displays are referring to.
  340. X
  341. X  For those who don't like all these aspects, specifying -A <number>
  342. X  will limit the number of aspects (e.g. -A 5 will make charts with only
  343. X  the five major aspects listed in them).
  344. X
  345. X-Ao <orb1> [<orb2> ..]: Specify max orbs for each aspect.
  346. X
  347. X  Change the default orbs of the various aspects with the -Ao <orb1>
  348. X  <orb2>... <orbn> switch. Do you not like the 7 degree orbs for
  349. X  conjunctions that are in there by default? One can change the first n
  350. X  aspect orbs (i.e. as many orb values that one puts after the -Ao)
  351. X  anywhere from just the conjunction to all 18 aspects. Non-integer
  352. X  values are allowed of course. Use negative orb values to completely
  353. X  eliminate an aspect from ever appearing. For example: astrolog -A 6
  354. X  -Ao 5 5 -1 10 narrows the orbs for Conjunction and Opposition,
  355. X  completely eliminates the Square, widens the orb for Trines, and
  356. X  leaves the Sextiles and Inconjuncts in the default values. Note that
  357. X  for very wide orbs more than one aspect may apply for a particular
  358. X  angle, in which case the more fundamental aspect is chosen. Also for
  359. X  wide aspects the decimal value of the orb may be lost in the -g text
  360. X  grid (due to too many characters) and their might be some slight
  361. X  overlap in the X window -g cells.
  362. X
  363. X-AO [..]: Like -Ao but suspend objects' max orb restrictions.
  364. X
  365. X  Note that Astrolog imposes restrictions on the max orb that any
  366. X  particular aspect can have to certain particular objects, namely the
  367. X  node, fortune, and vertex, which can't and shouldn't have aspects to
  368. X  them in excess of 2 degrees. One can suspend these restrictions by
  369. X  replacing the -Ao <orbs> option above, invoking it as -AO <orbs>
  370. X  instead. For a fun (and perhaps useful) display, try: astrolog -A 1
  371. X  -AO 180 -g [-X], and see everything conjunct everything else.
  372. X
  373. X
  374. XSwitches which affect how a chart is computed:
  375. X
  376. X-c <value>: Select a different default system of houses.
  377. X(0 = Placidus, 1 = Koch, 2 = Equal, 3 = Campanus, 4 = Meridian,
  378. X5 = Regiomontanus, 6 = Porphry, 7 = Morinus, 8 = Topocentric, 9 = None.)
  379. X
  380. X  Ten different house systems are supported: Invoke as astrolog -c
  381. X  <number> to change the system from the default of Placidus. (System 9
  382. X  refers to no houses at all, or in other words where the Ascendant will
  383. X  always be 0 degrees Aries, the Nadir 0 degrees Cancer, etc, which is
  384. X  useful for the extended chart animations as described later where
  385. X  having houses at all can tend to get in the way, and one can even
  386. X  observe the precession of the equinoxes with this system if used in
  387. X  conjunction with the -s siderial chart option.)
  388. X
  389. X-s: Compute siderial instead of the normal tropical chart.
  390. X
  391. X  With this option, the chart will be just like the normal charts as
  392. X  most commonly used in astrology, except that all the zodiac positions
  393. X  will be shifted (to be about 24 degrees earlier). This is because the
  394. X  option casts siderial charts which are based on the positions of the
  395. X  fixed stars (i.e. Aries starts at the constellation Aries) rather than
  396. X  the seasons (i.e. Aries starts at the Spring or Vernal Equinox.) Due
  397. X  to the "precession of the equinoxes" the the position of the Sun at
  398. X  the Equinoxes has been gradually happening at an earlier point in the
  399. X  siderial zodiac each year (taking about 2100 years change signs.)
  400. X
  401. X-s0: Display locations as right ascension instead of degrees.
  402. X
  403. X  For astronomers out there, this -s0 option will print all planetary
  404. X  positions in the right ascension hours/minutes format instead of the
  405. X  sign/degrees/minutes astrologers are accustomed to. This will affect
  406. X  how the objects are listed in the -v display, and how the star
  407. X  azimuths are displayed in the -O list. For example, 0 degrees Aries is
  408. X  represented as 0 hr, 0 min; 0 Cancer goes to 6 hr, 0 min, and so on
  409. X  through the 24 hour clock.
  410. X
  411. X-h [<objnum>]: Compute positions centered on specified object.
  412. X
  413. X  Normal astrology charts are based on the positions of the planets
  414. X  relative to the Earth. However, this option allows seeing of the
  415. X  zodiac positions with respect to the Sun's (or any other planet's)
  416. X  point of view. The -h option when invoked by itself will display a
  417. X  heliocentric chart: the Sun in the original listing will be replaced
  418. X  with the Earth's position as seen from the Sun in the heliocentric
  419. X  chart, with the other planets' positions modified accordingly. For
  420. X  bodies other than the Sun, the option takes a parameter to indicate
  421. X  which planet to center the chart on, e.g. do -h 5 to cast a Mars
  422. X  centered chart. (Moon centered charts aren't allowed; in fact, note
  423. X  that the -h option won't ever affect the Moon, which will always be
  424. X  displayed as seen from the Earth, no matter what the center body is
  425. X  set to, since it's not a formal planet.
  426. X
  427. X-p <month> <day> <year>: Cast progressed chart based for date.
  428. X
  429. X  A secondary progression chart for a particular date can be cast using the
  430. X  '-p <month> <date> <year>' command switch. (Note, I'm not sure if the house
  431. X  cusps are progressed correctly, but they're reasonably close to what is
  432. X  properly expected.)
  433. X
  434. X-pn: Cast progressed chart based on current date now.
  435. X
  436. X  The -pn switch is like the -p <month> <date> <year> switch except that
  437. X  (like the -n switch) it assumes the current moment now to cast the
  438. X  progressed chart to. This is just another shorthand convenience to see
  439. X  what ones progressed chart is like presently; just do: astrolog -i
  440. X  file -pn.
  441. X
  442. X-p0 <days>: Set no. of days to progress / day (default 365.25).
  443. X
  444. X  User definable progression rates can be specified with this option.
  445. X  When using the -p progression option, Astrolog assumes you want the
  446. X  standard "year for a day" rate of secondary progressions. By passing
  447. X  different values to the -p0 switch, one can change the default "365.25
  448. X  days for a day" to any value they want for some less often used method
  449. X  of progression. For example, one can do "-p0 7 -pn" to do a week for a
  450. X  day, "-p0 -365.25 -pn" to get negative year for day progressions, and
  451. X  so on. (Note that "-p0 1" would be the same as if no progression were
  452. X  done at all.)
  453. X
  454. X-x <1-360>: Cast harmonic chart based on specified factor.
  455. X
  456. X  Harmonic charts (i.e. where all the planet positions are multiplied by a
  457. X  factor and the chart recast) are supported via the '-x' option. (e.g.
  458. X  -x 3 will make all trines conjunct in the chart displayed.)
  459. X
  460. X-1 [<objnum>]: Cast chart with specified object on ascendant.
  461. X
  462. X  The -1 <obj> option can be used to change the houses to force a
  463. X  particular object to be on the ascendant. This is useful in casting
  464. X  Solar charts or for when the time of birth is not exactly known. For
  465. X  example -1 2 will case a normal chart, but the house cusps will be
  466. X  rotated so that the moon is on the ascendant.
  467. X
  468. X-3: Display objects in their zodiac decan positions.
  469. X
  470. X  Decan displays are supported in Astrolog, and one can display a decan
  471. X  influenced chart with the -3 switch. The decan theory is that each
  472. X  sign in the zodiac can be divided into three parts: The first 10
  473. X  degrees (i.e. the first decan) is mainly influenced by the sign in
  474. X  question, the second 10 degrees (second decan) although still
  475. X  influenced by the sign in question is also somewhat influenced by the
  476. X  next sign of the same element, while the last decan is influenced by
  477. X  the third sign of the same element. The -3 switch applied to a chart
  478. X  will move each object into the sign of its decan. For example, if the
  479. X  Sun is at 29 degrees Aquarius and the Moon at 5 degrees Virgo, in the
  480. X  resulting chart, the Sun will go to Libra (26 degrees) and the Moon
  481. X  will remain in Virgo (although be at 15 degrees now since it was
  482. X  previously in the middle of the first decan of Virgo.)
  483. X
  484. X-f: Display houses as sign positions (flip them).
  485. X
  486. X  The -f option can be used to "flip" the signs and houses, i.e. display
  487. X  the house as a sign position and vice versa. For example having the
  488. X  Sun at 26 degrees Scorpio, 2/3 way though the 10th house, will cause
  489. X  the resulting Sun under the -f option to be at 20 degrees Capricorn,
  490. X  26/30th the way through the 8th house. This can be used to determine
  491. X  how far a planet is through a particular house, as well as for Domal
  492. X  chart analysis that Mark Kenski has informed me about. Domal analysis
  493. X  is based on the fact that for synastry comparisons, for example, a
  494. X  planet in Gemini and one in the 3rd house can be considered related in
  495. X  a way similar to a conjunction.
  496. X
  497. X-G: Display houses based on geographic location only.
  498. X
  499. X  This switch generates a special type of locational analysis chart,
  500. X  called a geodetic chart, in which the house cusps are computed from a
  501. X  different source, i.e. as a function of only the longitude and
  502. X  latitude. This basically gives every spot on the planet a different
  503. X  unique set of house cusps, and can be used to analyze the
  504. X  characteristics of different areas, and their influence on you if you
  505. X  insert your own planets in the houses. This type of chart was
  506. X  described in the January 1992 issue of Dell Horoscope magazine, from
  507. X  which I learned how to generate these charts. Basically, the Midheaven
  508. X  is approximately the longitude value converted from degrees into the
  509. X  appropriate zodiac sign; for example 0 degrees E goes to 0 degrees
  510. X  Aries, 30 degrees E goes to 0 degrees Taurus, etc.
  511. X
  512. X-+ <days>: Cast chart for specified no. of days in the future.
  513. X
  514. X  The -+ <#ofdays> option will cast a normal chart, but one for #ofdays in
  515. X  the future (or past if a negative value is given). One use for this is in
  516. X  combination with the -n and -d options. For instance, I often invoke the
  517. X  program as "astrolog -n -d" to see the exact times of today's aspects.
  518. X  However, just before midnight I might want to see what's going to happen
  519. X  in the following day, so I would do "astrolog -n -d -+ 1" to see the exact
  520. X  times for tomorrow's aspects.
  521. X
  522. X-- <days>: Cast chart for specified no. of days in the past.
  523. X
  524. X  This new "dash minus" option is just like the "dash plus" (-+) option
  525. X  described above, except it subtracts instead of adds the specified
  526. X  number of days from any chart cast. This is only for convenience, in
  527. X  that "-- 1" is the same as "-+ -1".
  528. X
  529. X----
  530. X
  531. XSwitches which determine in what format the chart is displayed:
  532. X
  533. X-v: Display list of object positions (chosen by default).
  534. X
  535. X  This is just a formal specification for the standard chart listing of
  536. X  the planetary positions. One will get this chart by default if they
  537. X  don't specify any other chart types, and they will get it along with
  538. X  everything else in the -e option. Although it isn't necessary, it must
  539. X  be included if one wants this type of chart to be displayed along with
  540. X  some of the other chart types described below.
  541. X
  542. X-v0: Like -v but express velocities relative to average speed.
  543. X
  544. X  This switch is just like -v except that it modifies the planet
  545. X  velocities slightly. (See later for a description of these velocity
  546. X  fields.) Normally, it isn't a trivial task to determine precisely when
  547. X  a planet is going to change direction. This is because, for example,
  548. X  although a velocity of 0.010 degrees/day for fast moving Mercury means
  549. X  it's about to turn retrograde, the same velocity value is normal for
  550. X  slow moving Pluto. The -v0 switch divides the normal velocity values
  551. X  by how fast each planet moves with respect to the Sun, meaning that
  552. X  all planets will now have an average *relative* velocity value of
  553. X  1.000, and in all cases, a velocity of 2.000 means the planet is
  554. X  moving twice as fast as normal, and one of 0.010 means the planet is
  555. X  about to turn retrograde.
  556. X
  557. X-w: Display chart on screen in a graphic house wheel format.
  558. X
  559. X  Display of the chart in a nice wheel format is supported using the
  560. X  '-w' switch. (Special error case: If one of the houses gets too 'full'
  561. X  of planets, the planet will be put at the beginning of the next
  562. X  house.) The same chart header information as is at the top of the
  563. X  standard -v chart is printed in the middle of the wheel.
  564. X
  565. X-w0: Like -w but show objects in houses 4..9 in reverse order.
  566. X
  567. X  In the -w text wheel option, the objects in each house are printed
  568. X  from top to bottom in order from earliest in the house to latest. This
  569. X  looks good except for in houses 5..8 where this would appear backwards
  570. X  (e.g. a planet having just entered the 6th house from the 5th would be
  571. X  displayed right under the Descendant.) Therefore the objects from
  572. X  houses 4 through 9 are reversed and printed in order from bottom to
  573. X  top, making a more flowing looking wheel chart. If however, one always
  574. X  wants each house to be filled from its top to bottom regardless of
  575. X  which house, replace the -w with the -w0 switch
  576. X
  577. X-g: Display midpoint & aspect grid instead of positions.
  578. X
  579. X  Aspects and midpoint display are supported: Invoke as astrolog -g and
  580. X  a 20x20 grid showing the midpoint locations for each planet, and
  581. X  showing if any aspects are present and how accurate they are, is
  582. X  displayed. The planets are labeled down the diagonal of the grid, with
  583. X  the aspects to the lower left and the midpoints in the upper right.
  584. X  This is of course often used along with the -A* switches.
  585. X
  586. X  Note that there is a way in the aspect grids to determine whether an
  587. X  aspect is slightly short of exact or slight long of exact. If the
  588. X  difference is displayed as "3.5" it means the aspect is 3.5 degrees
  589. X  long of exact; if it's displayed as "3,5", the aspect is 3.5 degrees
  590. X  short. (i.e. with a comma instead of a period; Yeah, I know that's a
  591. X  hack, but it's useful in determining whether the exact aspect just
  592. X  happened or is about to happen. (Note that conjuncts are always '.',
  593. X  and oppositions always ','.)
  594. X
  595. X  Wider orbs are allowed for the Sun and Moon in the aspect grids.
  596. X  Normally, only the aspect in question determines the allowed orb, but
  597. X  the Sun and Moon will each add 1 degree to whatever the orb would have
  598. X  been. (This excludes minor objects such as the North Node, Part of
  599. X  Fortune, Vertex, and all the stars, for which the orbs are not allowed
  600. X  to ever exceed two degrees.)
  601. X
  602. X-g0: Like -g but flag aspect configurations (e.g. Yod's) too.
  603. X
  604. X  Search through the aspect grid for major aspect configurations,
  605. X  including Grand Trines, T-Squares, Grand Crosses, Yod's, Cradles, and
  606. X  Stelliums, with the -g0 option. (In a Stellium, three objects must all
  607. X  be conjunct with each other.) This option will produce the same aspect
  608. X  grid that -g displays, but afterwards will go through the grid and
  609. X  list any of these aspect configurations and what objects are forming
  610. X  them. (Of course, to see any Yod's, one has to -A 6 or more so that
  611. X  Inconjuncts will be included in the aspect grid.)
  612. X
  613. X-g0: For comparison charts, show midpoints instead of aspects.
  614. X
  615. X  For relationship aspect grids, the -g0 option will display a midpoint
  616. X  grid instead of an aspect grid between the planets in the two charts
  617. X  e.g. "-r0 chart1 chart2 -g0". (See later for descriptions of the
  618. X  relationship charts.)
  619. X
  620. X-ga: Like -g but indicate applying instead of difference orbs.
  621. X
  622. X  Ability to determine whether an aspect is applying or separating (is
  623. X  about to happen or just happened) is included in the -g option.
  624. X  Normally the aspect orbs are flagged as being '+' or '-' ('.' or ','
  625. X  in the text displays) based on whether they are greater or less than
  626. X  the exact amount (e.g. a 91 degree Square has a +1 degree orb while a
  627. X  89 degree one a -1 orb.) If one, however, invokes the -g option as -ga
  628. X  instead, a negative orb will indicate an applying aspect while a
  629. X  positive orb a separating one. (To estimate applying vs. separating,
  630. X  the program examines the planetary positions and their relative
  631. X  velocities at the time in question.)
  632. X
  633. X-Z: Display planet locations with respect to the local horizon.
  634. X
  635. X  The text display switch -Z prints out where each object is on the
  636. X  local horizon in terms of altitude and azimuth. For each object, the
  637. X  following is displayed: Its altitude on the local horizon from +90
  638. X  degrees (straight up) to -90 degrees (straight down), and its azimuth
  639. X  from 0..360 degrees, where 0 = due east, 90 = north, 180 = west, 270 =
  640. X  south. To make visualizing the azimuth easier, an "azimuth vector"
  641. X  with a N/S component and a W/E component is displayed, e.g. (1.00s
  642. X  0.33w) means that the object is mainly south, with its true angle
  643. X  being formed by an vector component west that's 1/3 the strength of
  644. X  the south component, i.e. the object is about 18 degrees west of
  645. X  south. This along with the altitude should make it easy to physically
  646. X  point to where any planet is at any moment, making it easy to locate
  647. X  planets in the night sky. This feature can also be used to determine
  648. X  the times that a planet rises and sets. Also displayed are altitude
  649. X  and azimuth differences between each object and the Sun and Moon,
  650. X  first showing the number of degrees that the Sun/Moon is "ahead" (or
  651. X  farther east in the zodiac) of the object in question, and then the
  652. X  number of degrees that the Sun/Moon is above the object in question.
  653. X  This feature can be used to roughly predict eclipses! Both the Sun and
  654. X  Moon span about 0.5 degrees in the sky, therefore if both the azimuth
  655. X  and altitude differences are < 0.5 (or 1.0 if the difference is
  656. X  between the Sun and Moon themselves) then the object in question is
  657. X  probably being occulted somewhat by the Sun/Moon. Note that there are
  658. X  three types of planetary position displays: Right ascension and
  659. X  declination showing the object's position with respect to the stars,
  660. X  longitude and latitude showing where on the Earth the object is
  661. X  straight up (as in the astro-graph zenith locations), and finally
  662. X  azimuth and altitude showing the positions of the object relative to
  663. X  the local horizon.
  664. X
  665. X-S: Display x,y,z coordinate positions of planets.
  666. X
  667. X  Solar system space based charts are available with the -S switch,
  668. X  which give the astronomical positions of each planet in terms of x, y,
  669. X  and z coordinates. Although not directly useful astrologically, it
  670. X  does give one a good view of how the planets actually were positioned
  671. X  at the time in question. For example, normal astrology doesn't make
  672. X  the distinction between the four different "forms" of say, a Mercury
  673. X  Venus Conjunction, i.e. they can either be Conjunct on the near side
  674. X  of the Sun, Conjunct on the far side of the Sun, or one can be on one
  675. X  side and the other on the other side. When the chart is actually
  676. X  displayed, for each body the following information is printed: The
  677. X  relative angle of the planet with respect to the central body, i.e.
  678. X  its zodiac position converted to the appropriate number from 0..360.
  679. X  This is followed by the x, y, and z coordinate positions of the
  680. X  object, in astronomical units from the central body. The x-axis
  681. X  increases in the direction of 0 degrees Aries (tropical zodiac), the
  682. X  y-axis increases in the direction of 0 degrees Cancer, and the z-axis
  683. X  is with respect to the Earth's orbit (meaning that the Sun and Earth
  684. X  always have a z-axis value of 0.0). Finally the overall length from
  685. X  the central body in AU is printed, which is just the diagonal as
  686. X  indicated by the x, y, z vectors. (The Earth and Sun are of course
  687. X  always about 1.0 AU from each other.) The Moon circles the Earth and
  688. X  isn't a part of the solar system proper; therefore, it is never in
  689. X  these charts. The -e everything option will include this chart in its
  690. X  listing of all the chart displays.
  691. X
  692. X-I: Display interpretation of planetary influences.
  693. X
  694. X  Another chart type is available - interpretation of influences. This
  695. X  is the beginning of a general interpretation ability for the program,
  696. X  although all it does now is calculate the relative "power" of each
  697. X  planet's placement, giving a general idea of the prominent areas of a
  698. X  chart. When such a chart is printed, each planet is given a point
  699. X  value, larger numbers indicating more strength. Each planet's strength
  700. X  is divided between two fields: the positioning in and of itself, and
  701. X  the power of the aspects it makes with the other planets. In addition
  702. X  to each field, the total of these two areas is printed, as well as the
  703. X  relative percentage of the planet in question with respect to all the
  704. X  planets combined. Each planet gets a ranking for its positioning,
  705. X  aspects, and total power as well, with the strongest getting #1, the
  706. X  next strongest #2, etc. The -e option will include this chart along
  707. X  with all the others as well in it's listing of all the chart displays.
  708. X
  709. X  To determine the strength of the positioning of a planet, various
  710. X  things are taken into account: 1) The power of a planet in and of
  711. X  itself, e.g. the Sun and Moon are more powerful then the other
  712. X  planets. 2) The house placement of a planet, e.g. a planet in the 1st
  713. X  house is more powerful than one in the 2nd. 3) Whether a planet is in
  714. X  the sign it rules or is exalted in, e.g. Jupiter in Sag results in
  715. X  more power to Jupiter. 4) Whether a planet is in the house
  716. X  corresponding to the sign it rules or is exalted in, e.g. Jupiter in
  717. X  the 9th house. 5) Planets get more power if the signs they rule are
  718. X  occupied, e.g. a bunch of stuff in Aquarius gives more power to
  719. X  Uranus. 6) Planets get more power if the houses they rule are
  720. X  occupied, e.g. a bunch of stuff in the 11th house gives power to
  721. X  Uranus. 7) Finally, planets get power according to what houses the
  722. X  cusps of which fall in the signs they rule, i.e. the ruler of the
  723. X  Ascendant (and to less extent the Midheaven, and so on) gets lots of
  724. X  influence. Determining the strength of a planet's aspects is much
  725. X  easier, and is basically composed of the sum of the strength of each
  726. X  aspect the planet makes. Taken into account are: 1) The inherent
  727. X  influence of the planet being aspected to, e.g. Sun conjunct Jupiter
  728. X  gives more influence to Jupiter than Mercury conjunct Jupiter would.
  729. X  2) The influence of the aspect itself, e.g. Oppositions are more
  730. X  powerful then Sextiles. 3) Finally the orb of the aspect, i.e. exact
  731. X  aspects are more powerful than wide ones. (The influence of the orb
  732. X  varies linearly from max power at exact to zero power at the limit of
  733. X  the orb - sorry Maggie M. and Mark K. - no complex aspect wave
  734. X  functions, at least for this version :)
  735. X
  736. X  Special thanks goes to Mark K. who initially presented this idea of
  737. X  interpreting overall influences to me. I basically just took his
  738. X  ideas, polished them a bit, and put it into the code. Interestingly,
  739. X  while programming this feature, I had a dream about him, in which he
  740. X  elaborated upon some of the ideas and even gave me suggestions for
  741. X  some of the planets' default power values (astral visitation?) And,
  742. X  while on the subject, I've had a couple of other Astrolog dreams; I
  743. X  had one neat one while working on the -h extension (described earlier)
  744. X  about a far distant future version of Astrolog that could actually
  745. X  teleport one to the places which they cast charts for :)
  746. X
  747. X-L [<step>]: Display astro-graph locations of planetary angles.
  748. X
  749. X  The '-L' option will take the standard chart information and generate
  750. X  the astro-graph positions of the planets. In other words, this does
  751. X  the exact same thing that Jim Lewis' Astro*Carto*Graphy maps do. It
  752. X  will display the longitude of where on the Earth at the time in
  753. X  question each object was on the midheaven and on the nadir, and the
  754. X  latitude of where the planets actually appeared at zenith. Also, for
  755. X  latitude increments of 5 degrees, the longitude of where the objects
  756. X  appeared on the ascendant and descendant is displayed. For text
  757. X  screens, one can pass an optional parameter to this -L (or -L0) option
  758. X  to change the default latitude step rate at which the Ascendant and
  759. X  Descendant lines are computed. Again, this value is by default 5
  760. X  degrees, although one can may increase or decrease it to any integer
  761. X  (subject to the restriction that the number 160 is divisible by it.)
  762. X
  763. X-L0: Like -L but display list of latitude crossings too.
  764. X
  765. X  Determination of latitude crossing points is included in the
  766. X  astro-graph routines! The -L0 option will do the same thing as the -L
  767. X  option, except that after displaying the longitude and latitude
  768. X  locations of the Asc/Desc/MC/IC lines, it will then search among the
  769. X  lines and display (in order from farthest North to farthest South) the
  770. X  latitude of any points where lines cross each other. This includes the
  771. X  curvey Asc/Desc lines crossing the straight MC/IC lines as well as
  772. X  cases where different Asc/Desc lines cross themselves. And unlike Jim
  773. X  Lewis' astro*carto*graphy, Astrolog will also display the longitude of
  774. X  the crossing (useful for Asc/Desc crossings) in addition to the
  775. X  latitude (as well allowing more planetary bodies to be included in the
  776. X  scan, and going farther North and South than Jim Lewis' printouts go.)
  777. X  Note however, that there is presently a small (very rare) minor
  778. X  omission glitch in the code, where if a crossing is within a couple of
  779. X  degrees of 180 deg W/E, it may not be displayed.
  780. X
  781. X-d: Print all aspects and changes occurring in a day.
  782. X
  783. X  The '-d' option will take the standard chart information, and for the
  784. X  day in question, display the exact times of all aspects that occur.
  785. X  This is just like the aspects-per-day as displayed in Jim Maynard's
  786. X  Celestial Guide books. (Displayed in local time as defined by the
  787. X  default zone, with accuracy to within a couple minutes.) This will
  788. X  tell any time two planets make aspects with each other, a planet
  789. X  changes its sign, or a planet goes retrograde or direct. Both the -d
  790. X  (and -T listed later) options will display the signs that any planets
  791. X  aspecting each other are in, in addition to the aspect itself (e.g.
  792. X  instead of just "Jupiter Tri Uranus", we have "Jupiter (Vir) Tri (Cap)
  793. X  Uranus". If a particular object is going retrograde, then its sign
  794. X  will be displayed in brackets instead of parentheses, and if a
  795. X  particular object is about to or has just gone retrograde or direct,
  796. X  then its sign will be in <>'s.
  797. X
  798. X-d0: Like -d but print all aspects for the entire month.
  799. X
  800. X  The -d option can now search the entire month for aspects between
  801. X  planets if one so desires. Specifying it as -d0 instead of just -d
  802. X  will go through the entire month instead of just the current day.
  803. X  (Combining this one with -R allows searching for important aspects,
  804. X  sign changes, etc.)
  805. X
  806. X-dp <month> <year>: Print aspects within progressed chart.
  807. X
  808. X  Another progression feature allows determining aspect times of
  809. X  progressed planets among themselves. The -i <file> -dp <month> <year>
  810. X  switch will, like the -d option, display times of aspects and sign
  811. X  changes, except that they will be for the chart in file, progressed
  812. X  throughout the month specified. Progressed planets move very slowly
  813. X  ("year for a day") so therefore there will usually be, if any, only a
  814. X  couple of aspects in a given month; again, one might want to
  815. X  substitute '0' for the month to scan the whole year. Also, since they
  816. X  move so slow, the accuracy is cut down, do the dates given are
  817. X  probably only accurate to the nearest day, in spite of the times given
  818. X  to the minute. Note that Astrolog can scan for aspects of: transiting
  819. X  planets among themselves (-d switch), transiting planets to natal
  820. X  planets (-T switch), progressed planets to natal planets (-Tp), and
  821. X  progressed planets among themselves (-dp). Only thing Astrolog can't
  822. X  do is do progressed planets to transiting planets, although that may
  823. X  change in the next version :)
  824. X
  825. X-e: Print all options for chart (i.e. normal & -w0-g0-Z-L0-d). There
  826. X
  827. X  are five main different formats of chart display available: The
  828. X  standard listing of planet positions, which you get without any
  829. X  switches; the aspect/midpoint grid you get with '-g', the house wheel
  830. X  you get with '-w', and so on. The -e "everything" option will display
  831. X  the chart in all five of these formats for about 650 lines of text!
  832. X
  833. X----
  834. X
  835. XSwitches which affect how the chart parameters are obtained:
  836. X
  837. X-n: Compute chart for this exact moment using current time.
  838. X
  839. X  For those with unix systems who can handle the time calls (If your
  840. X  system pukes on trying to compile that, simply comment out the #define
  841. X  TIME line at the beginning), the program supports displaying the chart
  842. X  for the time at the current moment! In other words, invoke as astrolog
  843. X  -n and see where the planets are right now. (This is fun - the house
  844. X  cusps change 1' about every 4 seconds!) You will need to change the
  845. X  #defines for the default longitude and latitude in astrolog.h, or else
  846. X  specify where you are explicitly by using the -l switch to change the
  847. X  default location. (To figure out the time zone, the program uses the
  848. X  default value as in the DEFAULT_ZONE constant set at compile time.)
  849. X
  850. X-a <month> <date> <year> <time> <zone> <long> <lat>:
  851. XCompute chart automatically given specified data.
  852. X
  853. X  Normally one generates a chart by entering the seven data coordinates
  854. X  manually. A fast typist familiar with the program might prefer to give
  855. X  all the data at once, which can be done with this option. Simply list
  856. X  the seven parameters above, in the exact format as they would be given
  857. X  to the program were the user being prompted for them.
  858. X
  859. X-z <zone>: Change the default time zone (for -d-q-T-E options).
  860. X
  861. X  The -z <value> option can be used to change the default time zone to
  862. X  the value in question. For example, you can force the -E ephemeris and
  863. X  -T transits to be displayed at midnight GMT time instead of the local
  864. X  time with -z 0; or, for the East coast where by default the time zone
  865. X  is "5", you can do -z 4 during DST to properly display transits,
  866. X  aspects in day, and other lists in the local DST zone.
  867. X
  868. X-z: Assume Daylight time (change default zone appropriately).
  869. X
  870. X  Normally the -z option takes an argument which will then become the
  871. X  default time zone. If one, however, invokes it by itself, it will
  872. X  subtract one hour from whatever the default time zone presently is.
  873. X  This is useful since it is equivalent to adjusting any times printed
  874. X  to Daylight time, i.e. it will add one hour to any times displayed.
  875. X  (When entering the birth time for charts, one is supposed to subtract
  876. X  one hour if Daylight time was in effect; note that subtracting one
  877. X  hour from the time zone will do the same thing.) For example, over
  878. X  here on the West Coast, I have my default time zone compiled to be
  879. X  "8"; now that Daylight time is in effect here, I can do -z 7 or just
  880. X  -z to decrease the default time zone when I make a -T transit list,
  881. X  which will in effect add one hour to the local times displayed, or in
  882. X  effect "Spring ahead" the clock for me. (For a better way of adjusting
  883. X  Astrolog for Daylight time without having to specify -z all the time,
  884. X  recompile the program, or add one hour to the times in your head, use
  885. X  the "defaults" file described later to edit the time zone.) Remember
  886. X  that the -z (and -l) switches must be before any other switches they
  887. X  modify (such as -n) in order for the new default to take effect.
  888. X
  889. X-l <long> <lat>: Change the default longitude & latitude.
  890. X
  891. X  Like the -z option, the -l option can be used to change the default
  892. X  compile time global coordinates used in certain options, such as the
  893. X  -n cast chart for right now switch.
  894. X
  895. X-q <month> <date> <year>: Compute chart for noon on date.
  896. X
  897. X  The -q <month> <day> <year> option can be used to cast a quick chart
  898. X  for 12 noon on a particular date, using the default longitude and
  899. X  latitude. The DEFAULT_ZONE compile time constant is used for the time
  900. X  zone. Again, one example where this is useful is with the -d option,
  901. X  e.g. to see the times of exact aspects on a particular date, like your
  902. X  next birthday, your finals, etc.
  903. X
  904. X-q0 <month> <date> <year> <time>: Like -q but include time too.
  905. X
  906. X  The -q0 <month> <date> <year> <time> option takes the four parameters
  907. X  and casts a chart for the time in question. The time zone and location
  908. X  are taken from the default compiled values. This is just yet another
  909. X  useful shorthand way to quickly make a chart. Note that this is just
  910. X  like the -q <month> <date> <year> option except that -q always casts
  911. X  it for noon in the default zone. Also note that the -a option which
  912. X  takes all seven chart parameters can be duplicated with -q0 along with
  913. X  the -z <zone> and -l <long> <lat> options.
  914. X
  915. X-i <file>: Compute chart based on info in file.
  916. X
  917. X  See the -o option below.
  918. X
  919. X-o <file> [..]: Write parameters of current chart to file.
  920. X
  921. X  The program supports directing chart information to, and reading
  922. X  output from, data files. The '-o' option will dump all the birth data
  923. X  (the date and stuff, not the planet positions) to the specified file.
  924. X  The '-i' option will cast the chart based on the info in the file.
  925. X  (This allows you to put your birth data into a specific file, and cast
  926. X  your chart whenever you want to after that without having to reenter
  927. X  your birth data all the time.)
  928. X
  929. X  Another file output feature, the ability to concatenate "comment
  930. X  lines" at the end of a data file, been been added to both the -o and
  931. X  -o0 options. (Some people have complained that the info in the
  932. X  Astrolog chart files are too cryptic.) After scanning the filename,
  933. X  the -o[0] option will then write any parameter that follows it at the
  934. X  end of the file, until a parameter beginning with a '-' (the next
  935. X  switch) is reached. For example: -o 'file' "Walter D. Pullen" Seattle
  936. X  will add my name and my birth city in two separate lines at the end of
  937. X  'file'. (In unix, quotes can be used to allow spaces within one
  938. X  parameter.)
  939. X
  940. X-o0 <file> [..]: Like -o but output planet/house positions.
  941. X
  942. X  Ability to write the actual sign and house positions of a chart to
  943. X  a file (instead of just the time and place) has been implemented via
  944. X  the -o0 <file> option. This option can be used interchangeably with
  945. X  the old -o output to file switch. The information written includes the
  946. X  zodiac position of the 20 main objects, their retrograde status and
  947. X  declination, as well as the positions of the (first six) house cusps.
  948. X  This file information can easily be passed into another program, and
  949. X  can be read back into Astrolog with the -i option. The -i option will
  950. X  automatically determine which type the file is, and will either use
  951. X  the given positions, or else calculate them as needed (note that some
  952. X  switches, such as the -c house system selection, will have no effect
  953. X  for this new file type.) Check an example of one of these files to see
  954. X  the precise format (a zodiac position is recorded as three numbers:
  955. X  degree in sign, sign as 1..12, and floating point minute within
  956. X  degree.) When the files are read back in, they will be flagged as
  957. X  "having no space or time" like the composite charts in the chart
  958. X  header displays.
  959. X
  960. X  This file format can allow one to do things such as transits to
  961. X  composite charts (send the composite chart to file with -o0 option and
  962. X  then use that file as the first parameter to the -T option) composites
  963. X  between two composite charts (use -rc between two composite charts
  964. X  sent to a file) and even, if one is willing to do a small amount of
  965. X  editing, to do transits to midpoints or the 0 degrees Aries point.
  966. X  Note that one can easily edit the positions in the -o0 position file
  967. X  to be whatever they like, so one could replace some unimportant object
  968. X  (like the vertex) with 0 degrees Aries or an important midpoint value.
  969. X  Note that trying to still use the -o time and space output with an
  970. X  output chart that doesn't have space/time will confuse the program; it
  971. X  will either say it can't make the file or else will output the
  972. X  time/space of the most recent parameter file it read in.
  973. X
  974. X----
  975. X
  976. XOther features or major modes:
  977. X
  978. X-r <file1> <file2>: Compute a relationship chart.
  979. X
  980. X  Computing the relationship between two charts is supported. Invoke the
  981. X  program as 'astrolog -r <file_of_person1> <file_of_person2>' and the
  982. X  program will give you the relationship between the two charts. In
  983. X  other words, the program will use the positions of person2's planets
  984. X  and person1's houses. Use this with the -w option to get a wheel chart
  985. X  and you can do synastry. Note that transits can be computed with this
  986. X  by comparing your chart with the positions of the planets at the
  987. X  current moment (as in -n switch). To make this easier, you may specify
  988. X  the filename "now" for any file and the computer will use the current
  989. X  planet positions instead of looking for a like named file. (e.g.
  990. X  'astrolog -r me now' will compute transits for file 'me'.)
  991. X
  992. X-rc <file1> <file2>: Compute a composite chart.
  993. X
  994. X  The '-r' option can be used to generate composite relationship charts.
  995. X  Simply invoke it as '-rc <person1> <person2>' instead of just -r and a
  996. X  composite chart (i.e. composed of the midpoints of the planets, etc.
  997. X  of the two charts in question) will be generated.
  998. X
  999. X-rm <file1> <file2>: Compute a time space midpoint chart.
  1000. X
  1001. X  Time-space midpoint relationship charts are supported: Doing "-rm
  1002. X  chart1 chart2" will calculate the time and location exactly half way
  1003. X  between the times and locations as indicated in the two files. Unlike
  1004. X  all other types of relationship charts, this one actually exists in
  1005. X  space and time, and therefore can be treated like a single chart and
  1006. X  can be output to a file with the -o option.
  1007. X
  1008. X-r0 <file1> <file2>: Keep the charts separate in comparison.
  1009. X
  1010. X  There is of course a distinction between synastry relationship charts
  1011. X  and the actual comparison between two separate charts. The -r0 option
  1012. X  is used to generate actual comparison charts. For example, combining
  1013. X  -r0 with the -g switch will cause a full grid chart of the aspects
  1014. X  between all the planets of the two charts (with person1's planets on
  1015. X  the vertical axis and person2's on the horizontal) to be displayed.
  1016. X  (Unfortunately, if all 20 of the default objects are left unrestricted
  1017. X  here, the grid will exceed 80 columns.) The -r0 option can also be
  1018. X  used with the -X switch to generate true relationship wheel charts,
  1019. X  (described later). The -r0 option will act like the -r synastry option
  1020. X  in certain displays that can't compare two charts; for example, '-r0
  1021. X  -v' will act the same as just '-r -v'. (Note: the "-t file" current
  1022. X  transit option is basically a shorthand way of doing "-r0 file now".)
  1023. X
  1024. X-t <file>: Compute current house transits for particular chart.
  1025. X
  1026. X  The command switch '-t <file>' can be used as a shortcut way to
  1027. X  compute the current transits for the chart in <file>. (Saves you from
  1028. X  having to mention the 'now' in the '-r0' option.)
  1029. X
  1030. X-T <file> <month> <year>: Compute all transits in month for chart.
  1031. X
  1032. X  The '-T <file> <month> <year>' option will scan the entire month
  1033. X  specified, and print out any transits that happen, in that month, to
  1034. X  the planets as listed in the specified <file>. There will be quite a
  1035. X  few, even though fast moving objects like the moon aren't looked at,
  1036. X  so you might want to use this with the -R option to limit this to just
  1037. X  certain planets. (The times are displayed in the local time zone, and
  1038. X  are generally accurate to within a half hour or so; Try doing it for
  1039. X  your birth month and your own chart - All planets should conjunct
  1040. X  their natal positions at about the time of your birth.) Putting a zero
  1041. X  in place of the month will cause the entire year to be scanned, which
  1042. X  prevents one from having to search each month in turn if they are
  1043. X  looking for something in particular. Note that the -T option includes
  1044. X  ALL of one's natal house cusps in the transit scans (instead of just
  1045. X  the Asc and MC). The 11th, 12th, 2nd, and 3rd cusps are included (and
  1046. X  oppositions to these and the Asc/MC can be used to to determine
  1047. X  aspects to the other six cusps.)
  1048. X
  1049. X-T0 <..>: Like -T but include transits of the Moon as well.
  1050. X
  1051. X  Normally the -T option always ignores the moon and does not include
  1052. X  the transiting moon in the lists because it moves so fast and would
  1053. X  cause an enormous amount of info. Still, if you are looking for lunar
  1054. X  transits, specifying the option as -T0 instead of just -T will include
  1055. X  the moon.
  1056. X
  1057. X-Tp <file> <month> <year>: Compute all progressions in month for chart.
  1058. X
  1059. X  Determining dates of transits of progressed planets to natal planets
  1060. X  can be done with the -Tp <file> <month> <year> option. This is just
  1061. X  like the -T option, except that the exact aspects of progressed
  1062. X  planets (rather than transiting planets) to the planets in 'file' are
  1063. X  displayed. Again, one can substitute '0' for the month to scan the
  1064. X  entire year (which might be desirable since progressions occur much
  1065. X  less often than transits, and there will only be a few, if any, in a
  1066. X  given month.)
  1067. X
  1068. X-E <month> <year>: Display ephemeris for given month.
  1069. X
  1070. X  The '-E <month> <year>' option will generate a quick ephemeris for the
  1071. X  ten main bodies for the month in question, useful if you just want to
  1072. X  see what's happening this month in the sky. It generally is used by
  1073. X  itself and not with any other options. (Displayed daily for midnight,
  1074. X  default time.) Any dots after a planet location in the list indicate
  1075. X  the planet was retrograde at the time. The -E <month> <year> ephemeris
  1076. X  option can also be used to display the ephemeris for the entire year
  1077. X  instead of just for one month. Like the -T option, putting a '0' for
  1078. X  the month will give the entire year's ephemeris.
  1079. X
  1080. X-E0 <..>: Like -E but include Chiron and the asteroids as well.
  1081. X
  1082. X  The -E option can also display the Asteroids, Chiron, and the Node in
  1083. X  the ephemeris listing if one invokes it as -E0 instead of just -E.
  1084. X  Note however that this will make each line more than 80 columns, so
  1085. X  this is mainly just for printing purposes.
  1086. X
  1087. END_OF_FILE
  1088. if test 57907 -ne `wc -c <'Helpfile.p1'`; then
  1089.     echo shar: \"'Helpfile.p1'\" unpacked with wrong size!
  1090. fi
  1091. # end of 'Helpfile.p1'
  1092. fi
  1093. echo shar: End of archive 5 \(of 8\).
  1094. cp /dev/null ark5isdone
  1095. MISSING=""
  1096. for I in 1 2 3 4 5 6 7 8 ; do
  1097.     if test ! -f ark${I}isdone ; then
  1098.     MISSING="${MISSING} ${I}"
  1099.     fi
  1100. done
  1101. if test "${MISSING}" = "" ; then
  1102.     echo You have unpacked all 8 archives.
  1103.     echo "See the README file for further instructions."
  1104.     rm -f ark[1-9]isdone
  1105. else
  1106.     echo You still need to unpack the following archives:
  1107.     echo "        " ${MISSING}
  1108. fi
  1109. ##  End of shell archive.
  1110. exit 0
  1111.  
  1112. exit 0 # Just in case...
  1113.