Helpers:
Elian Eve Jentoft, Erik Holten, Erik Winge
General Information
The Carpentries project comprises the Software Carpentry, Data Carpentry, and
Library Carpentry communities of Instructors, Trainers, Maintainers,
helpers, and supporters who share a mission to teach foundational computational and data science
skills to researchers.
Want to learn more and stay engaged with The Carpentries? Carpentries Clippings is The Carpentries' biweekly newsletter, where we share community news, community job postings, and more.
Sign up to receive future editions and read our full archive: https://carpentries.org/newsletter/
Software Carpentry
aims to help researchers get their work done
in less time and with less pain
by teaching them basic research computing skills.
This hands-on workshop will cover basic concepts and tools,
including program design, version control, data management,
and task automation.
Participants will be encouraged to help one another
and to apply what they have learned to their own research problems.
Who:
The course is aimed at graduate students and other researchers.
You don't need to have any previous knowledge of the tools
that will be presented at the workshop.
Where:
DSC Oasen, Georg Sverdrups Hus, Moltke Moes vei 39, Oslo, Norway .
Get directions with
OpenStreetMap
or
Google Maps.
Requirements:
Participants must bring a laptop with a
Mac, Linux, or Windows operating system (not a tablet, Chromebook, etc.) that they have administrative privileges on.
They should have a few specific software packages installed (listed below).
Accessibility:
We are committed to making this workshop
accessible to everybody.
The workshop organizers have checked that:
The room is wheelchair / scooter accessible.
Accessible restrooms are available.
We are dedicated to providing a positive and accessible learning environment for all.
We do not require participants to provide documentation of disabilities or disclose any unnecessary personal information.
However, we do want to help create an inclusive, accessible experience for all participants.
We encourage you to share any information that would be helpful to make your Carpentries experience accessible.
To request an accommodation for this workshop, please fill out the
accommodation request form.
If you have questions or need assistance with the accommodation form please email us.
Glosario is a multilingual glossary
for computing and data science terms. The glossary helps
learners attend workshops and use our lessons to make sense of computational and programming jargon written in English by offering it
in their native language. Translating data science terms also provides a teaching tool for Carpentries Instructors to reduce barriers
for their learners.
Workshop Recordings:
Carpentries workshops are designed to be interactive rather than lecture-based, with lessons that build upon one another.
To foster a positive online learning environment, we strongly recommend that participants join in real time.
As a result, workshop recordings are not recommended and may not be available to learners.
Roles:
To learn more about the roles at the workshop (who will be doing what),
refer to our Workshop FAQ.
Code of Conduct
Everyone who participates in Carpentries activities is required to conform to the Code of Conduct. This document also outlines how to report an incident if needed.
Surveys
Please be sure to complete these surveys before and after the workshop.
To participate in a
Software Carpentry
workshop,
you will need access to software as described below.
In addition, you will need an up-to-date web browser.
If you have used Windows Subsystem for Linux ("WSL2") please open your Ubuntu bash terminal and follow the Linux instructions for each of the software packages below.
If not, please follow the Windows instructions.
Python
Python is a popular language for
research computing, and great for general-purpose programming as
well. Installing all of its research packages individually can be
a bit difficult, so we recommend
Conda-forge,
an all-in-one installer.
Regardless of how you choose to install it,
please make sure you install a Python version >= 3.9
(e.g. 3.11 is fine, 3.6 is not).
We will teach Python using the Jupyter Notebook,
a programming environment that runs in a web browser (Jupyter Notebook will be installed by Miniforge). For this to work you will need a reasonably
up-to-date browser. The current versions of the Chrome, Safari and
Firefox browsers are all
supported
(some older browsers, including Internet Explorer version 9
and below, are not).
OneDrive is used by many institutions to sync your user folder (C:\Users\[your-username]\) within an organisation.
It may cause issues with the installation of the Carpentries environment.
If you have OneDrive set up, please ensure that you can access your C:\Users\[your-username]\Downloads folder:
Open File Explorer
Right click on the "Downloads" folder in the left-hand navigation pane
Select "Properties"
In the "Location" tab, ensure that the path is set to C:\Users\[your-username]\Downloads
If you encounter problems, please contact your IT support team and workshop organisers for assistance before the workshop.
Save the file to your C:\Users\[your-username]\Downloads folder.
Make sure that the filename is carpentries_environment.yml and the "Save as type" option is set to YML file (*.yml) The following steps requires using the Miniforge Prompt command line. If you aren't comfortable doing the installation yourself stop here and request help at the workshop.
Open your Start Menu from your taskbar, or use the Win Windows key.
Search for the application "Miniforge Prompt", and click the icon to open it.
Once open, ensure the prompt shows your C:\Users\[your-username] folder. If it does, continue to Step 8 below:
In this case, the prompt shows C:\Users\froggleston. Your username will be different!
If it doesn't:
Find your username by typing whoami and press Enter
Your username will be shown as [machine-name]\[your-username]. You only need the [your-username] part after the slash, i.e. froggleston in this example.
Type cd C:\Users\[your-username] and press Enter
Continue to Step 8 below
If you get stuck, please contact your workshop organisers to get assistance before the workshop starts.
In the Miniforge Prompt window, run the following commands:
Type cd Downloads and press Enter
Type conda env create -f carpentries_environment.yml and press Enter
The installation may take a few minutes depending on your internet connection speed. Once complete, you can close the Miniforge Prompt window.
Download the appropriate Miniforge installer for macOS The following steps require using the shell. If you aren't comfortable doing the installation yourself stop here and request help at the workshop.
Open a terminal window and navigate to the directory where the executable is downloaded (e.g., cd ~/Downloads).
Type
bash Miniforge3-
and then press Tab to autocomplete the full file name.
The name of file you just downloaded should appear.
Press Enter (or Return depending on your keyboard).
Follow the text-only prompts in the terminal. To move through the text, press Spacebar.
Type yes and press Enter (or Return) to approve the license.
Press Enter (or Return) to approve the default location for the files.
Type yes and press Enter (or Return) to prepend Miniforge to your PATH (this makes the Miniforge distribution the default Python).
Download the appropriate Miniforge installer for Linux The following steps require using the shell. If you aren't comfortable doing the installation yourself stop here and request help at the workshop.
Open a terminal window and navigate to the directory where the executable is downloaded (e.g., cd ~/Downloads).
Type
bash Miniforge3-
and then press Tab to autocomplete the full file name.
The name of file you just downloaded should appear.
Press Enter (or Return depending on your keyboard).
Follow the text-only prompts in the terminal.
To move through the text, press Spacebar.
Type yes and press Enter (or Return) to approve the license.
Press Enter (or Return) to approve the default location for the files.
Type yes and press Enter (or Return) to prepend Miniforge to your PATH (this makes the Miniforge distribution the default Python).
![Miniforge Prompt [your-username] as froggleston](assets/img/miniforge_prompt.png)
