home *** CD-ROM | disk | FTP | other *** search
/ NetNews Usenet Archive 1992 #31 / NN_1992_31.iso / spool / alt / astrolog / 2665 < prev    next >
Encoding:
Text File  |  1992-12-24  |  117.8 KB  |  2,190 lines

  1. Newsgroups: alt.astrology
  2. Path: sparky!uunet!paladin.american.edu!darwin.sura.net!udel!rochester!cornell!uw-beaver!news.u.washington.edu!byron.u.washington.edu!astrolog
  3. From: astrolog@byron.u.washington.edu (Astrolog)
  4. Subject: * Astrolog 2.30 Helpfile
  5. Message-ID: <1992Dec24.090235.8972@u.washington.edu>
  6. Summary: Documentation for each Astrolog feature. Extract to file "Helpfile".
  7. Keywords: Astrolog, Helpfile
  8. Sender: news@u.washington.edu (USENET News System)
  9. Organization: University of Washington
  10. Date: Thu, 24 Dec 1992 09:02:35 GMT
  11. Lines: 2177
  12.  
  13. Helpfile for Astrolog version 2.30 (September 1992):
  14.  
  15. This file contains a complete list of all the features available in
  16. Astrolog version 2.30, and documentation on how to use each option.
  17. The file is divided into five parts:
  18.  
  19. 1) A summary list of all the main features which are accessed via
  20. command line parameter switches, along with a list of single keypress
  21. commands that can be given in an X window (assuming you have X
  22. windows) to change the display in various ways.
  23.  
  24. 2) The list of command switches and keypresses is repeated, but after
  25. each option is listed a more lengthy description of the details of
  26. the feature.
  27.  
  28. 3) Details of default parameters, in compile time options and in the
  29. default parameter file, are described.
  30.  
  31. 4) Descriptions of things that appear in the Astrolog text displays,
  32. are described. This consists of describing how to enter chart
  33. information into the program, and how to interpret what is seen in
  34. the main display.
  35.  
  36. 5) Finally, there is a description of the different X window chart
  37. displays and how they are organized, and the X windows features in
  38. general. (Looking for a quick impressive display to prove Astrolog
  39. was worth compiling? In unix try: "astrolog -Xn -XG -Xw 400". :)
  40.  
  41.  
  42. ************************
  43. LIST OF COMMAND SWITCHES
  44. ************************
  45.  
  46. Astrolog command switches (version 2.30) (September 1992):
  47.  -H: Display this help message.
  48.  -H0: Display names of zodiac signs and houses.
  49.  -O: Display available planets and other celestial objects.
  50.  -O0: Like -O but ignore any restrictions.
  51.  -A: Display available aspects, their angles, and present orbs.
  52.  -I0 Display meanings of signs, houses, planets, and aspects.
  53.  
  54. Switches which determine in what format the chart is displayed:
  55.  -v: Display list of object positions (chosen by default).
  56.  -v0: Like -v but express velocities relative to average speed.
  57.  -vI: Interpret meaning of each planet/sign/house placement.
  58.  -w: Display chart on screen in a graphic house wheel format.
  59.  -w0: Like -w but show objects in houses 4..9 in reverse order.
  60.  -g: Display aspect and midpoint grid among planets.
  61.  -g0: Like -g but flag aspect configurations (e.g. Yod's) too.
  62.  -g0: For comparison charts, show midpoints instead of aspects.
  63.  -ga: Like -g but indicate applying instead of difference orbs.
  64.  -gI: Print interpretation of each aspect between planets.
  65.  -Z: Display planet locations with respect to the local horizon.
  66.  -Z0: For graphics charts, like -Z but have a polar center.
  67.  -S: Display x,y,z coordinate positions of planets in space.
  68.  -I: Display interpretation of planetary influences.
  69.  -L [<step>]: Display astro-graph locations of planetary angles.
  70.  -L0 [..]: Like -L but display list of latitude crossings too.
  71.  -d: Print all aspects and changes occurring in a day.
  72.  -d0: Like -d but print all aspects for the entire month.
  73.  -dp <month> <year>: Print aspects within progressed chart.
  74.  -e: Print all options for chart (i.e. -v-w-g0-Z-S-I-L0-d).
  75.  
  76. Switches which affect how the chart parameters are obtained:
  77.  -n: Compute chart for this exact moment using current time.
  78.  -a <month> <date> <year> <time> <zone> <long> <lat>:
  79.      Compute chart automatically given specified data.
  80.  -z: Assume Daylight time (change default zone appropriately).
  81.  -z <zone>: Change the default time zone (for -d-q-T-E options).
  82.  -l <long> <lat>: Change the default longitude & latitude.
  83.  -q <month> <date> <year>: Compute chart for noon on date.
  84.  -q0 <month> <date> <year> <time>: Like -q but include time too.
  85.  -i <file>: Compute chart based on info in file.
  86.  -o <file> [..]: Write parameters of current chart to file.
  87.  -o0 <file> [..]: Like -o but output planet/house positions.
  88.  
  89. Switches which affect what information is used in a chart.
  90.  -R [<obj1> [<obj2> ..]: Restrict specific bodies from displays.
  91.  -R0 [<obj1> ..]: Like -R but restrict everything first.
  92.  -R[C,u,U]: Restrict all minor cusps, all uranians, or stars.
  93.  -C: Include non-angular house cusps in charts.
  94.  -u: Include transneptunian/uranian bodies in charts.
  95.  -U: Include locations of fixed background stars in charts.
  96.  -U[z,l,n,b]: Order by azimuth, altitude, name, or brightness.
  97.  -A <0-18>: Specify the number of aspects to use in program.
  98.  -Ao <aspect> <orb>: Specify maximum orb for an aspect.
  99.  -Am <planet> <orb>: Specify maximum orb allowed to a planet.
  100.  -Ad <planet> <orb>: Specify orb addition given to a planet.
  101.  
  102. Switches which affect how a chart is computed:
  103.  -c <value>: Select a different default system of houses.
  104.      (0 = Placidus, 1 = Koch, 2 = Equal, 3 = Campanus,
  105.      4 = Meridian, 5 = Regiomontanus, 6 = Porphry, 7 = Morinus,
  106.      8 = Topocentric, 9 = None.)
  107.  -s: Compute a siderial instead of the normal tropical chart.
  108.  -s0: Display locations as right ascension instead of degrees.
  109.  -h [<objnum>]: Compute positions centered on specified object.
  110.  -p <month> <day> <year>: Cast progressed chart based for date.
  111.  -pn: Cast progressed chart based on current date now.
  112.  -p0 <days>: Set no. of days to progress / day (default 365.25).
  113.  -x <1-360>: Cast harmonic chart based on specified factor.
  114.  -1 [<objnum>]: Cast chart with specified object on ascendant.
  115.  -2 [<objnum>]: Cast chart with specified object on midheaven.
  116.  -3: Display objects in their zodiac decan positions.
  117.  -f: Display houses as sign positions (flip them).
  118.  -G: Display houses based on geographic location only.
  119.  -F <objnum> <sign> <deg>: Force object's position to be value.
  120.  -+ <days>: Cast chart for specified no. of days in the future.
  121.  -- <days>: Cast chart for specified no. of days in the past.
  122.  
  123. Other features or major modes:
  124.  -r <file1> <file2>: Compute a relationship synastry chart.
  125.  -rc <file1> <file2>: Compute a composite chart.
  126.  -rm <file1> <file2>: Compute a time space midpoint chart.
  127.  -rd <file1> <file2>: Print number of days between files' dates.
  128.  -rb <file1> <file2>: Display biorythm for file1 at time file2.
  129.  -r0 <file1> <file2>: Keep the charts separate in comparison.
  130.  -t <file>: Display current house transits for particular chart.
  131.  -t[b|d] <file>: Print biorythm/datediff for current time now.
  132.  -T <file> <month> <year>: Compute all transits in month for chart.
  133.  -T0 <..>: Like -T but include transits of the Moon as well.
  134.  -Tp <file> <month> <year>: Compute progressions in month for chart.
  135.  -E <month> <year>: Display planetary ephemeris for given month.
  136.  -E0 <..>: Like -E but include all unrestricted bodies.
  137.  
  138. Switches to access graphics options:
  139.  -X: Create a graphics chart instead of displaying it as text.
  140.  -Xb: Create X bitmap instead of putting graphics in window.
  141.  -XB: Display X chart on root instead of in a separate window.
  142.  -Xm: For color monitors, display charts in black and white.
  143.  -Xr: Create window or bitmap in reversed colors (B on W).
  144.  -Xw <hor> [<ver>]: Change the size of the chart window.
  145.  -Xs <percentage>: Change the size of characters by n%.
  146.  -Xi: Create chart in slightly modified form.
  147.  -XT: Inhibit display of chart info at bottom of window.
  148.  -XW: Simply create the bitmap of the world.
  149.  -XW0: Like -XW but don't just do rectangular projection.
  150.  -XP: Create the bitmap of the world, but as a polar projection.
  151.  -XG [<degrees>]: Display the bitmap of the world as a globe.
  152.  -Xn: Start up chart or globe display in animation mode.
  153.  -Xo <file>: Write output bitmap to specified file.
  154. Also, press 'H' within X window for list of key press options.
  155.  
  156.  
  157. Astrolog window keypress options (version 2.30):
  158.  Press 'H' or '?' to display this list of key options.
  159.  Press 'p' to toggle pause status on or off.
  160.  Press 'x' to toggle fg/bg colors in window.
  161.  Press 'm' to toggle color/monochrome display in window.
  162.  Press 'T' to toggle header info on current chart in window.
  163.  Press 'i' to toggle status of the minor chart modification.
  164.  Press 'l' to toggle labelling of object points in chart.
  165.  Press 'v' to display current chart in window on text screen.
  166.  Press 'R' to toggle restriction status of minor objects.
  167.  Press 'C' to toggle restriction status of minor house cusps.
  168.  Press 'u' to toggle restriction status of uranian planets.
  169.  Press 'U' to toggle restriction status of fixed stars.
  170.  Press 's', 'h', 'f', 'F' to toggle status of siderial zodiac,
  171.        heliocentric charts, domal charts, and decan charts.
  172.  Press 'O' and 'o' to recall/store a previous chart from memory.
  173.  Press 'B' to dump current window contents to root background.
  174.  Press 'Q' to resize wheel chart display to a square.
  175.  Press '<' and '>' to decrease/increase the scale size of the
  176.        glyphs and the size of world map.
  177.  Press '[' and ']' to decrease/increase tilt in globe display.
  178.  Press 'N' to toggle animation status on or off. Charts will
  179.        be updated to current status and globe will rotate.
  180.  Press '!'-'(' to begin updating current chart by adding times.
  181.        !: seconds, @: minutes, #: hours, $: days, %: months,
  182.        ^: years, &: years*10, *: years*100, (: years*1000.
  183.  Press 'r' to reverse direction of time-lapse or animation.
  184.  Press '1'-'9' to set rate of animation to 'n' degrees, etc.
  185.  Press 'V','L','A','Z','S','W','G','P' to switch to normal (-v),
  186.        astrograph (-L), grid (-g), local (-Z), space (-S),
  187.        world (-XW), globe (-XG), and polar (-XP) modes.
  188.  Press 'q' to terminate the window and program.
  189.  
  190.  Left   mouse button: Draw lines on chart in window.
  191.  Middle mouse button: Print coordinates of pointer on world map.
  192.  Right  mouse button: Terminate the window and program.
  193.  
  194.  
  195. **********************************
  196. DESCRIPTION OF EACH COMMAND SWITCH
  197. **********************************
  198.  
  199. Note: When specifying command switches, the leading dashes are
  200. optional. They aren't necessary. For example, the command "astrolog -i
  201. chartfile -R -u -U -Z -Xs 300 -Xi -XB" can be abbreviated as "astrolog
  202. i chartfile R u U Z Xs 300 Xi XB". (This is subject to a couple of
  203. minor limitations, in that one can't have the -1 or -3 option follow a
  204. -R restriction list of numbers, since -1 will be considered a number.)
  205.  
  206. ----
  207.  
  208. Astrolog command switches (version 2.30) (September 1992):
  209.  
  210. -H: Display this help message.
  211.  
  212.   This option displays a list exactly like the one given above on the
  213.   screen.
  214.  
  215. -H0: Display names of zodiac signs and houses.
  216.  
  217.   The -H0 switch will display a list of the 12 signs of the zodiac,
  218.   and the 12 houses, listing their standard and traditional names. This
  219.   is similar to switches like -O or -A, in that it displays lists of
  220.   things (objects, aspects, or in this case the signs) that Astrolog
  221.   uses in its charts.
  222.  
  223. -O: Display available planets and other celestial objects.
  224.  
  225.   Similar to the -A option below, the -O option will list all the
  226.   planets and other celestial objects used by the program, and their
  227.   numbers as recognized by the -R restrictions mentioned below. This
  228.   list will also show the zodiac signs that planets rule, fall in, are
  229.   exalted in, and debilitated in. (Remember that when -O is encountered,
  230.   it immediately executes and terminates the program, so any modifying
  231.   switches must be before it.)
  232.  
  233. -O0: Line -O but ignore any restrictions.
  234.  
  235.   The -O switch above simply displays a list of all the objects, cusps,
  236.   uranians, and stars, along with their index numbers. This list can be
  237.   affected by the -R restrictions, and the -C, -u, and -U switches must
  238.   be included in order for all of Astrolog's objects to get listed. In
  239.   order to make it easier to simply display a list of all 78 objects
  240.   Astrolog recognizes, the new -O0 option is just like -O (and is
  241.   equivalent to "-C -u -U -O") except that it will ignore all
  242.   restrictions and always list every object. Stars are printed in the
  243.   list along with their azimuth, altitude, and brightness values.
  244.  
  245. -A: Display available aspects, their angles, and present orbs.
  246.  
  247.   The -A command switch gives a list of all 18 supported aspects,
  248.   their abbreviations as used in the aspect grids, their angles, and
  249.   their orbs. It will list the number of each aspect in addition to all
  250.   the other info already there (e.g. conjunct = 1, opposition = 2, etc.)
  251.   so one can easily figure out what exact number to pass to the -A
  252.   option when changing the number of aspects used (see below). Finally,
  253.   it will display a brief verbal description of what each aspect glyph
  254.   look like. This is in case one doesn't know what aspects the weird
  255.   symbols in the -g -X window displays are referring to.
  256.  
  257. -I0 Display meanings of signs, houses, planets, and aspects.
  258.  
  259.   This will display the general meanings of each sign, each house, each
  260.   planet, and each aspect, on the screen. This shows more or less the
  261.   database the program uses to base its interpretations on (see -vI and
  262.   -gI switches below).
  263.  
  264. ----
  265.  
  266. Switches which determine in what format the chart is displayed:
  267.  
  268. -v: Display list of object positions (chosen by default).
  269.  
  270.   This is just a formal specification for the standard chart listing of
  271.   the planetary positions. One will get this chart by default if they
  272.   don't specify any other chart types, and they will get it along with
  273.   everything else in the -e option (see below). Although it isn't
  274.   necessary, it must be included if one wants this type of chart to be
  275.   displayed along with some of the other chart types described below.
  276.  
  277. -v0: Like -v but express velocities relative to average speed.
  278.  
  279.   This switch is just like -v except that it modifies the planet
  280.   velocities slightly. (See later for a description of these velocity
  281.   fields.) Normally, it isn't a trivial task to determine precisely when
  282.   a planet is going to change direction. This is because, for example,
  283.   although a velocity of 0.010 degrees/day for fast moving Mercury means
  284.   it's about to turn retrograde, the same velocity value is normal for
  285.   slow moving Pluto. The -v0 switch divides the normal velocity values
  286.   by how fast each planet moves with respect to the Sun, meaning that
  287.   all planets will now have an average *relative* velocity value of
  288.   1.000, and in all cases, a velocity of 2.000 means the planet is
  289.   moving twice as fast as normal, and one of 0.010 means the planet is
  290.   about to turn retrograde.
  291.  
  292. -vI: Interpret meaning of each planet/sign/house placement.
  293.  
  294.   A brief interpretation of the meaning of the positioning of each
  295.   planet in its sign and house is supported with the -vI switch. If one
  296.   includes the -vI switch, then instead of the standard -v listing of
  297.   planet positions, the planet positions will be listed with a brief
  298.   interpretation of what they mean. I have to say that this is a pretty
  299.   limited version of interpretation, being nothing more than a
  300.   combining of phrases representing the planet, sign, and house in
  301.   question; nevertheless, people who don't know how to interpret charts
  302.   might find this to be of use (or at least amusing. :)
  303.  
  304. -w: Display chart on screen in a graphic house wheel format.
  305.  
  306.   Display of the chart in a nice wheel format is supported using the
  307.   '-w' switch. (If one of the houses gets too 'full' of planets, the
  308.   planet will be put at the beginning of the next house.) The same
  309.   chart header information as is at the top of the standard -v chart is
  310.   printed in the middle of the wheel.
  311.  
  312.   In addition to the normal chart information in the middle of the
  313.   wheel, this display includes the day of the week that the date falls
  314.   on. This may seem minor, but it is a way to calculate the day of the
  315.   week for any date. If you forgot what day of the week you were born
  316.   on, display your chart with the -w switch, and ignore the chart and
  317.   just check the day of the week in the header information. Similarly,
  318.   one could use this to make a calendar for any particular month by
  319.   casting a -w chart for the 1st of the month in question, and building
  320.   the calendar from that starting point.
  321.  
  322. -w0: Like -w but show objects in houses 4..9 in reverse order.
  323.  
  324.   In the -w text wheel option, the objects in each house are printed
  325.   from top to bottom in order from earliest in the house to latest. This
  326.   looks good except for in houses 5..8 where this would appear backwards
  327.   (e.g. a planet having just entered the 6th house from the 5th would be
  328.   displayed right under the Descendant.) Therefore the objects from
  329.   houses 4 through 9 are reversed and printed in order from bottom to
  330.   top, making a more flowing looking wheel chart. If however, one always
  331.   wants each house to be filled from its top to bottom regardless of
  332.   which house, replace the -w with the -w0 switch
  333.  
  334. -g: Display aspect and midpoint grid among planets.
  335.  
  336.   Aspects and midpoint display are supported: Invoke as astrolog -g and
  337.   a rectangular grid showing the midpoint locations for each planet,
  338.   and showing if any aspects are present and how accurate they are, is
  339.   displayed. The planets are labeled down the main diagonal of the
  340.   grid, with the aspects to the lower left and the midpoints in the
  341.   upper right. This is of course often used along with the -A*
  342.   switches. Both the aspect orbs and midpoints are displayed to the
  343.   nearest minute, and on the main diagonal (or edges if a relationship
  344.   aspect grid) is displayed the sign of the planet in question in
  345.   addition to the planet name itself.
  346.  
  347. -g0: Like -g but flag aspect configurations (e.g. Yod's) too.
  348.  
  349.   Search through the aspect grid for major aspect configurations,
  350.   including Grand Trines, T-Squares, Grand Crosses, Yod's, Cradles, and
  351.   Stelliums, with the -g0 option. (In a Stellium, three objects must all
  352.   be conjunct with each other.) This option will produce the same aspect
  353.   grid that -g displays, but afterwards will go through the grid and
  354.   list any of these aspect configurations and what objects are forming
  355.   them. (Of course, to see any Yod's, one has to -A 6 or more so that
  356.   Inconjuncts will be included in the aspect grid.)
  357.  
  358. -g0: For comparison charts, show midpoints instead of aspects.
  359.  
  360.   For relationship aspect grids, the -g0 option will display a midpoint
  361.   grid instead of an aspect grid between the planets in the two charts
  362.   e.g. "-r0 chart1 chart2 -g0". (See later for descriptions of the
  363.   relationship charts.)
  364.  
  365. -ga: Like -g but indicate applying instead of difference orbs.
  366.  
  367.   Ability to determine whether an aspect is applying or separating (is
  368.   about to happen or just happened) is included in the -g option.
  369.   Normally the aspect orbs are flagged as being '+' or '-' based on
  370.   whether they are greater or less than the exact amount (e.g. a 91
  371.   degree Square has a +1 degree orb while a 89 degree one a -1 orb.) If
  372.   one, however, invokes the -g option as -ga instead, an orb printed as
  373.   'a' will indicate an applying aspect while an orb with 's' a
  374.   separating one. (To estimate applying vs. separating, the program
  375.   examines the planetary positions and their relative velocities at the
  376.   time in question.)
  377.  
  378. -gI: Print interpretation of each aspect between planets.
  379.  
  380.   Similar to the -vI option above, ability to give a brief
  381.   interpretation of each aspect in the aspect grid is supported with
  382.   the -gI switch. When the -gI switch is included, the standard -g
  383.   aspect grid will be replaced with a list of each aspect occurring and
  384.   a brief listing of what it means. Again, this is mainly just a lookup
  385.   of the general meanings of each planet and the aspect in question,
  386.   but still might be found of interest by some. (Note: only the first
  387.   11 aspects, out to the Bi-Quintile, can be considered.)
  388.  
  389. -Z: Display planet locations with respect to the local horizon.
  390.  
  391.   The text display switch -Z prints out where each object is on the
  392.   local horizon in terms of altitude and azimuth. For each object, the
  393.   following is displayed: Its altitude on the local horizon from +90
  394.   degrees (straight up) to -90 degrees (straight down), and its azimuth
  395.   from 0..360 degrees, where 0 = due east, 90 = north, 180 = west, 270 =
  396.   south. To make visualizing the azimuth easier, an "azimuth vector"
  397.   with a N/S component and a W/E component is displayed, e.g. (1.00s
  398.   0.33w) means that the object is mainly south, with its true angle
  399.   being formed by an vector component west that's 1/3 the strength of
  400.   the south component, i.e. the object is about 18 degrees west of
  401.   south. This along with the altitude should make it easy to physically
  402.   point to where any planet is at any moment, making it easy to locate
  403.   planets in the night sky. This feature can also be used to determine
  404.   the times that a planet rises and sets. Also displayed are altitude
  405.   and azimuth differences between each object and the Sun and Moon,
  406.   first showing the number of degrees that the Sun/Moon is "ahead" (or
  407.   farther east in the zodiac) of the object in question, and then the
  408.   number of degrees that the Sun/Moon is above the object in question.
  409.   This feature can be used to roughly predict eclipses! Both the Sun and
  410.   Moon span about 0.5 degrees in the sky, therefore if both the azimuth
  411.   and altitude differences are < 0.5 (or 1.0 if the difference is
  412.   between the Sun and Moon themselves) then the object in question is
  413.   probably being occulted somewhat by the Sun/Moon. Note that there are
  414.   three types of planetary position displays: Right ascension and
  415.   declination showing the object's position with respect to the stars,
  416.   longitude and latitude showing where on the Earth the object is
  417.   straight up (as in the astro-graph zenith locations), and finally
  418.   azimuth and altitude showing the positions of the object relative to
  419.   the local horizon.
  420.  
  421. -Z0: For graphics charts, like -Z but have a polar center.
  422.  
  423.   See section on the X graphics charts for description of this option.
  424.  
  425. -S: Display x,y,z coordinate positions of planets in space.
  426.  
  427.   Solar system space based charts are available with the -S switch,
  428.   which give the astronomical positions of each planet in terms of x, y,
  429.   and z coordinates. Although not directly useful astrologically, it
  430.   does give one a good view of how the planets actually were positioned
  431.   at the time in question. For example, normal astrology doesn't make
  432.   the distinction between the four different "forms" of say, a Mercury
  433.   Venus Conjunction, i.e. they can either be Conjunct on the near side
  434.   of the Sun, Conjunct on the far side of the Sun, or one can be on one
  435.   side and the other on the other side. When the chart is actually
  436.   displayed, for each body the following information is printed: The
  437.   relative angle of the planet with respect to the central body, i.e.
  438.   its zodiac position converted to the appropriate number from 0..360.
  439.   This is followed by the x, y, and z coordinate positions of the
  440.   object, in astronomical units from the central body. The x-axis
  441.   increases in the direction of 0 degrees Aries (tropical zodiac), the
  442.   y-axis increases in the direction of 0 degrees Cancer, and the z-axis
  443.   is with respect to the Earth's orbit (meaning that the Sun and Earth
  444.   always have a z-axis value of 0.0). Finally the overall length from
  445.   the central body in AU is printed, which is just the diagonal as
  446.   indicated by the x, y, z vectors. (The Earth and Sun are of course
  447.   always about 1.0 AU from each other.) The Moon circles the Earth and
  448.   isn't a part of the solar system proper; therefore, it is never in
  449.   these charts. The -e everything option will include this chart in its
  450.   listing of all the chart displays.
  451.  
  452. -I: Display interpretation of planetary influences.
  453.  
  454.   Another chart type is available - interpretation of influences. This
  455.   is the beginning of a general interpretation ability for the program,
  456.   although all it does now is calculate the relative "power" of each
  457.   planet's placement, giving a general idea of the prominent areas of a
  458.   chart. When such a chart is printed, each planet is given a point
  459.   value, larger numbers indicating more strength. Each planet's strength
  460.   is divided between two fields: the positioning in and of itself, and
  461.   the power of the aspects it makes with the other planets. In addition
  462.   to each field, the total of these two areas is printed, as well as the
  463.   relative percentage of the planet in question with respect to all the
  464.   planets combined. Each planet gets a ranking for its positioning,
  465.   aspects, and total power as well, with the strongest getting #1, the
  466.   next strongest #2, etc. The -e option will include this chart along
  467.   with all the others as well in it's listing of all the chart displays.
  468.  
  469.   To determine the strength of the positioning of a planet, various
  470.   things are taken into account: 1) The power of a planet in and of
  471.   itself, e.g. the Sun and Moon are more powerful then the other
  472.   planets. 2) The house placement of a planet, e.g. a planet in the 1st
  473.   house is more powerful than one in the 2nd. 3) Whether a planet is in
  474.   the sign it rules or is exalted in, e.g. Jupiter in Sag results in
  475.   more power to Jupiter. 4) Whether a planet is in the house
  476.   corresponding to the sign it rules or is exalted in, e.g. Jupiter in
  477.   the 9th house. 5) Planets get more power if the signs they rule are
  478.   occupied, e.g. a bunch of stuff in Aquarius gives more power to
  479.   Uranus. 6) Planets get more power if the houses they rule are
  480.   occupied, e.g. a bunch of stuff in the 11th house gives power to
  481.   Uranus. 7) Finally, planets get power according to what houses the
  482.   cusps of which fall in the signs they rule, i.e. the ruler of the
  483.   Ascendant (and to less extent the Midheaven, and so on) gets lots of
  484.   influence. Determining the strength of a planet's aspects is much
  485.   easier, and is basically composed of the sum of the strength of each
  486.   aspect the planet makes. Taken into account are: 1) The influence of
  487.   the planet being aspected to, e.g. Sun conjunct Jupiter gives more
  488.   influence to Jupiter than Mercury conjunct Jupiter would. The
  489.   planet's placement as described above plays a role, too, e.g. Venus
  490.   opposition Mars in Aries gives more influence to Venus that it would
  491.   be if Mars were in Taurus. 2) The influence of the aspect itself,
  492.   e.g. Oppositions are more powerful then Sextiles. 3) Finally the orb
  493.   of the aspect, i.e. exact aspects are more powerful than wide ones.
  494.   (The influence of the orb varies linearly from max power at exact to
  495.   zero power at the limit of the orb - sorry Maggie M. and Mark K. - no
  496.   complex aspect wave functions, at least for this version :)
  497.  
  498.   Special thanks goes to Mark K. who initially presented this idea of
  499.   interpreting overall influences to me. I basically just took his
  500.   ideas, polished them a bit, and put it into the code. Interestingly,
  501.   while programming this feature, I had a dream about him, in which he
  502.   elaborated upon some of the ideas and even gave me suggestions for
  503.   some of the planets' default power values (astral visitation?) And,
  504.   while on the subject, I've had a couple of other Astrolog dreams; I
  505.   had one neat one while working on the -h feature (described later)
  506.   about a far distant future version of Astrolog that could actually
  507.   teleport one to the places which they cast charts for :)
  508.  
  509. -L [<step>]: Display astro-graph locations of planetary angles.
  510.  
  511.   The '-L' option will take the standard chart information and generate
  512.   the astro-graph positions of the planets. In other words, this does
  513.   the exact same thing that Jim Lewis' Astro*Carto*Graphy maps do. It
  514.   will display the longitude of where on the Earth at the time in
  515.   question each object was on the midheaven and on the nadir, and the
  516.   latitude of where the planets actually appeared at zenith. Also, for
  517.   latitude increments of 5 degrees, the longitude of where the objects
  518.   appeared on the ascendant and descendant is displayed. For text
  519.   screens, one can pass an optional parameter to this -L (or -L0) option
  520.   to change the default latitude step rate at which the Ascendant and
  521.   Descendant lines are computed. Again, this value is by default 5
  522.   degrees, although one can may increase or decrease it to any integer
  523.   (subject to the restriction that the number 160 is divisible by it.)
  524.  
  525. -L0 [..]: Like -L but display list of latitude crossings too.
  526.  
  527.   Determination of latitude crossing points is included in the
  528.   astro-graph routines! The -L0 option will do the same thing as the -L
  529.   option, except that after displaying the longitude and latitude
  530.   locations of the Asc/Desc/MC/IC lines, it will then search among the
  531.   lines and display (in order from farthest North to farthest South) the
  532.   latitude of any points where lines cross each other. This includes the
  533.   curvey Asc/Desc lines crossing the straight MC/IC lines as well as
  534.   cases where different Asc/Desc lines cross themselves. And unlike Jim
  535.   Lewis' astro*carto*graphy, Astrolog will also display the longitude of
  536.   the crossing (useful for Asc/Desc crossings) in addition to the
  537.   latitude (as well allowing more planetary bodies to be included in the
  538.   scan, and going farther North and South than Jim Lewis' printouts go.)
  539.   Note however, that there is presently a small (very rare) minor
  540.   omission glitch in the code, where if a crossing is within a couple of
  541.   degrees of 180 deg W/E, it may not be displayed.
  542.  
  543. -d: Print all aspects and changes occurring in a day.
  544.  
  545.   The '-d' option will take the standard chart information, and for the
  546.   day in question, display the exact times of all aspects that occur.
  547.   This is just like the aspects-per-day as displayed in Jim Maynard's
  548.   Celestial Guide books. (Displayed in local time as defined by the
  549.   default zone, with accuracy to within a couple minutes.) This will
  550.   tell any time two planets make aspects with each other, a planet
  551.   changes its sign, or a planet goes retrograde or direct. Both the -d
  552.   (and -T listed later) options will display the signs that any planets
  553.   aspecting each other are in, in addition to the aspect itself (e.g.
  554.   instead of just "Jupiter Tri Uranus", we have "Jupiter (Vir) Tri (Cap)
  555.   Uranus". If a particular object is going retrograde, then its sign
  556.   will be displayed in brackets instead of parentheses, and if a
  557.   particular object is about to or has just gone retrograde or direct,
  558.   then its sign will be in <>'s.
  559.  
  560. -d0: Like -d but print all aspects for the entire month.
  561.  
  562.   The -d option can search the entire month for aspects between planets
  563.   if one so desires. Specifying it as -d0 instead of just -d will go
  564.   through the entire month instead of just the current day. (Combining
  565.   this one with -R allows searching for important aspects, sign
  566.   changes, etc.)
  567.  
  568. -dp <month> <year>: Print aspects within progressed chart.
  569.  
  570.   Another progression feature allows determining aspect times of
  571.   progressed planets among themselves. The -i <file> -dp <month> <year>
  572.   switch will, like the -d option, display times of aspects and sign
  573.   changes, except that they will be for the chart in file, progressed
  574.   throughout the month specified. Progressed planets move very slowly
  575.   ("year for a day") so therefore there will usually be, if any, only a
  576.   couple of aspects in a given month; again, one might want to
  577.   substitute '0' for the month to scan the whole year. Also, since they
  578.   move so slow, the accuracy is cut down, do the dates given are
  579.   probably only accurate to the nearest day, in spite of the times given
  580.   to the minute. Note that Astrolog can scan for aspects of: transiting
  581.   planets among themselves (-d switch), transiting planets to natal
  582.   planets (-T switch), progressed planets to natal planets (-Tp), and
  583.   progressed planets among themselves (-dp). Only thing Astrolog can't
  584.   do is do progressed planets to transiting planets, although that may
  585.   change in the next version :)
  586.  
  587. -e: Print all options for chart (i.e. -v-w-g0-Z-S-I-L0-d).
  588.  
  589.   There are eight main different formats of chart display available:
  590.   The standard listing of planet positions, which you get without any
  591.   switches or with the -v option; the aspect/midpoint grid you get with
  592.   -g, the house wheel you get with -w, and the charts generated with
  593.   the -Z, -S, -I, -L, and -d options. The -e "everything" option will
  594.   display the chart in all eight of these formats for about 750 lines
  595.   of text!
  596.  
  597. ----
  598.  
  599. Switches which affect how the chart parameters are obtained:
  600.  
  601. -n: Compute chart for this exact moment using current time.
  602.  
  603.   For those with systems who can handle time calls (If your system
  604.   pukes on trying to compile them, simply comment out the #define TIME
  605.   line at the beginning), the program supports displaying the chart for
  606.   the time at the current moment! In other words, invoke as astrolog -n
  607.   and see where the planets are right now. (This is fun - the house
  608.   cusps change 1 minute about every 4 seconds!) You will need to change
  609.   the #defines for the default longitude and latitude in astrolog.h, or
  610.   else specify where you are explicitly by using the -l switch to
  611.   change the default location. To figure out the time zone, the program
  612.   uses the default value in the astrolog.dat file or as defined in the
  613.   DEFAULT_ZONE constant set at compile time.
  614.  
  615. -a <month> <date> <year> <time> <zone> <long> <lat>:
  616. Compute chart automatically given specified data.
  617.  
  618.   Normally one generates a chart by entering the seven data coordinates
  619.   manually. A fast typist familiar with the program might prefer to give
  620.   all the data at once, which can be done with this option. Simply list
  621.   the seven parameters above, in the exact format as they would be given
  622.   to the program were the user being prompted for them.
  623.  
  624. -z: Assume Daylight time (change default zone appropriately).
  625.  
  626.   Normally the -z option takes an argument which will then become the
  627.   default time zone. If one, however, invokes it by itself, it will
  628.   subtract one hour from whatever the default time zone presently is.
  629.   This is useful since it is equivalent to adjusting any times printed
  630.   to Daylight time, i.e. it will add one hour to any times displayed.
  631.   (When entering the birth time for charts, one is supposed to subtract
  632.   one hour if Daylight time was in effect; note that subtracting one
  633.   hour from the time zone will do the same thing.) For example, over
  634.   here on the West Coast, I have my default time zone compiled to be
  635.   "8"; now that Daylight time is in effect here, I can do -z 7 or just
  636.   -z to decrease the default time zone when I make a -T transit list,
  637.   which will in effect add one hour to the local times displayed, or in
  638.   effect "Spring ahead" the clock for me. (For a better way of adjusting
  639.   Astrolog for Daylight time without having to specify -z all the time,
  640.   recompile the program, or add one hour to the times in your head, use
  641.   the "defaults" file described later to edit the time zone.) Remember
  642.   that the -z (and -l) switches must be before any other switches they
  643.   modify (such as -n) in order for the new default to take effect.
  644.  
  645. -z <zone>: Change the default time zone (for -d-q-T-E options).
  646.  
  647.   The -z <value> option can be used to change the default time zone to
  648.   the value in question. For example, you can force the -E ephemeris and
  649.   -T transits to be displayed at midnight GMT time instead of the local
  650.   time with -z 0; or, for the East coast where by default the time zone
  651.   is "5", you can do -z 4 during DST to properly display transits,
  652.   aspects in day, and other lists in the local DST zone.
  653.  
  654. -l <long> <lat>: Change the default longitude & latitude.
  655.  
  656.   Like the -z option, the -l option can be used to change the default
  657.   compile time world coordinates used in certain options, such as the
  658.   -n cast chart for right now switch.
  659.  
  660. -q <month> <date> <year>: Compute chart for noon on date.
  661.  
  662.   The -q <month> <day> <year> option can be used to cast a quick chart
  663.   for 12 noon on a particular date, using the default longitude and
  664.   latitude. The DEFAULT_ZONE compile time constant is used for the time
  665.   zone. Again, one example where this is useful is with the -d option,
  666.   e.g. to see the times of exact aspects on a particular date, like your
  667.   next birthday, your finals, etc.
  668.  
  669. -q0 <month> <date> <year> <time>: Like -q but include time too.
  670.  
  671.   The -q0 <month> <date> <year> <time> option takes the four parameters
  672.   and casts a chart for the time in question. The time zone and location
  673.   are taken from the default compiled values. This is just yet another
  674.   useful shorthand way to quickly make a chart. Note that this is just
  675.   like the -q <month> <date> <year> option except that -q always casts
  676.   it for noon in the default zone. Also note that the -a option which
  677.   takes all seven chart parameters can be duplicated with -q0 along with
  678.   the -z <zone> and -l <long> <lat> options.
  679.  
  680. -i <file>: Compute chart based on info in file.
  681.  
  682.   See the -o option below.
  683.  
  684. -o <file> [..]: Write parameters of current chart to file.
  685.  
  686.   The program supports directing chart information to, and reading
  687.   output from, data files. The '-o' option will dump all the birth data
  688.   (the date and stuff, not the planet positions) to the specified file.
  689.   The '-i' option will cast the chart based on the info in the file.
  690.   (This allows you to put your birth data into a specific file, and cast
  691.   your chart whenever you want to after that without having to reenter
  692.   your birth data all the time.)
  693.  
  694.   Another file output feature, the ability to concatenate "comment
  695.   lines" at the end of a data file, been been added to both the -o and
  696.   -o0 options. (Some people have complained that the info in the
  697.   Astrolog chart files are too cryptic.) After scanning the filename,
  698.   the -o[0] option will then write any parameter that follows it at the
  699.   end of the file, until a parameter beginning with a '-' (the next
  700.   switch) is reached. For example: -o 'file' "Walter D. Pullen" Seattle
  701.   will add my name and my birth city in two separate lines at the end of
  702.   'file'. (In unix, quotes can be used to allow spaces within one
  703.   parameter.)
  704.  
  705. -o0 <file> [..]: Like -o but output planet/house positions.
  706.  
  707.   Ability to write the actual sign and house positions of a chart to
  708.   a file (instead of just the time and place) has been implemented via
  709.   the -o0 <file> option. This option can be used interchangeably with
  710.   the old -o output to file switch. The information written includes the
  711.   zodiac position of the 20 main objects, their retrograde status and
  712.   declination, as well as the positions of the (first six) house cusps.
  713.   This file information can easily be passed into another program, and
  714.   can be read back into Astrolog with the -i option. The -i option will
  715.   automatically determine which type the file is, and will either use
  716.   the given positions, or else calculate them as needed (note that some
  717.   switches, such as the -c house system selection, will have no effect
  718.   for this new file type.) Check an example of one of these files to see
  719.   the precise format (a zodiac position is recorded as three numbers:
  720.   degree in sign, sign as 1..12, and floating point minute within
  721.   degree.) When the files are read back in, they will be flagged as
  722.   "having no space or time" like the composite charts in the chart
  723.   header displays.
  724.  
  725.   This file format can allow one to do things such as transits to
  726.   composite charts (send the composite chart to file with -o0 option and
  727.   then use that file as the first parameter to the -T option) composites
  728.   between two composite charts (use -rc between two composite charts
  729.   sent to a file) and even, if one is willing to do a small amount of
  730.   editing, to do transits to midpoints or the 0 degrees Aries point.
  731.   Note that one can easily edit the positions in the -o0 position file
  732.   to be whatever they like, so one could replace some unimportant object
  733.   (like the vertex) with 0 degrees Aries or an important midpoint value.
  734.   Note that trying to still use the -o time and space output with an
  735.   output chart that doesn't have space/time will confuse the program; it
  736.   will either say it can't make the file or else will output the
  737.   time/space of the most recent parameter file it read in.
  738.  
  739. ----
  740.  
  741. Switches which affect what information is used in a chart.
  742.  
  743. -R [<obj1> [<obj2> ..]: Restrict specific bodies from displays.
  744.  
  745.   The ability to restrict the transit (-T) and daily aspect (-d) scans
  746.   to just certain bodies has been implemented with the -R switch. Using
  747.   -R by itself will prevent the asteroids, Chiron, the Part of Fortune
  748.   and the Vertex from being in any of the lists. One may also give a
  749.   list of one or more numbers representing planets to be ignored (e.g. 1
  750.   = Sun, 2 = Moon, 3 = Mercury, etc) so that a complete custom setup can
  751.   be obtained (e.g. -R 1 2 3 4 5 will cause all of the inner planets to
  752.   be ignored). More than one -R switch can be combined (e.g. -R -R 16
  753.   will cause the asteroids, etc, and the North Node to be ignored; the
  754.   first -R gets rid of the asteroids, etc, and the second one deletes
  755.   the North Node.) Also, specifying the same particular body more than
  756.   once will cause it to be included again, or in other words, -R
  757.   <objectnum> complements the status of whether it is to be ignored or
  758.   not (e.g. -R -R 15 will cause all of the asteroids, etc, excluding
  759.   Vesta, to be ignored; the first -R makes causes the asteroids to be
  760.   ignored, and specifying Vesta in the second -R makes it reappear.)
  761.  
  762. -R0 [<obj1> ..]: Like -R but restrict everything first.
  763.  
  764.   The -R0 option will cause ALL of the bodies to be ignored, which is
  765.   useful if you are looking for just the transits/aspects of a few
  766.   planets (e.g. -R0 6 7 will cause everything but Juptier and Saturn to
  767.   be ignored.) Combining all these methods can cause whatever you are
  768.   looking for in transits and aspects to be quickly found without having
  769.   to wade through lots of stuff you aren't interested in.
  770.  
  771. -R[C,u,U]: Restrict all minor cusps, all uranians, or stars.
  772.  
  773.   These three switches are similar to the -R0 option in that they
  774.   initially restrict objects, i.e. all the minor cusps, Uranians, and
  775.   stars, (described below) respectively from appearing. For example, if
  776.   you want to include only the star Sirius in an X window chart without
  777.   having to also include all the other stars (or having to enter a very
  778.   long restriction list), do: "astrolog -U -RU 48 -X", which will
  779.   include the stars, and then restrict them all except Sirius, before
  780.   making the chart.
  781.  
  782. -C: Include non-angular house cusps in charts.
  783.  
  784.   This option must be indicated to include the four minor house cusps
  785.   (i.e. 11th, 12th, 2nd, 3rd) in the various chart options, such as the
  786.   -g aspect grids, -T transit searches, the X wheel chart, etc. This
  787.   option of course won't have any effect on certain charts where only
  788.   physical bodies are shown (e.g. -Z, -S, -L) or where all house cusps
  789.   are already indicated in the chart (e.g. -v, -w).
  790.  
  791. -u: Include transneptunian/uranian bodies in charts.
  792.  
  793.   Display the locations of the "Uranian" planets with the -u switch.
  794.   Transneptunian or Uranian planets are an interesting subset of
  795.   astrology which includes various objects alleged to be beyond Pluto.
  796.   (Do: astrolog -u -O to list the eight Uranian bodies.) Anyway,
  797.   Astrolog will display the zodiac positions of these planets as well if
  798.   one includes this option, and will print their positions after the
  799.   main planets, or include them in the other chart types. (Note: the
  800.   Uranians don't have any formal glyphs that I'm aware of, so therefore
  801.   they are displayed in the X charts as three letter abbreviations of
  802.   their name.)
  803.  
  804. -U: Include locations of fixed background stars in charts.
  805.  
  806.   Astrolog has the ability to display the positions of 47 of the
  807.   brightest and most important stars in the sky. To include these stars
  808.   in a chart, use the -U "universe" option. The 43 brightest stars,
  809.   i.e. all those with apparent magnitude values < 2.0 are included, in
  810.   addition to four dimmer "stars" which are considered significant,
  811.   i.e.: Polaris the North star, the Pleiades star cluster (home of our
  812.   extraterrestrial cousins), Zeta Reticuli (home of the Grey aliens),
  813.   and the Andromeda (M31) Galaxy (closest galaxy to our own Milky Way,
  814.   and home to various extraterrestrial hierarchies.) One bright star
  815.   is called "Orion", which is formally Alnilam, the middle star of
  816.   Orion's belt. Since stars are fixed in the sky, they will never
  817.   change position in the -s siderial zodiac, although they will slowly
  818.   precess forward in the normal tropical zodiac. The -R restriction
  819.   option can be used to determine which stars are actually included,
  820.   although the -U option needs to be included to get any stars at all.
  821.   (In X windows, the stars are denoted by three letter abbreviations
  822.   (as are the uranians and minor house cusps), and are colored
  823.   according to their brightness: yellow for stars brighter than (less
  824.   than) magnitude 0.0, gold for dimmer ones from 0.0 to 1.0, orange for
  825.   those from 1.0 to 2.0, and finally the dimmest special stars with a
  826.   magnitude greater than 2.0 are red.)
  827.  
  828. -U[z,l,n,b]: Order by azimuth, altitude, name, or brightness.
  829.  
  830.   In the -v standard chart, -Z horizon chart, and in the -O object list,
  831.   where all the stars are printed sequentially, it can sometimes be
  832.   confusing to locate the star you want among 42 others. The -U option
  833.   can be modified to sort the stars in various ways. If one uses -Ub
  834.   instead of just -U, the stars will be listed in order from brightest
  835.   to dimmest. Doing -Un instead of -U will alphabetize the stars by
  836.   name. -Ul will sort them by their altitude from highest in the sky to
  837.   lowest, while -Uz will sort them by their zodiac position. Note that
  838.   any star ordering will have no visible effect in X windows, and one
  839.   must still use the default ordering when passing numbers to the -R
  840.   option to restrict various stars.
  841.  
  842. -A <0-18>: Specify the number of aspects to use in program.
  843.  
  844.   If you like many aspects, or only desire the major ones, to be
  845.   included in the aspect grids, specifying -A <number> will limit or
  846.   extend the number of aspects (e.g. -A 2 will make charts with only
  847.   conjunctions and oppositions listed in them, while -A 18 will include
  848.   all 18 aspects that Astrolog supports.)
  849.  
  850. -Ao <aspect> <orb>: Specify maximum orb for an aspect.
  851.  
  852.   Change the default orbs of the various aspects with the -Ao <aspect>
  853.   <orb> switch. Do you not like the 7 degree orbs for conjunctions that
  854.   are in there by default? Given an aspect number and an orb value,
  855.   the orb used for that particular aspect is updated accordingly.
  856.   Non-integer orb values are allowed of course. Use negative orb values
  857.   to completely eliminate an aspect from ever appearing. For example:
  858.   astrolog -Ao 2 4 -Ao 4 -1 narrows the orb for Oppositions, and
  859.   completely eliminates Trines, leaving all the other aspects at the
  860.   default values. Note that for very wide orbs more than one aspect may
  861.   apply for a particular angle, in which case the more fundamental
  862.   aspect is chosen. Also for wide aspects the fractional value of the
  863.   orb may be lost in the -g text grid (due to too many characters) and
  864.   their might be some slight overlap in the X window -g cells.
  865.  
  866. -Am <planet> <orb>: Specify maximum orb allowed to a planet.
  867.  
  868.   Ability to explicitly specify maximum orbs that any aspect can make
  869.   to a particular planet is supported with the -Am switch. This is used
  870.   for objects like the North Node which require narrower orbs than what
  871.   the aspects themselves normally allow. The -Am switch takes two
  872.   parameters: the first to indicate the index of the object, and the
  873.   second to indicate what the maximum orb allowed to it will be. By
  874.   default, the only objects with restriction are the Node, Part of
  875.   Fortune, Vertex, and stars, which allow a 2 degree max orb to them.
  876.   With this option, one can change these limits or impose restrictions
  877.   for other planets too. The astrolog.dat file (described later) will
  878.   read in these default planet orbs for the first 20 objects.
  879.  
  880. -Ad <planet> <orb>: Specify orb addition given to a planet.
  881.  
  882.   Ability to widen an aspect orb for any planet is supported with the
  883.   -Ad switch. This is used for objects like the Sun and Moon which
  884.   allow wider orbs to them then what the aspects themselves allow. Like
  885.   the -Am switch, this -Ad switch takes two parameters: the first to
  886.   indicate the object, and the second to indicate how much wider orbs
  887.   allowed to it will be. By default, the only objects which have orbs
  888.   widened for them are the Sun and Moon, each of which adds one degree
  889.   to the orb of any aspect to it. With this option, one can change
  890.   these additions or allow other objects to have them, too. The
  891.   astrolog.dat file will also read in defaults for these orb additions
  892.   for the first 20 planets.
  893.  
  894. ----
  895.  
  896. Switches which affect how a chart is computed:
  897.  
  898. -c <value>: Select a different default system of houses.
  899. (0 = Placidus, 1 = Koch, 2 = Equal, 3 = Campanus, 4 = Meridian,
  900. 5 = Regiomontanus, 6 = Porphry, 7 = Morinus, 8 = Topocentric, 9 = None.)
  901.  
  902.   Ten different house systems are supported: Invoke as astrolog -c
  903.   <number> to change the system from the default of Placidus. (System 9
  904.   refers to no houses at all, or in other words where the Ascendant will
  905.   always be 0 degrees Aries, the Nadir 0 degrees Cancer, etc, which is
  906.   useful for the extended chart animations as described later where
  907.   having houses at all can tend to get in the way, and one can even
  908.   observe the precession of the equinoxes with this system if used in
  909.   conjunction with the -s siderial chart option.)
  910.  
  911. -s: Compute a siderial instead of the normal tropical chart.
  912.  
  913.   With this option, the chart will be just like the normal charts as
  914.   most commonly used in astrology, except that all the zodiac positions
  915.   will be shifted (to be about 24 degrees earlier). This is because the
  916.   option casts siderial charts which are based on the positions of the
  917.   fixed stars (i.e. Aries starts at the constellation Aries) rather than
  918.   the seasons (i.e. Aries starts at the Spring or Vernal Equinox.) Due
  919.   to the "precession of the equinoxes" the the position of the Sun at
  920.   the Equinoxes has been gradually happening at an earlier point in the
  921.   siderial zodiac each year (taking about 2100 years change signs.)
  922.  
  923. -s0: Display locations as right ascension instead of degrees.
  924.  
  925.   For astronomers out there, this -s0 option will print all planetary
  926.   positions in the right ascension hours/minutes format instead of the
  927.   sign/degrees/minutes astrologers are accustomed to. This will affect
  928.   how the objects are listed in the -v display, and how the star
  929.   azimuths are displayed in the -O list. For example, 0 degrees Aries is
  930.   represented as 0 hr, 0 min; 0 Cancer goes to 6 hr, 0 min, and so on
  931.   through the 24 hour clock.
  932.  
  933. -h [<objnum>]: Compute positions centered on specified object.
  934.  
  935.   Normal astrology charts are based on the positions of the planets
  936.   relative to the Earth. However, this option allows seeing of the
  937.   zodiac positions with respect to the Sun's (or any other planet's)
  938.   point of view. The -h option when invoked by itself will display a
  939.   heliocentric chart: the Sun in the original listing will be replaced
  940.   with the Earth's position as seen from the Sun in the heliocentric
  941.   chart, with the other planets' positions modified accordingly. For
  942.   bodies other than the Sun, the option takes a parameter to indicate
  943.   which planet to center the chart on, e.g. do -h 5 to cast a Mars
  944.   centered chart. (Moon centered charts aren't allowed; in fact, note
  945.   that the -h option won't ever affect the Moon, which will always be
  946.   displayed as seen from the Earth, no matter what the center body is
  947.   set to, since it's not a formal planet.
  948.  
  949. -p <month> <day> <year>: Cast progressed chart based for date.
  950.  
  951.   A secondary progression chart for a particular date can be cast using the
  952.   '-p <month> <date> <year>' command switch. (Note, I'm not sure if the house
  953.   cusps are progressed correctly, but they're reasonably close to what is
  954.   properly expected.)
  955.  
  956. -pn: Cast progressed chart based on current date now.
  957.  
  958.   The -pn switch is like the -p <month> <date> <year> switch except that
  959.   (like the -n switch) it assumes the current moment now to cast the
  960.   progressed chart to. This is just another shorthand convenience to see
  961.   what ones progressed chart is like presently; just do: astrolog -i
  962.   file -pn.
  963.  
  964. -p0 <days>: Set no. of days to progress / day (default 365.25).
  965.  
  966.   User definable progression rates can be specified with this option.
  967.   When using the -p progression option, Astrolog assumes you want the
  968.   standard "year for a day" rate of secondary progressions. By passing
  969.   different values to the -p0 switch, one can change the default "365.25
  970.   days for a day" to any value they want for some less often used method
  971.   of progression. For example, one can do "-p0 7 -pn" to do a week for a
  972.   day, "-p0 -365.25 -pn" to get negative year for day progressions, and
  973.   so on. (Note that "-p0 1" would be the same as if no progression were
  974.   done at all.)
  975.  
  976. -x <1-360>: Cast harmonic chart based on specified factor.
  977.  
  978.   Harmonic charts (i.e. where all the planet positions are multiplied by a
  979.   factor and the chart recast) are supported via the '-x' option. (e.g.
  980.   -x 3 will make all trines conjunct in the chart displayed.)
  981.  
  982. -1 [<objnum>]: Cast chart with specified object on ascendant.
  983.  
  984.   The -1 <obj> option can be used to change the houses to force a
  985.   particular object to be on the ascendant. This is useful in casting
  986.   Solar charts or for when the time of birth is not exactly known. For
  987.   example -1 2 will case a normal chart, but the house cusps will be
  988.   rotated so that the moon is on the ascendant.
  989.  
  990. -2 [<objnum>]: Cast chart with specified object on midheaven.
  991.  
  992.   Just as the -1 option is used to cast a chart with an object on the
  993.   Ascendant, the -2 <object> switch will cast a chart with the
  994.   specified object on the Midheaven. The house cusps will be rotated so
  995.   that the object in question is conjunct the 10th house cusp. As with
  996.   the -1 option, if <object> is not specified, the Sun will be assumed
  997.   by default.
  998.  
  999. -3: Display objects in their zodiac decan positions.
  1000.  
  1001.   Decan displays are supported in Astrolog, and one can display a decan
  1002.   influenced chart with the -3 switch. The decan theory is that each
  1003.   sign in the zodiac can be divided into three parts: The first 10
  1004.   degrees (i.e. the first decan) is mainly influenced by the sign in
  1005.   question, the second 10 degrees (second decan) although still
  1006.   influenced by the sign in question is also somewhat influenced by the
  1007.   next sign of the same element, while the last decan is influenced by
  1008.   the third sign of the same element. The -3 switch applied to a chart
  1009.   will move each object into the sign of its decan. For example, if the
  1010.   Sun is at 29 degrees Aquarius and the Moon at 5 degrees Virgo, in the
  1011.   resulting chart, the Sun will go to Libra (26 degrees) and the Moon
  1012.   will remain in Virgo (although be at 15 degrees now since it was
  1013.   previously in the middle of the first decan of Virgo.)
  1014.  
  1015. -f: Display houses as sign positions (flip them).
  1016.  
  1017.   The -f option can be used to "flip" the signs and houses, i.e. display
  1018.   the house as a sign position and vice versa. For example having the
  1019.   Sun at 26 degrees Scorpio, 2/3 way though the 10th house, will cause
  1020.   the resulting Sun under the -f option to be at 20 degrees Capricorn,
  1021.   26/30th the way through the 8th house. This can be used to determine
  1022.   how far a planet is through a particular house, as well as for Domal
  1023.   chart analysis that Mark Kenski has informed me about. Domal analysis
  1024.   is based on the fact that for synastry comparisons, for example, a
  1025.   planet in Gemini and one in the 3rd house can be considered related in
  1026.   a way similar to a conjunction.
  1027.  
  1028. -G: Display houses based on geographic location only.
  1029.  
  1030.   This switch generates a special type of locational analysis chart,
  1031.   called a geodetic chart, in which the house cusps are computed from a
  1032.   different source, i.e. as a function of only the longitude and
  1033.   latitude. This basically gives every spot on the planet a different
  1034.   unique set of house cusps, and can be used to analyze the
  1035.   characteristics of different areas, and their influence on you if you
  1036.   insert your own planets in the houses. This type of chart was
  1037.   described in the January 1992 issue of Dell Horoscope magazine, from
  1038.   which I learned how to generate these charts. Basically, the Midheaven
  1039.   is approximately the longitude value converted from degrees into the
  1040.   appropriate zodiac sign; for example 0 degrees E goes to 0 degrees
  1041.   Aries, 30 degrees E goes to 0 degrees Taurus, etc.
  1042.  
  1043. -F <objnum> <sign> <deg>: Force object's position to be value.
  1044.  
  1045.   The -F option is used to force a particular object's position to
  1046.   always be a particular location in the zodiac. This feature can be
  1047.   used as an easy way to manually include things Astrolog normally
  1048.   doesn't in various charts. For example, this can be used to force the
  1049.   position of some minor thing, like the Vertex, to always be the
  1050.   location of whatever you prefer, like the 0 degrees Aries point, or
  1051.   an important midpoint. Then you can do an aspect grid, transit
  1052.   search, or whatever, and calculate aspects to midpoints or transits
  1053.   over midpoints. The -F switch takes three arguments: first is the
  1054.   index of the object to replace, next is the sign from 1..12 to force
  1055.   it to be, and third is the degree within the sign. For example, if I
  1056.   want to see if anything is making an exact aspect today with my Sun
  1057.   Moon midpoint at 6Sag28, I could do "astrolog -n -d -F 16 9 6.28",
  1058.   which would replace the North Node with my Sun Moon midpoint in the
  1059.   aspect search.
  1060.  
  1061. -+ <days>: Cast chart for specified no. of days in the future.
  1062.  
  1063.   The -+ <#ofdays> option will cast a normal chart, but one for #ofdays
  1064.   in the future (or past if a negative value is given). One use for
  1065.   this is in combination with the -n and -d options. For instance, I
  1066.   often invoke the program as "astrolog -n -d" to see the exact times
  1067.   of today's aspects. However, just before midnight I might want to
  1068.   see what's going to happen in the following day, so I would do
  1069.   "astrolog -n -d -+ 1" to see the exact times for tomorrow's aspects.
  1070.  
  1071.   Note that for such a chart, the chart header will show the correct
  1072.   date of the actual new chart, instead of the original one. For
  1073.   example, today (9-11), if I do "astrolog -n -+ 2" I will get the
  1074.   chart for two days from now, and the chart header will display 9-13.
  1075.   This has some special uses. For example, if you want to know what the
  1076.   date was/will be when you are 10000 days old, do "astrolog -i
  1077.   yourchart -+ 10000" and see what the date in the resulting chart
  1078.   header is.
  1079.  
  1080. -- <days>: Cast chart for specified no. of days in the past.
  1081.  
  1082.   This new "dash minus" option is just like the "dash plus" (-+) option
  1083.   described above, except it subtracts instead of adds the specified
  1084.   number of days from any chart cast. This is only for convenience, in
  1085.   that "-- 1" is the same as "-+ -1".
  1086.  
  1087. ----
  1088.  
  1089. Other features or major modes:
  1090.  
  1091. -r <file1> <file2>: Compute a relationship synastry chart.
  1092.  
  1093.   Computing the relationship between two charts is supported. Invoke the
  1094.   program as 'astrolog -r <file_of_person1> <file_of_person2>' and the
  1095.   program will give you the relationship between the two charts. In
  1096.   other words, the program will use the positions of person2's planets
  1097.   and person1's houses. Use this with the -w option to get a wheel chart
  1098.   and you can do synastry. Note that transits can be computed with this
  1099.   by comparing your chart with the positions of the planets at the
  1100.   current moment (as in -n switch). To make this easier, you may specify
  1101.   the filename "now" for any file and the computer will use the current
  1102.   planet positions instead of looking for a like named file. (e.g.
  1103.   'astrolog -r me now' will compute transits for file 'me'.)
  1104.  
  1105. -rc <file1> <file2>: Compute a composite chart.
  1106.  
  1107.   The '-r' option can be used to generate composite relationship charts.
  1108.   Simply invoke it as '-rc <person1> <person2>' instead of just -r and a
  1109.   composite chart (i.e. composed of the midpoints of the planets, etc.
  1110.   of the two charts in question) will be generated.
  1111.  
  1112. -rm <file1> <file2>: Compute a time space midpoint chart.
  1113.  
  1114.   Time-space midpoint relationship charts are supported: Doing "-rm
  1115.   chart1 chart2" will calculate the time and location exactly half way
  1116.   between the times and locations as indicated in the two files. Unlike
  1117.   all other types of relationship charts, this one actually exists in
  1118.   space and time, and therefore can be treated like a single chart and
  1119.   can be output to a file with the -o option.
  1120.  
  1121. -rd <file1> <file2>: Print number of days between files' dates.
  1122.  
  1123.   One useful non-astrological function in the program is the ability to
  1124.   determine how many days have passed between two dates, with the -rd
  1125.   switch. As with the -rb option below, this is considered a
  1126.   relationship "chart" because it requires the input of two different
  1127.   dates, and when -rd is in effect, again the standard -v planet
  1128.   position listing will be replaced by a line telling how many days are
  1129.   in the interval. For example, "-rd person1 person2", will display how
  1130.   many days person1 is older than person2 (or the other day around).
  1131.   Want to find out how many days old you will be on Jan. 1, 2000? Do
  1132.   "-rd yourchart tty", and type in the first date of the next
  1133.   millenium, and see what you get!
  1134.  
  1135. -rb <file1> <file2>: Display biorythm for file1 at time file2.
  1136.  
  1137.   Biorythm charts are supported by Astrolog with the -rb switch.
  1138.   Although not directly related to Astrology, the concepts are similar,
  1139.   and adding this didn't require much extra code, and since some are
  1140.   interested in this, I felt I'd add it in. The biorythm theory says
  1141.   that we have have three main types of energy: Physical, Emotional,
  1142.   and Intellectual. These three run in continuous wave cycles from high
  1143.   to low, each of which repeats about every 30 days or so. Therefore, a
  1144.   biorythm chart for a particular day should describe how much energy
  1145.   one has or how they are feeling in this area. Now, Astrolog considers
  1146.   biorythm charts as a type of relationship chart, because in order to
  1147.   generate one, two dates or charts are needed: the birth date of the
  1148.   person, and the date to cast their chart for. Technically the program
  1149.   will replace the standard -v listing of planet positions with the
  1150.   biorythm chart when -rb is in effect. As an example, "-rb file1
  1151.   file2" will cast the chart for the birthday signified by chart1 or
  1152.   chart2 (whichever is older) for the date in the other file. Remember
  1153.   that one can substitude the pseudo filename 'tty' to mean get the
  1154.   chart info from the terminal instead.
  1155.  
  1156.   The actual biorythm chart itself will display, for the day in
  1157.   question, what the percentages of the physical, emotional, and
  1158.   intellectual cycles are, as numbers from -100% (low ebb) to +100%
  1159.   (happy and full of energy). In addition, the biorythm percentages for
  1160.   the seven days before (T-7 days) and the seven days after (T+7 days)
  1161.   the date in question will be listed, too, so one can see if the
  1162.   cycles are rising or falling. Finally, as a cute way to help in
  1163.   interpretation, the program prints the appropriate smiley, medium, or
  1164.   sad face after each percentage. (BTW, it takes over 58 years for all
  1165.   three cycles together to synchronize and repeat themselves.)
  1166.  
  1167. -r0 <file1> <file2>: Keep the charts separate in comparison.
  1168.  
  1169.   There is of course a distinction between synastry relationship charts
  1170.   and the actual comparison between two separate charts. The -r0 option
  1171.   is used to generate actual comparison charts. For example, combining
  1172.   -r0 with the -g switch will cause a full grid chart of the aspects
  1173.   between all the planets of the two charts (with person1's planets on
  1174.   the vertical axis and person2's on the horizontal) to be displayed.
  1175.   (Unfortunately, if all 20 of the default objects are left unrestricted
  1176.   here, the grid will exceed 80 columns.) The -r0 option can also be
  1177.   used with the -X switch to generate true relationship wheel charts,
  1178.   (described later). The -r0 option will act like the -r synastry option
  1179.   in certain displays that can't compare two charts; for example, '-r0
  1180.   -v' will act the same as just '-r -v'. (Note: the "-t file" current
  1181.   transit option is basically a shorthand way of doing "-r0 file now".)
  1182.  
  1183. -t <file>: Compute current house transits for particular chart.
  1184.  
  1185.   The command switch '-t <file>' can be used as a shortcut way to
  1186.   compute the current transits for the chart in <file>. (Saves you from
  1187.   having to mention the 'now' in the '-r0' option.)
  1188.  
  1189. -t[b|d] <file>: Print biorythm/datediff for current time now.
  1190.  
  1191.   The -t option has been extended based on the -rd and -rb features.
  1192.   Remember, the -t option is a shorthand for specifying a relationship
  1193.   comparision chart where one of the charts is that for the current
  1194.   moment now (assuming you have TIME compiled in.) The -tb <file>
  1195.   switch will display the person indicated in file's biorythm for
  1196.   today. The -td <file> switch will display how many days old the
  1197.   person in the file is today.
  1198.  
  1199. -T <file> <month> <year>: Compute all transits in month for chart.
  1200.  
  1201.   The '-T <file> <month> <year>' option will scan the entire month
  1202.   specified, and print out any transits that happen, in that month, to
  1203.   the planets as listed in the specified <file>. There will be quite a
  1204.   few, even though fast moving objects like the moon aren't looked at,
  1205.   so you might want to use this with the -R option to limit this to just
  1206.   certain planets. (The times are displayed in the local time zone, and
  1207.   are generally accurate to within a half hour or so; Try doing it for
  1208.   your birth month and your own chart - All planets should conjunct
  1209.   their natal positions at about the time of your birth.) Putting a zero
  1210.   in place of the month will cause the entire year to be scanned, which
  1211.   prevents one from having to search each month in turn if they are
  1212.   looking for something in particular. Note that the -T option includes
  1213.   ALL of one's natal house cusps in the transit scans (instead of just
  1214.   the Asc and MC). The 11th, 12th, 2nd, and 3rd cusps are included (and
  1215.   oppositions to these and the Asc/MC can be used to to determine
  1216.   aspects to the other six cusps.)
  1217.  
  1218. -T0 <..>: Like -T but include transits of the Moon as well.
  1219.  
  1220.   Normally the -T option always ignores the moon and does not include
  1221.   the transiting moon in the lists because it moves so fast and would
  1222.   cause an enormous amount of info. Still, if you are looking for lunar
  1223.   transits, specifying the option as -T0 instead of just -T will include
  1224.   the moon.
  1225.  
  1226. -Tp <file> <month> <year>: Compute all progressions in month for chart.
  1227.  
  1228.   Determining dates of transits of progressed planets to natal planets
  1229.   can be done with the -Tp <file> <month> <year> option. This is just
  1230.   like the -T option, except that the exact aspects of progressed
  1231.   planets (rather than transiting planets) to the planets in 'file' are
  1232.   displayed. Again, one can substitute '0' for the month to scan the
  1233.   entire year (which might be desirable since progressions occur much
  1234.   less often than transits, and there will only be a few, if any, in a
  1235.   given month.)
  1236.  
  1237. -E <month> <year>: Display planetary ephemeris for given month.
  1238.  
  1239.   The '-E <month> <year>' option will generate a quick ephemeris for the
  1240.   ten main bodies for the month in question, useful if you just want to
  1241.   see what's happening this month in the sky. It generally is used by
  1242.   itself and not with any other options. (Displayed daily for midnight,
  1243.   default time.) Any dots after a planet location in the list indicate
  1244.   the planet was retrograde at the time. The -E <month> <year> ephemeris
  1245.   option can also be used to display the ephemeris for the entire year
  1246.   instead of just for one month. Like the -T option, putting a '0' for
  1247.   the month will give the entire year's ephemeris.
  1248.  
  1249. -E0 <..>: Like -E but include all unrestricted bodies.
  1250.  
  1251.   The -E option can also display the Asteroids, Chiron, and the Node in
  1252.   the ephemeris listing if one invokes it as -E0 instead of just -E.
  1253.   Note however that this will make each line more than 80 columns, so
  1254.   this is mainly just for printing purposes.
  1255.  
  1256. ----
  1257.  
  1258. Switches to access graphics options:
  1259.  
  1260. -X: Create a graphics chart instead of displaying it as text.
  1261.  
  1262.   This is the general switch, which means display a chart in an X window
  1263.   instead of on the screen in some form. For example, the command
  1264.   'astrolog -i mychart -X' will open a new window and display the chart
  1265.   in question in it. (Of course, all the other switches, e.g. -R, -c,
  1266.   -1, etc, can be used to change what info is actually displayed.) If
  1267.   you use the -L astro-graph switch in addition to this, the appropriate
  1268.   astro*carto*graphy map will come up in a window instead of the earlier
  1269.   boring list of longitudes. (e.g. astrolog -i me -X -L) The -Z and -g
  1270.   switches will produce their own chart types as well, although, of
  1271.   course, only one type of chart can be in a window at any given time.
  1272.  
  1273. -Xb: Create X bitmap instead of putting graphics in window.
  1274.  
  1275.   This switch will cause a standard X11 bitmap file to be produced
  1276.   instead of putting the graphics in an actual window. This is useful if
  1277.   you want to convert the graphics to different formats, e.g. so they
  1278.   can be displayed on PC's, etc. Note that -Xb (or any other -X<letter>
  1279.   switch) automatically assumes the -X switch above, so 'astrolog -i
  1280.   file -Xb' is sufficient (and you don't also have to include the -X).
  1281.  
  1282. -XB: Display X chart on root instead of in a separate window.
  1283.  
  1284.   This switch will cause the chart graphics to be displayed directly on
  1285.   the root window. This action occurs very quickly since the program
  1286.   does not have to write a separate bitmap file and call xsetroot -bitmap
  1287.   on it (although one could easily do this if they want to). For example,
  1288.   one could put the line 'astrolog -n -XB' in their .xsession file
  1289.   and whenever they log in, their background will be set to a chart of
  1290.   the current state of the planets!
  1291.  
  1292. -Xm: For color monitors, display charts in black and white.
  1293.  
  1294.   For color X systems, the -Xm switch will create all windows in
  1295.   monochrome B/W mode.
  1296.  
  1297. -Xr: Create window or bitmap in reversed colors (B on W).
  1298.  
  1299.   Normally the charts comes up white on a black background. To get the
  1300.   chart or bitmap displayed in reverse video (black on white), use this
  1301.   -Xr switch.
  1302.  
  1303. -Xw <hor> [<ver>]: Change the size of the chart window.
  1304.  
  1305.   The default window size is 600x600. This can be changed with the -Xw
  1306.   switch. -Xw with one argument n will make an n by n window; -Xw with
  1307.   two arguments x and y will make an x by y window with the chart
  1308.   centered in the middle. Note that this switch will not affect
  1309.   astro-graph or aspect grid windows; to change the size of these use
  1310.   -Xs below.
  1311.  
  1312. -Xs <percentage>: Change the size of characters by n%.
  1313.  
  1314.   Note that the size of the planet and sign glyphs don't change when you
  1315.   change the size of the window. This can cause problems for very small
  1316.   windows where the glyphs overlap the rest of the chart and for very
  1317.   large windows where there is lots of excess space. The -Xs switch can
  1318.   be used to change the size of all glyphs. The valid values that can be
  1319.   passed to it are 100, 200, and 300, where 200 is the default. Note
  1320.   that this switch is used to change the size of the astro-graph (and
  1321.   aspect grid) windows (because the world map is considered to be one
  1322.   giant glyph by the program.)
  1323.  
  1324. -Xi: Display chart in slightly modified form.
  1325.  
  1326.   Certain people have asked that some of the X charts be modified in
  1327.   various minor ways, i.e. in either adding or removing certain
  1328.   information. Rather than add a new hard to remember minor option for
  1329.   each change, I have added one major new switch which covers all the
  1330.   charts. The new -Xi switch will invoke this "induce/inhibit
  1331.   information" option, and pressing the 'i' key in a window will
  1332.   accomplish the same thing by toggling the mode's status. By default,
  1333.   all the charts are as before, but when this bonus option is set, it
  1334.   affects each X window chart in a different way, as follows:
  1335.  
  1336.  o For the standard -v and relationship -r0 -v wheel charts, it will
  1337.    inhibit the display of the aspect grid in the center - useful for
  1338.    speed or when doing large time lapse animations when it would get in
  1339.    the way.
  1340.  
  1341.  o For the -g aspect grid, it will flip the aspects and midpoints across
  1342.    the center diagonal, i.e. the midpoints will be below it and the
  1343.    aspects above it, instead of the other way around. For the -r0 -g
  1344.    relationship aspect grid, the entire grid will be replaced with one
  1345.    showing all midpoints between all the objects in the two charts.
  1346.  
  1347.  o For the -Z horizon chart and -S space chart, it will, for the major
  1348.    planets, increase the size of the "points" showing where each object
  1349.    actually is, making a brighter "spot", for easier viewing; combine
  1350.    this in the horizon chart with the 'l' key label inhibitor and get a
  1351.    very realistic view of the night sky, with planets brighter and all.
  1352.  
  1353.  o For the -L astro-graph chart, this will eliminate the display of the
  1354.    Ascendant, Descendant, and Nadir lines, leaving just the vertical
  1355.    Midheaven lines and zenith points, for a remarkable increase in speed
  1356.    and much less clutter when including many objects.
  1357.  
  1358.  o For the -XW world map display, this will show the Earth's ley line
  1359.    locations by drawing them on top of the map. Familiar with ley lines?
  1360.    They are lines of energy crossing the Earth. I was experimenting
  1361.    earlier with the master ley line grids on the Earth (in the pattern of
  1362.    an overlapped 20 sided Icosahedron and 12 sided Dodecahedron) and I
  1363.    figured Astrolog with its world map would be an interesting program to
  1364.    explore this with. Actually this is mainly a hack, and belongs more to
  1365.    the field of dowsing than to astrology, but I figured I would leave it
  1366.    in there for amusement and inspiration. (Hackers note: there is an
  1367.    interesting "bug" that can arise with the -XW as well as the -XG (and
  1368.    -XP, described below) switches: These displays can be brought up in a
  1369.    window without having to specify an actual chart. Now suppose one
  1370.    presses 'C', 'W', etc. to bring up a chart - what will be displayed?
  1371.    The answer will be whatever default values were already there, and if
  1372.    you're curious, it's set to be the chart for the release of this
  1373.    version of the program itself: The Full Moon on Sep 11, 1992 7:18pm
  1374.    PDT (-7:00 GMT) Seattle, WA 122W20, 47W36.
  1375.  
  1376.  o For the -XP polar globe view, this will show the southern hemisphere
  1377.    instead of the northern.
  1378.  
  1379.  o For the -XG globe display, it will display the zenith locations of all
  1380.    planets (and stars if -U in effect) on the globe, i.e. where on the
  1381.    Earth each object could be viewed by looking straight up. This on the
  1382.    globe display is almost identical to the astro-graph chart without its
  1383.    various lines, except of course that the projection of the world map
  1384.    is different. It's also similar to the -Z horizon display, except that
  1385.    it's free from the distortion of projecting the celestial sphere upon
  1386.    a plane, so it has use to star gazers. However, animation mode here
  1387.    will still only affect what part of the Earth is viewable, and won't
  1388.    update the chart from which the zenith locations were obtained.
  1389.  
  1390. -XT: Inhibit display of chart info at bottom of window.
  1391.  
  1392.   Normally, at the bottom of any chart window is printed some header
  1393.   information listing the date, time, and location of the chart in
  1394.   question. One can inhibit this display by specifying the -XT switch.
  1395.  
  1396. -XW: Simply create the bitmap of the world.
  1397.  
  1398.   Believe it or not, I painstakingly entered the data for the world map
  1399.   used by the program by hand using an Atlas during a long week. If you
  1400.   just want to see the map of the world by itself without any
  1401.   astro-graph lines on it, use the -XW switch.
  1402.  
  1403. -XW0: Like -XW but don't just do rectangular projection.
  1404.  
  1405.   The -XW0 switch is just like the normal -XW switch in that it just
  1406.   displays the world map and nothing else, except that this -XW0 map
  1407.   generated will be in what's called the Mollewide projection, a good
  1408.   looking form often used for maps of the world, as opposed to the
  1409.   standard rectangular map projection used in -XW which distorts the
  1410.   polar regions of the globe across the top and bottom of the screen.
  1411.   (The Mollewide projection pinches the polar regions together,
  1412.   generating a elliptical map, which is similar to the -XG globe
  1413.   displays, but which shows the whole world instead of just half.)
  1414.  
  1415. -XP: Create the bitmap of the world, but as a polar projection.
  1416.  
  1417.   The -XP option will generate a polar view of the Earth as a globe.
  1418.   This is like the -XG globe option except that the view is always from
  1419.   the top (or bottom). By default, the view is looking down on the north
  1420.   pole with 0 deg W/E toward the bottom of the screen. (Animation mode
  1421.   will cause the view to spin about the center of the screen.) To see a
  1422.   view of the south pole hemisphere, go into the bonus information mode
  1423.   described above ('i' key). Again, like with all the other X window
  1424.   display modes, one can enter this display with a keystroke: press 'P'
  1425.   in any Astrolog window and it will revert to this display.
  1426.  
  1427. -XG [<degrees>]: Display the bitmap of the world as a globe.
  1428.  
  1429.   Once we have the data for the map of the world, there are
  1430.   several neat things we can do with it; for instance, with a little
  1431.   trigonometry and clipping, we can bring up a view of a globe, which
  1432.   is what the -XG switch does. An optional argument will specify a
  1433.   rotation value in degrees to display different parts of the globe.
  1434.   (The globe seems to look best for a -Xw window size of around 350.)
  1435.  
  1436.   Note that the -XW and -XW0 maps can be animated like as this -XG
  1437.   globe display can. Animation of these maps are done by shifting the
  1438.   whole map to one side or the other. In fact, such a feature can be
  1439.   used indirectly to shift one of the X window astro-graph charts
  1440.   (which are drawn on the world map) from the normal case of having the
  1441.   date line on the edges of the screen: Go into the world map or globe
  1442.   display, animate it a bit, and then change graphic modes to display
  1443.   the astro-graph chart, and it will be shifted by the corresponding
  1444.   amount. (Note that animating the astro-graph screen itself will
  1445.   change the chart info, not how the screen itself is done.) Because
  1446.   the -XW world map, and -XP polar globe display, can be animated just
  1447.   as the -XG general globe display can, the -XW and -XP switches accept
  1448.   optional parameters on the command line that will specify what degree
  1449.   (from 0 to 359) to start the map at, just like the -XG switch does.
  1450.   In addition, the -XG option itself accepts a second optional
  1451.   parameter, which is the starting angle for the globe's tilt, from -90
  1452.   to +90 degrees.
  1453.  
  1454. -Xn: Start up chart or globe display in animation mode.
  1455.  
  1456.   The -Xn [<value>] option can be used to start up an X window in
  1457.   animation mode. It a window, one would have to explicitly press 'N' or
  1458.   a shift+number key to start the window animation. Without a parameter
  1459.   after -Xn, the option will start it up in continuous update to "now"
  1460.   mode (which is like pressing 'N' in that any chart will be erased with
  1461.   the current chart now.) The switch can accept parameters from 1..9,
  1462.   corresponding to the animation rates obtained by pressing shift 1..9
  1463.   in the window, i.e. update whatever chart is passed to it seconds,
  1464.   minutes, hours, days, months, years, etc. later each time.
  1465.  
  1466. -Xo <file>: Write output bitmap to specified file.
  1467.  
  1468.   This option is used in conjunction with the -Xb option, to specify the
  1469.   name of the file to write the bitmap to.
  1470.  
  1471. ----
  1472.  
  1473. Astrolog window keypress options (version 2.30):
  1474.  
  1475. Press 'H' or '?' to display this list of key options.
  1476.  
  1477.   The most important key, of course. Pressing this will display a help
  1478.   list of all the key presses available in the text screen from which
  1479.   the window was invoked from.
  1480.  
  1481. Press 'p' to toggle pause status on or off.
  1482.  
  1483.   Press this to pause all updates to the window. This is mainly used to
  1484.   freeze any animation (see below) but also has an effect even on
  1485.   'still' windows. Key presses will still be accepted in pause mode but
  1486.   their effects won't be apparent until one presses 'p' again to
  1487.   continue. This can be used to temporarily freeze a chart in animation
  1488.   so that it can be looked at without interruption.
  1489.  
  1490. Press 'x' to toggle fg/bg colors in window.
  1491.  
  1492.   Pressing this will invert the colors in the window, or in other
  1493.   words will do the same thing as the -Xr switch on the command line.
  1494.  
  1495. Press 'm' to toggle color/monochrome display in window.
  1496.  
  1497.   For color displays, pressing this key will toggle in and out of
  1498.   monochrome mode.
  1499.  
  1500. Press 'T' to toggle header info on current chart in window.
  1501.  
  1502.   Pressing the 'T' key will toggle whether or not the chart parameters
  1503.   are printed at the bottom of the window. This corresponds to the -XT
  1504.   switch mentioned earlier.
  1505.  
  1506. Press 'i' to toggle status of the minor chart modification.
  1507.  
  1508.   Pressing this key will toggle whether or not an alternate form of the
  1509.   present chart should be displayed. See the -Xi switch described
  1510.   earlier for more information on these alternate chart formats.
  1511.  
  1512. Press 'l' to toggle labeling of object points in chart.
  1513.  
  1514.   Press the 'l' key in a window to inhibit the labeling of all planets
  1515.   in the various charts. Instead of drawing the little point and then
  1516.   the glyph near it, just the point is displayed. This mode is mainly
  1517.   useful for the -Z horizon and -S space charts (and has little use for
  1518.   anything else) when in cramped quarters or to get a more realistic
  1519.   view of how the sky actually looks.
  1520.  
  1521. Press 'v' to display current chart in window on text screen.
  1522.  
  1523.   Press this key to dump back to the text screen the list of where all
  1524.   the planets currently being displayed in the window are. This display
  1525.   is the same as produced with the -v switch, and is useful if one wants
  1526.   text to show where everything in the chart is.
  1527.  
  1528. Press 'R' to toggle restriction status of minor objects.
  1529.  
  1530.   Press the 'R' (restrict) key in an Astrolog X window and the screen
  1531.   will be redrawn with the restriction status of these asteroids and
  1532.   other minors toggled.
  1533.  
  1534. Press 'C' to toggle restriction status of minor house cusps.
  1535. Press 'u' to toggle restriction status of uranian planets.
  1536. Press 'U' to toggle restriction status of fixed stars.
  1537.  
  1538.   Pressing the 'C', 'u', and 'U' keys in the window will toggle the
  1539.   restriction status of the four minor house cusps, the uranian planets,
  1540.   and the fixed stars, respectively. These keys compliment the 'R' key
  1541.   option already in place, and are the counterparts to the -C, -u, -U,
  1542.   and -RC, -Ru, -RU options.
  1543.  
  1544. Press 's', 'h', 'f', 'F' to toggle status of siderial zodiac,
  1545. heliocentric charts, domal charts, and decan charts.
  1546.  
  1547.   Press the 's' key in the window to toggle whether or not the siderial
  1548.   vs. tropical zodiac is used. Press the 'h' key to toggle to a
  1549.   heliocentric based chart or back again to a geocentric one. Press the
  1550.   'f' key to toggle the status of whether or not the chart should be
  1551.   modified to correspond to the appropriate domal chart (where the house
  1552.   positions are represented as zodiac positions and vice versa). Press
  1553.   the 'F' key to toggle the status of whether or not the chart should be
  1554.   modified to correspond to a decan chart (where each sign is divided in
  1555.   thirds representing the two other signs in its element). These keys of
  1556.   course correspond the the -s, -h, -f, and -3 options, respectively.
  1557.  
  1558. Press 'O' and 'o' to recall/store a previous chart from memory.
  1559.  
  1560.   Have you ever animated your natal or some other chart to some far
  1561.   distant future or past time, only then to wish you could somehow
  1562.   easily get back in time to the original chart? You can, by pressing
  1563.   the 'O' key in a window, which will recall to the screen previously
  1564.   "saved" chart parameters (which are by default set to whatever you
  1565.   started the window with.) Press the 'o' key to change this default
  1566.   stored chart to be the chart that is presently in the window.
  1567.  
  1568. Press 'B' to dump current window contents to root background.
  1569.  
  1570.   Press the 'B' key in an X window to dump whatever is currently being
  1571.   displayed to the background root window. This is basically the
  1572.   corresponding keypress to the -XB option.
  1573.  
  1574. Press 'Q' to resize wheel chart display to a square.
  1575.  
  1576.   One can manually resize the Astrolog windows using a window manager
  1577.   (except when a world map or aspect grid is displayed, in which case
  1578.   any resizing will have no effect). Pressing the 'Q' key will
  1579.   automatically resize any (non-world map) window to be a square. This
  1580.   is useful, after resizing charts to approximately the size you want,
  1581.   to make them precise squares.
  1582.  
  1583. Press '<' and '>' to decrease/increase the scale size of the
  1584. glyphs and the size of world map.
  1585.  
  1586.   This two keys will respectively decrease and increase the size of the
  1587.   sign and planet glyphs (as well as resize the astro-graph and aspect
  1588.   grid charts) through the three scale factors available. After resizing
  1589.   the window, you will probably want to use these keys if the glyphs are
  1590.   then too big or small for the new chart.
  1591.  
  1592. Press '[' and ']' to decrease/increase tilt in globe display.
  1593.  
  1594.   '[', ']' keys: Not only can the globe display be rotated, but the
  1595.   poles can be now tilted down at various angles! (This basically makes
  1596.   the -XP polar globe view option obsolete; it's still in there only for
  1597.   backwards compatibility.) Press the '[' and ']' keys when the globe is
  1598.   being displayed to respectively "pull down" and "push back up" the
  1599.   angle of the polar axis from which the globe is viewed.  Combining
  1600.   this with the globe rotation allows one to move any point of the globe
  1601.   to the center of the screen.
  1602.  
  1603. Press 'N' to toggle animation status on or off. Charts will
  1604. be updated to current status and globe will rotate.
  1605.  
  1606.   Animation! This key will toggle in and out of a mode where the chart
  1607.   is continually updated in the window. Entering the animation mode
  1608.   will cause the chart being currently displayed to be replaced by the
  1609.   chart for the exact moment at the time you are running the program.
  1610.   Every second or two, the chart will be updated to reflect the new
  1611.   current state of the planets and houses. For large window sizes, one
  1612.   can actually see very minor changes in the chart every few seconds.
  1613.   With the text 'T' mode in effect, the chart is basically an advanced
  1614.   version of xclock, and makes a good window to be left running on
  1615.   your display. If you are in the -XG globe display mode, pressing
  1616.   the 'N' key will cause the globe to rotate for an impressive display!
  1617.  
  1618. Press '!'-'(' to begin updating current chart by adding times.
  1619. !: seconds, @: minutes, #: hours, $: days, : months,
  1620. ^: years, &: years*10, *: years*100, (: years*1000.
  1621.  
  1622.   These nine keys (i.e. shift plus the number keys from 1..9) enter
  1623.   into a different form of chart animation. Pressing them will cause the
  1624.   current chart being displayed (i.e. it will not revert to the current
  1625.   planet positions) to continually have a delta time added to it and be
  1626.   recast and shown. Pressing '!' will have one second added to the chart
  1627.   for every update (slow action unless you have a very fast system - the
  1628.   animation will be even slower than for the 'N' key). Pressing '@' will
  1629.   have one minute added to the chart each time, which makes for a nice
  1630.   display (note that you will definitely want to be in the text 'T' mode
  1631.   for these animations so you can see what times in the future these
  1632.   charts are being cast for. Pressing '#" will have one hour added each
  1633.   time (note that now the house cusps are starting to move quickly, so
  1634.   you may want to switch to a different system of houses (such as the
  1635.   Equal to keep the Midheaven from flopping back and forth) and/or use
  1636.   -1 to put an object like the sun on the Ascendant.) Pressing '$' will
  1637.   have one day added each time (now you will probably want to start
  1638.   using -R to remove fast moving objects like the moon), and pressing
  1639.   '%' will have one month added for each update of the window. The
  1640.   final keys, shift 6..9 cause years, decades, centuries, and millenia
  1641.   to be added each time, and tend to only be used to look for long range
  1642.   actions (when will Neptune next enter Pisces, etc.) To exit these
  1643.   animation modes, press the 'N' key.
  1644.  
  1645. Press 'r' to reverse direction of time-lapse or animation.
  1646.  
  1647.   Press this to reverse the direction of any animation taking
  1648.   place. For the '!'..'(' animation keys above, this will cause
  1649.   negative times to be added to the chart, e.g. pressing '#'
  1650.   then 'r' on a chart cast for noon will cause the next chart to
  1651.   be displayed for 11am, then 10am, etc. For the Globe animation,
  1652.   this will cause the rotation to reverse direction.
  1653.  
  1654. Press '1'-'9' to set rate of animation to 'n' degrees, etc.
  1655.  
  1656.   The nine number keys are used to set the relative "rate" of
  1657.   animation to "n" whatevers. For example, normally the "@" key means
  1658.   add one minute to the chart for each update, but press "5" and now
  1659.   we are adding 5 minutes each time. For the Globe animation,
  1660.   by default the Earth rotates one degree each time; however, the
  1661.   number keys can speed this up to nine degrees for each update.
  1662.  
  1663. Press 'V','L','A','Z','S','W','G','P' to switch to normal (-v),
  1664. astrograph (-L), grid (-g), local (-Z), space (-S),
  1665. world (-XW), globe (-XG), and polar (-XP) modes.
  1666.  
  1667.   There are basically eight main modes in which a window can be in:
  1668.   There are the five main charts (wheel, astro-graph, aspect grids,
  1669.   local sky, and space view) as well as the three world displays (the
  1670.   simple map by itself, the globe view, and the polar projection). These
  1671.   eight keys can be used to switch between these eight modes in the
  1672.   middle of program execution. For example, you can bring up your own
  1673.   chart in a window, then press 'L' to see the astro-graph chart for the
  1674.   same birth data. Then you can press 'W' to just see the world map by
  1675.   itself, and 'G' to see the globe view, after which you can press 'V'
  1676.   to return to your original wheel chart.
  1677.  
  1678. Press 'q' to terminate the window and program.
  1679.  
  1680.   Pressing this key will terminate the window (and the Astrolog
  1681.   program itself.)
  1682.  
  1683. ----
  1684.  
  1685. Left   mouse button: Draw lines on chart in window.
  1686. Middle mouse button: Print coordinates of pointer on world map.
  1687. Right  mouse button: Terminate the window and program.
  1688.  
  1689.   Mouse buttons: Pressing the mouse buttons in the X windows will do
  1690.   various functions. The left mouse button acts as a pen that allows one
  1691.   to actually draw on the chart: press it and drag the pointer to draw a
  1692.   line on the window - good for aiding in analysis or in presentations.
  1693.   (Any scribbles one makes will disappear the next time the chart window
  1694.   is updated, therefore drawing will have little effect when in
  1695.   animation mode.) The middle mouse button will only work when the world
  1696.   map is shown, i.e. in the -L astrograph or -XW world map displays:
  1697.   press it and get the approximate longitude and latitude of the place
  1698.   on the map where the pointer is. For the three scale sizes of 100,
  1699.   200, and 300 percent, the accuracy is to the nearest degree, 30', and
  1700.   20', respectively. So, if you want to cast a chart for southern
  1701.   Madagascar, Africa, but don't know the coordinates, click the middle
  1702.   button on the map for a good approximation! Finally, the right button
  1703.   acts just like the 'q' key, and will terminate the window.
  1704.  
  1705.  
  1706. *******************************
  1707. DATA ENTRY AND THE MAIN DISPLAY
  1708. *******************************
  1709.  
  1710. The main part of the program is executed simply by entering "astrolog"
  1711. (assuming that's the name of the executable), and the program will ask
  1712. you for all the birth info and will give the planet/house positions.
  1713. (e.g. for here in Seattle right now for the seven prompts I would
  1714. enter [for June 11th, 1992 AD at 10:22pm, with daylight time in effect
  1715. - if daylight time were *not* in effect, I would have entered 22.22
  1716. for the fourth value instead]: 6; 11; 1992; 21.22; 122.20; 47.36) The
  1717. program then calculates and displays the positions of all planets,
  1718. Chiron, the four main asteroids, as well as stuff like the Part of
  1719. Fortune and the Vertex. (The Uranian bodies and fixed stars can also
  1720. be listed if one includes the appropriate command switches described
  1721. earlier.)
  1722.  
  1723. This user interface where one manually inputs the chart information
  1724. is "smart" in a few ways. First, the true names of months or their
  1725. abbreviations may be entered (case doesn't matter) instead of the
  1726. corresponding number if you prefer. At most, the first three letters
  1727. of the month are needed; some months (like February which is the only
  1728. month starting with "F") may be abbreviated all the way up to their
  1729. first letter. The second enhancement is that the time value may be
  1730. entered with a "pm" or "am" (or just "p" and "a") suffix in addition
  1731. to the standard 24 hour clock. For example, instead of entering
  1732. "18.30" for "6:30pm", you can enter "6.30pm" or even "6.3p" and the
  1733. program will process it the same. Similarly, "12.30am" can be used
  1734. instead of "0.30", and so on. The final enhancement is that colons
  1735. may be used instead of decimal points for the time and location
  1736. values. For example "6.30" may be entered as "6:30" intead, and
  1737. longitude values like "122.20" may be entered "122:20", which is more
  1738. intuitive than those decimal points.
  1739.  
  1740. --
  1741.  
  1742. When the standard list of planetary positions is displayed, some
  1743. additional information in addition to these locations are shown: (1)
  1744. Whether or not each planet is in its ruling sign, or fall, as well
  1745. as displaying the same information for ruling or debilitating houses.
  1746. (2) The sum of the signs in each element and mode and their totals is
  1747. displayed in a grid form. Also, planets in their exalted and
  1748. debilitated signs are noted. In addition to the (R) indicating a
  1749. planet in it's ruling sign, and an (F) for a planet in it's fall, we
  1750. have (e) if a planet is in its exalting sign, and a (d) for a planet
  1751. in its debilitating sign (which is always opposite the exaltation, as
  1752. how the fall is opposite the ruler).
  1753.  
  1754. Also in this main display, the total number of planets in each of the
  1755. hemispheres of the wheel, as well the number of objects in
  1756. positive/masculine and negative/feminine quality signs, are counted.
  1757. To the right of the element table, we have a column of seven numbers
  1758. labeled as follows: "+" is the number of "positive" objects (i.e. in
  1759. Fire or Air signs); "-" is the number of "negative" objects (i.e. in
  1760. Water or Earth signs); "M" is the number of objects above the horizon
  1761. (i.e. in the hemisphere of the Midheaven); "N" is the number of
  1762. objects below the horizon (in the hemisphere of the Nadir); "A" is
  1763. the number of objects in the Eastern half of the sky (in the
  1764. hemisphere of the Ascendant); and "D" is the number of objects in the
  1765. Western half of the sky (in the hemisphere of the Descendant).
  1766. Finally we have a field indicating the division of objects into the
  1767. first six and second six signs of the zodiac. The number of objects
  1768. in the first six signs of the zodiac will be printed, labeled by the
  1769. character "<". (The number in the second half isn't printed; just
  1770. subtract from the total if you want to know.) According to a book on
  1771. the Kaballah, the emphasis of the first six signs on the zodiac is on
  1772. "what's to learn", and the emphasis on the second six signs is on
  1773. "what's to share". Use or interpret this as you wish.
  1774.  
  1775. I have taken the liberty to define ruling and exalting signs for
  1776. the asteroids (and the rest of the first twenty objects that don't
  1777. already have them.) This won't affect much other than whether a 'R',
  1778. 'F', 'e', or 'd' is displayed in the -v charts, but it will slightly
  1779. affect the powers given to these objects in the -I influence chart
  1780. since they now can be in their ruling sign. The -O object list will
  1781. display the list of ruling and exalting signs (and the fall and
  1782. debilitating signs which are just opposite the above) for all these
  1783. objects in addition to the planets; however, I have listed them below:
  1784.  
  1785. Chiron, the compassionate, experienced healer, is most similar in
  1786. function to Pisces, hence Chiron rules here. Chrion expresses well in
  1787. caring, feeling, Cancer, hence Chiron exalts here. Ceres, goddess of
  1788. agriculture and representing the mothering, reproductive instinct, is
  1789. similar in function to Taurus, hence Ceres rules here. Ceres expresses
  1790. well in the nurturing, caring, sign of Cancer, hence Ceres exalts
  1791. here. Pallas Athena, mentally acute and unemotional, is most similar
  1792. in function to Virgo, hence Pallas rules here. Pallas expresses well
  1793. in practical, disciplined, introverted Capricorn, hence Pallas exalts
  1794. here. Juno, ability to sacrifice self-interests to maintain a
  1795. relationship, is most similar in function to relationship oriented
  1796. Libra, hence Juno rules here. Juno expresses well in sociable, crowd
  1797. pleasing Leo, hence Juno exalts here. Vesta, with its orientation to
  1798. directing hidden creative or sexual energy without fear, is most
  1799. similar in function to Scorpio, hence Vesta rules here. Vesta
  1800. expresses well in individualistic, quirky Aquarius, hence Vesta exalts
  1801. here. The North Node, with its emphasis on being able to break from
  1802. the past routine and pursue the unfamiliar and personal growth, is
  1803. most similar in function to soceity questioning independent Aquarius,
  1804. hence it rules here. The Node expresses well in growth and sacrifice
  1805. oriented Virgo, hence the Node exalts here. The Part of Fortune is
  1806. calculated based on the positions of the Sun, Moon, and Ascendant; if
  1807. these three objects are in their ruling signs, then the Fortune will
  1808. fall in Pisces, hence the Fortune should rule here. Similarly, if the
  1809. Sun, Moon, and Ascendant are all in their exalting signs, then the
  1810. Fortune will fall in Aquarius, hence the Fortune should exalt here.
  1811. The Midheaven, being the 10th house cusp, corresponds to Capricorn,
  1812. ruled by Saturn. Hence the Midheaven's ruling and exalting signs are
  1813. the same as Saturn's: Capricorn and Libra. The Ascendant corresponds
  1814. similarly to Mars, hence its ruling and exalting signs are the same:
  1815. Aries and Capricorn. The Vertex, being always near the Descendant,
  1816. corresponds to Libra, and hence has the same rulership and exaltation
  1817. as Venus: Libra and Pisces.
  1818.  
  1819. The standard chart listing of the planetary positions will also
  1820. include an additional field for the "velocity" of each planet. This
  1821. velocity value approximates how fast the planet is moving through the
  1822. zodiac with respect to the Earth (or whatever the central body is set
  1823. to) in degrees per day. This value of course, goes negative when a
  1824. planet goes retrograde. This is useful not only to get a feel for how
  1825. fast each planet moves through the zodiac, but to determine when a
  1826. planet is about to go retrograde or direct - the value approaches
  1827. zero when the planet changes direction.
  1828.  
  1829.  
  1830. **************************************
  1831. DATA DEFAULTS AND COMPILE TIME OPTIONS
  1832. **************************************
  1833.  
  1834. Astrolog includes the ability to search an input file for various
  1835. default parameters to use in the program. This allows one to easily
  1836. change major defaults without having to recompile the program, which
  1837. is useful if, say, one receives a compiled executable from a friend
  1838. who had a different configuration. The program looks for the file
  1839. "astrolog.dat" in the current directory, and if not there, looks for
  1840. it in the default directory. Parameters in this file will override any
  1841. defaults compiled into the program, although the highest priority is
  1842. still given to the command line options. Note one doesn't *have* to
  1843. have this file in order to run the program - if not found Astrolog
  1844. will still run as before. Presently, the parameters one can change in
  1845. this file are: default time zone (as indicated with -z option),
  1846. default longitude and latitude (as in -l option), number of aspects
  1847. (-A option), default house system to use (values as in -c option).
  1848. Then come default restriction values (as with -R option) for the first
  1849. 20 objects (0 = active, 1 = restricted). Next are the orbs (as with
  1850. -Ao option) for the 18 aspects. Finally, comes a long list of the
  1851. influence values used by the -I option, i.e. the power values of each
  1852. of the first 20 planet objects, of the 12 houses, and of the 18
  1853. aspects. The only major thing that one *can't* change in the file is
  1854. the default directory path in which the program looks in for input
  1855. files if not in the current directory, since Astrolog needs the
  1856. default directory in order to be able to locate the file in the first
  1857. place! The "astrolog.dat" file included with this version of the
  1858. program has some "comment lines" describing what is contained in each
  1859. line. One can chance or delete comments as long as they make sure that
  1860. an equals sign ('=') immediately proceeds any value or list of values,
  1861. since the program uses this character to determine where comments end.
  1862.  
  1863. Astrolog.dat files for versions 2.25 and before won't work with
  1864. version 2.30, because there are additional definable parameters
  1865. inserted in this file for 2.30. For the -I influence interpretation
  1866. chart, the power given to planets in ruling sign, planets exalted in
  1867. sign, planets in ruling house, and planets exalted in house, may be
  1868. specified. In addition, there are some additional lists in the file
  1869. dealing with aspects that were described with the -A* switches.
  1870.  
  1871. --
  1872.  
  1873. I often use Astrolog to look at and compare files containing charts of
  1874. various people. I have many chart files, so I keep them in a separate
  1875. directory. Since it is always a pain to have to cd into this special
  1876. directory all the time, there is a DEFAULT_DIR string to be set at
  1877. compile time. Whenever the program reads in a chart file with the -i
  1878. option, it will first look in the current directory for it. If it's
  1879. not found there, Astrolog will then look for a file of the same name
  1880. in the special default directory.
  1881.  
  1882. A couple of people have e-mailed me saying that their computer (for
  1883. example, Mac's) won't accept command switches on the command line
  1884. (like they boot Astrolog from a menu for instance.) Therefore, they
  1885. aren't able to access many features in the normal way. If this is the
  1886. case with your system (or if you just don't like command line
  1887. options), then comment out the '#define SWITCHES' line at the
  1888. beginning of the astrolog.h file. If you do this, then the program
  1889. will ignore any switches and prompt you to enter them manually at the
  1890. very beginning of program execution.
  1891.  
  1892. A couple of other compile time option variables are in the include
  1893. file astrolog.h: For those people who don't like Placidus, a default
  1894. house system can be set by changing the value of DEFAULT_SYSTEM to the
  1895. value from 0..9 indicating what system to use if the user doesn't
  1896. explicitly specify it with -c. Another thing: It should be mentioned
  1897. that although the accuracy of Sun..Pluto, Chiron, and the Uranians are
  1898. to the nearest minute (for years 1900-2000), the four asteroids are
  1899. relatively inaccurate and can even be a couple of degrees off in the
  1900. worst case. Also, some people just don't like or care about those
  1901. minor bodies and think that they clutter up the various charts. If you
  1902. don't want the values of the asteroids, Chiron, Part of Fortune, and
  1903. the Vertex to appear in the program by default, there is a #define in
  1904. astrolog.h called ASTEROIDS that can be commented out so that it will
  1905. be as if -R is always included when the program is run. (Simply do -R
  1906. to get them *back* if you compile it this way.) Or better yet, change
  1907. the default restrictions to your preference by editing the
  1908. astrolog.dat default parameter file described above.
  1909.  
  1910. There is a special compile time variable dealing with graphics (in
  1911. addition to the "X11" one) called "GRAPH". One comments out the
  1912. #define GRAPH line if they don't want graphics, and not just if they
  1913. don't have X windows. In other words, one can generate most of
  1914. Astrolog's graphics charts even if they don't have X windows. Now,
  1915. when GRAPH is defined but X11 isn't, the program will generate the
  1916. charts, but just never try to bring up a window; it will simply
  1917. always assume that you are writing a bitmap file. The bitmap file
  1918. will contain a (unfortunately always black and white) image of what
  1919. would normally be in the window, just as the -Xb switch does. One can
  1920. then use any of various graphics utilities to convert the image into
  1921. something they can display on their system. (Any system that can
  1922. compile Astrolog should be able to compile in the non X window
  1923. graphics features as well.)
  1924.  
  1925. A bitmap output mode other than one of the standard ones that can be
  1926. read with the unix X11 xsetroot command is allowed in the graphics
  1927. routines. If one changes the BITMAPMODE compile time option in
  1928. astrolog.h to the character 'A' when compiling, then all bitmaps
  1929. output will be in a straight ascii form, with one character
  1930. corresponding to each pixel. This format is identical to the result
  1931. produced by the unix command bmtoa, and it can be converted back into
  1932. a bitmap with the unix command atobm. Although not as efficient
  1933. spacewise, this is a simpler format, and is recommended for those
  1934. without X windows who are still using Astrolog's graphics, if they
  1935. want to write their own conversion program.
  1936.  
  1937. Note for PC users: I have tried to make this program as much
  1938. executable on personal computers and other non-unix systems as
  1939. possible. Although this version should be easier to compile than
  1940. previous ones were, still there are probably some things I've
  1941. forgotten or left out. Another warning for PC users: You will probably
  1942. want to change the value of DIVISIONS in astrolog.h from its current
  1943. value of 24 to a lower value like 6 or so. Leaving it as is invoked
  1944. complaints of extreme slowness and occasional multiple hits in the -d
  1945. aspect search routine, where the same aspect would get listed more
  1946. than once.
  1947.  
  1948.  
  1949. ********************************
  1950. DESCRIPTION OF X WINDOW FEATURES
  1951. ********************************
  1952.  
  1953. One of the most impressive features of the program are the X windows
  1954. features, which are generally accessed in the program via the -X
  1955. switch and derivatives of it on the command line. There are five
  1956. different types of chart displays: A standard graphic display of a
  1957. wheel chart in a window (with glyphs, aspects in the center, etc),
  1958. graphic displays of the Astro-graph charts (which look almost
  1959. identical to the astro*carto*graphy maps from Jim Lewis) complete with
  1960. all the labeled lines drawn on a map of the world (like the -L
  1961. option), aspect/midpoint grids showing the aspects and orbs in effect
  1962. between every body in a chart (like -g option), a local sky chart
  1963. showing where each planet is located on a map of the local horizon
  1964. area (as in -Z), and a space chart showing an aerial view of the solar
  1965. system (as in -S). The X wheel and aspect grid charts can displayed
  1966. in a different form to accomodate relationship comparison charts.
  1967. There are also other commands that can be given to the window once it
  1968. is up and running, which can do other things, such as continually
  1969. update the window every few seconds to the current status (i.e. an
  1970. extended version of the -n option) as well as other forms of
  1971. animation. Note that the program is still text based, and one can
  1972. easily turn off all the X features by commenting out the #define X11
  1973. in astrolog.h if they don't have X windows.
  1974.  
  1975. Probably the only thing more impressive than the X window features are
  1976. the X window features displayed on color monitors. (The charts
  1977. displayed in color are *much* more eye catching than the B/W ones,
  1978. IMHO.) Here is how the colors have been assigned for the various
  1979. charts: Four colors have been allocated for the four elements - Fire =
  1980. Red, Earth = Brown, Air = Green, Water = Blue. The various sign glyphs
  1981. (and the corresponding house labels) are in the color of their
  1982. element. Planets are in the color of the sign of their main ruler.
  1983. Chiron and the four asteroids are Gold, while the north node, and
  1984. other non-physical objects like the fortune and vertex are Violet.
  1985. Representations of the Ascendant/ Descendant/ Midheaven/ Nadir (in the
  1986. astro-graph map lines and elsewhere) are in the element color of the
  1987. corresponding sign/house that the angular lines refer to, i.e.
  1988. Ascendant = Red, Midheaven = Brown, Descendant = Green, Nadir = Blue.
  1989. A few extra things have been added for color wheel charts only: dark
  1990. gray lines marking off each house (in addition to the main lines on
  1991. the horizon and meridian), and each degree instead of every 5th degree
  1992. being marked in dark gray on the outer circle (every 5th degree being
  1993. white). Aspects lines are colored too, as follows: Conjunctions =
  1994. Yellow, Sextiles = Light Blue, Squares = Red, Trines = Green,
  1995. Oppositions = Dark Blue. For the minor aspects we have:
  1996. Inconjuncts/Semisextiles = Brown, Semisquares/ Sesquiquadratures =
  1997. Orange, (Bi/Semi)Quintiles = Violet, (Bi/Tri)Septiles = Gold,
  1998. (Bi/Quatro)Noviles = Pink.
  1999.  
  2000. For color X terminals, the -XG globe display and -XW world map
  2001. display are done with the continents in different colors! This makes
  2002. them look much better than monochrome maps. Each of the seven
  2003. continents is in a different color of the rainbow, and the colors are
  2004. chosen to correspond to the appropriate chakra (etheric energy vortex
  2005. along the human spine) that goes with each land mass. They are:
  2006. Africa - red - Root chakra, Australia - orange - Navel chakra, South
  2007. America - yellow - Solar plexus chakra, North America - green - Heart
  2008. chakra, Europe - blue - Throat chakra, Asia - indigo - Third Eye
  2009. chakra, Antarctica - violet - Crown chakra. Major lakes are, of
  2010. course, colored navy blue.
  2011.  
  2012. --
  2013.  
  2014. -v -X: The X wheel charts have their graphic information organized as
  2015. follows: There's an outer circle showing the signs and sign glyphs,
  2016. inside of which is a smaller circle divided up into 5 degree
  2017. increments to make determining exact degrees easier. Inside of this
  2018. is a circle divided up into the 12 houses labeled with numbers. The
  2019. entire chart is divided by two dashed lines through the Ascendant/
  2020. Descendant (which is always horizontal of course) and the
  2021. Midheaven/Nadir. Inside the house circle are the planet glyphs in
  2022. their appropriate positions. Small pointer lines run from each glyph
  2023. to just before single dots. These dots indicate the precise locations
  2024. in the zodiac of each object. The pointer lines (which are dashed if
  2025. the object is retrograde and solid otherwise) are necessary so as not
  2026. to have to draw planet glyphs on top of one another when planets are
  2027. conjunct. Inside the ring of the single dots, are the aspect lines
  2028. connecting these positions. Since the default number of aspects to
  2029. use is just the 5 majors, one can determine which aspect is in place
  2030. just by looking at the aspect line. The accuracy of the aspect is
  2031. determined by the dashedness of the line: A solid line means the orb
  2032. is < 2 degrees; a dashed line means the orb is < 4 degrees; a really
  2033. dashed line mean the orb is < 6 degrees, etc.
  2034.  
  2035. -L -X: The X astro-graph charts are organized as follows: A map of
  2036. the world is shown. The edges of the map are labeled with ruler lines
  2037. that are 5 degrees apart (with longer ruler lines for more important
  2038. longitudes and latitudes, like those that are multiples of 10, 30,
  2039. etc.) The equator is labeled with a dashed line. The polar regions of
  2040. the world aren't shown; the map shown ranges from 60 degrees S
  2041. latitude to 75 degrees N latitude. Note that each pixel on the screen
  2042. represents exactly one half a degree on the world. (For -Xs 100 the
  2043. ratio is one pixel to one degree, and for -Xs 300 the ratio is one
  2044. pixel to 1/3 degree.) On this map are drawn the lines indicating
  2045. where on the world the various planets are angular at the time in
  2046. question. (Note: you might want to -R restrict some objects because
  2047. otherwise the map tends to get pretty cluttered with lines.) As
  2048. expected, Midheaven and Nadir lines are vertical, and the Ascendant
  2049. and Descendant lines are curved. Little square boxes on the
  2050. Midheaven lines indicate the exact zenith latitude location. Each
  2051. line is labeled at the top or the bottom of the screen, showing what
  2052. planet is in question and (sometimes) what angle is in question. All
  2053. Ascendant and Midheaven lines are labeled at the bottom of the
  2054. screen, and all Descendant and Nadir lines are labeled at the top.
  2055. Each line goes a bit beyond to the top or bottom of the world map,
  2056. and then another pointer segment (which is again dashed of the object
  2057. in question is retrograde) goes and points to the planet glyph. There
  2058. is a capital "A" or "M" under each of the glyphs at the bottom of the
  2059. screen, explicitly indicating whether the line is an Ascendant or
  2060. Midheaven line. At the top of the screen, however, there are only the
  2061. glyphs, but one can still determine whether these lines are
  2062. Descendant or Nadir lines based on whether they are curved or not.
  2063. Note that not all the Descendant lines are labeled; this is because
  2064. some of the Ascendant/Descendant lines actually connect near the top
  2065. of the screen and don't actually cross it.
  2066.  
  2067. -g -X: Aspect grid windows with the appropriate aspect glyphs can be
  2068. displayed by combining the -g option with the -X option (astrolog -g
  2069. -X). Both the split aspect/midpoint grids labeled down the diagonal,
  2070. as well as the relationship aspect grids between two charts (astrolog
  2071. -r <file1> <file2> -g -X) are supported. The aspects glyphs, objects,
  2072. and the signs in the grids are in their colors as defined earlier.
  2073. Like the astro-graph windows, these charts can't be resized in the
  2074. normal way unless one uses the '>' and '<' keys. For anything less
  2075. than the largest scale size (achieved with the switch -Xs 300, or by
  2076. pressing '>' within a window) all that will be displayed in each
  2077. aspect grid cell is the glyphs of the aspect in effect, the planet
  2078. being aspected, or the sign of the midpoint. However, once the largest
  2079. scale size is reached, there is room in each cell to display the
  2080. aspect orb to the nearest minute off of exact (with a plus or minus
  2081. sign indicating whether the actual angle is slightly greater than or
  2082. less than exact); the degree and minute in addition to the sign for
  2083. midpoints; and the degree and sign location for each planet that's in
  2084. the grid. Remember, the ASCII aspect grids in the text options are
  2085. rather limited, only displaying orbs to the nearest 0.1 degree,
  2086. midpoints to the nearest degree, as well as the confusing '.' vs. ','
  2087. for angles slightly greater or less than exact (not to mention leaving
  2088. the vertex out for the relationship grids between two charts). Well no
  2089. longer: with X11, we can see *real* aspect grids with Astrolog!
  2090.  
  2091. -Z -X: The -Z local horizon feature can be displayed in an X window
  2092. as well (e.g. astrolog -Z -X), in which all the planets will be
  2093. displayed in a window depicting the sky. The small dot above or below
  2094. each glyph indicates exactly where each planet is. (Some of the
  2095. glyphs may be overlapping, although the program tries to cut down on
  2096. this.) There is a horizontal line dividing the window representing
  2097. the local horizon; planets above this line are visible, while planets
  2098. below it are set. There are three vertical lines dividing the window
  2099. as well: The middle line represents the due south direction, the one
  2100. to the left is due east, the one to the right is due west, and the
  2101. edges of the window are due north. Like the standard chart display,
  2102. this window may be resized to any proportion. One can press the 'Z'
  2103. key in any window to enter this display type in that window at any
  2104. time.
  2105.  
  2106. -Z0 -X: An additional graphics chart is available through the -Z0
  2107. switch: local horizon charts suitable for stargazing. As we know, the
  2108. normal -Z switch generates a listing of the planets with repect to
  2109. the local horizon, and the -Z combined with the -X switch generates a
  2110. graphic image of the planets and stars on the local horizon. This
  2111. chart assumes one is facing due south, and is divided left to right
  2112. by the horizon line, with straight up being toward the top of the
  2113. screen and straight down toward the bottom. This is a good chart,
  2114. especially for noticing the rising and setting of planets and other
  2115. objects, but the fact that the meridian is split up causes distortion
  2116. when trying to view objects high up in the sky. Therefore, if one
  2117. combines this -Z0 switch with the -X switch, a new differently
  2118. oriented local horizon chart will be displayed. Here, the zenith
  2119. point straight up is in the center of the screen, and the horizon
  2120. line is a surrounding circle. Due north is along the line from the
  2121. center to the top of the screen, due south is on the line from the
  2122. center to the bottom, east is to the left, and west is to the right.
  2123. In other words, this is just like what one would see if they were
  2124. lying on their back looking straight up with their feet to the south,
  2125. so this should be better for stargazing. Outside the circle marks
  2126. what's below the horizon, and the extreme corners of the screen mark
  2127. the nadir - what's straight down. As with the normal -Z graphic
  2128. chart, this one has the various axes marked at five degree
  2129. increments.
  2130.  
  2131. -S -X: The -S switch can be combined with -X to give an X window
  2132. chart of the solar system. This will be displayed as an aerial view
  2133. of the entire solar system, with 0 degrees Aries to the left of the
  2134. screen, and 0 degrees Cancer to the bottom. Note that this chart
  2135. includes all possible planets, including the Earth (whose glyph is a
  2136. cross inside a circle). Whatever object is chosen to be the central
  2137. body is at the center of the screen, with all the others around it.
  2138. This is a fun chart to animate - watch the planets go around the Sun,
  2139. and *see* how they turn retrograde with respect to the Earth. In
  2140. addition to the bodies themselves, twelve spokes are drawn from the
  2141. center body to the edge of the screen, which delineate the zodiac
  2142. with respect to it. Note that the scale of the solar system is
  2143. large; attempting to fit all the planets out to Pluto on the screen
  2144. at once will cause all the inner planets to be crammed together near
  2145. the middle of the screen. To deal with this, the scale size as
  2146. indicated with the -Xs switch and the '<' and '>' keys will affect
  2147. how much of the solar system is viewed at once (in addition to the
  2148. glyph sizes). For a scale size of 300, the viewport will have a
  2149. radius of 6 AU (about out to the orbit of Jupiter; useful for viewing
  2150. the inner planets). For a scale size of 200 (default), it will have a
  2151. radius of 30 AU (enough to include Neptune, and Pluto most of the
  2152. time). Finally, a scale size of 100 will result in a radius of 90 AU,
  2153. enough to easily include the entire solar system, as well as the
  2154. orbits of the alleged Uranian bodies beyond Pluto.
  2155.  
  2156. -r0 -X: True relationship wheel charts can be displayed in a window,
  2157. i.e. where the planets of both charts are displayed in separate
  2158. rings of the same wheel. Use the -r0 option to display this
  2159. comparison type. For example, for the command "astrolog -r0 person1
  2160. person2 -X", the following is displayed: The signs and houses as in
  2161. person1's chart are drawn in the outermost part of the wheel. Inside
  2162. this is a ring of person2's planets as displayed in person1's houses,
  2163. and inside of this are person1's own planets. Finally at the very
  2164. middle is an aspect grid, which shows those aspects that are
  2165. occurring between the objects in the two charts. Basically this is
  2166. just the standard wheel chart for person1, except that person2's
  2167. planets are in an outer ring of objects and the aspect grid shows the
  2168. aspects of the relationship. Putting such a chart in animation mode
  2169. only affects person2's planets, so this is a great way to analyze
  2170. transits: Doing "astrolog -t yourchartfile -X" will show all your
  2171. current transits, and allow you to easily animate the transiting
  2172. planets through your natal signs and houses.
  2173.  
  2174. --
  2175.  
  2176. A couple of conveniences for the X window features exist. Note that
  2177. the -Xo <bitmapfilename> option is only used in conjunction with the
  2178. -Xb write output to bitmap switch. Therefore, -Xo automatically
  2179. assumes -Xb is set. (Invoking -Xb itself without -Xo will have the
  2180. program prompt the user for the bitmap filename.) In other words,
  2181. astrolog -Xb -Xo 'file' is the same as just astrolog -Xo 'file'. (This
  2182. may change if I add other file types, but for now none are planned.)
  2183. Also, I should mention that Astrolog includes its own appropriate
  2184. bitmap (a rainbow over an opened Third Eye) if one iconifies the
  2185. window, instead of reverting to the braindead UnknownIcon :)
  2186.  
  2187. -|-|-|-|-|-|-|-|-|-|-|-|-|-|-|-|-|-|-|-|-|-|-|-|-|-|-|-|-|-|-|-|-|-|-|-|-|-|-
  2188. |    Walter D. "Cruiser1" Pullen    |    astrolog@byron.u.washington.edu    |
  2189. -|-|-|-|-|-|-|-|-|-|-|-|-|-|-|-|-|-|-|-|-|-|-|-|-|-|-|-|-|-|-|-|-|-|-|-|-|-|-
  2190.