From 28ac518acaa3ad871900196bc613177fbf869e14 Mon Sep 17 00:00:00 2001 From: Facundo Sapienza Date: Sat, 9 Sep 2023 13:52:40 -0700 Subject: [PATCH] add workflow badge --- README.md | 35 ++++++++++++++++++----------------- 1 file changed, 18 insertions(+), 17 deletions(-) diff --git a/README.md b/README.md index f6aa94d..93a087c 100644 --- a/README.md +++ b/README.md @@ -1,14 +1,15 @@ ### ⚠️ New preprint available! ⚠️ -For a detailed description of the project, take a look at [our preprint of a manuscript that is in revision at JGR](https://www.authorea.com/doi/full/10.22541/essoar.168881772.25833701). +For a detailed description of the project, take a look at [our preprint of a manuscript that is in revision at JGR](https://www.authorea.com/doi/full/10.22541/essoar.168881772.25833701). -[![Jupyter Book Badge](https://jupyterbook.org/badge.svg)](https://polarwandering.github.io/PaleoSampling/) [![Binder](https://mybinder.org/badge_logo.svg)](https://mybinder.org/v2/gh/PolarWandering/PaleoSampling/HEAD) [![DOI](https://zenodo.org/badge/595793364.svg)](https://zenodo.org/badge/latestdoi/595793364) [![Licence](https://img.shields.io/github/license/Ileriayo/markdown-badges?style=for-the-badge)](./LICENSE) +[![Jupyter Book Badge](https://jupyterbook.org/badge.svg)](https://polarwandering.github.io/PaleoSampling/) [![Binder](https://mybinder.org/badge_logo.svg)](https://mybinder.org/v2/gh/PolarWandering/PaleoSampling/HEAD) [![DOI](https://zenodo.org/badge/595793364.svg)](https://zenodo.org/badge/latestdoi/595793364) +![GitHub Actions](https://img.shields.io/badge/github%20actions-%232671E5.svg?style=for-the-badge&logo=githubactions&logoColor=white)(.github/workflows/book.yml) [![Licence](https://img.shields.io/github/license/Ileriayo/markdown-badges?style=for-the-badge)](./LICENSE) ## Quantitative Analysis of Paleomagnetic Sampling Strategies This repository contains all the notebooks and code to reproduce the analysis for the different sampling procedures in order -to estimate the precision of different strategies for estimating paleomagnetic poles and paleosecular variation of the magnetic field -based on site magnetizations. +to estimate the precision of different strategies for estimating paleomagnetic poles and paleosecular variation of the magnetic field +based on site magnetizations. You can open a cloud JupyterHub version of all the code in this repository and execute it using the following Binder link: @@ -17,46 +18,46 @@ You can open a cloud JupyterHub version of all the code in this repository and e Learn more about the Binder project in this [link](https://mybinder.readthedocs.io/en/latest/). The notebooks in this repository can be directly been access thought the following JupyterBook. This link opens a website -where all the notebooks can be visualized. +where all the notebooks can be visualized. [![Jupyter Book Badge](https://jupyterbook.org/badge.svg)](https://polarwandering.github.io/PaleoSampling/) ### Organization -This repository includes a series of tools and code organized in different folders: +This repository includes a series of tools and code organized in different folders: - `notebooks`: It includes Jupyter Notebooks with examples of different sampling procedures and the code to parallelize the simulations using Dask (`Parallel.ipynb`). -- `figures`: It includes all the Jupyter Notebooks to generate the figures in the paper. +- `figures`: It includes all the Jupyter Notebooks to generate the figures in the paper. - `outputs`: It includes the simulated data from all the simulations used in the figures in `csv` format. -- `smpsite`: Python package to run simulations and estimate poles and dispersion (see Installation for more information). +- `smpsite`: Python package to run simulations and estimate poles and dispersion (see Installation for more information). -We also provide with an `environment.yml` and `Makefile` for setup of the computational environment used for this project. +We also provide with an `environment.yml` and `Makefile` for setup of the computational environment used for this project. ### Installation -All the notebooks inside this notebook can be executed after properly setting the environmnet. The `environment.yml` file can be used to -install all the required dependencies. Beside some standard Python dependencies, the `environment.yml` file include the installation of -`Pmagpy` using pip and the extra installation of the module `smpsite` (included in this repository). The package `smpsite` includes all the code used to make the simulations and compute the -estimated poles. +All the notebooks inside this notebook can be executed after properly setting the environmnet. The `environment.yml` file can be used to +install all the required dependencies. Beside some standard Python dependencies, the `environment.yml` file include the installation of +`Pmagpy` using pip and the extra installation of the module `smpsite` (included in this repository). The package `smpsite` includes all the code used to make the simulations and compute the +estimated poles. In order to install the environment, you can use conda or mamba (see [Managing Environments](https://conda.io/projects/conda/en/latest/user-guide/tasks/manage-environments.html) for more information) with `conda env create -f environment.yml`. Alternativelly, we included a `Makefile` that allow to create the conda environment and install the associated iPython kernel so this environment can be accessible though Jupyter notebooks all at once. In order to do this, you just need to open a terminal where the repository is located and enter ``` make env ``` -Alternatively, if you just want to install the `smpsite` module, you can clone this repository and do +Alternatively, if you just want to install the `smpsite` module, you can clone this repository and do ``` pip install smpsite ``` -or +or ``` pip install -e smpsite ``` -if you are working in developer mode. +if you are working in developer mode. ### Makefile -The current repository contains a `Makefile` that allows the user to run different routines on the code. You can move in a terminal to the +The current repository contains a `Makefile` that allows the user to run different routines on the code. You can move in a terminal to the path to this repository and use the following commands to trigger their respective actions. - `make env`: Creates the conda environment associated with the `environment.yml` file and then creates the respective iPython kernel such that the environment can be accessed via Jupyter notebooks.