View source for jmars

{{DavinciWiki_Function|
Use this function to output a data file to your JMARS Session. JMARS will take the input data and project it on to the current map in the Davinci Stamps layer
|
Arguments: an image variable or file path plus projection information
 
Return Value: the image is shown in a current [[JMARS (Program)|JMARS]] session
|
There are multiple usages for this function:

* GeoStruct option,  we provide a structure with all the same parameters as above.

[[Syntax]]: jmars(struct [,host&#61;STRING][,port&#61;INT][,name&#61;STRING][,id&#61;INT][,geo&#61;BOOL]) 

 struct &#61; a GeoStruct with a stretched byte .data (or .image), .ul, .lr, (optional, .ur, .ll) elements in the formats above

'''OR'''
* In this case we provide a byte data array or file path and the user defines the lat/lon range with the ul/lr options

[[Syntax]]: jmars(data/path, ul&#61;FLOAT//FLOAT, lr&#61;FLOAT//FLOAT [, ur&#61;FLOAT//FLOAT][, ll&#61;FLOAT//FLOAT][, host&#61;STRING][, port&#61;INT][, name&#61;STRING][,id&#61;INT])

 data/path &#61; stretched byte data or a file path
 ul &#61; Latitude//Longitude of the upper left corner of the data
 lr &#61; Latitude//Longitude of the lower right corner of the data
 
 Note: if only ul and lr are specified ur and ll values will be filled in automatically
 ur &#61; Latitude//Longitude of the upper right corner of the data
 ll &#61; Latitude//Longitude of the lower left corner of the data

'''OR'''
* This option is not well supported
[[Syntax]]: jmars(data, proj_struct [, ur&#61;FLOAT//FLOAT][, ll&#61;FLOAT//FLOAT][, host&#61;STRING][, port&#61;INT][, name&#61;STRING][,id&#61;INT])

 data/path &#61; stretched byte data or a file path
 proj_struct &#61; a STRUCT or path to a ISIS2/ISIS3 file that contains the relevant projection information

'''Optional:'''
 host &#61; name of the machine the instance of JMARS is running on (Default&#61;"localhost")
 port &#61; port number specified in the Davinci Stamps Layer (Default&#61;56277)
 ignore &#61; ignore value for image null space (Default &#61; 0)
 name &#61; specifiy a custom dataset name (Default &#61; "DV Upload "+ID#)
 id &#61; specify an id for JMARS to identify this dataset
      this will auto increment by default, but can be forced to overwrite
 geo &#61; re-project the input GeoStruct to the JMARS projection (Default &#61; 0)
|
First we will load a THEMIS ISIS2 (or ISIS3) cube. In this case we just point davinci to the projection location file (an ISIS cube)
 themis&#61;read($DV_EX+"/THEMIS.cub")
 jmars(do_rdcs(themis,9,6,2),$DV_EX+"/THEMIS.cub")

Now we load that ISIS cube and stretch the data while supplying a new name for the file,
 thmstruct&#61;load_pds($DV_EX+"/THEMIS.cub")
 jmars(do_rdcs(thmstruct.qube.data),thmstruct,name&#61;"THEMIS DCS 875")

Lets add the stretched black and white image and replace the previous image with it.
 jmars(sstretch(thmstruct.qube.data[,,9]),thmstruct,name&#61;"THEMIS B9 Radiance",id&#61;2)

We can auto display the output of project_crism() this is a saved file because crism processing can take a while
 crism&#61;read($DV_EX+"/00009ACE_07.proj.hdf")
 jmars(crism)

We can also auto display the output of get_map() a user could modify the .data element to be whatever they want
 map&#61;get_map(map&#61;"TES_Hematite",ppd&#61;64,lat&#61;"10:15",lon&#61;"15:20")
 jmars(map)

Now with user defined inputs (but only two) using a davinci variable (from a loaded file)
 color&#61;read($DV_EX+"/night_over_day.png")
 jmars(color,lr&#61;-31.25//3.,ul&#61;-27.75//0.,ignore&#61;0)

Now with the same user defined inuts and the file on disk
 jmars($DV_EX+"/night_over_day.png",lr&#61;-31.25//3.,ul&#61;-27.75//0.,ignore&#61;0)

And now a file on disk and an ISIS2/3 cube on disk
 jmars($DV_EX+"/night_over_day.png",$DV_EX+"/night_over_day.cub",ignore&#61;0)
|
|
*[[read_lines]]
*[[sprintf]]
*[[HasValue]]
*[[get_struct]]
*[[min]]
*[[max]]
*[[write]]
|
*[[get_image]]
*[[available_maps]]
*[[themis3db]]
|
*map_projection.dvrc
|1.00
|
}}
[[category:Functions]]
[[category:User Defined Functions]]
[[category:Miscellaneous]]
[[category:Map Projection]]