Welcome to APSG’s documentation!
APSG defines several new python classes to easily manage, analyze and visualize orientational structural geology data. It is under active developement, so until documenation will be finished, you can go trough tutorial to see what APSG can do for you.
Usage
To use APSG in a project:
import apsg
To use APSG interactively it is easier to import into current namespace:
from apsg import *
Changes in classnames and API
Note
APSG has been significantly refactored from version 1.0 and several changes are breaking backward compatibility. The main APSG namespace provides often-used classes in lowercase names as aliases to PascalCase convention used in modules to provide a simplified interface for users. The PascalCase names of classes use longer and plain English names instead acronyms for better readability.
If you already used older versions of APSG, check following table for new names and aliases of most commonly used classes.
alias |
class name |
Description |
---|---|---|
vec2 |
Vector2 |
A class to represent a 2D vector |
vec |
Vector3 |
A class to represent a 3D vector |
lin |
Lineation |
A class to represent non-oriented (axial) linear feature |
fol |
Foliation |
A class to represent non-oriented planar feature |
pair |
Pair |
The class to store pair of planar and linear features |
fault |
Fault |
The class to store pair of planar and linear features together with sense of movement |
cone |
Cone |
The class to store cone with given axis, secant line and revolution angle in degrees |
vec2set |
Vector2Set |
Class to store set of |
vecset |
Vector3Set |
Class to store set of |
linset |
LineationSet |
Class to store set of |
folset |
FoliationSet |
Class to store set of |
pairset |
PairSet |
Class to store set of |
faultset |
FaultSet |
Class to store set of |
coneset |
ConeSet |
Class to store set of |
defgrad2 |
DeformationGradient2 |
The class to represent 2D deformation gradient tensor |
defgrad |
DeformationGradient3 |
The class to represent 3D deformation gradient tensor |
velgrad2 |
VelocityGradient2 |
The class to represent 2D velocity gradient tensor |
velgrad |
VelocityGradient3 |
The class to represent 3D velocity gradient tensor |
stress2 |
Stress2 |
The class to represent 2D stress tensor |
stress |
Stress3 |
The class to represent 3D stress tensor |
ellipse |
Ellipse |
The class to represent 2D ellipse |
ellipsoid |
Ellipsoid |
The class to represent 3D ellipsoid |
ortensor2 |
OrientationTensor2 |
Represents an 2D orientation tensor |
ortensor |
OrientationTensor3 |
Represents an 3D orientation tensor |
ellipseset |
EllipseSet |
Class to store set of |
ortensor2set |
OrientationTensor2Set |
Class to store set of |
ellipsoidset |
EllipsoidSet |
Class to store set of |
ortensorset |
OrientationTensor3Set |
Class to store set of |
Check tutorials and module API for more details.