s1tiling.libs.otbwrappers.ConcatenateLIA

class s1tiling.libs.otbwrappers.ConcatenateLIA(cfg: Configuration)[source]

Bases: _ConcatenatorFactory

Factory that prepares steps that run Synthetize on LIA images.

Requires the following information from the configuration object:

  • ram_per_process

Requires the following information from the metadata dictionary

  • input filename

  • output filename

    New methods & Specialized methods

    __init__

    Constructor.

    _update_filename_meta_post_hook

    Override "update_out_filename" hook to help select the input set with the best coverage.

    complete_meta

    Precompute output basename from the input file(s).

    set_output_pixel_type

    Force LIA output pixel type to INT16.

    update_image_metadata

    Update concatenated LIA related information that'll get carried around.

    update_out_filename

    Unlike usual Concatenate, the output filename will always ends in "txxxxxx".

    Methods inherited from parent

    output_directory

    Accessor to where output files will be stored in case their production is required (i.e. not in-memory processing).

    create_step

    create_step() is overridden in Concatenate case in order to by-pass Concatenation in case there is only a single file.

    update_filename_meta

    Duplicates, completes, and returns, the meta dictionary with specific information for the current factory regarding tasks analysis.

    requirement_context

    Returns the requirement context that permits to fix missing requirements.

    parameters

    Returns the parameters to use with Synthetize OTB application.

    tmp_directory

    Directory used to store temporary files before they are renamed into their final version.

    build_step_output_filename

    Returns the names of typical result files in case their production is required (i.e. not in-memory processing).

    build_step_output_tmp_filename

    This specialization of StepFactory.build_step_output_tmp_filename() will automatically insert .tmp before the filename extension.

    check_requirements

    This specialization of check_requirements() checks whether the related OTB application can correctly be executed from S1Tiling.

    Attributes and properties

    appname

    OTB Application property.

    image_description

    Property image_description, used to fill TIFFTAG_IMAGEDESCRIPTION

    name

    Step Name property.

    param_in

    Name of the "in" parameter used by the OTB Application.

    param_out

    Name of the "out" parameter used by the OTB Application.

    ram_per_process

    Property ram_per_process

_do_create_actual_step(execution_parameters: Dict, input_step: AbstractStep, meta: Dict) AbstractStep

Instanciates the step related to the current StepFactory, that consumes results from the previous input step.

  1. We expect the step metadata and the GDAL image metadata to have been updated.

1. Steps that wrap an OTB application will instanciate this application object, and:

  • either pipe the new application to the one from the input step if it wasn’t a first step

  • or fill in the “in” parameter of the application with the out_filename() of the input step.

1-bis. in case the new step isn’t related to an OTB application, nothing specific is done, we’ll just return an AbstractStep

_update_filename_meta_pre_hook(meta: Dict) Dict

Hook meant to be overridden to complete product metadata before they are used to produce filenames or tasknames.

Called from update_filename_meta()

property appname: str

OTB Application property.

build_step_output_filename(meta: Dict) str | List[str]

Returns the names of typical result files in case their production is required (i.e. not in-memory processing).

This specialization uses gen_output_filename naming policy parameter to build the output filename. See the Available naming policies.

build_step_output_tmp_filename(meta: Dict) str | List[str]

This specialization of StepFactory.build_step_output_tmp_filename() will automatically insert .tmp before the filename extension.

check_requirements() Tuple[str, str] | None

This specialization of check_requirements() checks whether the related OTB application can correctly be executed from S1Tiling.

Returns:

A pair of the message indicating what is required, and some context how to fix it – by default: install OTB!

Returns:

None otherwise.

complete_meta(meta: Dict, all_inputs: List[Dict[str, AbstractStep]]) Dict[source]

Precompute output basename from the input file(s).

In concatenation case, the task_name needs to be overridden to stay unique and common to all inputs.

Also, inject files to remove

create_step(execution_parameters: Dict, previous_steps: List[List[Dict[str, AbstractStep]]]) AbstractStep

create_step() is overridden in Concatenate case in order to by-pass Concatenation in case there is only a single file.

property image_description: str

Property image_description, used to fill TIFFTAG_IMAGEDESCRIPTION

property name: str

Step Name property.

output_directory(meta: Dict) str

Accessor to where output files will be stored in case their production is required (i.e. not in-memory processing)

This property is built from gen_output_dir construction parameter. Typical values for the parameter are:

  • os.path.join(cfg.output_preprocess, '{tile_name}'), where tile_name is looked into meta parameter

  • None, in that case the result will be the same as tmp_directory(). This case will make sense for steps that don’t produce required products

property param_in: str

Name of the “in” parameter used by the OTB Application. Default is likely to be “in”, while some applications use “io.in”, often “il” for list of files…

property param_out: str

Name of the “out” parameter used by the OTB Application. Default is likely to be “out”, whie some applications use “io.out”.

parameters(meta: Dict) Dict[str, str | int | float | bool | List[str]]

Returns the parameters to use with Synthetize OTB application.

property ram_per_process

Property ram_per_process

requirement_context() str

Returns the requirement context that permits to fix missing requirements. By default, OTB applications requires… OTB!

set_output_pixel_type(app, meta: Dict) None[source]

Force LIA output pixel type to INT16.

tmp_directory(meta) str

Directory used to store temporary files before they are renamed into their final version.

This property is built from gen_tmp_dir construction parameter. Typical values for the parameter are:

  • os.path.join(cfg.tmpdir, 'S1')

  • os.path.join(cfg.tmpdir, 'S2', '{tile_name}') where tile_name is looked into meta parameter

update_filename_meta(meta: Dict) Dict

Duplicates, completes, and returns, the meta dictionary with specific information for the current factory regarding tasks analysis.

This method is used:

  • while analysing the dependencies to build the task graph – in this use case the relevant information are the file names and paths.

  • and indirectly before instanciating a new Step

Other metadata not filled here:

  • get_task_name() which is deduced from out_filename by default

  • out_extended_filename_complement()

It’s possible to inject some other metadata (that could be used from _get_canonical_input() for instance) thanks to _update_filename_meta_pre_hook().

This method is not meant to be overridden. Instead it implements the template method design pattern, and expects the customization to be done through the specialization of the hooks:

update_image_metadata(meta: Dict, all_inputs: List[Dict[str, AbstractStep]]) None[source]

Update concatenated LIA related information that’ll get carried around.

update_out_filename(meta: Dict, with_task_info: TaskInputInfo) None[source]

Unlike usual Concatenate, the output filename will always ends in “txxxxxx”.

However we want to update the coverage of the current pair as a new input file has been registered.

TODO: Find a better name for the hook as it handles two different services.