Determining Magnetic Conjugacy with SEET

STK Premium (Space) or STK Enterprise
You can obtain the necessary licenses for this tutorial by contacting AGI Support at support@agi.com or 1-800-924-7244.

This tutorial requires STK 12.9 or newer to complete in its entirety. If you have an earlier version of STK, you can view a legacy version of this lesson.

The results of the tutorial may vary depending on the user settings and data enabled (online operations, terrain server, dynamic Earth data, etc.). It is acceptable to have different results.

Capabilities covered

This lesson covers the following STK Capabilities:

  • STK Pro
  • Space Environment and Effects Tool (SEET)

Problem statement

You are an analyst for the DMSP satellite constellation. You need to determine the local magnetic vector location along the orbit and the times when the spacecraft is magnetically conjugate to your ground station. You will be modeling an event in 2016, so you will need to create an archive scenario.

Solution

Build a scenario that will model the DMSP satellite orbit of interest and a ground station of interest. Then use STK's Space Environment and Effects Tool (SEET) capability to model the geomagnetic conjugacy with respect to your objects of interest.

What you will learn

Upon completion of this tutorial, you will have a basic understanding of the following:

  • STK SEET Environment - specifically the International Geomagnetic Reference Field (IGRF) magnetic field model
  • How to use a Magnetic Field Line Separation constraint
  • How to analyze and report data

Video guidance

Watch the following video. Then follow the steps below, which incorporate the systems and missions you work on (sample inputs provided).

Creating a new scenario

Create a new scenario with an analysis period of 24 hours.

  1. Launch STK ().
  2. Click Create a Scenario in the Welcome to STK dialog box.
  3. Enter the following in the STK: New Scenario Wizard:
  4. Option Value
    Name SEET_MagneticConjugacy
    Location Default
    Start 1 Jul 2016 16:00:00.000 UTCG
    Stop 2 Jul 2016 16:00:00.000 UTCG
  5. Click OK when finished.
  6. Click Save () when the scenario loads. A folder with the same name as your scenario is created for you in the location specified above.
  7. Verify the scenario name and location.
  8. Click Save.
  9. Save () often!

Breaking it down

  • You will model the DMSP 5D-3 F17D satellite.
  • You will use the IGRP model as the magnetic model.
  • You will display the Geomagnetic vectors and report the results.

Using the STK SEET Magnetic Field component

SEET's Magnetic Field component computes the full vector magnetic field along the satellite path, as well as performing field-line tracing, using standard models. Typically, the International Geomagnetic Reference Field (IGRF) is used to model the Earth main (core) field contribution. The IGRF is a multi-pole spherical harmonic approximation fit to measurements of the magnetic field produced by currents flowing beneath the Earth's surface. In addition, an external field model is provided to estimate the contribution of the solar-wind magnetic field to the near-Earth environment. Many spacecraft fly directional magnetometers to measure their local vector magnetic field (denoted as B by convention) which can, in combination with a suitable field model, be used for navigation or attitude control.

Another aspect of magnetic fields is the concept of “lines of force” or magnetic field-lines (such as the patterns produced in iron filings by a bar magnetic). The field-lines play an important role in understanding the physics of the near-Earth space environment because high-energy charged particles that populate near-Earth space spiral along these field-lines. In this context, scientists are often interested in knowing when two points – such as a ground magnetometer station and a satellite – are connected by the same field line, a condition known as magnetic conjugacy.

Adding a Satellite object to the scenario

Add a satellite to the scenario that exercises the Magnetic Field model in the desired manner and ensure the satellite transits a sun synchronous orbit at around 850 km altitude.

  1. Select Satellite () in the Insert STK Objects tool.
  2. Select From Standard Object Database () in the Select A Method: list.
  3. Click Insert... .
  4. Enter 29524 in the Name of ID: field in the Search Standard Object Data dialog box.
  5. Click Search.
  6. Select DMSP 5D-3 F17 D in the results list.
  7. Click Insert.
  8. Click Close after the satellite propagates to close the Search Standard Object Data dialog box.

Configuring the magnetic field model

Decide which field model(s) to use. The IGRF main-field with the Olson-Pfitzer external field gives the highest accuracy. Fast-IGRF is reasonably accurate alternative to the IGRF (within 1%) which offers some improvement in speed. The centered-dipole model is a good choice when computational speed is a high priority. Analysis under about 15000 km altitude generally does not require the external field model.

Choose the IGRF update rate. The harmonic coefficients of the IGRF main-field change slowly with time and are maintained in tables having nodal values added every five years typically. Between these nodes, the coefficients are linearly interpolated. The update rate determines how frequently the IGRF model coefficients are re-interpolated from the table. The default of one day should be fine for most circumstances, but increasing this value to up to 30 days for very long orbits can improve computational speed.

  1. Right click on DMSP_5D-3_F17_D_29524 () in the Object Browser.
  2. Select Properties ().
  3. Select the Basic - SEET Environment page.
  4. Since you are in a LEO orbit you will be considering a relatively short time period. You can just leave the default options.

Configuring and displaying the 3D Vector

You will define the display of geometric elements in the 3D Graphics window.

  1. Select the 3D Graphics - Vector page.
  2. Select the Vectors tab.
  3. Select the Nadir(Centric) Vector Show check box.
  4. Clear the Show Label check box.
  5. Select the Velocity Vector Show check box.
  6. Clear the Show Label check box.
  7. Click Apply to accept your changes and to keep the Properties Browser open.

Adding a vector to the list

The Vector Geometry Tool includes components that you can add to your list of vectors.

  1. Click the Add... .
  2. Select DMSP_5D-3_F17_D_29524 () in the Objects list in the Add Components dialog box.
  3. Select SEET_GeomagneticField () in the Components for: DMSP_5D-3_F17_D_29524 list.
  4. Click OK to close the Add Components dialog box.

Displaying the new vector

Display the vector you just added in the steps above.

  1. Return to 3D Graphics - Vector page.
  2. Ensure the Show check box is selected for the SEET_GeomagneticField.
  3. Double click on the Color icon.
  4. Open the shortcut menu.
  5. Select a color that's different from Nadir(Centric) Vector and Velocity Vector.
  6. Clear the Show Label check box.
  7. Select the Show Magnitude check box.
  8. Click OK.

Viewing the vectors in the 3D Graphics window

View your changes in the 3D Graphics window.

  1. Bring the 3D Graphics window to the front.
  2. Right click on DMSP_5D-3_F17_D_29524's () in the Object Browser.
  3. Select Zoom To.
  4. Click Decrease Time Step () in the Animation toolbar and set your Time Step: to 3.00 sec.
  5. Click Start () to animate your scenario.
  6. Click Reset () when finished to reset your scenario to the start time.
  7. DMSP_5D-3_F17_D_29524 and vectors

Creating a report of magnetic vector components

Choose your data provider and create a custom report using the Report & Graph Manager.

  1. Right click on DMSP_5D-3_F17_D_29524 () in the Object Browser.
  2. Select Report & Graph Manager... ().
  3. Select the My Styles () folder in the Styles frame in the Report & Graph Manager.
  4. Click Create new report style ().
  5. Type Magfield Vector to name your report.
  6. Press Enter on your keyboard to open the report's properties ().

Choosing a data provider

You will use the SEET Magnetic Field data provider. This data provider computes the geomagnetic field and various parameters associated with the geomagnetic field.

  1. Select the Content page in the Properties Browser ().
  2. Expand () SEET Magnetic Field in the data provider list.
  3. Move () the following elements to the Report Contents list.
    • Time ()
    • B Field - ECF x ()
    • B Field - ECF y ()
    • B Field - ECF z ()
  4. Click OK.
  5. Select the Magfield Vector () report in the My Styles () folder.
  6. Click Generate... .
  7. magfield vector report

  8. Close () the report when finished viewing the report.
  9. Close () the Report & Graph Manager.

Inserting Boston

  1. Insert a Place () object using the From City Database () method.
  2. Type Boston in the Name: field in the Search Standard Object Data dialog box.
  3. Click Search.
  4. Select Boston Massachusetts in the Results: list.
  5. Click Insert.
  6. Click Close to close the Search Standard Object Data dialog box when Boston () is added to the scenario.

Turning off Boston's Line of Sight constraint

You can turn off the Line of Sight constraint. The object will be able to create an access through the central body (e.g. the Earth).

  1. Open Boston's () properties ().
  2. Select the Constraints - Active page.
  3. Clear the Enable Line Of Sight check box.
  4. Click OK .

Setting DMSP_5D-3_F17_D_29524's constraints

Turning off the satellite's Ling of Sight constraint

First, turn off the Line of Sight constraint.

  1. Open DMSP_5D-3_F17_D_29524's () properties ().
  2. Select the Constraints - Active page.
  3. Clear the Enable Line Of Sight check box.

Adding the Magnetic Field Line Separation constraint

  1. Click Add new constraints () in the Active Constraints toolbar.
  2. Select Magnetic Field Line Separation in the Constraint Name list in the Select Constraints to Add dialog box.
  3. Click Add.
  4. Click Close to close the Select Constraints to Add dialog box.
  5. Enter 0 deg in the Min: field located in the Magnetic Field Line Separation frame in the Constraint Properties section.
  6. Select the Max: check box.
  7. Enter 10 deg in the Max: field
  8. Click Apply.

Setting STK SEET environment graphics

STK SEET can display magnetic-field contour lines for a Satellite () object. The contour lines are displayed as field line footprint locations on the ground in the 2D Graphics window and as field-line maps in the 3D Graphics window.

  1. Select the 2D Graphics - SEET Environment page.
  2. Select the Show 3D check box in the Magnetic Field Contour Line frame.
  3. Click OK.

Generating an access between DMSP_5D-3_F17_D_29524 and Boston

Create an access between DMSP_5D-3_F17_D_29524 () and Boston ().

  1. Right click on DMSP_5D-3_F17_D_29524 () in the Object Browser.
  2. Select Access... ().
  3. Select Boston () in the Associated Objects list.
  4. Click .
  5. Click Report & Graph Manager... .

Generating an Access Intervals by Constraint report

This reports the intervals satisfying each constraint in the constraint set computed for the access, in the order in which the constraints were applied. You turned off line of sight for both objects and applied Magnetic Field Line Separation for DMSP_5D-3_F17_D_29524 () . When the Magnetic Field Line Separation is small, this condition is known as magnetic conjugacy. The Access Intervals by Constraint () report tells you when this takes place in your scenario.

  1. Select the Access Intervals by Constraint () report in the Installed Styles () list when the Report & Graph Manager opens.
  2. Click Generate... .
  3. View the data in the report.
  4. Close () the report when finished.

Generating a geomagnetic conjugacy report

This report computes time intervals when DMSP_5D-3_F17_D_29524 () is magnetically conjugate with Boston ().

  1. Return to the Report & Graph Manager.
  2. Select Satellite for the Object Type.
  3. Select DMSP_5D-3_F17_D_29524 () in the Object list.
  4. Select the SEET Geomagnetic Conjugacy () report in the Installed Styles () list.
  5. Click Generate... .
  6. Select Boston () in the Available Objects list in the Magnetic Conjugacy for DMSP_5D-3_F17_D_29524 dialog box.
  7. Keep the Max Separation of 10 deg.
  8. Click OK to close Magnetic Conjugacy for DMSP_5D-3_F17_D_29524 dialog box and generate the report.
  9. View the data in the report.
  10. Keep the report open.

Viewing the separation angle in the 3D Graphics window

You can use the report to set your animation time in the scenario.

  1. Right click on the first time in the report.
  2. Select Time in the shortcut menu.
  3. Select Set Animation Time in the next shortcut menu.
  4. Bring the 3D Graphics window to the front.
  5. L-shell separation angle

  6. Click Start () to animate your scenario.
  7. Notice the dotted line (e.g. possibly red) near your orbit as you watch the animation.
  8. This is the L-shell value showing the minimum to maximum angle separation.

  9. Click Reset () when finished to reset your scenario.

Saving your work

  1. Close any open reports, properties and tools.
  2. Save () your work.

Summary

This was a quick introduction in using STK SEET. You inserted DMSP_5D-3_F17_D_29524 () and Boston () into your scenario. You configured DMSP_5D-3_F17_D_29524 () to use the IGRF magnetic field model. You turned off the line of site constraint for both DMSP_5D-3_F17_D_29524 () and Boston () so that they could access each other through the central body (e.g. the Earth). You applied a magnetic field line separation constraint on DMSP_5D-3_F17_D_29524 () . Finally, you created two reports, one showing when the intervals satisfying each constraint in the constraint set was computed for the access and the second computed time intervals when DMSP_5D-3_F17_D_29524 () was magnetically conjugate with Boston ().