You are on page 1of 28

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


Toms Guardabrazo

Authors

Approved Toms Guardabrazo
Released Paco Lpez 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

***FINISHEDINSTALLATIONOFCFIS&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.shv<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:
BIOMASSE2ESsuccessfullyinstalled.
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_base
line
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, 2
31
-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.410
38
] Scene size in azimuth
dimension

grg_sampling scalar FLOAT32 m [0, 3.410
38
] Ground range spacing
between samples within a
profile.
az_sampling scalar FLOAT32 m [0, 3.410
38
] 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_patt
ern_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, 2
31
-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, 2
31
-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.410
38
] Instrument PRF
SAR_midrange_inc_angle scalar FLOAT64 deg (-90, 90) Incidence angle at mid
range
SAR_swath_width scalar FLOAT64 m [0, 3.410
38
] Swath width
SAR_pulse_bw scalar FLOAT64 Hz [0, 3.410
38
] Pulse bandwidth
SAR_rgsampling_freq scalar FLOAT64 Hz [0, 3.410
38
] Range sampling fre-
quency
SAR_azdoppler_bw scalar FLOAT64 Hz [0, 3.410
38
] Processed doppler band-
width
OSS_az_window_alpha scalar FLOAT64 - [0, 3.410
38
] 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.410
38
] 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.410
38
] Ground range sampling of
phase and azimuth
screen in meters
seed scalar INT32 - [0, 2
31
-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.410
38
] TEC bias
TEC_sd scalar FLOAT32 TECU [0, 3.410
38
] Standard deviation of
TEC error probability dis-
tribution
TEC_rg_grad scalar FLOAT32 TECU/
m
[-3.410
38
,
3.410
38
]
TEC range gradient
TEC_az_grad scalar FLOAT32 TECU/
m
[-3.410
38
,
3.410
38
]
TEC azimuth gradient
TEC_rg_step scalar FLOAT32 TECU [-3.410
38
,
3.410
38
]
Jump of TEC step func-
tion in range (centered at
zero)
TEC_az_step scalar FLOAT32 TECU [-3.410
38
,
3.410
38
]
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, 2
63
-1] Number of pixels (azi-
muth, range) over which
to smooth FR estimates
prior to correction
AZ_window [2] INT64 - [1, 2
63
-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, 2
63
-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.410
38
] Azimuth sampling in me-
ters for L1b product
ground_range_s
ampling
scalar FLOAT m [0, 3.410
38
] Ground range sampling in
meters for L1b product
seed scalar INT32 - [0, 2
31
-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, 2
31
-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_fi
le
-
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,2510
3
] 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.

You might also like