These are lines on which the first character is an asterisk (*) or one or more plus signs (+). These allow definition types to be specified. Any text lines following a keyword line will be used as text relating to whatever item was defined on the keyword line.

The following list shows all of the available types of keyword lines which may legitimately appear in a Solar Writer interpretations file. (Also check the on-line help file and ‘readme’ file supplied with the program to find any recent changes.)  Each keyword line type is identified by its ‘Internal Name', which is not for use in the interpretations file - it is simply a label by which each keyword type may be uniquely identified. The 'Syntax' indicates how that type of keyword line must appear in the interpretations file, as explained further below.

Syntax Rules for keyword lines

•Words in plain (non-italic) text must appear as shown

•Words in italic text are the names of Word Sets, and an item from the appropriate word set list shown below must be inserted.

•Words in brackets [] are optional

•Words separated with vertical bar | indicate alternatives from which one must be chosen

•All of the following words are ignored by the compiler, so may be used wherever desired within any keyword line: 'if', 'the', 'of', 'is', 'in', 'a', 'an', 'with', ‘to’, ‘from’.

Word Sets

•x = an integer (1, 2, 3...)

•nth = 1st, 2nd, 3rd, 4th, 5th, 6th, 7th, 8th, 9th, 10th, 11th, 12th, Quesited

•Sign = Aries, Taurus, Gemini, Cancer, Leo, Virgo, Libra, Scorpio, Sagittarius, Capricorn, Aquarius, Pisces

•SignType = Masculine, Feminine, Cardinal, Fixed, Mutable, Fire, Earth, Air, Water

•Planet = Moon, TheEarth, Sun, Vulcan, Mercury, Venus, Mars, Jupiter, Saturn, Uranus, Neptune, Pluto, Chiron, Vesta, Pallas, Juno, Ceres, Hygeia, Astraea, NorthNode, SouthNode, Ascendant, Midheaven, Vertex, East Point, PartFortune, Cupido, Hades, Zeus, Kronos, Apollon, Admetos, Vulcanus, Poseidon, TransPluto, Lilith, PlanetaryHourRuler, PlanetaryDayRuler

•Aspect = Conjunct, Opposite, Trine, Square, Sextile, Semisquare, Sesquisquare, Quincunx, Semisextile, Soft, Hard, Antiscion, Contra-Antiscion, Aspects, Aspect

•Dignity = Rulership, Exaltation, Triplicity, Term, Face, Detriment, Fall, Peregrine, Combust, Rulership/Exaltation/Triplicity, DignifiedNotCombust, Detriment/Fall, Direct, Retrograde

•RulerType = Sign, Exaltation, DiurnalTriplicity, NocturnalTriplicity, InSectTriplicity, OutOfSectTriplicity, ParticipatingTriplicity, Term, Face

•Complexion = Hot, Cold, Wet, Dry, Sanguine, Choleric, Melancholic, Phlegmatic, Balanced

•RulershipLevel = Modern, Traditional, Esoteric, Hierarchical

•HouseType = Angular, Succedent, Cadent

•ndeg = 0, 1, 2, 3, ..., 29

Notes on nth

•This refers to house number. The item ‘Quesited’ is for use in horary reports, and refers to whichever house number (1 to 12) the user has indicated to use as the quesited house. For reports that wish to use this option, the project file (*.swp) must have an entry "GetQuesitedHouse=1", in which case the user will be prompted to enter a house number which represents the quesited before the report is generated.

Notes on Aspect

•‘Soft’ means Conjunct, Trine or Sextile

•‘Hard’ means Opposition, Square, SemiSquare, SesquiSquare or Quincunx

•‘Antiscion’ means conjunction with the antiscion point of a planet

•‘Contra-Antiscion’ means conjunction with the contra-antiscion point of a planet

•‘Aspect’ or ‘Aspects’ means forming any aspect in the aspect set being used in the report

Notes on RulerType and Dignity

•Ruler types for all keyword lines involving the RulerType and Dignity word sets use the level of rulerships defined in the almuten file for the project. This is always the Traditional rulership level (i.e. excluding the outer planets) unless you have specifically changed it by editing or replacing the project’s almuten file. This level of rulerships applies to these keywords regardless of which level of rulerships has been selected with any preceding kwRulershipLevel keyword line.

Syntax Example

*Planet [is] [in] Dignity

1.Planet is the "word set" of planet names, from which one must be chosen (e.g. 'Venus')

2.The words 'is' and 'in' may optionally also appear

3.Dignity is the "word set" of dignity types, from which one must be chosen (e.g. 'Exaltation')

4.This could therefore be written as: Venus is in Exaltation, Venus in Exaltation, Venus Exaltation.

List of Allowable Keywords

Note: This list may be updated after this manual is published. It is recommended that you refer to the list in the built-in help system for the most up-to-date list.

kwSection

         *Section x

This is used to indicate where a section of the report begins, and the number following the 'Section' keyword denotes the nesting level of the section. The main title of the report should be given the level number zero (ie 'Section 0'), and subsequent sections should be given level numbers of 1 (or more than 1 for subsections). The text following this keyword line is taken as the title of the section, and this will be written as a section title into the final report.

kwIntroduction

         *Introduction

This is used to indicate that the following text will always appear in the report. This text cannot be switched off by the user. Its main purpose is to provide brief introductory text to sections of the report.

kwExplanation

         *Explanation

This is used to indicate that the following text should appear in the report provided that the user has selected the option for explanation text to be included in the report. Typically each section in the report might start with an '*Introduction' keyword line followed by brief introductory text, and then an '*Explanation' keyword line followed by a more detailed explanation.

kwKeywordTitlesOn

         *KeywordTitlesOn

This is used to set the author's preference for whether or not keyword titles are shown in the report from this point onwards (until the end of the report, or until another keyword of this kind is encountered). The user may override this preference when the report is produced by altering a setting in the program.

kwKeywordTitlesOff

         *KeywordTitlesOff

This is used to set the author's preference for whether or not keyword titles are shown in the report from this point onwards (until the end of the report, or until another keyword of this kind is encountered). The user may override this preference when the report is produced by altering a setting in the program.

kwRulershipLevel

         *RulershipLevel Rulerships

This is used to determine which set of rulerships is used when finding the rulers (dispositors) of the signs and decanates. If this keyword type is not present, then the default rulership level is ‘Traditional’. It is possible to change the rulership level at any place in the report - it may be changed many times, e.g. alternating between modern and esoteric rulerships. However, note that this keyword type has no effect on keyword lines involving RulerType and Dignity, as explained above.

kwPlanet

         *Planet

This is used to provide text relating to a planet in general e.g. an explanation of what that planet's symbolic meaning is, regardless of where it is in any chart. This would typically precede other keywords which give interpretations of that planet in each sign or house.

kwPlanetInSign

         *Planet [is] [in] Sign

This is used to provide text relating to a planet in a specific sign i.e. an explanation of what that planet's symbolic meaning is in that sign, if this placement occurs in the chart being used to generate the report.

kwPlanetInHouse

         *Planet [is] [in] nth House

This is used to provide text relating to a planet in a specific house i.e. an explanation of what that planet's symbolic meaning is in that house, if this placement occurs in the chart being used to generate the report.

kwAnyPlanetInHouse

         *[A] Planet [is] [in] nth House

kwPlanetDignified

         *Planet [is] Dignified

Rulerships are always Traditional (i.e. excluding the outer planets)

kwPlanetDebilitated

         *Planet [is] Debilitated

Rulerships are always Traditional (i.e. excluding the outer planets)

kwPlanetOriOcci

         *Planet [is] [Oriental|Occidental]

kwPlanetAspectsHouseRuler

         *Planet Aspect Ruler [of] [the] nth House

Rulerships are Traditional (i.e. excluding the outer planets) unless a kwRulershipLevel keyword line is present somewhere before this keyword.

kwPlanetAspectPlanet

         *Planet Aspect Planet

kwPlanetApplyingAspectPlanet

         *Planet Approaches Aspect Planet

kwPlanetHouseType

         *Planet [is] [in] [a] [Angular|Succedent|Cadent] House

kwPlanetWaxing

         *Planet [is] [Waxing|Waning]

kwPlanetInDignity

         *Planet [is] [in] Dignity

Rulerships are always Traditional (i.e. excluding the outer planets)

kwPlanetInPlanetDignity

         *Planet [is] [in] Dignity [of] Planet

Rulerships are always Traditional (i.e. excluding the outer planets)

kwPlanetRulerInSign

         *Ruler [of] Planet [is] [in] Sign

Rulerships are Traditional (i.e. excluding the outer planets) unless a kwRulershipLevel keyword line is present somewhere before this keyword.

kwPlanetRulerInHouse

         *Ruler [of] Planet [is] [in] nth House

Rulerships are Traditional (i.e. excluding the outer planets) unless a kwRulershipLevel keyword line is present somewhere before this keyword.

kwPlanetRulerIsPlanet

         *Ruler [of] Planet [is] Planet

Rulerships are Traditional (i.e. excluding the outer planets) unless a kwRulershipLevel keyword line is present somewhere before this keyword.

kwPlanetRulerAspectPlanet

         *Ruler [of] Planet Aspect Planet

Rulerships are Traditional (i.e. excluding the outer planets) unless a kwRulershipLevel keyword line is present somewhere before this keyword.

kwHouseRulerIsPlanet

         *Ruler [of] nth House [is] Planet

Rulerships are Traditional (i.e. excluding the outer planets) unless a kwRulershipLevel keyword line is present somewhere before this keyword.

kwGenitureIsPlanet

         *Ruler [of] [the] Geniture [is] Planet

kwAlcocodenIsPlanet

         *Alcocoden [is] Planet

kwPlanetAlmutenIsPlanet

         *Almuten [of] Planet [is] Planet

kwBirthHemisphere

         *[Northern|Southern] Hemisphere Birth

kwBirthDayNight

         *[Diurnal|Nocturnal] Birth

kwPlanetIsHouseRuler

         *Planet [is] [in] [the] nth House

Rulerships are Traditional (i.e. excluding the outer planets) unless a kwRulershipLevel keyword line is present somewhere before this keyword.

kwHouseRulerInHouse

         *Ruler [of] [the] nth House [is] [in] [the] nth House

Rulerships are Traditional (i.e. excluding the outer planets) unless a kwRulershipLevel keyword line is present somewhere before this keyword.

kwRiseOrder

         *Planet [Rises|Sets] [Before|After] Planet

kwPlanetRulerDignified

         *Ruler [of] Planet [is] Dignified

Rulerships are always Traditional (i.e. excluding the outer planets)

kwPlanetRulerInDignity

         *Ruler [of] Planet [is] [in] Dignity

Rulerships are always Traditional (i.e. excluding the outer planets)

kwHouseRulerDignified

         *Ruler [of] [the] nth House [is] Dignified

Rulerships are always Traditional (i.e. excluding the outer planets)

kwHouseRulerInDignity

         *Ruler [of] [the] nth House [is] [in] Dignity

Rulerships are always Traditional (i.e. excluding the outer planets)

kwHouseRulerAspectPlanetRuler

         *Ruler [of] [the] nth House Aspect Ruler [of] Planet

Rulerships are Traditional (i.e. excluding the outer planets) unless a kwRulershipLevel keyword line is present somewhere before this keyword.

kwHouseRulerAspectHouseRuler

         *Ruler [of] [the] nth House Aspect Ruler [of] [the] nth House

Rulerships are Traditional (i.e. excluding the outer planets) unless a kwRulershipLevel keyword line is present somewhere before this keyword.

kPlanetInDecan

         *Planet [is] [in] [the] nth Face [of] Sign

kPlanetRulerInDecan

         *Ruler of Planet [is] [in] [the] nth Face [of] Sign

Rulerships are Traditional (i.e. excluding the outer planets) unless a kwRulershipLevel keyword line is present somewhere before this keyword.

kPlanetAlmutenInDecan

         *Almuten [of] Planet [is] [in] [the] nth Face [of] Sign

kwAnyPlanetAspectPlanetInDecan

         *[A] Planet Aspect Planet [is] [in] [the] nth Face [of] Sign

kwSignificator

         *Planet [is] [the] [Significator|Significatrix]

This keyword must follow a keyword of type ‘kwPlanetAspectPlanet’, and any following text appears if the planet named in this keyword line is the significator of the aspect formed between the two planets named in the previous ‘kwPlanetAspectPlanet’ line.

kwPlanetInSignType

         *Planet [is] [in] [a] SignType Sign

kwHouseRulerTypeInDignity

         *RulerType Ruler [of] nth House [is] [in] Dignity

Rulerships are always Traditional (i.e. excluding the outer planets)

kwHouseRulerTypeIsPlanet

         *RulerType Ruler [of] nth House [is] Planet

Rulerships are always Traditional (i.e. excluding the outer planets)

kwPlanetMoreDignifiedThanPlanet

         *Planet [is] More Dignified Than Planet

‘More dignified’ means having a greater essential dignity score.

kwComplexionalScores

         *Complexional Scores

This keyword results in a list of complexional scores being inserted at this point in the report, showing the score for each complexional type for the chart currently being interpreted. It also shows which complexional type is the dominant one for this chart.

kwComplexionalType

         *Complexional Type [is] Complexion

This allows interpretive text to be supplied for each of the complexional types, and only the interpretation for the dominant type will appear in the report.

kwHouseRulerApproachesAspectHouseRuler

*Ruler [of] [the] nth House approaches Aspect [with] [the] Ruler [of] [the] nth House

Example: *Ruler of the 1st House approaches aspect to the Ruler of the 6th House

kwHouseRulerInRange

*Ruler [of] [the] nth House [is] [in] Range ndeg Sign [to] ndeg Sign

Example: *Ruler of the 1st House is in Range 27 Aries to 29 Aries

kwHouseAlmutenInHouseType

*Almuten [of] [the] nth House [is] HouseType

Example: *Almuten of 1st House is cadent

kwHouseCuspInSign

*nth House Cusp [is] [in] Sign

Example: *6th House Cusp is Pisces

kwHouseCuspInSignType

*nth House Cusp [is] [in] SignType

Example: *6th House Cusp is Fixed

kwHouseCuspInRange

*nth House Cusp [is] [in] Range ndeg Sign [to] ndeg Sign

Example: *6th House Cusp is in Range 27 Aries to 29 Aries

kwPlanetAspectHouseCusp

*Planet [is] [in] Aspect [with] nth House

Example: *Saturn Sextile 8th House

kwHouseAlmutenIsPlanet

*Almuten of the nth House is Planet

Example: *Almuten of the 5th House is the Moon

kwHouseAlmutenInDignity

*Almuten of the nth House is in Dignity

Example: *Almuten of the 5th House is Peregrine

kwPlanetAlmutenInHouse

*Almuten of Planet is in the nth House

Example: *Almuten of Ascendant is in the 5th House

kwPlanetSeparatingAspectPlanet

*Planet Separates [from] Aspect [with] Planet

Example: *Moon separates from conjunction with PlanetaryHourRuler

kwPlanetIsPlanet

*Planet [is] Planet

Example: *PlanetaryHourRuler is Mars

kwHouseAlmutenInHouse

*Almuten [of] [the] nth House [is] [in] [the] nth House

Example: *Almuten of the 1st House is in the 7th House

kwPlanetInRange

*Planet [is] [in] [the] Range ndeg Sign [to] ndeg Sign

Example: *Saturn in Range 0 Aries to 19 Aries

kwPlanetAspectAnyPlanetInHouse

*Planet Aspect [a] Planet [in] [the] nth House

*Moon Aspects a Planet in the 10th House

kwPlanetInEarlyDegrees (0-3 degrees of a sign)

*Planet [is] [in] Early Degrees

Example: *Ascendant is in Early Degrees

kwPlanetInLateDegrees (27-30 degrees of a sign)

*Planet [is] [in] Late Degrees

Example: *Ascendant is in Late Degrees

kwPlanetApplyingAspectHouseRuler

*Planet Approaches Aspect [with] Ruler [of]  [the] nth House

Example: *Moon Approaches Conjunction with Ruler of the 10th House

kwPlanetSeparatingAspectHouseRuler

*Planet Separates [from] Aspect [with] Ruler [of]  [the] nth House

Example: *Moon Separates from Conjunction with Ruler of the 10th House

kwPlanetAspectStar

*Planet [is] [in] Aspect [with] Star Starname

Example: *Moon conjunct Star Mirach

The starfile must be referred to in a "StarFile=file.fst" line in the swp file for the current project. This file must be a fixed Solar Fire type fixed star file, and it must somewhere contain the star referred to in this keyword line. By default this file resides in the Userdata subdirectory of Solar Writer. Note that the order of the starfile must not be modified after the report is compiled, or else stars might be referenced out of order, causing errors.

kwChart

*Chart [0/1/2]

This keyword is useful for synastry reports only. The chart number indicates which chart/s are used when processing the following keywords. If "*Chart 0" is used, then any "point aspect point" keywords use synastry aspects between the two charts. If "*Chart 1" or "*Chart 2" is used, then all following keywords relate to items in that chart alone. This allows different sections of a synastry report to deal with individual charts.

kwGraphic

*Graphic [%Width]

This allows the insertion of a graphic (*.wmf or *.bmp only) into the body of a report. The %Width must be an integer from 1 to 100 only, indicating the proportion of page width to size it to. (The graphic's aspect ratio is always maintained). The line following the keyword must give the graphic file name, optionally with a full path. If no path is found, then it is assumed to be in the Writer/Source subdirectory. If the graphic file is not found when the report runs, then it is simply ignored and excluded from the report.

kwDynamicReport

*DynamicReport [DynRepID]

Example:                *DynamicReport 0

DynrRepID is an integer that refers to nth (starting with 0 as first) dynamic report interpretations (*.INT) file referred to in the project (*.SWP) file (e.g. transits.int). This allows the calculation of the dynamic aspect events list, and the extraction and compilation of interpretations from the interpretations file for the report period specified by the user. Thus, this keyword results in an entire section of dynamic interpretations being inserted into the report.

kwDynamicBackground

*DynamicBackground [DynRepID]

Example:                *DynamicBackground 0

DynrRepID is an integer that refers to nth (starting with 0 as first) dynamic report interpretations (*.INT) file referred to in the project (*.SWP) file (e.g. transits.int). This allows the calculation of the dynamic house and sign placements list, and the extraction and compilation of interpretations from the interpretations file for the report period specified by the user. Thus, this keyword results in an entire section of dynamic interpretations being inserted into the report.

Keyword Line Combination

The keyword line must usually start with an asterisk. However, it is also possible to ‘nest’ keywords so that they combine with logical AND or OR conditions.

>> To combine keyword lines with an OR condition

1.Place the two or more keyword lines without any intervening interpretation text e.g.

* Jupiter is in the 3rd House

* Jupiter rules the 3rd House

Insert text here which applies when Jupiter is in the 3rd House OR when it rules the 3rd house....

>> To combine keyword lines with an AND condition

1.Place an extra plus sign (+) in front of each consecutive keyword line which forms part of a sequence of AND conditions, e.g.

* Jupiter is in Aries

+Birth is Diurnal

Insert text here which applies only when Jupiter is in Aries AND the birth was in the daytime.

++Mars is in the 2nd House

Insert text here which applies only when the above conditions are true AND also when Mars is in the 2nd house of the chart...