AAAAA SSSSS TTTTTTT RRRRRR OOOOO L OOOOO

GGGGG
A A S S T R R O O L O
O G G
A A S T R R O O L O
O G
AAAAAAA SSSSS T RRRRRR O O L O
O G GGGG
A A S T R R O O L O
O G G
A A S S T R R O O L O
O G G
A A SSSSS T R R OOOOO LLLLLLL OOOOO
GGGGG

** VERSION 7.60 **

Documentation for Astrolog version 7.60 (April 2023):

This file contains a complete list of all the features available in Astrolog, and
documentation on how to use each option. The file is divided into ten sections:
1) Summary: A summary of the program and a list of its main features.
2) Command Switch List: A summary of all features which are accessed via command
line switches and parameters is listed, along with the single key press commands that can
be given to a windowed command line version of the program (such as the X Windows
version) to change the display in various ways.
3) Command Switch Description: The list of command switches and keys is repeated,
but after each option is given a full description of the details of the feature.
4) Text Display: Descriptions of things that appear in Astrolog text displays are
described. This consists of describing how to enter chart information into the program,
and how to interpret what is seen in the standard main display.
5) Files: Details of default settings, for compile time options and in the default
configuration file, are described, along with using Astrolog files in general.
6) Graphics: Next is a description of the different graphic chart displays and how they
are organized, for versions such as MS Windows and X Windows. (Looking for a quick
display to prove Astrolog was worth downloading or compiling? With graphics try:
“astrolog -Xi -Xn -XG”!)
7) Windows Version: Then is discussed Astrolog for MS Windows, and a description of
the menu and dialog interface it offers.
8) AstroExpressions: This section describes “AstroExpressions”, which are
programmable customizations that don’t require recompiling the program.
9) Compiling: Next is a section on compiling Astrolog if you have the source code files,
as opposed to an executable ready to run, as well as how to compile and run Astrolog on
Unix based systems.
10) History: Finally is a section about the history of Astrolog, listing all the different
versions, when they were released, and what was introduced in each version.

ASTROLOG SUMMARY
Astrolog 7.60 is a many featured and customizable astrology chart calculation program
for Windows, Unix, Macintosh, and other platforms. It is 100% freeware and requires no
registration fee. :) The complete source code is available. Astrolog features: wheels,
aspects, midpoints, relationship charts, transits, progressions, eclipses, interpretations,
astrocartography, dials, local horizon, constellations, planet orbits, dispositors, influence
charts, Esoteric Astrology, biorhythms, different zodiacs, central planets, 23 house
systems, 3D houses, city and time change atlas, 30000 year ephemeris, asteroids, Dwarf
planets, Uranians, fixed stars, Arabic parts, planetary moons, script files and macros,
interactive graphics, smooth animation of charts, graphic files in PostScript, Windows
metafile, and bitmap formats, and more!
Astrolog is relatively unique in astrology software for the following reasons:
(1) It’s 100% freeware. :)
(2) It runs on multiple platforms, such as Windows, Mac, and Unix.
(3) The full source code is available.
(4) Features are accessible from the command line and from shell scripts.
(5) It offers many features not found in most other programs.
“Astrolog... is a phenomenal program filled with capabilities not found anywhere else...
What an asset to astrologers everywhere.”
- The Mountain Astrologer, Aries 2022, p123
“...perhaps commercial software vendors will follow Pullen's lead. It's long past time.”
- American Astrology, July 1996, p56
“The Best Freeware/Shareware Program of 1995 is Astrolog for Windows”
- American Astrology, March 1996, p22
“One exceptionally good freeware program is available to astrologers - good enough to
be worthy of review with the main commercial programs. This is Astrolog...”
- The Mountain Astrologer, November 1995, p46
“For a free program to have such a superb ephemeris with an 8000-year range is
incredible.”
- American Astrology, November 1994, p21
--
A list of the main features in Astrolog:

Position calculation features:

Positions of Sun through Pluto and the house cusps.
Positions of Chiron and the four main asteroids.
Positions of True and Mean nodes, Part of Fortune, Vertex, and East Point.
Position of Lilith (the “Black Moon” or focus of the Moon’s elliptical orbit).
Position of Vulcan, and other etheric or hypothetical bodies.
Positions of the eight Uranian planets.
Positions of major Dwarf planets and candidate Dwarf planets.
Positions of 27 planetary moons and 5 planet center of bodies.
Positions of 50 fixed stars (full support equivalent to planets).
Positions of 1100 fixed stars (displayed all together).
Positions of 177 Arabic parts and their formulas.
Option to display up to 540,000 additional asteroids and minor bodies.
Option to use any or all of the accurate 30,000 year Swiss Ephemeris.
Option to display accurate positions using JPL Horizons Website.

Computation features:
23 house systems (40 total counting experimental systems).
Tropical and sidereal zodiacs.
Specify zodiac starting position and ayanamsa.
Heliocentric and other planet centered charts.
Option to display barycenters or center of body for Sun and planets.
Applying and separating aspects, and waxing and waning aspects.
Parallel and Contraparallel aspects.
Distance based aspects that consider distances between planets.
Harmonic charts.
Solar charts with objects on Ascendant or Midheaven.
Decan positions.
Dwad and nested dwad positions.
Navamsa positions.
Esoteric Astrology and Rays.
3D house systems that take planetary latitude into account.
3D aspects that take planetary latitude into account.
3D midpoints that take planetary latitude into account.
Positions relative to ecliptic, equator, and plane of solar system.
Local horizon positions in azimuth/altitude or prime vertical coordinates.
Specify your own positions for planets.

Display formats:
Simple list of positions.
Wheel charts.
Indian (i.e. Vedic/Hindu/Jyotish) format wheel charts.
Aspect and midpoint grids.
List aspect configurations such as Yods.
List aspects sorted by influence.
List midpoints sorted by position.
Local horizon positions.
Times of planets rising and setting.
Solar system orbit charts.
Gauquelin sector charts.
Astro-graph astrocartography charts (including for minor house cusps)
List latitude crossings or parans in astro-graph charts.
Generic and transit calendars for months and years.
Ephemeris tables.
Transit graphs.
Chart spheres (3D wheel charts).
Biorhythm charts.

Transit and progression features:

Secondary progressions and solar arc progressions.
Specify your own progression rates.
Times of exact aspects among transiting planets.
Times of planets changing sign or direction.
Times of void of course Moon, lunar phases, and season changes.
Times of eclipses and occultations/transits, and their type/intensity.
Times of exact aspects in a progressed chart.
Times of exact transit events.
Times of transits to house cusps.
Times of solar, lunar, and other returns.
Times of exact transits from progressed planets.
List transits to natal planets within orb in influence order.
List aspects within orb among transiting planets in influence order.
Transits to composite and other no-time charts.

Relationship chart features:

Synastry charts.
Composite charts.
Time space midpoint charts.
Weighted or ratioed relationship charts.
Display elapsed time between charts.
Aspect and midpoint grids between two charts.
Aspect and midpoint lists between two charts.
Automatic transit to natal comparison chart.
Automatic progressed to natal comparison chart.

Atlas features:
Look up city names in atlas to get longitude and latitude.
Look up city’s time zone and whether Daylight Time was in effect.
Display nearest cities to a set of coordinates.
Display time zone and Daylight Time changes over time.
Autodetect whether Daylight Time is in effect for current moment now.
Graphic atlas to map cities within an area.

Interpretation features:
Influence charts sorting planets and signs by power.
Interpret natal positions and natal aspects.
Interpret transits and midpoints.
Interpret transiting aspects and sign and direction changes.
Interpret aspects and midpoints between charts.
Interpret synastry charts.
Interpret latitude crossings in astro-graph charts.
Esoteric Astrology interpretation including astrological Ray chart clues.

Graphics features:
Graphic wheel chart.
Graphic bi-wheel comparison / transit chart.
Graphic tri-wheels, quad-wheels, quin-wheels, and hexa-wheels.
Graphic South Indian (rasi), North Indian, and East Indian format wheels.
Graphic aspect / midpoint and relationship aspect / midpoint grids.
Graphic dial charts of various degree sizes, with midpoint trees.
Graphic 2D astro-graph chart on a map of the world.
Graphic 3D astro-graph chart on a globe of the world.
Graphic local horizon, polar horizon, Gauquelin wheel, and orbit charts.
Graphic ephemeris chart plotting planet positions over time.
Graphic planet visibility chart plotting when planets are above horizon.
Graphic Esoteric Astrology Ray table.
Graphic calendars and biorhythms.
Dispositor graph chart.
Plot positions among the astronomical constellations.
Draw lines between stars to depict constellations.
Graphic telescope chart to zoom in on an area of sky.
Display rings of Saturn, Uranus, Neptune, Jupiter, and Haumea.
Smoothly animate charts through time at varying rates.
Continuously update chart to current moment now.
Animate a rotating globe.
Timed exposures for horizon and orbit charts.
Display custom bitmap backgrounds behind charts.
Create PostScript graphic files.
Create graphic X11 and Windows bitmap files.
Create Windows metafiles.
Create Daedalus 3D wireframe files.

Customization options:
Initialization file for default settings.
Choose what transiting and natal planets to include in charts.
Choose among 24 major and minor aspects, or define your own.
Specify aspect orbs.
Specify the maximum orb allowed to a planet.
Specify wider orbs for any planet.
Display times and zodiac positions to the nearest second.
DMY & MDY date formats and 24 hour & am/pm time formats.
Display locations in hours & minutes, Nakshatra, or 360 degree form.
Customize interpretation strings.
Customize colors and color palettes.
Redefine planets to various hypothetical planets.
Redefine planets to point to external ephemeris files.
Define your own orbital elements for planets.
Choose among graphic glyphs for certain signs and planets.
Specify influence of planets and planets when transiting.
Specify influence of houses and aspects.
Customize chart positions and output through AstroExpression scripting.

Chart access features:

Quick charts for the current moment now.
Save and load chart time and place to file.
Save and load chart positions to file.
Save text output directly to file.
Save and load lists of multiple charts in various formats.
Filter chart lists by name, location, or custom user specified criteria.
Relocate charts.
Cast a chart a specified time ahead of any chart.

System features:
Display text charts in Ansi color.
Export text charts in HTML format.
Support nine different fonts for signs, planets, and aspects.
Paging for when text charts fill more than a screen.
Access environment variables.
Define macros for your most common operations.
Easy to use menu and dialog interface in the Windows version.
Right click context menus for each chart in Windows version.
Act as a screensaver in the Windows version.

LIST OF COMMAND SWITCHES

Astrolog (version 7.60) command switches:
-H: Display this help list.
-Hc: Display program credits and copyrights.
-HC: Display names of zodiac signs and houses.
-HO: Display available planets and other celestial objects.
-HA: Display available aspects, their angles, and present orbs.
-HF: Display names of astronomical constellations.
-HS: Display information about planets in the solar system.
-H7: Display information about the esoteric seven Rays.
-HI: Display meanings of signs, houses, planets, and aspects.
-He: Display all tables together (-Hc-H-Y-HX-HC-HO-HA-HF-HS-H7-HI).
-Q: Prompt for more command switches after display finished.
-Q0: Like -Q but prompt for additional switches on startup.
-M <1-48>: Run the specified command switch macro.
-M0 <1-48> <string>: Define the specified command switch macro.
-M[1-6][0] <strings>: Define macro(s) to run when chart calculated.
-Y: Display help list of less commonly used command switches.

Switches which determine the type of chart to display:

-v: Display list of object positions (chosen by default).
-v0: Like -v but express velocities relative to average speed.
-v3 [0-9]: Display decan or other information alongside positions.
-w [<rows>]: Display chart in a graphic house wheel format.
-w0 [..]: Like -w but reverse order of objects in houses 4..9.
-g: Display aspect and midpoint grid among planets.
-g0: Like -g but flag aspect configurations (e.g. Yods) too.
-gm: For comparison charts, show midpoints instead of aspects.
-gp: Like -g but generate parallel and contraparallel aspects.
-gd: Like -g but aspects measure distance proportions.
-ga: Like -g but indicate applying/separating instead of offset orbs.
-gx: Like -g but generate waxing/waning instead of offset orbs.
-a: Display list of all aspects ordered by influence.
-a0: Like -a but display aspect summary too.
 -ap: Like -a but do parallel and contraparallel aspects.
-ad: Like -a but aspects measure distance proportions.
-aa: Like -a but indicate applying/separating instead of offset orbs.
-ax: Like -a but generate waxing/waning instead of offset orbs.
-a[jonOPACDm]: Sort aspects by power, orb, orb difference, 1st planet, 2nd planet,
aspect, 1st position, 2nd position, midpoint.
-m: Display all object midpoints in sorted zodiac order.
-m0: Like -m but display midpoint summary too.
-ma: Like -m but show aspects from midpoints to planets as well.
-Z: Display planet locations with respect to the local horizon.
-Z0: Like -Z but express coordinates relative to polar center.
-Zd: Search day for object local rising and setting times.
-Zd[m,y,Y] [<years>]: Like -Zd but for entire month, year, or years.
-S: Display x,y,z coordinate positions of planets in space.
-l: Display Gauquelin sectors for each planet in chart.
-l0: Like -l but approximate sectors using Placidus cusps.
-j: Display astrological influences of each object in chart.
-j0: Like -j but include influences of each zodiac sign as well.
-7: Display Esoteric Astrology and Ray summary for chart.
-L [<step>]: Display astro-graph locations of planetary angles.
-L0 [<step> [<dist>]]: Like -L but list latitude crossings too..
-K: Display a calendar for given month.
-Ky: Like -K but display a calendar for the entire year.
-d [<step>]: Print all aspects and changes occurring in a day.
-dm: Like -d but print all aspects for the entire month.
-dy: Like -d but print all aspects for the entire year.
-dY <years>: Like -d but search within a number of years.
-dp <month> <year>: Print aspects within progressed chart.
-dpy <year>: Like -dp but search for aspects within entire year.
-dpY <year> <years>: Like -dp but search within number of years.
-dp[y]n: Search for progressed aspects in current month/year.
-D: Like -d but display aspects by influence instead of time.
-B: Like -d but graph all aspects occurring in a day.
-B[m,y,Y]: Like -B but for entire month, year, or five years.
-B0: Like -B but don't restrict fast moving objects from graph.
-E: Display planetary ephemeris for given month.
-Ey: Display planetary ephemeris for the entire year.
-EY <years>: Display planetary ephemeris for a number of years.
-E[]0 <step>: Display ephemeris times for days, months, or years.
-8: Display planetary moons chart showing placements and aspects.
-80: Like -8 but compute true planetcentric positions separately.
-e: Display all charts (-v-w-g-a-m-Z-S-l-K-j-7-L-E-P-Zd-d-D-B-8).
-t <month> <year>: Compute all transits to natal planets in month.
-tp <month> <year>: Compute progressions to natal in month for chart.
-tr <month> <year>: Compute all returns in month for chart.
-t[p]d: <month> <day> <year>: Compute transits for a single day.
-t[p]y: <year>: Compute transits/progressions for entire year.
-t[p]Y: <year> <years>: Compute transits for a number of years.
-t[py]n: Compute transits to natal planets for current time now.
-T <month> <day> <year>: Display transits ordered by influence.
-Tt <month> <day> <year> <time>: Like -T but specify time too.
-T[t]p <month> <day> <year>: Print progressions instead of transits.
-T[p]n: Display transits ordered by influence for current date.
-V [..]: Like -t but graph all transits occurring during period.
-V[d,y,Y] [[<day>] <month>] <year>: Like -V for day, year, or 5 years.
-V[..]0: Like -V but don't restrict fast moving objects from graph.
-P [<parts>]: Display list of Arabic parts and their positions.
-P0 [<parts>]: Like -P but display formulas with terms reversed.
-P[i,z,n,f]: Sort parts by index, position, name, or formula.
-N [<rows>]: Lookup chart location as city in atlas.
-Nl [<rows>]: Display nearest cities in atlas to chart location.
-Nz [<rows>]: Display all time changes in time zone of chart city.
-I [<columns>]: Print interpretation of selected charts.

Switches which affect how the chart parameters are obtained:

-n: Compute chart for this exact moment using current time.
-n[d,m,y]: Compute chart for start of current day, month, year.
-z [<zone>]: Change the default time zone (for -d-E-t-q options).
-z0 [<offset>]: Change the default Daylight time setting.
-zl <long> <lat>: Change the default longitude & latitude.
-zv <elev>: Change the default elevation above sea level.
-zf <temp>: Change default temperature for atmospheric refraction.
-zj <name> <place>: Change the default name and place strings.
-zt <time>: Set only the time of current chart.
-zd <day>: Set only the day of current chart.
-zm <month>: Set only the month of current chart.
-zy <year>: Set only the year of current chart.
-zi <name> <place>: Set name and place strings of current chart.
-zL <city>: Lookup city in atlas and set location in current chart.
-zN <city>: Lookup city in atlas and set zone, Daylight, and location.
-q <month> <day> <year> <time>: Compute chart with defaults.
-qd <month> <day> <year>: Compute chart for noon on date.
-qm <month> <year>: Compute chart for first of month.
-qy <year>: Compute chart for first day of year.
-qa <month> <day> <year> <time> <zone> <long> <lat>: Compute chart
automatically given specified data.
-qb <month> <day> <year> <time> <daylight> <zone> <long> <lat>: Like -qa but
takes additional parameter for Daylight offset.
-qc <mon> <day> <year> <time> <dst> <zone> <long> <lat> <name> <city>: Like -
qb but takes additional parameters for name and city.
-qj <day>: Compute chart for time of specified Julian day.
-qL <index>: Compute chart based on index within chart list.
-ql [..]: Like -q but also append chart info to chart list in memory.
-i <file>: Compute chart based on info in file.
-i[2-6] <file>: Load chart info into chart slots 2 through 6.
-il <file>: Like -i but also append chart info to chart list.
-id <dir>: Open all chart files in directory into chart list.
-o <file> [..]: Write parameters of current chart to file.
-o0 <file> [..]: Like -o but output planet/house positions.
-ol <file>: Write current chart list to Astrolog chart list file.
-oa <file>: Write current chart or chart list to AAF format file.
-oq <file>: Write current chart list to Quick*Chart format file.
-od <file>: Output program's current settings to switch file.
-os <file>, > <file>: Redirect output of text charts to file.
-5: Set whether transit event charts autopopulate chart list.
-5e[2-4]: Display text charts for all charts in chart list.
-5[dxynls]: Sort chart list by date, lon, lat, name, or city.
-5f <name> <city>: Filter chart list to charts containing substring.
-50: Delete all charts in chart list, leaving an empty list.

Switches which affect what information is used in a chart:

-R [<obj1> [<obj2> ..]]: Restrict specific bodies from displays.
-R0 [<obj1> ..]: Like -R but restrict everything first.
-R1 [<obj1> ..]: Like -R0 but unrestrict and show all objects.
-R[C,u,u0,8,U]: Restrict all cusps, Uranians, Dwarfs, moons, or stars.
-RT[0,1,C,u,u0,8,U] [..]: Restrict transiting planets in charts.
-RA [<asp1> ..]: Restrict specific aspects from displays.
-RO <obj>: Require object to be present in aspects.
-C: Include angular and non-angular house cusps in charts.
-u: Include Uranian/transneptunian bodies in charts.
-u0: Include Dwarf planets and related bodies in charts.
-u8: Include planetary moon bodies in charts.
-ub: Include planetary center of body (COB) objects in charts.
-U: Include locations of fixed background stars in charts.
-U[i,z,l,n,b,d,v]: Sort stars by index, zodiac position, latitude, name, brightness,
distance, or zodiac position velocity.
-A <0-24>: Specify the number of aspects to use in charts.
-A3: Aspects calculated by latitude combined with zodiac position.
-Ap: Orb limits apply to latitude as well as zodiac position.
-AP: Parallel aspects based on ecliptic not equatorial positions.
-Ao <aspect> <orb>: Specify maximum orb for an aspect.
-Am <planet> <orb>: Specify maximum orb allowed to a planet.
-Ad <planet> <orb>: Specify orb addition given to a planet.
-Aa <aspect> <angle>: Change the actual angle of an aspect.

Switches which affect how a chart is computed:

-b: Use ephemeris files for more accurate location computations.
-b0: Display locations and times to the nearest second.
-bj: Use more accurate JPL ephemeris file instead of Swiss Ephemeris.
-bs: Use less accurate Moshier formulas instead of Swiss Ephemeris.
-bp: Use less accurate Placalc ephemeris instead of Swiss Ephemeris.
-ba: Don't use Placalc ephemeris for the four main asteroids.
-bm: Use inaccurate Matrix formulas when ephemeris unavailable.
-bU: Use inaccurate Matrix formulas for fixed stars only.
-bJ: Use most accurate JPL Web query instead of Swiss Ephemeris.
-c <value>: Select a different system of house division. 0 = Placidus, 1 = Koch, 2 =
Equal, 3 = Campanus, 4 = Meridian, 5 = Regiomontanus, 6 = Porphyry, 7 = Morinus, 8 =
Topocentric, 9 = Alcabitius, 10 = Krusinski, 11 = Equal (Midheaven), 12 = Pullen
Sinusoidal Ratio, 13 = Pullen Sinusoidal Delta, 14 = Whole, 15 = Vedic, 16 = Sripati, 17
= Horizon, 18 = APC, 19 = Carter Poli Equatorial, 20 = Sunshine, 21 = Savard-A, 22 =
Null.
-c3 [0-3]: Place in houses using latitude as well as zodiac position.
-s [<offset>]: Compute sidereal zodiac instead of tropical zodiac.
-sr: Compute right ascension locations relative to equator.
-sr0: Like -sr but only display declinations instead of latitudes.
-s[z,h,n,d]: Display as zodiac, hr/min, Nakshatras, or 0-360 degrees.
-h [<objnum>]: Compute positions centered on specified object.
-p <month> <day> <year>: Cast secondary progressed chart for date.
-p0 <month> <day> <year>: Cast solar arc chart for date.
-p1 <month> <day> <year>: Like -p but with solar arc cusps only.
-p[0]t <month> <day> <year> <time>: Like -p but specify time too.
-p[0]n: Cast progressed chart based on current date now.
-pd <days>: Set num of days to progress / day (default 365.24219).
-pC <days>: Set factor to use when progressing cusps (default 1.0).
-x <value>: Cast harmonic chart based on specified factor.
-1 [<objnum>]: Cast chart with specified object on Ascendant.
-2 [<objnum>]: Cast chart with specified object on Midheaven.
-3: Display objects in their zodiac decan positions.
-4 [<nest>]: Display objects in their (nested) dwad positions.
-f: Display houses as sign positions (flip them).
-G: Compute houses based on geographic location only.
-J: Display wheel charts in Indian format.
-9: Display objects in their zodiac Navamsa positions.
-F <objnum> <sign> <deg>: Force object's position to be value.
-Fm <objnum> <obj1> <obj2>: Force object's position to midpoint.
-+ [<days>]: Cast chart for specified num of days in the future.
-- [<days>]: Cast chart for specified num of days in the past.
-+[t,m,y] [<num>]: Cast chart for num of hours/months/years in future.

Switches for relationship and comparison charts:

-r <file1> <file2>: Compute a relationship synastry chart.
-rc <file1> <file2>: Compute a composite chart.
-rm <file1> <file2>: Compute a time space midpoint chart.
-r[c,m]0 <file1> <file2> <ratio1> <ratio2>: Weighted chart.
-rd <file1> <file2>: Print time span between files' dates.
-rb <file1> <file2>: Display biorhythm for file1 at time file2.
-r0 <file1> <file2>: Keep the charts separate in comparison.
-rp[0] <file1> <file2>: Like -r0 but do file1 progr. to file2.
-rt <file1> <file2>: Like -r0 but treat file2 as transiting.
-r[2-6]: Make graphics wheel chart tri-wheel, quad-wheel, etc.
-y <file>: Display current house transits for particular chart.
-y[b,d,p,t] <file>: Like -r0 but compare to current time now.

Switches to access graphics options:

-k: Display text charts using Ansi characters and color.
-k0: Like -k but only use special characters, not Ansi color.
-kh: Text charts saved to file use HTML instead of Ansi codes.
-X: Create a graphics chart instead of displaying it as text.
-Xb: Create bitmap file instead of putting graphics on screen.
-Xb[n,c,v,a,b,w]: Set bitmap file output mode to X11 normal, X11 compacted, X11 very
compact, Ascii (bmtoa), Windows bitmap compact (16 color palette), or Windows bitmap
(24 bit colors).
-Xp: Create PostScript vector graphic instead of bitmap file.
-Xp0: Like -Xp but create complete instead of encapsulated file.
-XM[0]: Create Windows metafile vector graphic instead of bitmap.
-X3: Create Daedalus wireframe vector file instead of bitmap.
-Xo <file>: Write output bitmap or graphic to specified file.
-XB: Display X chart on root instead of in a separate window.
-XI <file>: Display bitmap as background behind graphics charts.
-XI0 <trans> <pos>: Set transparency and positioning of background.
-XIW <file>: Replace world map bitmap used for world map charts.
-Xm: Create monochrome graphic instead of one in color.
-Xr: Create chart graphic in reversed colors (white background).
-Xw <hor> [<ver>], -ge[..]: Change the size of chart graphic.
-Xs <100,200,300,400>: Change the size of map or characters by %.
-XS <100,150,200,300,400>: Change size of graphics chart text by %.
-XQ: Ensure square charts remain so regardless of bitmap size.
-Xi: Create chart graphic in slightly modified form.
-Xt: Inhibit display of chart info at bottom of graphic.
-Xu: Inhibit display of a border around graphic.
-Xx: Draw thicker lines in graphics charts.
-Xl: Inhibit labeling of object points in chart graphic.
-XA: Draw aspect glyphs over aspect lines in charts.
-Xj: Don't clear screen between chart updates, drawing trails.
-Xe: Draw Earth's equator in certain charts.
-XU: Draw all stars from [Link] file in certain charts.
-XU[0-3]: Like -XU but set whether to show larger star dot and name.
-XE <low> <high>: Draw range of asteroids in certain charts.
-XE[0-3] [..]: Like -XE but set whether to label ast number and name.
-XL: Plot city locations from atlas on world map.
-XL[1-5]: Like -XL but set how to color cities (when -XA is on).
-XC: Draw house boundaries or alternate info in certain charts.
-X1 <object>: Rotate wheel charts so object is at left edge.
-X2 <object>: Rotate wheel charts so object is at top edge.
-XX[0] [<degrees> [<degrees>]]: Display chart sphere instead of wheel.
-Xd <name>, -di[..] <name>: Open X window on specified display.
-Xv <0-3>: Set fill style for wedge areas in wheel charts.
-XJ: Display wheel charts in South, North, or East Indian form.
-X8: Display planetary moons around planets in wheel charts.
-XW: Simply display an image of the world map.
-XW0: Like -XW but do a non-rectangular Mollewide projection.
-XG[0] [<degrees> [<degrees>]]: Display image of world as a globe.
-XP[0] [<degrees>]: Like -XG but create globe from a polar projection.
-XZ [<object>]: Display telescope chart zoomed in on part of sky.
-XF: Display maps as constellations on the celestial sphere.
-Xn [<mode>]: Start up chart or globe display in animation mode.
-Xnf <units>: Set animation jump factor in units.
-Xnp: Pause animation, suppressing any active animation mode.
-XN: Map animates chart time instead of rotating map itself.
-XM[1-6][0] <strings>: Define macro(s) to run when chart drawn.
-HX: Display list of key press options for screen graphics.

Switches to access Windows options:

-W <value>: Run given Windows menu command internally.
-WN <1-32000>: Set animation update delay in milliseconds.
-WM <1-48> <text>: Set Windows menu text for macro command.
-Wn: Don't redraw screen until user forces update.
-Wh: Set hourglass cursor when redrawing chart.
-Wt: Don't display warning and error popup messages.
-Ww <hor> <ver>: Set upper left coordinates of window.
-WB <0-24> <0-24>: Set window scrollbar positions.
-WT <string>: Set title bar text of Astrolog window.
-Wo: Continually autosave graphics screen to bitmap file.
-Wo0: Continually autosave graphics screen to numbered files.
-Wo3: Autosave graphics screen to wireframe instead of bitmap.
-WSg: Setup Windows program group, for current user only.
-WSG: Setup Windows program group, for all users.
-WSd: Setup Windows desktop icon for program.
-WSx: Setup registering Windows file extensions for program.
-WSu: Unregister Windows file extensions for program.
-WZ: Treat program as screen saver, and exit next user input.

--

Astrolog (version 7.60) obscure command switches:

-Y: Display this help list.
 -YT: Compute true positions in space instead of apparent in sky.
-YV: Compute topocentric positions instead of from center of body.
-Yf: Local horizon positions affected by atmospheric refraction.
-Yh: Compute location of solar system barycenter instead of Sun.
-Ym: Position planetary moons around current central object.
-Ys [<offset>]: Sidereal zodiac positions in plane of solar system.
-Yn: Compute location of true instead of mean nodes and Lilith.
-Yn0: Don't consider nutation in tropical zodiac positions.
-Yu: Display eclipse and occultation information in charts.
-Yu0: Like -Yu but detect maximum eclipse anywhere on Earth.
-Yd: Display dates in D/M/Y instead of M/D/Y format.
-Yt: Display times in 24 hour instead of am/pm format.
-Yv: Display distance in metric instead of imperial units.
-Yr: Round positions to nearest unit instead of crop fraction.
-YC: Automatically ignore insignificant house cusp aspects.
-YO: Automatically adjust settings when exporting and printing.
-Y8: Clip text charts at the rightmost (e.g. 80th) column.
-Ya[0-3]: Set text input encoding to none, IBM, Latin-1, or UTF8.
-Yao[0-3]: Set output encoding to none, IBM, Latin-1, or UTF8.
-YQ <rows>: Pause text scrolling after a page full has printed.
-Yq[0-9] <strings>: Define command lines to run and show in sequence.
-Yi[0-9] <path>: Specify directory to search within for files.
-Yo: Output chart info and position files in old style format.
-Yc: Angular cusp objects are house positions instead of angles.
-Yp: Fix polar houses by preserving Ascendant instead of MC.
-Yz <min>: Forward clock by amount for current moment charts.
-Yz0 <sec>: Set seconds of Delta-T to always use for charts.
-YzO <hr>: Forward object positions by amount for all charts.
-YzC <hr>: Forward cusp positions by amount for all charts.
-Y1[0] <obj1> <obj2>: Rotate planets so one is at other's position.
-YZ <0-7>: Set orientation of azimuth for -Z local horizon chart.
-Yl <1-36>: Toggle plus zone status of sector for sector chart.
-YP <-1,0,1>: Set how Arabic parts are computed for night charts.
-Yb <days>: Set number of days to span for biorhythm chart.
-Ye <obj> <index>: Change orbit of Uranian to external formula.
-Yeb <obj> <index>: Change orbit of Uranian to external ephemeris.
-Yem <obj> <index>: Change orbit of Uranian to planet moon ephemeris.
-YeO <obj1> <obj2>: Change orbit of Uranian to internal planet.
-Yej <obj> <index>: Change orbit of Uranian to JPL Horizons Web query.
-Ye[..]n <obj> <index>: Change Uranian to North Node of object.
-Ye[..]s <obj> <index>: Change Uranian to South Node of object.
-Ye[..]a <obj> <index>: Change Uranian to apihelion of object.
-Ye[..]p <obj> <index>: Change Uranian to perihelion of object.
-Ye[..]HSBNTV <obj> <index>: Toggle heliocentric, sidereal zodiac, barycentric, true
node, true position, or topocentric for object.
 -YE <obj> <semi-major axis> <eccentricity (3)> <inclination (3)> <perihelion (3)>
<ascending node (3)> <time offset (3)>: Change orbit of object to be the given
elements.
-YU <obj> <name>: Change position of star to [Link] entry.
-YUb: Adjust star brightness to apparent magnitude based on distance.
-YUb0: Set brightness to distance independent absolute magnitude.
-YS <obj> <size>: Set diameter of object to be specified size.
-YR <obj1> <obj2> <flag1>..<flag2>: Set restrictions for object range.
-YRT <obj1> <obj2> <flag1>..<flag2>: Transit restrictions for range.
-YR0 <flag1> <flag2>: Set restrictions for sign, direction changes.
-YR1 <flag1> <flag2>: Set restrictions for latitude, distance events.
-YR2 <flag1> <flag2>: Set restrictions for node, equidistant events.
-YRZ <rise> <zenith> <set> <nadir>: Set restrictions for -Zd chart.
-YR7 <ruler> <eso> <hier> <exalt> <ray>: Set rulership restrictions.
-YR[oi]: Store or recall all object, aspect, and other restrictions.
-YRd <div>: Set divisions within signs to search for degree changes.
-YRh: Don't auto(un)restrict central planet when changing it.
-YRU[0] <starlist>: Restrict or focus on list of extra stars.
-YAo <asp1> <asp2> <orb1>..<orb2>: Set aspect orbs for range.
-YAm <obj1> <obj2> <orb1>..<orb2>: Set max planet orbs for range.
-YAd <obj1> <obj2> <orb1>..<orb2>: Set planet orb additions for range.
-YAa <asp1> <asp2> <ang1>..<ang2>: Set planet aspect angles for range.
-YAD <asp> <name> <abbrev> <glyph>: Customize display names of aspect.
-Yj <obj1> <obj2> <inf1>..<inf2>: Set influences for object range.
-YjC <cusp1> <cusp2> <inf1>..<inf2>: Set influences for house cusps.
-YjA <asp1> <asp2> <inf1>..<inf2>: Set influences for aspect range.
-YjT <obj1> <obj2> <inf1>..<inf2>: Set transit influences for range.
-Yj0 <inf1> <inf2> <inf3> <inf4>: Set influences given to planets in ruling sign,
exalted sign, ruling house, exalted house.
-Yj7 <inf1> <inf2> <inf3> <inf4> <inf5> <inf6>: Set influences for in esoteric,
hierarchical, Ray ruling sign, plus same for ruling house.
-YJ <obj> <sign> <cosign>: Set sign planet rules and co-rules.
-YJ0 <obj> <sign>: Set zodiac sign given planet exalts in.
-YJ7 <obj> <sign> <cosign>: Set signs planet esoterically rules.
-YJ70 <obj> <sign> <cosign>: Set signs planet hierarchically rules.
-Y7O <obj1> <obj2> <ray1>..<ray2>: Customize object rays.
-Y7C <sign1> <sign2> <rays1>..<rays2>: Customize sign rays.
-YI <obj> <string>: Customize interpretation for object.
-YIa <sign> <string>: Customize interpretation adjective for sign.
-YIv <sign> <string>: Customize interpretation verb for sign.
-YIC <house> <string>: Customize interpretation for house.
-YIA <asp> <string>: Customize interpretation for aspect.
-YIA0 <asp> <string>: Customize aspect interpretation statement.
-YkO <obj1> <obj2> <col1>..<col2>: Customize planet colors.
-YkC <fir> <ear> <air> <wat>: Customize element colors.
-YkA <asp1> <asp2> <col1>..<col2>: Customize aspect colors.
-Yk7 <1..7> <1..7> <col1>..<col2>: Customize Ray colors.
-Yk0 <1..7> <1..7> <col1>..<col2>: Customize 'rainbow' colors.
-Yk <0..8> <0..8> <col1>..<col2>: Customize 'general' colors.
-YkU <starlist>: Customize list of extra star colors.
-YkE <astlist>: Customize list of extra asteroid colors.
-YD <obj> <name>: Customize display name of object.
-YF <obj> <deg><sign><min> <deg><min> <velocity> <au>: Set position.

Switches to access obscure graphics options:

-YXG <0-2><0-2><0-3><0-2><0-2><0-2>: Select among different graphic glyphs for
Capricorn, Uranus, Pluto, Lilith, Vertex, and Eris.
-YXG[cuplve] <1-3>: Select specific glyph to use for item.
-YXD <obj> <string1> <string2>: Customize glyphs for planet.
-YXDD <obj> <from>: Copy glyph to one object from another.
-YXA <asp> <string1> <string2>: Customize glyphs for aspect.
-YXv <type> [<size> [<lines>]]: Set wheel chart decoration.
-YXt <string>: Display extra text in wheel chart sidebar.
-YXg <cells>: Set number of cells for graphic aspect grid.
-YXS <au>: Set radius of graphic solar system orbit chart.
-YXj <num>: Set number of graphic orbit trails to remember.
-YXj0 <step>: Set vertical step rate for graphic orbit trails.
-YX7 <inf>: Set influence width for graphic esoteric ephemeris.
-YXk: Use more color for sign boundaries in graphics charts.
-YXk0: Use more color for house boundaries in graphics charts too.
-YXK <col> <rgb>: Customize RGB value of color index.
-YXK0: Use alternate color palette for white background mode.
-YXe: Align certain charts to plane of ecliptic.
-YXa <num>: Set limit to dashedness in aspect lines drawn.
-YXU <starlist> <linklist>: Define lines between extra stars.
-YXU0 <starlist> <linklist>: Append instead of replace lines.
-YXW <num>: Draw triangles or cubes grid over world maps.
-YXf <0-9><0-9><0-9><0-9><0-9><0-9>: Set font usage in graphic charts for text,
signs, houses, planets, aspects, and Nakshatras.
-YXf[tshoan] <0-9>: Select specific font to use for area.
-YXp <-1,0,1>: Set paper orientation for PostScript files.
-YXp0 <hor> <ver>: Set paper size for PostScript files.

Switches to access obscure system options:

-YB: Make a beep sound at the time this switch is processed.
-Y5[2-4]: Enumerate all charts in chart list via ~5Y AstroExpression.
-Y5i <string>: Set filter string for ADB XML file format load.
-Y5I <var> <vars>: Set variable range for ~5i AstroExpression.
-YY <rows>: Load atlas list of city locations from current file.
-YY1 <rules> <entries>: Load Daylight Time rules from current file.
-YY2 <zones> <entries>: Load time zone change lists from file.
-YY3 <rows>: Load atlas time zone to zone change mappings from file.
 -YYt <text>: Output formatted text string in current context.
-YYT <text>: Popup formatted text string in current context.
-0[o,i,q,X,n,b,~]: Permanently disable file output/input, program exiting, all graphics,
internet, old formulas, or AstroExpressions.
-;: Ignore rest of command line and treat it as a comment.

Switches to define AstroExpressions:

-~ <string>: Display result of string parsed as AstroExpression.
-~g <string>: Set filter for aspect configurations.
-~a <string>: Set adjustment for aspect list powers.
-~a0 <string>: Set notification for aspect list summary.
-~m <string>: Set filter for midpoint display.
-~ma <string>: Set filter for displaying aspects to midpoints.
-~j <string>: Set adjustment for object influence.
-~j0 <string>: Set adjustment for sign influence.
-~7 <string>: Set notification for esoteric interpretation Rays.
-~L <string>: Set filter for astro-graph latitude crossings.
-~E <string>: Set filter for text ephemeris lines.
-~P <string>: Set filter for Arabic parts display.
-~Zd <string>: Set filter for rising and setting events.
-~d <string>: Set filter for transit to transit events.
-~dv <string>: Set adjustment for void of course determinations.
-~t <string>: Set filter for transit to natal events.
-~O <string>: Set adjustment for object calculations.
-~C <string>: Set adjustment for house cusp calculations.
-~A <string>: Set adjustment for aspect orbs.
-~p[0] <string>: Set adjustment for progression offset.
-~kO <string>: Set adjustment for object colors.
-~kA <string>: Set adjustment for aspect colors.
-~kv <string>: Set adjustment for wheel chart fill colors.
-~F[O,C,A] <string>: Set adjustment for sign/object/house/aspect fonts.
-~v <string>: Set adjustment for object display ordering.
-~v3 <string>: Set adjustment for wheel chart decan markings.
-~XL <string>: Set adjustment for atlas city coloring.
-~Xt <string>: Set notification before sidebar drawn.
-~XQ <string>: Set adjustment for key press in window.
-~WQ <string>: Set adjustment for Windows menu command selection.
-~U <string>: Set filter for extra stars.
-~U0 <string>: Set filter for extra asteroids.
-~q[1-2] <string>: Set notification before/after chart cast.
-~Q[1-3] <string>: Set notification before/after chart displayed.
-~5s <string>: Set sort order method for charts in chart list.
-~5f <string>: Set filter for charts in chart list.
-~5Y <string>: Set notification for chart enumeration via -Y5.
-~5i <string>: Set filter for ADB XML file format load via -Y5I.
-~M <0-26> <string>: Define the specified AstroExpression macro.
-~1 <string>: Simply parse AstroExpression (don't show result).
-~2[0] <var> <string>: Set AstroExpression custom string(s).
-~0: Disable all automatic AstroExpression checks in the program.

--

Astrolog graphics screen key press options (version 7.60):

Press '?' to display this list of key options.
Press 'p' to toggle pause status on or off.
Press 'x' to toggle foreground/background colors on screen.
Press 'm' to toggle color/monochrome display on screen.
Press 'i' to toggle status of the minor chart modification.
Press 't' to toggle header info on current chart on screen.
Press 'b' to toggle drawing of a border around the chart.
Press 'q' to toggle drawing thicker lines within the chart.
Press 'l' to toggle labeling of object points in chart.
Press 'k' to toggle labeling of glyphs on aspect lines.
Press 'j' to toggle not clearing screen between chart updates.
Press 'v' to display current chart positions on text screen.
Press 'R','C','u','y','`','~','U' to toggle restriction of minor objects, cusps, Uranians,
Dwarfs, moons, body centers, and stars.
Press 'c' to toggle relationship comparison chart mode.
Press 's', 'h', 'a', 'f', 'g', 'z' to toggle status of sidereal zodiac, heliocentric charts, 3D
houses, domal charts, decan charts, and Indian format wheel charts.
Press 'O' and 'o' to recall/store a previous chart from memory.
Press 'B' to save current window contents to root background.
Press 'B' to resize chart display to full size of screen.
Press 'Q' to resize chart display to a square.
Press '<' and '>' to decrease/increase the scale size of the glyphs and the size of world
map.
Press '{' and '}' to rotate left/right one degree in globe.
Press '[' and ']' to decrease/increase tilt in globe display.
Press '+' and '-' to add/subtract a day from current chart.
Press 'n' to set chart information to current time now.
Press 'N' to toggle animation status on or off. Charts will be updated to current status
and globes will rotate.
Press '!'-'(' to begin updating current chart by adding times. !: seconds, @: minutes, #:
hours, $: days, %: months, ^: years, &: decades, *: centuries, (: millennia.
Press 'r' to reverse direction of time-lapse or animation.
Press '1'-'9' to set rate of animation to 'n' degrees, etc.
Press 'V','A','Z','S','H','K','J','L','E','I','M','X','W','G','P','T' to switch to normal (-
v), grid (-g), local horizon (-Z), space (-S), sector (-l), calendar (-K), dispositor (-j), astro-
graph (-L), ephemeris (-E), rising (-Zd), moons (-8), chart sphere (-XX), world map (-
XW), globe (-XG), polar (-XP), and telescope (-XZ) modes.
Press 'Y' to switch to biorhythm relationship chart mode.
Press '=' to switch between Western and North/South Indian wheels.
Press '0' to toggle between -Z,-Z0 & -XW,-XW0 & -E,-Ey modes.
Press 'F' to toggle between world and constellation map modes.
Press 'd' to toggle display of house information in map modes.
Press 'e' to toggle display of Earth's equator in map modes.
Press 'w' to toggle drawing world maps in detailed bitmap mode.
Press 'space' to force redraw of current graphics display.
Press 'del' to clear the graphics screen and not redraw.
Press 'tab' to toggle between graphics resolutions.
Press 'enter' to input a command line of program switches.
Press 'escape' to close graphics window and exit program.

Left mouse button: Scribble lines over chart in window.

Middle mouse button: Print coordinates of pointer on world map.
Right mouse button: Close window and exit the program.

DESCRIPTION OF EACH COMMAND SWITCH

Astrolog allows command line switches to be invoked with either the leading dash (“-”)
standard to Unix users, or a leading slash (“/”) that PC users are more accustomed to. Not
only that, but the leading character is actually optional. For example, the command
“astrolog -i chartfile -R -u -U -Z -Xs 300 -Xi -XB” can be done as “astrolog /i chartfile
/r /u /U /Z /Xs 300”, or can be abbreviated as just “astrolog i chartfile R u U Z Xs 300 Xi
XB”. (This is subject to a couple of minor limitations, in that one can't have numeric
switches like -1 follow a -R restriction list of numbers, since the “-1” will be parsed as a
number.)
Many switches in their standard form are technically a “toggle” instead of a “set” for the
particular feature in question. For example, “astrolog -v -g -g” will only result in the -v
chart being printed. An aspect grid won't, because the first -g turned it on while the
second -g turned it back off again. This can be useful, in say the -e everything switch. If
you want all of Astrolog’s charts except the astro-graph, you can do “astrolog -e -L”,
where the -e turns everything on and the -L turns the astro-graph chart (already on
because of -e) back off. In another example, to get a chart with only the fixed stars in it,
one can do “astrolog -R0 -RU”, where the -R0 restricts everything, and the -RU
unrestricts all the stars. The various -X switches which set a mode in graphics are also
toggles. A combination like “-Xr -Xr” which with one instance will just go into reverse
video mode, will remain out of it because the first -Xr put you in and the second toggled
you back out.
Command switch flags may actually be forced on or off regardless of their current setting
with special character prefixes. Many switches (such as -s) represent on/off flags and
their setting is toggled when the switch is encountered. However, that alone doesn't allow
one to force the setting to be a value, because we don't know if it needs to be toggled or
not. Therefore, prefixing any flag switch with '_' will reset its state even if already off,
while prefixing with '=' will always make it on. For example, putting “_s” on a command
line will always set tropical zodiac, while “=s” will always set sidereal. The standard '-'
and '/' prefixes, along with no prefix at all, always toggle the current setting. This is
useful for configuration files where we want to set various flags to particular values.
There’s one more obscure switch prefix of ':', which doesn't affect the setting at all, but
still affects any subsetting parameters. For example, “:I 80” won't affect the interpretation
setting at all, but will still set the default screen width to 80 columns. That is slightly
simpler than the “-I 80 -I” double toggle that would have to be done to do such a thing
otherwise.
The various static help listings that may be generated, such as the lists from -H, -HO, -HI,
and so on, may be combined with each other and even the actual charts. For convenience
the program will terminate right away and not prompt for chart info if the only thing
specified is one of the tables, e.g. just “-H” will print the help list and exit, but “-H -i file
-g” will print the help list followed by an aspect grid chart.
In the command list below, greater than/less than symbols ('<' and '>') are used to denote
a command switch parameter to be replaced by the appropriate value, brackets ('[' and ']')
are used to denote an optional parameter, and commas are used to separate either/or
choices. For example, the specification of the -I switch is “-I [<columns>]”, meaning that
one can specify the -I switch, followed a parameter for the number of screen columns, but
that this extra parameter is optional. The specification of the -Xs switch is “-Xs
<100,200,300,400>“, meaning it can be used as either “-Xs 100”, “-Xs 200”, “-Xs 300”,
or “-Xs 400”. An ellipsis ('..') generally refers to a variable length list of values or an
abbreviation for something already indicated in related switches.
Correct parsing of strings is done on the command line (and in files since they are
technically command lines) in addition to when the user is being prompted for data
within the program. For example, to do the natal chart for the [Link] newsgroup
using the -qa switch, one may enter the intuitive “-qa Jul 29 1991ad 6:23pm -10 151e13
33s52”. The items may be entered in simpler numeric forms as well, such as just “-qa 7
29 1991 18:23 -10 -151:13 -33:52”.
Any command switch that takes an index number as a parameter may have it specified by
its actual name instead of a harder to remember value. For example, the switch sequence
“-c 1 -R 6 -A 5 -F 7 10 0” may also be entered as the more understandable “-c Koch -R
Jupiter -A Sextile -F Saturn Capricorn 0”. Any string may be abbreviated to its first three
characters, or any longer substring as long as they all match. Some stars (along with the
hypothetical bodies Vulcan and Vulkanus, the moons Titan and Titania, and the objects
Pholus and Phobos) have the same first three or more characters, so they need longer
substrings to be unambiguous. Aspects should be based on their formal abbreviations,
e.g. “ssx” instead of “sem” for Semisextile.

Astrolog (version 7.60) command switches:

-H: Display this help list.
This option displays a list of all standard command switches. One can also use
“-?” to display this list. Note that PC users are accustomed to seeing command
 switches with a leading slash “/” instead of a dash “-”. To accommodate this, the
list will display all the switches with a leading “/” instead of a “-”, if the program
has been compiled for a PC. On Unix and other systems they will be displayed
with the standard leading “-”.
-Hc: Display program credits and copyrights.
This help switch displays a full page of credits, listing the names of those who
programmed Astrolog or parts of it, and important copyright information and
other legal items. Every time the command line version of the program is
invoked, the -Hc switch is mentioned to use to see this info.
-HC: Display names of zodiac signs and houses.
The -HC switch will display a list of the 12 signs of the zodiac, and the 12 houses,
listing their standard and traditional names. This is similar to switches like -HO or
-HA below, in that it displays lists of things (objects, aspects, or in this case the
signs) that Astrolog uses in its charts. This switch will also include Esoteric
Astrology information, in that for each sign, listed will be the Rays associated
with the sign, the sign’s standard exoteric planetary rulers, the sign’s esoteric
rulers, the sign’s Hierarchical rulers, the planet exalted in the sign, the exoteric
detriments in the sign, and the planet that falls in the sign. (Exaltations and falls
for minor bodies will only be included if those bodies are unrestricted.)
-HO: Display available planets and other celestial objects.
Similar to the -HA option below, the -HO option will list the planets and other
celestial objects used by the program, and their index numbers as recognized by
the -R switch restrictions. This list will also show the zodiac signs that planets
rule, have their detriment in, are exalted in, and have their fall i.e. are debilitated
in. Stars are printed in the list along with their zodiac position, ecliptic latitude,
and brightness values. Note that this list shows only those items that aren't
restricted when it’s displayed. If you want to show all 131 objects regardless of
restriction status, then use the -R1 switch to activate them all and combine it with
-HO. This switch will also include Esoteric Astrology information, in that for
each planet, listed will be the signs the planet esoterically rules, the signs the
planet Hierarchically rules, and the Ray associated with the planet.
The object list table will include the list of additional stars if the Show Full Star
List setting (-XU switch) is on. The extra stars will be in a separate list after the
main list of objects. For each star it will show its scientific nomenclature
abbreviation (in which something like “alCyg” means Alpha Cygni), the current
zodiac position and latitude of the star, it’s magnitude or brightness, and finally its
traditional or common name (if any). Rows will be colored dark gray (for dim
stars magnitude 4.0 or above), light gray, or white (for bright stars below
magnitude 2.0).
Concerning objects the program includes, Astrolog supports the position of Earth
in the same way it does other planets. Earth is object number 0, placed before all
other objects. Earth is restricted by default, which means that in heliocentric
charts, Earth needs to be unrestricted to see it. If Earth is unrestricted in a
geocentric chart, it will be the heliocentric position of the Earth (i.e. directly
opposite the Sun). Similar logic will be applied whenever the central object is
unrestricted: An unrestricted Sun in a heliocentric chart will be the geocentric
position of the Earth (i.e. opposite the Earth), and an unrestricted planet in a
planet centered chart will be the heliocentric position of that planet (i.e. opposite
the Sun).
Astrolog can do the positions of the North Node and South Node of the Moon,
which are the two points in space where the Moon’s orbit intersects the ecliptic
plane. These are objects number 16 and 17 in Astrolog, and their glyphs are
horseshoe curves pointing up and pointing down. They are also called the
ascending and descending nodes in astronomy, or Rahu and Ketu in Indian/Vedic
astrology.
Astrolog can do the position of Lilith, often called the “Black Moon”. This Lilith
is the direction in space of the apogee or focus point of the Moon’s elliptical orbit
around the Earth (Earth itself being in the other focus point), and not the asteroid
(i.e. “1181 Lilith”), or the hypothetical planet (the “Dark Moon” or second Moon
of Earth proposed by Waldemath) that have the same name. Lilith is object
number 18 in Astrolog, and in graphics charts its default glyph is a small
backwards facing crescent with a cross below it, which in current years is the
most common form of this glyph. Astrolog also supports its classic glyph for
Lilith of a small circle with a forward slash through it, which can be selected with
the -YXG glyph selection switch or in the Graphics Settings dialog. The -b
ephemeris files switch setting needs to be in effect to get Lilith’s positions.
Astrolog can do the position of the Part of Fortune, which is a derived object
determined by the formula (Asc-Sun+Moon). This formula may be reversed (i.e.
Asc+Sun-Moon) for night charts, which Astrolog defines as when the Sun is in
houses 1-6. The Part of Fortune is object number 19 in Astrolog, and its graphics
glyph is a circle with an X through it, like a treasure X marking the spot. The Part
of Fortune is normally placed at 0 ecliptic latitude, however if the 3D houses
setting is on then the same formula used to derive it will be applied to set its
ecliptic latitude as well.
Also, Astrolog can do the position of the Vertex, which is where the ecliptic
intersects the prime vertical in the Western half of the celestial sphere. This is
object number 20 in Astrolog, and in graphics charts its default glyph is a “Vx”
abbreviation, which in current years in the most common form of this glyph.
Astrolog also supports its classic glyph for the Vertex of a cross with its four
endpoints split, which can be selected with the -YXG glyph selection switch or in
the Graphics Settings dialog.
Finally, Astrolog can do the position of the East Point, often called the
“Equatorial Ascendant”, which is technically the same as the position of the
 Ascendant at the equator for the time in question. This is object number 21 in
Astrolog, and its glyph is a simple “EP” abbreviation.
-HA: Display available aspects, their angles, and present orbs.
This switch gives a list of all 24 supported aspects, their abbreviations as used in
the aspect grids, their angles, and their orbs. It will list the index number of each
aspect in addition to all the other info (e.g. Conjunct = 1, Opposite = 2, etc.) so
one can see what number to pass to the -A switch when changing the number of
aspects to be used. Finally, it will print a brief description of what each aspect
glyph looks like. This is useful if one doesn't know what aspects the various
symbols in the graphic displays are referring to. If the parallel aspects mode is
active, then this will instead list the parallel aspects, namely parallel and
contraparallel.
This display will also include a list of all aspects in order of their angle in degrees.
It will list the number of degrees covered by each aspect based on the aspect’s
orb, along with the number of degrees covered by the gaps between aspects. If
any aspects are defined with wide enough orbs so that their areas overlap, this
condition and the amount of overlap will be indicated. (When overlap causes
more than one aspect to be valid, Astrolog will choose the aspect with the earlier
index to be in effect.)
-HF: Display names of astronomical constellations.
This will display a text table of all the constellations, listing their traditional
names, their astronomical abbreviations as used in the graphics above, their
English meanings, and even their genitive or possessive form (e.g. “Lyra” is the
name of the constellation, but the star Vega in it is called Alpha “Lyrae”).
-HS: Display information about planets in the solar system.
This is a another static table which will display some astronomical information
about the planets or other bodies in a simple form. For each object is shown its
distance from the Sun (or planet it orbits) in Astronomical Units (AU), its orbital
period in Earth years, its diameter relative to the Earth (Earth being 1), its
rotational period (i.e. day) in hours, its total mass relative to the Earth (Earth
being 1), its average density with respect to water (water being 1), the tilt of its
axis with respect to its orbit, and finally the number of primary moons or satellites
it has. This table also includes Astrolog’s non-planet objects such as asteroids,
lunar nodes, Uranians, Dwarf planets, and planetary moons, at least for the
distance from Sun and length of year fields (and usually the diameter and day
fields too). Finally this table will include star objects if they’re unrestricted, in
which the “Distance” column will measure light years (instead of Astronomical
Units as is done for planets) which is a factor of about 63000. Note that planet
diameters will be displayed in kilometers (instead of the default in Earth radiuses)
if the metric lengths setting (-Yv switch) is on.
-H7: Display information about the esoteric seven Rays.
 Information about the seven Rays used in Esoteric Astrology is available with this
switch. Each Ray is listed, along with its name in esotericism, and the aspect of
will that Ray covers. The signs associated with each Ray will be printed (by
default each Ray is associated with exactly three signs), and the planets associated
with each Ray. (Rays for minor bodies will only be included if those bodies are
unrestricted.) Finally is printed the “slice” value of the Ray, which is the count of
signs associated with that Ray, each proportioned by the number of other Rays
associated with that sign. For example, Ray 5 is associated with Leo (along with
Ray 1), Sagittarius (along with Rays 4 and 6), and Aquarius (only Ray 5).
Therefore Ray 5’s slice value is 1/2 + 1/3 + 1/1 = 1.83.
If interpretations are on, then after the Rays are listed, this display will include a
list of general Esoteric Astrology information used when interpreting Astrolog’s
esoteric chart (-7 -I switches). Each sign, house, and planet will be listed with its
esoteric information. Specifically, signs will include the esoteric lesson, mundane
and esoteric mantras, and the sign’s type of Light and its corresponding Labor of
Hercules. Houses will include general characteristics and the spiritual qualities
they foster, and planets will include their esoteric meaning.
-HI: Display meanings of signs, houses, planets, and aspects.
This will display the general meanings of each sign, each house, each planet, and
each aspect, on the screen. This shows more or less the database the program uses
to base its interpretations on (see the -I switch setting for charts later).
-He: Display all tables together (-Hc-H-Y-HX-HC-HO-HA-HF-HS-H7-HI).
This switch will print out all 11 of Astrolog’s static table help listings, similar to
what -e does for actual charts. Specifically, this will show the -Hc copyright
screen, the -H switch list, the -Y obscure switch list, the -HX graphics key press
list, the -HC sign and house list, the -HO object list, the -HA aspect list, the -HF
constellation list, the -HS planet information list, the -H7 esoteric Ray list, and the
-HI core interpretation list, for over 600 lines of informational output.
-Q: Prompt for more command switches after display finished.
Usually when Astrolog finishes printing the specified chart or charts, or when we
leave a graphics screen mode, the program will terminate. However, sometimes
one wants to display or work with lots of charts or options, which would normally
cause them to have to invoke the program over and over again from their shell,
using many processes, and can be slow loading over and over from a slow disk.
Auto-termination is also bad when automatically starting up the program in an X
window or DOS box - once the program finishes, the container will exit right
away too, not allowing reading of the text charts. The -Q switch causes the
program to enter a looping mode environment where (after the first chart is
displayed) the user will automatically be prompted to enter a new set of command
switches (using the no SWITCHES interface described later) which will be
 processed. This will go on and the program will run until you enter “.” on a line
for the switches to really terminate it.
Program errors which normally cause Astrolog to exit right away, will (unless
“fatal” errors) return the user back to this outer loop. What’s more is that being in
the loop doesn't cause all the minor program variables to be reset every time. The
main things like what info to use and what charts to display must be specified
each time, but minor modes (such as the present -x harmonic factor) won't, so say
specify -x 5 once, and you will be casting fifth harmonic charts until you specify
otherwise or exit the loop, not having to include -x each time.
-Q0: Like -Q but prompt for additional switches on startup.
This is just like -Q above except that the user will first be prompted for command
switches right upon entering the program. Note that these will be in addition to
whatever else was on the command line where the -Q0 itself was specified. This
is mostly useful when running on a Windows system (see later) where one can
have -Q0 as a default switch to pass to the program. Upon activation, the user will
be in a loop with Astrolog asking for switches right away before proceeding to
generate or prompt for any chart information.
-M <1-48>: Run the specified command switch macro.
-M0 <1-48> <string>: Define the specified command switch macro.
Astrolog has a feature to run “switch macros”, or a whole command line with one
small switch. The -M switch takes one parameter, which is the number of the
macro to run. When encountered, the switches it represents will be processed.
This is similar to loading in a generic command file with -i, except macros are
limited to one command line. Macros however don't require separate files, and
may even call command files themselves with -i.
The switch -M0 is the option that defines a macro. It takes two parameters: the
index of the macro to define, and a string representing the command line to assign
to it. (The command string probably needs to be in quotes to ensure it’s treated as
one parameter to -M0, instead of many items which will get processed right
away.) There are 48 macro slots available to define or run. Macros may do
anything and even call or define other macros. It’s possible to get in an infinite
loop if you make a macro (or command file) call or load itself, which will make
the program terminate with some unusual error.
Macros are powerful and their uses are nearly endless. They can be defined in the
[Link] config file for your most common switch sequences, and are designed
to prevent things such as batch files that would have to be created otherwise.
Suppose you often want to see the transits of outer planets only to the house cusps
in your natal chart for the current month. The command line for this is “-i
yourchart -tn -RT0 6 7 8 9 10 -R0 -RC -C”. You can assign this to the tenth macro
slot with: -M0 10 “-i yourchart -tn -RT0 jup sat ura nep plu -R0 -RC -C”. That
line can be put in your [Link] and you can do this month’s transits by just
 typing “astrolog -M 10”. Here’s another example: Suppose you want a feature to
bring up the chart of the spouse of whoever’s chart you are viewing at any time.
You can define a special macro, say in slot 5, in each of your chart info files
which does a -i on the file of their spouse, or does nothing if they’re unmarried.
Now when in graphics mode, you can press 'F5' anytime and Astrolog will bring
up the spouse’s chart! You could define a bunch of macros to set various color
sets or aspect orbs and switch among them quickly using the function keys. You
could even make a simple chart database by having each chart file load the next
one in sequence in some macro, and then cycle through your charts by running
that macro in a -Q switch loop or from the graphics screen.
-M[1-6][0] <strings>: Define macro(s) to run when chart calculated.
The -M2 through -M6 switches allow different calculation settings to be used for
different rings in a bi-wheel, tri-wheel, or beyond chart. The switches take 2
through 6 string parameters respectively, and each string is a command line that
gets automatically applied before calculating the planet positions for that ring. If
the switch is invoked as -M20, -M30, and such with an extra “0”, then it takes one
final parameter for a command line to run at the very end, which can restore
settings to default values for subsequent use of the program. With this feature you
can do things such as have a heliocentric chart and a geocentric chart displayed at
the same time. You can even do things such as (assuming all calculation methods
are compiled into the program) have one wheel with planets computed via Swiss
Ephemeris, another by the old Placalc ephemeris, and a third by the very old
Matrix formulas, to compare their accuracy side by side.
-Y: Display help list of less commonly used command switches.
This displays a list of available command switches, like the -H option but
showing only “less common” switches that would clutter things up if they were in
the main list, and are usually only specified in configuration files. Hence almost
all of those switches begin with 'Y'.

Switches which determine the type of chart to display:

-v: Display list of object positions (chosen by default).
This is just a formal specification for the standard chart listing of the planetary
positions. One will get this chart by default if they don't specify any other chart
types, and they will get it along with everything else in the -e option (see below).
Although it isn't necessary, it must be included if one wants this type of chart to
be displayed along with some of the other chart types described below.
-v0: Like -v but express velocities relative to average speed.
This switch is like -v except that it modifies planet velocities slightly. The -v
switch chart normally expresses velocity values as an absolute quantity in degrees
per day that the object appears to have moved through the zodiac. That means
 outer planets will generally always have lower values, e.g. although a velocity of
0.01 degrees/day for fast moving Mercury means it’s about to turn retrograde, the
same velocity value is normal for slow moving Pluto. Because it is useful to know
when a planet is about to change direction, the -v0 switch will divide the actual
velocity values by how fast each planet moves on average. That means all planets
will have an average relative velocity value of 1.0, and in all cases a velocity of
2.0 means the planet is moving twice as fast as normal, and one of 0.01 means the
planet is about to turn retrograde.
Note that moons and nodal objects orbiting planets have the average speed of the
planet they orbit, and inner planets closer to the Sun than the central object have
the average speed of the Sun. Similarly, when a planetary moon is set as the
central object, inner moons of the same planet move at the same average speed as
the planet being orbited (which means the speed the central body moon orbits that
planet) while outer moons of the same planet move at the same average speed as
that outer moon orbiting the planet.
Star velocities are accurate, and will be different for different stars based on their
individual (very slow) proper motions. They will also vary for geocentric charts,
because Earth’s orbit around the Sun produces a minor parallax effect which can
cause stars to appear retrograde at times. However, star velocities won’t be
affected by the -v0 switch when the sidereal zodiac is in effect, because in the
sidereal zodiac the average speed of a star is 0 since there’s no precession, and as
a result average speed can’t be computed since you can’t divide by zero.
Note this setting will cause some applying vs. separating aspect orbs to be
displayed wrong, i.e. shown as applying when the reverse is actually true or vice
versa. This issue affects aspect grids and aspect lists (-ga, -ma, and -D charts, but
not the -T transit influence charts). That is because velocities are used to
determine applying vs. separating, to see if one planet is overtaking another. The
issue comes with the program thinking that, for example, Pluto moving 2 times
faster than normal will soon overtake Mars, slightly ahead of it in the zodiac and
moving half normal speed. When the values are expressed as absolute speed, it’s
apparent that the outer planet Pluto always moves much slower than the more
inner planet Mars even when Mars is moving half normal speed. This issue is not
likely to come up much since only explicitly combining -v0 with -ga, -ma, or -D
will cause a problem.
-v3 [0-9]: Display decan or other information alongside positions.
Astrolog can divide the signs of the zodiac in various ways as used in traditional
or Indian astrology, and display these subsections around graphic wheel charts,
and in text listings. The optional numeric parameter to this switch (which is also
the “Wheel Sign Subdivision Type” dropdown in the Chart Settings dialog)
indicates the type of sign subdivision to display. In graphic wheel charts, the sign
wheel will be subdivided appropriately, with each section labeled with a sign,
planet, or number. In the standard text mode chart, the rightmost column will (as
long as the “Print Nearest Second” setting or -b0 switch is on) display the
placement of each planet within the selected division type, instead of latitude
velocity. Note the ~v3 switch AstroExpression can be used to modify these
divisions (i.e. how each section is sized and labeled) or create completely new
ones. The nine sign subdivision types are:
1) Decan Ruler: Each sign is trisected into three equal 10 degree sections,
showing traditional decans or faces. Each decan is labeled with the planet that
rules (based on rulership settings) the sign associated with that third of the
original sign.
2) Decan Sign: This option marks decans or faces with the signs themselves, as
opposed to the planets which rule those signs. This is similar to the effect of the -3
switch, except instead of changing planet positions to new signs, it marks ranges
of the zodiac with those signs.
3) Chaldean Decan: Decans or faces are marked using the Chaldean method, by
repeating the seven visible planets around the zodiac.
4) Egyptian Term: Each sign is subdivided into five unequal sized areas between
2 and 12 degrees, each of which is associated with one of the five planets from
Mercury through Saturn, as indicated by Egyptian terms or bounds.
5) Ptolemaic Term: Each sign is subdivided into five unequal sized areas between
3 and 8 degrees, each of which is associated with one of the five planets from
Mercury through Saturn, as indicated by Ptolemaic terms or bounds. Other term
arrangements can be configured with the ~v3 switch AstroExpression, in which
the documentation for that switch gives an example to show Chaldean terms.
6) Navamsa: Each sign is subdivided into nine equal areas of 3:20 degrees each,
as defined in Indian astrology Navamsas. Each section is labeled with a sign of
the zodiac, and these zodiac signs increase around the wheel. That makes it
equivalent to the 9th harmonic chart, in which each planet will be in a section
labeled with the sign it would move to if the harmonic chart factor were set to 9.
This is similar to the effect of the -9 switch, except instead of changing planet
positions to new signs, it marks ranges of the zodiac with those signs.
7) 12th Harmonic: Each sign is divided into 12 equal 2.5 degree sections, based
on the 12th harmonic in which the first section of each sign is associated with
Aries, the second Taurus, and so on.
8) Dwad: Also called dwadasamsa or dodecatemoria, the dwad division is similar
to the 12th harmonic division above, except each sign labels sections starting with
its own sign, instead of Aries. This is similar to the effect of the -4 switch, except
instead of changing planet positions to new signs, it marks ranges of the zodiac
with those signs.
9) Nakshatra: This shows the Nakshatra division used in Vedic astrology. The
wheel of the zodiac is divided into 27 equal sized areas of 13:30 degrees each, and
each section is labeled with the number 1-27. If the Nakshatra font is set be
 Hank’s Nakshatra (“-YXfn 9” on the command line) then the Nakshatras will be
displayed with glyphs instead of numbers. Since nine of the Nakshatras overlap
sign boundaries, both halves of them will be labeled appropriately. The text mode
version of this division will not only list the Nakshatra number, but also a four
letter abbreviation of the lunar mansion name, like as done when the “Display
Format” setting is set to “27 Nakshatras” (-sn switch). When displaying the
Nakshatras around a graphic wheel chart, the numbers or Nakshatra glyphs will
be colored based on the ruler of that Nakshatra. Specifically, starting with
Nakshatra #1, the colors will be that of the objects South Node (Ketu), Venus,
Sun, Moon, Mars, North Node (Rahu), Jupiter, Saturn, and Mercury (with these
nine repeated three times).
-w [<rows>]: Display chart in a graphic house wheel format.
Display of the chart in a nice wheel format is supported using the -w switch. (If
one of the houses gets too “full” of planets, the planet will be put at the beginning
of the next house.) The same chart header information as is at the top of the
standard -v chart is printed in the middle of the wheel. Some information in
addition to this is shown, which is: (1) the day of the week that the date falls on,
(2) the Universal Time (UT) of the time of the chart being cast (like UTC/GMT in
the 24 hour clock), (3) the sidereal time for the chart cast, where sidereal time is
vaguely similar to UT except 0:00 for it is approximately when 0 Aries crosses
the meridian, as opposed to when the Sun crosses the Nadir for UT, (4) whether
the zodiac system is set to tropical or sidereal, and whether the planetary positions
are geocentric, heliocentric, or centered around some other body, and (5) the
Julian day corresponding to the date and time of the chart. This chart will
automatically exclude a house object from being listed if its position is the same
as the cusp composing the wheel.
Note that this switch takes an optional parameter to specify the size in text rows
of each house printed. By default this is four, but one may increase (realize this
will make the chart require more than 24 lines to print) or decrease this value to
their preference. The parameter may range from 0 to 10, and with this you can
nicely generate a text wheel chart with all 89 objects in it, without overflowing all
the houses. The number 0 means to automatically size to cover the house with the
largest number of objects in it (houses will be printed with at least 4 rows, and
won’t autosize until a 5th object is present in a house).
-w0 [..]: Like -w but reverse order of objects in houses 4..9.
In the -w text wheel option, the objects in each house are printed from top to
bottom in order from earliest in the house to latest. This looks good except for in
houses 5..8 where this would appear backwards (e.g. a planet having just entered
the 6th house from the 5th would be displayed right under the Descendant.)
Therefore the objects from houses 4 through 9 are reversed and printed in order
from bottom to top, making a more flowing looking wheel chart. If however, one
always wants each house to be filled from its top to bottom regardless of which
house, replace the -w with the -w0 switch
-g: Display aspect and midpoint grid among planets.
Aspects and midpoint display are supported: Invoke as astrolog -g and a
rectangular grid showing the midpoint locations for each planet, and showing if
any aspects are present and how accurate they are, is displayed. The planets are
labeled down the main diagonal of the grid, with the aspects to the lower left and
the midpoints in the upper right. This is of course often used along with the -A
switches. Both the aspect orbs and midpoints are displayed to the nearest minute,
and on the main diagonal (or edges if a relationship aspect grid) is displayed the
sign and degree of the planet in question in addition to the planet name itself.
-g0: Like -g but flag aspect configurations (e.g. Yods) too.
Search through the aspect grid for major aspect configurations, including Grand
Trines, T-Squares, Grand Crosses, Yods, Cradles, Mystic Rectangles, and
Stelliums, with the -g0 option. In a Stellium, three or four objects must all be
conjunct with each other. In a Cradle, four objects form three sextiles producing a
chain of sextiles half way around the zodiac. In a Mystic Rectangle, there are two
trines and two sextiles forming a rectangle. This option will produce the same
aspect grid that -g displays, but afterwards it will go through the grid and list any
of these aspect configurations and what objects are forming them. Note that for
Yods, the Inconjunct aspect must be unrestricted in order to see them (e.g. include
-A 6). Note that for Stelliums, three and four planet conjunction Stelliums are
listed separately, which means the three redundant three planet Stelliums within
each four planet Stellium won’t be shown.
-gm: For comparison charts, show midpoints instead of aspects.
For relationship aspect grids, the -gm switch will display a midpoint grid instead
of an aspect grid between the planets in the two charts e.g. “-r0 chart1 chart2 -
gm”.
-gp: Like -g but generate parallel and contraparallel aspects.
Astrolog can show parallel and contraparallel aspects. Two planets are parallel
when they have the same declination with respect to the equator, and are
contraparallel when their declinations are the same amount but on opposite sides
of the equatorial plane. The -gp switch will turn on the aspect grid just like the -g
option, but will also set it so the grid contains parallel and contraparallel instead
of normal aspects. This feature works for the -g aspect and relationship aspect
grids, and the graphics versions of them. The graphic glyph for the parallel aspect
is two vertical parallel lines, while the glyph for contraparallel are two sets of two
lines crossing each other, like a tic-tac-toe grid. In -gp affected charts, the parallel
takes the place of conjunction, and contraparallel the place of opposition.
All aspect orb settings affecting conjunction and opposition will affect the -gp
aspects in the same way. (Note that the best orb for parallel aspects is only a
degree or so, hence the default conjunction orb will likely be too high, and should
be decreased with the -Ao switch for -gp grids.) The -A and -RA aspect selection
 switches will also affect -gp, but all aspects beyond the first two are ignored as
only the parallel and the contraparallel aspects are considered.
Applying/separating indicators will be shown for parallel and contraparallel
aspects, and when the applying aspects setting is not active, then the +/- sign for
the orb will show whether the average of the two planets’ positions is above or
below 0 declination.
-gd: Like -g but aspects measure distance proportions.
Astrolog supports “distance aspects”, or events that compare distances of planets
from the observer. Just as standard aspects compare position along horizontal
zodiac position, and Parallel/Contraparallel aspects compare position along
vertical declination, distance aspects consider the third dimension of distance. To
enable distance aspects, use this switch, or the “Aspects Measure Distance”
option in Display Settings.
Distance aspects compare proportions or ratios of distance, in which each aspect’s
normal angle indicates the proportion compared to 180. For example, a “Square”
aspect in this context means one planet is 50% of the distance from the observer
as the other (90/180), while a “Sextile” means one planet has 1/3 the distance of
the other (60/180). The “Conjunction” aspect is used to represent distances being
equal, which means there’s never an Opposition distance aspect in charts (because
180/180 would be redundant). Aspect orbs become percentages of distance. For
example, a 5 degree aspect orb in this context means planets forming distance
aspects are allowed to be up to 5% different from the exact proportional distance.
(One way to distinguish a chart of distance aspects is that orbs are expressed as
percentages instead of degrees.) For these distance aspects, “waxing” means the
nearer planet is moving away from the observer, while “waning” means the nearer
planet is moving closer.
This setting when enabled will also extend vertical aspects (-gp switch). In
addition to Parallel/Contraparallel which map to Conjunction/Opposition, the
other aspects can measure other proportions. Each aspect’s normal angle indicates
the proportion compared to 180. For example, a “Square” aspect in this context
means one planet has half the declination of the other (90/180), while a “Trine”
means one planet has 2/3 the declination of the other (120/180). For these vertical
aspects, “waxing” means they’re on the same side of the baseline, while “waning”
means they’re on opposite sides. (Because of this, Parallel aspects are always
waxing, while Contraparallel are always waning.)
-ga: Like -g but indicate applying/separating instead of offset orbs.
Ability to determine whether an aspect is applying or separating (is about to
happen or just happened) is included in the -g option. Normally the aspect orbs
are flagged as being '+' or '-' based on whether they are greater or less than the
exact amount (e.g. a 91 degree Square has a +1 degree orb while a 89 degree one
a -1 orb.) If one invokes the -g option as -ga instead, an orb printed as 'a' will
indicate an applying aspect while an orb with 's' a separating one. (To estimate
 applying vs. separating, the program examines the planetary positions and their
relative velocities at the time in question.)
-gx: Like -g but generate waxing/waning instead of offset orbs.
Ability to determine and display whether an aspect is waxing or waning is
included in the -g option. Waxing means the overall difference between the two
planets is increasing, while waning means the difference is decreasing. (Compare
waxing/waning to applying/separating orbs in which the exact aspect is about to
happen or has just happened, or to positive/negative in which the current angle is
greater than or less than the aspect’s angle.) All three types of orbs can be seen in
the -g aspect grid chart, the -a and -D aspect list charts, and the -t and -T transit to
natal charts.
This setting will also make it so that certain charts which display exact times of
aspects will include whether the aspect is waxing/waning next to them. The transit
to transit times chart (-d switch), and the transit to natal times chart (-t switch),
will label waxing aspects with “x” and waning with “n”. Similarly, the graphic
calendar (-K -X switches) will label aspects with “wax” or “wan” if there’s
enough room to the left of the time in the calendar boxes. Note that exact
Conjunction and Opposition aspects are never waxing or waning, so won’t be
labeled as either.
-a: Display list of all aspects ordered by influence.
Aspects may be displayed in a nice ordered list, instead of only in the -g aspect
grid. Use the -a switch and get a list of every aspect from the aspect grid printed
out one per line. The two planets are printed, the aspect they make, their orb, and
then the power of the aspect used in ordering. This chart also will flag notable
aspects such as Moon phases (e.g. “Full Moon”) and eclipses (if the -Yu switch
setting is on). The order in which the aspects are printed is based on the total
“power” in the aspect, i.e. the influence of the two planets in question, the aspect
in question, and the orb. The same info and data from the -j influence charts (see
later) are used here, so changing any default influences there will affect this
ordering. Any power number more than 10 should be a very significant aspect. An
exact Sun Moon conjunction can exceed 25. So, if you want to know, for
example, if that exact Mars Jupiter conjunction is more powerful than that wide
Sun Moon sextile, try a -a chart and find out what Astrolog’s opinion is.
-a0: Like -a but display aspect summary too.
This is just like the -a aspect list ordered by influence chart, except that summary
information will be displayed afterward. The sum of all the aspect powers and
their average is printed, the total number of aspects of each type is printed, and
the total number of aspects to each planet is printed.
-ap: Like -a but do parallel and contraparallel aspects.
 The -a aspect list can be made to list all parallel and contraparallel aspects if
invoked as -ap or -a0p, turning on the same flag as the -gp switch above. When in
effect, the parallel aspects setting will also affect -D and -T transit influence
charts, having them show their aspects in parallel too. This setting will also add
results to the -d transit to transit times search, and the -t transit to natal times
search, in which they’ll also list parallel aspects and when parallel transits happen
(instead of only working with standard aspects).
-ad: Like -a but aspects measure distance proportions.
The -a aspect list can be made to show distance aspects if invoked as -ad or -a0d,
turning on the same flag as the -gd switch above. When in effect, the distance
aspects setting will also affect -D and -T transit influence charts, as well as -B and
-V transit graph charts (both single chart and transit/relationship comparison chart
versions).
-aa: Like -a but indicate applying/separating instead of offset orbs.
This is a shorthand way to bring up the -a or -a0 sorted aspect list chart, with the
aspect orbs shown as applying or separating, instead of positive or negative
offsets to the exact aspect size. This is like how -ga does the same thing with the -
g aspect grid switch. (To get the functionality of -aa without this, one can use the -
ga switch itself along with -a, and then include -g by itself again, e.g. “-a -ga -g”,
to toggle the aspect grid back off but leave the applying vs. separating setting on!)
-ax: Like -a but generate waxing/waning instead of offset orbs.
This is a shorthand way to bring up the -a or -a0 sorted aspect list chart, with the
aspect orbs shown as waxing or waning, instead of positive or negative offsets to
the exact aspect size. This is like how -gx does the same thing with the -g aspect
grid switch.
-a[jonOPACDm]: Sort aspects by power, orb, orb difference, 1st planet, 2nd planet,
aspect, 1st position, 2nd position, midpoint.
The aspect list chart can sort the aspects it displays by several different methods.
This applies both to the single chart and relationship comparison versions of the
display. The sorting method set here will also affect the transit influence charts (-
D and -T switches). The -a switch can be followed by nine different subswitch
characters:
-aj: Sort by power. High total power aspects appear earlier, and lower power later.
This is the default.
-ao: Sort by orb. Narrow orbs appear earlier and wider orbs later. This only
considers the “magnitude” of the orb, and will intersperse applying and separating
orbs among each other.
-an: Sort by orb difference. This considers the “sign” of the orb, and will place all
applying orbs or angles less than the aspect size before all separating orbs or
angles more than the aspect size.
 -aO: Sort by planet. More specifically sort by the first planet listed, and within
each planet sort by the second planet listed.
-aP: Sort by second planet. More specifically sort by the second planet listed, and
within each planet sort by the first planet listed.
-aA: Sort by aspect. Within each aspect, sort by planets as with the -aO method.
-aC: Sort by zodiac position of the first planet listed.
-aD: Sort by zodiac position of the second planet listed.
-am: Sort by midpoint of the two planets' zodiac positions.
-m: Display all object midpoints in sorted zodiac order.
True midpoint charts are supported in addition to the midpoints that can be seen in
the -g aspect grid. Use the -m switch and get a list of all midpoints printed out
sorted in zodiac order. This will show both the actual midpoint location, as well as
the angular difference between the two objects displayed to the nearest minute. So
if you want to see, say, if any important midpoint is close to your Sun, this is a
much easier chart to use than scrutinizing the midpoint/aspect grid.
Vertical midpoints: Astrolog’s midpoint list chart will include the midpoints of
latitudes as well, if the -gp switch setting is on. For example, the vertical midpoint
of a planet at +6 degrees ecliptic latitude and a planet at -1 ecliptic latitude is
+2:30 latitude.
3D midpoints: Astrolog’s midpoint list chart (and the -g aspect/midpoint grid
chart) will do “3D midpoints” based on the midpoint along the great circle
between the two points on the celestial sphere, if the 3D houses setting (-c3
switch) is on. Classic midpoints only take the midpoint of zodiac position
longitudes and completely ignore latitude (or look at latitude separately). For
example, the classic midpoint of a planet at 0Ari and 0 latitude, and another planet
at 0Leo and +89 latitude, will just be 0Gem, however the 3D midpoint will be
close to 0Ari and +45 latitude. If 3D midpoints are active, then one probably
wants to turn on vertical midpoints too, in order to also see the vertical latitude
component of the 3D midpoint.
-m0: Like -m but display midpoint summary too.
This is just like the -m midpoint list ordered by zodiac position chart, except that
summary information for it will be displayed afterward. The average number of
degrees spanned between each planet pair is printed, and the total number of
midpoints in each zodiac sign is printed.
-ma: Like -m but show aspects from midpoints to planets as well.
Aspects to midpoints are supported with the -ma switch. This feature will do the
same as the -m midpoint list chart, except in addition to listing each midpoint, a
sublist of each aspect in effect from a natal planet to the position of that midpoint,
will be shown after it. The orb of the aspect will be printed too, where the orb will
be shown as either wide or narrow, or applying or separating, based on the value
of the -ga or -aa applying aspects setting.
-Z: Display planet locations with respect to the local horizon.
The text display switch -Z prints out where each object is on the local horizon in
terms of altitude and azimuth. This is basically a local space mundoscope. For
each object, the following is displayed: Its altitude on the local horizon from +90
degrees (straight up) to -90 degrees (straight down), and its azimuth from 0 to 360
degrees, where 0 = due east, 90 = north, 180 = west, 270 = south. To make
visualizing the azimuth easier, an “azimuth vector” with a N/S component and a
W/E component is displayed, e.g. (1.00s 0.33w) means that the object is mainly
south, with its true angle being formed by a vector component west that’s 1/3 the
strength of the south component, i.e. the object is about 18 degrees west of south.
This along with the altitude should make it easy to physically point to where any
planet is at any moment, making it easy to locate planets in the night sky. This
data can also be used to see when planets rise and set. Also displayed are the
planet’s brightness in magnitude, its phase (both as a percentage of disk area
covered, and percentage of time to fullness), and the angular diameter that its disk
covers in the sky.
If the -v3 switch setting is on, also displayed are altitude and azimuth differences
between each object and the Sun and Moon, first showing the number of degrees
that the Sun/Moon is “ahead” (or farther east in the zodiac) of the object in
question, and then the number of degrees that the Sun/Moon is above the object in
question. This feature can be used to roughly predict eclipses: Both the Sun and
Moon span about 0.5 degrees in the sky, therefore if both the azimuth and altitude
differences are < 0.5 (or 1.0 if the difference is between the Sun and Moon
themselves) then the object in question is probably being occulted somewhat by
the Sun/Moon.
-Z0: Like -Z but express coordinates relative to polar center.
This will do a text chart just like the -Z local horizon switch above except that it
will print the location of each planet in prime vertical coordinates (or whatever
the current 3D house model is, as set with the -c3 switch) instead of altitude and
azimuth. Prime vertical coordinates are measured with its “azimuth” around the
360 degree circle, with 0 degrees due east on the local horizon, going down with
90 degrees straight down, 180 degrees due west and so on; declination “altitudes”
are measured with positive values toward the north and negative toward the south.
In summary there are four types of planetary position displays: Azimuth and
altitude showing the positions of the object relative to the local horizon (covered
with -Z, or -Z0 and -c3 2), prime vertical coordinates (covered with -Z0 and -c3
1), right ascension and declination along the celestial equator showing the object’s
position with respect to the background of stars (covered with -Z0 and -c3 3), and
finally longitude and latitude showing where on the Earth the object is straight up
(as in the astro-graph zenith locations).
-Zd: Search day for object local rising and setting times.
 One can display the rising and setting times of the Sun, Moon, and other bodies
with this feature. Specifically, when this switch is included, the program will, for
the entire day specified in the chart information, display whenever a planet rises
(specifically conjuncts the local horizon while in the Eastern hemisphere), sets
(conjuncts horizon in West), reaches its zenith point (or specifically conjuncts the
meridian while above the horizon), and reaches its nadir point (conjuncts meridian
while below the horizon). Note that some stars may be high or low enough that
they will never rise or set, but instead will just “zenith” or “nadir” twice in a day
as they spin around the pole.
-Zd[m,y,Y] [<years>]: Like -Zd but for entire month, year, or years.
The -Zd switch which supports scanning an entire month, year, or range of years.
The -Zdm switch will scan the entire month, the -Zdy switch will scan the whole
year, and the -ZdY <years> switch will scan the number of years specified
starting with the current year.
-S: Display x,y,z coordinate positions of planets in space.
Solar system space based charts are available with the -S switch, which give the
astronomical positions of each planet in terms of x, y, and z coordinates. Although
not directly useful astrologically, it does give one a view of how the planets are
actually positioned at the time in question. For example, standard astrology
doesn't make the distinction between the four different forms of say, a Mercury
Venus Conjunction, i.e. they can either be Conjunct on the near side of the Sun,
Conjunct on the far side of the Sun, or one can be on one side and the other on the
other side. When the chart is actually displayed, for each body the following
information is printed: The azimuth or relative angle of the planet with respect to
the central body, i.e. its zodiac position in the current display format. This is
followed by the x, y, and z coordinate positions of the object, in astronomical
units from the central body. The x-axis increases in the direction of 0 degrees
Aries (tropical zodiac), the y-axis increases in the direction of 0 degrees Cancer,
and the z-axis is with respect to the ecliptic or Earth’s orbit (meaning that the Sun
and Earth always have a z-axis value of 0.0). Finally the overall length from the
central body in Astronomical Units (AU) is printed, which is just the diagonal as
indicated by the x, y, z vectors. (The Earth and Sun are of course always about 1.0
AU from each other.) If the -Yv metric lengths switch setting is on, then these
lengths will be displayed in kilometers instead, which gives a more detailed
measurement. For star objects, the “Length” column will measure light years
instead of AU. (Note that 1 light year is about 63000 AU, so the stars are actually
more distant by this factor.) The -e everything option will include this chart in its
listing of all the chart displays.
-l: Display Gauquelin sectors for each planet in chart.
Astrolog supports Gauquelin sector charts. These are based on the work of
Michael Gauquelin, with a sector chart basically a type of wheel chart where the
planets are placed in their appropriate Gauquelin sector instead of zodiac sign at a
 given time. Sectors are numbered from 1 to 36, and indicate proportions of time
between rising and setting. Sectors 1 through 18 are above the horizon, and 19
through 36 are below. When a planet rises it goes from sector 36 to 1, when
1/18th of the time until the moment it sets has passed it enters sector 2, and so on.
A sector chart can be thought of as somewhat related to a standard wheel chart,
except that it’s “time based” instead of “location based”. Because of this, the
sector chart will only include objects that actually rise and set during the day, and
objects that never do that such as circumpolar stars, or house cusp objects like the
Vertex and East Point, will be omitted from the chart. In interpretation, certain
sectors are known to be powerful. These sectors are called plus zones and are the
sectors immediately before and a bit after the four angles. For a more detailed
account on interpretation, see books such as Gauquelin’s “Cosmic Influences on
Human Behavior”. To bring up a sector chart, use the -l command switch.
The text mode version of this chart is similar to the standard -v listing. The chart
info time and place will be displayed, after which, for each planet, the sector it’s
in will be displayed, with a “+” indicating a plus zone, and a “-” indicating such is
not the case (where with colored text active plus zones will be in red and minus
dark green). Then as in the standard listing, the planet’s house, zodiac location,
retrogradation status, equatorial latitude, and velocity will be printed. Finally will
be displayed two alternative sector locations assuming systems where sectors go
from 1 to 18, and from 1 to 12 (where for example the beginning of sector 36 will
map to sector location 18.5, and 12.75, respectively). After this, summary
information will be displayed. The number and percentage of planets that fall in
plus zones (as well as the number and percentage of plus zones period) will be
printed, and for each of the 36 sectors, the number of planets that fall in it and
whether it’s a plus zone will be indicated.
-l0: Like -l but approximate sectors using Placidus cusps.
Calculating correct Gauquelin sector positions is based on rising and setting
times, which require searches, hence computing the chart takes longer than
regular wheels. It’s like the -Zd rising and setting list, in which increasing the -d
searching divisions value increases the accuracy and calculation time here too. To
cut calculation time down to that of ordinary charts, one may do a reasonable
approximation of sector positions based on how far each planet has moves
through a corresponding house (specifically house cusps divided using Placidus).
To compute charts in this faster manner, invoke the -l switch as -l0. Note that
since these sector positions are approximate, planets may appear to move in this
chart when compared to the accurate -l chart.
-j: Display astrological influences of each object in chart.
Another chart type is available - interpretation of influences. This is part of the
general interpretation ability of the program. What this chart does is calculate the
relative “power” of each planet’s placement, giving a general idea of dominants
or the prominent areas of a chart. In the chart, each planet is given a point value,
with larger numbers indicating more strength. Each planet’s strength is divided
between two fields: the positioning in and of itself, and the power of the aspects it
makes with the other planets. In addition to each field, the total of these two areas
is printed, as well as the relative percentage of the planet in question with respect
to all the planets combined. Each planet gets a ranking for its positioning, aspects,
and total power as well, with the strongest getting #1, the next strongest #2, etc.
The -e option will include this chart along with all the others as well in its listing
of all the chart displays.
To determine the strength of the positioning of a planet, various things are taken
into account:
1) The power of a planet in and of itself, e.g. the Sun and Moon are more
powerful than the other planets.
2) The house placement of a planet, e.g. a planet in the 1st house is more powerful
than one in the 2nd.
3) Whether a planet is in the sign it rules or is exalted in, e.g. Jupiter in Sagittarius
results in more power to Jupiter. Esoteric and Hierarchical rulers will be
considered too, if such rulerships are unrestricted (via the -YR7 switch).
4) Whether a planet is in the house corresponding to the sign it rules or is exalted
in, e.g. Jupiter in the 9th house.
5) Planets get more power if the signs they rule are occupied, e.g. a bunch of
things in Aquarius gives more power to Uranus.
6) Planets get more power if the houses they rule are occupied, e.g. a bunch of
things in the 11th house gives power to Uranus.
7) Finally, planets get power according to what house cusps fall in the signs they
rule, e.g. the ruler of the Ascendant (and to less extent the Midheaven) gets lots of
influence.
Determining the strength of a planet’s aspects is much easier, and is basically
composed of the sum of the strength of each aspect the planet makes. Taken into
account are:
1) The influence of the planet being aspected to, e.g. Sun conjunct Jupiter gives
more influence to Jupiter than Mercury conjunct Jupiter would. The planet’s
placement as described above plays a role, too, e.g. Venus opposition Mars in
Aries gives more influence to Venus that it would be if Mars were in Taurus.
2) The influence of the aspect itself, e.g. Oppositions are more powerful then
Sextiles.
3) Finally the orb of the aspect, i.e. exact aspects are more powerful than wide
ones. The influence of the orb varies linearly from max power at exact to zero
power at the limit of the orb. Sorry Maggie M. and Mark K. - no complex aspect
wave functions, at least for this version. ;)
Special thanks goes to Mark K. who initially presented this idea of interpreting
overall influences to me. I basically just started with his ideas, polished them a
bit, and put it into the program. Interestingly, while programming this feature I
had a dream about him, in which he elaborated upon some of the ideas and even
gave me suggestions for some of the planets’ default power values. Perhaps this
was an astral plane visitation? ;) While on the subject, I've had a couple of other
 Astrolog dreams; I had a neat one while working on the -h switch heliocentric
feature about a far distant future version of Astrolog that could actually teleport
one to the planets which they cast charts centered upon. :)
-j0: Like -j but include influences of each zodiac sign as well.
The -j planet influences in a chart feature can be expanded to include signs as
well. Invoke it as -j0 instead of just -j, and in addition to getting the influence of
each planet in a chart, one will get the influence of each sign in the chart as well.
To determine sign influence, we use the planet powers already determined. A sign
gets influence if:
(1) There is a planet in it.
(2) If any planet that rules or co-rules it is in the chart.
(3) If the -l0 switch is active, also checked will be if there’s a planet in the house
it corresponds to.
(4) If the -v3 switch is active, also checked will be if there’s a planet in a decan
mapping to that sign.
For example, with my Venus in Sagittarius, for me: (1) Sagittarius gets more
power because Venus is in it, and (2) Libra and Taurus get power because Venus
itself rules these signs. The exact power given is based on the total influence of
Venus already determined. Any sign that has over about 175 points or 20% of the
total is a really powerful and a fundamental part of the psyche. We also sum up
the influences of all the signs (which will logically total up to the sum of all the
planets), and display the influence of each element, and each mode as well, all
this being perhaps a more accurate version of the element table in the -v chart.
Also (unless the -l0 switch is active) one will get the influence of each house in
the chart as well. This will also include summaries for the four house “elements”
(called Dharma, Artha, Kama, and Moksha houses in Indian/Vedic astrology), and
the three house “modes” (Angular, Succedent, and Cadent). Each house has a
base influence (e.g. Angular houses are inherently stronger than non-Angular),
and houses also receive influence based in the influence of the planets within
them. Because house influences are tracked separately, signs don’t receive
influence if a planet is in the corresponding house (e.g. a planet in the 10th house
by default doesn’t add influence to Capricorn).
-7: Display Esoteric Astrology and Ray summary for chart.
A chart for Esoteric Astrology is available. It will list planets, showing the
planet’s Ray, the planet’s position and the Ray(s) of its zodiac sign, and rulership
information about the planet’s zodiac position and house position. That includes
whether the planet exoterically rules or is in detriment in the sign (indicated with
“R” or “d” characters), whether the planet esoterically rules or is in detriment in
the sign (“S” or “s” characters), whether the planet Hierarchically rules or is in
detriment in the sign (“H” or “h” characters), whether the planet exalts or falls in
the sign (“X” or “f” characters), and finally whether the planet Ray rules or is in
Ray detriment in the sign i.e. whether the planet’s Ray is the same as one of its
sign’s Rays (“Y” or “z” characters). For a “double Ray rulership”, or when a
planet’s Ray is the same as both the sign’s and house’s Ray, the “Y” will be “Y2”
instead. Finally the power of each planet is listed, based on its inherent strength,
positioning, and aspects, which is computed in the same way as in the -j switch
influence chart.
The esoteric chart also lists the seven Rays, showing the count of planetary sign
positionings that are associated with that Ray, the total power of those planets,
and the rank of each Ray’s total power and the percentage covered by that Ray.
This can be used to see which Rays are most influential in a chart. The same
counts and powers are repeated, however this time a sign associated with multiple
Rays only contributes proportional slices of power. By default, each Ray is
associated with three signs, so for balanced Ray coverage that gives each Ray an
equal potential for power, the first “count” values are preferred. However, some
signs are associated with one Ray, while others are with two or three, which
means certain signs have triple potential to contribute power, so for balanced
planet coverage that gives each sign an equal potential for power, the second
“slice” values are preferred. For more about Esoteric Astrology in Astrolog, see:
[Link]
This chart will display a special Esoteric Astrology interpretation when
interpretations are turned on. For each planet in sign placement, Astrolog will
display the esoteric meaning of the planet, the Ray of the planet and its meaning,
the esoteric lesson of the sign, the mundane and esoteric mantras of the sign, the
spiritual type of Light of the sign, the sign’s associated Labor of Hercules, the
mundane/exoteric and esoteric ruler(s) of the sign, along with the sign’s Ray(s),
and any standard, esoteric, Hierarchical, or Ray rulerships. If the “text influence
chart shows sign influences too” setting (-j0 switch) is on, then house placement
will be esoterically interpreted as well. Astrolog will display the esoteric meaning
of the house, the Ray(s) of the sign corresponding to the house, and any house
Ray rulerships.
Also included in the interpretation is an esoteric “Ray chart” for the person
or time in question. A true Ray chart can’t be determined objectively, but
it’s possible to give clues or hints to a Ray chart based on astrological
influences. Displayed will be the potential Rays for soul, personality,
mental vehicle, astral vehicle, and physical vehicle. For each vehicle, each
of the Seven Rays is given a score, and these Rays and their percentages
are displayed in order. Each vehicle focuses upon two or three planets that
align with it, which may include Earth and Vulcan, so for best results
these objects should be unrestricted. For the planets in question, the Ray
vehicle score calculating process looks at the Rays of the planet’s sign,
along with the Rays of the exoteric and esoteric rulers of the sign (and the
Rays of their dispositors or planets which rule those signs). Some signs
have multiple or veiled exoteric or esoteric rulers, in which case both lines
are considered. If the “wheel sign subdivision type” setting (-v3 switch) is
on, then also considered will be the sign based decanates. (This means
 looking at four things: Standard sign placement and ruler, along with 1/3
score for the decanate placement of the sign ruler, 1/3 score for the sign of
the ruler of the decanate, and 1/9 score for the decanate placement of the
decanate ruler.) Finally, for the three vehicles, Rays are proportioned to
align with the common distribution of Rays for those vehicles: Physical
Ray is usually 7, 3, or 1. Astral Ray is usually 6, 2, or 1. Mental Ray is
usually 5, 3, 4, or 1.
The text used for the mantras, spiritual Light, and Herculean Labors is
from the book “Esoteric Astrology” by Alice A. Bailey. The text used for
esoteric planet meanings, esoteric sign lessons, and esoteric house
meanings, along with the main design logic of the astrological influences
Ray chart itself, is by Esoteric Astrologer BL Allison.
-L [<step>]: Display astro-graph locations of planetary angles.
The '-L' option will take the standard chart information and generate the
astrocartography positions of the planets. In other words, this does the exact same
thing that Jim Lewis’ Astro*Carto*Graphy maps do. It will display the longitude
of where on the Earth at the time in question each object was on the midheaven
and on the nadir, and the latitude of where the planets actually appeared at zenith.
Also, for latitude increments of 5 degrees, the longitude of where the objects
appeared on the ascendant and descendant is displayed. For text screens, one can
pass an optional parameter to this -L (or -L0) option to change the default latitude
step rate at which the Ascendant and Descendant lines are computed. Again, this
value is by default 5 degrees, although one can may increase or decrease it to any
integer.
-L0 [<step> [<dist>]]: Like -L but list latitude crossings too.
Determination of latitude crossing points is available in the astro-graph feature.
The -L0 option will do the same thing as -L, except that after displaying the
longitude and latitude locations of the Asc/Desc/MC/IC lines, it will then search
among the lines and display (in order from farthest North to farthest South) the
latitude of any points where lines cross each other, which some call “parans”.
This includes the curvy Asc/Desc lines crossing the straight MC/IC lines as well
as cases where different Asc/Desc lines cross themselves. Astrolog will also
display the longitude of the crossing (useful for Asc/Desc crossings) in addition to
the latitude. Astrolog will detect all possible latitude crossings, even those near
the poles. Note that for any astrocartography chart with a given number of
uniquely positioned objects, with any orientation of its lines there should always
be the same number of crossings total. This chart will respect the rising and
setting restrictions (-YRZ switch) which when set will prevent the display of
latitude crossings involving the Ascendant, Midheaven, Descendant, or Nadir.
The text mode astro-graph chart will also display a list of cities from the atlas
closest to each latitude crossing. The second optional parameter to the -L0 switch
specifies the maximum distance allowed from the crossing point to a city, in
 default distance units (miles or kilometers). In the Windows version, the “Latitude
Crossings Show Cities Within” field in the Chart Settings dialog sets this
distance. The maximum number of cities allowed to be listed for each crossing
(which means the N closest cities to it that are within the distance limit) is
specified with the -Nl switch parameter. In the Windows version, the “Nearest
Cities List This Many Cities” field in Chart Settings sets this distance.
The text mode astro-graph chart has an alternate version that displays when in
relationship comparison mode (-L -r0 switches). This relationship
astrocartography chart will map the lines of both sets of planets separately, and
indicate latitude crossings or parans where one chart’s lines crosses the other
chart’s lines. For example, this can do a relationship comparison between two
people and see where their lines cross, or compare between transit and natal charts
to see how current energies are affecting one’s natal energies. When in transit to
natal comparison chart mode (-rt switch) transit restrictions will be checked when
deciding what objects to include. For example, if only the Sun is enabled in transit
restrictions, and only the Moon is enabled in standard restrictions, then only
transiting Sun crossing natal Moon lines will be displayed. Each line will be
marked with “#1” or “#2” to indicate the two chart slots, or else be marked with
“T.” or “P.” or “N.” to indicate transiting, progressed, or natal.
-K: Display a calendar for given month.
The -K switch generates a simple calendar for the month specified in the current
chart. This is a standard type of chart generatable from a date so the -e everything
switch includes this -K chart along with all the others. Note that this is technically
a non-astrological chart, but generic calendars are useful and easy to generate
with all of Astrolog’s date determination features, so the option to create them
using Astrolog is included. The calendars are compact, with one text row per
week. The day specified in the current chart will be highlighted in green assuming
-k Ansi color is active, e.g. “-n -K” will generate a chart for this month, with the
number of today’s date highlighted.
-Ky: Like -K but display a calendar for the entire year.
The -Ky switch is just like -K except that it will generate a calendar for the whole
year. All twelve months will be displayed on the screen, each just like the
individual monthly calendars above but printed in four rows of three months each.
-d [<step>]: Print all aspects and changes occurring in a day.
The -d option will take the standard chart information, and for the day in question,
display the exact times of all aspects that occur. This is similar to the aspects per
day as displayed in Jim Maynard’s Celestial Guide books. (Displayed in local
time as defined by the default zone, with accuracy based on the searching
divisions setting, described below.) This will tell any time when two planets make
aspects with each other, a planet changes its sign, or a planet goes retrograde or
direct. Events for planets stationary going retrograde will be marked with “S/R”,
and planets stationary going direct will be marked with “S/D”. This chart (along
with the -t list described below) will display the signs that any planets aspecting
each other are in, in addition to the aspect itself (e.g. instead of just “Jupiter Trine
Uranus”, we have “Jupiter (Vir) Tri (Cap) Uranus”. If a particular object is going
retrograde, then its sign will be displayed in brackets instead of parentheses, and
if an object is about to or has just gone retrograde or direct, then its sign will be in
<>’s. If the “Print Nearest Second” setting is on (-b0 switch) then these positions
will be printed to the nearest arc minute.
This chart will search for parallel and contraparallel aspects instead of standard
aspects when the parallel aspects setting (-gp switch) is on. These aspects will
check ecliptic instead of equatorial coordinates, if the -AP switch setting is on.
For “vertical” events, it will show the planet’s declination value at that time in
parentheses (instead of just the zodiac position longitude, which is less useful).
This chart will include aspects involving house cusp objects if the “Graphs
Include All Planets” setting is on (-B0/V0 switches). Normally cusp objects like
the Ascendant are always excluded from this chart (even if unrestricted) to avoid
too many aspects being displayed. This is an option if you want to see when
planets conjunct house cusps, which also means when during the day they move
between houses.
This display will also indicate when the Moon goes void of course. The Moon is
void of course (v/c) between the time of the last aspect it makes and when it
enters the next sign. The last aspect the Moon makes will be marked as the Moon
going void of course, along with how long the Moon is void of course before it
enters the next sign. There are different ways to measure the “last aspect” the
Moon makes, and for flexibility Astrolog simply bases it on which aspects and
planets are unrestricted. Note the Moon going void of course won’t be detected if
a Moon aspect event isn’t displayed some time before a Moon sign change event
in the list. That means the Moon and sign changes need to be unrestricted, in
order for void of course periods to be seen.
This switch accepts an optional accuracy parameter, a value which tells how
many searching divisions or “segments” we should divide each day or period,
when doing these aspect searches. More segments is slower but can be more
accurate by a few minutes. This command line change of the step rate can also be
done for other charts such as the -t transit search by using the switch toggle
feature to turn -d off but still leave the divisions value set, e.g. “-d 100 -d -t” will
set the value to 100 but not actually display the -d chart. Or better yet just use the
colon switch prefix to not affect the -d setting at all, e.g. “:d 100 -t”. In general, I
suggest this value be set to around 48, but it is easy to experiment to see what is
best for the speed of your computer. One may increase this value up to 2880 (if
they don't mind the wait) which will mean a chart every 30 seconds for -d aspect
in day charts and one every 15 minutes for -t transit search charts.
Note it’s possible for transit event searches to have too many events per time
period. This condition requires having many objects unrestricted combined with a
 short searching divisions setting. If such a scenario does happen then an
appropriate warning message will be displayed.
-dm: Like -d but print all aspects for the entire month.
The -d option can search the entire month for aspects between planets if one so
desires. Specifying it as -dm instead of just -d will go through the entire month
instead of just the current day. (Combining this one with -R allows searching for
important aspects, sign changes, etc.)
-dy: Like -d but print all aspects for the entire year.
The -d option can search the entire given year for events as well, if it’s specified
as -dy instead of just -d or -dm. Note that transit to transit event searches over an
entire year or years may take longer to run. Because of this, these searches will
divide the searching divisions setting by 10. That means a searching divisions
parameter of 100 used for a yearly search will be equivalent to a searching
divisions parameter of 10 used for a monthly search.
-dY <years>: Like -d but search within a number of years.
The -d search may also do a range of years all at once. Invoke the switch as -dY,
and give a parameter indicating the number of years to span, and it will be done,
starting with the year in the current chart. For example, to display the times of all
New and Full moons for the next two years (2022 through 2023), do “astrolog -n -
dY 2 -R0 sun moo -A opp”. (This is similar to the -EY and -tY features which
also allow doing a range of years in addition to a single year or month.)
-dp <month> <year>: Print aspects within progressed chart.
Another progression feature allows determining aspect times of progressed
planets among themselves. The -dp <month> <year> switch will, like the -d
option, display times of aspects and sign changes, for the time around the chart in
question, except that they will be progressed throughout the month specified.
Progressed planets move very slowly (“year for a day”) so therefore there will
usually be, if any, only a couple of aspects in a given month. Also, since they
move so slow, the accuracy is cut down, so the dates given are probably only
accurate about to the nearest day, in spite of the times given to the minute. Note
that Astrolog can scan for aspects of: transiting planets among themselves (-d
switch), transiting planets to natal planets (-T switch), progressed planets to natal
planets (-Tp), and progressed planets among themselves (-dp). The only thing
Astrolog can't directly do is do progressed planets to transiting planets, although
that may change in a future version. :)
-dpy <year>: Like -dp but search for aspects within entire year.
Since progressed planets move so slow and only a few aspects in a progressed
chart will appear each month, one might want to instead scan the whole year. To
do this, use the -dpy switch, which takes only one parameter for the year. This
 switch is consistent in format to how with the -T and -E switches one specifies an
entire year.
-dpY <year> <years>: Like -dp but search within number of years.
Related to above, the -dp option may also be done for a range of years. Invoke the
switch as -dpY, and pass in not only the year to search within as with -dpy, but
the number of years to scan from then. For example, do display the times of all
aspects within your progressed chart for the next decade, do “astrolog -i
yourchartfile -dpY 2022 10”.
-dp[y]n: Search for progressed aspects in current month/year.
The -dp progression event search option can be invoked as -dpn to search the
current month, or -dpyn to search the entire current year. For example, if I want to
search for the exact times of all aspects in my natal chart, progressed to any time
this month, I simply do “-i mychartfile -dpn”.
-D: Like -d but display aspects by influence instead of time.
This switch will display a chart listing all aspects in effect within the chart in
question, in order by influence based on their power when transiting. This chart
focuses upon and gives precedence to aspects of outer planets with each other, as
opposed to common inner planet configurations. For example, at the time in early
January 1994 the most influential aspects in effect were the Uranus Neptune
conjunction and the Saturn Pluto square. This chart is very much like the format
of the -a aspect list chart, except that we are using the transit influences as
opposed to natal influences of the planets. The -a chart is most appropriate for a
person’s natal chart, in that the inner planets are focused upon, such as a Sun
Moon square will be near the top of the list. This -D chart is more appropriate for
times as opposed to people, since it focuses upon rare outer planet configurations.
This chart is also very similar to the -T transit influence chart, in that it shows the
aspect, orb (which may be displayed in positive/negative, applying/separating, or
waxing/waning form), and power of the event with its present orb, except that this
does influences of transiting planets among themselves as opposed to aspects to a
natal chart. If you want to see what major events are coming up, and don't want
things such as Uranus Neptune conjunctions to sneak by, use this chart and watch
the configuration gradually rise to the top of the list as its orb narrows over time.
This chart may be combined with others and is included in the -e everything
switch.
Like the -a aspect list, this chart will also print an aspect summary afterward,
listing the total and average power of the aspects, along with the count of each
aspect and the count of aspects to each planet. Like the -a chart summary, this
summary is on by default can be removed by turning off the -a0 switch setting.
-B: Like -d but graph all aspects occurring in a day.
-B[m,y,Y]: Like -B but for entire month, year, or five years.
-B0: Like -B but don't restrict fast moving objects from graph.
-V [..]: Like -t but graph all transits occurring during period.
-V[d,y,Y] [[<day>] <month>] <year>: Like -V for day, year, or 5 years.
-V[..]0: Like -V but don't restrict fast moving objects from graph.
Astrolog has a graphical transit chart, which consists of a table of transit aspects,
each aspect of which has its strength mapped over a period of time. The result
makes it easy to see when an aspect enters orb, is exact, and leaves orb. These
graphs also allow seeing cases when an aspect comes close to but never becomes
exact, which is a situation missed by charts that only display times when aspects
are exact. The transit graph comes in two forms: transit to transit, and transit to
natal. Both forms can be displayed to show aspects within a single day, a single
month, a single year, or a range of five years. (Ranges of years will respect the
“Years to Span” value in the Transits dialog, or the parameter passed to the :EY
command switch, and cover spans up to 21 years, although five years is still the
default if one selects “Range of Years” without specifying a number.) Counting
text mode and graphics mode versions of these charts, there are 2x4x2 = 16
different transit graph chart types total! The transit to transit graph is accessed via
the -B command switch, which is identical in syntax to the existing -d transit to
transit times search, including all subswitches. The transit to natal graph is
accessed via the -V command switch, which is nearly identical in syntax to the
existing -t transit to natal times search, including all subswitches. (One difference
is that -B defaults to covering one day unless the appropriate subswitch is
specified, while -V defaults to covering one month.)
The total number of different aspects that are active within the period may be
high, especially when considering fast moving objects like the Moon and
especially house cusps. Note that for graphic charts, if there are too many transits
to fit within the screen height, then later aspects will be skipped (however in the
Windows version the vertical scrollbar can be used to scroll down the list of
aspects). By default transit graphs don’t include aspects involving certain fast
moving bodies (which means when the transiting body is fast moving in the case
of -V). Graphs involving a single day will skip house cusp objects, graphs
involving a month will skip the Moon as well, and graphs involving year(s) will
skip the Sun through Mars as well. If the -B and -V switches are invoked as -B0
and -V0, then this automatic restriction won’t happen.
In text mode transit graphs, each aspect has its own row, and each character
within a row represents a time period. If the aspect is within orb at that time, then
a digit from 0-9 is placed there, in which “0” means the orb is 0-10% exact on up
to “9” which means the orb is 90-100% exact. Peaks in influence (which usually
but not always indicate when the aspect is exact or 100% within orb) are colored
white to make them stand out better. Every row will have at least one high point
marked, even if it’s on one of the edges where an orb is increasing at the
boundary. In addition, the column corresponding to the time of the chart (or to the
transiting time in the case of the transit to natal graph) will be marked with
vertical bar characters. Transit graphs also come in a graphics version (unlike the
existing transit time and transit influence charts which only have text versions). In
 the graphics mode transit graphs, each aspect has its own row, in which each row
is a mini-graph plotting the aspect’s strength over time. Peaks and high points will
be marked in white, and for the transit to transit case, the column corresponding to
the time of the chart will be marked in dark green (unless the -Xi switch modify
display setting is active). In the Windows version, whether the specific time is
marked with a vertical line can be toggled with the “Graphics / Modify Chart”
command.
-E: Display planetary ephemeris for given month.
The -E option will generate an ephemeris of the planet positions each day for the
month indicated in the given chart, as taken from the standard interface. This is
useful if you just want to see an overview of what’s happening some month in the
sky. An “r” after a planet location in the list indicates the planet was retrograde at
the time that day. For example, to see the ephemeris for someone’s birth month,
one can do the convenient “-i chartfile -E”, or to see the ephemeris for this month,
do “-n -E”. The -E switch may be combined with the -gp or -ap parallel aspects
feature to generate an ephemeris of ecliptic latitudes (or equatorial declinations if
the -sr flag is in effect) instead of the normal zodiac longitudes. When the -p
switch progressed mode is on, this will show a progression of the fixed natal chart
to the span of dates covered in the ephemeris (instead of just graphing a changing
natal chart to a single fixed progression date).
The ephemeris listings obtain the time (and time zone) to cast each day’s chart for
(e.g. noon, midnight) from the chart information given it, instead of always
defaulting to something like midnight in the default time zone. This is a bit more
flexible since one may want to specify a noon or 6:00am or whatever ephemeris
which wouldn't be possible otherwise. The -qm <month> <year> switch (see
later) always uses midnight for the time and the default for the time zone, so when
using this switch with -E, the results will be a midnight ephemeris in this default
zone. However, something like -i yourchart -E to do an ephemeris for your birth
month will display the positions each day at your birthtime instead of at midnight.
This chart will include house cusp and other fast moving objects that move
around the zodiac in a single day, if such objects are unrestricted. In such cases,
it’s important to remember that object positions in the ephemeris are only plotted
once per day, so when an object such as the Ascendant changes only a degree or
so between one day and the next, within the day the object did move around the
entire zodiac.
-Ey: Display planetary ephemeris for the entire year.
To display an ephemeris for all twelve months in an entire year, invoke the -E
switch as -Ey. For example, to get an ephemeris for all of last year, one can do “-
qy 2021 -Ey” (see -qy and -qm options below).
-EY <years>: Display planetary ephemeris for a number of years.
 The -E ephemeris list feature may also do an ephemeris for a range of years all at
once. Invoke the switch as -EY, and pass a parameter indicating the number of
years to span with the ephemeris, and it will be done, starting with the year in the
current chart. For example, to do an ephemeris for all last century from 1900
through 1999, do “astrolog -qy 1900 -EY 100”.
-E[]0 <step>: Display ephemeris times for days, months, or years.
The text mode ephemeris can specify the step rate for ephemeris output. The -E0
switch is like -E, except it takes an extra parameter specifying the “step rate”
factor of how often to display times. By default the ephemeris chart displays times
once per day, however it can also be a given number of days, months, or years.
The extra parameter should have the prefix “h” for a step rate in hours, “m” for a
step rate in months, “y” for a step rate in years, and “d” (or nothing) for a step rate
in days. For example, “-E0 h8” will output data every eight hours or four times
per day, “-E0 d2” will display positions every other day, “-Ey0 m3” will display
positions once every three months, “-EY0 1000 y10” will display positions once
every ten years. Slower ephemeris step rates are useful when displaying very slow
moving objects, such as fixed stars in the tropical zodiac or planetary nodes.
-8: Display planetary moons chart showing placements and aspects.
Astrolog has a chart which will do a planetary moons report. This is the first time
something like this has become available to astrologers! :) To display it, use the -8
command switch, or the “Setting / Planetary Moons / Moons Chart” in the
Windows version. This chart will show positions and aspects of all unrestricted
planetary moons (or all moons if they’re all restricted). If a planetary center of
body object is unrestricted, then it will be used as the position of the planet
(otherwise the standard barycenter planet object will be used).
This chart can also display the moons of Dwarf planets Eris, Haumea, Quaoar,
Orcus, and Salacia. Earth’s moon and Nodes can be included if these points are
first assigned to custom objects, and Salacia’s moon Actaea can be included if
Salacia itself is first assigned to Orcus’ object slot. For example, to display all
Dwarf planet moons at once in these charts (Eris’ Dysnomia, Haumea’s Hi’iaka
and Namaka, Quaoar’s Weywot, and Orcus’ Vanth) use the following command
line: -Yej Vul 120136199 -Yej Cup 120136108 -Yej Had 220136108 -Yej Zeu
120050000 -Yej Kro 120090482 -Yej Eri 920136199 -Yej Hau 920136108 -Yej
Qua 920050000 -Yej Orc 920090482 _R Vul Cup Had Zeu Kro Eri Hau Qua Orc.
This chart is in seven parts:
1) Moon positions: The position of each unrestricted moon is displayed in
standard geocentric coordinates (or whatever the current central body is), as well
as in planet-centric coordinates relative to the planet the moon orbits. Note
standard geocentric coordinates will have moons very close together, while the
planet centered positions can be evenly distributed around the zodiac. All planet-
centered positions will be displayed in coordinates relative to Earth’s ecliptic
(similar to how heliocentric charts are done). In addition, each moon will show its
orientation relative to its planet and relative to Earth, in two ways: (1) Leading,
ranging from +100% if the moon is ahead of the planet in its orbit (both viewed
from Earth and viewed from the Sun), to -100% if the moon is trailing the planet.
(2) Closeness, ranging from +100% if the moon is closer to or between the planet
and the viewer (both viewed from Earth and viewed from the Sun), to -100% if
the moon is behind the planet or farther away from the viewer. Because “Lead”
and “Close” measure two things perpendicular to each other, together they add up
to 100%. Values greater than 75% or less than -75% indicate the moon is
prominent, and will be highlighted in color, using the colors of the corresponding
angles. In interpretation, a “Leading” moon is somewhat similar to an object on
the Ascendant, and is a guiding influence that the planet being orbited is heading
towards. A “Following” moon is somewhat similar to an object on the
Descendant, and is a part of the planet being moved away from or that one has
much experience with. A “Close” moon is somewhat similar to an object on the
Midheaven, and is intense and obvious in its effect on the planet. A “Distant”
moon is somewhat similar to an object on the Nadir, and is subtle and internal in
its effect.
2) Planet/moon overlaps: This section displays how close moons are to being
conjunct with the planet they orbit, as viewed from Earth (or whatever the current
central body is). Because moons are very close to their planet when viewed from
other planets, these conjunctions are only displayed if they’re precise, i.e. if
moon’s disk overlaps (or almost overlaps) the planet disk’s position in longitude.
For this section, the moon and planet must be within a number of moon disk
widths equal to the normal orb allowed in degrees. If the “print nearest second”
setting is on, then the alignment percentage will be displayed (which is positive
ranging from 0% to 100% depending on the horizontal alignment, or negative
depending on how many moon disk widths the moon and planet are apart
horizontally). If the moon overlaps the planet disk in latitude too, then there’s a
transit or occultation taking place between them, which will also be indicated.
Eclipses between a moon and its planet are one of the strongest influences in
interpretation! Interpretation text for these aspects will be included if
interpretations (-I switch) are turned on.
3) Moon/moon overlaps: This section displays how close different moons orbiting
the same planet are to being conjunct with each other, as viewed from Earth. Like
section #2, these conjunctions are only displayed if they’re precise, i.e. if the
moons’ disks overlap each other in longitude, or almost overlap within a number
of moon disk widths of each other. Eclipses visible from Earth will also be
indicated, which means the two moons’ disks are aligned in vertical latitude too
and actually overlap.
4) Moon/planet aspects (planet-centered): This section displays aspects between
moons and other planets, viewed from the planet the moon orbits. If a moon is
Conjunct or Opposite the Sun, then it will be a New Moon or Full Moon as seen
from that planet. In such a case, the moon will also be planet-centric “Close” +/-
100% in section #1. Similarly, a half moon (moon Square Sun) will happen
 exactly when the moon is leading or trailing the planet in its orbit, and the moon
will also be planet-centric “Lead” +/- 100% in section #1. An aspect of moon
Conjunct or Opposite Earth will happen when the moon is closest to or most
distant from Earth, which means the moon will be also geocentric “Close” +/-
100% in section #1. To avoid too much data, this section will only show
Conjunction aspects by default (and Squares and Oppositions to the Sun to catch
moon phases), although if the “graphs include all planets” setting in the Transits
dialog is on (-B0 switch) then all unrestricted aspects will be included.
5) Moon/moon aspects (same planet-centered): This section shows aspects
between moons orbiting the same planet, viewed relative to the planet they orbit.
It’s possible for conjunctions to be eclipses or disk overlaps between the two
moons, and if so they’ll be indicated.
6) Moon/moon conjunctions (other planet-centered): This is identical to section
#5, but shows conjunctions between moons orbiting different planets. In other
words, this treats it as if the two moons were orbiting the same planet, and checks
for aspects relative to the virtual shared center point. Eclipses in this section are
still possible, however they will be “virtual eclipses”, which means they would
only be visible if the moons actually did orbit the same body.
7) Moon/planet conjunctions (overlayed): This section shows aspects between
planet-centric moons and geocentric planets. In other words, similar to section #6
this treats it as if the moon were orbiting Earth or other central object instead, and
checks for aspects relative to the virtual shared center point. As with sections #4
and #6, this will only show Conjunctions by default. Moon phases and eclipses in
this section will be “virtual”, which means they would only be apparent if the
moons actually did orbit Earth.
-80: Like -8 but compute true planetcentric positions separately.
Astrolog’s text and graphic planetary moons charts (-8 switch) may be invoked as
-80 to cast each planetcentric chart separately. This setting is also in the Moon
Object Settings dialog under the option “true planetcentric positions in moons
charts”. Normally (to have a consistent view of the solar system) a planetcentric
chart is the geocentric perspective of the planet, with the geocentric positions just
offset to that planet. With this setting, the planetcentric chart will be cast relative
to that planet, which may make planets appear slightly differently than they
appear from Earth, due to light travel time to Earth. Note that this setting only
makes a difference for apparent positions, and that if true positions are on (-YT
switch) then -8 and -80 charts will be identical. True position charts and -80
charts will be virtually identical for planetcentric positions, since most moons are
only a few light seconds away from their planet.
-e: Display all charts (-v-w-g-a-m-Z-S-l-K-j-7-L-E-P-Zd-d-D-B-8).
There are 19 main different formats of chart display available: The standard
listing of planet positions which you get without any switches or with the -v
 option, the house wheel you get with -w, the aspect/midpoint grid you get with -g,
and the charts generated with the -a, -m, -Z, -S, -l, -K, -j, -7, -L, -E, -P, -Zd, -d, -
D, -B, and -8 switches. The -e “everything” option will display the chart in all 19
of these formats for about 1250 lines and 74K bytes of text! One can even include
the -t, -T and/or -V transit options below and include a few more chart formats in
the list (however transits require a time parameter to do transits for, so they aren't
really a single chart display and hence aren't included in -e by default). Note that
when doing text mode charts, the program will display chart information (such as
date and time) above most of them, however when displaying multiple different
text charts at once, only the first chart will contain a header.
-t <month> <year>: Compute all transits to natal planets in month.
The '-t <month> <year>' option will scan the entire month specified, and print out
any transits that happen, in that month, to the planet positions as listed in the
current chart as taken from the standard interface. There will be often be quite a
few events, even though fast moving objects like the Moon aren't looked at by
default (unless specified in the default parameter file or with the -RT switch), so
you might want to use this with the -R option to limit this to just certain planets.
The times are displayed in the local time zone, and are reasonable accurate, where
accuracy can be increased by upping the value in the -d searching divisions
setting; try doing it for your birth month and your own chart - all planets should
conjunct their natal positions at about the time of your birth. To determine transits
to natal house cusps other than the Asc and MC, i.e. when does a planet change
house in your natal chart, include the -C switch described elsewhere. See the -RT
option, as well as the -YC “smart cusps” default, described later, for options
which directly affect this feature.
This transit search supports 3D house ingress, and can display when planets
change 3D houses, if the 3D houses setting is on (-c3 switch). Restricting a house
cusp object will prevent display of planets entering the corresponding 3D house,
and turning on the restrict sign change events in searches setting (-YR0 switch)
will prevent the display of all 3D house events.
Note that even transiting house cusps (and other fast moving objects like the Part
of Fortune, Vertex, and East Point) may be included in these transit to natal
searches. (To activate transiting cusp objects use the -RT switch.) This allows one
to determine the time of events such as when the Ascendant today conjuncts your
natal Sun. Note that as the house cusps travel through all 360 degrees of the
zodiac during the day, a cusp will make a transit roughly 30 times as often as even
the fast moving Moon, the Moon itself making transits 12 times as often as
planets like the Sun. So realize you may get a flood of information, and hence
probably do want to restrict all planets and aspects you’re not interested in. Note
also that to get accurate times for transiting cusp events, you probably want a high
value for the -d searching divisions setting (I recommend at least 200) which
means longer calculations.
-tp <month> <year>: Compute progressions to natal in month for chart.
 Determining dates of transits of progressed planets to natal planets can be done
with the -tp <month> <year> option. This is just like the -t option, except that the
exact aspects of progressed planets (rather than transiting planets) to the planets in
the chart are displayed. Progressions occur much less often than transits, and there
will only be a few, if any, in a given month, so one might to invoke this as -Tpy,
as described below.
-tr <month> <year>: Compute all returns in month for chart.
This switch is a quick and convenient way to compute solar, lunar, and other
returns. As a return is when a transiting object conjuncts its natal position, returns
are findable using the generic -t transit to natal search. However to only display
returns with it and not every transit, one has to restrict aspects to just the
conjunction, and restrict objects to just the one you’re interested in. (But even that
will still show things in addition to returns if more than one object is unrestricted,
e.g. with just Sun and Moon you'll still get Sun to Moon conjunctions and vice-
versa.) The solution is this return feature, which (without altering your aspect or
object restrictions any) works just like the -t switch, but displays only returns in
the transit list, i.e. conjunctions between a transiting planet and that same planet in
the natal chart.
-t[p]d: <month> <day> <year>: Compute transits for a single day.
To display transits for a single day, invoke the -t switch as -td (-tpd for
progressions), which takes three parameters for the month, day, and year. For
example, “-i chartfile -td Feb 14 2022”.
-t[p]y: <year>: Compute transits/progressions for entire year.
To display transits for an entire year, invoke the -t switch as -ty (-tpy for
progressions), which only takes one parameter, the year. For example, “-i chartfile
-ty 2022”.
-t[p]Y: <year> <years>: Compute transits for a number of years.
One may search an arbitrary number of years at once for transits. The -tY <year>
<years> switch is like the -ty <year> switch, except that -tY takes an extra
parameter for how many years to search. For example, -tY 2015 10 will search the
ten years from 2015 through 2024 for whatever transits. With a negative value for
the years to scan, it will start that many years before the given year, e.g. -tY 1999
-10000 will scan the previous 100 centuries for transits, starting with 8002 B.C.!
Note that this switch may also be invoked as “-tYn <years>”, in which case it will
start from the current year and be an equivalent shorthand to “-tY 2022 <years>”
for this year at least.
-t[py]n: Compute transits to natal planets for current time now.
 This feature is a quick shorthand way to generate transits for the current month.
For example, instead of “astrolog -i chartfile -t 1 2022”, one can do “astrolog -i
chartfile -tn”. To do transits for the entire current year, invoke it as “-tyn”.
-T <month> <day> <year>: Display transits ordered by influence.
The -T switch is a transit influence chart. Given a date, it will take the transiting
planets on that date, and determine how they interact with the generic natal chart.
The information will be printed as a list of transits, sorted in order from most
significant to least significant. For each transit in effect, the transiting and natal
planets (and the signs they are in) are displayed, along with the aspect and the orb
(which may be displayed in positive/negative, applying/separating, or
waxing/waning form). The computer computed power value of each transit will
be printed too, in which anything over 100 is a very major transit. Any transit
that’s a return, i.e. a transiting planet conjuncting the same one in the natal chart,
will be flagged with a capital “R” at the end of the line.
The things which affect how Astrolog computes the influence of a transit are: The
power of the object that’s doing the transit, e.g. transiting Pluto conjunct your
natal Ascendant is much more powerful than the transiting Moon conjunct your
Ascendant. The power of the object being transited affects the power too (but not
as much as the transiter) e.g. Jupiter transiting your Sun is more powerful than
Jupiter transiting an asteroid. Finally, the orb plays a role as well, in that a transit
that will be exact in a couple of days from the given date passed to -y is more
powerful than one won't be exact for another month. Note that the power of a
planet when transiting is different than its influence in the natal chart: Although
Sun conjunct Moon is more powerful in a natal chart than Saturn conjunct Moon,
when transiting, Saturn transiting Moon is much more influential than Sun
transiting Moon. Hence there are two lists of object influence values that can be
customized. There’s the generic list of standard influences (which have items like
Sun, Moon, and Ascendant most powerful), and a parallel list of transit influences
(which have the slower moving bodies the most powerful).
Related to the -tr switch above, the -T switch can be invoked as -Tr, which is the
same as the general transit influence chart, but will only display aspects between a
transiting planet and the same natal planet. (Note that unlike -tr it will include
aspects other than the Conjunction.)
This switch is complementary to the -t transit search list, and you may find this
one more useful. The -t chart prints the times when a transit is exact, which is
useful to know, but doesn't really help when you want to know when a transit
enters orb enough to be significant, and it won't flag a major year long transit that
will be exact next month, listing it among a bunch of less significant aspects for
the following month. With -T, you can see a major transit first enter orb at the
bottom of the list, and then slowly rise to the top as it becomes more exact
through the days. And you can answer the question as to which is more
influential: say an exact transit of Mars to a minor house cusp, or a major transit
of Saturn to an angle that’s still a month away from exactness.
 Also notice the resemblance between -T and the -r0 -a combination. Both display
aspects ordered by influence. In fact, “-i chart -Tn” will look almost identical to “-
y chart -a”, except that -T is designed and formatted for doing transits to a
particular chart. (Doing -T will generate powers using the transit influences, and
allow the transiting and natal planets to be restricted separately with -RT and -R.)
Astrolog allows transit charts to be done between transiting planets and natal
planets, as well as charts among transiting planets to themselves, both of which
can be expressed as searches for exact times, or displays of influences of each
aspect at a particular time, as summarized in the following organized list:
-t switch: Display exact times of transits to natal planets.
-T switch: Display influences of transits to natal planets.
-d switch: Display exact times of aspects among transiting planets.
-D switch: Display influences of aspects among transiting planets.
-Tt <month> <day> <year> <time>: Like -T but specify time too.
The -Tt switch is just like -T, except in addition to month/day/year parameters for
the transit influence chart date, it also takes a fourth parameter for the time within
the date.
-T[t]p <month> <day> <year>: Print progressions instead of transits.
The -T transit influence switch can also (like the -t transit search) display all
aspects between progressed planets and natal planets in influence order, if it’s
invoked as -Tp instead of just -T. This works like -T in every way except that a
switch combination like “-i mychart -Tp 12 31 2022” will display aspects between
my natal planets, and those in my natal chart progressed to the end of the year,
and their influence and orbs at that time, instead of between my natal planets and
the actual positions of the planets at that time.
-T[p]n: Display transits ordered by influence for current date.
The -Tn switch is a shorthand way to pass the current date today and time now to
the -T switch. If you want to see what transits are most affecting your natal chart
presently, just do “-i yourchart -Tn”.
-P [<parts>]: Display list of Arabic parts and their positions.
Astrolog has the ability to display the positions of 177 Arabic parts or lots. The
“ARABIC” compile time option in astrolog.h may be commented to leave this
feature out if you don't want it. Display a chart with the -P switch to show each
part and its position, one per line for the chart in question. The listing contains
five columns: First is the name of the part, which is usually called in full “The
Part of <name>”. Second is its position in the zodiac (which will be shown to the
nearest arc second when the -b0 setting is active). Third is the house the location
appears within.
 Fourth is the formula used to compute the part, given so one knows what the
program is doing and to aid in interpretation. The formula is expressed in the form
<term1> - <term2> + <term3>. Also included is a flag indicating whether the
formula should be flipped for night births (which means charts where the Sun is
below the horizon or in houses 1 through 6). For night charts where the flip status
is “Y”, the real calculation done is <term1> + <term2> - <term3>. Each <term>
consists of an “object” plus a “modifier”. The object is usually given as the
abbreviation of a planet, or it may be a number from 1 to 12 indicating that house
cusp. The object may also be “For” or “Spi” meaning it’s the position of the Part
of Fortune or Part of Spirit, or it may reference an actual degree in the zodiac. The
modifier indicates how to get the actual position of the term from the object. It’s
usually blank meaning the term is just the position of the object. It may be “H”,
meaning the term is the location of the house the given object is in; it may also be
“R”, meaning the term is the location of the planet ruling the house the given
object is in; it may be “D”, meaning the term is the location of the planet that’s
the dispositor of the given object, i.e. ruler of its position; or it may be “+”,
meaning the term is 10 degrees beyond the position of the given object.
The last column is the “type” of Arabic part. Most parts are normal psychological
indicators like the Part of Fortune, and don't have anything listed here. Seven
parts reference elements and weather and are used for charts cast at the time of
equinoxes, solstices, and New and Full moons, and are indicated by “Event”. 21
parts reference crops and are parts used in the commodities market for
prognostication, and are indicated by “Comm”. Finally 16 parts are specially used
for Horary questions and are indicated by “Hora”.
The -P switch accepts an optional parameter to indicate how many of the Arabic
parts to show. When given, only the first 'n' parts will be displayed. As the special
part types are shown after all the standard ones, this may be used to restrict parts
you don't care about. For example, “-P 161” will leave off the horary parts, “-P
140” will leave off the horary and crop parts, and “-P 133” will leave off the
horary, crop, and event parts. Related to this, standard -R object restrictions will
affect the parts shown. If a planet is restricted, than any parts referencing it in its
formula will be left out.
This chart has an option to, for each part, display a list of aspects from
unrestricted planets to it. This is similar to how the -m midpoint list chart can
display aspects to midpoints, and as a result the “text midpoint list includes
aspects to midpoints” chart setting (-ma switch) will affect the Arabic parts chart
too.
-P0 [<parts>]: Like -P but display formulas with terms reversed.
If the -P switch is invoked as -P0 (or -Pz0, etc) the output will be identical to
before, except that the formula column will exchange the positions of the second
and third terms, i.e. instead of showing as <term1> - <term2> + <term3>, -P0 will
show <term1> + <term3> - <term2>. This isn't too useful in itself, unless
combined with -Pf below, where -Pf and -Pf0 sort differently giving different
 terms priority. Here’s how to conceptualize formulas: if the planets were rotated
through the zodiac so that object2 is at the position of object1, then the new
position of object3 is the part. For example, with the Part of Fortune being Asc -
Sun + Moo for daytime charts, if you rotate your chart so that the Sun is on the
Asc, then the Moon’s position is the POF, Mercury’s position is the Part of
Commerce, its formula being Asc - Sun + Mer, and so on. The default -Pf sorting
allows one to easily see, if one rotates this planet on the Asc, what parts indicate
the positions of the other planets. The -Pf0 ordering allows one to easily see,
where is the position of a particular planet, after all rotations where some other
planet is on the Asc.
-P[i,z,n,f]: Sort parts by index, position, name, or formula.
As with the fixed stars, the Arabic part listing may also be sorted in various useful
orders. The -Pz switch will set the sort order for -P to be in order of zodiac
position, with parts in Aries first and Pisces last. The -Pn switch will sort parts by
name, with the part of Accomplishment first and Worldliness last. The -Pf switch
will sort by formula, in which the ordering reflects the contents of each term, with
Ascendant and early planet terms first, and cusp and other special ones last.
Finally, the -Pi switch will sort by default index, which groups parts by category.
Note that regardless of the ordering, passing a value to -P will still leave off the
same parts as in the standard display. Especially with -Pz and -Pf, notice that
several parts may have the same position. Some formulas differ only in their night
flip flag, meaning they will be the same for day charts, while a few parts of
different category types can even have the exact same formula.
-N [<rows>]: Lookup chart location as city in atlas.
Astrolog has an atlas, allowing one to easily lookup the longitude and latitude of
cities. This switch will look up the current city (as set in the second parameter to
the -zi switch, or the “Location” field in the Chart Info dialogs). By default up to
the 22 best matches are displayed, although the switch takes one optional
parameter for how many rows to potentially display, which may range up to 200.
You can specify just a city name, or use a comma to combine with a
country/region name or its two letter abbreviation, to restrict search to just that
region. For USA and Canada, states and provinces may be specified instead of or
in addition to the country. City names will match substrings, which will be ranked
in an appropriate manner. For example, if you lookup the city “Eden”, the exact
match “Eden, NC” will be first, followed by the subword exact match of “Eden
Prairie, MN”, then the substring match at the beginning/end of a word in
“Edenvale, Germany”, and finally the substring in the middle of a word
“Redencao, Brazil”.
-Nl [<rows>]: Display nearest cities in atlas to chart location.
 This switch will display the nearest cities to the current longitude and latitude
coordinates. By default the 22 nearest are displayed, although the switch takes one
optional parameter for how many rows to display, which may range up to 200.
-Nz [<rows>]: Display all time changes in time zone of chart city.
This switch will display all time changes for the time zone area corresponding to
the active chart’s city (as set in the second parameter to the -zi switch, or the
“Location” field in the Chart Info dialogs). If that string doesn’t match anything in
the atlas, then time changes in all time zones will be output instead, for a
complete output of Astrolog’s worldwide database. This chart will display every
time change to or from Daylight Time, as well as occasions when the time zone
offset itself for the location changes. This will range from the first date when the
location started using a standard time zone (which will be no earlier than 1847
when GMT was introduced). The list will run until 2025, or five years after the
chart’s date (whichever is later, but never later than 2080). Time changes will be
printed one per line, listing the date and local time at which the time changes,
along with how the time zone offset changes and how much the local clock time
changes.
-I [<columns>]: Print interpretation of selected charts.
The -I interpretation option is an extensive feature to generate interpretations of
many of Astrolog’s charts. Simply include the -I switch to enter a mode which
shows an interpretation of any particular type of chart that the program would
display otherwise. If Astrolog doesn't support interpretations for it, the normal
chart will be shown instead.
For example, a brief interpretation of the meaning of the positioning of each
planet in its sign and house is supported when the -I switch is invoked with -v (or
by itself since -v is the default). If one does this, then instead of the standard -v
listing of planet positions, the positions will be listed with a brief interpretation of
what they mean. This is a pretty limited version of interpretation, being little more
than a combining of phrases representing the planet, sign, and house in question.
Nevertheless, those who aren't experienced with interpreting charts might find this
to be of use. These interpretaions will include adjustments for retrogradation,
decanate placement, exaltations, and rulerships (assuming standard, esoteric,
Hierarchical, and/or Ray based rulerships are enabled).
Another common interpretation one would want is the ability to give a brief
interpretation of each aspect in the aspect grid. When the -I switch is combined
with -g, the standard -g aspect grid will be replaced with a list of each aspect
occurring and a brief listing of what it means. Again, this is mainly just a lookup
of the general meanings of each planet and the aspect in question, but still might
be found of interest. (Note that only the first 11 aspects, out to the Biquintile, have
interpretation text, unless one adds their own for the others.)
 Synastry relationship charts may be interpreted too, with the -r -I combination.
Actually, they could be technically interpreted without any special code, since the
output of a synastry chart is a technical “chart” with planet and house positions,
but it would just be an interpretation of Person2’s planets in Person1’s houses as
if that were a natal chart. This interpretation feature recognizes charts generated
with -r as synastry charts and interprets them appropriately. For each of Person2’s
planets, the interpretation of how and where it affects Person1 is displayed.
Other interprations can be done too: “-r0 person1 person2 -g -I” is a legal
combination, and will display meanings of aspects between planets in two charts
in a relationship aspect grid. “-i person -a -I” is legal, and will display the
meanings of aspects in a chart; this is like -g -I, but the aspect meanings are
printed in sorted order based on how powerful Astrolog thinks each aspect is, so
this is probably more useful. “-r0 person1 person2 -a -I” is legal, and will display
the meanings of aspects in a relationship aspect list, like -r0 -g -I, but in the
improved sorted order. “-L0 -I” is legal, and will interpret the meaning of each
latitude crossing in the text mode astro-graph chart. “-d -I” is legal, and will
display the meanings of aspects among transiting planets occurring during a day,
as well as of sign and direction changes. “-t -I” is legal, and will display the
meanings of aspects from transiting planets to natal ones. “-T -I” is also legal, and
will display the transit interpretations in sorted order by influence. “-m -I” is a
legal combination, which will do an interpretation of a midpoint chart, printing
each midpoint in the same order as without the -I, but with each midpoint as an
interpretation sentence instead. Relationship midpoint charts may be interpreted in
the same manner using the “-r0 person1 person2 -m -I” combination. Finally, “-8
-I” is a legal combination, and will interpret Astrolog’s planetary moons chart,
specifically interpretations for the aspects moons make, as well as interpretations
for the meanings of moons in prominence zones, i.e. moons that are leading,
following, close, or distant from their planet.
In displaying interpretation text, the program will use the name or title field of the
chart (exactly as entered by the user or as passed to the -zi switch) when referring
to a person. If this field is empty, the program will use the generic labels “this
person”, “person1”, or “person2” as appropriate. Also in interpretation text, the
“Fortune” object will be displayed with its full name “Part of Fortune”, and
similarly the asteroid “Pallas” will be displayed with its full name “Pallas Athena”
(unless one has used the -YD switch to change the name of those objects).
This interpretation toggle switch accepts an optional parameter to specify the
number of screen columns in which to format the interpretation paragraphs, i.e.
what column to break lines at when formatting and printing. One may change this
from the default of 80 to accommodate narrower or wider screens or printers.

Switches which affect how the chart parameters are obtained:

-n: Compute chart for this exact moment using current time.
 For those with systems who can handle time calls (If your system errors on trying
to compile them, simply comment out the #define TIME line at the beginning),
the program supports displaying the chart for the time at the current moment. In
other words, invoke as astrolog -n and see where the planets are right now. (This
is fun, in which the house cusps change one minute about every four seconds!)
You will need to change the #defines for the default longitude and latitude in
astrolog.h, or else specify where you are explicitly by using the -zl switch to
change the default location. To figure out the time zone, the program uses the
default value in the [Link] file or as defined in the DEFAULT_ZONE
constant set at compile time.
Note that the default time zone setting or passing values to -z, won't affect the
positions of the planets, which is expected since they are where they are “now” no
matter how time is expressed. The default zone is merely used to determine what
to express the local time to when displaying the current time. It is important
however to realize that the time zone setting on your system can affect the actual
raw time the program gets internally for “now”. If the -n switch seems to always
generate times an hour or more off to what you have your time zone set to, it’s
likely that your time zone environment variable is uninitialized or set incorrectly.
You will need to set the “TZ” environment variable, setting it to a value such as
“xxxnyyy”, where 'n' is the hours your zone is before UTC/GMT, 'xxx' is a three
character string indicating the abbreviation of the zone (required, but doesn't need
to be set to anything more than 'xxx' if you prefer) and 'yyy' is the abbreviation for
the zone when/if ever in Daylight Time. For example, if running Astrolog on a PC
in Eastern Time, put the line “set TZ=EST5EDT” in your [Link] file.
Another way to correct your “now” charts if they always seem to be off by a
certain number of hours is to use the -Yz switch (described later).
-n[d,m,y]: Compute chart for start of current day, month, year.
These switches are like the -n generate chart for current moment now feature,
except that they will respectively generate charts for the midnight on the current
day, midnight on the first of the current month, and midnight on the first day of
the current year. The -n switch can also be invoked with subswitches to set other
chart slots, for example -n2 will set chart slot #2 to the current moment now, and -
nd3 will set chart slot #3 to midnight on the current day.
-z [<zone>]: Change the default time zone (for -d-E-t-q options).
The -z <value> option can be used to change the default time zone to the value in
question. For example, you can force the -E ephemeris and -t transit lists to be
displayed at midnight UTC/GMT time instead of the local time with “-z 0”. If
Daylight time is in effect, you should set the separate Daylight time default
below. Note that one can technically get by without changing the Daylight setting,
by subtracting one from the time zone itself, e.g. for EST where the time zone is
“5”, you can do “-z 4” or “-z EDT” during Daylight time to properly display
transits, aspects in day, and other lists in the local DST zone.
 Normally the -z switch takes an argument which will then become the default
time zone. If one, however, invokes it by itself, it will subtract one hour from
whatever the default time zone presently is. This is useful since it is equivalent to
adjusting any times printed to Daylight time, i.e. it will add one hour to any times
displayed. Again, this is archaic as it’s better to just use the -z0 switch below.
Without the -z0 setting, when entering the birth time for charts, one would have to
subtract one hour if Daylight time were in effect, or subtract one hour from the
time zone which will do the same thing. For example, over here on the West
Coast, I have my default time zone compiled to be “8"; when Daylight time is in
effect here, I can do -z 7 or just -z to decrease the default time zone when I make
say a -t transit list, which will in effect add one hour to the local times displayed,
or in effect “Spring ahead” the clock for me. (For a better way of adjusting
Astrolog for Daylight time without having to specify -z all the time, recompile the
program, or add one hour to times in your head, use the “defaults” file described
later to edit the default time zone or the Daylight setting.) Remember that the -z
(and -zl) switches should be before any other switches they modify (such as -n) in
order for the new default to take effect.
-z0 [<offset>]: Change the default Daylight time setting.
This switch sets the contents of the default Daylight time setting, and sets the
value in the current chart as well, taking one optional parameter. When present
the parameter will be used for the Daylight hour offset, which will almost always
be 0 or 1, but can technically be set to something else for Daylight offsets that
“Spring ahead” amounts other than one hour. When omitted, the -z0 switch will
toggle the Daylight setting on and off between 1 and 0. In addition to “0” and “1”,
this switch also accepts “n” and “y” (for “no” and “yes”) as parameters.
The -z0 switch will also accept “autodetect” (which may be abbreviated as “auto”
or “a”), in order to compute whether Daylight time is on or off at the current
moment. This allows charts for “now” to automatically use Daylight time when
the computer’s internal clock is using it. For example, an animation continually
updating to the current moment will change to or from Daylight Time at the
second the annual switchovers take place. Without this option one would have to
manually change this switch in their default settings file twice a year.
-zl <long> <lat>: Change the default longitude & latitude.
Similar to the -z switch, the -zl option can be used to change the default compile
time world coordinates used in certain options, such as the -n cast chart for right
now switch. Note that both the -zl default longitude and latitude, and the -z
default zone switches affect the time and location of the current chart in memory
in addition to the default setting. Confusion could result otherwise if changing a
default after chart info was already obtained, e.g. “-z -n” would be different from
“-n -z”, where the latter wouldn't change the zone for the chart because it was
seen after the -n was processed and the old zone used. The correct thing will
happen regardless of ordering. This means you can easily do a relocated chart
 with this -zl switch, e.g. “-i yourchart -zl 122W19:59 47N36:35” will cast your
chart relocated to Seattle.
-zv <elev>: Change the default elevation above sea level.
The default elevation used in topocentric charts may be specified with this switch.
Elevation above sea level can be expressed in meters (with an “m” suffix) or feet
(“ft” suffix). Note that this is a global setting, so affects all charts. To fully
support topocentric astrology, the standard interface for specifying time and
location should also ask for elevation above sea level (although that piece of
information would of course be unnecessary for standard non-topocentric charts).
As an example, changing from sea level to the top of Mt. Everest (29028 ft, or
8848 m) can change the topocentric position of the Moon by up to four arc
seconds.
-zf <temp>: Change default temperature for atmospheric refraction.
The default temperature to use for a chart when applying atmospheric refraction
may be specified with this switch. Temperature can be specified in degrees
Celsius (the default or by including a “C” suffix), or in degrees Fahrenheit (by
including an “F” suffix). Note that this is a global setting, so affects all charts. To
fully support refraction, the standard interface for specifying time and location
should also ask for temperature (although that piece of information would of
course be unnecessary for standard charts).
-zj <name> <place>: Change the default name and place strings.
The default name and location strings used for charts (most commonly for “now”
charts) may be specified with this switch.
-zt <time>: Set only the time of current chart.
This simple switch will set the time and only the time of the current chart in
memory to the given value. For example, to cast a chart for 3:00pm today, do “-n
-zt 3:00pm”. Without this one would have to cast a whole new chart using the -q
switch and respecify the month, day, and year. Note that placement of this switch
is important, as any other switch after it which also sets a time will clobber the
setting, e.g. “-zt 3:00pm -i chartfile” will be the same as just “-i chartfile” because
the file has its own time value.
-zd <day>: Set only the day of current chart.
This is just like the -zt switch above except that it takes one parameter for and sets
the day of the current chart. For example, to see the aspects taking place on the
15th of the current month, do “-n -zd 15 -d”, which does the chart for the current
month and year but the day scanned is the 15th instead of the current day.
-zm <month>: Set only the month of current chart.
 This simple switch will set the month and only the month of the current chart in
memory to the given value. For example, to display an ephemeris chart for July of
this year, do “-n -zm July -E”.
-zy <year>: Set only the year of current chart.
This is just like the -zm switch above expect it will set the year and only the year
of the current chart in memory to the given value. For example, to display a chart
for your birthday next year, do “-i yourchart -zy 2022”.
-zi <name> <place>: Set name and place strings of current chart.
This switch sets on the command line the contents of the name and city string
fields of the current chart. Note that this switch is actually put into present style
chart info switch files generated with -o to reload the name fields. You can
convert an old style file created before version 4.20 to new style and add in the
name fields for it with: -i file -zi "the name" "the city" -o file. (Note that you may
also want to correct the time or time zone if Daylight time was in effect though.)
-zL <city>: Lookup city in atlas and set location in current chart.
This switch will set the chart longitude and latitude based on the specified city’s
coordinates in Astrolog’s atlas. It’s like the -zN switch, although that switch also
sets the time zone and Daylight fields of the chart.
-zN <city>: Lookup city in atlas and set zone, Daylight, and location.
Astrolog can do time zone detection (including whether Daylight Saving Time is
in effect or not) for any date/time at any location in the world. This switch takes
one parameter for a city name, and will automatically look it up, and apply to the
chart info the atlas coordinates, time zone, and whether Daylight Time is in effect.
This switch will look at or take as “input” the current chart date and time fields,
and as “output” will set the current and default chart location, time zone, and
Daylight Time fields. For example, “astrolog -qt Feb 14 2022 1:09pm -zN
Seattle” is a quick way to do a chart for that city given the date and local time.
-q <month> <day> <year> <time>: Compute chart with defaults.
The -q <month> <day> <year> <time> option takes the four parameters and casts
a chart for the time in question. The time zone and location are taken from the
default compiled values. This is just another useful shorthand way to quickly
make a chart. Note that the -qa option which takes all seven chart parameters can
be duplicated with -q along with the -z <zone> and -l <long> <lat> options.
-qd <month> <day> <year>: Compute chart for noon on date.
The -q <month> <day> <year> option can be used to cast a quick chart for 12
noon on a particular date, using the default longitude and latitude, and time zone.
One example where this is useful is with the -d option, e.g. to see the times of
exact aspects on a particular date, like your next birthday, your finals, etc, without
 having to specify unnecessary data. Note that this is just like the -q switch except
that -q requires a specific time on the day in question as well.
-qm <month> <year>: Compute chart for first of month. -qy <year>: Compute chart for
first day of year.
A quick chart cast for midnight on the first of a month can be generated with the
two parameter -qm <month> <year> switch. A chart cast for midnight on the first
of January of a year can be generated with the one parameter -qy <year> switch.
Both of these use the default time zone and location. These switches are most
useful for charts that don't require all the standard information. For example, to
get an ephemeris for December 2022, do “astrolog -qm 12 2022” and avoid
having to enter in a day, hour, or location that wouldn't have any effect. These
options are in similar to the -qd <month> <day> <year> switch above that will do
a chart for noon on the given date, and the -q <month> <day> <year> <time>
switch that takes a time as well.
-qa <month> <day> <year> <time> <zone> <long> <lat>: Compute chart
automatically given specified data.
Normally one generates a new chart by entering the data coordinates interactively.
A fast typist familiar with the program might prefer to give all the info at once,
which can be done with this option. Simply list the seven parameters above, in the
exact format as they would be given to the program were the user being prompted
for them. (Note that it’s probably better to use the -qb switch below because of its
extra parameter; the -qa switch will automatically assume Daylight time is off.)
-qb <month> <day> <year> <time> <daylight> <zone> <long> <lat>: Like -qa but
takes additional parameter for Daylight offset.
This switch is just like the -qa switch above except that it takes one extra
parameter for the Daylight Saving time flag. In order, the eight parameters for -qb
are Month, Day, Year, Time, Daylight offset, Time Zone, Longitude, and
Latitude. (Like -zi this switch is also put into chart info files by -o.)
-qc <mon> <day> <year> <time> <dst> <zone> <long> <lat> <name> <city>: Like -
qb but takes additional parameters for name and city.
This switch is just like -qb above, except it takes 10 parameters to fill out all
fields of chart information, including name and location strings. (It’s like a
combination of -qb which sets the eight pieces of data, and -zl which sets name
and location.) When saving a chart list to Astrolog’s own chart list format, the file
will consist of a sequence of -qcl switches, which when loaded back in will define
the complete sets of chart information and append them to the chart list.
-qj <day>: Compute chart for time of specified Julian day.
This switch will automatically cast a chart for the given Julian Day. Unlike the
other -q switches which take standard months, days, and years, this switch takes
 one parameter for the Julian Day (which may be fractional to specify a time
within the day in question). For example, another way to cast a chart for
Midnight, UTC, on New Year’s day of 2018 is with “-qj 2458119.5”. (Julian Day
0 refers to Noon UTC, January 1, 4712 BC.)
Note: If the Swiss Ephemeris and Placalc ephemeris files are turned off, and only
the ancient Matrix formulas are being used, then the program will have to use an
older version of the Julian day conversion routines which will result in these -qj
charts giving incorrect results for dates in the Julian Calendar, i.e. before October
1582. This can be seen by casting a chart with -qj specifying a day less than
2299161.5, in which case the Julian Day displayed for the date of the chart cast
will be ten days greater than what was passed to it.
-qL <index>: Compute chart based on index within chart list.
This switch will do the reverse of -ql, and will copy a chart from the chart list into
the main slot to be displayed. In other words, it casts a chart based on the
specified index in the chart list. (Indexes start with 0 for the first chart in the chart
list.)
-ql [..]: Like -q but also append chart info to chart list in memory.
If the -q switch is invoked as -ql, it will behave as before, except the chart
specified will also have its information appended to Astrolog’s chart list. For
example, -qyl 2022 will load the chart for the start of the year 2022 into slot #1,
and also append that chart to the chart list.
-i <file>: Compute chart based on info in file.
This loads a file into the program. It can be any Astrolog file saved with the -o
option, as well as several external file formats that Astrolog also supports. See the
-o option below for details.
Astrodatabank import: Astrolog can import Astrodatabank format files.
This format stores multiple charts, and so will populate Astrolog’s chart
list (and the last chart read will be put into chart slot #1, so a file
containing just one chart is immediately displayed). These are XML
format files with an advanced schema containing records for a variety of
astrological data, although only fields corresponding to Astrolog’s chart
information fields will actually be read in. Files are recognized as
Astrodatabank format because their first character is “<” for a HTML-like
tag. The Astrodatabank can be viewed online at
[Link] and the actual Astrodatabank XML
itself (of which the full database currently contains 69230 charts in a large
200MB file) can be downloaded from: [Link]
Solar File import: Astrolog can import text files created by astrology
program Solar Fire. This format stores multiple charts, and so will
populate Astrolog’s chart list (and the last chart read will be put into chart
 slot #1, so a file containing just one chart is immediately displayed). This
doesn’t mean the actual Solar Fire file binary format which has the
“.SFcht” extension. Instead, Astrolog can import Solar File’s text file
export, which is created in Solar File by doing “File / Open / Chart
Database / Send/Add / Email All Charts”. Make sure “Attach chart file to
email” and “Text File” are turned on, and “Include chart comments” and
“Include life events” are off. The human readable “[Link]” attachment
produced is what can be loaded in to Astrolog, which is a quick way to
transfer a Solar File chart database into Astrolog. Files are recognized as
Solar Fire export format because their first line is blank, followed by
records for each chart which are lines for name, time, and location,
separated by blank lines.
Note that specification of Astrolog command switch files doesn’t require the
default “.as” extension. For example, “-i mychart” is equivalent to “-i
[Link]”, and the program will check both names before saying a file doesn’t
exist.
If the program is invoked with a single parameter that doesn’t look like a
command switch (e.g. “astrolog [Link]”) and that parameter exists as a file, then
the command line will be converted to a parameter being passed to the -i switch
(e.g. “astrolog -i [Link]”). This is not only a convenience, but is also needed
internally because the Windows “Open” verb is implemented by launching the
program and passing it the file as a parameter.
Note that there is a “virtual file” named “set” which can be passed to the -i and -r
switches. Instead of looking for an actual disk file, this represents the “last” set of
chart information dealt with, and is useful to avoid having to manually enter
information in certain cases. (Other “virtual files” Astrolog can use are “now”
which means the current time at the default location, and “tty” which means
prompt the user for the info.)
This is best used within a -Q loop. For example, you first manually enter
the time for a chart and it’s displayed. Now, this time in the loop, you
want the same chart in an aspect grid, and don't want to have to enter the
data again or create a file to read from. Entering “-i set” will use this chart
info no matter how it was entered. For graphics charts this “last” chart will
be set to the initial chart or whatever animation situation was saved via the
'o' key. Perhaps the most useful ability of the “set” chart however is that it
will set itself to times that appear in -t and -d transit and aspect in day
searches. For example, if you want to cast a chart for the New Moon this
August, first do a combination like “-qd Aug 27 2023 -d -R0 Sun Moo -A
1”, which will scan the 27th for Conjunctions involving the Sun and
Moon, and display the time. Before, to get a New Moon chart one would
then have to manually specify the time displayed. Now, just “-i set” will
bring it up!
 The initial contents of the “recall” chart, i.e. what you get by directly
doing something like “astrolog -i set” are initialized to the astrological
“chart” for the release of this version 7.60 of the program itself,
specifically for the Moon Venus Opposition (that’s also a total lunar
eclipse or occultation when viewed from the Moon or Venus) at
[Link]m PST (8 hours before UTC) on Sunday, April 9, 2022 for
Seattle, WA (122W19:55, 47N36:22).
This is one more “virtual file” that’s obscure and only useful in certain
circumstances, named “nul” which may be passed to the -i file input or -r
switches which take chart info files for parameters. The file “nul” means
to not change the chart info parameters any, but rather leave them with
whatever current settings they may have or were set to before. This is
mainly useful with the -r switches if you don't want to have to create two
actual files to pass in, or use the virtual file “tty” and have to enter in data
interactively. For example, to see what your biorhythm is like for the
beginning of December, do “astrolog -qm 12 2022 -rb nul [Link]”
on the command line and no further input is needed.
-i[2-6] <file>: Load chart info into chart slots 2 through 6.
If the -i chart file load switch is invoked as -i2, it will do the same thing as -i
except put the chart info into the second chart slot, for use with relationship
charts. This does not enter or leave any relationship chart mode. One can set what
chart info each wheel ring in the tri-wheel and beyond charts will contain by
putting a number after the -i switch to load the chart info from a file into that slot,
in which -i3 will load into the third slot, and -i4 into the fourth, and so on (-i2 will
again load into the second, and -i1 or just -i into the first). One can also do -it to
load into the transiting time (which is normally set by parameters to transit chart
selection switches such as -t, -T, and -V), and do -is to load into the “recall” chart
slot (which is normally looked at as an input parameter, namely the “virtual file”
named “set”).
There are special virtual files named “__1” through “__6” which represent the
current contents of the six chart slots, which can be passed to this and other
switches that read in chart files. These virtual files can be used to copy chart
date/time fields. For example, the command switch “-i2 __4” will copy the
contents of chart #4 to chart #2. There’s an additional virtual file named “__t”
which represents the transiting time.
Astrolog assumes the Gregorian calendar when inputting and displaying dates
after October 15, 1582, and the Julian calendar for dates before then. In obscure
cases, one might want the Julian calendar in effect later or the Gregorian calendar
earlier. The -ig switch is like -i, but will read chart data into variables which
indicate the date to use for the start of the Gregorian calendar. The virtual file
“__g” can be used to access the current crossover date. For example, “-qd Mar 1
1700 -ig nul” will have the Gregorian calendar start on March 1, 1700, as it did in
Germany.
 Note that all the other chart indicators in the -i switch may be used with -q too.
For example, the -q2 switch is like -q, except instead of directly setting the chart
information in the active chart, it will directly set the information in chart slot #2.
-il <file>: Like -i but also append chart info to chart list.
If the -i switch is invoked as -il, it will behave as before, except the file loaded
will also have its chart information appended to Astrolog’s chart list. For
example, -i2l <file> will load the file into chart slot #2, and also append that chart
to the chart list.
-id <dir>: Open all chart files in directory into chart list.
Before version 7.40, Astrolog always stored every set of chart information in a
separate file. Some may have directories containing hundreds of Astrolog chart
information files! Astrolog can read a directory, and open every *.as extension
file within it into the program’s chart list. (This will automatically skip the special
Astrolog files [Link], [Link], and [Link] if present.) Select a directory
to open with the -id switch (or in the Windows version with the “File / Other
Formats / Open Charts in Folder” menu command). If the -Yo old file format
switch is in effect, then Astrolog will open every single file in the directory
(which should be used with care, since it will produce errors if files other than
Astrolog chart information files are present in that directory).
-o <file> [..]: Write parameters of current chart to file.
The program supports directing chart information to, and reading output from,
data files. The '-o' option will dump all the birth data (the date and location, not
the planet positions) to the specified file. The '-i' option will cast the chart based
on the info in the file. (This allows you to put your birth data into a specific file,
and cast your chart whenever you want to after that without having to reenter your
birth data all the time.) Note that double quote characters in the name or location
fields will be converted to single quotes when saved.
Another file output feature, the ability to concatenate “comment lines” at the end
of a data file, is included with both the -o and -o0 options, as you may wish to say
keep track of info other than the program supported name and city. After scanning
the filename, the -o[0] option will then write any parameter that follows it at the
end of the file, until a parameter beginning with a '-' or '/' (the next obvious
command switch) is reached. For example: -o <file> "Birth certificate" Family,
will add extra info indicating the source of my birth data, and a general category
for the chart, in two separate lines at the end of the file. (On most systems, quotes
can be used to allow spaces within one parameter.)
-o0 <file> [..]: Like -o but output planet/house positions.
Ability to write the actual sign and house positions of a chart to a file (instead of
just the time and place) has been implemented via the -o0 <file> option. This
option can be used interchangeably with the -o output to file switch. The
 information written includes the zodiac position of all unrestricted objects, their
retrograde velocity, latitude, and distance, as well as the positions of the house
cusps. (The chart name strings as set with the -zi switch are written out too of
course.) This file information can easily be passed into another program, and can
be read back into Astrolog with the -i option. The -i option will automatically
determine which type the file is, and will either use the given positions, or else
calculate them as needed. (Note that some switches, such as the -c house system
selection, will have no effect for this file type.) Check an example of one of these
files to see the precise format (a zodiac position is recorded as three numbers:
degree in sign, sign as number 1 through 12 or three letter abbreviation, and
floating point minute within the degree.) When the files are read back in, they will
be flagged as “having no space or time” like the composite charts in the chart
header displays.
This file format can allow one to do things such as transits to composite charts
(send the composite chart to file with -o0 option and then read in the file with -i
when using the -t switch) composites between two composite charts (use -rc
between two composite charts sent to a file) and even, if one is willing to do a
small amount of editing, to do transits to midpoints or the 0 degrees Aries point.
Note that one can easily edit the positions in the -o0 position file to be whatever
they like, so one could replace some unimportant object (e.g. the Vertex) with 0
degrees Aries or an important midpoint value. Note that trying to still use the -o
time and space output with a chart in memory that doesn't have time/space will
output the time/space of the most recent chart data used.
Note for old style -o0 position files created before version 4.20 that aren't based
on command lines (see -Yo switch later): the positions of the eight Uranians may
be output to those planet position files in addition to the 20 main objects, but only
if the Uranians are actually calculated with -u in effect. Hence those position files
can be of two different lengths, but the program will be able to read in both
formats, leaving the Uranians uninitialized at 0Aries if they aren't also in the file.
-ol <file>: Write current chart list to Astrolog chart list file.
-oa <file>: Write current chart or chart list to AAF format file.
Astrolog supports the Astrological Exchange Format for storing chart information
(abbreviated AAF, which stands for “Astrologisches Austauschformat” in
German). This is a sharable text format designed to allow different astrology
programs (which usually have their own private file formats) to read each others’
data. The -oa switch will save the current chart information to this format, and in
the Windows version the “File / Other Formats / Save Chart Exchange” command
will save it. The -i command switch and the “File / Open Chart” command in the
Windows version will recognize this format too. (If a file starts with the “#”
character then it’s considered an AAF file, otherwise it’s one of Astrolog’s
standard script files.) Note that you can load an Astrolog chart info file (e.g.
“[Link]”), save it as AAF, load that AAF file, resave as “[Link]”, and
get the original file back. The [Link] site can show saved charts in
 AAF format, if you click the “aaf” button in the “Stored Astro Data” section of
your profile. Once there, you can simply select the two lines of AAF text for a
chart, copy it to the clipboard, and do “Edit / Paste” in Astrolog as a quick way to
display an [Link] profile chart in Astrolog.
Astrolog can also import multiple charts at once that are stored in the Astrological
Exchange Format. A sequence of AAF records in the same file will be loaded into
Astrolog’s chart list (and the last chart read will be put into chart slot #1, so a file
containing just one chart will still be immediately displayed). For example, on
[Link] site you can select the lines of AAF text for one or more
charts, copy it to the clipboard, then do “Edit / Paste” in Astrolog for a quick way
to transfer all your [Link] profile charts into Astrolog.
-oq <file>: Write current chart list to Quick*Chart format file.
Astrolog supports the Quick*Chart format for storing chart information. The -oq
switch will save the current chart information in this format, and in the Windows
version the “File / Other Formats / Save Chart Quick*Chart” command will save
it. This format stores multiple charts, so if the chart list is present it will be saved,
otherwise a length one list consisting of just chart slot #1 will be saved. These
files can be loaded into the program too with the -i command switch or the “File /
Open Chart” command in the Windows version, and such files can even be pasted
in from the Windows clipboard. On import, the charts present will populate
Astrolog’s chart list (and the last chart read will be put into chart slot #1, so a file
containing just one chart is immediately displayed). This file format usually has
the “.qck” extension, and contains a simple text list of charts in fixed width fields,
with each line containing 100 characters. Files are recognized as Quick*Chart
format because their lines are always 100 (or sometimes 101) characters long.
-od <file>: Output program's current settings to switch file.
This switch will output program settings to the specified file, or in other words
generate the contents of [Link]. It duplicates the effect of the “File / Save
Program Settings” menu command in the Windows version.
-os <file>, > <file>: Redirect output of text charts to file.
This switch, given a file, will output the contents of a text chart to that file. This is
just like output redirection (i.e. “> textfile” at the end of a command line) except
that it’s implemented within the program. Hence unlike output redirection it will
work from within a -Q loop, from the File Run menu in Microsoft Windows, and
on systems whose shells don't allow redirection at all. This also has the advantage
in that prompts and user messages won't be sent to the file, hence things can be
done such as “astrolog -os textfile”, where the program will still prompt you on
the screen for the chart info, but the chart itself will still go to the file.
The -os switch may also be expressed as ->, which is included as a convenience
with its similarity to the “>“ output redirection featured in many shells. As with
all switches, one may leave off the dash and invoke it as just “>“. When just “>“
 is included on the command line, the system’s own output redirection will tend to
be used. This switch allows one to also include “>“ when prompted for command
lines within the program, or when running from MS Windows, where the shell
plays no part.
-5: Set whether transit event charts autopopulate chart list.
This switch will set a special mode such that any chart that produces a list of
times will automatically populate the chart list with those events (replacing the
existing list if already present). This includes the -d transit to transit times, -t
transit to natal times, and -Zd rising and setting charts. This useful feature allows
one to produce things such as a list of Full Moons during the year, or one’s solar
returns for the next decade, and then display and navigate through all these
different calculated charts in the chart list. In the Windows version, this setting
exists in the “Times Populate Chart List” checkbox in the Transits dialog.
-5e[2-4]: Display text charts for all charts in chart list.
The -5e switch will display all charts in the chart list in sequence. This will
produce one stream of text, in which the display options selected will be done for
each chart, e.g. “-g -a -5e” will display the -g aspect grid and -a aspect list for
each chart in the list. (Because of this, -5e is ignored for graphics, and only has an
effect in text mode charts.) Beware that combining -5e with -e will produce a
huge amount of output, e.g. “-5e -e” on the entire Astrodatabank will produce 5
gigabytes of output. The -5e2 switch is similar to -5e, except it will set chart slot
#2 to each chart in the list, instead of just the main slot like -5e does. For example,
“-5e -rt” will display each chart in the list transited to the time in slot #2, while “-
5e2 -rt” will display the main chart transited to each time in the chart list.
The -5e3 switch will do a grid of charts, and cover every combination of different
charts, such that each chart is matched with each other chart exactly once, e.g. “-g
-5e3” will display aspect grids for each combination of charts. Finally, -5e4 is like
-5e3 but will do each combination period (which will include each chart being
compared with itself, and each pair of charts will be matched with each other
twice in different orders). Beware that -5e4 can produce an enormous amount of
output, e.g. “-5e4 -r0 -g” on the entire Astrodatabank will produce over 4 billion
different aspect grids!
-5[dxynls]: Sort chart list by date, lon, lat, name, or city.
Astrolog’s chart list can be sorted in five different ways: By date (earliest to
latest), by longitude (from farthest West to farthest East), by latitude (from North
to South), by name string alphabetically, and by location string. On the command
line, the five sorting methods can be selected with the -5d, -5x, -5y, -5n, and -5l
command switches. In the Windows version, the chart list can be sorted in the
Chart List dialog by selecting the method and then pressing the “Sort List” button.
Note that sorting will affect the list in memory, and therefore remain in effect if
the chart list is subsequently saved to file. There’s also a user customizable
 method of sorting, accessible via the -5s command switch, which will call the ~5s
switch AstroExpression to decide how to sort.
-5f <name> <city>: Filter chart list to charts containing substring.
Astrolog’s chart list can be filtered, to work with a subset of the charts in it. This
is useful to focus upon a set of charts with long lists. Filtering can be done with
the -5f switch, which takes name and location string parameters. (In the Windows
version, the chart list can be filtered in the Chart List dialog, by entering Name
and/or Location strings which must be present in the chart, and then pressing the
“Filter” or “Remove Filter” buttons.) In both scenarios, the name or location
strings can be empty, in which case filtering is only done upon the other
parameter. The command line will always affect and reduce the number of charts
in the list in memory, however in the Windows version filtering won’t affect the
list in memory if the dialog is OK’ed with a filter active (which means filtering to
select the chart you want won’t affect the chart list, however OK’ing the dialog
with a filter on but no chart selected is a way to permanently affect the chart list).
There’s also a user customizable method of filtering, accessible via the ~5f switch
AstroExpression, which (similar to the name and location fields) will also set a
condition that must be met by charts in order to be present post-filtering.
-50: Delete all charts in chart list, leaving an empty list.
This switch will delete the entire chart list, such that the list size will be 0.

Switches which affect what information is used in a chart.

-R [<obj1> [<obj2> ..]]: Restrict specific bodies from displays.
The ability to restrict the transit (-t) and daily aspect (-d) scans to just certain
bodies has been implemented with the -R switch. Using -R by itself will prevent
the asteroids, Chiron, Lilith, the Part of Fortune, East Point, and the Vertex from
being in any of the charts. One may also give a list of one or more numbers
representing planets to be ignored (e.g. 1 = Sun, 2 = Moon, 3 = Mercury, etc) or
specify planet abbreviations directly, so that a complete custom setup can be
obtained (e.g. “-R 1 2 3 4 5” or “-R sun moo mer ven mar” will cause all of the
inner planets to be ignored). More than one -R switch can be combined (e.g. -R -R
16 will cause the asteroids, etc, and the North Node to be ignored; the first -R gets
rid of the asteroids, etc, and the second one deletes the North Node.) Also,
specifying the same particular body more than once will cause it to be included
again, or in other words, -R <objectnum> complements the status of whether it is
to be ignored or not (e.g. -R -R 15 will cause all of the asteroids, etc, excluding
Vesta, to be ignored; the first -R makes causes the asteroids to be ignored, and
specifying Vesta in the second -R makes it reappear.)
Note that Astrolog will compute charts faster when objects are restricted, since it
doesn't bother to compute locations that aren't needed or used. For example, the
search of a year for a Solar Return (-i chart -ty year -R0 Sun -RT0 Sun) is about
 twice as fast than when the restrictions are omitted, since we’re only looking at
Sun locations.
-R0 [<obj1> ..]: Like -R but restrict everything first.
The -R0 option will cause all bodies to be restricted, which is useful if you are
looking for just the transits/aspects of a few planets (e.g. -R0 6 7 will cause
everything but Jupiter and Saturn to be ignored.) Combining all these methods
can cause whatever you are looking for in transits and aspects to be quickly found
without having to wade through lots of data you aren't interested in.
-R1 [<obj1> ..]: Like -R0 but unrestrict and show all objects.
This will unconditionally unrestrict all planets and other objects used by the
program, which is a complement to the -R0 switch above which restricts
everything. Note that this will also set modes, in that it does automatically
activate the -C, -u, and -U sets of objects.
-R[C,u,u0,8,U]: Restrict all cusps, Uranians, Dwarfs, moons, or stars.
These five switches are similar to the -R0 option in that they initially restrict
objects, i.e. all the minor cusps, Uranians, and fixed stars, respectively from
appearing. For example, if you want to include only the star Sirius in a chart
without having to also include all the other stars (or having to enter a very long
restriction list), do: “astrolog =RU Sir”, which will restrict all stars except Sirius,
before making the chart.
-RT[0,1,C,u,u0,8,U] [..]: Restrict transiting planets in charts.
Transiting planets may be restricted from charts independently of those planets
being transited to. In the -t switch transit to natal charts, the -R option only affects
the natal planets. To restrict transiting planets, one must use the -RT switch. The -
RT switch is exactly like -R, and any subswitches of -R can be used with -RT as
long as the 'T' immediately follows the 'R'. For example, -RT by itself restricts
transiting asteroids from appearing in -t charts, -RT0 restricts all transiting bodies,
-RTu restricts the Uranians, and so on. This is a useful feature, and allows one to
pretty much be able to generate exactly and only those transits one is interested in.
For example, if you want to see if anything is transiting your natal Jupiter or natal
Saturn this month, do: “astrolog -i yourchart -tn -R0 Jup Sat”. If you want to see if
Chiron is transiting anything this year, do: “astrolog -i yourchart -tyn -RT0 Chi”.
If you are only interested in transits of outer planets to your Sun or Moon, do:
“astrolog -i yourchart -ty 2022 -RT0 Jup Sat Ura Nep Plu -R0 Sun Moo”, and so
on. By default, only the transiting Moon is restricted. To get it back, unrestrict it
with “-RT Moo”. These default transit restrictions are in the [Link] default
settings file, and are right after the standard restriction table, both of which may
be modified however you please.
-RA [<asp1> ..]: Restrict specific aspects from displays.
 The -RA switch will restrict the given aspect or list of aspects from appearing in
charts, like how the -R switch does for objects. (Note that an aspect can also be
restricted by giving it a negative orb.) As with object restrictions, aspects can be
forced on or off independent of their previous state with the “_” or “=” switch
prefixes. Aspect restrictions are automatically linked with the -A switch aspect
count setting. In other words, increasing the aspect count will automatically
unrestrict uncovered aspects, and decreasing it will automatically restrict covered
aspects. Also, manually restricting or unrestricting aspects will automatically
adjust the aspect count to be the highest unrestricted aspect.
If -RA is invoked as -RA0 it will restrict all aspects. (This is similar to the -R0
switch which restricts all objects, and is equivalent to doing -A 0.) Similarly, if -
RA is invoked as -RA1 it will unrestrict and show all aspects. (This is similar to
the -R1 switch which restricts all objects, and is equivalent to doing -A 24 after -
A 0).
-RO <obj>: Require object to be present in aspects.
A “reverse restriction” is a required object that must be present in charts listing
aspects between planets. For example, if you want to see only aspects or transits
involving Mars (such as Mars Trine Venus, and Mars Trine Jupiter, but not Venus
Trine Jupiter) then Mars is considered required. If the object parameter is -1,
“None”, or the empty string, that will turn this option off and not have a required
object. In addition to actual aspect lists, this setting will affect the aspect
configurations included after the text mode aspect grid (-g0 switch), although it
won’t prevent objects from appearing in the aspect grid itself. This setting will
also affect the midpoints included in the midpoint list (-m switch), although it
won’t restrict which aspects are displayed to those midpoints (-ma switch).
-C: Include angular and non-angular house cusps in charts.
This option must be indicated to include the 12 actual house cusps (i.e.
Ascendant, et al) in the various chart options, such as the -g aspect grids, -t transit
searches, the graphics wheel chart, etc. This option won't have any effect on
certain charts where only physical bodies are shown (e.g. -Z, -S, -L) or where all
house cusps are already indicated in the chart (e.g. -v, -w). The house cusps
technically have actual object indexes like the planets, and are objects 22 through
33 in order (add 22 to a house to get its index). You can deal with and restrict
these individually for transit and other charts, e.g. to turn on just the Ascendant
and MC, do “-C -RC 22 31”. Cusp objects (along with Uranians and fixed stars
below) are integrated with object restrictions. In other words, restricting all
objects in a category will turn the category as a whole off, and unrestricting an
object within a category will turn the category on. Concerning rulerships, each
cusp object is set to “rule” the sign corresponding to it (e.g. Ascendant “rules”
Aries) while each cusp “exalts in” the next sign after it of the same element (e.g.
Ascendant “exalts in” Leo).
-u: Include Uranian/transneptunian bodies in charts.
 Display the locations of the “Uranian” planets with the -u switch. Uranian or
transneptunian planets come from a school of astrology which includes various
hypothetical objects alleged to orbit beyond Neptune. (Do: astrolog -u -HO to list
the nine Uranian bodies.) Astrolog will include the zodiac positions of these
planets if one includes this option, and will print their positions after the main
planets, and include them in the other chart types.
Astrolog supports the position of Vulcan, a hypothetical planet located inside
Mercury’s orbit. Vulcan is significant in Esoteric Astrology, and is computed
according to the research of L.H. Weston. Vulcan is stored within the Uranian
group of objects (which are also hypothetical planets). That means this switch will
include Vulcan along with the eight actual Uranians. Computing Vulcan requires
the Swiss Ephemeris routines to be active, and it will be placed at 0Aries
otherwise. The orbital formula for Vulcan is defined in the file “[Link]” in the
Astrolog install directory, and like the larger ephemeris files that text file needs to
be present in order for Vulcan to be computed.
-u0: Include Dwarf planets and related bodies in charts.
Astrolog supports nine objects related to Dwarf planets. These include the “Seven
Dwarfs”, or the seven largest confirmed or possible Dwarf planets located beyond
Pluto, which in decreasing size order are: Eris, Haumea, Makemake, Gonggong,
Quaoar, Sedna, and Orcus. Also included are asteroid “10 Hygiea” (which might
also be a Dwarf planet), and the centaur “5145 Pholus”. The -u0 command switch
will enable (or disable) these nine objects. In the Windows version, these nine
objects have been added to the “Setting / Restrictions” and the “Setting / More
Object Settings” dialogs, and can be toggled on/off with the “Setting / Include
Dwarfs” menu command or the “y” hotkey. These are full objects like any other,
in which graphic glyphs and simple interpretations are available too. By default
Astrolog uses the most common glyphs, which are covered by Unicode characters
or were designed by Denis Moskowitz. The ephemeris files for these bodies come
with all downloads of Astrolog, so one can just point and click to show them. For
more about the “Seven Dwarfs” in astrology and their significance, see:
[Link]
-u8: Include planetary moon bodies in charts.
-ub: Include planetary center of body (COB) objects in charts.
Astrolog supports 32 objects related to moons of other planets. These include 27
moons, and five points for the actual center of body (COB) of Jupiter through
Pluto (as opposed to the planetary system barycenters which the standard planet
objects cover). The -u8 switch will enable (or disable) the 27 moon objects, and
the -ub switch will enable the five center of body objects. These are full objects
like any other, and simple interpretations are available too. Note the similarity in
names of Saturn’s moon “Titan” with Uranus’ moon “Titania”, which means that
when specifying objects by name on the command line that “Titan” or a substring
of it will match Saturn’s Titan, and at least the six characters “Titani” are needed
to match Titania. Planetary moon ephemeris files still need to be downloaded
 separately from [Link] or
[Link] although the object slots make them
easy to work with. For more about planetary moons in astrology, see:
[Link]
-U: Include locations of fixed background stars in charts.
Astrolog has the ability to display the positions of 50 of the brightest and most
important stars in the sky. To include these stars in a chart, use the -U “universe”
option. The 43 brightest stars, i.e. all those in the sky with apparent magnitude
values less than 2.0 are included. For example, one bright star is Alnilam, which
is the middle star of Orion’s belt. In addition, seven dimmer stars or objects in
space which are considered significant are also included: Polaris the North star,
Algol, the Pleiades star cluster (specifically the brightest star Alcyone within it,
which is the home of the Pleiadian extraterrestrials), Zeta Reticuli (home of the
Grey aliens), the Galactic Center point of our Milky Way galaxy, the Andromeda
Galaxy or M31 (which is the closest galaxy to our own, and home to various
extraterrestrial hierarchies), and the Great Attractor (which our and most other
nearby galaxies are being drawn to). Since stars are mostly fixed in the sky, they
won’t change position much in the -s sidereal zodiac, although they will slowly
precess forward in the standard tropical zodiac. Stars will move slightly between
geocentric and heliocentric positions, based on the parallax effect produced by
Earth orbiting around the Sun. The -R restriction option can be used to determine
which stars are actually included, although the -U option will enable them all at
once. With on screen graphics, the stars are labeled by three letter abbreviations,
and are colored according to their brightness: orange for stars brighter than (less
than) magnitude 1.0, and dark red for the dimmer remaining stars with
magnitudes greater than this value.
-U[i,z,l,n,b,d,v]: Sort stars by index, zodiac position, latitude, name, brightness, distance,
or zodiac position velocity.
In places where stars are printed sequentially, such as the -v standard chart, -Z
horizon chart, -S space chart, and in the -HO and -HS object lists, it can
sometimes be confusing to locate the star you want among 49 others. The -U
option subswitches will sort the stars in various ways. Note that star ordering will
have no visible effect in graphics charts, and one must still use the default
ordering when passing numbers to the -R switch to restrict star objects.
-Ui: Sort by default index, which is by their magnitude in the year 2000. This
means the brightest star Sirius first, and the dimmest objects or galaxies last. This
is different from -Ub below, because brightnesses do change over time gradually
due to star proper motion (-YUb switch), and because brightness may be
determined by absolute magnitude independent of distance (-YUb0 switch).
-Uz: Sort stars by their zodiac position.
-Ul: Sort stars by their ecliptic latitude from highest in the celestial sphere to
lowest.
-Un: Alphabetize the stars by name.
 -Ub: Stars will be listed in order from brightest to dimmest, however brightness is
currently calculated.
-Ud: Sort stars by distance from the viewer. Note that determining star distances
requires Swiss Ephemeris to be the calculation method, and older calculation
methods will assume all stars are exactly 100 light years away from our Sun.
-Uv: Sort stars by their longitudinal velocity. Note that determining star velocities
requires Swiss Ephemeris to be the calculation method, and older calculation
methods will assume all stars never move.
-A <0-24>: Specify the number of aspects to use in charts.
If you like many aspects, or only desire the major ones, to be included in the
aspect grids, specifying -A <number> will limit or extend the number of aspects
(e.g. -A 2 will make charts with only Conjunctions and Oppositions listed in
them, while -A 24 will include all 24 aspects that Astrolog supports.) Astrolog
supports all aspects up through the 12th harmonic, or all possible aspect
combinations that are x/y of a circle, where y is 12 or less.
-A3: Aspects calculated by latitude combined with zodiac position.
3D aspects: Aspect calculations can take the latitude of the planet into account. In
other words, the angle between two planets is based on the 3D great circle
distance between them on the celestial sphere, and not just the 2D difference
between their zodiac position longitudes.
For example, during a New Moon the Sun and Moon may be as much as 5
degrees different in latitude, which means that even when a New Moon is exact,
the 3D aspect orb between them may be up to 5 degrees. (If the Sun and Moon are
conjunct in both zodiac position and latitude, then a solar eclipse is taking place.)
For bodies with latitudes that can be widely different from the ecliptic, such as
Pluto, asteroids, and especially fixed stars, the difference is more pronounced. For
example, a body at 0Leo and -30 latitude will be Square a body at 0Leo and +60
latitude, even though they’re both at the same longitude and would be considered
Conjunct normally.
-Ap: Orb limits apply to latitude as well as zodiac position.
3D orbs: Most astrologers and astrology software only look at a planet’s zodiac
longitude, and ignore any latitude, when determining whether an aspect is within
orb. When 3D orbs are on, they will prevent an aspect from appearing if the 3D
great circle distance between the pair of planets is out of orb. That means turning
3D orbs on may cause certain aspects to no longer be present, especially involving
objects that can have very different latitudes, such as asteroids and fixed stars. For
example, a Conjunction between two planets both exactly at 15Libra longitude
won’t be flagged if their latitudes are different by more than the orb for the
Conjunction aspect.
-AP: Parallel aspects based on ecliptic not equatorial positions.
 Parallel and contraparallel aspects are usually calculated relative to equatorial
declination. This switch will instead calculate parallel aspects relative to ecliptic
latitude. Note that since most planets are on or near the ecliptic, aspect orbs
should be very narrow to avoid most everything being parallel to everything else.
-Ao <aspect> <orb>: Specify maximum orb for an aspect.
Change the default orbs of the various aspects with the -Ao <aspect> <orb>
switch. Do you not like the 7 degree orbs for conjunctions that are used by
default? Given an aspect name or index number, and an orb value, the orb used
for that particular aspect is updated accordingly. Non-integer orb values are
allowed. A negative orb value will completely eliminate an aspect from ever
appearing, although it’s better to simply restrict the aspect if you want to do that.
For example: astrolog -Ao Opp 4 -Ao Tri -1 narrows the orb for Oppositions, and
eliminates Trines, leaving all the other aspects at the default values. Note that for
very wide orbs more than one aspect may apply for a particular angle, in which
case the earlier or more fundamental aspect is chosen. Note also that the actual
orbs used for a particular aspect may be modified by the max orb and orb addition
settings below, which are applied after this setting.
-Am <planet> <orb>: Specify maximum orb allowed to a planet.
Ability to explicitly specify maximum orbs that any aspect can make to a
particular planet is supported with the -Am switch. This is used for objects like
the North Node which require narrower orbs than what the aspects themselves
normally allow. The -Am switch takes two parameters: the first to indicate the
index of the object, and the second to indicate what the maximum orb allowed to
it will be. By default, the only objects with restriction are the Node, Part of
Fortune, Vertex, and fixed stars, which allow a 2 degree max orb to them. With
this option, one can change these limits or impose restrictions for other planets
too. Note all stars use the maximum orb given to the first star (object #43), and
object indexes beyond the first star aren’t allowed for this switch. The [Link]
settings file will read in these default planet orbs for all objects. Note also that the
actual max orbs used for a particular aspect may be modified by the orb addition
setting below, which is applied after this setting.
-Ad <planet> <orb>: Specify orb addition given to a planet.
Ability to widen an aspect orb for any planet is supported with the -Ad switch.
This is used for objects like the Sun and Moon for which one might want wider
orbs to them than what the aspects themselves allow. Like the -Am switch, this -
Ad switch takes two parameters: the first to indicate the object, and the second to
indicate how much wider orbs allowed to it will be. By default, the only objects
which have orbs widened for them are the Sun and Moon, each of which adds one
degree to the orb of any aspect to it. With this option, one can change these
additions or allow other objects to have them, too. It can also be used for
“moiety” type aspect orbs which vary based on planet instead of aspect. (To do
this, set all aspect orbs to zero with -Ao, and then for each planet set -Ad to half
 its moiety orb). Note all stars use the orb addition given to the first star (object
#43), and object indexes beyond the first star aren’t allowed for this switch. The
[Link] file will also read in defaults for these orb additions for all planets.
(Note that these object orb additions can be added to a negative orb for an aspect
making it valid, so if you really want to restrict an aspect with -Ao, it should be a
large enough negative value so that the sum of any additions between two objects
won't make it go positive.)
-Aa <aspect> <angle>: Change the actual angle of an aspect.
This option is used to change the actual angle of a particular aspect. This is useful
if one wants to search for some unusual angle not already available in Astrolog’s
aspects or accessible through the -x harmonic charts. For example, if I want to
know when any planet enters a 2.5 degree orb of any planet in my natal chart, I
could do a transit search along with “-Aa 1 2.5”, where “1” is the index of the
conjunction aspect, and “2.5” means the “conjunction” aspect is now exact when
any two objects are 2 degrees and 30 minutes apart.

Switches which affect how a chart is computed:

-b: Use ephemeris files for more accurate location computations.
Astrolog uses the accurate Swiss Ephemeris to compute the positions of objects.
These include the planets, the Moon and its nodes and Lilith, Chiron and the
asteroids, and the Uranians and Vulcan. Swiss Ephemeris is also used to compute
fixed stars and house cusps. The Swiss Ephemeris (version 2.10.03) is a
compressed version of NASA’s Jet Propulsion Laboratory (JPL) DE431
ephemeris, and reproduces it with 0.001 arc seconds precision.
The ephemeris files used by the Swiss Ephemeris cover 30,000 years. Three
different files cover each date range, which are named “se*.se1”, in which “se”
stands for “Swiss Ephemeris”. The files “sepl*.se1” cover the planets (“pl” stands
for planets), the files “semo*.se1” cover the Moon (“mo” stands for Moon), and
the files “seas*.se1” cover the asteroids and Chiron (“as” stands for asteroids).
The last three or four characters in an ephemeris filename indicate the date range
covered, which consists of six centuries starting with the number indicated, in
which “_” means a positive year, and “m” means minus or negative years BC.
Note since there is no year 0 (1 BCE/BC is followed by 1 CE/AD) negative
ephemeris file ranges are offset by 1 year. The three files “se*_18.se1” cover the
years 1800 through 2400 AD, which is good for most modern purposes and take
up 2012K of space. These three files are included in the standard setup of
Astrolog. For users who want to cover more years, the complete set of files is
available online. The following is a list of the years covered by each ephemeris
file:
Files seplm132.se1 / semom132.se1 / seasm132.se1 cover
-12998 BC - -12601 BC.
Files seplm126.se1 / semom126.se1 / seasm126.se1 cover
-12601 BC - -12001 BC.
Files seplm120.se1 / semom120.se1 / seasm120.se1 cover
-12001 BC - -11401 BC.
Files seplm114.se1 / semom114.se1 / seasm114.se1 cover
-11401 BC - -10801 BC.
Files seplm108.se1 / semom108.se1 / seasm108.se1 cover
-10801 BC - -10201 BC.
Files seplm102.se1 / semom102.se1 / seasm102.se1 cover
-10201 BC - -9601 BC.
Files seplm96.se1 / semom96.se1 / seasm96.se1 cover
-9601 BC - -9001 BC.
Files seplm90.se1 / semom90.se1 / seasm90.se1 cover
-9001 BC - -8401 BC.
Files seplm84.se1 / semom84.se1 / seasm84.se1 cover
-8401 BC - -7801 BC.
Files seplm78.se1 / semom78.se1 / seasm78.se1 cover
-7801 BC - -7201 BC.
Files seplm72.se1 / semom72.se1 / seasm72.se1 cover
-7201 BC - -6601 BC.
Files seplm66.se1 / semom66.se1 / seasm66.se1 cover
-6601 BC - -6001 BC.
Files seplm60.se1 / semom60.se1 / seasm60.se1 cover
-6001 BC - -5401 BC.
Files seplm54.se1 / semom54.se1 / seasm54.se1 cover
-5401 BC - -4801 BC. +
Files seplm48.se1 / semom48.se1 / seasm48.se1 cover
-4801 BC - -4201 BC. +
Files seplm42.se1 / semom42.se1 / seasm42.se1 cover
-4201 BC - -3601 BC. +
Files seplm36.se1 / semom36.se1 / seasm36.se1 cover
-3601 BC - -3001 BC. +
Files seplm30.se1 / semom30.se1 / seasm30.se1 cover
-3001 BC - -2401 BC. +
Files seplm24.se1 / semom24.se1 / seasm24.se1 cover
-2401 BC - -1801 BC. +
Files seplm18.se1 / semom18.se1 / seasm18.se1 cover
-1801 BC - -1201 BC. +
Files seplm12.se1 / semom12.se1 / seasm12.se1 cover
-1201 BC - -601 BC. +
Files seplm06.se1 / semom06.se1 / seasm06.se1 cover
-601 BC - -1 BC. +
Files sepl_00.se1 / semo_00.se1 / seas_00.se1 cover
-1 BC - 600 AD. +
Files sepl_06.se1 / semo_06.se1 / seas_06.se1 cover
600 AD - 1200 AD. +
Files sepl_12.se1 / semo_12.se1 / seas_12.se1 cover
1200 AD - 1800 AD. +
Files sepl_18.se1 / semo_18.se1 / seas_18.se1 cover
1800 AD - 2400 AD. **
Files sepl_24.se1 / semo_24.se1 / seas_24.se1 cover
2400 AD - 3000 AD. +
Files sepl_30.se1 / semo_30.se1 / seas_30.se1 cover
3000 AD - 3600 AD. +
Files sepl_36.se1 / semo_36.se1 / seas_36.se1 cover
3600 AD - 4200 AD. +
Files sepl_42.se1 / semo_42.se1 / seas_42.se1 cover
4200 AD - 4800 AD. +
Files sepl_48.se1 / semo_48.se1 / seas_48.se1 cover
4800 AD - 5400 AD. +
Files sepl_54.se1 / semo_54.se1 / seas_54.se1 cover
5400 AD - 6000 AD.
Files sepl_60.se1 / semo_60.se1 / seas_60.se1 cover
6000 AD - 6600 AD.
Files sepl_66.se1 / semo_66.se1 / seas_66.se1 cover
6600 AD - 7200 AD.
Files sepl_72.se1 / semo_72.se1 / seas_72.se1 cover
7200 AD - 7800 AD.
Files sepl_78.se1 / semo_78.se1 / seas_78.se1 cover
7800 AD - 8400 AD.
Files sepl_84.se1 / semo_84.se1 / seas_84.se1 cover
8400 AD - 9000 AD.
Files sepl_90.se1 / semo_90.se1 / seas_90.se1 cover
9000 AD - 9600 AD.
Files sepl_96.se1 / semo_96.se1 / seas_96.se1 cover
9600 AD - 10200 AD.
Files sepl_102.se1 / semo_102.se1 / seas_102.se1 cover
10200 AD - 10800 AD.
Files sepl_108.se1 / semo_108.se1 / seas_108.se1 cover
10800 AD - 11400 AD.
Files sepl_114.se1 / semo_114.se1 / seas_114.se1 cover
11400 AD - 12000 AD.
Files sepl_120.se1 / semo_120.se1 / seas_120.se1 cover
12000 AD - 12600 AD.
Files sepl_126.se1 / semo_126.se1 / seas_126.se1 cover
12600 AD - 13200 AD.
Files sepl_132.se1 / semo_132.se1 / seas_132.se1 cover
13200 AD - 13800 AD.
Files sepl_138.se1 / semo_138.se1 / seas_138.se1 cover
13800 AD - 14400 AD.
Files sepl_144.se1 / semo_144.se1 / seas_144.se1 cover
14400 AD - 15000 AD.
 Files sepl_150.se1 / semo_150.se1 / seas_150.se1 cover
15000 AD - 15600 AD.
Files sepl_156.se1 / semo_156.se1 / seas_156.se1 cover
15600 AD - 16200 AD.
Files sepl_162.se1 / semo_162.se1 / seas_162.se1 cover
16200 AD - 16800 AD.

There is a flag to “Use ephemeris files” in the [Link] file, which when set will
always use the Swiss Ephemeris routines and is the same as just including -b all
the time, in which case -b will toggle them back off. There is a compile time
option #define SWISS in the astrolog.h header file which can be commented out
to disable the -b switch and the new formulas (although there’s little reason to
ever want to do that, of course).
If a chart is cast for a date without the required ephemeris files, an error message
will be displayed (only one error message per chart, to avoid a long string of
errors when doing charts like transit searches and ephemeris tables). Then, the
program will fall back to using a less accurate internal ephemeris and formulas by
Steve Moshier. The Moshier ephemeris is based on the JPL DE404 ephemeris,
which covers 6000 years (-3000 BCE/BC to 3000 CE/AD), and computes planets
to within 0.1 arc seconds, and the Moon within 3 arc seconds. Note that the
position of Chiron is only available for 3975 years at most, from Jan 1, 675
through Dec 31, 4649, regardless of ephemeris files available. That’s because
outside those dates Chiron’s orbit becomes impossible to accurately determine,
due to close encounters with Saturn. Attempting to cast a chart for Chiron outside
of this range with Swiss Ephemeris will display an error and place it at 0Aries.
When Swiss Ephemeris is active, the program also uses it for calculating house
cusps, including the Ascendant, Midheaven, and related variables. That changes
the position of the Ascendant and house cusps by several arc seconds in most
charts, in comparison to when Swiss Ephemeris is disabled. It’s a minor effect,
since on average house cusps change 15 arc seconds every clock second, however
the slight improvement in accuracy is still present.
-b0: Display locations and times to the nearest second.
The ability to display zodiac positions to the arc second is supported with the -b0
switch. Without this, positions are displayed only to the arc minute (which used to
be all that was useful due to the lesser accuracy of older calculation methods).
With the Swiss Ephemeris routines accurate to within an arc second, this switch
will turn on the more precise display.
When this setting is on, the planet and house positions in the -w text wheel chart,
and the sidebar positions in graphic wheel charts, will be to the nearest second.
The -g text mode aspect and midpoint grids will have an extra row for the zodiac
arc second of the orb or midpoint position. The -Z local space chart will display
the altitude and azimuth to the nearest second, while the other three vector
columns will be displayed with an extra digit of precision. The -S orbital position
 chart will have all five of its columns displayed to an extra four digits of
precision. The -L0 astro-graph chart with latitude crossings will display the
latitude crossing intersections to the nearest second. The -Zd switch rising and
setting chart will display the zenith and nadir altitudes, and the horizon azimuths
to the nearest second. Finally, Astrolog’s text mode aspect list chart (-a switch),
influence chart (-j switch), and date difference chart (-rd switch), will display
power, percentage, and time numbers with more digits to the right of the decimal
point.
Finally the standard -v listing will display the zodiac positions and latitudes to the
nearest second, and the velocity values will have an extra four digits of precision.
Note however this doesn't leave room to the right anymore for the house cusp
positions and element table normally shown. They will be left out for -b0,
however when the -C switch is in effect, the house cusp positions will be
displayed in their own separate rows, which normally isn't ever done since there’s
always the list to the side. Also, -b0 combined with -v will display an extra
column at the end showing the velocity of a planet’s motion along the vertical
latitude axis (which is used to compute applying/separating parallel aspects). This
will be shown in the last column if the -v3 switch setting is off, otherwise it will
show the decan positions of each object, allowing viewing of each planet
alongside its decan without having to actually change positions with the -3 switch.
Also with this setting, all clock times will include seconds. Exact times in the -d
Transits In Day search list, the -t Transit To Natal search list, and the -Zd Rising
and Setting Times list will all be displayed to the second, instead of just to the
minute. This will also affect the time and location values in chart header text.
-bj: Use more accurate JPL ephemeris file instead of Swiss Ephemeris.
The only thing more accurate than the Swiss Ephemeris (and even then only
slightly) is the JPL ephemeris itself, of which the Swiss Ephemeris is a
compressed version. Astrolog supports doing calculations using the JPL
ephemeris, with the -bj command switch, or in the Windows version by selecting
the “JPL Ephemeris” option in the “Calculation Method” dropdown of
Calculation Settings. Using this option requires the large 2.7 gigabyte file
[Link] to be downloaded from [Link] and placed in
a directory where Astrolog can find it. (Note some browsers like Chrome have
FTP disabled by default.)
-bs: Use less accurate Moshier formulas instead of Swiss Ephemeris.
When ephemeris files are unavailable, the Swiss Ephemeris automatically falls
back to using a slightly less accurate internal ephemeris and formulas by Steve
Moshier. The Moshier ephemeris is based on the JPL DE404 ephemeris, which
covers 6000 years (-3000 BCE/BC to 3000 CE/AD), and computes planets to
within 0.1 arc seconds, and the Moon within 3 arc seconds. The -bs switch will
force Astrolog to use the Moshier ephemeris, even if the more accurate ephemeris
files are available.
-bp: Use less accurate Placalc ephemeris instead of Swiss Ephemeris.
Older versions of Astrolog used the Placalc ephemeris, which is less accurate and
covers fewer years then the Swiss Ephemeris. The older ephemeris is still
available with this switch. There’s little reason for the average user to ever need
or want to do this. The old ephemeris routines are still available for obscure
situations such as comparing accuracy of different calculation methods, testing
against previous version output with known positions, or a need to run Astrolog in
limited disk space environments. (The Placalc ephemeris is 4.8 megabytes total or
57K per century, while Swiss Ephemeris is 37.1 megabytes or 344K per century.)
Placalc’s accuracy is about the same as Mark Pottenger’s “CCRS” routines, and
those used in Nova (it even fixes some accuracy problems Nova has, in some of
its earlier versions at least). Placalc’s integrated outer planet positions represent
the standard of the Nautical Almanac, the international astronomical standard, as
published in the Astronomical Almanac, for its computations as computed before
1984. (Since 1984 the standard has been the DE200 integrations by JPL.) The
Sun’s position implements the Newcomb theory for all terms > 0.01", the
positions of Mercury through Mars are done to all terms > 0.05", while “Brown’s
improved lunar ephemeris” is used such that the Moon is within 3" of DE200. For
the asteroids, at the conclusion of the integration process computing their files, the
uncertainty error had reached 8.0E-11 AU after CPJV_29, and 4.9E-10 AU after
CPJV_m2. Placalc’s fraction of second precision, is of course much more
accurate when compared to the Matrix positions, which are only accurate to about
one minute (and several degrees for Chiron, as well as the four asteroids) for the
20th century only. For example, at 1800 CE/AD, the Matrix positions for the
outer planets are off by 2 degrees, and about 1 degree for 2100; by 1500 CE/AD,
Matrix is off by 14 degrees for Pluto while Chiron is barely in the right
hemisphere any more.
Placalc uses ephemeris files for some planets which must be in a directory
specified at compile time or covered by one of the environment variables in order
to be found. The advanced routines are valid based on how many of the ephemeris
files one has. With all of them, the formulas will cover and deliver accurate
positions for nearly 8500 years from -5260 BCE/BC through 3237 CE/AD. There
are 95 ephemeris files total. Each file covers a range of 100,000 days, or about
273 years. Altogether they take up 4.8 megabytes of disk space, but each segment
of 273 years only takes up 150K. For each time segment, there is an ephemeris
file named “LRZ5_n” containing the positions of Jupiter through Pluto (at 80 day
increments), a file “CHI_n” containing the positions of Chiron, and a file
“CPJV_n” containing the positions of the four asteroids. The 'n' refers to the span
of Julian Days covered by it (divided by 100000). For example, Julian Days
1,200,000 through 1,300,000 are in the files “LRZ5_12”, “CHI_12”, and
“CPJV_12” (the 'm' character in some files refers to negative/minus Julian Days).
You don't need all the files to use -bp, just those that cover the dates you want to
use. If you try to use -bp with a date not covered by an available ephemeris file, a
warning message will be printed and the old Matrix formulas will be used. (Only
one error is displayed for each chart until control returns to the user, to prevent
potentially numerous errors from tables involving multiple charts such as transit
searches.) The files “LRZ5_24”, “CHI_24”, and “CPJV_24” cover the years 1859
through 2131 CE/AD, which is good for most modern purposes and only take up
150K of space. (These three files are included in the standard zip archive release
file of Astrolog. For users who want to cover more years, the complete set of files
is available online.) The following is a list of the precise dates covered by each
ephemeris file:
Files LRZ5_m2 / CPJV_m2 / CHI_m2 cover Jun 6, -5260 BC
- Mar 20, -4986 BC.
Files LRZ5_m1 / CPJV_m1 / CHI_m1 cover Mar 20, -4986 BC
- Jan 1, -4712 BC.
Files LRZ5_0 / CPJV_0 / CHI_0 cover Jan 1, -4712 BC
- Oct 14, -4439 BC.
Files LRZ5_1 / CPJV_1 / CHI_1 cover Oct 14, -4439 BC
- Jul 28, -4165 BC.
Files LRZ5_2 / CPJV_2 / CHI_2 cover Jul 28, -4165 BC
- May 10, -3891 BC.
Files LRZ5_3 / CPJV_3 / CHI_3 cover May 10, -3891 BC
- Feb 21, -3617 BC.
Files LRZ5_4 / CPJV_4 / CHI_4 cover Feb 21, -3617 BC
- Dec 4, -3344 BC.
Files LRZ5_5 / CPJV_5 / CHI_5 cover Dec 4, -3344 BC
- Sep 17, -3070 BC.
Files LRZ5_6 / CPJV_6 / CHI_6 cover Sep 17, -3070 BC
- Jun 30, -2796 BC.
Files LRZ5_7 / CPJV_7 / CHI_7 cover Jun 30, -2796 BC
- Apr 13, -2522 BC.
Files LRZ5_8 / CPJV_8 / CHI_8 cover Apr 13, -2522 BC
- Jan 25, -2248 BC.
Files LRZ5_9 / CPJV_9 / CHI_9 cover Jan 25, -2248 BC
- Nov 7, -1975 BC.
Files LRZ5_10 / CPJV_10 / CHI_10 cover Nov 7, -1975 BC
- Aug 21, -1701 BC.
Files LRZ5_11 / CPJV_11 / CHI_11 cover Aug 21, -1701 BC
- Jun 3, -1427 BC.
Files LRZ5_12 / CPJV_12 / CHI_12 cover Jun 3, -1427 BC
- Mar 17, -1153 BC.
Files LRZ5_13 / CPJV_13 / CHI_13 cover Mar 17, -1153 BC
- Dec 28, -880 BC.
Files LRZ5_14 / CPJV_14 / CHI_14 cover Dec 28, -880 BC
- Oct 11, -606 BC.
Files LRZ5_15 / CPJV_15 / CHI_15 cover Oct 11, -606 BC
- Jul 24, -332 BC.
Files LRZ5_16 / CPJV_16 / CHI_16 cover Jul 24, -332 BC
- May 7, -58 BC.
Files LRZ5_17 / CPJV_17 / CHI_17 cover May 7, -58 BC
- Feb 18, 216 AD.
Files LRZ5_18 / CPJV_18 / CHI_18 cover Feb 18, 216 AD
- Dec 1, 489 AD.
Files LRZ5_19 / CPJV_19 / CHI_19 cover Dec 1, 489 AD
- Sep 14, 763 AD.
Files LRZ5_20 / CPJV_20 / CHI_20 cover Sep 14, 763 AD
- Jun 27, 1037 AD.
Files LRZ5_21 / CPJV_21 / CHI_21 cover Jun 27, 1037 AD
- Apr 10, 1311 AD.
Files LRZ5_22 / CPJV_22 / CHI_22 cover Apr 10, 1311 AD
- Jan 31, 1585 AD.
Files LRZ5_23 / CPJV_23 / CHI_23 cover Jan 31, 1585 AD
- Nov 16, 1858 AD.
Files LRZ5_24 / CPJV_24 / CHI_24 cover Nov 16, 1858 AD
- Aug 31, 2132 AD. *
Files LRZ5_25 / CPJV_25 / CHI_25 cover Aug 31, 2132 AD
- Jun 16, 2406 AD.
Files LRZ5_26 / CPJV_26 / CHI_26 cover Jun 16, 2406 AD
- Mar 31, 2680 AD.
Files LRZ5_27 / CPJV_27 / CHI_27 cover Mar 31, 2680 AD
- Jan 14, 2954 AD.
Files LRZ5_28 / CPJV_28 / CHI_28 cover Jan 14, 2954 AD
- Oct 30, 3227 AD.
Files LRZ5_29 / CPJV_29 cover Oct 30, 3227 AD
- Aug 15, 3501 AD.

Note that because the asteroid ephemeris files were first introduced in a version
after those for the other planets, meaning one may not yet have CPJV_n files for
dates they have the other files for, there is an “undocumented” switch called -ba,
which is like -bp but will still compute the asteroids using the Matrix formulas.
Note that this calculation method is not compatible with allowing the -v0 switch
to express planetary velocities relative to average speed work with it, and nor will
central planetary bodies other than the Sun or Earth (standard geocentric and
heliocentric charts) via -h work. It will however display velocities for the Moon
and the Nodes, which aren't available with the Matrix routines.
Special thanks to Dr. Alois Treindl who kindly allowed the Placalc formulas to be
used in Astrolog. Mr. Treindl is the founder and owner of Astrodienst Zurich,
second largest astrological computer service in Europe, and is well known for his
work with Liz Greene. Astrolog basically treats the Placalc routines as a library
which we link into, in that code that knows about both programs is kept to a
minimum.
Special thanks also to Mr. Paul Schlyter, of the Swedish Amateur Astronomer’s
Society (SAAF, or in Swedish: Svensk Amat|rAstronomisk F|rening), for
providing ephemeris files for the four asteroids, by writing a utility which does
 the integration process to determine the positions, and that conveniently output
files in the Placalc format. Note that the requirements for use of those asteroid
files are the same as that of the rest of Astrolog.
-bm: Use inaccurate Matrix formulas when ephemeris unavailable.
If the Swiss Ephemeris and Placalc are disabled or not compiled in, then Astrolog
will use a very old set of formulas that don’t include external ephemeris files,
based on routines originally designed by Matrix Software. The old Matrix
formulas are only accurate to about one arc minute for the 20th century. The
Uranian objects are less accurate in the Matrix routines too. Their zodiac positions
may vary up to 10 arc minutes, and their latitudes (which will always be fixed at
0) may vary by up to 59 arc minutes. This switch allows these formulas to still be
used. When this setting is off, the Matrix formulas will never be used no matter
what, in which case the lack of ephemeris files will result in planets being at
0Aries. That may be desired behavior, to ensure only the best Swiss Ephemeris
positions are ever in place. Many may prefer the error condition of no positions,
to relatively inaccurate and potentially misleading positions. There’s little reason
for the average user to ever need or want to turn this on, although some features
like defining your own orbital elements (via the -YE switch) make use of the
simple Matrix formulas.
-bU: Use inaccurate Matrix formulas for fixed stars only.
The Swiss Ephemeris is also used for computing the positions of fixed stars. Star
positions are taken from the file [Link] that comes with Astrolog’s
installation. Stars can be computed without Swiss Ephemeris with the -bU
command switch. There’s little reason to not use Swiss Ephemeris, although fixed
stars are computed slightly faster via the older and less accurate method.
-bJ: Use most accurate JPL Web query instead of Swiss Ephemeris.
Astrolog can use JPL Horizons to compute special bodies, as well as the standard
planets. The -bj switch is a calculation mode that will use JPL Horizons Web
queries to calculate the main planets and asteroids. In the Windows version,
there’s a “JPL Horizons Web Query” option in the “Calculation Method”
dropdown. Since Swiss Ephemeris is a compressed version of JPL Horizons data,
this method can be considered the most accurate astrology calculation available
anywhere, although it will only be very slightly different from Swiss Ephemeris
results themselves. Because every planet calculation involves an online Web
query, this switch results in a noticeable slowdown of the program, so shouldn’t
be used with transit searches or places that internally cast many charts. In Unix
versions of Astrolog, this works by internally doing a system shell call to the
“wget” command, which requires that utility to be installed. To avoid accidental
usage and unexpected long waits, JPL Horizons Web query features can be
permanently turned off within a session of Astrolog with the -0n switch.
-c <value>: Select a different system of house division. 0 = Placidus, 1 = Koch, 2 =
Equal, 3 = Campanus, 4 = Meridian, 5 = Regiomontanus, 6 = Porphyry, 7 = Morinus, 8 =
Topocentric, 9 = Alcabitius, 10 = Krusinski, 11 = Equal (Midheaven), 12 = Pullen
Sinusoidal Ratio, 13 = Pullen Sinusoidal Delta, 14 = Whole, 15 = Vedic, 16 = Sripati, 17
= Horizon, 18 = APC, 19 = Carter Poli Equatorial, 20 = Sunshine, 21 = Savard-A, 22 =
Null.
Astrolog supports 23 different house systems: Invoke the program as “astrolog -c
<number>” or “astrolog -c <name>” to change the system from the default of
Placidus. Note that in the Campanus, Regiomontanus, Topocentric, and Sunshine
house systems, at high latitudes (inside the Arctic or Antarctic circles) their
houses will sometimes be arranged in reverse order. Similarly, in polar regions the
natural formulas for the MC and Asc may put the Asc in the 180 degree region
before instead of after the MC. In such a case Astrolog preserves the Midheaven,
and flips the Ascendant if need be to ensure the other house cusps remain sane.
Placidus houses (-c 0): This is perhaps the most popular house system in the
world, or at least in the USA. Note that the Placidus (and Koch) system isn’t
defined and can’t be computed in a standard manner for polar locations inside the
Arctic and Antarctic circles. If the user attempts to cast a chart in this system with
a latitude beyond about 66 degrees N or S, then the program will fall back to
Porphyry houses.
Koch houses (-c 1): Similar to Placidus, this system doesn’t work in the Arctic or
Antarctic circles, and will fall back to Porphyry for polar zones.
Equal houses (-c 2): This is the most common “equal” system, in which all 12
houses are always 30 degrees in size, when measured along the ecliptic. Here the
1st cusp is the same as the Ascendant, and the 10th house is disassociated from
the MC.
Campanus houses (-c 3): The local horizon is divided into 12 equal sized wedges
along the prime vertical, and then mapped to the ecliptic. Therefore, this can also
be called “3D Equal Houses”, because its 3D model has all houses always cover
30 degree wedges (even if the 2D cross section of those wedges intersecting the
plane of the ecliptic appears to have different sizes). For more about the 3D model
of Campanus, see: [Link]
Meridian houses (-c 4): Also called “Axial rotation” houses, this system divides
the local horizon into 12 equal sized wedges along the celestial equator, which are
then mapped to the cliptic via great circles connecting the North and South
celestial poles of those wedges. The 10th cusp is same as the MC, however it
disassociates the 1st cusp from the Ascendant. (Horizon houses has this property
too.) This system will always have the 1st cusp be the same as the East Point or
equatorial Ascendant.
Regiomontanus houses (-c 5): Similar to Campanus and Sunshine, this is a
quadrant system defined by 12 wedges of space, composed by drawing great
circles connecting the North and South points on the local horizon. However
unlike Campanus, these wedges are different sizes.
Porphyry houses (-c 6): This is the simplest quadrant system, which simply
trisects each quadrant into three equal sized sections.
Morinus houses (-c 7): This system disassociates both the 1st cusp from the
Ascendant, and also disassociates the 10th cusp from the MC.
Topocentric houses (-c 8): Also called Polich-Page houses after its inventors, this
produces similar results to Placidus near the equator. Unfortunately, the formulas
for this system will sometimes produce houses that are overlapping and out of
order (and not just in reversed order) in polar regions.
Alcabitius houses (-c 9): This is an old system dating back to the 10th century,
that was more popular before Placidus and others were invented. It produces
results close to Porphyry, even when near or inside the Arctic circle (and unlike
Placidus it works in polar regions).
Krusinski houses (-c 10): This quadrant system was invented between 1993-1995
by the three astrologers Krusinski, Pisa, and Goelzer independently of each other.
Midheaven based Equal houses (-c 11): This is just like the more common
“standard” Equal house system, except that it starts with the 10th cusp being the
same as the MC and disassociates the 1st cusp from the Ascendant (instead of
starting with the 1st cusp being the same as the Ascendant and disassociating the
10th cusp from the MC).
Pullen sinusoidal Ratio houses, Pullen sinusoidal Delta houses (-c 12, -c 13):
These are relatively new systems similar to Porphyry houses, except they’re
“smooth” around the zodiac with the MC/Asc ratio or difference being spread in a
continuous sinusoidal manner from expanded to compressed quadrants. For more
information about sinusoidal systems and why they can be considered the “best
looking” house systems for wheel charts, see:
[Link]
Whole houses (-c 14): Here the first cusp is at zero degrees of the sign of the
Ascendant, and the others are all at the beginning of the succeeding signs. This is
basically the same as the Equal system with all positions shifted back to the start
of their sign. This is the ancient or traditional India style of equal houses, and is
therefore preferred by many Indian/Vedic astrologers.
Vedic houses (-c 15): Also called Vehlow houses, this is the modern India style of
Equal houses. In this system, each house covers 30 degrees, and the Ascendant is
always in the middle of the first house, i.e. the 1st cusp is always 15 degrees
before the Ascendant.
Sripati houses (-c 16): This house system is a mixture between the Vedic and
Porphyry systems. It’s computed the same as Porphyry, except that each cusp
starts in the middle of the previous house as defined by the Porphyry system.
Horizon houses (-c 17): Sometimes called “Azimuth” houses, this system divides
the local horizon into 12 equal sized wedges along the horizon line, which are
then mapped to the ecliptic via great circles connecting the local horizon Zenith
and Nadir poles of those wedges. The 10th cusp is the same as the MC, however it
disassociates the 1st cusp from the Ascendant. (Meridian houses has this property
too.) This system will always have the 7th cusp be the same as the Vertex. Note
that stepping over the equator with this house system will cause all houses to flip
180 degrees, and that near the equator house sizes may be very large or small.
APC houses (-c 18): More fully called “Ascendant Parallel Circle” (and
sometimes called “Abenragel” after its inventer) this is a quadrant based system,
however it has the interesting property that non-angular cusps aren’t always 180
degrees opposite each other.
Carter Poli Equatorial houses (-c 19): Invented by astrologer Charles Carter
(1887-1968), this system has the 1st cusp the same as the Ascendant, however it
disassociates the 10th cusp from the MC.
Sunshine houses (-c 20): Invented by astrologer Bob Makransky, Sunshine houses
has the property (similar to APC houses) that non-angular cusps aren’t always 180
degrees opposite each other. Near the poles, Sunshine houses can have five cusps
in a row overlapping, and therefore have four houses in row zero sized.
Savard-A houses (-c 21): This system is named after John Savard, and uses his
description of what he calls Albategnus houses. However, research into
Albategnius' writings shows that he never mentioned this particular house system,
which is why it's called “Savard-A” instead of “Albategnius”. It divides the prime
vertical like Campanus, but instead of trisecting the prime vertical directly, it uses
parallels of declination at 1/3 or 30 degree intervals.
Null houses (-c 22): Also called Zero Aries houses, this means no houses at all, or
in other words where the Ascendant will always be 0 degrees Aries, the Nadir 0
degrees Cancer, etc, which can be useful for extended chart animations, in which
having houses at all can get in the way. One can even observe the precession of
the equinoxes with this system if used in conjunction with the -s sidereal chart
option. Note that in graphics charts, the graphic sidebar for wheel charts won’t list
the 12 house cusp positions when the house system is set to Null, because the
house cusp positions are obvious and unchanging. This can be used as a way to
remove listing the cusp positions, if one wants more room to list the planets below
them.
Astrolog also supports 11 theoretical equal house systems. They don’t
appear as Windows menu options, and can only be selected in the “House
System” dropdown in Calculation Settings, or on the command line.
Counting these, Astrolog supports 40 house systems total:
Midheaven based Whole houses (-c 23): Standard Whole houses has the
1st house at the start of the sign of the Ascendant. Midheaven based
Whole houses has the 10th house at the start of the sign of the Midheaven.
This is similar to the difference between standard Equal houses which ties
the 1st house to the Ascendant, and Equal (MC) houses which ties the 10th
house to the Midheaven.
Midheaven based Vedic houses (-c 24): Standard Vedic houses has the
Ascendant in the middle of the 1st house. Midheaven based Vedic houses
has the MC in the middle of the 10th house.
Balanced Equal houses (-c 25): This is a mixture between Ascendant and
Midheaven based Equal houses. Here the difference between the Asc and
MC is applied to both the 1st and 10th cusps equally, so the amount the
Asc is different from the 1st cusp is always the same as the amount the
MC is different from the 10th. This is the only 2D equal system which is
able to treat all four Angles equally. On a technical level, Balanced Equal
houses places the Asc/MC midpoint in the middle of the 11th house,
which ensures a balanced distribution, as seen in this animation:
[Link]
Balanced Whole houses (-c 26): Similar to Balanced Equal houses, this is
a mixture between Ascendant and Midheaven based Whole houses. Just as
Ascendant based Whole houses has the Ascendant somewhere in the 1st
house, and Midheaven based Whole houses has the Midheaven
somewhere in the 10th, Balanced Whole houses ensures the Asc/MC
midpoint is always in the 30 degree section half way between the 1st and
10th houses.
Balanced Vedic houses (-c 27): Similar to Balanced Equal houses, this is a
mixture between Ascendant and Midheaven based Vedic houses. The end
result of these five theoretical house systems combined with the four more
common existing house systems, is a 3x3 grid of nine equal house systems
total. There’s Equal, Whole, and Vedic along one axis. Along the other
axis, each of these general concepts can be centered around the Ascendant,
around the Midheaven, or balanced between the two.
East Point Equal houses (-c 28): Standard Equal houses places the 1st
house at the Ascendant. East Point based Equal houses places the 1st
house at the East Point.
East Point Whole houses (-c 29): Standard Whole houses places the 1st
house at the start of the sign of the Ascendant. East Point based Whole
houses places the 1st house at the start of the sign of the East Point.
East Point Vedic houses (-c 30): Standard Vedic houses places the
Ascendant in the middle of the 1st house. East Point based Vedic houses
places the East Point in the middle of the 1st house.
Antivertex Equal houses (-c 31): Standard Equal houses places the 1st
house at the Ascendant. Antivertex based Equal houses places the 1st
house at the point of the Antivertex (i.e. 180 degrees opposite the Vertex).
Antivertex Whole houses (-c 32): Standard Whole houses places the 1st
house at the start of the sign of the Ascendant. Antivertex based Whole
houses places the 1st house at the start of the sign of the Antivertex (and
the 7th house at the start of the sign of the Vertex).
Antivertex Vedic houses (-c 33): Standard Vedic houses places the
Ascendant in the middle of the 1st house. Antivertex based Vedic houses
places the Antivertex in the middle of the 1st house (and the Vertex in the
middle of the 7th house). The end result of all 11 theoretical house
systems combined with the four more common existing house systems, is
a 3x5 grid of 15 equal house systems total. There’s Equal, Whole, and
Vedic along one axis. Along the other axis, each of these concepts can be
centered around the Ascendant, around the Midheaven, around the East
Point, around the Antivertex, or balanced between the Asc and MC.
East Point Porphyry houses (-c 34): Standard Porphyry houses trisects
each quadrant. East Point based Porphyry houses trisects “quadrants”
formed by the MC and East Point axes.
Vertex Porphyry houses (-c 35): Standard Porphyry houses trisects each
quadrant. Vertex based Porphyry houses trisects “quadrants” formed by
the MC and Antivertex axes.
East Point Sinusoidal Ratio houses (-c 36): Standard Sinusoidal Ratio
houses divides each quadrant based on a sine wave. East Point based
Sinusoidal Ratio houses divides “quadrants” formed by the MC and East
Point axes.
Vertex Sinusoidal Ratio houses (-c 37): Standard Sinusoidal Ratio houses
divides each quadrant based on a sine wave. Vertex based Sinusoidal
Ratio houses divides “quadrants” formed by the MC and Antivertex axes.
East Point Sinusoidal Delta houses (-c 38): Standard Sinusoidal Delta
houses divides each quadrant based on a sine wave. East Point based
Sinusoidal Delta houses divides “quadrants” formed by the MC and East
Point axes.
Vertex Sinusoidal Delta houses (-c 39): Standard Sinusoidal Delta houses
divides each quadrant based on a sine wave. Vertex based Sinusoidal
Delta houses divides “quadrants” formed by the MC and Antivertex axes.
-c3 [0-3]: Place in houses using latitude as well as zodiac position.
Astrolog supports 3D houses, which means that a planet’s house placement is
determined by its ecliptic latitude in addition to its zodiac position longitude. 3D
houses is not a standard house system, since it doesn’t affect Astrolog’s list of
house cusp objects (which are still determined by whatever house system is
active). However, 3D houses does determine which house an object is placed
within. For more details about 3D houses, see:
[Link]
In general, houses are based on the local horizon, in which the sky or celestial
sphere is divided into 12 equally sized wedges (similar to wedges of an orange)
with houses 1-6 below the horizon, and houses 7-12 above it. Similarly, houses
10-3 are to the east of the meridian, and houses 4-9 are to the west of the
meridian. The signs of the zodiac are also a set of 12 wedges, however they're
oriented to a different coordinate system, or more specifically are rotated to be
aligned with the ecliptic.
Campanus is the standard house system most similar to 3D houses, because
Campanus houses are defined by the intersection of the ecliptic with the 12 equal
sized house wedges. That means Campanus houses and 3D houses give the same
house placements for planets exactly on the ecliptic. Since most planets are near
the ecliptic, and it's only objects like asteroids and especially stars that are located
any significant distance from it, Campanus is a rough approximation of 3D
houses. Therefore, Campanus is probably the best house system to use with the
3D houses setting, because 3D Campanus is basically “3D Equal houses”, in
which each 3D house is an equal sized 30 degree slice of the celestial sphere.
However, every standard house system has a corresponding 3D house system in
Astrolog, defined by great circles drawn from the due South point to the due
North point on the local horizon, passing through each 2D cusp where it intersects
the ecliptic. For an example of 3D Placidus houses, see:
[Link]
When 3D houses are active, it affects charts in the following ways:
Standard radix (-v switch): The indicating of what house a planet is within
is based on the 3D house model being used, and not only the house cusp
zodiac positions of whatever house system is active.
Graphic wheel (-v -X switches): The positioning of planets around the
wheel is based on its proportion through the house, and not its zodiac
position. Normally the wheel is “zodiac focused” and a planet is placed
based on its zodiac longitude, with its latitude (and how latitude affects 3D
house placement) ignored. When 3D houses are on, the wheel is instead
“house focused”. That means positioning is based on the proportion a
planet is through its house, e.g. a planet 1/5 of the way through the 3rd
house will be positioned 1/5 of the way through the 3rd house in the
wheel, regardless of the planet’s zodiac longitude. The result is planets
seem to shift slightly, especially if their latitude is different from 0.
Text local horizon (-Z switch): Positions will be displayed in prime
vertical mode (as with the -Z0 switch), because prime vertical coordinates
define houses, in which the azimuth or 0-360 degrees (representing house
positions 1-12) follows the prime vertical from the horizon east point
through the west point via the nadir. Similarly, the altitude or -90 to +90
degrees ranges from the north to south points on the local horizon. In
addition, instead of a 0-360 degree number, the azimuth will be expressed
as the house position 1-12, along with the percentage the object is through
the house from 0-30 degrees.
Graphic local horizon (-Z -X switches): Both versions of the graphic local
horizon chart will have added to it an overlay of dark green lines showing
the 3D houses (with each house labeled 1-12), and dark blue lines showing
the signs (with each sign labeled with its glyph). These two sets of
overlapping wedge shapes can make it clear how 3D houses differ from
house determination by zodiac longitude only.
Graphic solar system orbit (-S -X switches): Planets will be drawn on a
logarithmic scale, resulting in planetary orbits roughly equally spaced.
One issue with the normal chart is that unless one is really zoomed in, the
inner planets are crammed together and harder to see. The Moon and Node
objects will be spaced farther away from the Earth too, so they will be
more visible as well. The video [Link]
v=jSZzytVUzgI shows this in action, in which the Moon can be seen
orbiting the Earth, while Earth and the other planets can be seen orbiting
the Sun. Similarly, all 27 planetary moon objects (if unrestricted) will be
displayed an appropriate distance from their planet, allowing an
astronomically accurate display of the Sun and all planets, in which all
moons around those planets will also be visible at the correct angle around
them. For an example of this see:
[Link]
Chart sphere (-XX switch): As with the graphic local horizon chart, this
chart has the ability to highlight house boundaries in 3D as well as 2D. 2D
house boundaries share the same “poles” as the zodiac itself, and the size
of each house’s wedge will be determined by the house system in effect.
In contrast, 3D house boundaries are anchored to the North and South
points on the local horizon, and at least for 3D Campanus will always be
equal sized wedges. Toggling the 3D houses setting while viewing the
display is an easy way to visualize the difference between 2D and 3D
houses. Showing 2D or 3D houses assumes that houses boundaries are
being shown in the first place, which is toggled by the show house details
setting (-XC switch). Note that chart spheres always draw the horizon
(which the Ascendant is on) and meridian (which the Midheaven is on),
which means 3D non-quadrant systems (which disassociate the 1st cusp
 from the Ascendant and/or the 10th cusp from the Midheaven) will show
13 or 14 lines crossing the sphere instead of just 12.
Graphic globe (-XG switch): When “Modify Display” setting is active (-
Xi switch) which causes the planets to be drawn over the globe at their
zenith positions, the globe will have an overlay in dark green lines
showing the ecliptic and sign wedges. This applies to both the globe
showing the Earth’s continents (which looks “down”) and the celestial
sphere showing the astronomical constellations (which looks “up”).
Astrolog supports three different models of 3D houses. To select the model, pass
an optional numeric argument to the -c3 switch, or in the Windows version select
the desired “3D Houses Plane” in the Calculation Settings dialog. The 3D
boundaries of the different 3D house models can be seen in Astrolog’s graphic
local horizon, chart sphere, and telescope charts. The 3D house models supported
are:
1) Prime Vertical: Houses are arranged along the prime vertical, and have
their poles (where the 12 houses meet) at the North and South points on
the local horizon. Note that Campanus houses combined with this 3D
model is a “3D Equal system”, in which all houses are equal sized 30
degree wedges of the celestial sphere. As with 2D Campanus houses, the
Ascendant will always be on the 1st house boundary line, and the MC on
the 10th house boundary line. This is the default and preferred model for
3D houses, because for quadrant systems it ensures that all parts of houses
1-6 are below the horizon, and all parts of houses 7-12 are above the
horizon.
2) Local horizon: Houses are arranged along the local horizon, and have
their poles at the Zenith and Nadir points straight up and down on the local
horizon. Note that Horizon houses combined with this 3D model is a “3D
Equal system”, in which all houses are equal sized 30 degree wedges of
the celestial sphere. As with 2D Horizon houses, the Ascendant won’t
necessarily be on 1st house boundary line, but the Vertex will always be
on the 7th house boundary line. As with Horizon houses themselves,
stepping across the equator will flip all houses 180 degrees.
3) Celestial Equator: Houses are arranged along the celestial equator, and
have their poles at the celestial poles or the points directly above Earth’s
North and South poles. Note that Meridian houses combined with this 3D
model is a “3D Equal system”, in which all houses are equal sized 30
degree wedges of the celestial sphere. As with 2D Meridian houses, the
Ascendant won’t necessarily be on 1st house boundary line, but the East
Point will always be on this boundary.
0) Ecliptic: Houses are arranged along the ecliptic, and have their poles
(where the 12 houses meet) at the North and South ecliptic poles. This is
classic 2D houses, because signs are also arranged along the ecliptic and
 use the ecliptic poles, which means only zodiac position longitude is used
to determine house placement. Passing 0 to the -c3 switch turns 3D houses
off, although it doesn’t change which of 1-3 is the default 3D house model
used when the -c3 switch (specified without an argument) turns 3D houses
on. An image of all four house models side by side on the celestial sphere
can be seen at: [Link]
-s [<offset>]: Compute sidereal zodiac instead of tropical zodiac.
With this option, the chart will be just like the normal charts as most commonly
used in Western astrology, except that all the zodiac positions will be shifted (to
be about 25 degrees earlier). This is because the option casts sidereal charts which
are based on the positions of the fixed stars (i.e. Aries starts at the constellation
Aries) rather than the seasons (i.e. Aries starts at the Spring or Vernal Equinox.)
Due to the “precession of the equinoxes” the position of the Sun at the Equinoxes
has been gradually happening at an earlier point in the sidereal zodiac each year
(taking about 2147 years to change signs.) Note that in the sidereal zodiac, planet
velocities are slightly lower, to align with the fact that sidereal zodiac positions
are all precessing backwards very slowly.
This switch accepts an optional parameter of an offset for the start of the zodiac.
This value, when non-zero, will be added to all sidereal zodiac positions, and
effectively allows one to choose any starting point for the sidereal zodiac, which
is useful for Indian/Vedic or other systems whose sidereal zodiacs have 0Aries at
a different location than the standard Fagan-Bradley sidereal zodiac that the
program uses by default. For example, “-s 10.5” will add 10 degrees and 30
minutes to all sidereal zodiac positions. These sidereal zodiac ayanamsas can be
also specified by name in addition to a particular offset in degrees, e.g. “-s Lahiri”
works as well as “-s 0.883208”. This value is initialized to a zodiac offset value in
the [Link] default settings file, which is by default zero.
-sr: Compute right ascension locations relative to equator.
This will display planetary positions relative to the Earth’s equator instead of the
ecliptic i.e. Earth’s orbit. This is the way more commonly used in astronomy, and
results in real right ascension notation, especially when combined with the -s
sidereal zodiac and -sh hours and minutes display format. This switch makes the
declination values in the standard -v listing also relative to the equator, instead of
the ecliptic latitude displayed by default, where “Declination” will be printed at
the head of the column instead of “Latitude”. (Without this the only way to get
such information is from the zenith latitudes in the -L astro-graph chart which
show the same thing.) Note that this setting isn't fully integrated with all of
Astrolog’s charts; specifically it will distort the values in the -Z local horizon and
-L astro-graph charts which assume ecliptic positions, and hence -sr shouldn't be
combined with these options.
-sr0: Like -sr but only display declinations instead of latitudes.
 Astrolog can display vertical planet coordinates as equatorial declination (instead
of as ecliptic latitude, which is the default). To do this, turn on the -sr0 switch
(which is also available in the Windows version by turning on “Equatorial
Latitudes” in the Calculation Settings dialog). This is an extension of the -sr
switch, which turns on equatorial coordinates for both longitude and latitude (but
may be less useful since it distorts zodiac position longitudes). These two settings
together can cover all four combinations of ecliptic versus equatorial coordinates.
For example “=sr _sr0” will result in equatorial longitudes and ecliptic latitudes,
by turning on equatorial for both and then turning off equatorial latitudes.
-s[z,h,n,d]: Display as zodiac, hr/min, Nakshatras, or 0-360 degrees.
For astronomers, the -sh switch will express all planetary positions in the right
ascension hours/minutes format instead of the sign/degrees/minutes astrologers
are accustomed to. This will affect how the objects are listed in most charts, such
as the -v position list, the -E text ephemeris, and how star azimuths are displayed
in the -HO list. For example, 0 degrees Aries is represented as 0 hr, 0 min; 0
Cancer goes to 6 hr, 0 min, and so on through the 24 hour clock.
The -sd switch will cause zodiac positions to be displayed as a simple decimal
degree number in the 360 degree circle. This setting will also apply to longitude
and latitude values in charts, including the standard -v text chart listing and
graphic wheel chart, and the -E text mode ephemeris when listing latitudes. To
return to the default of displaying as degrees and minutes within a zodiac sign,
use the -sz switch.
Astrolog can also display zodiac positions in Vedic Nakshatra or lunar mansion
format, which divides the zodiac into 27 equal sized divisions of 13:20 degrees
each (and each Nakshatra is in turn divided into four quadrants or Padas). The -sn
switch will display zodiac longitudes as Nakshatras, and in the Windows version
the “Display Format / 27 Nakshatras” option in the Display Settings dialog will
do the same. For example, 0Lib00 will be displayed as “14Chit3”, which means
the 14th Nakshatra (named “Chitra”) and the 3rd Pada within it. If the “print
nearest second” setting is on, then the position will be displayed with more detail:
The Pada will indicate the fractional amount through it (e.g. half way through
Pada #1 will be displayed as “1.5”) and the corresponding Navamsa sign to that
Pada will be displayed (i.e. the sign abbreviation appended to the position will be
the same as the zodiac position as a whole if the -9 switch Navamsa mode were
turned on). For example, 0Tau00:00 would be displayed at “3Krit2.0Cp”, which
means the 3rd Nakshatra (named “Krittika”) and the start of the 2nd Pada within it
(which corresponds to Capricorn in Navamsa).
-h [<objnum>]: Compute positions centered on specified object.
Standard astrology charts are geocentric, which means based on the positions of
the planets relative to the Earth. This option allows seeing of the zodiac positions
with respect to the Sun’s (or any other planet’s) point of view. The -h option when
invoked by itself will display a heliocentric chart, in which the Sun in the original
 listing will be replaced with the Earth’s position as seen from the Sun, with the
other planets’ positions modified accordingly. (For example, the Moon and the
Moon’s Nodes in a heliocentric chart will always be very close to the Earth, since
they’re relatively near together in space.) For bodies other than the Sun, this
option takes a parameter to indicate which planet to center the chart on, e.g. do -h
5 to cast a Mars centered chart.
The -h central planet setting even supports star objects. This means you can cast a
chart centered on another star, and see how the stars and constellations appear
from the position of that star. Stars are very far apart from each other, and the
closest star to our Sun is 4.4 light years away, or nearly 10,000 times farther away
than Neptune. As a result, from other star systems all the planets will appear very
close to the Sun (within one arc minute or even narrower depending on the star).
Note that the object “Andromeda” or M31 is actually a galaxy, which means
casting a chart centered on it will actually do a chart from the perspective of
another galaxy! Because the Andromeda galaxy is 2.5 million light years away,
from its point of view all the other stars will appear very close together (within
3.5 arc minutes).
There are a few limitations for charts other than geocentric or heliocentric. Planet
velocities will be the heliocentric position velocities, and apparent positions that
take into account the speed of light will be based on heliocentric distances (which
means using the -YT switch true positions setting is recommended). Moon
centered charts are allowed, however note that when the old Matrix formulas are
being used, the -h option won't ever affect the Moon, which will always be
displayed as seen from the Earth, no matter what the center body is set to, since
it’s not a formal planet.
-p <month> <day> <year>: Cast secondary progressed chart for date.
A secondary progression chart for a particular date can be cast using the '-p
<month> <day> <year>' command switch. The precise time within the given day
progressed to is midnight in the default time zone. House cusps are progressed
using the quotidian method, which means cusps move about 360 degrees each
year in the progressed chart, because they move about 360 degrees each day in a
standard chart.
This setting to progress charts may be turned off by invoking the -p switch as
“_p” with the underscore reset prefix. Unlike the standard -p switch, _p takes no
parameters. This is a command switch trick only useful when doing multiple
charts in a -Q loop, or when passing extra command lines to a graphics screen
with the return key or through macros.
-p0 <month> <day> <year>: Cast solar arc chart for date.
Solar arc progressions are supported in addition to secondaries. Invoke the -p
<month> <day> <year> switch as -p0 instead, and a chart will be generated with
all planets and house cusps progressed forward an amount equal in degrees to the
 number of years that have passed between the specified date and the chart in
question. The -pd option here (see below) specifies the number of days that have
to pass per zodiac degree to progress forward; by default this is 365.24219. To
generate a solar arc chart for the current moment now, invoke the -pn switch as -
p0n.
-p1 <month> <day> <year>: Like -p but with solar arc cusps only.
Astrolog supports a mixed progression mode in which the planets are secondary
progressed (meaning planetary positions are computed at a future date) but house
cusps are progressed by solar arc (meaning the same offset is applied to all cusps).
Use the -p1 switch to do progressions of this type. (Note that “p1” can be used in
all switch contexts that “p” for secondary progressions can, and “p0” for solar arc
progressions can.)
-p[0]t <month> <day> <year> <time>: Like -p but specify time too.
The -pt switch is just like -p, except in addition to month/day/year parameters for
the date to progress to, it also takes a fourth parameter for the time within the
date. Progressed charts usually move so slowly that one doesn’t care about time,
but time can be specified for extra precision.
-p[0]n: Cast progressed chart based on current date now.
The -pn switch is like the -p <month> <day> <year> switch except that (like the -
n switch) it assumes the current moment now to cast the progressed chart to. This
is just another shorthand convenience to see what ones progressed chart is like
presently; just do: astrolog -i file -pn.
-pd <days>: Set num of days to progress / day (default 365.24219).
User definable progression rates can be specified with this option. When using the
-p progression option, Astrolog assumes you want the standard “year for a day”
rate of secondary progressions. By passing different values to the -pd switch, one
can change the default “365.24219 days for a day” to any value they want for
some less often used method of progression. For example, one can do “-pd 7 -pn”
to do a week for a day, “-pd -365.24219 -pn” to get negative year for day
progressions, and so on. For tertiary progressions based on a synodic month do “-
pd 29.530588”, for tertiary progressions based on the sidereal month do “-pd
27.321661”, and for primary directions or a year per four minutes do “-pd
131487.188”. (Note that “-pd 1” would be the same as if no progression were
done at all.)
-pC <days>: Set factor to use when progressing cusps (default 1.0).
The rate that progressed house cusps move (whether computed or by solar arc)
compared to the default can be specified. Use the -pC switch to set this value. For
example, Astrolog’s default for secondary progressions is quotidian, which means
the cusps move 360 degrees around the zodiac each day. However, other types of
 progression have the cusps move the same speed as the Sun. Change the cusp
move ratio field from “1” to “365.24219” and that will make cusps move
365.24219 times slower, which will make them move just 1 degree per day, about
the same as the Sun.
-x <value>: Cast harmonic chart based on specified factor.
Harmonic charts are supported with the “-x” switch. In a harmonic chart, all the
planet positions are multiplied by a factor in the calculated chart, for example “-x
3” will make all Trines in the chart become Conjunctions. The parameter passed
in may be any number, including decimal or negative numbers, ranging anywhere
from 1 (i.e. no harmonic factor) to 9999999 for those who want to explore
extreme harmonics.
-1 [<objnum>]: Cast chart with specified object on Ascendant.
The -1 <obj> option can be used to change the houses to force a particular object
to be on the Ascendant. This is useful in casting Solar charts or for when the time
of birth is not exactly known. For example -1 Moo will cast a normal chart, but
the house cusps will be rotated so that the Moon is on the Ascendant.
If the -1 switch is invoked as -10, then instead of rotating house cusps so that the
Ascendant is the same as the Sun, it will rotate house cusps so that the Ascendant
is the same as the start of the Sun’s sign. Similarly, the -20 switch acts like the -2
switch below, and does the same for the Midheaven.
-2 [<objnum>]: Cast chart with specified object on Midheaven.
Just as the -1 option is used to cast a chart with an object on the Ascendant, the -2
<object> switch will cast a chart with the specified object on the Midheaven. The
house cusps will be rotated so that the object in question is conjunct the 10th
house cusp. As with the -1 option, if <object> is not specified, the Sun will be
assumed by default.
-3: Display objects in their zodiac decan positions.
Decan displays are supported in Astrolog, and one can display a decan influenced
chart with the -3 switch. The decan theory is that each sign in the zodiac can be
divided into three parts: The first 10 degrees (i.e. the first decan) is mainly
influenced by the sign in question, the second 10 degrees (second decan) although
still influenced by the sign in question is also somewhat influenced by the next
sign of the same element, while the last decan is influenced by the third sign of
the same element. The -3 switch applied to a chart will move each object into the
sign of its decan. For example, if the Sun is at 29 degrees Aquarius and the Moon
at 5 degrees Virgo, in the resulting chart, the Sun will go to Libra (26 degrees)
and the Moon will remain in Virgo (although be at 15 degrees now since it was
previously in the middle of the first decan of Virgo.)
-4 [<nest>]: Display objects in their (nested) dwad positions.
 Turn on a dwad transformation of planet positions with this switch. Dwads (also
called dwadasamsa or dodecatemoria) divide each sign into 12 subsigns, similar
to the 12th harmonic, however unlike simple harmonics each subsequence starts
with the current sign. Dwads can be nested multiple levels deep, similar to a
fractal: This switch takes an optional parameter indicating how many nestings to
apply, which should be a number 0 or greater.
-f: Display houses as sign positions (flip them).
The -f option can be used to “flip” the signs and houses, i.e. display the house as a
sign position and vice versa. For example having the Sun at 26 degrees Scorpio,
2/3 way though the 10th house, will cause the resulting Sun under the -f option to
be at 20 degrees Capricorn, 26/30th the way through the 8th house. This can be
used to determine how far a planet is through a particular house, as well as for
domal chart analysis that Mark Kenski has informed me about. Domal analysis is
based on the fact that for synastry comparisons, for example, a planet in Gemini
and one in the 3rd house can be considered related in a way similar to a
conjunction.
-G: Display houses based on geographic location only.
This switch generates a special type of locational analysis chart, called a geodetic
chart, in which the house cusps are computed from a different source, i.e. as a
function of only the longitude and latitude. This basically gives every spot on the
planet a different unique set of house cusps, and can be used to analyze the
characteristics of different areas, and their influence on you if you insert your own
planets in the houses. This type of chart was described in the January 1992 issue
of Dell Horoscope magazine, from which I learned how to generate these charts.
Basically, the Midheaven is approximately the longitude value converted from
degrees into the appropriate zodiac sign. For example 0 degrees E goes to 0
degrees Aries, 30 degrees E goes to 0 degrees Taurus, etc.
-J: Display wheel charts in Indian format.
Astrolog can display wheel charts in Indian (i.e. Vedic/Hindu/Jyotish) format.
This will affect both the text -w wheels and the graphic wheels (including the
Gauquelin sector wheel). An Indian format wheel is identical to a Western wheel
except: (1) The signs and houses increase as you go clockwise instead of
counterclockwise, so the entire wheel is flipped over. (2) The chart is rotated so
the left edge is always the start of Aquarius instead of the Ascendant, putting
Pisces in the upper left corner, meaning the Ascendant is placed wherever in the
wheel is appropriate. For Indian astrology one will probably prefer to combine
this with the -w house focused wheel chart switch so all the houses are the same
size, or even display that chart in text mode so the wheel will be a square.
-9: Display objects in their zodiac Navamsa positions.
This command switch will display the chart in the Navamsa format used in
Indian/Vedic astrology. The Navamsa or marriage chart is formed by applying a
 formula to each planet position to get a resulting new location. This is similar in
operation to the -3 decan feature, however this divides each sign into ninths.
Specifically, to convert a position, see which ninth of a sign a planet falls in, e.g. a
planet from 0 degrees 0' to 3 degrees 20' of a sign is in the first ninth, a planet
from 3 degrees 20' to 6 degrees 40' is in the second ninth, and so on. Take that
number, and count one less than that many signs ahead in the zodiac to get the
resulting sign. The starting sign should be Aries if the original sign was Fire,
Capricorn if the original sign was Earth, Libra if the original sign was Air, and
Cancer if the original sign was Water. A formal Navamsa chart only considers
signs, hence only the sign of each planet will be changed, and the degree within
each sign will be unaffected.
-F <objnum> <sign> <deg>: Force object’s position to be value.
The -F option is used to force a particular object’s position to always be a
particular location in the zodiac. This feature can be used as an easy way to
manually include things Astrolog normally doesn't in various charts. For example,
this can be used to force the position of some minor thing, like the Vertex, to
always be the location of whatever you prefer, like the 0 degrees Aries point, or
an important midpoint. Then you can do an aspect grid, transit search, or
whatever, and calculate aspects to midpoints or transits over midpoints. The -F
switch takes three arguments: first is the index of the object to replace, next is the
sign to force it to be, and third is the degree within the sign. For example, if I
want to see if anything is making an exact aspect today with my Sun Moon
midpoint at 6Sag28, I could do “astrolog -n -d -F Nod Sag 6.4667”, which would
replace the North Node with my Sun Moon midpoint in the aspect search. To turn
off the effect of this switch, do “_F <objnum>” without any other arguments.
-Fm <objnum> <obj1> <obj2>: Force object's position to midpoint.
The -Fm option will force an object’s position to always be the midpoint between
two other objects. For example, an easier way to replace the North Node with my
Sun Moon midpoint is “-Fm Nod Sun Moo”. Note all -F switch forcings are
applied in object index order, so it’s possible to have midpoints involving other
midpoints, as long as the more complex midpoints have higher indexes.
-+ [<days>]: Cast chart for specified num of days in the future.
The -+ <#ofdays> option will cast a normal chart, but one for #ofdays in the
future (or past if a negative value is given). One use for this is in combination
with the -n and -d options. For instance, I often invoke the program as “astrolog -
n -d” to see the exact times of today’s aspects. However, just before midnight I
might want to see what’s going to happen in the following day, so I would do
“astrolog -n -d -+ 1” to see the exact times for tomorrow’s aspects. The #ofdays
parameter is optional, and will default to one if left off, so the above command
can be done as just “astrolog -n -d -+”.
 Note that for such a chart, the chart header will show the correct date of the actual
new chart, instead of the original one. For example, if today is Nov 19, and I do
“astrolog -n -+ 2”, then I will get the chart for two days from now, and the chart
header will display Nov 21. This has some special uses. For example, if you want
to know what the date was or will be when you are 10000 days old, do “astrolog -i
yourchart -+ 10000” and see what the date in the resulting chart header is.
-- [<days>]: Cast chart for specified num of days in the past.
This “dash minus” option is just like the “dash plus” (-+) option described above,
except it subtracts instead of adds the specified number of days from any chart
cast. This is only for convenience, in that “-- 1” is the same as “-+ -1”.
-+[t,m,y] [<num>]: Cast chart for num of hours/months/years in future.
The -+t switch is just like the -+ switch above except that it will add one hour to
whatever chart instead of one day. Similarly, -+m switch will add one calendar
month to whatever chart, and the -+y switch will add one calendar year to
whatever chart. The -- “dash minus” switch is extended in a similar manner, in
that --t, --m, and --y will do as expected. These switches also have the optional
parameter to specify how many hours (which may be a floating point number),
months, or years to move forward or back.

Switches for relationship and comparison charts:

-r <file1> <file2>: Compute a relationship synastry chart.
Computing the relationship between two charts is supported. Invoke the program
as 'astrolog -r <file_of_person1> <file_of_person2>' and the program will give
you the relationship between the two charts. In other words, the program will use
the positions of person2’s planets and person1’s houses. Use this with the -w
option to get a wheel chart and you can do synastry. Note that transits can be
computed with this by comparing your chart with the positions of the planets at
the current moment (as in -n switch). To make this easier, you may specify the
filename “now” for any file and the computer will use the current planet positions
instead of looking for a like named file. (e.g. 'astrolog -r me now' will compute
transits for file 'me'.)
Note: if the -r switch is invoked as “_r” with the underscore reset prefix, any
relationship mode will be canceled. Unlike the standard -r switches, _r takes no
file parameters. This is a command switch trick only useful when doing multiple
charts in a -Q loop, or when passing extra command lines to a graphics screen
with the return key or through macros. Astrolog’s -r relationship chart switches
set relationship chart mode, and without this there’s no easy way to return to
single chart mode. Yes, when a graphics screen is up, the 'c' key will toggle
relationship comparison mode, but that’s not available from the command line.
-rc <file1> <file2>: Compute a composite chart.
 The '-r' option can be used to generate composite relationship charts. Simply
invoke it as '-rc <person1> <person2>' instead of just -r and a composite chart (i.e.
composed of the midpoints of the planets, etc. of the two charts in question) will
be generated. (Note: when the house cusps in the two charts are nearly 180
degrees apart, simply taking the midpoints of all the cusps may result in them
being out of order in the resulting composite. In such a case we give priority to
the composite midheaven, and invert the midpoints of any of the other cusps or
the Ascendant by 180 degrees if leaving them that way would have things out of
order.)
-rm <file1> <file2>: Compute a time space midpoint chart.
Time and space midpoint relationship charts are supported: Doing “-rm chart1
chart2” will calculate the time and location exactly half way between the times
and locations as indicated in the two files. This type of chart is also called a
Davison chart. Unlike all other types of relationship charts, this one actually exists
in space and time, and therefore can be treated like a single chart and can be
output to a file with the -o option.
These charts normally take the midpoint of longitudes and the midpoint of
latitudes separately to determine the location of the resulting chart. However, if
the 3D houses setting (-c3 switch) is on, then the midpoint location will instead be
the true midpoint along the great circle between the two points on the globe.
-r[c,m]0 <file1> <file2> <ratio1> <ratio2>: Weighted chart.
The -rc composite and -rm time-space midpoint relationship charts may be
weighted to give more influence to one of the charts. When the switches are
invoked as -rc0 or -rm0 they accept two additional parameters which are the ratio
weights to give to the two chart files in question. For example, the sequence “-rm
person1 person2 2 1” will still do a time space midpoint chart, but the time and
location that the chart is cast for will be biased at a 2:1 ratio toward person1, i.e.
will be 2/3 of the way from person2’s chart info closer to person1’s info.
Note that the -rc0 switch can be used to generate multiple composite charts
between more than two people! A composite chart between two people can
already be done and saved to a file with “-rc person1 person2 -o0 composite12”.
A third person can now be merged in by doing a composite between it and the
composite of the first two, but giving the first result a 2:1 ratio because two charts
have already gone into it, by “-rc0 composite12 person3 2 1 -o0 composite123”.
A fourth person can then be merged in at a higher ratio with “-rc0 composite123
person4 3 1 -o0 composite1234” and so on. Actually this method won't always
generate a 100% correct multiple composite chart in cases where the objects are
spread out over 180 degrees and the initial composites put the current midpoint in
the wrong half, e.g. if the Suns of person1 through person3 are 1Can, 29Sag, and
0Ari, then the true composite Sun is at 0Ari, but composite12 is at 0Lib and hence
the final composite is at 0Leo or 0Sag, in the wrong “quadrant” biased toward the
 earlier results. Still the results are useful and the method can be used with -rm0 to
get the correct average between multiple chart locations.
-rd <file1> <file2>: Print time span between files' dates.
One useful non-astrological function in the program is the ability to determine
how much time has passed between two dates, with the -rd switch. As with the -rb
option below, this is considered a relationship “chart” because it requires the input
of two different dates, and when -rd is in effect, again the standard -v planet
position listing will be replaced by a line telling how much time has passed in the
interval. The time difference is expressed in seven ways: in years, months, weeks,
hours, minutes, and seconds (displayed to two decimal places). Also, the
difference in location between the two charts is included. The degree differences
between longitude and latitude are shown, as is the actual distance between the
two spots on the globe when measured around a great circle (displayed to the
degree, as well as in miles or kilometers based on whether the European length
format is active). For example, “-rd person1 person2”, will display how many
years, days, etc person1 is older than person2 (or the other day around). Want to
say know how many years older your mother is than you? Just do “-rd momchart
yourchart”. Want to find out how many days old you will be on Jan. 1, 2030? Do
“-rd yourchart tty”, and type in the first date of the next decade, and see what you
get!
-rb <file1> <file2>: Display biorhythm for file1 at time file2.
Biorhythm charts are supported by Astrolog with the -rb switch. Although not
directly related to Astrology, the concepts are similar, and adding this didn't
require much extra code, and since some are interested in this, I felt I'd add it in.
The biorhythm theory says that we have three main types of energy: Physical,
Emotional, and Intellectual. These three run in continuous wave cycles from high
to low, each of which repeats about every 30 days or so. Therefore, a biorhythm
chart for a particular day should describe how much energy one has or how they
are feeling in this area. Now, Astrolog considers biorhythm charts as a type of
relationship chart, because in order to generate one, two dates or charts are
needed: the birth date of the person, and the date to cast their chart for.
Technically the program will replace the standard -v listing of planet positions
with the biorhythm chart when -rb is in effect. As an example, “-rb file1 file2”
will cast the chart for the birthday signified by chart1 or chart2 (whichever is
older) for the date in the other file. Remember that one can substitute the pseudo
filename 'tty' to mean get the chart info from the terminal instead.
The actual biorhythm chart itself will display, for the day in question, what the
percentages of the physical, emotional, and intellectual cycles are, as numbers
from -100% (low ebb) to +100% (happy and full of energy). In addition, the
biorhythm percentages for the seven days before (T-7 days) and the seven days
after (T+7 days) the date in question will be listed, too, so one can see if the
cycles are rising or falling. Finally, as a cute way to help in interpretation, the
program prints the appropriate smiley, medium, or sad face after each percentage.
 (Note that it takes over 58 years for all three cycles together to synchronize and
repeat themselves.)
-r0 <file1> <file2>: Keep the charts separate in comparison.
There is a distinction between any of the above types of particular relationship
charts and the actual comparison between two separate charts. The -r0 option is
used to generate actual comparison charts. For example, combining -r0 with the -g
switch will cause a full grid chart of the aspects between all the planets of the two
charts (with person1’s planets on the vertical axis and person2’s on the horizontal)
to be displayed. (Note that if all 20 standard objects are unrestricted here, the text
mode grid will exceed 80 columns, unless the -Y8 80 column clip feature is
turned on.) The -r0 option can also be used with the -X switch to generate true
relationship bi-wheel charts. The -r0 option will act like the -r synastry option for
those displays which can't compare two charts. (Note the “-y file” current transit
option is basically a shorthand way of doing “-r0 file now”.) If you want to enter
relationship comparison mode without specifying files, use the -r2 switch which
takes no parameters.
Comparison relationship charts may be generated for the standard -v text listing.
This is the text mode version of a bi, tri, or quad wheel chart, and is displayed
with the -v -r0 switch combination. The two to four charts covered will each have
of their planet positions (both zodiac position and latitude) listed side by side.
Also included is a delta, listing the distance between each pair of planets, or the
maximum distance between any two planets in the case of tri and quad charts.
This delta distance is the difference between zodiac positions (unless the 3D
aspects setting is active, in which case it will be the great circle distance taking
latitude into account too).
Comparison relationship charts may also be generated for the -m midpoint and -a
aspect list options. Combining -m with -r0 will yield an ordered list of all
midpoints between all combinations of one planet from chart1 and another planet
from chart2. Combining -a with -r0 will yield a list of all aspects between planets
in the two charts, in order based on what Astrolog think their influences are. So, if
you really want to know if your Sun widely trining your partner’s Moon, will
override the effect of your Saturn closely squaring their Mars, do “astrolog -r0
yourchart theirchart -a” and see the influence given to each aspect.
-rp[0] <file1> <file2>: Like -r0 but do file1 progr. to file2.
This switch is a form of the -r0 relationship comparison charts. This switch, given
two files, will compare the natal chart in file1, to the chart of this natal chart
progressed to the time specified in file2. This is a shorthand way to the commonly
desired comparison of a progressed chart to a natal one. The -y switch may be
invoked as -yp <file> which will automatically compare the chart to the current
time now. For example, to get a dual graphic wheel chart with your natal planets
in the inner wheel, and your current progressed chart on the outer wheel, simply
do “-yp yourchart now -X”. (There is no easy way to do this otherwise, short of
 using -o0 position files, since the -p progression switch will affect all charts.) The
-rp switch may also be invoked as -rp0, which will do the same thing but as a
solar arc progression instead of a secondary progression. Similar to with the -rt
switch, transit restrictions will affect the progressed chart.
-rt <file1> <file2>: Like -r0 but treat file2 as transiting.
The -rt switch will behave exactly like the existing -r0 chart comparison option
but with a difference: Transit restrictions will affect the second chart. With -r0,
both charts are treated as natal charts and hence the normal -R restrictions apply
to both. However, one may want to have different sets of planets active in the two
charts, such as in a wheel chart where transiting planets are being compared to
natal. Another difference with this transit and natal comparison relationship chart
is that it sets the velocity for all natal planets to 0, so aspects show whether
transits to natal planets are applying or separating correctly.
The -y switch which is like the -r0 switch but assumes the current moment now
for the second chart, may be done as -yt in the same way. For example, to do a
graphic bi-wheel showing your complete natal chart in the inner wheel, and only
the current transiting outer planets on the outer wheel, do “astrolog -yt
[Link] -X -RT0 jup sat ura nep plu”.
-r[2-6]: Make graphics wheel chart tri-wheel, quad-wheel, etc.
Astrolog can do tri-wheel, quad-wheel, quin-wheel, and hexa-wheel graphics
charts. These are like the standard and bi-wheel charts, but with a third, fourth,
fifth, and sixth ring of planets. The standard or first chart in memory is placed on
the outer wheel, next in is the second chart in memory, and the third charts and
beyond are farther toward the inside. (Note this is different from the bi-wheel
graphic which has the first chart on the inside and the second on the outside.) If
the graphic sidebar is showing, the house cusps listed will correspond to the chart
info in the first ring, and the planets listed will correspond to the last ring. Lines in
the middle of the chart will show aspects between planets in any two different
pairs of charts present. In other words, a bi-wheel shows aspects between chart #1
and chart #2, a tri-wheel shows aspects between chart #1 and #2, #1 and #3, and
#2 and #3, and so on for quad-wheels and beyond. When the -XC house details
display flag is off, the program will draw dotted lines from each planet in the
outer rings to the inner one, as is done by default in the bi-wheel chart. The -r3
switch, taking no parameters, puts one in tri-wheel mode, and -r4 through -r6
switches put one in quad-wheel, quin-wheel, and hexa-wheel modes. (You can
also do -r2 to enter bi-wheel mode, and -r1 or _r to return to the standard single
wheel.) Bi-wheel and beyond charts will highlight the space between the different
planet rings with dark green circles. (This color can be customized, or set to black
to remove the highlighting altogether.)
-y <file>: Display current house transits for particular chart.
 The command switch '-y <file>' can be used as a shortcut way to compute the
current transits for the chart in <file> (unless the TIME features are compiled
out), which saves you from having to mention the “now” in the -r0 option.
-y[b,d,p,t] <file>: Like -r0 but compare to current time now.
The -y option is extended based on the -rb and -rd features. The -yb <file> switch
will display the person indicated in file’s biorhythm for today. The -yd <file>
switch will display how many months, days, etc old the person in the file is right
now. Want to know how many minutes old you are? Just do “-yd yourchart”. Do
the same command again right away and see that you are now a couple seconds
older than the first time! There are also switches -yp[0] and -yt which similarly
behave like -rp[0] and -rt above but automatically compare to now.

Switches to access graphics options:

-k: Display text charts using Ansi characters and color.
With this option, the text charts may be displayed in color, as well as with real
graphics characters instead of using things like dashes and pluses. This makes the
text charts look almost as neat as their color graphics counterparts. All that’s
needed is a terminal that accepts Ansi escape sequences. You will get garbage if
you include -k on a non-Ansi terminal. (For this reason, the default for this flag is
off for non-Windows systems, although it can be made on all the time by setting
the appropriate flag in the [Link] configuration file.) Include the -k switch on
the command line, and the program will display all charts as before, but change
the color appropriately for every part of any chart printed! Just try a -w chart, a -g
grid, or a -t list and see the difference of how much easier it is to find a planet or
aspect among a large chart! I highly recommend this setting be made on by
default in the [Link] file if your system will support it, especially for those
who display text charts on the screen more often than they print one out.
Color isn't used randomly but is based on logic. Most colors are very similar to
the ones chosen in the color X charts. In general, everything is based on the
following rules for elements: By default, Fire is Red, Earth is Yellow, Air is
Green, and Water is Blue. Zodiac signs and positions are printed in the color of
their element. Houses are printed in the color of their corresponding sign. Planets
are printed in the color of the sign they rule. As for the other objects, we have the
following colors: Asteroids are in bright purple (magenta), Uranians are in dim
purple, and non-physical points like the Node, Fortune, and Vertex are in a bluish
gray (dark cyan). Stars are either orange if they are bright (magnitude < 1.0) or a
dark red if dimmer. For aspects we have the following: Conjunctions are Yellow,
Oppositions are Blue, Squares are Red, Trines are Green, Sextiles are Light Blue
(Cyan). For the minor aspects we have magenta for inconjunct/semisextile, orange
for semisquare/sesquiquadrature, dark cyan for all the quintiles, dark purple for all
the septiles, dark red for all the noviles, and dark green for the undeciles.
-k0: Like -k but only use special characters, not Ansi color.
This minor switch is just like the -k switch, however it only toggles whether the
high Ascii graphics characters are used, as opposed to -k which toggles both that
and whether Ansi colors are used. A system with a black and white monitor may
want to use high graphics but not color, while a system with a foreign character
set may prefer color but not graphics characters.
-kh: Text charts saved to file use HTML instead of Ansi codes.
Astrolog supports saving text charts in HTML format. This is useful in order to
transfer Astrolog text into other programs with color formatting intact. When this
setting is on, in the Windows version the Save Chart Text Output command will
produce HTML format files instead of plain text files, and the Copy Chart Text
Output command will put “HTML Format” content on the Windows clipboard.
Note that Web pages have a white background by default, which means that
output will appear similar to Astrolog screen text when the reverse background
setting (-Xr switch) is on. That means white text will be black in the HTML file,
and light gray text will appear dark gray and vice versa.
-X: Create a graphics chart instead of displaying it as text.
This is the general switch, which means display a chart in an X window instead of
on the screen in some form. For example, the command 'astrolog -i mychart -X'
will open a new window and display the chart in question in it. (Of course, all the
other switches, e.g. -R, -c, -1, etc, can be used to change what info is actually
displayed.) If you use the -L astro-graph switch in addition to this, the appropriate
astrocartography map will come up in a window instead of the earlier boring list
of longitudes. (e.g. astrolog -i me -X -L) The -Z and -g switches will produce their
own chart types as well, although, of course, only one type of chart can be in a
window at any given time.
-Xb: Create bitmap file instead of putting graphics on screen.
This switch will cause a bitmap file to be produced and written to a file instead of
putting the graphics on the actual screen. This is useful if you want to convert the
graphics to different formats, e.g. so they can be displayed on alternate systems,
etc. Note that -Xb (or any other -X<letter> switch) automatically assumes the -X
switch above, so 'astrolog -i file -Xb' is sufficient (and you don't also have to
include the -X).
-Xb[n,c,v,a,b,w]: Set bitmap file output mode to X11 normal, X11 compacted, X11 very
compact, Ascii (bmtoa), Windows bitmap compact (16 color palette), or Windows bitmap
(24 bit colors).
The bitmap file can be written in five different formats; by default whatever
format specified at compile time is used. One can change this mode by putting an
extra character on the command line after the -Xb switch. Specifically, to override
the compile time mode, use -Xbn for a standard X11 bitmap, -Xbc for an X11
 bitmap with some white space removed, -Xbv for a very compact X11 bitmap
(which may not be able to be processed correctly by all X programs), -Xba for a
one character per pixel Ascii dump identical to the result generated from the X11
bmtoa program, and finally -Xbb for the Windows .bmp bitmap described below.
One of the available bitmap formats are the .bmp extension bitmap files
commonly used on PC’s running under Microsoft Windows. If you have a PC
running Windows, you can set your root background to be one of these
monochrome Astrolog bitmaps by: use the -Xb option to create a bitmap file, then
rename it if necessary to have the extension .bmp and put it in your Windows
subdirectory, then go into Program Manager -> Control Panels -> Desktop and
select this file to be your “wallpaper”. These bitmap files may be generated in
either color or black and white. By default, all graphic charts will be in color,
unless specified otherwise. Color is most useful for these PC bitmaps (-Xbb),
although a color bitmap will take up more disk space. X11 bitmap files will
always be output in monochrome format, since color .xbm files don't exist. A
color Ascii file (-Xba) will have the color value of each pixel converted to a
hexadecimal number, instead of being in the format generated by the Unix bmtoa
utility in the case of monochrome charts.
Astrolog supports 24 bit color Windows bitmaps, which can display 16 million
colors per pixel (instead of just a 16 color palette). Saving a file in Windows
bitmap format, or copying such a bitmap to the clipboard will generate the more
detailed bitmap. The -Xbw switch indicates the default bitmap format is 24 bit
bitmaps, while the -Xbb switch will save smaller 16 color palette bitmaps. When
the palette is 16 colors, chart backgrounds and detailed world maps will be
disabled. In the Windows version, the “Graphics / Map Effects / Use Detailed
World Map” command will toggle between the two options. Note that 24 bit color
isn’t supported in some environments like X11 windows, in which case they will
always be in the 16 color palette regardless of this setting.
-Xp: Create PostScript vector graphic instead of bitmap file.
-Xp0: Like -Xp but create complete instead of encapsulated file.
Astrolog can generate PostScript graphics files. PostScript is a graphics format
different from bitmaps in that it’s based on vector “strokes” as opposed to
“pixels”. With a vector graphic, an image is defined in terms of “circle here, line
there, etc” instead of a large array. This means PostScript graphics can be printed
at any size without losing accuracy or becoming pixilated or “blocky”, and look
perfectly smooth when printed to a laser printer. A PostScript file is also about an
order of magnitude smaller in size than a corresponding bitmap file.
To generate a PostScript chart, use the -Xp switch. This will work just like bitmap
files for all Astrolog’s graphics charts, in that you will be prompted for a file to
write the graphics to unless you explicitly pass a file to the -Xo switch. The type
of file generated will be an encapsulated PostScript graphic (which are usually
seen with a .eps extension) meaning that it’s made to be inserted into a document
and scaled and so on and printed from there. A true independent PostScript file
 which can be sent directly to a printer can be generated by specifying -Xp as -Xp0
instead. As with bitmaps, it is recommended to include -Xm for a monochrome
graphic unless you have a color printer, and to include -Xr so the chart is black on
a white background (so that you don't cover 90% of the page with ink when
printing)!
There is a compile time option #define PS in the astrolog.h which can be
commented out to disable the -Xp switch and all PostScript features. Note that on
an X window system one may directly print out a bitmap to a PostScript printer
even without this internal support. One simply brings up an Astrolog chart in an X
window, or creates a bitmap and displays that bitmap in a window using some
other graphics program, and then uses the Unix command “xdpr” to print it, with
a line such as “xdpr -P<postscriptprintername> -device ps”, and then clicking on
the window to print it to the specified printer. Of course, the native PostScript
charts will look much smoother.
Special thanks to Mr. Brian D. Willoughby who wrote the routines and parts in
the file [Link] which deal with PostScript (e.g. what’s the PS command to
draw a line, ellipse, filled rectangle, etc.) Basically, if it’s inside #ifdef PS, Brian
likely gets credit for it, and for anything else (except the Swiss Ephemeris,
Placalc, and Matrix source files) I'm the one to blame. :)
-XM[0]: Create Windows metafile vector graphic instead of bitmap.
Another graphics format, Astrolog can generate Windows metafiles. Metafiles are
those files (usually with extension .wmf and often called “pictures” for users) that
are frequently used in Microsoft Windows for clipart and other such things.
Like PostScript, metafiles are a vector graphic format. Metafiles are in binary
format unlike the human readable Ascii text in PostScript files, and hence are
smaller in size for the same image. Although the same chart generated in
PostScript and metafile format will more or less look the same, for PC and
Windows users, metafiles are usually preferred. (For Unix systems, PostScript is
preferred since there aren't many Unix apps out there that know or care about
Windows metafiles, while PostScript is a standard used everywhere.) A metafile
can be inserted as a picture or pasted into programs like MS Word. Unlike
PostScript, a metafile can be displayed on the screen in your document, instead of
like most EPS files which when displayed by Windows just indicate that “this is
an PostScript image” and have to be printed to be seen. A metafile can be viewed
or edited in various drawing applications (such as MS Paint or the classic MS
Draw) in which one may modify the Astrolog chart, change colors, add text, and
so on before printing.
Metafiles (and PostScript graphics) have the option to use system fonts for text, as
well as zodiac signs, houses, planets, and aspect glyphs. This will look smoother
than having Astrolog draw the characters with 45 degree line segments. There is a
setting in the [Link] file which when set by the user will use system fonts
instead of simulating them. If the -XM switch is invoked as -XM0 instead, the
 status of this flag will be toggled for the chart generated. (This switch can be used
with PostScript charts by specifying “-XM0 -Xp”.) In the PostScript charts, the
following system fonts are used by default: Courier for text, Times Roman for
house labels, and Astro for sign, planet, and aspect glyphs.
For these metafiles, the following Windows TrueType fonts are used by default:
Courier New for text, Wingdings for sign glyphs, Arial for house labels, and
Astro for planets and aspect glyphs. All of these fonts should be installed on your
system already except likely Astro. This font, created by Kenneth Hirst, is
available at [Link] To install it on Windows, unzip this
file, then go into the Windows Control Panel and select the Fonts icon. Click on
the Add button and select the file “[Link]” that was in the zip archive, and the
font will be installed on your system. If it’s not installed, the planet and aspect
glyphs will appear as letters. (If you can't get access to the Astro font, but still
want all the other fonts to be included, then change the value of the -YXf font
selection setting to 61800, which will cause only the planet and aspect glyphs to
be simulated by Astrolog.)
It is possible that a metafile using system fonts may print perfectly to a PostScript
printer, but a PS file itself won't find a less common font such as Astro. This is
because the Astro font may be installed on your Windows system, but not on the
printer itself, and because when printing a metafile to a printer, Windows will
automatically embed the necessary font information in what it sends to the printer
if the font isn't already there. Note that one may actually generate a PostScript
chart from a metafile in Windows by using the Print Manager (or the Setup dialog
button available from within those Windows host applications that use the
standard Print dialog) to set printing to be to an encapsulated PS file instead of
directly to a printer. Of course doing this won't likely be needed since Astrolog
can generate PS files natively.
Like bitmaps, creating metafiles is also efficient in how it uses memory. Astrolog
will attempt to allocate a large buffer for them, and keep decreasing the amount
until it succeeds. (Note that the related PostScript charts don't need any memory
buffers because they’re written to disk while being generated.) There is a compile
time option #define META in the astrolog.h which can be commented out to
disable the -XM switch and all metafile features.
-X3: Create Daedalus wireframe vector file instead of bitmap.
Astrolog supports saving graphics charts in 3D wireframe format. These
wireframe files are a vector format similar to the PostScript and Windows
metafile formats, except they’re true 3D models formed of line segments with
separate X, Y, and Z coordinates. Such wireframe files can be viewed from
different angles, rendered in perspective, and even explored from inside. With the
right software and hardware, one could potentially use a 3D printer with an
Astrolog wireframe, and have a physical 3D model of your chart! :)
 Most charts in wireframe mode are just lines drawn within a 2D plane, however
some Astrolog charts have special wireframe versions of them that are fully 3D.
The chart sphere and the globe charts are self-explanatory in wireframe mode
since they’re already 3D models. The solar system orbit chart plots the planets in
3D space, in which the inclinations of the orbits above or below the ecliptic can
be seen. In all wireframe charts, planet glyphs are in the horizontal plane (so
they’re best seen looked down on from above) and the points where planets
actually are located are marked with small wireframe diamonds. When a planet is
sufficiently zoomed in upon in the solar system orbit chart, it will be drawn as a
full sphere instead of just a small diamond. When this is the case, Saturn and
Uranus will also be drawn with their rings, rotated and tilted at the proper angle.
This makes the solar system orbit chart similar to a 3D model of Astrolog’s
telescope chart.
More specifically, Astrolog produces wireframe files in the Daedalus wireframe
format. That is a plain text file format listing the numeric coordinates of each line
segment, which is simple enough to be edited by hand or converted to other 3D
formats. The easiest way to view and work with Daedalus wireframe files is by
loading them into Daedalus, a graphics program by the same author. See
[Link] for more about the program
Daedalus. Note that Daedalus versions 3.2 and before only supported
monochrome wireframes, so Astrolog needs to be in monochrome mode (-Xm
switch off) in order for older versions of Daedalus to be able to properly parse the
Astrolog generated wireframe file. For an example of Astrolog generated
wireframe files rendered in Daedalus, see this video:
[Link]
-Xo <file>: Write output bitmap or graphic to specified file.
This switch is used in conjunction with the -Xb, -Xp, or -XM options, to specify
the name of the file to write the graphic image to. If not included the program will
prompt you for the filename before writing to disk.
-XB: Display X chart on root instead of in a separate window.
For X window systems only, this switch will cause the chart graphics to be
displayed directly on the root window. This action occurs quickly since the
program does not have to write a separate bitmap file and then call xsetroot -
bitmap on it (although one could easily do that if they want to). For example, one
could put the line “astrolog -n -XB” in their .xsession file and whenever they log
in, their background will be set to a chart of the current state of the planets.
-XI <file>: Display bitmap as background behind graphics charts.
Astrolog can display pictures as a background for its charts. This switch will load
the specified Windows bitmap file (“.bmp” extension) and display it behind every
graphics or text chart. In the Windows version, the “File / Open Bitmap / Open
Background” command will do the same. The bitmap contents will take the place
 of the background color (which is usually black or white). An easy way to get
pictures into the Windows version of Astrolog is from your Web browser right
click on any picture and select “Copy image” or equivalent, and then do “Edit /
Paste” in Astrolog.
-XI0 <trans> <pos>: Set transparency and positioning of background.
This switch allows one to set the transparency and positioning of the background
image, and takes two parameters to cover both settings. The transparency
parameter runs from 0 to 100, in which 0 means fully transparent and the
background image is invisible, and 100 means fully opaque and the background
color doesn’t exist. The default is 25, which ensures a black background will still
be sufficiently dark and a white background sufficiently light to not make viewing
the chart itself difficult. In the Windows version, the Graphics Setting dialog has a
“Transparency Percentage of Background” field which controls this. The second
parameter for positioning may be 0, which means the background image is
stretched to cover the chart dimensions, or 1 or -1 which means the aspect ratio of
the original bitmap is preserved. 1 means the chart will always be covered and the
left/right or top/bottom edges of the background will be cropped if the ratios don’t
match (which is the default), and -1 means all of the background will be displayed
and the left/right or top/bottom edges of the chart will remain the background
color if the ratios don’t match.
-XIW <file>: Replace world map bitmap used for world map charts.
Astrolog’s graphical world map displays (which includes its astro-graph and
nearest cities local space charts) will by default show a detailed picture of the
world, instead of simple line drawings along the coastlines that the program has
supported since version 2.00 released in 1991. For example, the globe display (-
XG switch) will display a “spherical bitmap”, rotated and tilted appropriately.
Also, in the globe displays (-XG & -XP switches) if the “world map in Mollewide
projection setting” is on, then the night half of the world will be shaded darker. In
the Windows version, the “Graphics / Map Effects / Use Detailed World Map”
command will toggle between the two options. The world map bitmap exists in
the file “[Link]” in the Astrolog install directory. You can edit or replace that
file, however for accurate results this file needs to be an equirectangular
projection of the world, in which the left and right edges are at 180 degrees W/E.
The -XIW switch will load the specified Windows bitmap file and use it for the
world map bitmap instead. In the Windows version, the “File / Open Bitmap /
Open World Map” command will do the same. The default [Link] uses the
NASA Visible Earth Blue Marble image
[Link]
generation. More detailed or alternate world maps that can be used with the -XIW
switch, or replace the default [Link], are available at:
[Link]
-Xm: Create monochrome graphic instead of one in color.
 For systems without color monitors, the -Xm switch will create all charts in
monochrome B/W mode. One can still generate color bitmap files on a
monochrome system, just can't properly display them of course.
-Xr: Create chart graphic in reversed colors (white background).
Normally the charts comes up white on a black background. To get the chart or
bitmap displayed in reverse video (black on white), use this -Xr switch.
-Xw <hor> [<ver>], -ge[..]: Change the size of chart graphic.
The default graphic chart size is 600x600 pixels. This can be changed with the -
Xw switch. Passing -Xw with one argument n will make an n by n pixel chart.
Passing -Xw with two arguments x and y will make an x by y image. If -Xw is
passed zero, then it will use the compile time default window size. Note that this
switch will not affect astro-graph or aspect grid windows. To change the size of
those charts use -Xs below.
For X window systems only, Astrolog accepts the standard -geometry switch
(which can be abbreviated as -geom or anything starting with -ge). This is only an
alias to this -Xw chart size switch, in that it takes the same parameters in the same
way.
-Xs <100,200,300,400>: Change the size of map or characters by %.
Note that the size of the planet and sign glyphs don't change when you change the
size of a graphics chart. This can cause problems for very small charts where the
glyphs overlap the rest of the chart and for very large charts where there is lots of
excess space. The -Xs switch can be used to change the size of all glyphs. The
valid values that can be passed to it are 100, 200, 300, and 400 of which 200 is the
default. Note that this switch is used to change the size of the astro-graph (and
aspect grid) graphic charts (because the world map is sort of considered to be one
giant glyph by the program.)
Astrolog has its own internal character set definitions for the glyphs which it just
draws at a higher scale based on the -Xs setting. This can make glyphs at higher
scales look slightly blocky. To help prevent this, there’s a second alternate
“internal font” of double sized glyphs for planets, signs, aspects, and house
numbers, which allow the 100% or small scale, and the 200% or medium scale
glyphs, to appear smooth to the nearest pixel. (These improved larger glyphs are
also used at the 400% or huge scale, and when printing.) There’s also a set of
triple sized sign and house number glyphs used at the 300% or large character
scale.
-XS <100,150,200,300,400>: Change size of graphics chart text by %.
The size for text within graphics charts (such as the text in the wheel chart
sidebar, and the text at the bottom of the screen in other charts) can be changed
with this switch. The valid values that can be passed to it are 100, 150, 200, 250,
 300, 350, and 400 of which 100 is the default. On high resolution monitors with
many pixels, the default text size may be small enough to be hard to read, so
increasing it may be appropriate. The 150% scale is perhaps most useful, if one
finds the default of 100% too small and 200% too large. Similar to the larger
glyph fonts above, Astrolog has a second alternative “internal font” for text 150%
the size of its standard font, which it uses for the 150% scale (and appropriate
multiples of it like 300%).
-XQ: Ensure square charts remain so regardless of bitmap size.
This setting will force all graphics charts to be square, assuming they can be
resized arbitrarily and look better when square. This option is similar to running
the “Graphics / Square Screen” menu command in the Windows version after
every manual window resize (except it won’t automatically resize the window to
fit the final chart size, but rather will draw within the largest square area within
the window). If this option is not on, then resizing a wheel chart will result in an
elliptical wheel.
-Xi: Create chart graphic in slightly modified form.
The display of graphics charts can be modified in various minor ways, such as
adding or removing certain information. Rather than add a new hard to remember
minor option for each chart’s change, there is one comprehensive switch which
covers all charts. The -Xi switch will invoke this “induce/inhibit information”
option, and pressing the 'i' key in a window will accomplish the same thing by
toggling the mode’s status. When this option is set, it affects each graphic chart in
a different way, as follows:
For the standard -v and relationship -r0 -v wheel charts, and the -l sector chart, it
will toggle the dashedness of the aspect lines in the middle of the wheel (i.e. it
negates the value of the -YXa switch).
For the -g aspect grid, it will flip the aspects and midpoints across the center
diagonal, i.e. the midpoints will be below it and the aspects above it, instead of
the other way around. For the -r0 -g relationship aspect grid, the entire grid will
be replaced with one showing all midpoints between all the objects in the two
charts. Note: The -g0 switch when combined with -r0 will also generate a
relationship midpoint (as opposed to aspect with just -g) grid. However, this will
revert back to the aspect grid if both -Xi and -g0 are in effect with -r0.)
For the -Z horizon chart and -S space chart, it will, for the major planets, increase
the size of the “points” showing where each object actually is, making a brighter
“spot”, for easier viewing; combine this in the horizon chart with the 'l' key label
inhibitor and get a very realistic view of the night sky, with planets brighter and
all.
For the -K calendar chart, it will display the numbers for dates in the middle of
their squares instead of in the upper left corner.
 For the -j dispositor chart, it will include house cusps objects in the chart, which
are normally left out of it.
For the -7 esoteric Ray chart, it will compute Ray powers based on their “slice”
proportions instead of their “count” of times present.
For the -L astro-graph chart, this will eliminate the display of the Ascendant,
Descendant, and Nadir lines, leaving just the vertical Midheaven lines and zenith
points, for an increase in speed and much less clutter when including many
objects.
For the -E graphical ephemeris chart, it will exclude showing the Moon and Part
of Fortune without having to restrict them, which is commonly desired because
their lines move across the ephemeris chart much faster than any of the other
objects.
For the -B and -V transit graphs, it will draw a dark green vertical line
highlighting the current chart’s time and date.
For the -XX chart sphere display, it will show only one side of the sphere, making
it appear as if you’re inside it.
For the -XW world map display, -XG globe display, and -XP polar globe display,
it will make them show just the world map or globe itself, and not display the
zenith locations of the chart’s planets or any astro-graph lines.
Note there is a special case situation that can arise with the -XW, -XG, and
-XP switches: These displays can be brought up in a window without
having to specify any chart data. Now suppose one presses 'V', 'L', etc. to
bring up a chart, then what will be displayed? The answer will be
whatever initial values were already there, and if you’re curious, it’s set to
be my own birth data: 11:01am PST (8 hours before UTC) on Friday,
November 19, 1971 in Seattle, WA (122W19:59 47N36:35). This info can
also be brought up by accessing the “-i nul” virtual chart straight from the
command line before any other switches.
-Xt: Inhibit display of chart info at bottom of graphic.
Normally, at the bottom of any chart graphic is printed some header information
listing the name, date, time, and location of the chart in question (unless the info
is already being shown in a sidebar). One can inhibit this display by specifying
the -Xt switch.
-Xu: Inhibit display of a border around graphic.
This switch toggles off the border setting, which is also interactively toggled by
pressing the 'b' key when a graphics screen is up. This covers the rectangular
border around the outside of most charts, as well as the circular border around
globes and the elliptical border around the Mollewide projection of the world
 map. This switch allows one to toggle the border for graphics files, as well as set
the default for this in the [Link] file.
-Xx: Draw thicker lines in graphics charts.
Graphics charts may be drawn with thicker lines, in which all lines will be two
pixels instead of just one pixel wide. This setting will also cause system font
characters on graphics charts to be drawn in boldface. Use this switch to do this,
or in the Windows version select the “Thicker Lines” command on the
“Graphics / Chart Effects” submenu. Lines will still be one pixel thick when
drawing Astrolog’s default vector glyphs and text at the smallest 100% scale,
because otherwise they’d be too hard to read since their lines would be
overlapping.
-Xl: Inhibit labeling of object points in chart graphic.
This switch will inhibit labeling with glyphs or text abbreviations, the spots
indicating the positions of planets in the various graphics charts. This is just the
command line counterpart to the existing functionality accessed by the 'l' key.
-XA: Draw aspect glyphs over aspect lines in charts.
Lines indicating aspects between objects (such as seen in the middle of wheel
charts, as well as in solar system orbit charts and chart spheres) have the option to
draw the aspect’s glyph over the middle of the line. This switch (and the “Show
Glyphs On Aspect Lines” menu command on the “Graphics / Map Effects”
submenu) will label aspect lines in this manner.
-Xj: Don't clear screen between chart updates, drawing trails.
This switch will toggle on a flag which will cause the graphics screen to not be
cleared on new chart draws. Pressing the 'j' key interactively will toggle the same
setting. This feature is used to draw “jet trail” streaks on the screen for some
charts, such as the -S orbit and -Z local horizon. If you bring up one of these
charts, turn on the setting, and then animate forward, a “time exposure” can be
done showing the orbits of planets or an object’s path across the sky.
-Xe: Draw Earth's equator in certain charts.
This switch causes Earth’s equator to be displayed in graphics charts. The equator
can be displayed in the graphic local horizon chart, along with in the chart sphere,
world map, and globe displays. Note that in local horizon charts and chart
spheres, the equator line always passes through the East and West points (i.e.
where the prime vertical intersects the horizon).
The equator setting will also toggle display effects in other charts: In graphic
wheel charts, whether aspect lines are shown in the middle of the wheel is toggled
with this setting. In the -S solar system chart, whether aspect lines are drawn
between planets is toggled with this setting.
-XU: Draw all stars from [Link] file in certain charts.
Astrolog supports displaying thousands of stars in its graphics charts. These extra
stars will appear in the chart sphere, graphic local horizon chart, and constellation
map charts. Unlike the actual 50 fixed star objects that Astrolog has supported for
many versions, these extra stars don’t have object indexes, aren’t labeled by
default, and can’t be individually restricted with the -R switch. In the Windows
version and when saved to wireframe files they will be colored different shades of
gray according to their brightness in the night sky. In contexts with a limited color
palette these extra stars will be either dark gray, light gray, or white depending on
their brightness. These stars are the complete set of stars from the Swiss
Ephemeris file [Link] that comes with Astrolog. Altogether there are 1115
stars total by default, and when displayed they allow one to see constellations in
the sky such as the Big Dipper.
The list of additional stars will only include physical stars and skip “virtual”
bodies such as the galactic pole, if the “Graphs Include All Planets” setting is off
(-B0/V0 switches). This will reduce the number of stars in the additional stars list
from 1115 to 1097. Non-star points like this are apparent in the [Link] star list
file because they have non-standard magnitudes like 0.0 or 999.99.
-XU[0-3]: Like -XU but set whether to show larger star dot and name.
The list of additional stars can have the stars displayed as larger dots, and can also
have the stars labeled with their names. Stars will be labeled with their traditional
or common name (if any), otherwise by their scientific nomenclature
abbreviation. The -XU switch can be invoked as -XU1 to turn on larger dot
placement, -XU2 to turn on name labeling, -XU3 to do both, and -XU0 to do
neither.
-XE <low> <high>: Draw range of asteroids in certain charts.
Astrolog can display custom asteroids and other bodies, assuming their Swiss
Ephemeris format ephemeris files have been downloaded, however doing so
usually requires specifying each asteroid individually. The -XE switch will
display an arbitrarily long sequence of asteroids. It takes two parameters: The low
and high minor planet numbers of the bodies to calculate and list. This is a quick
way to display hundreds or even thousands of asteroids at once, assuming their
ephemeris files have been downloaded. Extra asteroids may be seen in the
graphics charts for local horizon (-Z switch), solar system orbit (-S switch), on
world maps and chart spheres, and in the text mode list objects table (-HO
switch). For example, here’s a fun Astrolog animation in which 10,000 asteroids
are orbiting around the Sun at once:
[Link]
-XE[0-3] [..]: Like -XE but set whether to label ast number and name.
The asteroid list feature is very similar to the -XU switch which displays all the
stars in the [Link] file, except this displays a range of asteroids instead. The -
 XU switch subsetting will affect asteroids too, in which -XU1 shows just a dot, -
XU2 has the asteroid’s name labeled, -XU3 is a larger dot, and -XU4 is a large
dot with label. Assuming labels are present as defined by -XU, then the -XE
switch can be invoked with a trailing digit to determine how exactly asteroids are
labeled. Doing -XE1 will have no label, -XE2 will label with the asteroid’s
number (e.g. “10”), -XE3 will label with the asteroid’s name (e.g. “Hygiea”), and
-XE4 will label with both number and name (e.g. “10 Hygiea”).
-XL: Plot city locations from atlas on world map.
Astrolog’s atlas is graphical! :) It can plot the location of all cities in its atlas on
the graphic world map and globe displays. To show them, turn on this switch
(which is also available as the “Show Cities” menu command on the “Graphics /
Map Effects” submenu).
-XL[1-5]: Like -XL but set how to color cities (when -XA is on).
Normally all cities are displayed in the same color. However, if the aspect line
labeling setting (-XA switch) is also on, then cities will be colored differently. If
the -XL switch is invoked with a trailing digit, it will affect how cities are
colored:
-XL1: Cities are colored one of the seven colors of the rainbow based on their
country/region.
-XL2: Like -XL1 but USA states and Canada provinces are also colored
differently.
-XL3: Cities are colored one of six colors of the rainbow based on their default
time zone offset in effect today. Cities on non-hour time zones (such as India) are
colored magenta instead.
-XL4: Like -XL3 but the correct offset (including Daylight Time) is calculated for
each city based on the current chart time. For past times before a location started
using time zones, cities are colored gray instead. This Astrolog animation shows
how time zones have changed and been introduced over 180 years:
[Link]
-XL5: Color each city an individual color, in one of seven colors of the rainbow.
-XC: Draw house boundaries or alternate info in certain charts.
This switch controls whether house boundaries are displayed in graphics charts, or
it toggles the display of various details related to houses. This setting affects
different graphics charts in different ways:
Local horizon and chart spheres: Whether house boundaries are drawn. Note these
can be either 3D or 2D house boundaries, depending on whether the 3D houses
setting is active (-c3 switch).
Solar system orbit: Whether sign boundaries are drawn.
Maps and globes: Whether sign boundaries and the ecliptic are drawn.
Dispositor chart: Whether the depositor wheels have the Sun or first object at the
top of the wheel instead of at the left.
 Wheel charts: Whether a dotted line is drawn from planets in outer wheels to the
innermost wheel. Even for the common single wheel chart this setting has a minor
effect, and determines whether the dots for each planet are larger.
-X1 <object>: Rotate wheel charts so object is at left edge.
Another graphics feature, this allows one to effectively rotate one of the graphic
wheel charts so that a particular object is hinged to the left hand (east) edge of the
chart. Given the -X1 switch with the index value of an object, the wheel is drawn
but always rotated so that the object in question is at the left side of the chart. By
default we have the ascendant at the left edge, of course. This is useful for
tracking important planets so one knows where they are, but yet doesn't distort the
house cusps as the -1 switch does.
-X2 <object>: Rotate wheel charts so object is at top edge.
This is identical to the -X1 switch above except here we rotate the entire graphic
wheel so the object in question is always at the top of the chart. Note that during a
day, the degree difference between the Ascendant and Midheaven varies in most
house systems, so that with the Ascendant hinged at the left edge, the Midheaven
will wobble back and forth near the top of the wheel. If you prefer, “-X2 Mid”
will fix the Midheaven at the top of the screen, and the chart will be like before
except the Ascendant will be the one to wobble near the left edge of the chart.
-Xd <name>, -di[..] <name>: Open X window on specified display.
For X windows only, the -Xd <display> switch can be used to change the display
to bring the window up on. Normally, the X window will always come up on the
current display, but we can do things like “astrolog -Xd machine:0.0” and have
the window appear there. In addition, the program will accept this string through
the standard “-display” switch common to most X11 applications (which can be
abbreviated as “-disp” or anything starting with “-di”).
-Xv <0-3>: Set fill style for wedge areas in wheel charts.
Astrolog’s wheel charts can be filled in with color, which generally looks better
and has more contrast. This affects the outer sign and house wedge areas in wheel
charts, and sectors in the Gauquelin sector chart. The default fill used for wheels
is a darker version of the color of the object (e.g. the color of the sign) which is
darkened by the background transparency percentage value (-XI switch). If this
percentage is set to over 50%, then the glyphs will be drawn in black or white
instead, to be more visible on the more brightly colored background. Wheels can
also be filled in with colors around the rainbow, starting with Aries or the 1st
house being red. This switch sets which type of wheel fill to use, in which 0 is
turned off (if you want outlines only), 1 is standard fill, 2 is rainbow fill (based on
a RGB light color wheel), and 3 is a different rainbow fill (based on a RYB paint
color wheel). In the Windows version, the “Wheel Fill” field in the Graphics
Settings dialog allows one to select among the first three options. Note that filled
wheels are only available in bitmap files, in Windows metafile files, and on the
 Windows screen. They won’t appear in PostScript files, on X11 windows, or
when printing from Windows.
-XJ: Display wheel charts in South, North, or East Indian form.
Astrolog can display South Indian, North Indian, and East Indian style wheel
charts, as used in Indian astrology. To display them, use this switch (or the
“Graphics / Indian Style Charts / Show Indian Wheels” menu command). This
setting will modify the standard wheel chart (the -v -X switch combination, or the
“Chart / Standard Radix” menu command) and the house wheel chart (the -w -X
switch combination, or the “Chart / House Wheel” command) to draw Indian
wheels instead of Western. Planets in sign or house areas will be labeled with
their glyphs, although if the “show glyph labels” setting (-Xl switch) is off, then
planets will instead be labeled with their two letter abbreviation as is commonly
done with Indian charts. Glyphs or abbreviations will be arranged in position
order within a sign/house, from top to bottom or from left to right. If the “text
house wheel reverses object order” setting is on (-w0 switch) then glyphs will
instead be arranged in reverse order in parts of the wheel that progress from
bottom to top or from right to left. As with other charts, in the Windows version
one can right mouse click on it to view a context menu, allowing one to toggle
relevant settings, and easily switch between Western and the various Indian
charts.
The South Indian chart consists of 12 boxes (one for each sign) arranged around a
square. This is the classic rasi or sign based chart. In this chart, Pisces is the upper
left box, and signs increase clockwise (which is the opposite direction of standard
Western wheel charts). Each box will be labeled with its sign, and if the house
system is one in which house boundaries exactly coincide with signs (such as
Whole or Null) then each box will be labeled with its house too. Either way, the
sign containing the 1st house cusp will be highlighted with two diagonal lines, to
make it more visible. If the “Indian wheel order” setting (-J switch) is on then
arrangement will instead be similar to a Western wheel, with the sign containing
the first house on the left edge, and signs increasing counterclockwise. The square
space in the middle of the chart will have an aspect/midpoint grid drawn within it,
for as many planets as there’s room for, unless the “show equator” setting is on (-
Xe switch). Because South Indian chart boxes are signs, this chart is displayed
with the standard “Chart / Standard Radix” command, when “Indian Style
Wheels” are on, and also if the “adjusted houses” setting (-XC switch) is off.
The North Indian chart consists of 12 diamond or triangle shaped areas (one for
each house) arranged to compose a square. This is the classic bhava chalit or
house based chart. Angular houses will be in the larger diamond shaped areas near
the middle. Each box will be labeled with its house, and if the house system is one
in which house boundaries exactly coincide with signs (such as Whole or Null)
then each box will be labeled with its sign too. In this chart, the 1st house is the
top diamond, and signs increase counterclockwise. If the “Indian wheel order”
setting is on (-J switch) then arrangement will be more similar to a Western
wheel, with the chart being rotated 90 degrees so that the first house is the
 diamond on the left edge. Because North Indian chart boxes are houses, this chart
is displayed with the “Chart / House Wheel” command, when “Indian Style
Wheels” are on.
The East Indian chart is similar to South Indian, in that by default it has one
square or triangular area for each sign, however by default Aries is at the top and
the signs go counterclockwise around the wheel. Similar to the other Indian
charts, if the “1st house on left edge” setting (-J switch) is on, then the chart will
be rotated so the box containing the Ascendant will be on the left edge. The
standard wheel chart will be displayed as East Indian (instead of South Indian) if
the “Indian chart format” setting (-XJ switch) is on, and also if the “adjusted
houses” setting (-XC switch) is on.
-X8: Display planetary moons around planets in wheel charts.
Astrolog offers a wheel chart variation which shows planetary moons orbiting
planets. The wheel chart will be displayed as normal, except unrestricted
planetary moon objects will be drawn around the glyph of the planet they orbit.
Since each planet is now a mini-wheel chart, this is effectively a “wheels within
wheels” chart. The Moon’s Node and Lilith objects will be displayed orbiting
Earth (assuming a non-geocentric chart) since these objects orbit or are positioned
around the Earth, so can be treated the same as if they were additional moons of
Earth.
Moons will be displayed using their first letter, or as a lower case version of the
first letter, if the letter is already in use by an earlier indexed moon of that planet.
For example, Saturn’s moon Titan will be displayed as “T”, while Saturn’s moon
Tethys will be “t”. Moon letters will be placed relative to their orientation to the
viewer, and will be highlighted based on which of the four prominence zones
they’re in. (These moon prominence zones are somewhat analogous to the four
Gauquelin sector plus zones.) Moons which are leading the planet in its orbit will
be highlighted in red, moons which are following the planet in its orbit will be in
green, moons which are close or between the planet and the viewer will be
yellow, moons which are distant or behind the planet will be blue, and moons not
in any zone will be gray. Moon letters will be distributed around the planet glyph
such that letters don’t overlap, similar to how planet glyphs don’t overlap in the
main wheel. For an example animation of this chart see:
[Link]
-XX[0] [<degrees> [<degrees>]]: Display chart sphere instead of wheel.
Astrolog supports chart spheres, which are like standard chart wheels but in 3D.
Chart spheres make it easy to see the ecliptic latitude of planets in addition to
their zodiac longitude. They are most similar to the -Z switch graphic local
horizon charts, except instead of being a flat rectangular map, the celestial sphere
is rendered like a globe.
In a chart sphere, its equator marks the plane of the local horizon. Lines are drawn
from the center in the four directions, which are labeled around the horizon.
Between the zenith point straight up, and the nadir point straight down, can be
seen the prime vertical running through the east and west points on the horizon,
and the meridian running through the north and south points on the horizon. In
addition, the ecliptic and the 12 zodiac sign wedges are displayed. Display of
signs can be toggled with the Indian format flag (-J switch, or the Setting / House
Settings / Indian Wheel Display command, or with the “z” key). Note that each of
the four lines from the center of the sphere to the North/South/West/East points
on the horizon will only be displayed if the corresponding
Nadir/Zenith/Setting/Rising flag from rising and setting restrictions (-YRZ
switch) is off. If all four are restricted, then the prime vertical line across the
sphere will go away too. If all four are restricted and the Show House Details
setting (-XC switch) is off as well, then the horizon and meridian lines will go
away too, leaving just the lines of the ecliptic marking the signs of the zodiac.
(This last scenario goes well with turning on the -YXe switch Use Ecliptic Axis
setting, to align the sphere with the ecliptic.)
Also in a chart sphere, the 3D boundaries of the 12 houses can be seen, in which
houses 1-6 are below the horizon and houses 7-12 are above, and in which houses
1-3 and 10-12 are east of the meridian and houses 4-9 are west of the meridian.
Display of the houses can be toggled with the show house details setting (-XC
switch, or the Graphics / Map Effects / Show House Details command, or with the
“d” key). These houses will show either 3D house boundaries or classic 2D house
boundaries, based on the 3D houses flag (-c3 switch, or the Setting / House
Settings / 3D Houses command, or with the “a” key). Finally, the astronomical
constellations will be displayed upon the surface of the sphere if the Show
Constellations setting is on (-XF switch, or with the Graphics / Map Effects /
Show Constellations command, or with the “F” key).
Planets will be plotted on the surface of the sphere based on their zodiac position
and latitude locations. Most planets will be on or near the ecliptic, except for
Pluto, asteroids, and especially fixed stars. Aspect lines will be drawn through the
middle of the sphere. If aspect lines make the display too cluttered, the orbs can
be reduced or aspects turned off altogether. When Astrolog is showing two, three,
or four charts at once, then the chart sphere will overlay all sets of planets upon
the sphere, instead of just showing the first set of planets. This result will be a bi-
sphere, which is like a bi-wheel but for a 3D chart sphere instead of just a 2D
wheel chart.
The sphere overlaps its “near” and “far” sides, with the far side solid, and the near
side semitransparent in which planets and such are rendered in gray. This
simulates the viewer being inside the sphere, focusing upon what is in distance,
such as a person looking south toward the ecliptic assuming a northern
hemisphere chart location. If the -XX switch is invoked as -XX0 instead, the
transparency will be reversed and the near side will be solid and the far side
semitransparent, as if one were outside the sphere looking upon its surface. In the
 Windows version, the “Globe Halves Focus On Southern Hemisphere” flag in the
Graphics Settings dialog controls this, and can be toggled with the Graphics /
Modify Chart command. If you don’t want any overlap at all, turn on the modify
display flag (with the -Xi switch, or the Graphics / Modify Display menu
command) and only the solid half of the sphere will be drawn.
Similar to Astrolog’s -XG switch globe display, the chart sphere can be rotated
and tilted. Two optional parameters to the -XX switch indicate how much the
sphere should be rotated around its axis, and how much it should be tilted toward
or away from the viewer. While a window is up, the sphere can be rotated left and
right with the “{“ and “}” keys (or the Graphics / Map Orientation / Rotate West
and Rotate East menu commands), and can be tilted with the “[“ and “]” keys (the
Graphics / Map Orientation / Tilt North and Tilt South commands). Rotating and
tilting is a good way to better visualize the sphere and its contents. For an
example animation of this chart see:
[Link]
-XW: Simply display an image of the world map.
The world map used by the astro-graph chart is something I painstakingly entered
the data for by hand using an atlas during a long week. This rectangular world
map (-XW switch) is very similar to Astrolog’s existing graphic astro-graph chart
(-L -X switches), except for differences in how the lines are labeled. (Users may
prefer one style to the other.) You can switch between the two styles of
rectangular astro-graph chart with the “L” (for classic astro-graph chart) and “W”
(for world map showing astro-graph lines) hotkeys. If you just want to see the
map of the world by itself without any astro-graph lines on it, also include the -Xi
switch.
If the alternate display setting is on (-Xi switch) and the -YXW switch setting is
non-zero, then overlaying the world map will be shown the Earth’s ley line
locations. Ley lines are spiritual lines of energy crossing the Earth. I was
experimenting with the master ley line grids on the Earth (in the pattern of an
overlapped 20 sided Icosahedron and 12 sided Dodecahedron) and I figured
Astrolog with its world map would be an interesting program to explore them
with. This belongs more to the field of dowsing than to astrology, but it’s still
available for amusement and inspiration. Note that when the -Xi modify display
setting is off, then the -YXW switch setting will display a different grid of
triangles or squares over any of the world map charts.
-XW0: Like -XW but do a non-rectangular Mollewide projection.
The -XW0 switch is just like the normal -XW switch in that it just displays the
world map and nothing else, except that this -XW0 map generated will be in
what’s called the Mollewide projection, a good looking form often used for maps
of the world, as opposed to the standard rectangular map projection used in -XW
which distorts the polar regions of the globe across the top and bottom of the
screen. (The Mollewide projection pinches the polar regions together, generating
 a elliptical map, which is similar to the -XG globe displays, but which shows the
whole world instead of just half.)
-XG[0] [<degrees> [<degrees>]]: Display image of world as a globe.
Given the data for the map of the world, there are several nice things we can do
with it. For instance, with a little trigonometry and clipping, we can draw a globe,
which is what the -XG switch does. An optional argument will specify a rotation
value in degrees to display different parts of the globe. This graphic globe can be
displayed semitransparently, with the continents or constellations on the back side
of the globe drawn in a dotted fashion. Select this option with the -XG0
subswitch, or by turning on “Globe Halves Focus On Southern Hemisphere” in
Graphics Settings. In the Windows version, this can be toggled with the “Graphics
/ Modify Chart” command.
Note that the -XW and -XW0 maps can be animated like this -XG globe display
can. By default animation of these maps are done by shifting the whole map to
one side or the other, and won’t update the underlying chart data. Because the -
XW world map and -XP polar globe displays can be animated just as the -XG
general globe display can, the -XW and -XP switches accept optional parameters
on the command line that will specify what degree (from 0 to 359) to start the
map at, just like the -XG switch does. In addition, the -XG option itself accepts a
second optional parameter, which is the starting angle for the globe’s tilt, from -
90 to +90 degrees.
This globe is a 3D graphic astro-graph chart, which is drawn on a spherical globe
instead of just a flat rectangular map. This globe can be rotated and animated, and
in the Windows version you can right click and drag to view different parts of the
world. This 3D astro-graph is a separate chart from Astrolog’s existing classic
astro-graph chart (-L -X switches). You can even toggle between them with the
“3D Houses” setting (-c3 switch or “a” hotkey). An animation of this chart can be
seen at: [Link]
As with the classic 2D astro-graph chart, by default Midheaven lines are
yellow, Ascendant lines are red, Descendant lines are green, and Nadir
lines are blue. The Midheaven lines will be labeled at the planet’s zenith
point, Nadir lines at the planet’s nadir point, and Ascendant and
Descendant lines at Earth’s equator. Midheaven and Ascendant lines have
glyphs in the planet’s color, while Descendant and Nadir lines always
have glyphs in gray. The presence of Midheaven, Ascendant, Descendant,
and Nadir lines can each be individually toggled with the “Rising and
Setting Restrictions” in Display Settings (-YRZ switch). If all four are
restricted, then planets will still be plotted at their zenith points, i.e. where
on the Earth each planet could be viewed by looking straight up. A
magenta dot will be drawn at the location for the chart, with a dotted line
around that latitude in order to make latitude crossings near the location
more apparent. This dot can be turned off by toggling the “Text Astro-
Graph Shows Latitude Crossings” flag in Chart Settings (-L0 switch).
 These 3D astro-graph displays will show astro-graph lines for the minor
cusps as well, when the minor cusp objects are unrestricted. Just as the
Ascendant line in astrocartography shows where on the world an object is
rising, a minor cusp line shows where on the world the object is exactly
conjunct that cusp (or its 3D cusp to be precise). Standard astro-graph
lines are based on the angles, and that means non-quadrant house systems
(which disassociate the 1st cusp from the Ascendant and/or the 10th cusp
from the Midheaven) will show 13 or 14 lines on the world instead of just
12. Note that this addition is only for the world map and globe displays
which can show astro-graph lines, while the actual astro-graph chart (-L
switch) is still limited to the classic view of the angles.
-XP[0] [<degrees>]: Like -XG but create globe from a polar projection.
The -XP option will generate a polar view map of the Earth. This is similar to the
-XG globe option except that the view is always with the north pole in the middle,
and the opposite pole around the outer edge. By default, the view is looking down
on the north pole with 0 deg W/E toward the bottom of the screen. (Animation
mode will cause the view to spin about the center of the screen.) To see a view
centered on the south pole, invoke this switch as -XP0 instead. Again, like with
all the other windowed display modes, one can enter this display with a keystroke:
press 'P' in any Astrolog window and it will change to this display.
-XZ [<object>]: Display telescope chart zoomed in on part of sky.
Astrolog features a chart which shows a particular section of sky, like what a
telescope presents. It’s similar to the local horizon chart, except zoomed in and
with more detail. It shows planet disk sizes of the Sun and Moon (and planets and
even planetary moons if you zoom in enough). This is a great way to watch solar
or lunar eclipses, or transits and occultations of other bodies. (For accurate solar
eclipse viewing, have topocentric positions turned on to take into account where
you are on the globe.) This chart also shows Moon phases, which means part of
the Moon will be in shadow, and the phase percentage will be displayed at the
bottom of the chart. Phases can be seen on other planets too (Mercury and Venus
especially, along with outer planets although they’re always close to full). Show
the telescope with this command switch, or the “Graphics / Draw Telescope”
command in the Windows version. For an example of Jupiter and its different
sized large Galilean moons, see:
[Link]
If the Earth is unrestricted in a geocentric chart, then the Earth will be drawn as its
umbra and penumbra shadows at the Moon’s distance, for lunar eclipses. The
chart will always draw the umbra of Earth’s shadow in front of the Moon, and the
penumbra of Earth behind the Moon. This makes lunar eclipses look realistic, in
that a bite will appear out of the Moon’s disk when it enters the umbra. For an
example of this in a Total Lunar Eclipse, see:
[Link]
Saturn’s rings will be visible, tilted and rotated appropriately, if the telescope is
zoomed in upon Saturn. Ellipses will be drawn at the most visible boundaries of
Saturn’s rings, specifically at the outer limit of Saturn’s “A” ring and the inner
limit of Saturn’s “B” ring. Similarly, Uranus’ rings will be displayed too, with an
ellipse drawn at the most visible point of Uranus’ rings, specifically at the point of
its “E” ring. Astrolog can also display the rings of Neptune, Jupiter, and Dwarf
planet Haumea. Note that Saturn’s axis is currently hardcoded, however its
precession is a very slow 1.83 million year cycle, so it stays reasonably accurate.
For example, Astrolog correctly shows the nearest dates when Earth crosses
Saturn’s ring plane (Sep 4, 2009 and March 23, 2025). Astrolog’s icon is a ringed
planet being orbited by two moons, and it can display images similar to its icon
within the program itself. :) For more about rings of planets and how to interpret
them in astrology, see: [Link]
In the Windows version, right clicking on the chart will bring up a context menu
with fourteen commands, allowing one to toggle different settings which
determine what things are shown in the chart. As with the local horizon chart
(which shows the entire sky) the telescope chart allows you to toggle whether
constellation boundaries, zodiac sign boundaries, 2D or 3D house boundaries, and
the full list of stars are visible. In addition, one can toggle whether the Moon and
other planets are drawn as crescents (in which the part in shadow will be drawn in
dark blue) with the -XA switch setting, whether the boundaries of planets will
always be visible (even when occulted or behind another planet) with the -L0
switch setting, whether the horizon line is drawn (with the -Xe switch setting),
and whether a grid of dots covers the chart at every degree or minute (with the -
XL switch setting). The chart itself can reflect the local horizon (with axes of
azimuth and altitude), or the ecliptic (with axes of zodiac position longitude and
ecliptic latitude), determined with the -YXe switch setting.
The telescope can track a planet as it moves. An optional argument to the -XZ
switch specifies the planet to keep in the middle of the chart. In the Windows
version, the field “Telescope Focuses on This Object” in the Graphics Settings
dialog controls this. If a planet is not being tracked, then the section of sky being
looked upon is determined by the map rotation and tilt settings. Changing these
settings will move the chart view to other areas of the sky, and stop any tracking
that is in place. The viewing location can also be changed by pressing the square
and curly bracket hotkeys, or in the Windows version by right clicking on the
window and dragging. Note when this chart is zoomed in, the view will move by
a proportionally slower rate, to allow finer adjustments.
The number of degrees of sky that’s visible is determined by the -YXS switch
setting. In the Windows version, the “Graphics / Map Orientation / Zoom Out”
and “Zoom In” commands will double or halve the number of degrees seen. The
axes on the edges of the chart will show the nearest arc minute (instead of just the
degree), or even the nearest arc second, if the chart is zoomed in enough. These
commands also zoom on other graphics charts, such as the solar system orbit and
nearest cities charts. Note that object disks are also visible in the solar system
 orbit chart, although it requires zooming in quite a bit for disks to be more than
one pixel wide. Object disks are visible in the local horizon charts too, although
since those charts show the whole sky, object disks won’t become apparent unless
the central object is set to something (such as a planetary moon) located near a
large body.
-XF: Display maps as constellations on the celestial sphere.
A graphics chart showing all 88 of the astronomical constellations is available
with the -XF switch. When this mode is active, the -XW world map and -XG and
-XP globe chart modes will draw the outlines of the constellations on the celestial
sphere instead of continents on the Earth. This mode will also draw constellations
on the -XX chart sphere, -XZ telescope, and -Z -X local horizon chart views.
Pressing the 'F' key when a graphics screen is up will toggle this setting on. (If
you aren't already in one of the map graphics modes, -XF and the 'F' key will
switch to one.) The constellation maps may be rotated, tilted, and animated and
can do everything else just like the world maps, and depict the sky as if you were
looking up at it from Earth. In the -Xi display modification mode, the locations of
the planets in the current chart will be shown among the constellations. The
constellations are labeled with their correct abbreviations, and you can see the
familiar image outlines such as the Great Bear, Cygnus, and all the others, as well
as the constellations named after the twelve signs of the zodiac, and how these
astrological signs compare with their corresponding constellations. I happen to
have four planets in my own natal chart in the constellation Ophiuchus, while
there are several other constellations very close to the ecliptic which planets
(other than the Sun) sometimes enter, e.g. in my own chart my Pluto is in the
constellation Coma Berenices (Berenice's Hair). As with Astrolog’s map of the
world, I entered the data describing the irregular shape of each constellation
myself, and the boundaries are accurate although rounded to the nearest degree.
This is a unique feature that isn't in many astronomical programs much less
astrological! For a demo of this, do “astrolog -i yourchartfile -XF -XG -Xn -XU”
and see a rotating celestial sphere of the constellations and stars, and where the
planets in your natal chart are located within them.
-Xn [<mode>]: Start up chart or globe display in animation mode.
The -Xn [<value>] option can be used to start up an X window in animation
mode. In a window, one would have to explicitly press 'N' or a Shift+number key
to start the window animation. Without a parameter after -Xn, the option will start
it up in continuous update to “now” mode (which is like pressing 'N' in that any
chart will be erased with the current chart now.) The switch can accept parameters
from 1-9, corresponding to the animation rates obtained by pressing Shift+1-9 in
the window, i.e. update whatever chart is passed to it seconds, minutes, hours,
days, months, years, etc. later each time.
-Xnf <units>: Set animation jump factor in units.
 This switch sets the animation factor, or how many units of time to jump at a time
(taking a parameter from 1-9). This produces the same effect as pressing the 1-9
keys within a window.
-Xnp: Pause animation, suppressing any active animation mode.
This switch will pause animation, producing the same effect as pressing the “p”
key within a window.
-XN: Map animates chart time instead of rotating map itself.
This flag controls whether animating a map display (such as a globe, map, or
chart sphere) will animate the orientation of the map itself or the time of the chart
within the map. By default map displays animate the map orientation, however
this option allows one to animate the chart within the map.
-XM[1-6][0] <strings>: Define macro(s) to run when chart drawn.
The -XM2 through -XM6 switches allow different graphics settings to be used for
different rings in a bi-wheel, tri-wheel, or beyond chart. The switches take 2
through 6 string parameters respectively, and each string is a command line that
gets automatically applied before drawing that ring. For example, you can do
things such as have rings with different glyphs, different character scales, or
different restrictions.
-HX: Display list of key press options for screen graphics.
This switch prints out the list of keys one can press when a graphics screen is
being displayed. This list may also be obtained by pressing the '?' key
interactively when graphics are actually up. With -HX, this may be done anytime
and be printed out or sent to a file like all other Astrolog tables.

Switches to access Windows options:

-W <value>: Run given Windows menu command internally.
For the Windows version only, this obscure switch allows one to invoke a menu
command from a command line, taking one numeric parameter indicating the item
to run. Values 40001 through 40301 are valid menu commands, where the list of
what number corresponds to what command is in the resource.h source file. An
example use of this is to put “-W 40047” in your [Link] file which will start
the program with the “Chart Resizes Window” setting on by default. Another
example is having “-W 40272” on the command line of the program’s icon to
have the Chart Info dialog come up on startup.
-WN <1-32000>: Set animation update delay in milliseconds.
For the Windows version only, this switch specifies the animation delay, taking
one parameter indicating the number of milliseconds between the start of screen
 updates. This is the same as the “animation delay” edit control in the Graphics
Settings dialog, and exists here as a switch so one may set a default value for it in
the [Link] file.
-WM <1-48> <text>: Set Windows menu text for macro command.
For the Windows version only, this switch allows one to customize the menu text
for the macro running commands, taking two parameters, the macro from 1-48
whose menu item to change, and the new text to put on the menu. An ampersand
“&” may be used to put an underscore under the character following it, which will
be used as the standard Windows menu shortcut for the command. For example,
doing -WM 12 "Best friend's chart”, will edit the last item on the “Edit Run
Macro (Normal Set)” submenu to read “Best friend's chart”. After it will still
appear “F12” as this doesn't change the direct keyboard shortcut. (One should of
course also use the -M0 switch to assign a macro to slot 12 here to actually
display your friend’s chart when the macro is run.)
-Wn: Don't redraw screen until user forces update.
For the Windows version only, this switch toggles it so that the window will not
redraw its contents until you force an update (with the Redraw Screen command
or by pressing space). Normally the screen updates after every command or
whenever a section of the window gets uncovered. However this constant
redrawing may cause unwanted waiting on a slower system, especially if one is
tweaking various minor settings in say a large transit search, and doesn't want to
wait after each modification.
-Wh: Set hourglass cursor when redrawing chart.
This switch toggles whether the Windows version shows an hourglass mouse
pointer while calculating and drawing charts. This setting is on by default, but one
may want to turn it off during animations to prevent the mouse pointer from
continually flashing to and from the hourglass.
-Wt: Don't display warning and error popup messages.
This switch disables warning popup messages in the Windows version, such as
ephemeris files not being found. One scenario where this can be used is star charts
for the distant past or future. Heliocentric barycentric positions of fixed stars
don’t require calculating the position of the Sun, and therefore can be calculated
for any date and don’t depend on ephemeris files being available. However,
Astrolog will still warn about dates out of range, which can be ignored in this
scenario. For example, the animation
[Link] covering a million years was
generated with -Wt on.
-Ww <hor> <ver>: Set upper left coordinates of window.
 In the Windows version, this switch (taking two parameters) will change the
coordinates of the origin of the program’s window. This is a way to precisely or
programmatically position or move the window.
-WB <0-24> <0-24>: Set window scrollbar positions.
In the Windows version, this switch sets the window’s scrollbars. Its two
parameters specify the horizontal and vertical scrollbar positioning. Both are
numbers from 0-24, in which 0 is the left or top edge, 24 is the right or bottom
edge, and 12 is centered in the middle.
-WT <string>: Set title bar text of Astrolog window.
In the Windows version, this switch sets the title bar text to use for the window.
This can be used to mark specific windows or help distinguish a large number of
Astrolog windows from each other.
-Wo: Continually autosave graphics screen to bitmap file.
In the Windows version, this switch causes the program to automatically save a
bitmap of the current graphics screen to the bitmap file “[Link]”, whenever
the screen is updated. This specialized feature allows external programs to get the
current state of Astrolog’s screen, which can be used for scenarios such as
creating the following video: [Link]
-Wo0: Continually autosave graphics screen to numbered files.
In the Windows version, this switch causes the program to automatically save a
bitmap of the current graphics screen to a continually increasing sequence of
bitmap files whenever the screen is updated, to “[Link]”, “[Link]”,
and so on. Each time the -Wo0 switch is invoked, the counter will be reset to zero.
This specialized feature allows external programs to see a list of Astrolog
screenshots, which can be used for scenarios such as creating animated GIF’s:
[Link]
-Wo3: Autosave graphics screen to wireframe instead of bitmap.
The Windows version can automatically generate and save Daedalus wireframe
files as new graphics charts are displayed. This switch is just like -Wo, except that
a wireframe file instead of a bitmap will be automatically generated and saved to
file. The program Daedalus can be configured to automatically open and display
such files. If Astrolog is animating the chart, then the wireframe rendered in
Daedalus will be animating in the same manner, which allows creating videos
such as: [Link]
-WSg: Setup Windows program group, for current user only.
In the Windows version, this switch creates a Windows program group for the
current user containing pointers to the Astrolog executable, the main and update
documentation files, and the Astrolog website.
-WSG: Setup Windows program group, for all users.
In the Windows version, this switch creates the same program group, but for all
users.
-WSd: Setup Windows desktop icon for program.
In the Windows version, this switch creates a Windows desktop icon to launch
Astrolog.
-WSx: Setup registering Windows file extensions for program.
In the Windows version, this switch associates Astrolog with “.as” extension files
in the Windows registry. Note that the special switch “-setup” will setup a
Windows program group for the current user, a desktop icon, and file extensions
for program (which is basically a shortcut for the combination of “-WSg -WSd -
WSx”).
-WSu: Unregister Windows file extensions for program.
In the Windows version, this switch undoes the effect of the previous switch, and
unassociates Astrolog from “.as” extension files, which is useful for uninstall.
Note these last two switches edit the current user’s settings within the Windows
registry.
-WZ: Treat program as screen saver, and exit next user input.
Astrolog can act as a Windows screen saver. To use it as one, copy the
[Link] executable to the file [Link] in your Windows system directory
(which is usually C:\WINDOWS\SYSTEM32). The right directory is the one that
has other .scr extension screen savers in it. Once installed, in Windows select
“Start / Settings / Control Panel / Display / Screen Saver” or equivalent, and pick
“Astrolog” from the list. When Previewed or when started as a screen saver, the
default display will be a wheel chart starting from the current moment now and
animating forward a minute at a time. If the file “[Link]” exists in the same
directory as [Link], then that file will be loaded on startup, which can
change the default behavior. You can’t set an unlock password when Astrolog is
running as a screen saver, and the Settings button won’t do anything other than
show the same animation within a window.
Astrolog knows to act as a screen saver when Windows invokes it with specific
command switches, and will exit immediately when a key is pressed or the mouse
is moved. “Astrolog /s” (run screen saver) will run in full screen mode.
“Astrolog /c” and “Astrolog /a” (configure screen saver) will run in windowed
mode. “Astrolog /p” (preview screen saver) will do nothing. One can invoke
Astrolog with these switches to test its screen saver functionality, or use the -WZ
switch, which will turn on the internal mode which makes the program exit on the
next user action.
Astrolog (version 7.60) obscure command switches:
-Y: Display help list of less commonly used command switches.
This switch was described in an earlier section.
-YT: Compute true positions in space instead of apparent in sky.
This switch turns on true planetary positions, which means where planets actually
are in space. Normally Astrolog shows apparent positions, which is where planets
appear in the sky, or the true positions adjusted by the travel time of the speed of
light. Most astrologers and astrology software work with apparent positions
(although there’s no definitive proof that astrological influences travel at the
speed of light). True positions will be up to half an arc minute ahead of apparent
positions, e.g. light from the Sun takes about 8 minutes to reach Earth, so the Sun
has moved forward another 8 clock minutes through the zodiac. For the -S orbit
chart, in which one is looking down at the solar system as a whole, it’s
recommended to have true positions on (and topocentric positions off).
-YV: Compute topocentric positions instead of from center of body.
This switch turns on topocentric positions, which means positions relative to
one’s location on the surface of the Earth. Normally Astrolog shows positions
relative to the center of the Earth. Most astrologers and astrology software treat
the Earth as a single point (although there’s no definitive proof that astrological
influences affect everybody on all parts of the Earth equally). Because topocentric
is relative to location on Earth, one’s elevation above sea level influences
positions, and needs to be set separately (with the -zv switch). Positions with this
setting may be different by more than half a degree, with the maximum change
being the Moon (because it’s closest to the Earth) and when planets are near the
horizon, because in those cases parallax has the biggest opportunity to alter
positioning. Topocentric positions require Swiss Ephemeris to be active (which it
is by default) in order to work, and also for the chart to be geocentric. For the -Z
local horizon chart, in which one is looking at points of light in the sky from their
local position on Earth, it’s recommended to have topocentric positions on (and
true positions off).
-Yf: Local horizon positions affected by atmospheric refraction.
Astrolog supports taking into account atmospheric refraction in local horizon
positions, which will affect the apparent altitude of objects. Refraction is
influenced by temperature (in which colder temperatures cause denser atmosphere
and more refraction), by elevation above sea level (in which higher elevations
have thinner atmosphere and less refraction), and by the object’s initial altitude
(in which objects nearer the horizon pass through more atmosphere and are offset
more). In a cold environment at sea level, objects near the horizon can be offset
by over half a degree in altitude due to refraction. The temperature and elevation
above sea level to use for a chart is specified with the -zf and -zv switches, or in
 the Default Chart Info dialog. Atmospheric refraction when enabled will affect
Astrolog’s local horizon chart, its Gauquelin sector chart which is based on local
horizon positions, its rising and setting charts, chart spheres, and the placement of
planets in 3D houses when arranged along the prime vertical.
-Yh: Compute location of solar system barycenter instead of Sun.
Astrolog supports barycentric charts with this switch, which has positions relative
to the solar system barycenter, or the solar system’s center of mass. Barycentric is
similar to heliocentric charts centered around the Sun, however the solar system
barycenter will vary from the Sun’s position based on the positions of the planets
(especially Jupiter which is the most massive). The solar system barycenter ranges
from inside the Sun’s body to about one Sun radius from it. For geocentric charts,
this setting will make the Sun’s position be the barycenter instead of the Sun
itself, which can affect its position in geocentric charts by up to half a degree. In
heliocentric charts, all positions will be relative to the barycenter instead of to the
Sun.
-Ym: Position planetary moons around current central object.
This switch turns on a mode such that planetary moons and other objects orbiting
planets are displayed as orbiting the central object instead. This will also affect
Earth’s Moon, the Moon’s Nodes, and Lilith. (In addition, when another star is
the central object, planets orbiting our Sun will instead be made to orbit the other
star system.) Planetary moons are usually very close to the planet they orbit,
making it necessary to do a planet centered chart to get a good look at the relative
orientation of its moons. In other words, this option overlays planet centered
moon positions with the standard natal chart. Because a planet is a mini-solar
system, there can be sympathetic connections between moons around a planet,
and planets around the Sun at the same relative angle (or even between moons
around different planets that are at the same relative angles).
-Ys [<offset>]: Sidereal zodiac positions in plane of solar system.
This will modify sidereal zodiac positions to be relative to the invariable plane of
the solar system (instead of relative to the plane of the ecliptic, which is the
default). The difference is subtle, especially for centuries near the present,
however the solar system plane is stable relative to the background of stars, in
comparison to the ecliptic which does change slightly over time. As a result this
option is useful for stellar animations spanning many thousands of years. For
example, the animation [Link]
covering a million years was generated with -Ys on.
This switch takes an optional parameter which indicates a zodiac offset value in
degrees to be added to all planet position longitudes. Unlike the similar sidereal
zodiac ayanamsa setting passed as a parameter to the -s switch, this setting is
always applied (even to tropical zodiac positions). Normally one only wants an
offset applied to the sidereal zodiac, in order to make it easier to switch back and
 forth between the standard tropical zodiac, and the sidereal zodiac with an
ayanamsa set. However, there are obscure scenarios when one wants to add to all
charts: For example, to invert all zodiac positions 180 degrees for charts in the
southern hemisphere, set this parameter to 180 when the chart latitude is below 0
degrees South.
-Yn: Compute location of true instead of mean nodes and Lilith.
This switch sets whether the North Node and South Node objects in Astrolog are
the mean or the true nodes of the Moon. This also affects whether Lilith is the
mean or true Black Moon. The mean node is the default, but toggling on the -Yn
flag will do the true node.
-Yn0: Don't consider nutation in tropical zodiac positions.
Astrolog (and the Swiss Ephemeris that it uses) takes into account nutation, or the
periodic subtle wobble of Earth’s axis. The nutation offset is small, and will be
within 18 arcseconds. The new -Yn0 switch will turn nutation off for the tropical
zodiac. (Nutation is always properly ignored in the fixed sidereal zodiac.)
-Yu: Display eclipse and occultation information in charts.
Astrolog can accurately detect eclipses and occultations/transits, or when one
planet’s disk is partially covering another. To do this, turn on this switch (which is
also available as the “Show Eclipse Information” checkbox in the Display
Settings dialog). When active, appropriate charts will indicate whether
conjunctions and oppositions are eclipses. The aspect list (-a switch), transit to
transit times (-d), and transit to transit influence (-D) charts will display next to
each aspect if it’s an eclipse, and if so whether it’s total (or an occultation in
which one body completely covers another), annular (or a transit in which one
body is passing in front of another), partial (in which one body partially overlaps
another), penumbral (in which part of the Moon is in the Earth’s shadow, i.e.
some part of the Moon’s surface is experiencing a partial Solar eclipse), or total
penumbral (a semi-rare condition in which all of the Moon is within the Earth’s
penumbra, but no part of the Moon is in the full umbra). Eclipses are marked as
total or annular only if you’re in the eclipse’s path during the time of totality or
annularity. Note that oppositions other than Sun/Moon can be eclipses or
occultations too, in which any opposition will be flagged as an eclipse if the
central body appears to overlap one body when viewed from the vantage point of
the other body. Note that for accurate Solar Eclipse times, such as detecting when
totality begins and ends, your location on Earth is very important, so you should
have topocentric positions on (-YV switch). Similarly, for Lunar Eclipses you
want to consider the effect of Earth’s shadow from the geocentric middle of the
planet, which means you should have topocentric positions off.
If the print nearest minute setting (-b0 switch) is in effect, then any eclipses will
include the percentage of the planet’s diameter involved. For example, for partial
eclipses it will range from 1% (just beginning to cover) to 99% (just shy of
 totality or annularity). For annular and total eclipses it will range from 1%
(complete overlap just begin) to 100% (planets’ middles perfectly centered at the
same position). For penumbral eclipses it will range from 1% (Moon just entering
Earth’s penumbra) to 100% (totally within penumbra).
Planetary moons can do eclipses too! Astrolog’s eclipse detection will display
lunar eclipses involving other planets and their moons, if the other planet is the
central object. For example, a lunar eclipse of Io behind Jupiter’s shadow is
interesting, because fast moving Io passes through penumbral and partial phases
in under five minutes, but it spends over two hours in totality of Jupiter’s large
shadow. Lunar eclipses of moons of other planets can also be seen in Astrolog’s
telescope chart (-XZ switch) however that requires the moon to be the object the
telescope is focused upon. (That’s because the Earth’s or the other planet’s
shadows are drawn as circles at the moon’s distance, which requires knowing
which moon is being considered.)
The transit to transit graphs (-B switch) will graph the intensity of an eclipse over
time. In the text mode transit graph, times during eclipses will be marked by
special characters: Total eclipses or occultations are indicated by “T”, annular
eclipses or transits are “A”, partial eclipses are “P”, and penumbral lunar eclipses
are “p”. In graphics mode, a second graph will be drawn in dark blue overlapping
the first. The height of this graph will indicate the type of eclipse and its
percentage progression: Penumbral eclipses will range from 1/12 to 3/12 height of
the area, partial eclipses will range from 5/12 to 7/12, and annular or total from
9/12 to 11/12. These three “zones” make it easy to see (for example) a lunar
eclipse progressing over time, and when it moves from penumbral to partial to
total.
Note that Astrolog can display special aspect glyphs indicating eclipses, in which
a filled in Conjunction glyph indicates a solar eclipse or occultation, and a filled
in Opposition glyph indicates a lunar eclipse. These glyphs are available in
Astrolog’s default font, and the filled in Conjunction is available in the Hamburg
font. Eclipse glyphs can be seen in Astrolog’s graphic aspect grid, calendar, and
transit graph charts (-g, -K, and -B switches).
-Yu0: Like -Yu but detect maximum eclipse anywhere on Earth.
Astrolog can flag Conjunctions as solar eclipses in certain charts. However,
eclipses are normally only displayed as such if they’re visible from the location
on Earth at the exact time in question, which doesn’t help with determining
whether a particular New Moon is an eclipse. If the -Yu switch is invoked as -Yu0
instead, then Conjunctions will be displayed as eclipses if they’re visible from
anywhere on Earth, and the type of eclipse (e.g. partial vs. total) and its
percentage coverage will be displayed as if one were optimally positioned on
Earth where the eclipse is at its maximum.
-Yd: Display dates in D/M/Y instead of M/D/Y format.
 This is a switch which determines whether dates are displayed in
Month/Day/Year order or in the more “European” Day/Month/Year format.
Toggling on or off this flag will specify the DMY or MDY format everywhere in
the program from text wheel charts to transit charts to the chart info displayed in
graphics charts.
-Yt: Display times in 24 hour instead of am/pm format.
This is another option which is just like the above except that it affects how times
are displayed throughout the program. When clear, times will be printed in am/pm
format, while when set they will be in the more “European” 24 hour clock.
-Yv: Display distance in metric instead of imperial units.
When the program displays distances, it’s normally in imperial units (feet or
miles). This switch will instead display distances in metric units (meters or
kilometers).
-Yr: Round positions to nearest unit instead of crop fraction.
This switch displays zodiac positions rounded up or down to the nearest minute
(or second when -b0 is active). Normally Astrolog displays positions by dropping
any fractional part, so for example a position of 12Lib34 means the actual
position is somewhere between 12Lib34:00 and 12Lib34:59. Not rounding is
better when animating Astrolog, so for example the moment when 29Sag59:59
turns to 0Cap00:00 is the exact instant of the Solstice.
-YC: Automatically ignore insignificant house cusp aspects.
This option toggles on a useful flag to automatically prevent display of irrelevant
or redundant aspects involving house cusps, processing them in a more intuitive
manner. This affects charts such as -t transit search lists, -T transit influence
charts, and -a aspect lists. First, aspects other than Conjunctions to minor cusps
will be ignored, e.g. a Sextile to the 12th house cusp is redundant and isn't really
useful, since we are more interested in the Conjunction to the 2nd house. Minor
aspects to the Angles such as the Ascendant and Midheaven are left alone.
The setting also prevents simultaneous aspects to two things that are always
opposite each other, e.g. if a transit list shows a Trine to the Midheaven, it won't
show a Sextile to the Descendant right next to it. However, if one object has been
restricted, then any aspect will be allowed to an object always opposite it (e.g. if
North Node restricted then allow any aspect to the South Node). Similarly, if one
aspect has been restricted, anything involving the supplemental aspect will be
allowed (e.g. if Trine restricted then allow all Sextiles).
-YO: Automatically adjust settings when exporting and printing.
This flag tells Astrolog to do the “smart” thing when exporting charts to other
formats. This setting has two effects: (1) When printing, if the chart background is
 black (which it is by default) then the program will automatically reverse it to
white when printing. That avoids the problem of printing and getting a mostly
black piece of paper, which wastes ink. (2) When saving text charts or copying
them to the clipboard, Ansi color will be temporarily turned off. That avoids
getting Ansi escape sequence characters in the text, which in most cases isn’t
wanted because the escape sequences aren’t parsed in most contexts.
-Y8: Clip text charts at the rightmost (e.g. 80th) column.
This setting when active will stop printing lines of text within charts if they’re
long enough to go beyond the right edge of the screen. This can be used to
prevent text from wrapping around the screen to the next line. By default, with all
objects unrestricted, certain charts will have rows more than 80 columns wide,
which can break up the chart making it difficult to read, e.g. the -r0 -g relationship
aspect grid, the -E ephemeris listing, and the -L astro-graph columns when
Uranians are included. With this option on however, these and any other charts
that can go beyond column 80, will always be displayed on one line, with
columns that would go beyond the 80th not getting printed. Note that this setting
can actually clip at any column instead of just the 80th, where the screen width
value used is the same as used for interpretation formatting, i.e. the optional
parameter to the -I switch.
-Ya[0-3]: Set text input encoding to none, IBM, Latin-1, or UTF8.
Astrolog allows one to specify the character encoding or codepage of text strings
that are read into the program and stored internally. There are multiple methods to
store special characters other than low-Ascii text. This can be an important issue
because chart information files or even content within strings on the command
line needs to specify how to handle high Ascii bytes that are present, and using
the wrong encoding can cause special characters to display incorrectly in Astrolog
text mode or graphics mode charts. The character encoding is selected with the
numeric digit subswitch to the -Ya switch (or in the Windows version with the
“Character Encoding” radio button group in the Display Settings dialog). The four
options are:
0) Default: This means don’t treat content as in any particular encoding, and never
do any character translation. In previous versions of Astrolog, there was no
character encoding anywhere. For example, Astrolog graphics charts would
assume characters were in the common Latin-1 codepage, however Astrolog text
mode charts emulate a command prompt and display using an old IBM codepage,
so special characters that display right one in one context wouldn’t in the other.
This setting will still do translation in places where it’s absolutely required, such
as when reading in Astrodatabank XML files which are known to be encoded in
UTF8.
1) IBM / DOS: This means the encoding used by old IBM and DOS computers,
sometimes called the OEM codepage or codepage 437, which is still used today
within most Windows command prompts. Unix users and even most Windows
 users should avoid this, however this option is still present because those who
primarily run the Windows command line version of Astrolog from command
prompts (which use this codepage by default) may have old chart information
files that store special strings in this manner.
2) Latin-1: This means the common encoding used by most of the Western world,
called Codepage ISO-8859-1 or Latin-1 (or more technically Windows-1252,
which is a superset of it which also defines characters in the 128-159 byte range).
For example, this is used when viewing plain Ascii text files in Windows
Notepad, or characters in classic Unix command prompts (that don’t already
support UTF8). Therefore, this is the generally the simplest option that will work
in most cases. Like #1, this is a single byte codepage, so only covers 256 possible
Unicode characters, which means other characters will be displayed as “?” if
necessary. Some file formats are always saved in this format, such as PostScript
and Windows metafiles.
3) UTF8 Unicode: Unlike #1 and #2, this is a multibyte codepage, which uses two
or three bytes to encode high-Ascii and high Unicode characters greater than 127.
Because this can cover the entire Unicode range, this option can display East
Asian and other special characters. These special characters are available when
saving to HTML output, and for graphics charts on the Windows screen when
using system fonts. When Astrolog saves text chart in UTF8, the first three bytes
in the file will be the special UTF8 byte order mark (BOM) which indicates the
file is in that format (which most text readers that understand UTF8 will
automatically skip over).
-Yao[0-3]: Set output encoding to none, IBM, Latin-1, or UTF8.
The -Ya setting above will not internally change the byte content of strings, but
rather it just affects how they’re displayed. (That means if special characters ever
display incorrectly or as garbage character sequences, changing the character
encoding setting will likely fix it.) There’s a parallel setting defined by the -Yao
switch used to set the encoding for how strings should be output to file. Combined
with the input encoding defined by -Ya, this can allow one to do codepage
conversions, for example if they want to convert an Astrolog chart information
file known to be in one encoding, into a different encoding.
-YQ <rows>: Pause text scrolling after a page full has printed.
This feature gives you the option to have Astrolog automatically stop whenever
the screen gets filled with text and prompt before scrolling to the next page. It
takes one parameter to define the number of rows to print before prompting the
user to press return to continue. If set to zero, the feature will be turned off and
Astrolog will print continuously until done. This helps those who may be
concerned about the program scrolling things off the screen before they can read
it. Without this one would have to press Ctrl-s to have the system pause printing,
send output to a file to inspect afterward, or be on a system with scrollbars to see
everything. This feature is off by default, but can easily be changed to a common
 screen height such as 24 rows in the [Link] file. When the program is paused,
one can type a couple things before pressing return: Entering ‘q’ or ‘.’ will
terminate the program, entering ‘Q’ will turn off the feature and scroll until done,
‘8’ will toggle the right hand column clipping setting, and ‘k’ will toggle the Ansi
color setting.
-Yq[0-9] <strings>: Define command lines to run and show in sequence.
This obscure switch allows appending multiple text charts within a single display.
It takes between 0-9 parameters, depending on whether it’s invoked as -Yq0, -
Yq1, and so on. If there’s no digit character after -Yq, then it’s assumed to have
zero parameters, and will turn off this feature. Astrolog will treat each parameter
as a command line, and then display the resulting chart after each command line
is processed. This is basically equivalent to having a batch script invoke Astrolog
several times in a row and appending the results together. For example, “-Yq2 "-n
_e =dm -YRo -R0 Sun Moo -A 0 -RA Opp -YR0 1 1" "-i set _e _d -YRi"” will
cast a chart for the time of the Full Moon this month.
-Yi[0-9] <path>: Specify directory to search within for files.
This switch is a way to specify search paths for loading files, such as ephemeris
files and chart information files. It takes one parameter indicating a directory to
look within for files. This can be an absolute path relative to the root of the file
system, or a relative path relative to the directory of the Astrolog executable.
There are actually ten different switches -Yi0 through -Yi9 (in which -Yi by itself
is equivalent to -Yi0) which can cover ten different paths. The default [Link]
default settings file contains a couple instances of -Yi pointing to sample
directories. Downloads of Astrolog place all ephemeris files in the “ephem”
subdirectory, and use -Yi to point to this subdirectory. Note that -Yi can’t be used
to help find [Link] itself for its initial loading, because the [Link] file is
loaded early before even the command line is processed. However, because the
directory of the executable is searched before anything else, placing [Link]
next to the executable will ensure it’s found, and -Yi switches inside [Link]
can be used to point to any other paths. System environment variables pointing to
directories such as ASTROLOG are supported, but aren’t necessary to define file
paths.
-Yo: Output chart info and position files in old style format.
Astrolog can still read in all old style -o info and -o0 position chart files generated
by previous versions of the program without problem. Not only that, but it will
write out these old formats too if the -Yo switch is put into effect. When set, it
will output -o and -o0 files exactly as in version 4.10 and before, in simple lists of
numbers in fixed fields instead of in generic command switch files.
-Yc: Angular cusp objects are house positions instead of angles.
This switch determines whether the angular house cusp objects (i.e. object
indexes 22, 25, 28, and 31) contain the position of their respective house cusps, or
 the positions of the Ascendant, Nadir, Descendant, and Midheaven. These
positions are always the same except for certain house systems, e.g. in the Equal
house system the position of the 10th cusp is different from the Midheaven.
Normally the angular house objects always contain the positions of the Asc, MC,
etc, however this feature gives the user the option to have the objects’ contents be
the positions of the cusps as defined by the house system in use. Similarly, the
default graphic glyphs for the Asc/MC/Des/IC objects are those letter
abbreviations. When this setting is on, the default graphic glyphs will instead be
the number of the house cusp, and also the display text used for the object will
indicate the house number instead of the angle’s name. This will make it clearer
what is actually being shown, transited over, and so on.
-Yp: Fix polar houses by preserving Ascendant instead of MC.
When a chart is cast in a polar region within the Arctic or Antarctic Circle, the
Ascendant may be more than 180 degrees after the MC, which makes it
impossible to have proper house cusps (at least for systems that associate the Asc
with the 1st house and the MC with the 10th). Normally Astrolog addresses this
by flipping the Ascendant 180 degrees if it’s in the wrong half of the zodiac. If the
-Yp switch is set, the MC will be flipped 180 degrees instead. This setting has no
effect when Swiss Ephemeris is active and computing house cusps.
-Yz <min>: Forward clock by amount for current moment charts.
This obscure switch, taking one parameter for the number of minutes, allows one
to offset forward or backward the time considered to be the current moment now.
This is useful if your -n now charts always seem to be a few hours or whatever
off, as seems to be the case on certain Mac or Amiga systems. For example, if -n
says it’s 3:30pm when it’s really 1:30pm, doing “-Yz -120” will back up the clock
appropriately (and change the planetary positions slightly too). It’s important that
this switch be used as a last resort instead of first, where one should first check
their system time, the system time zone setting such as may be set with the TZ
environment variable, and Astrolog’s default time zone. A line for this setting
appears in the default [Link] file.
-Yz0 <sec>: Set seconds of Delta-T to always use for charts.
Astrolog takes into account Delta-T when processing and displaying times, which
means leap seconds which are periodically inserted within certain years due to the
very gradual slowing of Earth’s rotation. This switch allows one to manually
specify the Delta-T offset to use, in number of seconds, which may be useful for
specialized scenarios like comparing calculations between sources using different
Delta-T models.
-YzO <hr>: Forward object positions by amount for all charts.
-YzC <hr>: Forward cusp positions by amount for all charts.
These obscure settings are similar to the -Yz correction factor switch which adds
the given number of minutes to all now charts. The -YzO switch takes one
 floating point parameter, and will add the given number of hours to the computed
object positions of all charts. Also, the -YzC switch will add the given number of
hours to the computed house cusp positions of all charts. If either of these offsets
are present, they will be listed in the sidebar of wheel charts. Together, they can
be used to experiment with progression related or other chart adjustment methods.
-Y1[0] <obj1> <obj2>: Rotate planets so one is at other's position.
This switch is similar to the existing -1 solar chart switch, except instead of
rotating house cusps by an offset so they’re at a planet’s position, this rotates all
planets by an offset so they’re at the original position of some planet. This switch
takes two parameters specifying planets that represent an offset, such that after
shifting, the first planet is at the original position of the second. If the switch is
invoked as -Y10, it will instead rotate everything so the first planet is at the start
of the sign of the second planet’s original position. This option is considered
turned off and will have no effect if the two parameters are the same (and the “0”
part isn’t active). This general feature allows generating certain types of charts,
such as Esoteric Astrology wheels and Draconic charts. A Draconic chart is where
all planet positions are rotated such that the North Node is at 0Aries, which means
“-Y1 Nod Vul” (with “Vul” being a restricted object or one forced to be located at
0Aries) will produce a Draconic chart.
-YZ <0-7>: Set orientation of azimuth for -Z local horizon chart.
This switch will set how azimuth numbers in the text mode local horizon chart (-Z
switch) are determined. By default, azimuth in Astrolog starts at 0 degrees on the
East horizon, passing through 90 degrees on the North horizon. However,
alternative true north-based azimuths start with 0 on the North horizon. The
parameter to the -YZ must be from 0-7, and it indicates where 0 degrees starts,
and toward which direction degrees increase. Each number indicates an additional
90 degrees added to the azimuth, in which 0-3 means degrees increase
counterclockwise when looking down upon the horizon, while 4-7 increases
clockwise. For example, a parameter of 1 indicates 0 degrees on the South
horizon passing through 90 degrees on the East horizon, while 5 indicates 0
degrees on the North horizon passing through 90 degrees on the East horizon.
-Yl <1-36>: Toggle plus zone status of sector for sector chart.
This command switch is used with the -l sector charts and sets whether a sector is
a plus zone sector or not. Taking one parameter of a sector number, it toggles the
plus zone status of it. Like the -R restriction switches, the “_” prefix may be used
to make a sector minus and the “=“ prefix to make a sector plus.
-YP <-1,0,1>: Set how Arabic parts are computed for night charts.
This is an obscure option allowing one to force whether night chart formula
inverting is done in the -P Arabic part chart list, since sources differ on which
parts are best inverted. This option takes one parameter, either -1, 0, or 1. Zero is
the default setting, meaning the program will invert only those parts that have the
 flip flag set, for charts cast at night. If the setting is 1, then no inverting will ever
be done for any part, even in night charts. If the setting is -1, then inverting will
always be done for every part, even in day charts. Note that the Part of Fortune
does appear both in the -P full part list, as well as being the only part that’s also a
standard object (object #19) meaning it’s the only part one may automatically do
aspects or transits to. Note also that in the -P chart the Part of Fortune inverts for
night charts, meaning the standard object in the main object list does too.
-Yb <days>: Set number of days to span for biorhythm chart.
This switch, taking one parameter, specifies how many days to include in the
biorhythm charts. It will control the number of days spanned in the text biorhythm
listing, and number of days plotted before and after the given day in the graphic
biorhythm chart.
-Ye <obj> <index>: Change orbit of Uranian to external formula.
Astrolog supports custom planets beyond the set of objects it normally works
with. This switch customizes planet positions. It takes two parameters: One for
the object to replace, and another for the object to replace it with. The source
object must be one of the 50 objects in the Uranian hypothetical object category
(Vulcan or one of the eight Uranians), the Dwarf planets object category, or the
planetary moons object category. The destination object is defined by an index in
the “[Link]” text file in the Astrolog install directory. For example, “-Ye Cup
9” will replace Cupido with Isis-Transpluto, and “-Ye Had 18” will replace Hades
with Proserpina. Note this feature requires Swiss Ephemeris to be active (which it
is by default) in order to take effect. Astrolog will also automatically query the
name of the new object and change the name of the object slot, and also turn off
the object’s glyph so it’s displayed as an abbreviation of its new name. Renaming
the object and redefining its glyph can also be done manually with the -YD and -
YXD switches.
-Yeb <obj> <index>: Change orbit of Uranian to external ephemeris.
Astrolog can access custom bodies whose positions are in external Swiss
Ephemeris format ephemeris files (such as Salacia and Ixion) with the -Yeb
switch. This is similar to the -Ye switch which allows accessing the orbital
elements of fictitious bodies in the [Link] file. Simply download the desired
ephemeris file from [Link] and place it in the
same directory as the other ephemeris files. Pass the number of the ephemeris file
to the -Yeb switch, and the object in question will be replaced with the positions
of the new object. For example, to show the position of the centaur 10199
Chariklo, download [Link]
and then do “-Yeb Cup 10199” to replace the position of Cupido with Chariklo.
See [Link] for an index of which asteroids
map to which numbers.
-Yem <obj> <index>: Change orbit of Uranian to planet moon ephemeris.
 Astrolog can access planetary moons whose positions are in Swiss Ephemeris
format ephemeris files (such as Saturn’s Titan and Jupiter’s Ganymede) with the -
Yem switch. This is like -Yeb, except it references a planetary moon ephemeris
file instead of an asteroid ephemeris file. Planetary moon ephemeris files have
filenames like “sepm9XYZ.se1”, in which “XYZ” is the designation for the
moon. In this designation, “X” is the planet being orbited (4=Mars, 5=Jupiter,
6=Saturn, 7=Uranus, 8=Neptune, 9=Pluto) and “YZ” is the moon in question. For
example, “sepm9501.se1” defines Jupiter’s Moon Io. This moon can be assigned
to Cupido’s object slot with “-Yem Cup 501”. Also, “moon” #99 is the true non-
barycentric position of the planet, e.g. “sepm9599.se1” defines the actual position
of Jupiter’s center of body taking into account the gravitational perturbations of
its moons (in comparison to the standard Jupiter planet object which is the center
of mass of the Jupiter system). When slots are customized to be planetary moons
(either with this switch or with -Yej) the slot will be treated as a planetary moon
in all ways, e.g. it will start appearing in the planetary moons chart, it will be
automatically colored based on the planet it orbits, and so on. Note that this
switch is no longer necessary to compute planetary moon positions themselves,
since Astrolog has separate object slots for each moon now, however it can still
be used to compute alternate versions of a moon (e.g. toggle the sidereal zodiac
setting as described below). For more about planetary moons, how to use and
interpret them in astrology, and how to display them in Astrolog, see:
[Link]
-Yej <obj> <index>: Change orbit of Uranian to JPL Horizons Web query.
Astrolog can compute planet positions using direct online queries to the JPL
Horizons Web site. This switch allows customizing an object slot to be the index
of a JPL Horizons computable body. This feature is designed for objects not yet
supported by Swiss Ephemeris, such as less common planetary moons or space
probes. To determine the JPL Horizons index number for a body, visit
[Link] change the “Target Body” to what you’re
interested in by looking up its name, then click “this link” at the bottom to show
the batch-file corresponding to the settings, and finally look at the
“COMMAND=” line to see the number. You can also generate any ephemeris,
and look at line #2 in the results header for the number. Note if the number ends
in a semicolon (which is true for asteroids and other minor bodies) then you
should add a million to the number passed to Astrolog.
For example, “-Yej Vul 505” will customize Vulcan’s object slot to be Jupiter’s
moon Amalthea, however “-Yej Vul 1000505” will customize Vulcan to be
asteroid “505 Cava”. In the Windows version, in the “Object Customization”
dialog, an object may be given the definition starting with “j” to refer to the
relevant JPL Horizons object. For example, to calculate the position of Dwarf
planet Eris’ moon Dysnomia, set an object to have the definition of
“j120136199”, or pass the number 120136199 to the -Yej switch. For another
example, to calculate the position of comet “C/2022 E3” (the “green comet”), set
an object to have the definition of “j90004682” (after which “Lookup Names” in
 the Object Customization dialog should display the body's Name as “ZTF”,
standing for “Zwicky Transient Facility” which discovered it, which is a quick
way to verify the right object has been defined).
Because every planet calculation involves an online Web query, this switch
results in a noticeable slowdown of the program, so shouldn’t be used with transit
searches or places that internally cast many charts. In Unix versions of Astrolog,
this works by internally doing a system shell call to the “wget” command, which
requires that utility to be installed. For example, the following animation shows
the five spacecraft which have exited the solar system so far (Pioneer 10, Pioneer
11, Voyager 1, Voyager 2, and New Horizons) in which Swiss Ephemeris
computed the planets, and JPL Horizons Web queries computed the space probes:
[Link]
-YeO <obj1> <obj2>: Change orbit of Uranian to internal planet.
-Ye[..]n <obj> <index>: Change Uranian to North Node of object.
-Ye[..]s <obj> <index>: Change Uranian to South Node of object.
-Ye[..]a <obj> <index>: Change Uranian to aphelion of object.
-Ye[..]p <obj> <index>: Change Uranian to perihelion of object.
Astrolog can access the nodes and helion points of planets, by defining them as
custom bodies. The -Ye command switch can be invoked in four different ways to
select these points: -Yen for the north or ascending node, -Yes for the south or
descending node, -Yep for the perihelion point or point on its orbit nearest the
Sun, and -Yea for the aphelion point or point farthest from the Sun. (For the
Moon, -Yep and -Yea produce the perigee and apogee points nearest to and
farthest from the Earth.) These four points exist in space, and the planet in
question will pass through them along its orbit. As with the Moon’s nodes,
Astrolog’s true node vs. mean node setting (-Yn switch) will influence these
positions. The -Ye switch is invoked in one of three ways to indicate the type of
object in question: -Ye by itself for fictitious bodies in [Link], -Yeb for
asteroids in custom ephemeris files, and -YeO for an existing planet in Astrolog’s
standard list. For example, “-Yen Cup 9” redefines Cupido’s slot to be the north
node of Transpluto or [Link] object #9, “-Yebs Cup 9” redefines Cupido to be
the south node of the asteroid Metis assuming se00009s.se1 has been
downloaded, and “-YeOa Cup 9” redefines Cupido to be the aphelion point of
Neptune or Astrolog object #9. (Warning: The -Yen example and others like it
don’t actually work, because node and helion points of [Link] objects and
planetary moons aren’t implemented yet.)
-Ye[..]HSBNTV <obj> <index>: Toggle heliocentric, sidereal zodiac, barycentric, true
node, true position, or topocentric for object.
The -Ye switch allows the custom objects to have different settings from the
default. For example, this feature can allow displaying the true node alongside the
mean node and check for aspects between them, or plot how the Sun’s position
changes over time relative to the solar system barycenter. The -Ye switch can be
 ended with six different subswitch characters, which may be chained together to
toggle multiple settings at once:
-YeH: Toggle the heliocentric setting of the customized object (-h switch).
-YeS: Toggle the sidereal zodiac setting of the customized object (-s switch).
-YeB: Toggle the barycentric setting of the customized object (-Yh switch).
-YeN: Toggle the true node setting of the customized object (-Yn switch).
-YeT: Toggle the true positions setting of the customized object (-YT switch).
-YeV: Toggle the topocentric positions setting of the customized object (-YV
switch).
-YE <obj> <semi-major axis> <eccentricity (3)> <inclination (3)> <perihelion (3)>
<ascending node (3)> <time offset (3)>: Change orbit of object to be the given
elements.
This feature allows one to “define their own planets”, by changing the orbital
elements of one of Astrolog’s objects. This switch takes 17 parameters, which
specify all the data needed for any elliptical orbit around the Sun. The parameters
are as follows: First is the object to redefine; second is the semi-major axis of the
new orbit, in AU; next are three parameters for the eccentricity of the orbit’s
ellipse; next are three parameters for the inclination of the orbit with respect to the
ecliptic, in degrees; next are three parameters for the argument of perihelion,
which is the “rotation” of the orbit in degrees or how far away its perihelion is
from zero Aries; next are three parameters defining the ascending node, which is
the “tilt” of the orbit or how far away the point where the orbit intersects the
ecliptic is from zero Aries; finally are three parameters for the “mean anomaly”
which is basically where on the orbit the planet is at a reference time and how fast
it moves along it. Many of the above element settings take three values when it
seems like only one is needed. The second and third values are used as linear and
quadratic error factors to the first, and can be zero unless every last bit of
accuracy that can be provided outside of ephemeris files is needed. Note that these
parameters basically replace the same elements as used in the old Matrix
formulas. This means the -YE switch settings are ignored when the -b ephemeris
flag is in effect. Note also that the Matrix formulas have special error factors
applied on top of their main elements for Jupiter through Pluto, hence it’s
recommended to only redefine asteroids, Uranians, or inner planets. The
following example will roughly move Venus into Earth’s orbit: “-YE 4 1 0 0 0 0 0
0 0 0 0 0 0 0 0 0 23000”. Note this feature requires the old Matrix formulas (-bm
switch) to be on in order to take effect, and is therefore outdated and only still
present for backwards compatibility.
-YU <obj> <name>: Change position of star to [Link] entry.
Astrolog’s list of stars can be customized. The -YU command switch takes two
parameters: The existing object index or star name to replace, and a string for a
star name from the file [Link] in the Astrolog install directory to compute
instead. This star name can be the traditional or common name in the first column
of the file, or the scientific nomenclature name in the second column of the file if
 the name starts with a comma. For example, “-YU Ache Algol” or “-YU
84 ,bePer” will both replace the star Achernar (object #84) with the star Algol or
Beta Persei. You may also want to change the object’s name with the -YD switch
to complete the customization (i.e. “-YD Ache Algol”. If a star is defined to "" or
the empty string, then that will turn off customization for that slot, and return to
Astrolog’s internal default. This feature requires Swiss Ephemeris to be the active
method of star computation in order to work.
-YUb: Adjust star brightness to apparent magnitude based on distance.
Star brightness is usually a fixed value indicating the star’s magnitude as currently
viewed from Earth. This switch adjusts star brightness based on the star’s current
distance from the central object. This is useful when doing charts for extreme past
or future times (in which the stars have drifted to different distances and therefore
brightnesses) and especially when casting charts centered on other star systems
(which have a more immediate effect on distance and brightness). For example,
the star Sirius is magnitude -1.46 now, however in the year 38,000 when it’s
closer to our Sun it will have brightened to -1.57, and by the year 300,000 it will
have dimmed to just +0.01.
-YUb0: Set brightness to distance independent absolute magnitude.
This switch makes brightness be displayed as a star’s absolute magnitude, or the
inherent brightness of the star independent of distance (which is defined as the
magnitude of the star when viewed from 10 parsecs or 32.6 light years away).
Note that objects with no brightness such as the Great Attractor, will always have
their brightness displayed as 999.99. In addition to stars themselves, this setting
will also affect planet magnitudes in the text mode local horizon chart (-Z switch).
For example, Venus is the brightest planet in the sky due to its close distance to
Earth, however if all planets were equal distance then Jupiter and sometimes
Saturn would be brighter.
-YS <obj> <size>: Set diameter of object to be specified size.
This switch will set the diameter of the specified object to the given number of
kilometers (or miles if given with the suffix “mi”). This is relevant for eclipse
detection and charts which draw planet disks, especially if an object slot is
customized to be a different body. For example, if you’ve ever wanted to know
what the Moon would look like in our sky if it were as big as Jupiter, do “-YS
Moo 142984”. The result will be that the “Moon” now spans 22 degrees and is
nearly 50 times wider!
-YR <obj1> <obj2> <flag1>..<flag2>: Set restrictions for object range.
This is like the -R switch except that it explicitly sets the restrictions for a range
of Astrolog objects instead of just one. The first two parameters specify the lower
and upper object bounds, and are followed by zero or one flag parameters to clear
or set the restriction status of each object within the range.
-YRT <obj1> <obj2> <flag1>..<flag2>: Transit restrictions for range.
This behaves exactly like the -YR switch above except it affects transit
restrictions, like how the -RT switch is to -R.
-YR0 <flag1> <flag2>: Set restrictions for sign, direction changes.
This sets the restriction status for sign and direction changes. It takes two
parameter flags, with the first setting for sign changes, and the second direction
changes. This affects the -d daily event searches, and works like the -R
restrictions but for all types of these special events, instead of all aspects or all
events containing a particular object.
-YR1 <flag1> <flag2>: Set restrictions for latitude, distance events.
The transit to transit times chart (-d switch) can also detect times of when a
planet’s latitude reaches highest or lowest, and when a planet reaches most or
least distance from the central object (i.e. reaches apoapsis or periapsis points).
Combined with the ability to detect when a planet goes retrograde or direct, this
chart has events for all axes in 3D spherical coordinates (horizontal axis = zodiac
position changing retrograde or direct, vertical axis = latitude reaching high or
low point, and distance axis = planet reaching apoapsis or periapsis). This switch
allows restricting whether these latitude or distance events are included in the
chart (which they are by default, since these events are less commonly used). It
takes two parameter flags, with the first setting controlling latitude events, and the
second distance events.
-YR2 <flag1> <flag2>: Set restrictions for node, equidistant events.
Node crossing events: Astrolog’s transit to transit times chart (-d switch) has the
ability to detect events where the latitude of a planet crosses zero (i.e. crosses a
nodal point). Enable these events with the first parameter to the -YR2 switch
(which indicates the restriction status of north and south node crossings) or with
the “Latitude Zero Crossing” checkbox in the Transits dialog. These events will
be displayed in charts as “LA0 North” and “LA0 South”. The North Node is
where an object crosses a plane from negative to positive altitude, while the South
Node is where it crosses a plane from positive to negative altitude.
Equal distance events: Astrolog’s transit to transit times chart (-d switch) and
transit to natal times chart (-t switch) have the ability to detect events where two
planets are of equal distance from the observer. Enable this event with the second
parameter to the -YR2 switch (which indicates the restriction status of equidistant
events) or with the “Distances Equal” checkbox in the Transits dialog. This event
will be displayed as “EqD” in charts. This effectively introduces a new aspect
type along the distance axis, similar to how standard aspects measure alignment
along the horizontal or longitude axis, and how parallel and contraparallel aspects
measure alignment along the vertical axis. Note that some planet pairs will never
be equidistant from each other, such as outer planets (which are always far away)
with inner planets (which are always relatively close).
-YRZ <rise> <zenith> <set> <nadir>: Set restrictions for -Zd chart.
This switch allows one to determine which events appear in the -Zd rising and
setting time chart. It takes four parameters, which respectively control whether
rising events, zenith transit events, setting events, and nadir transit events are
included in the chart. A zero value indicates to include that event, while a one
means to restrict it. For example, to include only rising and setting events in the -
Zd chart, do “-YRZ 0 1 0 1”. These restrictions also affect the -L graphic astro-
graph chart, and will control whether the Ascendant, Midheaven, Descendant, and
Nadir lines are drawn.
-YR7 <ruler> <eso> <hier> <exalt> <ray>: Set rulership restrictions.
This switch controls what types of rulerships and exaltations are shown in charts.
It takes five parameters, one for each of the five types of rulerships: Standard
rulerships, esoteric rulerships, Hierarchical rulerships, exaltations, and Ray
Rulerships. As with other restriction switches, a zero value means show, and non-
zero means restrict. The [Link] default settings file contains a line for these
variables. Rulership restrictions will affect what’s shown in the standard -v chart
list, what’s shown in the -7 esoteric chart, and also what set of rulerships is used
in the graphic -J switch dispositor chart.
-YR[oi]: Store or recall all object, aspect, and other restrictions.
The -YRo switch will store and remember a copy of all restrictions. The -YRi
switch will do the reverse and recall and restore the most recent set of restrictions
saved with -YRo. This includes object restrictions, transiting object restrictions,
aspect restrictions, sign and direction restrictions, rising/setting angle restrictions,
and rulership set restrictions. This is useful for scenarios such as automatically
finding the time of and displaying the chart for an event, in which one first
restricts all objects to the set necessary to find the event, and then later restores
the original set for displaying the chart. For example, to display the chart for the
Full Moon this month, do: astrolog -Yq2 "-n _e =dm -YRo -R0 Sun Moo -RA0
Opp -YR0 1 1" "-i set _e -YRi"
-YRd <div>: Set divisions within signs to search for degree changes.
The transit to transit times search (-d switch) can include planetary crossovers into
a new degree. This is similar to the existing feature of the chart which shows
planetary crossovers into a new sign. This switch determines how many sections
to divide each sign into, when checking for a planet crossing into a new section.
Only if this setting is greater than one will it introduce new events in to the transit
times list. For example, setting it to 2 will divide each sign into two halves and
display when planets transit the 15 degree mark of each sign, setting to 3 will
divide each sign into three pieces and display when planets cross the 10 and 20
degree marks, 30 will display when planets cross each degree, and so on.
This setting will also cause houses in graphic wheel charts to be subdivided into
the specified number of equal sized sections. Hatch marks will be displayed
 within each house, dividing the house in a similar fashion as to how signs are
divided into 30 divisions of one degree each.
-YRh: Don't auto(un)restrict central planet when changing it.
Changing the central planet will automatically unrestrict the old central planet and
restrict the new central planet from appearing in charts. For example, switching
from geocentric to heliocentric (through either the Windows interface or the
command line) will automatically restrict the Sun and unrestrict the Earth to
reflect what looks best in a heliocentric chart. Restrictions will only be changed if
both the old central planet is restricted and the new central planet is unrestricted.
This behavior is active by default, but can be prevented with the -YRh switch. If
turned on, then no restrictions will change when the central planet is changed.
-YRU[0] <starlist>: Restrict or focus on list of extra stars.
The collection of extra stars shown by the Show Full Star List setting (-XU
switch) supports ways of focusing upon or excluding certain stars. The -YRU
switch will restrict certain stars from appearing, while the -YRU0 switch will
make only certain stars appear and ignore all the rest. It takes one parameter, a
comma separated list of strings indicating star names. For example, “-YRU0
Alkaid,Mizar,Alioth,Megrez,Phecda,Merak,Dubhe” will make the extra stars
feature only show the seven stars of the Big Dipper, and skip all other stars.
-YAo <asp1> <asp2> <orb1>..<orb2>: Set aspect orbs for range.
This is like -Ao but sets the orbs for a range of Astrolog aspects instead of just
one. The first two parameters specify the lower and upper aspect index bounds,
and are followed by a list of orb values for each aspect in the range.
-YAm <obj1> <obj2> <orb1>..<orb2>: Set max planet orbs for range.
This is like -Am but sets the maximum aspect orbs allowed to a range of objects
instead of just one. Again, the first two parameters are the lower and upper object
indexes, followed by the list of max orb values.
-YAd <obj1> <obj2> <orb1>..<orb2>: Set planet orb additions for range.
This is like -Ad but sets the planet orb addition values for a range of objects
instead of just one. Again, the first two parameters are the bound indexes, and are
followed by the list of planet orb additions.
-YAa <asp1> <asp2> <ang1>..<ang2>: Set planet aspect angles for range.
This is like -Aa but sets the angles to use for a range of aspects instead of just one.
Again, the first two parameters are the bound indexes, and are followed by a list
of angle degree values for each aspect in the range.
-YAD <asp> <name> <abbrev> <glyph>: Customize display names of aspect.
 This changes the name of aspects, or what strings are used to display them in
charts. The feature is best used if one customizes an aspect’s angle to a new value,
to completely replace one aspect with another. This switch takes four parameters:
The aspect to rename, and then three strings for the aspect’s new name, the
aspect’s new three letter abbreviation, and a description of the aspect’s glyph.
Note that renaming aspects only changes how they’re displayed in charts, which
means command switches still need to refer to the aspect by its default name.
-Yj <obj1> <obj2> <inf1>..<inf2>: Set influences for object range.
This sets the powers or influences of the given range of planets, when considered
in a natal chart, as used in charts such as the -j influence chart, -a aspect influence
list, and -T transit influence list. Every object has its own index, except fixed stars
are collectively covered by slot #43 (the index of the first fixed star). Setting that
slot will set the influence for all stars. Similarly, the command line will parse the
string "star" to match this index of the first star. For example, “-Yj star star 4” will
set the influence of all stars to 4.
-YjC <cusp1> <cusp2> <inf1>..<inf2>: Set influences for house cusps.
This sets the influences for the given range of houses, as used in charts such as -j.
-YjA <asp1> <asp2> <inf1>..<inf2>: Set influences for aspect range.
This sets the influences for the given range of aspects, as used in charts such as
the -j influence chart, -a aspect influence list, and -T and -D transit lists.
-YjT <obj1> <obj2> <inf1>..<inf2>: Set transit influences for range.
This sets the influences of the given range of planets, just like -Yj, except here for
when the planets are transiting, as used in charts such as the -T transit and -D
external planets influence lists.
-Yj0 <inf1> <inf2> <inf3> <inf4>: Set influences given to planets in ruling sign, exalted
sign, ruling house, exalted house.
This switch takes four parameters and sets respectively, the extra influences given
to a planet when it’s in the sign it rules, when it’s in the sign it exalts in, when it’s
in the house corresponding to the sign it rules, and when it’s in the house
corresponding to the sign it exalts in. These values are used in examples such as
the -j influence chart.
-Yj7 <inf1> <inf2> <inf3> <inf4> <inf5> <inf6>: Set influences for in esoteric,
hierarchical, Ray ruling sign, plus same for house.
This switch defines power numbers for esoteric positionings, as used by the -7
switch esoteric charts. It takes six parameters. The first three are the power added
to a planet when it’s in the sign it esoterically rules, the power when a planet’s in
the sign it Hierarchically rules, and the power when a planet’s in the sign it Ray
 rules. The second three are the same, but are the power added to a planet when it’s
in the house corresponding to the sign it esoterically, Hierarchically, or Ray rules.
-YJ <obj> <sign> <cosign>: Set sign planet rules and co-rules.
This switch allows one to customize the rulerships of a given planet. It takes three
parameters, the object to modify, the zodiac sign for it to rule, and a second sign
for it to co-rule. Pass in the value zero to make a planet not rule any sign. For
example, Jupiter by default rules Sagittarius and co-rules Pisces. If you'd prefer it
to rule Cancer and not have a co-rulership, do “-YJ Jup Can 0”.
-YJ0 <obj> <sign>: Set zodiac sign given planet exalts in.
Similar to the -YJ switch, this allows one to customize the zodiac sign a given
planet exalts in. It takes two parameters, the object to modify, and the new sign to
exalt in (with a zero value meaning no exaltation). For example, to make Pluto
exalt in Aries (and hence implicitly have its fall in the opposite sign Libra) do “-
YJ0 Plu Ari”.
-YJ7 <obj> <sign> <cosign>: Set signs planet esoterically rules.
-YJ70 <obj> <sign> <cosign>: Set signs planet hierarchically rules.
These switches customize esoteric and Hierarchical rulerships. They are very
similar to the -YJ switch that customizes a standard exoteric rulership. These
switches take three parameters: The planet to change the rulership of, the sign that
it rules, and a second sign that it also rules if any.
-Y7O <obj1> <obj2> <ray1>..<ray2>: Customize object rays.
The Ray associated with each planet can be customized with this switch. The first
two parameters are the low and high object indexes to change. The next
parameters are the new Rays for objects within those indexes, ranging from 1 to 7.
-Y7C <sign1> <sign2> <rays1>..<rays2>: Customize sign rays.
The Rays associated with each zodiac sign can be customized with this switch.
The first two parameters are the low and high sign indexes to change. The next
parameters are the set of Rays for each sign within those indexes. Since a sign
may be associated with more than one Ray, each setting change may be multiple
digits, for example “-Y7C Cap Cap 137” will make Capricorn associated with
Rays 1, 3, and 7.
-YI <obj> <string>: Customize interpretation for object.
-YIa <sign> <string>: Customize interpretation adjective for sign.
-YIv <sign> <string>: Customize interpretation verb for sign.
-YIC <house> <string>: Customize interpretation for house.
-YIA <asp> <string>: Customize interpretation for aspect.
-YIA0 <asp> <string>: Customize aspect interpretation statement.
 You can customize the core phrases as used in Astrolog’s interpretations. All
these switches take two parameters: the index of the item to change, and the string
to set it to. (You probably want to enclose any strings in quotes so they are treated
as a single parameter and not split at the spaces.) The things that can be changed
and the switches to do them follow:
-YI <obj> <string>: This sets the meaning for the given planet or object, i.e. the
part of one’s mind the planet represents. For example, the default setting for
Jupiter would be: -YI 6 "enthusiastic, faithful, wise, expansive, spontaneous
nature".
-YIC <house> <string>: This sets the meaning for the given house, i.e. the area of
life that house represents. For example, the default for the first house is: -YIC 1
"establishment of personal identity".
-YIa <sign> <string>: This sets the characteristics for the given sign, i.e.
adjectives describing it. For example, the default for Gemini is: -YIa 3
"inquisitive, witty, perceptive, adaptable".
-YIv <sign> <string>: This sets the desires for the given sign, i.e. verbs describing
what something characterized by it seeks. For example, the default for Virgo is: -
YIv 6 "works toward perfection".
-YIA <asp> <string>: This sets the meaning for the given aspect, i.e. the type of
interaction going on when the aspect is in effect. For example, the default for the
Trine is: -YIA 4 "is in harmony with". Special note: If the optional characters
“%s” appear in the given string anywhere, Astrolog will replace them with an
appropriate adverb indicating how strong the effect of the aspect is (and include
the trailing space). For example, the real default for Trine is: -YIA 4 "is %sin
harmony with”, where the “%s” will is replaced with "always ", "somewhat ", etc,
as appropriate.
-YIA0 <asp> <string>: This sets the conclusion for the given aspect, i.e. an
additional sentence about it. For example, the default for the Opposition is: -YIA0
5 "Adaptation is required by both sides".
-YkO <obj1> <obj2> <col1>..<col2>: Customize planet colors.
-YkC <fir> <ear> <air> <wat>: Customize element colors.
-YkA <asp1> <asp2> <col1>..<col2>: Customize aspect colors.
-Yk7 <1..7> <1..7> <col1>..<col2>: Customize Ray colors.
-Yk0 <1..7> <1..7> <col1>..<col2>: Customize 'rainbow' colors.
-Yk <0..8> <0..8> <col1>..<col2>: Customize 'general' colors.
Astrolog can customize the colors as used for almost anything in the program. A
color may be set to any one of 16 values, represented by the numbers 0 to 15,
which are: 0 - Black, 1 - Maroon, 2 - DkGreen, 3 - Orange, 4 - DkBlue, 5 -
Purple, 6 - DkCyan, 7 - LtGray, 8 - Gray, 9 - Red, 10 - Green, 11 - Yellow, 12 -
Blue, 13 - Magenta, 14 - Cyan, 15 - White. When entering a color as a parameter,
use the correct number above, or else type the color’s name as printed above
(which may be abbreviated to the first three characters). The switches to change
color settings are below.
-YkO <obj1> <obj2> <colors> switch: Colors of planets and other objects can be
set with this switch, which takes at least three parameters. The first two
parameters are the low and high object indexes to change. The next parameters
are the new colors for objects within that range. If a color is “Element” (or the
number 16), that means use the element color of the sign the planet rules (which is
the default color setting for the main planets and house cusps). Note that the color
“Element” will use either standard, esoteric, or Hierarchical rulers, depending on
the rulership restrictions (as set with the -YR7 switch). If a color is “Ray” (or the
number 17), that means use the color of the Ray associated with the planet. This
switch will set the color to use for all fixed stars if you change the color of the
first star object. If set to the virtual color “Star” (or the number 18), then that
means the default behavior of using orange for stars brighter than magnitude 1.0,
and dark red for dimmer stars. Note that signs will use the colors of the house
cusp objects corresponding to them, e.g. the Pisces glyph and zodiac positions in
Pisces will be printed in the color of the 12th house cusp object.
-YkC <col1> <col2> <col3> <col4> switch: This switch defines the colors used
for the four elements, and takes four parameters, for fire, earth, air, and water, in
that order. The colors used for planets are based on the element of the sign they
rule, so this affects the colors of the main planets too. For example, to make earth
be green and air yellow, instead of the other way around as Astrolog used to
always force, do “-YkC 9 10 11 12” or “-YkC Red Green Yellow Blue” or just “-
YkC red gre yel blu”.
-YkA <asp1> <asp2> <colors> switch: This defines the colors used for a range of
aspects. The first two parameters are the lower and upper indexes of the aspects to
modify, and are followed by one color parameter for each aspect in the range. For
example, to highlight Trines by making them white and all the other major aspects
dark blue, do “-YkA 1 5 dkb dkb dkb whi dkb”.
-Yk7 <val1> <val2> <colors> switch: This defines the colors of esoteric Rays.
The first two parameters are the low and high Ray numbers to change, ranging
from 1 to 7. The next parameters are the new colors for the Rays within that
range.
-Yk0 <val1> <val2> <colors> switch: This sets a range of colors used other
places in the program (excluding elements and aspects) whose default colors are
one of the colors of the rainbow. The first two parameters are values from 1 to 7
indicating the lower and upper bounds of the default colors to redefine, and are
followed by new actual colors to use instead. The seven indexes represent the
colors Red, Orange, Yellow, Green, Cyan, Blue, and Purple. For example, if you
want to change the color used for the Uranians from their default of purple to
orange, do “-Yk0 7 7 orange” and you've effectively “redefined the color purple”.
 -Yk <val1> <val2> <colors> switch: Like -Yk0 above this also sets a range of
colors as used many places in the program, except this allows one to redefine all
the standard or obscure colors (i.e. the other nine that aren't one of the rainbow
colors covered above). Again the first two parameters indicate the range of colors
to change which are from 0 to 8, and are followed by the new colors to use. The
nine indexes represent in order the colors Black, White, LtGray, Gray, Maroon,
DkGreen, DkCyan, DkBlue, and Magenta. For example, to change the highlight
color as used in graphics charts to draw borders and the like from LtGray to
Yellow, do “-Yk 2 2 yellow”. (Note that you can use this to even “change” the
colors Black and White to draw graphics on whatever background color you
want.)
Note that colors can be specified as references to other colors, in command
switches taking color values as well as in dialog dropdowns in the Windows
version. For example, "Fire" (the current color of the element Fire), "Jupiter"
(Jupiter’s current color), "Conjunction" (the aspect’s current color), and "Ray3"
(that Ray’s current color) all work. Color references can be abbreviated by the
first three characters, or however much is needed to be unique. Note that these are
one time only input translations to the current value of a particular color, and
aren’t persistent aliases that will update if the referenced color is later changed.
-YkU <starlist>: Customize list of extra star colors.
This switch can be used to specify colors to use for particular extra stars when the
Show Full Star List setting (-XU switch) is active. It takes one parameter, which
is a comma separated list of string pairs. These pairs indicate the name of a star
followed by the name of the color to use for it. For example, “-YkU
Alkaid,Red,Mizar,Blue,Alioth,Green,Megrez,Yellow,Dubhe,Orange,Merak,Mage
nta,Phecda,Purple” will highlight the seven stars of the Big Dipper in the seven
Ray colors.
-YkE <astlist>: Customize list of extra asteroid colors.
This switch can be used to specify colors to use for particular extra asteroids when
the show asteroids setting (-XE switch) is active. It takes one parameter, which is
a comma separated list of string pairs. These pairs indicate the numeric index of
an asteroid followed by the name of the color to use for it. For example, “-YkE
5,Red,10,Blue” will highlight asteroid “5 Astrea” in red and “10 Hygiea” in blue.
You can also reference the name or number+name of the asteroid, if the -XE
switch is set appropriately so that asteroids are being labeled in that format. For
example, if -XE2 is in effect, then “-YkE Astraea,Red,Hygiea,Blue” will also
work.
-YD <obj> <name>: Customize display name of object.
Astrolog can change the name of objects, or what string is used to display them in
charts. The -YD command switch takes two parameters: The object index to
rename, and the string to use when displaying it. Object names must be at least
 two characters long, and anything shorter will make the object revert back to its
default name. Note that renaming objects only changes how they’re displayed in
charts, which means command switches and such still need to refer to the object
by its default name.
-YF <obj> <deg><sign><min> <deg><min> <velocity> <au>: Set position.
This switch will set the position of an object, given a zodiac sign, integer degree
within the sign, minute within the degree, latitude in integer degrees, latitude in
minutes, velocity in degrees per day, and distance in AU. It’s used internally
inside -o0 chart position files to set planet positions for charts with no time or
space.

Switches to access obscure graphics options:

-YXG <0-2><0-2><0-3><0-2><0-2><0-2>: Select among different graphic glyphs for
Capricorn, Uranus, Pluto, Lilith, Vertex, and Eris.
Astrolog has the ability to choose between different common glyphs for various
astrological symbols. One may optionally display charts with the “European”
version of the Capricorn glyph, instead of the more twisty “American” type glyph.
One may display charts with the “astronomical” version of the Uranus glyph
using a dotted circle with an ascending arrow, instead of the more astrological
“Herschel” glyph with the crescent bounded cross over a circle. One may display
with the “astronomical” version of the Pluto glyph as the “PL” initials, or the
“esoteric” version of the Pluto glyph as an upward pointing arrow, instead of the
more “astrological” version with the circle over crescent over cross. One may
choose to display Lilith as a small reversed crescent over a cross, instead of as a
circle with a line through it. One may choose to display the Vertex as the
abbreviation “Vx”, instead of as a cross with split ends. Finally, one may choose
to display Dwarf planet Eris using the Unicode “Form Two” glyph of a circle
below which is a downward pointing arrow, instead of the default “Form One”
glyph for Eris of two clashing spear tips.
The -YXG switch changes the glyphs to use for these signs and planets that may
be drawn in more than one way. It takes one parameter, a six digit number
specifying the glyphs to use for Capricorn (100000’s place digit), Uranus
(10000’s place), Pluto (1000’s place), Lilith (100’s place), Vertex (10’s place),
and Eris (1’s place). For each position, the digit “0” means to leave a glyph alone,
while “1” means set to what’s generally considered the “American” form, and “2”
means to what’s generally considered a “European” form. (For Pluto only, one
may also choose the digit “3”, which is the upward pointing arrow glyph used in
Esoteric Astrology.) For example, “-YXG 012000” leaves the glyphs for
Capricorn and Lilith and Vertex and Eris at their present setting, sets Uranus to be
the “Herschel” glyph, and Pluto to be the astronomical “PL” glyph. The default
selection is “111221”, but some astrologers in Europe may prefer “222112”.
-YXG[cuplve] <1-3>: Select specific glyph to use for item.
Subswitches of the -YXG switch will set the glyph to use for individual signs or
objects. Specifically, -YXGc will set the glyph for Capricorn, -YXGu will set
glyph for Uranus, -YXGp will set Pluto, -YXGl will set Lilith, -YXGv will set the
Vertex, and -YXGe will set Eris.
-YXD <obj> <string1> <string2>: Customize glyphs for planet.
Astrolog can change the glyphs used to display objects in graphics charts. The -
YXD switch takes three parameters: The object index to rename, and two strings
which contain the small and large definitions to use for the object’s glyph. The
small definition measures 9x9 units (and is used when drawing in the small 100%
character scale), and the large definition measures 17x17 (and is used when
drawing in the medium 200% character scale). If the large definition is the empty
string then a double scale version of the small glyph will be used for it, and if the
small definition is the empty string then the default glyph for that object will be
used. Glyphs are drawn in vector format by moving a pen (similar to the “draw”
command in the BASIC programming language) and drawing starts from the
middle unit coordinate. Strings consist of a sequence of actions, each of which
starts with a character indicating how to move the pen, following by a number
indicating how many units to move in that direction (no number defaults to one
unit).
The action characters “U”, “D”, “L”, and “R” move up, down, left, and right.
Similarly, “E”, “F”, “G”, and “H” move 45 degrees up and to the right, down and
to the right, down and left, and up and left. The action prefix “B” before one of
the directions means “blank”, and moves the pen without drawing a line while
moving. The prefix “N” before one of the directions means “no update”, and
doesn’t move the pen after drawing a line. For example, the default small glyph
for Jupiter is: “BH3RFDGDGDR5NDNR2U6E”. Special case: If a definition
consists of “T” then don’t do any pen drawing at all, but instead use the three
letter text abbreviation of the object name for display, like is done with fixed star
objects.
The -YXD switch (and -YXA below) take two parameters for the small and large
sized glyphs, which requires defining both. They can be invoked as -YXD1 and -
YXA1 instead, which are simpler in that they take a single parameter for the small
glyph. (The large glyph will be the small glyph scaled appropriately.)
-YXDD <obj> <from>: Copy glyph to one object from another.
This switch will copy a graphic glyph from one object to another. It takes one
parameter for the object index to change, and another for the object index to copy
the glyph from. This switch allows one to have a custom object slot be a copy of a
planet, without having to manually recreate the planet’s glyph in the new slot.
-YXA <asp> <string1> <string2>: Customize glyphs for aspect.
 This switch changes the glyphs used to display aspects in graphics charts. It takes
three parameters: The aspect index to rename, and two strings which contain the
small and large definitions to use for the aspect’s glyph. Aspect glyph definitions
work the same as with the -YXD switch used to redefine planet glyphs. Note that
the two indexes beyond the normal list of 24 aspects (indexes #25 and #26)
indicate the Parallal and Contralparallel aspects, and the next two indexes (#27
and #28) indicate the filled in Conjunction and Opposition glyphs for eclipses.
-YXv <type> [<size> [<lines>]]: Set wheel chart decoration.
This switch specifies how to decorate the corners of wheel charts. Parameter #1 is
0 for no decoration, 1 for a spider web pattern, or 2 for a moiré pattern. Parameter
#2 is optional, and indicates how far along the edge of the wheel chart the
decoration extends, as a percentage from 1 to 100. For example, if this is 50 then
the patterns in each corner will just touch those in adjacent corners. Note that
values too high will impede display because they’ll start overlapping the wheel
itself. Parameter #3 is also optional, and indicates how many lines are used to
compose the spider web pattern.
-YXt <string>: Display extra text in wheel chart sidebar.
The sidebar area to the right of graphic wheel charts can have custom text
appended to it. This switch takes a string parameter, which if non-empty gets
displayed at the bottom of the first section of the sidebar. This can for example be
used to indicate who prepared the chart. If the sequence “\n” appears in the string,
it will be treated as a line break. For example -YXt "Compliments of John Doe\
n[Link] will show those two lines in the chart. Also, if a
sequence like “\A” appears in the string (or “\” plus any other capital letter) it will
be expanded into the current value of that custom AstroExpression variable.
Finally, two backslashes in a row will be converted to a single one. See the ~Xt
switch for an example of how to use this switch to display the chart time’s
obliquity of the ecliptic and the right ascension of the MC (which normally isn’t
present in the sidebar).
-YXg <cells>: Set number of cells for graphic aspect grid.
This sets the size of the graphic -g aspect and midpoint grids, i.e. the number of
cell rows and columns available to draw items in. If this size value is too high (or
too many objects are restricted), there will be unused rows at the bottom, while if
it’s too low (or too many objects are added), rows will be clipped off the bottom.
If the grid size is set to zero, then the size to use will be the number of
unrestricted objects present, and the chart will automatically resize as planets are
(un)restricted.
-YXS <au>: Set radius of graphic solar system orbit chart.
The graphic solar system orbit chart (-S -X switches) covers a given amount of
space measured in Astronomical Units (AU). Usually this size is automatically
determined by the glyph character scale setting (-Xs switch). This switch allows
 one to specifically set the radius size in AU, which is useful if one wants a wider
or more focused view than the default. If this size is 0, then the graphic orbit chart
will be automatically sized as usual.
-YXj <num>: Set number of graphic orbit trails to remember.
The graphic solar system orbit chart (-S -X switches) allows remembering and
displaying multiple locations of each planet. It allows animating the chart over
time, in which each planet has a trail behind it showing its movement along its
orbit. This switch determines how many positions are remembered, and each new
display of the chart in which planet locations are different will append their
locations to the current set of trails. The locations are stored as coordinates in
space relative to the central object, which means the screen can be resized and the
viewing scale changed and the orbit trails will move accordingly, however actions
like switching to or from heliocentric will cause planets to appear to jump.
Change this setting to 0 to turn the feature off and remove the current set of trails.
If the parameter is negative, the chart will instead draw complete orbits for objects
circling the Sun or Earth. These orbits will be circles of the object’s current radius
in the plane of the ecliptic, so aren’t fully accurate, but are still visually useful.
Orbit circles will only be drawn for objects whose transit restrictions are also
unrestricted (-RT switch) which allows specifying which objects you want to see
orbits for.
-YXj0 <step>: Set vertical step rate for graphic orbit trails.
Orbit trails in the graphic solar system orbit chart (-S -X switches) are supported
in the 3D wireframe file output, and the trails will be connected lines instead of
just dots in the wireframe scene. This switch allows setting a vertical offset (along
the Z axis perpendicular to the plane of the ecliptic) for each subsequent section
of trail. The result will be the orbit trails forming a helix instead of just a circle
over time, which allows interesting animation effects such as the entire solar
system appearing to move through space over time. For an example animation of
this type of wireframe file, see the video: [Link]
v=jFhwfM0FKCo
-YX7 <inf>: Set influence width for graphic esoteric ephemeris.
This number specifies the width in influence units of each Ray’s column in the
esoteric graphic ephemeris. For example, given “-YX7 600”, then a Ray influence
value of 400 will fill 2/3 of the column.
-YXk: Use more color for sign boundaries in graphics charts.
-YXk0: Use more color for house boundaries in graphics charts too.
The -YXk switch will cause graphics charts to highlight zodiac sign boundaries in
extra color. For example, wheel charts, solar system orbit charts, and the graphic
ephemeris will have sign boundaries drawn in the color of each sign instead of
always in grayscale. This also influences the display of chart spheres, and local
 horizon charts when 3D houses are on. If the switch is invoked as -YXk0 instead,
then the 12 houses will be highlighted in extra color as well. Some may find the
extra coloring makes charts stand out more, while others may find it to be too
much and actually make charts harder to read.
-YXK <col> <rgb>: Customize RGB value of color index.
This switch can be used to redefine the actual colors within Astrolog’s default
color palette. It takes two parameters, the name of the color to redefine, and the
new RGB color value to use for that color index. The RGB color value can either
be a three comma separated decimal numbers, or the “#” character followed by
three two character hexadecimal numbers in sequence. For example, “-YXK
Orange 255,127,0” or “-YXK Orange #ff7f00” will change the color “Orange”
from the dark yellow olive/ochre that’s the default to an actual fiery orange color.
-YXK0: Use alternate color palette for white background mode.
Astrolog’s “Reverse Background” command (-Xr switch) may be used to draw
the chart on a white background. The problem is that normally won’t look good,
because colors like yellow, green, and cyan which look great on black become
harder to see on white. Astrolog has an alternate color palette used for reverse
background mode, in which colors like yellow will be darker. The -YXK0 switch
(which is on by default) controls whether this alternate color palette is used. Note
that manually changing palette colors with the -YXK switch will cause the user
specified RGB colors to always be used, regardless of this setting or the
background color.
-YXe: Align certain charts to plane of ecliptic.
Astrolog’s chart sphere, local horizon, and telescope charts use the local horizon
for its “equator”, while Astrolog’s globe charts are aligned with the Earth’s
equator. Using this switch, these charts will be tilted so they’re aligned with the
ecliptic instead. When in this mode, rotating and tilting the globe will do so
relative to the plane of the ecliptic.
When the local horizon or telescope charts are aligned with Earth’s ecliptic,
zodiac positions are displayed increasing from left to right, as might be expected.
However, when looking up at the ecliptic in the sky (at least in the Northern
hemisphere) zodiac positions increase from right to left, so the telescope shows a
mirror image of what’s actually in the sky. To counter this, if the harmonic chart
setting is negative (i.e. “-x -1”) then the chart will be flipped horizontally.
-YXa <num>: Set limit to dashedness in aspect lines drawn.
In graphics charts, dashed lines are used when drawing aspect lines whose orbs
aren’t exact, with more space between points indicating a wider orb. This switch
indicates the maximum number of pixels allowed to be skipped between set
pixels. Limits are useful to prevent very wide orbs from being hard to see. Images
such as [Link] (which compares Earth’s
 to Venus’ orbit over time) are generated by having 360 degree orbs, or always
drawing a line between two planets (and never with any dashedness in them, so -
YXa 0 is used).
If the parameter is negative, then that modifies aspect lines so that exact aspects
are drawn solid, and aspects at the orb limit for the aspect in question are drawn
with <num> spaces between points. This may be preferred to the default behavior
in which the dashedness of the line is only based on the number of degrees the
aspect is different from exact. The default behavior will result in aspects to the
North Node (which by default only allows a two degree orb to it) to always be
nearly solid, even if the aspect is near the orb limit for being shown at all. The
Modify Display command (-Xi switch) will toggle between these two display
modes (i.e. it negates the value of the -YXa switch).
-YXU <starlist> <linklist>: Define lines between extra stars.
When the extra stars shown by the Show Full Star List setting (-XU switch) are
drawn, lines can be drawn between certain pairs of stars. The -YXU switch will
define what stars to draw lines between. It takes two parameters, a comma
separated list of strings indicating stars that may have lines connected to them,
and a comma separated list of number pairs indicating indexes of stars within the
list of strings to connect. For example, “-YXU
Alkaid,Mizar,Alioth,Megrez,Phecda,Merak,Dubhe 0,1,1,2,2,3,3,4,4,5,5,6” will
draw lines among the seven stars of the Big Dipper.
The second parameter usually has number indexes separated with commas,
however a semicolon will treat subsequent numbers as starting one beyond the
highest number seen so far. That allows defining separate constellations without
having to keep track of continually increasing index numbers. Also, sequences of
star indexes can be specified with the underscore character between them “_” for
easy definition of lines of stars, or line segments in sequence. For example,
another way to define the Big Dipper is “-YXU
Alkaid,Mizar,Alioth,Megrez,Phecda,Merak,Dubhe 0_1_2_3_4_5_6”
-YXU0 <starlist> <linklist>: Append instead of replace lines.
This switch is like -YXU, except it will append the lines to the existing set,
instead of replacing them. For example, that allows for an easy way to define all
constellations (with each constellation defined separately) without having to
compose one giant command switch for everything all at once. Note that every
star must only be named once in the first star list parameter, and shouldn’t ever be
duplicated (and that includes across multiple calls to -YXU0) because only the
first inclusion of each star will have its link list index filled out with valid star
data.
-YXW <num>: Draw triangles or cubes grid over world maps.
This switch will draw a grid of triangles around the world in the globe and map
displays, overlaying any astro-graph lines or other things also on the world. If the
 argument that this switch takes is 0, then the grid is turned off. If the argument is
positive, then a grid of triangles is drawn based on an icosahedron, with each
triangle subdivided into smaller triangles a number of times equal to the
argument. If the argument is negative, then a grid of squares is drawn based on a
cube, with each square subdivided into smaller squares a number of times equal to
the magnitude of the argument.
-YXf <0-9><0-9><0-9><0-9><0-9><0-9>: Set font usage in graphic charts for text,
signs, houses, planets, aspects, and Nakshatras.
Astrolog supports ten different fonts for display of text, signs, houses, planets,
aspects, and Vedic Nakshatras. They are Astrolog’s default internal vector
drawing, the Wingdings font from Windows (for signs only), the Astro font by
Kenneth Hirst, the EnigmaAstrology font by Jan Kampherbeek, the
HamburgSymbols font by cat3, the Astronomicon font by Roberto Corona, the
“Hank’s Nakshatra” font by Hank Friedman (for Nakshatras only), and generic
high Unicode characters in the Courier New, Consolas, and Arial fonts.
The Astronomicon font at [Link] is nice
because it’s the first font which has glyphs for all of Astrolog’s standard objects
and aspects, including alternate versions. Astrolog assumes Astronomicon font
version 1.1 is installed. This version of the font added the “Q” glyph for the
Quintile aspect, which is used to match Astrolog’s default “Q” glyph for it. That
means displaying the Quintile aspect in Astronomicon within Astrolog but using
the old version 1.0 of the font, will result in a bad character since the glyph isn’t
present in the old version. This issue will only be present if one displays the
Quintile glyph in Astrolog using an old version of the Astronomicon font, and can
be ignored otherwise.
The -YXf switch takes a six digit number, which indicates which font to use for
each area, in which 0=Astrolog, 1=Wingdings, 2=Astro, 3=Enigma, 4=Hamburg,
5=Astronomicon, 6=Courier New, 7=Consolas, 8=Arial, 9=Hank’s Nakshatra.
For example, the default when the “use real system fonts in graphics charts”
setting in the Display Settings dialog is turned on is 618229, which means Courier
New for text, Wingdings for signs, Arial for houses, Astro for objects and aspects,
and Hank’s for Nakshatras. For houses, the Arial font means to use Ascii digits to
draw the numbers, instead of single Unicode characters. In the Windows version,
the Graphics Settings dialog has dropdowns so one can select exactly which font
they want to use for each area. For PostScript files, the fonts will be “Courier”
instead of “Courier New”, and “Times Roman” instead of “Consola”, to avoid
Windows specific fonts that may not be available in other environments. Note that
system fonts are only available in PostScript files, Windows metafile files, and on
the Windows screen. They aren’t available in bitmap files or on X11 windows.
-YXf[tshoan] <0-9>: Select specific font to use for area.
Subswitches of the -YXf switch will set the font to use for particular things.
Specifically, -YXft will set the font for text, -YXfs will set font for signs, -YXh
 will set houses, -YXfo will set objects, -YXfa will set aspects, and -YXfn will set
Vedic Nakshatras.
-YXp <-1,0,1>: Set paper orientation for PostScript files.
This allows one to set the page orientation for full PostScript graphics files as
generated with the -Xp0 switch. If the orientation parameter value is positive, that
means the chart will be printed in portrait mode, while if negative, it will be in
landscape mode. If the orientation value is set to zero (the default), then the
program will decide based on the size of the current chart, with charts with wider
horizontal sizes (e.g. astro-graph charts and wheel charts with sidebars) being in
landscape, and charts with horizontal sizes less than or equal to the vertical (e.g.
aspect grids and wheel charts without sidebars) being in portrait.
-YXp0 <hor> <ver>: Set paper size for PostScript files.
One may also choose the paper size of full -Xp0 PostScript graphics charts. There
are two parameters given which specify the horizontal and vertical size of the
paper to be printed upon. By default this is 8.5" x 11". If you have say 8.5" x 14"
legal size or A4 paper in your printer it can be used just as easily. Sizes may be
specified in inches or centimeters. If the parameter ends in “cm” then it will be
parsed as centimeters, and if it ends in “in” then it will be parsed as inches. If
there’s no units, then it will be parsed based on the -Yv metric switch setting.

Switches to access obscure system options:

-YB: Make a beep sound at the time this switch is processed.
This obscure switch just sounds a generic system beep.
-Y5[2-4]: Enumerate all charts in chart list via ~5Y AstroExpression.
For technical users who work with AstroExpressions, there’s a quick way to
automatically loop over all charts in the chart list. The obscure -Y5 switch (which
can also be invoked as -5Y which does the same thing) will loop over all charts in
the chart list in sequence. It’s very similar to -5e in that it can be invoked as -Y5, -
Y52, -Y53, and -Y54 to loop in different manners, except it won’t display the
charts cast. This switch only has effect when the ~5Y AstroExpression has been
defined to look at the charts. See the ~5Y switch description for details. This is
designed to analyze the chart list, to perhaps determine data to use for later
filtering via -5f and ~5f, and then displaying via -5e.
For example, suppose you have a set of planet positions but don’t know whose
chart it is? The following command line will check each chart in the chart list, and
display the chart which has the least total differences in degrees from the natal
chart in slot #1. If the chart list is the Astrodatabank, this is a quick way to
determine who a celebrity is given just their planet positions: astrolog -i
[Link] -i [Link] ~5Y "=c 0.0 For %i 0 Objs =c Add @c LonDist
 ObjLon1 @i ObjLon2 @i If Lt @c @d Do =d @c =a List1" ~1 "=d 99999.9" -
5Y2 -qL ~@a
For a more complex example, if you want to display all charts in the chart list
with the most number of Trines to your natal chart, you first need to determine the
most number of Trines any chart has (which can be counted using -Y5 and ~Y5),
and then filter the chart list to be the chart (or multiple charts) containing that
many Trines (using -5f and ~5f), and finally the filtered chart list can be displayed
with -5e. For my own chart, my "celebrity match" is musician Tiny Tim, which
means that no other chart in the entire Astrodatabank has more Trines when
compared to my natal chart than his (when using default planet set and orbs). The
following command line will show this: astrolog -i [Link] -~M 1 "DoGrid2
False =c 0 For %i 0 Objs If ObjOn @i For %j 0 Objs If ObjOn @j Do =e
GridNam @i @j If Equ @e A_Tri =c Inc @c" -~5Y "Macro 1 If Gt @c @d =d
@c" -~5f "Macro 1 Gte @c @d" -RA0 Tri -i [Link] -5Y2 -i2 nul -5f "" "" -
5e -g -r2
-Y5i <string>: Set filter string for ADB XML file format load.
This switch can be used to filter the contents of an Astrodatabank (ADB) XML
file. The switch’s parameter indicates a string that must be present within a
record, in order for that record to be loaded. This switch is similar to Astrolog’s
existing chart list filtering, however this prevents records from being loaded in the
first place, instead of requiring them to be loaded and then manually removed
afterward, which is faster. It also allows checking records or metadata that can’t
be seen or filtered via other means. For example, to only load those charts with
accurate birth data that are Rodden Rating AA, do: -Y5i ">AA<"
-Y5I <var> <vars>: Set variable range for ~5i AstroExpression.
This switch is similar to -Y5i but allows more detailed filtering based on multiple
strings at once. It takes two numeric parameters, which indicate a starting index in
the list of AstroExpression custom variables and strings, and a count of how many
AstroExpression variables to consider from that point. Afterward, when an
Astrodatabank XML file is loaded, each chart record will be scanned for the given
strings as indicated in the AstroExpression custom string list. Each instance of
those strings will cause the corresponding custom variables to be incremented.
Finally, the ~5i switch AstroExpression will be called, allowing that
AstroExpression hook to check the presence of variables to determine which
strings have been seen. For example, assume “-Y5I 4 3”, and in which custom
string 4 is “Apple”, custom string 5 is “Banana”, and custom string 6 is “Carrot”.
A chart record containing two instances of “Apple” and one of “Banana”
anywhere within it, will cause custom variable @d to be 2, @e to be 1, and @f to
be 0, when ~5i is called.
-YY <rows>: Load atlas list of city locations from current file.
 Astrolog’s atlas information is stored in the file [Link], which gets loaded the
first time atlas information is needed. This is an Astrolog command switch text
file like any other, and can easily be user modified or extended. The header of the
file describes the format. The file consists of one instance of the new -YY
command switch, which takes one parameter indicating the number of city
location lines that follow in the file. (If you add or delete cities from the file, make
sure to also update this number appropriately.) This switch is only valid in switch
files, and an error will be displayed if it’s seen on the command line.
The default [Link] file contains over 24,000 cities, or every city in the world with
over 15,000 population. Similar to ephemeris files, you can download a larger
atlas if you want more cities available. The file
[Link] contains nearly 200,000 cities, or
every city in the world with over 500 population. You can replace the default
[Link] with [Link] (renaming “[Link]” to “[Link]”) or just load the
larger file into the program when needed. The information in these atlases was
composed using data from [Link] available under the
Creative Commons Attribution 4.0 License.
-YY1 <rules> <entries>: Load Daylight Time rules from current file.
Astrolog’s time zone change information is stored in the file [Link], which
gets loaded the first time that such information is needed. This information was
converted from version “2023b” of the collaborative open source and public
domain TZ database (sometimes called the “Olson database”) at
[Link] which is used by many programs and
operating systems for time zone and Daylight Saving Time determination. This
database is fully accurate everywhere in the world for 1970 and beyond. Before
1970 time changes are often an inexact science, but are estimated to be at least
90% accurate. The file [Link] is an Astrolog command switch text file like
any other, and can be user modified. The sections within the file describe the
format. There are three sections in it, which contain instances of the -YY1, -YY2,
and -YY3 switches.
The -YY1 switch reads in a new set of Daylight Saving Time change rules from
the current switch file, consisting of the specified number of rules, each consisting
of a sublist of rule entries. First parameter is number of rules, and second is the
total number of rule entry lines in all rules. The time zone areas read in by the -
YY2 switch can specify different rules to apply at different times.
-YY2 <zones> <entries>: Load time zone change lists from file.
This switch reads in a new set of time zone changes from the current switch file,
consisting of the specified number of time zone areas, each consisting of a sublist
of zone change entries. First parameter is number of time zone areas, and second
is the total number of zone change entry lines in all areas. This defines when time
zone offsets themselves change in a particular area, as well as when to apply or
not apply Daylight Saving Time rules.
-YY3 <rows>: Load atlas time zone to zone change mappings from file.
This switch reads in a new set of time zone links from the current switch file,
consisting of the specified number of time zones (as specified by the -YY switch)
and how each maps to a zone change area as specified by the -YY2 switch. This
defines how a city’s time zone maps to a time zone area, so the program can
lookup a date/time in question within that area to see the time zone and Daylight
Time offsets that were in effect then.
-YYt <text>: Output formatted text string in current context.
This obscure switch when encountered will immediately output the specified text.
It can be used to append text to a text mode chart, or even work within an
AstroExpression hook, if one calls the “Switch” AstroExpression function to
execute a command line containing this switch. In the switch’s string parameter,
the character sequence “\n” will be translated to a newline, character sequences
like “\A” will be expanded to the contents of custom AstroExpression variable
@a, and character sequences like “\a” will be expanded to the contents of custom
AstroExpression string indexed by variable @a. This switch will do nothing when
the program is in graphics mode.
-YYT <text>: Popup formatted text string in current context.
This obscure switch will popup a message. In the Windows version the text will
be in a message box, while non-Windows versions will print the text to the
console. It takes one parameter, indicating the string of text to display. In the
switch’s string parameter, the character sequence “\n” will be translated to a
newline, character sequences like “\A” will be expanded to the contents of custom
AstroExpression variable @a, and character sequences like “\a” will be expanded
to the contents of custom AstroExpression string indexed by variable @a.
-0[o,i,q,X,n,b,~]: Permanently disable file output/input, program exiting, all graphics,
internet, old formulas, or AstroExpressions.
This obscure switch is invoked in one of seven forms: -0o, -0i, -0q, -0X, -0n, -0b,
or -0~. More than one of the subswitches may be combined, e.g. -0oiqXnb~ to do
all seven forms at once. Each subswitch disables a section of the program. The
seven areas of file output, file input, program termination, graphics mode charts,
internet Web queries, old Matrix and Placalc formulas, and AstroExpression
processing, may be respectively turned off by the seven subswitches above. Once
a section is disabled, it remains that way permanently and can not be turned back
on without restarting the program. Attempting to access a restricted feature will
display an appropriate error message or at least do nothing.
This switch is meant to be used when Astrolog is being run from a chart server, as
a demo, or related situation. For example, if one set up Astrolog on a network to
be able to receive chart requests including arbitrary command lines where the
result is e-mailed back to the user, the administrator probably wants to prevent the
client from using the -o switch to create or potentially overwrite files on the
 server, in which case -0o can be put in the [Link] file to prevent file output
before the client gets a chance to do anything. Similarly, -0i can be used to
prevent the client from using -i to read in private files on the server. If the server
only e-mails text back to the user, you probably don't want the server copy of the
program going into interactive graphics mode waiting for someone to pass it
keystrokes, in which case -0X can be used. JPL Horizons Web queries to
calculate positions access the internet and may be slow, so can be disabled with -
0n to prevent accidental usage of them. Similarly, the Matrix and Placalc formulas
are outdated, and can be prevented from being accidentally selected too with -0b.
Finally, -0q might be useful in demo situations where people can play with the
program but you don't want them exiting it. In this last case, the only way to stop
the program is to kill the process (although a Control-C should stop command line
or Unix versions).
-;: Ignore rest of command line and treat it as a comment.
The -; “dash semicolon” switch when encountered causes all the rest of the
switches on a command line to be ignored and not processed. This allows the
semicolon (usually used by itself without the optional dash prefix of course) to be
used to begin comments and for comment lines in the various command files.

Astrolog graphics screen key press options (version 7.60):

(Note: When a graphics chart is up, pressing a key which doesn't do any of the
operations below will sound a beep.)
Press '?' to display this list of key options.
Pressing this will display a help list of all the key presses available in the text
screen from which the window was invoked from.
Press 'p' to toggle pause status on or off.
Press this to pause all automatic updates to the window or screen. This is mainly
used to temporarily freeze any animation so a particular chart can be looked at
without interruption. When animation is on but temporarily paused with this key,
the mouse (inactive for the purpose of scribbling during animation) will come
active again.
Press 'x' to toggle foreground/background colors on screen.
Pressing this will invert the colors on the screen, or in other words will do the
same thing as the -Xr switch on the command line.
Press 'm' to toggle color/monochrome display on screen.
For color displays, pressing this key will toggle in and out of monochrome mode.
Press 'i' to toggle status of the minor chart modification.
 Pressing this key will toggle whether or not an alternate form of the present chart
should be displayed. See the -Xi switch described earlier for more information on
these alternate chart formats.
Press 't' to toggle header info on current chart on screen.
Pressing this key will toggle whether or not the chart parameters are printed at the
bottom of the window or in a sidebar. This corresponds to the -Xt switch
mentioned earlier.
Press 'b' to toggle drawing of a border around the chart.
This key, when pressed when a graphics chart is being displayed, will toggle
whether or not a border is drawn around the graphic. Some charts, such as aspect
grids, will always have a border regardless of the state of this flag, while others
such as the globes will never have one. Most charts however, such as the wheel
charts will look good either way and this key can be used to choose.
Press 'q' to toggle drawing thicker lines within the chart.
Press this key to toggle whether lines are drawn twice as thick. This will do the
same thing as the -Xx switch.
Press 'l' to toggle labeling of object points in chart.
Press this key in a window to inhibit the labeling of all planets in the various
charts. Instead of drawing the actual little point and then the glyph near it (as well
as sometimes a line from the glyph to the dot), just the point is displayed. This
mode is mainly useful for the -Z horizon and -S space charts (and has little use for
anything else) when in cramped quarters or to get a more realistic view of how the
sky actually looks.
Press 'k' to toggle labeling of glyphs on aspect lines.
Press this key to toggle whether or not aspect lines between planets in charts are
labeled with the aspect’s glyph over the middle of the line. This will do the same
thing as the -XA switch.
Press 'j' to toggle not clearing screen between chart updates.
This key toggles on the “jet trails / time exposure” flag which will cause the
graphics screen to not be cleared on new chart draws. See the -Xj switch which
affects the same setting for more info.
Press 'v' to display current chart positions on text screen.
Press this key to dump back to the text screen the list of where all the planets
currently being displayed in the window are. This display is the same as produced
with the -v switch, and is useful if one wants text to show where everything in the
chart is.
Press 'R','C','u','y','`','~','U' to toggle restriction of minor objects, cusps, Uranians,
Dwarfs, moons, body centers, and stars.
Press the 'R' (restrict) key in an Astrolog graphics screen and the chart will be
redrawn with the restriction status of the asteroids and other minor objects
toggled. Pressing the 'C', 'u', 'y', '`', '~', and 'U' keys in the window will toggle the
restriction status of the 12 house cusp objects, the Uranian bodies, dwarf planets,
planetary moons, planet centers of body (COB), and fixed star objects,
respectively. These keys compliment the 'R' key option and are the counterparts to
the -C, -u, -u0, -u8, -ub, -U, and -RC, -Ru, -Ru0, -R8, -Rb, -RU switches. (Note
that for all these keys except 'R', toggling their state off will automatically restrict
all the objects associated with them, while the 'R' key can simultaneously restrict
some and unrestrict other bodies.)
Press 'c' to toggle relationship comparison chart mode.
This key, when pressed when a graphics chart is being displayed, will toggle the
state of whether a relationship comparison chart (-r0 switch) is being shown. For
example, pressing it when a wheel chart is up will revert to a dual wheel chart
showing two sets of planets, while pressing it when an aspect grid is up will revert
to a dual aspect grid between the planets of two different charts. When going from
a comparison to a single chart, one of the charts will be used while the other will
be ignored. When going from a single to a comparison, whatever is in the chart
slot #2 will start being displayed too (which if it’s the same as the main chart is
slot #1 won't be too useful, until they are made different through animation or
other keypresses).
Press 's', 'h', 'a', 'f', 'g', 'z' to toggle status of sidereal zodiac, heliocentric charts, 3D
houses, domal charts, decan charts, and Indian format wheel charts.
Press the 's' key in the window to toggle whether or not the sidereal vs. tropical
zodiac is used. Press the 'h' key to toggle to a heliocentric based chart or back
again to a geocentric one. Press the 'a' key to toggle whether house placements
take 3D latitude into account instead of just zodiac longitude. Press the 'f' key to
toggle the status of whether or not the chart should be modified to correspond to
the appropriate domal chart (where the house positions are represented as zodiac
positions and vice versa). Press the 'g' key to toggle the status of whether or not
the chart should be modified to correspond to a decan chart (where each sign is
divided in thirds representing the two other signs in its element). Press the 'z' key
to toggle whether wheel charts are displayed in Indian format. These keys of
course correspond the -s, -h, -c3, -f, -3, and -J switches, respectively.
Press 'O' and 'o' to recall/store a previous chart from memory.
Have you ever animated your natal or some other chart to some far distant future
or past time, only then to wish you could somehow easily get back in time to the
original chart? You can, by pressing the 'O' key in a window, which will recall to
the screen previously “saved” chart parameters (which are by default set to
 whatever you started the window with.) Press the 'o' key to change this default
stored chart to be the chart that is presently in the window.
Press 'B' to dump current window contents to root background.
Press the 'B' key in an X window to dump whatever is currently being displayed
to the background root window. This is basically the corresponding keypress to
the -XB option.
Press 'B' to resize chart display to full size of screen.
For PC systems, the 'B' key does a different function that the feature shown
above. See PC graphics section for its description.
Press 'Q' to resize chart display to a square.
One can manually resize the Astrolog X Windows using a window manager
(except when a world map or aspect grid is displayed, in which case any resizing
will have no effect). Pressing the 'Q' key will automatically resize any (non-world
map) window to be a square. This is useful, after resizing charts to approximately
the size you want, to make them precise squares. Note that for PC’s, this will take
EGA and CGA mode pixel ratios into account, in that the horizontal and vertical
sizes may be made different in order that the actual display looks square. This will
also take into account wheel chart sidebars and only resize the actual visible chart
to a square when one is being displayed to prevent distortion.
Press '<' and '>' to decrease/increase the scale size of the glyphs and the size of world
map.
This two keys will respectively decrease and increase the size of the sign and
planet glyphs (as well as resize the astro-graph and aspect grid charts) through the
three scale factors available. After resizing the window, you will probably want to
use these keys if the glyphs are then too big or small for the new chart.
Press '{' and '}' to rotate left/right one degree in globe.
Press the '{' and '}' keys when the globe or related chart being displayed to
respectively “shift left” and “shift right” the rotation angle of the vantage point
from which the globe is being viewed.
Press '[' and ']' to decrease/increase tilt in globe display.
Not only can the globe display be rotated, but the poles can be tilted down at
various angles! Press the '[' and ']' keys when the globe is being displayed to
respectively “pull down” and “push back up” the angle of the polar axis from
which the globe is viewed. Combining this with the globe rotation allows one to
move any point of the globe to the center of the screen.
Press '+' and '-' to add/subtract a day from current chart.
 These keys, when pressed when a graphics chart is being displayed, will update
the current chart forward or backward one day (actually 1..9 days based on the
current animation rate). When animation mode itself is active, these keys will
jump by the current animation step, instead of only an amount in days.
Press 'n' to set chart information to current time now.
This key, when pressed when a graphics chart is being displayed, will change the
current chart (or “outer” chart when a -r0 comparison chart is up) to the current
time and place now. This interactively does the same as the -n command line
switch. The only other way to revert a graphics chart to the time “now” is to enter
animation mode via the 'N' key and then leave it, so this is a shortcut convenience.
(This feature is only available when the TIME compile time value is
uncommented of course.)
Press 'N' to toggle animation status on or off. Charts will be updated to current status and
globe will rotate.
Animation: This key will toggle in and out of a mode where the chart is
continually updated in the window. Entering the animation mode will cause the
chart being currently displayed to be replaced by the chart for the exact moment at
the time you are running the program. Every second or two, the chart will be
updated to reflect the new current state of the planets and houses. For large
window sizes, one can actually see very minor changes in the chart every few
seconds. With the text 'T' mode in effect, the chart is basically an advanced
version of xclock, and makes a good window to be left running on your display. If
you are in the -XG globe display mode, pressing the 'N' key will cause the globe
to rotate for a nice display! Note that when a comparison relationship chart is up,
animation will forward the chart in the “second” slot rather than the “first”. This
is more intuitive when animating bi-wheel transit to natal charts, where the
transiting, i.e. second, chart will be the one forwarded.
Press '!'-'(' to begin updating current chart by adding times. !: seconds, @: minutes, #:
hours, $: days, : months, ^: years, &: years*10, *: years*100, (: years*1000.
These nine keys (i.e. shift plus the number keys from 1..9) enter into a different
form of chart animation. Pressing them will cause the current chart being
displayed (i.e. it will not revert to the current planet positions) to continually have
a delta time added to it and be recast and shown. Pressing '!' will have one second
added to the chart for every update (slow action unless you have a very fast
system - the animation will be even slower than for the 'N' key). Pressing '@' will
have one minute added to the chart each time, which makes for a nice display
(note that you will definitely want to be in the text 'T' mode for these animations
so you can see what times in the future these charts are being cast for. Pressing '#'
will have one hour added each time (note that now the house cusps are starting to
move quickly, so you may want to switch to a different system of houses (such as
the Equal to keep the Midheaven from flopping back and forth) and/or use -1 to
put an object like the sun on the Ascendant.) Pressing '$' will have one day added
 each time (now you will probably want to start using -R to remove fast moving
objects like the moon), and pressing '%' will have one month added for each
update of the window. The final keys, shift 6..9 cause years, decades, centuries,
and millennia to be added each time, and tend to only be used to look for long
range actions (such as when will Neptune next enter Pisces). To exit these
animation modes, press the 'N' key.
Press 'r' to reverse direction of time-lapse or animation.
Press this to reverse the direction of any animation taking place. For the '!'..'('
animation keys above, this will cause negative times to be added to the chart, e.g.
pressing '#' then 'r' on a chart cast for noon will cause the next chart to be
displayed for 11am, then 10am, etc. For the Globe animation, this will cause the
rotation to reverse direction.
Press '1'-'9' to set rate of animation to 'n' degrees, etc.
The nine number keys are used to set the relative “rate” of animation to “n” units.
For example, normally the “@” key means add one minute to the chart for each
update, but press “5” and now we are adding 5 minutes each time. For the Globe
animation, by default the Earth rotates one degree each time; however, the
number keys can speed this up to nine degrees for each update.
Press 'V','A','Z','S','H','K','J','L','E','I','M','X','W','G','P','T' switch to normal (-v),
grid (-g), local horizon (-Z), space (-S), sector (-l), calendar (-K), dispositor (-j), astro-
graph (-L), ephemeris (-E), rising (-Zd), moons (-8), chart sphere (-XX), world map (-
XW), globe (-XG), polar (-XP), and telescope (-XZ) modes.
There are 16 main modes in which the graphics screen can be in: There are the
eleven main charts (wheel, aspect grid, local sky, space view, Gauquelin sector,
calendar, dispositor, astro-graph, ephemeris, rising/setting, and planetary moons)
as well as the five map displays (the chart sphere, the simple world map by itself,
the globe view, the polar projection, and the telescope). These 16 keys can be
used to switch between these modes in the middle of program execution. For
example, you can bring up your own chart in a window, then press 'L' to see the
astro-graph chart for the same birth data. Then you can press 'W' to just see the
world map by itself, and 'G' to see the globe view, after which you can press 'V' to
return to your original wheel chart.
Press 'Y' to switch to biorhythm relationship chart mode.
This switches the display to show the biorhythm chart (-rb switch). This is
separated from the line above, because the biorhythm only exists as a relationship
chart, since it always involves two dates (the natal chart, and the date to show
biorhythms for).
Press '=' to switch between Western and North/South Indian wheels.
 This mode replaces the standard Western type wheel chart with a South Indian
type chart, and the house wheel chart (which is the standard wheel chart when the
‘0’ key mode is on) with a North Indian type chart.
Press '0' to toggle between -Z,-Z0 & -XW,-XW0 & -E,-Ey modes.
When graphics are up on the screen, pressing this key acts similar to the mode
changing keys above that switch between the different graphic chart types. When
pressed, the state of the program being invoked with -Z vs. -Z0, as well as the
state of -XW vs. -XW0, and the state of -E vs. -Ey, will be reversed. In other
words, if I am viewing the -Z -X horizon chart, and I want to see the -Z0 -X sky
graphic, then I press '0' to go to it. Similarly, this key will flip me back and forth
between the -XW simple rectangular world map display and the -XW0 Mollewide
projection graphic, as well as the -E monthly ephemeris and the -Ey yearly
ephemeris. This is a quick way to change these suboptions while the program is
running.
Press 'F' to toggle between world and constellation map modes.
This key toggles on the constellation charts where the map and globe modes show
the celestial sphere instead of the Earth’s continents. See the -XF switch which
affects the same setting for complete info.
Press 'd' to toggle display of house information in map modes.
This key toggles whether house cusp boundaries are drawn on the local horizon,
chart sphere, globe, and map displays. See the -XC switch which affects the same
setting for complete info.
Press 'e' to toggle display of Earth's equator in map modes.
This key toggles whether the Earth’s equator is drawn on the local horizon, chart
sphere, globe, and map displays. See the -Xe switch which affects the same
setting for complete info.
Press 'w' to toggle drawing world maps in detailed bitmap mode.
This key toggles whether the world map is drawn in 24 bit color in the astro-
graph, local space, and globe displays. See the -Xbw switch which affects the
same setting for complete info.
Press 'F1'-'F12' [plus Shift,Ctrl,Alt] to run macros 1-48.
For PC’s, pressing the function keys F1 through F12 will execute macros when
graphics are being displayed. Pressing F1 through F12 will run macros 1 through
12. Pressing Shift+F1 through Shift+F12 will run macros 13 through 24.
Control+F1 through Control+F12 will run macros 25 through 36. Finally Alt+F1
through Alt+F12 will run macros 37 through 48. Executing a macro that hasn't
been defined yet (either with a function key or the -M switch) will do nothing.
Press 'space' to force update of current graphics display.
When a graphics chart is up on the screen, pressing the space bar will force a
redraw of the chart. This is useful for say to cleanup after one has scribbled on it
with the mouse button features (described below).
Press 'del' to clear the graphics screen and not redraw.
Pressing the delete key when a graphics screen is up will clear the screen, but not
redraw the chart right away unless animation mode is on. This is most useful for
the -Xj “timed exposure” streaks in horizon and orbit charts if you want to start a
new “jet trail” while animating.
Press 'enter' to input a command line of general switches.
Pressing the return key when a graphics screen is up will pause and prompt you
for a command line. This command line will be processed after which you will be
returned back to the graphics state you left, allowing the changing on the fly of
any setting that isn't already covered by pressing whatever key, without having to
drop all the way back to a -Q loop or out of the program altogether. This can be
used to redisplay the -H switch help list too. (There are a couple of rare things you
can't do in the middle of graphics, e.g. you aren't allowed to suddenly switch to
one of the graphics file modes.)
Press 'escape' to close graphics window and exit program.
Pressing this key will close the window, and also exit the Astrolog program itself.
--
Left mouse button: Scribble lines over chart in window.
Middle mouse button: Print coordinates of pointer on world map.
Right mouse button: Close window and exit the program.
Clicking mouse buttons within the window (of the X Windows or MS Windows
version) will do various functions. The left mouse button acts as a pen that allows
one to actually draw on the chart: Click it and drag the pointer to draw a line on
the window, which is good for aiding in analysis or in presentations. (Any
scribbles one makes will disappear the next time the chart window is updated.)
The middle mouse button (or Alt+left click in the MS Windows version) will only
work when a world map is shown, i.e. in the -L astro-graph or -XW world map
displays: Click to get the approximate longitude and latitude of the place on the
map where the pointer is, printed in the main window (or have the current chart’s
location set to this location in the MS Windows version). For the four scale sizes
of 100, 200, 300, and 400 percent, the accuracy is to the nearest degree, 30
minutes, 20', and 15', respectively. So, if you want to cast a chart for southern
Madagascar, Africa, but don't know the coordinates, click the middle button on
the map for a good approximation. Finally, the right button (middle button if any
for PC’s) acts just like the 'escape' key, and will terminate the program.
 Note that for X Windows, pressing the middle mouse button when a world map is
up, in addition to displaying the longitude and latitude of the point clicked on in
the parent window, will also set the current chart location to this point. This
makes an easy interface for doing chart relocation. Say you want to relocate your
natal chart to Tokyo, Japan. Just bring up your chart in graphics mode, press 'W'
to switch to the world map display, click middle button on Japan, then return to
the wheel chart and there your chart is, as if you had been born at the same time
but in Tokyo.
Control keys: Certain control keys can be pressed when a graphics chart is up to set the
color of the “pen” one can scribble on the chart with using the left mouse button. (Who
knows, maybe Astrolog will contain a full featured drawing program someday. ;)
Usually, the scribbles are always in the gray highlight color. However, sixteen control
keys can be pressed to change the pen to sixteen different colors, which are defined as
follows: Ctrl-a is White, Ctrl-z is Black, Ctrl-r is Red, Ctrl-g is Green, Ctrl-b is Blue,
Ctrl-y is Yellow, Ctrl-o is Orange, Ctrl-l is Light gray, Ctrl-d is Dark gray, Ctrl-m is
Magenta (Valentine pink), Ctrl-u is Purple (pUrple), Ctrl-e is Maroon (Dark red, next to
'R' on keyboard), Ctrl-f is Dark Green (Forest green, next to 'G' on keyboard), Ctrl-n is
Dark Blue (Navy blue, next to 'B' on keyboard), Ctrl-j is Cyan, Ctrl-k is Dark Cyan (Next
to 'J' on keyboard).

DATA ENTRY AND THE MAIN DISPLAY

The main part of the program is executed simply by entering “astrolog” (assuming that’s
the name of the executable), and the program will ask you for all the birth info and will
give the planet/house positions. For example, for a chart in Seattle at the Summer Solstice
(for June 21st, 2022 CE/AD at 2:14am Pacific Daylight Time, 7 hours before UTC) for
the ten prompts one would enter: Jun, 21, 2022, 2:14am, Y, PT, 122W20, 47N36,
Summer Solstice, Seattle WA. The program then calculates and displays the positions of
all planets, Chiron, the four main asteroids, as well as items like North Node and South
Node of the Moon, Lilith, the Part of Fortune, the Vertex, and the East Point. Uranian
bodies, Dwarf planets, planetary moons, and fixed stars can also be listed if one includes
the appropriate command switches.
Two of the chart info fields interactively prompted for above are general text fields for
the person’s name or chart title, and the name of the city or location the chart is cast for.
After you enter the location, if it matches a city in the atlas, the recommended values to
enter for Daylight Time, time zone, and longitude/latitude will be displayed. When set,
the contents of these fields will be displayed in the various charts, such as the -v listing,
the -w text wheel, and in the graphic wheel chart sidebars.
Another field explicitly prompted for is whether Daylight Saving time was in effect for
the chart or not. (Without this one would have to subtract one hour from the time or time
zone to indicate if Daylight time was in effect, which of course was limited in that it’s not
always clear whether a given chart was for say 11am Standard time, or really for noon
Daylight time.) Enter “0”, “Y”, or “S” for Standard time, and “1”, “N”, or “D” for
Daylight time (or War time). An indication of Standard or Daylight time will be shown in
the headers of the -v listing and in the graphics charts.
--
The user interface where one manually inputs the chart information is “smart” in various
ways, as many of the chart info fields may be entered in several formats and be parsed
correctly:
Months may be entered as numbers from 1 to 12 or as their true names. Case doesn't
matter, and month names may be abbreviated to their first three letters.
Year values may be entered with an optional “BCE”/”BC” or “CE”/“AD” suffix. (Periods
may be interspersed, e.g. “b.c.” is allowed.) Years BCE/BC may also be entered as
negative years, but if you do this note that you have to add one to the negative number
since there’s no formal year 0 BCE/BC or 0 CE/AD, e.g. since 1BCE/BC is followed by
1CE/AD, specifying “5BC” would be the number “-4”.
Astrolog deals with the switchover from the Julian to the present Gregorian calendar
system when accepting input and printing output. The calendar system changed (at least
in most of Europe) from the Julian to the Gregorian calendar in 1582 when October 4th
was followed the next day by October 15th. Throughout the program Astrolog uses the
Julian Calendar for date and leap year specification for dates before 10/4/1582 (date
modifiable with the -ig switch) and the Gregorian after. It will properly handle the change
even in the middle of months in charts, e.g. in -K calendar charts, -E ephemeris charts, -
dm aspect search charts, and graphics animations, ten days will be skipped in October
1582.
Time values may be entered with a “pm” or “am” (or just “p” and “a”) suffix (periods
may be interspersed), or in the standard 24 hour clock. The separator between hours and
minutes should be a colon. For example, 6:30pm may be entered as “18:30” or “6:30p”.
12:30am may be entered as “12:30a.m.”, “0:30”, and so on. Time values will also parse
seconds. For example, “[Link]m” translates to 12 hours, 34 minutes, and 56 seconds.
Fractional seconds can be entered, e.g. “[Link].78” means 12 hours, 34 minutes, and
56.78 seconds. One can still enter times like “12:34pm” without a seconds qualifier, in
which case 0 seconds will be used. Fractional hours and minutes may also be entered. For
example, “12:30pm” is the same as “12.5”, and “12:30.4pm” is the same as “[Link]”.
Time zones may be entered as hours away from UTC. Positive numbers indicate west or
before UTC, and negative numbers indicate east or after UTC. Numbers may also be
terminated with “W” or “E” to indicate west or east or UTC. Time zones may also be
abbreviation strings, such as “EST”, “PST”, and “UTC”. Note that this setting is still
separate from the Daylight Time setting. In other words, strings such as “EDT” or
“EWT” may be entered, but that will only subtract one hour from the time zone number,
and not turn on or off the Daylight setting. Hence it may be preferred to enter strings that
don't imply such an assumption, i.e. Astrolog also accepts general abbreviations such as
“ET” or “PT”. For that matter, some one letter time zone abbreviations are accepted, e.g.
“E” or “P” for Eastern and Pacific. When specifying half hour time zones as a number
instead of using an abbreviation, the correct way is with “:30” or “.5”, since the
parameter is processed as hours and minutes. Below is a table of all zone abbreviations
Astrolog accepts. Listed for each zone is its official name, its standard abbreviation, its
hours before UTC, and its standard meridian. For some zones the program accepts special
two and one letter shortcuts:
Time Zone Name           Abbrev.     Hours   Longitude
Hawaiian Standard Time   HST  HT  H  +10   150 W
Central Alaska Time      CAT         +10     150  W
Alaska Hawaii Standard   AHS         +10     150  W
Hawaiian Daylight Time   HDT         + 9   150 W
Alaska Hawaii Daylight   AHD         + 9     150  W
Yukon Standard Time      YST  YT  Y  + 9     135  W
Yukon Daylight Time      YDT         + 8     135  W
Pacific Standard Time    PST  PT  P  + 8     120  W
Pacific Daylight Time    PDT         + 7     120  W
Pacific War Time         PWT         + 7     120  W
Mountain Standard Time   MST  MT  M  + 7     105  W
Mountain Daylight Time   MDT         + 6     105  W
Mountain War Time        MWT         + 6     105  W
Central Standard Time    CST  CT  C  + 6      90  W
Central Daylight Time    CDT         + 5      90  W
Central War Time         CWT         + 5      90  W
Eastern Standard Time    EST  ET  E  + 5      75  W
Eastern Daylight Time    EDT         + 4      75  W
Eastern War Time         EWT         + 4      75  W
Atlantic Standard Time   AST  AT  A  + 4      60  W
Atlantic Daylight Time   ADT         + 3      60  W
Atlantic War Time        AWT         + 3      60  W
Brazil Standard Time     BST  BT  B  + 3      45  W
Brazil Daylight Time     BDT         + 2      45  W
West Africa Time         WAT         + 1      15  W
Universal Time Code UTC UT U 0 0
Greenwich Mean Time      GMT  GT  G    0       0
Western European Time    WET           0       0
Central European Time    CET         - 1      15  E
Eastern European Time    EET         - 2      30  E
Russia Zone 3            UZ3         - 4      60  E
Russia Zone 4            UZ4         - 5      75  E
Indian Standard Time     IST  IT  I  - 5:30   82.5E
Russia Zone 5            UZ5         - 6      90  E
North Sumatra Time       NST         - 6:30   97.5E
South Sumatra Time       SST         - 7     105  E
China Coast Time         CCT         - 8     120  E
Japan Standard Time      JST  JT  J  - 9     135  E
South Australian Time    SAS         - 9:30  142.5E
 Guam Standard Time       GST         -10     150  E
Russia Zone 1            UZ1         -11     165  E
New Zealand Time         NZT  ZT  Z  -12   180 E
International Date Line  IDL         -12     180  E
Local Mean Time          LMT  LT  L  Varies  Varies
Local Apparent Time      LAT    Varies  Varies

The special time zone setting “LMT” allows one to do charts for times given in Local
Mean Time. When encountered, the actual time zone setting will be set appropriately,
doing the “subtract four minutes for every degree west of the time zone’s standard
meridian” arithmetic to make it work. Astrolog also supports time zone entry in Local
Apparent Time (LAT), which is true sundial time. LAT is similar to Local Mean Time
(LMT), the latter of which is a constant rate time based on longitude difference from
GMT. However, since LAT is variable due to Earth’s orbit, equivalent LAT and LMT
times are up to 20 minutes different from each other.
Longitude and latitude locations may be entered in the standard
<degree><direction><minute> notation, e.g. “122W20” or “33S52”. The direction
specifier may also be put at the end of the string, with a period or colon separator
between degrees and minutes, e.g. “122:20W” or “33.52S”. The direction character may
also be left off altogether in which case positive values indicate western and northern
locations and negative eastern and southern, e.g. “122.20” or “-33:52”. Seconds can also
be entered for longitude and latitude locations, in formats such as “122W19:59” or
“[Link]W”.
Note: When parsing time zones, the number can be preceded by the letter “H”, e.g.
“h5w” is the same as “5w”. Time zones may also optionally be specified as a longitude
degree value to use instead of hours, with the prefix “m”, e.g. “m90e00” means 90
degrees East, which is interpreted the same as “6:00E” for 6 hours East. Also, for times
and locations, seconds can be specified by having four digits in a row after the
degree/hour, e.g. “12:3456” is equivalent to “[Link]”. These are formats used by
Astrodienst on [Link] (such as in Astrodatabank files) which it’s important to be able
to parse.
--
When the chart zodiac positions are displayed, by default they’re truncated instead of
rounded, e.g. a position of 12Lib34 means the actual position is somewhere between
12Lib34:00 and 12Lib34:59. When the standard list of planetary positions is displayed,
some additional pieces of information are shown along with the planetary locations:
Whether or not each planet is in its ruling sign, or detriment, as well as the same
information for houses, is shown. Planets in their exalted and fall i.e. debilitated signs and
houses are noted too. In addition to the (R) indicating a planet in its ruling sign, and an
(d) for a planet in detriment, there’s also (X) if a planet is in its exalting sign, and a (f) for
a planet in its fall sign (which is always opposite the exaltation, as how the detriment is
opposite the ruler).
The text listing also indicates Esoteric Astrology rulerships. Normally shown is whether
the planet exoterically rules or is in detriment in the sign (indicated with “R” or “d”
characters), and whether the planet exalts or falls in the sign (“X” or “f” characters). If
the right rulership restrictions are set, also included is whether the planet esoterically
rules or is in detriment in the sign (“S” or “s” characters), whether the planet
Hierarchically rules or is in detriment in the sign (“H” or “h” characters), and whether the
planet Ray rules or is in Ray detriment in the sign i.e. whether the planet’s Ray is the
same as one of the sign’s Rays (“Y” or “z” characters). In case of multiple alignments
applying, the order of priority is to show a standard exoteric rulership or detriment, an
exaltation or fall, an esoteric rulership, a Hierarchical rulership, and finally a Ray
rulership.
In this main display, an element table indicating the sum of the signs in each element and
mode and their totals is displayed in a grid form. Also, the total number of planets in each
of the hemispheres of the wheel, as well the number of objects in yang/positive/masculine
and yin/negative/feminine quality signs, are counted. To the right of the element table, we
have a column of seven numbers labeled as follows: “+” is the number of “yang” objects
(i.e. in Fire or Air signs); “-” is the number of “yin” objects (i.e. in Water or Earth signs);
“M” is the number of objects above the horizon (i.e. in the “Southern” hemisphere of the
Midheaven); “N” is the number of objects below the horizon (in the “Northern”
hemisphere of the Nadir); “A” is the number of objects in the Eastern half of the sky (in
the hemisphere of the Ascendant); and “D” is the number of objects in the Western half
of the sky (in the hemisphere of the Descendant). Note that cusp objects are left out of
hemisphere counts (but still included in the other object summaries) as they would skew
things since they are always in a particular hemisphere. Finally we have a field indicating
the division of objects into the first six and second six signs of the zodiac. The number of
objects in the first six signs of the zodiac will be printed, labeled by the character “<“.
(The number in the second half isn't printed; just subtract from the total if you want to
know.) According to a book on the Kabbalah, the emphasis of the first six signs on the
zodiac is on “what’s to learn”, and the emphasis on the second six signs is on “what’s to
share”. Use or interpret this as you wish.
I have taken the liberty to define ruling and exalting signs for the asteroids (and the rest
of the first 22 objects that don't already have them.) This won't affect much other than
whether a 'R', 'd', 'X', or 'f' is displayed in the -v charts, but it will slightly affect the
powers given to these objects in the -j influence chart since they can be in their ruling
sign, etc. The -HO object list will display the list of ruling and exalting signs (and the
detriment and fall signs which are just opposite the above) for all these objects in addition
to the planets; however, I have listed them below:
Chiron, the compassionate, experienced healer, is most similar in function to Pisces,
hence Chiron rules here. Chiron expresses well in caring, feeling, Cancer, hence Chiron
exalts here. Ceres, goddess of agriculture and representing the mothering, reproductive
instinct, is similar in function to Taurus, hence Ceres rules here. Ceres expresses well in
the nurturing, caring, sign of Cancer, hence Ceres exalts here. Pallas Athena, mentally
acute and unemotional, is most similar in function to Virgo, hence Pallas rules here.
Pallas expresses well in practical, disciplined, introverted Capricorn, hence Pallas exalts
here. Juno, ability to sacrifice self-interests to maintain a relationship, is most similar in
function to relationship oriented Libra, hence Juno rules here. Juno expresses well in
sociable, crowd pleasing Leo, hence Juno exalts here. Vesta, with its orientation to
directing hidden creative or sexual energy without fear, is most similar in function to
Scorpio, hence Vesta rules here. Vesta expresses well in individualistic, quirky Aquarius,
hence Vesta exalts here.
The North Node, with its emphasis on being able to break from the past routine and
pursue the unfamiliar and personal growth, is most similar in function to society
questioning independent Aquarius, hence it rules here. The South Node’s ruling and
exalting signs are set to be respectively Leo and Sagittarius, i.e. the opposite of the North
Node’s. The Part of Fortune is calculated based on the positions of the Sun, Moon, and
Ascendant; if these three objects are in their ruling signs, then the Fortune will fall in
Pisces, hence the Fortune should rule here. Similarly, if the Sun, Moon, and Ascendant
are all in their exalting signs, then the Fortune will fall in Aquarius, hence the Fortune
should exalt here. The Vertex, being always near the Descendant, corresponds to Libra,
and hence has the same rulership and exaltation as Venus: Libra and Pisces. The East
Point, being always near the Ascendant, corresponds to Mars, and hence has the same
rulership and exaltation as Mars: Aries and Capricorn. Lilith has the rulership of Scorpio
and exaltation in Pisces. House cusps and angles rule the sign corresponding to them, e.g.
Aries for the Ascendant, Taurus for the 2nd Cusp, and so on. House cusp objects exalt in
the next sign of the same element beyond the one they rule, e.g. Aries exalts in Leo.
Each Uranian also has been assigned its own ruling and exalting sign, meaning Uranians
in their rulership, etc, will be flagged as such and have more or less influence and so on. I
also came up with these myself and used the interpretation strings to decide what the
most appropriate signs are. If you prefer other signs or no sign at all for any of the
rulerships, you can easily change them using the -YJ switch described elsewhere.
Specifically, Cupido rules Libra and exalts in Gemini, Hades rules Scorpio and exalts in
Virgo, Zeus rules Leo and exalts in Aries, Kronos rules Capricorn and exalts in
Sagittarius, Apollon rules Sagittarius and exalts in Aquarius, Admetos rules Virgo and
exalts in Scorpio, Vulkanus rules Aries and exalts in Leo, and finally Poseidon rules
Sagittarius and exalts in Pisces.
The standard chart listing of the planetary positions will also include an additional field
for the “velocity” of each planet. This velocity value approximates how fast the planet is
moving through the zodiac with respect to the Earth (or whatever the central body is set
to) in degrees per day. This value of course, goes negative when a planet goes retrograde.
This is useful not only to get a feel for how fast each planet moves through the zodiac,
but to determine when a planet is about to go retrograde or direct, in which the value
approaches zero when the planet is about to change direction. Velocities will also be
displayed for house cusp and related objects like the Vertex and East Point.
 FILES, DATA DEFAULTS, AND COMPILE TIME OPTIONS
Astrolog includes the ability to search an input file for various default settings to use in
the program. This allows one to easily change major defaults without having to recompile
the program, which is useful if, say, one receives a compiled executable from a friend
who has a different configuration. The program looks for the file [Link] in the
current directory, and if not there, looks for it in the default directory (and in directories
indicated by environment variables if set). Parameters in this file will override any
defaults compiled into the program, although the highest priority is still given to the
command line options. Note one doesn't have to have this file in order to run the program
- if not found Astrolog will still run as before using compile time defaults.
Astrolog configuration files from versions 4.10 and before (which were named
“[Link]”) won't work with the current version, because like the chart info files, the
[Link] file is also a series of command switches (see below). The fixed fields used in
version 4.10 and before no longer exist, since there are command switches to do the same
things as everything the old files could set and a whole lot more. Attempting to use any
old [Link] file will cause the program to complain that it’s not in any valid format.
If you have an old file, delete it and modify the one included with this release to
correspond to your desired settings. Version 4.20 through 7.50 configuration files are
however fully compatible with 7.60 and don't need to be changed.
--
As of Astrolog version 4.20, all files are a series of command switches that indicate the
contents of the file and set the appropriate things when executed. This is very powerful,
extendable, and general. Astrolog still has the ability to read and write the old chart
formats. This affects -o chart info files, -o0 chart position files, and the [Link] config
file. In a sense there is no difference between the three formats, just they are generated or
read in for different situations. Whenever any chart is read in, Astrolog simply reads in
the file a line at a time and processes the switches as if they were on the command line or
entered in a -Q loop.
The [Link] config file is one of the files that is a series of command lines. This
change makes the [Link] file much more powerful and versatile than it would be
otherwise. The file is not in a fixed format with fields that have to be in a certain order.
You can move lines around, add as many lines as you want, or take lines out without
problem. These config files shouldn't become out of date in future versions of the
program either. Incompatibilities will only arise if the syntax of a switch changes, and
even then it’s obvious as to the small correction that needs to be made. It’s important to
remember that any switch can be put in the [Link] file. For example, you can change
the default behavior of the program when invoked without any switches, by say putting “-
n” in it, to make the program always display the chart for now unless you specify
otherwise. You may want to put “-C” in it if you want the house cusps to always be
included in transit and other charts. If you are always doing graphics charts, you can put
“-X” in there somewhere so you don't have to put it on the command line. Long or
complicated switches like new planet definitions, and color or interpretation
customizations, are good candidates to put in [Link] so they don't have to be retyped
all the time.
The file as generated with the -o switch is also just a couple of command lines to set the
chart information appropriately. (Before version 4.20, the older file format hadn't
changed a bit since files where first introduced in version 1.20!) Note that you can
manually add additional switches to any chart info file, to have per chart settings. For
example, if you are always displaying a particular natal chart’s aspect grid, you can put a
“-g” in that particular file so you don't have to include -g on the actual command line
with the “-i file”. (Or you can put the “-g” in the [Link] file and have all charts come
up by default in the aspect grid instead of the -v listing.) Note also that the -i switch is
technically a generic command file reader. You can read any switch file with -i, and even
reload the [Link] defaults with a line such as “-i [Link]”.
Since -i will read in and process any command file, you can make your own arbitrary
command files and read them in whenever you want. You aren't limited to modifying just
chart info files and [Link]. Say you like to use a narrower set of orbs for transits. You
can make a special file that just sets a bunch of orbs using the -A switches, and then read
it in via “-i narroworbfile” and combine it with -t or whatever. Note that command files
can even process other command files inside of them. Remember that [Link] is just a
special command file; the program basically just does a “-i [Link]” internally on
startup.
-@ switch: All Astrolog switch files must begin with the '@' character, which identifies
them as such. The switch files as generated with -o and -o0, and the default [Link]
file, have a few characters immediately following the '@' which indicate the file type and
program version, included for potential backward compatibility issues in the future. All
Astrolog command switch files start with a line beginning with “@A”, followed by a
character identifying the file subtype (which is one of “IPLDCZS”), followed by the
program version number not counting the period (i.e. “750”). Specifically, Astrolog chart
info files start with “@AI750”, chart position files start with “@AP750”, chart list files
start with “@AL750”, default settings files like “[Link]” start with “@AD750”. The
city atlas file “[Link]” starts with “@AC750”, and the time change file “[Link]”
starts with “@AZ750”. The sequence “@AS750” isn’t used by any Astrolog system or
automatically generated file, but is reserved for user scripts generated manually. Note that
the '@' happens to technically be a switch too, but is only dealt with internally by the
program. If you make any of your own command files to read in with -i, just be sure there
is a '@' character at its very beginning (or better yet the sequence of characters
“@AS750” to indicate it’s a custom script file) and everything will work.
Before version 7.00, an older format was used: The first two digits after “@”
indicated file type, in which “01” was a -o chart info file, “02” was a -o0 chart
position file, and “03” was a configuration file like [Link]. The second two
digits indicated file version: Chart info files were “0103”, because version 1 of a
chart info file was the pre-version 4.20 form, and version 2 was the pre-version
6.00 form. Chart position files were “0205” because version 4 was the pre-version
6.50 form, version 3 was the pre-version 6.00 form, version 2 was the pre-version
4.20 form, and version 1 was the pre-version 3.10 form. The [Link] file was
 “0309” because versions 1-7 were all the different old fixed field versions of this
dating back to when the config file was first introduced, and version 8 was the
pre-version 6.00 instance of it. Astrolog 7.60 and earlier versions can load each
others’ files without problem.
Chart position files as generated with the -o0 switch are much improved over the format
used in versions 4.10 and before. The zodiac positions have an extra two digits of
precision and the declinations have an extra one digit. The newer files include the
velocity of the planet and its distance from the sun, so applying vs. separating aspects and
-S orbit charts work perfectly. (Before the data would be lost.) These files may also
include star positions unlike before, and are more complete with respect to house cusps.
The actual house array is kept separate from the cusp object indexes, meaning that one
for example can reload charts in the Equal house system that disassociate the Midheaven
from the 10th cusp and remember both positions, and even save a -r synastry chart with -
o0 and remember both sets of house cusps on reload.
-YF switch: As -o0 position files are a series of command lines, there is a switch to set
the actual positions of a planet. This is the -YF switch which takes eight parameters,
which are: the index of the object to set the positions of, the degree within the sign of its
position, the zodiac sign of its position, the minute within the degree of its position, the
degree of its ecliptic latitude, the minute within the degree of the latitude (which should
always be positive, e.g. for a latitude of -10.5 degrees, the parameters would be -10 and
30), the velocity in degrees per day (positive is direct motion, negative retrograde), and
finally the distance from the Sun or central body in AU. This switch shouldn't really be
used outside of -o0 files as it causes the chart to be assumed to have no time or space, but
is described here for completeness. Note that another advantage to the newer -o0 files is
that you can again add other switches to them (e.g. “-s” to indicate if it’s a position file
for a tropical or sidereal zodiac chart), and rearrange or delete lines without problem,
unlike the older -o0 files which required all the planets and in a fixed order.
To handle houses, when the -YF switch is called on a house cusp object, it will set the
object itself as well as the corresponding house cusp. However, the angles are slightly
different: Setting the Ascendant or MC objects won’t affect any house cusps, and setting
the IC or Descendant objects will also set both the house cusp, as well as set the opposite
house cusp to be 180 degrees opposite. This allows chart position files to properly cover
cases where the Ascendant is different from the 1st cusp and/or the MC is different from
the 10th cusp, and also cases where non-angular houses aren’t 180 degrees opposite each
other.
Here’s an example of one of the switch based command files, specifically a modern chart
info file with the name, city, and Daylight fields in it. This is much easier to understand
and modify than older files, and is the info for my own natal chart consisting of the three
lines below:
@AI750 ; Astrolog chart info.
/qb Nov 19 1971 11:01am ST +8:00 [Link]W [Link]N
/zi "Walter D. Pullen" "Seattle, WA, USA"
--
Astrolog has several environment variables which may be set to indicate directories
where to find the various files it may look for. Without them, the only place the program
will look for chart files, the [Link] initialization file, and ephemeris files is in the
current directory and default directories set at compile time. The program will look where
all of these environment variables point, if they are defined. The three environment
variables are named “ASTROLOG”, “ASTR750”, and “ASTR”. On a PC you can set an
environment variable from the DOS prompt with a command such as “set
ASTROLOG=C:\PROGRAMS\ASTRO750\CHARTS”. This command can be put in
your [Link] file to remain persistent. On a Unix system you can set an
environment variable from the shell with a command such as “setenv ASTROLOG
~username/programs/astro750/charts”. This line can be put in your .cshrc file to remain
persistent. Note that the ASTR750 environment variable is version specific, i.e. the
previous version looked in one called ASTR740 instead. This allows one to have a
directory for version specific files such as the [Link] file, and have multiple versions
of Astrolog on the system at once without them conflicting with each other. I personally
point ASTROLOG to my chart files directory, ASTR750 to my [Link] directory, and
ASTR to my ephemeris directory, although any file may be found with any of the
variables. Specifically, when Astrolog searches for a file, it will look in the following
directories, in order: The current directory, the ASTR750 environment variable directory,
the ASTROLOG environment directory, the ASTR dir, and finally the compile time
default directory.
--
Some systems (for example, Mac’s) don't directly accept parameter switches on the
command line (such as Astrolog is being booted from a menu.) Therefore, such a
limitation makes one unable to access many program features in the normal way. If this is
the case with your system (or if you just don't like command line options), then comment
out the '#define SWITCHES' line at the beginning of the astrolog.h file. If you do this,
then the program will ignore any switches and prompt you to enter them manually at the
very beginning of program execution. You just enter one line containing all the
parameters together, separated by one or more spaces, just like is done when typing in the
command line, or when in the -Q loop mode. Astrolog will automatically parse the string
and extract the parameters, just like the operating system shell does.
Related to this, the “-.” switch, when encountered on a command line, will immediately
terminate the program, ignoring any modes or other command switches. This is the
formal way how to really exit the program when in the -Q loop (and really only useful in
this case). Remember, earlier it was said to enter “.” for the command line to exit the -Q
mode. Astrolog internally interprets the “.” as a switch without a leading dash, i.e. “-.”,
which is a switch that will force program termination.
--
I often use Astrolog to look at and compare files containing charts of various people. I
have many chart files, so I keep them in a separate directory. Since it is always a pain to
have to cd into this special directory all the time, there is a DEFAULT_DIR string to be
set at compile time. Whenever the program reads in a chart file with the -i option, it will
first look in the current directory for it. If it’s not found there, Astrolog will then look for
a file of the same name in this special default directory (and in directories indicated by
environment variables if set).
A couple of other compile time option variables are in the include file astrolog.h: For
those people who don't like Placidus, a default house system can be set by changing the
value of DEFAULT_SYSTEM to the value from 0 to 11 indicating what system to use if
the user doesn't explicitly specify one with -c or in [Link]. A few other compile time
options are in astrolog.h which can be used to leave out certain parts of the program
which you don't desire to have or just take up memory and make the executable larger.
The #define INTERPRET can be commented out to remove all the -I interpretation
routines and tables. The #define BIORHYTHM can be commented out to remove the
non-astrological -rb biorhythm text and graphical charts. And the #define CONSTEL can
be commented out to remove the -XF constellation graphics and -HF text constellation
list. Finally, concerning the source code itself, all of Astrolog’s functions have full Ansi
prototypes, which can be turned off for older compilers by commenting out the PROTO
#ifdef.
There is a special compile time variable dealing with graphics (in addition to the “X11”
and “WIN” ones) called “GRAPH”. One comments out the #define GRAPH line if they
don't want any graphics at all, and not just if they don't have X windows or PC screen
graphics. In other words, one can generate most of Astrolog’s graphics charts even if they
don't have X windows or a PC with graphics abilities. When GRAPH is defined, but X11
or WIN aren't, the program will generate the charts, but just never try to bring up a
window; it will simply always assume that you are writing a bitmap file. The bitmap file
will contain a (unfortunately always black and white for the X bitmap format) image of
what would normally be in the window, just as the -Xb switch does. One can then use
various graphics utilities to convert the image into something they can display on their
system if they can't do so using any of the available bitmap modes. (Any system that can
compile Astrolog should be able to compile in all the non-screen graphics features as
well.)
A bitmap output mode other than the Windows .bmp bitmaps and standard ones that can
be read with the Unix X11 xsetroot command is allowed in the graphics routines. If one
changes the BITMAPMODE compile time option in astrolog.h to the character 'A' when
compiling, or invokes the -Xb switch as -Xba, then all bitmaps output will be in a straight
Ascii form, with one character corresponding to each pixel. This format is identical to the
result produced by the Unix command bmtoa (when the chart is monochrome), and it can
be converted back into a bitmap with the Unix command atobm. Although not as efficient
spacewise, this is a simpler format, and is recommended for those without screen
capabilities who still want to use Astrolog’s graphics, if they want to write their own
conversion program.
 DESCRIPTION OF GRAPHICS FEATURES
One of the most impressive features of Astrolog are its graphics features available for X
windows, which are generally accessed in the program via the -X switch and derivatives
of it on the command line. There are seven different types of chart displays: A standard
graphic display of a wheel chart in a window (with glyphs, aspects in the center, etc),
graphic displays of the Astro-graph charts (which look almost identical to the
Astro*Carto*Graphy maps from Jim Lewis) complete with all the labeled lines drawn on
a map of the world (like the -L option), aspect/midpoint grids showing the aspects and
orbs in effect between every body in a chart (like -g option), a local sky chart showing
where each planet is located on a map of the local horizon area (as in -Z), a space chart
showing an aerial view of the solar system (as in -S), a dispositor graph chart showing
planetary rulership chains (accessed with -j), and a graphic ephemeris plotting position
vs. time (as in -E), in addition to a couple of non-astrological charts such as calendar (-K)
and biorhythm (-rb) graphics. The X wheel and aspect grid charts can also displayed in a
different manner to accommodate relationship comparison charts showing two sets of
planets at once. There are also other commands that can be given to the window once it is
up and running, which can do other things, such as continually update the window every
few seconds to the current status (i.e. an extended version of the -n option) as well as
other forms of animation. Note that the program is still text based, and one can turn off
all the X features by commenting out the #define X11 in astrolog.h if they don't have X
windows.
Probably the only thing more impressive than the graphics features are the graphics
features displayed on color monitors. Here is how the colors have been assigned for the
various charts: Four colors have been allocated for the four elements which by default
are: Fire = Red, Earth = Brown, Air = Green, Water = Blue. The various sign glyphs (and
the corresponding house labels) are in the color of their element. Planets are in the color
of the sign of their main ruler. Chiron and the four asteroids are Pink, while the North
Node, and other non-physical objects like the Part of Fortune and Vertex are Blue Gray.
Representations of the Ascendant/ Descendant/ Midheaven/ Nadir (in the astro-graph
map lines and elsewhere) are in the element color of the corresponding sign/house that
the angular lines refer to, i.e. Ascendant = Red, Midheaven = Brown, Descendant =
Green, Nadir = Blue. A few extra things have been added for color wheel charts only:
dark gray lines marking off each house (in addition to the main lines on the horizon and
meridian), and each degree instead of every 5th degree being marked in dark gray on the
outer circle (every 5th degree being white). Aspects lines are colored too, as follows:
Conjunctions = Yellow, Sextiles = Light Blue, Squares = Red, Trines = Green,
Oppositions = Dark Blue. For the minor aspects we have: Inconjuncts/Semisextiles =
Pink, Semisquares/ Sesquiquadratures = Orange, (Bi/Semi)Quintiles = Dark Cyan,
(Bi/Tri)Septiles = Maroon, (Bi/Quatro)Noviles = Purple, (Bi/Tri/Quatro/Quin)Undeciles
= Dark Green.
For color terminals, the -XG globe display and -XW world map display are done with the
continents in different colors, also making them look much better than monochrome
maps. Each of the seven continents is in a different color of the rainbow, and the colors
are chosen to correspond to the appropriate chakra (etheric energy vortex along the
human spine) that goes with each land mass. They are: Africa - red - Root chakra,
Australia - orange - Navel chakra, South America - yellow - Solar plexus chakra, North
America - green - Heart chakra, Europe - blue - Throat chakra, Asia - indigo - Third Eye
chakra, Antarctica - violet - Crown chakra. Lakes within continents are colored dark blue.
--
-v -X: The graphic wheel charts have their graphic information organized as follows:
There’s an outer circle showing the signs and sign glyphs, inside of which is a smaller
circle divided up into 5 degree increments to make determining exact degrees easier.
Inside of this is a circle divided up into the 12 houses labeled with numbers. The entire
chart is divided by two dashed lines through the Ascendant/Descendant (which is always
horizontal of course) and the Midheaven/Nadir. Inside the house circle are the planet
glyphs in their appropriate positions. Small pointer lines run from each glyph to just
before single dots. These dots indicate the precise locations in the zodiac of each object.
The pointer lines (which are gray or dashed if the object is retrograde, and bright or solid
otherwise) are necessary so as not to have to draw planet glyphs on top of one another
when planets are conjunct. Inside the ring of the single dots, are the aspect lines
connecting these positions. Since the default number of aspects to use is just the 5 majors,
one can determine which aspect is in place just by looking at the aspect line. The
accuracy of the aspect is determined by the dashedness of the line: A solid line means the
orb is < 2 degrees; a dashed line means the orb is 2 to 4 degrees; a really dashed line
mean the orb is 4 to 6 degrees, and so on.
-v0 -X: Astrolog’s wheel charts will be labeled more extensively than just having the
chart header information displayed at the bottom of the graphic like in other chart modes.
The wheels will include full information on time, place, the chart’s name and city fields if
defined, house system, zodiac, central planet, element table info (including the count of
objects in angular, succedent, and cadent houses, and the count of objects in the first six
“learning” signs and the last six “sharing” signs), as well as the actual positions of house
cusps and planets as displayed in the wheel. (House cusp positions won’t be displayed
when using the Null house system.) All this information is in a “sidebar” to the right of
the wheel which includes a listing not unlike the -v text chart. (Note that the default size
of this sidebar is such that for a 480x480 pixel chart size, including the sidebar will make
it 640x480, which perfectly fills a classic VGA PC screen.)
The sidebar can include house cusp objects in the list of planets. Each cusp object
will only be included if it’s different from the actual house cusp, or if its latitude
is non-zero. Normally cusp objects are redundant, since the positions of the 12
houses are already listed, however (for example) some house systems have the
Ascendant different from the 1st house, or the Midheaven different from the 10th,
which means it’s important to list them.
The sidebar will also include additional lines to indicate less common chart types,
which makes it easier to see when a particular mode is in effect. Included will be
whether the chart is progressed (and if so what date it’s progressed to), if the
harmonic chart factor has been set, along with special indicators if the decan,
dwad, domal, Navamsa, or geodetic houses settings are on. Solar charts will be
 indicated too, and will mention how the planet positions are being rotated. It will
indicate what planet is being rotated to what position, and whether the rotating is
to the start of sign, e.g. “Sun on Ascendant” or “Moon’s sign on Midheaven”.
This sidebar supports relationship charts involving two or more charts, and for a
relationship chart will list both sets of chart information (or all three or four sets
in the case of tri and quad wheels). Each set of chart information will be properly
labeled, such as synastry chart sidebars will indicate which set of chart
information is determining the houses and which the planets. If you want a
simpler style wheel with just the chart information at the bottom of the graphic,
set the -v0 flag, as in “-v0 -X”, instead of “-v -X” or just “-X”.
-w -X: A different way of formatting the graphical wheel charts described above is
available by combining the -w switch with -X. Normally all of Astrolog’s wheel charts
are such that each zodiac sign is the same size. Due to different house sizes in most
systems however, this makes the houses appear different sizes on the wheel, so that the
Midheaven won't be the exact top of the chart for instance. Some users may instead prefer
“house oriented” as opposed to sign oriented wheel charts. Astrolog, with the -w -X
combination, will make each house be the same size on the screen, and will compress or
expand the signs instead (of course this means that such things as exact squares may not
be between objects exactly 90 degrees apart on the circle any more). When graphics are
displayed on the screen, the '0' key will toggle between the two forms of wheel chart.
-L -X: The graphical astro-graph charts are organized as follows: A map of the world is
shown. The edges of the map are labeled with ruler lines that are 5 degrees apart (with
longer ruler lines for more important longitudes and latitudes, like those that are multiples
of 10, 30, etc.) The equator is labeled with a dashed line. The polar regions of the world
aren't shown; the map shown ranges from 60 degrees S latitude to 75 degrees N latitude.
Note that each pixel on the screen represents exactly one half a degree on the world. (For
-Xs 100 the ratio is one pixel to one degree, and for -Xs 400 the ratio is one pixel to 1/4
degree.) On this map are drawn the lines indicating where on the world the various
planets are angular at the time in question. (Note: you might want to -R restrict some
objects because otherwise the map tends to get pretty cluttered with lines.) As expected,
Midheaven and Nadir lines are vertical, and the Ascendant and Descendant lines are
curved. Little square boxes on the Midheaven lines indicate the exact zenith latitude
location. Each line is labeled at the top or the bottom of the screen, showing what planet
is in question and (sometimes) what angle is in question. All Ascendant and Midheaven
lines are labeled at the bottom of the screen, and all Descendant and Nadir lines are
labeled at the top. Each line goes a bit beyond to the top or bottom of the world map, and
then another pointer segment (which is again dashed of the object in question is
retrograde) goes and points to the planet glyph. The glyph for the Ascendant or
Midheaven is under each of the glyphs at the bottom of the screen, explicitly indicating
whether the line is an Ascendant or Midheaven line. At the top of the screen, however,
there are only the glyphs, but one can still determine whether these lines are Descendant
or Nadir lines based on whether they are curved or not. Note that not all the Descendant
lines are labeled; this is because some of the Ascendant/Descendant lines actually
connect near the top of the screen and don't actually cross it. (Where the Ascendant and
Descendant lines meet, those points are intersected by the planet’s Midheaven or Nadir
lines.) This graphic astro-graph chart will display a small purple dot at the precise point
on the world map for which the chart in question is being generated. This is useful to help
see how close the various planetary lines are to you, if you live in the middle of the
continent or someplace not easily determinable on the compact map of the world.
-L0 -X: Graphic astro-graph charts will be done slightly differently if done by combining
-L0 with -X. A thin horizontal line will be drawn all across the map of the world at the
latitude of the chart in question. Normally, there’s only a small dot at the precise location.
In astro-graph charts, intersections between lines anywhere at the same latitude of a natal
chart, even if any number of degrees away longitudinally, will affect the person, in the
same way but not as strong as if they are directly under the intersection itself. This small
chart modification can make finding such intersections easier in the graphics chart, just as
-L0 for text charts actually lists the latitudes of all crossings.
-g -X: Aspect grid graphics with the appropriate aspect glyphs can be displayed by
combining the -g option with the -X option (astrolog -g -X). Both the split
aspect/midpoint grids labeled down the diagonal, as well as the relationship aspect grids
between two charts (astrolog -r0 <file1> <file2> -g -X) are supported. The aspect glyphs,
objects, and the signs in the grids are in their colors as defined earlier. Like the astro-
graph charts, these charts can't be resized in the normal way unless one uses the '>' and '<'
keys. For anything less than the larger scale sizes (achieved with the switch -Xs 300, or
by pressing '>' within a window) all that will be displayed in each aspect grid cell is the
glyphs of the aspect in effect, the planet being aspected, or the sign of the midpoint.
However, once the larger scale sizes are reached, there is room in each cell to display the
aspect orb to the nearest minute off of exact (with a plus or minus sign indicating whether
the actual angle is slightly greater than or less than exact, or an 'a' or 's' if applying vs.
separating orbs are to be shown instead); the degree and minute in addition to the sign for
midpoints; and the degree and sign location for each planet that’s in the grid, as with the -
g text charts. This chart will show the nearest arc second of orbs and midpoints when the
-b0 print nearest second setting is on, and when the -Xs character scale factor is 400 (so
that there’s enough room to include seconds).
-m -X: Astrolog supports dial wheel charts with midpoint trees, as used in Uranian
astrology. To display it, bring up Astrolog’s midpoint chart with graphics mode on (with
the -m -X switches, or with the “Chart / Midpoint List” menu command). The dial used is
based on the harmonic chart factor setting, in which a harmonic factor of 1 is a 360
degree dial, 2 is a 180 degree dial, 3 is a 120 degree dial, 4 is a 90 degree dial, and so on.
Dials may also be specified in number of degrees covered, in which the parameter to the -
x switch (or the “harmonic chart factor” field in the Calculation Settings dialog) may
have the prefix “d” to indicate a dial degree instead of a harmonic chart factor. For
example, entering “4” or “d90” will both do a 90 degree dial.
The dial chart will have a red arrow crossing the wheel pointing to the focus
planet or degree, and it can be interactively moved by pressing the left and right
arrow keys, or by clicking and dragging the right mouse button. The parameter to
the -XZ switch (or the “telescope focuses on this object” field in the Graphics
Settings dialog) will indicate the object for the dial to focus upon. If that field is
 empty and not set to a planet, then the dial will instead point to the degree
indicated by the parameter to the -XW switch (or the “horizontal map degree
rotation” field in Graphics Settings).
The dial will also draw lines between planets which have the focus point as their
midpoint. These lines will use the orb of the Conjunction aspect to determine how
wide to allow lines. The middle of the chart will list these midpoints, showing the
two objects forming the midpoint, the angle in dial degrees between them, and the
orb or how offset the midpoint is from exact. This midpoint list can be sorted in
several different ways, based on the -a subswitch (or the “sort aspect list by” field
in the Chart Settings dialog). Specifically, you can sort by aspect i.e. angle (the
default), by orb, or by object index. Note that the “3D aspects” setting will apply
to these midpoints, and if enabled will calculate 3D midpoints based on great
circles that take ecliptic latitude into account, instead of just midpoints based on
zodiac position only. If the “show equator” setting is on (-Xe switch) then instead
of a dial and midpoint tree, standard aspects between points around the wheel will
be drawn.
-Z -X: The -Z local horizon feature can be displayed in an X window as well (e.g.
astrolog -Z -X), in which all the planets will be displayed in a window depicting the sky.
The small dot above or below each glyph indicates exactly where each planet is. (Some
of the glyphs may be overlapping, although the program tries to avoid this.) There is a
horizontal line dividing the window representing the local horizon; planets above this line
are visible, while planets below it are set. There are three vertical lines dividing the
window as well: The middle line represents the due south direction, the one to the left is
due east, the one to the right is due west, and the edges of the window are due north.
(These directions are labeled in the borders of the chart.) Like the standard chart display,
this window or graphic may be resized to any proportion. At any time one can press the
'Z' key when a graphic is up to enter this display type in that window.
-Z0 -X: An additional graphics chart is available through the -Z0 switch: local horizon
charts suitable for stargazing. The normal -Z switch generates a listing of the planets with
respect to the local horizon, and the -Z combined with the -X switch generates a graphic
image of the planets and stars on the local horizon. That chart assumes one is facing due
south, and is divided left to right by the horizon line, with straight up being toward the
top of the screen and straight down toward the bottom. That is a good chart, especially for
noticing the rising and setting of planets and other objects, but the fact that the meridian
is split up causes distortion when trying to view objects high up in the sky. Therefore, if
one combines this -Z0 switch with the -X switch, a differently oriented local horizon
chart will be displayed. Here, the zenith point straight up is in the center of the screen,
and the horizon line is a surrounding circle. Due north is along the line from the center to
the top of the screen, due south is on the line from the center to the bottom, east is to the
left, and west is to the right. In other words, this is just like what one would see if they
were lying on their back looking straight up with their feet to the south, so this should be
better for stargazing. Outside the circle marks what’s below the horizon, and the extreme
corners of the screen mark the nadir or what’s straight down. All points below the
horizon are compressed to fit between the horizon circle and the outer boundary square,
allowing all points in the sky to be visible. As with the normal -Z graphic chart, this one
has the various axes marked at five degree increments.
-S -X: The -S switch can be combined with -X to give a graphics chart of the solar
system. This will be displayed as an aerial view of the entire solar system, with 0 degrees
Aries to the left of the screen, 0 degrees Cancer to the bottom, etc. Whatever object is
chosen to be the central body is at the center of the screen, with all the others around it.
This is a fun chart to animate, in that one can watch the planets orbit around the Sun, and
see how they turn retrograde with respect to the Earth. In addition to the bodies
themselves, twelve spokes are drawn from the center body to the edge of the chart, which
delineate the zodiac with respect to it. This chart will also label the zodiac signs, with
sign glyphs around the outside edge of the chart. These glyphs and the lines to mark the
sign boundaries can be toggled with the show house details setting (-XC switch). This
chart can also display aspect lines between the planets. The aspects present will be with
respect to the central body, and will be the same aspects as seen in the aspect grid or in
the middle of a wheel chart. The display of these aspects can be toggled with the show
equator setting (-Xe switch).
Note that the scale of the solar system is large, which means attempting to fit all
the planets out to Pluto on the screen at once will cause all the inner planets to be
crammed together near the middle of the screen. To deal with this, the scale size
as indicated with the -Xs switch and the '<' and '>' keys will affect how much of
the solar system is viewed at once (in addition to controlling the glyph sizes). For
a scale size of 100, the viewing region will have a wide radius of 90 AU, enough
to easily include the entire solar system, as well as the orbits of the hypothetical
Uranian bodies beyond Pluto. For the default scale size of 200, it will have a
radius of 30 AU, enough to include Neptune (and Pluto most of the time). For a
scale size of 300, the viewport will have a radius of 6 AU (about out to the orbit
of Jupiter, which is useful for viewing the inner planets). Finally for a scale size
of 400, the viewing region will have a radius of 1 AU (just enough to cover the
Earth’s orbit). At a 400% scale zoom with the Moon included as well, one can
actually get a feel for the relative distance of the Sun from the Earth and the Moon
from the Earth, although the chart will have to be over 1000 pixels wide for the
Moon to even appear one pixel away from the Earth! If the scale size is 400, and
the -XS graphic text scale is set to 200 or larger, then the viewing region will be a
very small 0.006 AU, which is just large enough to fit the Moon’s orbit, so works
well with geocentric or Moon object centered charts, to see the motion of the
Moon, Nodes, and Lilith around the Earth. Note that if the -b ephemeris files
setting is off, then Earth’s Moon will be left out.
This chart can display star objects, as well as the list of additional stars. If stars
objects are unrestricted, or the list of additional stars is being shown, then their
positions will be plotted in this chart. Because stars are so far away, the chart
scaling will be in light years instead of Astronomical Units (AU), which is a
factor of about 63000. That will make all planets appear to be overlapping in the
middle of the chart, and as a result when showing stars it’s recommended to
restrict all non-star objects except the Sun. Astrolog’s 3D wireframe file of this
 chart will plot stars in 3D space, resulting in a 3D environment in which one can
explore the local area of the galaxy. For example, the Astrolog animation
[Link] flies through space around the
Big Dipper, allowing one to see how it appears from different angles.
-l -X: The Gauquelin sector chart may be displayed in graphical form by combining the -l
switch with -X, where the 36 sectors will be arranged in a wheel, with chart header info
displayed at the bottom or in a sidebar as with regular wheels. Each planet will be plotted
at its appropriate sector location, with plus zone sectors labeled in red and minus in dark
green, and aspects will be indicated in the middle of the wheel. This chart also has the
plus or minus zone status of each sector indicated by a small plus or minus sign around
the outside border of the wheel. The sidebar in this graphic Gauquelin sector wheel chart
will to the right of each planet position show the sector number the planet falls in.
(Normally this is just the glyph for the object in question like it is for the other wheels.)
-j -X: Graphic dispositor charts are available by combining the -j influence switch with -
X. This is a another graphics chart format that can also be switched to whenever screen
graphics are up by pressing the 'J' key. The dispositor of a planet is the planet that rules
the sign it’s located in. For example, if you have Venus in Aries, the dispositor for your
Venus is Mars. A graph can be made showing an arrow from each planet to its dispositor.
A final dispositor is a planet who is its own dispositor, i.e. in its ruling sign with no
arrows pointing away from it. There can also be two planets in what’s called mutual
reception (or a reception loop of more than two) if they are each other’s dispositor, e.g.
Venus in Aries and Mars in Libra. Astrolog’s dispositor chart will show four subgraphs,
one in each quadrant. Both a sign dispositor graph, as described above, and a house
dispositor graph, where each planet is linked to the planet ruling the house it’s in, are
shown. In addition, both types have the same information displayed in two different
useful formats: a wheel with the planets around the perimeter, and in a hierarchy with
final dispositors at the top and the other planets stacked based on how many levels they
are from final ones. Final dispositors are circled in white, while those in reception loops
are circled in gray, and dispositor arrows within the top level (i.e. in reception loops) are
in white too instead of the color of the planet for easy identification. For a demo of the
dispositors in your own chart, do “astrolog -i yourchartfile -j -X”.
This chart normally graphs standard rulership dispositors, and will include all
non-star and non-cusp objects within it. However, if standard rulerships are
restricted (-YR7 switch) and esoteric rulerships aren’t, then it will instead graph
esoteric rulerships. If esoteric rulerships are graphed, then the chart will always
include Earth and Vulcan (which means Vulcan should be unrestricted so its
position isn’t 0Aries) for 12 planets instead of 10 in the chart. If both standard and
esoteric rulerships are restricted and Hierarchical rulerships aren’t, then this will
instead graph Hierarchical rulerships.
If the modify display setting (-Xi switch) is on, then house cusps will be included
in the chart. If the show glyphs on aspect lines setting (-XA switch) is on, then
final dispositor objects won’t be circled. If the Indian wheel display setting (-J
switch) is on, then the dispositor wheels will arrange objects clockwise instead of
counterclockwise around them. If the show house details setting (-XC switch) is
 on, then the dispositor wheels will have the Sun or first object at the top of the
wheel instead of at the left.
-7 -X: A graphical ephemeris of esoteric Ray influences is available by combining the -7
esoteric chart switch with -X. This chart is effectively the Ray power values in the -7
switch text mode chart graphed over time. The seven Rays and their powers (and average
power) are listed on the horizontal axis, and time on the vertical axis. If the modify chart
setting is on, this chart will graph an entire year instead of just a month. Similarly, as with
the graphic ephemeris chart (-E -X switches), this chart will graph multiple years instead
of just a single year, if the -EY multiple ephemeris years switch setting is active. If the -
Xi alternate display mode is on, it will graph the “slice” power of each Ray instead of the
“count” power. If the -Xl show glyph labels setting is on, this display will have a
horizontal line drawn across the chart indicating the day and time in question, to make it
easier to see where in the month or year the chart time actually is. The -YX7 <num>
switch specifies the width in influence units of each Ray’s column in the esoteric graphic
ephemeris. For example, given “-YX7 600”, then a Ray influence value of 400 will fill
2/3 of the column.
-K -X: Graphic calendar charts are available by combining the -K calendar chart with -X.
This is another graphics format that can be switched to whenever screen graphics are up
by pressing the 'K' key. This shows a calendar for the month of the current chart, like the
corresponding text chart but in graphic format with boxes for each day like a real
calendar. The current day within the month will be highlighted in green (if the -Xl label
inhibitor flag isn't on). The -Xi alternate display mode will put the date numbers in the
middle of their box instead of in the upper left corner. Finally the -Xt chart info display
flag for this particular chart will control how the date numbers are justified in their box.
The -Ky yearly calendar switch may be combined with -X switch to generate a graphic
calendar for the entire year. When the graphic calendar for the year is drawn, the 12
individual months will be arranged in either a 2x6 grid, a 3x4 grid, a 4x3 grid, or a 6x2
grid, based on the dimensions of the chart; for example, a square chart will be drawn
three months across by four down, but a tall skinny chart will cause the calendar layout to
be in a 2x6 grid.
The graphic calendar will include aspect and other events times within each day’s
box, if the “show glyphs on aspect lines” setting is active (-XA switch). This
effectively combines the graphic calendar with the transit to transit times search (-
d switch). Depending on the amount of room available in the boxes, displayed
will be the aspect event, its exact time, and markers for void of course Moon and
Moon phases. Do you miss the aspect calendars in Jim Maynard’s Celestial Guide
and Pocket Astrologer books, after they stopped printing them? This feature can
allow you to make your own. :)
Astrolog’s graphic calendar when showing aspects within each day’s box (-XA
switch) will show transit to natal aspects when in a comparison chart mode,
showing aspects between the transiting date (such as set with the -t switch or in
the Transits dialog) and the natal chart. For example, turn on the “Info /
Comparison Chart” menu command (-r0 switch) to show it. This will do
progressed to natal instead if in “Progressed to Natal” node (-rp switch). To
 distinguish this from standard transit to transit calendar aspects, transiting planets
will be flagged with a “T” prefix, and progressed planets with a “P” prefix.
-E -X: A graphical planetary tracking chart is available by combining the -E switch with
-X. This “graphical ephemeris” will display the sign degrees of the zodiac along the
horizontal axis, and the days in the given month along the vertical. The positions of the
planets at each day (at the time and zone from the current chart) are then graphed. The
result is a bunch of wavy lines that make it easy to see all the planetary movements
during the month. Wherever lines cross there’s a conjunction on the day indicated on the
axis at the same level as the crossing. Although this only looks at the month in the given
chart information, the actual day will be highlighted on the vertical axis. In the -r0
relationship comparison mode, this chart will have in addition to the standard ephemeris
lines for the first chart, dashed vertical lines drawn at the positions of the planets in the
second chart, at the time the ephemeris is done for. If the -Xl show glyph labels setting is
on, this display will have a horizontal line drawn across the chart indicating the day and
time in question, to make it easier to see where in the month or year the chart time
actually is.
Combining the -Ey yearly ephemeris switch with -X will generate a graphical
ephemeris showing the movements for the entire year, with the months labeled
along the vertical axis. Also, this chart can graph multiple years instead of just
one year: The parameter passed to the -EY multiple ephemeris years switch
(which is also present in the “Years To Span” field in the Transits dialog in the
Windows version) will determine how many years the graphic ephemeris covers.
If the -gp or -ap parallel aspects setting is active, then this chart will instead graph
planetary latitudes, instead of zodiac position longitudes. In this alternate display,
planets are normally clustered near the 0 degree mark. The -YX7 switch setting
sets the radius in tenths of degrees to include, e.g. “-YX7 100” shows +/- 10
degrees on either side of 0 degrees latitude, “-YX7 50” shows +/- 5 degrees, and
so on.
-Zd -X: Astrolog has a planet visibility chart which maps planet visibility for a year,
showing when it’s above the horizon. In this chart, the horizontal axis is time of day, and
the vertical axis is day within the year. Pixels are plotted if the planet is above the horizon
at the date/time, allowing one to see at a glance when a planet is visible, and how those
times change during the year. Up to three planets (the first three unrestricted objects) will
be included, in which the first object is red, the second green, and the third blue. Points
where multiple planets are visible are given the combination of those colors, e.g. times
when the red and blue planets are both above the horizon will be magenta. A key
showing which planets or planet combinations are which colors is placed below the
graph. For example, if you want to check times for when both Mars and Jupiter are
visible at night, restrict everything but Sun (red), Mars (green), and Jupiter (blue), and
check the date/time areas that are cyan (in which red is off, and green and blue are on).
This chart is the graphics version of Astrolog’s rising and setting times chart, so in the
Windows version can be selected with the “Rising and Setting” command.
-Nl -X: Astrolog can display a graphical version of its atlas, which plots the location of
nearby cities on a map. This chart also draws directional lines toward where on Earth
each planet is at its zenith. (This local space compass view is used in locational astrology,
and its lines are somewhat related to the angle lines in astrocartography.) Show this chart
by combining the -Nl nearest cities chart switch with -X, or in the Windows version by
selecting the new “Chart / Nearest Cities” command. As with the telescope chart, you can
pan and zoom the part of the earth viewed with the rotation and zoom commands and
hotkeys. Right clicking on the chart will bring up a context menu allowing one to toggle
different settings which determine what things are shown in the chart.
-8 -X: Astrolog’s planetary moons chart can be displayed in graphical form. The graphic
planetary moons chart shows planetary moon placement and aspects in graphical form.
Like the text mode planetary moons chart, this will show the positions of unrestricted
moons, or all moons if all moon objects are restricted. The chart itself is divided into four
circular parts, and shows top and side views from both geocentric and heliocentric
perspectives. Front views are like Astrolog’s telescope chart viewing the planet from the
perspective of the current central body, and show prominence zones making it easy to see
whether a moon is leading, following, above, or below its planet. Top down views are
like Astrolog’s solar system orbit chart looking down upon the ecliptic plane, and show
prominence zones making it easy to see whether a moon is leading, following, close to, or
distant from its planet. All views have a central circle which indicates the planet itself, in
which a moon will only be displayed within the circle if it’s actually eclipsing (transiting
over or occulted by) the planet from the perspective in question. If the chart includes
moons from multiple planets, they will be overlayed within each area.
-r0 -X: True relationship wheel charts can be displayed in a window, i.e. where the
planets of both charts are displayed in separate rings of the same wheel. Use the -r0
option to display this comparison type. For example, for the command “astrolog -r0
person1 person2 -X”, the following is displayed: The signs and houses as in person1’s
chart are drawn in the outermost part of the wheel. Inside this is a ring of person2’s
planets as displayed in person1’s houses, and inside of this are person1’s own planets.
Finally at the very middle is an aspect grid, which shows those aspects that are occurring
between the objects in the two charts. Basically this is just the standard wheel chart for
person1, except that person2’s planets are in an outer ring of objects and the aspect grid
shows the aspects of the relationship. Putting such a chart in animation mode only affects
person2’s planets, so this is a great way to analyze transits: Doing “astrolog -t
yourchartfile -X” will show all your current transits, and allow you to easily animate the
transiting planets through your natal signs and houses.
-rb -X: Graphical biorhythm charts are available by combining the -rb (or -yb) switch
with -X. This will make a graph of one’s biorhythm for the two weeks before and after
the specified time, with days on the horizontal axis and the Physical, Emotional, and
Intellectual percentages on the vertical. This chart will include a fourth line for the
average of the Physical, Emotional, and Intellectual lines, if the “Modify Display” setting
(-Xi switch) is on. When any graphics chart is up, one may press the 'Y' key to revert to a
biorhythm chart. (Note that this is a relationship comparison chart, which means if you go
to it from a graphics mode only showing one chart, then it will show the biorhythm for
them at their birth, and you will want to then animate or adjust it to get a useful display.)
--
A couple of conveniences for the graphics features exist. Note that the -Xo
<graphicsfilename> option is only used in conjunction with the -Xb write output to
bitmap switch (or the -Xp or -XM PostScript and metafile chart formats). Therefore, -Xo
automatically assumes -Xb is set. (Invoking -Xb itself without -Xo will have the program
prompt the user for the bitmap filename.) In other words, astrolog -Xb -Xo 'file' is the
same as just astrolog -Xo 'file'. Astrolog includes its own appropriate X bitmap (the same
ringed planet with moons seen in the Windows version) if one iconifies its X window.
For X windows, one can animate a graphics chart on the root background by combining -
XB with the -Xn switch. This will be just like the animations done in windows except the
root is being used instead. Astrolog can be run in the background this way to continually
update your root to the current chart representing the present moment. Limitations with
this are that since there’s no window, no keypresses can be processed so the program
must be manually terminated, and that the continual updates will be as CPU intensive as
the window animations are.
When graphics charts are displayed in a window, Astrolog will remember the most recent
user selected window size. When switching from a chart type that has a fixed size to a
chart type that can be of any size, that user selected size will be restored. This behavior
can be seen in the X Windows version, and in windows produced by the command line
Windows version (#define WINCLI enabled). It can also be seen in the standard
Windows version when the Chart Resizes Window and Window Resizes Chart settings
are both enabled.
Text in graphics charts is done using Astrolog’s own internal font. This font includes
glyphs for the high-Ansi 128-255 character range. These glyphs cover the common
Windows-1252 codepage, which is a superset of ISO 8859-1 (Latin 1) but with extra
characters defined for the 128-159 range.

DESCRIPTION OF MS WINDOWS FEATURES

Users of command line versions of Astrolog should find the Microsoft Windows version
familiar and easy to work with. All of Astrolog’s text and graphics chart displays are
available and look the same in the Windows version. Similarly, all of Astrolog’s chart
info and other files work and haven't changed format any. All command line switches
work the same, and can even be passed to the Windows version to do things if you prefer,
in addition to the more user friendly graphical user interface (GUI) being available. The
keys one can press while an interactive graphics screen is up are set as shortcuts for
equivalent menu commands here. Basically, additional features and a more user friendly
interface are presented, while everything else is still available. :)
Not counting the About box and the standard Windows open file, save file, and printing
dialogs, Astrolog contains 21 dialogs, a couple of which are also shared by more than one
command. There are nine top level menus not counting the system menu, which have
among them 130 different options, or 297 counting all second level submenus! In using
the dialogs, one should specify or enter the appropriate settings, and then press “OK” for
them to take effect, or “Cancel” to discard any changes made. On pressing “OK”, the
program will check all the fields for validity, and display an appropriate error message
and not close the dialog if anything is out of range, giving a chance to correct or cancel.
Every menu command has an accelerator, i.e. an underscore below a letter, where when
the menu is displayed one may press that letter to select that option (pressing Alt plus the
appropriate letter may be used to pull down a top level menu). In addition every menu
option has a unique direct keyboard shortcut, in which pressing the appropriate key will
invoke the command directly without having to pull down a menu. To the right of each
menu option is listed the key or key combination that’s its shortcut. Note that a capital
letter here means the shift key needs to be down, e.g. “Alt+o” means hold down the Alt
key and press “o”, while “Alt+O” means hold down both the Alt and Shift keys and then
press “O”.
Astrolog tries to be smart about what you’re trying to do when menu options are selected,
and may automatically change settings to make the appropriate thing happen. For
example, as with the X Windows version, the charts in the MS Windows version can be
divided into “text mode” i.e. just plain text, and “graphics mode” charts, and the first
option on the View menu will switch between them. Charts like transit lists only exist in
text form, so when selected you'll automatically leave graphics mode if in it. Similarly,
selecting most any item on the Graphics menu will enter graphics mode as those settings
have no effect on text charts. Also, entering animation mode will automatically turn on
the flicker free updates setting, and so on.
As with Astrolog versions on other platforms, you can use the mouse to draw on the
window here too. Click and drag the left mouse button to scribble lines. Doing a
Shift+click will draw a straight line from the location you last clicked to the current
position. Doing Control+click will draw a rectangle with opposite corners at the location
last clicked and the current position. Doing Control+Shift+click will draw an ellipse with
opposite corners at the two positions clicked. Finally, when the current display is either
the world map or an astro-graph chart, one may do Alt+click on the map to relocate the
chart to the spot on the world clicked upon, which will change the longitude and latitude
of the current chart info in memory. For the right mouse button, you can click and drag to
rotate various graphics charts, and/or bring up context menus with chart specific settings.
The chart sphere and globe displays can be rotated and well as tilted, while the astro-
graph and world map and polar globe displays can be rotated back and forth along their
single axis.
The window that the charts are drawn in has horizontal and vertical scrollbars on it. For
charts that are just text, the scrollbars may be used to shift the chart up or left to view any
characters that get written off the bottom or right edge of the window. For charts that are
graphics, if the chart is larger than the window it’s in, the scrollbars may be used to move
around the viewable portion of it, while if the chart is smaller than the window, the
scrollbars will control where in the window the chart is drawn, e.g. centered, in upper left
corner, etc. Note that it’s most common and logical to have the chart and window the
same size, in which case moving the scrollbars has no effect on the graphics chart. For
text mode charts, if the window has been scrolled down so that all the text is off the top
of the screen, then the program will automatically scroll up and redraw again, so the
bottom 20 rows or so are visible. Similarly, if while viewing a text mode chart one scrolls
to the right beyond all text, then the program will automatically scroll to the left until at
least some columns are visible again.
Like other versions, Astrolog for Windows will read in and process the contents of the
[Link] file if available on startup for default settings. Immediately after this the
program will process the contents of the Windows command line if any.
In Windows explorer, Astrolog’s icon is a yellow ringed planet with two blue moons.
Astrolog setup claims ownership the file extension “.as”, standing for Astrolog Switch
file. The “.as” extension files appear in Windows as a gray ringed planet icon. Double
clicking a “.as” file (or right clicking it and selecting “Open”) will launch Astrolog and
have it automatically open that file. Right clicking a “.as” file and selecting “Edit” will
open the file in the text editor Notepad.
--
Astrolog for Windows is reasonably intuitive to use and do what you want with even
without referring to any documentation. Still for completeness and detail, below is a
quick rundown on all the menu options. Where applicable, the command switch
corresponding to the menu command is given in brackets. One may look up the
documentation for that command switch in earlier sections for additional information.
Note that each text and graphics chart has a unique popup menu that can be brought up
by right-clicking on the window. There are 20 different graphics chart popup menus, and
21 different text chart menus, which allow changing settings specialized to that chart.
This is a quick and easy way to modify charts in ways that may not be readily apparent
otherwise.

File menu commands:

Open Chart...: This brings up the standard Windows open file dialog, allowing one to
select a chart info, chart position, chart list, or any other Astrolog command file. This file
will be loaded and processed, with the new chart being displayed in the window. [This
does the same as the -i <file> command switch. Note that this ignores the various
Astrolog directory environment variables that -i can use.]
Open Chart #2...: This also brings up the Windows open dialog, allowing one to select a
chart file, however any chart time and location settings will be put into the “second” chart
slot, as used in relationship charts. [This does the same as the -r <file1> <file2> switch,
just that it only sets the contents of <file2>.]
Save Chart Info...: This brings up the standard Windows save file dialog, allowing one
to enter a filename, which will be created and the time and location of the current chart
will be written to it. If a file is specified without the extension delimiter "." in the name,
then the default extension “.as” will automatically appended. If for some reason one
really does want to save a file without any extension, they should just append a “.” to the
filename to give it a zero length extension. Note that, as with all of Astrolog’s Save
dialogs, this will query for a confirmation before overwriting or replacing existing files.
[This does the same as the -o <file> switch.]
Save Chart Positions...: This also brings up the Windows save dialog, however here to
the created file will be written the actual positions of all the planets and house cusps, and
no time or location info. [This does the same as the -o0 <file> switch.]
Save Program Settings...: This allows one to save settings made within the program so
they will automatically be in effect again the next time the program is run. Without this,
one can change settings such as the house system, aspect orbs, and so on, but they will go
away upon exiting the program. The way to make setting changes persistent is to edit the
[Link] default settings file. This command has the program automatically generate a
new [Link] file for you based on the current state of the program. The standard
Windows Save dialog will be brought up as with all the other Save commands. The
default filename to save to will of course be [Link], to replace the existing settings
file. One can start the program, immediately do “File / Save Program Settings”, and
create an [Link] file virtually identical to the one that was just read in. You can select
a different name to save the file to if you like, where the file will be a command switch
file like any other except it won't be read in automatically on startup like [Link].
Note this feature won't save every possible program setting, such as the active chart being
displayed, but it will save many things. (See the default [Link] file itself for what
exactly is saved.) Because of this, be warned that manual additions made to [Link]
won’t be preserved if you save on top of it.
Other Formats: This submenu allows loading or saving other formats such as chart lists.
The four commands under this submenu are:
Open Charts in Folder...: This beings up the Windows select folder dialog,
allowing one to select a directory, after which all Astrolog chart files present in it
will be loaded into the program’s chart list. [This does the same as the -id switch.]
Save Chart List...: This saves the time and location of the current chart (or the
list of charts in the chart list if present) to Astrolog’s chart list format. [This does
the same as the -ol switch.]
Save Chart Exchange...: This saves the time and location of the current chart (or
the list of charts in the chart list if present) to the Astrological Exchange Format
(AAF). [This does the same as the -oa switch.]
Save Chart Quick*Chart...: This saves the time and location of the current chart
(or the list of charts in the chart list if present) to the Quick*Chart format. [This
does the same as the -oq switch.]
Export Chart Text Output...: This allows one to save the actual text displayed in a
window for a text chart to a file as simple text. [This does the same as the -os <file>
switch.]
Export Chart Bitmap...: This saves the current graphics display to a Windows bitmap
file. [This does the same as the -Xb switch.]
Export Chart Metafile...: This saves the current graphics display to a Windows metafile
format file. [This does the same as the -XM switch.]
Export Chart PostScript...: This saves the current graphics display to an encapsulated
PostScript file. [This does the same as the -Xp switch.]
Export Chart Wireframe...: This saves a special 3D version of the current graphics
display to a Daedalus 3D wireframe file. [This does the same as the -X3 switch.]
Export As Wallpaper: This submenu allows one to easily set an Astrolog graphics chart
to be the background bitmap for the Windows desktop. This functionality can be done
without this command, in which one can do File Save Bitmap to create a bitmap file, then
go into the Windows control panel desktop settings, and point the wallpaper bitmap to the
file created. However this command allows it do be done with a click of the mouse,
during which a bitmap file called “[Link]” will automatically be created and saved
in your Windows directory. (Note that in modern versions of Windows it may be
necessary to run Astrolog as Administrator in order for the program to have permission to
save the file and change settings in this manner.) The five commands under this submenu
are:
Tile Bitmap: This command centers the Astrolog chart in the middle of the
screen.
Center Bitmap: This command tiles the chart across and down it.
Stretch Bitmap: This command stretches or shrinks both chart dimensions
separately to cover the background dimensions.
Fit Bitmap: This command will stretch or shrink the bitmap to just fit within the
desktop while preserving proportion, so will leave space on the horizontal or
vertical edges if the proportions are different from the background.
Fill Bitmap: This command will stretch or shrink the bitmap to completely fill
the desktop area while preserving proportion, so will crop content on the
horizontal or vertical edges of the bitmap if its proportions are different from the
background. Note the “Fit” and “Fill” commands will only work on Windows 7 or
later, which supports these styles of background.
Open Bitmap: This submenu contains commands which open special bitmaps that can
be used in the program.
 Open Chart Background...: This command opens a bitmap to be displayed as
the background behind graphics and text charts in the program. [This does the
same as the -XI switch.]
Open World Map...: This command opens a bitmap to be used as an alternate
world map in the program’s world map and globe charts. [This does the same as
the -XIW switch.]
Print...: This feature allows one to directly print charts from within the program. This
command brings up the standard Windows Print dialog, with the same look and feel and
options available as when printing from other Windows programs such as Write. The
image printed will be the exact chart that appears in the window. For graphics charts, the
printout will be a one page image of the display, scaled to be as large as possible within
the bounds of the page. The window’s horizontal and vertical scrollbars determine where
in the page the image is situated, e.g. if the vertical scrollbar is all the way to the top, the
image will be at the top of the page, if centered, then it will be vertically centered, and so
on. Note that the colors in the window will usually be the colors on the paper, which
means you probably want to have the “Graphics / Reverse Background” setting active, so
the chart will be on a white background and hence not waste ink. For monochrome
printers you also probably want to have the Graphics Monochrome setting active, to
prevent colors like yellow coming out as a hard to see light gray. For text mode charts,
the printout will be on a white background regardless of what’s in the window. You may
want to turn off the View Colored Text setting if you don't have a color printer. The font
size may be affected by the Graphics Character Scale command settings. For the standard
medium character scale on a 8.5"x11” paper, there will be 70 rows to a page. The text
printout will be more than one page if there are more than 70 rows of output. Note that
even with this feature available, one may still want to use the program’s clipboard and
file features to print from another program. Astrolog’s Print command makes decisions
about layout, font, and so on, for you. Some may find that convenient, but others may
still prefer to import Astrolog output into a word processing or desktop publishing
program to have more control. The graphics generated by printing a chart directly, and
printing a chart bitmap, metafile, or PostScript file, have slightly different textures so one
may prefer one format to another. Still, direct printing is available to those of us who
would like to use it.
Print Setup...: This brings up the standard Windows Print Setup dialog, allowing one to
select settings such as the printer to print to, and whether the printed page will be oriented
in portrait or landscape mode. This dialog is also accessible from the Print dialog itself
via the “Setup...” button, but is also made available separately here.
Exit: This terminates the program. Note that pressing Control+C or “q” will also quit in
addition to this and the command’s “Escape” shortcut key.

Edit menu commands:

Enter Command Line...: This brings up a dialog with one edit control, in which one
may enter a command line. This gives access to obscure program features that don't have
their own menu options yet, as well as easy access to the command switches for those
who work with them. This dialog also has a “Enable AstroExpression Hooks” checkbox,
which can be used to enable, disable, or check the status of that feature area.
Run Macro (Normal Set): This, along with the next three menu items of “Run Macro
(Shift Set)”, “Run Macro (Control Set)”, and “Run Macro (Alt Set)”, are submenus each
of which contain 12 entries of the form “Macro <1-48>“. These run the appropriate
command switch macro. See the -M0 switch for information on how to define a macro.
[This does the same as the -M switch.]
Note that pressing F1 will show documentation and do the same as the “Help /
Open Documentation” command. That’s assuming macro #1 hasn’t been defined
(if macro #1 has been defined, F1 will still invoke that macro). Similarly, pressing
Alt+F4 will follow the Windows standard and close the program (instead of first
displaying an error about macro #40 not being defined, and then closing). If
macro #40 has been defined, Alt+F4 will still only invoke that macro.
Copy Chart Text Output: This is like the File Save Chart Text Output command except
the text will be copied to the Windows clipboard. After doing this one can run or switch
to an application such as Notepad, Write, or Word, and use their Edit Paste command to
paste in the chart text, which may then be printed, combined with other text, and so on.
Next to the Print command, this is the easiest way to print Astrolog charts.
Copy Chart Bitmap: This is like the File Save Chart Bitmap command except the
Windows bitmap will be copied to the clipboard, which may again be pasted into another
application.
Copy Chart Metafile: This is like the File Save Chart Metafile command except the
Windows metafile will be copied to the clipboard. Note that when printing to laser
printers, the Metafile format is recommended over the Bitmap format because its output
is free of any pixel blockiness.
Copy Chart PostScript: This is like the File Save Chart PostScript command except the
PostScript file will be copied to the clipboard as simple text.
Copy Chart Wireframe: This is like the File Save Chart Wireframe command except
the 3D wireframe file will be copied to the clipboard as simple text.
Edit / Paste: This command will load whatever’s on the Windows clipboard into the
program, as if it were a file. If there’s text on the clipboard, then Astrolog will try to
parse it as a command line or a “.as” extension script file. This will also handle the other
file formats Astrolog supports, e.g. if the text starts with “#” then Astrolog will consider
it to be AAF file content. If there’s a bitmap on the clipboard, Astrolog will display it as
the chart background. For example, in your Web browser you can simply right click on
any picture and select “Copy image” or equivalent, and then do Paste in Astrolog to
display it behind the chart.

View menu commands:

Show Graphics: This toggles the current chart display between text and graphics mode.
Text charts are drawn in the window as simple text such as might appear in a command
prompt, while graphics charts are pretty high resolution wheels and the like. [This does
the same as the -X switch.]
Buffer Redraws: This option on the Window Settings submenu toggles whether or not
screen updates are smooth. When off, the screen clears and the chart redraws as you
watch, while when on, the program “pauses” while the update is done behind the scenes
after which the new chart is displayed all at once. Animation mode automatically turns
this setting on to provide flicker free updates.
Redraw Screen: This option on the Window Settings submenu simply redraws the
current screen. Most often this is used to erase any scribbles one may have added with the
mouse buttons.
Clear Screen: This option on the Window Settings submenu simply erases the screen
leaving a blank window, where the next redraw will bring the chart back. This can be
used if one wants to draw on an empty screen.
Hourglass on Redraw: This option on the Window Settings submenu toggles whether or
not the program puts up the hourglass wait cursor while redrawing a chart. I've found it
most natural to have this on normally to know when the program is busy calculating, but
off during animations.
Chart Resizes Window: This option on the Window Settings submenu toggles whether
the window will resize when the chart size increases or decreases. For example, if
displaying a graphic aspect grid which is a square chart, and one switches to the
rectangular shaped astro-graph map chart, this setting when on, will resize the window to
be the new rectangular shape. When off, the chart will either not fill up the whole
window or will overlap its edges, in which case the scrollbars may be used to view all
parts of the graphic. Note that when the window size changes in this way, the program
will automatically move the window’s location appropriately if the new size would make
the window appear partially off the screen edge.
Window Resizes Chart: This option on the Window Settings submenu toggles whether
the chart will resize whenever the window size is increased or decreased. For example,
when displaying the graphic wheel chart, and one manually resizes the window to be
larger, this setting when on, will make the wheel bigger too so its fills the new window.
[Note that the X Windows version of Astrolog always behaves as though this and the
above setting are both on.]
Size Chart to Window: This option on the Window Settings submenu does a one time
resize of the chart to fill the dimensions of the current window. This is only relevant for
graphics charts that don't already have a forced fixed size, and for when the Window
Resizes Chart setting is off.
Size Window to Chart: This option on the Window Settings submenu does a one time
resize of the window to be the dimensions of the current chart. This is only relevant for
graphics charts and for when the Chart Resizes Window setting is off.
Size Window Full Screen: This option on the Window Settings submenu (accessible
with the “Shift+Tab” hotkey) toggles the Astrolog window into or out of full screen
mode. The scrollbars will determine the relative placement of the Astrolog chart within
the screen, if they have different proportions (e.g. scrollbars centered will center the chart
within the screen).
Scroll Page Up, Scroll Page Down, Scroll to Beginning, Scroll to End: These four
commands on the Window Settings submenu allow one to respectively: scroll the
window up as if one clicked above the thumbnail on the vertical scrollbar, scroll the
window down as if one clicked below the thumbnail on the vertical scrollbar, do the same
thing as if one scrolls to the far upper left, and do the same thing as if one scrolls to the
far bottom right. Note that one will generally want to use the keyboard shortcuts for these
commands (the Page Up, Page Down, Home, and End keys) rather then select them from
the menu, but they’re on the menu too just for convenience.
Colored Text: This toggles whether or not the characters in text charts are multi-colored.
Colored text is recommended to have on normally because it looks nice, but should be
turned off when saving text output to file or copying text to the clipboard to remove the
control characters which cause the color changes. [This does the same as the -k switch.]
Set Colors...: This brings up the Set Colors dialog. One may use the various combo
controls to change the colors used in graphics and text charts, by selecting a color from a
dropdown, or by entering its name or abbreviation or index from 0-15. The Standard
Color Palette covers generic uses of color. [The sixteen settings here do the same as the
sixteen settings covered by the -Yk0 and -Yk switches.] The Elements group covers the
colors used for the four elements. [This does the same as the -YkC switch.] The Seven
Rays group covers the colors of the esoteric Rays. [This does the same as the -Yk7
switch.]
Show Interpretations: This toggles whether or not interpretations are given for text
charts. [This does the same as the -I switch.]
Print Nearest Second: This toggles whether or not all zodiac positions are displayed to
the nearest arc second as opposed to just the arc minute. [This does the same as the “0”
part of the -b0 switch.]
Applying Aspects: This toggles whether or not aspect orbs are displayed in the form of
about to happen or just happened, as opposed to degrees narrow or degrees wide. [This
does the same as the “a” part of the -ga and -aa switches.]
Parallel Aspects: This toggles whether or not aspects in the “vertical plane” are used,
with the parallel and contraparallel aspects shown as opposed to conjunction and
opposition. [This does the same as the “p” part of the -gp and -ap switches.]

Info menu commands:

Set Chart Info...: This brings up the generic Enter Chart Info dialog, which is the place
for one to actually create a chart by specifying the time and location in question. The
dialog contains eight main controls, for month, day, year, time, Daylight Saving Time
flag, time zone, longitude, and latitude. These have dropdowns from which one may
optionally choose common values. If the Print Nearest Second command is set, then
times and locations in this dialog will be displayed to the second, instead of just to the
minute. After this are two optional text edit controls where one may enter the name and
location for the chart. The special button “Now” will copy the current time over all the
fields. The special button “Recall” will copy the contents of the last stored chart cast over
the fields. [The eight main combo controls cover the same fields as the -qb switch. The
two text controls cover the same fields as the -zi switch. The “Now” button does the same
as the -n switch. The “Recall” button does the same as using the “-i set” virtual file.]
This dialog also allows access to Astrolog’s atlas, allowing one to easily lookup the
longitude and latitude of cities. Astrolog can also do time zone detection (including
whether Daylight Saving Time is in effect or not) for any date/time at any location in the
world. :) The following four buttons in the dialog allow accessing these features:
Lookup City: This button will look up the current city, as set in the “Location”
field. The 14 best matches will be displayed in the dialog. Afterward, you can
click on the entry in the dialog you want, then click the “Apply Info” button to
apply the coordinates to the chart info. You can specify just a city name, or use a
comma to combine with a country/region name or its two letter abbreviation, to
restrict search to just that region. For USA and Canada, states and provinces may
be specified instead of or in addition to the country. City names will match
substrings, which will be ranked in an appropriate manner. For example, if you
lookup the city “Eden”, the exact match “Eden, NC” will be first, followed by the
subword exact match of “Eden Prairie, MN”, then the substring match at the
beginning/end of a word in “Edenvale, Germany”, and finally the substring in the
middle of a word “Redencao, Brazil”. [This does the same as the -N switch.]
Nearest Cities: This button will display the nearest cities to the current longitude
and latitude coordinates. The 14 nearest will be displayed in the dialog. Again,
you can click on the entry in the dialog you want, then click “Apply Info” to
apply the coordinates to the chart info. [This does the same as the -Nl switch.]
Time Changes: This button will display all time changes for the time zone area
corresponding to the active chart’s city in the “Location” string field. This chart
will display every time change to or from Daylight Time, as well as occasions
when the time zone offset itself for the location changes. This will range from the
first date when the location started using a standard time zone (which will be no
earlier than 1847 when GMT was introduced). The list will run until 2025, or five
years after the chart’s date (whichever is later, but never later than 2080). Time
changes will be printed one per line, listing the date and local time at which the
time changes, along with how the time zone offset changes and how much the
local clock time changes. [This does the same as the -Nz switch.]
Apply Info: This button will update the Time Zone, Daylight Saving, Longitude,
and Latitude fields in the chart appropriately, based on the local time and city
specified in the Time and Location fields. [This does similarly as the -zN switch.]
 Note that some times are ambiguous, for which it is not possible to determine
whether or not Daylight Saving Time is in effect. For example, in Seattle clocks
“fall back” one hour on Nov 6, 2022, in which 1:59am Daylight Time is followed
by 1:00am Standard Time. If you say you’re born at “1:30am” local time on that
day, it’s unknown whether that means 1:30am Daylight Time, or 1:30am Standard
Time an hour later. Astrolog will display a warning in such a situation. A similar
warning will be displayed if you say you were born during the one hour gap
during which clocks “spring ahead”, which is an invalid time that never appears
on clocks because it gets skipped.
Chart For Now: This sets the current chart information to the current time now. When in
a relationship comparison bi-wheel mode, this command will instead set the second or
transiting chart slot to the current moment. [This does the same as the -n switch.]
Default Chart Info...: This brings up the Default Chart Info dialog, in which one may
specify the default Daylight setting, time zone, the correction factor to add to “now”
charts, longitude, latitude, elevation above sea level, temperature (for atmospheric
refraction), and name and location strings. These settings are used in commands such as
“Chart For Now”, in which the current time obtained needs to be combined with some
location to make a complete chart. [The nine controls in this dialog correspond
respectively to the -z0, -z, -Yz, the two parameters passed to the -zl, the -zv, -zf, and the
two parameters passed to the -zj switches.]
Set Chart #2 Info...: This brings up a dialog identical to the standard Chart Info dialog,
except here the chart settings specified are put into the “second” chart slot, as used in
relationship charts. This command is to “Set Chart Info”, as the “Open Chart #2”
command is to “Open Chart”. [This does the same as the -i2 switch.]
Charts #3 through #6...: This brings up a dialog giving one access to all six chart slots,
with buttons which will bring up the file open dialogs to load chart info into each slot,
and buttons allowing access to the chart info dialogs to view or change the info in each
slot. This dialog also has a radio button group to indicate what type of wheel and how
many chart rings to display: a single wheel, bi-wheel, tri-wheel, quad-wheel, quin-wheel,
or hexa-wheel. This dialog will also display the chart information for all six chart slots
within the dialog to the right of the buttons, which makes it easy to see the contents of all
chart slots together without having to bring up a hexa-wheel. [This covers the same as the
-r3 through -r6 switches, and the -i3 through -i6 switches.]
Chart List: This submenu allows working with Astrolog’s chart list, which means being
able to store an arbitrary length list of sets of chart information. (This list is separate from
Astrolog’s standard chart slots which are used to display wheels, bi-wheels, and so on.)
Once loaded into the program, a chart list can be inspected, edited, displayed, and more.
The five commands here are:
Chart List...: This brings up a dialog showing the current chart list. In this dialog,
one can see the list of sets of chart information, and the number of entries in the
list. One may select a chart and click OK to copy that chart list entry into
Astrolog’s chart slot #1 and display it. One may also select a chart slot, and use
 the “Set To Slot” button to copy the chart list entry to that slot, or use the “Copy
From” button to append the chart information in that slot to the end of the chart
list (which will do nothing if the charts are the same, to prevent duplicates). One
can also select a chart slot, and use the “Edit Chart” button to view and change the
information using the “Set Chart Info” dialog, or use the “Delete Chart” button to
delete it from the chart list. The “Delete All” button will empty the entire chart
list, such that the list size will be 0. Note that opening chart list files will not
delete the existing chart list first (to allow one to append lists together) so deleting
the list is necessary if one wants to start from a clean slate. Finally, the “Sort By”
and “Filtering” sections allow one to sort the list, or filter the list to only display
certain charts. [Deleting the chart list does the same as the -50 switch. Sorting
does the same as the -5d, -5x, -5y, -5n, and -5l switches. Filtering does the same
as the -5f switch.]
One can easily display the different charts in the chart list with the other
commands on this submenu. The “Previous Chart” and “Next Chart” commands
(accessible via the Shift+Up and Shift+Down hotkeys) will display the previous
or next chart in the list, which means the appropriate chart from the chart list will
be copied into main chart slot #1, and be displayed in the wheel or other chart
context. (The program will remember the index of the most recent chart list entry
displayed.) Also, the “First Chart” and “Last Chart” menu commands (accessible
via the Ctrl+Up and Ctrl+Down hotkeys) will jump to showing the first or last
charts in the chart list.
No Relationship Chart: This and the remaining eight commands on the Info menu
specify the current relationship chart mode if any, where the currently active mode has a
check mark by it. This first command turns any relationship mode off, where just a single
chart is shown, with any “second” chart ignored. [This does the same as the -r switch
when invoked as _r.]
Comparison Chart: This sets the relationship chart mode to dual comparison, where two
charts are shown side by side, e.g. the wheel chart becomes a bi-wheel, and aspect grids
are between two sets of planets. [This does the same as the -r0 switch, except it uses the
two charts already in memory as opposed to reading them from file.]
Synastry Chart: This does a synastry chart, a single chart consisting of the second
chart’s planets in the first chart’s houses. [This does the same as the -r switch.]
Composite Chart: This does a composite chart, a single chart consisting of all the
midpoints between each object pair in the two charts. [This does the same as the -rc
switch.]
Time Space Midpoint Chart: This does a midpoint relationship chart, a single chart cast
at the time and location half way between those of the two charts. In other words, this
replaces chart #1 with the midpoint of chart #1 and #2. The original contents of chart #1
are stored in the “recall” chart slot, and will be restored upon exiting this relationship
mode. After exiting this mode, the “recall” chart slot will contain the information for the
midpoint chart. [This does the same as the -rm switch.]
Date Difference Chart: This displays the span of time between the two charts, given in
all units from the nearest second to the nearest year. [This does the same as the -rd
switch.]
Biorhythm Chart: This displays a biorhythm chart, for a person born at the time in the
earlier of the two charts, for the time in the other chart. [This does the same as the -rb
switch.]
Transit and Natal: This sets a mode identical to “Comparison Chart” above except that
the transit restrictions will apply to the second chart and the natal restrictions to the first,
instead of the natal restriction set to both. [This does the same as the -rt switch.]
Progressed and Natal: This sets a mode like “Transit And Natal” above, except that the
second chart actually shown (outer ring in wheel charts) will be a chart made by
progressing the first chart to the time in the second. [This does the same as the -rp
switch.]

Setting menu commands:

Sidereal Zodiac: This toggles whether or not the chart is cast with respect to the sidereal
zodiac as opposed to the tropical. [This does the same as the -s switch.]
Heliocentric: This toggles whether or not the chart is cast with respect to the Sun for a
heliocentric chart, as opposed to the Earth in a standard geocentric chart. [This does the
same as the -h switch toggling between Sun and Earth centered charts.]
House System: This submenu allows one to select among 23 systems of house division
to use. [This does the same as the -c switch.]
House Settings: This submenu allows one to toggle various settings related to houses.
The eight commands here are:
Solar Chart: This option toggles whether or not the houses are rotated to put the
Sun on the Ascendant for a solar chart. Note that a check mark will be by this
command when the houses are rotated any amount, even if the focus object isn’t
the Sun and the position being rotated to isn’t the Ascendant. [This does the same
as the -1 switch.]
3D Houses: This option toggles whether house placements are determined by 3D
zodiac position and latitude coordinates, instead of just a simple placement of
zodiac position between house cusps. [This does the same as the -c3 switch.]
Show Decans: This option toggles whether or not the planet positions are
adjusted to put each object in the sign corresponding to its decan. [This does the
same as the -3 switch.]
Show Dwads: This option toggles whether or not the planet positions are adjusted
to put each object in the sign corresponding to its dwad. [This does the same as
the -4 switch.]
 Flip Signs With Houses: This option toggles whether or not planet and house
positions are swapped with respect to each other for a Domal chart. [This does the
same as the -f switch.]
Geodetic Houses: This option toggles whether or not house cusps are only
computed based on the chart’s longitude for geodetic houses. [This does the same
as the -G switch.]
Indian Wheel Display: This option toggles whether wheel charts are displayed in
Indian format or not. [This does the same as the -J switch.]
Show Navamsas: This option toggles whether or not the planet positions are
adjusted to generate a Navamsa chart. [This does the same as the -9 switch.]
Aspect Settings...: This brings up the Aspect Settings dialog, allowing one to set various
things related to each aspect. For each of the 24 aspects, there is: (1) A checkbox for
whether the aspect is to be included in charts at all, (2) an edit control specifying the
aspect’s maximum orb, (3) an edit control specifying the aspect’s actual angle, (4) an edit
control specifying the aspect’s relative power for influence charts, and (5) an control
specifying the color to use when displaying the aspect. In addition there are three buttons:
(1) “Restrict All” which automatically checks all aspects, (2) “Unrestrict All” which
unchecks them all, and (3) “Toggle Majors” which inverts the status of the first five
aspects. [The checkboxes do the same as the -A and -RA switches. The orb fields do the
same as the -Ao or -YAo switches. The angle fields do the same as the -Aa switch. The
influence fields do the same as the -YjA switch. The color fields do the same as the -YkA
switch.]
Object Settings...: This brings up the Object Settings dialog, allowing one to set various
things related to each planet. For each of the first 20 objects, there is: (1) an edit control
specifying the maximum aspect orb allowed to that object, e.g. no more than a two degree
orb to the North Node, (2) an edit control specifying an aspect orb addition allowed, e.g.
widen all orbs by one degree for the Sun, (3) an edit control specifying the object’s
relative power for influence charts, and (4) an edit control specifying the color to use
when displaying the object, which also allows selecting “Element” or “Ray” to become
the colors of the element of the sign that the planet rules, or the Ray associated with the
sign. [The max orb fields do the same as the -Am or -YAm switches. The orb addition
fields do the same as the -Ad or -YAd switches. The influence fields do the same as the -
Yj switch. The color fields do the same as the -YkO switch.]
More Object Settings...: This brings up a dialog much like the Object Settings dialog
above, except this dialog is for the house cusp and Uranian objects. Like the standard
Object Settings dialog which is for the first 20 objects, this dialog allows one to set the
maximum aspect orb allowed to, the orb addition factor for aspects concerning, and the
power influence value of, each cusp and Uranian object. This dialog also has an field
labelled “All Stars”, which applies to all fixed star objects equally. The default color to
use for all stars is the virtual color "Star", which means use orange for stars brighter than
magnitude 1.0, and dark red for dimmer stars.
Restrictions...: This brings up the Object Restrictions dialog, allowing one to specify
whether each planet or other object is included in charts, where each object has a
checkbox, with checked meaning restricted. In addition there are several buttons added
for convenience: (1) “Restrict All” which automatically checks all objects, (2) “Unrestrict
All” which unchecks them all, (3) “Toggle Minors” which inverts the state of the
asteroids and all the other objects in the second set of ten, (4) “Toggle Cusps” which
inverts the state of the 12 cusp objects, (5) “Toggle Uran.” which inverts the eight
Uranian planets, and (6) “Copy From Transit Restriction Set” which sets all items to be
the state of those in the parallel transit restriction set. [This dialog does the same as
passing values to the -R switch. The “Restrict All”, “Unrestrict All”, “Toggle Cusps”,
and “Toggle Uran.” buttons do the same as the -R0, -R1, -RC and -Ru switches
respectively.]
Star Restrictions...: This brings up the Star Restrictions dialog, which is similar to the
standard Restrictions dialog except it deals with the fixed star or other deep space objects.
Each of the 50 fixed stars has a checkbox, where in addition there are two buttons: (1)
“Restrict All” which automatically checks all the star objects, and (2) “Unrestrict All”
which unchecks them all. [The “Restrict All” and “Unrestrict All” buttons do the same as
the -RU0 and -RU1 switches.]
Transit Restrictions...: This brings up the Transit Restrictions dialog, which is identical
the standard Restrictions dialog in every way except it sets the status of the objects in the
transit restrictions array, as used in transit charts. The “Copy From Standard Restriction
Set” button here copies all flags from the standard restriction set. [The various operations
here do the same as the -RT switch and derivatives.]
Planetary Moons: This submenu contains several commands for working with moons of
other planets. The six commands here are:
Moons Chart: This sets the current chart displayed to be a table showing all
planetary moon positions (both relative to Earth, and relative to the planet being
orbited) and aspects involving moons (again relative to Earth and/or relative to the
planet being orbited). [This does the same as the -8 switch.]
Moon Restrictions...: This command is similar to the “Restrictions” and “Star
Restrictions” commands, and will bring up a dialog allowing one to individually
restrict or include each of the moons related objects. The dialog has buttons to
toggle the status of each planet’s moons separately, so it’s easy to focus on (for
example) just Saturn’s moons if wanted.
Moon Object Settings...: This brings up a dialog allowing one to individually set
the maximum orb, orb addition offset, influence power number, and color of each
moon object. The default for planetary moons is a two degree orb, the same as
fixed stars. Note the default virtual color “Planet”, which means to use the same
color as the planet the moon orbits, but darkened slightly (e.g. use maroon for the
moon’s color, if the planet the moon orbits is set to be red). This dialog also has a
checkbox “Make Moons Orbit Current Central Object” which accesses the -Ym
 switch setting, and a checkbox “Wheel Charts Show Moons Orbiting Planet”
which accesses the -X8 switch setting.
Include Moons: This toggles whether or not the planetary moons objects are
included in charts. [This does the same as the -u8 switch.]
Include Body Centers: This toggles whether or not the planetary center of body
(COB) objects are included in charts. [This does the same as the -ub switch.]
Object Customization...: This brings up a dialog allowing one to customize 50
different objects. This includes all objects in the Uranians, Dwarfs, and planetary
moons object categories. For each object slot, one can rename it, and change its
definition. Definitions are a number or an Astrolog object name, with optional
prefix and/or suffix letters after a space. For numbers, no prefix means a minor
planet or asteroid with its own ephemeris file (e.g. “5” for asteroid “5 Astraea”),
the prefix “h” means a hypothetical planet from [Link] (e.g. “h9” for Isis-
Transpluto), and the prefix “m” means a planetary moon (e.g. “m501” for
Jupiter’s moon Io). For the Windows version, the prefix “j” means calculate the
object using a Web query to the JPL Horizons Web site. [These options do the
same as the -Yeb, -Ye, -Yem, and -Yej switches.] If a suffix is present in the
definition, the characters “n”, “s”, “p”, and “a” will (instead of the object’s
position) compute the position of its north node, south node, perihelion point, or
aphelion point along its orbit. Also, the suffix characters “H”, “S”, “B”, “N”, “T”,
and “V” will toggle the heliocentric setting (-h switch), sidereal zodiac setting (-s
switch), barycenter setting (-Yh switch), true node setting (-Yn switch), true
positions setting (-YT switch), and topocentric positions setting (-YV switch) for
just this object (which is useful if you want to for example include heliocentric
nodes in a geocentric chart).
The “Lookup Names” button in this dialog will take any name slots that
are blank, and fill them out with a name based on the slot’s definition.
This button is useful if you want to verify that (for example) minor planet
#1234 in Swiss Ephemeris file se01234s.se1 is actually going to compute
the asteroid “Elyna” and not some other body.
Star Customization...: This brings up a dialog allowing one to customize 50
different star objects. In it, star object slots can be renamed, and their definition
changed to a new star. Star definitions are designations as given in the [Link]
Swiss Ephemeris text file, and as passed to the -YU command switch. This dialog
is very similar to the Object Customization dialog, which also allows adjusting
the contents of 50 Astrolog object slots. Any customizations made in this dialog
or with the -YU switch will be saved to a section in the [Link] default settings
file, as created with the -od switch or with the “Save Program Settings”
command.
Include Minors: This toggles whether or not the asteroids and other minor objects are
included in charts. [This does the same as the -R switch when invoked without any
parameters.]
Include Cusps: This toggles whether or not house cusps are included as objects in charts
such as aspect grids and transit searches. [This does the same as the -C switch.]
Include Uranians: This toggles whether or not the Uranian or transneptunian category
objects are included in charts. [This does the same as the -u switch.]
Include Dwarfs: This toggles whether or not the Dwarf planet category objects are
included in charts. [This does the same as the -u0 switch.]
Include Fixed Stars: This toggles whether or not star objects are included in charts.
[This does the same as the -U switch.]
Calculation Settings...: This brings up the Calculation Settings dialog, used to set
various settings which affect zodiac positions of objects. They are:
(1) A dropdown for the calculation method, which (depending on what’s been
compiled into the program) will allow one to calculate planet positions by up to
seven different methods: Swiss Ephemeris, slightly less accurate Moshier
ephemeris, more accurate but much larger JPL ephemeris, old and less accurate
Placalc ephemeris, very old and much less accurate Matrix formulas, most
accurate but slow JPL Horizons Web query, or None [same as -b, -bs, -bj, -bp, -
bm, and -bJ switches]. The “Swiss Ephemeris” selections will show which
version of Swiss Ephemeris is being used. When “None” is selected most objects
will be placed at 0Aries, which of course isn’t useful except for obscure testing
scenarios.
(2) An edit control to specify the zodiac degree offset or ayanamsa to be used for
the sidereal zodiac [same as the parameter passed to the -s switch]. This control
has a dropdown to allow quick selection of several common systems of sidereal
astrology. The values in it are 0.0 for Fagan-Bradley, 0.883208 (or 0 degrees 53'
and 0”) for Nirmala Chandra Lahiri [Robert Hand version], 0.98006 (or 0 degrees
58' and 48”) for Krishnamurti, 2.329509 (or 2 degrees 19' and 46”) for B.V.
Raman, and -3.619379 (or -3 degrees 37’ and 9”) for Djwhal Khul. Also available
are Deluce, Usha-Shasi, Yukteshwar, J.N. Bhasin, and Galactic Center (in which
the Galactic Center is at 0Sag).
(3) A dropdown for the house system to use (which is equivalent to the Setting /
House System submenu, but also contains additional experimental systems) [same
as -c switch].
(4) The central planet, e.g. geocentric, heliocentric, or some other planet [same as
the parameter passed to the -h switch].
(5) The harmonic chart factor [same as -x switch].
(6) The dwad nesting level [same as -4 switch].
(7) A checkbox indicating whether to display planetary latitude positions relative
to Earth’s equator, as opposed to the ecliptic [same as -sr0 switch].
(8) A checkbox indicating whether to display planetary longitude positions
relative to Earth’s equator, as opposed to the ecliptic as is standard in astrology
[same as -sr switch].
(9) A checkbox indicating whether true instead of apparent positions are shown
[same as the -YT switch].
 (10) A checkbox indicating whether topocentric positions relative to one’s
position on the surface of the Earth are shown [same as -YV switch].
(11) A checkbox indicating whether the Sun object computes the barycenter of the
solar system instead of the physical Sun [same as -Yh switch].
(12) A checkbox indicating whether the North Node, South Node, and Lilith
objects are the true or mean versions [same as -Yn switch].
(13) A checkbox indicating whether the four angular cusp objects are set to the
positions of the actual house as defined by the current house system [same as -Yc
switch].
(14) A checkbox indicating whether atmospheric refraction should be applied to
local horizon positions [same as -Yf switch].
(15) A checkbox indicating whether sidereal zodiac positions are relative to the
invariable plane of the solar system instead of the ecliptic [same as -Ys switch].
(16) A checkbox indicating whether to not apply tropical nutation to charts [same
as -Yn0 switch].
(17) A checkbox indicating whether 3D houses are active, in which house
position determination takes into account planetary latitude [same as -c3 switch].
(18) A checkbox indicating whether 3D aspects are active, in which aspect angle
determination takes into account planetary latitude [same as -A3 switch].
(19) A checkbox indicating whether 3D orbs are active, in which aspect orbs are
applied to planetary latitude as well as longitude [same as -Ap switch].
(20) A radio button group specifying the 3D house model to use when 3D houses
are active: Have 3D houses arranged along the plane of the prime vertical, local
horizon, or celestial equator [same as the parameter to the -c3 switch].
(21) A radio button group specifying the solar chart setting, i.e. whether to rotate
the house cusps so an object is on the Ascendant or on the Midheaven, and an edit
control specifying which object to use when active [all this does the same as the -
1 and -2 switches].
(22) A checkbox in the solar chart group above indicating whether the Ascendant
or Midheaven should be rotated to the start of the object’s sign [same as -10 and -
20 switches].
Display Settings...: This brings up the Display Settings dialog, used to set various
settings that affect cosmetic changes in chart displays. They are:
(1) A checkbox indicating whether to round positions to the nearest unit instead of
crop [same as -Yr switch].
(2) A checkbox indicating the date display format [same as -Yd switch].
(3) A checkbox indicating the time display format [same as -Yt switch].
(4) A checkbox indicating the distance display format [same as -Yv switch].
(5) A checkbox indicating whether minor or equivalent aspects to house cusp
objects are dropped [same as -YC switch].
(6) The number of aspects to include in charts [same as the -A switch].
(7) An edit control indicating the “reverse restriction”, or a required object that
must be present in charts involving aspects between planets [same as -RO switch].
(8) Whether to detect eclipses and occultations and display eclipse information in
charts [same as -Yu switch].
 (9) Whether eclipse detection only checks for an eclipse visible from your
location, or checks whether there’s an eclipse taking place anywhere on the planet
[same as -Yu0 switch].
(10) Four checkboxes to control whether the events of rising, zenith transit,
setting, and nadir transit appear in the rising and setting chart [same as -YRZ
switch].
(11) The number of text columns to use in interpretation paragraphs [same as the
parameter passed to the -I switch].
(12) A checkbox indicating whether to leave off the rightmost characters of text
chart rows if they exceed the text columns setting [same as -Y8 switch].
(13) A checkbox indicating whether to export text and print in an intuitive manner
[same as -YO switch].
(14) A checkbox indicating whether to export text files in HTML format [same as
-kh switch].
(15) A checkbox indicating whether to output chart info files in the old non-
command switch format used before version 4.20 [same as -Yo switch].
(16) A checkbox indicating whether the screen as well as metafile and PostScript
graphics files should use system as opposed to simulated fonts for glyphs and
other characters [same as -YXf switch].
(17) Two edit controls specifying the horizontal and vertical paper size in inches
to use in PostScript charts [same as -YXp0 switch]. Sizes may be specified in
inches or centimeters. If the parameter ends in “cm” then it will be parsed as
centimeters, and if it ends in “in” then it will be parsed as inches. If there’s no
units, then it will be parsed based on the distance display format setting above.
(18) A radio button group indicating how to orient the paper for PostScript charts
[same as -YXp switch].
(19) A radio button group specifying how to display zodiac positions, i.e. in the
standard degree/sign/minute notation, in hours/minutes, or just degrees [these
items correspond to the -sz, -sh, and -sd switches].
(20) A radio button group specifying what encoding to process text characters
using [same as -Ya switch].
(21) Five checkboxes to control whether standard rulerships, esoteric rulerships,
Hierarchical rulerships, exaltations, and Ray rulerships should appear in charts
[same as -YR7 switch].
(22) A radio button group specifying the aspect orb type (positive/negative,
applying/separating, or waxing/waning) [same as -ga and -gx subswitches].
(23) A checkbox indicating whether aspects measure along the distance axis, and
whether vertical aspects consider more than Parallel and Contraparallel [same as -
gd and -ad subswitches].

Chart menu commands:

Standard Radix: This sets the current chart displayed to be the standard default radix or
natal chart, i.e. a standard list of positions in text mode and a wheel (or bi-wheel in
comparison relationship mode) chart in graphics mode. [This does the same as the -v
switch.]
House Wheel: This sets the current chart displayed to be a house emphasized wheel
chart, i.e. a simple text wheel chart divided by houses in text mode, and a wheel chart
where all the houses are made to be the same size in graphics mode. [This does the same
as the -w switch.]
Aspect Midpoint Grid: This sets the current chart displayed to be a grid showing all
aspects and all midpoints between each pair of planets. It will show either aspects or
midpoints in comparison relationship mode. [This does the same as the -g switch.]
Aspect List: This sets the current display to be a list of all aspects sorted by influence,
and is a text mode only chart. [This does the same as the -a switch.]
Midpoint List: This sets the current display to be a list of all midpoints sorted by zodiac
position, and is a text mode only chart. [This does the same as the -m switch.]
Local Horizon: This sets the current display to show all the planets and other objects as
they appear relative to the local horizon or sky, i.e. a list of altitude and azimuth values in
text mode, and a visual coordinate plot in graphics mode. [This does the same as the -Z
switch.]
Solar System Orbit: This sets the current display to show the orbital positions of all the
planets, i.e. a list of the x, y, and z coordinates of each object relative to the sun (or
current central body) in text mode, and an aerial view of all the planets in their orbits in
graphics mode. 0Ari is at the left of the screen, and 0Can is at the bottom. [This does the
same as the -S switch.]
Gauquelin Sectors: This sets the current display to show all the planets as situated in the
36 Gauquelin sectors, along with their plus zone status, i.e. a list of objects and locations
in text mode, and a sector wheel in graphics mode. [This does the same as the -l switch.]
Calendar: This sets the current display to be a simple calendar of the month or year
surrounding the time of the chart in question. [This does the same as the -K switch.]
Influence: In text mode, this sets the current display to be a list of the influence or power
of each planet with respect to its positioning and aspects. In graphics mode, this shows
dispositor graphs of the main planets for their sign and house placements. [This does the
same as the -j switch.]
Esoteric: This sets the current display to be an Esoteric Astrology chart. In text mode this
lists the planets and the Rays and rulers associated with each planet’s position, and also
lists the Rays and their influence in the chart. In graphics mode this shows what amounts
to a Ray ephemeris, plotting Ray influence vs. time for each of the seven Rays. [This
does the same as the -7 switch.]
Astro-Graph: This sets the current display to be an astro-graph chart, showing where on
the world each planet was rising, on the Midheaven, etc. In text mode this lists the
latitude and longitude of each line at various intervals, and in graphics mode actually
draws and labels each line on a map of the world. [This does the same as the -L switch.]
Ephemeris: This sets the current display to be an ephemeris chart, i.e. a list of the zodiac
positions of each planet over a range of days (e.g. the month or year) surrounding the
time of the chart in question for text mode, and a plot of position vs. time for each object
in graphics mode. [This does the same as the -E switch.]
Arabic Parts: This sets the current display to be a list of the positions of all Arabian part
items for the given time, and is a text mode only chart. [This does the same as the -P
switch.]
Rising and Setting: This sets the current display to be a list of the times during the day
any planet rises, sets, and crosses the meridian and nadir. This is a text mode only chart.
[This does the same as the -Zd switch.]
Nearest Cities: This sets the current display to be a list of the nearest cities to the chart
location in text mode, or will draw a map of the local area of the world labeling visible
cities in graphics mode. [This does the same as the -Nl switch.]
Transits...: This brings up the Transits dialog, used to create various transit lists. The
first thing to do when using this dialog is to set the type of chart desired in the “transit
type” radio button group. The five choices here are:
(1) “Transit to transit times”, which will display exact times of aspects and other
events such as sign and direction changes over a range of time [same as -d
switch].
(2) “Transit to transit influence”, which will display all aspects between objects in
the current chart ordered by significance [same as -D switch].
(3) “Transit to transit graph”, which will for each aspect show a graph of its orb
strength over a range of time [same as -B switch].
(4) “Transit to natal times”, which will display exact times of aspects made to
natal planets from transiting planets over a range of time [same as -t switch].
(5) “Transit to natal influence”, which will display all aspects between transiting
and natal objects for a given time ordered by significance [same as -T switch].
(6) “Transit to natal graph”, which will for each transit to natal aspect show a
graph of its orb strength over a range of time [same as -V switch].
(7) “None”, which gets out of any transit chart mode.
The second thing to do is to be aware of the “progress instead of transit”
checkbox; when checked, all the transit charts will instead be progressed charts,
i.e. the transit types will be:
(1) Progressed to progressed times [same as -dp switch].
(2) Progressed to progressed influence [same as -D combined with -p].
(3) Progressed to progressed graph [same as -Bp switch].
(4) Progressed to natal times [same as -tp switch].
(5) Progressed to natal influence [same as -Tp switch].
(6) Progressed to natal graph [same as -Vp switch].
Now, for the “transit to natal” charts, you should set the values in the “transit to
natal info” combo control group (these controls are ignored for the transit to
 transit charts). There are controls for “month”, “day”, “year”, and “time” like
those in the Chart Info dialog, which here set the time for the transiting chart (the
natal chart settings should of course be set in Chart Info). Pressing the “Now”
button in the dialog will set these time values to be that of the current moment. In
addition, for the “transit to transit/natal times” and “transit to transit/natal graph”
charts, you should select from the “times and graph cover” radio button group
appropriately (these controls are ignored for the transit influence charts). In this
group one may choose to scan over a single day, a month, year, or range of years
for aspects, where the time in question is that surrounding the natal chart set in the
Chart Info dialog for “transit to transit times/graph”, and is the time surrounding
that in the “do transits for” group in this dialog for “transit to natal times/graph”.
You should note here that (1) when the “range of years” radio button is selected,
the number of years to scan over may entered in the “years to span” edit control
(with this setting being ignored otherwise), (2) the shortest period “transit to natal
times” may be done for is a single month, meaning that even if you select the
“given day” radio button in combination with this chart you'll get the “given
month”, and (3) that some of the time settings in the “do transits for” group are
effectively ignored when doing “transit to natal times” over a large range, e.g.
when doing the “given year”, the values in the “month”, “day”, and “time”
controls don't affect the chart any.
Other fields in this dialog are:
(1) Two checkboxes indicating whether to include sign and direction change
events in “transit to transit times” searches [same as -YR0 switch].
(2) Two checkboxes indicating whether to include latitude direction changes
events, and distance direction changes events (e.g. apogee and perigee points) in
“transit to transit times” searches [same as -YR1 switch].
(3) A checkbox named “display transit returns only”, will when checked affect the
“transit to natal search” chart so that it only shows returns, and affect the “transit
to natal influence” chart so that it only shows aspects between a transiting planet
and the same natal planet [same as the -tr, -Tr, and -Vr switches].
(4) A checkbox named “graphs include all planets” affects the “transit to transit
graph” and “transit to natal graph” charts, and causes them to not autorestrict
certain fast moving planets [same as the -B0 and -V0 subswitches].
(5) Also for the two “times” charts, you can change the value in the “searching
divisions” edit control, which determines at how narrow intervals to cast charts
for, with higher values giving more accurate times but taking longer to compute
[this is the same as the optional parameter passed to the -d switch].
Progressions...: This brings up the Progressions dialog, which as its name suggests
allows one to do various forms of progressed charts. The first thing to do when using this
dialog is to set the “Do Progression” checkbox appropriately [same as -p switch]. When
checked, all standard charts Astrolog calculates will be progressed. When clear, all charts
will be normal which means the rest of the settings in the dialog are ignored.
Assuming progressions are being done, you then want to set the values in the
“Progressed Chart Info” combo control group. There are controls for “Month”,
 “Day”, “Year”, and “Time” like those in the Chart Info dialog, which here set the
time to progress the natal chart to (the natal chart being of course set in Set Chart
Info). Pressing the “Now” button in the dialog will set these time values to be the
current moment.
Next, you may set the values in the “Progression Type” control group to define
the type of progression to do. There is a radio button group which one may use to
select between “Secondary (Calculated Cusps)”, “Secondary (Solar Arc Cusps)”
[same as -p1 switch], or “Solar Arc” [same as -p0 switch]. Also there is a
“Degrees Per Day” combo control which one may use to set the progression speed
[same as -pd switch]. A number may be typed in, or one of several common
values for this setting may be selected from the dropdown: The number
365.24219 here gives the standard “year for a day” secondary progression rate,
the number 131487.1884 does primary directions or a year per four minutes,
while other values will do tertiary progressions. Finally there is a “Cusp Move
Ratio” field to define the slowness factor to apply to progressed house cusps
[same as -pC switch].
Chart Settings...: The brings up the Chart Setting Details dialog, which defines various
minor settings that go with and affect the various displays. They are:
(1) A checkbox indicating whether to display planet velocity values relative to
average speed in the text mode standard chart list [same as -v0 switch].
(2) A dropdown for how to subdivide signs (e.g. with decans or terms) in wheel
charts and the standard listing [same as -v3 switch].
(3) An edit control specifying the number of text rows to have in each house for
the text mode wheel chart [same as the parameter passed to the -w switch].
(4) A checkbox indicating whether the text house wheel chart lists objects in
Western houses four through nine in reverse order [same as -w0 switch].
(5) A checkbox indicating whether the text aspect grid lists all aspect
configurations (e.g. Grand Trines) after the grid [same as -g0 switch].
(6) A checkbox indicating whether the relationship aspect grid shows midpoints
instead of aspects [same as -gm switch].
(7) A checkbox indicating whether the text aspect list also gives a summary of the
number of aspects of each type and to each planet [same as -a0 switch].
(8) A checkbox indicating whether the text midpoint list also gives a summary of
the number of midpoints in each zodiac sign [same as -m0 switch].
(9) A checkbox indicating whether the text midpoint list also for each midpoint
gives a sublist of each aspect from a planet to it [same as -ma switch].
(10) A checkbox indicating whether the local horizon chart is displayed with
respect to the poles, where in text mode the positions are given in prime vertical
coordinates, and in graphics mode centers the display around a view looking
straight up as opposed to at the horizon [same as -Z0 switch].
(11) A checkbox indicating whether the Gauquelin sector chart is computed as a
fast approximation based on Placidus cusps [same as -l0 switch].
(12) A checkbox indicating whether the text calendar chart is for the entire year as
opposed to just the month surrounding the time in the current chart.
 (13) A checkbox indicating whether the text influence chart also lists the
influence of each sign in the chart after the influences of all the planets [same as -
j0 switch].
(14) An edit control specifying the degree interval at which longitude and latitude
coordinates are given for the curved Ascendant and Descendant lines in the text
astro-graph chart [same as the parameter passed to the -L switch].
(15) A checkbox indicating whether the text astro-graph chart also lists all latitude
crossings between lines [same as -L0 switch].
(16) A checkbox indicating whether the ephemeris chart is for the entire year as
opposed to just the month surrounding the time in the current chart.
(17) An edit control specifying the number of Arabian parts to include in the
Arabic part chart [same as the parameter passed to the -P switch].
(18) A checkbox indicating whether to display the formulas for the parts in the
Arabic part chart in A+C-B as opposed to A-B+C form [same as -P0 switch].
(19) An edit control specifying the number of days covered by biorhythm charts
[same as -Yb command switch].
(20) A radio button group which determines in what order to sort the fixed star
objects for charts such as the standard text listing [same as the letter if any
included with the -U switch].
(21) A radio button group which determines in what order to sort the parts in the
Arabic part chart [same as the letter if any included with the -P switch].
(22) A dropdown for what method to sort the aspect list chart by [ same as
subswitches passed to the -a switch].

Graphics menu commands:

Draw Chart Sphere: This sets the current chart displayed to be a chart sphere, which is
like a standard chart wheel but in 3D. [This does the same as the -XX switch.]
Draw World Map: This sets the current chart displayed to be a map of the world
displayed in rectangular form, including plotting the zenith locations of planets and other
astro-graph lines. [This does the same as the -XW switch.]
Draw Globe: This sets the current display to be the map of the world shown as the side
view of a globe, which effectively makes it a 3D astro-graph chart. Note that this chart
looks nice in animation mode because it rotates! [This does the same as the -XG switch.]
Draw Polar Globe: This sets the current display to be the map of the world shown in
polar projection with the North (or South) pole in the center. [This does the same as the -
XP switch.]
Draw Telescope: This sets the current display to be a telescope view of a part of the sky,
which may be focused upon a particular planet. [This does the same as the -XZ switch.]
Reverse Background: This toggles whether or not graphics charts are displayed black on
a white background as opposed to the standard white on a black background. This setting
affects text mode charts in addition to graphics charts, and allows text charts to be
displayed on a white background if one prefers. [This does the same as the -Xr switch.]
Monochrome: This toggles whether or not graphics charts are displayed in just black and
white monochrome mode as opposed to in the standard selection of 16 VGA colors. [This
does the same as the -Xm switch.]
Square Screen: This resizes both the graphics chart and the window to be square shaped,
and is useful for charts such as the wheel or globes if they ever appear oblong and not
circular shaped as they should. For wheel charts with sidebars it will logically make it so
just the wheel part becomes square.
Character Scale: This submenu allows one to set the size of the glyphs in graphics
charts. For text mode charts, this setting will affect the font size of the characters. There
are four options on this menu of “Small”, “Medium”, “Large”, and “Huge”, with medium
being the default. There are two more options on this menu labeled “Decrease” and
“Increase”, which will move the setting down or up a notch (if not already at an extreme).
[For graphics these settings correspond to the four percentage values that may be passed
to the -Xs switch.]
Chart Effects: This submenu allows one to toggle various settings which determine
whether things are displayed on the almost all graphics charts. The six commands here
are:
Show Border: This toggles whether or not graphics charts are displayed with
borders around them. [This does the same as the -Xu switch.]
Show Chart Info: This toggles whether or not graphics displays have the time
and location of the chart in question printed at their base. [This does the same as
the -Xt switch.]
Show Info Sidebar: This toggles whether or not wheel charts are displayed with
an information sidebar to their right, listing the positions of the houses and objects
along with element table summaries. [This does the same as the -v0 switch.]
Thicker Lines: This toggles whether or not outlines in graphics charts are drawn
twice as thick. [This does the same as the -Xx switch.]
Show Glyph Labels: This toggles whether or not glyphs are drawn for planets
and objects in graphics charts. Pretty much the only time it’s useful to ever turn
this off is for the local horizon and orbit charts, especially when doing a timed
exposure animation of them. [This does the same as the -Xl switch.]
Show Glyphs on Aspect Lines: This toggles whether or not aspect lines between
planets show aspect glyphs on them. [This does the same as the -XA switch.]
Map Effects: This submenu allows one to toggle various settings which control things on
the sphere, map, and globe displays. The seven commands here are:
 Show Constellations: This toggles whether or not the map displays show in them
the astronomical constellations instead of the continents of the world. [This does
the same as the -XF switch.]
Show Full Star List: This toggles whether or not the map displays show in them
every fixed star defined in the [Link] file. [This does the same as the -XU
switch.]
Show House Details: This toggles whether or not the map displays show in them
the boundaries of the 12 houses. [This does the same as the -XC switch.]
Show Equator: This toggles whether or not the map displays show in them the
location of the Earth’s equator. [This does the same as the -Xe switch.]
Show Cities: This toggles whether or not the map displays plot in them the
location of every city in the atlas. [This does the same as the -XL switch.]
Use Detailed World Map: This toggles whether world maps and globes are
displayed as full color bitmaps, versus simple line drawings along coastlines.
[This does the same as the -Xbw switch.]
Use Ecliptic Axis: This toggles whether the chart sphere, globe, and local horizon
displays are aligned with the ecliptic. [This does the same as the -YXe switch.]
Map Orientation: This submenu allows one to change the angle of rotation and tilt of
the Earth in the globe and related charts, along with the zoom level which applies to
certain charts. The first three menu options here are: “Tilt North”, which pulls the globe
down one degree (or rather a number of degrees equal to the animation jump factor);
“Tilt South”, which pulls the globe up one degree; and “Set to Zero”, which returns the
globe to the standard zero degree angle with the equator edge on. [This affects the same
setting as the second optional parameter passed to the -XG switch.] The next two menu
options are: “Rotate West”, which rotates the globe to the right one degree (or rather a
number of degrees equal to the animation jump factor); and “Rotate East”, which rotates
the globe to the left one degree. [This affects the same setting as the first optional
parameter to the -XG switch.] The final two menu options are: “Zoom Out” and “Zoom
In” which double or halve the amount of space visible in the solar system, nearest cities,
and telescope charts. [This affects the same setting as the -YXS switch.]
Indian Style Charts: This submenu allows one to easily select or toggle South Indian,
North Indian, and East Indian wheel formats.
Show Indian Wheels: This toggles whether the standard radix and house wheel
charts are displayed in Indian format, instead of in Western format. [This does the
same as the -XJ switch.]
Draw South Indian: This sets the display to the South Indian or rasi format.
[This turns on the -XJ switch, sets the chart type to sign wheel, and turns off the -
XC switch.]
 Draw North Indian: This sets the display to the North Indian or bhava chalit
format. [This turns on the -XJ switch, and sets the chart type to house wheel.]
Draw East Indian: This sets the display to the East Indian format. [This turns on
the -XJ switch, sets the chart type to sign wheel, and turns on the -XC switch.]
Modify Display: This toggles whether or not each graphics chart is displayed in a
slightly modified form, e.g. for the map displays this will show just the map itself, and
plot all the planets upon it. [This does the same as the -Xi switch; see the documentation
for this switch in an earlier section for a list of how this setting affects each chart.]
Modify Chart: This option acts as a quick way to toggle several settings associated with
certain charts. They are:
(1) For wheel charts, toggle between the standard wheel and the house
emphasized wheel.
(2) For the relationship grid, toggle whether it shows midpoints instead of aspects.
(3) For the local horizon chart, toggle whether it displays with a polar center.
(4) For the astro-graph chart, toggle whether it draws a line across the world map
at the chart location.
(5) For ephemeris and calendar charts, toggle whether they’re displayed for the
year instead of just the month.
(6) For transit graphs, toggle whether they show all aspects instead of restricting
fast moving objects.
(7) For chart spheres and globe displays, toggle which hemisphere they focus
upon.
(8) For the world map display, toggle whether it’s shown in Mollewide projection.
Scribble Color: This submenu allows one to select the color to use when using the
mouse to draw on the window. It has sixteen options, one for each of the main colors.
Graphics Settings...: This brings up the Graphics Settings dialog, used to set various
additional graphics settings not already covered by menu options. They are:
(1) Two edit controls specifying the horizontal and vertical size of the graphics
chart in pixels [same as -Xw switch].
(2) An edit control specifying the scale size of glyphs in graphics charts, with a
dropdown allowing one to select from the four valid percentages 100 through 400
[same as -Xs switch].
(3) An edit control specifying the scale size of text in graphics charts, with a
dropdown allowing one to select from the seven valid percentages 100 through
400 [same as -XS switch].
(4) An edit control specifying the transparency percentage of the background
image and wheel chart filling [same as first parameter to -XI0 switch].
(5) A checkbox indicating whether charts that look best square should always be
drawn square, even in rectangular windows [same as the -XQ switch].
(6) An edit control specifying the horizontal and vertical number of cells to have
in the graphic aspect grid chart, which may be zero to have the size automatically
 determined [same as -YXg switch].
(7) An edit control for the solar system orbit trail length [same as the -YXj
switch].
(8) An edit control specifying the planet to track and keep in the center of the
display (if any) in the telescope chart [same as the optional parameter passed to
the -XZ switch].
(9) An edit control for the solar system orbit and telescope zoom scale [same as
the -YXS switch].
(10) An edit control specifying the rotation in degrees for the globe and world
map charts [same as the first optional parameter passed to the -XG switch].
(11) An edit control specifying the angular tilt in degrees for the globe chart
[same as the second optional parameter passed to the -XG switch].
(12) A checkbox indicating whether to draw the other hemisphere in the chart
sphere and polar globe charts [same as -XX0, -XG0, and -XP0 subswitches].
(13) A checkbox indicating whether to display the world map chart in the oval
shaped Mollewide projection as opposed to just in rectangular form [same as -
XW0 switch].
(14) An edit control specifying the time to delay between doing screen updates
when in animation mode [same as the -WN switch].
(15) A checkbox indicating whether animation mode affects the orientation of
map displays, instead of the time of the chart within the map [same as the -XN
switch].
(16) A checkbox indicating whether the graphics screen doesn't automatically
update and redraw after setting changes or window expose events, requiring the
user to manually force redraws [same as the -Wn switch].
(17) Two checkboxes for whether the display of the full star list includes bigger
dots and name labels [same as -XU subswitches].
(18) Six edit control dropdowns allowing one to select which font to use for text,
signs, houses, objects, aspects, and Vedic Nakshatras [same as -YXf switch].
(19) A radio button group specifying the “wheel chart rotation”, i.e. whether to
rotate the entire wheel so an object is at the left edge or at the top edge of the
chart, and an edit control specifying which object to use when active [all this does
the same as the -X1 and -X2 switches].
(20) A radio button group allowing one to select the decoration for the corners of
wheel charts, along with an edit control for how much of the image to cover with
it [same as the -YXv switch].
(21) A radio button group indicating whether and how to fill in the sectors in
wheel charts [same as -Xv switch].
(22) Six radio button groups allowing one to select between different glyphs to
use for Capricorn, Uranus, Pluto, Lilith, the Vertex, and Eris [same as -YXG
switch].
(23) A dropdown for how to color cities from the atlas [same as subswitches
passed to the -XL switch].

Animate menu commands:

Do Animation: This starts animation, which continually updates the static chart. The
animation amount will be taken from the values on the Jump Rate and Jump Factor
submenus, which by default is to continually “Update To Now”. Selecting this command
when animation is already on will toggle it off. Note that when animating the “Transit
And Natal” or “Progressed And Natal” bi-wheels (-rt and -rp switches) animating charts
will adjust the time of the transiting chart or the progressed chart, instead of the natal
chart. [This does the same as the -Xn switch.]
Jump Rate: This submenu allows one to select the type of animation to do, when “Do
Animation” is on. The first option, “Update To Now”, sets it so the chart will be
continuously updated to the current moment, and will act as a glorified astrological clock.
The remaining nine options: “Seconds”, “Minutes”, “Hours”, “Days”, “Months”,
“Years”, “Decades”, “Centuries”, and “Millennia”, set it so whatever chart will step
forward or backward by the specified amount each update.
Jump Factor: This submenu allows one to select how many units of whatever time rate
the animation proceeds by. The nine options here are the numbers one through nine,
where for example if animation is jumping by “Minutes” above, selecting “One” will
progress the chart by one minute each update, and selecting “Five” will progress by five
minutes each update. This setting is ignored when animation is set to “Update To Now”
or is off altogether.
Reverse Direction: This option toggles whether or not animation will proceed
backwards through time as opposed to forwards. This setting has effect only when
animation is on and set to an actual unit, i.e. it’s ignored when set to “Update To Now”.
Pause Animation: This toggles whether or not any animation is paused. Animation
being paused is basically the same as animation being off altogether, except that it’s easy
to unpause to continue animating. Note that the pause key may be used in addition to the
“p” key as a keyboard shortcut to this command.
Timed Exposure: This toggles whether or not the screen is erased between each update.
When active, the screen won't be cleared meaning progressive updates are drawn over the
existing display. This is generally only useful for charts such as the local horizon or solar
system (with glyph labels off) where this effect may be used to create streaks showing the
path of objects across the sky or through their orbits. [This does the same as the -Xj
switch.]
Step Forward: This moves the time of the current chart forward one day, or rather the
number of units set in the “Jump Rate” and “Jump Factor” menus. [This is similar to the -
+ switch.]
Step Backward: This moves the time of the current chart backward one day, or rather
the number of units set in the “Jump Rate” and “Jump Factor” menus. [This is similar to
the -- switch.]
Store Chart Info: This copies the time and location of the current chart being displayed
and remembers it in a special buffer. See below.
Recall Chart Info: This sets the current chart information to be that in the special buffer
above. [This does the same as using the “-i set” virtual file.]

Help menu commands:

Open Documentation: This will show the large comprehensive documentation file
“[Link]” that you’re reading now, in the default Web browser.
More Documentation: This submenu allows one to view Astrolog’s documentation files
online without having to leave the program. The five commands here are:
Open Documentation: This will show the large comprehensive documentation
file “[Link]” that you’re reading now, in the default Web browser.
Open Changes: This will open the “[Link]” file listing the additions to the
current version over the previous one, in the default Web browser.
Open License: This command launches the default browser and has it
automatically open the Astrolog license file “[Link]”, displaying legal
information on how you may use the program. Astrolog uses the GNU General
Public License (GPL).
Open Website: This will automatically visit the Astrolog Web site. This
command will start the default browser, and have it open the file “[Link]” in
the Astrolog install directory.
Open Website Mirror: This will open the Astrolog website mirror location at
[Link] in the default browser, as pointed to by the file “[Link]” in the
Astrolog install directory.
Open Data Files: This submenu allows access Astrolog’s various editable data files. The
five commands here are:
Open Default Settings: This will open the “[Link]” default settings file in
the Windows Notepad program.
Open Atlas: This will open the “[Link]” atlas or city database file in the
Windows Notepad program.
Open Time Zone Changes: This will open the “[Link]” time zone
definitions and time changes file in the Windows Notepad program.
Open Star List: This will open the “[Link]” Swiss Ephemeris fixed star list
file in the Windows Notepad program.
Open Orbital Elements: This will open the “[Link]” Swiss Ephemeris
definitions for hypothetical planets file in the Windows Notepad program.
List Signs: This sets the current display to be a text listing of the twelve signs and houses
and information about them. [This does the same as the -HC switch.]
List Objects: This sets the current display to be a text listing of all the planets and other
objects (that aren't restricted) which Astrolog can compute the positions of, along with
information about their rulerships. [This does the same as the -HO switch.]
List Aspects: This sets the current display to be a text listing of all eighteen aspects the
program can deal with, and information about them. [This does the same as the -HA
switch.]
List Constellations: This sets the current display to be a text listing of all 88
astronomical constellations the program displays in the constellation map charts, and a
little information about each one. [This does the same as the -HF switch.]
List Planet Info: This sets the current display to be a text listing of the planets in the
solar system, with some astronomical data given about each. [This does the same as the -
HS switch.]
List Rays: This sets the current display to be a text listing of the seven Rays, showing
their names and associations with signs and planets. [This does the same as the -H7
switch.]
List General Meanings: This sets the current display to be a text listing of the basic
interpretation database used by the program, giving the general meanings of each sign,
house, planet, and aspect. [This does the same as the -HI switch.]
List Switches: This sets the current display to be a text listing of the main command
switches that may be passed to the program, with a one line description of each. [This
does the same as the -H switch.]
List Obscure Switches: This sets the current display to be a text listing of the remaining
more obscure command switches not covered in the list above. [This does the same as the
-Y switch.]
List Keystrokes: This sets the current display to be a text listing of the main shortcut
keys (“main” being those that don't require the Alt key and that exist in the DOS version
as well) that one may press to do various operations. [This does the same as the -HX
switch.]
List Credits: This sets the current display to be a text listing of the credits and copyrights
for the program. [This does the same as the -Hc switch.]
Setup: Astrolog for Windows can do its own setup in many respects. The five commands
on this submenu are:
Create Program Group (User): This command will create a Windows program
group for the current user containing pointers to the Astrolog executable, the main
and update documentation files, and the Astrolog website. [This does the same as
the -WSg switch.]
Create Program Group (All): This command will create the same program
group, but for all users. [This does the same as the -WSG switch.]
 Create Desktop Icon: This command will create a Windows desktop icon to
launch Astrolog. [This does the same as the -WSd switch.]
Install File Extensions: This command will associate Astrolog with “.as”
extension files in the Windows registry. [This does the same as the -WSx switch.]
Uninstall File Extensions: This command undoes the effect of the previous
command, and unassociates Astrolog from “.as” extension files, which is useful
for uninstall. Note the last two menu commands edit the Windows registry, which
is protected on Vista and newer versions of Windows, meaning the command may
fail and display an error message. Hence Astrolog may need to be run as
Administrator in order for the program to have permission to change the registry.
[This does the same as the -WSu switch.]
About...: This brings up the About Astrolog dialog which contains static text also listing
the credits and copyrights for the program. Note that if you compile and run the debug
version of the program, the title bar of this dialog will have the text “(DEBUG)” added to
it. [This again contains the same text that the -Hc switch display prints.]

ASTROEXPRESSION FEATURES
AstroExpressions are programmable customizations that don’t require recompiling the
program, and can be considered an extended form of command switches. The term
“AstroExpression” stands for “Astrolog Expression”. You can compose expressions to do
a variety of simple or advanced operations, such as create your own house systems.
AstroExpressions are composed of the following components, which are defined as
follows:
Constant: A fixed numeric value. For example, “True” (which always evaluates
to 1), and “Signs” (the number of signs in the zodiac, which is 12). Indexes into
the alphabet can be indicated by “%a” (number 1) through “%z” (26). Also, there
are lists of constants available for months (1-12), objects, aspects, house systems,
signs of the zodiac (1-12), color indexes, days of the week (0-6), and sidereal
zodiac ayanamsa offsets. These constants start with a letter and an underscore,
followed by at least three letters (or enough to be unique). For example,
“M_January”, “O_Jupiter”, “A_Trine”, “H_Placidus”, “S_Leo”, “K_Green”,
“W_Sunday”, and “Z_Lahiri”.
Variable: A numeric value stored somewhere, which can change. For example,
“Mon” is the month of the current chart.
Custom Variable: One of a set of generic variables, which don’t correspond to
any specific program setting, but can be used by expressions to store whatever
they want. An example is an index while looping over the list of all objects. Some
numeric variables are automatically set by the program before it evaluates an
AstroExpression hook, and can be considered special parameters to that
 expression. Also, some custom variables are automatically queried by the
program after an expression hook returns, and can be considered as special return
values from that hook. The custom variable slots start at index #0 and have no
upper bound. Custom numeric variables can be referenced with the @ prefix (e.g.
@0 or @99). Custom variables #1 through #26 can also be referenced with @a
through @z. Note the important distinction between “%a” (which is always 1) and
“@a” (which is the value contained within variable #1).
Parameter: A piece of data passed to a function or variable assignment.
Parameters are either constants, variables, or functions. Anything that’s not a
constant is a variable or function to be queried or evaluated.
Type: The type of data contained in a parameter or variable. All parameters and
variables contain either integers or real numbers. Integers are signed 32 bit
numbers. Real numbers are floating point numbers, and real constants always
contain decimal points (e.g. “1.0” is real number 1, while “1” is integer 1).
Boolean values are no different from integers, in which False is represented by 0,
and True is represented by 1 or any non-zero number. A hexadecimal integer can
be specified with the “#” prefix, and a binary integer can be specified with the
“##” prefix.
Function: A type of parameter, which evaluates to a number. Functions are
followed by zero or more nested parameters. An example is “Add”, which takes
two numeric parameters and returns their sum. A function that takes zero
parameters and always evaluates to the same thing is a named constant, such as
“False” or a specific color like “K_Red”. Functions always precede their
parameters, which means AstroExpressions are in prefix format, e.g. “Mul Add 1
2 Sub 4 3” expresses “Multiply(Add(1, 2), Subtract(4, 3))” or “(1 + 2) x (4 - 3)”.
Expression: A string of text which gets evaluated, and returns a result. If an
expression consists of multiple subexpressions, they will be evaluated in
sequence, and the value of the last one will be returned. All parameters can be
considered subexpressions contained within a larger expression.
Hook: A type of expression that can be defined which is “hooked” into a
particular part of the program, which (if defined) gets evaluated every time that
part of the program runs. There are hooks into object and house cusp calculation
which can modify their positions, along with hooks into certain charts which
allow filtering or modifying their outputs.
The following lists all AstroExpression functions. The name of each function is listed,
followed by the type of its return value and the expected types of its parameters (if any).
Numbers will automatically be converted to Integer or Real as needed. “Num” means
either type is handled, without any conversion needed. If “Num” is the return value, then
if any “Num” parameters are Real the return type will be real, else integer. For example,
“Add 1 2.5” will cast integer 1 to real 1.0, then add two real numbers to return 3.5.
“Bool” means the function returns an integer (0 for False or 1 for True).
General functions (which are independent of Astrolog and astrology):
False: Bool: Constant. Returns integer 0.
True: Bool: Constant. Returns integer 1.
Int: Int(Num): Integer. Converts a number to integer, discarding any decimal real
part. For example “Int -3.9” is -3. Like the “(int)” cast operator in C.
Real: Real(Num): Real. Converts a number to real. Like the “(float)” cast
operator in C.
Type: Bool(Num): Is real. Returns the type of Num, which means 0 if it’s integer
and 1 if it’s real.
Add: Num(Num, Num): Addition. Adds two integer or two real numbers
together.
Sub: Num(Num1, Num2): Subtraction. Subtracts Num2 from Num1.
Mul: Num(Num, Num): Multiplication. Multiplies two numbers together.
Div: Num(Num1, Num2): Division. Divides Num1 by Num2.
Mod: Num(Num1, Num2): Modulus. Returns the remainder when Num1 is
divided by Num2.
Pow: Real(Real1, Real2): Power. Returns Real1 raised to the Real2 power.
Neg: Num(Num): Negation. Negates the sign of a number.
Inc: Num(Num): Increment. Adds one to a number.
Dec: Num(Num): Decrement. Subtracts one from a number.
Equ: Bool(Num, Num): Equality. Returns whether two numbers are equal.
Neq: Bool(Num, Num): Inequality. Returns whether two numbers are not equal.
Lt: Bool(Num1, Num2): Less than. Returns whether Num1 is less than Num2.
Gt: Bool(Num1, Num2): Greater than. Returns whether Num1 is greater than
Num2.
Lte: Bool(Num1, Num2): Less than or equal. Returns whether Num1 is less than
or equal to Num2.
Gte: Bool(Num1, Num2): Greater than or equal. Returns whether Num1 is
greater than or equal to Num2.
Not: Bool(Int): Boolean not. Returns whether a number is 0. Like the “!” operator
in C.
And: Int(Int, Int): Logical and. Returns the bits of two numbers anded together.
This function does not do short circuit evaluation, meaning both arguments are
always evaluated even if the first is false. Like the “&” operator in C.
Or: Int(Int, Int): Logical or. Returns the bits of two numbers ored together. This
function does not do short circuit evaluation, meaning both arguments are always
evaluated even if the first is true. Like the “|” operator in C.
Xor: Int(Int, Int): Logical exclusive or. Returns the bits of two numbers exclusive
ored together. Like the “^” operator in C.
Inv: Int(Int): Logical inverse. Returns a number with all its bits flipped. Like the
“~” operator in C.
<<: Int(Int1, Int2): Shift left. Returns Int1 with all its bits shifted left Int2 times.
Like the “<<“ operator in C.
>>: Int(Int1, Int2): Shift right. Returns Int1 with all its bits shifted right Int2
times. Like the “>>“ operator in C.
Odd: Int(Int): Odd. Returns whether an integer is an odd number.
Abs: Num(Num): Absolute value. Returns the absolute value of a number, or the
positive part if the number is negative.
Sgn: Num(Num): Sign. Returns the sign of a number (-1 if negative, 0 if zero, and
1 if positive).
Sgn2: Num(Num): Sign. Returns the sign of a number (-1 if negative, and 1 if
non-negative).
Min: Num(Num1, Num2): Minimum. Returns the lower of Num1 and Num2.
Max: Num(Num1, Num2): Maximum. Return the higher of Num1 and Num2.
Tween: Bool(Num, Num1, Num2): Between. Returns whether Num lies within
the range of Num1 to Num2. This is basically a shorthand version of “And Gte
<Num> <Num1> Lte <Num> <Num2>”.
?:: Num(Int, Num1, Num2): If/else. If Int is true, return Num1, otherwise return
Num2. This function does not do short circuit evaluation, meaning all parameters
are evaluated regardless of the flag. Like the “?:” operator in C.
Squ: Num(Num): Square. Return a number squared.
Sqr: Real(Real): Square root. Return the square root of a real number.
Dist: Real(Real, Real): Distance. Return the distance from the origin to a pair of
real coordinates.
Ln: Real(Real): Logarithm. Returns the natural or base “e” logarithm of a real
number.
Log10: Real(Real): Logarithm. Returns the base 10 logarithm of a real number.
Sin: Real(Real): Sine. Return the trigonometric sine of a real number, specified in
radians.
Cos: Real(Real): Cosine. Return the cosine of a real, in radians.
Tan: Real(Real): Tangent. Return the tangent of a real, in radians.
Asin: Real(Real): ArcSine. Return the inverse sine of a real, in radians.
Acos: Real(Real): ArcCosine. Return the inverse cosine of a real, in radians.
Atan: Real(Real): ArcTangent. Return the inverse tangent of a real, in radians.
Ang: Real(Real, Real): Angle. Return the angle of a line from the origin to a pair
of real coordinates, in radians.
SinD: Real(Real): Sine. Return the trigonometric sine of a real number, specified
in degrees.
CosD: Real(Real): Cosine. Return the cosine of a real, in degrees.
TanD: Real(Real): Tangent. Return the tangent of a real, in degrees.
AsinD: Real(Real): ArcSine. Return the inverse sine of a real, in degrees.
AcosD: Real(Real): ArcCosine. Return the inverse cosine of a real, in degrees.
AtanD: Real(Real): ArcTangent. Return the inverse tangent of a real, in degrees.
AngD: Real(Real, Real): Angle. Return the angle of a line from the origin to a
pair of real coordinates, in degrees.
Floor: Real(Real): Floor. Round a real number down to the next lower whole
number. For example, “Floor -3.1” is -4.0.
Fract: Real(Real): Fraction. Return the fractional part of a real number, i.e. its
floor subtracted from it. For example, “Fract -3.1” is 0.9.
DMS: Real(RealD, RealM, RealS). Degrees, minutes, seconds. Returns a decimal
number of degrees given a number of degrees, minutes within the degree, and
seconds within the minute. For example, “DMS 12 30 0” will return 12.5.
Rnd: Int(Int1, Int2): Random number. Return a random integer between Int1 and
Int2, inclusive.
Rgb: Int(IntR, IntG, IntB). RGB color. Returns an RGB color value, given red,
green, and blue color components in the range of 0-255.
 RgbR, RgbG, RgbB: Int(Int): Extract color component. Returns the red, green,
or blue color component of an RGB color value.
Blend: Int(Int1, Int2, Real): Blend colors. Returns an RGB color value, given two
RGB color values to blend together, and a real number indicating the proportion
between them, in which 0.0 is fully color #1, and 1.0 is fully color #2.
Hue: Int(Real). Rainbow color. Returns an RGB color of rainbow, based on light
mixing. The hue parameter should range from 0-360, in which 0 is red, 120 is
green, 240 is blue, and so on around the circle.
Hue2: Int(Real). Rainbow color. Returns an RGB color of the rainbow, based on
paint color mixing. The hue parameter should range from 0-360, in which 0 is red,
120 is yellow, 240 is blue, and so on around the circle.
Char: Int(Int1, Int2). Select character. Returns the Ascii value of the character
within custom string index Int1, at character position Int2. Returns -1 if the string
isn’t set or the character position is out of range.
Dlg: Int. Color dialog. In the Windows version, brings up the Windows color
picker dialog. Returns the RGB color selected within the dialog.
Mouse: Int(Int): Mouse coordinates. In the Windows version, takes the current
pixel coordinates of the mouse pointer (relative to the upper left corner of the
Astrolog window) and assigns it to the two custom variables pointed to by the
parameter. Also returns these two numbers combined together using the formula
(Y * 65536 + X). Note the parameter is usually a static index of a variable, instead
of variable value, so should be in the form %a instead of @a, in order to assign X
coordinate to @a and Y coordinate to @b.
Specific functions (which are related to Astrolog and astrology):
Signs: Int: Signs. Returns the constant number of signs in the zodiac (i.e. 12).
Objs: Int: Objects. Returns the number of objects, or rather the highest
unrestricted object index (ranging from -1 to 130).
Asps: Int: Aspects. Returns the number of aspects, which is also the highest
unrestricted aspect index (ranging from 0 to 24).
Mon: Int: Month. Returns the month of the current chart (i.e. 1-12).
Day: Int: Day. Returns the day of the current chart (1-31).
Yea: Int: Year. Returns the year of the current chart.
Tim: Real: Time. Returns the time of the current chart in hours (0.0 to 24.0).
Dst: Real: Daylight Saving: Returns the Daylight Saving Time offset of the
current chart in hours (usually 0.0 or 1.0). A Daylight Saving offset set to
Autodetect will be the special value 24.0.
Zon: Real: Time zone: Returns the time zone offset of the current chart in hours
West of GMT (usually -12.0 to 12.0). A time zone set to Local Mean Time (LMT)
will be the special value 24.0, and a time zone set to Local Apparent Time (LAT)
will be the special value 23.0.
Lon: Real: Longitude: Returns the longitude of the current chart in degrees West
of GMT (-180.0 to 180.0).
Lat: Real: Latitude: Returns the latitude of the current chart in degrees North of
the equator (-90.0 to 90.0).
Mon2, Day2, Yea2, Tim2, Dst2, Zon2, Lon2, Lat2: Int or Real: Second chart.
Like above but returns chart info for chart slot #2. There are similar functions for
chart slots #1, #3, and #4. Note the difference between Mon1 which always
references chart slot #1, and just Mon which is the current chart being worked
with (e.g. for the current chart row in an ephemeris table).
MonN, DayN, YeaN, TimN, DstN, ZonN, LonN, LatN: Int(Int) or Real(Int):
Slot indexed chart. Like the functions above used to access chart information in
specific slots, but returns chart info for the referenced chart slot in the range 0-6.
MonL, DayL, YeaL, TimL, DstL, ZonL, LonL, LatL: Int(Int) or Real(Int): List
indexed chart. Like the functions above used to access chart information in
specific slots, but returns chart info for the referenced chart index in the chart list.
MonS, DayS, YeaS, TimS, DstS, ZonS, LonS, LatS: Int or Real: Saved chart.
Like above but returns chart info for the saved or previous chart.
MonT, DayT, YeaT, TimT: Int or Real: Transit chart. Like above but returns
chart info for the time to transit over or progress to.
MonG, DayG, YeaG: Int: Gregorian chart. Like above but returns the date info
currently being used for the Julian to Gregorian calendar crossover, which by
default is October 15, 1582.
DstD, ZonD, LonD, LatD: Real: Default chart. Like above but returns chart info
for the default chart.
ObjLon: Real(Int): Object longitude. Returns the zodiac position of an object.
ObjLat: Real(Int): Object latitude. Returns the ecliptic latitude of an object.
ObjDir: Real(Int): Object direction. Returns the velocity of an object in degrees
per day. (Negative number means retrograde motion.)
ObjDirY: Real(Int): Object direction Y. Returns the velocity of an object along
the vertical or latitude axis.
ObjDirL: Real(Int): Object direction Z. Returns the velocity of an object along
the distance axis.
ObjHouse: Int(Int): Object house. Returns the house placement of an object (i.e.
1-12).
ObjLon2, ObjLat2, ObjDir2, ObjDirY2, ObjDirL2, ObjHouse2: Int or Real:
Second chart. Like above but returns the zodiac position longitude, ecliptic
latitude, etc, for chart slot #2. There are similar functions for chart slots #1 though
#6.
ObjX: Real(Int): Object X. Returns the X coordinate of an object in space, in AU.
ObjY: Real(Int): Object Y. Returns the Y coordinate of an object in space, in AU.
ObjZ: Real(Int): Object Z. Returns the Z coordinate of an object in space, in AU.
ObjXN, ObjYN, ObjZN: Real(Int). Indexed object coordinates. Like ObjX,
ObjY, and ObjZ, but returns the coordinates in space for the referenced chart slot
in the range 0-6.
ObjOn: Bool(Int): Object on. Returns whether an object is present and not
restricted. Specified with -R switch.
ObjOnT: Bool(Int): Object on transit. Returns whether an object is present in
transits and not restricted in transit restrictions. Specified with -RT switch.
ObjOrb: Real(Int): Object orb. Returns an object’s maximum aspect orb allowed,
in degrees. Specified with -Am switch.
ObjAdd: Real(Int): Object addition. Returns how much aspects to an object
should have their orbs widened, in degrees. Specified with -Ad switch.
ObjInf: Real(Int): Object influence. Returns the power of an object. Specified
with -Yj switch.
ObjInfT: Real(Int): Object transit influence. Returns the power of an object when
transiting. Specified with -YjT switch.
ObjCol: Int(Int): Object color. Returns the color index of an object. Specified
with -YkO switch.
ObjRul: Int(Int). Object ruler. Returns the primary sign that the specified planet
rules.
ObjRul2: Int(Int). Secondary object ruler. Returns the secondary sign that the
specified planet co-rules, or 0 if none is set.
ObjRulS: Int(Int). Object esoteric ruler. Returns the primary sign that the
specified planet esoterically rules.
ObjRulS2: Int(Int). Secondary esoteric ruler. Returns the secondary sign that the
specified planet esoterically co-rules, or 0 if none is set.
ObjRulH: Int(Int). Object Hierarchical ruler. Returns the primary sign that the
specified planet Hierarchically rules.
ObjRulH2: Int(Int). Secondary Hierarchical ruler. Returns the secondary sign
that the specified planet Hierarchically co-rules, or 0 if none is set.
ObjExa: Int(Int). Object exaltation. Returns the sign that the specified planet is
exalted within, or 0 if none is set.
ObjRay: Int(Int). Object Ray. Returns the Ray of the specified planet in the range
1-7, or 0 if none is set.
ObjDist: Real(Int): Object distance. Returns average distance of an object from
the Sun (or Earth if it orbits it) in millions of kilometers.
ObjYear: Real(Int): Object year. Returns average length of year or time it takes
an object to orbit the Sun (or Earth if it orbits it) in Earth years.
ObjDiam: Real(Int): Object diameter. Returns the diameter of an object, in
kilometers. If an object has been reconfigured to be a planetary moon, that
diameter of that moon will be returned instead.
ObjDay: Real(Int). Object day length. Returns an object’s length of day or how
long it takes to rotate upon its axis, in hours.
AspAngle: Real(Int): Aspect angle. Returns the angle of an aspect, in degrees.
Specified with -Aa switch.
AspOrb: Real(Int): Aspect orb. Returns the maximum orb allowed for an aspect,
in degrees. Specified with -Ao switch.
AspInf: Real(Int): Aspect influence. Returns the power of an aspect. Specified
with -YjA switch.
AspCol: Int(Int): Aspect color. Returns the color index of an aspect. Specified
with -YkA switch.
Cusp: Real(Int): House cusp. Returns the zodiac position of a house cusp, in
degrees.
Cusp3: Real(Int): 3D cusp. Returns the prime vertical position of a 3D house
cusp, in degrees.
HouseInf: Real(Int): House influence. Returns the power of a house. Specified
with the -YjC switch.
PlusZone: Bool(Int): Gauquelin plus zone. Returns whether the specified
Gauquelin sector from 1-36 is a plus zone.
SignRul: Int(Int). Sign ruler. Returns the planet that rules the specified sign.
SignRul2: Int(Int). Sign secondary ruler. Returns the planet that co-rules the
specified sign, or -1 if none is set.
SignEso: Int(Int). Sign esoteric ruler. Returns the planet that esoterically rules the
specified sign.
SignEso2: Int(Int). Secondary esoteric ruler. Returns the planet that esoterically
co-rules the specified sign, or -1 if none is set.
SignHie: Int(Int). Sign Hierarchical ruler. Returns the planet that Hierarchically
rules the specified sign.
SignHie2: Int(Int). Secondary Hierarchical ruler. Returns the planet that
Hierarchically co-rules the specified sign, or -1 if none is set.
SignRay: Int(Int). Sign Rays. Return the Rays of the specified sign, with one digit
per Ray. For example, Aries is associated with Rays 1 and 7, so for S_Aries this
returns 17.
SignRay2: Int(IntS, IntR). Sign Ray check. Check whether the specified sign is
associated with the specified Ray. Returns 0 if not, and a non-zero value if so,
specifically the proportion compared to 420 that Ray is present compared to the
other Rays also associated with that sign. For example, “SignRay2 S_Sag 4”
returns 140 or 420/3, since Sagittarius is indeed associated with Ray 4, but also
three different Rays in total.
RayCol: Int(Int). Ray color. Return the Astrolog color index being used for the
specified Ray.
LonSign: Int(Real): Longitude sign. Returns the sign of a 0-360 degree zodiac
position (i.e. 1-12).
LonDeg: Real(Real): Longitude degree. Returns the degree within a sign of a 0-
360 degree zodiac position (0.0 to 30.0).
LonHouse: Int(Real): Longitude house. Returns the house placement of a 0-360
degree zodiac position (i.e. 1-12).
LonHou3D: Real(Real, Real): Longitude 3D house. Returns the 3D house
placement of a 0-360 degree zodiac position and ecliptic latitude, as a decimal
value, e.g. 0.0-30.0 for 1st house.
LonDist: Real(Real, Real): Returns the minimum distance between two 0-360
degree zodiac positions, in degrees (ranging from 0.0 to 180.0).
LonDiff: Real(Real1, Real2): Returns the minimum difference between zodiac
positions Real2 and Real1, in degrees (ranging from -180.0 to 180.0)
LonMid: Real(Real, Real): Returns the midpoint of two 0-360 degree zodiac
positions.
LonDecan: Real(Real). Decan transformation. Transforms a zodiac position to its
decan sign, like as done by the -3 switch.
LonNavam: Real(Real). Navamsa transformation. Transforms a zodiac position
to its Navamsa sign, like as done by the -9 switch.
LonDwad: Real(Real). Dwad transformation. Transforms a zodiac position to its
dwad sign, like as done by the -4 switch.
LonTerm: Int(Real, Int). Term determination. Returns the object corresponding
to the given zodiac position. Depending on the integer parameter, this will be:
0=Decan ruler, 1=Chaldean decan, 2=Egyptian term, 3=Ptolemaic term.
DayWeek: Int(Int1, Int2, Int3): Day of week. Returns the day of the week it is on
month Int1, day Int2, year Int3.
JulianT: Real(IntM, IntD, IntY, Real): Julian Time. Returns the Julian time for
the given month, day, year, and time in hours.
LATLMT: Real. LAT to LMT offset. Returns the “equation of time” or the offset
in hours between Local Apparent Time and Local Mean Time, for the moment of
the most recently cast chart.
PolDist: Real(RealX1, RealY1, RealX2, RealY2): Polar distance. Returns the
distance between two sets of longitude and latitude coordinates on a globe, in
degrees.
Oblique: Real: Obliquity. Returns the obliquity of the ecliptic of the most
recently cast chart, which is usually about 23.5 degrees.
RAMC: Real: Right Ascension of Midheaven. Returns the RAMC in degrees (0-
360) for the most recently cast chart.
DeltaT: Real: Delta-T. Returns the Delta-T offset in seconds for the most recently
cast chart.
SidDiff: Real: Sidereal offset. Returns the precessional offset from the tropical to
sidereal zodiacs for the time of the most recently cast chart, which for current
dates is about -25.0.
Nutation: Real: Nutation. Returns the tropical nutation longitude offset for the
most recently cast chart.
HouseSys: Int: House system. Returns the index of the current house system.
Same as the _c function.
AspLon: Int(Int1, Int2, IntV): Aspect check. Returns whether there’s an aspect
between objects in the current chart indicated by Int1 and Int2, taking into account
all orb settings. If an aspect is present, then custom variable IntV (if a valid
variable index) will be set to the orb between them in degrees.
AspLon2: Int(Int1, Int2, IntV): Relationship aspect check. Like AspLon but
checks for an aspect between planet positions in the first two chart slots.
AspLat: Int(Int1, Int2, IntV): Parallel aspect check. Like AspLon but checks for
parallel or contraparallel aspects between planet positions in the current chart.
AspLat2: Int(Int1, Int2, IntV): Relationship parallel aspect check. Like AspLat
but checks for an aspect between planet positions in the first two chart slots.
GridNam: Int(IntX, IntY): Grid name. Returns the aspect present in the current
aspect grid, or sign of the midpoint if a midpoint grid, or sign of the object if
referencing coordinates on the main diagonal of a single chart grid.
GridVal: Real(IntX, IntY): Grid value. Returns the orb value present in the
current aspect grid, or degree within sign of the midpoint if a midpoint grid, or
degree within sign of the object if referencing coordinates on the main diagonal of
a single chart grid.
DoGrid: Bool. Make aspect grid. Compose the internal aspect/midpoint grid for
the planet positions in the most recently cast chart, as used in certain Astrolog
charts, and as accessed via the GridNam and GridVal functions. Returns whether
creating the grid succeeded.
DoGrid2: Bool(Bool). Make relationship aspect grid. Compose the internal
aspect grid (or midpoint grid if the parameter is True) for the planet positions in
the first two chart slots, as used in certain Astrolog charts, and as accessed via the
GridNam and GridVal functions. Returns whether creating the grid succeeded.
Note that the first chart is measured down along the Y axis, while the second chart
is measured across along the X axis, as seen in the comparison aspect grid charts.
ListCnt: Int. List count. Returns the size of the chart list in memory.
ListCur: Int. List current position. Returns the index of the most recent chart list
entry displayed with the commands on the “Info / Chart List” submenu.
List1: Int. List index #1. Returns the index into the chart list used for chart slot #1
when using any of the -5e switches.
List2: Int. List index #2. Returns the index into the chart list used for chart slot #2
when using the -5e3 or -5e4 switches.
TiltXY: Real(Int, Real). Coordinate transformation. Tilts the longitude and
latitude coordinates referenced by custom variables Int and Int+1, by Real
degrees. Returns the adjusted longitude. For example, “TiltXY %x Oblique” will
translate between ecliptic and equatorial coordinates (effectively doing the same
as the -sr switch) assuming longitude and latitude are stored in @x and @y.
Context: Int: Chart context. Returns what the current or most recently cast chart
was cast for. This is usually 1-6 to indicate which chart in a relationship or wheel
is being cast. It can also be 0 for special case charts (like the chart cast for a
progressed time), or -1 for one of many charts cast in sequence (like each interval
during a transit search). This is designed for use in the ~q notification or hooks
like ~O that take place during chart casting.
Version: Real: Program Version. Returns the version of Astrolog running, which
is 7.60.
=Obj: Int(Int1, Int2, Int3, Int4). Copy object. Copies the contents of object Int2 in
chart slot Int1, to object Int4 in chart slot Int3. This includes the object’s longitude
and latitude position, horizontal and vertical and distance velocity, and its house
position. Returns the longitude position.
=Hou: Int(Int1, Int2, Int3, Int4). Copy house cusp. Copies the contents of house
cusp Int2 in chart slot Int1, to cusp Int4 in chart slot Int3. Returns the house cusp
longitude.
DCol: Int(Int). Set draw color. Sets the color to use for the other D-prefix drawing
functions, and returns that color.
DDot: Int(IntX, IntY). Draw pixel. Sets a pixel in the current draw color at a
coordinate. Returns the drawing color used. Functions like this can be called in
contexts such as the ~Q2 AstroExpression to add additional content to a graphics
chart after it’s been drawn.
DSpot: Int(IntX, IntY). Draw spot. Sets a small cluster of five pixels in the
current draw color at a coordinate. Returns the drawing color used.
DLine: Int(IntX1, IntY1, IntX2, IntY2). Draw line. Draws a line in the current
draw color from a start coordinate to an end coordinate. Returns the drawing color
used.
DBox: Int(IntX1, IntY1, IntX2, IntY2). Draw box. Draws a rectangle outline in
the current draw color between two opposite corner coordinates. Returns the
drawing color used.
DBlock: Int(IntX1, IntY1, IntX2, IntY2). Draw block. Draws a filled in rectangle
in the current draw color between two opposite corner coordinates. Returns the
drawing color used.
DCirc: Int(IntX1, IntY1, IntX2, IntY2). Draw circle. Draws an ellipse outline in
the current draw color between two opposite corner coordinates. Returns the
drawing color used.
DDisk: Int(IntX1, IntY1, IntX2, IntY2). Draw disk. Draws a filled in ellipse in
the current draw color between two opposite corner coordinates. Returns the
drawing color used.
DText: Int(Int, IntX, IntY). Draw text. Draws the custom string indexed, at the
specified coordinates in the current draw color. Returns the drawing color used.
 DSign: Int(Int, IntX, IntY). Draw sign. Draws a sign glyph, at the specified
coordinates in the current draw color. Returns the drawing color used.
DHouse: Int(Int, IntX, IntY). Draw house. Draws a house label, at the specified
coordinates in the current draw color. Returns the drawing color used.
DObj: Int(Int, IntX, IntY). Draw object. Draws an object glyph, at the specified
coordinates in the current draw color. Returns the drawing color used.
DAsp: Int(Int, IntX, IntY). Draw aspect. Draws an aspect glyph, at the specified
coordinates in the current draw color. Returns the drawing color used.
DNak: Int(Int, IntX, IntY). Draw Nakshatra. Draws a Vedic Nakshatra label, at
the specified coordinates in the current draw color. Returns the drawing color
used.
Programming functions (which are related to variables and control flow):
Var: Num(Int): Variable lookup. Returns the value within the referenced custom
variable.
Do: Num(Num1, Num2): Evaluate the parameter Num1, then return Num2. “Do”
is useful as the function inside control flow functions such as “If” and “For”, to
chain multiple operations together.
Do2: Num(Num1, Num2, Num3): Evaluate the parameters Num1 and Num2,
then return Num3.
Do3: Num(Num1, Num2, Num3, Num4): Evaluate the parameters Num1 through
Num3, then return Num4.
If: Num(Int, Num): If statement. If Int is true, then evaluate Num. Returns Num if
true, else 0. Note that Num will only be evaluated if Int is true. Like the “if”
statement in C.
IfElse: Num(Int, Num1, Num2): If/else. If Int is true, then evaluate and return
Num1, otherwise evaluate and return Num2. Note that unlike the similar “?:”
function, here only one of Num1 and Num2 will be evaluated. Like the “if / else”
statement in C.
DoCount: Num(Int, Num): Loop. Evaluate expression Num for Int number of
times in sequence. Return the final evaluation of Num (or 0 if it never got
evaluated).
While: Num(Int, Num): While loop. Evaluates Int as an expression. If true,
evaluates Num and then repeats. Keep reevaluating until expression Int is no
longer true. Return the final evaluation of Num (or 0 if it never got evaluated).
Warning: Expressions like “While True 0” will run forever and hang the program!
Like the “while” statement in C.
DoWhile: Num(Int, Num): Do/while loop. Evaluates Num as an expression, then
evaluates Int as an expression. If true, then evaluate again, and repeat until
expression Int is no longer true. Return the final evaluation of Num. Like the
“do/while” statement in C.
For: Int(Int1, Int2, Int3, Num): For loop. Set custom variable indicated by Int1 to
Int2. While Int1 is less than or equal to Int3, evaluate Num, then increment Int1.
Returns the final value of Int1 after the loop finishes. In most cases one wants to
specify the variable Int1 as “%a” instead of “@a”. The former makes variable %a
itself loop, while the latter makes the custom variable pointed to by the value of
@a loop. Similar to the “for” loop in various languages.
Macro: Num(Int). Macro expression. Run and return the result of custom
expression that was defined in slot Int with the ~M command switch.
AstroExpression macros will evaluate all expressions in sequence and return the
result of the last one, similar to AstroExpression strings assigned to command
switch hooks.
Switch: Int(Int): Switch macro. Runs the command switch macro, as defined with
the -M0 switch. Returns whether running that macro succeeded. Remember that a
command switch macro (running a saved command line) is different from an
AstroExpression macro (which evaluates a defined AstroExpression).
RndSeed: Int(Int): Random seed. Initializes the random number generation seed
used by the Rnd function to an integer, and also returns that number.
Assign: Num(Int, Num): Variable assignment. Assigns Num to the custom
variable Int, and also returns that number. Can also use “=” as a shortcut for
“Assign”.
=a: Num(Num): Assign to “A”. Assigns Num to custom variable “A”, and also
returns that number. Can also use functions “=b” through “=z” to assign to them.
_v3, _v31, _w1, _aj, _L1, _L2, _d1, _EY, _E01, _E02, _P1, _N1, _80, _I1, _zv,
_zf, _A3, _Ap, _APP, _b, _b0, _c, _c3, _c31, _s, _s0, _s1, _sr, _sr0, _h, _p, _p0,
_pd, _pC, _x, _1, _3, _4, _f, _G, _J, _9, _YT, _YV, _Yf, _Yh, _Ym, _Ys, _Ys,
_Ys1, _Yn, _Yn0, _Yz0, _Yu, _Yu0, _Yr, _YC, _YO, _Y8, _Ya, _Yao, _Yoo,
_Yc, _Yp, _YZ, _Yb, _Y5I1, _Y5I2: Bool or Int or Real: Program setting. This
list of functions queries the Astrolog setting that’s set with the identically named
command switch. There are only a few exceptions or alternate behaviors:
Functions ending with “1” or “2” access the first or second arguments passed to
the switch without that digit. Function _aj accesses the -a switch sort order, with
integers 0-8 referencing the “jonOPACDm” subswitches. Functions _E01 and
_E02 both reference the step parameter to the -E0 switch, in which _E01 is the
rate (-1=hours, 0=days, 1=months, 2=years) and _E02 is the factor. Functions
_APP and _Yoo access the -AP and -Yo switch settings, and repeat the letter of
the command switch in their names to avoid a case insensitive name conflict with
_Ap and _YO. Function _s is a boolean for the -s switch sidereal setting, while
 _s1 is a real for the zodiac offset ayanamsa parameter. Function _s0 accesses the -
s switch display format, with integers 0-3 referencing the “zhdn” subswitches.
Function _1 is non-zero if either the -1 or -2 solar chart switches are set, and
contains (1+object focused upon) if -1 switch, and (-1-object) if -2 switch.
_XI1, _XI2, _Xr, _Xm, _XT, _Xi, _Xuu, _Xx, _Xll, _XA, _XL, _Xj, _XF,
_XW0, _Xee, _XU, _XC, _XQ, _XN, _Xwx, _Xwy, _Xnn, _Xs, _XSS, _XU0,
_XE1, _XE2, _XE, _XL0, _X1, _Xv, _XJJ, _X8, _XGx, _XGy, _XZ, _Xnp,
_Xnf, _YXG, _YXGc, _YXGu, _YXGp, _YXGl, _YXGv, _YXGe, _YXe,
_YXa, _YXf, _YXft, _YXfs, _YXfh, _YXfo, _YXfa, _YXfn, _YXW: Bool or
Int or Real: Program graphics setting. This list of functions queries the Astrolog
graphics setting that’s set with the identically named command switch. There are
only a few exceptions: Functions _Xuu, _Xee, _Xnn, _XSS, and _XJJ access the -
Xu, -Xe, -Xn, -XS, and -XJ switch settings, and repeat the letter of the command
switch in their names to avoid a case insensitive name conflict with _XU, _XE,
_XN, _Xs, and _Xj. Functions _XI1 & _XI2, _Xwx & _Xwy, _XGx & _XGy
access the two parameters passed to the -XI0, -Xw and -XG switches.
_WN, _Wnn, _Wh, _Wt, _Wo, _Wo0, _Wo3, _Wz: Bool or Int: Program
Windows setting. This list of functions queries the Astrolog Windows version
setting that’s set with the identically named command switch. There is one
exception: Function _Wnn accesses the -Wn switch setting, and repeats the letter
of the command switch in its name to avoid a case insensitive name conflict with
_WN.
_YR0, _YR1, _YR2, _YRZ, _YR7, _YXK: Bool(Int) or Int(Int). Program
setting parameter. This list of functions queries the Astrolog settings that are set
with the identically named command switch. The parameter indicates which
parameter to the command switch to query the status of. For example, the
parameter to _YXK indicates which palette slot to return the RGB color of.
PC, WIN, X11, WCLI, WSETUP, JPLWEB: Bool. Program compile time
setting. This list of functions returns whether the correspondingly named compile
time #define in astrolog.h was set when the program was compiled. For example,
they can be used to take different actions in an AstroExpression based on whether
the Windows or X11 version is being run.
There are various command switches which allow one to define AstroExpression “hooks”
into areas of chart calculation or display, to modify or filter their results. All
AstroExpression related command switches start with the tilde “~” character. Note on
Unix systems the shell automatically expands “~” to your $HOME directory, so on them
specify “-~” (dash tilde) or “/~” (slash tilde) instead of just “~”, to make it work.
~ <string>: Display AstroExpression. The passed in string will be parsed and
evaluated, and the return value displayed. This is useful for debugging
expressions, or querying the value of custom variables. It can also be used to
debug complex command lines, by inserting instances of “~” at appropriate points
to display the current values of chart information or other internal variables. For
example, “~ 'Sqr Div 9.0 4.0'” will evaluate and display the expression
“SquareRoot(9.0 / 4.0)” which is 1.5.
~g <string>: Filter aspect configurations. Called for each aspect configuration in
the -g0 aspect chart. Return value is whether to display that aspect configuration.
On entry, @v is the aspect configuration (0=3 planet Stellium, 1=Grand Trine,
2=T-Square, 3=Yod, 4=Grand Cross, 5=Cradle, 6=Mystic Rectangle, 7=4 planet
Stellium). Also, @w through @z are the four planets involved (@z will be -1 if
the configuration only involves 3 planets). For example, to only display grand
crosses and grand trines, do: ~g "Or Equ @v 1 Equ @v 4"
~a <string>: Adjust aspect powers. Called during the -a switch aspect list chart,
and allows one to adjust each aspect’s power. On entry, custom variables @w and
@y are the two objects forming aspect, @x is the aspect, and @z is the current
power (in thousandths, e.g. a power of 1.234 is integer 1234). Return value is
ignored, although if @z is changed it will be the new power to use. For example,
to triple the power of any aspect involving an object in the sign Sagittarius, do: ~a
"If Or Equ LonSign ObjLon @w S_Sag Equ LonSign ObjLon @y S_Sag =z
Mul @z 3"
~a0 <string>: Notify aspect list summary. Called once after the -a0 aspect list
summary is displayed. On entry, @y is the total number of aspects that were
displayed, and @z is the total power of all aspects. Return value is ignored. For
example, if you animate a bunch of aspect list charts, you can keep track of the
highest total power displayed (i.e. store it in custom variable @a) with: ~a0 "If
Gt @z @a =a @z"
~m <string>: Filter midpoints. Called for each midpoint in the -m midpoint chart.
On entry, @w and @x are the two objects forming the midpoint, @y is the
position of the midpoint, and @z is the angular difference between their positions.
Returns value is whether to display that midpoint. For example, to only display
midpoints located within 30 degrees of the Sun’s position, do: ~m "Lt LonDist
@y ObjLon O_Sun 30.0"
~ma <string>: Filter aspects to midpoints. Called for each aspect made to a
midpoint (or Arabic part) in the -ma midpoint list. On entry, @v is the zodiac
degree position of the midpoint, @w is its velocity, @x is the aspect being made,
@y is the object being aspected, and @z is the orb between them. Return value is
whether to display that aspect. For example, to only display tight aspects to the
Sun or Moon, do: ~ma "And Lt Abs @z 2.0 Lte @y O_Moo"
~j <string>: Adjust object influence powers. Called when a chart’s object and
aspect powers are computed in the text mode -j influence and -7 esoteric charts.
On entry, @x is the object, @y is its power due to positioning, and @z is its
power due to aspects. Return value is ignored, although if you update @y and @z
they will be the new powers used. For example, to give an extra 100 power to
completely unaspected planets, do: ~j "=n 0 For %i 0 Objs If And Neq @i @x
GridNam Min @i @x Max @i @x =n Inc @n If Lte @n 0 =z Add @z 100.0"
~j0 <string>: Adjust sign influence powers. Called when a chart’s sign powers
are computed in the text mode -j0 influence charts. On entry, @y is the sign, and
@z is its power. Return value is ignored, although if you update @z it will be the
new power used. For example, to give an extra 200 relative power to fire signs,
do: ~j0 "If Equ Mod @y 4 1 =z Add @z 200.0"
~7 <string>: Notify Ray chart. This is called when the esoteric chart is being
interpreted (-7 -I switches) and allows tracking Ray charts. On entry, @v through
@z contain the top percentage Rays for physical, astral, mental, personality, and
soul. Return value is ignored. For example, if you animate a bunch of esoteric
charts, you can keep track of the count of each possible personality Ray in custom
variables @a through @g with: ~7 " =u %y = Var @u Inc Var Var @u"
~L <string>: Filter latitude crossings. Called for each latitude crossing in the -L0
astrocartography chart. On entry, @u and @v are the longitude and latitude of the
crossing point, @w and @y are the two planets whose lines are involved, and @x
and @z are object indexes for angles indicating which lines are involved. @x will
always be Ascendant or Descendant, but @z may be any of the four angles. For
example, to only display latitude crossings involving the Ascendant that are
within 10 degrees of the current chart’s latitude do: ~L "And Lt Abs Sub @v
Lat1 10 Or Equ @x O_Asc Equ @z O_Asc"
~E <string>: Filter ephemeris output. Called for each line in the text ephemeris
chart. Return value is whether to display the line. For example, to do a stellium
search and only display ephemeris lines in which there are at least 5 planets in the
same sign, do: astrolog -n -Ey ~E "For %m 1 Signs = @m 0 For %m 0 Objs If
ObjOn @m = LonSign ObjLon @m Inc Var LonSign ObjLon @m =n 0 For
%m 1 Signs =n Max @n Var @m Gte @n 5"
~P <string>: Filter Arabic parts. Called for each Arabic part in the -P parts list
chart. On entry, @y is the index of the Arabic part starting from 0 (independent of
the current sorting order), and @z is the zodiac position of that part. Return value
is whether to display that part. If @z is changed, the part’s position will be
updated. For example, to only display parts that lie in the 10th house, do: ~P
"Equ LonHouse @z 10"
~Zd <string>: Filter rising and setting times. On entry, @x is the planet, @y is
the event (0=rises, 1=zeniths, 2=sets, 3=nadirs), and @z is the azimuth in degrees
(0 = due East, 90 = due North). Return value is whether to display the event. For
example, to only show rising events within 10 degrees of due East, do: ~Zd "And
Equ @y 0 Lt LonDist @z 0.0 10.0"
~d <string>: Filter transit to transit events. Called for each event in the -d switch
chart. On entry, @u is the first object forming the event, @v is the aspect or other
event (-1: sign change, -2: direction change, -3: degree change, -5: latitude
direction change, -6: distance direction change, -7: latitude zero crossing, -8:
distances equal), @w is the second object forming the event (or new sign if that
event, or 1: retrograde or 0: direct if that event), @x is Moon void of course
indicator for how many seconds it will be v/c (-1 for not going v/c in this event),
@y is the eclipse type (-1: eclipse detection turned off, 0: no eclipse, 1:
penumbral, 2: total penumbral, 3: partial, 4: annular, 5: total), and @z is the
eclipse percentage (if any). Return value is whether to display the event. For
example, to display eclipses for this year (at least those in effect when
corresponding aspect is exact) do: astrolog -n -dy =Yu ~d "Gt @y 0"
~dv <string>: Determine void of course times. Called when the transit to transit
times chart (-d switch) decides whether an aspect indicates a void of course event.
On entry, @v is 0 if checking whether this event starts void of course and @v is 1
if checking whether this event ends void of course, @w is the first object forming
the event, @x is the aspect or other event (-1: sign change, -2: direction change, -
3: degree change, -5: latitude direction change, -6: distance direction change, -7:
latitude zero crossing, -8: distances equal), @y is the second object forming the
event (or new sign if that event), and @z is the default decision for whether this
marks void of course moon. Return value is ignored, although if @z is changed it
will be the new indicator for void of course. For example, to detect and display
void of course Sun times (i.e. the period between the last aspect the Sun makes
before the Sun enters the next sign) instead of void of course Moons, do: ~dv
"=z ?: @v And Equ @w O_Sun Equ @x -1 And Equ @w O_Sun Gt @x 0"
~t <string>: Filter transit to natal events. Called for each event in the -t switch
chart. On entry, @x is the first object forming the event, @y is the aspect (or -4
for 3D house change), @z is the second object forming the event (or destination
house if 3D house change). Return value is whether to display the transit. For
example, to only display transit events taking place on weekends, do: ~t "=a
DayWeek Mon Day Yea Or Equ @a 0 Equ @a 6"
~O <string>: Adjust object position. Called each time a chart is cast, and allows
changing objects’ positions. On entry, @v is the object index, @w is the object’s
zodiac position, @x is the object’s ecliptic latitude, @y is the object’s zodiac
position velocity (negative for retrograde), and @z is the object’s vertical
velocity. Return value is ignored, although if you update @w through @z the
object’s positions and velocities will be updated. For example, to invert all zodiac
positions 180 degrees for charts in the southern hemisphere located south of the
equator, do: ~O "=w Add @w 180.0 Lt Lat 0.0"
~C <string>: Adjust house cusp position. Called each time a chart is cast, and
allows changing house cusp positions. On entry, @x is the house cusp (1-12), @y
is the cusp’s zodiac position, and @z is the cusp’s 3D house position. Return
value is ignored, although if @y and @z are changed the cusp’s positions will be
updated. For example, Astrolog supports Null houses or the “0 Aries” system, an
equal house system in which the 1st house cusp is always 0Aries. Suppose you
want a “0 Leo” house system in which the 1st house cusp is always 0Leo? This
can be done with: ~C "=y Mul Sub Add S_Leo @x 2 30.0"
~A <string>: Redefine aspect orb. Called for each cell whenever the aspect grid
is internally composed. (The internal aspect grid is used by multiple charts which
show aspects, and not just the -g aspect grid itself.) On entry, @v and @x are the
two objects potentially being aspected, @w is the aspect (which will be A_Par or
A_CPr when doing parallel and contraparallel aspects), @y is the difference in
angle between them (negative for applying and positive for separating), and @z is
the default max orb. Return value is ignored, although if @z is changed it will be
the new max orb to use. For example, to have separating aspects have 70% the
orb of applying aspects, do: ~A "If Gt @y 0.0 =z Mul @z 0.70"
~p[0] <string>: Adjust progression. The ~p string AstroExpression is called
whenever a chart is about to be secondary progressed, and the ~p0 string is called
whenever a chart is about to be solar arc progressed. (Mixed progressions that do
solar arc for cusps and secondary for planets will call both.) On entry, @x is the
Julian time of the natal chart, @y is the Julian time to use for progressed house
cusps (which may be different from planets if the -pC switch cusp move ratio is
set), and @z is the Julian time to use for progressed planets (or the offset for ~p0).
Return value is ignored, although @z (and also @y for ~p) can be modified to
change the progressed results. For example, to have progressions move at a
logarithmic rate (fast early in life, and continually slowing down over time) in the
manner presented by A.T. Mann, do: ~p0 "=z Mul Sgn2 Sub @x @y Sub Mul
Log10 Add Div Div Abs Sub @x @y 365.242199 0.076661459 10 120 120"
~kO <string>: Customize object color. Called each time an object glyph is
displayed, and allows one to change its color. On entry, @y is the object, and @z
is the default color. Return value is ignored, although if @z is changed it will be
the new color to use. For example, to make planets colored the same as the zodiac
sign they’re located within, do: ~kO "=z ObjCol Dec Add O_Asc LonSign
ObjLon @y"
~kA <string>: Customize aspect color. Called each time an aspect line is drawn
between two planets in a wheel chart, and allows one to change its color. On
entry, @w and @y are the two objects being aspected, @x is the aspect, and @z
is the default color. Return value is ignored, although if @z is changed it will be
the new color to use. For example, to change the color of aspect lines involving
the Sun or Moon to magenta, do: ~kA "If Or Lte @w O_Moo Lte @y O_Moo
=z K_Mag"
~kv <string>: Adjust wheel section color. On entry, @x contains the section type
(0 = sign, 1 = house, 2 = Gauquelin sector), @y contains the index (i.e. which
sign, house, or sector), and @z contains the RGB color to use for it based on the -
Xv switch setting. Return value is ignored, although if @z is changed it will be
used instead. For example, to give signs colors of the rainbow, but with red
starting at the Sun’s position in the zodiac, do: ~kv "If Equ @x 0 =z Blend
_YXk ?: _Xr K_White K_Black Hue Sub Mul Dec @y 30 ObjLon O_Sun Div
_XI1 100.0"
~F[O/C/A] <string>: Font adjustment. Called each time a real font character is
displayed in the Windows version, and allows customizing its display. This can be
used to change which glyphs are displayed for which characters, and where. On
entry, custom variable @u is Astrolog’s index for what’s being drawn (i.e. which
sign, object, house, or aspect depending on the command switch defined), @v is
the font character (usually between 32-127 for low Ascii), @w is the font index
(1=Wingdings, 2=Astro, 3=Enigma, 4=Hamburg, 5=Astronomicon, 6=Courier,
7=Consolas, 8=Arial), @x and @y are the pixel coordinates where the glyph will
be drawn (which can be adjusted to move glyphs that seem off-center), and @z is
the relative scale percentage (which can be adjusted for glyphs that seem too large
or too small). Return value is ignored, although if any of @v through @z are
modified they will be used to draw the glyph instead. For example, to randomly
display sign glyphs using one of the first three fonts available, do: ~F "=w Rnd 1
3 =v Add @u ?: Equ @w 1 93 ?: Equ @w 2 64 ?: Lte @u 9 48 ?: Equ @u 10
38 ?: Equ @u 11 34 49"
~v <string>: Adjust object ordering. Called each time a chart is cast, and allows
changing the order in which objects are listed in charts. This affects all lists of
objects, including aspect grids. It will also affect the order in which individual
aspects are printed, e.g. if ~v places the Moon in order before the Sun, then
aspects will be printed as "Moon Con Sun" (and not “Sun Con Moon” as based on
the default object ordering). On entry, custom variable @z is both the object index
and its default ordering. Return value is ignored, although if @z is changed it will
be the new ordering to use (ties are broken in favor of the object with the earlier
index). For example, to always display Ceres between Mars and Jupiter (instead
of after all the main planets) do: ~v "If Equ @z O_Cer =z O_Mar"
~v3 <string>: Adjust sign division. Called when a sign division is about to be
drawn in a wheel chart, as done when the -v3 switch is on. On entry, @w contains
the size of the current division in degrees, @x is the sign from 1-12, @y is the
section index within the sign (starting with 0), and @z is the object index or other
value to use to label the section. Return value is ignored, although @w and @z
can be changed to change the size of the division and how to label it. If @z is
between -1 and -12 the section will be labeled with a sign instead of a planet, if
@z is -100 or lower it will be labeled with a number that’s 100 plus that number
(e.g. -100 is 0, -101 is 1, and so on), and if @z is between -13 and -99 then the
section won’t be labeled at all. For example, to mark terms using the Chaldean
method, in which the five subdivisions of each sign are progressively one degree
smaller, do: ~v3 "=a 64735 =b 47356 =c 73564 =d 56473 =w Sub 8 @y =z Mod
Div Var Inc Mod Dec @x 4 Pow 10 Sub 4 @y 10"
~XL <string>: Adjust city color. On entry, @w is the index of the city, @x and
@y are the city’s longitude and latitude, and @z is the current color to use for it.
Return value is ignored, although if @z is changed it will be the new color to use
to display the city’s point. If this color index is invalid (outside the range of 0-15)
then the city will be skipped and not drawn at all. For example, to only draw those
cities within 45 degrees of the chart location, do: ~XL "If Gt PolDist Lon Lat
@x @y 45 =z -1"
~Xt <string>: Notify sidebar. Called when the wheel chart sidebar is about to be
drawn. This works well with the -YXt switch to add computed numeric values to
the sidebar. For example, if you want the current obliquity of the ecliptic and the
right ascension of the MC to always be displayed in the sidebar, do: -YXt
"Obliquity: \A\nRAMC: \B" ~Xt "=a Oblique =b RAMC"
~XQ <string>: Adjust key. This can be used to customize key assignments, and
is called whenever the user presses a key in the window. (This only applies to
non-Windows GUI versions, in which the Windows GUI version should instead
use the ~WQ switch below.) On entry, @z is the Ascii value of the key pressed
(in which the function keys to invoke macros have numbers 201-248). Return
value is ignored, although if @z is changed it will be the new key to process
instead. For example, to disable the Escape and Ctrl+c keys so they don’t exit the
program, do: ~XQ "If Or Equ @z 27 Equ @z 3 =z -1"
~WQ <string>: Adjust menu command. This can be used to customize menu
command assignments, and is called whenever the user selects a menu command
in the Windows version. (This only applies to the Windows GUI version, in
which the non-Windows GUI versions should instead use the ~XQ switch above.)
On entry, @z is the index of the menu command selected (as defined in the source
file resource.h, with values starting at 40001). Return value is ignored, although if
@z is changed it will be the new menu command to process instead. For example,
to make the w/a/s/d keys behave the same as the arrow keys, do: ~WQ "If Equ
@z 40082 =z 40289 If Equ @z 40131 =z 40244 If Equ @z 40281 =z 40290 If
Equ @z 40086 =z 40243"
~U <string>: Filter extra star output. On entry, custom variable @v is the star
index, @w is the star’s zodiac position longitude, @x is the star’s latitude, @y is
the star’s velocity, and @z is the star’s magnitude. Return value is whether to
display the star. Also, @w through @z may be changed to adjust the star’s data.
For example, to only display stars brighter than magnitude 3.0 (which will reduce
the number of stars from over 1000 to 172) do: ~U "Lt @z 3.0"
~U0 <string>: Filter extra asteroid output. On entry, custom variable @w is the
asteroid index, @x is the asteroid’s zodiac position longitude, @y is the asteroid’s
latitude, and @z is the asteroid’s velocity. Return value is whether to display the
asteroid. Also, @x through @z may be changed to adjust the asteroid’s data. For
example, to only display asteroids that are located within 10 great circle degrees
from the Sun, do: ~U0 "Lt PolDist @x @y ObjLon O_Sun ObjLat O_Sun
10.0"
~q[1-2] <string>: Notify chart cast. The ~q1 string AstroExpression is called
whenever a chart is about to be cast, and the ~q2 string is called whenever a chart
has just been cast. This is designed to be used along with other AstroExpression
hooks that adjust chart casting, when there’s initialization or finalization code
needed. (For example, when the ~O hook is called, it can’t tell whether it’s the
first or last object being adjusted.)
~Q[1-3] <string>: Notify chart display. These are designed to be used along with
other AstroExpression hooks that adjust chart display, when there’s initialization
or finalization code needed. The ~Q1 string AstroExpression is called whenever a
chart is about to be displayed (which allows, for example, drawing initial content
behind everything else). The ~Q2 string is called whenever a chart has just been
displayed (which allows drawing final content over everything else). The ~Q3
string is called after a chart has been displayed on the screen and the screen
updated (which allows, for example, displaying a message to the user after an
update has been drawn and can be seen by the user).
~5s <string>: Adjust chart list custom sort order. This is called when the -5s
switch is invoked. For each chart in the chart list, the chart will be cast, and then
the AstroExpression called. On entry, @z is the current chart’s index within the
chart list. The return value is the weight to give this chart, to be used when
sorting. (After all charts have been given weights, the chart list will be sorted
from lowest to highest weight.) For example, to sort by Sun/Moon angle (which
will place New Moon charts first in the list and Full Moon charts last) do: ~5s
"LonDist ObjLon O_Sun ObjLon O_Moo" -5s
~5f <string>: Adjust chart list custom filter. This is called when the -5f switch is
invoked (and also in the Windows version in the Chart List dialog when the
“Filter” button is pressed). For each chart in the chart list, the chart will be cast,
and then the AstroExpression called. On entry, @z is the current chart’s index
within the chart list. The return value is whether to keep the chart in the list (in
which zero means delete it). For example, to only show charts from the chart list
which have the “Moon in the 7th house and Jupiter aligned [Conjunct] with
Mars”, do: ~5f "And Equ ObjHouse O_Moo 7 Equ AspLon O_Jup O_Mar -1
A_Con" -5f "" ""
~5Y <string>: Notify chart list enumeration. This is called when the -Y5 or -5Y
switch is invoked. For each chart or chart pair in the chart list, the chart(s) will be
cast, and then the AstroExpression called. On entry, no custom variables are set,
and return value is ignored too. However AstroExpression variables List1 (and
List2) will be the index of the current chart(s) being considered. For example, to
check which chart in the chart list forms the most Trine aspects to a natal chart
(i.e. to transfer that chart to slot #2), first load the natal chart in slot #1, then do:
~5Y "DoGrid2 False =c 0 For %i 0 Objs If ObjOn @i For %j 0 Objs If
ObjOn @j Do =e GridNam @i @j If Equ @e A_Tri =c Inc @c If Gt @c @d
Do =d @c =a List1" ~1 "=d 0" -Y52 -qL2 ~@a
~5i <string>: Filter Astrodatabank import. This is only called when the -Y5I
switch is set. On entry, the set of custom variables indicated by -Y5I will be set
based on the number of times the corresponding custom strings were found within
the chart record. Return value is whether to accept the current record in the file,
and add it to the chart list. For example, to only load ADB chart records for
people who have at least three different psychological conditions at the same
time, do: ~2 1 ">Diagnoses : Psychological :" -Y5I 1 1 -~5i "Gte @a 3"
~M <0-26> <string>: Define AstroExpression macro: Similar to command
switch macros, you can define custom AstroExpression macro functions. The first
 parameter is the macro slot to fill, and the second is the AstroExpression to place
within it. Macros can be called in AstroExpressions with the “Macro <arg>”
function, in which parameter <arg> is the macro index to call.
~1 <string>: Run expression. This simply parses the string as an
AstroExpression, and does nothing else. This is very similar to the “~” switch
except that also displays the final result. This switch is good to use in a command
switch file (to for example initialize custom AstroExpression variables) when you
don’t want popup messages interrupting anything.
~2[0] <index> <string>: String and string list setting. Astrolog has a set of
custom string variables, parallel to its list of custom numeric variables. The ~2
switch will set the custom string at the given index, to the specified string. If this
switch is invoked as ~20 instead, then it will instead set a range of strings at once,
starting with the index. The first character in the string parameter will be a
separator, in which each instance of that separator character will be a dividing
point between strings. For example, to set custom string 4 to “Apple”, 5 to
“Banana”, and 6 to “Carrot”, do: ~20 4 ";Apple;Banana;Carrot"
~0: Disable AstroExpressions. AstroExpressions are often hooks inserted into
program operation, which means they may be evaluated on every screen update.
Therefore, they automatically get disabled if there’s an error parsing one, to avoid
a continuous stream of errors. The ~0 switch disables all AstroExpression hooks
in the current program session, which means “_~0” can be used to reenable them.
In the Windows version, the “Enter Command Line” dialog has a “Enable
AstroExpression Hooks” checkbox, which can be used to enable, disable, or
check their status.
One final feature is that parsing of all numeric dialog fields and command switches can
use AstroExpressions. If the parameter starts with a tilde (~) character, then the rest of it
will be parsed as an AstroExpression. If an AstroExpression parameter to a command
switch is complicated (i.e. has spaces within it), then surround the parameter in single or
double quotes, to ensure it gets treated as a single parameter to that switch. For example,
to find and restrict the first unrestricted object, do: =R "~=b 0 For %a 0 Objs If ObjOn
@a Do =b @a =a Objs @b"
AstroExpressions are effectively their own programming language, which means that
they can do general computing tasks not related to astrology, such as implement games.
To demonstrate this, the script file [Link] in the source subdirectory of any
Astrolog download contains a sample game in which a random Maze is drawn over the
wheel chart, and you use the keyboard to solve the Maze. You can change the size of the
Maze, and the time it takes you to get through is displayed upon reaching the exit. :)
 COMPILING INSTRUCTIONS
Compiling Astrolog is very similar to the process of compiling most other programs:
First edit the top of the file astrolog.h, commenting out any of the #define’s which set
various features that aren't valid on your system or you don't want, and changing default
values and directories to your preference. (Just see the self-explanatory section comments
in this file.) Then in the same manner, also edit these default parameter values in the
[Link] file to your liking, at least the location and time zone values. (I also
recommend turning on the Ansi color feature if your system will support it, since text
charts look much nicer in color.)
For Unix systems, just run the command “make” in the directory containing the file
“Makefile”. You can also always compile by hand with a command line like: “cc -O -c
*.cpp; cc -o astrolog *.o -lm -lX11”. Just make sure to compile each source file and link
them together at the end with the math library, and if applicable the X11 library. If
compiling with GNUC, also add “-ldl” to the linker line. Note that some Macs support X
Windows, so modern Macs can compile using this method too.
It is possible to compile Astrolog on a VMS system, even with its X windows
functionality. There’s an example of a simple VMS .COM file in the source code
distribution which can automatically compile and link Astrolog on VMS, which should
work for the current version, although you might need to include “/noopt” after the CC’s
since some compilers may cause the program to pass parameters incorrectly with
optimization on.
To compile the Astrolog source code for Windows, the #define WIN compile time flag
needs to be uncommented in astrolog.h (this should of course be commented out for all
other platforms). In addition, the PC flag should be uncommented, while the flags for
other graphics libraries like X11 should be commented out. Pretty much all of the
features in the features section should be on, such as INTERPRET, as well as some of the
system settings like TIME, because there are menu options that deal with them that won't
automatically disappear if they’re disabled. The included file [Link] may be
used as a project file or makefile. Ensure “Project / Astrolog Properties / Configuration
Properties / Linker / System / Subsystem” is set to “Windows
(/SUBSYSTEM:WINDOWS)” so it will be compiled as a Windows program. Also
manually add [Link] and [Link] to the “Project / Astrolog Properties /
Configuration Properties / Linker / Command Line / Additional Options” area, because
they may not be automatically detected based on #include files. If you want the C runtime
to be statically linked instead of requiring the right runtime DLL to be present, then set
“Project / Astrolog Properties / Configuration Properties / C/C++ / Code Generation /
Runtime Library” to “Multi-threaded (/MT)” instead of “Multi-threaded DLL (/MD)”.
The standard Windows executable was compiled as a 32 bit application using Microsoft
Visual Studio 2019 version 16.11.25. Other Windows compilers should work, provided
they have a resource compiler which understands the standard .rc extension resources for
menus and dialogs. Astrolog’s source code can compile 64 bit instances of the Windows
version too. The Windows About dialog and the -Hc switch display will indicate whether
a 32 or 64 bit version of the program is running. Internally, the sources look for the
compiler set #define _WIN64 to indicate 64 bit specific content.
To compile a command line only interface (CLI) version of Astrolog on Windows, turn
off WIN in astrolog.h before compiling. Also in “Project / Astrolog Properties /
Configuration Properties / Linker / System”, set Subsystem to “Console” (instead of
“Windows” which starts with the standard Windows GUI).
The command line only version of Astrolog on Windows can also bring up a generic
window with the -X switch, when the WCLI #define is uncommented when compiling.
This is different from the standard Windows version (which is a full windowed program
and not a command line program). The WCLI window won’t have a menu bar, but it will
still accept keypresses and mouse clicks. It’s basically a Windows version of the X11 and
Mac graphics versions, just compiled for Windows instead of those alternate platforms.
The WCLI version is more limited, but useful for testing the generic windowing features
of the program without having to go to different platforms.

ASTROLOG HISTORY
This is a comprehensive history list of the 38 versions of Astrolog that have been released
since its beginning. Below is a listing of all versions of Astrolog that have been released,
after which for each version, is listed the description of the new features and changes
added to that version.
Num Vers. Release Date Features added to
version
1 1.00 Wed 11 Sep 91 [Link] UTC Initial planet
calculations
2 1.10 Sat 14 Sep 91 [Link] UTC Aspects, different
house systems
3 1.20 Fri 20 Sep 91 [Link] UTC File input, wheels,
relationships
4 1.30 Wed 9 Oct 91 [Link] UTC Transits, searches,
astro-graph
5 1.40 Tue 12 Nov 91 [Link] UTC Restrictions, other
conveniences
6 2.00 Wed 11 Dec 91 [Link] UTC X charts, multiple
source files
7 2.10 Tue 18 Feb 92 [Link] UTC Color, more X charts,
local space, more progression and file support
8 2.20 Wed 3 Jun 92 [Link] UTC Stars, space charts,
influences, default settings, more relationships
9 2.25 Thu 18 Jun 92 [Link] UTC Bug fixes over v2.20
10 2.30 Fri 12 Sep 92 [Link] UTC Interpretations,
source code comments
11 2.40 Wed 20 Jan 93 [Link] UTC Ansi text color,
midpoint lists
12 3.00 Sun 21 Mar 93 [Link] UTC PC Graphics, more
interpretations
13 3.05 Thu 20 May 93 [Link] UTC Bug fixes over v3.00
14 3.10 Sun 26 Sep 93 [Link] UTC Transit influences,
efficiency
15 4.00 Wed 5 Jan 94 [Link] UTC Placalc ephemeris,
PostScript, metafiles, better wheel charts
16 4.10 Mon 21 Mar 94 [Link] UTC Improvements, bug
fixes over v4.00
17 4.20 Fri 23 Sep 94 [Link] UTC New files,
constellations, macros, new objects, dispositors
18 4.30 Mon 28 Nov 94 [Link] UTC Parallel aspects, bug
fixes
19 4.40 Sun 12 Feb 95 [Link] UTC Macintosh support,
Arabic parts
20 5.00 Mon 24 Jul 95 [Link] UTC Windows interface,
Placalc asteroid ephemeris
21 5.05 Sun 20 Aug 95 [Link] UTC Bug fixes over v5.00
22 5.10 Sun 31 Dec 95 [Link] UTC Chart printing,
setting saving
23 5.20 Sun 24 Mar 96 [Link] UTC Gauquelin sectors,
printing fixes
24 5.30 Mon 30 Sep 96 [Link] UTC Mac graphics, tri and
quad-wheels
25 5.40 Thu 24 Dec 98 [Link] UTC Indian style charts
26 6.00 Mon 22 Dec 15 [Link] UTC Swiss Ephemeris
planets, Esoteric Astrology, GNU license
27 6.10 Sun 20 Mar 16 [Link] UTC Swiss Ephemeris
houses, true and topocentric positions
28 6.20 Mon 20 Mar 17 [Link] UTC 3D houses, bug fixes
29 6.30 Mon 23 Oct 17 [Link] UTC Chart spheres, 3D
aspects, transit graphs, Swiss Ephemeris stars
30 6.40 Sun 22 Jul 18 [Link] UTC 3D wireframes, 3D
orbs, barycentric positions, many stars
31 6.50 Tue 23 Jul 19 [Link] UTC 3D astro-graph, star
distances
32 7.00 Tue 5 Jun 20 [Link] UTC Atlas, eclipses, many
asteroids, context menus, AstroExpressions
33 7.10 Tue 1 Oct 20 [Link] UTC Telescope chart,
nearest cities chart, planetary moons, more fonts
34 7.20 Mon 12 Apr 21 [Link] UTC Dwarf planet and moon
objects, detailed maps and backgrounds
35 7.30 Sat 11 Sep 21 [Link] UTC Visibility chart,
filled and 5/6 chart wheels, More 3D house models
36 7.40 Fri 1 Apr 22 [Link] UTC Chart lists, Other
file formats, Unicode characters
37 7.50 Sat 10 Sep 22 [Link] UTC Midpoint dial chart,
Indian style wheels, Atmospheric refraction
38 7.60 Sun 9 Apr 23 [Link] UTC Distance aspects,
Dwarf planet moons, more rings, more Indian wheels

All of the above versions of Astrolog except 2.25, 3.05, and 5.05 and beyond, were
posted in direct source file, shell archive, and/or zip archive form to the Usenet
newsgroup [Link]. Versions 2.10, 2.25, 3.05 and 4.10 were submitted in shell
archive format to [Link]. In addition, version 1.30 was also posted to
[Link]. Beta releases of versions 5.20, and 6.40 and beyond were created
but not made generally available. (Many thanks to those who have tested beta or release
versions of the program, and have sent bug reports or other feedback! :) Version 5.40 was
released for Windows in both 16 bit and 32 bit architectures. Versions 6.30 and beyond
were released for Windows in both 32 bit and 64 bit architectures.

LICENSE
IMPORTANT NOTICE: Astrolog and all chart display routines and anything not
enumerated below used in this program are Copyright (C) 1991-2023 by Walter D. Pullen
(Astara@[Link], [Link] Permission is granted to freely
use, modify, and distribute these routines provided these credits and notices remain
unmodified with any altered or distributed versions of the program.
The main ephemeris databases and calculation routines are from the library SWISS
EPHEMERIS and are programmed and copyright 1997-2008 by Astrodienst AG. The use
of that source code is subject to the license for the Swiss Ephemeris Free Edition,
available at [Link] This copyright notice must not be changed
or removed by any user of this program.
Additional ephemeris databases and formulas are from the calculation routines in the
program PLACALC and are programmed and Copyright (C) 1989,1991,1993 by
Astrodienst AG and Alois Treindl (alois@[Link]). The use of that source code is subject
to regulations made by Astrodienst Zurich, and the code is not in the public domain. This
copyright notice must not be changed or removed by any user of this program.
The original planetary calculation routines used in this program have been copyrighted
and the initial core of this program was mostly a conversion to C of the routines created
by James Neely as listed in 'Manual of Computer Programming for Astrologers', by
Michael Erlewine, available from Matrix Software.
Atlas composed using data from [Link] licensed under a Creative
Commons Attribution 4.0 License. Time zone changes composed using public domain
TZ database: [Link]
The PostScript code within the core graphics routines are programmed and Copyright (C)
1992-1993 by Brian D. Willoughby (brianw@[Link]).
More formally: This program is free software; you can redistribute it and/or modify it
under the terms of the GNU General Public License as published by the Free Software
Foundation; either version 2 of the License, or (at your option) any later version. This
program is distributed in the hope that it will be useful and inspiring, but WITHOUT
ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
more details, a copy of which is in the [Link] file included with Astrolog, and
at [Link]
O*O*O*O*O*O*O*O*O*O*O*O*O*O*O*O*O*O*O*O*O*O*O*O*O*O*O*O*O*O*
O*O*O*O*O*O*O*O
* Walter D. "Cruiser1" Pullen :) !
Astara@[Link] *
O Astrolog 7.60 Web site:
[Link] O
* "Who am I, What am I? As I am, I am not. But as we are,
I AM. And to *
O you my creation, My Perfect Love is your Perfect Freedom.
And I will be O
* with you forever and ever, until the End, and then forever
more." - GOD *
O*O*O*O*O*O*O*O*O*O*O*O*O*O*O*O*O*O*O*O*O*O*O*O*O*O*O*O*O*O*
O*O*O*O*O*O*O*O