[cig-commits] [commit] release_1.2: adding README and HISTORY (9579072)
cig_noreply at geodynamics.org
cig_noreply at geodynamics.org
Wed Jan 14 04:27:56 PST 2015
Repository : https://github.com/geodynamics/axisem
On branch : release_1.2
Link : https://github.com/geodynamics/axisem/compare/672dc979c8e3fe7d730aa641ba6f1b469329b573...9579072f2d4cb83a163705b19f49166f57069e11
>---------------------------------------------------------------
commit 9579072f2d4cb83a163705b19f49166f57069e11
Author: martinvandriel <vandriel at erdw.ethz.ch>
Date: Wed Jan 14 13:27:11 2015 +0100
adding README and HISTORY
>---------------------------------------------------------------
9579072f2d4cb83a163705b19f49166f57069e11
HISTORY | 72 ++++++++++++++++++++++++++++++++++++++++++++++++++++++
README | 86 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
2 files changed, 158 insertions(+)
diff --git a/HISTORY b/HISTORY
new file mode 100644
index 0000000..b638b27
--- /dev/null
+++ b/HISTORY
@@ -0,0 +1,72 @@
+AxiSEM 1.2 (2015/01/15):
+
+Questions/contact: info at axisem.info
+Webpage/distribution: http://www.axisem.info
+
+New features since v1.1:
+ - parallel synchronous IO via netcdf/mpiio for wavefields, output now scales
+ on up to 10K machines instead of 100
+ - 'displ_only' mode for wavefield output: stores the displacement on all GLL
+ points to a netcdf file
+ - 'strain_only' mode for wavefield output: stores the strain on a subset of
+ GLL points to a netcdf file
+ - output format consistent with the format expected by Instaseis
+ (www.instaseis.net)
+ - some code refactoring to use same modules in MESHER and SOLVER
+ - additional tests for the nightly builds
+
+Bugfixes
+ - Symplectic fourth order time scheme ('symplec4') well tested
+ - Bugfix for correct dt to be used in the attenuation module when a custom
+ value is used
+
+-------------------------------------------------------------------------------
+
+AxiSEM 1.1 (2014/07/07, Git revision 304a002):
+
+First bugfix release of AxiSEM.
+
+Changes to last version:
+ - Format of external (1D) models is changed and simplified
+ - Power-law Q in attenuation
+ - Full-field output for kernel wavefields and rdbm
+ - Better checking of user input
+ - Cleaning up output
+
+Bugfixes
+ - Serial mode now functional and compiling without MPI
+ - Bugfixes in NetCDF output of (kerner-related) wavefields
+ - Bugfix of all nodes writing into the same file, receiver.dat
+ - Bugfix in writing out 1D model files
+ - Bugfix in mesh decomposition for fluid spheres
+ - Fixed SOLVER/submit.csh script for arbitrary DATA directories, especially
+ for 'single' simulations
+
+-------------------------------------------------------------------------------
+
+AxiSEM 1.0 (2013/12/19, SVN revision 1089):
+First general release of AxiSEM.
+
+Working:
+ - 1D models included (PREM, IASP91, AK135 with different modifications)
+ - External 1D models
+ - Models can include solid and fluid zones
+ - Axially symmetric heterogeneities
+ - Attenuation
+ - Anisotropy
+ - General moment tensor and force sources
+ - Receiver locations on the surface
+ - Benchmarked for elastic models against yspec (Al Attar & Woodhouse, 2008)
+ up to 1 Hz
+ - Newmark time integration scheme tested and benchmarked against YSPEC
+ - Symplectic time integration scheme tested, but not fully benchmarked
+ - NetCDF output
+ - Postprocessing to produce ASCII seismogram files
+ - Mesh decomposition up to 32 processors radially and 500+ (depending on
+ frequency) laterally
+
+Known issues:
+ - Other time integration schemes are not reliably working.
+ - Source time function 'quheavi' is not working reliably.
+ - Receivers must be on surface.
+ - Uppermost layer of model must be solid.
diff --git a/README b/README
new file mode 100644
index 0000000..ef1b6ee
--- /dev/null
+++ b/README
@@ -0,0 +1,86 @@
+
+ AxiSEM 1.2
+
+ Axially symmetric Spectral Element Method
+
+ Copyright 2013, Tarje Nissen-Meyer, Alexandre Fournier, Martin van Driel
+ Simon Stähler, Kasra Hosseini, Stefanie Hempel
+
+
+ Webpage and distribution: http://www.axisem.info
+ Contact and information: info at axisem.info
+
+ January 14, 2015
+
+-------------------------------------------------------------------------------
+
+ If you are publishing results obtained with this
+ code, please cite this paper:
+
+ T. Nissen-Meyer, M. van Driel, S. C. Staehler,
+ K. Hosseini, S. Hempel, L. Auer, A. Colombi and A. Fournier:
+
+ "AxiSEM: broadband 3-D seismic wavefields in axisymmetric media"
+
+ Solid Earth, 5, 425-445, 2014
+ doi:10.5194/se-5-425-2014
+
+-------------------------------------------------------------------------------
+
+This package contains:
+
+ manual_axisem_1.2.pdf -- PDF manual
+
+ MESHER -- the program to generate 2D meshes for the SEM
+ forward solver
+
+ SOLVER -- the SEM forward solver itself
+
+ make_axisem.macros -- macro file to set compiler options
+
+ copytemplates.sh -- reset all input files to default templates
+
+ COPYING -- the GNU General Public License
+
+ HISTORY -- changelog
+
+ README -- this file
+
+Basic instructions for running:
+
+More details are found in the manual. For a quick start:
+
+The mesher has to be run first to generate a SEM mesh for the solver.
+Any changes in the resolution, spherically symmetric background model, or number
+of processors requires a new mesh.
+Changes in the source-receiver settings or 2.5D heterogeneities only need a new solver run.
+Changes on the moment tensor, receiver components, or filtering only need a new postprocessing run.
+
+General settings and explanations for parameters needed in MESHER and SOLVER
+are found in the inparam_* files in the respective directories.
+
+1) Run copytemplates.sh to set up a generic run with pre-set parameters
+
+2) Go into the MESHER directory, run ./submit.csh . This compiles the code using
+gfortran and mpif90 as default compilers, and then submits a job on a single node.
+For high resolution (seismic period below 3s), this requires significant amounts
+of RAM, see manual.
+
+3) Check OUTPUT; if finished, then run ./movemesh.csh <MESH_NAME>
+
+4) go into SOLVER/MESHES/<MESH_NAME> , check vtk files with paraview
+
+5) Edit inparam_basic to the desired <MESH_NAME>
+
+6) Run ./submit.csh <RUN_NAME> , this compiles and then submits a parallel run.
+
+7) Check <RUN_NAME>/OUTPUT*
+
+8) All data-related output is in <RUN_NAME>/Data/
+
+9) Convolution with a STF and summation for a moment source is done by running
+ postprocessing.csh in <RUN_NAME>
+
+Detailed instructions can be found in the file manual_axisem_1.2.pdf
+
+
More information about the CIG-COMMITS
mailing list