Create a new OMS project.

Click on the OMS icon that is on your desktop to start OMS.

When a new OMS project is created, a directory will be created to contain all the associated subdirectories and files used in the project. It is suggested that a single OMS work directory be created where all OMS projects can be located. This work directory must exist prior to the creation of the a new OMS project. For the purpose of this tutorial, create a work directory named

omswork

Now go to the OMS graphical user interface (GUI). Click on File in the OMS main menu bar with the left mouse button and then click on New Project with the left mouse button.

This will open the New Project window. Click on Modeling Project with the left mouse button and then click on Next.

In Step 2 you will select the working directory you created above to be used by the new project. Locate the directory omswork in the list presented and double click on it with the left mouse button. This will copy it to the Directory: input field. In the Files of type: input field, choose the All Directories option. In the Project Name: input field type OmsEtTutorial. Then click Next.

In step 3 you must provide a Full Name for the project. OMS uses a project naming convention that is consistent with coding conventions of the Java programming language. In Java, a Java package is a mechanism for organizing Java classes into namespaces. Programmers typically use packages to organize classes that belong to the same category or provide similar functionality. Packages are simply a way to organize files into different directories according to their functionality and/or use. OMS components usually reside in a package or namespace.

The directory for this project is located at C:\omswork\OmsEtTutorial. When a new project is created, the project directory structure created by OMS is shown below. A directory with the project name OmsEtTutorial is created under the omswork directory. Several project subdirectories are created under the OmsEtTutorial directory.

The subdirectories are:

• analysis – location for pre-configured post processing analysis files.
• data – location for all model data and parameter files.
• doc – location for project documentation.
• models – location for all models created under this project.
• nbproject – location for OMS project related files created and maintained by the system.
• output - location for all model output.
• scenarios- location for all user-created combinations of a model, parameter file, and data file.
• src – the location for the source code for the components to be used in model creation.

The package naming convention for OMS is organization.name.category.specialty. In this tutorial we will be using components of the model PRMS. The organization developing the PRMS model is a government organization (gov) whose name is the U.S. Geological Survey (usgs). The category is considered to be the model name (prms). Therefore the Full Name we use is gov.usgs.prms. Type this name in the Full Name input field and then click Finish.

The Full Name you provide (gov.usgs.prms) is also used to create a directory structure under the src directory of this project to contain the Java source files for this project. Expanding the src directory shows that the subdirectory path under src is the same as the Full Name of the project. The component source code will be located in the directory prms.

The new OMS project has now been created and the name OmsEtTutorial will appear in the Projects window of the OMS interface.

Clicking on the + with the left mouse button will expand the project directory structure to show the subdirectories that have been created by OMS for this project.

• Documentation directory is a location for project documentation.
• Input directory is the location for all model data and parameter files.
• Output directory is the location for all model output files.
• Components directory is the location for the source code for the components to be used in model creation.
• Models directory is the location for all models created under this project.
• Simulations directory is a location for user-created combinations of a model, parameter file, and data file.
• Analysis directory is the location for pre-configured post processing analysis files.