Skip to content

Commit 0802a9e

Browse files
committed
markdown source builds
Auto-generated via `{sandpaper}` Source : 8e0f690 Branch : main Author : Ben Companjen <ben@companjen.name> Time : 2025-04-01 09:40:14 +0000 Message : Merge pull request #66 from datacarpentry/update/packages Update 4 packages
1 parent 8b4a064 commit 0802a9e

5 files changed

Lines changed: 1171 additions & 69 deletions

File tree

config.yaml

Lines changed: 82 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,82 @@
1+
#------------------------------------------------------------
2+
# Values for this lesson.
3+
#------------------------------------------------------------
4+
5+
# Which carpentry is this (swc, dc, lc, or cp)?
6+
# swc: Software Carpentry
7+
# dc: Data Carpentry
8+
# lc: Library Carpentry
9+
# cp: Carpentries (to use for instructor training for instance)
10+
# incubator: The Carpentries Incubator
11+
carpentry: 'dc'
12+
13+
# Overall title for pages.
14+
title: 'Social Science Workshop Overview'
15+
16+
# Date the lesson was created (YYYY-MM-DD, this is empty by default)
17+
created: '2017-05-25'
18+
19+
# Comma-separated list of keywords for the lesson
20+
keywords: 'software, data, lesson, The Carpentries' # FIXME
21+
22+
# Life cycle stage of the lesson
23+
# possible values: pre-alpha, alpha, beta, stable
24+
life_cycle: 'stable'
25+
26+
# License of the lesson
27+
license: 'CC-BY 4.0'
28+
29+
# Link to the source repository for this lesson
30+
source: 'https://github.com/datacarpentry/socialsci-workshop'
31+
32+
# Default branch of your lesson
33+
branch: 'main'
34+
35+
# Who to contact if there are any issues
36+
contact: 'team@carpentries.org'
37+
38+
# Navigation ------------------------------------------------
39+
#
40+
# Use the following menu items to specify the order of
41+
# individual pages in each dropdown section. Leave blank to
42+
# include all pages in the folder.
43+
#
44+
# Example -------------
45+
#
46+
# episodes:
47+
# - introduction.md
48+
# - first-steps.md
49+
#
50+
# learners:
51+
# - setup.md
52+
#
53+
# instructors:
54+
# - instructor-notes.md
55+
#
56+
# profiles:
57+
# - one-learner.md
58+
# - another-learner.md
59+
60+
# Order of episodes in your lesson
61+
episodes:
62+
- introduction.Rmd
63+
64+
# Information for Learners
65+
learners:
66+
67+
# Information for Instructors
68+
instructors:
69+
70+
# Learner Profiles
71+
profiles:
72+
73+
# Customisation ---------------------------------------------
74+
#
75+
# This space below is where custom yaml items (e.g. pinning
76+
# sandpaper and varnish versions) should live
77+
78+
79+
url: 'https://datacarpentry.github.io/socialsci-workshop'
80+
analytics: 'carpentries'
81+
lang: 'en'
82+
overview: true

files/setup-python.md

Lines changed: 45 additions & 34 deletions
Original file line numberDiff line numberDiff line change
@@ -4,58 +4,69 @@
44

55
### Python and Jupyter Notebooks
66

7-
[Python](https://python.org) is a popular language for scientific computing, and great for general-purpose programming as well.
8-
For this workshop we use Python version 3.x.
9-
Installing all of its scientific packages individually can be a bit difficult, so we provide an environment file to help you take care of them all together.
10-
We will use the _Miniforge_ distribution of Python.
7+
- [Python](https://python.org) is a popular language for
8+
scientific computing, and great for general-purpose programming as
9+
well. For this workshop we use Python version 3.x.
10+
Installing all of its scientific packages individually can be
11+
a bit difficult, so we recommend an all-in-one installer.
12+
We will use Anaconda or Miniconda.
13+
They both use [Conda](https://conda.io/en/latest/), the main difference is
14+
that Anaconda comes with a lot of packages pre-installed.
15+
With Miniconda you will need to install the required packages.
16+
We recommend using the Anaconda installation instructions.
17+
18+
:::::::::::::::: spoiler
19+
20+
## Anaconda installation
21+
22+
Download and install [Anaconda](https://www.anaconda.com/distribution/#download-section).
23+
Remember to choose the installer for Python 3.x.
24+
Anaconda does not include the plotting package plotnine. To install this package, open your terminal application and
25+
type:
1126

12-
Please refer to the [Python section of the workshop website for installation instructions](https://carpentries.github.io/workshop-template/install_instructions/#python).
27+
```bash
28+
conda install -c conda-forge plotnine
29+
```
1330

14-
#### Launching Jupyter
31+
:::::::::::::::::::::::::
1532

16-
:::::::::::::::::::::::::::::::::::::::::: spoiler
33+
:::::::::::::::: spoiler
1734

18-
##### Windows
35+
## Miniconda installation
1936

20-
After following the instructions above, search for the application 'Miniforge Prompt' and open it.
21-
Type the following commands, pressing <kbd>Enter</kbd> after each one:
37+
Miniconda is a "light" version of Anaconda. If you install and use Miniconda
38+
you will also need to install the workshop packages.
2239

23-
```bash
24-
conda activate carpentries
25-
jupyter notebook
26-
```
27-
28-
::::::::::::::::::::::::::::::::::::::::::::::::::
40+
Download and install [Miniconda](https://docs.conda.io/en/latest/miniconda.html)
41+
following the instructions. Remember to choose the installer for
42+
Python 3.x.
2943

30-
:::::::::::::::::::::::::::::::::::::::::: spoiler
44+
From your terminal application, type:
3145

32-
##### MacOS
46+
```bash
47+
conda list
48+
```
3349

34-
After following the instructions above, open the Terminal application (inside Applications/Utilities).
35-
Type the following commands, pressing <kbd>Enter</kbd> after each one:
50+
To install the packages we'll be using in the workshop, type:
3651

3752
```bash
38-
conda activate carpentries
39-
jupyter notebook
53+
conda install -y numpy pandas matplotlib jupyter
54+
conda install -c conda-forge plotnine
4055
```
41-
::::::::::::::::::::::::::::::::::::::::::::::::::
42-
43-
:::::::::::::::::::::::::::::::::::::::::: spoiler
4456

45-
##### Linux
57+
:::::::::::::::::::::::::
4658

47-
After following the instructions above, search for the application 'Miniforge Prompt' and open it.
48-
Type the following commands, pressing <kbd>Enter</kbd> after each one:
59+
After installing either Anaconda or Miniconda and the workshop packages,
60+
launch a Jupyter notebook by typing this command from the terminal:
4961

5062
```bash
51-
conda activate carpentries
5263
jupyter notebook
5364
```
5465

55-
::::::::::::::::::::::::::::::::::::::::::::::::::
56-
57-
The notebook should open automatically in your browser.
58-
If it does not or you wish to use a different browser, open this link: [http://localhost:8888](https://localhost:8888).
66+
The notebook should open automatically in your browser. If it does not or you
67+
wish to use a different browser, open this link: [http://localhost:8888](https://localhost:8888).
5968

6069
For a brief introduction to Jupyter Notebooks, please consult our
61-
[Introduction to Jupyter Notebooks](https://datacarpentry.org/python-ecology-lesson/jupyter_notebooks/) page.
70+
[Introduction to Jupyter Notebooks](https://datacarpentry.org/python-ecology-lesson/jupyter_notebooks) page.
71+
72+

md5sum.txt

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@
33
"LICENSE.md" "9d622b076c6b30147b938bca87261e63" "site/built/LICENSE.md" "2025-04-01"
44
"config.yaml" "b36da743462bb121d2ee6cf971df29e7" "site/built/config.yaml" "2025-04-01"
55
"index.md" "f351c7df9717e28e0423a6aa2bb9c3eb" "site/built/index.md" "2025-04-01"
6-
"setup-python-workshop.Rmd" "d344a34485b192e4f577e2cb28e88f6b" "site/built/setup-python-workshop.md" "2025-04-01"
6+
"setup-python-workshop.Rmd" "c3a2be3d4c8c10528c9491900e33ee81" "site/built/setup-python-workshop.md" "2025-04-01"
77
"setup-r-workshop.Rmd" "c23b6dad11ac5be31cb23d9024071567" "site/built/setup-r-workshop.md" "2025-04-01"
88
"instructors/instructor-notes.md" "468465e1b56a50166605f81d9ed5314e" "site/built/instructor-notes.md" "2025-04-01"
99
"learners/data.md" "97b5977eefc34fa0201e207ff91b2c1e" "site/built/data.md" "2025-04-01"

0 commit comments

Comments
 (0)