Jiggle install instructions are on this website: https://pasadena.wr.usgs.gov/jiggle/Install.html (TODO: clean up the install instructions)
Jiggle only interfaces with the California Integrated Seismic Network (CISN) database schema. Use by other schema would require creation of a concrete implementation of Java Abstract Seismic Interface (JASI). Jiggle is intended only for use by RSNs, not by the general public.
Jiggle runs on a Java Virtual Machine (JVM), so it is platform independent. The user should be able to run Jiggle on a Windows, Mac, or Linux operating system. JVM version 1.8 or higher is recommended.
Jiggle connects to an Oracle database through the Java Database Connectivity (JDBC) application programming interface (API).
Jiggle may run slowly if accessed through a remote connection. Users have reported faster performance over Remote Desktop, than through a Virtual Private Network (VPN).
Requirements to run Jiggle
- A reasonably fast processor and at least 2 GB memory
- Java Platform, Standard Edition (Java SE): 8 or 11. If it is not already installed on your computer, download it at https://www.oracle.com/technetwork/java/javase/downloads/index.html
- Application and external .jar files
- Jiggle properties files with input parameters
- Script to start Jiggle GUI
- Oracle database with CISN schema, JASI views, and PL/SQL commands
Create a directory for the Jiggle jar files and other dependencies. For
example, let's call this directory
The latest version of Jiggle is Java8
jiggle18-p7.jar from 2017-06-27 (see
most recent entry in the Jiggle Release
Download this jiggle jar file from
jiggle.jar, and put it in the
bin/ directory. As new features get
added to Jiggle, this jar file will be updated on the website, for the user to
download the latest version.
This version of Jiggle from 2017-06-27 depends on having the up-to-date GTYPE schema in the database. Most RSNs are now using the GTYPE schema, although there are still a few exceptions in early 2019.
- In the origin database table, there is a separate column for GTYPE.
- If an event type is "earthquake", the origin can have a GTYPE value of either "local", "regional", or "teleseism".
External libraries and dependencies
All external libraries and dependencies for Jiggle (
mentioned below are available for download from
Jiggle depends on the following external .jar files which should also go into
bin/ directory. Do not unpack these jar files. New users need to download
these only once.
Jiggle needs supporting map interface files. Download
mapdata.zip which should
unzip and be placed into a
mapdata/ subdirectory inside the
New users need to download these only once.
Jiggle also needs properties files, which contain input parameter names and
properties.zip for examples. See Properties (Input
Parameters) for more information about these properties files.
Jiggle runtime script
To run Jiggle, the user needs a runtime script (Linux/Unix/Mac) or bat file
(Windows). This script should be in the same
bin/ directory as the
For example, a Unix runtime script, named
run_jiggle.sh, would look like:
#!/bin/bash java -Xms1000M -Xmx2560M -DJIGGLE_HOME=./ -DJIGGLE_USER_HOMEDIR=$HOME/Documents/Jiggle/Code/prop -jar jiggle.jar $1
Explanation of input arguments:
-Xms: initial and minimum Java heap size (in this case, 1000 MB) to allocate memory for the JVM
-Xmx: maximum Java heap size (in this case, 2560 MB) to allocate memory for the JVM
-DJIGGLE_HOME: directory containing the Jiggle application’s files such as
- In this case,
-DJIGGLE_HOMEis the current directory, assuming that this runtime script also lives in the
- In this case,
-DJIGGLE_USER_HOMEDIR: directory containing the Jiggle properties files. See Properties (Input Parameters) for more information.
- This should be an absolute path; I have found that specifying a relative path does not work.
- The last
$1in this command is there to specify a different Jiggle properties filename as an input argument. Without the
$1input, Jiggle assumes the input parameters are in a file called
Note that we need to make
$ chmod +x run_jiggle.sh
To run Jiggle from the command line, with input parameters from file
jiggle.props located in directory
To run Jiggle from the command line, with input parameters from a different file
jiggle_waves.props located in a different directory
$ ./run_jiggle.sh ../prop/jiggle_waves.props