/
README
100 lines (70 loc) · 4.18 KB
/
README
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
fdfault is a finite difference code for solving elastodynamic rupture problems
Features:
- High order finite difference method
- Complex geometries handled through coordinate transforms on structured mesh
- Boundary conditions are enforced weakly, producing a provably stable method
- Supports elastic and elastic-plastic material response
- Several friction laws, permits heterogeneous parameters in several ways
- Parallelized using MPI
- Included Python module to simplify setting up problems and generating input files
- Analysis tools for Python and MATLAB
Requirements:
- C++ compiler with an MPI library for main code
- Python (supports both Python 2 and 3) with numpy required for setup and analysis
(Python is optional, but greatly simplifies problem generation and thus is highly
recommended)
#######################################################################################
Installation Instructions:
If installing from a downloaded zip archive, enter
> unzip fdfault-1.0.zip
Depending on which version you downloaded, the filename for the zipped archive might
be different. Or clone the git repository using
> git clone https://github.com/egdaub/fdfault.git
For most users, building the source code should simply require
> cd fdfault/src
> make
assuming you have Make and an appropriate C++ compiler with an MPI Library. You may
need to change some of the compiler flags -- I have mostly tested the code using the
GNU Compilers and OpenMPI on both Linux and Mac OS X. This will create the fdfault
executable in the main fdfault directory.
You will also need to configure the python module. There are several ways to do this:
1. Install the Python module system-wide. To make the Python tools available system-wide,
change to the python directory and run setup.py (you must have setuptools installed):
> cd fdfault/python
> python setup.py install
You may also use Python 3 without any modifications. Depending on your setup, you might
need administrative privileges to do the installation step. If you obtained the code by
cloning the Git repository, installation in this manner will not update automatically
if any of the source code files are updated. If you want to keep up to date without
having to reinstall, install a development version:
> cd fdfault/python
> python setup.py develop
This will simply place a link to the fdfault python directory in the system Python
libraries, so any updates will automatically be available.
2. If you would like the Python module available in any directory without installing for
other users, you can simply modify your PYTHONPATH environment variable to include the
full path to fdfault/python. This will only effect the current user.
3. Some users prefer to only have the Python tools available in certain directories.
The tools for setting up problems are most often used in the problems directory, and the
analysis tools are most often used in the data directory.
To make these tools available in these directories only, make a symbolic link to the
python/fdfault directory in the problems directory:
> cd fdfault/problems
> ln -s ../python/fdfault/ fdfault
This will allow you to simply type "import fdfault" in python from within the problems
directory. Similarly, to make the analysis features available in the data directory:
> cd fdfault/data
> ln -s ../python/fdfault/analysis fdfault
This allows you to type "import fdfault" from within the data directory and have the
analysis tools at your disposal.
Finally you will need to build the User's Guide. The user's guide requires Sphinx and
MathJax (or an internet connection to access MathJax online) for the HTML version and
a LaTeX distribution for the PDF version.
> cd fdfault/docs/
> make html && make latexpdf
This should build the notes in the fdfault/docs/_build/html or fdfault/docs/_build/latex
directories. If you wish to build only the html or pdf version, use the appropriate
command. If you do not have Sphinx or LaTeX on your machine, both versions of the
documentation are available on the web, though these are only periodially updated:
http://www.ceri.memphis.edu/people/egdaub/fdfault/_build/html/index.html (html)
http://www.ceri.memphis.edu/people/egdaub/fdfault/_build/latex/fdfault_docs.pdf (pdf)