Cloud Modeling with EOIR

STK Premium (Air), 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.

Required Capability Install: This lesson requires an additional capability installation for STK EOIR. The EOIR install is included in the STK Premium software download, but requires a separate install process. Read the Readme.htm found in the STK install folder for installation instructions. You can obtain the necessary install by visiting https://support.agi.com/downloads or calling AGI support.

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
  • Electro-Optical Infrared Sensor Performance (EOIR)

Problem statement

Determining when a system can detect, track, identify, and characterize targets of interest under operational conditions is critical to the success of a mission. Modeling and simulating these operations with a set of disparate tools can take far too long and is prone to mistakes. You need a single, multidomain analysis platform to accelerate your work.

Solution

STK's EOIR capability models the detection, tracking, and imaging performance of Electro-Optical Infrared (EOIR) sensors for Earth science, space situational awareness, and missile defense applications. Results support concept design, engineering, test, and operations.

With EOIR in STK 12 or newer, you can account for time-dynamic clouds—the natural enemy of all optical systems—in your mission. In this tutorial you will model a geosynchronous weather satellite and the cloud patterns it would see from orbit. You will also observe the results in the sensor data. Going forward, you can then account for potential targets becoming obscured.

Upon completion of this tutorial, you will be able to:

  1. Design a space-based observation system.
  2. Build on board visible and long wave infrared cameras.
  3. Analyze sensor scenes.

The sensor specifications in this lesson are notional.

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

Getting started

You'll begin by building a scenario and then inserting the objects for this mission:

  1. a ground site
  2. a GEO sat
  3. a tracking sensor

Once you've established these objects, you'll add a new level to your analysis with an EOIR sensor.

  1. Click the Create a Scenario () button.
  2. Enter the following in the New Scenario Wizard:
  3. Option Value
    Name EOIR_CloudPatterns
    Start Time Default Start Time
    Stop Time Default Stop Time
  4. Click OK .

Verifying that EOIR is installed

Ensure that EOIR is installed on your computer.

  1. If you do not see the EOIR toolbar (), extend the View menu.
  2. Select the Toolbars option.
  3. Select EOIR.

Disabling STK Terrain Server

In this analysis, you won't be utilizing streaming terrain imagery. The main asset is a space-based geosynchronous satellite. You can disable STK's Terrain Server.

  1. Open EOIR_CloudPatterns's () properties ().
  2. Browse to the Basic - Terrain page.
  3. Clear the Use terrain server for analysis check box.
  4. Click OK .

Inserting a Facility

When you build the space-based observation system, you can use a facility on the ground as a target to point the sensor. You do not need to set any specific parameters for the ground site.

  1. Insert a Facility () object using the Insert Default () method.
  2. Rename the facility to GroundSite.

Inserting a Satellite

Build the Earth Observation satellite.

  1. Insert a Satellite () object using the Orbit Wizard () method.
  2. Set the following options in the Orbit Wizard:
  3. Option Value
    Type Geosynchronous
    Satellite Name EarthObsSat
    Show All Objects On

    The Show All Objects helps you see where GroundSite is with respect to the satellite. Since the satellite is in GEO, as long as you are on the correct side of the hemisphere, you are able to see GroundSite.

  4. Set the Definition parameters:
  5. Option Value
    Subsatellite Point -75 deg
    Inclination 0 deg
  6. Click OK .

Inserting a sensor

You are creating a space-based Earth observation system. Take a moment to insert a sensor and place it on the EarthObsSat satellite.

  1. Insert a Sensor () object using the Define Properties () method.
  2. Select EarthObsSatellite.
  3. Click OK .

Defining the sensor properties

Be default, a sensor is mounted on a satellite pointed at the Earth. Using the targeted option, you can center the sensor's focus on GroundSite. That changes the angle of the sensor.

  1. Browse to the Basic - Pointing page.
  2. Set the Pointing Type to Targeted.
  3. Move () GroundSite to the Assigned Target list. This is the point of focus for the sensor.

Setting the EOIR settings

You defined the point behavior of the sensor. Next, you can address the Electro-Optical Infrared component of this mission.

EOIR settings - Spatial

Set the EOIR spatial parameters for the sensor.

  1. Select the Basic - Definition page.
  2. Set the Sensor Type to EOIR.
  3. Ensure the Spatial tab is selected and set the following options:
  4. Option Value
    Input Field-of-View and Number of Pixels
    Field of View - Horizontal Half Angle 5.0 deg
    Field of View - Vertical Half Angle 5.0 deg
    Number of Pixels - Horizontal 200.00
    Number of Pixels - Vertical 200.00
  5. Click Apply .

EOIR settings - spectral

The spectral band wavelengths are set in the Spectral tab. This study analyzes the visible waveband (0.4-0.7 um).

  1. Locate the Spectral Band Edge Wavelengths field.
  2. Set the Low to 0.400 um.
  3. Set the High to 0.700 um.
  4. Click Apply.

EOIR settings - Optical

You can set the Image Quality and the Optical Transmission on the Optical tab. You can set two of the optical inputs and EOIR automatically calculates the third.

  1. Select the Optical tab.
  2. Set the following options:
  3. Option Value
    Input F-Number and Entrance Pupil Diameter
    F/# 2.00
    Entrance Pupil Diameter 100 cm (considered commercially viable)
    Image Quality Negligible Aberrations
  4. Click Apply .

EOIR settings - radiometric

On the radiometric tab, you can set the values that define the radiant energy measurement properties. At a high level the sensitivity defines the noise floor of the sensor. After generating the sensor scene, you can revisit these parameters.

  1. Select the Radiometric tab.
  2. Set the Input to High Level.
  3. Click OK .
  4. Rename the sensor EOIR_Visible.

Set the target object

From the EOIR Target Configuration, you can select STK objects to use in the generated sensor scene. You can add Groundsite.

  1. Select EOIR_Visible () in the Object Browser.
  2. Click the EOIR Target Configuration () button on the EOIR toolbar.
  3. Move () the Facility/GroundSite to the Selected Target list. As a reminder, there are no thermal properties defined for the ground site.
  4. Click OK .
  5. Save () the scenario.

Generate a sensor scene

EOIR can create an image of what the system on the EarthObsSat sees. The current state is the Earth without any weather patterns, i.e., clouds.

  1. Select the EOIR_Visible () in the Object Browser.
  2. In the EOIR toolbar, click the EOIR Sensor Scene () button to generate an image that represents the sensor output.
  3. Give STK a moment to generate the scene.
  4. Right-click the sensor scene and select Details...
  5. Set the Scene Detail to Fine. This shows a higher resolution of the Globe.
  6. Click OK .
  7. Close the sensor scene.

Loading the current weather patterns

With STK 12, you can download the most recent cloud model for the scenario. If you are working offline, there are cloud models that you can load into the scenario. Before loading in the cloud model, first review the settings of this capability in the Clouds section of the EOIR Atmosphere Model STK Help page.

Using Connect commands for EOIR

Additional parameters can be set with Connect commands (for example, adding multiple cloud layers). Below are some examples of those commands.

EOIR */ SetAtmosphere Clouds On
EOIR */ CloudData DatasetTest1 0 1000
EOIR */ CloudData NewConstDataSet Test2
EOIR */ CloudData AddCldDataSets Test3 “…\CloudData.cld”

To set any of these commands via Connect, you can use the following:

EOIR */ CloudData SetValue DataLabel ParameterName Value

Valid values for ParameterName are listed on the EOIR CloudData STK Help page.

Setting the EOIR Atmosphere model

  1. Click the EOIR Target Configuration () button on the EOIR toolbar.
  2. Select the Atmosphere and Textures button.
  3. Left-click on the Clouds page.
  4. Select the Show check box for Clouds.
  5. Click Add Dataset.
  6. Enter SimpleClouds in the Dataset Label.
  7. Set the following options:
  8. Option Value
    Altitude 10 km
    Forward Scatter 50%
    Back Scatter 50%.
  9. Set the Coverage to File.
  10. Click Clouds Download.
  11. The downloaded clouds are in the C:\ProgramData\AGI\STK 12\STKData\VO\Clouds

    Optionally, you can load in the local cloud models by clicking on the ellipsis button and selecting a file from the STK install, typically at <STK Install Folder>\EOIR_Databases\Clouds.

  12. Keep the default Radiance or Emissivity/Temperature set to Constant Emissivity and Temperature default values.
  13. Click OK in the EOIR Atmosphere Model.
  14. Click OK in the EOIR Configuration window.

Using Globe Manager - Cloud Model

You loaded in the Cloud model for your EOIR sensor. You can also view the clouds in the 3D Graphics window.

  1. Open the Globe Manager (Globe Manager button).
  2. Right-click on Clouds.cld.
  3. Select the Change Clouds option.
  4. Select the Clouds.cld file.
  5. Click OK .
  6. Examine the clouds in the 3D Graphics window. This gives you an idea of what you will see in the EOIR sensor scene.

Generating a sensor scene

EOIR can create an image of what the system on the EarthObsSat sees. The current state is of the Earth with a cloud model loaded.

  1. Select the EOIR_Visible () in the Object Browser.
  2. In the EOIR toolbar, click the EOIR Sensor Scene () button to generate an image that represents the sensor output.
  3. Give STK a moment to generate the scene.
  4. Close the sensor scene.

Viewing Earth observations in the long-wavelength infrared band

The first EOIR sensor just looked at the visible part of the spectrum. Look at the long-wavelength infrared (8-15um). This is the thermal imaging region or thermal infrared region of the spectrum.

  1. Copy () EOIR_Visible () in the Object Browser.
  2. Paste () the sensor on EarthObsSat.
  3. Rename the sensor EOIR_LWIR.
  4. Open EOIR_LWIR's () properties (.
  5. Ensure the Spectral tab is selected.
  6. Set the following wavelength bounds:
  7. Option Value
    High 15.000 um
    Low 8.000 um

    Set the high value first to keep all values within the limits.

  8. Click OK .
  9. Save () the scenario.

Generating a sensor scene

Using the new sensor, generate a new sensor scene to see the differences in the model.

  1. Select the EOIR_LWIR () in the Object Browser.
  2. In the EOIR toolbar, click the EOIR Sensor Scene () icon to generate an image that represents the sensor output.
  3. Give STK a moment to generate the scene.
  4. Right-click on the sensor scene and select Details...
  5. Set the Scene Detail to Fine. This shows a higher resolution of the Globe.
  6. Set the Color Map to BGRY.
  7. Click Apply .

Viewing cloud inband radiance

  1. Click on a cloud in the sensor scene.
  2. In the Details panel, take a look at the Inband Radiance values, specifically the order of magnitude.
  3. The inband Radiance order of magnitude gives you insight as to how sensitive the sensor should be. You can adjust the radiometric settings to be of the same magnitude.

Defining the sensitivity

  1. Bring EOIR_LWIR's () properties () to the front.
  2. Select the Basic - Definition page.
  3. Select the Radiometric tab.
  4. Set the Units for Saturation and Sensitivity to Radiance.
  5. Enable the Simulate Saturation option.
  6. Set the Sensitivity - Equivalent Value to 0.00001 (1e-5). This value is found by varying the sensitivity until the sensor scene shows some noise in space, but otherwise a smoothed display.
  7. Set the Dynamic Range - Equivalent Value to 0.3. This value is found by varying the dynamic range.
  8. Click OK .
  9. Wait for the sensor scene to update.
  10. The data from the sensor scene can be exported from the Details panel in the Automatic File Output field. You can load this data into MATLAB or your preferred tool for post-processing.