Classical methods and conventions

Traditions differ on some classical calculations. This page says which convention each of these endpoints follows and what its fields mean, so you can check an answer or explain it to your users.

Identifiers such as malefic_in_seventh stay in English in every language, so your code can rely on them.

Why a dosha verdict says what it saysCopy Anchor Link

Every dosha check includes an explanation with its result:

• manglik-dosha, kaalsarp-dosha and pitra-dosha;
• sade-sati, sade-sati-current and dhaiya;
• ganda-mool-birth and ghat-chakra;
• the combined dosh-report and bundle-kaalsarp-pitra.

The yoga rules already explain themselves: each rule found carries its own detail.

Comparing methods side by sideCopy Anchor Link

utilities/compare-methods runs one capability under two to seven values of one of its option fields and returns each result. Use it for a method, an ayanamsha or a school, for example Chara dasha by the standard rule and by K.N. Rao's. differing_fields lists the top-level fields where the results disagree.

{ "capability": "chara-dasha", "field": "method", "values": ["standard", "kn_rao"],
  "input": { "datetime": "1990-10-18T14:30:00", "timezone": "Asia/Kolkata", "latitude": 28.6139, "longitude": 77.209 } }

It costs the capability's own price once per value. AI readings and reports can't be compared this way. Each capability it runs gets the same key-scope and plan checks as a direct call.

Ghat ChakraCopy Anchor Link

doshas-yogas/ghat-chakra reads the birth Moon sign and returns the factors traditionally avoided when starting new work.

The month, tithi group, weekday, nakshatra and Ghat Chandra agree in the tables we read. Yoga, karana and prahar differ for five Moon signs. source_differences shows the other value, so you can follow your own table.

Ganda Mool at birthCopy Anchor Link

doshas-yogas/ganda-mool-birth checks whether the birth Moon is in Ashwini, Ashlesha, Magha, Jyeshtha, Mula or Revati, the stars at the junctions of signs. panchang/ganda-mool answers a different question: whether such a star runs on a given day.

Texts vary widely on the effect of each pada, and some state them in fatal terms. We return only the broad focus and do not repeat those statements. Tradition also judges this from the whole chart, not from the star alone.

Kalathra DoshaCopy Anchor Link

doshas-yogas/kalathra-dosha has no single classical definition, so this is a stated convention: natural malefics (Sun, Mars, Saturn, Rahu and Ketu) afflicting the 7th house, its lord or Venus. Every rule comes back with whether it fired and which planet caused it, so you can apply a different threshold.

• Aspects: every planet aspects the 7th from itself. Mars also aspects the 4th and 8th, Jupiter the 5th and 9th, Saturn the 3rd and 10th. Rahu and Ketu take the 7th only, because their other aspects are disputed.
• A malefic ruling the 7th does not afflict its own house or itself.
• level: a mitigated target is listed but not counted. One target left is mild, two moderate, three strong.
• present: at least two targets are left. This threshold is our choice.
• from_lagna, from_moon: the top-level present and level read the Lagna. The Moon is read separately as present_from_moon.

Ishta DevataCopy Anchor Link

jaimini/ishta-devata follows the Jaimini rule. It takes the Atmakaraka's navamsha sign (the Karakamsha), then the 12th sign from it in the navamsha, and the deity of the planet found there.

Functional benefics and maleficsCopy Anchor Link

strengths/functional-nature gives each planet's nature for the lagna: benefic, malefic or neutral. Our chart images colour planets from the same table, so the two always agree.

roles adds what the house lordship makes it: yogakaraka (rules a kendra and a trikona), lagna_lord, trikona_lord, kendra_lord, dusthana_lord, maraka (rules the 2nd or 7th) and badhaka (rules the 11th for a movable lagna, the 9th for a fixed one, the 7th for a dual one). A maraka here is a house rule only: reports/maraka-planets adds the planets in those houses, with reasons.

Rahu and Ketu rule no sign here, so they are malefic with their dispositor and its nature.

Birth PayaCopy Anchor Link

vedic-charts/birth-paya returns both common methods, and they can differ: by_moon_from_lagna (the Moon's house from the Lagna) and by_nakshatra (the birth star). Use the one your tradition follows.

ChandrashtamaCopy Anchor Link

panchang/chandrashtama gives the periods the Moon transits the 8th sign from the natal Moon, about 2¼ days each lunar month. It uses the sign (rashi) method, not the 17th-star method some South Indian calendars use. A period already running on from_date comes back whole, so its start can be before that date. Times are in the birth's zone unless you send query_timezone.

Harsha BalaCopy Anchor Link

tajika/varshaphal-harsha-bala gives each of the seven planets in the annual chart up to 5 units from each of four sources, 20 in all.

Tajika counts Mercury and Saturn as female. Venus's house of joy is the 5th, as in the Tajika Nilakanthi verse; some programs use the 12th, so their Venus can differ from ours.

Panchavargeeya BalaCopy Anchor Link

tajika/varshaphal-panchavargeeya-bala adds five strengths, 80 points at most. vishwa_bala is the total divided by four.

• uchcha: the distance from the deep debilitation point divided by 9, at most 20.
• Friendship: by placement in the annual chart. The division's lord in the 3rd, 5th, 9th or 11th from the planet is a friend, in the 1st, 4th, 7th or 10th an enemy, and otherwise neutral.
• Drekkana lords: Tajika's own scheme, running in Chaldean order from Mars in Aries, not the Parashari sign, 5th and 9th.
• Hadda: the Egyptian terms.
• strength: extraordinary above 15, strong from 10, medium from 5, otherwise weak.

Published sources use different friend and neutral scales and different grade cut-offs, so another program's figures can differ. Each row shows every part's lord, relation and points, so you can see where.

Pythagorean numerologyCopy Anchor Link

Send "system": "pythagorean" to numerology/numerology, numerology/name-numerology or their singles. The default is chaldean.

• Letter values: the alphabet in order, A=1 to I=9, then J=1 again.
• Unchanged: the numbers from the date of birth are the same on both tables.
• master_number: 11, 22 or 33 when the reduction passes through one, beside the reduced number. It is null on the Chaldean table, which does not use them.
• name_suggestions: empty on the Pythagorean table, because those spellings are a Chaldean remedy.
• Scripts: both tables use Latin letters, so a name in another script is refused with a 422 and is not charged.

Human DesignCopy Anchor Link

The human-design family uses tropical positions from the Swiss Ephemeris. It is not affiliated with or endorsed by any owner of a Human Design trademark, and the descriptions are our own.

• Two moments: birth, and the design moment, when the Sun stood exactly 88 degrees before its birth position, about 88 days earlier.
• human-design-activations: the gate, line and colour of each planet at both moments.
• Channels and centers: a channel is defined when both of its gates are active at either moment, and that defines the two centers it joins. human-design-centers-channels also returns the connected groups, so you can draw the chart.
• Type and authority: worked out from the defined centers and how they connect, for example whether a motor reaches the throat.
• human-design-interpretation: our own words for each center, defined or open, and the authority and definition, with x_percent and y_percent to place each center on a drawing. gates lists every activation, on the personality (birth) and design side, with the gate's I Ching hexagram name (the public-domain Wilhelm titles) and a one-line theme of our own. Each defined channel carries the themes of its two gates, and profile_reading gives the theme of each of the profile's two lines.

Chinese astrologyCopy Anchor Link

chinese-chart returns the four pillars. Conventions differ, so these are ours:

• Year: starts at the lunar new year, the second new moon after the December solstice by the date in China, with the intercalary exception of 2034 handled. A birth before that date belongs to the year before.
• Month: follows the Sun. The Tiger month starts at 315 degrees of tropical longitude, and each month is 30 degrees.
• Day: counted from the local birth date through the 60-day cycle, so the day changes at midnight. Some schools change it at 23:00.
• Hour: the two-hour branch of the local clock time. The Rat hour starts at 23:00.
• compatible_animals and clash_animal: the two trine animals and the six-harmony animal, and the animal directly opposite.
• chinese-year-forecast: compares the year's animal with the person's as own year, six harmony, three harmony, clash or neutral.

Blended match scoreCopy Anchor Link

match-score gives one percentage for a couple: Ashtakoot 70%, and Manglik, Rajju and Vedha 10% each. These weights are ours and are not a classical rule. The response returns each part and its weight, so you can apply your own.

More numerologyCopy Anchor Link

• challenge-numbers: from the digit roots of the month, day and year. First is month minus day, second is day minus year, main is the difference of those two, and last is month minus year, each as a positive number.
• subconscious-self-number: how many of the nine numbers the letters of a name hold on the Pythagorean table. The numbers it lacks are its karmic lessons.
• numerology-match: the radical numbers count 40%, the destiny numbers 40%, and each person's radical against the other's destiny 10% each, scored by the friendship of their ruling planets. These weights are ours.
• numerology-daily: personal year is the digit root of birth day, birth month and the year's root. Personal month adds the month, and personal day adds the day.

Bhava Bala adjustmentsCopy Anchor Link

bhava-bala totals the three classical parts: Bhavadhipati, Dig and Drishti. Beside the total it gives two adjustments from B. V. Raman, which are not added to total_virupas, so that number still compares with other software.

• yuti_bala: plus 60 virupas for Jupiter or Mercury in the bhava, minus 60 for the Sun, Mars or Saturn.
• kala_bala: 15 virupas when the bhava's sign suits the time of birth. Shirshodaya signs (Gemini, Leo, Virgo, Libra, Scorpio, Aquarius) in the day, Prishtodaya signs (Aries, Taurus, Cancer, Sagittarius, Capricorn) at night, and Pisces at twilight, which we take as 48 minutes either side of sunrise and sunset.

occupants lists the planets in each bhava that Yuti Bala counts: Jupiter, Mercury, the Sun, Mars and Saturn. The response also names the strongest and weakest bhava.

adjusted_total_virupas, adjusted_rupas and adjusted_rank add the two adjustments, for those who follow Raman's full total. They are null when the time of birth cannot be placed in the day, night or twilight. method lists what each total includes.

KP sub lordsCopy Anchor Link

kp-planets and kp-birth-chart give each planet's sub_lord and sub_sub_lord. A nakshatra is divided among the nine Vimshottari lords in proportion to their years, starting from the nakshatra's own lord. The sub_lord rules the part the planet stands in. That part is divided the same way to give the sub_sub_lord. A planet exactly on a boundary belongs to the next part.

Ashtakoot thresholdCopy Anchor Link

minimum_recommended on ashtakoot-details is 18 of 36, the usual threshold. It is a convention to help you read the total, and the response does not refuse or approve a match because of it.

Disha Shoola remedyCopy Anchor Link

disha_shoola_remedy on vasa-shoola is the food traditionally taken before travelling on that weekday in the direction to avoid, such as milk on a Monday. Almanacs differ on these foods.

Panch Pakshi birth birdCopy Anchor Link

panch-pakshi-birth finds the bird from the Moon's nakshatra at birth, in five groups (1-5, 6-11, 12-16, 17-21, 22-27), with the birds in reverse order in the dark fortnight. ruling_days and dying_days come from the same weekday tables as panch-pakshi. Regional traditions differ, and we do not give colours or directions for the birds because the sources disagree.

Tajika yoga strengthCopy Anchor Link

strength_percent on varshaphal-tajika-yogas is ours and is not a classical figure. For a yoga built on an aspect, it is how close the strongest pair is to exact: 100 at the exact aspect, falling to 0 at the edge of the two planets' combined Deeptamsa. For Iqabala and Induvara it is the share of the seven planets in the houses that count.

Vastu padasCopy Anchor Link

vastu-entrance-pada names the pada of a door in one of two ways, and method_id in the answer says which was used.

• perimeter_equal_length: each wall is divided into eight equal lengths, clockwise from the north-west corner. A door given by side and position_percent always uses this.
• equal_angle_sectors: the bearing from the centre is divided into 32 equal sectors of 11.25 degrees, starting at 315 degrees. A door given by bearing_degrees uses this by default, as the compass method does.

The two agree only at the middle and the corners of each wall. On a square plot, a north door a quarter of the way along the wall is N3 by length and N2 by angle. To get the wall method from a bearing, send bearing_method: "plot_boundary": the bearing is traced to the plot's wall (square, or a rectangle when you send plot_width and plot_depth) and wall_position shows where it landed.

Vastu room placementCopy Anchor Link

vastu-room-placement reads one room in one of the 16 zones or the centre, or in the zone of a boundary pada, and with neither, the room in every zone. The grade (ideal, good, acceptable, poor, avoid) uses the same room rules as vastu-analyse, so the two never disagree. The reasons are built from:

• the zone: its deity, element and domain;
• the room's element and weight: a kitchen is Fire, a store room heavy Earth, a borewell a dip in the ground;
• the weight rule: heavy to the south and west, light and low to the north and east, and the centre open.

Remedies come from the remedy library where it has an entry for the placement, otherwise from the same principles: keep the zone clear, the zone element's colours, the ruling planet's yantra, moving the weight within the room, and finally moving the room to its first named zone. Each has what_to_do, why_it_helps and effort_level.

vastu-pada-grid lays out the 81-pada Paramasayika grid of 45 deities. Texts differ on small details, and the associations are traditional and are not predictions.

Number relationsCopy Anchor Link

friendly_numbers, neutral_numbers and unfavourable_numbers come from the classical friendships of each number's ruling planet, counted in both directions. secondary_gemstone is the usual lower-cost alternative to the main stone.

Manglik percentageCopy Anchor Link

percentage on manglik-dosha is the same figure the matching reports use: a level from Mars's placement and dignity, plus points for each of the Ascendant, Moon and Venus it applies from. It is our scale and not a classical one. Cancellations depend on a partner's chart, so they are in manglik-match.