| Environments | PYTHON :: EASI |
| Quick links | Description :: Parameters :: Parameter descriptions :: Details :: Examples :: Related |
| Back to top |
| Back to top |
cdl(file, dbcl, dtyp)
| Name | Type | Caption | Length | Value range |
|---|---|---|---|---|
| FILE * | str | Input file name | 1 - | |
| DBCL | List[int] | Input channel(s) | 0 - | |
| DTYP | str | Description report type | 0 - 5 | SHORT | FULL Default: SHORT |
| Back to top |
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.
DTYP
Specifies the type of descriptor listing.
For more information, see the Details section.
| Back to top |
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
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
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)
| Back to top |
The following example shows a SHORT CDL listing.
from pci.cdl import cdl
file = "irvine.pix"
cdl(file)
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.
from pci.cdl import cdl file = 'irvine.pix' dbcl = [10] dtyp = "FULL" cdl(file,dbcl,dtyp)
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.®, 2026. All rights reserved.