jmars

Contents: Description, Arguments, Usage, Examples, Sub-Functions, Related Functions, Source Supported Under Version: >1.00 Current .dvrc Version: 1.00 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 Functions Function Categories Common Procedures Glossary Download Davinci Change Log News Mailing List Contact Developers davinci-dev [AT] mars.asu.edu All other topics See navigation on the left Major Sub-Functions read_lines sprintf HasValue get_struct min max write Related Functions get_image available_maps themis3db map_projection.dvrc jmars() Recent Library Changes Change Log Created On: 02-08-2011 Modified On: 05-14-2013