Skip to content

Commit ab73047

Browse files
authored
updates readme formatting
1 parent b183450 commit ab73047

File tree

1 file changed

+44
-45
lines changed

1 file changed

+44
-45
lines changed

EXAMPLES/real_world/Myanmar_Mw7.7/README.md

Lines changed: 44 additions & 45 deletions
Original file line numberDiff line numberDiff line change
@@ -44,37 +44,35 @@ Furthermore, we want to use a (realistic) velocity model for this region.
4444
We will take one of the EarthScope (IRIS) [EMC models](https://ds.iris.edu/ds/products/emc-earthmodels/).
4545
For this region, a nice model seems to be [FWEA23](https://ds.iris.edu/ds/products/emc-fwea23/) by Liu et al. (2024).
4646

47-
48-
4947
1. **Setup model**:
5048

51-
We will first setup the topography surface and tomographic model for meshing our region.
52-
In this example folder, we provide a bash script `setup_model.sh` to setup these model files.
53-
54-
Just run the setup script with the default target region:
55-
```
56-
> ./setup_model.sh
57-
```
58-
59-
This might take a while to complete and download the rather large EMC model file.
60-
Note that we added additional interfaces at 100km and 6km depth to facilitate the meshing with doubling layers.
61-
62-
Furthermore, USGS provides a global [Vs30 model and data](https://earthquake.usgs.gov/data/vs30/) set.
63-
The script will download and extract a corresponding Vs30-interface for our region.
64-
65-
49+
We will first setup the topography surface and tomographic model for meshing our region.
50+
In this example folder, we provide a bash script `setup_model.sh` to setup these model files.
51+
52+
Just run the setup script with the default target region:
53+
```
54+
> ./setup_model.sh
55+
```
56+
57+
This might take a while to complete and download the rather large EMC model file.
58+
Note that we added additional interfaces at 100km and 6km depth to facilitate the meshing with doubling layers.
59+
60+
Furthermore, USGS provides a global [Vs30 model and data](https://earthquake.usgs.gov/data/vs30/) set.
61+
The script will download and extract a corresponding Vs30-interface for our region.
62+
63+
6664
2. **Wave simulation**:
6765
68-
After you have completed the mesh setup, you can run the in-house mesher `xmeshfem3D` and `xgenerate_databases` to create the spectral-element mesh of our region.
69-
The seismic wave propagation solver `xspecfem3D` then creates the needed movie data files for our visualization.
70-
71-
To run the simulation, just type:
72-
```
73-
> ./run_this_example.sh
74-
```
66+
After you have completed the mesh setup, you can run the in-house mesher `xmeshfem3D` and `xgenerate_databases` to create the spectral-element mesh of our region.
67+
The seismic wave propagation solver `xspecfem3D` then creates the needed movie data files for our visualization.
68+
69+
To run the simulation, just type:
70+
```
71+
> ./run_this_example.sh
72+
```
7573
7674
77-
3. **Visualization**:
75+
3. **Visualization**:
7876
7977
For our simulation here, we turned on the surface movie and shake map outputs in `DATA/Par_file` like:
8078
```
@@ -91,21 +89,21 @@ For this region, a nice model seems to be [FWEA23](https://ds.iris.edu/ds/produc
9189
NTSTEP_BETWEEN_FRAMES = 100
9290
HDUR_MOVIE = 0.0
9391
```
94-
92+
9593
To visualize the corresponding output data (`OUTPUT_FILES/moviedata***`), we can create movie snapshot files as `OUTPUT_FILES/AVS_*.inp` files:
9694
```
9795
> ./xcreate_movie_files.sh
9896
```
99-
97+
10098
Similar for the shakemap, we can plot the peak-ground velocity (PGV) values by
10199
```
102100
> ./xcreate_shakemap.sh 2
103101
```
104-
102+
105103
You can use for example [Paraview](https://www.paraview.org) to look at the created `OUTPUT_FILEs/AVS_movie*.inp` files.
106104
107105
108-
That's it, try it out for yourself...
106+
That's it, try it out for yourself...
109107
110108
111109
## Visualization with Blender (optional)
@@ -117,14 +115,12 @@ A single wavefield snapshot like above can be plotted using [Blender](https://ww
117115
> ./xcreate_snapshot.sh 10000
118116
```
119117
120-
121118
Regarding shakemap image coloring, for conversion to Modified Mercalli Intensity (MMI), Wald et al. suggest a table like:
122119
123120
| PGV (cm/s) | < 0.1 | 0.1-0.4 | 0.4-1.1 | 1.1-3.4 | 3.4-8.1 | 8.1-16.0 | 16.0-31.0 | 31.0-60.0 | 60.0-116.0 | > 116.0 |
124121
| - | - | - | - | - | - | - | - | - | - | - |
125122
| Intensity (MMI) | I | II | III | IV | V | VI | VII | VIII | IX | X+ |
126123
127-
128124
USGS uses a scale like:
129125
130126
| PGV (cm/s) | < 0.0215 | 0.135 | 1.41 | 4.65 | 9.64 | 20 | 41.4 | 85.8 | >178 |
@@ -150,6 +146,7 @@ Adjust color-max accordingly:
150146
![screenshot of wavefield](./REF_SEIS/image.shakemap.PGV.jpg)
151147
152148
149+
153150
## Spectral Acceleration (SA) - response spectrum at Bangkok Chatuchak building collapse
154151
155152
Our simulation outputs the ground motions at the Chatuchak building site in Bangkok, Thailand. In particular, we are interested in how the [Spectral Acceleration (SA)](https://en.wikipedia.org/wiki/Spectral_acceleration) for a building at this location looked like.
@@ -163,22 +160,24 @@ A simple script to produce this figure is provided in this example directory:
163160
> ./xcreate_spectral_response.sh
164161
```
165162
163+
166164
## Sonification of traces (optional)
167165
168-
To hear how the ground shaking sounded, we can "sonify" the output traces, i.e., map the traces to an audible spectrum.
169-
First, get the script from the [shakemovie](https://github.com/SPECFEM/shakemovie) repository:
170-
```
171-
> git clone https://github.com/SPECFEM/shakemovie.git
172-
> ln -s shakemovie/scripts/run_create_sound.py
173-
```
166+
To hear how the ground shaking sounded, we can "sonify" the output traces, i.e., map the traces to an audible spectrum.
167+
First, get the script from the [shakemovie](https://github.com/SPECFEM/shakemovie) repository:
168+
```
169+
> git clone https://github.com/SPECFEM/shakemovie.git
170+
> ln -s shakemovie/scripts/run_create_sound.py
171+
```
172+
173+
and create sounds:
174+
```
175+
> ./run_create_sound.py 1.0 OUTPUT_FILES/DB.MANDALAY.BXZ.semv 25.0
176+
> ./run_create_sound.py 1.0 OUTPUT_FILES/DB.NAYPYIDAW.BXZ.semv 25.0
177+
```
174178
175-
and create sounds:
176-
```
177-
> ./run_create_sound.py 1.0 OUTPUT_FILES/DB.MANDALAY.BXZ.semv 25.0
178-
> ./run_create_sound.py 1.0 OUTPUT_FILES/DB.NAYPYIDAW.BXZ.semv 25.0
179-
```
180179
181-
## Reference solution
180+
## Reference solution
182181
183-
For comparison, we provide a reference solution in folder `REF_SEIS/` with corresponding output files.
184-
The simulation was run in parallel using 16 MPI processes, each using a single Nvidia A100 GPU. The total simulated time is 1000 s with a time-to-solution of ~ 24 min 15 s.
182+
For comparison, we provide a reference solution in folder `REF_SEIS/` with corresponding output files.
183+
The simulation was run in parallel using 16 MPI processes, each using a single Nvidia A100 GPU. The total simulated time is 1000 s with a time-to-solution of ~ 24 min 15 s.

0 commit comments

Comments
 (0)