## A software for receiver functions analysis and dealing with sediment effects
[](https://python.org)
**rfsed** is developed specifically to implement different techniques of
**analysing receiver functions from stations overlying sedimentary layers.**
The software is **adaptable, efficient, and easy-to-use** for different
analysis of receiver functions obtained from stations overlying sedimentary layers.
Receiver functions techniques implemented in **rfsed** are:
+ H-k stacking (one layer) of Zhu and Kanamori (2000)
+ Sequential H-k stacking (two layers) of Yeck et al., (2013)
+ Resonance filtering and modified H-k stacking of Yu et al., (2015)
+ H-k stacking and Waveform Fitting (two-step method) of Akinremi et al., (2024)
+ Analysis of the synthetic reciever functions with the above-mentioned methods.
Beside these receiver function methods, **rfsed** has the following features:
+ Extracting earthquake data from local seismic record files.
+ Multiprocessing options for waveform fitting and extracting earthquake
data from local seismic record files.
+ Creating publication quality figures for the results of the analysis.
Receiver functions streams in the **rfsed** are handled by the `RFStream` class of the
[rf](https://github.com/trichter/rf) open software, and it inherits a lot of useful
methods from the Obspy class `Stream`. It is supported via the obspyh5 package.
For more information on class `RFStream`, see documentation on
[rf](https://rf.readthedocs.io/en/latest/). In the **rfsed** modules to extract earthquake
data from local seismic records, read and write support for necessary metadata is
provided for SAC, SeismicHanlder and HDF5 formats based on
[ObsPy](https://github.com/obspy/obspy).
## Installation and testing of this software
### Installation from PyPi
The easiest way to install **rfsed** is via `pip`::
```bash
pip install rfsed
```
### Installation development version from source code
To obtain the latest updates, you can install **rfsed** from the source code from
available on GitHub.
Clone the **rfsed** repository from GitHub
```bash
git clone https://github.com/akinremisa/rfsed.git
```
Change directory to the same directory that this repo is in
```bash
cd rfsed
```
Installing using pip
```bash
pip install .
```
### Test the rfsed software
You can test the software using pytest by running this command in the software
directory and will look for all available tests in the current directory and
subdirectories recursively
```bash
pytest
```
Or run individual tests in the /tests/ directory
## Getting started
Access **rfsed**'s documentation [here](https://akinremisa.github.io/rfsed/).
**rfsed** comes with tutorials that demonstrates all its methods. See the documentation for more details.
## Reporting Bugs / Contact the developers
This version is an early release of **rfsed**. If you encounter any issues or unexpected
behaviour, please [open an issue](https://github.com/akinremisa/rfsed/issues/new) on GitHub.
## Questions?
If you have any questions about the software, please use the
[discussions feature](https://github.com/akinremisa/rfsed/discussions/new/choose)
## Contributing
All contributions are welcome ... e.g. report bugs, discuss or add new features.
## Citing rfsed
If you use **rfsed** in your work, please consider citing the following paper.
+ Akinremi S., van der Meijde, M., Thomas, C., Afonso, J. C., Ruigrok, E., & Fadel, I. (2024).
Waveform fitting of receiver functions for enhanced retrieval of crustal structure in the
presence of sediments. Journal of Geophysical Research: Solid Earth, 5(129). https://doi.org/10.1029/2023JB028393
#### References
+ Akinremi, S., van der Meijde, M., Thomas, C., Afonso J. C., Ruigrok E., Fadel, I. (2024).
Waveform fitting of receiver functions for enhanced retrieval of crustal structure in the
presence of sediments. Journal of Geophysical Research: Solid Earth, 5(129). https://doi.org/10.1029/2023JB028393
+ Tom Eulenfeld T., (2020). rf: Receiver function calculation in seismology. Journal of Open Source Software, 5(48),
1808, https://doi.org/10.21105/joss.01808
+ Yeck, W. L., Sheehan, A. F., & Schulte-Pelkum, V. (2013). Sequential h-k stacking to obtain accurate
crustal thicknesses beneath sedimentary basins. Bulletin of the Seismological Society of America, 103,
2142-2150. https://doi.org/10.1785/0120120290
+ Yu, Y., Song, J., Liu, K. H., & Gao, S. S. (2015). Determining crustal structure beneath seismic
stations overlying a low-velocity sedimentary layer using receiver functions. Journal of Geophysical
Research: Solid Earth, 120 , 3208-3218. https://doi.org/10.1002/2014JB011610
+ Zhu, L., & Kanamori, H. (2000). Moho depth variation in southern California from teleseismic
receiver functions. Journal of Geophysical Research: Solid Earth, 105, 2969-2980. https://doi.org/10.1029/1999jb900322
#### Related receiver function projects
+ [rf](https://github.com/trichter/rf) including calculation of receiver functions
+ [seispy](https://github.com/xumi1993/seispy) including hk-stacking
+ [RFPy](https://github.com/paudetseis/RfPy) including hk-stacking, harmonic decomposition
+ [BayHunter](https://github.com/jenndrei/BayHunter) inversion of receiver functions and surface wave dispersion
+ [telewavesim](https://github.com/paudetseis/Telewavesim) teleseismic body wave modeling through stacks of anisotropic layers
+ [PyGLImER](https://github.com/PyGLImER/PyGLImER) including common conversion point imaging
Raw data
{
"_id": null,
"home_page": "https://github.com/akinremisa/rfsed",
"name": "rfsed",
"maintainer": null,
"docs_url": null,
"requires_python": "<3.11,>=3.6",
"maintainer_email": null,
"keywords": "Seismology, Receiver Function, Sediment effect in receiver functions, Crustal modelling, Moho, Earth Sciences",
"author": "Stephen Akinremi",
"author_email": "s.akinremi@utwente.nl",
"download_url": "https://files.pythonhosted.org/packages/85/f1/e8b11ed22ead2ccf8b1cbacbf0e51cc8c37cdcfe97363744177a023a453a/rfsed-1.0.0.tar.gz",
"platform": null,
"description": "\n## A software for receiver functions analysis and dealing with sediment effects \n\n[](https://python.org)\n\n\n**rfsed** is developed specifically to implement different techniques of \n**analysing receiver functions from stations overlying sedimentary layers.** \nThe software is **adaptable, efficient, and easy-to-use** for different \nanalysis of receiver functions obtained from stations overlying sedimentary layers.\n\nReceiver functions techniques implemented in **rfsed** are:\n+ H-k stacking (one layer) of Zhu and Kanamori (2000)\n+ Sequential H-k stacking (two layers) of Yeck et al., (2013)\n+ Resonance filtering and modified H-k stacking of Yu et al., (2015)\n+ H-k stacking and Waveform Fitting (two-step method) of Akinremi et al., (2024)\n+ Analysis of the synthetic reciever functions with the above-mentioned methods.\n\n\nBeside these receiver function methods, **rfsed** has the following features:\n+ Extracting earthquake data from local seismic record files.\n+ Multiprocessing options for waveform fitting and extracting earthquake \ndata from local seismic record files.\n+ Creating publication quality figures for the results of the analysis.\n\n\nReceiver functions streams in the **rfsed** are handled by the `RFStream` class of the \n[rf](https://github.com/trichter/rf) open software, and it inherits a lot of useful \nmethods from the Obspy class `Stream`. It is supported via the obspyh5 package. \nFor more information on class `RFStream`, see documentation on \n[rf](https://rf.readthedocs.io/en/latest/). In the **rfsed** modules to extract earthquake \ndata from local seismic records, read and write support for necessary metadata is \nprovided for SAC, SeismicHanlder and HDF5 formats based on \n[ObsPy](https://github.com/obspy/obspy).\n\n\n\n\n## Installation and testing of this software\n\n### Installation from PyPi\nThe easiest way to install **rfsed** is via `pip`::\n\n```bash\npip install rfsed\n```\n\n### Installation development version from source code\nTo obtain the latest updates, you can install **rfsed** from the source code from \navailable on GitHub.\n\nClone the **rfsed** repository from GitHub\n```bash\ngit clone https://github.com/akinremisa/rfsed.git\n```\nChange directory to the same directory that this repo is in\n```bash\ncd rfsed \n``` \nInstalling using pip\n```bash\npip install .\n```\n### Test the rfsed software\nYou can test the software using pytest by running this command in the software \ndirectory and will look for all available tests in the current directory and \nsubdirectories recursively\n\n```bash\npytest\n```\nOr run individual tests in the /tests/ directory\n\n## Getting started\nAccess **rfsed**'s documentation [here](https://akinremisa.github.io/rfsed/).\n\n**rfsed** comes with tutorials that demonstrates all its methods. See the documentation for more details.\n\n## Reporting Bugs / Contact the developers\nThis version is an early release of **rfsed**. If you encounter any issues or unexpected \nbehaviour, please [open an issue](https://github.com/akinremisa/rfsed/issues/new) on GitHub.\n\n## Questions?\nIf you have any questions about the software, please use the \n[discussions feature](https://github.com/akinremisa/rfsed/discussions/new/choose)\n\n## Contributing\nAll contributions are welcome ... e.g. report bugs, discuss or add new features.\n\n## Citing rfsed\nIf you use **rfsed** in your work, please consider citing the following paper.\n+ Akinremi S., van der Meijde, M., Thomas, C., Afonso, J. C., Ruigrok, E., & Fadel, I. (2024). \nWaveform fitting of receiver functions for enhanced retrieval of crustal structure in the \npresence of sediments. Journal of Geophysical Research: Solid Earth, 5(129). https://doi.org/10.1029/2023JB028393\n\n#### References\n+ Akinremi, S., van der Meijde, M., Thomas, C., Afonso J. C., Ruigrok E., Fadel, I. (2024). \nWaveform fitting of receiver functions for enhanced retrieval of crustal structure in the \npresence of sediments. Journal of Geophysical Research: Solid Earth, 5(129). https://doi.org/10.1029/2023JB028393\n+ Tom Eulenfeld T., (2020). rf: Receiver function calculation in seismology. Journal of Open Source Software, 5(48), \n1808, https://doi.org/10.21105/joss.01808\n+ Yeck, W. L., Sheehan, A. F., & Schulte-Pelkum, V. (2013). Sequential h-k stacking to obtain accurate \ncrustal thicknesses beneath sedimentary basins. Bulletin of the Seismological Society of America, 103, \n2142-2150. https://doi.org/10.1785/0120120290\n+ Yu, Y., Song, J., Liu, K. H., & Gao, S. S. (2015). Determining crustal structure beneath seismic \nstations overlying a low-velocity sedimentary layer using receiver functions. Journal of Geophysical \nResearch: Solid Earth, 120 , 3208-3218. https://doi.org/10.1002/2014JB011610\n+ Zhu, L., & Kanamori, H. (2000). Moho depth variation in southern California from teleseismic \nreceiver functions. Journal of Geophysical Research: Solid Earth, 105, 2969-2980. https://doi.org/10.1029/1999jb900322\n\n#### Related receiver function projects\n+ [rf](https://github.com/trichter/rf) including calculation of receiver functions\n+ [seispy](https://github.com/xumi1993/seispy) including hk-stacking\n+ [RFPy](https://github.com/paudetseis/RfPy) including hk-stacking, harmonic decomposition\n+ [BayHunter](https://github.com/jenndrei/BayHunter) inversion of receiver functions and surface wave dispersion\n+ [telewavesim](https://github.com/paudetseis/Telewavesim) teleseismic body wave modeling through stacks of anisotropic layers\n+ [PyGLImER](https://github.com/PyGLImER/PyGLImER) including common conversion point imaging\n",
"bugtrack_url": null,
"license": null,
"summary": "Package for receiver functions analysis and dealing with sediment effects in receiver functions",
"version": "1.0.0",
"project_urls": {
"Homepage": "https://github.com/akinremisa/rfsed"
},
"split_keywords": [
"seismology",
" receiver function",
" sediment effect in receiver functions",
" crustal modelling",
" moho",
" earth sciences"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "7c5b25f2b97f780fc5358fdf4c18558fb1038558b8623cce87fe498e36ef032d",
"md5": "c5d068eac0e90c9adb920a2e0ae931d5",
"sha256": "edbd5aa414ea48ae5cc2ee3c5eed9fb393bbc36104cfc2fd05d67033d236bfbb"
},
"downloads": -1,
"filename": "rfsed-1.0.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "c5d068eac0e90c9adb920a2e0ae931d5",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": "<3.11,>=3.6",
"size": 47308762,
"upload_time": "2024-07-22T16:41:44",
"upload_time_iso_8601": "2024-07-22T16:41:44.757370Z",
"url": "https://files.pythonhosted.org/packages/7c/5b/25f2b97f780fc5358fdf4c18558fb1038558b8623cce87fe498e36ef032d/rfsed-1.0.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "85f1e8b11ed22ead2ccf8b1cbacbf0e51cc8c37cdcfe97363744177a023a453a",
"md5": "9811bdb19f185ac8a0100dda3a725bd7",
"sha256": "a252137385600f17b8bced8664578f9fdf46701947e3f5afb3b07490e28e7166"
},
"downloads": -1,
"filename": "rfsed-1.0.0.tar.gz",
"has_sig": false,
"md5_digest": "9811bdb19f185ac8a0100dda3a725bd7",
"packagetype": "sdist",
"python_version": "source",
"requires_python": "<3.11,>=3.6",
"size": 47256530,
"upload_time": "2024-07-22T16:42:30",
"upload_time_iso_8601": "2024-07-22T16:42:30.875006Z",
"url": "https://files.pythonhosted.org/packages/85/f1/e8b11ed22ead2ccf8b1cbacbf0e51cc8c37cdcfe97363744177a023a453a/rfsed-1.0.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-07-22 16:42:30",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "akinremisa",
"github_project": "rfsed",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "rfsed"
}
JSON
