# 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