haselREC - HAzard-based SELection of RECords
The code is described in: Zuccolo, E., O’Reilly, G.J., Poggi, V., Monteiro, R. (2021) haselREC: an automated open-source ground motion record selection and scaling tool. Bull Earthquake Eng 19, 5747–5767 https://doi.org/10.1007/s10518-021-01214-w
Main Contributor:
- Elisa Zuccolo - EUCENTRE Foundation, Italy
Supporting Developers:
- Gerard J. O'Reilly - Scuola Universitaria Superiore IUSS Pavia, Italy,
- Andrea Francia - Software architect
For inquiries: ezuccolo@ogs.it
NEW:
- Kik-NET strong ground motion database and code-based record selection!
- record selection according to NTC18 (both single and two-component record selection)!
Installation
haselREC has the following dependencies:
- numpy
- pandas
- scipy
- obspy
- matplotlib
- openquake.hazardlib
- shakelib.conversions.imc.boore_kishida_2017 (Optional. Only of the input intensity measure component is the larger between the two horizontal components).
Add the lib folder to PYTHONPATH. For Linux open the file ~/.bashrc in your
text editor and add the following line at the end:
export PYTHONPATH=/path/to/haselREC
How to make haselREC to automatically download ESM recordings
ESM recordings can be stored in advance or automatically downloaded from internet using a token file (token.txt). To obtain the token file you need at first to register at: https://esm-db.eu/ and then you can run the command:
curl -X POST -F 'message={"user_email": "email","user_password": "password"}' "https://esm-db.eu/esmws/generate-signed-message/1/query" > token.txt
Documentation
The documentation of the code can be generated using Sphinx (v1.8.5). To run the documentation type:
make html
The documentation will be generated in the build folder
Demos
Some demos can be found in the demo folder. See the README file in the demo folder
License
Copyright (C) 2020-2021 Elisa Zuccolo, Eucentre Foundation haselREC is free software: you can redistribute it and/or modify it under the terms of the GNU Affero General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version. See the GNU Affero General Public License for more details. You should have received a copy of the GNU Affero General Public License along with haselREC. If not, see http://www.gnu.org/licenses/.
Disclaimer
haselREC is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Affero General Public License for more details. The authors of the software assume no liability for use of the software.
Potential Improvements
A list of things that could be improved:
- Use of original names for recordings from the NGA-West2 database
- Computation of exact CS