pygplates.GpmlTimeSample

class pygplates.GpmlTimeSample(property_value, time[, description][, is_enabled=True])

Bases: Boost.Python.instance

A time sample associates an arbitrary property value with a specific time instant. Typically a sequence of time samples are used in a GpmlIrregularSampling. The most common example of this is a time-dependent sequence of total reconstruction poles.

Time samples are equality (==, !=) comparable (but not hashable - cannot be used as a key in a dict). This includes comparing the property value in the two time samples being compared (see PropertyValue) as well as the time instant, description string and disabled flag.

__init__(property_value, time[, description][, is_enabled=True])

Create a time sample given a property value and time and optionally a description string and disabled flag.

Parameters:
  • property_value (PropertyValue) – arbitrary property value
  • time (float or GeoTimeInstant) – the time position associated with the property value
  • description (string or None) – description of the time sample
  • is_enabled (bool) – whether time sample is enabled
time_sample = pygplates.GpmlTimeSample(property_value, time)

Methods

__init__(property_value, time, ...) Create a time sample given a property value and time and optionally a description string and disabled flag.
get_description() Returns the description of this time sample, or None.
get_time() Returns the time position of this time sample.
get_value() Returns the property value of this time sample.
is_disabled() Returns whether this time sample is disabled or not.
is_enabled() Returns whether this time sample is enabled.
set_description([description]) Sets the description associated with this time sample, or removes it if none specified.
set_disabled([is_disabled=True]) Sets whether this time sample is disabled.
set_enabled([is_enabled=True]) Sets whether this time sample is enabled.
set_time(time) Sets the time position associated with this time sample.
set_value(property_value) Sets the property value associated with this time sample.
get_description()

Returns the description of this time sample, or None.

Return type:string or None
get_time()

Returns the time position of this time sample.

Return type:float

You can use GeoTimeInstant with the returned float to check for distant past or distant future for example. See GmlTimeInstant.get_time() for more details.

get_value()

Returns the property value of this time sample.

Return type:PropertyValue
is_disabled()

Returns whether this time sample is disabled or not.

Return type:bool

For example, a disabled total reconstruction pole (in a GpmlIrregularSampling sequence) is ignored when interpolating rotations at some arbitrary time.

is_enabled()

Returns whether this time sample is enabled.

Return type:bool

For example, only enabled total reconstruction poles (in a GpmlIrregularSampling sequence) are considered when interpolating rotations at some arbitrary time.

set_description([description])

Sets the description associated with this time sample, or removes it if none specified.

Parameters:description (string or None) – description of the time sample
set_disabled([is_disabled=True])

Sets whether this time sample is disabled.

Parameters:is_disabled (bool) – whether time sample is disabled (defaults to True)
set_enabled([is_enabled=True])

Sets whether this time sample is enabled.

Parameters:is_enabled (bool) – whether time sample is enabled (defaults to True)
set_time(time)

Sets the time position associated with this time sample.

Parameters:time (float or GeoTimeInstant) – the time position associated with the property value
set_value(property_value)

Sets the property value associated with this time sample.

Parameters:property_value (PropertyValue) – arbitrary property value

This essentially replaces the previous property value. Note that an alternative is to directly modify the property value returned by get_value() using its property value methods.

Previous topic

pygplates.GpmlPiecewiseAggregation

Next topic

pygplates.GpmlTimeWindow

This Page