test_facetedSpacecraftProjectedArea

test_facetedSpacecraftProjectedArea.test_facetedSpacecraftProjectedArea(show_plots, general_heading, sun_heading, velocity_heading)[source]

Verification Test Description

This unit test verifies that the faceted spacecraft projected area BSK module correctly computes the per-facet and total projected area of a faceted spacecraft model using a provided heading direction vector. The module can be configured for three different heading direction types. The first (most direct) option is to provide a general heading direction using the module BodyHeadingMsgPayload input message. In this case, the heading vector must be provided relative to and expressed in the hub body frame B. The second heading configuration option is for the sun direction heading. In this case, the facet sunlit areas are computed. This option requires two module input messages (SpicePlanetStateMsgPayload and SCStatesMsgPayload) to be configured. The spice input message must contain the Sun inertial state information, while the spacecraft state message contains the spacecraft hub inertial state information. The third heading option is to configure the velocity heading for the exposed area to drag, which requires setting the module SCStatesMsgPayload input message. In this case, the heading vector is set as the direction of the spacecraft hub’s inertial velocity vector.

This test sets up a simulation for each of the three heading configuration options. All tests set up the faceted spacecraft projected area BSK module identically with two different facets. The test checks that the computed truth values match the values output from the module.

Test Parameters

Parameters:

  • general_heading (bool) – Option 1: Direct general heading test

  • sun_heading (bool) – Option 2: Sun heading for sunlit area calculation test

  • velocity_heading (bool) – Option 3: Spacecraft inertial velocity heading for area exposed to drag test

Description of Variables Being Tested

The test checks that the module correctly computes the per-facet and total projected area of a faceted spacecraft model using a provided heading direction vector. The specific variables checked are the per-facet and total projected area(s).