vega.hipe.pds

Class PDSImage

java.lang.Object

SimpleImage

vega.hipe.pds.PDSImage

public class PDSImage
extends SimpleImage

Class that stores an image read in Planetary Data Science format. As it inherit from SimpleImage it can be handle by Hipe and save as FITS

Field Summary

Fields

Modifier and Type	Field and Description
static java.lang.String	A_AXIS_RADIUS
static java.lang.String	ASCENDING_NODE_LONGITUDE
static java.lang.String	B_AXIS_RADIUS
static java.lang.String	BAND_STORAGE_TYPE
static java.lang.String	BANDS
static java.lang.String	BANDWIDTH
static java.lang.String	BYTES
static java.lang.String	C_AXIS_RADIUS
static java.lang.String	CENTER_FILTER_WAVELENGTH
static java.lang.String	CENTER_LATITUDE
static java.lang.String	CENTER_LONGITUDE
static java.lang.String	COORDINATE_SYSTEM_NAME
static java.lang.String	COORDINATE_SYSTEM_TYPE
static java.lang.String	DATA_QUALITY_DESC
static java.lang.String	DATA_QUALITY_ID
static java.lang.String	DATA_SET_ID
static java.lang.String	DATA_SET_MAP_PROJECTION_CATALOG
static java.lang.String	DECLINATION
static java.lang.String	DESCRIPTION
static java.lang.String	DETECTOR_ID
static java.lang.String	DETECTOR_TEMPERATURE
static java.lang.String	EASTERNMOST_LONGITUDE
static java.lang.String	END_OBJECT
static java.lang.String	EVENT_TYPE
static java.lang.String	FILE_NAME
static java.lang.String	FILE_RECORDS
static java.lang.String	FIRST_STANDARD_PARALLEL
static java.lang.String	FOCAL_PLANE_TEMPERATURE
static java.lang.String	FOOTPRINT_POINT_LATITUDE
static java.lang.String	FOOTPRINT_POINT_LONGITUDE
static java.lang.String	HEADER_TYPE
static java.lang.String	IMAGE
static java.lang.String	IMAGE_HEADER
static java.lang.String	INST_CMPRS_NAME
static java.lang.String	INST_CMPRS_QUALITY
static java.lang.String	INST_CMPRS_QUANTZ_TBL_ID
static java.lang.String	INST_CMPRS_RATIO
static java.lang.String	INSTRUMENT_HOST_ID
static java.lang.String	INSTRUMENT_HOST_NAME
static java.lang.String	INSTRUMENT_NAME
static java.lang.String	INSTRUMENT_TEMPERATURE
static java.lang.String	INTERCHANGE_FORMAT
static java.lang.String	LABEL_RECORDS
static java.lang.String	LENS_TEMPERATURE
static java.lang.String	LINE_FIRST_PIXEL
static java.lang.String	LINE_LAST_PIXEL
static java.lang.String	LINE_PROJECTION_OFFSET
static java.lang.String	LINE_SAMPLES
static java.lang.String	LINES
static java.lang.String	MACROPIXEL_SIZE
static java.lang.String	MAP_PROJECTION_ROTATION
static java.lang.String	MAP_PROJECTION_TYPE
static java.lang.String	MAP_RESOLUTION
static java.lang.String	MAP_SCALE
static java.lang.String	MAXIMUM
static java.lang.String	MAXIMUM_LATITUDE
static java.lang.String	MAXIMUM_RESOLUTION
static java.lang.String	MEAN
static java.lang.String	MINIMUM
static java.lang.String	MINIMUM_LATITUDE
static java.lang.String	MISSING_FRAMES
static java.lang.String	MISSION_NAME
static java.lang.String	MISSION_PHASE_NAME
static java.lang.String	OBJECT
static java.lang.String	OFFSET_ANGLE
static java.lang.String	ORBIT_NUMBER
static java.lang.String	ORBITAL_ECCENTRICITY
static java.lang.String	ORBITAL_INCLINATION
static java.lang.String	ORBITAL_SEMIMAJOR_AXIS
static java.lang.String	PDS_VERSION_ID
static java.lang.String	PERIAPSIS_ALTITUDE
static java.lang.String	PERIAPSIS_ARGUMENT_ANGLE
static java.lang.String	PERIAPSIS_TIME
static java.lang.String	PIXEL_SUBSAMPLING_FLAG
static java.lang.String	POSITIVE_LONGITUDE_DIRECTION
static java.lang.String	PROCESSING_LEVEL_ID
static java.lang.String	PRODUCT_ID
static java.lang.String	RADIANCE_OFFSET
static java.lang.String	RADIANCE_SCALING_FACTOR
static java.lang.String	RECORD_BYTES
static java.lang.String	RECORD_TYPE
static java.lang.String	REFERENCE_LATITUDE
static java.lang.String	REFERENCE_LONGITUDE
static java.lang.String	REFLECTANCE_SCALING_FACTOR
static java.lang.String	RELEASE_ID
static java.lang.String	REVISION_ID
static java.lang.String	RIGHT_ASCENSION
static java.lang.String	SAMPLE_BITS
static java.lang.String	SAMPLE_FIRST_PIXEL
static java.lang.String	SAMPLE_LAST_PIXEL
static java.lang.String	SAMPLE_PROJECTION_OFFSET
static java.lang.String	SAMPLE_TYPE
static java.lang.String	SECOND_STANDARD_PARALLEL
static java.lang.String	SIGNAL_CHAIN_ID
static java.lang.String	SPACECRAFT_CLOCK_START_COUNT
static java.lang.String	SPACECRAFT_CLOCK_STOP_COUNT
static java.lang.String	SPACECRAFT_ORIENTATION
static java.lang.String	SPACECRAFT_POINTING_MODE
static java.lang.String	SPACECRAFT_SOLAR_DISTANCE
static java.lang.String	STANDARD_DEVIATION
static java.lang.String	TARGET_NAME
static java.lang.String	WESTERNMOST_LONGITUDE

Constructor Summary

Constructors

Constructor and Description
PDSImage()

Method Summary

Methods

Modifier and Type	Method and Description
java.awt.image.BufferedImage	asBufferedImage() Get this image as BufferedImage so it can be handle by standard java image library
PDSImage	descalate(float factor) Reduce the scale of this picture by a factor.
PDSImage	getAtResolution(float resolution) Get the image a specific PIXEL/DEGREE resolution
PDSImage	getAtScale(float scale) Get the picture at a specific KM/PIXEL scale
java.lang.Double	getDoubleMetadata(java.lang.String name) Get the value of a metadata as Double.
java.lang.Integer	getIntegerMetadata(java.lang.String name) Get the value of a metadata as integer.
java.lang.Long	getLongMetadata(java.lang.String name) Get the value of a metadata as Long.
double	getMaximumLatitude() Get the maximum latitude of this image.
double	getMaximumLongitude() Get the maximum longitude of this image.
double	getMinimumLatitude() Get the minimum latitude of this image.
double	getMinimumLongitude() Get the minimum longitude of this image.
int[]	getPixelAt(double latitude, double longitude) Get the x and y postion of the pixel that represents these coordinates in latitude and longitude
java.lang.String	getStringMetadata(java.lang.String name) Get the value of a metadata as String
PDSImage	getSubImage(double minimumLatitude, double minimumLongitude, double maximumLatitude, double maximumLongitude) Get a subset of this image described by a rectangle.
java.awt.image.WritableRaster	getWritableRaster() Get the writable raster of this image
static PDSImage	readPdsFile(java.lang.String file) Read a PDS image from a file.
java.lang.String	toString()

Methods inherited from class java.lang.Object

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

Field Detail

OFFSET_ANGLE

public static java.lang.String OFFSET_ANGLE

PERIAPSIS_TIME

public static java.lang.String PERIAPSIS_TIME

LINE_SAMPLES

public static java.lang.String LINE_SAMPLES

WESTERNMOST_LONGITUDE

public static java.lang.String WESTERNMOST_LONGITUDE

DATA_SET_MAP_PROJECTION_CATALOG

public static java.lang.String DATA_SET_MAP_PROJECTION_CATALOG

DATA_QUALITY_DESC

public static java.lang.String DATA_QUALITY_DESC

MEAN

public static java.lang.String MEAN

RELEASE_ID

public static java.lang.String RELEASE_ID

LINE_FIRST_PIXEL

public static java.lang.String LINE_FIRST_PIXEL

FILE_RECORDS

public static java.lang.String FILE_RECORDS

SAMPLE_PROJECTION_OFFSET

public static java.lang.String SAMPLE_PROJECTION_OFFSET

INST_CMPRS_RATIO

public static java.lang.String INST_CMPRS_RATIO

REVISION_ID

public static java.lang.String REVISION_ID

ORBITAL_INCLINATION

public static java.lang.String ORBITAL_INCLINATION

SAMPLE_LAST_PIXEL

public static java.lang.String SAMPLE_LAST_PIXEL

REFLECTANCE_SCALING_FACTOR

public static java.lang.String REFLECTANCE_SCALING_FACTOR

EASTERNMOST_LONGITUDE

public static java.lang.String EASTERNMOST_LONGITUDE

MINIMUM_LATITUDE

public static java.lang.String MINIMUM_LATITUDE

MINIMUM

public static java.lang.String MINIMUM

BANDS

public static java.lang.String BANDS

REFERENCE_LONGITUDE

public static java.lang.String REFERENCE_LONGITUDE

SPACECRAFT_POINTING_MODE

public static java.lang.String SPACECRAFT_POINTING_MODE

COORDINATE_SYSTEM_NAME

public static java.lang.String COORDINATE_SYSTEM_NAME

DETECTOR_ID

public static java.lang.String DETECTOR_ID

MISSING_FRAMES

public static java.lang.String MISSING_FRAMES

COORDINATE_SYSTEM_TYPE

public static java.lang.String COORDINATE_SYSTEM_TYPE

INTERCHANGE_FORMAT

public static java.lang.String INTERCHANGE_FORMAT

PROCESSING_LEVEL_ID

public static java.lang.String PROCESSING_LEVEL_ID

SPACECRAFT_CLOCK_STOP_COUNT

public static java.lang.String SPACECRAFT_CLOCK_STOP_COUNT

BANDWIDTH

public static java.lang.String BANDWIDTH

A_AXIS_RADIUS

public static java.lang.String A_AXIS_RADIUS

SPACECRAFT_CLOCK_START_COUNT

public static java.lang.String SPACECRAFT_CLOCK_START_COUNT

PRODUCT_ID

public static java.lang.String PRODUCT_ID

MAXIMUM_LATITUDE

public static java.lang.String MAXIMUM_LATITUDE

PERIAPSIS_ALTITUDE

public static java.lang.String PERIAPSIS_ALTITUDE

PIXEL_SUBSAMPLING_FLAG

public static java.lang.String PIXEL_SUBSAMPLING_FLAG

DESCRIPTION

public static java.lang.String DESCRIPTION

SPACECRAFT_ORIENTATION

public static java.lang.String SPACECRAFT_ORIENTATION

B_AXIS_RADIUS

public static java.lang.String B_AXIS_RADIUS

MISSION_NAME

public static java.lang.String MISSION_NAME

SAMPLE_FIRST_PIXEL

public static java.lang.String SAMPLE_FIRST_PIXEL

DETECTOR_TEMPERATURE

public static java.lang.String DETECTOR_TEMPERATURE

PDS_VERSION_ID

public static java.lang.String PDS_VERSION_ID

EVENT_TYPE

public static java.lang.String EVENT_TYPE

DATA_SET_ID

public static java.lang.String DATA_SET_ID

FIRST_STANDARD_PARALLEL

public static java.lang.String FIRST_STANDARD_PARALLEL

SPACECRAFT_SOLAR_DISTANCE

public static java.lang.String SPACECRAFT_SOLAR_DISTANCE

MAP_RESOLUTION

public static java.lang.String MAP_RESOLUTION

ORBIT_NUMBER

public static java.lang.String ORBIT_NUMBER

BYTES

public static java.lang.String BYTES

MACROPIXEL_SIZE

public static java.lang.String MACROPIXEL_SIZE

INST_CMPRS_NAME

public static java.lang.String INST_CMPRS_NAME

RECORD_TYPE

public static java.lang.String RECORD_TYPE

ORBITAL_ECCENTRICITY

public static java.lang.String ORBITAL_ECCENTRICITY

END_OBJECT

public static java.lang.String END_OBJECT

DECLINATION

public static java.lang.String DECLINATION

LINES

public static java.lang.String LINES

MISSION_PHASE_NAME

public static java.lang.String MISSION_PHASE_NAME

LENS_TEMPERATURE

public static java.lang.String LENS_TEMPERATURE

HEADER_TYPE

public static java.lang.String HEADER_TYPE

SECOND_STANDARD_PARALLEL

public static java.lang.String SECOND_STANDARD_PARALLEL

CENTER_LONGITUDE

public static java.lang.String CENTER_LONGITUDE

MAP_PROJECTION_TYPE

public static java.lang.String MAP_PROJECTION_TYPE

SAMPLE_BITS

public static java.lang.String SAMPLE_BITS

IMAGE_HEADER

public static java.lang.String IMAGE_HEADER

OBJECT

public static java.lang.String OBJECT

C_AXIS_RADIUS

public static java.lang.String C_AXIS_RADIUS

IMAGE

public static java.lang.String IMAGE

LINE_PROJECTION_OFFSET

public static java.lang.String LINE_PROJECTION_OFFSET

RIGHT_ASCENSION

public static java.lang.String RIGHT_ASCENSION

REFERENCE_LATITUDE

public static java.lang.String REFERENCE_LATITUDE

INST_CMPRS_QUANTZ_TBL_ID

public static java.lang.String INST_CMPRS_QUANTZ_TBL_ID

STANDARD_DEVIATION

public static java.lang.String STANDARD_DEVIATION

INSTRUMENT_NAME

public static java.lang.String INSTRUMENT_NAME

INST_CMPRS_QUALITY

public static java.lang.String INST_CMPRS_QUALITY

ORBITAL_SEMIMAJOR_AXIS

public static java.lang.String ORBITAL_SEMIMAJOR_AXIS

RADIANCE_SCALING_FACTOR

public static java.lang.String RADIANCE_SCALING_FACTOR

FOOTPRINT_POINT_LATITUDE

public static java.lang.String FOOTPRINT_POINT_LATITUDE

TARGET_NAME

public static java.lang.String TARGET_NAME

BAND_STORAGE_TYPE

public static java.lang.String BAND_STORAGE_TYPE

ASCENDING_NODE_LONGITUDE

public static java.lang.String ASCENDING_NODE_LONGITUDE

MAP_SCALE

public static java.lang.String MAP_SCALE

POSITIVE_LONGITUDE_DIRECTION

public static java.lang.String POSITIVE_LONGITUDE_DIRECTION

FOOTPRINT_POINT_LONGITUDE

public static java.lang.String FOOTPRINT_POINT_LONGITUDE

LINE_LAST_PIXEL

public static java.lang.String LINE_LAST_PIXEL

FOCAL_PLANE_TEMPERATURE

public static java.lang.String FOCAL_PLANE_TEMPERATURE

LABEL_RECORDS

public static java.lang.String LABEL_RECORDS

SAMPLE_TYPE

public static java.lang.String SAMPLE_TYPE

MAXIMUM_RESOLUTION

public static java.lang.String MAXIMUM_RESOLUTION

PERIAPSIS_ARGUMENT_ANGLE

public static java.lang.String PERIAPSIS_ARGUMENT_ANGLE

RADIANCE_OFFSET

public static java.lang.String RADIANCE_OFFSET

INSTRUMENT_HOST_ID

public static java.lang.String INSTRUMENT_HOST_ID

FILE_NAME

public static java.lang.String FILE_NAME

INSTRUMENT_HOST_NAME

public static java.lang.String INSTRUMENT_HOST_NAME

DATA_QUALITY_ID

public static java.lang.String DATA_QUALITY_ID

MAXIMUM

public static java.lang.String MAXIMUM

CENTER_LATITUDE

public static java.lang.String CENTER_LATITUDE

INSTRUMENT_TEMPERATURE

public static java.lang.String INSTRUMENT_TEMPERATURE

MAP_PROJECTION_ROTATION

public static java.lang.String MAP_PROJECTION_ROTATION

RECORD_BYTES

public static java.lang.String RECORD_BYTES

SIGNAL_CHAIN_ID

public static java.lang.String SIGNAL_CHAIN_ID

CENTER_FILTER_WAVELENGTH

public static java.lang.String CENTER_FILTER_WAVELENGTH

Constructor Detail

PDSImage

public PDSImage()

Method Detail

toString

public java.lang.String toString()

getStringMetadata

public java.lang.String getStringMetadata(java.lang.String name)

Get the value of a metadata as String

Parameters:

name - the name of the matadata

Returns:

the string representation of the metadata or null if the metadata does not exist or it can not converted to String

getDoubleMetadata

public java.lang.Double getDoubleMetadata(java.lang.String name)

Get the value of a metadata as Double. The metadata requested must be a double parameter or a string that can be parsed to a double

Parameters:

name - the name of the matadata

Returns:

the double representation of the metadata or null if the metadata does not exist or it can not converted to double

getLongMetadata

public java.lang.Long getLongMetadata(java.lang.String name)

Get the value of a metadata as Long. The metadata requested must be a double parameter or a string that can be parsed to a long

Parameters:

name - the name of the metadata

Returns:

the double representation of the metadata or null if the metadata does not exist or it can not converted to long

getIntegerMetadata

public java.lang.Integer getIntegerMetadata(java.lang.String name)

Get the value of a metadata as integer. The metadata requested must be a double parameter or a string that can be parsed to a integer

Parameters:

name - the name of the metadata

Returns:

the double representation of the metadata or null if the metadata does not exist or it can not converted to integer

readPdsFile

public static PDSImage readPdsFile(java.lang.String file)
                            throws java.io.IOException

Read a PDS image from a file. It has been only tested with MEX images, so it is improbable that can read universal PDS files.

Parameters:

file - the full path to the file

Returns:

Throws:

java.io.IOException - If it has problems opening the file

getMaximumLatitude

public double getMaximumLatitude()

Get the maximum latitude of this image. It reads the value form MAXIMUM_LATITUDE metadata. If the metadata is not present, it will fail.

Returns:

the maximum latitude of this image

getMinimumLatitude

public double getMinimumLatitude()

Get the minimum latitude of this image. It reads the value form MINIMUM_LATITUDE metadata. If the metadata is not present, it will fail.

Returns:

the maximum latitude of this image

getMinimumLongitude

public double getMinimumLongitude()

Get the minimum longitude of this image. It reads the value form WESTERNMOST_LONGITUDE metadata. If the metadata is not present, it will fail.

Returns:

the maximum latitude of this image

getMaximumLongitude

public double getMaximumLongitude()

Get the maximum longitude of this image. It reads the value form EASTERNMOST_LONGITUDE metadata. If the metadata is not present, it will fail.

Returns:

the maximum latitude of this image

getPixelAt

public int[] getPixelAt(double latitude,
               double longitude)
                 throws InvalidValueException

Get the x and y postion of the pixel that represents these coordinates in latitude and longitude

Parameters:

latitude -

longitude -

Returns:

An array of int with size 2. Index 0 represents the x value and index 1 the y value.

Throws:

InvalidValueException - If the latitude and longitude coordinates are outside this image.

getSubImage

public PDSImage getSubImage(double minimumLatitude,
                   double minimumLongitude,
                   double maximumLatitude,
                   double maximumLongitude)
                     throws InvalidValueException

Get a subset of this image described by a rectangle. All corners of the rectangle need to be within this picture

Parameters:

minimumLatitude - Latitude of the left upper corner of the rectangle

minimumLongitude - Longitude of the left upper corner of the rectangle

maximumLatitude - Latitude of the right down corner of the rectangle

maximumLongitude - Longitude of the right down corner of the rectangle

Returns:

Throws:

InvalidValueException - If any of the corners are outside the current picture

getWritableRaster

public java.awt.image.WritableRaster getWritableRaster()

Get the writable raster of this image

Returns:

The writable raster

asBufferedImage

public java.awt.image.BufferedImage asBufferedImage()

Get this image as BufferedImage so it can be handle by standard java image library

Returns:

descalate

public PDSImage descalate(float factor)
                   throws InvalidValueException

Reduce the scale of this picture by a factor. 1.0 is the same scale of this picture. 0.0 is a no picture

Parameters:

factor - a float value between 0 and 1

Returns:

The escalated image

Throws:

InvalidValueException - if the factor is greater than 1 or less than 0

getAtScale

public PDSImage getAtScale(float scale)
                    throws InvalidValueException

Get the picture at a specific KM/PIXEL scale

Parameters:

scale -

Returns:

The escalated image

Throws:

InvalidValueException - In the case that the scale result in a bigger resolution than the current image

getAtResolution

public PDSImage getAtResolution(float resolution)
                         throws InvalidValueException

Get the image a specific PIXEL/DEGREE resolution

Parameters:

resolution -

Returns:

Throws:

InvalidValueException - In the case that the PIXEL/DEGREE resolution result in a bigger resolution than the current image