Earth Observation Mission CFI Software Pointing Software User Manual for JAVA |
Class for target calculations. More...
Public Member Functions | |
Target (final Attitude att, final DemId dem, final AtmosId atmos) throws CfiError | |
Class constructor. | |
native void | targetInter (final SatId satId, long deriv, long interFlag, double losAz, double losEl, double geodAlt, double losAzRate, double losElRate, long iray, double freq) throws CfiError |
Compute the first or the second intersection point of the line of sight from the satellite with a surface located at a certanin geodetic altitude over the Earth. | |
native void | targetTravelTime (final SatId satId, long deriv, double losAz, double losEl, double travelTime, double losAzRate, double losElRate, double travelTimeRate, long iray, double freq) throws CfiError |
It computes the point of the line or sight from the satellite at a given travel time along the line of sight. | |
native void | targetGroundRange (final SatId satId, long deriv, double losAz, double losEl, double geodAlt, double distance, double losAzRate, double losElRate) throws CfiError |
It computes the location of a point that is placed on a surface at a certain geodetic altitude over the Earth, that lays on the plane defined by the satellite position, the nadir and a reference point. | |
native void | targetIncidenceAngle (final SatId satId, long deriv, double losAz, double incidenceAngle, double geodAlt, double losAzRate) throws CfiError |
It computes the location of a point that is placed on a surface at a certain geodetic altitude over the Earth and that is seen from the satellite on a line of sight that forms a certain azimuth angle in the selected Attitude Frame and that intersects that surface with a certain incidence angle. | |
native void | targetRange (final SatId satId, long deriv, double losAz, double range, double geodAlt, double losAzRate, double rangeRate) throws CfiError |
It computes the location of a point that is placed on a surface at a certain geodetic altitude over the Earth, that is seen from the satellite on a line of sight that forms a certain azimuth angle in the selected Attitude Frame, and that is at a certain range or slant-range from the satellite. | |
native void | targetRangeRate (final SatId satId, long deriv, double efRangeRate, double range, double geodAlt, double efRangeRateRate, double rangeRate) throws CfiError |
It computes the location of a point that is placed on a surface at a certain geodetic altitude over the Earth, that is at a certain range from the satellite, and whose associatedEarth-fixed target has a certain range-rate value. | |
native void | targetTangent (final SatId satId, long deriv, double losAz, double losEl, double losAzRate, double losElRate, long iray, double freq) throws CfiError |
It computes the location of the tangent point over the Earth that is located on the line of sight defined by an elevation and azimuth angles expressed in the selected Attitude Frame. | |
native void | targetAltitude (final SatId satId, long deriv, double losAz, double geodAlt, double losAzRate, long iray, double freq) throws CfiError |
It computes the location of the tangent point over the Earth that is located on a surface at a certain geodetic altitude over the Earth and that is on a line of sight that forms a certain azimuth angle in the selected Attitude Frame. | |
native void | targetStar (final SatId satId, long deriv, double starRa, double starDec, double starRaRate, double starDecRate, long iray, double freq) throws CfiError |
It computes the location of the tangent point over the Earth that is located on the line of sight that points to a star defined by its right ascension and declination coordinates. | |
native void | targetTangentSun (final SatId satId, long deriv, long iray, double freq) throws CfiError |
It computes the location of the tangent point over the Earth that is located on the line of sight that points to the Sun. | |
native void | targetTangentMoon (final SatId satId, long deriv, long iray, double freq) throws CfiError |
It computes the location of the tangent point over the Earth that is located on the line of sight that points to the Moon. | |
native void | targetStation (final SatId satId, long deriv, double geocLong, double geodLat, double geodAlt, double minLinkEl) throws CfiError |
It computes the most relevant observation parameters of the link between the satellite and a ground station. | |
native void | targetDRS (final SatId satId, long deriv, double[] drsPos, double[] drsVel) throws CfiError |
It computes the most relevant observation parameters of the link between the satellite and a Data Relay Satellite. | |
native void | targetGeneric (final SatId satId, long deriv, double[] targPos, double[] targVel, double[] targAcc) throws CfiError |
It allows the user to provide the target location (position and velocity) and later calculate extra results from it. | |
native void | targetReflected (final SatId satId, long deriv, double geodAlt, double deflectionNorth, double deflectionEast, long sourceType, double[] sourceParam) throws CfiError |
It allows the user to compute, from S/C position and attitude, and emitting source position, the point of reflection from the source towards the SC at a certain geodetic altitude. | |
native void | targetSc (final SatId satId1, final SatId satId2, final Attitude att2, long deriv) throws CfiError |
It computes the pointing from one satellite to another satellite. | |
native void | multiTargetInter (final SatId satId, long deriv, long interFlag, double losAz, double losEl, long numTarget, double[] geodAlt, double losAzRate, double losElRate, long iray, double freq) throws CfiError |
It computes the first or the second intersection points of the line of sight from the satellite with surfaces located at certain geodetic altitudes over the Earth. | |
native void | multiTargetTravelTime (final SatId satId, long deriv, double losAz, double losEl, long numTarget, double[] travelTime, double losAzRate, double losElRate, double travelTimeRate, long iray, double freq) throws CfiError |
It computes the points of the line or sight from the satellite at given travel times along the (curved) line of sight. | |
native TargetOutput | targetListInter (final SatId satId, long deriv, long interFlag, final InstrumentData instrData, double geodAlt) |
Compute the first or the second intersection point of the line of sight from the satellite with a surface located at a certanin geodetic altitude over the Earth for a set of azimuth/elevation points. | |
native TargetExtra | extraVector (long choice, long targetType, long targetNumber) throws CfiError |
It provides the following output parameters for target(s): target position, velocity and acceleration vectors, line of sight direction, range, travel time and their corresponding derivatives. | |
native TargetExtra | extraMain (long choice, long targetType, long targetNumber) throws CfiError |
It computes the extra parameter for the target(s) in input data structure. | |
native TargetExtra | extraAux (long choice, long targetType, long targetNumber) throws CfiError |
It computes auxiliary parameters for the target in input data structure. | |
native TargetExtra | extraTargetToSun (long choice, long targetType, long targetNumber, long iray, double freq) throws CfiError |
It computes extra parameters related to the pointing fromthe target in input data structure to the sun. | |
native TargetExtra | extraTargetToMoon (long choice, long targetType, long targetNumber, long iray, double freq) throws CfiError |
It computes extra parameters related to the pointing from the target in input data structure to the moon. | |
native TargetExtra | extraEfTarget (long choice, long targetType, long targetNumber, double freq) throws CfiError |
It computes the parameter for an Earth fixed target related to the target in input data structure. | |
native TargetExtra | extraSpecularReflection (long choice, long targetType, long targetNumber, double deflectionNorth, double deflectionEast) throws CfiError |
It calculates the direction of the specular reflection associated to a given target. | |
native TargetExtraResultsList | extraListVector (long choice, long targetType) throws CfiError |
It provides the following output parameters for targets computed. | |
native TargetExtraResultsList | extraListMain (long choice, long targetType) throws CfiError |
It computes the extra parameter for the targets computed with targetList methods. | |
native TargetExtraResultsList | extraListAux (long choice, long targetType) throws CfiError |
It computes auxiliary parameters for the targets computed with targetList methods. | |
native TargetExtraResultsList | extraListTargetToSun (long choice, long targetType, long iray, double freq) throws CfiError |
It computes extra parameters related to the pointing from the targets computed with targetList methods to the sun. | |
native TargetExtraResultsList | extraListTargetToMoon (long choice, long targetType, long iray, double freq) throws CfiError |
It computes extra parameters related to the pointing from the targets computed with targetList methods to the moon. | |
native TargetExtraResultsList | extraListEfTarget (long choice, long targetType, double freq) throws CfiError |
It computes the parameter for an Earth fixed target related to the targets computed with targetList methods. | |
native TargetExtraResultsList | extraListSpecularReflection (long choice, long targetType, double deflectionNorth, double deflectionEast) throws CfiError |
It calculates the direction of the specular reflection associated to the targets computed with targetList methods. | |
native SatId | satId () |
Return satellite id. | |
native TargetIdData[] | getData () throws CfiError |
It gets target parameters. | |
native void | eq (final Target target) |
Copy operator. | |
Public Attributes | |
long | numUserTarget |
Number of user defined targer calculated. | |
long | numLosTarget |
Number of Line Of Sight target calculated. |
Class for target calculations.
Class constructor.
void EECFI.Target::eq | ( | final Target | target | ) |
TargetExtra EECFI.Target::extraAux | ( | long | choice, | |
long | targetType, | |||
long | targetNumber | |||
) | throws CfiError |
It computes auxiliary parameters for the target in input data structure.
Note on targetNumber with targets computed with Target.targetListInter: the targetNumber to be used to get a specific LOS target is an incremental number. That is, if there are N user targets US1, US2, ... USN and a number of LOS targets for every user target NLOS1, NLOS2, ..., NLOSN, if we want to get LOS target with index 1 corresponding to user target US3, the targetNumber to be used must be NLOS1+NLOS2+1.
The targetNumber can also be get with the returned array by Target.getData.
choice | Flag to select the extra results to be computed (TargetResAuxNameEnum). Even though derivatives could be requested by user, they will not be calculated if the target was computed without derivatives (a warning is raised in this case). | |
targetType | Flag to select the type of target (TargetTypeEnum). | |
targetNumber | Target number. |
Results rate rate vector; components:
[0] Radius of curvature-rate-rate in the look direction at the nadir of the target (Earth fixed CS) [m/s]
[1] Distance-rate-rate from the nadir of the target to the satellite nadir (EF CS) [m/s]
[2] Distance-rate-rate from the nadir of the target to the ground track (EF CS) [m/s]
[3] Distance-rate-rate from the SSP to the point located on the ground track that is at a minimum distance from the nadir of the target (EF CS) [m/s].
TargetExtra EECFI.Target::extraEfTarget | ( | long | choice, | |
long | targetType, | |||
long | targetNumber, | |||
double | freq | |||
) | throws CfiError |
It computes the parameter for an Earth fixed target related to the target in input data structure.
Note on targetNumber with targets computed with Target.targetListInter: the targetNumber to be used to get a specific LOS target is an incremental number. That is, if there are N user targets US1, US2, ... USN and a number of LOS targets for every user target NLOS1, NLOS2, ..., NLOSN, if we want to get LOS target with index 1 corresponding to user target US3, the targetNumber to be used must be NLOS1+NLOS2+1.
The targetNumber can also be get with the returned array by Target.getData.
choice | Flag to select the extra results to be computed (DerivPointingEnum). Even though derivatives could be requested by user, they will not be calculated if the target was computed without derivatives (a warning is raised in this case). | |
targetType | Flag to select the type of target (TargetTypeEnum). | |
targetNumber | Target number. | |
freq | Frequency of the signal [Hz]. Allowed range: >0. |
TargetExtraResultsList EECFI.Target::extraListAux | ( | long | choice, | |
long | targetType | |||
) | throws CfiError |
It computes auxiliary parameters for the targets computed with targetList methods.
choice | Flag to select the extra results to be computed (TargetResAuxNameEnum). Even though derivatives could be requested by user, they will not be calculated if the target was computed without derivatives (a warning is raised in this case). | |
targetType | Flag to select the type of target (TargetTypeEnum). |
TargetExtraResultsList EECFI.Target::extraListEfTarget | ( | long | choice, | |
long | targetType, | |||
double | freq | |||
) | throws CfiError |
It computes the parameter for an Earth fixed target related to the targets computed with targetList methods.
choice | Flag to select the extra results to be computed (DerivPointingEnum). Even though derivatives could be requested by user, they will not be calculated if the target was computed without derivatives (a warning is raised in this case). | |
targetType | Flag to select the type of target (TargetTypeEnum). | |
freq | Frequency of the signal [Hz]. Allowed range: >0. |
TargetExtraResultsList EECFI.Target::extraListMain | ( | long | choice, | |
long | targetType | |||
) | throws CfiError |
It computes the extra parameter for the targets computed with targetList methods.
choice | Flag to select the extra results to be computed (TargetResMainNameEnum). Even though derivatives could be requested by user, they will not be calculated if the target was computed without derivatives (a warning is raised in this case). | |
targetType | Flag to select the type of target (TargetTypeEnum). |
TargetExtraResultsList EECFI.Target::extraListSpecularReflection | ( | long | choice, | |
long | targetType, | |||
double | deflectionNorth, | |||
double | deflectionEast | |||
) | throws CfiError |
It calculates the direction of the specular reflection associated to the targets computed with targetList methods.
choice | Flag to select the extra results to be computed (DerivPointingEnum). Even though derivatives could be requested by user, they will not be calculated if the target was computed without derivatives (a warning is raised in this case). | |
targetType | Flag to select the type of target (TargetTypeEnum). | |
targetNumber | Target number. | |
deflectionNorth | North-South component of the vertical deflection [deg]. Allowed range: >=-90; <=90. | |
deflectionEast | East-West component of the vertical deflection [deg]. Allowed range: >=-90; <=90. |
TargetExtraResultsList EECFI.Target::extraListTargetToMoon | ( | long | choice, | |
long | targetType, | |||
long | iray, | |||
double | freq | |||
) | throws CfiError |
It computes extra parameters related to the pointing from the targets computed with targetList methods to the moon.
choice | Flag to select the extra results to be computed (DerivPointingEnum). Even though derivatives could be requested by user, they will not be calculated if the target was computed without derivatives (a warning is raised in this case). | |
targetType | Flag to select the type of target (TargetTypeEnum). | |
iray | Ray tracing model switch (not used). | |
freq | Frequency of the signal [Hz]. Allowed range: >0. |
TargetExtraResultsList EECFI.Target::extraListTargetToSun | ( | long | choice, | |
long | targetType, | |||
long | iray, | |||
double | freq | |||
) | throws CfiError |
It computes extra parameters related to the pointing from the targets computed with targetList methods to the sun.
Note: it can be internally applied a correction to computations in order to compensate for the travel time of light from the Sun to the Earth and the satellites orbiting it. To activate this compensation, the Sun model in xl_model_id must be initialized with the enum XL_MODEL_SUN_TRAVEL_TIME using the function xl_model_init (see [LIBSUM]).
choice | Flag to select the extra results to be computed (DerivPointingEnum). Even though derivatives could be requested by user, they will not be calculated if the target was computed without derivatives (a warning is raised in this case). | |
targetType | Flag to select the type of target (TargetTypeEnum). | |
iray | Ray tracing model switch (not used). | |
freq | Frequency of the signal [Hz]. Allowed range: >0. |
TargetExtraResultsList EECFI.Target::extraListVector | ( | long | choice, | |
long | targetType | |||
) | throws CfiError |
It provides the following output parameters for targets computed.
with targetList methods: target position, velocity and acceleration vectors, line of sight direction, range, travel time and their corresponding derivatives.
choice | Flag to select the extra results to be computed (DerivPointingEnum). Even though derivatives could be requested by user, they will not be calculated if the target was computed without derivatives (a warning is raised in this case). | |
targetType | Flag to select the type of target (TargetTypeEnum). |
TargetExtra EECFI.Target::extraMain | ( | long | choice, | |
long | targetType, | |||
long | targetNumber | |||
) | throws CfiError |
It computes the extra parameter for the target(s) in input data structure.
Note on targetNumber with targets computed with Target.targetListInter: the targetNumber to be used to get a specific LOS target is an incremental number. That is, if there are N user targets US1, US2, ... USN and a number of LOS targets for every user target NLOS1, NLOS2, ..., NLOSN, if we want to get LOS target with index 1 corresponding to user target US3, the targetNumber to be used must be NLOS1+NLOS2+1.
The targetNumber can also be get with the returned array by Target.getData.
choice | Flag to select the extra results to be computed (TargetResMainNameEnum). Even though derivatives could be requested by user, they will not be calculated if the target was computed without derivatives (a warning is raised in this case). | |
targetType | Flag to select the type of target (TargetTypeEnum). | |
targetNumber | Target number. |
TargetExtra EECFI.Target::extraSpecularReflection | ( | long | choice, | |
long | targetType, | |||
long | targetNumber, | |||
double | deflectionNorth, | |||
double | deflectionEast | |||
) | throws CfiError |
It calculates the direction of the specular reflection associated to a given target.
Note on targetNumber with targets computed with Target.targetListInter: the targetNumber to be used to get a specific LOS target is an incremental number. That is, if there are N user targets US1, US2, ... USN and a number of LOS targets for every user target NLOS1, NLOS2, ..., NLOSN, if we want to get LOS target with index 1 corresponding to user target US3, the targetNumber to be used must be NLOS1+NLOS2+1.
The targetNumber can also be get with the returned array by Target.getData.
choice | Flag to select the extra results to be computed (DerivPointingEnum). Even though derivatives could be requested by user, they will not be calculated if the target was computed without derivatives (a warning is raised in this case). | |
targetType | Flag to select the type of target (TargetTypeEnum). | |
targetNumber | Target number. | |
deflectionNorth | North-South component of the vertical deflection [deg]. Allowed range: >=-90; <=90. | |
deflectionEast | East-West component of the vertical deflection [deg]. Allowed range: >=-90; <=90. |
TargetExtra EECFI.Target::extraTargetToMoon | ( | long | choice, | |
long | targetType, | |||
long | targetNumber, | |||
long | iray, | |||
double | freq | |||
) | throws CfiError |
It computes extra parameters related to the pointing from the target in input data structure to the moon.
Note on targetNumber with targets computed with Target.targetListInter: the targetNumber to be used to get a specific LOS target is an incremental number. That is, if there are N user targets US1, US2, ... USN and a number of LOS targets for every user target NLOS1, NLOS2, ..., NLOSN, if we want to get LOS target with index 1 corresponding to user target US3, the targetNumber to be used must be NLOS1+NLOS2+1.
The targetNumber can also be get with the returned array by Target.getData.
choice | Flag to select the extra results to be computed (DerivPointingEnum). Even though derivatives could be requested by user, they will not be calculated if the target was computed without derivatives (a warning is raised in this case). | |
targetType | Flag to select the type of target (TargetTypeEnum). | |
targetNumber | Target number. | |
iray | Ray tracing model switch (not used). | |
freq | Frequency of the signal [Hz]. Allowed range: >0. |
TargetExtra EECFI.Target::extraTargetToSun | ( | long | choice, | |
long | targetType, | |||
long | targetNumber, | |||
long | iray, | |||
double | freq | |||
) | throws CfiError |
It computes extra parameters related to the pointing fromthe target in input data structure to the sun.
Note: 1) On targetNumber with targets computed with Target.targetListInter: the targetNumber to be used to get a specific LOS target is an incremental number. That is, if there are N user targets US1, US2, ... USN and a number of LOS targets for every user target NLOS1, NLOS2, ..., NLOSN, if we want to get LOS target with index 1 corresponding to user target US3, the targetNumber to be used must be NLOS1+NLOS2+1.
The targetNumber can also be get with the returned array by Target.getData. 2) It can be internally applied a correction to computations in order to compensate for the travel time of light from the Sun to the Earth and the satellites orbiting it. To activate this compensation, the Sun model in xl_model_id must be initialized with the enum XL_MODEL_SUN_TRAVEL_TIME using the function xl_model_init (see [LIBSUM]).
choice | Flag to select the extra results to be computed (DerivPointingEnum). Even though derivatives could be requested by user, they will not be calculated if the target was computed without derivatives (a warning is raised in this case). | |
targetType | Flag to select the type of target (TargetTypeEnum). | |
targetNumber | Target number. | |
iray | Ray tracing model switch (not used). | |
freq | Frequency of the signal [Hz]. Allowed range: >0. |
TargetExtra EECFI.Target::extraVector | ( | long | choice, | |
long | targetType, | |||
long | targetNumber | |||
) | throws CfiError |
It provides the following output parameters for target(s): target position, velocity and acceleration vectors, line of sight direction, range, travel time and their corresponding derivatives.
Note on targetNumber with targets computed with Target.targetListInter: the targetNumber to be used to get a specific LOS target is an incremental number. That is, if there are N user targets US1, US2, ... USN and a number of LOS targets for every user target NLOS1, NLOS2, ..., NLOSN, if we want to get LOS target with index 1 corresponding to user target US3, the targetNumber to be used must be NLOS1+NLOS2+1.
The targetNumber can also be get with the returned array by Target.getData.
choice | Flag to select the extra results to be computed (DerivPointingEnum). Even though derivatives could be requested by user, they will not be calculated if the target was computed without derivatives (a warning is raised in this case). | |
targetType | Flag to select the type of target (TargetTypeEnum). | |
targetNumber | Target number. |
TargetIdData EECFI.Target::getData | ( | ) | throws CfiError |
It gets target parameters.
Note on return array:
void EECFI.Target::multiTargetInter | ( | final SatId | satId, | |
long | deriv, | |||
long | interFlag, | |||
double | losAz, | |||
double | losEl, | |||
long | numTarget, | |||
double[] | geodAlt, | |||
double | losAzRate, | |||
double | losElRate, | |||
long | iray, | |||
double | freq | |||
) | throws CfiError |
It computes the first or the second intersection points of the line of sight from the satellite with surfaces located at certain geodetic altitudes over the Earth.
satId | Satellite id. | |
deriv | Derivative order (DerivPointingEnum). | |
interFlag | Flag for first or second intersection point selection (XPCFI_INTER_1ST or XPCFI_INTER_2ND). | |
losAz | Azimuth of the LOS (Attitude frame) [deg]. Allowed range: >=0; <360. | |
losEl | Elevation of the LOS (Attitude frame) [deg]. Allowed range: >=-90; <=90. | |
numTarget | Number of user defined altitudes. | |
geodAlt | Geodetic altitude over the Earth [m]. Allowed range: >=-bWGS. | |
losAzRate | Azimuth rate of the LOS (Attitude frame) [deg/s]. | |
losElRate | Elevation rate of the LOS (Attitude frame) [deg/s]. | |
iray | Ray tracing model switch (not used). | |
freq | Frequency of the signal [Hz]. Allowed range: >0. |
void EECFI.Target::multiTargetTravelTime | ( | final SatId | satId, | |
long | deriv, | |||
double | losAz, | |||
double | losEl, | |||
long | numTarget, | |||
double[] | travelTime, | |||
double | losAzRate, | |||
double | losElRate, | |||
double | travelTimeRate, | |||
long | iray, | |||
double | freq | |||
) | throws CfiError |
It computes the points of the line or sight from the satellite at given travel times along the (curved) line of sight.
satId | Satellite id. | |
deriv | Derivative order (DerivPointingEnum). | |
losAz | Azimuth of the LOS (Attitude frame) [deg]. Allowed range: >=0; <360. | |
losEl | Elevation of the LOS (Attitude frame) [deg]. Allowed range: >=-90; <=90. | |
numTarget | Number of user defined altitudes. | |
travelTime | Travel time along the (curved) line of sight [s]. Allowed range: >0. | |
losAzRate | Azimuth rate of the LOS (Attitude frame) [deg/s]. | |
losElRate | Elevation rate of the LOS (Attitude frame) [deg/s]. | |
travelTimeRate | Travel time rate along the (curved) line of sight [s/s]. | |
iray | Ray tracing model switch (not used). | |
freq | Frequency of the signal [Hz]. Allowed range: >0. |
SatId EECFI.Target::satId | ( | ) |
Return satellite id.
void EECFI.Target::targetAltitude | ( | final SatId | satId, | |
long | deriv, | |||
double | losAz, | |||
double | geodAlt, | |||
double | losAzRate, | |||
long | iray, | |||
double | freq | |||
) | throws CfiError |
It computes the location of the tangent point over the Earth that is located on a surface at a certain geodetic altitude over the Earth and that is on a line of sight that forms a certain azimuth angle in the selected Attitude Frame.
satId | Satellite id. | |
deriv | Derivative order (DerivPointingEnum). | |
losAz | Azimuth of the LOS (Attitude frame) [deg]. Allowed range: >=0; <360. | |
geodAlt | Geodetic altitude over the Earth [m]. Allowed range: >=-bWGS. | |
losAzRate | Azimuth rate of the LOS (Attitude frame) [deg/s]. | |
iray | Ray tracing model switch (not used). | |
freq | Frequency of the signal [Hz]. Allowed range: >0. |
void EECFI.Target::targetDRS | ( | final SatId | satId, | |
long | deriv, | |||
double[] | drsPos, | |||
double[] | drsVel | |||
) | throws CfiError |
It computes the most relevant observation parameters of the link between the satellite and a Data Relay Satellite.
This method is obsolete and will be removed in future versions of the CFI.
satId | Satellite id. | |
deriv | Derivative order (DerivPointingEnum). | |
drsPos | DRS position vector (Earth Fixed CS) [m]. | |
drsVel | DRS velocity vector (Earth Fixed CS) [m/s]. |
void EECFI.Target::targetGeneric | ( | final SatId | satId, | |
long | deriv, | |||
double[] | targPos, | |||
double[] | targVel, | |||
double[] | targAcc | |||
) | throws CfiError |
It allows the user to provide the target location (position and velocity) and later calculate extra results from it.
void EECFI.Target::targetGroundRange | ( | final SatId | satId, | |
long | deriv, | |||
double | losAz, | |||
double | losEl, | |||
double | geodAlt, | |||
double | distance, | |||
double | losAzRate, | |||
double | losElRate | |||
) | throws CfiError |
It computes the location of a point that is placed on a surface at a certain geodetic altitude over the Earth, that lays on the plane defined by the satellite position, the nadir and a reference point.
satId | Satellite id. | |
deriv | Derivative order (DerivPointingEnum). | |
losAz | Azimuth of the LOS (Attitude frame) [deg]. Allowed range: >=0; <360. | |
losEl | Elevation of the LOS (Attitude frame) [deg]. Allowed range: >=-90; <=90. | |
geodAlt | Geodetic altitude over the Earth [m]. Allowed range: >=-bWGS. | |
distance | Distance or ground range to the reference point, positive from nadir in the azimuth direction (Earth Fixed CS) [m]. | |
losAzRate | Azimuth rate of the LOS (Attitude frame) [deg/s]. | |
losElRate | Elevation rate of the LOS (Attitude frame) [deg/s]. |
void EECFI.Target::targetIncidenceAngle | ( | final SatId | satId, | |
long | deriv, | |||
double | losAz, | |||
double | incidenceAngle, | |||
double | geodAlt, | |||
double | losAzRate | |||
) | throws CfiError |
It computes the location of a point that is placed on a surface at a certain geodetic altitude over the Earth and that is seen from the satellite on a line of sight that forms a certain azimuth angle in the selected Attitude Frame and that intersects that surface with a certain incidence angle.
satId | Satellite id. | |
deriv | Derivative order (DerivPointingEnum). | |
losAz | Azimuth of the LOS (Attitude frame) [deg]. Allowed range: >=0; <360. | |
incidenceAngle | Incidence angle of the LOS [deg]. Allowed range: >=0; <=90. | |
geodAlt | Geodetic altitude over the Earth [m]. Allowed range: >=-bWGS. | |
losAzRate | Azimuth rate of the LOS (Attitude frame) [deg/s]. |
void EECFI.Target::targetInter | ( | final SatId | satId, | |
long | deriv, | |||
long | interFlag, | |||
double | losAz, | |||
double | losEl, | |||
double | geodAlt, | |||
double | losAzRate, | |||
double | losElRate, | |||
long | iray, | |||
double | freq | |||
) | throws CfiError |
Compute the first or the second intersection point of the line of sight from the satellite with a surface located at a certanin geodetic altitude over the Earth.
satId | Satellite id. | |
deriv | Derivative order (DerivPointingEnum). | |
interFlag | Flag for first or second intersection point selection (XPCFI_INTER_1ST or XPCFI_INTER_2ND). | |
losAz | Azimuth of the LOS (Attitude frame) [deg]. Allowed range: >=0; <360. | |
losEl | Elevation of the LOS (Attitude frame) [deg]. Allowed range: >=-90; <=90. | |
geodAlt | Geodetic altitude over the Earth [m]. Allowed range: >=-bWGS. | |
losAzRate | Azimuth rate of the LOS (Attitude frame) [deg/s]. | |
losElRate | Elevation rate of the LOS (Attitude frame) [deg/s]. | |
iray | Ray tracing model switch (not used). | |
freq | Frequency of the signal [Hz]. Allowed range: >0. |
TargetOutput EECFI.Target::targetListInter | ( | final SatId | satId, | |
long | deriv, | |||
long | interFlag, | |||
final InstrumentData | instrData, | |||
double | geodAlt | |||
) |
Compute the first or the second intersection point of the line of sight from the satellite with a surface located at a certanin geodetic altitude over the Earth for a set of azimuth/elevation points.
The sets of azimuth and elevation points can be defined in 3 different ways:satId | Satellite id. | |
deriv | Derivative order (DerivPointingEnum). | |
interFlag | Flag for first or second intersection point selection (XPCFI_INTER_1ST or XPCFI_INTER_2ND). | |
instrData | Instrument data. | |
geodAlt | Geodetic altitude over the Earth [m]. Allowed range: >=-bWGS. |
void EECFI.Target::targetRange | ( | final SatId | satId, | |
long | deriv, | |||
double | losAz, | |||
double | range, | |||
double | geodAlt, | |||
double | losAzRate, | |||
double | rangeRate | |||
) | throws CfiError |
It computes the location of a point that is placed on a surface at a certain geodetic altitude over the Earth, that is seen from the satellite on a line of sight that forms a certain azimuth angle in the selected Attitude Frame, and that is at a certain range or slant-range from the satellite.
satId | Satellite id. | |
deriv | Derivative order (DerivPointingEnum). | |
losAz | Azimuth of the LOS (Attitude frame) [deg]. Allowed range: >=0; <360. | |
range | Range to the satellite (Earth Fixed CS) [m]. Allowed range: >0. | |
geodAlt | Geodetic altitude over the Earth [m]. Allowed range: >=-bWGS. | |
losAzRate | Azimuth rate of the LOS (Attitude frame) [deg/s]. | |
rangeRate | Range rate to the satellite (Earth Fixed CS) [m/s]. |
void EECFI.Target::targetRangeRate | ( | final SatId | satId, | |
long | deriv, | |||
double | efRangeRate, | |||
double | range, | |||
double | geodAlt, | |||
double | efRangeRateRate, | |||
double | rangeRate | |||
) | throws CfiError |
It computes the location of a point that is placed on a surface at a certain geodetic altitude over the Earth, that is at a certain range from the satellite, and whose associatedEarth-fixed target has a certain range-rate value.
satId | Satellite id. | |
deriv | Derivative order (DerivPointingEnum). | |
efRangeRate | Range rate of the related Earth-Fixed target (Earth Fixed CS) [m/s]. | |
range | Range to the satellite (Earth Fixed CS) [m]. Allowed range: >0. | |
geodAlt | Geodetic altitude over the Earth [m]. Allowed range: >=-bWGS. | |
efRangeRateRate | Range rate rate of the related Earth-Fixed target (Earth Fixed CS) [m/s2]. | |
rangeRate | Range rate to the satellite (Earth Fixed CS) [m/s]. |
void EECFI.Target::targetReflected | ( | final SatId | satId, | |
long | deriv, | |||
double | geodAlt, | |||
double | deflectionNorth, | |||
double | deflectionEast, | |||
long | sourceType, | |||
double[] | sourceParam | |||
) | throws CfiError |
It allows the user to compute, from S/C position and attitude, and emitting source position, the point of reflection from the source towards the SC at a certain geodetic altitude.
Note: in some limit configurations the function will return a degraded solution (returning also a warning), being 5 milidegrees the maximum difference between the incidence angle and the reflected angle.
satId | Satellite id. | |
deriv | Derivative order (DerivPointingEnum). | |
geodAlt | Geodetic altitude (Earth Fixed CS) [deg]. Allowed range: >=-90; <=90. | |
deflectionNorth | North-South component of the vertical deflection [deg]. Allowed range: >=-90; <=90. | |
deflectionEast | East-West component of the vertical deflection [deg]. Allowed range: >=-90; <=90. | |
sourceType | Type of the source (SourceTypeEnum). | |
sourceParam | Vector with parameters (depends on sourceType).
. |
native void EECFI.Target.targetSc | ( | final SatId | satId1, | |
final SatId | satId2, | |||
final Attitude | att2, | |||
long | deriv | |||
) | throws CfiError |
It computes the pointing from one satellite to another satellite.
void EECFI.Target::targetStar | ( | final SatId | satId, | |
long | deriv, | |||
double | starRa, | |||
double | starDec, | |||
double | starRaRate, | |||
double | starDecRate, | |||
long | iray, | |||
double | freq | |||
) | throws CfiError |
It computes the location of the tangent point over the Earth that is located on the line of sight that points to a star defined by its right ascension and declination coordinates.
satId | Satellite id. | |
deriv | Derivative order (DerivPointingEnum). | |
starRa | Right ascension of the star (True of Date CS) [deg]. Allowed range: >=0; <360. | |
starDec | Declination of the star (True of Date CS) [deg]. Allowed range: >=-90; <=90. | |
starRaRate | Right ascension of the star rate (True of Date CS) [deg/s]. | |
starDecRate | Declination of the star rate (True of Date CS) [deg/s]. | |
iray | Ray tracing model switch (not used). | |
freq | Frequency of the signal [Hz]. Allowed range: >0. |
void EECFI.Target::targetStation | ( | final SatId | satId, | |
long | deriv, | |||
double | geocLong, | |||
double | geodLat, | |||
double | geodAlt, | |||
double | minLinkEl | |||
) | throws CfiError |
It computes the most relevant observation parameters of the link between the satellite and a ground station.
satId | Satellite id. | |
deriv | Derivative order (DerivPointingEnum). | |
geocLong | GS geocentric longitude (Earth Fixed CS) [deg]. Allowed range: >=0; <360. | |
geodLat | GS geodetic latitude (Earth Fixed CS) [deg]. Allowed range: >=-90; <=90. | |
geodAlt | GS Geodetic altitude (Earth Fixed CS) [m]. Allowed range: >=-bWGS. | |
minLinkEl | GS minimum link elevation (Topocentric CS) [deg]. Allowed range: >=-90; <=90. |
void EECFI.Target::targetTangent | ( | final SatId | satId, | |
long | deriv, | |||
double | losAz, | |||
double | losEl, | |||
double | losAzRate, | |||
double | losElRate, | |||
long | iray, | |||
double | freq | |||
) | throws CfiError |
It computes the location of the tangent point over the Earth that is located on the line of sight defined by an elevation and azimuth angles expressed in the selected Attitude Frame.
satId | Satellite id. | |
deriv | Derivative order (DerivPointingEnum). | |
losAz | Azimuth of the LOS (Attitude frame) [deg]. Allowed range: >=0; <360. | |
losEl | Elevation of the LOS (Attitude frame) [deg]. Allowed range: >=-90; <=90. | |
losAzRate | Azimuth rate of the LOS (Attitude frame) [deg/s]. | |
losElRate | Elevation rate of the LOS (Attitude frame) [deg/s]. | |
iray | Ray tracing model switch (not used). | |
freq | Frequency of the signal [Hz]. Allowed range: >0. |
void EECFI.Target::targetTangentMoon | ( | final SatId | satId, | |
long | deriv, | |||
long | iray, | |||
double | freq | |||
) | throws CfiError |
It computes the location of the tangent point over the Earth that is located on the line of sight that points to the Moon.
satId | Satellite id. | |
deriv | Derivative order (DerivPointingEnum). | |
iray | Ray tracing model switch (not used). | |
freq | Frequency of the signal [Hz]. Allowed range: >0. |
void EECFI.Target::targetTangentSun | ( | final SatId | satId, | |
long | deriv, | |||
long | iray, | |||
double | freq | |||
) | throws CfiError |
It computes the location of the tangent point over the Earth that is located on the line of sight that points to the Sun.
Note: it can be internally applied a correction to computations in order to compensate for the travel time of light from the Sun to the Earth and the satellites orbiting it. To activate this compensation, the Sun model in xl_model_id must be initialized with the enum XL_MODEL_SUN_TRAVEL_TIME using the function xl_model_init (see [LIBSUM]).
satId | Satellite id. | |
deriv | Derivative order (DerivPointingEnum). | |
iray | Ray tracing model switch (not used). | |
freq | Frequency of the signal [Hz]. Allowed range: >0. |
void EECFI.Target::targetTravelTime | ( | final SatId | satId, | |
long | deriv, | |||
double | losAz, | |||
double | losEl, | |||
double | travelTime, | |||
double | losAzRate, | |||
double | losElRate, | |||
double | travelTimeRate, | |||
long | iray, | |||
double | freq | |||
) | throws CfiError |
It computes the point of the line or sight from the satellite at a given travel time along the line of sight.
satId | Satellite id. | |
deriv | Derivative order (DerivPointingEnum). | |
losAz | Azimuth of the LOS (Attitude frame) [deg]. Allowed range: >=0; <360. | |
losEl | Elevation of the LOS (Attitude frame) [deg]. Allowed range: >=-90; <=90. | |
travelTime | Travel time along the (curved) line of sight [s]. Allowed range: >0. | |
losAzRate | Azimuth rate of the LOS (Attitude frame) [deg/s]. | |
losElRate | Elevation rate of the LOS (Attitude frame) [deg/s]. | |
travelTimeRate | Travel time rate along the (curved) line of sight [s/s]. | |
iray | Ray tracing model switch (not used). | |
freq | Frequency of the signal [Hz]. Allowed range: >0. |
Number of Line Of Sight target calculated.
Number of user defined targer calculated.