LOCK

Description

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

Parameters

lock(file, dbic)

Name	Type	Caption	Length	Value range
FILE *	str	Input file name	1 -
DBIC	List[int]	Input raster channel(s)	0 -

* Required parameter

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.

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.

Examples

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

from pci.lock import lock

file	=	'irvine.pix'
dbic	=	[1,-6,10]

lock( file, dbic )

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.

from pci.lock import lock

file	=	'results.pix'
dbic	=	[]

lock( file, dbic )