LOCK

Write-lock image channels


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

Back to top

Description


Prevents the contents of image channels in a PCIDSK file from being overwritten. Write-locked channels can still be read.
Back to top

Parameters


Name Type Caption Length Value range
FILE * String Input file name 1 - 192  
DBIC Integer Input raster channel(s) 0 -    

* Required parameter
Back to top

Parameter descriptions

FILE

Specifies the name of the PCIDSK file that contains the image channels to lock.

DBIC

Specifies the image channel(s) to lock.

If this parameter is not specified, all channels are locked.

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.

Back to top

Details

LOCK prevents the contents of image channels in a PCIDSK file from being overwritten.

Specified image channels (DBIC) can be locked against writing. Write-locked channels can be read but cannot be overwritten. A write-locked channel may be used as input to any operation but cannot have an operation generated and saved to it. LOCK lets you protect specified channels (for example, the original raw data or completed results) from being accidently overwritten. Use UNLOCK to overwrite channels.

A PCIDSK file that does not have imagery channel headers cannot be locked. In such cases, LOCK generates a warning message.

Important: Locking a channel does not protect the data if the file is deleted.
Back to top

Examples

Ensure that channels 1 through 6, and channel 10 in the file 'irvine.pix', which contain raw data, cannot be overwritten.

EASI>file	=	'irvine.pix'
EASI>dbic	=	1,-6,10

EASI>RUN LOCK

To make the results of your work available to other users without providing them with the ability to modify them, it is recommended that all image channels in the file be locked.

EASI>file	=	'results.pix'
EASI>dbic	=	

EASI>RUN LOCK

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