mil.nga.geopackage.extension.elevation

Class ElevationTilesCore<TImage extends ElevationImage>

java.lang.Object

mil.nga.geopackage.extension.BaseExtension

mil.nga.geopackage.extension.elevation.ElevationTilesCore<TImage>

public abstract class ElevationTilesCore<TImage extends ElevationImage>
extends BaseExtension

Tiled Gridded Elevation Core Data Extension

Since:

1.2.1

Author:

osbornb

Field Summary

Fields

Modifier and Type	Field and Description
protected ElevationTilesAlgorithm	algorithm Interpolation algorithm
protected BoundingBox	elevationBoundingBox Elevations bounding box
protected Projection	elevationProjection Projection of the elevations
static String	EXTENSION_AUTHOR Extension author
static String	EXTENSION_DEFINITION Extension definition URL
static String	EXTENSION_NAME Extension, with author and name
static String	EXTENSION_NAME_NO_AUTHOR Extension name without the author
protected Integer	height Elevation results height
protected Projection	requestProjection Projection of the requests
protected boolean	sameProjection Flag indicating the elevation and request projections are the same
protected Integer	width Elevation results width
protected boolean	zoomIn True if zooming in should be performed to find a tile matrix with elevation values
protected boolean	zoomInBeforeOut True if zoom in in before zooming out, false to zoom out first
protected boolean	zoomOut True if zooming out should be performed to find a tile matrix with elevation values

Fields inherited from class mil.nga.geopackage.extension.BaseExtension

extensionsDao, geoPackage

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	ElevationTilesCore(GeoPackageCore geoPackage, TileMatrixSet tileMatrixSet) Constructor for creating extension rows when creating a new elevation tile table
protected	ElevationTilesCore(GeoPackageCore geoPackage, TileMatrixSet tileMatrixSet, Integer width, Integer height, Projection requestProjection) Constructor

Method Summary

Modifier and Type	Method and Description
static TileMatrixSet	createTileTableWithMetadata(GeoPackageCore geoPackage, String tableName, BoundingBox contentsBoundingBox, long contentsSrsId, BoundingBox tileMatrixSetBoundingBox, long tileMatrixSetSrsId) Create the elevation tile table with metadata
protected Double[][]	formatUnboundedResults(TileMatrix tileMatrix, Map<Long,Map<Long,Double[][]>> rowsMap, int tileCount, long minRow, long maxRow, long minColumn, long maxColumn) Format the unbounded results from elevation tiles into a single double array of elevation
ElevationTilesAlgorithm	getAlgorithm() Get the interpolation algorithm
protected Double	getBicubicInterpolationElevation(Double[][] values, ElevationSourcePixel sourcePixelX, ElevationSourcePixel sourcePixelY) Get the bicubic interpolation elevation from the 4 x 4 elevation values
protected Double	getBicubicInterpolationElevation(Double[][] values, float offsetX, float offsetY) Get the bicubic interpolation elevation from the 4 x 4 elevation values
protected Double	getBicubicInterpolationElevation(GriddedTile griddedTile, TImage image, Double[][] leftLastColumns, Double[][] topLeftRows, Double[][] topRows, int y, int x, float widthRatio, float heightRatio, float destTop, float destLeft, float srcTop, float srcLeft) Get the bicubic interpolation elevation
protected Double	getBilinearInterpolationElevation(ElevationSourcePixel sourcePixelX, ElevationSourcePixel sourcePixelY, Double[][] values) Get the Bilinear Interpolation elevation value
protected Double	getBilinearInterpolationElevation(float offsetX, float offsetY, float minX, float maxX, float minY, float maxY, Double[][] values) Get the Bilinear Interpolation elevation value
protected Double	getBilinearInterpolationElevation(float offsetX, float offsetY, float minX, float maxX, float minY, float maxY, Double topLeft, Double topRight, Double bottomLeft, Double bottomRight) Get the Bilinear Interpolation elevation value
protected Double	getBilinearInterpolationElevation(GriddedTile griddedTile, TImage image, Double[][] leftLastColumns, Double[][] topLeftRows, Double[][] topRows, int y, int x, float widthRatio, float heightRatio, float destTop, float destLeft, float srcTop, float srcLeft) Get the bilinear interpolation elevation
protected Double	getCubicInterpolationElevation(Double[] values, double offset) Interpolate 4 values using the offset between value1 and value2
protected Double	getCubicInterpolationElevation(Double value0, Double value1, Double value2, Double value3, double offset) Interpolate 4 values using the offset between value1 and value2
Double	getDataNull() Get the data null value
Double	getElevation(double latitude, double longitude) Get the elevation at the coordinate
BoundingBox	getElevationBoundingBox() Get the elevation bounding box
Projection	getElevationProjection() Get the elevation projection
ElevationTileResults	getElevations(BoundingBox requestBoundingBox) Get the elevation values within the bounding box
ElevationTileResults	getElevations(BoundingBox requestBoundingBox, Integer width, Integer height) Get the elevation values within the bounding box with the requested width and height result size
ElevationTileResults	getElevations(ElevationRequest request) Get the requested elevation values
abstract ElevationTileResults	getElevations(ElevationRequest request, Integer width, Integer height) Get the requested elevation values with the requested width and height
ElevationTileResults	getElevationsUnbounded(BoundingBox requestBoundingBox) Get the unbounded elevation values within the bounding box.
abstract ElevationTileResults	getElevationsUnbounded(ElevationRequest request) Get the requested unbounded elevation values.
Double	getElevationValue(GriddedTile griddedTile, float pixelValue) Get the elevation value for the pixel value
Double	getElevationValue(GriddedTile griddedTile, int unsignedPixelValue) Get the elevation value for the unsigned short pixel value
Double	getElevationValue(GriddedTile griddedTile, short pixelValue) Get the elevation value for the "unsigned short" pixel value
abstract Double	getElevationValue(GriddedTile griddedTile, TImage image, int x, int y) Get the elevation value from the image at the coordinate
Double[]	getElevationValues(GriddedTile griddedTile, float[] pixelValues) Get the elevation values from the pixel values
Double[]	getElevationValues(GriddedTile griddedTile, int[] unsignedPixelValues) Get the elevation values from the "unsigned short" pixel values
Double[]	getElevationValues(GriddedTile griddedTile, short[] pixelValues) Get the elevation values from the "unsigned short" pixel values
float	getFloatPixelValue(GriddedTile griddedTile, Double elevation) Get the pixel value of the elevation
GriddedCoverage	getGriddedCoverage() Get the gridded coverage
GriddedCoverageDao	getGriddedCoverageDao() Get the Gridded Coverage DAO
List<GriddedTile>	getGriddedTile() Get the gridded tile
GriddedTile	getGriddedTile(long tileId) Get the gridded tile by id
GriddedTileDao	getGriddedTileDao() Get the Gridded Tile DAO
Integer	getHeight() Get the requested elevation height
protected Double	getNearestNeighborElevation(GriddedTile griddedTile, TImage image, Double[][] leftLastColumns, Double[][] topLeftRows, Double[][] topRows, int y, int x, float widthRatio, float heightRatio, float destTop, float destLeft, float srcTop, float srcLeft) Get the nearest neighbor elevation
protected List<int[]>	getNearestNeighbors(float xSource, float ySource) Determine the nearest neighbors of the source pixel, sorted by closest to farthest neighbor
List<Extensions>	getOrCreate() Get or create the extension
float	getPixelValue(float[] pixelValues, int width, int x, int y) Get the pixel value at the coordinate from the pixel values
short	getPixelValue(GriddedTile griddedTile, Double elevation) Get the "unsigned short" pixel value of the elevation
short	getPixelValue(int unsignedPixelValue) Get the "unsigned short" value from the unsigned 16 bit integer pixel value
short	getPixelValue(short[] pixelValues, int width, int x, int y) Get the pixel value as an "unsigned short" at the coordinate from the "unsigned short" pixel values
Projection	getRequestProjection() Get the request projection
protected ElevationSourcePixel	getSourceMinAndMax(float source) Get the min, max, and offset of the source pixel
static List<String>	getTables(GeoPackageCore geoPackage) Get the elevation tile tables
TileMatrixSet	getTileMatrixSet() Get the Tile Matrix Set
int	getUnsignedPixelValue(GriddedTile griddedTile, Double elevation) Get the unsigned 16 bit integer pixel value of the elevation
int	getUnsignedPixelValue(int[] unsignedPixelValues, int width, int x, int y) Get the pixel value as a 16 bit unsigned value at the coordinate from the 16 bit unsigned pixel values
int	getUnsignedPixelValue(short pixelValue) Get the unsigned pixel value.
int	getUnsignedPixelValue(short[] pixelValues, int width, int x, int y) Get the pixel value as a 16 bit unsigned value as an integer
int[]	getUnsignedPixelValues(short[] pixelValues) Get the unsigned pixel values.
Integer	getWidth() Get the requested elevation width
protected float	getXSource(int x, float destLeft, float srcLeft, float widthRatio) Determine the x source pixel location
protected float	getYSource(int y, float destTop, float srcTop, float heightRatio) Determine the y source pixel location
boolean	has() Determine if the Tile Matrix Set has the extension
boolean	isDataNull(double value) Check the pixel value to see if it is the null equivalent
boolean	isSameProjection() Is the request and elevation projection the same
boolean	isZoomIn() Is the zooming in (higher zoom level values) enabled to find matching elevations
boolean	isZoomInBeforeOut() Is zooming in (when enabled) performed before zooming out (when enabled)
boolean	isZoomOut() Is the zooming out (lower zoom level values) enabled to find matching elevations
protected BoundingBox	padBoundingBox(TileMatrix tileMatrix, BoundingBox boundingBox, int overlap) Pad the bounding box with extra space for the overlapping pixels
GriddedCoverage	queryGriddedCoverage() Query and updated the gridded coverage
protected Double[][]	reprojectElevations(Double[][] elevations, int requestedElevationsWidth, int requestedElevationsHeight, BoundingBox requestBoundingBox, ProjectionTransform transformRequestToElevation, BoundingBox elevationBoundingBox) Reproject the elevations to the requested projection
void	setAlgorithm(ElevationTilesAlgorithm algorithm) Set the interpolation algorithm
void	setHeight(Integer height) Set the requested elevation height
void	setWidth(Integer width) Set the requested elevation width
void	setZoomIn(boolean zoomIn) Set the zoom in enabled state
void	setZoomInBeforeOut(boolean zoomInBeforeOut) Set the zoom order between in and out
void	setZoomOut(boolean zoomOut) Set the zoom out enabled state

Methods inherited from class mil.nga.geopackage.extension.BaseExtension

get, getExtensionsDao, getGeoPackage, getOrCreate, has

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

EXTENSION_AUTHOR

public static final String EXTENSION_AUTHOR

Extension author

See Also:

Constant Field Values

EXTENSION_NAME_NO_AUTHOR

public static final String EXTENSION_NAME_NO_AUTHOR

Extension name without the author

See Also:

Constant Field Values

EXTENSION_NAME

public static final String EXTENSION_NAME

Extension, with author and name

EXTENSION_DEFINITION

public static final String EXTENSION_DEFINITION

Extension definition URL

width

protected Integer width

Elevation results width

height

protected Integer height

Elevation results height

requestProjection

protected final Projection requestProjection

Projection of the requests

elevationProjection

protected final Projection elevationProjection

Projection of the elevations

elevationBoundingBox

protected final BoundingBox elevationBoundingBox

Elevations bounding box

sameProjection

protected final boolean sameProjection

Flag indicating the elevation and request projections are the same

zoomIn

protected boolean zoomIn

True if zooming in should be performed to find a tile matrix with elevation values

zoomOut

protected boolean zoomOut

True if zooming out should be performed to find a tile matrix with elevation values

zoomInBeforeOut

protected boolean zoomInBeforeOut

True if zoom in in before zooming out, false to zoom out first

algorithm

protected ElevationTilesAlgorithm algorithm

Interpolation algorithm

Constructor Detail

ElevationTilesCore

protected ElevationTilesCore(GeoPackageCore geoPackage,
                             TileMatrixSet tileMatrixSet,
                             Integer width,
                             Integer height,
                             Projection requestProjection)

Constructor

Parameters:

geoPackage - GeoPackage

tileMatrixSet - tile matrix set

width - specified results width

height - specified results height

requestProjection - request projection

ElevationTilesCore

protected ElevationTilesCore(GeoPackageCore geoPackage,
                             TileMatrixSet tileMatrixSet)

Constructor for creating extension rows when creating a new elevation tile table

Parameters:

geoPackage - GeoPackage

tileMatrixSet - tile matrix set

Method Detail

getElevationValue

public abstract Double getElevationValue(GriddedTile griddedTile,
                                         TImage image,
                                         int x,
                                         int y)

Get the elevation value from the image at the coordinate

Parameters:

griddedTile - gridded tile

image - elevation image

x - x coordinate

y - y coordinate

Returns:

elevation

getElevations

public abstract ElevationTileResults getElevations(ElevationRequest request,
                                                   Integer width,
                                                   Integer height)

Get the requested elevation values with the requested width and height

Parameters:

request - elevation request

width - elevation request width

height - elevation request height

Returns:

elevation results

getElevationsUnbounded

public abstract ElevationTileResults getElevationsUnbounded(ElevationRequest request)

Get the requested unbounded elevation values. Unbounded results retrieves and returns each elevation pixel. The results size equals the width and height of all matching pixels.

Parameters:

request - elevation request

Returns:

elevation results

getTileMatrixSet

public TileMatrixSet getTileMatrixSet()

Get the Tile Matrix Set

Returns:

Tile Matrix Set

getGriddedCoverageDao

public GriddedCoverageDao getGriddedCoverageDao()

Get the Gridded Coverage DAO

Returns:

Gridded Coverage DAO

getGriddedTileDao

public GriddedTileDao getGriddedTileDao()

Get the Gridded Tile DAO

Returns:

Gridded Tile DAO

getWidth

public Integer getWidth()

Get the requested elevation width

Returns:

width

setWidth

public void setWidth(Integer width)

Set the requested elevation width

Parameters:

width - requested elevation width

getHeight

public Integer getHeight()

Get the requested elevation height

Returns:

height

setHeight

public void setHeight(Integer height)

Set the requested elevation height

Parameters:

height - requested elevation height

getRequestProjection

public Projection getRequestProjection()

Get the request projection

Returns:

request projection

getElevationProjection

public Projection getElevationProjection()

Get the elevation projection

Returns:

elevation projection

getElevationBoundingBox

public BoundingBox getElevationBoundingBox()

Get the elevation bounding box

Returns:

elevation bounding box

isSameProjection

public boolean isSameProjection()

Is the request and elevation projection the same

Returns:

true if the same

isZoomIn

public boolean isZoomIn()

Is the zooming in (higher zoom level values) enabled to find matching elevations

Returns:

true if zoom in enabled

setZoomIn

public void setZoomIn(boolean zoomIn)

Set the zoom in enabled state

Parameters:

zoomIn - true to zoom in when finding elevations, false to disable

isZoomOut

public boolean isZoomOut()

Is the zooming out (lower zoom level values) enabled to find matching elevations

Returns:

true if zoom out enabled

setZoomOut

public void setZoomOut(boolean zoomOut)

Set the zoom out enabled state

Parameters:

zoomOut - true to zoom out when finding elevations, false to disable

isZoomInBeforeOut

public boolean isZoomInBeforeOut()

Is zooming in (when enabled) performed before zooming out (when enabled)

Returns:

true to zoom in for results first, false to zoom out for results first

setZoomInBeforeOut

public void setZoomInBeforeOut(boolean zoomInBeforeOut)

Set the zoom order between in and out

Parameters:

zoomInBeforeOut - true to zoom in for results first, false to zoom out first

getAlgorithm

public ElevationTilesAlgorithm getAlgorithm()

Get the interpolation algorithm

Returns:

algorithm

setAlgorithm

public void setAlgorithm(ElevationTilesAlgorithm algorithm)

Set the interpolation algorithm

Parameters:

algorithm - algorithm type

getOrCreate

public List<Extensions> getOrCreate()

Get or create the extension

Returns:

extensions list

has

public boolean has()

Determine if the Tile Matrix Set has the extension

Returns:

true if has extension

getGriddedCoverage

public GriddedCoverage getGriddedCoverage()

Get the gridded coverage

Returns:

gridded coverage

queryGriddedCoverage

public GriddedCoverage queryGriddedCoverage()

Query and updated the gridded coverage

Returns:

gridded coverage

getGriddedTile

public List<GriddedTile> getGriddedTile()

Get the gridded tile

Returns:

gridded tiles

getGriddedTile

public GriddedTile getGriddedTile(long tileId)

Get the gridded tile by id

Parameters:

tileId - tile id

Returns:

gridded tile

getDataNull

public Double getDataNull()

Get the data null value

Returns:

data null value or null

isDataNull

public boolean isDataNull(double value)

Check the pixel value to see if it is the null equivalent

Parameters:

value - pixel value

Returns:

true if equivalent to data null

getTables

public static List<String> getTables(GeoPackageCore geoPackage)

Get the elevation tile tables

Parameters:

geoPackage - GeoPackage

Returns:

table names

reprojectElevations

protected Double[][] reprojectElevations(Double[][] elevations,
                                         int requestedElevationsWidth,
                                         int requestedElevationsHeight,
                                         BoundingBox requestBoundingBox,
                                         ProjectionTransform transformRequestToElevation,
                                         BoundingBox elevationBoundingBox)

Reproject the elevations to the requested projection

Parameters:

elevations - elevations

requestedElevationsWidth - requested elevations width

requestedElevationsHeight - requested elevations height

requestBoundingBox - request bounding box in the request projection

transformRequestToElevation - transformation from request to elevations

elevationBoundingBox - elevations bounding box

Returns:

projected elevations

formatUnboundedResults

protected Double[][] formatUnboundedResults(TileMatrix tileMatrix,
                                            Map<Long,Map<Long,Double[][]>> rowsMap,
                                            int tileCount,
                                            long minRow,
                                            long maxRow,
                                            long minColumn,
                                            long maxColumn)

Format the unbounded results from elevation tiles into a single double array of elevation

Parameters:

tileMatrix - tile matrix

rowsMap - rows map

tileCount - tile count

minRow - min row

maxRow - max row

minColumn - min column

maxColumn - max column

Returns:

elevations

getXSource

protected float getXSource(int x,
                           float destLeft,
                           float srcLeft,
                           float widthRatio)

Determine the x source pixel location

Parameters:

x - x pixel

destLeft - destination left most pixel

srcLeft - source left most pixel

widthRatio - source over destination width radio

Returns:

x source pixel

getYSource

protected float getYSource(int y,
                           float destTop,
                           float srcTop,
                           float heightRatio)

Determine the y source pixel location

Parameters:

y - y pixel

destTop - destination top most pixel

srcTop - source top most pixel

heightRatio - source over destination height radio

Returns:

y source pixel

getNearestNeighbors

protected List<int[]> getNearestNeighbors(float xSource,
                                          float ySource)

Determine the nearest neighbors of the source pixel, sorted by closest to farthest neighbor

Parameters:

xSource - x source pixel

ySource - y source pixel

Returns:

nearest neighbor pixels

getSourceMinAndMax

protected ElevationSourcePixel getSourceMinAndMax(float source)

Get the min, max, and offset of the source pixel

Parameters:

source - source pixel

Returns:

source pixel information

getBilinearInterpolationElevation

protected Double getBilinearInterpolationElevation(ElevationSourcePixel sourcePixelX,
                                                   ElevationSourcePixel sourcePixelY,
                                                   Double[][] values)

Get the Bilinear Interpolation elevation value

Parameters:

sourcePixelX - source pixel x

sourcePixelY - source pixel y

values - 2 x 2 elevation values as [y][x]

Returns:

elevation

getBilinearInterpolationElevation

protected Double getBilinearInterpolationElevation(float offsetX,
                                                   float offsetY,
                                                   float minX,
                                                   float maxX,
                                                   float minY,
                                                   float maxY,
                                                   Double[][] values)

Get the Bilinear Interpolation elevation value

Parameters:

offsetX - x source pixel offset

offsetY - y source pixel offset

minX - min x value

maxX - max x value

minY - min y value

maxY - max y value

values - 2 x 2 elevation values as [y][x]

Returns:

elevation

getBilinearInterpolationElevation

protected Double getBilinearInterpolationElevation(float offsetX,
                                                   float offsetY,
                                                   float minX,
                                                   float maxX,
                                                   float minY,
                                                   float maxY,
                                                   Double topLeft,
                                                   Double topRight,
                                                   Double bottomLeft,
                                                   Double bottomRight)

Get the Bilinear Interpolation elevation value

Parameters:

offsetX - x source pixel offset

offsetY - y source pixel offset

minX - min x value

maxX - max x value

minY - min y value

maxY - max y value

topLeft - top left elevation

topRight - top right elevation

bottomLeft - bottom left elevation

bottomRight - bottom right elevation

Returns:

elevation

getBicubicInterpolationElevation

protected Double getBicubicInterpolationElevation(Double[][] values,
                                                  ElevationSourcePixel sourcePixelX,
                                                  ElevationSourcePixel sourcePixelY)

Get the bicubic interpolation elevation from the 4 x 4 elevation values

Parameters:

values - elevation values

sourcePixelX - source pixel x

sourcePixelY - source pixel y

Returns:

bicubic elevation

getBicubicInterpolationElevation

protected Double getBicubicInterpolationElevation(Double[][] values,
                                                  float offsetX,
                                                  float offsetY)

Get the bicubic interpolation elevation from the 4 x 4 elevation values

Parameters:

values - elevation values

offsetX - x source pixel offset

offsetY - y source pixel offset

Returns:

bicubic elevation

getCubicInterpolationElevation

protected Double getCubicInterpolationElevation(Double[] values,
                                                double offset)

Interpolate 4 values using the offset between value1 and value2

Parameters:

values - elevation values

offset - offset between the middle two pixels

Returns:

value elevation value

getCubicInterpolationElevation

protected Double getCubicInterpolationElevation(Double value0,
                                                Double value1,
                                                Double value2,
                                                Double value3,
                                                double offset)

Interpolate 4 values using the offset between value1 and value2

Parameters:

value0 - index 0 value

value1 - index 1 value

value2 - index 2 value

value3 - index 3 value

offset - offset between the middle two pixels

Returns:

value elevation value

padBoundingBox

protected BoundingBox padBoundingBox(TileMatrix tileMatrix,
                                     BoundingBox boundingBox,
                                     int overlap)

Pad the bounding box with extra space for the overlapping pixels

Parameters:

tileMatrix - tile matrix

boundingBox - bounding box

overlap - overlapping pixels

Returns:

padded bounding box

getPixelValue

public short getPixelValue(short[] pixelValues,
                           int width,
                           int x,
                           int y)

Get the pixel value as an "unsigned short" at the coordinate from the "unsigned short" pixel values

Parameters:

pixelValues - "unsigned short" pixel values

width - image width

x - x coordinate

y - y coordinate

Returns:

"unsigned short" pixel value

getUnsignedPixelValue

public int getUnsignedPixelValue(short[] pixelValues,
                                 int width,
                                 int x,
                                 int y)

Get the pixel value as a 16 bit unsigned value as an integer

Parameters:

pixelValues - "unsigned short" pixel values

width - image width

x - x coordinate

y - y coordinate

Returns:

unsigned int pixel value

getUnsignedPixelValue

public int getUnsignedPixelValue(int[] unsignedPixelValues,
                                 int width,
                                 int x,
                                 int y)

Get the pixel value as a 16 bit unsigned value at the coordinate from the 16 bit unsigned pixel values

Parameters:

unsignedPixelValues - unsigned int pixel values

width - image width

x - x coordinate

y - y coordinate

Returns:

16 bit unsigned pixel value

getUnsignedPixelValue

public int getUnsignedPixelValue(short pixelValue)

Get the unsigned pixel value. The value saved as an "unsigned short" in the short is returned as an integer which stores the positive 16 bit value

Parameters:

pixelValue - "unsigned short" pixel value

Returns:

unsigned 16 bit pixel value as an integer

getPixelValue

public short getPixelValue(int unsignedPixelValue)

Get the "unsigned short" value from the unsigned 16 bit integer pixel value

Parameters:

unsignedPixelValue - unsigned 16 bit integer pixel value

Returns:

"unsigned short" pixel value

getUnsignedPixelValues

public int[] getUnsignedPixelValues(short[] pixelValues)

Get the unsigned pixel values. The values saved as "unsigned shorts" in the short array is returned as an integer which stores the positive 16 bit value

Parameters:

pixelValues - pixel values as "unsigned shorts"

Returns:

unsigned 16 bit pixel values as an integer array

getElevationValue

public Double getElevationValue(GriddedTile griddedTile,
                                short pixelValue)

Get the elevation value for the "unsigned short" pixel value

Parameters:

griddedTile - gridded tile

pixelValue - pixel value as an unsigned short

Returns:

elevation value

getElevationValue

public Double getElevationValue(GriddedTile griddedTile,
                                int unsignedPixelValue)

Get the elevation value for the unsigned short pixel value

Parameters:

griddedTile - gridded tile

unsignedPixelValue - pixel value as an unsigned 16 bit integer

Returns:

elevation value

getElevationValues

public Double[] getElevationValues(GriddedTile griddedTile,
                                   short[] pixelValues)

Get the elevation values from the "unsigned short" pixel values

Parameters:

griddedTile - gridded tile

pixelValues - pixel values as "unsigned shorts"

Returns:

elevation values

getElevationValues

public Double[] getElevationValues(GriddedTile griddedTile,
                                   int[] unsignedPixelValues)

Get the elevation values from the "unsigned short" pixel values

Parameters:

griddedTile - gridded tile

unsignedPixelValues - pixel values as 16 bit integers

Returns:

elevation values

createTileTableWithMetadata

public static TileMatrixSet createTileTableWithMetadata(GeoPackageCore geoPackage,
                                                        String tableName,
                                                        BoundingBox contentsBoundingBox,
                                                        long contentsSrsId,
                                                        BoundingBox tileMatrixSetBoundingBox,
                                                        long tileMatrixSetSrsId)

Create the elevation tile table with metadata

Parameters:

geoPackage -

tableName -

contentsBoundingBox -

contentsSrsId -

tileMatrixSetBoundingBox -

tileMatrixSetSrsId -

getUnsignedPixelValue

public int getUnsignedPixelValue(GriddedTile griddedTile,
                                 Double elevation)

Get the unsigned 16 bit integer pixel value of the elevation

Parameters:

griddedTile - gridded tile

elevation - elevation value

Returns:

16 bit integer pixel value

getPixelValue

public short getPixelValue(GriddedTile griddedTile,
                           Double elevation)

Get the "unsigned short" pixel value of the elevation

Parameters:

griddedTile - gridded tile

elevation - elevation value

Returns:

"unsigned short" pixel value

getPixelValue

public float getPixelValue(float[] pixelValues,
                           int width,
                           int x,
                           int y)

Get the pixel value at the coordinate from the pixel values

Parameters:

pixelValues - pixel values

width - image width

x - x coordinate

y - y coordinate

Returns:

pixel value

getElevationValue

public Double getElevationValue(GriddedTile griddedTile,
                                float pixelValue)

Get the elevation value for the pixel value

Parameters:

griddedTile - gridded tile

pixelValue - pixel value

Returns:

elevation value

getElevationValues

public Double[] getElevationValues(GriddedTile griddedTile,
                                   float[] pixelValues)

Get the elevation values from the pixel values

Parameters:

griddedTile - gridded tile

pixelValues - pixel values

Returns:

elevation values

getFloatPixelValue

public float getFloatPixelValue(GriddedTile griddedTile,
                                Double elevation)

Get the pixel value of the elevation

Parameters:

griddedTile - gridded tile

elevation - elevation value

Returns:

pixel value

getElevation

public Double getElevation(double latitude,
                           double longitude)

Get the elevation at the coordinate

Parameters:

latitude - latitude

longitude - longitude

Returns:

elevation value

getElevations

public ElevationTileResults getElevations(BoundingBox requestBoundingBox)

Get the elevation values within the bounding box

Parameters:

requestBoundingBox - request bounding box

Returns:

elevation results

getElevations

public ElevationTileResults getElevations(BoundingBox requestBoundingBox,
                                          Integer width,
                                          Integer height)

Get the elevation values within the bounding box with the requested width and height result size

Parameters:

requestBoundingBox - request bounding box

width - elevation request width

height - elevation request height

Returns:

elevation results

getElevations

public ElevationTileResults getElevations(ElevationRequest request)

Get the requested elevation values

Parameters:

request - elevation request

Returns:

elevation results

getElevationsUnbounded

public ElevationTileResults getElevationsUnbounded(BoundingBox requestBoundingBox)

Get the unbounded elevation values within the bounding box. Unbounded results retrieves and returns each elevation pixel. The results size equals the width and height of all matching pixels.

Parameters:

requestBoundingBox - request bounding box

Returns:

elevation results

getBilinearInterpolationElevation

protected Double getBilinearInterpolationElevation(GriddedTile griddedTile,
                                                   TImage image,
                                                   Double[][] leftLastColumns,
                                                   Double[][] topLeftRows,
                                                   Double[][] topRows,
                                                   int y,
                                                   int x,
                                                   float widthRatio,
                                                   float heightRatio,
                                                   float destTop,
                                                   float destLeft,
                                                   float srcTop,
                                                   float srcLeft)

Get the bilinear interpolation elevation

Parameters:

griddedTile - gridded tile

image - image

leftLastColumns - last columns in the tile to the left

topLeftRows - last rows of the tile to the top left

topRows - last rows of the tile to the top

y - y coordinate

x - x coordinate

widthRatio - width source over destination ratio

heightRatio - height source over destination ratio

destTop - destination top most pixel

destLeft - destination left most pixel

srcTop - source top most pixel

srcLeft - source left most pixel

Returns:

bilinear elevation

getBicubicInterpolationElevation

protected Double getBicubicInterpolationElevation(GriddedTile griddedTile,
                                                  TImage image,
                                                  Double[][] leftLastColumns,
                                                  Double[][] topLeftRows,
                                                  Double[][] topRows,
                                                  int y,
                                                  int x,
                                                  float widthRatio,
                                                  float heightRatio,
                                                  float destTop,
                                                  float destLeft,
                                                  float srcTop,
                                                  float srcLeft)

Get the bicubic interpolation elevation

Parameters:

griddedTile - gridded tile

image - image

leftLastColumns - last columns in the tile to the left

topLeftRows - last rows of the tile to the top left

topRows - last rows of the tile to the top

y - y coordinate

x - x coordinate

widthRatio - width source over destination ratio

heightRatio - height source over destination ratio

destTop - destination top most pixel

destLeft - destination left most pixel

srcTop - source top most pixel

srcLeft - source left most pixel

Returns:

bicubic elevation

getNearestNeighborElevation

protected Double getNearestNeighborElevation(GriddedTile griddedTile,
                                             TImage image,
                                             Double[][] leftLastColumns,
                                             Double[][] topLeftRows,
                                             Double[][] topRows,
                                             int y,
                                             int x,
                                             float widthRatio,
                                             float heightRatio,
                                             float destTop,
                                             float destLeft,
                                             float srcTop,
                                             float srcLeft)

Get the nearest neighbor elevation

Parameters:

griddedTile - gridded tile

image - image

leftLastColumns - last columns in the tile to the left

topLeftRows - last rows of the tile to the top left

topRows - last rows of the tile to the top

y - y coordinate

x - x coordinate

widthRatio - width source over destination ratio

heightRatio - height source over destination ratio

destTop - destination top most pixel

destLeft - destination left most pixel

srcTop - source top most pixel

srcLeft - source left most pixel

Returns:

nearest neighbor elevation