Skip to article frontmatterSkip to article content
Site not loading correctly?

This may be due to an incorrect BASE_URL configuration. See the MyST Documentation for reference.

User Guide

The home page allows you to view faults in 2D, turn on and off an earthquake catalog layer and the U.S. Geological Survey’s Quaternary Fault and Fold Database. Other useful tools in this viewer are being able to change the color of faults based on different fault properties using the “Fault Color” drop-down menu. From the 2D viewer, the 3D viewer can be launched to view all of the faults at once, or a smaller selection of faults.

2D Viewer

You can color the faults by different fault attributes using the “Fault Color” drop-down menu. This can be helpful for viewing in 2D and for selecting faults to view in 3D.

To select faults to view in 3D, you can:

  1. Select faults in the panel on the lower left by clicking the check boxes next to those you’d like to view in 3D.

  2. Use the “Fault Color” tool on the left to filter faults by properties (see the examples below).

  3. Use the “Lasso” tool to select a group of faults.

Fault Color example 1: by fault level

  1. Select “Color by Fault Level”.

    Select Color by Fault Level
  2. Click on one of the levels to select all faults of that classification. Here, all Level 1 faults are selected.

  3. Click on “View 3D” and the 3D viewer will launch in a new window.

    Level 1 faults selected, then View 3D

Fault Color example 2: by region

  1. Select “Color by Region”.

    Select Color by Region
  2. Use the latitude and longitude sliders to narrow the view to just the faults you would like to view.

    Narrow the view with the latitude and longitude sliders
  3. Click “Select/Deselect All” (you can add or remove any faults to make sure you are looking at your complete region if you had issues with the latitude/longitude sliders). Then click “View 3D”. This will launch the 3D viewer with only the faults you selected.

    Select all faults in the region, then View 3D

Lasso example

  1. Click on “Lasso”.

  2. Draw a shape around the faults you would like to select.

  3. Click “View 3D” and the 3D viewer will launch in a new window.

Lasso selection

3D Fault Viewer

The faults load by default in a non-uniform, lower-resolution pink mesh.

3D viewer default view

The north arrow icon is movable. If it is obscuring your view at any time, you can click and drag it to a new position.

Click on a fault to see its name and attributes. If you click on “Load High-Res 1 km”, a higher-resolution 1 km blue triangular mesh will replace the pink mesh.

Fault attributes and Load High-Res 1 km buttonFault shown as a 1 km high-resolution mesh

You can view more than one fault in high resolution at a time, but we suggest no more than 10 at a time to avoid slowing down the web viewer. Either continue selecting faults as shown above, or select multiple faults at once from a list by holding down “Shift” or “Command” and clicking multiple names from the list. This list is in a panel that can be accessed through the “Show/Hide Controls” button in the upper left. This panel is also where you can click “Reset” to set all of the faults back to the lower-resolution pink meshes. We recommend not having more than about 10 high-resolution meshes turned on at once (more can produce lag in the web viewer rendering).

Selecting several faults for high resolution from the list

Other useful tools in the 3D viewer

3D viewer tools

Data Download

GeoJSON file downloads of the fault models are available on the downloads page. In the 2D viewer, Download (1 km) downloads the selected faults.

General Tips

Local Installation

If you plan to download and install this package locally:

  1. Download the CFM-WEB code from the GitHub repository.

  2. Download and install Docker.

  3. Go to the Cesium site and create an account and get a token.

  4. Go to the downloaded CFM-WEB code directory and create a .env file containing CESIUM_KEYS={"cesium_access_token": "<your token>"}.

  5. In the root directory (directory above app/) build the image: docker build -t cfm_viewer .

  6. Run the package: docker run --env-file .env -p 8080:80 cfm_viewer

  7. On your browser go to the CFM viewer at http://localhost:8080.

References