Skip to content

Commit

Permalink
Updated readme for Jan 2023.
Browse files Browse the repository at this point in the history
  • Loading branch information
jtkiley committed Jan 1, 2023
1 parent 745145d commit 474fb31
Showing 1 changed file with 5 additions and 4 deletions.
9 changes: 5 additions & 4 deletions readme.markdown
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
# CARMA Short Course 2022: Introduction to Python for Research
# CARMA Short Course 2023: Introduction to Python for Research

## Overview

Expand Down Expand Up @@ -67,7 +67,7 @@ If you encounter issues, get as far as you can, and we will work through them in

1. On the right (on Github), click "Releases".
1. Find the release for your course (usually at the top), and click the link for "Source code (zip)" under the "Assets" heading to download a zip archive of the course materials. **Note:** this is also where the slides are located (usually uploaded the day before the course begins).
1. Expand the zip archive, which will produce a folder (e.g., `carma_python-1.4.0`) with the course materials inside.
1. Expand the zip archive, which will produce a folder (e.g., `carma_python-1.5.0`) with the course materials inside.
1. Move this folder somewhere easy to find (e.g., your desktop) while the course is ongoing.


Expand All @@ -77,7 +77,8 @@ If you encounter issues, get as far as you can, and we will work through them in
1. (Windows only) The installer has an option labeled, "Add Anaconda to my PATH environment variable." I recommend that you check this option, despite the note that it is not recommended. Among other things, this makes the VS Code integration work better (see below).
1. (experts-only alternative) Install miniconda instead of the GUI version. While there are direct download versions, you would typically use a package manager (e.g., brew on macOS, apt on Ubuntu).

**Note:** If you have a new Apple Silicon Mac, the easiest thing to do is to follow the instructions above, which will install Anaconda using Rosetta 2 (see this [Anaconda blog post](https://www.anaconda.com/blog/apple-silicon-transition)). There is a native version available, though it does not yet have the Anaconda Navigator graphical user interface. That omission is fine once you know your way around, but it's helpful for learning.
**Note:** If you have a new Apple Silicon Mac, the easiest thing to do is to follow the link above, and then click "Get Additional Installers."
Then, choose the one labeled `64-Bit (M1) Graphical Installer`.


### Importing the Anaconda environment
Expand Down Expand Up @@ -112,7 +113,7 @@ You can run the notebook that we will use in the first session as a test of whet
1. The notebook should run quickly, and you should not see errors. Note: the single most common issue with any import errors at the top is that you have not selected the environment in step 3 above. You need to do that before launching Jupyter Lab, and a subsequent change will not affect the already--running Jupyter Lab.


### (optional, but recommended) Install VS Code
### (optional, but highly recommended) Install VS Code

I will generally do walkthroughs using VS Code for notebooks instead of the Jupyter Lab interface.
VS Code is an open-source programming text editor platform, developed principally by Microsoft, that works with many languages (including Python and R), and it has nice built-in Jupyter Notebook support.
Expand Down

0 comments on commit 474fb31

Please sign in to comment.