Tutorial

These instructions assume that you have already successfully installed JAS.

Welcome to the Java Analysis Studio (JAS) tutorial. This tutorial was designed so that a new user could easily learn some of the key components of JAS and quickly get started creating and processing jobs in JAS. The tutorial is separated into several parts. Each part provides some general information about JAS, and details specific steps that should be completed before proceeding further in the tutorial. All steps that need completing before proceeding are highlighted in the tutorial as shown in the sample below.

This is a sample of the tutorial format used to highlight steps that need to be completed before proceeding.

If you are ready to discover the wonderful world of JAS then begin part 1 of the tutorial.

Part 1: Creating a New Job

After starting the JAS application you should see an application window that looks something like this:

With JAS started you are ready to create a new job. In JAS, a job is the most fundamental construct, which maintains the following information about your analysis process:

the connection to the source of the data: either a local or remote connection
the analysis routine or event generator process
the data set name from the chosen source
the functions and filters generated for the analysis
the plots created from the analysis

The first order of business is to create a new job. In order to create a new job you must activate the New Job Wizard by either:

selecting 'New Job' from the 'Jobs' submenu, or
selecting 'Job' from the 'New' submenu of the 'File' menu, or
clicking on the new job button on the toolbar

The New Job Wizard, shown below, will appear.

The wizard asks you to specify:

a name for the job.
the connection to the source of the data. There are two types of job connections:
- a local job is the simplest type, since all event processing takes place on the user's (local) machine. All data sources are on the local machine, or is accessible on the local network.
- a remote job is one where events are processed on a remote server and JAS works in client/server mode. The data sources used are on a server that is running Java Data Server code. All event processing takes place there. While histogram bin values or other results of event processing are sent to the client, the data themselves remain on the server. The user can use the client code to visualize and analyze the data summaries without having to send it all over from the server.
the type of job process to be run. Again, there are two options:
- a data analysis job. An event analyzer will read a data set and analyze the events in it.
- a event generation job. An event generator will create a data set of events.

Other options will be discussed later in JAS Tutorial Part 6: Further Explorations into JAS , but for now we will assume a local data analysis job.

As shown below, enter the job name as 'MyFirstJASJob', and select 'A local job for data analysis' in the New Job Wizard. Click the Next button.

You should now see the setup page shown below, which prompts you to select which data interface module (DIM) you wish to use to open the data set you will analyze. Local DIMs are designed for specific data formats, and return an event source object which is required to access your data. All DIMs registered in the Local DIM registry will be listed.

Choose the 'PAW' DIM and click 'Next'.

The next page of the New Job Wizard is specific to the type of DIM selected. Shown below is the setup page for the 'PAW' DIM, which requires you enter the path to where your local data set can be found. JAS comes with a test data set that should be used for this tutorial. The sample data set is named 'pawdemo.hbook' and can be found in the 'sampledata' directory, which is below the directory where you installed JAS.

Enter the file path to the sample data set called 'pawdemo.hbook'. For a standard windows installation this file is located at c:\programfiles\java analysis studio\sampledata\pawdemo.hbook. Otherwise, browse to where you installed JAS and select the 'pawdemo.hbook' file from the sampledata directory. Click 'Finish'.

Now that you have finished setting the DIM parameters the job will open and the data set will now appear on the job tree in the main JAS display, as shown below.

You should now be ready for JAS Tutorial Part 2: Using the JAS Display .

Top