pyissm.model.classes.esa

class pyissm.model.classes.esa(other=None)

Bases: manage_state

Elastic solid earth adjustment (ESA) class for ISSM.

This class contains parameters for elastic solid earth adjustment in the ISSM framework. ESA models the instantaneous elastic response of the solid Earth to ice loading changes, which is important for studying present-day ice sheet mass balance and sea level change.

Parameters:

other (any, optional) – Any other class object that contains common fields to inherit from. If values in other differ from default values, they will override the default values.

deltathickness

Thickness change: ice height equivalent [m].

Type:

float, default=np.nan

love_h

Load Love number for radial displacement.

Type:

float, default=0.0

love_l

Load Love number for horizontal displacements.

Type:

float, default=0.0

hemisphere

North-south, East-west components of 2-D horizontal displacement vector: -1 south, 1 north.

Type:

float, default=0.0

degacc

Accuracy (default 0.01 deg) for numerical discretization of the Green’s functions.

Type:

float, default=0.01

requested_outputs

Additional outputs requested (default: EsaUmotion).

Type:

list, default=[‘default’]

transitions

Indices into parts of the mesh that will be icecaps.

Type:

list, default=[]

Examples

>>> md.esa = pyissm.model.classes.esa()
>>> md.esa.deltathickness = thickness_change
>>> md.esa.love_h = 0.6
>>> md.esa.love_l = 0.1
>>> md.esa.degacc = 0.005
__init__(other=None)

Initialize the instance with optional field inheritance.

Parameters:

other (object, optional) – Another instance to inherit field values from. If provided, any fields in the current instance that differ from the default values and exist in ‘other’ will be replaced with the values from ‘other’.

Notes

The inheritance process:

  1. Iterates through all attributes of the current instance

  2. Checks if the same attribute exists in the ‘other’ instance

  3. Compares field values using _fields_equal()

  4. If different, replaces the current value with the ‘other’ value

This enables the common ISSM pattern where classes can inherit configurations from existing instances while maintaining their default values for unspecified fields.

Methods

__init__([other])

Initialize the instance with optional field inheritance.

check_consistency(md, solution, analyses)

Check consistency of the [esa] parameters.

issm_enum_string()

Default ISSM C++ enum string used during marshalling.

marshall_class(fid, prefix[, md])

Marshall [esa.esa] parameters to a binary file.
check_consistency(md, solution, analyses)

Check consistency of the [esa] parameters.

Parameters:

  • md (pyissm.model.Model) – The model object to check.

  • solution (str) – The solution name to check.

  • analyses (list of str) – List of analyses to check consistency for.

Returns:

md – The model object with any consistency errors noted.

Return type:

pyissm.model.Model

marshall_class(fid, prefix, md=None)

Marshall [esa.esa] parameters to a binary file.

Parameters:

  • fid (file object) – The file object to write the binary data to.

  • prefix (str) – Prefix string used for data identification in the binary file.

  • md (pyissm.model.Model, optional) – ISSM model object needed in some cases.

Return type:

None