Welcome to the scatseisnet repository

About

This library contains programs to transform time series into scattering coefficients with a scattering network. The scattering network is a deep neural network with wavelet filters as convolutional layers. The scatseisnet package is under construction. A target release date will be around April 2023.

This package was written and documented by Léonard Seydoux and René Steinmann. Any contributions are very welcomed.

This work was supported by the European Advanced Grant F-IMAGE (ERC PE10, ERC-2016-ADG) and by the Multidisciplinary Institute of Artificial Intelligence (MIAI) at the University of Grenoble Alpes.

Scatseisnet: a toolbox for scattering networks in seismology
Copyright ©️ 2023 Léonard Seydoux and René Steinmann

This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version. This program 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 General Public License for more details. You should have received a copy of the GNU General Public License along with this program. If not, see https://www.gnu.org/licenses/.

Installation

The package is available from the PyPI repository. To install using pip, execute the following line:

CPU-only installation

pip install scatseisnet

GPU usage

If you want to use a GPU, you need to install the package with the package CuPy. The code will try to find it and use it if it is installed. You can install it with the following command.

pip install cupy

Documentation

Please check the documentation. You can find tutorials thererin in the form of notebooks.

Contribution guidelines

Thank you for your interest in contributing to this project! Here are some guidelines to help ensure a smooth and successful contribution process. Please read them carefully before contributing. We are happy to answer any questions you may have, and to welcome you as a contributor.

1. Fork the project to your own GitHub account by clicking the "Fork" button in the top right corner of the repository page. This will allow you to make changes to the project without affecting the main project.

2. Create a new branch for your contribution. This will keep your changes separate from the main branch and make it easier to review and merge your changes. The name of your branch should be concise and descriptive. For example, if you are adding a new feature, you might call your branch "add-feature".

3. Write concise commit messages that describe the changes you made. Use the present tense and avoid redundant information. We try to follow the Conventional Commits specification.

4. Make sure your changes work as intended and do not introduce new bugs or problems. Write tests if applicable.

5. Document your changes with following the numpydoc format. This step is important to ensure that the package documentation is up to date and complete. If you are not sure about this step, we can help you.

6. When you are ready to submit your changes, create a pull request from your branch to the main branch of the original repository. Provide a clear description of your changes and why they are necessary, and we will review your contribution.

Thank you again for your interest in contributing to this project!