ilog.views.maps.defense.format.asrp

Class IlvRasterASRPReader

java.lang.Object

ilog.views.maps.raster.IlvRasterAbstractReader

ilog.views.maps.defense.format.asrp.IlvRasterASRPReader

All Implemented Interfaces:

IlvPersistentObject, IlvMapFeatureIterator, IlvMapReusableFeatureIterator, Serializable

Direct Known Subclasses:

IlvRasterUSRPReader

public class IlvRasterASRPReader
extends IlvRasterAbstractReader

Reader of ASRP images. Example of use:

 IlvRasterASRPReader r = new IlvRasterASRPReader();
 r.addMap(fileName);
 

Since:

JViews 7.0

See Also:

Serialized Form

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	IlvRasterASRPReader.ASRPProjection Projection encapsulating an IlvARCProjectionFactory.IlvAbstractARCProjection to ensure that in the non-polar regions longitude coordinates smaller than the longitude origin will have a negative projected value.
protected static class	IlvRasterASRPReader.FieldPosition Class to store tag field position information.
protected static class	IlvRasterASRPReader.SubFieldPosition Class to store subfield position information.
protected static class	IlvRasterASRPReader.TagInfo Class to store and a list of IlvRasterASRPReader.SubFieldPosition position information.

Field Summary

Fields

Modifier and Type	Field and Description
protected String	imgFileName Raster information about the raster currently loading.
protected IlvMathTransform	internalTransformation Transformation from x/y to lat/lon data
protected int[]	tileIndexes List of tile indexes used when the ASRP image uses zero pixel tiles.

Fields inherited from class ilog.views.maps.raster.IlvRasterAbstractReader

needReload

Constructor Summary

Constructors

Constructor and Description
IlvRasterASRPReader() Default constructor.
IlvRasterASRPReader(IlvInputStream stream) Creates a new IlvRasterASRPReader from previously saved information in the input stream.

Method Summary

Modifier and Type	Method and Description
boolean	addMap(String baseName) Starts the reading of files and adds a new ASRP image.
boolean	addMap(URL url) Starts the reading of files and adds a new ASRP image.
IlvCoordinateSystem	getCoordinateSystem() Returns a projected ARC coordinate system.
protected double	getDoubleField(byte[] data, IlvRasterASRPReader.SubFieldPosition fpos) Utility method to read and convert raw bytes to double subfield data.
IlvMathTransform	getInternalTransformation(int imageIndex) Return the projection associated with the zone of the file to load.
protected int	getIntField(byte[] data, IlvRasterASRPReader.SubFieldPosition fpos) Utility method to read and convert raw bytes to int subfield data.
IlvFeatureAttributeProperty	getProperties(int imageIndex) Returns the feature properties to be associated with the image.
protected String	getStringField(byte[] data, IlvRasterASRPReader.SubFieldPosition fpos) Utility method to read and convert raw bytes to string subfield data.
static boolean	isASRPFile(File file) Checks if a file could be an ASRP GEN File by checking its content.
protected static FileInputStream	openStream(String fileName) Opens a file input stream trying for extension in upper and lowercase.
protected static InputStream	openStream(URL url) < Opens a file input stream trying for extension in upper and lowercase.
protected IlvRasterASRPReader.TagInfo	parseFields(String descr) Decodes the list of subfields from a string - returns the filled TagInfo.
protected void	parseTags(Hashtable<String,IlvRasterASRPReader.FieldPosition> t, String descr, int nbCharLength, int nbCharPos, int nbCharName) Decodes the list of fields in a record from a string - adds them to the hashtable.
protected byte[]	readData(DataInput stream, Hashtable<String,IlvRasterASRPReader.FieldPosition> tags) Utility method to read raw data bytes from an ASRP record - also fills tags with data.
protected void	readGEN(String file, IlvRasterProperties loadingRaster) Reads the GEN file of a ASRP image.
protected void	readGEN(URL url, IlvRasterProperties loadingRaster) Reads the GEN file of a ASRP image.
protected void	readIMG(String fileName, IlvRasterProperties loadingRaster, byte[] rasterData) Reads the IMG file of an ASRP image.
protected void	readIMG(URL url, IlvRasterProperties loadingRaster, byte[] rasterData) Reads the IMG file of an ASRP image.
protected void	readQAL(String file, IlvRasterProperties loadingRaster, HashMap<String,String> digestProperties) Reads the QAL file of a ASRP image.
protected void	readQAL(URL url, IlvRasterProperties loadingRaster, HashMap<String,String> digestProperties) Reads the QAL file of a ASRP image.
void	reload(IlvThreadMonitoringData monitorInfo) Given the state of the reader (number of images read, coverage zone,...), the purpose of this method is to recreate all images from the original source.
protected void	storeDigestProperties(Hashtable<String,IlvRasterASRPReader.TagInfo> fields, Hashtable<String,IlvRasterASRPReader.FieldPosition> tags, byte[] data, HashMap<String,String> digestProperties) Method that analyses QAL file data in order to store the DIGEST meta data.
void	write(IlvOutputStream stream) Writes the attributes of a persistent object.

Methods inherited from class ilog.views.maps.raster.IlvRasterAbstractReader

addRaster, computeGisImageBounds, computeLimits, createRasterTileLoader, dispose, getDefaultFeatureRenderer, getDefaultMaximumIntervalsForDeterminingImageLocation, getImageBounds, getImageCount, getInverseTransformation, getLowerRightCorner, getLowerRightCorner, getMaximumIntervalsForDeterminingImageLocation, getNextFeature, getRasterMappedBuffer, getRasterProperties, getTileLoader, getTileLoader, getTileLoaders, getTransformation, getUpperLeftCorner, getUpperLeftCorner, isForceImageLoadingWhenSaving, isGeoreferenced, isHighQualityRendering, isNeedReload, removeRaster, restart, setDefaultMaximumIntervalsForDeterminingImageLocation, setForceImageLoadingWhenSaving, setHighQualityRendering, setMaximumIntervalsForDeterminingImageLocation, setTransformation

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

internalTransformation

protected transient IlvMathTransform internalTransformation

Transformation from x/y to lat/lon data

tileIndexes

protected int[] tileIndexes

List of tile indexes used when the ASRP image uses zero pixel tiles.

imgFileName

protected String imgFileName

Raster information about the raster currently loading.

Constructor Detail

IlvRasterASRPReader

public IlvRasterASRPReader()

Default constructor.

IlvRasterASRPReader

public IlvRasterASRPReader(IlvInputStream stream)
                    throws IlvReadFileException

Creates a new IlvRasterASRPReader from previously saved information in the input stream.

Parameters:

stream - Stream being read.

Throws:

IlvReadFileException

Method Detail

getInternalTransformation

public IlvMathTransform getInternalTransformation(int imageIndex)

Return the projection associated with the zone of the file to load.

Specified by:

getInternalTransformation in class IlvRasterAbstractReader

Parameters:

imageIndex - The index of the image in the collection of image returned by the IlvRasterAbstractReader.getTileLoader(int)method.

Returns:

An IlvNonPolarARCProjection for zones 1 to 8 and 10 to 17, a IlvNorthPolarARCProjection for the zone 11 or an IlvSouthPolarARCProjection for zone 18.

addMap

public boolean addMap(String baseName)
               throws IOException

Starts the reading of files and adds a new ASRP image.

• Reads the .GEN File
• Reads the .QUA File
• Builds the appropriate bitmap array to store data
• Reads the .IMG File

Parameters:

baseName - The base name path of the file.

Returns:

true if the ASRP file was successfully loaded.

Throws:

IOException

addMap

public boolean addMap(URL url)
               throws IOException

Starts the reading of files and adds a new ASRP image.

• Reads the .GEN File
• Reads the .QUA File
• Builds the appropriate bitmap array to store data
• Reads the .IMG File

Parameters:

url - The URL of the file.

Returns:

true if the ASRP file was successfully loaded.

Throws:

IOException

Since:

JViews 7.5

write

public void write(IlvOutputStream stream)
           throws IOException

Writes the attributes of a persistent object.

Specified by:

write in interface IlvPersistentObject

Overrides:

write in class IlvRasterAbstractReader

Parameters:

stream - The output stream.

Throws:

IOException - thrown when an exception occurs during the write operation for this object.

reload

public void reload(IlvThreadMonitoringData monitorInfo)

Given the state of the reader (number of images read, coverage zone,...), the purpose of this method is to recreate all images from the original source. Note : this method should not rely on the list of IlvRasterProperties of the reader as they might not be saved when the theme only is saved.

Overrides:

reload in class IlvRasterAbstractReader

Parameters:

monitorInfo - Used to update task progress.

See Also:

IlvRasterAbstractReader.reload(ilog.views.maps.raster.datasource.IlvThreadMonitoringData)

getDoubleField

protected double getDoubleField(byte[] data,
                                IlvRasterASRPReader.SubFieldPosition fpos)

Utility method to read and convert raw bytes to double subfield data.

Parameters:

data - The data to analyze.

fpos - The position of the subfield.

Returns:

The double value of the subfield.

getIntField

protected int getIntField(byte[] data,
                          IlvRasterASRPReader.SubFieldPosition fpos)

Utility method to read and convert raw bytes to int subfield data.

Parameters:

data - The data to analyze.

fpos - The position of the subfield.

Returns:

The int value of the subfield.

getStringField

protected String getStringField(byte[] data,
                                IlvRasterASRPReader.SubFieldPosition fpos)

Utility method to read and convert raw bytes to string subfield data.

Parameters:

data - The data to analyze.

fpos - The position of the subfield.

Returns:

The text value of the subfield.

parseFields

protected IlvRasterASRPReader.TagInfo parseFields(String descr)

Decodes the list of subfields from a string - returns the filled TagInfo.

Parameters:

descr - The field description.

Returns:

The information decoded from the description.

storeDigestProperties

protected void storeDigestProperties(Hashtable<String,IlvRasterASRPReader.TagInfo> fields,
                                     Hashtable<String,IlvRasterASRPReader.FieldPosition> tags,
                                     byte[] data,
                                     HashMap<String,String> digestProperties)

Method that analyses QAL file data in order to store the DIGEST meta data.

Parameters:

fields - TagInfo per name Hashtable. It will be filled by fields found in the digest data

tags - FieldPosition per name Hashtable. This mst be provided

data - data read from QAL file.

digestProperties - string value per complete name Hashtable filled by this method.

parseTags

protected void parseTags(Hashtable<String,IlvRasterASRPReader.FieldPosition> t,
                         String descr,
                         int nbCharLength,
                         int nbCharPos,
                         int nbCharName)

Decodes the list of fields in a record from a string - adds them to the hashtable.

Parameters:

t - The table containing the parsed tags.

descr - The description.

nbCharLength - Number of characters for the length part.

nbCharPos - Number of characters for the position part.

nbCharName - Number of characters for the name part.

readData

protected byte[] readData(DataInput stream,
                          Hashtable<String,IlvRasterASRPReader.FieldPosition> tags)
                   throws IOException

Utility method to read raw data bytes from an ASRP record - also fills tags with data.

Parameters:

stream - The input stream to read.

tags - The table in which to put the tags read by this utility.

Returns:

The data read that needs to be analyzed.

Throws:

IOException - when an error is encountered when reading the stream.

readGEN

protected void readGEN(String file,
                       IlvRasterProperties loadingRaster)
                throws IOException

Reads the GEN file of a ASRP image.

Parameters:

file - The path to the GEN file.

loadingRaster - Information about the current image.

Throws:

IOException

readGEN

protected void readGEN(URL url,
                       IlvRasterProperties loadingRaster)
                throws IOException

Reads the GEN file of a ASRP image.

Parameters:

url - The url to the GEN file.

loadingRaster - Information about the current image.

Throws:

IOException

Since:

JViews 7.5

openStream

protected static FileInputStream openStream(String fileName)
                                     throws FileNotFoundException

Opens a file input stream trying for extension in upper and lowercase.

Parameters:

fileName - The file name to open.

Returns:

The file input stream.

Throws:

FileNotFoundException

openStream

protected static InputStream openStream(URL url)
                                 throws MalformedURLException,
                                        IOException

< Opens a file input stream trying for extension in upper and lowercase.

Parameters:

url - the url to open.

Returns:

the file input stream.

Throws:

IOException

MalformedURLException

FileNotFoundException

Since:

JViews 7.5

readIMG

protected void readIMG(String fileName,
                       IlvRasterProperties loadingRaster,
                       byte[] rasterData)
                throws IOException

Reads the IMG file of an ASRP image.

Parameters:

fileName - The path to the GEN file.

loadingRaster - Information about the current image.

rasterData - The raster data.

Throws:

IOException

readIMG

protected void readIMG(URL url,
                       IlvRasterProperties loadingRaster,
                       byte[] rasterData)
                throws IOException

Reads the IMG file of an ASRP image.

Parameters:

url - The url to the GEN file.

loadingRaster - Information about the current image.

rasterData - The raster data.

Throws:

IOException

Since:

JViews 7.5

readQAL

protected void readQAL(String file,
                       IlvRasterProperties loadingRaster,
                       HashMap<String,String> digestProperties)
                throws IOException

Reads the QAL file of a ASRP image.

Parameters:

file - The path to the QAL file.

loadingRaster - Information about the current image.

digestProperties - name/value pair hashtable for metadata found in the QAL file.

Throws:

IOException

readQAL

protected void readQAL(URL url,
                       IlvRasterProperties loadingRaster,
                       HashMap<String,String> digestProperties)
                throws IOException

Reads the QAL file of a ASRP image.

Parameters:

url - The url to the QAL file.

loadingRaster - Information about the current image.

digestProperties - name/value pair hashtable for metadata found in the QAL file.

Throws:

IOException

Since:

JViews 7.5

getCoordinateSystem

public IlvCoordinateSystem getCoordinateSystem()

Returns a projected ARC coordinate system.

Returns:

The coordinate system, or null if the coordinate system is unknown.

See Also:

IlvMapFeatureIterator.getCoordinateSystem()

getProperties

public IlvFeatureAttributeProperty getProperties(int imageIndex)

Returns the feature properties to be associated with the image.

Specified by:

getProperties in class IlvRasterAbstractReader

Parameters:

imageIndex - The index of the image.

Returns:

The properties to be associated with the image.

See Also:

IlvRasterAbstractReader.getProperties(int)

isASRPFile

public static boolean isASRPFile(File file)

Checks if a file could be an ASRP GEN File by checking its content.

Parameters:

file - file to check.

Returns:

true if the file can be an ASRP GEN file.

Since:

JViews 7.5