migrate {RGeostats}R Documentation

Migrate from a Db into another Db

Description

Migrate a variable from an input into an output Db

Usage

migrate(dbin, dbout, names = db.getname(dbin,"z",1), 
             flag.fill=FALSE, flag.inter=FALSE, ldmax=2, dmax=NA, 
             update.names=NA, radix = "Migrate", modify.target = db.locmod())

Arguments

dbin

The db-class where the input variable is read

dbout

The db-class where the migrated results are written

names

List of names of attributes to be processed. For more information see db.ident.

flag.fill

Grid filling option (only valid when migrating to Grid).

  • FALSE Points are assigned to the grid nodes (some grid nodes may be left empty)

  • TRUE All grid nodes will be valuated with the closest point value

flag.inter

Grid interpolation option (only valid when migrating from Grid to Point).

  • When TRUE, the result is the multilinear interpolated value from the grid.

  • When FALSE, the result is the value of the closest grid node.

ldmax

When the migration is limited to a maximum distance (argument 'dmax'), this criterion is based on the distance between a datum and the target where the datum can be potentially migrated. The criterion can be applied in two different ways:

  • ldmax=1 The migration does not take place as soon as a distance along one direction is larger than the corresponding 'dmax' value.

  • ldmax=2 The migration does not take place if the target does not belong to an ellipsoid, centered on the datum, whose dimensions along each space direction is given by the corresponding 'dmax' value.

dmax

Maximum distance for migration (when defined). This argument can be provided as an array (whose dimension must match the space dimension of both 'db' files). If provided as a scalar (dimension: 1), this value is used along each space dimension.

update.names

When 'update.names' are provided (in the output db-class) and if their count is equal to the 'names' (in the input db-class), then the resulting variables are PATCHED in 'update.names' (instead of being added).

radix

Radix of the name given to the output variable

modify.target

Decides whether or not the newly created variables will have their locator defined or not. For more information, see db.locmod.

Value

The output Db where the calculated variable has been added or updated.

[Package RGeostats version 14.0.10 Index]