jmars

From DavinciWiki
Jump to: navigation, search

Description

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 and Return Values

Arguments: an image variable or file path plus projection information

Return Value: the image is shown in a current JMARS session

Usage

There are multiple usages for this function:

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

Syntax: jmars(struct [,host=STRING][,port=INT][,name=STRING][,id=INT][,geo=BOOL])

struct = 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=FLOAT//FLOAT, lr=FLOAT//FLOAT [, ur=FLOAT//FLOAT][, ll=FLOAT//FLOAT][, host=STRING][, port=INT][, name=STRING][,id=INT])

data/path = stretched byte data or a file path
ul = Latitude//Longitude of the upper left corner of the data
lr = 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 = Latitude//Longitude of the upper right corner of the data
ll = Latitude//Longitude of the lower left corner of the data

OR

  • This option is not well supported

Syntax: jmars(data, proj_struct [, ur=FLOAT//FLOAT][, ll=FLOAT//FLOAT][, host=STRING][, port=INT][, name=STRING][,id=INT])

data/path = stretched byte data or a file path
proj_struct = a STRUCT or path to a ISIS2/ISIS3 file that contains the relevant projection information

Optional:

host = name of the machine the instance of JMARS is running on (Default="localhost")
port = port number specified in the Davinci Stamps Layer (Default=56277)
ignore = ignore value for image null space (Default = 0)
name = specifiy a custom dataset name (Default = "DV Upload "+ID#)
id = specify an id for JMARS to identify this dataset
     this will auto increment by default, but can be forced to overwrite
geo = re-project the input GeoStruct to the JMARS projection (Default = 0)

Examples

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=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=load_pds($DV_EX+"/THEMIS.cub")
jmars(do_rdcs(thmstruct.qube.data),thmstruct,name="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="THEMIS B9 Radiance",id=2)

We can auto display the output of project_crism() this is a saved file because crism processing can take a while

crism=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=get_map(map="TES_Hematite",ppd=64,lat="10:15",lon="15:20")
jmars(map)

Now with user defined inputs (but only two) using a davinci variable (from a loaded file)

color=read($DV_EX+"/night_over_day.png")
jmars(color,lr=-31.25//3.,ul=-27.75//0.,ignore=0)

Now with the same user defined inuts and the file on disk

jmars($DV_EX+"/night_over_day.png",lr=-31.25//3.,ul=-27.75//0.,ignore=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=0)

DavinciWiki Mini-Nav Bar

Contents


Contact Developers

  • davinci-dev [AT] mars.asu.edu

All other topics

  • See navigation on the left

Related Functions

Recent Library Changes

Created On: 02-08-2011
Modified On: 05-14-2013

Personal tools