Howdy!
This is the hub of the Carleton Physics Jupyter workshop. This While many languages can be used via the Jupyter notebook environment, this wiki page contains lots of information to help you get acquainted with Python (via Jupyter) and resources to help you once you get the basics down. Rather than finding a compiler and downloading packages that will work on your computer, this tutorial has you work with Jupyter, a free online compiler. After you find a computer with Jupyter (or install it on your own computer via the instructions linked below), you should begin by looking at and working through the Getting Started with Python Tutorial in this wiki. For lots of information about Jupyter, see jupyter.org. Note that viewing this page from off campus may require use of the campus VPN.
Carleton Python
guidesGuides
Getting started with Python in Jupyter
PDF Instructions / Jupyter Notebook Tutorial Python Code
Math typesetting guide
Text typesetting guide
Citation guide
Font guide
Some Carleton templates
PHYS 228 Lab Writeup
- Overleaf Template
- Template File
- Example ( PDF / Overleaf )
Essay
Physics Comps Paper
Additional resources
There are many excellent LaTeX resources available at Carleton and on the Internet.
LaTeX Wikibook
The LaTeX Wikibook is an excellent (and very thorough!) guide to many features of LaTeX, ranging from the most basic commands to extremely advanced techniques. Highly recommended.
DeTeXify
This site can find the LaTeX command for hand-drawn math symbols. Great when you just can't remember how to make a φ!
TeX Stack Exchange
Stack Exchange is a network of sites where users can ask and answer questions. The TeX-LaTeX Stack Exchange is a great resource for finding answers to both common and esoteric questions—but be careful! Not every answer is good!
A search engine is an invaluable resource for learning any new technology. Not sure how to typeset an integral? Baffled by a cryptic error message? Just Google it!
Your peers
You're not the only one using LaTeX at Carleton! Ask around. Someone has probably already had the same problem you do!Running Jupyter on a computer where it's installed
Starting Jupyter
Mac and Linux: open a terminal window. (In recent Mac OS versions, if a terminal icon is not seen, one can search "terminal" by pressing command-spacebar.) At the prompt, type jupyter notebook and press enter. A new tab in a web browser will open with a file tree and some other options. Click the "new" button, or navigate to a notebook file, which will have the extension .ipynb. After either clicking on an existing .ipynb file or creating a new one, a new tab will open with your notebook. You may be asked to pick a kernal. If you get this dialog, either python 2 or python 3 will serve your initial purpose. Note that although a browser is used as an interface, everything Jupyter related is happening locally on your computer.
Windows 10: click on the start menu and begin typing jupyter, the app should pop up. Click the app. A terminal-like window may appear and you may have to wait a moment. Then a new tab in a web browser will open with a file tree and some other options. Click the "new" button, or navigate to a notebook file, which will have the extension .ipynb. After either clicking on an existing .ipynb file or creating a new one, a new tab will open with your notebook. You may be asked to pick a kernal. If you get this dialog, either python 2 or python 3 will serve your initial purpose. Note that although a browser is used as an interface, everything Jupyter related is happening locally on your computer.
Ending Jupyter
Mac and Linux: close all Jupyter-related windows, then press ctrl-c with the terminal window active.
Windows 10: close all Jupyter-related windows.
When you have a lot of windows running
Even if you close the browser tab where you were developing an ipynb, it will continue to run (listed as running) in the "home" (where the file tree is) Jupyter tab. If you open and close a large number of notebooks, you might want to shut some of them down. This can be done by selecting them in the home tab and clicking the "shutdown" button that will appear after they are selected.
Installing Jupyter
Follow the instructions found here. Note that the anaconda installation is recommend and is easiest, as it installs both anaconda and jupyter at the same time.
External links
...and remember, if you want to do something specific with python (take a natural logarithm, find syntax to create an array of zeros, etc.), or if you have a specific question about Jupyter, an internet search may be the most efficient approach
Questions? Problems with the site? Contact Marty Baylor or Bruce Duffy.