DataSet.GetValuesAt Methods
Gets a number of raster values.
Overload List
| Name | Description | |
|---|---|---|
| Public method | GetValuesAt(PointCollection points) | Gets a number of raster values at the specified positions, using bilinear interpolation if the dataset is continuous. |
| Public method | GetValuesAt(PointCollection points, RasterFilter rasterFilter) | Gets a number of raster values at the specified positions, using a given interpolation method. |
| Public method | GetValuesAt(IEnumerable< Point > points) | Gets a number of raster values at the specified positions, using bilinear interpolation if the dataset is continuous. |
| Public method | GetValuesAt(IEnumerable< Point > points, RasterFilter rasterFilter) | Gets a number of raster values at the specified positions, using a given interpolation method. |
GetValuesAt(PointCollection points)
Gets a number of raster values at the specified positions, using bilinear interpolation if the dataset is continuous.Syntax
public IntCollection GetValuesAt (
PointCollection points
)Parameters
The positions, expressed in the coordinate reference system of the dataset, to get the values at.
Return Value
The raster values at the specified positions.
Remarks
This method is similar to GetValueAt, except that it retrieves multiple raster values in one call, and if several rasters overlap a position, you are not guaranteed to get the highest well-defined raster value for that position.
Unlike GetValueAt, this method does not throw exceptions if no data is found for a specified coordinate. Instead the returned value for that particular point is set to the lowest representable 32-bit integer, −2147483648. Valid values are still returned for the other positions.
Example
// Get the integer values for the given coordinates
public static IntCollection GetValuesAt(
DataSet dataSet, IEnumerable<Point> wgs84LongLatPointCollection)
{
// Project the coordinates to the Crs of the DataSet
PointCollection projectedPointCollection =
Crs.Wgs84LongLat.ProjectTo(dataSet.Crs, wgs84LongLatPointCollection);
// Get the integer values at the given coordinates and return it
// GetValuesAt does not throw exceptions if no data is found for a specified coordinate.
// Instead the returned value for that particular point is set to -2147483648.
// Valid values are still returned for the other coordinates
return dataSet.GetValuesAt(projectedPointCollection);
}
GetValuesAt(PointCollection points, RasterFilter rasterFilter)
Gets a number of raster values at the specified positions, using a given interpolation method.Syntax
public IntCollection GetValuesAt (
PointCollection points,
RasterFilter rasterFilter
)Parameters
The positions, expressed in the coordinate reference system of the dataset, to get the values at.
The interpolation method: either nearest-neighbor, bilinear or bicubic.
Return Value
The raster values at the specified positions.
Remarks
This method is similar to GetValueAt, except that it retrieves multiple raster values in one call. Also, if several rasters overlap a position, you are not always guaranteed to get the highest well-defined raster value for that position; this is guaranteed only if bicubic interpolation is used.
Unlike GetValueAt, this method does not throw exceptions if no data is found for a specified coordinate. Instead the returned value for that particular point is set to the lowest representable 32-bit integer, −2147483648. Valid values are still returned for the other positions.
Example
// Get the integer values for the given positions, using bicubic interpolation.
public static IntCollection GetValuesBicubicAt(
DataSet dataSet, IEnumerable<Point> wgs84LongLatPointCollection)
{
// Project the coordinates to the Crs of the DataSet
PointCollection projectedPointCollection =
Crs.Wgs84LongLat.ProjectTo(dataSet.Crs, wgs84LongLatPointCollection);
// Get the integer values at the given coordinates and return it
// GetValuesAt does not throw exceptions if no data is found for a specified coordinate.
// Instead the returned value for that particular point is set to -2147483648.
// Valid values are still returned for the other coordinates
return dataSet.GetValuesAt(projectedPointCollection, RasterFilter.Bicubic);
}
GetValuesAt(IEnumerable< Point > points)
Gets a number of raster values at the specified positions, using bilinear interpolation if the dataset is continuous.Syntax
public IntCollection GetValuesAt (
IEnumerable< Point > points
)Parameters
The positions, expressed in the coordinate reference system of the dataset, to get the values at.
Return Value
The raster values at the specified positions.
Remarks
This method is similar to GetValueAt, except that it retrieves multiple raster values in one call, and if several rasters overlap a position, you are not guaranteed to get the highest well-defined raster value for that position.
Unlike GetValueAt, this method does not throw exceptions if no data is found for a specified coordinate. Instead the returned value for that particular point is set to the lowest representable 32-bit integer, −2147483648. Valid values are still returned for the other positions.
Example
// Get the integer values for the given coordinates
public static IntCollection GetValuesAt(
DataSet dataSet, IEnumerable<Point> wgs84LongLatPointCollection)
{
// Project the coordinates to the Crs of the DataSet
PointCollection projectedPointCollection =
Crs.Wgs84LongLat.ProjectTo(dataSet.Crs, wgs84LongLatPointCollection);
// Get the integer values at the given coordinates and return it
// GetValuesAt does not throw exceptions if no data is found for a specified coordinate.
// Instead the returned value for that particular point is set to -2147483648.
// Valid values are still returned for the other coordinates
return dataSet.GetValuesAt(projectedPointCollection);
}
GetValuesAt(IEnumerable< Point > points, RasterFilter rasterFilter)
Gets a number of raster values at the specified positions, using a given interpolation method.Syntax
public IntCollection GetValuesAt (
IEnumerable< Point > points,
RasterFilter rasterFilter
)Parameters
The positions, expressed in the coordinate reference system of the dataset, to get the values at.
The interpolation method: either nearest-neighbor, bilinear or bicubic.
Return Value
The raster values at the specified positions.
Remarks
This method is similar to GetValueAt, except that it retrieves multiple raster values in one call. Also, if several rasters overlap a position, you are not always guaranteed to get the highest well-defined raster value for that position; this is guaranteed only if bicubic interpolation is used.
Unlike GetValueAt, this method does not throw exceptions if no data is found for a specified coordinate. Instead the returned value for that particular point is set to the lowest representable 32-bit integer, −2147483648. Valid values are still returned for the other positions.
Example
// Get the integer values for the given positions, using bicubic interpolation.
public static IntCollection GetValuesBicubicAt(
DataSet dataSet, IEnumerable<Point> wgs84LongLatPointCollection)
{
// Project the coordinates to the Crs of the DataSet
PointCollection projectedPointCollection =
Crs.Wgs84LongLat.ProjectTo(dataSet.Crs, wgs84LongLatPointCollection);
// Get the integer values at the given coordinates and return it
// GetValuesAt does not throw exceptions if no data is found for a specified coordinate.
// Instead the returned value for that particular point is set to -2147483648.
// Valid values are still returned for the other coordinates
return dataSet.GetValuesAt(projectedPointCollection, RasterFilter.Bicubic);
}
Platforms
Windows, Linux, Android