CHIPIMPORT

Create chip database from chips


EnvironmentsPYTHON :: EASI
Quick linksDescription :: Parameters :: Parameter descriptions :: Return Value :: Details :: Example

Back to top

Description


CHIPIMPORT wraps a group of chips into a chip database.
Back to top

Parameters


chipimport(mfile, chipfile, filedem)

Name Type Caption Length Value range
MFILE * str directory of chips 1 -    
CHIPFILE * str Name of chip database 1 -    
FILEDEM str DEM file name 0 -    

* Required parameter
Back to top

Parameter descriptions

MFILE

Specifies the directory of chips.

CHIPFILE

Specifies the name of the chip database in which to store the extracted chips. If the database already exists, the new chips are appended to it. If it does not already exist, a new CDB file is created.

FILEDEM

Specifies a name for the DEM file that extracts the elevation value of the extracted chip. If this parameter is not specified, no elevation value is extracted.

Back to top

Return Value

Returns: execution status

Type:  PCI_INT

Returns 0 if the extraction is successful; otherwise returns -1.

Back to top

Details

CHIPIMPORT wraps a group of chips to a chip database. Each chip should have a txt file as its entry

Each text file should have the following entries:

Chip File: Chip file name - string

ChipID: Chip Id - string

Description: Chip description - string

Image Desc.: Image description - string

Sensor: Sensor name - string

View Angle: View angle - float

Acquisition Date: Time - string ddmmmyyyy

SceneID: Scene Id - string

Projection: Projection unit - string like C2000_42 D000

GCP Geo Location: Chip geo offset - 2 floats

Elevation: Elevation height - float

GCP Image Location: Pixel/Line offset of the chip - 2 floats

Chip Size: Chip size - 2 ints

Resolution: Chip resolution for pixel - 2 floats

Rotation Angle: Rotation - float

N..of Bands: Band number - int

Data Type: 8U/16U/16S/32R - string

Source File: The image file name the chip comes from

Access Number: - int

Average Success Score: - int

Back to top

Example

Create a new chip database by importing chips defined in an existing text file.

from pci.chipimport import chipimport

mfile    =  'entry.txt'
chipfile =  'chips.cdb'
filedem  =  '' # No elevation is extracted

chipimport(mfile, chipfile, filedem)
           

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