Skip to content

Commit

Permalink
add using
Browse files Browse the repository at this point in the history
  • Loading branch information
zingale committed Jan 21, 2024
1 parent cf290e0 commit ed9b9e2
Show file tree
Hide file tree
Showing 3 changed files with 51 additions and 23 deletions.
28 changes: 5 additions & 23 deletions content/01-python/installing.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,6 +3,11 @@
This class will introduce the basics of the python programming
language and the libraries used for scientific computing.

```{tip}
To get th most from this class, you should work on your own laptop. That
way you practice using python and the scientific libraries on the in the
environment you are most comfortable with.
```

## Getting python

Expand Down Expand Up @@ -32,26 +37,3 @@ print("hello, world")
```


## Following along in class

All of the class notes are hosted as Jupyter notebooks on github:

https://github.com/sbu-python-class/python-science

these are rendered by [Jupyter
book](https://jupyterbook.org/intro.html) into a webpage that allows
you to see the rendered notebooks as well as launch the notebooks in
the cloud:

http://sbu-python-class.github.io/python-science/Introduction.html

````{note}
Some notebooks use [MyST Markdown](https://jupyterbook.org/en/stable/content/myst.html) to
allow for more styling. To see these styles, you need to install `jupyterlab-myst`, which
can be done via:
```
pip install jupyterlab_myst
```
````

45 changes: 45 additions & 0 deletions content/01-python/using.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,45 @@
# Using These Notes

These notes are built via [Jupyter book](https://jupyterbook.org/), as
a collection of [Jupyter](https://jupyter.org/) notebooks and markdown
pages.

The course is on Github at:
https://github.com/sbu-python-class/python-science, and the course
website is built automatically via a Github action each time a change
is pushed.

If you find any problems or have suggestions for improving the notes,
feel free to create an issue or pull request at the Github repo.

## Interactive Usage

For the Jupyter notebooks in this collection, there are a few ways to
access them to run them on your own.

* clicking on the {octicon}`download` icon in the upper right let's
you download the raw notebook so you can run it on your local
computer.

* clicking on the {octicon}`rocket` icon in the upper right will allow
you to run the notebook directly in the cloud. There are 2 different
compute clouds:

* [mybinder](https://mybinder.org/) : this is an open project with
ties to the Jupyter project. It can take a few minutes for the
page to appear if it hasn't been accessed recently, but then it
will give you the standard Jupyter experience.

* [Google colab](https://colab.research.google.com/) : this is
Google's version of an online notebook, which runs directly in
Google's cloud. This starts up almost instantly.

````{note}
Some notebooks use [MyST Markdown](https://jupyterbook.org/en/stable/content/myst.html) to
allow for more styling. To see these styles, you need to install `jupyterlab-myst`, which
can be done via:
```
pip install jupyterlab_myst
```
````
1 change: 1 addition & 0 deletions content/_toc.yml
Original file line number Diff line number Diff line change
Expand Up @@ -4,6 +4,7 @@ parts:
- caption: Getting Started
chapters:
- file: 01-python/installing
- file: 01-python/using
- file: 01-python/w1-jupyter.ipynb

- caption: Python Basics
Expand Down

0 comments on commit ed9b9e2

Please sign in to comment.