CL_dataGet

Description

• Retrieves the values of CelestLab data.

  The argument local specifies if local data values can be returned instead of internal ones:

  - local = %f : internal (predefined) values are always returned.

  - local = %t : local data values (values of variables whose name begin with "%CL_") are returned if these data exist. This is the default behaviour.

  Notes:

  - The names of CelestLab data that can be found through the CelestLab menu - tab "Data files (predefined variables)". The data files (*.scd) where the data are defined are located in the folder: CL_home()/data.

  - Any field is accessible. For instance CL_dataGet("body") returns the whole "body" structure, CL_dataGet("body.Sun.mu") returns only the value of the field "body.Sun.mu. "

  - If a local variable (%CL_xxx) exists, its value should have a same type and size as the corresponding internal (predefined) value.

  - CL_dataGet() returns the whole (internal) data structure. The argument "local" is ignored.

Parameters

name:

(optional, string) Data name. Default is "" (all data structure) (1x1)

local:

(optional, boolean) %t if local variable is returned if it exists. Default is %t (1x1)

val:

Value of the field (can be a structure or a matrix of any size)

Authors

• CNES - DCT/SB

See also

• CL_init

Examples

muSun = CL_dataGet("body.Sun.mu"); au = CL_dataGet("au"); body = CL_dataGet("body"); CL_dataGet("mu", local=%f) // => default value %CL_mu = CL_dataGet("body.Sun.mu"); // change local change CL_dataGet("mu") // => local value %CL_mu = CL_dataGet("mu", local=%f) // reset to default value // Retrieve CelestLab's whole (internal) data structure: s = CL_dataGet()