Package net.simplace.sim.transformers

package net.simplace.sim.transformers
Transformers change data from resources before simulation start

Overview

Transformers normally act on resources and produce new resources, e.g. unit conversion, subdivision of layered data, aggregation etc.

The data is transformed before the simulation starts.

General Description

There are different types of transformers

  • column tranformers
  • transformer-generators
  • resourceless generators

Column transformers

They take colums of an existing resource and transforms them to coresponding columns of a new resource.

Column transformers have the same key values as the resource they transform. The key columns and the transformed columns are in the same order as in the resource.

Example: The SoilLayer transformer creates from each layered soil property of arbitrary depth a soil property with fixed layer depth.

Transformer-Generators

They take columns of an existing resource and generate one ore more columns of a new resource

Transformer-Generators often have an additional key column. The order of the keys is determined by the transformer. Some transformers can transform only resources that have a single key column. The number, datatype and order of the generated columns is determined by the transformer. See the documentation of particular transformer for details.

Example: The AstronomicParameterTransformer that transforms a resource containing a latitude column to a new resource that holds for each latitude in the resource the corresponding daylengths of all DOYs. The resulting resource has first the DOY as a key column, followed by the key column of the resources and then the columns for Daylength, PhotoperiodicDaylength, SolarConstant ... in this order.

Resourceless Generators

They transform no resource, but rather take parameters and generate a new resource.

The key column(s) and the number, datatype and order of the generated columns are defined by the transformer. See the documentation of particular transformer for details.

Example: The Daylength transformer takes latitude as a parameter and generates daylengths of all DOYs. The only key column is the DOY.

Notice

When transformation depends on simulated values or when simulations within one project need custom transformations (e.g. for calibration) then the transformers can not be used. In these cases transforming SimComponents can help.

Some transformer's behaviour depends on the input configuration. The astronomic parameter transformer can act as a transformer-generator as well as a resourceless generator.

See individual transformer documentation for details.

Siehe auch:
  • Klassen
    Klasse
    Beschreibung
    AstronomicParametersTransformer

    Calculated daylength, photoperiodic daylength, solar constant and daily total effective solar height for each DOY for a set of given latitudes.

    Input and output of the transformer

    For each row in the resource it creates 366 rows containing values for each day of year (DOY)

    The transformer needs the field names of a resource, that contain

    • location id
    • latitude in decimal degrees
    • inclination of sun angle in decimal degrees

    Normally you do not enter the numeric value for latitude, but a reference to the value, i. e. the column name of the resource's column containing the latitudes.

    DayLengthTransformer
    Calculates the Daylengths for a given latitude.
    DiurnalSineWeatherTransformer
    Transforms daily radiation and temperature to diurnal values using sine curves.
    LayerAggregationTransformer
    Aggregates values of several soil layers up to the user-specified maximal soil depth.
    LinearRegressionTransformer
    Calculates linear Regression (slope and intercept) from two double arrays

    Inputs and outputs

    The transformer takes the field/column names from a resource that act as x and y values.

    MissingDataTransformer
    Fills missing datasets.
    NetRadiationFromAnyTransformer
    Calculates net radiation from either global radiation or, if no global radiation available, from sun hours using (FAO 56) methods.
    PedotransferTransformer

    Takes data with

    • depth,
    • clay percentage,
    • silt percentage,
    • sand percentage (optional, default 100-(clay+silt)),
    • organic matter percentage (optional, default 0),
    • bulk density (optional, default 1.4),
    • top soil depth (optional, default 0.3 m),
    • pedotransfer function (optional, default 'Hypres'),
    • gravel percentage (optional, default 0)

    in n soil layers and transforms it to Van Genuchten parameters alpha, l, m, n and Ks or Volumetric water contents.

    Description

    Soil data is mostly delivered with the layer specific information.

    SlimAlfaTransformer
    Extension of the SoilLayerTransformer that additionally calculates ALFA.
    SoilLayerTransformer

    Distributes values of n layers of arbitrary thickness to m layers with uniform thickness.

    Description

    Original resolution is taken from an array that contains the depth of the lower boundary of each layer.

    SoilLayerTransformerLegacy

    Takes data with n depth depended layers and creates m layers with the same information

    Description

    Soil data is mostly delivered with the layer specific information.