Evaluate satisfaction of multiple constraints at a specified time.
OnePointAccess <FromObjectPath> <ToObjectPath> {ComputeOption} [{SummaryOption}] [{TimeInterval} [<StepSize>]] [OutputFile "<FilePath>"]
One point access allows the user to configure and evaluate satisfaction of multiple constraints at a specified time.
Valid values for {ComputeOption} are Create, Compute, Remove. A OnePointAccess must be Created before any computations can be done, and it should be Removed when finished.
Valid values for {SummaryOption} are ResultOnly, FastSummary, DetailedSummary. If none is entered then FastSummary will be returned. If ResultOnly is entered, then OnePointAccess will return a Yes or No indicating if access is found at the current animation time, or the time specified. FastSummary and DetailedSummary will also return information about each constraint that is evaluated.
The access will be evaluated at the current animation time, unless a time option is entered. For valid {TimeInterval} values see Time Options. A single time can be entered to have access evaluated at a single point. Access will be evaluated over a time period if both start and stop time or an interval component is entered; in this case, the <StepSize> must also be entered. StepSize is entered in seconds.
Include the OutputFile "<FilePath>" to have the access information written to a file, instead of to the screen.
The values returned by this command, when using the FastSummary or DetailedSummary options are the constraint values at the time indicated. If the constraint is not unitless, these values are returned in internal units. For example, if the Elevation Angle constraint is turned on, the value returned is in radians. If the Range constraint is turned on, the value returned for this constraint is in meters.
Note: If constraints are changed for either object the OnePointAccess must be Removed and Created again.
Note: If more than one optional value is entered with the OnePointAccess command they must be entered in the order given in the format.
To create a one point access between Sat1 and Fac1:
OnePointAccess */Satellite/Sat1 */Facility/Fac1 Create
I Return entry 1:
I OnePointAccess for Satellite/Sat1 to Facility/Fac1 has been created.
Return a FastSummary for the access over the input time period, with a 240 second step size:
OnePointAccess */Satellite/Sat1 */Facility/Fac1 Compute "27 Oct 2004 00:50:00.00" "27 Oct 2004 01:10:00.00" 240
I Return entry 1:
I 27 Oct 2004 00:50:00.000 Yes
I Return entry 2:
I Satellite/Sat1 Range Ok 1.052392421574e+007
I Return entry 3:
I Facility/Fac1 LineOfSight Ok 9.434670144216e-001
I Return entry 4:
I 27 Oct 2004 00:54:00.000 Yes
I Return entry 5:
I Satellite/Sat1 Range Ok 1.093366285548e+007
I Return entry 6:
I Facility/Fac1 LineOfSight Ok 9.217866614886e-001
I Return entry 7:
I 27 Oct 2004 00:58:00.000 Yes
I Return entry 8:
I Satellite/Sat1 Range Ok 1.132176383687e+007
I Return entry 9:
I Facility/Fac1 LineOfSight Ok 8.979022214201e-001
I Return entry 10:
I 27 Oct 2004 01:02:00.000 Yes
I Return entry 11:
I Satellite/Sat1 Range Ok 1.168658415973e+007
I Return entry 12:
I Facility/Fac1 LineOfSight Ok 8.723200019068e-001
I Return entry 13:
I 27 Oct 2004 01:06:00.000 No
I Return entry 14:
I Satellite/Sat1 Range Max 1.202701569636e+007
I Return entry 15:
I 27 Oct 2004 01:10:00.000 No
I Return entry 16:
I Satellite/Sat1 Range Max 1.234234337131e+007
To remove the one point access between Sat1 and Fac1:
OnePointAccess */Satellite/Sat1 */Facility/Fac1 Remove
I Return entry 1:
I OnePointAccess for Satellite/Sat1 to Facility/Fac1 has been removed.
This command belongs to the following group(s):
10
STK Programming Interface 11.0.1