public class SdoGeorPKG
extends java.lang.Object
Note that all methods in this class are transactional, which means that no commit statement is issued implicitly in each method.
The following is an example of how to use this class:
//initialize an instance of SdoGeorPKG SdoGeorPKG pkg=new SdoGeorPKG(connection); //reading a GeoRaster object from database based on a query Statement stmt = connection.createStatement(); ResultSet rs = statement.executeQuery("SELECT a.georaster FROM georaster_table a where a.georaster.rasterdatatable='RDT' and a.georaster.rasterid=1"); rs.next(); STRUCT geor = (oracle.sql.STRUCT) rs.getObject(1); //convert STRUCT into SdoGeoRaster SdoGeoRaster sdoGeoRaster = new SdoGeoRaster(geor); //change cell value of the GeoRaster object pkg.changeCellValue(sdoGeoRaster,10,10,"1",10.0,null); //submit change connection.commit();
Modifier and Type | Class and Description |
---|---|
class |
SdoGeorPKG.SdoGeorGCP
SdoGeorGCP is a Java class which wraps PL/SQL type SDO_GEOR_GCP defined in the server-side
|
class |
SdoGeorPKG.SdoGeorGCPRefType
SdoGeorGCPRefType is a Java class which wraps PL/SQL type SDO_GEOR_GCPGEOREFTYPE defined in the server-side
|
Modifier and Type | Field and Description |
---|---|
long |
offset |
Constructor and Description |
---|
SdoGeorPKG(java.sql.Connection conn)
Constructs an
SdoGeorPKG object using the given connection. |
Modifier and Type | Method and Description |
---|---|
void |
affineTransform(SdoGeoRaster inGeoRaster, java.math.BigDecimal[] translation, double[] scales, java.math.BigDecimal[] rotatePoint, java.lang.Double rotateAngle, double[] shear, java.lang.Integer reflection, java.lang.String storageParam, SdoGeoRaster outGeoRaster, double[] bgValues, int parallelParam)
Apply affine geometric trasnformation on GeoRaster Objects
|
double |
calcCompressionRatio(SdoGeoRaster georaster)
Computes the compression ratio of the GeoRaster object.
|
void |
changeCellValue(SdoGeoRaster georaster, JGeometry window, java.lang.String layerNumbers, double newCellValue, double[] bgValues)
Changes the value of raster cells in a specified window of a GeoRaster object to a single new value.
|
void |
changeCellValue(SdoGeoRaster georaster, long startRow, long startColumn, long endRow, long endColumn, java.lang.String bandNumbers, double newCellValue, double[] bgValues)
Changes the value of raster cells in a specified window of a GeoRaster object to a single new value.
|
void |
changeCellValue(SdoGeoRaster georaster, long row, long column, java.lang.String bandNumbers, double newCellValue, double[] bgValues)
Changes the value of raster cell in a specified point of a GeoRaster object to a single new value.
|
void |
changeCellValues(SdoGeoRaster georaster, int[] rowNumbers, int[] colNumbers, int bandNumber, double[] newCellValues, double[] bgValues)
Changes the value of raster cells specified by row/column arrays or by a multipoint geometry to new values.
|
void |
changeCellValues(SdoGeoRaster georaster, JGeometry ptGeom, int layerNumber, double[] newCellValues, double[] bgValues)
Changes the value of raster cells specified by row/column arrays or by a multipoint geometry to new values.
|
void |
changeFormatCopy(SdoGeoRaster source, java.lang.String storageParam, SdoGeoRaster target, double[] bgValues)
Makes a copy of an existing GeoRaster object using a different storage format (for example, changing the blocking, cell depth, or interleaving).
|
void |
compressJP2(SdoGeoRaster inGeoRaster, java.lang.String compressParam, SdoGeoRaster outGeoRaster)
Compresses the image in a GeoRaster object using JPEG 2000 compression.
|
void |
copy(SdoGeoRaster source, SdoGeoRaster target)
Makes a copy of an existing GeoRaster object.
|
void |
createTemplate(SdoGeoRaster georaster, int rasterType, java.lang.String rasterSpec, java.lang.String maskLayers, java.lang.String initRDTEntry)
Populates a GeoRaster object with metadata of a general pattern, and optionally inserts entries with empty raster blocks into its raster data table.
|
void |
decompressJP2(SdoGeoRaster inGeoRaster, java.lang.Integer pyramidLevel, java.math.BigDecimal[] cropArea, java.lang.String layerNumbers, java.lang.String storageParam, SdoGeoRaster outGeoRaster)
Decompress the JPEG 2000 compressed GeoRaster image into a GeoRaster object.
|
void |
decompressJP2(SdoGeoRaster inGeoRaster, java.lang.Integer pyramidLevel, JGeometry cropArea, java.lang.String bandNumbers, java.lang.String storageParam, SdoGeoRaster outGeoRaster)
Decompress the JPEG 2000 compressed GeoRaster image into a GeoRaster object.
|
void |
deletePyramid(SdoGeoRaster georaster)
Deletes the pyramid data of a GeoRaster object.
|
java.math.BigDecimal[] |
evaluateDouble(SdoGeoRaster georaster, int pyramidLevel, int rowNumber, int colNumber, java.lang.String bands, java.lang.String interpolationMethod)
Evaluates a direct location using a specified interpolation method, and returns the raster values for the specified bands for that location.
|
java.math.BigDecimal[] |
evaluateDouble(SdoGeoRaster georaster, int pyramidLevel, JGeometry ptGeom, java.lang.String layers, java.lang.String interpolationMethod)
Evaluates a direct location using a specified interpolation method, and returns the raster values for the specified layers for that location.
|
java.math.BigDecimal[] |
evaluateDoubles(SdoGeoRaster georaster, int pyramidLevel, int[] rowNumbers, int[] colNumbers, int bandNumber, java.lang.String interpolationMethod)
Evaluates multiple locations using a specified interpolation method, and returns the raster values (double precision numbers) for the specified band or layer for those locations.
|
java.math.BigDecimal[] |
evaluateDoubles(SdoGeoRaster georaster, int pyramidLevel, JGeometry ptGeom, int layerNumber, java.lang.String interpolationMethod)
Returns the values of one or more cells located anywhere in the GeoRaster object by specifying its row/column/band numbers in its cell coordinate space, or by specifying a multipoint geometry in either model coordinate space or cell coordinate space and its logical layer number.
|
double |
generateAreaWeightedMean(SdoGeoRaster georaster, JGeometry window, java.lang.Integer bandNumber, boolean nodata)
Computes the area weighted mean value on a specified band of the input GeoRaster object.
|
void |
generateBitmapPyramid(SdoGeoRaster src_geor, SdoGeoRaster tmp_geor, SdoGeoRaster target_geor, java.lang.String pyramidParams, double[] bgValues, int parallelParam)
Generates pyramid data for a bitmap GeoRaster object.
|
void |
generateBlockMBR(SdoGeoRaster georaster)
Computes the minimum bounding rectangle (MBR) for each block in a GeoRaster object, and sets the blockMBR attribute for each raster block in the raster data table.
|
void |
generatePyramid(SdoGeoRaster georaster, java.lang.String pyramidParams, double[] bgValues)
Generates pyramid data, which is stored together with the original data.
|
JGeometry |
generateSpatialExtent(SdoGeoRaster georaster, java.lang.Double height)
Generates a Spatial geometry that contains the spatial extent (footprint) of the GeoRaster object.
|
java.math.BigDecimal[] |
generateSpatialResolutions(SdoGeoRaster geoRaster)
Sets the generated spatial resolutions in the metadata for the GeoRaster object.
|
java.math.BigDecimal[] |
generateSpatialResolutions(SdoGeoRaster geoRaster, long pyramidLevel, java.lang.Integer SRID, java.lang.String resolutionUnit)
Generates and returns the spatial resolutions based on the georeferencing information in the metadata for the GeoRaster object.
|
void |
generateStatistics(SdoGeoRaster georaster, int samplingFactor, JGeometry samplingWindow, boolean histogram, java.lang.String layerNumbers, boolean useBin, double[] binFunction, boolean nodata)
Computes and sets statistical data associated with one or more layers.
|
void |
generateStatistics(SdoGeoRaster georaster, int samplingFactor, long[] samplingWindow, boolean histogram, java.lang.String layerNumbers, boolean useBin, double[] binFunction, boolean nodata)
Computes and sets statistical data associated with one or more layers.
|
java.math.BigDecimal[] |
generateStatistics(SdoGeoRaster georaster, long pyramidLevel, int samplingFactor, JGeometry samplingWindow, java.lang.String bandNumbers, boolean nodata, boolean polygonClip)
Computes statistical data associated with one or more layers and pyramid levels.
|
java.math.BigDecimal[] |
generateStatistics(SdoGeoRaster georaster, long pyramidLevel, int samplingFactor, JGeometry samplingWindow, java.lang.String bandNumbers, boolean nodata, boolean polygonClip, int parallelDegree)
Computes statistical data associated with one or more layers and pyramid levels.
|
java.math.BigDecimal[] |
generateStatistics(SdoGeoRaster georaster, long pyramidLevel, int samplingFactor, long[] samplingWindow, java.lang.String bandNumbers, boolean nodata)
Computes statistical data associated with one or more layers and pyramid levels.
|
java.math.BigDecimal[] |
generateStatistics(SdoGeoRaster georaster, long pyramidLevel, int samplingFactor, long[] samplingWindow, java.lang.String bandNumbers, boolean nodata, int parallelDegree)
Computes statistical data associated with one or more layers and pyramid levels.
|
double |
generateStatisticsMax(SdoGeoRaster georaster, long pyramidLevel, int samplingFactor, JGeometry samplingWindow, java.lang.String bandNumbers, boolean nodata, boolean polygonClip)
Computes statistical data associated with one or more layers on a specified pyramid level, and returns the maximum value.
|
double |
generateStatisticsMax(SdoGeoRaster georaster, long pyramidLevel, int samplingFactor, JGeometry samplingWindow, java.lang.String bandNumbers, boolean nodata, boolean polygonClip, int parallelDegree)
Computes statistical data associated with one or more layers on a specified pyramid level, and returns the maximum value.
|
double |
generateStatisticsMax(SdoGeoRaster georaster, long pyramidLevel, int samplingFactor, long[] samplingWindow, java.lang.String bandNumbers, boolean nodata)
Computes statistical data associated with one or more layers on a specified pyramid level, and returns the maximum value.
|
double |
generateStatisticsMax(SdoGeoRaster georaster, long pyramidLevel, int samplingFactor, long[] samplingWindow, java.lang.String bandNumbers, boolean nodata, int parallelDegree)
Computes statistical data associated with one or more layers on a specified pyramid level, and returns the maximum value.
|
double |
generateStatisticsMean(SdoGeoRaster georaster, long pyramidLevel, int samplingFactor, JGeometry samplingWindow, java.lang.String bandNumbers, boolean nodata, boolean polygonClip)
Computes statistical data associated with one or more layers on a specified pyramid level, and returns the mean value.
|
double |
generateStatisticsMean(SdoGeoRaster georaster, long pyramidLevel, int samplingFactor, JGeometry samplingWindow, java.lang.String bandNumbers, boolean nodata, boolean polygonClip, int parallelDegree)
Computes statistical data associated with one or more layers on a specified pyramid level, and returns the mean value.
|
double |
generateStatisticsMean(SdoGeoRaster georaster, long pyramidLevel, int samplingFactor, long[] samplingWindow, java.lang.String bandNumbers, boolean nodata)
Computes statistical data associated with one or more layers on a specified pyramid level, and returns the mean value.
|
double |
generateStatisticsMean(SdoGeoRaster georaster, long pyramidLevel, int samplingFactor, long[] samplingWindow, java.lang.String bandNumbers, boolean nodata, int parallelDegree)
Computes statistical data associated with one or more layers on a specified pyramid level, and returns the mean value.
|
double |
generateStatisticsMedian(SdoGeoRaster georaster, long pyramidLevel, int samplingFactor, JGeometry samplingWindow, java.lang.String bandNumbers, boolean nodata, boolean polygonClip)
Computes statistical data associated with one or more layers on a specified pyramid level, and returns the median value.
|
double |
generateStatisticsMedian(SdoGeoRaster georaster, long pyramidLevel, int samplingFactor, JGeometry samplingWindow, java.lang.String bandNumbers, boolean nodata, boolean polygonClip, int parallelDegree)
Computes statistical data associated with one or more layers on a specified pyramid level, and returns the median value.
|
double |
generateStatisticsMedian(SdoGeoRaster georaster, long pyramidLevel, int samplingFactor, long[] samplingWindow, java.lang.String bandNumbers, boolean nodata)
Computes statistical data associated with one or more layers on a specified pyramid level, and returns the median value.
|
double |
generateStatisticsMedian(SdoGeoRaster georaster, long pyramidLevel, int samplingFactor, long[] samplingWindow, java.lang.String bandNumbers, boolean nodata, int parallelDegree)
Computes statistical data associated with one or more layers on a specified pyramid level, and returns the median value.
|
double |
generateStatisticsMin(SdoGeoRaster georaster, long pyramidLevel, int samplingFactor, JGeometry samplingWindow, java.lang.String bandNumbers, boolean nodata, boolean polygonClip)
Computes statistical data associated with one or more layers on a specified pyramid level, and returns the minimum value.
|
double |
generateStatisticsMin(SdoGeoRaster georaster, long pyramidLevel, int samplingFactor, JGeometry samplingWindow, java.lang.String bandNumbers, boolean nodata, boolean polygonClip, int parallelDegree)
Computes statistical data associated with one or more layers on a specified pyramid level, and returns the minimum value.
|
double |
generateStatisticsMin(SdoGeoRaster georaster, long pyramidLevel, int samplingFactor, long[] samplingWindow, java.lang.String bandNumbers, boolean nodata)
Computes statistical data associated with one or more layers on a specified pyramid level, and returns the minimum value.
|
double |
generateStatisticsMin(SdoGeoRaster georaster, long pyramidLevel, int samplingFactor, long[] samplingWindow, java.lang.String bandNumbers, boolean nodata, int parallelDegree)
Computes statistical data associated with one or more layers on a specified pyramid level, and returns the minimum value.
|
double |
generateStatisticsMode(SdoGeoRaster georaster, long pyramidLevel, int samplingFactor, JGeometry samplingWindow, java.lang.String bandNumbers, boolean nodata, boolean polygonClip)
Computes statistical data associated with one or more layers on a specified pyramid level, and returns the mode value.
|
double |
generateStatisticsMode(SdoGeoRaster georaster, long pyramidLevel, int samplingFactor, JGeometry samplingWindow, java.lang.String bandNumbers, boolean nodata, boolean polygonClip, int parallelDegree)
Computes statistical data associated with one or more layers on a specified pyramid level, and returns the mode value.
|
double |
generateStatisticsMode(SdoGeoRaster georaster, long pyramidLevel, int samplingFactor, long[] samplingWindow, java.lang.String bandNumbers, boolean nodata)
Computes statistical data associated with one or more layers on a specified pyramid level, and returns the mode value.
|
double |
generateStatisticsMode(SdoGeoRaster georaster, long pyramidLevel, int samplingFactor, long[] samplingWindow, java.lang.String bandNumbers, boolean nodata, int parallelDegree)
Computes statistical data associated with one or more layers on a specified pyramid level, and returns the mode value.
|
double |
generateStatisticsSTD(SdoGeoRaster georaster, long pyramidLevel, int samplingFactor, JGeometry samplingWindow, java.lang.String bandNumbers, boolean nodata, boolean polygonClip)
Computes statistical data associated with one or more layers on a specified pyramid level, and returns the STD value.
|
double |
generateStatisticsSTD(SdoGeoRaster georaster, long pyramidLevel, int samplingFactor, JGeometry samplingWindow, java.lang.String bandNumbers, boolean nodata, boolean polygonClip, int parallelDegree)
Computes statistical data associated with one or more layers on a specified pyramid level, and returns the STD value.
|
double |
generateStatisticsSTD(SdoGeoRaster georaster, long pyramidLevel, int samplingFactor, long[] samplingWindow, java.lang.String bandNumbers, boolean nodata)
Computes statistical data associated with one or more layers on a specified pyramid level, and returns the STD value.
|
double |
generateStatisticsSTD(SdoGeoRaster georaster, long pyramidLevel, int samplingFactor, long[] samplingWindow, java.lang.String bandNumbers, boolean nodata, int parallelDegree)
Computes statistical data associated with one or more layers on a specified pyramid level, and returns the STD value.
|
void |
georeference(SdoGeoRaster georaster, int srid, int modelCoordinateLocation, double[] xCoefficients, double[] yCoefficients)
Georeferences a GeoRaster object using specified cell-to-model transformation coefficients.
|
java.math.BigDecimal[] |
georeference(SdoGeoRaster georaster, SdoGeorPKG.SdoGeorGCPRefType gcpGeorefModel, java.lang.Boolean storeGCP, java.lang.Integer srid, java.lang.Integer modelCoordinateLocation, java.lang.String setResolution)
returns the solution of any one of the supported geometric models using ground control points (GCPs) that are specified in the parameters.
|
java.math.BigDecimal[] |
georeference(SdoGeoRaster georaster, java.lang.String FFMethodType, java.lang.Integer srid, java.lang.Integer modelCoordinateLocation, java.lang.String setResolution)
returns the solution of any one of the supported geometric models using ground control points (GCPs) that are stored in the database.
|
java.math.BigDecimal[] |
georeference(SdoGeoRaster georaster, java.lang.String FFMethodType, int nGCP, SdoGeorPKG.SdoGeorGCP[] gcps, java.lang.Boolean storeGCP, java.lang.Integer srid, java.lang.Integer modelCoordinateLocation, java.lang.String setResolution)
returns the solution of any one of the supported geometric models using ground control points (GCPs) that are specified in the parameters.
|
void |
getBitmapMask(SdoGeoRaster source, int layer, java.lang.String storageParam, SdoGeoRaster target)
Updates a specified pyramid of a specified area or the overlapping parts of one GeoRaster object with selected pyramid and selected bands or layers of another GeoRaster object.
|
double |
getBitmapMaskValue(SdoGeoRaster georaster, int pyramidLevel, int rowNumber, int colNumber, int bandNumber)
Gets the value of a single cell from a bitmap mask.
|
double |
getBitmapMaskValue(SdoGeoRaster georaster, JGeometry ptGeom, int pyramidLevel, int layerNumber)
Gets the value of a single cell from a bitmap mask.
|
java.math.BigDecimal[] |
getBitmapMaskValues(SdoGeoRaster georaster, int layerNumber, int pyramidLevel, int[] rowNumbers, int[] colNumbers)
Gets the values of multiple cells from a bitmap mask.
|
java.math.BigDecimal[] |
getBitmapMaskValues(SdoGeoRaster georaster, int layerNumber, int pyramidLevel, JGeometry ptGeom)
Gets the values of multiple cells from a bitmap mask.
|
double |
getCellValue(SdoGeoRaster georaster, int pyramidLevel, int rowNumber, int colNumber, int bandNumber)
Returns the value of a single cell located anywhere in the GeoRaster object by specifying its row, column, and band number in its cell coordinate system and its logical layer number.
|
java.math.BigDecimal[] |
getCellValue(SdoGeoRaster georaster, int pyramidLevel, int rowNumber, int colNumber, java.lang.String bands)
Returns the values of a single cell located anywhere in the GeoRaster object by specifying its row, column, and band numbers in its cell coordinate system.
|
java.math.BigDecimal[] |
getCellValue(SdoGeoRaster georaster, int pyramidLevel, JGeometry ptGeom, java.lang.String layers)
Returns the values of a single cell located anywhere in the GeoRaster object by specifying a point geometry in its model coordinate system and its logical layer numbers.
|
double |
getCellValue(SdoGeoRaster georaster, JGeometry ptGeom, int pyramidLevel, int layerNumber)
Returns the value of a single cell located anywhere in the GeoRaster object by specifying a point geometry in its model coordinate system and its logical layer number.
|
java.math.BigDecimal[] |
getCellValues(SdoGeoRaster georaster, int pyramidLevel, int[] rowNumbers, int[] colNumbers, int bandNumber)
Returns the values of one or more cells located anywhere in the GeoRaster object by specifying its row/column/band numbers in its cell coordinate space, or by specifying a multipoint geometry in either model coordinate space or cell coordinate space and its logical layer number.
|
java.math.BigDecimal[] |
getCellValues(SdoGeoRaster georaster, int pyramidLevel, JGeometry ptGeom, int layerNumber)
Returns the values of one or more cells located anywhere in the GeoRaster object by specifying its row/column/band numbers in its cell coordinate space, or by specifying a multipoint geometry in either model coordinate space or cell coordinate space and its logical layer number.
|
java.sql.Connection |
getConnection()
Returns a connection which points to target database.
|
int |
getGeoreferenceType(SdoGeoRaster georaster)
Returns a number that indicates the georeference type for a GeoRaster object.
|
java.sql.Blob |
getRasterBlockLocator(SdoGeoRaster geoRaster, long pyramidLevel, long bandBlockNumber, long rowBlockNumber, long columnBlockNumber, boolean isBitmapMask, boolean lock_for_write)
returns the LOB locator of a raster block by specifying the pyramidLevel, bandBlockNumber, rowBlockNumber, and columnBlockNumber parameters.
|
java.sql.Blob |
getRasterBlockLocator2(SdoGeoRaster geoRaster, long pyramidLevel, JGeometry ptGeom, long layerNumber, boolean isBitmapMask, boolean lock_for_write)
return the LOB locator of a raster block that contains a specific single cell and the offset of the cell within the raster block.
|
java.sql.Blob |
getRasterBlockLocator2(SdoGeoRaster geoRaster, long pyramidLevel, long rowNumber, long columnNumber, long bandNumber, boolean isBitmapMask, boolean lock_for_write)
return the LOB locator of a raster block that contains a specific single cell and the offset of the cell within the raster block.
|
double[] |
getRasterRange(SdoGeoRaster geoRaster, int layerNumber)
Gets the minimum and maximum cell values of a specified layer of a GeoRaster object or of the GeoRaster object itself (the object layer).
|
void |
mask(SdoGeoRaster inGeoRaster, java.lang.String bandNumbers, SdoGeoRaster mask, java.lang.String storageParam, SdoGeoRaster outGeoRaster, double zeroMapping, double oneMapping, double[] bgValues)
Applies a mask to specified layers of an existing (input) GeoRaster object.
|
void |
mergeLayers(SdoGeoRaster source, java.lang.String sourceLayerNumbers, SdoGeoRaster target, double[] bgValues)
Merges the layers of two GeoRaster objects, either by appending source layers to a target GeoRaster object (first format) or by performing a union operation.
|
void |
mergeLayers(SdoGeoRaster source1, java.lang.String source1LayerNumbers, SdoGeoRaster source2, java.lang.String source2LayerNumbers, java.lang.String storageParam, SdoGeoRaster target, double[] bgValues)
Merges the layers of two GeoRaster objects, either by appending source layers to a target GeoRaster object (first format) or by performing a union operation.
|
void |
mosaic(java.lang.String georasterTableName, java.lang.String georasterColumnName, SdoGeoRaster target, java.lang.String storageParam, double[] bgValues)
Mosaics GeoRaster objects into one GeoRaster object.
|
void |
rectify(SdoGeoRaster inGeoRaster, java.lang.Integer pyramidLevel, java.lang.String elevationParam, SdoGeoRaster dem, java.lang.Integer outSRID, java.lang.Integer outModelCoordLoc, JGeometry cropArea, boolean polygonClip, java.lang.String layerNumbers, double[] outResolutions, java.lang.String resolutionUnit, JGeometry referencePoint, java.lang.String resampleParam, java.lang.String storageParam, java.sql.Blob rasterBlob, JGeometry[] outArea, java.math.BigDecimal[] outWindow, double[] bgValues)
Perform rectification on all or part of a georeferenced GeoRaster object.
|
void |
rectify(SdoGeoRaster inGeoRaster, java.lang.Integer pyramidLevel, java.lang.String elevationParam, SdoGeoRaster dem, java.lang.Integer outSRID, java.lang.Integer outModelCoordLoc, JGeometry cropArea, boolean polygonClip, java.lang.String layerNumbers, double[] outResolutions, java.lang.String resolutionUnit, JGeometry referencePoint, java.lang.String resampleParam, java.lang.String storageParam, SdoGeoRaster outGeoRaster, double[] bgValues, int parallelDegree)
Perform rectification on all or part of a georeferenced GeoRaster object.
|
java.sql.Blob |
reproject(SdoGeoRaster inGeoRaster, int pyramidLevel, double[] cropArea, java.lang.String bandNumbers, java.lang.String resampleParam, java.lang.String storageParam, int outSRID, JGeometry outArea, double[] outWindow, double[] bgValues)
Reprojects all or part of a GeoRaster object to a different Oracle Spatial and Graph coordinate system (specified by the outSRID parameter).
|
void |
reproject(SdoGeoRaster inGeoRaster, int pyramidLevel, double[] cropArea, java.lang.String bandNumbers, java.lang.String resampleParam, java.lang.String storageParam, int outSRID, SdoGeoRaster outGeoraster, double[] bgValues)
Reprojects all or part of a GeoRaster object to a different Oracle Spatial and Graph coordinate system (specified by the outSRID parameter).
|
void |
reproject(SdoGeoRaster inGeoRaster, int pyramidLevel, JGeometry cropArea, java.lang.String layerNumbers, java.lang.String resampleParam, java.lang.String storageParam, int outSRID, java.sql.Blob rasterBlob, JGeometry outArea, double[] outWindow, double[] bgValues)
Reprojects all or part of a GeoRaster object to a different Oracle Spatial and Graph coordinate system (specified by the outSRID parameter).
|
void |
reproject(SdoGeoRaster inGeoRaster, int pyramidLevel, JGeometry cropArea, java.lang.String layerNumbers, java.lang.String resampleParam, java.lang.String storageParam, int outSRID, SdoGeoRaster outGeoraster, double[] bgValues)
Reprojects all or part of a GeoRaster object to a different Oracle Spatial and Graph coordinate system (specified by the outSRID parameter).
|
void |
reproject(SdoGeoRaster inGeoRaster, java.lang.String resampleParam, java.lang.String storageParam, int outSRID, SdoGeoRaster outGeoraster, double[] bgValues)
Reprojects a GeoRaster object to a different Oracle Spatial and Graph coordinate system (specified by the outSRID parameter).
|
void |
scaleCopy(SdoGeoRaster source, java.lang.String scaleParam, int pyramidLevel, java.lang.String resampleParam, java.lang.String storageParam, SdoGeoRaster target, double[] bgValues)
Scales a GeoRaster object by enlarging or reducing the image along row and column dimensions, and puts the result into a new object that reflects the scaling.
|
void |
scaleCopy(SdoGeoRaster source, java.lang.String scaleParam, java.lang.String resampleParam, java.lang.String storageParam, SdoGeoRaster target, double[] bgValues)
Scales a GeoRaster object by enlarging or reducing the image along row and column dimensions, and puts the result into a new object that reflects the scaling.
|
void |
setBitmapMask(SdoGeoRaster georaster, int layer, SdoGeoRaster mask, java.lang.Integer NODATAMask)
Attaches a bitmap mask to a GeoRaster object, or replaces or removes the current bitmap mask.
|
void |
setConnection(java.sql.Connection conn)
Sets the connection which points to the target database.
|
void |
setModelCoordLocation(SdoGeoRaster georaster, java.lang.String modelCoordLoc)
Sets the model coordinate location value for a GeoRaster object, or deletes the current model coordinate location value (if any) if the modelCoordLoc parameter is specified as null.
|
void |
subset(SdoGeoRaster source, int pyramid, JGeometry cropArea, java.lang.String layerNumbers, java.lang.String storageParam, SdoGeoRaster target, double[] bgValues)
Performs either or both of the following operations: (1) spatial crop, cut, or clip, or (2) layer or band subset or duplicate.
|
void |
subset(SdoGeoRaster source, int pyramid, JGeometry cropArea, java.lang.String layerNumbers, java.lang.String storageParam, SdoGeoRaster target, double[] bgValues, java.lang.String polygonClip)
Performs either or both of the following operations: (1) spatial crop, cut, or clip, or (2) layer or band subset or duplicate.
|
void |
subset(SdoGeoRaster source, int pyramid, long[] cropArea, java.lang.String layerNumbers, java.lang.String storageParam, SdoGeoRaster target, double[] bgValues)
Performs either or both of the following operations: (1) spatial crop, cut, or clip, or (2) layer or band subset or duplicate.
|
void |
subset(SdoGeoRaster source, JGeometry cropArea, java.lang.String layerNumbers, java.lang.String storageParam, SdoGeoRaster target, double[] bgValues)
Performs either or both of the following operations: (1) spatial crop, cut, or clip, or (2) layer or band subset or duplicate.
|
void |
subset(SdoGeoRaster source, JGeometry cropArea, java.lang.String layerNumbers, java.lang.String storageParam, SdoGeoRaster target, double[] bgValues, java.lang.String polygonClip)
Performs either or both of the following operations: (1) spatial crop, cut, or clip, or (2) layer or band subset or duplicate.
|
void |
subset(SdoGeoRaster source, long[] cropArea, java.lang.String layerNumbers, java.lang.String storageParam, SdoGeoRaster target, double[] bgValues)
Performs either or both of the following operations: (1) spatial crop, cut, or clip, or (2) layer or band subset or duplicate.
|
void |
updateRaster(SdoGeoRaster target, int targetPyramidLevel, java.lang.String targetLayerNumbers, JGeometry targetArea, SdoGeoRaster source, int sourcePyramidLevel, java.lang.String sourceLayerNumbers, boolean updateUpperPyramids, double[] bgValues)
Updates a specified pyramid of a specified area or the overlapping parts of one GeoRaster object with selected pyramid and selected bands or layers of another GeoRaster object.
|
void |
updateRaster(SdoGeoRaster target, int targetPyramidLevel, java.lang.String targetLayerNumbers, long[] targetArea, SdoGeoRaster source, int sourcePyramidLevel, java.lang.String sourceLayerNumbers, boolean updateUpperPyramids, double[] bgValues)
Updates a specified pyramid of a specified area or the overlapping parts of one GeoRaster object with selected pyramid and selected bands or layers of another GeoRaster object.
|
boolean |
validateBlockMBR(SdoGeoRaster georaster)
Validates the blockMBR attribute of each block of a GeoRaster object.
|
boolean |
validateGeoRaster(SdoGeoRaster georaster)
Validates a GeoRaster object, checking its raster data and metadata.
|
void |
warp(SdoGeoRaster inGeoRaster, java.lang.Integer pyramidLevel, java.lang.Integer outSRS, JGeometry cropArea, java.math.BigDecimal[] dimensionSize, java.lang.String layerNumbers, java.lang.String elevationParam, java.lang.String resampleParam, java.lang.String storageParam, SdoGeoRaster outGeoRaster, double[] bgValues, int parallelParam)
Perform geometric transformation on the input GeoRaster object to produce an output GeoRaster object with the specified output spatial reference system.
|
public SdoGeorPKG(java.sql.Connection conn)
SdoGeorPKG
object using the given connection.conn
- a JDBC connection.public void setConnection(java.sql.Connection conn)
conn
- a JDBC connectionpublic java.sql.Connection getConnection()
public double generateStatisticsMax(SdoGeoRaster georaster, long pyramidLevel, int samplingFactor, long[] samplingWindow, java.lang.String bandNumbers, boolean nodata) throws java.lang.Exception
georaster
- source GeoRaster object.pyramidLevel
- Pyramid level on which to perform the operation.samplingFactor
- Sampling factor in the format 'samplingFactor=n', with the denominator n in 1/(n*n) representing the number of cells skipped in both row and column dimensions in computing the statistics. For example, if samplingFactor is 4, one-sixteenth of the cells are sampled; but if samplingFactor is 1, all cells are sampled. The higher the value, the less accurate the statistics are likely to be, but the more quickly they will be computed.samplingWindow
- A rectangular window or a polygon geometry object from which to generate statistics. If the data type is SDO_NUMBER_ARRAY, the parameter identifies the upper-left (row, column) and lower-right (row, column) coordinates of a rectangular window, and raster space is assumed. If the data type is SDO_GEOMETRY, it is transformed into raster space if it is in model space; and if the polygonClip value is FALSE, the MBR of the geometry object is used as the window, but if the polygonClip value is TRUE, the polygon geometry object (if valid) is used as the window.bandNumbers
- Band ordinate numbers of the layers for which values are used in computing the statistics. This is a string that can include numbers, number ranges indicated by hyphens (-), and commas to separate numbers and number ranges. For example, '0,1,3-5,7' specifies layers 1, 2, 4, 5, 6, and 8. If bandNumbers is null, all bands are used in computing the statistics.nodata
- Specifies whether or not to compare each cell values with NODATA values defined in the metadata when computing statistics. TRUE causes all pixels with a NODATA value not to be considered; FALSE (the default) causes pixels with NODATA values to be considered as regular pixels.java.lang.Exception
public double generateStatisticsMax(SdoGeoRaster georaster, long pyramidLevel, int samplingFactor, long[] samplingWindow, java.lang.String bandNumbers, boolean nodata, int parallelDegree) throws java.lang.Exception
georaster
- source GeoRaster object.pyramidLevel
- Pyramid level on which to perform the operation.samplingFactor
- Sampling factor in the format 'samplingFactor=n', with the denominator n in 1/(n*n) representing the number of cells skipped in both row and column dimensions in computing the statistics. For example, if samplingFactor is 4, one-sixteenth of the cells are sampled; but if samplingFactor is 1, all cells are sampled. The higher the value, the less accurate the statistics are likely to be, but the more quickly they will be computed.samplingWindow
- A rectangular window or a polygon geometry object from which to generate statistics. If the data type is SDO_NUMBER_ARRAY, the parameter identifies the upper-left (row, column) and lower-right (row, column) coordinates of a rectangular window, and raster space is assumed. If the data type is SDO_GEOMETRY, it is transformed into raster space if it is in model space; and if the polygonClip value is FALSE, the MBR of the geometry object is used as the window, but if the polygonClip value is TRUE, the polygon geometry object (if valid) is used as the window.bandNumbers
- Band ordinate numbers of the layers for which values are used in computing the statistics. This is a string that can include numbers, number ranges indicated by hyphens (-), and commas to separate numbers and number ranges. For example, '0,1,3-5,7' specifies layers 1, 2, 4, 5, 6, and 8. If bandNumbers is null, all bands are used in computing the statistics.nodata
- Specifies whether or not to compare each cell values with NODATA values defined in the metadata when computing statistics. TRUE causes all pixels with a NODATA value not to be considered; FALSE (the default) causes pixels with NODATA values to be considered as regular pixels.parallelDegree
- Specifies the degree of parallelism for the operation. If >1. The database optimizer uses the degree of parallelism specified by this parameter. If <=1, then there is no parallel processing. (For more information,see Section 1.13 of Spatial GeoRaster Developer's Guide, "Parallel Processing in GeoRaster").java.lang.Exception
public double generateStatisticsMax(SdoGeoRaster georaster, long pyramidLevel, int samplingFactor, JGeometry samplingWindow, java.lang.String bandNumbers, boolean nodata, boolean polygonClip) throws java.lang.Exception
georaster
- source GeoRaster object.pyramidLevel
- Pyramid level on which to perform the operation.samplingFactor
- Sampling factor in the format 'samplingFactor=n', with the denominator n in 1/(n*n) representing the number of cells skipped in both row and column dimensions in computing the statistics. For example, if samplingFactor is 4, one-sixteenth of the cells are sampled; but if samplingFactor is 1, all cells are sampled. The higher the value, the less accurate the statistics are likely to be, but the more quickly they will be computed.samplingWindow
- A rectangular window or a polygon geometry object from which to generate statistics. If the data type is SDO_NUMBER_ARRAY, the parameter identifies the upper-left (row, column) and lower-right (row, column) coordinates of a rectangular window, and raster space is assumed. If the data type is SDO_GEOMETRY, it is transformed into raster space if it is in model space; and if the polygonClip value is FALSE, the MBR of the geometry object is used as the window, but if the polygonClip value is TRUE, the polygon geometry object (if valid) is used as the window.bandNumbers
- Band ordinate numbers of the layers for which values are used in computing the statistics. This is a string that can include numbers, number ranges indicated by hyphens (-), and commas to separate numbers and number ranges. For example, '0,1,3-5,7' specifies layers 1, 2, 4, 5, 6, and 8. If bandNumbers is null, all bands are used in computing the statistics.nodata
- Specifies whether or not to compare each cell values with NODATA values defined in the metadata when computing statistics. TRUE causes all pixels with a NODATA value not to be considered; FALSE (the default) causes pixels with NODATA values to be considered as regular pixels.polygonClip
- The value TRUE causes the samplingWindow geometry object to be used for the operation; the value FALSE or a null value causes the MBR (minimum bounding rectangle) of the samplingWindow geometry object to be used for the operation.java.lang.Exception
public double generateStatisticsMax(SdoGeoRaster georaster, long pyramidLevel, int samplingFactor, JGeometry samplingWindow, java.lang.String bandNumbers, boolean nodata, boolean polygonClip, int parallelDegree) throws java.lang.Exception
georaster
- source GeoRaster object.pyramidLevel
- Pyramid level on which to perform the operation.samplingFactor
- Sampling factor in the format 'samplingFactor=n', with the denominator n in 1/(n*n) representing the number of cells skipped in both row and column dimensions in computing the statistics. For example, if samplingFactor is 4, one-sixteenth of the cells are sampled; but if samplingFactor is 1, all cells are sampled. The higher the value, the less accurate the statistics are likely to be, but the more quickly they will be computed.samplingWindow
- A rectangular window or a polygon geometry object from which to generate statistics. If the data type is SDO_NUMBER_ARRAY, the parameter identifies the upper-left (row, column) and lower-right (row, column) coordinates of a rectangular window, and raster space is assumed. If the data type is SDO_GEOMETRY, it is transformed into raster space if it is in model space; and if the polygonClip value is FALSE, the MBR of the geometry object is used as the window, but if the polygonClip value is TRUE, the polygon geometry object (if valid) is used as the window.bandNumbers
- Band ordinate numbers of the layers for which values are used in computing the statistics. This is a string that can include numbers, number ranges indicated by hyphens (-), and commas to separate numbers and number ranges. For example, '0,1,3-5,7' specifies layers 1, 2, 4, 5, 6, and 8. If bandNumbers is null, all bands are used in computing the statistics.nodata
- Specifies whether or not to compare each cell values with NODATA values defined in the metadata when computing statistics. TRUE causes all pixels with a NODATA value not to be considered; FALSE (the default) causes pixels with NODATA values to be considered as regular pixels.polygonClip
- The value TRUE causes the samplingWindow geometry object to be used for the operation; the value FALSE or a null value causes the MBR (minimum bounding rectangle) of the samplingWindow geometry object to be used for the operation.parallelDegree
- Specifies the degree of parallelism for the operation. If >1. The database optimizer uses the degree of parallelism specified by this parameter. If <=1, then there is no parallel processing. (For more information,see Section 1.13 of Spatial GeoRaster Developer's Guide, "Parallel Processing in GeoRaster").java.lang.Exception
public double generateStatisticsMin(SdoGeoRaster georaster, long pyramidLevel, int samplingFactor, long[] samplingWindow, java.lang.String bandNumbers, boolean nodata) throws java.lang.Exception
georaster
- source GeoRaster object.pyramidLevel
- Pyramid level on which to perform the operation.samplingFactor
- Sampling factor in the format 'samplingFactor=n', with the denominator n in 1/(n*n) representing the number of cells skipped in both row and column dimensions in computing the statistics. For example, if samplingFactor is 4, one-sixteenth of the cells are sampled; but if samplingFactor is 1, all cells are sampled. The higher the value, the less accurate the statistics are likely to be, but the more quickly they will be computed.samplingWindow
- A rectangular window or a polygon geometry object from which to generate statistics. If the data type is SDO_NUMBER_ARRAY, the parameter identifies the upper-left (row, column) and lower-right (row, column) coordinates of a rectangular window, and raster space is assumed. If the data type is SDO_GEOMETRY, it is transformed into raster space if it is in model space; and if the polygonClip value is FALSE, the MBR of the geometry object is used as the window, but if the polygonClip value is TRUE, the polygon geometry object (if valid) is used as the window.bandNumbers
- Band ordinate numbers of the layers for which values are used in computing the statistics. This is a string that can include numbers, number ranges indicated by hyphens (-), and commas to separate numbers and number ranges. For example, '0,1,3-5,7' specifies layers 1, 2, 4, 5, 6, and 8. If bandNumbers is null, all bands are used in computing the statistics.nodata
- Specifies whether or not to compare each cell values with NODATA values defined in the metadata when computing statistics. TRUE causes all pixels with a NODATA value not to be considered; FALSE (the default) causes pixels with NODATA values to be considered as regular pixels.java.lang.Exception
public double generateStatisticsMin(SdoGeoRaster georaster, long pyramidLevel, int samplingFactor, long[] samplingWindow, java.lang.String bandNumbers, boolean nodata, int parallelDegree) throws java.lang.Exception
georaster
- source GeoRaster object.pyramidLevel
- Pyramid level on which to perform the operation.samplingFactor
- Sampling factor in the format 'samplingFactor=n', with the denominator n in 1/(n*n) representing the number of cells skipped in both row and column dimensions in computing the statistics. For example, if samplingFactor is 4, one-sixteenth of the cells are sampled; but if samplingFactor is 1, all cells are sampled. The higher the value, the less accurate the statistics are likely to be, but the more quickly they will be computed.samplingWindow
- A rectangular window or a polygon geometry object from which to generate statistics. If the data type is SDO_NUMBER_ARRAY, the parameter identifies the upper-left (row, column) and lower-right (row, column) coordinates of a rectangular window, and raster space is assumed. If the data type is SDO_GEOMETRY, it is transformed into raster space if it is in model space; and if the polygonClip value is FALSE, the MBR of the geometry object is used as the window, but if the polygonClip value is TRUE, the polygon geometry object (if valid) is used as the window.bandNumbers
- Band ordinate numbers of the layers for which values are used in computing the statistics. This is a string that can include numbers, number ranges indicated by hyphens (-), and commas to separate numbers and number ranges. For example, '0,1,3-5,7' specifies layers 1, 2, 4, 5, 6, and 8. If bandNumbers is null, all bands are used in computing the statistics.nodata
- Specifies whether or not to compare each cell values with NODATA values defined in the metadata when computing statistics. TRUE causes all pixels with a NODATA value not to be considered; FALSE (the default) causes pixels with NODATA values to be considered as regular pixels.parallelDegree
- Specifies the degree of parallelism for the operation. If >1. The database optimizer uses the degree of parallelism specified by this parameter. If <=1, then there is no parallel processing. (For more information,see Section 1.13 of Spatial GeoRaster Developer's Guide, "Parallel Processing in GeoRaster").java.lang.Exception
public double generateStatisticsMin(SdoGeoRaster georaster, long pyramidLevel, int samplingFactor, JGeometry samplingWindow, java.lang.String bandNumbers, boolean nodata, boolean polygonClip) throws java.lang.Exception
georaster
- source GeoRaster object.pyramidLevel
- Pyramid level on which to perform the operation.samplingFactor
- Sampling factor in the format 'samplingFactor=n', with the denominator n in 1/(n*n) representing the number of cells skipped in both row and column dimensions in computing the statistics. For example, if samplingFactor is 4, one-sixteenth of the cells are sampled; but if samplingFactor is 1, all cells are sampled. The higher the value, the less accurate the statistics are likely to be, but the more quickly they will be computed.samplingWindow
- A rectangular window or a polygon geometry object from which to generate statistics. If the data type is SDO_NUMBER_ARRAY, the parameter identifies the upper-left (row, column) and lower-right (row, column) coordinates of a rectangular window, and raster space is assumed. If the data type is SDO_GEOMETRY, it is transformed into raster space if it is in model space; and if the polygonClip value is FALSE, the MBR of the geometry object is used as the window, but if the polygonClip value is TRUE, the polygon geometry object (if valid) is used as the window.bandNumbers
- Band ordinate numbers of the layers for which values are used in computing the statistics. This is a string that can include numbers, number ranges indicated by hyphens (-), and commas to separate numbers and number ranges. For example, '0,1,3-5,7' specifies layers 1, 2, 4, 5, 6, and 8. If bandNumbers is null, all bands are used in computing the statistics.nodata
- Specifies whether or not to compare each cell values with NODATA values defined in the metadata when computing statistics. TRUE causes all pixels with a NODATA value not to be considered; FALSE (the default) causes pixels with NODATA values to be considered as regular pixels.polygonClip
- The value TRUE causes the samplingWindow geometry object to be used for the operation; the value FALSE or a null value causes the MBR (minimum bounding rectangle) of the samplingWindow geometry object to be used for the operation.java.lang.Exception
public double generateStatisticsMin(SdoGeoRaster georaster, long pyramidLevel, int samplingFactor, JGeometry samplingWindow, java.lang.String bandNumbers, boolean nodata, boolean polygonClip, int parallelDegree) throws java.lang.Exception
georaster
- source GeoRaster object.pyramidLevel
- Pyramid level on which to perform the operation.samplingFactor
- Sampling factor in the format 'samplingFactor=n', with the denominator n in 1/(n*n) representing the number of cells skipped in both row and column dimensions in computing the statistics. For example, if samplingFactor is 4, one-sixteenth of the cells are sampled; but if samplingFactor is 1, all cells are sampled. The higher the value, the less accurate the statistics are likely to be, but the more quickly they will be computed.samplingWindow
- A rectangular window or a polygon geometry object from which to generate statistics. If the data type is SDO_NUMBER_ARRAY, the parameter identifies the upper-left (row, column) and lower-right (row, column) coordinates of a rectangular window, and raster space is assumed. If the data type is SDO_GEOMETRY, it is transformed into raster space if it is in model space; and if the polygonClip value is FALSE, the MBR of the geometry object is used as the window, but if the polygonClip value is TRUE, the polygon geometry object (if valid) is used as the window.bandNumbers
- Band ordinate numbers of the layers for which values are used in computing the statistics. This is a string that can include numbers, number ranges indicated by hyphens (-), and commas to separate numbers and number ranges. For example, '0,1,3-5,7' specifies layers 1, 2, 4, 5, 6, and 8. If bandNumbers is null, all bands are used in computing the statistics.nodata
- Specifies whether or not to compare each cell values with NODATA values defined in the metadata when computing statistics. TRUE causes all pixels with a NODATA value not to be considered; FALSE (the default) causes pixels with NODATA values to be considered as regular pixels.polygonClip
- The value TRUE causes the samplingWindow geometry object to be used for the operation; the value FALSE or a null value causes the MBR (minimum bounding rectangle) of the samplingWindow geometry object to be used for the operation.parallelDegree
- Specifies the degree of parallelism for the operation. If >1. The database optimizer uses the degree of parallelism specified by this parameter. If <=1, then there is no parallel processing. (For more information,see Section 1.13 of Spatial GeoRaster Developer's Guide, "Parallel Processing in GeoRaster").java.lang.Exception
public double generateStatisticsMean(SdoGeoRaster georaster, long pyramidLevel, int samplingFactor, long[] samplingWindow, java.lang.String bandNumbers, boolean nodata) throws java.lang.Exception
georaster
- source GeoRaster object.pyramidLevel
- Pyramid level on which to perform the operation.samplingFactor
- Sampling factor in the format 'samplingFactor=n', with the denominator n in 1/(n*n) representing the number of cells skipped in both row and column dimensions in computing the statistics. For example, if samplingFactor is 4, one-sixteenth of the cells are sampled; but if samplingFactor is 1, all cells are sampled. The higher the value, the less accurate the statistics are likely to be, but the more quickly they will be computed.samplingWindow
- A rectangular window or a polygon geometry object from which to generate statistics. If the data type is SDO_NUMBER_ARRAY, the parameter identifies the upper-left (row, column) and lower-right (row, column) coordinates of a rectangular window, and raster space is assumed. If the data type is SDO_GEOMETRY, it is transformed into raster space if it is in model space; and if the polygonClip value is FALSE, the MBR of the geometry object is used as the window, but if the polygonClip value is TRUE, the polygon geometry object (if valid) is used as the window.bandNumbers
- Band ordinate numbers of the layers for which values are used in computing the statistics. This is a string that can include numbers, number ranges indicated by hyphens (-), and commas to separate numbers and number ranges. For example, '0,1,3-5,7' specifies layers 1, 2, 4, 5, 6, and 8. If bandNumbers is null, all bands are used in computing the statistics.nodata
- Specifies whether or not to compare each cell values with NODATA values defined in the metadata when computing statistics. TRUE causes all pixels with a NODATA value not to be considered; FALSE (the default) causes pixels with NODATA values to be considered as regular pixels.java.lang.Exception
public double generateStatisticsMean(SdoGeoRaster georaster, long pyramidLevel, int samplingFactor, long[] samplingWindow, java.lang.String bandNumbers, boolean nodata, int parallelDegree) throws java.lang.Exception
georaster
- source GeoRaster object.pyramidLevel
- Pyramid level on which to perform the operation.samplingFactor
- Sampling factor in the format 'samplingFactor=n', with the denominator n in 1/(n*n) representing the number of cells skipped in both row and column dimensions in computing the statistics. For example, if samplingFactor is 4, one-sixteenth of the cells are sampled; but if samplingFactor is 1, all cells are sampled. The higher the value, the less accurate the statistics are likely to be, but the more quickly they will be computed.samplingWindow
- A rectangular window or a polygon geometry object from which to generate statistics. If the data type is SDO_NUMBER_ARRAY, the parameter identifies the upper-left (row, column) and lower-right (row, column) coordinates of a rectangular window, and raster space is assumed. If the data type is SDO_GEOMETRY, it is transformed into raster space if it is in model space; and if the polygonClip value is FALSE, the MBR of the geometry object is used as the window, but if the polygonClip value is TRUE, the polygon geometry object (if valid) is used as the window.bandNumbers
- Band ordinate numbers of the layers for which values are used in computing the statistics. This is a string that can include numbers, number ranges indicated by hyphens (-), and commas to separate numbers and number ranges. For example, '0,1,3-5,7' specifies layers 1, 2, 4, 5, 6, and 8. If bandNumbers is null, all bands are used in computing the statistics.nodata
- Specifies whether or not to compare each cell values with NODATA values defined in the metadata when computing statistics. TRUE causes all pixels with a NODATA value not to be considered; FALSE (the default) causes pixels with NODATA values to be considered as regular pixels.parallelDegree
- Specifies the degree of parallelism for the operation. If >1. The database optimizer uses the degree of parallelism specified by this parameter. If <=1, then there is no parallel processing. (For more information,see Section 1.13 of Spatial GeoRaster Developer's Guide, "Parallel Processing in GeoRaster").java.lang.Exception
public double generateStatisticsMean(SdoGeoRaster georaster, long pyramidLevel, int samplingFactor, JGeometry samplingWindow, java.lang.String bandNumbers, boolean nodata, boolean polygonClip) throws java.lang.Exception
georaster
- source GeoRaster object.pyramidLevel
- Pyramid level on which to perform the operation.samplingFactor
- Sampling factor in the format 'samplingFactor=n', with the denominator n in 1/(n*n) representing the number of cells skipped in both row and column dimensions in computing the statistics. For example, if samplingFactor is 4, one-sixteenth of the cells are sampled; but if samplingFactor is 1, all cells are sampled. The higher the value, the less accurate the statistics are likely to be, but the more quickly they will be computed.samplingWindow
- A rectangular window or a polygon geometry object from which to generate statistics. If the data type is SDO_NUMBER_ARRAY, the parameter identifies the upper-left (row, column) and lower-right (row, column) coordinates of a rectangular window, and raster space is assumed. If the data type is SDO_GEOMETRY, it is transformed into raster space if it is in model space; and if the polygonClip value is FALSE, the MBR of the geometry object is used as the window, but if the polygonClip value is TRUE, the polygon geometry object (if valid) is used as the window.bandNumbers
- Band ordinate numbers of the layers for which values are used in computing the statistics. This is a string that can include numbers, number ranges indicated by hyphens (-), and commas to separate numbers and number ranges. For example, '0,1,3-5,7' specifies layers 1, 2, 4, 5, 6, and 8. If bandNumbers is null, all bands are used in computing the statistics.nodata
- Specifies whether or not to compare each cell values with NODATA values defined in the metadata when computing statistics. TRUE causes all pixels with a NODATA value not to be considered; FALSE (the default) causes pixels with NODATA values to be considered as regular pixels.polygonClip
- The value TRUE causes the samplingWindow geometry object to be used for the operation; the value FALSE or a null value causes the MBR (minimum bounding rectangle) of the samplingWindow geometry object to be used for the operation.java.lang.Exception
public double generateStatisticsMean(SdoGeoRaster georaster, long pyramidLevel, int samplingFactor, JGeometry samplingWindow, java.lang.String bandNumbers, boolean nodata, boolean polygonClip, int parallelDegree) throws java.lang.Exception
georaster
- source GeoRaster object.pyramidLevel
- Pyramid level on which to perform the operation.samplingFactor
- Sampling factor in the format 'samplingFactor=n', with the denominator n in 1/(n*n) representing the number of cells skipped in both row and column dimensions in computing the statistics. For example, if samplingFactor is 4, one-sixteenth of the cells are sampled; but if samplingFactor is 1, all cells are sampled. The higher the value, the less accurate the statistics are likely to be, but the more quickly they will be computed.samplingWindow
- A rectangular window or a polygon geometry object from which to generate statistics. If the data type is SDO_NUMBER_ARRAY, the parameter identifies the upper-left (row, column) and lower-right (row, column) coordinates of a rectangular window, and raster space is assumed. If the data type is SDO_GEOMETRY, it is transformed into raster space if it is in model space; and if the polygonClip value is FALSE, the MBR of the geometry object is used as the window, but if the polygonClip value is TRUE, the polygon geometry object (if valid) is used as the window.bandNumbers
- Band ordinate numbers of the layers for which values are used in computing the statistics. This is a string that can include numbers, number ranges indicated by hyphens (-), and commas to separate numbers and number ranges. For example, '0,1,3-5,7' specifies layers 1, 2, 4, 5, 6, and 8. If bandNumbers is null, all bands are used in computing the statistics.nodata
- Specifies whether or not to compare each cell values with NODATA values defined in the metadata when computing statistics. TRUE causes all pixels with a NODATA value not to be considered; FALSE (the default) causes pixels with NODATA values to be considered as regular pixels.polygonClip
- The value TRUE causes the samplingWindow geometry object to be used for the operation; the value FALSE or a null value causes the MBR (minimum bounding rectangle) of the samplingWindow geometry object to be used for the operation.parallelDegree
- Specifies the degree of parallelism for the operation. If >1. The database optimizer uses the degree of parallelism specified by this parameter. If <=1, then there is no parallel processing. (For more information,see Section 1.13 of Spatial GeoRaster Developer's Guide, "Parallel Processing in GeoRaster").java.lang.Exception
public double generateStatisticsMedian(SdoGeoRaster georaster, long pyramidLevel, int samplingFactor, long[] samplingWindow, java.lang.String bandNumbers, boolean nodata) throws java.lang.Exception
georaster
- source GeoRaster object.pyramidLevel
- Pyramid level on which to perform the operation.samplingFactor
- Sampling factor in the format 'samplingFactor=n', with the denominator n in 1/(n*n) representing the number of cells skipped in both row and column dimensions in computing the statistics. For example, if samplingFactor is 4, one-sixteenth of the cells are sampled; but if samplingFactor is 1, all cells are sampled. The higher the value, the less accurate the statistics are likely to be, but the more quickly they will be computed.samplingWindow
- A rectangular window or a polygon geometry object from which to generate statistics. If the data type is SDO_NUMBER_ARRAY, the parameter identifies the upper-left (row, column) and lower-right (row, column) coordinates of a rectangular window, and raster space is assumed. If the data type is SDO_GEOMETRY, it is transformed into raster space if it is in model space; and if the polygonClip value is FALSE, the MBR of the geometry object is used as the window, but if the polygonClip value is TRUE, the polygon geometry object (if valid) is used as the window.bandNumbers
- Band ordinate numbers of the layers for which values are used in computing the statistics. This is a string that can include numbers, number ranges indicated by hyphens (-), and commas to separate numbers and number ranges. For example, '0,1,3-5,7' specifies layers 1, 2, 4, 5, 6, and 8. If bandNumbers is null, all bands are used in computing the statistics.nodata
- Specifies whether or not to compare each cell values with NODATA values defined in the metadata when computing statistics. TRUE causes all pixels with a NODATA value not to be considered; FALSE (the default) causes pixels with NODATA values to be considered as regular pixels.java.lang.Exception
public double generateStatisticsMedian(SdoGeoRaster georaster, long pyramidLevel, int samplingFactor, long[] samplingWindow, java.lang.String bandNumbers, boolean nodata, int parallelDegree) throws java.lang.Exception
georaster
- source GeoRaster object.pyramidLevel
- Pyramid level on which to perform the operation.samplingFactor
- Sampling factor in the format 'samplingFactor=n', with the denominator n in 1/(n*n) representing the number of cells skipped in both row and column dimensions in computing the statistics. For example, if samplingFactor is 4, one-sixteenth of the cells are sampled; but if samplingFactor is 1, all cells are sampled. The higher the value, the less accurate the statistics are likely to be, but the more quickly they will be computed.samplingWindow
- A rectangular window or a polygon geometry object from which to generate statistics. If the data type is SDO_NUMBER_ARRAY, the parameter identifies the upper-left (row, column) and lower-right (row, column) coordinates of a rectangular window, and raster space is assumed. If the data type is SDO_GEOMETRY, it is transformed into raster space if it is in model space; and if the polygonClip value is FALSE, the MBR of the geometry object is used as the window, but if the polygonClip value is TRUE, the polygon geometry object (if valid) is used as the window.bandNumbers
- Band ordinate numbers of the layers for which values are used in computing the statistics. This is a string that can include numbers, number ranges indicated by hyphens (-), and commas to separate numbers and number ranges. For example, '0,1,3-5,7' specifies layers 1, 2, 4, 5, 6, and 8. If bandNumbers is null, all bands are used in computing the statistics.nodata
- Specifies whether or not to compare each cell values with NODATA values defined in the metadata when computing statistics. TRUE causes all pixels with a NODATA value not to be considered; FALSE (the default) causes pixels with NODATA values to be considered as regular pixels.parallelDegree
- Specifies the degree of parallelism for the operation. If >1. The database optimizer uses the degree of parallelism specified by this parameter. If <=1, then there is no parallel processing. (For more information,see Section 1.13 of Spatial GeoRaster Developer's Guide, "Parallel Processing in GeoRaster").java.lang.Exception
public double generateStatisticsMedian(SdoGeoRaster georaster, long pyramidLevel, int samplingFactor, JGeometry samplingWindow, java.lang.String bandNumbers, boolean nodata, boolean polygonClip) throws java.lang.Exception
georaster
- source GeoRaster object.pyramidLevel
- Pyramid level on which to perform the operation.samplingFactor
- Sampling factor in the format 'samplingFactor=n', with the denominator n in 1/(n*n) representing the number of cells skipped in both row and column dimensions in computing the statistics. For example, if samplingFactor is 4, one-sixteenth of the cells are sampled; but if samplingFactor is 1, all cells are sampled. The higher the value, the less accurate the statistics are likely to be, but the more quickly they will be computed.samplingWindow
- A rectangular window or a polygon geometry object from which to generate statistics. If the data type is SDO_NUMBER_ARRAY, the parameter identifies the upper-left (row, column) and lower-right (row, column) coordinates of a rectangular window, and raster space is assumed. If the data type is SDO_GEOMETRY, it is transformed into raster space if it is in model space; and if the polygonClip value is FALSE, the MBR of the geometry object is used as the window, but if the polygonClip value is TRUE, the polygon geometry object (if valid) is used as the window.bandNumbers
- Band ordinate numbers of the layers for which values are used in computing the statistics. This is a string that can include numbers, number ranges indicated by hyphens (-), and commas to separate numbers and number ranges. For example, '0,1,3-5,7' specifies layers 1, 2, 4, 5, 6, and 8. If bandNumbers is null, all bands are used in computing the statistics.nodata
- Specifies whether or not to compare each cell values with NODATA values defined in the metadata when computing statistics. TRUE causes all pixels with a NODATA value not to be considered; FALSE (the default) causes pixels with NODATA values to be considered as regular pixels.polygonClip
- The value TRUE causes the samplingWindow geometry object to be used for the operation; the value FALSE or a null value causes the MBR (minimum bounding rectangle) of the samplingWindow geometry object to be used for the operation.java.lang.Exception
public double generateStatisticsMedian(SdoGeoRaster georaster, long pyramidLevel, int samplingFactor, JGeometry samplingWindow, java.lang.String bandNumbers, boolean nodata, boolean polygonClip, int parallelDegree) throws java.lang.Exception
georaster
- source GeoRaster object.pyramidLevel
- Pyramid level on which to perform the operation.samplingFactor
- Sampling factor in the format 'samplingFactor=n', with the denominator n in 1/(n*n) representing the number of cells skipped in both row and column dimensions in computing the statistics. For example, if samplingFactor is 4, one-sixteenth of the cells are sampled; but if samplingFactor is 1, all cells are sampled. The higher the value, the less accurate the statistics are likely to be, but the more quickly they will be computed.samplingWindow
- A rectangular window or a polygon geometry object from which to generate statistics. If the data type is SDO_NUMBER_ARRAY, the parameter identifies the upper-left (row, column) and lower-right (row, column) coordinates of a rectangular window, and raster space is assumed. If the data type is SDO_GEOMETRY, it is transformed into raster space if it is in model space; and if the polygonClip value is FALSE, the MBR of the geometry object is used as the window, but if the polygonClip value is TRUE, the polygon geometry object (if valid) is used as the window.bandNumbers
- Band ordinate numbers of the layers for which values are used in computing the statistics. This is a string that can include numbers, number ranges indicated by hyphens (-), and commas to separate numbers and number ranges. For example, '0,1,3-5,7' specifies layers 1, 2, 4, 5, 6, and 8. If bandNumbers is null, all bands are used in computing the statistics.nodata
- Specifies whether or not to compare each cell values with NODATA values defined in the metadata when computing statistics. TRUE causes all pixels with a NODATA value not to be considered; FALSE (the default) causes pixels with NODATA values to be considered as regular pixels.polygonClip
- The value TRUE causes the samplingWindow geometry object to be used for the operation; the value FALSE or a null value causes the MBR (minimum bounding rectangle) of the samplingWindow geometry object to be used for the operation.parallelDegree
- Specifies the degree of parallelism for the operation. If >1. The database optimizer uses the degree of parallelism specified by this parameter. If <=1, then there is no parallel processing. (For more information,see Section 1.13 of Spatial GeoRaster Developer's Guide, "Parallel Processing in GeoRaster").java.lang.Exception
public double generateStatisticsMode(SdoGeoRaster georaster, long pyramidLevel, int samplingFactor, long[] samplingWindow, java.lang.String bandNumbers, boolean nodata) throws java.lang.Exception
georaster
- source GeoRaster object.pyramidLevel
- Pyramid level on which to perform the operation.samplingFactor
- Sampling factor in the format 'samplingFactor=n', with the denominator n in 1/(n*n) representing the number of cells skipped in both row and column dimensions in computing the statistics. For example, if samplingFactor is 4, one-sixteenth of the cells are sampled; but if samplingFactor is 1, all cells are sampled. The higher the value, the less accurate the statistics are likely to be, but the more quickly they will be computed.samplingWindow
- A rectangular window or a polygon geometry object from which to generate statistics. If the data type is SDO_NUMBER_ARRAY, the parameter identifies the upper-left (row, column) and lower-right (row, column) coordinates of a rectangular window, and raster space is assumed. If the data type is SDO_GEOMETRY, it is transformed into raster space if it is in model space; and if the polygonClip value is FALSE, the MBR of the geometry object is used as the window, but if the polygonClip value is TRUE, the polygon geometry object (if valid) is used as the window.bandNumbers
- Band ordinate numbers of the layers for which values are used in computing the statistics. This is a string that can include numbers, number ranges indicated by hyphens (-), and commas to separate numbers and number ranges. For example, '0,1,3-5,7' specifies layers 1, 2, 4, 5, 6, and 8. If bandNumbers is null, all bands are used in computing the statistics.nodata
- Specifies whether or not to compare each cell values with NODATA values defined in the metadata when computing statistics. TRUE causes all pixels with a NODATA value not to be considered; FALSE (the default) causes pixels with NODATA values to be considered as regular pixels.java.lang.Exception
public double generateStatisticsMode(SdoGeoRaster georaster, long pyramidLevel, int samplingFactor, long[] samplingWindow, java.lang.String bandNumbers, boolean nodata, int parallelDegree) throws java.lang.Exception
georaster
- source GeoRaster object.pyramidLevel
- Pyramid level on which to perform the operation.samplingFactor
- Sampling factor in the format 'samplingFactor=n', with the denominator n in 1/(n*n) representing the number of cells skipped in both row and column dimensions in computing the statistics. For example, if samplingFactor is 4, one-sixteenth of the cells are sampled; but if samplingFactor is 1, all cells are sampled. The higher the value, the less accurate the statistics are likely to be, but the more quickly they will be computed.samplingWindow
- A rectangular window or a polygon geometry object from which to generate statistics. If the data type is SDO_NUMBER_ARRAY, the parameter identifies the upper-left (row, column) and lower-right (row, column) coordinates of a rectangular window, and raster space is assumed. If the data type is SDO_GEOMETRY, it is transformed into raster space if it is in model space; and if the polygonClip value is FALSE, the MBR of the geometry object is used as the window, but if the polygonClip value is TRUE, the polygon geometry object (if valid) is used as the window.bandNumbers
- Band ordinate numbers of the layers for which values are used in computing the statistics. This is a string that can include numbers, number ranges indicated by hyphens (-), and commas to separate numbers and number ranges. For example, '0,1,3-5,7' specifies layers 1, 2, 4, 5, 6, and 8. If bandNumbers is null, all bands are used in computing the statistics.nodata
- Specifies whether or not to compare each cell values with NODATA values defined in the metadata when computing statistics. TRUE causes all pixels with a NODATA value not to be considered; FALSE (the default) causes pixels with NODATA values to be considered as regular pixels.parallelDegree
- Specifies the degree of parallelism for the operation. If >1. The database optimizer uses the degree of parallelism specified by this parameter. If <=1, then there is no parallel processing. (For more information,see Section 1.13 of Spatial GeoRaster Developer's Guide, "Parallel Processing in GeoRaster").java.lang.Exception
public double generateStatisticsMode(SdoGeoRaster georaster, long pyramidLevel, int samplingFactor, JGeometry samplingWindow, java.lang.String bandNumbers, boolean nodata, boolean polygonClip) throws java.lang.Exception
georaster
- source GeoRaster object.pyramidLevel
- Pyramid level on which to perform the operation.samplingFactor
- Sampling factor in the format 'samplingFactor=n', with the denominator n in 1/(n*n) representing the number of cells skipped in both row and column dimensions in computing the statistics. For example, if samplingFactor is 4, one-sixteenth of the cells are sampled; but if samplingFactor is 1, all cells are sampled. The higher the value, the less accurate the statistics are likely to be, but the more quickly they will be computed.samplingWindow
- A rectangular window or a polygon geometry object from which to generate statistics. If the data type is SDO_NUMBER_ARRAY, the parameter identifies the upper-left (row, column) and lower-right (row, column) coordinates of a rectangular window, and raster space is assumed. If the data type is SDO_GEOMETRY, it is transformed into raster space if it is in model space; and if the polygonClip value is FALSE, the MBR of the geometry object is used as the window, but if the polygonClip value is TRUE, the polygon geometry object (if valid) is used as the window.bandNumbers
- Band ordinate numbers of the layers for which values are used in computing the statistics. This is a string that can include numbers, number ranges indicated by hyphens (-), and commas to separate numbers and number ranges. For example, '0,1,3-5,7' specifies layers 1, 2, 4, 5, 6, and 8. If bandNumbers is null, all bands are used in computing the statistics.nodata
- Specifies whether or not to compare each cell values with NODATA values defined in the metadata when computing statistics. TRUE causes all pixels with a NODATA value not to be considered; FALSE (the default) causes pixels with NODATA values to be considered as regular pixels.polygonClip
- The value TRUE causes the samplingWindow geometry object to be used for the operation; the value FALSE or a null value causes the MBR (minimum bounding rectangle) of the samplingWindow geometry object to be used for the operation.parallelDegree
- Specifies the degree of parallelism for the operation. If >1. The database optimizer uses the degree of parallelism specified by this parameter. If <=1, then there is no parallel processing. (For more information,see Section 1.13 of Spatial GeoRaster Developer's Guide, "Parallel Processing in GeoRaster").java.lang.Exception
public double generateStatisticsMode(SdoGeoRaster georaster, long pyramidLevel, int samplingFactor, JGeometry samplingWindow, java.lang.String bandNumbers, boolean nodata, boolean polygonClip, int parallelDegree) throws java.lang.Exception
georaster
- source GeoRaster object.pyramidLevel
- Pyramid level on which to perform the operation.samplingFactor
- Sampling factor in the format 'samplingFactor=n', with the denominator n in 1/(n*n) representing the number of cells skipped in both row and column dimensions in computing the statistics. For example, if samplingFactor is 4, one-sixteenth of the cells are sampled; but if samplingFactor is 1, all cells are sampled. The higher the value, the less accurate the statistics are likely to be, but the more quickly they will be computed.samplingWindow
- A rectangular window or a polygon geometry object from which to generate statistics. If the data type is SDO_NUMBER_ARRAY, the parameter identifies the upper-left (row, column) and lower-right (row, column) coordinates of a rectangular window, and raster space is assumed. If the data type is SDO_GEOMETRY, it is transformed into raster space if it is in model space; and if the polygonClip value is FALSE, the MBR of the geometry object is used as the window, but if the polygonClip value is TRUE, the polygon geometry object (if valid) is used as the window.bandNumbers
- Band ordinate numbers of the layers for which values are used in computing the statistics. This is a string that can include numbers, number ranges indicated by hyphens (-), and commas to separate numbers and number ranges. For example, '0,1,3-5,7' specifies layers 1, 2, 4, 5, 6, and 8. If bandNumbers is null, all bands are used in computing the statistics.nodata
- Specifies whether or not to compare each cell values with NODATA values defined in the metadata when computing statistics. TRUE causes all pixels with a NODATA value not to be considered; FALSE (the default) causes pixels with NODATA values to be considered as regular pixels.polygonClip
- The value TRUE causes the samplingWindow geometry object to be used for the operation; the value FALSE or a null value causes the MBR (minimum bounding rectangle) of the samplingWindow geometry object to be used for the operation.parallelDegree
- Specifies the degree of parallelism for the operation. If >1. The database optimizer uses the degree of parallelism specified by this parameter. If <=1, then there is no parallel processing. (For more information,see Section 1.13 of Spatial GeoRaster Developer's Guide, "Parallel Processing in GeoRaster").java.lang.Exception
public double generateStatisticsSTD(SdoGeoRaster georaster, long pyramidLevel, int samplingFactor, long[] samplingWindow, java.lang.String bandNumbers, boolean nodata) throws java.lang.Exception
georaster
- source GeoRaster object.pyramidLevel
- Pyramid level on which to perform the operation.samplingFactor
- Sampling factor in the format 'samplingFactor=n', with the denominator n in 1/(n*n) representing the number of cells skipped in both row and column dimensions in computing the statistics. For example, if samplingFactor is 4, one-sixteenth of the cells are sampled; but if samplingFactor is 1, all cells are sampled. The higher the value, the less accurate the statistics are likely to be, but the more quickly they will be computed.samplingWindow
- A rectangular window or a polygon geometry object from which to generate statistics. If the data type is SDO_NUMBER_ARRAY, the parameter identifies the upper-left (row, column) and lower-right (row, column) coordinates of a rectangular window, and raster space is assumed. If the data type is SDO_GEOMETRY, it is transformed into raster space if it is in model space; and if the polygonClip value is FALSE, the MBR of the geometry object is used as the window, but if the polygonClip value is TRUE, the polygon geometry object (if valid) is used as the window.bandNumbers
- Band ordinate numbers of the layers for which values are used in computing the statistics. This is a string that can include numbers, number ranges indicated by hyphens (-), and commas to separate numbers and number ranges. For example, '0,1,3-5,7' specifies layers 1, 2, 4, 5, 6, and 8. If bandNumbers is null, all bands are used in computing the statistics.nodata
- Specifies whether or not to compare each cell values with NODATA values defined in the metadata when computing statistics. TRUE causes all pixels with a NODATA value not to be considered; FALSE (the default) causes pixels with NODATA values to be considered as regular pixels.java.lang.Exception
public double generateStatisticsSTD(SdoGeoRaster georaster, long pyramidLevel, int samplingFactor, long[] samplingWindow, java.lang.String bandNumbers, boolean nodata, int parallelDegree) throws java.lang.Exception
georaster
- source GeoRaster object.pyramidLevel
- Pyramid level on which to perform the operation.samplingFactor
- Sampling factor in the format 'samplingFactor=n', with the denominator n in 1/(n*n) representing the number of cells skipped in both row and column dimensions in computing the statistics. For example, if samplingFactor is 4, one-sixteenth of the cells are sampled; but if samplingFactor is 1, all cells are sampled. The higher the value, the less accurate the statistics are likely to be, but the more quickly they will be computed.samplingWindow
- A rectangular window or a polygon geometry object from which to generate statistics. If the data type is SDO_NUMBER_ARRAY, the parameter identifies the upper-left (row, column) and lower-right (row, column) coordinates of a rectangular window, and raster space is assumed. If the data type is SDO_GEOMETRY, it is transformed into raster space if it is in model space; and if the polygonClip value is FALSE, the MBR of the geometry object is used as the window, but if the polygonClip value is TRUE, the polygon geometry object (if valid) is used as the window.bandNumbers
- Band ordinate numbers of the layers for which values are used in computing the statistics. This is a string that can include numbers, number ranges indicated by hyphens (-), and commas to separate numbers and number ranges. For example, '0,1,3-5,7' specifies layers 1, 2, 4, 5, 6, and 8. If bandNumbers is null, all bands are used in computing the statistics.nodata
- Specifies whether or not to compare each cell values with NODATA values defined in the metadata when computing statistics. TRUE causes all pixels with a NODATA value not to be considered; FALSE (the default) causes pixels with NODATA values to be considered as regular pixels.parallelDegree
- Specifies the degree of parallelism for the operation. If >1. The database optimizer uses the degree of parallelism specified by this parameter. If <=1, then there is no parallel processing. (For more information,see Section 1.13 of Spatial GeoRaster Developer's Guide, "Parallel Processing in GeoRaster").java.lang.Exception
public double generateStatisticsSTD(SdoGeoRaster georaster, long pyramidLevel, int samplingFactor, JGeometry samplingWindow, java.lang.String bandNumbers, boolean nodata, boolean polygonClip) throws java.lang.Exception
georaster
- source GeoRaster object.pyramidLevel
- Pyramid level on which to perform the operation.samplingFactor
- Sampling factor in the format 'samplingFactor=n', with the denominator n in 1/(n*n) representing the number of cells skipped in both row and column dimensions in computing the statistics. For example, if samplingFactor is 4, one-sixteenth of the cells are sampled; but if samplingFactor is 1, all cells are sampled. The higher the value, the less accurate the statistics are likely to be, but the more quickly they will be computed.samplingWindow
- A rectangular window or a polygon geometry object from which to generate statistics. If the data type is SDO_NUMBER_ARRAY, the parameter identifies the upper-left (row, column) and lower-right (row, column) coordinates of a rectangular window, and raster space is assumed. If the data type is SDO_GEOMETRY, it is transformed into raster space if it is in model space; and if the polygonClip value is FALSE, the MBR of the geometry object is used as the window, but if the polygonClip value is TRUE, the polygon geometry object (if valid) is used as the window.bandNumbers
- Band ordinate numbers of the layers for which values are used in computing the statistics. This is a string that can include numbers, number ranges indicated by hyphens (-), and commas to separate numbers and number ranges. For example, '0,1,3-5,7' specifies layers 1, 2, 4, 5, 6, and 8. If bandNumbers is null, all bands are used in computing the statistics.nodata
- Specifies whether or not to compare each cell values with NODATA values defined in the metadata when computing statistics. TRUE causes all pixels with a NODATA value not to be considered; FALSE (the default) causes pixels with NODATA values to be considered as regular pixels.polygonClip
- The value TRUE causes the samplingWindow geometry object to be used for the operation; the value FALSE or a null value causes the MBR (minimum bounding rectangle) of the samplingWindow geometry object to be used for the operation.java.lang.Exception
public double generateStatisticsSTD(SdoGeoRaster georaster, long pyramidLevel, int samplingFactor, JGeometry samplingWindow, java.lang.String bandNumbers, boolean nodata, boolean polygonClip, int parallelDegree) throws java.lang.Exception
georaster
- source GeoRaster object.pyramidLevel
- Pyramid level on which to perform the operation.samplingFactor
- Sampling factor in the format 'samplingFactor=n', with the denominator n in 1/(n*n) representing the number of cells skipped in both row and column dimensions in computing the statistics. For example, if samplingFactor is 4, one-sixteenth of the cells are sampled; but if samplingFactor is 1, all cells are sampled. The higher the value, the less accurate the statistics are likely to be, but the more quickly they will be computed.samplingWindow
- A rectangular window or a polygon geometry object from which to generate statistics. If the data type is SDO_NUMBER_ARRAY, the parameter identifies the upper-left (row, column) and lower-right (row, column) coordinates of a rectangular window, and raster space is assumed. If the data type is SDO_GEOMETRY, it is transformed into raster space if it is in model space; and if the polygonClip value is FALSE, the MBR of the geometry object is used as the window, but if the polygonClip value is TRUE, the polygon geometry object (if valid) is used as the window.bandNumbers
- Band ordinate numbers of the layers for which values are used in computing the statistics. This is a string that can include numbers, number ranges indicated by hyphens (-), and commas to separate numbers and number ranges. For example, '0,1,3-5,7' specifies layers 1, 2, 4, 5, 6, and 8. If bandNumbers is null, all bands are used in computing the statistics.nodata
- Specifies whether or not to compare each cell values with NODATA values defined in the metadata when computing statistics. TRUE causes all pixels with a NODATA value not to be considered; FALSE (the default) causes pixels with NODATA values to be considered as regular pixels.polygonClip
- The value TRUE causes the samplingWindow geometry object to be used for the operation; the value FALSE or a null value causes the MBR (minimum bounding rectangle) of the samplingWindow geometry object to be used for the operation.parallelDegree
- Specifies the degree of parallelism for the operation. If >1. The database optimizer uses the degree of parallelism specified by this parameter. If <=1, then there is no parallel processing. (For more information,see Section 1.13 of Spatial GeoRaster Developer's Guide, "Parallel Processing in GeoRaster").java.lang.Exception
public java.math.BigDecimal[] generateStatistics(SdoGeoRaster georaster, long pyramidLevel, int samplingFactor, long[] samplingWindow, java.lang.String bandNumbers, boolean nodata) throws java.lang.Exception
georaster
- source GeoRaster object.pyramidLevel
- Pyramid level on which to perform the operation.samplingFactor
- Sampling factor in the format 'samplingFactor=n', with the denominator n in 1/(n*n) representing the number of cells skipped in both row and column dimensions in computing the statistics. For example, if samplingFactor is 4, one-sixteenth of the cells are sampled; but if samplingFactor is 1, all cells are sampled. The higher the value, the less accurate the statistics are likely to be, but the more quickly they will be computed.samplingWindow
- sampling window: a rectangular window for which to set statistics, specified as a numeric array with the lower-left and upper-right coordinates. The window must be inside the extent in cell space. A null value for this parameter indicates the entire image.bandNumbers
- Band ordinate numbers of the layers for which values are used in computing the statistics. This is a string that can include numbers, number ranges indicated by hyphens (-), and commas to separate numbers and number ranges. For example, '0,1,3-5,7' specifies layers 1, 2, 4, 5, 6, and 8. If bandNumbers is null, all bands are used in computing the statistics.nodata
- Specifies whether or not to compare each cell values with NODATA values defined in the metadata when computing statistics. TRUE causes all pixels with a NODATA value not to be considered; FALSE (the default) causes pixels with NODATA values to be considered as regular pixels.java.lang.Exception
public java.math.BigDecimal[] generateStatistics(SdoGeoRaster georaster, long pyramidLevel, int samplingFactor, long[] samplingWindow, java.lang.String bandNumbers, boolean nodata, int parallelDegree) throws java.lang.Exception
georaster
- source GeoRaster object.pyramidLevel
- Pyramid level on which to perform the operation.samplingFactor
- Sampling factor in the format 'samplingFactor=n', with the denominator n in 1/(n*n) representing the number of cells skipped in both row and column dimensions in computing the statistics. For example, if samplingFactor is 4, one-sixteenth of the cells are sampled; but if samplingFactor is 1, all cells are sampled. The higher the value, the less accurate the statistics are likely to be, but the more quickly they will be computed.samplingWindow
- sampling window: a rectangular window for which to set statistics, specified as a numeric array with the lower-left and upper-right coordinates. The window must be inside the extent in cell space. A null value for this parameter indicates the entire image.bandNumbers
- Band ordinate numbers of the layers for which values are used in computing the statistics. This is a string that can include numbers, number ranges indicated by hyphens (-), and commas to separate numbers and number ranges. For example, '0,1,3-5,7' specifies layers 1, 2, 4, 5, 6, and 8. If bandNumbers is null, all bands are used in computing the statistics.nodata
- Specifies whether or not to compare each cell values with NODATA values defined in the metadata when computing statistics. TRUE causes all pixels with a NODATA value not to be considered; FALSE (the default) causes pixels with NODATA values to be considered as regular pixels.parallelDegree
- Specifies the degree of parallelism for the operation. If >1. The database optimizer uses the degree of parallelism specified by this parameter. If <=1, then there is no parallel processing. (For more information,see Section 1.13 of Spatial GeoRaster Developer's Guide, "Parallel Processing in GeoRaster").java.lang.Exception
public java.math.BigDecimal[] generateStatistics(SdoGeoRaster georaster, long pyramidLevel, int samplingFactor, JGeometry samplingWindow, java.lang.String bandNumbers, boolean nodata, boolean polygonClip) throws java.lang.Exception
georaster
- source GeoRaster object.pyramidLevel
- Pyramid level on which to perform the operation.samplingFactor
- Sampling factor in the format 'samplingFactor=n', with the denominator n in 1/(n*n) representing the number of cells skipped in both row and column dimensions in computing the statistics. For example, if samplingFactor is 4, one-sixteenth of the cells are sampled; but if samplingFactor is 1, all cells are sampled. The higher the value, the less accurate the statistics are likely to be, but the more quickly they will be computed.samplingWindow
- Sampling window: a rectangular window for which to set statistics, specified as an SDO_GEOMETRY object. The default for this parameter is the entire image.bandNumbers
- Band ordinate numbers of the layers for which values are used in computing the statistics. This is a string that can include numbers, number ranges indicated by hyphens (-), and commas to separate numbers and number ranges. For example, '0,1,3-5,7' specifies layers 1, 2, 4, 5, 6, and 8. If bandNumbers is null, all bands are used in computing the statistics.nodata
- Specifies whether or not to compare each cell values with NODATA values defined in the metadata when computing statistics. TRUE causes all pixels with a NODATA value not to be considered; FALSE (the default) causes pixels with NODATA values to be considered as regular pixels.polygonClip
- The value TRUE causes the samplingWindow geometry object to be used for the operation; the string FALSE or a null value causes the MBR (minimum bounding rectangle) of the samplingWindow geometry object to be used for the operation.java.lang.Exception
public java.math.BigDecimal[] generateStatistics(SdoGeoRaster georaster, long pyramidLevel, int samplingFactor, JGeometry samplingWindow, java.lang.String bandNumbers, boolean nodata, boolean polygonClip, int parallelDegree) throws java.lang.Exception
georaster
- source GeoRaster object.pyramidLevel
- Pyramid level on which to perform the operation.samplingFactor
- Sampling factor in the format 'samplingFactor=n', with the denominator n in 1/(n*n) representing the number of cells skipped in both row and column dimensions in computing the statistics. For example, if samplingFactor is 4, one-sixteenth of the cells are sampled; but if samplingFactor is 1, all cells are sampled. The higher the value, the less accurate the statistics are likely to be, but the more quickly they will be computed.samplingWindow
- Sampling window: a rectangular window for which to set statistics, specified as an SDO_GEOMETRY object. The default for this parameter is the entire image.bandNumbers
- Band ordinate numbers of the layers for which values are used in computing the statistics. This is a string that can include numbers, number ranges indicated by hyphens (-), and commas to separate numbers and number ranges. For example, '0,1,3-5,7' specifies layers 1, 2, 4, 5, 6, and 8. If bandNumbers is null, all bands are used in computing the statistics.nodata
- Specifies whether or not to compare each cell values with NODATA values defined in the metadata when computing statistics. TRUE causes all pixels with a NODATA value not to be considered; FALSE (the default) causes pixels with NODATA values to be considered as regular pixels.polygonClip
- The value TRUE causes the samplingWindow geometry object to be used for the operation; the string FALSE or a null value causes the MBR (minimum bounding rectangle) of the samplingWindow geometry object to be used for the operation.parallelDegree
- Specifies the degree of parallelism for the operation. If >1. The database optimizer uses the degree of parallelism specified by this parameter. If <=1, then there is no parallel processing. (For more information,see Section 1.13 of Spatial GeoRaster Developer's Guide, "Parallel Processing in GeoRaster").java.lang.Exception
public void rectify(SdoGeoRaster inGeoRaster, java.lang.Integer pyramidLevel, java.lang.String elevationParam, SdoGeoRaster dem, java.lang.Integer outSRID, java.lang.Integer outModelCoordLoc, JGeometry cropArea, boolean polygonClip, java.lang.String layerNumbers, double[] outResolutions, java.lang.String resolutionUnit, JGeometry referencePoint, java.lang.String resampleParam, java.lang.String storageParam, SdoGeoRaster outGeoRaster, double[] bgValues, int parallelDegree) throws java.lang.Exception
inGeoRaster
- GeoRaster object on which to perform the operation. It must be georeferenced.pyramidLevel
- Pyramid level of the source GeoRaster object for the operation. For BLOB output, this parameter is required. For SDO_GEORASTER output, if this parameter is null and the storageParam pyramid value is FALSE, only the pyramid level 0 is rectified and the output will have only level 0. If this parameter is null and the storageParam pyramid value is TRUE, all the pyramid levels from the input are rectified. If the number 0 or greater is specified, only that pyramid level is used for the rectification, producing a result in scale based on that pyramid level image.elevationParam
- A string containing one or more of the elevation parameters average (average surface height), scale (scale value applied to all DEM values), and offset (offset applied to all DEM values), where the new value is (value + offset) * scale. This parameter must be a quoted string that contains one or more keyword=value pairs (for example, 'average=800 scale=3.2808399 offset=10'). If this parameter is null, 0 is assumed for average and offset, and 1 is used for scale. Any scale and offset values are ignored if DEM is not specified. The use of the elevationParam parameter requires that the input GeoRaster object have a 3D model SRID. When the input GeoRaster object has a 3D model SRID, the average elevation is important for defining the extents of the output image. If that information is available, it should be specified even if DEM is also specified. If the average elevation is not specified, the procedure will calculate an approximate value for the average elevation.DEM
- GeoRaster object with a digital elevation model (DEM); used to perform orthorectification, as explained in the Usage Notes. Must have the same SRID as outGeoRaster. The DEM area should cover the entire outGeoRaster area, or the cropArea if used. The elevation data is assumed to be on the first layer of the DEM GeoRaster object. If this parameter is null, the elevationParam value is used. For best results, the resolution of the DEM GeoRaster object should be close to the resolution of the input GeoRaster object. The use of the DEM parameter requires that the input GeoRaster object have a 3D model SRID. When the input GeoRaster object has a 3D model SRID, the average elevation is important for defining the extents of the output image. If that information is available, it should be specified in the elevationParam parameter even if DEM is also specified. If the average elevation is not specified, the procedure will calculate an approximate value for the average elevation.outSRID
- Coordinate system for the output GeoRaster object. Must be either null or a value from the SRID column of the MDSYS.CS_SRS table.If it is null, the output GeoRaster object will have the same SRID as the input GeoRaster object.outModelCoordLoc
- A value specifying the model location of the base of the area represented by a cell: 0 for CENTER or 1 for UPPERLEFT. If null, CENTER is used.cropArea
- Crop area definition. If null, no cropping is performed, and polygonClip is ignored. If polygonClip is FALSE, the MBR of the cropArea is used to crop the output image. If polygonClip is TRUE, the geometry of the cropArea is used to crop the output image. Areas outside the crop area are filled with the background valuepolygonClip
- Ignored if cropArea is null. Otherwise, the string TRUE causes the cropArea value to be used to crop the mosaicked data; the string FALSE or a null value causes the MBR of cropArea to be used to crop the output image.layerNumbers
- A string identifying the logical layer numbers for the rectification and the output to outGeoRaster. Use commas to delimit the values, and a hyphen to indicate a range (for example, 2-4 for layers 2, 3, and 4).outResolutions
- An array of numeric values, one for each spatial dimension. Each value indicates the number of units of measure associated with the data area represented by that spatial dimension of a pixel. For example, if the spatial resolution values are (10,10) and the unit of measure for the ground data is meters, each pixel represents an area of 10 meters by 10 meters. If null, the default is the resolution of the source data at the specified pyramid level.resolutionUnit
- The unit of the outResolutions parameter. If resolutionUnit is different from the outGeoRaster SRID unit, an appropriate conversion is computed (the value of the output resolution is calculated by converting the outResolutions value in resolutionUnit to the unit of the output SRID) . If resolutionUnit is null, the default is the unit of the output SRID. If specified, it must be a quoted string in the format "unit=value" where value is the unit name. This parameter is ignored if outResolutions is null.referencePoint
- A point of type SDO_GEOMETRY indicating a reference to where the outGeoRaster object should be aligned so that the distance between the referencePoint and the upper-left corner of the output will have an integer number of pixels.resampleParam
- A comma-separated quoted string of keyword=value pairs for specifying resampling parameters. See the Usage Notes for more information.storageParam
- A string specifying storage parameters, as explained in Section 1.4.1.outGeoRaster
- GeoRaster object to hold the result of the operation. Must be either a valid existing GeoRaster object or an empty GeoRaster object. (Empty GeoRaster objects are explained in Section 1.4.3.) Cannot be the same GeoRaster object as inGeoRasterbgValues
- Background values for filling partially empty raster blocks. It is only useful when the source GeoRaster object has empty raster blocks and the current operation leads to partially empty raster blocks (see Section 1.4.4). The number of elements in the SDO_NUMBER_ARRAY object must be either one (same filling value used for all bands) or the band dimension size (a different filling value for each band, respectively). For example, SDO_NUMBER_ARRAY(1,5,10) fills the first band with 1, the second band with 5, and the third band with 10. The default bgValues are zero (0).java.lang.Exception
public void rectify(SdoGeoRaster inGeoRaster, java.lang.Integer pyramidLevel, java.lang.String elevationParam, SdoGeoRaster dem, java.lang.Integer outSRID, java.lang.Integer outModelCoordLoc, JGeometry cropArea, boolean polygonClip, java.lang.String layerNumbers, double[] outResolutions, java.lang.String resolutionUnit, JGeometry referencePoint, java.lang.String resampleParam, java.lang.String storageParam, java.sql.Blob rasterBlob, JGeometry[] outArea, java.math.BigDecimal[] outWindow, double[] bgValues) throws java.lang.Exception
inGeoRaster
- GeoRaster object on which to perform the operation. It must be georeferenced.pyramidLevel
- Pyramid level of the source GeoRaster object for the operation. For BLOB output, this parameter is required. For SDO_GEORASTER output, if this parameter is null and the storageParam pyramid value is FALSE, only the pyramid level 0 is rectified and the output will have only level 0. If this parameter is null and the storageParam pyramid value is TRUE, all the pyramid levels from the input are rectified. If the number 0 or greater is specified, only that pyramid level is used for the rectification, producing a result in scale based on that pyramid level image.elevationParam
- A string containing one or more of the elevation parameters average (average surface height), scale (scale value applied to all DEM values), and offset (offset applied to all DEM values), where the new value is (value + offset) * scale. This parameter must be a quoted string that contains one or more keyword=value pairs (for example, 'average=800 scale=3.2808399 offset=10'). If this parameter is null, 0 is assumed for average and offset, and 1 is used for scale. Any scale and offset values are ignored if DEM is not specified. The use of the elevationParam parameter requires that the input GeoRaster object have a 3D model SRID. When the input GeoRaster object has a 3D model SRID, the average elevation is important for defining the extents of the output image. If that information is available, it should be specified even if DEM is also specified. If the average elevation is not specified, the procedure will calculate an approximate value for the average elevation.DEM
- GeoRaster object with a digital elevation model (DEM); used to perform orthorectification, as explained in the Usage Notes. Must have the same SRID as outGeoRaster. The DEM area should cover the entire outGeoRaster area, or the cropArea if used. The elevation data is assumed to be on the first layer of the DEM GeoRaster object. If this parameter is null, the elevationParam value is used. For best results, the resolution of the DEM GeoRaster object should be close to the resolution of the input GeoRaster object. The use of the DEM parameter requires that the input GeoRaster object have a 3D model SRID. When the input GeoRaster object has a 3D model SRID, the average elevation is important for defining the extents of the output image. If that information is available, it should be specified in the elevationParam parameter even if DEM is also specified. If the average elevation is not specified, the procedure will calculate an approximate value for the average elevation.outSRID
- Coordinate system for the output GeoRaster object. Must be either null or a value from the SRID column of the MDSYS.CS_SRS table.If it is null, the output GeoRaster object will have the same SRID as the input GeoRaster object.outModelCoordLoc
- A value specifying the model location of the base of the area represented by a cell: 0 for CENTER or 1 for UPPERLEFT. If null, CENTER is used.cropArea
- Crop area definition. If null, no cropping is performed, and polygonClip is ignored. If polygonClip is FALSE, the MBR of the cropArea is used to crop the output image. If polygonClip is TRUE, the geometry of the cropArea is used to crop the output image. Areas outside the crop area are filled with the background valuepolygonClip
- Ignored if cropArea is null. Otherwise, the string TRUE causes the cropArea value to be used to crop the mosaicked data; the string FALSE or a null value causes the MBR of cropArea to be used to crop the output image.layerNumbers
- A string identifying the logical layer numbers for the rectification and the output to outGeoRaster. Use commas to delimit the values, and a hyphen to indicate a range (for example, 2-4 for layers 2, 3, and 4).outResolutions
- An array of numeric values, one for each spatial dimension. Each value indicates the number of units of measure associated with the data area represented by that spatial dimension of a pixel. For example, if the spatial resolution values are (10,10) and the unit of measure for the ground data is meters, each pixel represents an area of 10 meters by 10 meters. If null, the default is the resolution of the source data at the specified pyramid level.resolutionUnit
- The unit of the outResolutions parameter. If resolutionUnit is different from the outGeoRaster SRID unit, an appropriate conversion is computed (the value of the output resolution is calculated by converting the outResolutions value in resolutionUnit to the unit of the output SRID) . If resolutionUnit is null, the default is the unit of the output SRID. If specified, it must be a quoted string in the format "unit=value" where value is the unit name. This parameter is ignored if outResolutions is null.referencePoint
- A point of type SDO_GEOMETRY indicating a reference to where the outGeoRaster object should be aligned so that the distance between the referencePoint and the upper-left corner of the output will have an integer number of pixels.resampleParam
- A comma-separated quoted string of keyword=value pairs for specifying resampling parameters. See the Usage Notes for more information.storageParam
- A string specifying storage parameters, as explained in Section 1.4.1.rasterBlob
- BLOB to hold the output reflecting the rectification. It must exist or have been initialized before the operation.outArea
- An SDO_GEOMETRY object containing the MBR (minimum bounding rectangle) in the model coordinate system of the resulting object.outWindow
- An SDO_NUMBER_ARRAY object identifying the coordinates of the upper-left and lower-right corners of the output window in the cell space.bgValues
- Background values for filling partially empty raster blocks. It is only useful when the source GeoRaster object has empty raster blocks and the current operation leads to partially empty raster blocks (see Section 1.4.4). The number of elements in the SDO_NUMBER_ARRAY object must be either one (same filling value used for all bands) or the band dimension size (a different filling value for each band, respectively). For example, SDO_NUMBER_ARRAY(1,5,10) fills the first band with 1, the second band with 5, and the third band with 10. The default bgValues are zero (0).java.lang.Exception
public void mask(SdoGeoRaster inGeoRaster, java.lang.String bandNumbers, SdoGeoRaster mask, java.lang.String storageParam, SdoGeoRaster outGeoRaster, double zeroMapping, double oneMapping, double[] bgValues) throws java.lang.Exception
inGeoRaster
- The SDO_GEORASTER object on which the mask operation is to be performed to create the new object.bandNumbers
- A string identifying the physical band numbers on which the operation is to be performed. Use commas to delimit the values, and a hyphen to indicate a range (for example, 1-3 for the second, third, and forth layers).mask
- The SDO_GEORASTER object to be used as a mask on the input GeoRaster object for generating the output GeoRaster object. If this parameter is specified as null, then available attached masks of the input GeoRaster object are applied to the specified layers.storageParam
- a string specifying storage parametersoutGeoRaster
- The new SDO_GEORASTER object that reflects the results of the mask operation. Must be either a valid existing GeoRaster object or an empty GeoRaster object. (Empty GeoRaster objects are explained in Section 1.4.3.) Cannot be the same GeoRaster object as inGeoRaster. If the output GeoRaster object has any existing raster data, it is deleted before the mask operation is performed. The output GeoRaster object is overwritten as a result of this function.zeroMapping
- Value used for mask cell value 0 (zero). The default value is 0.oneMapping
- Value used for mask cell value 1 (one). The default value is 1.bgValues
- Background values for filling partially empty raster blocks. It is only useful when the source GeoRaster object has empty raster blocks and the current operation leads to partially empty raster blocks (see Section 1.4.4). The number of elements in the SDO_NUMBER_ARRAY object must be either one (same filling value used for all layers) or the band dimension size (a different filling value for each layer, respectively). For example, SDO_NUMBER_ARRAY(1,5,10) fills the first layer with 1, the second layer with 5, and the third layer with 10. The default bgValues are zero (0). The filling values must be valid cell values as specified by the target cell depth background values for filling sparse data.java.lang.Exception
public double[] getRasterRange(SdoGeoRaster geoRaster, int layerNumber) throws java.lang.Exception
geoRaster
- source GeoRaster objects.layerNumber
- Number of the layer for which to return the range of cell values. A value of 0 (zero, the default) indicates the object layer. (As mentioned in Section 1.5, the logical layer number is the physical band number plus 1.)java.lang.Exception
public java.sql.Blob getRasterBlockLocator(SdoGeoRaster geoRaster, long pyramidLevel, long bandBlockNumber, long rowBlockNumber, long columnBlockNumber, boolean isBitmapMask, boolean lock_for_write) throws java.lang.Exception
geoRaster
- GeoRaster object.pyramidLevel
- Pyramid level of the block.bandBlockNumber
- Band number of the block.rowBlockNumber
- Row number of the block.columnBlockNumber
- Column number of the block.isBitmapMask
- A boolean value to specifies that a bitmap mask block will be accessed or a regular raster block will be accessed.lock_for_write
- A boolean value TRUE locks the row in the raster data table so that other users cannot lock or update that row until the current transaction ends; the boolean value FALSE does not lock the row in the raster data table. The default bgValues are zero (0).java.lang.Exception
public java.sql.Blob getRasterBlockLocator2(SdoGeoRaster geoRaster, long pyramidLevel, long rowNumber, long columnNumber, long bandNumber, boolean isBitmapMask, boolean lock_for_write) throws java.lang.Exception
geoRaster
- GeoRaster object.pyramidLevel
- Pyramid level of the block.rowNumber
- Row number of the cell.columnNumber
- Column number of the cell.bandNumber
- Band number of the cell.isBitmapMask
- A boolean value to specifies that a bitmap mask block will be accessed or a regular raster block will be accessed.lock_for_write
- A boolean value TRUE locks the row in the raster data table so that other users cannot lock or update that row until the current transaction ends; the boolean value FALSE does not lock the row in the raster data table. The default bgValues are zero (0).java.lang.Exception
public java.sql.Blob getRasterBlockLocator2(SdoGeoRaster geoRaster, long pyramidLevel, JGeometry ptGeom, long layerNumber, boolean isBitmapMask, boolean lock_for_write) throws java.lang.Exception
geoRaster
- GeoRaster object.pyramidLevel
- Pyramid level of the block.ptGeom
- Point geometry that locates the cell.layerNumber
- Layer number of the cell.isBitmapMask
- A boolean value to specifies that a bitmap mask block will be accessed or a regular raster block will be accessed.lock_for_write
- A boolean value TRUE locks the row in the raster data table so that other users cannot lock or update that row until the current transaction ends; the boolean value FALSE does not lock the row in the raster data table. The default bgValues are zero (0).java.lang.Exception
public java.math.BigDecimal[] generateSpatialResolutions(SdoGeoRaster geoRaster, long pyramidLevel, java.lang.Integer SRID, java.lang.String resolutionUnit) throws java.lang.Exception
geoRaster
- GeoRaster object.pyramidLevel
- Pyramid level of the returned resolution values.SRID
- Coordinate system. Must be a value from the SRID column of the MDSYS.CS_SRS table. The srid value cannot be 0 (zero). If not specified, the default is the SRID associated with georaster.resolutionUnit
- Unit of measurement: a quoted string with unit=. If not specified, the unit associated with SRID is used.java.lang.Exception
public java.math.BigDecimal[] generateSpatialResolutions(SdoGeoRaster geoRaster) throws java.lang.Exception
geoRaster
- GeoRaster object.java.lang.Exception
public void changeFormatCopy(SdoGeoRaster source, java.lang.String storageParam, SdoGeoRaster target, double[] bgValues) throws java.lang.Exception
source
- source GeoRaster objectstorageParam
- a string specifying storage parameterstarget
- target GeoRaster objectbgValues
- background values for filling partially empty raster blocks. It is only useful when the source GeoRaster object has empty raster blocks and the current operation leads to partially empty raster blocks.
The number of elements must be either one (same filling value used for all bands) or the band dimension size (a different filling value for each band, respectively). The filling values must be valid cell values as specified by the target cell depth background values for filling sparse data.
java.lang.Exception
public void copy(SdoGeoRaster source, SdoGeoRaster target) throws java.lang.Exception
source
- source GeoRaster objecttarget
- target GeoRaster objectjava.lang.Exception
public void mergeLayers(SdoGeoRaster source, java.lang.String sourceLayerNumbers, SdoGeoRaster target, double[] bgValues) throws java.lang.Exception
source
- source GeoRaster objectsourceLayerNumbers
- String specifying one or more layer numbers of layers in source GeoRaster object to be appended to target georaster object. Use commas to delimit numbers or ranges, and use a hyphen to indicate a range. Example: '1,3-5,7' for layers 1, 3, 4, 5, and 7.target
- target GeoRaster objectbgValues
- background values for filling partially empty raster blocks. It is only useful when the source GeoRaster object has empty raster blocks and the current operation leads to partially empty raster blocks.
The number of elements must be either one (same filling value used for all bands) or the band dimension size (a different filling value for each band, respectively). The filling values must be valid cell values as specified by the target cell depth background values for filling sparse data.
java.lang.Exception
public void mergeLayers(SdoGeoRaster source1, java.lang.String source1LayerNumbers, SdoGeoRaster source2, java.lang.String source2LayerNumbers, java.lang.String storageParam, SdoGeoRaster target, double[] bgValues) throws java.lang.Exception
source1
- the first source GeoRaster objectsource1LayerNumbers
- String specifying one or more layer numbers of layers in the first source GeoRaster object to be appended to target GeoRaster object. Use commas to delimit numbers or ranges, and use a hyphen to indicate a range. Example: '1,3-5,7' for layers 1,3, 4, 5, and 7.source2
- the second source GeoRaster objectsource2LayerNumbers
- String specifying one or more layer numbers of layers in the second source GeoRaster object to be appended to the target GeoRaster object. Use commas to delimit numbers or ranges, and use a hyphen to indicate a range. Example: '1,3-5,7' for layers 1,3, 4, 5, and 7.storageParam
- a string specifying storage parameterstarget
- target GeoRaster objectbgValues
- background values for filling partially empty raster blocks. It is only useful when the source GeoRaster object has empty raster blocks and the current operation leads to partially empty raster blocks.
The number of elements must be either one (same filling value used for all bands) or the band dimension size (a different filling value for each band, respectively). The filling values must be valid cell values as specified by the target cell depth background values for filling sparse data.
java.lang.Exception
public void mosaic(java.lang.String georasterTableName, java.lang.String georasterColumnName, SdoGeoRaster target, java.lang.String storageParam, double[] bgValues) throws java.lang.Exception
georasterTableName
- name of the table containing all source GeoRaster objectsgeorasterColumnName
- column of type SDO_GEORASTER in georasterTableName.target
- target GeoRaster object to hold the result of the mosaic operationstorageParam
- a string specifying storage parametersbgValues
- background values for filling partially empty raster blocks. It is only useful when the source GeoRaster object has empty raster blocks and the current operation leads to partially empty raster blocks.
The number of elements must be either one (same filling value used for all bands) or the band dimension size (a different filling value for each band, respectively). The filling values must be valid cell values as specified by the target cell depth background values for filling sparse data.
java.lang.Exception
public void scaleCopy(SdoGeoRaster source, java.lang.String scaleParam, java.lang.String resampleParam, java.lang.String storageParam, SdoGeoRaster target, double[] bgValues) throws java.lang.Exception
source
- source GeoRaster objectsscaleParam
- a string specifying a scaling parameter keyword and its associated value. The keyword must be scaleFactor or maxDimSize:
scaleFactor: to reduce or enlarge as a multiple of the original size. This keyword must have a numeric value greater than 0 (zero) (for example, 'scaleFactor=0.75'). A value of 1.0 will not change the current size; a value less than 1 will reduce the image; a value greater than 1 will enlarge the image. The number of cells along each dimension is the original number multiplied by scaleFactor. For example, if the scaleFactor value is 2 and the GeoRaster object has X and Y dimensions, the number of cells along each dimension is doubled.
maxDimSize: to specify a size in terms of the maximum number of cells for each dimension. This keyword must have a numeric value for each dimension (for example, 'maxDimSize=(512,512)'). The aspect ratio is not changed.
resampleParam
- a string specifying a resampling parameter (for example, 'resampling=NN'). For the current release, the only supported keyword is resampling, and its value must be one of the following:
NN: value of the nearest neighbor cell in the original GeoRaster object
BILINEAR: distance-weighted average of the 4 nearest cells in the original GeoRaster object
AVERAGE4: simple average of the 4 nearest cells in the original GeoRaster object
AVERAGE16: simple average of the 16 nearest cells in the original GeoRaster object
CUBIC: cubic convolution of the 16 nearest cells in the original GeoRaster object
storageParam
- a string specifying storage parameterstarget
- target GeoRaster object to hold the result of the scaleCopy operation.bgValues
- background values for filling partially empty raster blocks. It is only useful when the source GeoRaster object has empty raster blocks and the current operation leads to partially empty raster blocks.
The number of elements must be either one (same filling value used for all bands) or the band dimension size (a different filling value for each band, respectively). The filling values must be valid cell values as specified by the target cell depth background values for filling sparse data.
java.lang.Exception
public void scaleCopy(SdoGeoRaster source, java.lang.String scaleParam, int pyramidLevel, java.lang.String resampleParam, java.lang.String storageParam, SdoGeoRaster target, double[] bgValues) throws java.lang.Exception
source
- source GeoRaster objectsscaleParam
- a string specifying a scaling parameter keyword and its associated value. The keyword must be scaleFactor or maxDimSize:
scaleFactor: to reduce or enlarge as a multiple of the original size. This keyword must have a numeric value greater than 0 (zero) (for example, 'scaleFactor=0.75'). A value of 1.0 will not change the current size; a value less than 1 will reduce the image; a value greater than 1 will enlarge the image. The number of cells along each dimension is the original number multiplied by scaleFactor. For example, if the scaleFactor value is 2 and the GeoRaster object has X and Y dimensions, the number of cells along each dimension is doubled.
maxDimSize: to specify a size in terms of the maximum number of cells for each dimension. This keyword must have a numeric value for each dimension (for example, 'maxDimSize=(512,512)'). The aspect ratio is not changed.
pyramidLevel
- pyramid levelresampleParam
- a string specifying a resampling parameter (for example, 'resampling=NN'). For the current release, the only supported keyword is resampling, and its value must be one of the following:
NN: value of the nearest neighbor cell in the original GeoRaster object
BILINEAR: distance-weighted average of the 4 nearest cells in the original GeoRaster object
AVERAGE4: simple average of the 4 nearest cells in the original GeoRaster object
AVERAGE16: simple average of the 16 nearest cells in the original GeoRaster object
CUBIC: cubic convolution of the 16 nearest cells in the original GeoRaster object
storageParam
- a string specifying storage parameterstarget
- target GeoRaster object to hold the result of the scaleCopy operation.bgValues
- background values for filling partially empty raster blocks. It is only useful when the source GeoRaster object has empty raster blocks and the current operation leads to partially empty raster blocks.
The number of elements must be either one (same filling value used for all bands) or the band dimension size (a different filling value for each band, respectively). The filling values must be valid cell values as specified by the target cell depth background values for filling sparse data.
java.lang.Exception
public void updateRaster(SdoGeoRaster target, int targetPyramidLevel, java.lang.String targetLayerNumbers, long[] targetArea, SdoGeoRaster source, int sourcePyramidLevel, java.lang.String sourceLayerNumbers, boolean updateUpperPyramids, double[] bgValues) throws java.lang.Exception
target
- target GeoRaster objecttargetPyramidLevel
- pyramid level of target GeoRaster objecttargetLayerNumbers
- String specifying one or more layer numbers of layers in the target GeoRaster object to be updated. Use commas to delimit numbers or ranges, and use a hyphen to indicate a range. Example: '1,3-5,7' for layers 1, 3, 4, 5, and 7.targetArea
- area to be updated in targetGeoRaster: a rectangular window, specified by a numeric array with the lower-left and upper-right coordinates.source
- source GeoRaster objectsourcePyramidLevel
- pyramid level of source GeoRaster objectsourceLayerNumbers
- string specifying one or more layer numbers of layers in sourceGeoRaster to be used to update targetGeoRaster. Use commas to delimit numbers or ranges, and use a hyphen to indicate a range. Example: '1,3-5,7' for layers 1, 3, 4, 5, and 7. Any layers that you specify for this parameter must be compatible with the layers to be updated in the target GeoRaster object.updateUpperPyramids
- TRUE or FALSE to specify whether to update upper-level pyramids.bgValues
- background values for filling partially empty raster blocks. It is only useful when the source GeoRaster object has empty raster blocks and the current operation leads to partially empty raster blocks.
The number of elements must be either one (same filling value used for all bands) or the band dimension size (a different filling value for each band, respectively). The filling values must be valid cell values as specified by the target cell depth background values for filling sparse data.
java.lang.Exception
public void updateRaster(SdoGeoRaster target, int targetPyramidLevel, java.lang.String targetLayerNumbers, JGeometry targetArea, SdoGeoRaster source, int sourcePyramidLevel, java.lang.String sourceLayerNumbers, boolean updateUpperPyramids, double[] bgValues) throws java.lang.Exception
target
- target GeoRaster objecttargetPyramidLevel
- pyramid level of target GeoRaster objecttargetLayerNumbers
- String specifying one or more layer numbers of layers in the target GeoRaster object to be updated. Use commas to delimit numbers or ranges, and use a hyphen to indicate a range. Example: '1,3-5,7' for layers 1, 3, 4, 5, and 7.targetArea
- area to be updated in targetGeoRaster.source
- source GeoRaster objectsourcePyramidLevel
- pyramid level of source GeoRaster objectsourceLayerNumbers
- string specifying one or more layer numbers of layers in sourceGeoRaster to be used to update targetGeoRaster. Use commas to delimit numbers or ranges, and use a hyphen to indicate a range. Example: '1,3-5,7' for layers 1, 3, 4, 5, and 7. Any layers that you specify for this parameter must be compatible with the layers to be updated in the target GeoRaster object.updateUpperPyramids
- TRUE or FALSE to specify whether to update upper-level pyramids.bgValues
- background values for filling partially empty raster blocks. It is only useful when the source GeoRaster object has empty raster blocks and the current operation leads to partially empty raster blocks.
The number of elements must be either one (same filling value used for all bands) or the band dimension size (a different filling value for each band, respectively). The filling values must be valid cell values as specified by the target cell depth background values for filling sparse data.
java.lang.Exception
public void subset(SdoGeoRaster source, JGeometry cropArea, java.lang.String layerNumbers, java.lang.String storageParam, SdoGeoRaster target, double[] bgValues) throws java.lang.Exception
source
- source GeoRaster objectscropArea
- crop area definitionlayerNumbers
- a string identifying the logical layer numbers on which the operation or operations are to be performed. Use commas to delimit the values, and a hyphen to indicate a range (for example, 2-4 for layers 2, 3, and 4).storageParam
- a string specifying storage parameterstarget
- target GeoRaster object to hold the result of the subset operation.bgValues
- background values for filling partially empty raster blocks. It is only useful when the source GeoRaster object has empty raster blocks and the current operation leads to partially empty raster blocks.
The number of elements must be either one (same filling value used for all bands) or the band dimension size (a different filling value for each band, respectively). The filling values must be valid cell values as specified by the target cell depth background values for filling sparse data.
java.lang.Exception
public void subset(SdoGeoRaster source, JGeometry cropArea, java.lang.String layerNumbers, java.lang.String storageParam, SdoGeoRaster target, double[] bgValues, java.lang.String polygonClip) throws java.lang.Exception
source
- source GeoRaster objectscropArea
- crop area definitionlayerNumbers
- a string identifying the logical layer numbers on which the operation or operations are to be performed. Use commas to delimit the values, and a hyphen to indicate a range (for example, 2-4 for layers 2, 3, and 4).storageParam
- a string specifying storage parameterstarget
- target GeoRaster object to hold the result of the subset operation.bgValues
- background values for filling partially empty raster blocks. It is only useful when the source GeoRaster object has empty raster blocks and the current operation leads to partially empty raster blocks.
The number of elements must be either one (same filling value used for all bands) or the band dimension size (a different filling value for each band, respectively). The filling values must be valid cell values as specified by the target cell depth background values for filling sparse data.
polygonClip
- The string TRUE causes the clipping window (cropArea geometry object) to be used for the subset operation; the string FALSE or a null value causes the MBR (minimum bounding rectangle) of the clipping window to be used for the subset operation.java.lang.Exception
public void subset(SdoGeoRaster source, int pyramid, JGeometry cropArea, java.lang.String layerNumbers, java.lang.String storageParam, SdoGeoRaster target, double[] bgValues) throws java.lang.Exception
source
- source GeoRaster objectspyramid
- pyramid levelcropArea
- crop area definitionlayerNumbers
- a string identifying the logical layer numbers on which the operation or operations are to be performed. Use commas to delimit the values, and a hyphen to indicate a range (for example, 2-4 for layers 2, 3, and 4).storageParam
- a string specifying storage parameterstarget
- target GeoRaster object to hold the result of the subset operation.bgValues
- background values for filling partially empty raster blocks. It is only useful when the source GeoRaster object has empty raster blocks and the current operation leads to partially empty raster blocks.
The number of elements must be either one (same filling value used for all bands) or the band dimension size (a different filling value for each band, respectively). The filling values must be valid cell values as specified by the target cell depth background values for filling sparse data.
java.lang.Exception
public void subset(SdoGeoRaster source, int pyramid, JGeometry cropArea, java.lang.String layerNumbers, java.lang.String storageParam, SdoGeoRaster target, double[] bgValues, java.lang.String polygonClip) throws java.lang.Exception
source
- source GeoRaster objectspyramid
- pyramid levelcropArea
- crop area definitionlayerNumbers
- a string identifying the logical layer numbers on which the operation or operations are to be performed. Use commas to delimit the values, and a hyphen to indicate a range (for example, 2-4 for layers 2, 3, and 4).storageParam
- a string specifying storage parameterstarget
- target GeoRaster object to hold the result of the subset operation.bgValues
- background values for filling partially empty raster blocks. It is only useful when the source GeoRaster object has empty raster blocks and the current operation leads to partially empty raster blocks.
The number of elements must be either one (same filling value used for all bands) or the band dimension size (a different filling value for each band, respectively). The filling values must be valid cell values as specified by the target cell depth background values for filling sparse data.
polygonClip
- The string TRUE causes the clipping window (cropArea geometry object) to be used for the subset operation; the string FALSE or a null value causes the MBR (minimum bounding rectangle) of the clipping window to be used for the subset operation.java.lang.Exception
public void subset(SdoGeoRaster source, long[] cropArea, java.lang.String layerNumbers, java.lang.String storageParam, SdoGeoRaster target, double[] bgValues) throws java.lang.Exception
source
- source GeoRaster objectscropArea
- crop area definitionlayerNumbers
- a string identifying the logical layer numbers on which the operation or operations are to be performed. Use commas to delimit the values, and a hyphen to indicate a range (for example, 2-4 for layers 2, 3, and 4).storageParam
- a string specifying storage parameterstarget
- target GeoRaster object to hold the result of the subset operation.bgValues
- background values for filling partially empty raster blocks. It is only useful when the source GeoRaster object has empty raster blocks and the current operation leads to partially empty raster blocks.
The number of elements must be either one (same filling value used for all bands) or the band dimension size (a different filling value for each band, respectively). The filling values must be valid cell values as specified by the target cell depth background values for filling sparse data.
java.lang.Exception
public void subset(SdoGeoRaster source, int pyramid, long[] cropArea, java.lang.String layerNumbers, java.lang.String storageParam, SdoGeoRaster target, double[] bgValues) throws java.lang.Exception
source
- source GeoRaster objectspyramid
- pyramid levelcropArea
- crop area definitionlayerNumbers
- a string identifying the logical layer numbers on which the operation or operations are to be performed. Use commas to delimit the values, and a hyphen to indicate a range (for example, 2-4 for layers 2, 3, and 4).storageParam
- a string specifying storage parameterstarget
- target GeoRaster object to hold the result of the subset operation.bgValues
- background values for filling partially empty raster blocks. It is only useful when the source GeoRaster object has empty raster blocks and the current operation leads to partially empty raster blocks.
The number of elements must be either one (same filling value used for all bands) or the band dimension size (a different filling value for each band, respectively). The filling values must be valid cell values as specified by the target cell depth background values for filling sparse data.
java.lang.Exception
public void georeference(SdoGeoRaster georaster, int srid, int modelCoordinateLocation, double[] xCoefficients, double[] yCoefficients) throws java.lang.Exception
georaster
- the SDO_GEORASTER object to be georeferencedsrid
- model coordinate system. Must not be null or 0 (zero). It can be a value from the SRID column of the MDSYS.CS_SRS table. If it is not a value from the SRID column of the MDSYS.CS_SRS table, the SRID is not supported by Oracle Spatial, and some SRID-related operations may not be supported.modelCoordinateLocation
- a value specifying the model location of the base of the area represented by a cell: 0 for CENTER or 1 for UPPERLEFT.xCoefficients
- an array specifying the A, B, and C coefficient values in the calculationyCoefficients
- an array specifying the D, E, and F coefficient values in the calculationjava.lang.Exception
public void getBitmapMask(SdoGeoRaster source, int layer, java.lang.String storageParam, SdoGeoRaster target) throws java.lang.Exception
source
- source GeoRaster objectlayer
- the layer on which to perform the operation. A value of 0 (zero) indicates the object layer.storageParam
- a string specifying storage parameterstarget
- target GeoRaster objectjava.lang.Exception
public void setBitmapMask(SdoGeoRaster georaster, int layer, SdoGeoRaster mask, java.lang.Integer NODATAMask) throws java.lang.Exception
georaster
- GeoRaster object.layer
- the layer on which to perform the operation. A value of 0 (zero) indicates the object layer.mask
- The bitmap mask to be attached to the GeoRaster object. If this parameter is null, any existing bitmap mask associated with the specified layer of the GeoRaster object is removed.NODATAMask
- Specifies 0 if mask is not to be interpreted as a NODATA mask, or 1 if mask is to be interpreted as a NODATA mask.java.lang.Exception
public void deletePyramid(SdoGeoRaster georaster) throws java.lang.Exception
georaster
- GeoRaster objectjava.lang.Exception
public void generatePyramid(SdoGeoRaster georaster, java.lang.String pyramidParams, double[] bgValues) throws java.lang.Exception
georaster
- GeoRaster objectpyramidParams
- a string containing the pyramid parameters. pyramidParams must be a quoted string that contains one or more of the following keywords, each with an appropriate value:
rLevel (for example, rLevel=2): Specifies the maximum reduction level: the number of pyramid levels to create at a smaller (reduced) size than the original object. If you do not specify this keyword, pyramid levels are generated until the smaller of the number of rows or columns is between 64 and 128. The dimension sizes at each lower resolution level are equal to the truncated integer values of the dimension sizes at the next higher resolution level, divided by 2.
resampling (for example, resampling=NN): Specifies the resampling method. Must be one of the following: NN (value of the nearest neighbor cell in the original GeoRaster object), BILINEAR (distance-weighted average of the 4 nearest cells in the original GeoRaster object), AVERAGE4 (simple average of the 4 nearest cells in the original GeoRaster object), AVERAGE16 (simple average of the 16 nearest cells in the original GeoRaster object), CUBIC (cubic convolution of the 16 nearest cells in the original GeoRaster object).
nodata (for example, nodata=TRUE): Specifies whether NODATA values and value ranges should be considered during the procedure. Must be either TRUE (NODATA values and value ranges should be considered) or FALSE (NODATA values and value ranges should not be considered). The default value is FALSE. If the value is TRUE and the resampling method is BILINEAR, AVERAGE4, AVERAGE16 or CUBIC, whenever a cell value involved in the resampling calculation is a NODATA value, the result of the resampling is also a NODATA value. The resulting NODATA value is the minimum NODATA value associated with the current raster layer, if multiple NODATA values or value ranges exist.
bgValues
- background values for filling partially empty raster blocks. It is only useful when the source GeoRaster object has empty raster blocks and the current operation leads to partially empty raster blocks.
The number of elements must be either one (same filling value used for all bands) or the band dimension size (a different filling value for each band, respectively).
java.lang.Exception
public void generateBlockMBR(SdoGeoRaster georaster) throws java.lang.Exception
georaster
- GeoRaster objectjava.lang.Exception
public void generateStatistics(SdoGeoRaster georaster, int samplingFactor, long[] samplingWindow, boolean histogram, java.lang.String layerNumbers, boolean useBin, double[] binFunction, boolean nodata) throws java.lang.Exception
georaster
- source GeoRaster object.samplingFactor
- Sampling factor in the format 'samplingFactor=n', with the denominator n in 1/(n*n) representing the number of cells skipped in both row and column dimensions in computing the statistics. For example, if samplingFactor is 4, one-sixteenth of the cells are sampled; but if samplingFactor is 1, all cells are sampled. The higher the value, the less accurate the statistics are likely to be, but the more quickly they will be computed.samplingWindow
- sampling window: a rectangular window for which to set statistics, specified as a numeric array with the lower-left and upper-right coordinates. The window must be inside the extent in cell space. A null value for this parameter indicates the entire image.histogram
- Specify TRUE to cause a histogram to be computed and stored, or FALSE to cause a histogram not to be computed and stored.layerNumbers
- Numbers of the layers for which to compute the statistics. This is a string that can include numbers, number ranges indicated by hyphens (-), and commas to separate numbers and number ranges. For example, '1,3-5,7' specifies layers 1, 3, 4, 5, and 7. Layer 0 (zero) indicates the object layer.useBin
- Specifies whether or not to use a provided bin function (specified in the binFunction parameter) when generating statistics. TRUE (the default) causes a bin function to be used as follows: (1) the bin function specified by the binFunction parameter, if it is not null; otherwise, (2) the bin function specified by the <binFunction> element in the GeoRaster XML metadata, if one is specified; otherwise, (3) a dynamically generated bin function, as explained in the Usage Notes. FALSE causes a dynamically generated bin function to be used, and causes the binFunction parameter and <binFunction> element to be ignored.For information about bin functions, see the Usage Notes for the SDO_GEOR.setBinFunction procedure.binFunction
- Bin function as an array whose elements specify the bin type, total number of bins, first bin number, minimum cell value, and maximum cell value. The SDO_NUMBER_ARRAY type is defined as VARRAY(1048576) OF NUMBER. For more information about the bin function for SQO_GEOR.generateStatistics, see the Usage Notes. For information about bin functions and an example, see the Usage Notes for the SDO_GEOR.setBinFunction procedure.nodata
- Specifies whether or not to compare each cell values with NODATA values defined in the metadata when computing statistics. TRUE causes all pixels with a NODATA value not to be considered; FALSE (the default) causes pixels with NODATA values to be considered as regular pixels.java.lang.Exception
public void generateStatistics(SdoGeoRaster georaster, int samplingFactor, JGeometry samplingWindow, boolean histogram, java.lang.String layerNumbers, boolean useBin, double[] binFunction, boolean nodata) throws java.lang.Exception
georaster
- source GeoRaster object.samplingFactor
- Sampling factor in the format 'samplingFactor=n', with the denominator n in 1/(n*n) representing the number of cells skipped in both row and column dimensions in computing the statistics. For example, if samplingFactor is 4, one-sixteenth of the cells are sampled; but if samplingFactor is 1, all cells are sampled. The higher the value, the less accurate the statistics are likely to be, but the more quickly they will be computed.samplingWindow
- sampling window: a rectangular window for which to set statistics, specified as an SDO_GEOMETRY object. The window must be inside the extent in cell space. A null value for this parameter indicates the entire image.histogram
- Specify TRUE to cause a histogram to be computed and stored, or FALSE to cause a histogram not to be computed and stored.layerNumbers
- numbers of the layers for which to compute the statistics. This is a string that can include numbers, number ranges indicated by hyphens (-), and commas to separate numbers and number ranges. For example, '1,3-5,7' specifies layers 1, 3, 4, 5, and 7. Layer 0 (zero) indicates the object layer.useBin
- Specifies whether or not to use a provided bin function (specified in the binFunction parameter) when generating statistics. TRUE (the default) causes a bin function to be used as follows: (1) the bin function specified by the binFunction parameter, if it is not null; otherwise, (2) the bin function specified by the <binFunction> element in the GeoRaster XML metadata, if one is specified; otherwise, (3) a dynamically generated bin function, as explained in the Usage Notes. FALSE causes a dynamically generated bin function to be used, and causes the binFunction parameter and <binFunction> element to be ignored.For information about bin functions, see the Usage Notes for the SDO_GEOR.setBinFunction procedure.binFunction
- Bin function as an array whose elements specify the bin type, total number of bins, first bin number, minimum cell value, and maximum cell value. The SDO_NUMBER_ARRAY type is defined as VARRAY(1048576) OF NUMBER. For more information about the bin function for SQO_GEOR.generateStatistics, see the Usage Notes. For information about bin functions and an example, see the Usage Notes for the SDO_GEOR.setBinFunction procedure.nodata
- Specifies whether or not to compare each cell values with NODATA values defined in the metadata when computing statistics. TRUE causes all pixels with a NODATA value not to be considered; FALSE (the default) causes pixels with NODATA values to be considered as regular pixels.java.lang.Exception
public double calcCompressionRatio(SdoGeoRaster georaster) throws java.lang.Exception
georaster
- source GeoRaster objectjava.lang.Exception
public JGeometry generateSpatialExtent(SdoGeoRaster georaster, java.lang.Double height) throws java.lang.Exception
georaster
- source GeoRaster objectheight
- number specifying the Z value for three-dimensional (X, Y, Z) georeferencing. For two-dimensional georeferencing, use null.java.lang.Exception
public boolean validateBlockMBR(SdoGeoRaster georaster) throws java.lang.Exception
georaster
- source GeoRaster objectjava.lang.Exception
public boolean validateGeoRaster(SdoGeoRaster georaster) throws java.lang.Exception
georaster
- source GeoRaster objectjava.lang.Exception
public void changeCellValue(SdoGeoRaster georaster, long row, long column, java.lang.String bandNumbers, double newCellValue, double[] bgValues) throws java.lang.Exception
georaster
- source GeoRaster objectrow
- row of the point where the values is changed to newCellValuecolumn
- column of the point where the values is changed to newCellValuebandNumbers
- a string identifying the physical band numbers on which the operation is to be performed. Use commas to delimit the values, and a hyphen to indicate a range (for example, 1-3 for bands 1, 2, and 3).newCellValue
- the new cell value for each cell inside the window in the specified bands or layers. The value must be in the range designated by the cellDepth value for the GeoRaster object.bgValues
- background values for filling partially empty raster blocks. It is only useful when the source GeoRaster object has empty raster blocks and the current operation leads to partially empty raster blocks. The filling values must be valid cell values as specified by the target cell depth background values for filling sparse data.java.lang.Exception
public void changeCellValue(SdoGeoRaster georaster, long startRow, long startColumn, long endRow, long endColumn, java.lang.String bandNumbers, double newCellValue, double[] bgValues) throws java.lang.Exception
georaster
- source GeoRaster object.startRow
- startRow of the window in which to change the values of all cells to newCellValuestartColumn
- startColumn of the window in which to change the values of all cells to newCellValueendRow
- endRow of the window in which to change the values of all cells to newCellValueendColumn
- endColumn of the window in which to change the values of all cells to newCellValuebandNumbers
- A string identifying the physical band numbers on which the operation is to be performed. Use commas to delimit the values, and a hyphen to indicate a range (for example, 1-3 for bands 1, 2, and 3).newCellValue
- The new cell value for each cell inside the window in the specified bands or layers. The value must be in the range designated by the cellDepth value for the GeoRaster object.bgValues
- background values for filling partially empty raster blocks. It is only useful when the source GeoRaster object has empty raster blocks and the current operation leads to partially empty raster blocks. The filling values must be valid cell values as specified by the target cell depth background values for filling sparse data.java.lang.Exception
public void changeCellValue(SdoGeoRaster georaster, JGeometry window, java.lang.String layerNumbers, double newCellValue, double[] bgValues) throws java.lang.Exception
georaster
- source GeoRaster object.window
- window in which to change the values of all cells to newCellValuelayerNumbers
- a string identifying the logical layer numbers on which the operation is to be performed. Use commas to delimit the values, and a hyphen to indicate a range (for example, 2-4 for layers 2, 3, and 4).newCellValue
- the new cell value for each cell inside the window in the specified bands or layers. The value must be in the range designated by the cellDepth value for the GeoRaster object.bgValues
- background values for filling partially empty raster blocks. It is only useful when the source GeoRaster object has empty raster blocks and the current operation leads to partially empty raster blocks. The filling values must be valid cell values as specified by the target cell depth background values for filling sparse data.java.lang.Exception
public double getCellValue(SdoGeoRaster georaster, JGeometry ptGeom, int pyramidLevel, int layerNumber) throws java.lang.Exception
georaster
- source GeoRaster objectpyramidLevel
- pyramid level containing the cell whose value is to be returnedptGeom
- point geometry that identifies the cell whose value is to be returnedlayerNumber
- number of the logical layer that contains the cell whose value is to be returned. (The logical layer number is the physical band number plus 1.)java.lang.Exception
public double getCellValue(SdoGeoRaster georaster, int pyramidLevel, int rowNumber, int colNumber, int bandNumber) throws java.lang.Exception
georaster
- source GeoRaster objectpyramidLevel
- pyramid level containing the cell whose value is to be returnedrowNumber
- number of the row that contains the cell whose value is to be returnedcolNumber
- number of the column that contains the cell whose value is to be returnedbandNumber
- number of the physical band that contains the cell whose value is to be returnedjava.lang.Exception
public double getBitmapMaskValue(SdoGeoRaster georaster, JGeometry ptGeom, int pyramidLevel, int layerNumber) throws java.lang.Exception
georaster
- source GeoRaster objectpyramidLevel
- pyramid level containing the cell whose value is to be returnedptGeom
- point geometry that identifies the cell whose value is to be returnedlayerNumber
- number of the logical layer that contains the cell whose value is to be returned. (The logical layer number is the physical band number plus 1.)java.lang.Exception
public double getBitmapMaskValue(SdoGeoRaster georaster, int pyramidLevel, int rowNumber, int colNumber, int bandNumber) throws java.lang.Exception
georaster
- source GeoRaster objectpyramidLevel
- pyramid level containing the cell whose value is to be returnedrowNumber
- number of the row that contains the cell whose value is to be returnedcolNumber
- number of the column that contains the cell whose value is to be returnedbandNumber
- number of the physical band that contains the cell whose value is to be returnedjava.lang.Exception
public java.math.BigDecimal[] getCellValues(SdoGeoRaster georaster, int pyramidLevel, int[] rowNumbers, int[] colNumbers, int bandNumber) throws java.lang.Exception
georaster
- source GeoRaster objectpyramidLevel
- pyramid level containing the cell whose value is to be returnedrowNumbers
- numbers of the rows that contain the cells whose values are to be returnedcolNumbers
- numbers of the columns that contain the cells whose values are to be returnedbandNumber
- number of the physical band that contains the cell whose value is to be returnedjava.lang.Exception
public java.math.BigDecimal[] getCellValues(SdoGeoRaster georaster, int pyramidLevel, JGeometry ptGeom, int layerNumber) throws java.lang.Exception
georaster
- source GeoRaster objectpyramidLevel
- pyramid level containing the cell whose value is to be returnedptGeom
- multipoint geometry that identifies the cell whose value is to be returned.layerNumber
- number of the logical layer that contains the cells whose values are to be returned.java.lang.Exception
public void changeCellValues(SdoGeoRaster georaster, int[] rowNumbers, int[] colNumbers, int bandNumber, double[] newCellValues, double[] bgValues) throws java.lang.Exception
georaster
- source GeoRaster objectrowNumbers
- numbers of the rows that contain the cells whose values are to be returnedcolNumbers
- numbers of the columns that contain the cells whose values are to be returnedbandNumber
- number of the physical band that contains the cell whose value is to be returnednewCellValues
- The new cell value for each cell inside the window in the specified bands or layers. The value must be in the range designated by the cellDepth value for the GeoRaster object.bgValues
- Background values for filling partially empty raster blocks. It is only useful when the source GeoRaster object has empty raster blocks and the current operation leads to partially empty raster blocks (see Empty Raster Blocks). The number of elements in the SDO_NUMBER_ARRAY object must be either one (same filling value used for all bands) or the band dimension size (a different filling value for each band, respectively). For example, SDO_NUMBER_ARRAY(1,5,10) fills the first band with 1, the second band with 5, and the third band with 10. The default bgValues are zero (0). The filling values must be valid cell values as specified by the target cell depth background values for filling sparse data.java.lang.Exception
public void changeCellValues(SdoGeoRaster georaster, JGeometry ptGeom, int layerNumber, double[] newCellValues, double[] bgValues) throws java.lang.Exception
georaster
- source GeoRaster objectptGeom
- multipoint geometry that identifies the cell whose value is to be returned.layerNumber
- number of the logical layer that contains the cells whose values are to be returned.newCellValues
- The new cell value for each cell inside the window in the specified bands or layers. The value must be in the range designated by the cellDepth value for the GeoRaster object.bgValues
- Background values for filling partially empty raster blocks. It is only useful when the source GeoRaster object has empty raster blocks and the current operation leads to partially empty raster blocks (see Empty Raster Blocks). The number of elements in the SDO_NUMBER_ARRAY object must be either one (same filling value used for all bands) or the band dimension size (a different filling value for each band, respectively). For example, SDO_NUMBER_ARRAY(1,5,10) fills the first band with 1, the second band with 5, and the third band with 10. The default bgValues are zero (0). The filling values must be valid cell values as specified by the target cell depth background values for filling sparse data.java.lang.Exception
public java.math.BigDecimal[] evaluateDoubles(SdoGeoRaster georaster, int pyramidLevel, int[] rowNumbers, int[] colNumbers, int bandNumber, java.lang.String interpolationMethod) throws java.lang.Exception
georaster
- source GeoRaster objectpyramidLevel
- pyramid level containing the cell whose value is to be returnedrowNumbers
- numbers of the rows that contain the cells whose values are to be returnedcolNumbers
- numbers of the columns that contain the cells whose values are to be returnedbandNumber
- number of the physical band that contains the cell whose value is to be returnedinterpolationMethod
- interpolationMethod(for example, interpolationMethod=NN): Specifies the interpolation method. Must be one of the following: NN, BILINEAR, BIQUADRATIC, CUBIC, AVERAGE4, AVERAGE16.java.lang.Exception
public java.math.BigDecimal[] evaluateDoubles(SdoGeoRaster georaster, int pyramidLevel, JGeometry ptGeom, int layerNumber, java.lang.String interpolationMethod) throws java.lang.Exception
georaster
- source GeoRaster objectpyramidLevel
- pyramid level containing the cell whose value is to be returnedptGeom
- multipoint geometry that identifies the cell whose value is to be returned.layerNumber
- number of the logical layer that contains the cells whose values are to be returned.interpolationMethod
- interpolationMethod(for example, interpolationMethod=NN): Specifies the interpolation method. Must be one of the following: NN, BILINEAR, BIQUADRATIC, CUBIC, AVERAGE4, AVERAGE16.java.lang.Exception
public java.math.BigDecimal[] getBitmapMaskValues(SdoGeoRaster georaster, int layerNumber, int pyramidLevel, int[] rowNumbers, int[] colNumbers) throws java.lang.Exception
georaster
- source GeoRaster objectlayerNumber
- number of the layer on which to perform the operation. A value of 0 (zero) indicates the object layer.pyramidLevel
- pyramid level containing the cell whose value is to be returnedrowNumbers
- numbers of the rows that contain the cells whose values are to be returnedcolNumbers
- numbers of the columns that contain the cells whose values are to be returnedjava.lang.Exception
public java.math.BigDecimal[] getBitmapMaskValues(SdoGeoRaster georaster, int layerNumber, int pyramidLevel, JGeometry ptGeom) throws java.lang.Exception
georaster
- source GeoRaster objectlayerNumber
- number of the layer on which to perform the operation. A value of 0 (zero) indicates the object layer.pyramidLevel
- pyramid level containing the cell whose value is to be returnedptGeom
- multipoint geometry that identifies the cell whose value is to be returned.java.lang.Exception
public void setModelCoordLocation(SdoGeoRaster georaster, java.lang.String modelCoordLoc) throws java.lang.Exception
georaster
- source GeoRaster object.modelCoordLoc
- Model coordinate location to set for the GeoRaster object. It must be specified as either null (to delete any current model coordinate location value) or one of the following string values: CENTER (the cell coordinate system is center-based) or UPPERLEFT (the cell coordinate system is based on the upper-left corner).java.lang.Exception
public void createTemplate(SdoGeoRaster georaster, int rasterType, java.lang.String rasterSpec, java.lang.String maskLayers, java.lang.String initRDTEntry) throws java.lang.Exception
georaster
- source GeoRaster object.rasterType
- The 5-digit rasterType attribute value, as specified in Section 2.1.1 of GeoRaster document.rasterSpec
- The rasterSpec parameter must be a quoted string that contains one or more keyword-value pairs. The following keyword are supported for this parameter: blocking (for example, blocking=TRUE). For an explanation of this keyword, see Table 1-1 in Section 1.4.1 of GeoRaster document , "Storage Parameters". blocksize (for example, blocksize=(128,128,3)). For an explanation of this keyword, see Table 1-1 in Section 1.4.1 of GeoRaster document, "Storage Parameters". cellDepth (for example, cellDepth=8BIT_S). For an explanation of this keyword, see Table 1-1 in Section 1.4.1, "Storage Parameters". compression (for example, compression=JPEG-B). For an explanation of this keyword, see Table 1-1 in Section 1.4.1, "Storage Parameters". dimSize (for example, dimSize=(256,256,3)): Specifies the row, column, and band dimension sizes. This keyword must be specified and must be consistent with the rasterType parameter. interleaving (for example, interleaving=BIP). For an explanation of this keyword, see Table 1-1 in Section 1.4.1, "Storage Parameters". quality (for example, quality=75). For an explanation of this keyword, see Table 1-1 in Section 1.4.1, "Storage Parameters". resampling (for example, resampling=NN): Specifies the resampling method. Must be one of the following: NN (value of the nearest neighbor cell in the original GeoRaster object), BILINEAR (distance-weighted average of the 4 nearest cells in the original GeoRaster object), AVERAGE4 (simple average of the 4 nearest cells in the original GeoRaster object), AVERAGE16 (simple average of the 16 nearest cells in the original GeoRaster object), CUBIC (cubic convolution of the 16 nearest cells in the original GeoRaster object). This keyword is ignored if rLevel is not set. rLevel (for example, rLevel=2): Specifies the maximum pyramid reduction level. Must be a positive integer. If you specify this keyword, the pyramid type is set to DECREASE in the metadata; otherwise the pyramid type is set to NONE. ultCoord (for example, ultCoord=(0,0,0)): Specifies the upper-left coordinate integer values for the GeoRaster object. The default value is 0 for all the dimensions. The value for the band dimension must be 0.maskLayers
- A string identifying the logical layer numbers on which there are associated bitmap masks. Use commas to delimit the values, and a hyphen to indicate a range (for example, 2-4 for layers 2, 3, and 4).initRDTEntry
- The string TRUE causes the raster data table to be populated; the string FALSE causes the raster data table not to be populated. If you do not specify this parameter, the raster data table is not populated.java.lang.Exception
public int getGeoreferenceType(SdoGeoRaster georaster) throws java.lang.Exception
georaster
- source GeoRaster object.java.lang.Exception
public java.math.BigDecimal[] evaluateDouble(SdoGeoRaster georaster, int pyramidLevel, int rowNumber, int colNumber, java.lang.String bands, java.lang.String interpolationMethod) throws java.lang.Exception
georaster
- source GeoRaster object.pyramidLevel
- pyramid level containing the cell whose value is to be returned.rowNumber
- number of the row that contains the cell whose value is to be returned.colNumber
- number of the column that contains the cell whose value is to be returned.bands
- A string identifying the physical band numbers on which the operation is to be performed. Use commas to delimit the values, and a hyphen to indicate a range (for example, 1-3 for bands 1, 2, and 3).interpolationMethod
- interpolationMethod(for example, interpolationMethod=NN): Specifies the interpolation method. Must be one of the following: NN, BILINEAR, BIQUADRATIC, CUBIC, AVERAGE4, AVERAGE16.java.lang.Exception
public java.math.BigDecimal[] evaluateDouble(SdoGeoRaster georaster, int pyramidLevel, JGeometry ptGeom, java.lang.String layers, java.lang.String interpolationMethod) throws java.lang.Exception
georaster
- source GeoRaster objectpyramidLevel
- pyramid level containing the cell whose value is to be returnedptGeom
- Point geometry that identifies the direct location whose raster values are to be returned.layers
- A string identifying the logical layer numbers on which the operation is to be performed. Use commas to delimit the values, and a hyphen to indicate a range (for example, 2-4 for layers 2, 3, and 4). (the logical layer number is the physical band number plus 1).interpolationMethod
- interpolationMethod(for example, interpolationMethod=NN): Specifies the interpolation method. Must be one of the following: NN, BILINEAR, BIQUADRATIC, CUBIC, AVERAGE4, AVERAGE16.java.lang.Exception
public java.math.BigDecimal[] getCellValue(SdoGeoRaster georaster, int pyramidLevel, int rowNumber, int colNumber, java.lang.String bands) throws java.lang.Exception
georaster
- source GeoRaster object.pyramidLevel
- pyramid level containing the cell whose value is to be returned.rowNumber
- number of the row that contains the cell whose value is to be returned.colNumber
- number of the column that contains the cell whose value is to be returned.bands
- A string identifying the physical band numbers on which the operation is to be performed. Use commas to delimit the values, and a hyphen to indicate a range (for example, 1-3 for bands 1, 2, and 3).java.lang.Exception
public java.math.BigDecimal[] getCellValue(SdoGeoRaster georaster, int pyramidLevel, JGeometry ptGeom, java.lang.String layers) throws java.lang.Exception
georaster
- source GeoRaster object.pyramidLevel
- pyramid level containing the cell whose value is to be returned.ptGeom
- Point geometry that identifies the cell whose values is to be returned.layers
- A string identifying the logical layer numbers on which the operation is to be performed. Use commas to delimit the values, and a hyphen to indicate a range (for example, 2-4 for layers 2, 3, and 4). (the logical layer number is the physical band number plus 1).java.lang.Exception
public java.math.BigDecimal[] georeference(SdoGeoRaster georaster, java.lang.String FFMethodType, int nGCP, SdoGeorPKG.SdoGeorGCP[] gcps, java.lang.Boolean storeGCP, java.lang.Integer srid, java.lang.Integer modelCoordinateLocation, java.lang.String setResolution) throws java.lang.Exception
georaster
- The SdoGeoRaster object to be georeferenced.FFMethodType
- Polynomial or rational polynomial function used as georeference geometric model. Must be one of the following string values: Affine, QuadraticPolynomial, CubicPolynomial, DLT, QuadraticRational, or RPC.nGCP
- Number of ground control points in the GCP array (gcps parameter).gcps
- A GCP array of type SdoGeorGCP.storeGCP
- A flag indicating whether the GCPs should be stored in the GeoRaster metadata.srid
- Model coordinate system. it can be null or a value from the SRID column of the MDSYS.CS_SRS table. If it is not a value from the SRID column of the MDSYS.CS_SRS table, the SRID is not supported by Oracle Spatial and Graph, and some SRID-related operations may not be supported.modelCoordinateLocation
- A value specifying the model location of the base of the area represented by a cell: 0 for CENTER or 1 for UPPERLEFT.setResolution
- A flag indicating whether the spatial resolution is calculated and stored in the GeoRaster metadata. The string FALSE or a null value does not store the spatial resolution in the GeoRaster metadata; the string TRUE stores the spatial resolution in the GeoRaster metadata.java.lang.Exception
public java.math.BigDecimal[] georeference(SdoGeoRaster georaster, SdoGeorPKG.SdoGeorGCPRefType gcpGeorefModel, java.lang.Boolean storeGCP, java.lang.Integer srid, java.lang.Integer modelCoordinateLocation, java.lang.String setResolution) throws java.lang.Exception
georaster
- The SdoGeoRaster object to be georeferenced.gcpGeorefModel
- A SdoGeorGCPRefType object containing the following: FFMethodType, nGCP, GCPs, solutionAccuracy.storeGCP
- A flag indicating whether the GCPs should be stored in the GeoRaster metadata.srid
- Model coordinate system. it can be null or a value from the SRID column of the MDSYS.CS_SRS table. If it is not a value from the SRID column of the MDSYS.CS_SRS table, the SRID is not supported by Oracle Spatial and Graph, and some SRID-related operations may not be supported.modelCoordinateLocation
- A value specifying the model location of the base of the area represented by a cell: 0 for CENTER or 1 for UPPERLEFT.setResolution
- A flag indicating whether the spatial resolution is calculated and stored in the GeoRaster metadata. The string FALSE or a null value does not store the spatial resolution in the GeoRaster metadata; the string TRUE stores the spatial resolution in the GeoRaster metadata.java.lang.Exception
public java.math.BigDecimal[] georeference(SdoGeoRaster georaster, java.lang.String FFMethodType, java.lang.Integer srid, java.lang.Integer modelCoordinateLocation, java.lang.String setResolution) throws java.lang.Exception
georaster
- The SdoGeoRaster object to be georeferenced.FFMethodType
- Polynomial or rational polynomial function used as georeference geometric model. Must be one of the following string values: Affine, QuadraticPolynomial, CubicPolynomial, DLT, QuadraticRational, or RPC.srid
- Model coordinate system. it can be null or a value from the SRID column of the MDSYS.CS_SRS table. If it is not a value from the SRID column of the MDSYS.CS_SRS table, the SRID is not supported by Oracle Spatial and Graph, and some SRID-related operations may not be supported.modelCoordinateLocation
- A value specifying the model location of the base of the area represented by a cell: 0 for CENTER or 1 for UPPERLEFT.setResolution
- A flag indicating whether the spatial resolution is calculated and stored in the GeoRaster metadata. The string FALSE or a null value does not store the spatial resolution in the GeoRaster metadata; the string TRUE stores the spatial resolution in the GeoRaster metadata.java.lang.Exception
public void reproject(SdoGeoRaster inGeoRaster, java.lang.String resampleParam, java.lang.String storageParam, int outSRID, SdoGeoRaster outGeoraster, double[] bgValues) throws java.lang.Exception
inGeoRaster
- The GeoRaster object on which the reprojection operation is to be performed to create the new object.resampleParam
- A string containing the resampling parameters, resampleParam must be a quoted string that contains one or more of the following keywords, each with an appropriate value: resampling (for example, resampling=NN): Specifies the resampling method. Must be one of the following: NN, BILINEAR, CUBIC, AVERAGE4, AVERAGE16. nodata (for example, nodata=TRUE): Specifies whether NODATA values and value ranges should be considered during the procedure. Must be either TRUE (NODATA values and value ranges should be considered) or FALSE (NODATA values and value ranges should not be considered). The default value is FALSE. If the value is TRUE and the resampling method is BILINEAR, CUBIC, AVERAGE4, or AVERAGE16, whenever a cell value involved in the resampling calculation is a NODATA value, the result of the resampling is also a NODATA value. The resulting NODATA value is the minimum NODATA value associated with the current raster layer, if multiple NODATA values or value ranges exist.storageParam
- A string specifying storage parameters, as explained in Section 1.4.1 of GeoRaster document.outSRID
- Output srid.outGeoraster
- Output georaster object.bgValues
- Background values for filling partially empty raster blocks. It is only useful when the source GeoRaster object has empty raster blocks and the current operation leads to partially empty raster blocks . The number of elements in the SDO_NUMBER_ARRAY object must be either one (same filling value used for all bands) or the band dimension size (a different filling value for each band, respectively). For example, SDO_NUMBER_ARRAY(1,5,10) fills the first band with 1, the second band with 5, and the third band with 10. The default bgValues are zero (0).java.lang.Exception
public void reproject(SdoGeoRaster inGeoRaster, int pyramidLevel, JGeometry cropArea, java.lang.String layerNumbers, java.lang.String resampleParam, java.lang.String storageParam, int outSRID, SdoGeoRaster outGeoraster, double[] bgValues) throws java.lang.Exception
inGeoRaster
- The GeoRaster object on which the reprojection operation is to be performed to create the new object.pyramidLevel
- A number specifying the pyramid level of the source GeoRaster object.cropArea
- A JGeometry object, and the minimum bounding rectangle (MBR) of the JGeometry object is used as the crop area.layerNumbers
- A string identifying the logical layer numbers on which the operation is to be performed. Use commas to delimit the values, and a hyphen to indicate a range (for example, 2-4 for layers 2, 3, and 4).resampleParam
- A string containing the resampling parameters, resampleParam must be a quoted string that contains one or more of the following keywords, each with an appropriate value: resampling (for example, resampling=NN): Specifies the resampling method. Must be one of the following: NN, BILINEAR, CUBIC, AVERAGE4, AVERAGE16. nodata (for example, nodata=TRUE): Specifies whether NODATA values and value ranges should be considered during the procedure. Must be either TRUE (NODATA values and value ranges should be considered) or FALSE (NODATA values and value ranges should not be considered). The default value is FALSE. If the value is TRUE and the resampling method is BILINEAR, CUBIC, AVERAGE4, or AVERAGE16, whenever a cell value involved in the resampling calculation is a NODATA value, the result of the resampling is also a NODATA value. The resulting NODATA value is the minimum NODATA value associated with the current raster layer, if multiple NODATA values or value ranges exist.storageParam
- A string specifying storage parameters, as explained in Section 1.4.1 of GeoRaster document.outSRID
- Output srid.outGeoraster
- output georaster object.bgValues
- Background values for filling partially empty raster blocks. It is only useful when the source GeoRaster object has empty raster blocks and the current operation leads to partially empty raster blocks (see Section 1.4.4). The number of elements in the SDO_NUMBER_ARRAY object must be either one (same filling value used for all bands) or the band dimension size (a different filling value for each band, respectively). For example, SDO_NUMBER_ARRAY(1,5,10) fills the first band with 1, the second band with 5, and the third band with 10. The default bgValues are zero (0).java.lang.Exception
public void reproject(SdoGeoRaster inGeoRaster, int pyramidLevel, double[] cropArea, java.lang.String bandNumbers, java.lang.String resampleParam, java.lang.String storageParam, int outSRID, SdoGeoRaster outGeoraster, double[] bgValues) throws java.lang.Exception
inGeoRaster
- The GeoRaster object on which the reprojection operation is to be performed to create the new object.pyramidLevel
- A number specifying the pyramid level of the source GeoRaster object.cropArea
- The parameter identifies the upper-left (row, column) and lower-right (row, column) coordinates of a rectangular window, and raster space is assumed.bandNumbers
- A string identifying the physical band numbers on which the operation is to be performed. Use commas to delimit the values, and a hyphen to indicate a range (for example, 1-3 for bands 1, 2, and 3).resampleParam
- A string containing the resampling parameters, resampleParam must be a quoted string that contains one or more of the following keywords, each with an appropriate value: resampling (for example, resampling=NN): Specifies the resampling method. Must be one of the following: NN, BILINEAR, CUBIC, AVERAGE4, AVERAGE16. nodata (for example, nodata=TRUE): Specifies whether NODATA values and value ranges should be considered during the procedure. Must be either TRUE (NODATA values and value ranges should be considered) or FALSE (NODATA values and value ranges should not be considered). The default value is FALSE. If the value is TRUE and the resampling method is BILINEAR, CUBIC, AVERAGE4, or AVERAGE16, whenever a cell value involved in the resampling calculation is a NODATA value, the result of the resampling is also a NODATA value. The resulting NODATA value is the minimum NODATA value associated with the current raster layer, if multiple NODATA values or value ranges exist.storageParam
- A string specifying storage parameters, as explained in Section 1.4.1 of GeoRaster document.outSRID
- Output srid.outGeoraster
- output georaster object.bgValues
- Background values for filling partially empty raster blocks. It is only useful when the source GeoRaster object has empty raster blocks and the current operation leads to partially empty raster blocks (see Section 1.4.4). The number of elements in the SDO_NUMBER_ARRAY object must be either one (same filling value used for all bands) or the band dimension size (a different filling value for each band, respectively). For example, SDO_NUMBER_ARRAY(1,5,10) fills the first band with 1, the second band with 5, and the third band with 10. The default bgValues are zero (0).java.lang.Exception
public void reproject(SdoGeoRaster inGeoRaster, int pyramidLevel, JGeometry cropArea, java.lang.String layerNumbers, java.lang.String resampleParam, java.lang.String storageParam, int outSRID, java.sql.Blob rasterBlob, JGeometry outArea, double[] outWindow, double[] bgValues) throws java.lang.Exception
inGeoRaster
- The GeoRaster object on which the reprojection operation is to be performed to create the new object.pyramidLevel
- A number specifying the pyramid level of the source GeoRaster object.cropArea
- A JGeometry object, and the minimum bounding rectangle (MBR) of the JGeometry object is used as the crop area.layerNumbers
- A string identifying the logical layer numbers on which the operation is to be performed. Use commas to delimit the values, and a hyphen to indicate a range (for example, 2-4 for layers 2, 3, and 4).resampleParam
- A string containing the resampling parameters, resampleParam must be a quoted string that contains one or more of the following keywords, each with an appropriate value: resampling (for example, resampling=NN): Specifies the resampling method. Must be one of the following: NN, BILINEAR, CUBIC, AVERAGE4, AVERAGE16. nodata (for example, nodata=TRUE): Specifies whether NODATA values and value ranges should be considered during the procedure. Must be either TRUE (NODATA values and value ranges should be considered) or FALSE (NODATA values and value ranges should not be considered). The default value is FALSE. If the value is TRUE and the resampling method is BILINEAR, CUBIC, AVERAGE4, or AVERAGE16, whenever a cell value involved in the resampling calculation is a NODATA value, the result of the resampling is also a NODATA value. The resulting NODATA value is the minimum NODATA value associated with the current raster layer, if multiple NODATA values or value ranges exist.storageParam
- A string specifying storage parameters, as explained in Section 1.4.1 of GeoRaster document.outSRID
- Output srid.rasterBlob
- output raster blob.bgValues
- Background values for filling partially empty raster blocks. It is only useful when the source GeoRaster object has empty raster blocks and the current operation leads to partially empty raster blocks (see Section 1.4.4). The number of elements in the SDO_NUMBER_ARRAY object must be either one (same filling value used for all bands) or the band dimension size (a different filling value for each band, respectively). For example, SDO_NUMBER_ARRAY(1,5,10) fills the first band with 1, the second band with 5, and the third band with 10. The default bgValues are zero (0).java.lang.Exception
public java.sql.Blob reproject(SdoGeoRaster inGeoRaster, int pyramidLevel, double[] cropArea, java.lang.String bandNumbers, java.lang.String resampleParam, java.lang.String storageParam, int outSRID, JGeometry outArea, double[] outWindow, double[] bgValues) throws java.lang.Exception
inGeoRaster
- The GeoRaster object on which the reprojection operation is to be performed to create the new object.pyramidLevel
- A number specifying the pyramid level of the source GeoRaster object.cropArea
- The parameter identifies the upper-left (row, column) and lower-right (row, column) coordinates of a rectangular window, and raster space is assumed.bandNumbers
- A string identifying the physical band numbers on which the operation is to be performed. Use commas to delimit the values, and a hyphen to indicate a range (for example, 1-3 for bands 1, 2, and 3).resampleParam
- A string containing the resampling parameters, resampleParam must be a quoted string that contains one or more of the following keywords, each with an appropriate value: resampling (for example, resampling=NN): Specifies the resampling method. Must be one of the following: NN, BILINEAR, CUBIC, AVERAGE4, AVERAGE16. nodata (for example, nodata=TRUE): Specifies whether NODATA values and value ranges should be considered during the procedure. Must be either TRUE (NODATA values and value ranges should be considered) or FALSE (NODATA values and value ranges should not be considered). The default value is FALSE. If the value is TRUE and the resampling method is BILINEAR, CUBIC, AVERAGE4, or AVERAGE16, whenever a cell value involved in the resampling calculation is a NODATA value, the result of the resampling is also a NODATA value. The resulting NODATA value is the minimum NODATA value associated with the current raster layer, if multiple NODATA values or value ranges exist.storageParam
- A string specifying storage parameters, as explained in Section 1.4.1 of GeoRaster document.outSRID
- Output srid.bgValues
- Background values for filling partially empty raster blocks. It is only useful when the source GeoRaster object has empty raster blocks and the current operation leads to partially empty raster blocks (see Section 1.4.4). The number of elements in the SDO_NUMBER_ARRAY object must be either one (same filling value used for all bands) or the band dimension size (a different filling value for each band, respectively). For example, SDO_NUMBER_ARRAY(1,5,10) fills the first band with 1, the second band with 5, and the third band with 10. The default bgValues are zero (0).java.lang.Exception
public void decompressJP2(SdoGeoRaster inGeoRaster, java.lang.Integer pyramidLevel, java.math.BigDecimal[] cropArea, java.lang.String layerNumbers, java.lang.String storageParam, SdoGeoRaster outGeoRaster) throws java.lang.Exception
inGeoRaster
- The SDO_GEORASTER object to be decompressed.pyramidLevel
- A number specifying the pyramid level to be decompressed in the source GeoRaster object.cropArea
- Crop area definition. If cropArea is of type SDO_GEOMETRY, use the layerNumbers parameter to specify one or more layer numbers; if cropArea is of type SDO_NUMBER_ARRAY, use the bandNumbers parameter to specify one or more band numbers. If the data type is SDO_NUMBER_ARRAY, the parameter identifies the upper-left (row, column) and lower-right (row, column) coordinates of a rectangular window, and raster space is assumed. If the data type is SDO_GEOMETRY, the minimum bounding rectangle (MBR) of the geometry object is used as the crop area; see also the Usage Notes for SDO_SRID requirements.layerNumbers
- A string identifying the logical layer numbers on which the operation is to be performed. Use commas to delimit the values, and a hyphen to indicate a range (for example, 2-4 for layers 2, 3, and 4).storageParam
- A string specifying storage parameters, as explained in Storage Parameters.outGeoRaster
- The output SDO_GEORASTER object that reflects the results of the operation. Must be either a valid existing GeoRaster object or an empty GeoRaster object. (Empty GeoRaster objects are explained in Blank and Empty GeoRaster Objects.) Cannot be the same GeoRaster object as inGeoRaster.java.lang.Exception
public void decompressJP2(SdoGeoRaster inGeoRaster, java.lang.Integer pyramidLevel, JGeometry cropArea, java.lang.String bandNumbers, java.lang.String storageParam, SdoGeoRaster outGeoRaster) throws java.lang.Exception
inGeoRaster
- The SDO_GEORASTER object to be decompressed.pyramidLevel
- A number specifying the pyramid level to be decompressed in the source GeoRaster object.cropArea
- Crop area definition. If cropArea is of type SDO_GEOMETRY, use the layerNumbers parameter to specify one or more layer numbers; if cropArea is of type SDO_NUMBER_ARRAY, use the bandNumbers parameter to specify one or more band numbers. If the data type is SDO_NUMBER_ARRAY, the parameter identifies the upper-left (row, column) and lower-right (row, column) coordinates of a rectangular window, and raster space is assumed. If the data type is SDO_GEOMETRY, the minimum bounding rectangle (MBR) of the geometry object is used as the crop area; see also the Usage Notes for SDO_SRID requirements.bandNumbers
- A string identifying the physical band numbers on which the operation is to be performed. Use commas to delimit the values, and a hyphen to indicate a range (for example, 1-3 for bands 1, 2, and 3).storageParam
- A string specifying storage parameters, as explained in Storage Parameters.outGeoRaster
- The output SDO_GEORASTER object that reflects the results of the operation. Must be either a valid existing GeoRaster object or an empty GeoRaster object. (Empty GeoRaster objects are explained in Blank and Empty GeoRaster Objects.) Cannot be the same GeoRaster object as inGeoRaster.java.lang.Exception
public void compressJP2(SdoGeoRaster inGeoRaster, java.lang.String compressParam, SdoGeoRaster outGeoRaster) throws java.lang.Exception
inGeoRaster
- The SDO_GEORASTER object to be compressed.compressParam
- A string specifying one or more keywords for the compression parameter. For an explanation of the available keywords, see JPEG 2000 (JP2) Compression Parameters.outGeoRaster
- The SDO_GEORASTER object to hold the result of the compression. Must be either a valid existing GeoRaster object or an empty GeoRaster object. (Empty GeoRaster objects are explained in Blank and Empty GeoRaster Objects.) Cannot be the same GeoRaster object as inGeoRaster.java.lang.Exception
public double generateAreaWeightedMean(SdoGeoRaster georaster, JGeometry window, java.lang.Integer bandNumber, boolean nodata) throws java.lang.Exception
georaster
- GeoRaster object.window
- A polygon geometry object from which to generate statistics,it is transformed into raster space if it is in model space,see also the Usage Notes for the SDO_GEOR.generateStatistics function for SDO_SRID requirements.bandNumber
- Band ordinate number of the layer for which to perform the operation.nodata
- Specifies whether or not to compare each cell values with NODATA values defined in the metadata when computing statistics. TRUE causes all pixels with a NODATA value not to be considered; FALSE (the default) causes pixels with NODATA values to be considered as regular pixels. NODATA values and value ranges are discussed in NODATA Values and Value Ranges.java.lang.Exception
public void warp(SdoGeoRaster inGeoRaster, java.lang.Integer pyramidLevel, java.lang.Integer outSRS, JGeometry cropArea, java.math.BigDecimal[] dimensionSize, java.lang.String layerNumbers, java.lang.String elevationParam, java.lang.String resampleParam, java.lang.String storageParam, SdoGeoRaster outGeoRaster, double[] bgValues, int parallelParam) throws java.lang.Exception
inGeoRaster
- GeoRaster object on which to perform the operation. It must be georeferenced (see Georeferencing GeoRaster Objects and Advanced Georeferencing).pyramidLevel
- Pyramid level of the source GeoRaster object for the operation. For BLOB output, this parameter is required. For SDO_GEORASTER output, if this parameter is null, all pyramid levels from the input GeoRaster object are processed. If the number 0 or greater is specified, only that pyramid level is used for the rectification, producing a result in scale based on that pyramid level image.outSRS
- Coordinate system (spatial reference system) for the output GeoRaster object. Must be either null or a value from the SRID column of the MDSYS.CS_SRS table. If it is null, the output GeoRaster object will have the same SRID as the input GeoRaster object.cropArea
- Defines the shape of the area to be covered by the output image. Areas outside this polygon will be filled with the background value. If this parameter is not specified, no cropping is performed.dimensionSize
- Dimension size array of the GeoRaster object. Defines the extent of the image in cell space.layerNumbers
- String specifying one or more numbers of layers from inGeoRaster to be transferred to outGeoRaster. Use commas to delimit numbers or ranges, and use a hyphen to indicate a range. Example:'1,3-5,7' for layers 1, 3, 4, 5, and 7. If this parameter is null (the default) all the layers will be processed.elevationParam
- A string containing one or more of the elevation parameters average (average surface height), scale (scale value applied to all DEM values), and offset (offset applied to all DEM values), where the new value is (value + offset) * scale. This parameter must be a quoted string that contains one or more keyword=value pairs (for example, 'average=800 scale=3.2808399 offset=10'). If this parameter is null, 0 is assumed for average and offset, and 1 is used for scale. Any scale and offset values are ignored if DEM is not specified. The use of the elevationParam parameter requires that the input GeoRaster object have a 3D model SRID. When the input GeoRaster object has a 3D model SRID, the average elevation is important for defining the extents of the output image. If that information is available, it should be specified even if DEM is also specified. If the average elevation is not specified, the procedure will calculate an approximate value for the average elevation. Note:For any numbers in string (VARCHAR2) parameters to GeoRaster subprograms, the period (.) must be used for any decimal points regardless of the locale.resampleParam
- A comma-separated quoted string of keyword=value pairs for specifying resampling parameters.storageParam
- A string specifying storage parameters, as explained in Storage Parameters.outGeoRaster
- GeoRaster object to hold the result of the operation. Must be either a valid existing GeoRaster object or an empty GeoRaster object. (Empty GeoRaster objects are explained in Blank and Empty GeoRaster Objects.) Cannot be the same GeoRaster object as inGeoRasterbgValues
- Background values for filling partially empty raster blocks. It is only useful when the source GeoRaster object has empty raster blocks and the current operation leads to partially empty raster blocks (see Empty Raster Blocks). The number of elements in the SDO_NUMBER_ARRAY object must be either one (same filling value used for all bands) or the band dimension size (a different filling value for each band, respectively). For example, SDO_NUMBER_ARRAY(1,5,10) fills the first band with 1, the second band with 5, and the third band with 10. The default bgValues are zero (0). The filling values must be valid cell values as specified by the target cell depth background values for filling sparse data.parallelParam
- Specifies the degree of parallelism for the operation. If specified, must be greater than 1. The database optimizer uses the degree of parallelism specified by this parameter. If parallelism is specified, the procedure performs an internal commit operation. If an error occurs (even if it is raised by the Oracle parallel server), you must delete the resulting output GeoRaster object explicitly in order to roll back the operation.java.lang.Exception
public void generateBitmapPyramid(SdoGeoRaster src_geor, SdoGeoRaster tmp_geor, SdoGeoRaster target_geor, java.lang.String pyramidParams, double[] bgValues, int parallelParam) throws java.lang.Exception
src_geor
- Source GeoRaster object for which pyramid data is to be generated.tmp_geor
- Temporary GeoRaster object used to store temporary datatarget_geor
- Target GeoRaster object used to store the resulting GeoRaster data.pyramidParams
- A string containing the pyramid parameters. See the Usage Notes for information about the available keywords and values.bgValues
- Background values for filling partially empty raster blocks. It is only useful when the source GeoRaster object has empty raster blocks and the current operation leads to partially empty raster blocks (see Empty Raster Blocks). The number of elements in the SDO_NUMBER_ARRAY object must be either one (same filling value used for all bands) or the band dimension size (a different filling value for each band, respectively). For example, SDO_NUMBER_ARRAY(1,5,10) fills the first band with 1, the second band with 5, and the third band with 10. The default bgValues are zero (0). The filling values must be valid cell values as specified by the target cell depth background values for filling sparse data.parallelParam
- Specifies the degree of parallelism for the operation.java.lang.Exception
public void affineTransform(SdoGeoRaster inGeoRaster, java.math.BigDecimal[] translation, double[] scales, java.math.BigDecimal[] rotatePoint, java.lang.Double rotateAngle, double[] shear, java.lang.Integer reflection, java.lang.String storageParam, SdoGeoRaster outGeoRaster, double[] bgValues, int parallelParam) throws java.lang.Exception
inGeoRaster
- GeoRaster object on which to perform the operationtranslation
- An array of numbers contains the shift in x and y directions. If it is NULL, no translation happens.scales
- An array of numbers contains the multiplication factors of image row and column. The first number is for column, and the second for row. If any one is NULL, no scale for that dimension; if the parameter is NULL, no scale applies.rotatePoint
- Defines the point (X,Y) about which to rotate; if new use the default point (0,0).rotateAngle
- The angle to rotate. If is NULL no rotation applies.shear
- Array of numbers contains the shearing in x and y directions. The first number is X axis, and the second for Y axis. If any one is NULL, no shearing for that dimension; if the parameter is NULL, no shearing applies.reflection
- Defines the axis about which the image is reflected, 1 represent X axis, and 2 for Y axis. If it is NULL, no reflection applies.storageParam
- A string specifying storage parameters for the result.outGeoRaster
- GeoRaster object to hold the result of the operation. Must be either a valid existing GeoRaster object or an empty GeoRaster object. (Empty GeoRaster objects are explained in Blank and Empty GeoRaster Objects.) Cannot be the same GeoRaster object as inGeoRasterbgValues
- Background values for filling partially empty raster blocks. It is only useful when the source GeoRaster object has empty raster blocks and the current operation leads to partially empty raster blocks (see Empty Raster Blocks). The number of elements in the SDO_NUMBER_ARRAY object must be either one (same filling value used for all bands) or the band dimension size (a different filling value for each band, respectively). For example, SDO_NUMBER_ARRAY(1,5,10) fills the first band with 1, the second band with 5, and the third band with 10. The default bgValues are zero (0). The filling values must be valid cell values as specified by the target cell depth background values for filling sparse data.parallelParam
- Specifies the degree of parallelism for the operation. If specified, must be greater than 1. The database optimizer uses the degree of parallelism specified by this parameter. If parallelism is specified, the procedure performs an internal commit operation. If an error occurs (even if it is raised by the Oracle parallel server), you must delete the resulting output GeoRaster object explicitly in order to roll back the operation.java.lang.Exception