Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/brian-rose/fake-cookbook
A place to experiment with cookbook workflows
https://github.com/brian-rose/fake-cookbook
Last synced: about 4 hours ago
JSON representation
A place to experiment with cookbook workflows
- Host: GitHub
- URL: https://github.com/brian-rose/fake-cookbook
- Owner: brian-rose
- License: apache-2.0
- Created: 2023-06-28T15:22:56.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2023-10-09T04:59:09.000Z (about 1 year ago)
- Last Synced: 2024-06-11T16:43:09.957Z (5 months ago)
- Language: Jupyter Notebook
- Homepage: https://brian-rose.github.io/fake-cookbook/
- Size: 1.85 MB
- Stars: 0
- Watchers: 2
- Forks: 0
- Open Issues: 3
-
Metadata Files:
- Readme: README.md
- License: LICENSE
- Citation: CITATION.cff
Awesome Lists containing this project
README
# A Fake Cookbook
[](https://github.com/brian-rose/fake-cookbook/actions/workflows/nightly-build.yaml)
[](https://binder.projectpythia.org/v2/gh/ProjectPythia/cookbook-template/main?labpath=notebooks)
[](https://zenodo.org/badge/latestdoi/659797688)
This Project Pythia Cookbook covers ... (replace `...` with the main subject of your cookbook ... e.g., _working with radar data in Python_)
## Motivation
(Add a few sentences stating why this cookbook will be useful. What skills will you, "the chef", gain once you have reached the end of the cookbook?)
## Authors
[Brian Rose](https://github.com/brian-rose)
### Contributors
## Structure
(State one or more sections that will comprise the notebook. E.g., _This cookbook is broken up into two main sections - "Foundations" and "Example Workflows."_ Then, describe each section below.)
### Section 1 ( Replace with the title of this section, e.g. "Foundations" )
(Add content for this section, e.g., "The foundational content includes ... ")
### Section 2 ( Replace with the title of this section, e.g. "Example workflows" )
(Add content for this section, e.g., "Example workflows include ... ")
## Running the Notebooks
You can either run the notebook using [Binder](https://binder.projectpythia.org/) or on your local machine.
### Running on Binder
The simplest way to interact with a Jupyter Notebook is through
[Binder](https://binder.projectpythia.org/), which enables the execution of a
[Jupyter Book](https://jupyterbook.org) in the cloud. The details of how this works are not
important for now. All you need to know is how to launch a Pythia
Cookbooks chapter via Binder. Simply navigate your mouse to
the top right corner of the book chapter you are viewing and click
on the rocket ship icon, (see figure below), and be sure to select
“launch Binder”. After a moment you should be presented with a
notebook that you can interact with. I.e. you’ll be able to execute
and even change the example programs. You’ll see that the code cells
have no output at first, until you execute them by pressing
{kbd}`Shift`\+{kbd}`Enter`. Complete details on how to interact with
a live Jupyter notebook are described in [Getting Started with
Jupyter](https://foundations.projectpythia.org/foundations/getting-started-jupyter.html).
### Running on Your Own Machine
If you are interested in running this material locally on your computer, you will need to follow this workflow:
(Replace "cookbook-example" with the title of your cookbooks)
1. Clone the `https://github.com/brian-rose/fake-cookbook` repository:
```bash
git clone https://github.com/ProjectPythia/cookbook-example.git
```
1. Move into the `cookbook-example` directory
```bash
cd cookbook-example
```
1. Create and activate your conda environment from the `environment.yml` file
```bash
conda env create -f environment.yml
conda activate cookbook-example
```
1. Move into the `notebooks` directory and start up Jupyterlab
```bash
cd notebooks/
jupyter lab
```