25 mTemporalRepresentationScale.
setDays( 1.0 );
40 for (
auto it = mRangePerBand.constBegin(); it != mRangePerBand.constEnd(); ++it )
42 if ( it.value().overlaps( range ) )
58 QgsRasterLayer *rasterLayer = qobject_cast< QgsRasterLayer *>( layer );
74 bool includeBeginning =
true;
75 bool includeEnd =
true;
76 for (
auto it = mRangePerBand.constBegin(); it != mRangePerBand.constEnd(); ++it )
78 if ( it.value().begin() < begin || !begin.isValid() )
80 begin = it.value().
begin();
81 includeBeginning = it.value().includeBeginning();
83 else if ( !includeBeginning && it.value().begin() == begin && it.value().includeBeginning() )
85 includeBeginning =
true;
87 if ( it.value().end() > end || !end.isValid() )
89 end = it.value().end();
90 includeEnd = it.value().includeEnd();
92 else if ( !includeEnd && it.value().end() == end && it.value().includeEnd() )
110 QgsRasterLayer *rasterLayer = qobject_cast< QgsRasterLayer *>( layer );
115 return { mFixedRange };
119 QList<QgsDateTimeRange> results;
120 results.reserve( mRangePerBand.size() );
121 for (
auto it = mRangePerBand.constBegin(); it != mRangePerBand.constEnd(); ++it )
123 results.append( it.value() );
175 return mIntervalHandlingMethod;
180 if ( mIntervalHandlingMethod == method )
182 mIntervalHandlingMethod = method;
197 return mRangePerBand;
202 if ( mRangePerBand == ranges )
205 mRangePerBand = ranges;
221 int currentMatchingBand = -1;
223 for (
auto it = mRangePerBand.constBegin(); it != mRangePerBand.constEnd(); ++it )
225 if ( it.value().overlaps( range ) )
228 || ( it.value().includeEnd() && it.value().end() >= currentMatchingRange.
end() )
229 || ( !currentMatchingRange.
includeEnd() && it.value().end() >= currentMatchingRange.
end() ) )
231 currentMatchingBand = it.key();
232 currentMatchingRange = it.value();
236 return currentMatchingBand;
253 const int bandCount = layer->
bandCount();
255 res.reserve( bandCount );
256 for (
int i = 1; i <= bandCount; ++i )
264 res.reserve( mRangePerBand.size() );
267 for (
auto it = mRangePerBand.constBegin(); it != mRangePerBand.constEnd(); ++it )
269 if ( it.value().overlaps( range ) )
271 res.append( it.key() );
278 return QList<int>() << mBandNumber;
290 if ( mBandNumber == number )
293 mBandNumber = number;
298 return mTemporalRepresentationOffset;
303 if ( mTemporalRepresentationOffset == offset )
306 mTemporalRepresentationOffset = offset;
311 return mTemporalRepresentationScale;
316 if ( mTemporalRepresentationScale == scale )
319 mTemporalRepresentationScale = scale;
327 const QDomElement temporalNode = element.firstChildElement( QStringLiteral(
"temporal" ) );
329 setIsActive( temporalNode.attribute( QStringLiteral(
"enabled" ), QStringLiteral(
"0" ) ).toInt() );
331 mMode =
static_cast< Qgis::RasterTemporalMode >( temporalNode.attribute( QStringLiteral(
"mode" ), QStringLiteral(
"0" ) ). toInt() );
332 mBandNumber = temporalNode.attribute( QStringLiteral(
"bandNumber" ), QStringLiteral(
"1" ) ).toInt();
333 mIntervalHandlingMethod =
static_cast< Qgis::TemporalIntervalMatchMethod >( temporalNode.attribute( QStringLiteral(
"fetchMode" ), QStringLiteral(
"0" ) ). toInt() );
339 const QDomNode rangeElement = temporalNode.namedItem( QStringLiteral(
"fixedRange" ) );
341 const QDomNode begin = rangeElement.namedItem( QStringLiteral(
"start" ) );
342 const QDomNode end = rangeElement.namedItem( QStringLiteral(
"end" ) );
344 const QDateTime beginDate = QDateTime::fromString( begin.toElement().text(), Qt::ISODate );
345 const QDateTime endDate = QDateTime::fromString( end.toElement().text(), Qt::ISODate );
354 mRangePerBand.clear();
356 const QDomNodeList ranges = temporalNode.firstChildElement( QStringLiteral(
"ranges" ) ).childNodes();
357 for (
int i = 0; i < ranges.size(); ++i )
359 const QDomElement rangeElement = ranges.at( i ).toElement();
360 const int band = rangeElement.attribute( QStringLiteral(
"band" ) ).toInt();
361 const QDateTime begin = QDateTime::fromString( rangeElement.attribute( QStringLiteral(
"begin" ) ), Qt::ISODate );
362 const QDateTime end = QDateTime::fromString( rangeElement.attribute( QStringLiteral(
"end" ) ), Qt::ISODate );
363 const bool includeBeginning = rangeElement.attribute( QStringLiteral(
"includeBeginning" ) ).toInt();
364 const bool includeEnd = rangeElement.attribute( QStringLiteral(
"includeEnd" ) ).toInt();
365 mRangePerBand.insert( band,
QgsDateTimeRange( begin, end, includeBeginning, includeEnd ) );
372 mTemporalRepresentationOffset = QDateTime::fromString( temporalNode.attribute( QStringLiteral(
"temporalRepresentationOffset" ) ), Qt::ISODate );
373 mTemporalRepresentationScale =
QgsInterval( temporalNode.attribute( QStringLiteral(
"temporalRepresentationScale" ), QStringLiteral(
"1" ) ).toDouble(),
374 static_cast< Qgis::TemporalUnit >( temporalNode.attribute( QStringLiteral(
"temporalRepresentationScaleUnit" ), QStringLiteral(
"4" ) ).toInt() ) );
389 if ( element.isNull() )
390 return QDomElement();
392 QDomElement temporalElement = document.createElement( QStringLiteral(
"temporal" ) );
393 temporalElement.setAttribute( QStringLiteral(
"enabled" ),
isActive() ? QStringLiteral(
"1" ) : QStringLiteral(
"0" ) );
394 temporalElement.setAttribute( QStringLiteral(
"mode" ), QString::number(
static_cast< int >( mMode ) ) );
395 temporalElement.setAttribute( QStringLiteral(
"bandNumber" ), QString::number( mBandNumber ) );
396 temporalElement.setAttribute( QStringLiteral(
"fetchMode" ), QString::number(
static_cast< int >( mIntervalHandlingMethod ) ) );
403 QDomElement rangeElement = document.createElement( QStringLiteral(
"fixedRange" ) );
405 QDomElement startElement = document.createElement( QStringLiteral(
"start" ) );
406 QDomElement endElement = document.createElement( QStringLiteral(
"end" ) );
408 const QDomText startText = document.createTextNode( mFixedRange.
begin().toTimeSpec( Qt::OffsetFromUTC ).toString( Qt::ISODate ) );
409 const QDomText endText = document.createTextNode( mFixedRange.
end().toTimeSpec( Qt::OffsetFromUTC ).toString( Qt::ISODate ) );
410 startElement.appendChild( startText );
411 endElement.appendChild( endText );
412 rangeElement.appendChild( startElement );
413 rangeElement.appendChild( endElement );
415 temporalElement.appendChild( rangeElement );
421 QDomElement ranges = document.createElement( QStringLiteral(
"ranges" ) );
422 for (
auto it = mRangePerBand.constBegin(); it != mRangePerBand.constEnd(); ++it )
424 QDomElement range = document.createElement( QStringLiteral(
"range" ) );
425 range.setAttribute( QStringLiteral(
"band" ), it.key() );
426 range.setAttribute( QStringLiteral(
"begin" ), it.value().begin().toString( Qt::ISODate ) );
427 range.setAttribute( QStringLiteral(
"end" ), it.value().end().toString( Qt::ISODate ) );
428 range.setAttribute( QStringLiteral(
"includeBeginning" ), it.value().includeBeginning() ?
"1" :
"0" );
429 range.setAttribute( QStringLiteral(
"includeEnd" ), it.value().includeEnd() ?
"1" :
"0" );
430 ranges.appendChild( range );
432 temporalElement.appendChild( ranges );
438 temporalElement.setAttribute( QStringLiteral(
"temporalRepresentationOffset" ), mTemporalRepresentationOffset.toString( Qt::ISODate ) );
439 temporalElement.setAttribute( QStringLiteral(
"temporalRepresentationScale" ), QString::number( mTemporalRepresentationScale.
originalDuration() ) );
440 temporalElement.setAttribute( QStringLiteral(
"temporalRepresentationScaleUnit" ), QString::number(
static_cast< int >( mTemporalRepresentationScale.
originalUnit() ) ) );
449 element.appendChild( temporalElement );
458 setIsActive( rasterCaps->hasTemporalCapabilities() );
461 if ( rasterCaps->hasTemporalCapabilities() )
466 mIntervalHandlingMethod = rasterCaps->intervalHandlingMethod();
TemporalIntervalMatchMethod
Method to use when resolving a temporal range to a data provider layer or band.
TemporalUnit
Temporal units.
RasterTemporalMode
Raster layer temporal modes.
@ RepresentsTemporalValues
Pixel values represent an datetime.
@ RedrawLayerOnly
Redraw the layer when temporal range changes, but don't apply any filtering. Useful when raster symbo...
@ FixedRangePerBand
Layer has a fixed temporal range per band.
@ TemporalRangeFromDataProvider
Mode when raster layer delegates temporal range handling to the dataprovider.
@ FixedTemporalRange
Mode when temporal properties have fixed start and end datetimes.
Base class for handling properties relating to a data provider's temporal capabilities.
A representation of the interval between two datetime values.
double originalDuration() const
Returns the original interval duration.
Qgis::TemporalUnit originalUnit() const
Returns the original interval temporal unit.
void setDays(double days)
Sets the interval duration in days.
Base class for storage of map layer temporal properties.
Base class for all map layer types.
Implementation of data provider temporal properties for QgsRasterDataProviders.
QList< QgsDateTimeRange > allAvailableTemporalRanges() const
Returns a list of all valid datetime ranges for which temporal data is available from the provider.
const QgsDateTimeRange & availableTemporalRange() const
Returns the overall datetime range extent from which temporal data is available from the provider.
QgsRasterDataProviderTemporalCapabilities * temporalCapabilities() override
Returns the provider's temporal capabilities.
QDomElement writeXml(QDomElement &element, QDomDocument &doc, const QgsReadWriteContext &context) override
Writes the properties to a DOM element, to be used later with readXml().
QDateTime temporalRepresentationOffset() const
Returns the temporal offset, which is a fixed datetime which should be added to individual pixel valu...
void setDefaultsFromDataProviderTemporalCapabilities(const QgsDataProviderTemporalCapabilities *capabilities) override
Sets the layers temporal settings to appropriate defaults based on a provider's temporal capabilities...
bool isVisibleInTemporalRange(const QgsDateTimeRange &range) const override
Returns true if the layer should be visible and rendered for the specified time range.
QgsTemporalProperty::Flags flags() const override
Returns flags associated to the temporal property.
QList< int > filteredBandsForTemporalRange(QgsRasterLayer *layer, const QgsDateTimeRange &range) const
Returns a filtered list of bands which match the specified range.
void setTemporalRepresentationOffset(const QDateTime &offset)
Sets the temporal offset, which is a fixed datetime which should be added to individual pixel values ...
Qgis::TemporalIntervalMatchMethod intervalHandlingMethod() const
Returns the desired method to use when resolving a temporal interval to matching layers or bands in t...
const QgsInterval & temporalRepresentationScale() const
Returns the scale, which is an interval factor which should be applied to individual pixel values fro...
void setIntervalHandlingMethod(Qgis::TemporalIntervalMatchMethod method)
Sets the desired method to use when resolving a temporal interval to matching layers or bands in the ...
Qgis::RasterTemporalMode mode() const
Returns the temporal properties mode.
void setTemporalRepresentationScale(const QgsInterval &scale)
Sets the scale, which is an interval factor which should be applied to individual pixel values from t...
int bandForTemporalRange(QgsRasterLayer *layer, const QgsDateTimeRange &range) const
Returns the band corresponding to the specified range.
QList< QgsDateTimeRange > allTemporalRanges(QgsMapLayer *layer) const override
Attempts to calculate the overall list of all temporal extents which are contained in the specified l...
void setMode(Qgis::RasterTemporalMode mode)
Sets the temporal properties mode.
QgsRasterLayerTemporalProperties(QObject *parent=nullptr, bool enabled=false)
Constructor for QgsRasterLayerTemporalProperties, with the specified parent object.
void setFixedTemporalRange(const QgsDateTimeRange &range)
Sets a temporal range to apply to the whole layer.
void setFixedRangePerBand(const QMap< int, QgsDateTimeRange > &ranges)
Sets the fixed temporal range for each band.
bool readXml(const QDomElement &element, const QgsReadWriteContext &context) override
Reads temporal properties from a DOM element previously written by writeXml().
QMap< int, QgsDateTimeRange > fixedRangePerBand() const
Returns the fixed temporal range for each band.
int bandNumber() const
Returns the band number from which temporal values should be taken.
const QgsDateTimeRange & fixedTemporalRange() const
Returns the fixed temporal range for the layer.
QgsDateTimeRange calculateTemporalExtent(QgsMapLayer *layer) const override
Attempts to calculate the overall temporal extent for the specified layer, using the settings defined...
void setBandNumber(int number)
Sets the band number from which temporal values should be taken.
Represents a raster layer.
int bandCount() const
Returns the number of bands in this layer.
QgsRasterDataProvider * dataProvider() override
Returns the source data provider.
The class is used as a container of context for various read/write operations on other objects.
void changed()
Emitted when the temporal properties have changed.
bool isActive() const
Returns true if the temporal property is active.
void setIsActive(bool active)
Sets whether the temporal property is active.
@ FlagDontInvalidateCachedRendersWhenRangeChanges
Any cached rendering will not be invalidated when temporal range context is modified.
T begin() const
Returns the beginning of the range.
T end() const
Returns the upper bound of the range.
bool overlaps(const QgsTemporalRange< T > &other) const
Returns true if this range overlaps another range.
bool includeEnd() const
Returns true if the end is inclusive, or false if the end is exclusive.
bool isInfinite() const
Returns true if the range consists of all possible values.
#define BUILTIN_UNREACHABLE
QgsTemporalRange< QDateTime > QgsDateTimeRange
QgsRange which stores a range of date times.