Logo
  Community Fault Model (CFM)

CFM Web Interface User Guide

Overview

The Community Fault Model (CFM) Web Interface provides interactive 2D and 3D visualizations of fault traces and surfaces for the Cascadia Subduction Zone. This guide outlines the functionality and usage of the 2D and 3D Fault Viewers, including instructions for interacting with the maps and accessing the data.

2D Fault Viewer (Homepage)

The Homepage includes a 2D Fault Viewer as a map-based representation of fault traces and other geospatial datasets. It allows users to explore, filter, and analyze faults in a two-dimensional view.

Key Features

  • Fault Trace Visualization: Displays fault traces as lines on the map. Users can click on fault traces to view detailed descriptions.
  • Interactive Filtering: Filter faults by latitude, longitude, or depth using range sliders. Apply custom colors to faults based on their attributes (e.g., depth, dip, or rake).

How to Use

  1. Navigate to the 2D Viewer ( Visualization → Repository ): Open the CFM-Web's homepage.
  2. Filter Faults: Use the sliders to set minimum and maximum values for latitude, longitude, and depth. The map on the right and the list of displayed faults under the control panel will update dynamically to show/list only the faults within the selected ranges.
  3. Customize Fault Colors: Use the Fault Color dropdown to select how faults are colored. Adjust the numeric range for color mapping if applicable.
  4. Select/Deselect Faults for 3D View: Use the Select All/Deselect All checkbox to quickly toggle all faults. Click individual faults on the map for more information.
  5. Navigate to the 3D Viewer: Click the View 3D button to open the 3D fault viewer and display fault traces and surfaces for the selected faults on the 2D viewer.

3D Fault Viewer

The 3D Fault Viewer provides an immersive, three-dimensional visualization of fault surfaces and traces. It includes additional geospatial features such as earthquake data, terrain occlusion, and boundary lines.

Key Features

  • Fault Surface Visualization: View 3D fault surfaces with adjustable opacity and selectable depth ranges.
  • Earthquake Data: Display earthquake epicenters as points sized proportionally to magnitude.
  • Toggle Auxiliary Datasets: Use the 2D Surfaces selection box to toggle auxiliary GeoJSON datasets on the map (select up to two surfaces at the same time).
  • Imagery Layer and Terrain: Show or hide terrain features and geospatial boundaries. Enable or disable terrain occlusion for a clearer view.
  • Community Velocity Models (CVM): Use the CVM selection box and sliders to display and adjust CVM model limits. Use the sliders to refine latitude, longitude, depth, and outline opacity for the model.

How to Use

  • To View All Fault Surfaces: For a 3D view of all fault surfaces, navigate to Visualization → 3D Viewer.
  • To View Selected Fault Surfaces:
    1. Navigate to the 2D Viewer: Go to the homepage ( Visualization → Repository ).
    2. Filter Faults: Use the sliders to limit faults to those of interest.
    3. Select Faults for 3D View: Use the checkbox next to each fault in the fault list table to select individual faults or use the top checkbox to select all faults. The viewer will highlight the selected faults.
    4. Navigate to the 3D Viewer: Click the View 3D button to open the 3D fault viewer and display fault traces and surfaces for the selected faults on the 2D viewer.
    5. Select Auxiliary 2D Surface(s): Use the dropdown menu on the upper left corner to select up to two auxiliary 2D surfaces to display.
    6. Toggle Features: Use checkboxes to show/hide earthquakes, terrain occlusion, and boundary lines.
    7. Change View: Use the Center View button to focus on a specific region by entering latitude and longitude. Use the Home View button to reset the map to its default orientation.
    8. Explore Earthquake Data: Toggle the Earthquakes checkbox to display epicenters. Adjust the circle size slider to change the marker size for earthquakes.
    9. Adjust Opacity: Use the Opacity Control slider to adjust the transparency of fault surfaces.

Data Download

CFM GeoPackage (.gpkg) & KML (.kml) file downloads of the models are available under the Data menu ( Data → Download Models ).

General Tips

  • Visit the links under the More menu.
  • Interaction: Use your mouse or touchscreen to pan, zoom, and rotate the map. Hover over features to display tooltips with additional information.
  • Full-Screen Mode: Click the Full Screen Map button for an enhanced viewing experience.
  • Help and Support: If you encounter any issues, visit the Help Page to submit a question or request assistance.

Development and Branch Support

The CFM Web Interface supports configuration and deployment across multiple branches. By default, the interface uses the main branch. However, for development or testing purposes, the dev branch is also supported. To use the dev branch, access the interface with the following URL:

  • http://your-cfm-server-address/?branch=dev

Using the dev branch allows you to load development-specific configuration files and resources, making it easy to test new features without affecting the main interface.

Local Installation

If you plan to download and install this package locally:
  • Download the CFM-WEB code from the GitHub repository
  • Download and install Docker
  • Go to the CESIUM site and create an account and get a token
  • Go to the downloaded CFM-WEB code directory
  • Place your token in app/static/config/repository_config.js by replacing your_access_token in Cesium.Ion.defaultAccessToken = "your_access_token"; with your own token
  • In the root directory (directory above app/) Build the image: docker run -d -p 8080:80 -v $(pwd)/app:/app cfm_viewer
  • Run the package docker run -p 8080:80 -v $(pwd)/app:/app cfm_viewer
  • On your browser go to the CFM viewer http://localhost:8080