You are on page 1of 19

#Introduction (help file revised 22 January 2007) This is the OPeNDAP Data Connector (ODC).

Using the ODC you can search for and r etrieve datasets published by OPeNDAP data servers. OPeNDAP servers (also known as DODS servers) located at major institutions around the world serve a wide var iety of data including: climatic data, satellite imagery, and ocean sensor resul ts. The ODC allows you to find these datasets, download them to your machine, sa ve them, and import them into client applications like IDL, Matlab, SPSS, Excel, or into databases such as Access and Oracle. The ODC is your gateway to terabyt es of scientific data and imagery. To report bugs or make comments use the feedback tab. You may also directly contact either: Dan Holloway <> John Chamberlain <> The development of this software was funded by the National Oceanographic Partne rship Program ( #Startup and Shutdown Start the ODC by running the executable ("odc.exe" on Windows, "odc" on UNIX). C onfiguration parameters for startup are in the file "startup.ini" which must be in the base directory (unless you are doing a manual startup (see installation i nstructions for your system). Note that a 1.4 or better JRE must be available. T he Windows package includes this JRE and on Mac OS X Jaguar or better it is buil t-in. To shutdown the ODC click the "x" in the upper right hand corner of the applicat ion window's title bar. The ODC has various configuration settings. These are stored in a file called "c onfig.txt". You can view these settings by using the IPS command "show config" ( see topic Third-Party and Command Line Support for information on using the cons ole). *** Base Directory *** Your base directory on startup will always be the first status log entry (see St atus and Errors topic below for how to display). You can change the base directo ry by supplying the desired directory path as an argument to your startup comman d. In a unix install this startup command is usually a script. In a Windows inst allation the application argument can be specified in the startup.ini file as th e "ApplicationParameter" value. #Quickstart The ODC uses a tab-based interface. This is the help tab. The tabs are persistent: you can leave a tab and come back to it and it will be unchanged. As you do the quickstart you can come back and forth to the help tab without aff ecting your work. Operating the ODC involves three steps:

single click plot type "Pseudocolor" if it is not already selected [the x and y values will automatically be picked for you] 13 .go into the "1. #About Network Resources.go into the "University of Rhode Island .click the check box next to the "dsp_band_1" variable 9 . this will load its structure [the structure of the file will appear in the pane below] 8 .click the "Output to" button [you will automatically move to the View/Plot pane] [the data will automatically be loaded to the plot pane] 12 . Follow along to learn how to do these steps: 1 .single click the red "To Retrieve" button at the top of the screen [you should now move automatically to the retrieve panel] [Pathfinder SST will be listed as one of your selected datasets] [notice that it is highlighted. your choice will highlight 5 .single click the blue "Plot" button [a plot of the data will appear in a separate window] Congratulations you have done a plot! Each of the screens above has much more functionality and options than we have e xplored here. . In some cases a server will not be responsive and you will see the progress meter in the lower right-hand corner of the display s trobe persistently. These connections may not always be active or servers may be down or malfunctioning. this means it is the active data set] 6 . Visit the web site's plot gallery (http://opendap. Firewalls and Proxies It is important to realize that the ODC does its work by accessing servers locat ed all over the to get detailed walk throughs for how do plots of all types." folder 3 . You can stop such actions by double-clicking the progress me ter.go to Search / Dataset List tab 2 "Plotter" in the drop-down list next to the "Output to" butt on 11 .1km Northwest Atlantic AVHRR" folder 4 . Read the rest of the help when you want to learn more.navigate the directory tree by double-clicking the folders to a mont h of your choice [a list of data files for the month will appear on the right] 7 .single click (DO NOT DOUBLE CLICK) on "Pathfinder SST".double click one of the files.modify the array ranges so they read "0:10:6143" (enter key "saves" the change) [this specifies you only want every 10th value in the array] [we subset the data like this because a 6143 x 6143 matrix would take a lot longer to process without adding much more to s ee] [shortcut: use the "step" drop-down box below to set the step to 10] 10 .(1) identify the dataset you want to use (Search) (2) retrieve its structure and make a sub-selection of the data if desir ed (Retrieve) (3) output or view the data (View) The controls for these three steps are grouped onto three tabs accessible at the top of the screen.

proxy. The ODC supports "Basic" au thentication only. If you do not have a proxy server or do not need to use one then proxy. --. On the Macintosh these settings these settings are in the app builder properties file.Use". Check with your network administrator.Host " and proxy.Use should be set to "Yes". Kerberos or other authen tication scheme it will not work.456. This is much sl ower than real memory. NTLM.Username proxy. For these reasons it is recommen ded that you try to match the maximum memory setting to actual amount of RAM ava ilable to the application.72 the proxy settings can be found under the menu Preferences / Advanced / Proxies. The ODC has limited support for authenticated proxies. You can increase its responsiveness by setting the minimum heap memory (the sta rting memory for the application). To s et up the ODC to use your proxy you need to set configuration settings (see Conf iguration topic in this help for how to do that) called "proxy. In this file the format of the entry is like "Option = -Xms40m". The host setting should eit her be a machine name like "sodastraw. but you are behind a firewall it is probably because the browser is using a proxy server which the ODC can use as well. Authenticated proxies are proxy servers that require a username and password. to serve as the memory. If you set the maximum memory higher than the total amount of real memory in your system the program w ill use "virtual memory".789".Port". This integer m ust be between 0 and 65535. #About Memory The ODC is a memory-intensive application especially if you use it for plotting. You should increase the maximum amount of mem ory available to the program to match the total amount of memory in your compute r unless you have some special reason for restricting it. RAM. For example in Netscape 4. and wears the disk. The port setting will be an integer like "8080".UseBasicAuthentication (set to "yes" or "true") proxy. If your web proxy uses Digest.mycompany. If you want to use Basic authentication set the following properties: proxy. T he ODC can still operate as long as there is an HTTP proxy server available to y our machine. In a Unix environment they are the first parameters to the java startup command .During network accesses (by default) there is a yellow box that appears in the c enter of the i file. If your browser works.Use shoul d be set to "No" (the default). ie disk space. "proxy. You can disable this box by changing a configuration settin g. These settings are accomplished by adding switches like this to the startup comm and: -Xms40m ts to 2m) -Xmx300m ts to 64m) starting memory of 40 megabytes (if no switch is present defaul maximum memory of 300 megabytes (if no switch is present defaul If you are operating under Windows you can find these settings in the startup.Password To determine the host and port of your proxy either ask your administrator or lo ok in your browser" or a numeric IP address lik e "123.Firewalls and Proxies--You may work behind a "firewall" which prevents normal access to the internet.

It also records all errors and warnings. If you encounter a problem and w ant to report it to the developers please copy and paste your status log into th e message to us. For example. This file is created automatically the first time y ou run the ODC. It is recommended that users increase both the starting and maximum memory to at least the levels shown above (40 starting. There are two ways to read and modify your configuration settings: (1) edit the configuration file directly (2) use the console The configuration settings for the ODC are in a file called "config.g. "java -Xms40m -Xmx300m . GCMD is the Global Change Master Directo ry sponsored by NASA. To view status or error information go to the View / Text tab. notably plotting. The dataset list is a general catalog of known OPeNDAP ser vers and their data. 300 maximum) to get a standard level of performance. a dataset that consumes 20 megabyte s as a raw stream might easily use 80 megabytes when it is being manipulated in memory. For example. #Status and Errors The ODC keeps track of most major application actions in its status log. Favorites are yo ur favorite data sets.txt" located in your ODC base directory. You ca n also dump just the errors and warnings by clicking the "Show Errors" button. Recent is the 20 (by d efault) most recent data sets selected.(e. To display all the commands enter the command "h elp" or "?". Note that the favorites and recent will not be visible if y ou are in read-only mode (eg running the program directly from a CD-ROM). Your base directory is listed as the first entry in the status l og (see topic on status and errors).. Initially this list will be empty. Note that the amount of memory used will often be much larger than the raw amoun t of memory a dataset consumes. #Searching and Retrieving The top row of tabs in the interface gives your search options. if you are behind a fire wall you will need to set the configuration to use a proxy server. Errors always print out at the end of a status log dump.. etc"). The reason for this is that for some operations. This is because it takes several network accesses to load it. At the bottom of the screen are buttons that will output the st atus and error information to the text windows. Likewise you can use the "se t" command to change a setting. Failing to change maximum memory setting can be particularly debilitating becaus e it prevents the ODC from using the full resources of your system. #Configuration The default settings for this program will work for most people however you may need (or want) to tweak its configuration. You can use the console available on the View / Text tab to display or modify co nfiguration settings. If you wish to load the G CMD search interface go to the Select / GCMD tab and click the "Access GCMD" but ton in the center of the screen. the d ata must be held in multiple buffers simultaneously. To show all settings enter "show config" in the text box a t the bottom of the screen and press the Enter key. The GCMD interface is not immediately accessible when you start the ODC. .

This will overwrite your local file cache with the remot ely maintained copy at UCAR. Display the DAS (ancillary/descriptive . If a direct ory has been not been discovered an ellipsis (". Each time this is done a network access is made to further discover the subdirectory. to restore the tree to show all nodes make the searc h box empty and click the "Search" button again #Subset and Select When you send one or more dataset locations to the Retrieve panel. * Any GCMD spatial constraint you specify will be applied to all GCMD queries. The buttons are red to indicate that they do a network access. * Double clicking on an item in the Favorites or Recent tabs will cause its info rmation to be displayed in the area below * Dataset List Search: to use this search enter search terms in the box and clic k the "Search" button. You may subset one or more directory files by double-clicking the file name. * Display the DDS (structure information) for a dataset by holding down the cont rol key and double-clicking the dataset. The "?" (Info) button wi ll retrieve information about the location and display it in a text panel to the right.. when the search completes the tree will be updated to o nly include matching nodes. The information used to populate the dataset list comes from a file included wit h the ODC distribution called "datasets. Any criteria specified here will be applied to all the selected files in the directory tree. If you have netwo rk problems or the site holding the dataset is unavailable for some reason there may be a long delay before a response occurs. Thi s means that the ODC does not know what is in the directory and it will require a network access to find out. Only the first level of the directory is shown.. To see subd irectories you must double-click on the desired sub-directory. There is a red button "?" to the left of each item. the search is by default an "OR" search that includes any of your terms.") appears after its name. The criteria for that file will appear in the lower pane of the Additional Criteria area.ucar by clicking the "Refresh Dataset List" button o n the Dataset list tab. S ee the section below on the spatial constraint panel for more information on usi ng it. If the item is a directory (indicated by a folder icon) a directory tree will appear to the right in the top half of the panel when the location is sele cted (clicked once). the panel wil l be activated and the dataset location title will be listed in the panel on the upper left.After you have located one or more data sets of interest you must move them to t he retrieve panel by clicking the "To Retrieve" button.xml". if you want to guarantee a term is there ("AND") put a "+" in fr ont of that search term. If there is no ellipsis then you can expand the di rectory to see what is in it without making a network access. You can retrieve the latest versio n of this file from unidata. The retrieved datasets panel lists the dataset locations which you have identifi ed. When you select a directory any files in the directory will be shown in the list box to the right of the directory tree. The directory tree for a given directory dataset item is not fully displayed whe n it is first shown. You can move multiple fi les by multi-selecting holding down the Ctrl key.

Constraints --To constrain the results from dataset use the lower pane of the "Additional Crit eria" panel.) The selected datasets list shows the estimated size of the dataset if possible. The supported output file formats are: Binary . For example. In the case of sequences you can use the drop down box to specify a relation and then give a quantity in the text bo x next to it. endin g index and stride (ie step). If the selected dataset has fields that can be constrained they wil l appear here. In the case of an array you can specify the starting index. kilobytes (K). --. Note the URL in the ly by clicking bar at the top of the retrieve panel shows the URL for the curren that in the case of directory URLs there will be no file name in location bar. When you select one of these options they will be ap plied to all of the selected datasets as indicated in the "Selected Datasets" li st box as long as the operation is valid. you cannot send a gif to the plotter.. 8. If you specify a directory (the path ending in a slash) then when the file is sa ved the existing file name (or names) of the selected URL(s) will be used. * The location t subset. just selecting the direc tory itself will do nothing. and 12.. The elipsis button (.) will give you a file dialog box you can use to navigate yo ur machine's directory tree. you can only send OPeNDAP datasets to the plotter. The URL will be added as a new dataset loca tion in the selected datasets lists. Also. The estimate does not include any sequences or string data. * You may select more than one item in a list or tree by hold down the Ctrl or S hift keys. If you output to a file specify a filename or directory in the box provided. megabytes (M) or gigabytes (G). The files you have selected will be listed in the " Selected Datasets" list box in the lower left of the retrieval panel. the formatted output is specifically designed to be easy to p . This measurement is shown in units of bytes (B).A readable printout that has been flattened into tables (onl y valid for OPeNDAP sources) The formatted output is appropriate when you want to read the data in a two-dime nsional way. In the case of a directory you must select one or more files within the directory. 6. #Outputting There are various output options indicated by the buttons in the lower left quad rant of the retrieve panel. You can use the location bar to enter an URL manual the "Add" button. 10.A readable printout of the data in bracketed format (only valid for OPeNDAP sources) Formatted . if you specify "4:2:12" you will get data for array indices 4. For more information on constraining a dataset see the OPeNDAP web site.information) for a dataset by holding down the shift and control keys while doub le-clicking. * You must select a dataset for a download to occur. Ctrl will add to your selection and Shift will cause your selection t o be extended to the place of the mouse click * You can enter (or paste) an URL manually into the location box at the top of s creen and pressing the "Add" button.the exact file as it exists on the server (only valid for non-O PeNDAP sources currently) ASCII . (For example.

text or other non-OPeNDAP sources.InternetRead 30 Would set the timeout to 30 seconds. The connect timeout applies only when the ODC is first connecting to the server and the read timeout applies once data retrieval has b egun. This is a limitation o f the current OPeNDAP server design. it should appear in the box you can also copy and paste into the box . You can read more about entering commands a nd using the command interface in the next topic (Third-Party and Command Line S upport). This is the command entry edit box. for example.InternetRead and/or timeout.41) data files which the server can read as OPeNDAP s ources.find the "Text" tab at the top of the screen. Data Binary Output Not Supported: Currently (as of version 2. . etc).type the command desired.txt file in the ODC bas e directory.find the "View" tab at the top of the screen.arse. One way to change these settings is to use the command interface found on the Vi ew/Text panel. If you attempt to output a file in a non-supported format you will receive an er ror message to that effect. #Third-Party and Command Line Support (Console) * The ODC has a command server called the "interprocess server" which listens by default on port 31870. To adjust timeouts change the configuration settings timeout. click on it once Near the bottom of the view text screen directly above the buttons you should see a rectangular box with a white background.gif.InternetConnect. STEP-BY-STEP Dummies Guide to executing a command . issuing the command: set timeout. You can issue commands to the IPS by entering them in th e text box at the bottom of the text view panel and pressing Enter. For example. click on it once . #Timeouts You may get a timeout error indicating that the ODC did not want to wait any lon ger for the enter key to execute the command the results will appear in the text area above * You can issue the same commands by connecting from a third party application s uch as a telnet client. . NetCDF (*.nc) and HDF files. Binary file retrievals are only possible for non-OPeNDAP sources such as ima ges ( once inside the box to place the cursor inside the box you should see a blinking vertical line inside the box this is the cursor . . You can only return the ASCII or formatted ASCII formats for data fil es. This is true of MODIS data f or example. Another way to change this setting is to edit the config. Some servers may require longer timeouts than normal because they have data archived using complex retrieval systems. CANNOT be returned in the bina ry format.

It updates automatically when you select a region type. It has a self-evident format so you can modify it or provide your own gazetteer.txt datasets. The temporal constraint will be applied automatically if there is any text in any of the six temporal entry boxes. The relative paths are: config. The From day defaults to "01" and the To day defaults to "31". histograms. scatter. If you leave the year blank. The first list box contains region types. You can modify the location and shape of the rectangle e ither by manipulating it with the mouse. #Spatial-Temporal Constraint The spatial-temporal constraint panel can be used to create a spatial or tempora l constraint on your search. If you only make an entry in "From" then t here will be no "To" constraint and vice versa.ini file: ApplicationParameter = [desired directory] (for example. To create a temporal constraint enter the From and To dates in the boxes provide d. If this checkbox is off no spatial const raint will be applied. but enter a month or a day then the From year will default to "0001" and the To yea r to the current year. The second list box has the entries for the selected type . If you supply no base directory the working directory (us er.* Enter "?" or "help" in the command line at the bottom of the text view screen to see supported commands for the interprocess server. editing the coordinate text boxes or se lecting an item from the gazetteer. #Program Directories and Files * The ODC uses various files and directories installed below its root directory relative to the "base directory". The gazetteer file is a text file the lo cation of which is specified in your configuration. Step-by-step: * You can change configuration settings from console by using the command "set".xml ECHO_static_valids. The base directory is normally where the appli cation has been installed. The third list box has custom regions. You can specify a different directory adding the following line to your startup. The From month defaults to "01" and the To month defaults to "12". By clicking the Add button you can define your own regions.dir) will be used. contour and vector . The gazetteer has preset coordinates for well-known regions. To create a spatial constraint surround the desired area on the map with the whi te selection rectangle. After you have selected an area you must mak e sure the "Apply" checkbox is checked. #Plotting If you would like to graph your data the ODC has the ability to create plots of various kinds such as line.xml /preferences /ImageCache * By default the PC launcher automatically sets the base directory to wherever t he launcher executable is located. The se will be added to the gazetteer file. "c:/usr/John Smith/odc") * If you do not use a launcher you should supply the name of the base directory as a startup argument. pseudocolor.

All other dimensions must be constrained. The data set structure will appear in the pane below.D5:D23. The interface will show the dimensions for that value and allow you to specify which dimensions should be the x and y.4-6. Dimensions that are not assigned to an axis must by constrained and a text box w ill appear allowing you to enter a constraint. In the case of a line plot you can only selec t one x or y. Enter the ranges in spreads heet fashion. In most cases you will need to constrain arrays to two dimen sions or less. T he definition area will then allow you to specify which value(s) you want to plo t. You can also change the scale of the plot with the zoom fact or controls to the right of the plot button area. Defining the Plot To define your plot first pick one of the plot types. This will load the data off the net work into memory. You can add ranges together by separating th em with a comma. The contents of the Xand Y-Axis combos may change depending on which values you are plotting. For more information on the output destinations see the topic Output. for example "A3:B15". the axes choices are determined automatically.2. If you click the "Table View" radio button in the upper left the definition pane will change to allow y ou to enter one or more ranges to get the data from. Output Options Once you have defined a plot you can output the plot by clicking the "Plot" butt on. Note that doing this involves a network access as indicated by the red color of the "To Plotter" button. For more information on zoom f actor see the topic Scaling. If you specify more than one value in a con straint multiple plots will be generated--one for each index in the constraint. For example. the constraint X [1:100]. if desired. Choose a variable to plot from the "values" combo box.9. from the c ombo box. Selecting and Loading the Data First add the URL for the data you wish to plot to the retrieve panel and constr ain it. The constraint is a comma-separat ed list of values or ranges. If you add ranges they mus . These numbers are t he index numbers of the data not the data values themselves. If you select multi-dimensional arrays you must restrict them to one or two dime nsions. The plot definition pane may change to support the plot type chosen. Each example in the gallery has a detailed set of dire ctions for duplicating the plot.Z[17:17] restricts the Z-dimension to a single value. If the load is successful the dataset will be listed in plotter panel. "1.M6:M400". Use the "To Plotter" button in the retrieval panel to download th e data and make it accesible to the plotter. This turn s the array into a two-dimensional array. Using the Table View You can also plot from data contained in the table view. The plotter will not process arrays with more than two dimensions. A good way to get started plotting is to go to the OPeNDAP online galler y of example plots and see how those plots were done.plots. If you are plotting a mapped grid. There are various output destinations available via the drop-down list next to the plot button. If there are more t han one dimensions to constrain only one of the dimensions may have more than on e index specified by the constraint. such as "Line". for example.Y[1:250]. To re strict a dimension constrain it to a single value. Select the loaded item from the list. You are now ready to define your pl ot. This will give you an idea of the range of plotting capabilities and serve as a guide to setting up the pl ots of the various types.13-17". for example "A3:A15.

Missing Values The "Missing" text box allows you to enter one or more "missing values" for the data set. Y ou can turn it off via an option setting. If the dataset's attribute information contains an attribute for the selected va riable that starts with the word "missing" those values will automatically be pa rsed and used as missing values. You can sometimes determine the missing value(s) by examing the global attribut es of the data set (use 'show descriptions' in the constraint panel). For example. For example. you could aggregate a 3x20 matrix and a 3x60 matrix but you could not aggregate a 4x5 matrix and a 3x15 ma trix. If there is more than one missing value separate them with spaces in the box. This calculation will double your data memory requirements temporarily and take time proportional to n*log(n) where n is the number of data elements. Plotting Data in a File If you would like to plot data from a file. A missing value is a data value that is to be treated as null. If this is the case the axes selec tion will be automatic and will be reflected in the variables pane. If the vectors are of different lengths an error will occur. If there are strings in the data they can be delimited by quotation marks. If the data is gridded it may come with map vectors that associate specific values with the axes. You can have the ODC attempt to calculate the m issing values for you which it does by default if no missing values attribute wa s found. It is necessary to select x and y vectors of the same length. #Plotting Lines When plotting lines directly from data (not using a table view) there are follow ing ways of defining the data variables: Independent none s) none s) 1 x/y/slice 1 x/y/slice n slices es) In all cases only vectors (one-dimensional variables) may be used as line/scatte r plot variables. "Satellite AR4078 (""AEGIS"") Data" will evaluate to [ Satellite AR4078 ("AEGIS") Data].Axes For two-dimensional plot types (vector and pseudocolor) you can select what kind of axes the plot displays. These v alues show in the plot as a particular color indicated by the color specificatio n. In a CSV file fields are s eparated by commas and records are separated by new lines.t have at least one identical dimension. double it. #Plotting . 1 y/x/slice n slices n slices (number of slices must match for both variabl slices lines only (scatter plots must have 2 variable Dependent 1 x/y lines only (scatter plots must have 2 variable . store it in CSV (comma-separated val ues) format and then load it into the table view. The missin g values assigments are part of the color specification. To escape a quotation mark . Once it is in the table view i t can be plotted as described in the paragraph above.

The values in the array are y-values. ascendi ng or descending. You must use option 2 if you have lines of different lengths. In each case the system wi ll decide which option you picked depending on your input.The reverse check box allows you to choose the order of the axis values. In option 1 each range will make a new line.Annotations The plotter can automatically generate a range of annotations and you can add cu stom text annotations. This is the string that will appear in the legend. #Plotting .Line and Scatter Plots from a table If you use the table view to set up your data ou have three options for defining your data: 1 one or more linear ranges with the same length 2 one or more sequential 2xN ranges 3 one 2-D array with the each line in a row or column In each case you can optionally specify an x-mapping. If you choose "indexed" for the axes then then plot will show the one-based inde x numbers data rows/columns. *** Text *** Text is automatically generated by the plotter the first time it plots a dataset (in a row). You can see these entries by visiting the "Text" tab in the plotting definition area. *** Line IDs *** If you add each line separately you can specify an ID for the lines. If you do not enter a size the following defaults are used: . In this case a radio button allows you to specify whether the lines are in the rows or the columns. If the x-values are integers you can have a xmapping (see below) for the real values. You can also specify a mapping as in the other two options. The size is the length of the bar in screen dots ( 72 dpi). *** Legend *** The legend shows the color bar for pseudocolor plots. Sometimes you may notice that when you select a variable or da taset the reverse default is checked. The usefulness of this is that sometimes you may wi sh to know exactly what row/column is containing certain data values. This will often be the case for olde r data that was originally designed to be outputted to a line printer where the graphical origin will be the top left instead of the bottom left. #Plotting . It will generate text for the axes and the title as long as it can determine the information. You can delete them. 90. The reason for this is that the map vector s in the data for whatever reason are in descending order and the plotter has au tomatically chosen to reverse them for you. In this case the f irst row/column in the range is considered to be the x-value (or index) and the second row/column is the y-value. modify them or add your ow n. Option 3 is possible if you have a large number of lines in a rectangular array. 180 and 270 are ignored). In this option the y-values must be sequential. The rotation is relative t o the horizon and can only be in increments of 90 degrees (values other than 0.

The alignment is part of the text/legend that is fitted to the orient ation location. If the bottom of the text seems to be extra high this is because the alignment t akes into account descenders--characters such as 'y' and 'q' that have tails bel ow the baseline.the preview tab will be activated and the plot will appear therein . #Plotting .y-axis orientation: size = y-axis length x-axis orientation: size = x-axis length plot. If the text is like a hand of a clock. Currently the scale only has one style: a line with out-turned ticks at each end . top/bottom orientation: size = canvas width canvas. For example.Layout The plotter locates text. The text rectangle is placed so that its bottom includes the fu ll descent of all possible characters. The offsets allow you to make absolute x/y ajustments in screen pixels to the pl acement location. Legends a nd scales can only be oriented in increments of 90 degrees. but text can have an y rotation. The relative object is the thing the object being placed is relative to. leave the labe l blank and add a custom text annotation. left/right orientation: size = canvas height In general you should use a rotation of 0 for horizontal legends and 270 for ver tical legends. orientation. left/right orientation: size = y-axis length canvas. an X-length of "100" and real scale length of "20". if your object is "Plot". Preview . but if you wanted it to be in the upper right of the plot area you w ould pick "Plot" as the object. The rotation is relative to the horizon. The label is automatically rotated the same way. For example if the x-axis covers 100 miles in re ality and you want the scale be 20 miles wide (1/5 the length of the x-axis) you might enter a labels of "20 miles". legend/colorbar and scale on the plot using a layout s ystem with six quantities: object.Output The output options are controlled by the drop-down list next to the blue Plot bu tton. #Plotting . orientation is "Top Left" and alignment is "Center". You must enter the real scale length and scale length relati ve to the length of the x-axis. then the center of the text will be positioned at th e top left of the corner of the plot area. *** Scale *** The scale is a line that shows relationship between distances on the image to di stances in reality. h/v offset and rotati on. top/bottom orientation: size = x-axis length plot. If you want to control the font/color/size of the label. alignment. 0 degrees would be at 3 o'clock. For exa mple if you wanted the text to be in the upper right of the canvas you would pic k "Canvas". The orientation is the place on the relative object where the text/legend is bei ng placed. 90 degrees would be at 6 o'clock etc.

Histograms .the plot(s) will be sent to the thumbnail pane. The scale is the relationship between data points and screen pixels.use the external window for the plot. You can change the sc ale by setting the zoom factor which has the following meaning: Max .set the size to the exact dimensions shown When you are using Max or % zoom factors the custom area will show current size of the output. For ex ample in a 1 to 1 scale there would be one data point for each pixel. you can change the width of the thumbnails with an options s etting.a new window will be created for the plot.a dialog will appear requesting that you select a printer and the be sent to the printer Full Screen . Note that printer output is scaled like a screen even though it is higher resolu tion. double-click on a thumbnail to plot it again Image .make proportional. The nominal resolution of most computer screens is 72 pixels per inch. if you multiplot 20 plots to the external wi ndow each plot will appear in the window in turn separated by a delay c alled the the multiplot delay which is settable via the options panel Printer plot will .only one plot can be active at a time in the preview pane if you plot to the preview pane you lose any previous plot that wa s there New Window . the thumbnail view is useful for viewing many plots at once. the external window is a single separate window. the thumbnails are shrunken to a fixed width (by default 100 pixels) and laid out in a matrix on the thumbnail pane. In other w ords if you were plotting a 200 x 300 array in a pseudocolor plot the plot area would be 200 x 300 pixels in size on both and the printer.the entire screen will be used to display the plot press the escape key or the spacebar or click anywhere in the wind ow to close it Thumbnails . if you multiplot 20 plo ts to new window you will create 20 new windows External Window . use Shift -click to select thumbnails.try to fill output area % .you will be prompted for a file name and location and the plot wil l be stored as a PNG image file #Plotting . for example 50% means 2 data points per pixel Custom . #Plotting .Scale The scale tab has controls that allow you to define margins and scale for your p lot.

This repo rt is sent to the View / Text tab and you must go there to see it. Each of these v alues ranges in hex from 00-FF and can be selected either numerically or using a picker. and so on. You can also specify transparency (called "alpha"). If you select a small number of classes there will be only a few rectangles. Thus. . on an 800x600 monitor the plot area for a full-screen display is typically 500 pixels wide. you could divide a country's population into age groups. if yo ur plot area is 500 pixels wide and your data was the numbers 1 to 800 then the plot would be 400 pixels wide with each line representing a range of 2. #Plotting . bright ness) value. The main parameter when doing a histogram is the number of classes which can be set from the Options tab. with a setting of 0 the plot could include up to 500 classes. If you want to specify white.Colors In the ODC plotter you can specify colors via their HSB (hue. ignored] The color step is the direction of the spectrum (ascending: red to blue. The color specification appears as a list of entries in the box labeled "Colors" . saturation. Clicking on the pl ot area outside the rectangles will prompt you for a histogram report. If you select many. Th e codes (not case-sensitive) are: SA SD CA CD synchronized ascending synchronized descending continuous ascending continuous descending For most cases you should use a synchronized descending step. Histograms work by sorting all the values of the dataset into classes. A popup box w ill appear showing range and count information for the class. The first class might be children (age 010). Note that fewer classes t han this may result because the value range is held constant. there will many narrow rectangles or lines in the maximal case. This will tend to make the lower data values blue and the higher ones red. make brightness 00. make brightne ss FF. descend ing: blue to red) and whether the hue/sat/bri/alpha vary in synchronized way. It tabulates summary information about histogram. In the HSB system colors are formed by starting with a pure hue and adding black (saturation) or white (brightness). the second adolescents (age 11-14). It c an operate on any single variable or slice from your dataset. If you want to specify black. Histogram Reports To get detailed information on a class single-click the rectangle. Normally a continous color st ep is only used when generating gray scale. A setting of 0 classes will result in maximizing the number of classes for the current output. For example. Each entry has the following space-separated fields: DataFrom DataTo ColorFrom ColorTo Step Hue Saturation Brightness Alpha [ comments. These entries can be saved to a file and used for any plot. For example. The X-axis shows t he extreme values from lowest to highest and the Y-axis shows the number of valu es.The histogram plotter can show you the distribution of values in your data. The Alpha is the transp arency (0xFF for opaque and 0x00 for transparent). For example. Class es are sometimes casually referred to as "bins".

specify -1 for the HSB parameters and FF for alpha (opaque).5 20.the data type does not match . 10.range of values .Data Parameters When data is plotted there are three key additional parameters to plotting it: . 10. saturated. If you want the colors to be opaque but vary continuously. The hue ( -1) and the saturation (-1) are allowed to float.5 and 20. blue (80) which only varied in brightness. Click on square in these areas to change that quantity for the curren tly selected color. the parameters will be recalculated. To define a color you modulate four quantities: its hue. If you want to hold one or more parame ters constant give them a value.5 +1 -1 -1 80 FF -1 FF This entry would cause the values between 10. It is important to know that the plotter uses only set of data parame ters--it does not maintain a different set of parameters for every loaded matrix in every loaded dataset. When a new color specification is created or colors are generated the current da ta parameters are used.Using the Color Picker The color picker is the dialog box titled "Choose Color" which comes up when you change a color. To get a better understanding of color systems and controlling color you may wan t to read the next type . You can view the data parameters in the values area of the variables panel.the user requests a recalculation using the calculator button on the variables pane .5 to be plotted as an opaq ue.This allows you to specify a range of data to be plotted using a range of colors . For example. Note that the Co lorFrom/To field values have the order AHSB. Setting the ColorFrom and ColorTo causes those values to be ignored.5 +1 FF50FF77 FF80FF77 -1 -1 77 FF In this example the data range plots between green (50) and blue (80). "Generating Colors". but the brightness is held con stant at 77 and the opacity is also held constant at 100% (FF). brightness and alpha.the array/list dimensions do not match In other words if you plot one dataset and then another. Calculating this information can be relatively expensi ve in terms of processing time so it is only recalculated under three conditions : .missing values This information is necessary to create color specifications and do other plot p rocessing. if the second dataset h as the same type and dimensions as the first the parameters will not be recalcul ated. #Plotting . but if either the data type or dimensions in the second dataset does not m atch those in the first. .5 20. saturation. #Plotting .

The color generator will create N new ranges that are each mappe d to a single color. Using the color generator is good way t o get started creating a color specification. move to to the place place you want to copy to and switch it back Fine adjustment . In an ODC color specification if the "ColorFrom" and "ColorTo" for a range are the same then the range is banded.The arrow keys move the last selected band (hue / sat / bri / alp ). multi-hu e. There are two basic types of color systems: continuous and banded. If they are different then the range is continous. You can use the color generator as well. Right arrow +1. enter the number of bands (N) and other param eters as shown. up arrow +16. The currently selected color is shown at the bottom left next the label "Color:" . In a banded system. You will recogni ze this as the form of the color used in a color specification ranges. The color generator is controlled from the box labeled "Generate Colors" on the color specification tab. The forma t of the number is AHSB in that order. weighted rainbow). The ARGB number is also shown for the sak e of comparison. Description of the continous color systems: gray scale saturation is set to 0 and brightness is varied across the data range for a continuous gray scale. left arrow -1. all t he data within a given fixed range is mapped to the same color. To generate a banded color system. down arrow -16. To generate a continuous color system. The hex form of the color is shown next to the color rectangle. little rainbow. *** TIPS *** Copy a color to copy a color note that the compare color stays the same. You can find color mappings with these codes many places on the internet (for example: http://home. then fill in the parameters appropriately. When you generate colors the range is determined by the total of ranges already in the specification (if there are no ranges then 0 to 1 is used).net/~laanderson/colornet. 100% bri (to make gray reduce brightness) black = 0% brightness (no light!) #Plotting . pick the basic type (gray make fine adjusments use the arrow keys Make white Make black white = 0% sat. earthlink. on th e right is the "compare color". bw printer . Inside this rectangle are two colors: on the left is the selected color. A color spe cification can include both types of ranges if the user desires. You can enter an RGB number in the picker by clicking on the "A RGB" label and entering the 6-digit hex code for that color. full spectrum. You can swap these two colors by clicking anywhe re in the color rectangle. so switch the color to the compare color box. In a continuo us system the color varies continuously with the data.htm).Generating Colors If you do not make a color specification then the plots that require color will make their own using the ODC's color generating ability.

You can also specify a phase (where the pattern starts for every repet ition) by appending a number separated from the rest of the string by a colon.HSB The plotting color system uses the HSB (Hue-Saturation-Brightness) system. the stretched rainbow expands these ranges so that all six colors (red. hue 00) little rainbow the data ranges across a limited part of the spectrum that the user selects. To ma ke colors in this system you start with a hue and add black (saturation) or whit e (brightness). In the line style there will be a t hickness. If you leave the box blank the line will be contin uous. has the best spectrum distribution #Plotting . magenta) are of equal size.. Example: . cyan and magenta) are less prominent than the primary colors. The dash pattern is a string. etc. the user can also rotate the spectrum (by default it begins/ends in the middle of red. the user can fix saturation and brightness to particular levels (100% 100% is the default). color and dash pattern. green. You can specify as complex a pattern as you want.Line Styles Some settings allow you to set a line style. in a little rainbow one of the three primary colors will receive emphasis weighted rainbow in the standard spectrum. the boundary colors (yellow. yellow. #Plotting . blue. This table shows some of the conventional terms used under this system: Colour type Black White Gray Hue Shade Tint Tone S Any 0% 0% 100% 100% 1-99% 1-99% B 0% 100% 1-99% 100% 1-99% 100% 1-99% For example. To indicate a dash pattern enter the number of pixels separated by spaces in the order line-gap-line-gap-. tinted or toned for variance full spectrum the data ranges across the full range of possible hues.the full range of values is used continuously from 00000000 to FFFFFFFF. cyan. to make a brown shade you start with a yellow-red hue and shade it down to the brown.. on screen this will look strange but when printed will give the best possible gray scale multi-hue in a multi-hue system one or more hues are selected and then are shaded.

If you s et the coastline path to a directory it will search the directory for the above files. #Additional Tips * In the GCMD search you can clear the info panel by clicking the area to the ri ght of the info buttons * By double-clicking in this area you can see the currently defined constraint * Ctrl-clicking in this area will run whatever text is in this panel as a GCMD q . The default directory is /coastline. All t he selected thumbnails will be plotted. #Plotting . XXXX~~XXX~XXXX~~XXX~XXXX~~XXX~XXXX~~XXX~XXXX~~XXX~ By specifying a phase you can change where the pattern starts.2 km 20M < 0. For example. IMPORTANT: any resolution smaller than low (5 km) will use significant memory an d time resources to load and process. ~'s are gaps).The dash pattern 4 2 3 1 would look like this (x's are pixels.c Intermediate 1.Multiple Plots You can generate multiple plots all at once in several ways.c Low 5.5-8. l atitude and longitude.4 km gshhs_i.04 km 87M < 0. For example 4 2 3 1 : 2 looks like this. you could make latitude 'Y' and longitude 'X' and constra int time to be '1.Coastline You can display a coastline by turning on the Show Coastline option in the Optio ns tab. For example. You can also cause a particular file a lways to be used by setting the coastline path to that particular file.11'. You can also multi-plot by creating thumbnails. If you have dataset with more than 2 dimensions you can specify one of the const raints to be range of values.c Crude 25 km 167K You can cause only the crude coastline to be used by setting the coastline path (in the configuration settings) to blank. #Plotting . in the pattern above the total length is 4 + 2 + 3 + 1 = 10.05 km gshhs_h.c Full 0. XX~~XXX~XXXX~~XXX~XXXX~~XXX~XXXX~~XXX~XXXX~~XXX~ The phase must be greater than or equal to zero and cannot be greater than the t otal pattern length. selecting the thumbnails you wan t to plot by holding down the shift key and then pressing the plot button. if you had a dataset that was time.0 km 5M < 2 km gshhs_l. one for each time value.2. Be cautious when using the coastline on da ta that covers a small region.0 km 1M < 10 km gshhs_c.c High 0. If you have coastline data available it will be applied according to the followi ng resolution cutoffs: File Description Resolution File Size Cutoff -----------------------------------------------------------gshhs_f. This would generate seven plots.

uery * Some servers especially NOAA/NASA servers may require longer timeouts .