DataSet.GetDataCoverage Method

Gets coverage information for this dataset in a given area.

GetDataCoverage(Rectangle areaOfInterest)

Gets coverage information for this dataset in a given area.

Syntax

public RectangleSet GetDataCoverage (
    Rectangle areaOfInterest
)

Parameters

areaOfInterest

Type: Rectangle
The area with to retrieve coverage information for, expressed in the Crs.

Return Value

Type: RectangleSet
The coverage information, also expressed in the Crs.

Remarks

Some datasets can give more detailed information about their data coverage than the simple Bounds property. If so, that information can be retrieved by this method. The default implementation, however, returns only Bounds.

More specifically, this method returns a set of rectangles that indicates what part of the area of interest that is covered with data.

Example

// Get data coverage for Europe in Wgs84LongLat 
public static RectangleSet GetDataCoverageForEuropeInWgs84LongLat(DataSet dataSet)
{
    // The bounds of Europe in Wgs84LongLat
    Rectangle europeBoundary = new Rectangle(-13.01, 35.96, 32.17, 71.69);

    // Project the bounds of Europe to the Crs of the DataSet
    Rectangle projectedBoundary = Crs.Wgs84LongLat.ProjectTo(dataSet.Crs, europeBoundary).Bounds;

    // Get the data coverage in Europe
    RectangleSet dataCoverage = dataSet.GetDataCoverage(projectedBoundary);

    // Project the data coverage to Wgs84LongLat and return it
    return dataSet.Crs.ProjectTo(Crs.Wgs84LongLat, dataCoverage);
}

Platforms

Windows, Linux, Android

DataSet::getDataCoverage Method

Gets coverage information for this dataset in a given area.

getDataCoverage(const Rectangle& areaOfInterest)

Gets coverage information for this dataset in a given area.

Syntax

C++

public:
RectangleSet getDataCoverage (
    const Rectangle& areaOfInterest
)

Parameters

areaOfInterest

Type: Rectangle
The area with to retrieve coverage information for, expressed in the crs.

Return Value

Type: RectangleSet
The coverage information, also expressed in the crs.

Remarks

Some datasets can give more detailed information about their data coverage than the simple bounds property. If so, that information can be retrieved by this method. The default implementation, however, returns only bounds.

More specifically, this method returns a set of rectangles that indicates what part of the area of interest that is covered with data.

Example

C++

// Get data coverage for Europe in wgs84LongLat 
static RectangleSet getDataCoverageForEuropeInWgs84LongLat(DataSetPtr dataSet)
{
    // The bounds of Europe in wgs84LongLat
    Carmenta::Engine::Rectangle europeBoundary(-13.01, 35.96, 32.17, 71.69);

    // Project the bounds of Europe to the Crs of the DataSet
    Carmenta::Engine::Rectangle projectedBoundary = 
        Crs::wgs84LongLat()->projectTo(dataSet->crs(), europeBoundary).bounds();

    // Get the data coverage in Europe
    RectangleSet dataCoverage = dataSet->getDataCoverage(projectedBoundary);

    // Project the data coverage to wgs84LongLat and return it
    return dataSet->crs()->projectTo(Crs::wgs84LongLat(), dataCoverage);
}

Platforms

Windows, Linux, Android

DataSet.getDataCoverage Method

Gets coverage information for this dataset in a given area.

getDataCoverage(Rectangle areaOfInterest)

Gets coverage information for this dataset in a given area.

Syntax

Java

public final RectangleSet getDataCoverage (
    Rectangle areaOfInterest
)

Parameters

areaOfInterest

Type: Rectangle
The area with to retrieve coverage information for, expressed in the crs.

Return Value

Type: RectangleSet
The coverage information, also expressed in the crs.

Remarks

More specifically, this method returns a set of rectangles that indicates what part of the area of interest that is covered with data.

Example

Java

// Get data coverage for Europe in Wgs84LongLat 
public static RectangleSet getDataCoverageForEuropeInWgs84LongLat(DataSet dataSet)
{
    // The bounds of Europe in Wgs84LongLat
    Rectangle europeBoundary = new Rectangle(-13.01, 35.96, 32.17, 71.69);

    // Project the bounds of Europe to the Crs of the DataSet
    Rectangle projectedBoundary = 
        Crs.getWgs84LongLat().projectTo(dataSet.getCrs(), europeBoundary).getBounds();

    // Get the data coverage in Europe
    RectangleSet dataCoverage = dataSet.getDataCoverage(projectedBoundary);

    // Project the data coverage to Wgs84LongLat and return it
    return dataSet.getCrs().projectTo(Crs.getWgs84LongLat(), dataCoverage);
}

Platforms

Windows, Linux, Android

DataSet.getDataCoverage Method

Gets coverage information for this dataset in a given area.

getDataCoverage(areaOfInterest)

Gets coverage information for this dataset in a given area.

Syntax

Python

RectangleSet getDataCoverage ( areaOfInterest )

Parameters

areaOfInterest

Type: Rectangle
The area with to retrieve coverage information for, expressed in the crs.

Return Value

Type: RectangleSet
The coverage information, also expressed in the crs.

Remarks

More specifically, this method returns a set of rectangles that indicates what part of the area of interest that is covered with data.

Example

Python

# This example is not available in the selected language.

Platforms

Windows, Linux, Android

DataSet.GetDataCoverage Method

In this article

GetDataCoverage(Rectangle areaOfInterest)

Syntax

Parameters

Return Value

Remarks

Example

Platforms

See Also

Reference

DataSet::getDataCoverage Method

In this article

getDataCoverage(const Rectangle& areaOfInterest)

Syntax

Parameters

Return Value

Remarks

Example

Platforms

See Also

Reference

DataSet.getDataCoverage Method

In this article

getDataCoverage(Rectangle areaOfInterest)

Syntax

Parameters

Return Value

Remarks

Example

Platforms

See Also

Reference

DataSet.getDataCoverage Method

In this article

getDataCoverage(areaOfInterest)

Syntax

Parameters

Return Value

Remarks

Example

Platforms

See Also

Reference