CARIS Bathy DataBASE Server : CARIS Bathy DataBASE Server : Command Prompt Tools : Database Classify Raster Holidays
 

Database Classify Raster Holidays

The bathydbclassifyrasterholidays process classifies each cell in a raster band as valid data, no data or an interior holiday (hole). This process is run on one or more rasters in the database. The classification data is saved to a new band in the input raster, using the naming convention "<InputBand> and Holidays".

The following is the command line format for the BathyDBClassifyRasterHolidays tool and descriptions of the available parameters:

bathydbclassifyrasterholidays --database-name <value> --login-credentials <value> --database-type <value> --input-band <value> <inputs>

Parameter

 

Long

Short

Description

--help

-h

Display the help message (command format and descriptions of the available parameters).

--login-credentials

-L

The credentials of the database superuser used to log in to the relational database server. The expected format is tied to the database server type.

For PostrgeSQL is it specified as:
SuperUserName[/password][@hostname][:port]

For Oracle it is specified as:
superUserName[/password][@<connect_identifier>] where <connect_identifier> can be in the form of an Oracle Net Service name <@net_service_name> or Easy Connect string @<Host>[:Port]/<service_name>.

--database-name

-D

The name of the database containing the datasets. A connection to the RDBMS will be established in order to modify the datasets in the database.

--database-type

-T

The database type. One of:

POSTGRES

ORACLE

--input-band

-i

A string specifying the name of the input raster band that will be classified.

--classify-no-data

-y

With this option set, every cell inside the raster surface extents is classified. By default, only the cells inside the outer boundary of the data in the band are classified.

<inputs>

The rasters to be classified. This can be entered as a list of the BOIDs for the database objects associated with the raster coverages, or by specifying CRFX attribute query files.

To use this command:

1. Open the command prompt window.

2. Go to the BDB Server bin directory, for example

C:\Program Files\CARIS\BDB Server\<version>\bin.

3. Type “bathydbclassifyrasterholidays” followed by the appropriate parameters.

4. To finish, press <Enter>.

The rasters that meet the input criteria are classified and the data saved to new holiday bands.

Example:

You need to identify holidays in database coverages, where:

the login credentials for the server are user1/s3cr3t@postgresserver:5432,

you need to log in to the “TrainingDB1” database,

the database type is PostgreSQL,

the Depth band on all specified database rasters will be analyzed,

all cells inside the raster are to be classified, and

the input coverages will be specified by the GriddedRasters.crfx rule file found in the D:\BatchSample\Rules directory.

Type the following:

bathydbclassifyrasterholidays --login-credentials postgres/superpass@localhost:5432 --database-name TrainingDB1 --database-type POSTGRES --input-band Depth --classify-no-data D:\BatchSample\Rules\GriddedRasters.crfx