get image

From DavinciWiki

Revision as of 10:00, 7 October 2009 by Cedwards (Talk | contribs)

(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)

Jump to: navigation, search

Contents: Description, Arguments, Usage, Examples, Sub-Functions, Related Functions, Source

Supported Under Version: >1.02

Current .dvrc Version: 1.09

Description

Used to download the specified image from the Mars Space Flight Facility Image Server.

Arguments and Return Values

Arguments: an image ID, instrument, and type

Return Value: the url to the specified image

Usage

Syntax: get_map( image_id [,instrument = STRING][,type = STRING]

Input Parameters:

image_id-the specified image id

Options:
instrument -           "ctx","hirise","moc"
                       "viking","themis","crism" (Default = "themis")
type (if themis) -     "BWS","DCS","D875","D964","D642"
                       "PBT","BTR","RDR","ABR" (Default is "RDR")
type (if crism) -      "TRDR-LBL","TRDR-IMG","DDR-LBL","DDR-IMG","MAF"
                        "HYD","PHY","ICE","TRU","IRA","FEM" (Default is "TRDR-LBL")
 
Note: type is only used for THEMIS/CRISM data

Examples

dv> out=load_pds(get_image("I01001001",instrument="themis",type="RDR"))
Downloading...............................done.
struct, 29 elements
   pds_version_id: "PDS3"
   record_type: ""FIXED_LENGTH""
   record_bytes: 644
   file_records: 71880
   label_records: 7
   ptr_to_history: 8
   ptr_to_spectral_qube: 21
   mission_name: ""2001 MARS ODYSSEY""
   instrument_host_name: ""2001 MARS ODYSSEY""
   instrument_name: ""THERMAL EMISSION IMAGING SYSTEM""
   instrument_id: ""THEMIS""
   detector_id: ""IR""
   mission_phase_name: ""MAPPING""
   target_name: ""MARS""
   product_id: ""I01001001RDR""
   producer_id: ""ODY_THM_TEAM""
   data_set_id: ""ODY-M-THM-3-IRRDR-V1.0""
   product_creation_time: "2004-10-10T13:45:29"
   product_version_id: ""1.6""
   release_id: ""0002""
   start_time: "2002-03-06T22:44:03.158"
   stop_time: "2002-03-06T22:48:02.626"
   spacecraft_clock_start_count: ""699921894.230""
   spacecraft_clock_stop_count: ""699922134.094""
   start_time_et: 68726707.34
   stop_time_et: 68726946.81
   orbit_number: 1001
   history: struct, 5 elements
       Object: "HISTORY"
       bytes: 8372
       history_type: "CUSTOM"
       interchange_format: "ASCII"
       data: struct, 7 elements...
   spectral_qube: struct, 54 elements
       Object: "SPECTRAL_QUBE"
       axes: 3
       axis_name: Text Buffer with 3 lines of text
           1: SAMPLE
           2: LINE
           3: BAND
       core_items: 3x1x1 array of int, bsq format [12 bytes]
       core_name: ""CALIBRATED_SPECTRAL_RADIANCE""
       core_item_bytes: 2
       core_item_type: "SUN_INTEGER"
       core_base: 0.000000000
       core_multiplier: 1.000000000
       core_unit: ""WATT*CM**-2*SR**-1*UM**-1""
       core_null: -32768
       core_valid_minimum: -32752
       core_low_repr_saturation: -32767
       core_low_instr_saturation: -32766
       core_high_repr_saturation: -32765
       core_high_instr_saturation: -32764
       suffix_items: 3x1x1 array of int, bsq format [12 bytes]
       suffix_bytes: 4
       sample_suffix_name: "HORIZONTAL_DESTRIPE"
       sample_suffix_item_bytes: 4
       sample_suffix_item_type: "SUN_REAL"
       sample_suffix_base: 0.000000000
       sample_suffix_multiplier: 1.000000000
       sample_suffix_valid_minimum: -8388614
       sample_suffix_null: -8388613
       sample_suffix_low_repr_sat: -8388612
       sample_suffix_low_instr_sat: -8388611
       sample_suffix_high_repr_sat: -8388609
       sample_suffix_high_instr_sat: -8388610
       line_suffix_name: "VERTICAL_DESTRIPE"
       line_suffix_item_bytes: 4
       line_suffix_item_type: "SUN_REAL"
       line_suffix_base: 0.000000000
       line_suffix_multiplier: 1.000000000
       line_suffix_valid_minimum: -8388614
       line_suffix_null: -8388613
       line_suffix_low_repr_sat: -8388612
       line_suffix_low_instr_sat: -8388611
       line_suffix_high_repr_sat: -8388609
       line_suffix_high_instr_sat: -8388610
       flight_software_version_id: ""1.00""
       command_sequence_number: 1001
       image_id: 1
       description: ""Aromatum Chaos, Ganges & Capri Chasmata""
       inst_cmprs_ratio: 2.350000000
       uncorrected_sclk_start_count: ""699921894.230""
       image_duration: 239.4670000
       gain_number: 16
       offset_number: 0
       time_delay_integration_flag: ""ENABLED""
       missing_scan_lines: 0
       md5_checksum: ""00641c08c2c6d4404acfe8c462fafd98""
       band_bin: struct, 8 elements...
       data: 320x7184x10 array of short, bsq format [45,977,600 bytes]

dv> bws=read(get_image("I01001001",instrument="themis",type="BWS"))
Downloading..........done.
................................................
/tmp/dv_24374/d6sUSt: bip PNG image: 320x7184x1, 8 bits
320x7184x1 array of byte, bip format [2,298,880 bytes]

DavinciWiki Mini-Nav Bar

Contents