Rocscience International Conference 2025 is going to take place in Sydney, Australia Read more

Search Results

History Query


A History Query in RS2 is a user-defined point anywhere on the model, on which the historical data can be interpolated in the RS2 Compute dialog when launching Compute. For a model, RS2 Compute module does not automatically output data for all mesh nodes. The History Query option allows users to specify key location(s) for the development of data change over the simulation. Three types of data are available: displacement, pore pressure, and temperature. A History Query must be added in the modeler after Mesh, and before Compute.

Add History Query

History queries can be specified as individual points within the solid material. Note that History Query can only be added after Mesh. Steps are as followed.

  1. Select the Add History Query Add History Query option from the Analysis menu.
  2. Use the mouse or enter coordinate to locate a query.
  3. Use the mouse to enter a point graphically or enter x,y coordinates in the prompt line. Hit Enter or Esc key. A History Query point will be added to the model. The item will be added under the Mesh Group in the Model Items.
  4. Mesh Group in the Model Items

  5. Repeat step 1-3 to add more History Query points.
  6. After History Query points are defined, the historical data can be viewed in the compute dialog when Compute Compute is launched. See View History Query Data section for detail.

Any number of History Query points can be defined. History query points are displayed as light blue circles with label names of “HQ #” (# is the default number) through all tabs and stages in the model. Hover the mouse over the History Query point, and the name and coordinates will display.

Edit History Queries

Select the History Query entity under Model Items. The Properties section for History Query will display underneath, users can change the label name.

History Query entity

Delete History Query

To delete History Query point(s), there are two ways.

  1. Right click on the History Query point in the model and select Delete history query.
  2. Select the Remove History Query Remove History Query option from the Analysis menu. Use the mouse to select one or more History Query point(s), hit the Enter key to complete.

View History Query Data

After a history query point has been created using the Add History Query option, the data generated of the point can be viewed in multiple ways. The history query data include various data types, for the user to observe the data development at a specific location throughout the simulation.

There are the following two ways to view history query data (with details described in the section below).

  1. To monitor the data change DURING the computation, history query data are presented in the RS2 Compute dialog.
  2. To view the complete data AFTER the computation, the user can Graph History Query Data from the RS2 Interpret.

View History Query Data in RS2 Compute Dialog

The development of history query data can be viewed under the Current Progress tab in the RS2 Compute dialog during the computation. To view the data, steps should be followed:

History query point(s) must be defined prior in the model using the Add History Query option.
  1. After constructing the model, select Compute from the Analysis menu.
  2. In the RS2 Compute dialog that pops up, make sure the Current Progress tab is selected.
  3. The History Graphs section sits on the right side of the dialog. Use the dropdown menu for Plot, to select any defined history query.
  4. Select the Y-axis from one the three options: Load Percentage Stage, Stage Number, and SRF.
  5. HQ data type in compute

  6. Three types of History Graphs will be presented below: history of displacement vs. y-axis, history of pore pressure change vs. y-axis (when groundwater seepage analysis is enabled), and history of temperature change vs. y-axis (when thermal analysis is enabled).

RS2 Compute Dialog

Hint: To set up proper History Graphs, users can use the Pause option anytime during computation.

View History Query Data in RS2 Interpret

After computation, the history query data can be viewed with Graph History Query Data in RS2 Interpret.

The complete data history are outputted after calculation as file outputs of: solid (*.r*), fluid (*.w*), and thermal (*.t*) for the corresponding data types. Note that for SSR, only solid results will be outputted.

Rocscience logo, click here to return to the homepage Portal Account Portal Account Log In Log Out Home Shopping Cart icon Click here to search our site Click here to close Learning Tech Support Documentation Info Chevron Delete Back to Top View More" Previous Next PDF File Calendar Location Language Fees Video Click here to visit Rocscience's LinkedIn page Click here to visit Rocscience's YouTube page Click here to visit Rocscience's X page Click here to visit Rocscience's Facebook page Click here to visit Rocscience's Instagram page Click here to visit Rocscience's Reddit page Bookmark Network Scroll down for more Checkmark Download Print Back to top Single User Multiple Users RSLog RocFall3 CPillar Dips EX3 RocFall RocPlane RocSlope3 RocSupport RocTopple RS2 RS3 RSData RSPile Settle3 Slide2 Slide3 SWedge UnWedge RocTunnel RocSlope2 Commercial License Education License Trial License Shop safe & secure Money-back guarantee