Package net.simplace.sim.transformers
package net.simplace.sim.transformers
Transformers change data from resources before simulation start
WIKI_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 sim components 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.
WIKI_END
- See Also:
-
ClassesClassDescriptionWIKI_START 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.Calculates the Daylengths for a given latitude.Transforms daily radiation and temperature to diurnal values using sine curves.Aggregates values of several soil layers up to the user-specified maximal soil depth.Calculates linear Regression (slope and intercept) from two double arrays WIKI_START == Inputs and outputs == The transformer takes the field/column names from a resource that act as x and y values.Fills missing datasets.Calculates net radiation from either global radiation or, if no global radiation available, from sun hours using (FAO 56) methods.WIKI_START 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.WIKI_START Extension of the !WIKI_START 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.WIKI_START 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.