Getting Started Using OpenDX

1.2 dxsamples
Next, let's look in the /dxsamples-x.x directory found under $DXROOT. You can navigate to this directory using either your file system browser or with some modern web browsers. Within /dxsamples-x.x, there are many different kinds of sample files under different subdirectories. Some of these directories pertain to more advanced features that are not discussed in this workshop, but which are documented in the html (chiefly in the Programmers Guide) if you would like to know more about them.

Specifically, the items we will not talk about further in this workshop are:

  • /callmodule: a means for calling DX routines like a library, from programs you write in C or other languages;
  • /dxlink: a scheme that permits user-compiled programs to communicate with DX programs through sockets;
  • /java: a system designed to permit web browsers to connect to DX servers and run pre-built DX programs remotely (this does not permit the remote user to create new DX programs);
  • /program_guide, /outboard and /user: example files for people who wish to write their own custom modules and add them to DX;
  • /supervise: a system for customizing the user interface interaction with the image display within DX through user-written code;
  • /scripts: a number of examples of how to invoke DX functionality from the text-based script language rather than through the DX user interface (this is described in the User's Guide and we'll touch on the syntax briefly)

As you can see, there is a lot more material that could be discussed in future workshops or explored on your own!

What we came for are the example programs (nets) found under $DXROOT/dxsamples-x.x/programs. In addition, many of the examples in /programs will reference sample data files found under $DXROOT/dxsamples-x.x/data. There is also a /tutorial directory which is more directly accessed through the user interface.

So, assuming you haven't hit any snags (like not finding the /programs directory!), we're almost ready to begin!

Make a note of the exact path to the /dxsamples-x.x directory: we'll need to type it very shortly. In Unix, type "pwd" or "/bin/pwd" to see the full path of the directory you are currently in. In Windows, type "cd" from the command prompt.