PCIDEL2

Description

Deletes image channels from a PCIDSK image file created by CIM (separate image files are used for storing each image channel). Image channels are deleted by modifying the PCIDSK database header and (optionally) deleting the image files.

Parameters

pcidel2(file, delmode, dbic)

Name	Type	Caption	Length	Value range
FILE *	str	Input header file name	1 -
DELMODE *	str	Delete image file	2 - 3	YES | NO
DBIC *	List[int]	Input image channel(s)	1 -

* Required parameter

Parameter descriptions

FILE

Specifies the name of the PCIDSK header file to modify.

The input file must have image channels stored as separate image disk files (DBLAYOUT as FILE).

DELMODE

Specifies whether to delete individual image channel files from disk.

DBIC

Specifies the image channel(s) to delete from the PCIDSK database.

The channel number for a deleted channel can be used again by PCIADD2.

Details

PCIDEL2 deletes specified image channels (DBIC) from a PCIDSK database file (FILE) created by CIM or PCIADD2, where each image channel in the database is stored as a separate image disk file. PCIDEL2 cannot delete image channels created by PCIMOD; use PCIMOD to delete image channels created by PCIMOD.

The option to delete the image files may be specified (DELMODE). If DELMODE="NO", the PCIDSK database is modified so that the specified image channels are marked as deleted in the PCIDSK file header, but the actual image files containing the image data are NOT deleted from disk.

If DELMODE="YES", the PCIDSK database is modified so that the specified image channels are marked as deleted in the PCIDSK file header, and the actual image files containing the image data are actually deleted from disk.

PCIDEL2 changes the numbering of existing channels and removes the deleted channel(s) from the list.

Example

Delete channels 1, 3, and 6 from a 512x512 PCIDSK file created by CIM with DBLAYOUT as FILE , which already contains six image channels. The image files pertaining to these image channels are deleted from disk.

from pci.pcidel2 import pcidel2

file	=	"image.pix"
delmode	=	"yes"
dbic	=	[1,3,6]

pcidel2( file, delmode, dbic )