swisseph

Class TCPlanetPlanet

java.lang.Object

swisseph.TransitCalculator

swisseph.TCPlanetPlanet

All Implemented Interfaces:

java.io.Serializable

public class TCPlanetPlanet
extends TransitCalculator
implements java.io.Serializable

This class implements a TransitCalculator for two planets in relative positions or speeds to each other.

You would create a TransitCalculator from this class and use the SwissEph.getTransit() methods to actually calculate a transit, e.g.:

 SwissEph sw = new SwissEph(...);
 ...
 int flags = SweConst.SEFLG_SWIEPH |
             SweConst.SEFLG_TRANSIT_LONGITUDE;
 boolean backwards = true;
 
 TransitCalculator tc = new TCPlanetPlanet(
                                  sw,
                                  SweConst.SE_MERCURY,
                                  SweConst.SE_VENUS,
                                  flags,
                                  0);
 ...
 double nextTransitUT = sw.getTransitUT(tc, jdUT, backwards);
 

This would calculate the last (UT-) date, when Mercury and Venus had the same longitudinal position.

See Also:

Serialized Form

Field Summary

Fields inherited from class swisseph.TransitCalculator

rollover, rolloverVal

Constructor Summary

Constructors

Constructor and Description
TCPlanetPlanet(SwissEph sw, int pl1, int pl2, int flags, double offset) Creates a new TransitCalculator for relative transits of two different planets to each other with the option for transits over longitudes, latitudes, distance or the speed in any of these directions in the geocentric or topocentric coordinate system, and in tropical or sidereal zodiac system, both with the sum and difference of both planets positions and speeds.
TCPlanetPlanet(SwissEph sw, int pl1, int pl2, int flags, double offset, int precalcCount, double precalcSafetyfactor) Creates a new TransitCalculator for relative transits of two different planets to each other with the option for transits over longitudes, latitudes, distance or the speed in any of these directions in the geocentric or topocentric coordinate system, and in tropical or sidereal zodiac system, both with the sum and difference of both planets positions and speeds.

Method Summary

Modifier and Type	Method and Description
protected double	calc(double jdET)
protected boolean	checkIdenticalResult(double offset, double val)
protected boolean	checkResult(double offset, double lastVal, double val, boolean above, boolean pxway)
protected double	getDegreePrecision(double jd)
double	getMaxOffset()
protected double	getMaxSpeed()
double	getMinOffset()
protected double	getMinSpeed()
protected double	getNextJD(double jdET, double val, double offset, double min, double max, boolean back)
java.lang.Object[]	getObjectIdentifiers() This returns the two planet numbers involved as Strings.
double	getOffset() This returns the transit degree or other transit value of the relative position or speed of the two planets.
boolean	getRollover()
protected double	getTimePrecision(double degPrec)
boolean	hasPartileAspect(double jdET, int p1, int p2, int flgs, double offset) Checks if the two planets have a partile aspect.
void	setOffset(double value) This sets the transit degree or other transit value for the difference or sum of the positions or speeds of both planets.
java.lang.String	toString()

Methods inherited from class swisseph.TransitCalculator

getRolloverVal

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Constructor Detail

TCPlanetPlanet

public TCPlanetPlanet(SwissEph sw,
                      int pl1,
                      int pl2,
                      int flags,
                      double offset)

Creates a new TransitCalculator for relative transits of two different planets to each other with the option for transits over longitudes, latitudes, distance or the speed in any of these directions in the geocentric or topocentric coordinate system, and in tropical or sidereal zodiac system, both with the sum and difference of both planets positions and speeds.

Calculation of partile transits is possible now, but it's still a rather slow calculation and not finally tested.

Parameters:

sw - A SwissEph object, if you have one available. May be null, if you don't use sidereal or topocentric mode.
If you use sidereal or topocentric mode, you have to set the sidereal mode or topocentric location before calculating transits. Both planets share the same sidereal mode and location.

pl1 - The planet number of the first planet.
Planets from SweConst.SE_SUN up to SweConst.SE_INTP_PERG (with the exception of SweConst.SE_EARTH) have their extreme speeds saved, so these extreme speeds will be used on calculation.
Other objects calculate extreme speeds by randomly calculating by default 200 speed values and multiply them by 1.4 as a safety factor.
ATTENTION: be sure to understand that you might be able to miss some transit or you might get a rather bad transit time in very rare circumstances.
Use SweConst.SE_AST_OFFSET + asteroid number for planets with a planet number not defined by SweConst.SEFLG_*.

pl2 - The second planet that will be transited by the first planet.

flags - The calculation type flags (SweConst.SEFLG_TRANSIT_LONGITUDE, SweConst.SEFLG_TRANSIT_LATITUDE or SweConst.SEFLG_TRANSIT_DISTANCE in conjunction with SweConst.SEFLG_TRANSIT_SPEED for transits over a speed value).

Also flags modifying the basic planet calculations, these are SweConst.SEFLG_TOPOCTR, SweConst.SEFLG_EQUATORIAL, SweConst.SEFLG_HELCTR, SweConst.SEFLG_TRUEPOS, and SweConst.SEFLG_SIDEREAL, plus the ephemeris flags SweConst.SEFLG_MOSEPH, SweConst.SEFLG_SWIEPH or SweConst.SEFLG_JPLEPH optionally.
For right ascension use SEFLG_TRANSIT_LONGITUDE | SEFLG_EQUATORIAL, for declination SEFLG_TRANSIT_LATITUDE | SEFLG_EQUATORIAL.

SEFLG_PARTILE_TRANSIT will calculate the next time, when the planets will have a partile aspect to each other, if they don't have a partile aspect now. If they do have a partile aspect now, it calculates the next time, when this partile aspect gets lost.

offset - This is the desired transit degree or distance in AU or transit speed in deg/day.

See Also:

TCPlanetPlanet(SwissEph, int, int, int, double, int, double), TCPlanet.TCPlanet(SwissEph, int, int, double), TCPlanet.TCPlanet(SwissEph, int, int, double, int, double), SweConst.SEFLG_TRANSIT_LONGITUDE, SweConst.SEFLG_TRANSIT_LATITUDE, SweConst.SEFLG_TRANSIT_DISTANCE, SweConst.SEFLG_TRANSIT_SPEED, SweConst.SE_AST_OFFSET, SweConst.SEFLG_PARTILE_TRANSIT, SweConst.SEFLG_PARTILE_TRANSIT_START, SweConst.SEFLG_PARTILE_TRANSIT_END, SweConst.SEFLG_YOGA_TRANSIT, SweConst.SEFLG_TOPOCTR, SweConst.SEFLG_EQUATORIAL, SweConst.SEFLG_HELCTR, SweConst.SEFLG_TRUEPOS, SweConst.SEFLG_SIDEREAL, SweConst.SEFLG_MOSEPH, SweConst.SEFLG_SWIEPH, SweConst.SEFLG_JPLEPH

TCPlanetPlanet

public TCPlanetPlanet(SwissEph sw,
                      int pl1,
                      int pl2,
                      int flags,
                      double offset,
                      int precalcCount,
                      double precalcSafetyfactor)

Creates a new TransitCalculator for relative transits of two different planets to each other with the option for transits over longitudes, latitudes, distance or the speed in any of these directions in the geocentric or topocentric coordinate system, and in tropical or sidereal zodiac system, both with the sum and difference of both planets positions and speeds.

Calculation of partile transits is possible now, but it's still a rather slow calculation and not finally tested.

Parameters:

sw - A SwissEph object, if you have one available. May be null, if you don't use sidereal or topocentric mode.
If you use sidereal or topocentric mode, you have to set the sidereal mode or topocentric location before calculating transits. Both planets share the same sidereal mode and location.

pl1 - The planet number of the first planet.
Planets from SweConst.SE_SUN up to SweConst.SE_INTP_PERG (with the exception of SweConst.SE_EARTH) have their extreme speeds saved, so these extreme speeds will be used on calculation.
Other objects calculate extreme speeds by randomly calculating by default 200 speed values and multiply them by 1.4 as a safety factor.
ATTENTION: be sure to understand that you might be able to miss some transit or you might get a rather bad transit time in very rare circumstances.
Use SweConst.SE_AST_OFFSET + asteroid number for planets with a planet number not defined by SweConst.SEFLG_*.

pl2 - The second planet that will be transited by the first planet.

flags - The calculation type flags (SweConst.SEFLG_TRANSIT_LONGITUDE, SweConst.SEFLG_TRANSIT_LATITUDE or SweConst.SEFLG_TRANSIT_DISTANCE in conjunction with SweConst.SEFLG_TRANSIT_SPEED for transits over a speed value, and SweConst.SEFLG_YOGA_TRANSIT to calculate for the SUM of the two positions or speeds instead of the difference plus SweConst.SEFLG_PARTILE_TRANSIT, SweConst.SEFLG_PARTILE_TRANSIT_START or SweConst.SEFLG_PARTILE_TRANSIT_END to calculate partile aspects).

Also flags modifying the basic planet calculations, these are SweConst.SEFLG_TOPOCTR, SweConst.SEFLG_EQUATORIAL, SweConst.SEFLG_HELCTR, SweConst.SEFLG_TRUEPOS, and SweConst.SEFLG_SIDEREAL, plus the (optional) ephemeris flags SweConst.SEFLG_MOSEPH, SweConst.SEFLG_SWIEPH or SweConst.SEFLG_JPLEPH.

For right ascension use SEFLG_TRANSIT_LONGITUDE | SEFLG_EQUATORIAL, for declination SEFLG_TRANSIT_LATITUDE | SEFLG_EQUATORIAL.

SEFLG_PARTILE_TRANSIT will calculate the next time, when the planets will have a partile aspect to each other, if they don't have a partile aspect now. If they do have a partile aspect now, it calculates the next time, when this partile aspect gets lost.

offset - This is an offset to the exact conjunction transit point. E.g., when the offset is 180 for longitude calculations, you will get the dates, when the two planets are opposite to each other. Note: The offset is related to the FIRST planet, so an offset value of 30 degree will find the transit points, when the FIRST planet will be 30 degrees after the position of the second planet.
Specify the desired transit degree or distance (in AU) or transit speed (in deg/day).

precalcCount - Only used, when a planet without known minimum and maximum speed (or acceleration on speed transit) has to be calculated (this is the case with asteroids for example). This value determines, how many random calculations will be done to get an idea of the speed or acceleration range of the planet. Defaults to 200, minimum is 100.

precalcSafetyfactor - Only for objects without known range of possible speeds (esp. asteroids or similar): increase the calculated random speed values by multiplying them with this safety factor. Defaults to 1.4, minimum will be 1.1.

See Also:

TCPlanetPlanet(SwissEph, int, int, int, double), TCPlanet.TCPlanet(SwissEph, int, int, double), TCPlanet.TCPlanet(SwissEph, int, int, double, int, double), SweConst.SEFLG_TRANSIT_LONGITUDE, SweConst.SEFLG_TRANSIT_LATITUDE, SweConst.SEFLG_TRANSIT_DISTANCE, SweConst.SEFLG_TRANSIT_SPEED, SweConst.SEFLG_PARTILE_TRANSIT, SweConst.SEFLG_PARTILE_TRANSIT_START, SweConst.SEFLG_PARTILE_TRANSIT_END, SweConst.SEFLG_YOGA_TRANSIT, SweConst.SE_AST_OFFSET, SweConst.SEFLG_TOPOCTR, SweConst.SEFLG_EQUATORIAL, SweConst.SEFLG_HELCTR, SweConst.SEFLG_TRUEPOS, SweConst.SEFLG_SIDEREAL, SweConst.SEFLG_MOSEPH, SweConst.SEFLG_SWIEPH, SweConst.SEFLG_JPLEPH

Method Detail

getRollover

public boolean getRollover()

Specified by:

getRollover in class TransitCalculator

Returns:

Returns true, if one position value is identical to another position value. E.g., 360 degree is identical to 0 degree in circle angles.

See Also:

TransitCalculator.rolloverVal

getMinOffset

public double getMinOffset()

Overrides:

getMinOffset in class TransitCalculator

Returns:

Returns the lowest possible offset value.

getMaxOffset

public double getMaxOffset()

Overrides:

getMaxOffset in class TransitCalculator

Returns:

Returns the highest possible offset value.

setOffset

public void setOffset(double value)

This sets the transit degree or other transit value for the difference or sum of the positions or speeds of both planets. It will be used on the next call to getTransit().

Specified by:

setOffset in class TransitCalculator

Parameters:

value - The offset value.

See Also:

getOffset()

getOffset

public double getOffset()

This returns the transit degree or other transit value of the relative position or speed of the two planets.

Specified by:

getOffset in class TransitCalculator

Returns:

The current offset value.

See Also:

setOffset(double)

getObjectIdentifiers

public java.lang.Object[] getObjectIdentifiers()

This returns the two planet numbers involved as Strings.

Overrides:

getObjectIdentifiers in class TransitCalculator

Returns:

An array of identifiers identifying the calculated objects.

hasPartileAspect

public boolean hasPartileAspect(double jdET,
                                int p1,
                                int p2,
                                int flgs,
                                double offset)

Checks if the two planets have a partile aspect.

Parameters:

jdET - Time to check

p1 - First planet

p2 - Second planet

flgs - Calculation flags, see the swe_calc() method

offset - The wanted offset between the planets

Returns:

true or false

getMaxSpeed

protected double getMaxSpeed()

Specified by:

getMaxSpeed in class TransitCalculator

getMinSpeed

protected double getMinSpeed()

Specified by:

getMinSpeed in class TransitCalculator

calc

protected double calc(double jdET)

Specified by:

calc in class TransitCalculator

getTimePrecision

protected double getTimePrecision(double degPrec)

Specified by:

getTimePrecision in class TransitCalculator

getDegreePrecision

protected double getDegreePrecision(double jd)

Specified by:

getDegreePrecision in class TransitCalculator

checkIdenticalResult

protected boolean checkIdenticalResult(double offset,
                                       double val)

Overrides:

checkIdenticalResult in class TransitCalculator

checkResult

protected boolean checkResult(double offset,
                              double lastVal,
                              double val,
                              boolean above,
                              boolean pxway)

Overrides:

checkResult in class TransitCalculator

getNextJD

protected double getNextJD(double jdET,
                           double val,
                           double offset,
                           double min,
                           double max,
                           boolean back)

Overrides:

getNextJD in class TransitCalculator

toString

public java.lang.String toString()

Overrides:

toString in class java.lang.Object