DataSet.GetNormalizedFloatValuesAt Methods
Gets a number of raster values, normalized by Scale and Offset.
Overload List
| Name | Description | |
|---|---|---|
| Public method | GetNormalizedFloatValuesAt(PointCollection points) | Gets a number of float raster values at the specified positions, normalized by Scale and Offset, using bilinear interpolation if the dataset is continuous. |
| Public method | GetNormalizedFloatValuesAt(PointCollection points, RasterFilter rasterFilter) | Gets a number of float raster values at the specified positions, normalized by Scale and Offset, using a given interpolation method. |
| Public method | GetNormalizedFloatValuesAt(IEnumerable< Point > points) | Gets a number of raster values at the specified positions, normalized by Scale and Offset, using bilinear interpolation if the dataset is continuous. |
| Public method | GetNormalizedFloatValuesAt(IEnumerable< Point > points, RasterFilter rasterFilter) | Gets a number of raster values at the specified positions, normalized by Scale and Offset, using a given interpolation method. |
GetNormalizedFloatValuesAt(PointCollection points)
Gets a number of float raster values at the specified positions, normalized by Scale and Offset, using bilinear interpolation if the dataset is continuous.Syntax
public FloatCollection GetNormalizedFloatValuesAt (
PointCollection points
)Parameters
The positions, expressed in the coordinate reference system of the dataset, to get the values at.
Return Value
For each raster cell value c at the specified positions, the normalized value c * Scale + Offset.
Remarks
This method works only if the dataset can read Scale and Offset from metadata.
The method is similar to GetNormalizedFloatValueAt, 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 GetNormalizedFloatValueAt, 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 a value less than −1.0e38. Valid values are still returned for the other positions.
Currently, only the GdalDataSet can read Offset and Scale from metadata. If the dataset cannot read Offset and Scale, this method will throw an exception, so you must instead call GetFloatValuesAt and use the Offset and Scale in application code (if you know them).
Example
// Get the normalized float values for the given coordinates
public static FloatCollection GetNormalizedFloatValuesAt(
DataSet dataSet, IEnumerable<Point> wgs84LongLatPointCollection)
{
// Project the coordinates to the Crs of the DataSet
PointCollection projectedPointCollection =
Crs.Wgs84LongLat.ProjectTo(dataSet.Crs, wgs84LongLatPointCollection);
// Get the normalized float values at the given coordinates and return it
// GetNormalizedFloatValuesAt does not throw exceptions if no data is found
// for a specified coordinate. Instead the returned value for that particular
// point is set to a value less than -1.0e38. Valid values are still returned
// for the other coordinates.
return dataSet.GetNormalizedFloatValuesAt(projectedPointCollection);
}
GetNormalizedFloatValuesAt(PointCollection points, RasterFilter rasterFilter)
Gets a number of float raster values at the specified positions, normalized by Scale and Offset, using a given interpolation method.Syntax
public FloatCollection GetNormalizedFloatValuesAt (
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
For each raster cell value c at the specified positions, the normalized value c * Scale + Offset.
Remarks
This method works only if the dataset can read Scale and Offset from metadata.
The method is similar to GetNormalizedFloatValueAt, 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 GetNormalizedFloatValueAt, 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 a value less than −1.0e38. Valid values are still returned for the other positions.
Currently, only the GdalDataSet can read Offset and Scale from metadata. If the dataset cannot read Offset and Scale, this method will throw an exception, so you must instead call GetFloatValuesAt and use the Offset and Scale in application code (if you know them).
GetNormalizedFloatValuesAt(IEnumerable< Point > points)
Gets a number of raster values at the specified positions, normalized by Scale and Offset, using bilinear interpolation if the dataset is continuous.Syntax
public FloatCollection GetNormalizedFloatValuesAt (
IEnumerable< Point > points
)Parameters
The positions, expressed in the coordinate reference system of the dataset, to get the values at.
Return Value
For each raster cell value c at the specified positions, the normalized value c * Scale + Offset.
Remarks
This method works only if the dataset can read Scale and Offset from metadata.
The method is similar to GetNormalizedFloatValueAt, 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 GetNormalizedFloatValueAt, 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 a value less than −1.0e38. Valid values are still returned for the other positions.
Currently, only the GdalDataSet can read Offset and Scale from metadata. If the dataset cannot read Offset and Scale, this method will throw an exception, so you must instead call GetFloatValuesAt and use the Offset and Scale in application code (if you know them).
Example
// Get the normalized float values for the given coordinates
public static FloatCollection GetNormalizedFloatValuesAt(
DataSet dataSet, IEnumerable<Point> wgs84LongLatPointCollection)
{
// Project the coordinates to the Crs of the DataSet
PointCollection projectedPointCollection =
Crs.Wgs84LongLat.ProjectTo(dataSet.Crs, wgs84LongLatPointCollection);
// Get the normalized float values at the given coordinates and return it
// GetNormalizedFloatValuesAt does not throw exceptions if no data is found
// for a specified coordinate. Instead the returned value for that particular
// point is set to a value less than -1.0e38. Valid values are still returned
// for the other coordinates.
return dataSet.GetNormalizedFloatValuesAt(projectedPointCollection);
}
GetNormalizedFloatValuesAt(IEnumerable< Point > points, RasterFilter rasterFilter)
Gets a number of raster values at the specified positions, normalized by Scale and Offset, using a given interpolation method.Syntax
public FloatCollection GetNormalizedFloatValuesAt (
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
For each raster cell value c at the specified positions, the normalized value c * Scale + Offset.
Remarks
This method works only if the dataset can read Scale and Offset from metadata.
The method is similar to GetNormalizedFloatValueAt, 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 GetNormalizedFloatValueAt, 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 a value less than −1.0e38. Valid values are still returned for the other positions.
Currently, only the GdalDataSet can read Offset and Scale from metadata. If the dataset cannot read Offset and Scale, this method will throw an exception, so you must instead call GetFloatValuesAt and use the Offset and Scale in application code (if you know them).
Platforms
Windows, Linux, Android