CDL

Channel descriptor listing


EnvironmentsPYTHON :: EASI
Quick linksDescription :: Parameters :: Parameter descriptions :: Details :: Examples :: Related

Back to top

Description


CDL prints various types of information about selected image channels to the report device, based on the channel descriptors.
Back to top

Parameters


Name Type Caption Length Value range
FILE* String Input file name 1 - 192  
DBCL Integer Input channel(s) 0 -    
DTYP String Description report type 0 - 5 SHORT | FULL
Default: SHORT
REPORT String Report mode 0 - 192 Quick links

* Required parameter
Back to top

Parameter descriptions

FILE

Specifies the name of the PCIDSK file for which to produce the channel descriptors report.

DBCL

Specifies the image channels for which descriptors are listed.

Ranges of channels or segments can be specified with negative values. For example, {1,-4,10} is internally expanded to {1,2,3,4,10}. When you are not specifying a range in this way, only 48 numbers can be specified explicitly.

DTYP

Specifies the type of descriptor listing.

Supported types are:

For more information, see the Details section.

REPORT

Specifies where to direct the generated report.

Available options are:

Back to top

Details

Channel descriptions are saved in the image file when a task writes image data to an output channel.

Although the channel description is usually automatically generated by the task, if a task is aborted while writing to the image channel, an error message appears in the channel description (*** Operation Aborted Before Completion ***)

CDL lists up to 1,024 channel descriptors (DBCL) for a specified PCIDSK file (FILE). Two types of reports may be specified: SHORT and FULL (DTYP). By default, CDL produces a short listing of all image channel descriptions.

The first line of the channel descriptor report has the form:

filespec                 [S nnnnPIC nnnnnnP nnnnnnL] dd-mmm-yy
where:

Short listing

When the short listing option is selected, each channel descriptor is listed with the following information:

nnnnnL[typ] program DESCRIPTIVE MESSAGE...             dd-mmm-yy
where:

Full listing

When a full listing option is selected, each image channel is listed with the following information:

Channel: nnnnn                 Type:  xxxxx
Creation: hh:mm dd-mmm-yy  Last Update:  hh:mm  dd-mmm-yy
Contents: xxxxxxx
Locking : xxxxxxx
File Name: xxxxxxx
History:
    (history line 1)
    (history line 2)
     . . .
    (history line 8)
where:
Back to top

Examples

The following example shows a SHORT CDL listing.

EASI>FILE    =   "irvine.pix"
EASI>DBCL    =
EASI>DTYP    =
EASI>REPORT  =

EASI>RUN CDL
irvine.pix                   [S   10PIC    512P    512L] 14-Aug-90
1L[ 8U] MCD  0.45 - 0.52 micrometers: Blue-Green         1-OCT-90
2L[ 8U] MCD  0.52 - 0.60 micrometers: Green              1-OCT-90
3L[ 8U] MCD  0.63 - 0.69 micrometers: Red                1-OCT-90
4L[ 8U] MCD  0.76 - 0.90 micrometers: Near I.R.          1-OCT-90
5L[ 8U] MCD  2.08 - 2.35 micrometers: Middle I.R.        1-OCT-90
6L[ 8U] MCD  USGS Land Use/Land Cover                    1-OCT-90
7 [ 8U] MCD  Supervised Classification Results           1-OCT-90
8 [ 8U] MCD  Working Channel      1-OCT-90
9 [ 8U] MCD  Working Channel      1-OCT-90
10L[16S] MCD  USGS Elevation Data  1-OCT-90

The following example shows a FULL CDL listing.

EASI>FILE    =   "irvine.pix"
EASI>DBCL    =   10
EASI>DTYP    =   "FULL"
EASI>REPORT  =

EASI>RUN CDL
irvine.pix                 [S   10PIC    512P    512L] 14-Aug-90
Channel:   10              Type: 16-bit signed integer
Creation: 11:19 14-Aug-90            Last Update: 13:57  1-OCT-90
Contents: USGS Elevation Data
Locking : Write Locked.  Read-only access.
History:
MCD    :USGS Elevation Data   13:57  1-OCT-90
C8TO16 :8-bit to 16-bit Image Conversion:DBIC=10,11  11:24 14-Aug-90
CIM    :Empty                 11:19 14-Aug-90

© PCI Geomatics Enterprises, Inc.®, 2024. All rights reserved.