crunch (version 1.18.0)

derivations: Get or set a derived variable's expression

Description

Get a derived variable's derivation formula as a (CrunchExpr)expressions with derivation([variable]). Set (change) a derived variable's derivation with derivation([variable]) <- [expression].

Usage

# S4 method for CrunchVariable
derivation(x)
# S4 method for CrunchVariable,ANY
derivation(x) <- value
# S4 method for CrunchVariable,`NULL`
derivation(x) <- value
# S4 method for CrunchVariable
is.derived(x)
# S4 method for CrunchVariable,logical
is.derived(x) <- value

Arguments

x

a variable

value

a CrunchExpr to be used as the derivation (for the setter only) or NULL to integrate a derived variable. For is.derived, FALSE can be used to integrate a derived variable.

Value

a CrunchExpr of the derivation for derivation; a logical for is.derived; the variable given in x for is.derived<- returns

Details

To integrate (aka realize or instantiate) a variable so that it is no longer linked to the source variables that made up the derivation, use derivation([variable]) <- NULL

is.derived can be used to see if a variable is derived or not. Additionally setting a derived variable's is.derived to FALSE will integrate the derived variable.

Examples

# NOT RUN {
ds$derived_v1 <- ds$v1 + 5

derivation(ds$derived_v1)
# Crunch expression: v1 + 5

derivation(ds$derived_v1) <- ds$v1 + 10
derivation(ds$derived_v1)
# Crunch expression: v1 + 10

is.derived(ds$derived_v1)
# TRUE

# to integrate or instantiate the variable in place (remove the link between
# variable v1 and the derivation) you can:
derivation(ds$derived_v1) <- NULL

# after integrating, the derived variable is no longer derived.
is.derived(ds$derived_v1)
# FALSE
# }