Import variables from a reprocess#

This page documents SignalCreation.Lidar.Lidar.insert_new_parameters(), which imports one or more variables from an external reprocessed dataset into the current LIDAR dataset, with configurable renaming and conflict handling.

Function signature#

def insert_new_parameters(
    self,
    data,
    variables_to_import: list[str] | str | None = None,
    variables_to_import_new_name: list[str] | str | None = None,
    tag_param_variable_to_import: str = "import_reprocess_data/insert_new_parameters/variables_to_import",
    tag_param_variables_to_import_new_name: str = "import_reprocess_data/insert_new_parameters/variables_to_import_new_name",
    case_same_name: str | None = None,
) -> None

Parameters#

  • data Source reprocessed object (GeoScene-like) holding _lidar data.

  • variables_to_import (list[str] | str | None) Names of variables to copy. If None, read from XML at the given tag.

  • variables_to_import_new_name (list[str] | str | None) Target names for copied variables. If None, read from XML at the given tag.

  • case_same_name (str | None, default: ``”change_name”``) Behavior when the target name already exists: "change_name", "overwrite", or "raise_error".

XML configuration#

  • Variables: import_reprocess_data/insert_new_parameters/variables_to_import

  • New names: import_reprocess_data/insert_new_parameters/variables_to_import_new_name

Workflow#

  1. Read or accept variables and new names; ensure same length.

  2. For each pair, handle name conflicts per policy.

  3. Insert DataArrays in the current dataset under the requested target names.

Outputs#

  • New variables added into the dataset under the specified names.

  • Returns None (modifies dataset in place).

See also#