i2_features_map

Landsat5_old

Name	Default Value	Description	Type	Mandatory	Name
additional_features		OTB’s bandmath expressions, separated by comma	str	False	additional_features
end_date		The end date of interpolated image time series	str	False	end_date
keep_bands	[‘B1’, ‘B2’, ‘B3’, ‘B4’, ‘B5’, ‘B6’]	The list of spectral bands used for classification	list	False	keep_bands
start_date		The first date of interpolated image time series	str	False	start_date
temporal_resolution	16	The temporal gap between two interpolation	int	False	temporal_resolution

Landsat8

Name	Default Value	Description	Type	Mandatory	Name
additional_features		OTB’s bandmath expressions, separated by comma	str	False	additional_features
end_date		The end date of interpolated image time series	str	False	end_date
keep_bands	[‘B1’, ‘B2’, ‘B3’, ‘B4’, ‘B5’, ‘B6’, ‘B7’]	The list of spectral bands used for classification	list	False	keep_bands
start_date		The first date of interpolated image time series	str	False	start_date
temporal_resolution	16	The temporal gap between two interpolation	int	False	temporal_resolution
write_reproject_resampled_input_dates_stack	True	Enable the write of resampled stack image for each date	bool	False	write_reproject_resampled_input_dates_stack

Landsat8_old

Name	Default Value	Description	Type	Mandatory	Name
additional_features		OTB’s bandmath expressions, separated by comma	str	False	additional_features
end_date		The end date of interpolated image time series	str	False	end_date
keep_bands	[‘B1’, ‘B2’, ‘B3’, ‘B4’, ‘B5’, ‘B6’]	The list of spectral bands used for classification	list	False	keep_bands
start_date		The first date of interpolated image time series	str	False	start_date
temporal_resolution	16	The temporal gap between two interpolation	int	False	temporal_resolution
write_reproject_resampled_input_dates_stack	True	Enable the write of resampled stack image for each date	bool	False	write_reproject_resampled_input_dates_stack

Sentinel_2

Name	Default Value	Description	Type	Mandatory	Name
additional_features		OTB’s bandmath expressions, separated by comma	str	False	additional_features
end_date		The end date of interpolated image time series	str	False	end_date
keep_bands	[‘B2’, ‘B3’, ‘B4’, ‘B5’, ‘B6’, ‘B7’, ‘B8’, ‘B8A’, ‘B11’, ‘B12’]	The list of spectral bands used for classification	list	False	keep_bands
start_date		The first date of interpolated image time series	str	False	start_date
temporal_resolution	10	The temporal gap between two interpolation	int	False	temporal_resolution
write_reproject_resampled_input_dates_stack	True	Enable the write of resampled stack image for each date	bool	False	write_reproject_resampled_input_dates_stack

Sentinel_2_L3A

Name	Default Value	Description	Type	Mandatory	Name
additional_features		OTB’s bandmath expressions, separated by comma	str	False	additional_features
end_date		The end date of interpolated image time series	str	False	end_date
keep_bands	[‘B2’, ‘B3’, ‘B4’, ‘B5’, ‘B6’, ‘B7’, ‘B8’, ‘B8A’, ‘B11’, ‘B12’]	The list of spectral bands used for classification	list	False	keep_bands
start_date		The first date of interpolated image time series	str	False	start_date
temporal_resolution	16	The temporal gap between two interpolation	int	False	temporal_resolution
write_reproject_resampled_input_dates_stack	True	Enable the write of resampled stack image for each date	bool	False	write_reproject_resampled_input_dates_stack

Sentinel_2_S2C

Name	Default Value	Description	Type	Mandatory	Name
additional_features		OTB’s bandmath expressions, separated by comma	str	False	additional_features
end_date		The end date of interpolated image time series	str	False	end_date
keep_bands	[‘B02’, ‘B03’, ‘B04’, ‘B05’, ‘B06’, ‘B07’, ‘B08’, ‘B8A’, ‘B11’, ‘B12’]	The list of spectral bands used for classification	list	False	keep_bands
start_date		The first date of interpolated image time series	str	False	start_date
temporal_resolution	10	The temporal gap between two interpolation	int	False	temporal_resolution
write_reproject_resampled_input_dates_stack	True	Enable the write of resampled stack image for each date	bool	False	write_reproject_resampled_input_dates_stack

arg_train

Name	Default Value	Description	Type	Mandatory	Name
features	[‘NDVI’, ‘NDWI’, ‘Brightness’]	List of additional features computed	list	False	features

Notes

features

This parameter enable the computation of the three indices if available for the sensor used.There is no choice for using only one of them.

builders

Name	Default Value	Description	Type	Mandatory	Name
builders_class_name	[‘i2_classification’]	The name of the class defining the builder	list	False	builders_class_name
builders_paths	/path/to/iota2/sources	The path to user builders	list	False	builders_paths

Notes

builders_class_name

Available builders are : ‘i2_classification’, ‘i2_features_map’, ‘i2_obia’ and ‘i2_vectorization’

builders_paths

If not indicated, the iota2 source directory is used: */iota2/sequence_builders/

chain

Name	Default Value	Description	Type	Mandatory	Name
cloud_threshold	0	Threshold to consider that a pixel is valid	int	False	cloud_threshold
first_step	None	The step group name indicating where the chain start	str	True	first_step
l5_path_old	None	Absolute path to Landsat-5 images coming from old THEIA format (D*H*)	str	False	l5_path_old
l8_path	None	Absolute path to Landsat-8 images comingfrom new tiled THEIA data	str	False	l8_path
l8_path_old	None	Absolute path to Landsat-8 images coming from old THEIA format (D*H*)	str	False	l8_path_old
last_step	None	The step group name indicating where the chain ends	str	True	last_step
list_tile	None	List of tile to process, separated by space	str	True	list_tile
logger_level	INFO	Set the logger level: NOTSET, DEBUG, INFO, WARNING, ERROR, CRITICAL	str	False	logger_level
output_path	None	Absolute path to the output directory.	str	True	output_path
proj	EPSG:2154	The projection wanted. Format EPSG:XXXX is mandatory	str	False	proj
remove_output_path	True	Enable the removing of complete output_path directory	bool	False	remove_output_path
s1_path	None	Absolute path to Sentinel-1 configuration file	str	False	s1_path
s2_l3a_output_path	None	Absolute path to store preprocessed data in a dedicated directory.	str	False	s2_l3a_output_path
s2_l3a_path	None	Absolute path to Sentinel-2 L3A images (THEIA format)	str	False	s2_l3a_path
s2_output_path	None	Absolute path to store preprocessed data in a dedicated directory.	str	False	s2_output_path
s2_path	None	Absolute path to Sentinel-2 images (THEIA format)	str	False	s2_path
s2_s2c_output_path	None	Absolute path to store preprocessed data in a dedicated directory.	str	False	s2_s2c_output_path
s2_s2c_path	None	Absolute path to Sentinel-2 images (Sen2Cor format)	str	False	s2_s2c_path
user_feat_path	None	Absolute path to the user’s features path	str	False	user_feat_path

Notes

cloud_threshold

Indicates the threshold for a polygon to be used for learning. It use the validity count, which is incremented if a cloud, a cloud shadow or a saturated pixel is detected

output_path

Absolute path to the output directory.It is recommended to have one directory per run of the chain

remove_output_path

Enable the removing of complete output_path directory Only if the first_step is init and the folder name is valid

user_feat_path

Absolute path to the user’s features path They must be stored by tiles

external_features

Name	Default Value	Description	Type	Mandatory	Name
concat_mode	True	Enable the use of all features	bool	False	concat_mode
exogeneous_data	None	Path to a Geotiff file containing additional data to be used in external features.	str	False	exogeneous_data
external_features_flag	False	Enable the external features mode	bool	False	external_features_flag
functions	None	The function list to be used to compute features.Can be a string of space-separated function namesCan be a list of either strings of function nameor lists of one function name and one argument mapping	list	False	functions
module	/path/to/iota2/sources	Absolute path for user source code	str	False	module
no_data_value	-10000	value considered as no_data in features map mosaic (i2_features_map builder name)	int	False	no_data_value
output_name	None	Temporary chunks are written using this name as prefix	str	False	output_name

Notes

concat_mode

If disabled, only external features are used in the whole processing

exogeneous_data

If the =exogeneous_data= contains ‘$TILE’, it will be replaced by the tile name being processed.If you want to reproject your data on given tiles, you can use the =split_raster_into_tiles.py= command line tool.

Usage: =split_raster_into_tiles.py –help=.

python_data_managing

Name	Default Value	Description	Type	Mandatory	Name
chunk_size_mode	split_number	The chunk split mode, choices are ‘split_number’ or ‘user_fixed’	str	False	chunk_size_mode
chunk_size_x	50	The number if rows for chunk	int	False	chunk_size_x
chunk_size_y	50	The number if rows for chunk	int	False	chunk_size_y
data_mode_access	gapfilled	Choose which data can be accessed in custom features	str	False	data_mode_access
fill_missing_dates	False	Fill raw data with no data if dates are missing	bool	False	fill_missing_dates
number_of_chunks	50	The expected number of chunks	int	False	number_of_chunks
padding_size_x	0	The padding for chunk	int	False	padding_size_x
padding_size_y	0	The padding for chunk	int	False	padding_size_y

Notes

data_mode_access

Three values are allowed: - gapfilled: give access only the gapfilled data - raw: gives access only the original raw data - both: provides access to both data ..Notes:: Data are spatialy resampled, these parameters concern only temporal interpolation

fill_missing_dates

If raw data access is enabled, this option considers all unique dates for all tiles and identify which dates are missing for each tile. A missing date is filled using a no data constant value.Cloud or saturation are not corrected, but masks are provided Masks contain three value: 0 for valid data, 1 for cloudy or saturated pixels, 2 for a missing date

sensors_data_interpolation

Name	Default Value	Description	Type	Mandatory	Name
auto_date	True	Enable the use of start_date and end_date	bool	False	auto_date
use_additional_features	False	Enable the use of additional features	bool	False	use_additional_features
use_gapfilling	True	Enable the use of gapfilling	bool	False	use_gapfilling
write_outputs	False	Write temporary files	bool	False	write_outputs

Notes

auto_date

If True, iota2 will automatically guess the first and the last interpolation date. Else, start_date and end_date of each sensors will be used

write_outputs

Write the time series before and after gapfilling, the mask time series, and also the feature time series. This option required a large amount of free disk space.

task_retry_limits

Name	Default Value	Description	Type	Mandatory	Name
allowed_retry	0	Allow dask to retry a failed job N times.	int	False	allowed_retry
maximum_cpu	4	The maximum number of CPU available	int	False	maximum_cpu
maximum_ram	16	The maximum amount of RAM available. (gB)	int	False	maximum_ram

Notes

maximum_cpu

the amount of cpu will be doubled if the task is killed due to ram overconsumption until maximum_cpu or allowed_retry are reach

maximum_ram

the amount of RAM will be doubled if the task is killed due to ram overconsumption until maximum_ram or allowed_retry are reach

userFeat

Name	Default Value	Description	Type	Mandatory	Name
arbo	/*	The input folder hierarchy	str	False	arbo
patterns	ALT,ASP,SLP	key name for detect the input images	str	False	patterns