XStereonet

require.mx('mxjs/geotech/xstereonet.js');

This library provides functions to plot stereonets in mXrap

Note, implementation includes ported Matlab scripts written by Nestor Cardozo for the book Structural Geology Algorithms by Allmendinger, Cardozo, & Fisher, 2011

StatusName
Constant EQUALANGLE

Constant EQUALAREA

Constant LOWERHEMISPHERE

Constant UPPERHEMISPHERE

plotStereonet ( Plotter ⇅plotter, Text ↓plotType, Number ↓viewTrend_degs, Number ↓viewPlunge_degs, Number ↓markerIncrement_degs )

Plot a Stereonet

Convert.getStrikeDipPlaneFromTrendPlungePole ( Array ↑array, Number ↓trend_degs, Number ↓plunge_degs )

Compute the plane (strike/dip) from a pole (trend/plunge). All inputs and outputs in degrees

Convert.getTrendPlungePoleFromStrikeDipPlane ( Array ↑array, Number ↓strike_degs, Number ↓dip_degs )

Compute the pole (trend/plunge) from a plane (strike/dip). All inputs and outputs in degrees

Original.plotCircle ( Plotter ⇅plotter, Text ↓plotType, Number ↓strike_degs, Number ↓dip_degs, Number ↓key, Number ↓viewTrend_degs, Number ↓viewPlunge_degs )

Plot a plane as a circle on a Stereonet

Original.plotPole ( Plotter ⇅plotter, Text ↓plotType, Number ↓trend_degs, Number ↓plunge_degs, Number ↓key, Number ↓viewTrend_degs, Number ↓viewPlunge_degs )

Plot a pole as a point on a Stereonet

Plot.plotCircle ( Plotter ⇅plotter, Text ↓plotType, Number ↓dip_degs, Number ↓dipdir_degs, Number ↓key, Text ↓hemisphere, Number ↓viewTrend_degs, Number ↓viewPlunge_degs )

The Dip and Dip Direction provided is interpreted as the trend and plunge of a line into the stereonet. This function then plots the corresponding plane/circle that has the line's point of entry as its pole.

Plot.plotJointCircle ( Plotter ⇅plotter, Text ↓plotType, Number ↓dip_degs, Number ↓dipdir_degs, Number ↓key, Text ↓hemisphere, Number ↓viewTrend_degs, Number ↓viewPlunge_degs )

Plot a plane as a circle on a Stereonet. The Dip and Dip Direction provided corresponds to the plane.

Plot.plotJointPole ( Plotter ⇅plotter, Text ↓plotType, Number ↓dip_degs, Number ↓dipdir_degs, Number ↓key, Text ↓hemisphere, Number ↓viewTrend_degs, Number ↓viewPlunge_degs )

Plot a point on a Stereonet at the pole of a plane specified by the Dip and Dip Direction provided.

Plot.plotPole ( Plotter ⇅plotter, Text ↓plotType, Number ↓dip_degs, Number ↓dipdir_degs, Number ↓key, Text ↓hemisphere, Number ↓viewTrend_degs, Number ↓viewPlunge_degs )

The Dip and Dip Direction provided is interpreted as the trend and plunge of a line into the stereonet. This plots the point of entry.


Library Functions

Lib.plotStereonet ( ⇅plotter, ↓plotType, ↓viewTrend_degs, ↓viewPlunge_degs, ↓markerIncrement_degs )

Plot a Stereonet

Parameters:
  • Plotter ⇅plotter - - Plotter object to plot to. See XChart.Plotter.create(...) on how to create Plotter(s).
  • Text ↓plotType - - either XStereonet.EQUALAREA or XStereonet.EQUALANGLE.
  • Number ↓viewTrend_degs - - optional. Trend of view direction, in degrees. Default 0 degrees.
  • Number ↓viewPlunge_degs - - optional. Plunge of view direction, in degrees. Default 90 degrees.
  • Number ↓markerIncrement_degs - - optional. Angle increment for the markers, in degrees. Default 10 degrees.

Category: Convert

This category contains functions to convert between various related systems

Lib.Convert.getStrikeDipPlaneFromTrendPlungePole ( ↑array, ↓trend_degs, ↓plunge_degs )

Compute the plane (strike/dip) from a pole (trend/plunge). All inputs and outputs in degrees

Parameters:
  • Array ↑array - - Output array containing strike and dip as [strike, dip] in degrees
  • Number ↓trend_degs - - Trend of pole, in degrees.
  • Number ↓plunge_degs - - Plunge of pole, in degrees.
Lib.Convert.getTrendPlungePoleFromStrikeDipPlane ( ↑array, ↓strike_degs, ↓dip_degs )

Compute the pole (trend/plunge) from a plane (strike/dip). All inputs and outputs in degrees

Parameters:
  • Array ↑array - - Output array containing trend and plunge as [trend, plunge] in degrees
  • Number ↓strike_degs - - Strike of plane, in degrees.
  • Number ↓dip_degs - - Dip of plane, in degrees.

Category: Original

This category contains the original functions to plot poles from trend/plunge and circles from strike/dip.

Lib.Original.plotCircle ( ⇅plotter, ↓plotType, ↓strike_degs, ↓dip_degs, ↓key, ↓viewTrend_degs, ↓viewPlunge_degs )

Plot a plane as a circle on a Stereonet

Parameters:
  • Plotter ⇅plotter - - Plotter object to plot to. See XChart.Plotter.create(...) on how to create Plotter(s).
  • Text ↓plotType - - either XStereonet.EQUALAREA or XStereonet.EQUALANGLE.
  • Number ↓strike_degs - - Strike of plane, in degrees.
  • Number ↓dip_degs - - Dip of plane, in degrees.
  • Number ↓key - - optional. Reference key for this point.
  • Number ↓viewTrend_degs - - optional. Trend of view direction, in degrees. Default 0 degrees.
  • Number ↓viewPlunge_degs - - optional. Plunge of view direction, in degrees. Default 90 degrees.
Lib.Original.plotPole ( ⇅plotter, ↓plotType, ↓trend_degs, ↓plunge_degs, ↓key, ↓viewTrend_degs, ↓viewPlunge_degs )

Plot a pole as a point on a Stereonet

Parameters:
  • Plotter ⇅plotter - - Plotter object to plot to. See XChart.Plotter.create(...) on how to create Plotter(s).
  • Text ↓plotType - - either XStereonet.EQUALAREA or XStereonet.EQUALANGLE.
  • Number ↓trend_degs - - Trend of pole, in degrees.
  • Number ↓plunge_degs - - Plunge of pole, in degrees.
  • Number ↓key - - optional. Reference key for this point.
  • Number ↓viewTrend_degs - - optional. Trend of view direction, in degrees. Default 0 degrees.
  • Number ↓viewPlunge_degs - - optional. Plunge of view direction, in degrees. Default 90 degrees.

Category: Plot

This category contains the functions to plot poles and circles from Dip and Dip Direction

Lib.Plot.plotCircle ( ⇅plotter, ↓plotType, ↓dip_degs, ↓dipdir_degs, ↓key, ↓hemisphere, ↓viewTrend_degs, ↓viewPlunge_degs )

The Dip and Dip Direction provided is interpreted as the trend and plunge of a line into the stereonet. This function then plots the corresponding plane/circle that has the line's point of entry as its pole.

Parameters:
  • Plotter ⇅plotter - - Plotter object to plot to. See XChart.Plotter.create(...) on how to create Plotter(s).
  • Text ↓plotType - - either XStereonet.EQUALAREA or XStereonet.EQUALANGLE.
  • Number ↓dip_degs - - Dip of plane, in degrees.
  • Number ↓dipdir_degs - - Dip Direction of plane, in degrees.
  • Number ↓key - - optional. Reference key for this point.
  • Text ↓hemisphere - - optional. One of XStereonet.LOWERHEMISPHERE or XStereonet.UPPERHEMISPHERE. Lower Hemisphere by default;
  • Number ↓viewTrend_degs - - optional. Trend of view direction, in degrees. Default 0 degrees.
  • Number ↓viewPlunge_degs - - optional. Plunge of view direction, in degrees. Default 90 degrees.
Lib.Plot.plotJointCircle ( ⇅plotter, ↓plotType, ↓dip_degs, ↓dipdir_degs, ↓key, ↓hemisphere, ↓viewTrend_degs, ↓viewPlunge_degs )

Plot a plane as a circle on a Stereonet. The Dip and Dip Direction provided corresponds to the plane.

Parameters:
  • Plotter ⇅plotter - - Plotter object to plot to. See XChart.Plotter.create(...) on how to create Plotter(s).
  • Text ↓plotType - - either XStereonet.EQUALAREA or XStereonet.EQUALANGLE.
  • Number ↓dip_degs - - Dip of plane, in degrees.
  • Number ↓dipdir_degs - - Dip Direction of plane, in degrees.
  • Number ↓key - - optional. Reference key for this point.
  • Text ↓hemisphere - - optional. One of XStereonet.LOWERHEMISPHERE or XStereonet.UPPERHEMISPHERE. Lower Hemisphere by default;
  • Number ↓viewTrend_degs - - optional. Trend of view direction, in degrees. Default 0 degrees.
  • Number ↓viewPlunge_degs - - optional. Plunge of view direction, in degrees. Default 90 degrees.
Lib.Plot.plotJointPole ( ⇅plotter, ↓plotType, ↓dip_degs, ↓dipdir_degs, ↓key, ↓hemisphere, ↓viewTrend_degs, ↓viewPlunge_degs )

Plot a point on a Stereonet at the pole of a plane specified by the Dip and Dip Direction provided.

Parameters:
  • Plotter ⇅plotter - - Plotter object to plot to. See XChart.Plotter.create(...) on how to create Plotter(s).
  • Text ↓plotType - - either XStereonet.EQUALAREA or XStereonet.EQUALANGLE.
  • Number ↓dip_degs - - Dip of plane, in degrees.
  • Number ↓dipdir_degs - - Dip Direction of plane, in degrees.
  • Number ↓key - - optional. Reference key for this point.
  • Text ↓hemisphere - - optional. One of XStereonet.LOWERHEMISPHERE or XStereonet.UPPERHEMISPHERE. Lower Hemisphere by default;
  • Number ↓viewTrend_degs - - optional. Trend of view direction, in degrees. Default 0 degrees.
  • Number ↓viewPlunge_degs - - optional. Plunge of view direction, in degrees. Default 90 degrees.
Lib.Plot.plotPole ( ⇅plotter, ↓plotType, ↓dip_degs, ↓dipdir_degs, ↓key, ↓hemisphere, ↓viewTrend_degs, ↓viewPlunge_degs )

The Dip and Dip Direction provided is interpreted as the trend and plunge of a line into the stereonet. This plots the point of entry.

Parameters:
  • Plotter ⇅plotter - - Plotter object to plot to. See XChart.Plotter.create(...) on how to create Plotter(s).
  • Text ↓plotType - - either XStereonet.EQUALAREA or XStereonet.EQUALANGLE.
  • Number ↓dip_degs - - Dip of plane, in degrees.
  • Number ↓dipdir_degs - - Dip Direction of plane, in degrees.
  • Number ↓key - - optional. Reference key for this point.
  • Text ↓hemisphere - - optional. One of XStereonet.LOWERHEMISPHERE or XStereonet.UPPERHEMISPHERE. Lower Hemisphere by default;
  • Number ↓viewTrend_degs - - optional. Trend of view direction, in degrees. Default 0 degrees.
  • Number ↓viewPlunge_degs - - optional. Plunge of view direction, in degrees. Default 90 degrees.