RANFRAC

Description

Evaluates a set of 32R channels to be a random fraction vector map. Each channel of the map corresponds to a fraction vector element. On a pixel-by-pixel basis, the sum of the channels will be 1. The fraction of 1 in each channel of the map at each pixel location is pseudorandomly generated. RANFRAC deletes pre-existing image metadata from input file.

Parameters

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

* Required parameter

Parameter descriptions

FILE

Specifies the name of the existing file to receive the fraction map.

DBOC

Specifies the output channels in the input file to comprise the fraction vector map. The channels must all be of type 32R.

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.

Details

The specified output channels are evaluated to a fraction vector map. Denote the computed N-dimensional output channel band vector at pixel location p by frac_p (fraction vector p). Pixel p in the ith specified output channel is given the value of the ith element of frac_p.

The fraction vectors are pseudorandomly generated. The elements of each fraction vector are non-negative, and sum to 1.

Examples

This example illustrates the verification of the correctness of ENDMEMB.

Create an image file to contain a 3-channel random fraction vector map and a 224 channel synthetic image:

EASI>file	=	"synth.pix"
EASI>dbsz	=	100, 100
EASI>pxsz	=	1, 1
EASI>dbnc	=	0,0,0,227
EASI>dblayout=	"pixel"
EASI>tex1    =	
EASI>tex2    =	

EASI>RUN CIM

Evaluate channels 225, 226, 227 to a random fraction vector map:

EASI>file	=	'synth.pix'
EASI>dboc	=	225,226,227

EASI>RUN RANFRAC

Evaluate channels 1 to 224 to a synthetic image. The three input endmember spectra may be extracted from cuprad.pix using the Focus spectra plotting window. Here, the endmember spectra are stored USGS format file "in.spl":

EASI>file	=	'synth.pix'
EASI>specfile	=	'in.spl'
EASI>dbic	=	225,226,227
EASI>dboc	=	1, -224

EASI>RUN SPMIX

Use ENDMEMB to compute endmembers for the synthetic image and write them out USGS-format spectra file "out.spl" :

EASI>file	=	'synth.pix'
EASI>dbic	=	dboc
EASI>wlenint	=
EASI>valonly	=
EASI>dbiw	=
EASI>dbib	=
EASI>nendmemb	=	3
EASI>errsetsz	=	10
EASI>bvanglthr	=	5
EASI>specfilo	=	'out.spl'
EASI>filotype	=	'spl'
EASI>rtlevel	=	0

EASI>RUN ENDMEMB

Acknowledgements

PCI Geomatics received financial support from the Canadian Space Agency/L'Agence Spatiale Canadienne through the Earth Observation Application Development Program (EOADP) for the development of this software, under contract 9F028-0-4902/12.