biomass e2es sum v1.0

28
BIOMASS END-TO-END MISSION PERFORMANCE SIMULATOR Software User Manual Prepared for: European Space Agency (ESA) Prepared by: DEIMOS

Upload: pjjurado

Post on 20-Jul-2016

8 views

Category:

Documents


1 download

TRANSCRIPT

BIOMASS END-TO-END MISSION PERFORMANCE SIMULATOR

Software User Manual

Prepared for:

European Space Agency (ESA)

Prepared by:

DEIMOS

Page intentionally left blank

DOC INFO BIOMASS E2ES

BIOMASS End-to-End Mission Performance Simulator

Software User Manual

Tomás Guardabrazo

Authors

Approved Tomás Guardabrazo

Released Paco López Dekker

BIOMASS End-to-End Mission Performance Simulator

June 2011 BIOMASS_E2ES_SUM_1.0

i

DOC INFO BIOMASS E2ES

Document Change Control

Issue Rev. Date Chapter Changes Status

1 0 27/06/2011 All Initial issue delivered for CDR (SW Beta ve-sion).

Release

BIOMASS_E2ES_SUM_1.0 ii

BIOMASS End-to-End Mission Performance Simulator

June 2011

TOC Table of Contents BIOMASS E2ES

Table of Contents

BIOMASS END-TO-END ............................................................................ I 

MISSION PERFORMANCE SIMULATOR .................................................. I 

Software User Manual ........................................................................................................i 

Prepared for: .......................................................................................................................i 

European Space Agency (ESA).........................................................................................i 

Prepared by: ........................................................................................................................i 

1  REFERENCES.....................................................................................7 

1.1  Applicable Documents ..............................................................................................7 

1.2  Types and Units..........................................................................................................7 

2  INTRODUCTION................................................................................10 

2.1  Scope of this document ..........................................................................................10 

2.2  Software overview....................................................................................................10 

3  BIOMASS-E2ES INSTALLATION.....................................................13 

3.1  Preconditions ...........................................................................................................13 

3.2  Installation procedure..............................................................................................13 

3.3  COTS installation .....................................................................................................13 

3.4  SOFTWARE installation...........................................................................................14 

4  BIOMASS-E2ES OPERATION..........................................................15 

4.1  Quick start.................................................................................................................15 

4.2  Description of configuration parameters ..............................................................16 4.2.1  Orbit Setup and Geometry Module configuration file ..............................................16 

4.2.2  Scene Generator Module configuration file .............................................................18 

4.2.3  Observing System Simulator configuration file........................................................19 

4.2.4  Ionospheric Generation Module configuration file...................................................20 

4.2.5  Ionospheric Correction Module configuration file ....................................................22 

4.2.6  Product Generation Module configuration file .........................................................24 

4.2.7  L2 Retrieval Module configuration file .....................................................................25 

4.2.8  PE Module configuration file....................................................................................25 

BIOMASS End-to-End Mission Performance Simulator

June 2011 BIOMASS_E2ES_SUM_1.0

iii

TOC

Table of Contents BIOMASS E2ES

BIOMASS_E2ES_SUM_1.0 iv

BIOMASS End-to-End Mission Performance Simulator

June 2011

4.3  Montecarlo simulations .......................................................................................... 26 

Acronyms BIOMASS E2ES

List of Acronyms

AR Acceptance Review

CDR Critical Design Review

CCN Contract Change Notice

CDR Critical Design Review

CFI Customer Furnished Item

CM Configuration Management

CMP Configuration Management Plan

COTS Commercial Off-The-Shelf

CR Change Record

DB Data Base

DD Detailed Design

DDD Detailed Design Document

DDF Design Definition File

DDR Detailed Design Review

DJF Design Justification File

DDVP Design and Development Plan

DMS DEIMOS Space

ESA European Space Agency

ESTEC European Space Technology Centre

FP Final Presentation

FTP File Transfer Protocol

HMI Human Machine Interface

HW Hardware

IT Integration & Test

ICD Interface Control Document

ITT Invitation to Tender

KOM Kick-Off Meeting

N/A Not Applicable

NCR Non Conformance Report

OO Object Oriented

PDR Preliminary Design Review

QA Quality Assurance

RB Requirements Baseline

RID Review Item Discrepancy

BIOMASS End-to-End Mission Performance Simulator

June 2011 BIOMASS_E2ES_SUM_1.0

v

Acronyms BIOMASS E2ES

BIOMASS_E2ES_SUM_1.0 vi

BIOMASS End-to-End Mission Performance Simulator

June 2011

SDE Software Development Environment

SDP Software Development Plan

SoW Statement of Work

SPR Software Problem Report

SR Software Requirement

SRD Software Requirements Document

SRR System Requirements Review

SUM Software User Manual

SVP Software Verification Plan

SVV Software Verification and Validation

SW Software

TBC To Be Confirmed

TBD To Be Defined

TS Technical Specification

UML Unified Modeling Language

UR User Requirement(s)

WBS Work Breakdown Structure

WP Work Package

WPD Work Package Description

XML Extended Markup Language

XSD XML Schema Definition

1 References BIOMASS E2ES

1 References

1.1 Applicable Documents

[AD1] ESA/ESTEC “Statement of Work for the BIOMASS End-to-End Mission Performance Simula-tor”, EOP-SFP/2009-05-1390, Issue 1.0, 16/04/2010.

[AD2] BIOMASS End-to_end Mission Performance Simulator Requirements Baseline (RB), Issue 1, revision 0, EOP-SFP/2009-05-1392.

[AD3] ECSS-E_ST-40C March 2009, Space Engineering – Software, tailored according to ANNEX 1 in [AD1].

[AD4] OpenSF Interface Control Document – OpenSF-DMS-ICD-001-11

1.2 Types and Units

Types used in this document

Type Name Description Size

(bytes)

CHAR ASCII character encoded with UTF-8 1

INT8 Signed short integer included in [-32 768, 32 767] ([-215, 215-1])

2

UINT8 Unsigned short integer included in [0, 65 535] ([0, 216-1])

2

INT32 Signed long integer included in [−2 147 483 648, 20 147 483 647]

4

UINT32 Unsigned long integer included in [0, 4 294 967 295] 4

FLOAT32 Single-precision binary floating-point number (Expo-nents in the range −126 to +127 are representable)

4

FLOAT64 Double-precision binary floating-point number (Expo-nents in the range −1022 to +1023 are representable)

8

POINTER Address of a memory area 4 or 8 de-pending on the com-puter.

BOOLEAN Boolean TRUE (1) / FALSE (any value not equal to 1) 1

<type name>[n] 1-dimension array of n elements of type <type name>. Example : INT32[10] is a table of 10 signed long integer

n*size of <type name>

<type x-dimensions array of elements of type <type name> n*p*…*q

1 References BIOMASS E2ES

Size Type Name Description

(bytes)

name>[n],[p]…[q]

Example :FLOAT32[10][2] is a matrix of 10 rows, 2 col-umns of Single-precision binary floating-point number

size of <type name>

STRUCT Aggregation of several variables of different types (see after this table for the details) Example : STRUCT { INT32 variable1, CHAR[10] variable2, FLOAT64 variable3}

Variable

ENUM Finite list of predefined and ordered values coded with INT32 Example : ENUM {Red, Blue, Green) where Red corre-sponds to 1, Blue corresponds to 2 and Green corre-sponds to 3

4

When Type is STRUCT, the information is split into at least two tables. The main one (header in orange) includes the name of the structure. After it, a secondary table (header on gray color) con-tains the details of the structure. If further levels are needed, more tables are added (e.g., when a structure contains another structure). We include in the next example some arrows to guide the reader:

Variable Description Type / Size Units / scaling

Var1 This is var 1 FLOAT64 euros

Var2 This is var 2 FLOAT64[n] m

thisIsStruct A structure STRUCT[1] [keep empty]

ThisIsStruct2 Another structure STRUCT[3] [keep empty]

thisIsStruct [this field is empty because this structure

is described in the main table]

[empty] [empty]

NumPix Number of pixels FLOAT64 dimensionless

ID Counter across swath UNIT32 m

UT Time of observations STRING HH:MM:SS

ThisIsStruct2 [empty] [empty] [empty]

Field1 Lorem Ipsum Lorem Ipsum Lorem Ipsum

Field2 Lorem Ipsum Lorem Ipsum Lorem Ipsum

ThisIsSubStruct A short description about its contents Lorem Ipsum Lorem Ipsum

BIOMASS_E2ES_SUM_1.0

8

BIOMASS End-to-End Mission Performance Simulator

June 2011

1 References BIOMASS E2ES

ThisIsSubStruct [The field is not empty because this is a

structure inside another structure. There-

fore, a description must indicate to which

structure it belongs]

This struct is contained in the struct Thi-

sIsStruct2

[empty] [empty]

QI1 Lorem Ipsum Lorem Ipsum Lorem Ipsum

QI2 Lorem Ipsum Lorem Ipsum Lorem Ipsum

Table 1.1: Convention for units

Unit symbol Name

dl dimensionless for numerical quantities

N/A for STRING, CHAR, BOOLEAN and STRUCT types

EU or W.m-2 .m-1 spectral irradiance

LU or W.m-2.sr-1 .m-1 spectral radiance

jd julian day

e - (photo-)electrons

m metre

s seconds

% percentage

K degree Kelvin (temperature)

° or deg degree (angle)

rad radian

sr steradian

2 Introduction BIOMASS E2ES

2 Introduction

2.1 Scope of this document

This document is the BIOMASS-E2ES software installation and user manual. Some of the contents as the configuration parameters description are extracted from the ICD.

2.2 Software overview

The BIOMASS-E2ES SW system is composed of several modules, some of them developed in the frame of different contracts (EMs or External Modules).

The BIOMASS-E2ES Statement of Work (SoW) describes the following list of modules:

Geometry Module (developed in the frame of this contract by DMS)

Scene Generator (EM)

Ionospheric Module (EM)

Observing System Simulator A (EM)

Observing System Simulator B (EM)

Product Generation Module (developed in the frame of this contract by DLR)

L2 Retrieval Module (EM)

Performance Evaluation Modules (PEM) (developed in the frame of this contract by DLR)

The following picture is taken from the SADD and illustrates the modules interconnection. openSF is the SW GUI used to manage the software execution, logging, etc...

BEES system architecture departs slightly from the baseline architecture proposed in the SoW, since several modules have required a split to accommodate the system data flow needs. The mapping be-tween the SoW modules and the BEES modules is given in Table 1.1.

Figure 2.2 shows the simulator data flow as described in the SADD/ICD.

BIOMASS_E2ES_SUM_1.0

10

BIOMASS End-to-End Mission Performance Simulator

June 2011

2 Introduction BIOMASS E2ES

Figure 2.1 Block diagram of BEES

SoW Module BEES Modules Comment

OSM Feeds the RPG with orbit height and others GM

GM Generates the geometry data

SGM SGM -

IGM Generates the ionosphere effects IM

ICM Applies the ionospheric corrections

OSS-RPG Radar parameter generator to provide the GM with some required inputs

OSS-IRF Generates the Impulse Response Function

OSS

OSS-SES Generates the Sensitivity and Errors

PGM PGM-L1a Generates the iono-free output

2 Introduction BIOMASS E2ES

SoW Module BEES Modules Comment

PGM-L1b Reads the iono-corrected output

L2RM L2RM -

- PEM-L1b Performance evaluation module for L1b product

- PEM-L2 Performance evaluation module for L2 product

Table 2.1 Mapping between BEES modules and SoW modules

Figure 2.2 BIOMASS E2ES data flow.

BIOMASS_E2ES_SUM_1.0

12

BIOMASS End-to-End Mission Performance Simulator

June 2011

3 BIOMASS-E2ES Installation BIOMASS E2ES

3 BIOMASS-E2ES Installation

3.1 Preconditions

The software installation section below assumes that the target platform has these components al-ready installed and accessible to non-root users:

mySQL

openSF

gcc33

IDL 8.0 or 8.1

3.2 Installation procedure

The BIOMASS-E2ES package is composed of two folders:

COTS. This includes all COTS required to run the BIOMASS-E2ES (EO-CFI, netcdf libraries, Matlab Compiler Runtimes, etc)

SOFTWARE. This includes all modules composing the software, external and internal, plus all the operational and testing harness (openSF sessions, installation scripts, integration tests, etc...)

Each folder has a dedicated installation script that shall be invoked as explained in following sections. The BIOMASS-E2ES installation shall be performed in a fixed order: first COTS and then SOFT-WARE.

3.3 COTS installation

To install the BIOMASS-E2ES COTS proceed as follows:

1. Login as root and move the mount point of the delivery media. If this media is an USB stick it should be auto-mounted, a file browser window should emerge. Just take note of the path and close this window.

2. Open a terminal (right click on desktop and select Open in Terminal). Now move to the media mounting point mentioned in the previous step.

3. Move to the COTS folder and type the following command:

>> ./install_COTS.sh ./ 

This launches the COTS installer, that will compile and put all binaries and libraries in a specific folder (/usr/local/biomass_e2es/cots). If everything goes OK you should see this message at the end of the log:

3 BIOMASS-E2ES Installation BIOMASS E2ES

*** FINISHED INSTALLATION OF CFIS & COTS *** 

In case of failure, the script indicates in the last line in red font which COTS has originated the problem. You should not worry if some red messages appear, they are just warnings.

The full COTS installation log is anyway stored in /tmp/install_COTS.log for inspection.

3.4 SOFTWARE installation

The software installation shall be done as the following user:

user:             bees password:    biomass_e2es 

To install the software the user shall go through the following steps:

1. Logout as root and login as bees

2. Open a terminal (right click on desktop and select Open terminal) and move to the media mounting point mentioned in the previous section.

3. Move the SOFTWARE folder and type the following command:

>> . install_BEES.sh ‐v <version> ‐s ./bees.tar.gz [‐f] [‐d] 

where <version> is the version name you want to give the installed software (for instance "vBeta_CDR"). The command line flags have the following meaning:

-v specifies the version name you want to choose for the installed software

-s specifies the name and path of the SW installation package

-f specifies that you want to overwrite an existing installation with name <version>

-d specified that you want to overwrite the existing bees openSF database

WARNING: The first time you install the software you shall include the -d flag, otherwise the bees database will not be created!

WARNING: However, if you use this flag and a previous installation of the software exists, you will remove all user-defined openSF sessions!

Now the installed extracts the data from the package, compiles the GM and installs all modules (including external ones) in a specific location:

/usr/local/biomass_e2es/<version> 

If the SW installation finishes successfully you will see this message in the last line of the log:

BIOMASS E2ES successfully installed. 

The full SW installation log is saved as /tmp/install_BEES.log for further inspection.

BIOMASS_E2ES_SUM_1.0

14

BIOMASS End-to-End Mission Performance Simulator

June 2011

4 BIOMASS-E2ES Operation BIOMASS E2ES

4 BIOMASS-E2ES Operation

4.1 Quick start

The BIOMASS-E2ES SW operation shall be done as the user bees (see default password in the pre-vious section). To open the GUI (openSF):

1. Login as bees

2. Type the following command:

>> runBEES.sh 

3. For a quick start you can expand the Sessions tree in the left window and right click on any of the predefined sessions (e.g. BIOMASS-E2E-CDR-OSS-A) and select Run.

Predefined sessions are end-to-end chains using different OSSs and accounting account for default sessions, integrations tests, etc... The following preconfigured chains are provided by default:

Sample chains

BIOMASS-E2ES-CDR-OSS-A

BIOMASS-E2ES-CDR-OSS-B

Integration test chains

BIOMASS-IT-010

BIOMASS-IT-020

BIOMASS-IT-030

BIOMASS-IT-040

Time performance chains

BM-TIME-PERF-OSS-A

BM-TIME-PERF-OSS-B

The following screenshot shows the Sessions tree structure as preconfigured in installation:

4 BIOMASS-E2ES Operation BIOMASS E2ES

4. The GUI operations are described in the openSF manual. For instance, the GUI allows inspect-ing and editing the configuration parameters. To open the configuration editor double click (left button) on the selected session and go to the Configuration tab.

4.2 Description of configuration parameters

4.2.1 Orbit Setup and Geometry Module configuration file

The Orbit Setup and Geometry Module configuration file is defined by the following fields:

BIOMASS_E2ES_SUM_1.0

16

BIOMASS End-to-End Mission Performance Simulator

June 2011

4 BIOMASS-E2ES Operation BIOMASS E2ES

Parameter Dimension Type Units Range Description

repeat_cycle scalar INT16 days [1, 32767] Exact Repeat Cycle of the sun-synchronous orbit

cycle_length scalar INT16 orbits [1, 32767] Number of orbits per cy-cle

mlst_of_anx scalar FLOAT32 decimal hours

[0, 24) Mean Local Solar Time of Ascending Node

scene_center_lon scalar FLOAT32 degrees [-180, 180) Longitude of the scene center from -180 to +180 degrees

scene_center_lat scalar FLOAT32 degrees [-90, 90) Geodetic latitude of the scene center from -90 to +90 degrees

perc_critical_baseline

scalar FLOAT32 % [0, 100] Percentage of the critical interferometric baseline at the scene center latitude

num_acquisitions scalar INT16 - [1, 32767] Number of acquisitions (e.g. 2 for master/slave)

seed scalar INT32 - [0, 231-1] Seed to initialize the ran-dom number generation.

A zero value means self-initialization (if supported by the module)

scene_az_size scalar FLOAT32 m [0, 3.4•1038] Scene size in azimuth dimension

grg_sampling scalar FLOAT32 m [0, 3.4•1038] Ground range spacing between samples within a profile.

az_sampling scalar FLOAT32 m [0, 3.4•1038] Azimuth spacing between GM output profiles.

A value of 0 indicates that only one profile is gener-ated, corresponding to an azimuth invariant geome-try.

DEM_type scalar STRING - - Switch to choose DEM

4 BIOMASS-E2ES Operation BIOMASS E2ES

Parameter Dimension Type Units Range Description

type:

- "DISABLED" to ignore it

- "RANGE" to consider a 1-D DEM (azimuth invari-ant range profile)

- "COMPLETE" to con-sider a 2-D DEM (in range and azimuth)

DEM_folder scalar STRING - - Path to the DEM folder.

4.2.2 Scene Generator Module configuration file

The Scene Generator Module configuration file is defined by the following fields:

Parameter Dimension Type Units Range Description

scene_type scalar ENUM (INT8)

- [0, Ntypes-1] Scene type (biome type)

mean_biomass scalar FLOAT32 ? ? Average biomass level for the scene

biomass_gradient [2] FLOAT32 ? ? 2-D gradient of biomass (partial derivative with respect to ground range and azimuth)

use_opt_biomass_pattern

scalar BOOL - - Switch to use external optional biomass pattern

opt_biomass_pattern_file

- FILE - - Path to optional biomass pattern file.

tempo-ral_decorre-ation_scenario

- FILE - - High (1), medium (2) or low (3) temporal decorre-lation

seed scalar INT32 - [0, 231-1] Seed to initialize the ran-dom number generation.

A zero value means self-initialization (if supported by the module)

BIOMASS_E2ES_SUM_1.0

18

BIOMASS End-to-End Mission Performance Simulator

June 2011

4 BIOMASS-E2ES Operation BIOMASS E2ES

4.2.3 Observing System Simulator configuration file

The following table describes the configuration parameters this file shall contain:

Parameter Dimension Type Units Range Description

Regular

OSS_execution_mode - STRING - - Execution mode for OSS:

- "MANUAL" to read ad-vanced parameters from configuration

- "PREDEFINED" to read advanced parameters from the acquisition file

- "AUTO" to let RPG op-timizing the SAR parame-ters from GM outputs

OSS_definition_file - FILE - - Path to acquisition defini-tion file (containing all instrument parameters)

seed scalar INT32 - [0, 231-1] Seed to initialize the ran-dom number generation.

A zero value means self-initialization (if supported by the module)

Advanced

SAR_PRF scalar FLOAT64 Hz [0, 3.4•1038] Instrument PRF

SAR_midrange_inc_angle scalar FLOAT64 deg (-90, 90) Incidence angle at mid range

SAR_swath_width scalar FLOAT64 m [0, 3.4•1038] Swath width

SAR_pulse_bw scalar FLOAT64 Hz [0, 3.4•1038] Pulse bandwidth

SAR_rgsampling_freq scalar FLOAT64 Hz [0, 3.4•1038] Range sampling fre-quency

SAR_azdoppler_bw scalar FLOAT64 Hz [0, 3.4•1038] Processed doppler band-width

OSS_az_window_alpha scalar FLOAT64 - [0, 3.4•1038] Alpha parameter of the raised cosine window for

4 BIOMASS-E2ES Operation BIOMASS E2ES

Parameter Dimension Type Units Range Description

azimuth

OSS_ rg_window_alpha scalar FLOAT64 - [0, 3.4•1038] Alpha parameter of the raised cosine window for range

OSS_num_azimuth_ambig scalar INT16 - [0, 32767] Number of ambiguities in azimuth

OSS_num_range_ambig scalar INT16 - [0, 32767] Number of ambiguities in range

IRF_dimensions [2] INT16 - [0, 32767] Dimensions of the IRF in range and azimuth re-spectively

IRF_num_samples scalar INT16 - [0, 32767] Number of IRFs com-puted within the swath

IRF_oversamp_factor scalar INT16 - [0, 32767] IRF oversampling factor, applied both in range and azimuth

SES_num_samples scalar INT16 - [0, 32767] Number of SES across-range samples

4.2.4 Ionospheric Generation Module configuration file

The following table describes the configuration parameters this file shall contain:

Parameter Dimension Type Units Range Description

CkL_percentile scalar FLOAT32 % [0,100] CkL percentile

Kp scalar INT8 - {1,3,7} Kp

screen_samp scalar FLOAT32 m [0, 3.4•1038] Ground range sampling of phase and azimuth screen in meters

seed scalar INT32 - [0, 231 -1] Seed to initialize the ran-dom number generation.

A zero value means self-initialization (if supported by the module)

PS_method - STRING - - Switch to select the phase

BIOMASS_E2ES_SUM_1.0

20

BIOMASS End-to-End Mission Performance Simulator

June 2011

4 BIOMASS-E2ES Operation BIOMASS E2ES

Parameter Dimension Type Units Range Description

screen generation method:

"1D"

"2D"

"TEConly"

"Residual" (TBC)

TEC_model - STRING - - Switch to select the TEC computation model:

"IRI"

"IONEX"

"ZERO"

Rz12 scalar INT64 - [-1,300] 12-month smoothed Zu-rich sunspot number (re-quired only for "IRI" TEC model)

For negative values, the model will retrieve a his-torical Rz12 from IRI LUT

TEC_bias scalar FLOAT32 TECU [0, 3.4•1038] TEC bias

TEC_sd scalar FLOAT32 TECU [0, 3.4•1038] Standard deviation of TEC error probability dis-tribution

TEC_rg_grad scalar FLOAT32 TECU/m

[-3.4•1038, 3.4•1038]

TEC range gradient

TEC_az_grad scalar FLOAT32 TECU/m

[-3.4•1038, 3.4•1038]

TEC azimuth gradient

TEC_rg_step scalar FLOAT32 TECU [-3.4•1038, 3.4•1038]

Jump of TEC step func-tion in range (centered at zero)

TEC_az_step scalar FLOAT32 TECU [-3.4•1038, 3.4•1038]

Jump of TEC step func-tion in azimuth (centered at zero)

TEC_map_folder - FILE - - Path to the folder contain-ing IONEX files (required

4 BIOMASS-E2ES Operation BIOMASS E2ES

Parameter Dimension Type Units Range Description

only for "IONEX" TEC model)

MAG_field_file - FILE - - Path to the magnetic field file

SCINT_db_folder - FILE - - Path to the folder contain-ing the scintillation pa-rameters database

IRI_data_folder - FILE - - Path to the folder contain-ing IRI coefficients

4.2.5 Ionospheric Correction Module configuration file

The following table describes the configuration parameters this file shall contain:

Parameter Dimension Type Units Range Description

FR_window [2] INT64 - [1, 263 -1] Number of pixels (azi-muth, range) over which to smooth FR estimates prior to correction

AZ_window [2] INT64 - [1, 263 -1] Number of pixels (azi-muth, range) over which to smooth azimuth correc-tion estimates prior to cor-rection

AZ_method - STRING - - Azimuth correction method:

"Papathanassiou_Kim"

"None"

FR_method - STRING - - Faraday rotation estima-tion and correction method:

"Bickel_Bates"

"Freeman1"

"Freeman2"

"Chen_Quegan"

BIOMASS_E2ES_SUM_1.0

22

BIOMASS End-to-End Mission Performance Simulator

June 2011

4 BIOMASS-E2ES Operation BIOMASS E2ES

Parameter Dimension Type Units Range Description

"Qi_Jin"

"None"

AF_method - STRING - - Autofocus method:

"PGA"

"MAM"

"None"

TEC_model - STRING - - Switch to select the TEC computation model:

"IRI"

"IONEX"

"ZERO"

Rz12 scalar INT64 - [1, 263 -1] 12-month smoothed Zu-rich sunspot number (re-quired only for "IRI" TEC model)

TEC_map_folder - FILE - - Path to the folder contain-ing IONEX files (required only for "IONEX" tec model)

MAG_field_file - FILE - - Path to the magnetic field file

sw_output_errors - BOOL - [FALSE, TRUE]

Switch to enable the op-tional generation of the following output variables:

- ph_error_screen

- fr_error_screen

- az_error_screen

IRI_data_folder - FILE - - Path to the folder contain-ing IRI coefficients

4 BIOMASS-E2ES Operation BIOMASS E2ES

4.2.6 Product Generation Module configuration file

The following table describes the configuration parameters this file shall contain:

Parameter Dimension Type Units Range Description

sw_iono_scint scalar BOOL - [FALSE, TRUE]

Switch to include the ionospheric scintillation

sw_iono_frot scalar BOOL - [FALSE, TRUE]

Switch to include the ionospheric faraday rota-tion

sw_amb_model scalar ENUM - [0,1 2] Switch to select ambiguity processing:

1 - Ignore ambiguities

2 - Simulate ambiguities using ambiguous IRF and mapping

3 - Model ambiguities us-ing AASR and RASR lev-els

sw_noise scalar BOOL - [FALSE, TRUE]

Switch to include noise

sw_rad_bias scalar BOOL - [FALSE, TRUE]

Switch to include a ra-diometric bias

sw_phase_stab [3] BOOL - [FALSE, TRUE]

Switches to include phase stability between chan-nels, between acquisi-tions, and within an image

sw_ampl_stab [3] BOOL - [FALSE, TRUE]

Switches to include phase stability between chan-nels, between acquisi-tions, and within an image

sw_ch_imbal scalar BOOL - [FALSE, TRUE]

Switch to include channel imbalance

sw_ch_xtalk scalar BOOL - [FALSE, TRUE]

Switch to include channel cross talk

sw_bypass_ICM scalar BOOL - [FALSE, TRUE]

Switch to enable the ICM bypassing. If TRUE, the PGM-L1b input shall be read from the PGM-L1a output instead of ICM out-

BIOMASS_E2ES_SUM_1.0

24

BIOMASS End-to-End Mission Performance Simulator

June 2011

4 BIOMASS-E2ES Operation BIOMASS E2ES

Parameter Dimension Type Units Range Description

put.

azi-muth_sampling

scalar FLOAT m [0, 3.4•1038] Azimuth sampling in me-ters for L1b product

ground_range_sampling

scalar FLOAT m [0, 3.4•1038] Ground range sampling in meters for L1b product

seed scalar INT32 - [0, 231 -1] Seed to initialize the ran-dom number generation.

A zero value means self-initialization (if supported by the module)

4.2.7 L2 Retrieval Module configuration file

The following table describes the configuration parameters this file shall contain:

Parameter Dimen-

sion Type

Units Range Description

block_size

2

INT32 - [0, 231-1] Defines the block of range azimuth samples (each sample is a covariance matrix) used in the L2 retrieval algorithm.

model_defs_file - FILE - - Path to model-definitions database

bi-ome_to_model_map_file

- FILE - - Path to biome-to-model

map file

4.2.8 PE Module configuration file

The following table describes the configuration parameters this file shall contain:

Parameter Dimension Type Units Range Description

L1b_eval - BOOL - [FALSE, TRUE]

Switch to enable L1b per-formance evaluation

L2_eval - BOOL - [FALSE, Switch to enable L2 per-

4 BIOMASS-E2ES Operation BIOMASS E2ES

BIOMASS_E2ES_SUM_1.0

26

BIOMASS End-to-End Mission Performance Simulator

June 2011

Parameter Dimension Type Units Range Description

TRUE] formance evaluation

matrix_norm - STRING - [Frobenius, Spectral]

Matrix norm to use for L1b errors.

confidence_interval - FLOAT32 - [0,100] Confidence interval for L2 errors.

range_bin_size FLOAT32 “m” [100,25•103] Range bin size for range profiles

biomass_bin_size FLOAT32 “T/ha” [1,100] Biomass bin size for bio-mass profiles

4.3 Montecarlo simulations

To perform Montecarlo simulations, the BIOMASS-E2ES software relies on the parameter iteration functionality provided by openSF.

To access this feature, double click on a session and go to the Parameters tab. Click on the desired parameter and press the "Iterate parameters". A new window emerges with the current value of the parameter. If the user double clicks on this value, the range-setting window appears to set the iteration range.

Once the iteration range is set, return to the session edition window and press Run. The batch of simulations will begin, each one generating a different output folder.