public class SweHel
extends java.lang.Object
implements java.io.Serializable
Constructor and Description |
---|
SweHel() |
SweHel(SwissEph sw,
SwissLib sl,
swisseph.Swemmoon sm,
SwissData swed) |
Modifier and Type | Method and Description |
---|---|
int |
swe_heliacal_angle(double tjdut,
double[] dgeo,
double[] datm,
double[] dobs,
int helflag,
double mag,
double azi_obj,
double azi_sun,
double azi_moon,
double alt_moon,
double[] dret,
java.lang.StringBuffer serr)
ATTENTION: This method possibly (re-)sets a global parameter used
in calculation of delta T.
|
int |
swe_heliacal_pheno_ut(double JDNDaysUT,
double[] dgeo,
double[] datm,
double[] dobs,
java.lang.StringBuffer ObjectNameIn,
int TypeEvent,
int helflag,
double[] darr,
java.lang.StringBuffer serr)
/**
(Undocumented)
' JDNDaysUT [JDN]
' HPheno
'0=AltO [deg] topocentric altitude of object (unrefracted)
'1=AppAltO [deg] apparent altitude of object (refracted)
'2=GeoAltO [deg] geocentric altitude of object
'3=AziO [deg] azimuth of object
'4=AltS [deg] topocentric altitude of Sun
'5=AziS [deg] azimuth of Sun
'6=TAVact [deg] actual topocentric arcus visionis
'7=ARCVact [deg] actual (geocentric) arcus visionis
'8=DAZact [deg] actual difference between object's and sun's azimuth
'9=ARCLact [deg] actual longitude difference between object and sun
'10=kact [-] extinction coefficient
'11=minTAV [deg] smallest topocentric arcus visionis
'12=TfistVR [JDN] first time object is visible, according to VR
'13=TbVR [JDN] optimum time the object is visible, according to VR
'14=TlastVR [JDN] last time object is visible, according to VR
'15=TbYallop[JDN] best time the object is visible, according to Yallop
'16=WMoon [deg] cresent width of moon
'17=qYal [-] q-test value of Yallop
'18=qCrit [-] q-test criterion of Yallop
'19=ParO [deg] parallax of object
'20 Magn [-] magnitude of object
'21=RiseO [JDN] rise/set time of object
'22=RiseS [JDN] rise/set time of sun
'23=Lag [JDN] rise/set time of object minus rise/set time of sun
'24=TvisVR [JDN] visibility duration
'25=LMoon [deg] cresent length of moon
'26=CVAact [deg]
'27=Illum [%] 'new
'28=CVAact [deg] 'new
'29=MSk [-]
ATTENTION: This method possibly (re-)sets a global parameter used
in calculation of delta T.
|
int |
swe_heliacal_ut(double JDNDaysUTStart,
double[] dgeo,
double[] datm,
double[] dobs,
java.lang.StringBuffer ObjectNameIn,
int TypeEvent,
int helflag,
double[] dret,
java.lang.StringBuffer serr_ret)
This method calculates the Julian day of the next heliacal phenomenon after a given start date.
|
int |
swe_topo_arcus_visionis(double tjdut,
double[] dgeo,
double[] datm,
double[] dobs,
int helflag,
double mag,
double azi_obj,
double alt_obj,
double azi_sun,
double azi_moon,
double alt_moon,
double[] dret,
java.lang.StringBuffer serr)
ATTENTION: This method possibly (re-)sets a global parameter used
in calculation of delta T.
|
int |
swe_vis_limit_mag(double tjdut,
double[] dgeo,
double[] datm,
double[] dobs,
java.lang.StringBuffer ObjectName,
int helflag,
double[] dret,
java.lang.StringBuffer serr)
Limiting magnitude in dark skies
ATTENTION: This method possibly (re-)sets a global parameter used in calculation of delta T. |
public int swe_vis_limit_mag(double tjdut, double[] dgeo, double[] datm, double[] dobs, java.lang.StringBuffer ObjectName, int helflag, double[] dret, java.lang.StringBuffer serr)
tjdut
- UT julian day numberdgeo
- geographic positiondgeo[0]: geographic longitude dgeo[1]: geographic latitude dgeo[2]: geographic altitude (eye height) in meters
datm
- atmospheric conditionsdatm[0]: atmospheric pressure in mbar (hPa) datm[1]: atmospheric temperature in degrees Celsius datm[2]: relative humidity in % datm[3]: if datm[3]>=1, then it is Meteorological Range [km] if 1>datm[3]>0, then it is the total atmsopheric coeffcient (ktot) if datm[3]=0, then the other atmospheric parameters determine the total atmospheric coefficient (ktot) Default values: If this is too much for you, set all these values to 0. The software will then set the following defaults: Pressure 1013.25, temperature 15, relative humidity 40. The values will be modified depending on the altitude of the observer above sea level. If the extinction coefficient (meteorological range) datm[3] is 0, the software will calculate its value from datm[0..2].
dobs
- observer descriptiondobs[0]: age of observer in years (default = 36) dobs[1]: Snellen ratio of observers eyes (default = 1 = normal) The following parameters are only relevant if the flag SE_HELFLAG_OPTICAL_PARAMS is set: dobs[2]: 0 = monocular, 1 = binocular (actually a boolean) dobs[3]: telescope magnification: 0 = default to naked eye (binocular), 1 = naked eye dobs[4]: optical aperture (telescope diameter) in mm dobs[5]: optical transmission
ObjectName
- of fixstar or asteroid number or "sun", "venus", "mars",
"mercury", "jupiter", "saturn", "uranus", "neptune", "moon" (case insensitive)helflag
- calculation flag, bitmapSweConst.SE_HELFLAG_OPTICAL_PARAMS (512): Use this with calculations for optical instruments. Unless this bit is set, the values of dobs[2-5] are ignored. SweConst.SE_HELFLAG_NO_DETAILS (1024): provide the date, but not details like visibility start, optimum, and end. This bit makes the program a bit faster. SweConst.SE_HELFLAG_VISLIM_DARK (4096): function behaves as if the Sun were at nadir. SweConst.SE_HELFLAG_VISLIM_NOMOON (8192): function behaves as if the Moon were at nadir, i. e. the Moon as a factor disturbing the observation is excluded. This flag is useful if one is not really interested in the heliacal date of that particular year but in the heliacal date of that epoch.
dret
- (output parameter) double[50]dret[0]: start visibility (Julian day number) dret[1]: optimum visibility (Julian day number), zero if helflag >= SweConst.SE_HELFLAG_AV dret[2]: end of visibility (Julian day number), zero if helflag >= SweConst.SE_HELFLAG_AV dret[3] ... dret[49]: unused but required on input
serr
- error string-1 Error -2 Object is below horizon 0 OK, photopic vision |1 OK, scotopic vision |2 OK, near limit photopic/scotopic
SweDate.setGlobalTidalAcc(double)
public int swe_topo_arcus_visionis(double tjdut, double[] dgeo, double[] datm, double[] dobs, int helflag, double mag, double azi_obj, double alt_obj, double azi_sun, double azi_moon, double alt_moon, double[] dret, java.lang.StringBuffer serr)
SweDate.setGlobalTidalAcc(double)
public int swe_heliacal_angle(double tjdut, double[] dgeo, double[] datm, double[] dobs, int helflag, double mag, double azi_obj, double azi_sun, double azi_moon, double alt_moon, double[] dret, java.lang.StringBuffer serr)
SweDate.setGlobalTidalAcc(double)
public int swe_heliacal_pheno_ut(double JDNDaysUT, double[] dgeo, double[] datm, double[] dobs, java.lang.StringBuffer ObjectNameIn, int TypeEvent, int helflag, double[] darr, java.lang.StringBuffer serr)
' JDNDaysUT [JDN] ' HPheno '0=AltO [deg] topocentric altitude of object (unrefracted) '1=AppAltO [deg] apparent altitude of object (refracted) '2=GeoAltO [deg] geocentric altitude of object '3=AziO [deg] azimuth of object '4=AltS [deg] topocentric altitude of Sun '5=AziS [deg] azimuth of Sun '6=TAVact [deg] actual topocentric arcus visionis '7=ARCVact [deg] actual (geocentric) arcus visionis '8=DAZact [deg] actual difference between object's and sun's azimuth '9=ARCLact [deg] actual longitude difference between object and sun '10=kact [-] extinction coefficient '11=minTAV [deg] smallest topocentric arcus visionis '12=TfistVR [JDN] first time object is visible, according to VR '13=TbVR [JDN] optimum time the object is visible, according to VR '14=TlastVR [JDN] last time object is visible, according to VR '15=TbYallop[JDN] best time the object is visible, according to Yallop '16=WMoon [deg] cresent width of moon '17=qYal [-] q-test value of Yallop '18=qCrit [-] q-test criterion of Yallop '19=ParO [deg] parallax of object '20 Magn [-] magnitude of object '21=RiseO [JDN] rise/set time of object '22=RiseS [JDN] rise/set time of sun '23=Lag [JDN] rise/set time of object minus rise/set time of sun '24=TvisVR [JDN] visibility duration '25=LMoon [deg] cresent length of moon '26=CVAact [deg] '27=Illum [%] 'new '28=CVAact [deg] 'new '29=MSk [-]ATTENTION: This method possibly (re-)sets a global parameter used in calculation of delta T. See SweDate.setGlobalTidalAcc(double).
JDNDaysUT
- Julian day number of the start date for the searchdgeo
- Geographic location; double[3] = [longitude, latitude, altitude in meters]datm
- Athmospheric conditions; double[4]:dobs
- Description of observer; double[6]:ObjectNameIn
- Name string of fixstar or planetTypeEvent
- Type of eventhelflag
- helflag contains ephemeris flag, like iflag in swe_calc() etc. In addition it can contain the following bits:darr
- Return values in double[3].serr
- Output value; error string on errorSweConst.SE_HELIACAL_RISING
,
SweConst.SE_HELIACAL_SETTING
,
SweConst.SE_EVENING_FIRST
,
SweConst.SE_MORNING_LAST
,
SweConst.SE_HELFLAG_OPTICAL_PARAMS
,
SweConst.SE_HELFLAG_NO_DETAILS
,
SweConst.SE_HELFLAG_VISLIM_DARK
,
SweConst.SE_HELFLAG_VISLIM_NOMOON
,
SweConst.SE_HELFLAG_AV
,
ATTENTION: This method possibly (re-)sets a global parameter used
in calculation of delta T. See SweDate.setGlobalTidalAcc(double).
,
SweDate.setGlobalTidalAcc(double)
public int swe_heliacal_ut(double JDNDaysUTStart, double[] dgeo, double[] datm, double[] dobs, java.lang.StringBuffer ObjectNameIn, int TypeEvent, int helflag, double[] dret, java.lang.StringBuffer serr_ret)
JDNDaysUTStart
- Julian day number of the start date for the searchdgeo
- Geographic location; double[3] = [longitude, latitude, altitude in meters]datm
- Athmospheric conditions; double[4]:dobs
- Description of observer; double[6]:ObjectNameIn
- Name string of fixstar or planetTypeEvent
- Type of eventhelflag
- helflag contains ephemeris flag, like iflag in swe_calc() etc. In addition it can contain the following bits:dret
- Return values in double[3].serr_ret
- Output value; error string on errorSweConst.SE_HELIACAL_RISING
,
SweConst.SE_HELIACAL_SETTING
,
SweConst.SE_EVENING_FIRST
,
SweConst.SE_MORNING_LAST
,
SweConst.SE_HELFLAG_OPTICAL_PARAMS
,
SweConst.SE_HELFLAG_NO_DETAILS
,
SweConst.SE_HELFLAG_VISLIM_DARK
,
SweConst.SE_HELFLAG_VISLIM_NOMOON
,
SweConst.SE_HELFLAG_AV
,
SweDate.setGlobalTidalAcc(double)