Prev Up Next Index
Go backward to 1.2 Sequence Data
Go up to 1 What To Do With A DODS URL
Go forward to 2 Finding More DODS URLs

1.3 An Easier Way

DODS also includes a way to sample data that makes writing a constraint expression somewhat easier. Append .html to the URL, and you get a form that directs you to add information to sample the data at a URL:  

...sst.mnmean.nc.html

Sending a URL ending in .html returns a form like this:

 

The DODS Dataset Access Form

It's useful to have a browser window open with one of these query forms in it while you read this section. Click here to bring up a copy of the form to use while you read.

Near the top of the page, you'll see a box entitled "Data URL". At this point, if you've been following along, it should look pretty familiar. If you're just jumping in, it's the DODS URL connected to the data we're interested in, but unsampled.

Moving down the page, there is a list of "Global Attributes", which is really just for your perusal. At this point, there's not much to be done with this, but it is often helpful information.

The important part of the page is the "Variables" section. For each variable in the dataset, you'll see the data description (e.g. "Array of 32 bit Reals [lat = 0..179]"), a checkbox, a text input box, and a list of the variable's attributes. If you click on the checkbox, you'll see the variable's array bounds appear in the text box, and you'll see that variable appear in a constraint expression appended to the Data URL at the top of the page. If you edit the array bounds in the text box, hitting "enter" will place your edits in the Data URL box.

In the oh-so-unlikely event you dare try all this without your documentation vade mecum along, there's a Show Help button up near the top of the page. Clicking there will show you instructions about how to proceed.

NOTE: You'll see a "stride" mentioned. This is another way to subsample a DODS array or Grid. Asking for lat[0:4] gets you the first five members of the lat array. Adding a stride value allows you to skip array values. Asking for lat[0:2:10] gets you every second array value between 0 and 10: 0, 2, 4, 6, 8, 10. 

 

Move on down the variable list, editing your request, and experiment with adding and changing variable requests.

When you have a request you'd like to make, look at the buttons at the top of the page.

 

Dataset Access Form Detail

You can click on Get ASCII, and the data request will appear in a browser window, in comma-separated form. The Get Binary button will save a binary data file on your local disk. (The Send to Program will send the URL directly to a DODS client. However, it requires a suitable DODS client to be running on your computer, and also requires you to install a helper application for your browser. There are instructions for doing this at the DODS home page.)

The DODS Data Access Form interface works for Sequence data as well as Grids. However, since Sequence constraint expressions look different than Grid expressions, the form looks slightly different, too. You can see below that the variable selection boxes allow you to enter relational expressions for each variable. Beside that, however, the function is exactly the same.  

Dataset Access Form for Sequence Data (detail)

Click here to see a copy of a Sequence form.

NOTE: Not all DODS servers support all the DODS functionality. There are a few non-standard DODS servers out there in the world that only support the bare minimum required. That minimum is to respond to queries for the DDS, DAS, and (binary) data. The ASCII data and the web access form are optional add-ons that are not required for the basic DODS function.

 
Tom Sgouros, 2004/07/07

Prev Up Next