rfsed


Namerfsed JSON
Version 0.1.8 PyPI version JSON
download
home_pagehttps://github.com/akinremisa/rfsed
SummaryPackage for receiver functions analysis and dealing with sediment effects in receiver functions
upload_time2024-03-01 12:17:02
maintainer
docs_urlNone
authorStephen Akinremi
requires_python<3.11,>=3.6
license
keywords seismology receiver function sediment effect in receiver functions crustal modelling moho earth sciences
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage No coveralls.
            ## A python package for receiver functions analysis and dealing with sediment effects 

[![python version](https://img.shields.io/pypi/pyversions/rf.svg)](https://python.org)


rfsed is developed specifically to implement different techniques of **analysing receiver functions
from stations overlying sedimentary layers.** The package is **adaptable, efficient, and easy-to-use** for different analysis receiver functions
obtained from stations overlying sedimentary layers.

Receiver functions techniques implemented in rfsed are:
+ H-k stacking of Zhu and Kanamori (2000)
+ Sequential H-k stacking 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:
+ Creating publication quality figures for the results of the analysis.
+ Extracting earthquake data from local seismic record files.
+ Multiprocessing options for waveform fitting and extracting earthquake data from local seismic record files.


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/). 
The rf framework is included in the rfsed package for completness under The MIT License (MIT) Copyright (c) 2013-2019 Tom Eulenfeld. 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).

The receiver function forward calculation in rfsed is done using SynR, which is modified after the [SynSeis module - seispy](https://github.com/xumi1993/seispy) project (under the GNU GENERAL PUBLIC LICENSE).




## Installation and testing of this package

### Installation from PyPi
The easiest way to install rfsed is via `pip`_::

```bash
pip install rfsed
```

## Getting started
Access rfsed's documentation [here](https://akinremisa.github.io/rfsed/).

rfsed comes with tutorials that demonstrates all its methods. You can find those in the `examples/` directory.

## 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 package, 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 found this package useful, please consider citing it.
+ 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 (under review)

#### References
+ 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. doi: 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. doi: 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. doi: 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) synthetics
+ [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": "",
    "docs_url": null,
    "requires_python": "<3.11,>=3.6",
    "maintainer_email": "",
    "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/dc/e4/ce05fb5041bf7b842bbf61d35ae28b210aab4ec22d3483141c7044602a54/rfsed-0.1.8.tar.gz",
    "platform": null,
    "description": "## A python package for receiver functions analysis and dealing with sediment effects \n\n[![python version](https://img.shields.io/pypi/pyversions/rf.svg)](https://python.org)\n\n\nrfsed is developed specifically to implement different techniques of **analysing receiver functions\nfrom stations overlying sedimentary layers.** The package is **adaptable, efficient, and easy-to-use** for different analysis receiver functions\nobtained from stations overlying sedimentary layers.\n\nReceiver functions techniques implemented in rfsed are:\n+ H-k stacking of Zhu and Kanamori (2000)\n+ Sequential H-k stacking 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+ Creating publication quality figures for the results of the analysis.\n+ Extracting earthquake data from local seismic record files.\n+ Multiprocessing options for waveform fitting and extracting earthquake data from local seismic record files.\n\n\nReceiver 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/). \nThe rf framework is included in the rfsed package for completness under The MIT License (MIT) Copyright (c) 2013-2019 Tom Eulenfeld. 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).\n\nThe receiver function forward calculation in rfsed is done using SynR, which is modified after the [SynSeis module - seispy](https://github.com/xumi1993/seispy) project (under the GNU GENERAL PUBLIC LICENSE).\n\n\n\n\n## Installation and testing of this package\n\n### Installation from PyPi\nThe easiest way to install rfsed is via `pip`_::\n\n```bash\npip install rfsed\n```\n\n## Getting started\nAccess rfsed's documentation [here](https://akinremisa.github.io/rfsed/).\n\nrfsed comes with tutorials that demonstrates all its methods. You can find those in the `examples/` directory.\n\n## Reporting Bugs / Contact the developers\nThis 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.\n\n## Questions?\nIf you have any questions about the package, please use the [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 found this package useful, please consider citing it.\n+ 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 (under review)\n\n#### References\n+ 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. doi: 10.1785/0120120290\n+ 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. doi: 10.1002/2014JB011610\n+  Zhu, L., & Kanamori, H. (2000). Moho depth variation in southern California from teleseismic receiver functions. Journal of Geophysical Research: Solid Earth, 105, 2969-2980. doi: 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) synthetics\n+ [PyGLImER](https://github.com/PyGLImER/PyGLImER) including common conversion point imaging\n",
    "bugtrack_url": null,
    "license": "",
    "summary": "Package for receiver functions analysis and dealing with sediment effects in receiver functions",
    "version": "0.1.8",
    "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": "220e9212138a56c08d928d9a06e2f67b555f3f32fee26c2e7271ef1576a98911",
                "md5": "99be4ed07caecf12ffbb7272f64d01c0",
                "sha256": "2b74b6dee48413b13b61949f7dde4a48a4d8e07cfa4b8eeebc3843b006c2b0e2"
            },
            "downloads": -1,
            "filename": "rfsed-0.1.8-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "99be4ed07caecf12ffbb7272f64d01c0",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": "<3.11,>=3.6",
            "size": 34159768,
            "upload_time": "2024-03-01T12:16:29",
            "upload_time_iso_8601": "2024-03-01T12:16:29.220325Z",
            "url": "https://files.pythonhosted.org/packages/22/0e/9212138a56c08d928d9a06e2f67b555f3f32fee26c2e7271ef1576a98911/rfsed-0.1.8-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "dce4ce05fb5041bf7b842bbf61d35ae28b210aab4ec22d3483141c7044602a54",
                "md5": "9afb81e16bf7b479a1208263f7e211c1",
                "sha256": "5ae61bc0997b35f0a534d4fe719c7a8e610a86f9f693b0b3bbcf60b5d5c1076c"
            },
            "downloads": -1,
            "filename": "rfsed-0.1.8.tar.gz",
            "has_sig": false,
            "md5_digest": "9afb81e16bf7b479a1208263f7e211c1",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": "<3.11,>=3.6",
            "size": 33891889,
            "upload_time": "2024-03-01T12:17:02",
            "upload_time_iso_8601": "2024-03-01T12:17:02.428401Z",
            "url": "https://files.pythonhosted.org/packages/dc/e4/ce05fb5041bf7b842bbf61d35ae28b210aab4ec22d3483141c7044602a54/rfsed-0.1.8.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2024-03-01 12:17:02",
    "github": true,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "github_user": "akinremisa",
    "github_project": "rfsed",
    "travis_ci": false,
    "coveralls": false,
    "github_actions": true,
    "lcname": "rfsed"
}
        
Elapsed time: 0.21478s