# pygplates.GpmlTimeWindow¶

class pygplates.GpmlTimeWindow(property_value, begin_time, end_time)

Bases: Boost.Python.instance

A time window associates an arbitrary property value with a specific time period. The property value does not vary over the time period of the window. Typically a sequence of time windows are used in a GpmlPiecewiseAggregation where the sequence of windows form a piecewise-constant (staircase function) property value over time (since each time window has a constant property value) assuming the windows do not have overlaps or gaps in time.

Time windows 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 windows being compared (see PropertyValue) as well as the time period.

__init__(property_value, begin_time, end_time)

Create a time window given a property value and time range.

Parameters: property_value (PropertyValue) – arbitrary property value begin_time (float or GeoTimeInstant) – the begin time of the time window end_time (float or GeoTimeInstant) – the end time of the time window GmlTimePeriodBeginTimeLaterThanEndTimeError if begin time is later than end time
time_window = pygplates.GpmlTimeWindow(property_value, begin_time, end_time)


Note that begin_time must be further in the past than the end_time begin_time > end_time.

Methods

 __init__(property_value, begin_time, end_time) Create a time window given a property value and time range. get_begin_time() Returns the begin time of this time window. get_end_time() Returns the end time of this time window. get_value() Returns the property value of this time window. set_begin_time(time) Sets the begin time of this time window. set_end_time(time) Sets the end time of this time window. set_value(property_value) Sets the property value associated with this time window.
get_begin_time()

Returns the begin time of this time window.

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_end_time()

Returns the end time of this time window.

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 window.

Return type: PropertyValue
set_begin_time(time)

Sets the begin time of this time window.

Parameters: time (float or GeoTimeInstant) – the begin time of this time window GmlTimePeriodBeginTimeLaterThanEndTimeError if begin time is later than end time
set_end_time(time)

Sets the end time of this time window.

Parameters: time (float or GeoTimeInstant) – the end time of this time window GmlTimePeriodBeginTimeLaterThanEndTimeError if begin time is later than end time
set_value(property_value)

Sets the property value associated with this time window.

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.GpmlTimeSample

#### Next topic

pygplates.PointOnSphere