home *** CD-ROM | disk | FTP | other *** search
/ Source Code 1994 March / Source_Code_CD-ROM_Walnut_Creek_March_1994.iso / compsrcs / misc / volume37 / astrolog / part08 < prev    next >
Encoding:
Text File  |  1993-05-18  |  59.9 KB  |  1,111 lines

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