Spacecraft.SpacecraftNoon(TimeSpanArray, Array) Method

 Top 

Description

Computes the observed noon as seen by the Spacecraft. Noon is defined as the midpoint between the two times when the Spacecraft exits and enters the Earth's umbral cone. This method returns the shadow entry and exits times, as well as the time of Spacecraft Noon.

 

Timing Precision Mode

This page describes functionality in nanosecond timing precision mode.

Click here to see the documentation for this object in millisecond timing precision mode.

 

Note: This is an interval method. See the Interval Methods page for more information.

Note: This method has a state. See the Methods and Properties with State page for more information.

 

Method Signature

Spacecraft.SpacecraftNoon(

TimeSpanArray EventTime,

Array EventType)

 

 

Arguments

EventTime

Description:

The time that the event occurred.

 

The FF_Preferences.IntervalEventReportingBehavior property controls whether the start of propagation is reported as an event. By default, if the exit from shadow is before the beginning of the propagation span, FreeFlyer will label the start of the propagation as the exit from shadow.

 

 

EventType

Description:

The type of the event that occurred. Event type == 1 is exit from shadow. Event type == 2 is entry into shadow. Event type == 3 is spacecraft noon.

 

 

 

Return Value

Type:

number

 

 

Returns the number of elements filled into EventType and EventTime arrays

 

Syntax

myVariable1 = mySpacecraft1.SpacecraftNoon(myTimeSpanArray1, myArray1);

 

 

Example 1

This example demonstrates how to generate a report of a Spacecraft's noon, defined to be the midpoint between the two times when the Spacecraft exits and enters the Earth's umbral cone. This method reports three different event types: Event type == 1 is exit from shadow, Event type == 2 is entry into shadow, Event type == 3 is the Spacecraft's noon, along with the event time.

 

Spacecraft Spacecraft1;

Variable i;

Variable noonTimes;

TimeSpanArray EventTime;

Array EventType;

String scEventType;

String scEventTime;

DataTableWindow scReport({scEventType, scEventTime});

 

While (Spacecraft1.ElapsedTime < TIMESPAN( 1 days));

 

          noonTimes = Spacecraft1.SpacecraftNoon(EventTime, EventType);

 

          If(noonTimes > 0) then;

                      For i = 0 to noonTimes - 1 step 1;

                                  Switch (EventType[i]);

                                              Case 1:

                                                          scEventType = "Exit From Shadow: ";

                                                          scEventTime = EventTime[i].ConvertToCalendarDate();

                                                          Update scReport;

                                                          Break;

                                              Case 2:

                                                          scEventType = "Entry Into Shadow: ";

                                                          scEventTime = EventTime[i].ConvertToCalendarDate();

                                                          Update scReport;

                                                          Break;

                                              Case 3:

                                                          scEventType = "Spacecraft Noon: ";

                                                          scEventTime = EventTime[i].ConvertToCalendarDate();

                                                          Update scReport;

                                  End;

                      End;

          End;

 

          Step Spacecraft1;

 

End;

 

 

Output:

 

scEventType

scEventTime

Exit From Shadow:

Spacecraft Noon:

Entry Into Shadow:

Exit From Shadow:

Spacecraft Noon:

Entry Into Shadow:

Exit From Shadow:

Spacecraft Noon:

Entry Into Shadow:

Exit From Shadow:

Spacecraft Noon:

Entry Into Shadow:

Exit From Shadow:

Spacecraft Noon:

Entry Into Shadow:

Exit From Shadow:

Spacecraft Noon:

Entry Into Shadow:

Exit From Shadow:

Spacecraft Noon:

Entry Into Shadow:

Exit From Shadow:

Spacecraft Noon:

Entry Into Shadow:

Exit From Shadow:

Spacecraft Noon:

Entry Into Shadow:

Exit From Shadow:

Spacecraft Noon:

Entry Into Shadow:

Exit From Shadow:

Spacecraft Noon:

Entry Into Shadow:

Exit From Shadow:

Spacecraft Noon:

Entry Into Shadow:

Exit From Shadow:

Spacecraft Noon:

Entry Into Shadow:

Exit From Shadow:

Spacecraft Noon:

Entry Into Shadow:

Exit From Shadow:

Jan 01 2020 00:06:53.232421875

Jan 01 2020 00:39:26.967773438

Jan 01 2020 01:12:00.703125000

Jan 01 2020 01:45:49.877929687

Jan 01 2020 02:18:23.576660156

Jan 01 2020 02:50:57.275390625

Jan 01 2020 03:24:46.450195312

Jan 01 2020 03:57:20.112304687

Jan 01 2020 04:29:53.774414062

Jan 01 2020 05:03:42.949218750

Jan 01 2020 05:36:16.647949219

Jan 01 2020 06:08:50.346679687

Jan 01 2020 06:42:39.594726562

Jan 01 2020 07:15:13.293457031

Jan 01 2020 07:47:46.992187500

Jan 01 2020 08:21:36.313476562

Jan 01 2020 08:54:10.012207031

Jan 01 2020 09:26:43.710937500

Jan 01 2020 10:00:33.105468750

Jan 01 2020 10:33:06.694335938

Jan 01 2020 11:05:40.283203125

Jan 01 2020 11:39:29.677734375

Jan 01 2020 12:12:03.229980469

Jan 01 2020 12:44:36.782226562

Jan 01 2020 13:18:26.176757812

Jan 01 2020 13:50:59.729003906

Jan 01 2020 14:23:33.281250000

Jan 01 2020 14:57:22.749023437

Jan 01 2020 15:29:56.264648437

Jan 01 2020 16:02:29.780273437

Jan 01 2020 16:36:19.321289062

Jan 01 2020 17:08:52.836914062

Jan 01 2020 17:41:26.352539062

Jan 01 2020 18:15:15.966796875

Jan 01 2020 18:47:49.445800781

Jan 01 2020 19:20:22.924804687

Jan 01 2020 19:54:12.612304687

Jan 01 2020 20:26:46.091308594

Jan 01 2020 20:59:19.570312500

Jan 01 2020 21:33:09.257812500

Jan 01 2020 22:05:42.700195313

Jan 01 2020 22:38:16.142578125

Jan 01 2020 23:12:05.903320312

 

 

 

See also

Spacecraft Object

Spacecraft.SpacecraftNoon

Spacecraft Propagation Guide

Coverage and Contact Analysis Guide