Installation

Geochem-EZ is downloaded as a zipped file. This file folder will contain all of the files that you will need to run the program. We have also included a number of example case files to help learn the program.

Install GeoChem-EZ by copying the contents of the unzipped file folder into a directory. In naming the directory please do not include any spaces in the file or folder name. We do not know the limit to which the program folder can be nested within a directory or the maximum file name length, so we recommend placing the program folder in the root directory (e.g., C:\GeochemEZ or C:\Geochem in Windows) and naming the folder "Geochem" or "GeochemEZ."

Linux Users

After unzipping the file in Linux, it will be necessary to change the permission of the file georun for execution. This can be done by typing chmod +x georun inside the installation folder.

Files and Directories

The following is a list of the files and directories that are either required and/or utilized by the software:

On Windows On Linux Description
GEORUN.EXE Georun This contains the executable file for GEOCHEM, which is run by GeoChem-EZ.
GEOCHEM.CFG geochem.cfg This is used by GEORUN.EXE and is written anew every run by GeoChem-EZ.
Interface.cfg interface.cfg This file saves all the databases the user selects, along with their default work directory and template. If this is deleted, GeoChem-EZ will revert to a default configuration and generate new file.
GeoChemEZ.jar GeoChemEZ.jar This executable file contains all the necessary Java files to run GeoChem-EZ.
metlig.MLW metlig.MLW This database file stores the molecular weights of all the metals and ligands in the GEODAT-A.LIG database. If you expand on this database and wish to use g/L and mg/L in GeoChem-EZ, you can edit this database with any ASCII editor. The format is simply [m/l] [code#] [molecular weight]. The only time that this database should be modified is when metals or ligands are added to the GEODAT-A.LIG database.
resources\ resources/ This directory contains the default SALTS and LIG databases as well as the entire help system and some images used by EZ. Add your own custom LIG databases here. All content in this directory should be accessed only through the GeoChem-EZ program.
MyData\ MyData/ This is the default directory to store all of your input and output files. This would include files with .geo, .out, and .dat file extensions. Upon installation of the program, it will contain example files in both .DAT and .GEO formats.

Run

To launch GeoChem-EZ simply click on the jar file GeoChemEZ.jar. Alternatively, place a Geochem-EZ shortcut on the computer desktop. In Linux, just type java -jar GeoChem-EZ.jar inside the installation directory. We have included an icon.ico file in the resources folder if you wish to change the shortcut icon to our logo.

Attention

The first time that the program is opened there may appear error messages related to the program not be able to find the appropriate databases. Please ignore this and configure these files.

Configure

To configure the program, select Options on the top menu bar and then choose the locations for the default work directory (normally the MyData folder), the Metal/Ligand database (usually GEODAT-A.lig unless you have your own database file), and the GEODAT-A.Salts file (found in the resources folder). Default Template is reserved for those users who want to open a specific template each time the program starts.

Attention

You may encounter problems with Geochem-EZ if your Windows default language is set to anything other than English (United States). The problem arises when commas are used in place of decimal points. Windows users with this issue will need to change their default language to English (United States) via the control panel choosing the Region and Language option before running Geochem-EZ. Within the Formats tab of the Region and Language option choose English (United States) and then click on Additional Settings. In the Numbers tab of Additional Settings, check to see whether the decimal symbol is now a period (.) and not a comma.

Help

To get a feel for how GEOCHEM-EZ works, it is best to first look at the Help files. To get there, first launch GEOCHEM-EZ, then go to menu bar at the top of the program interface, click on Help and choose Launch Help. This will open our Help files in your default web browser. The Quick Start Page and the Advanced Options Page are recommended first introductions to the program. It will show you how to enter and run a case and some of the options that will make your analysis more powerful.

The Help files display better on the Mozilla Firefox browser (http://www.mozilla.org/en-US/firefox/new/). If you are a seasoned GEOCHEM-PC user, then you can simply open your old "dat" files and get to work. We have included in the MyData folder several example files with the Geochem-EZ .geo file extension that can be opened with the "load file" option.