Software Setup Guide#
As this is a course in computational modeling and data science, you will be completing all of your assignments using your computer! However, in order to do so there are a number of things you need to set up before the course starts.
MAKE SURE TO COMPLETE ALL OF THE SECTIONS LISTED IN THIS DOCUMENT BEFORE YOU COME TO CLASS
Getting Zoom#
Although the course will be conducted in person, the video conferencing software Zoom will be used for virtual office hours, so it is critical to have access to this platform. First, you should download the software, which you can do by going here: https://msu.zoom.us/support/download.
Once you have the software on your computer, you can link it to your MSU account by following the steps laid out here
Installing Python#
Follow the instructions below to get the Anaconda distribution of Python installed on your computer. Even if you already have a version of Python installed on your machine, we encourage you to go through this installation process as the assignments will assume that you are working with the same versions of the Anaconda Python packages that the instructors are using. If you already specifically have Anaconda installed, we encourage you to update all of the Python packages (you may need to look up how to do this).
Instructions for downloading Anaconda (Python 3.12.x):#
Go to the Anaconda Download webpage: https://www.anaconda.com/download/
Click “Skip Registration” on the right side to skip providing your email.
Ensure the page is on the correct tab for your operating system (Windows | macOS | Linux) for your computer, though it should auto-detect the correct operating system.
In the “Anaconda Distribution” section, click the link just below “Graphical Installer” to download the installation file.
Go to your downloads and run the installation file. If you have issues, follow the installation guide provided by Anaconda, here: https://docs.anaconda.com/anaconda/install/
Once installed, open the Anaconda Navigator program on your computer.
Select the tile labeled “Jupyter Notebook” and click “Launch.”
If everything goes correctly, a browser window should open up with the Jupyter interface running. If things don’t work, don’t worry, we will help you get started.
Course Communication with Teams#
We will be using Teams (http://teams.microsoft.com) as our means of communicating outside of scheduled class times about course content as the semester progresses and you are expected to monitor Teams regularly. See the Syllabus for more info.
Backup Option: MSU’s JupyterHub Interface#
From time to time, you might run into issues with your computer. When this happens, you can use the web-hosted JupyterHub server managed by MSU. It creates a virtual environment that allows you to run simple commands and host Jupyter notebooks. To make sure that you have access to this backup option, follow the directions below. Note that there are extra steps involved that require that you to upload your Jupyter notebooks to JupyterHub, as well as to download them (in the case of Homework assignments) in order to turn them in on D2L.
This service should only be used as a temporary fix if Jupyter stops working on your computer. To make sure that you have access to this backup option, follow the directions below. Note that there are extra steps involved that require that you upload and download your Jupyter notebooks to and from JupyterHub in order to turn them in on D2L. Again, this option is meant to be used as a backup to your local Python installation and requires and internet connection to use. It will often be easier to run things locally on your computer.
Instructions for connecting to the engineering JupyterHub server:#
Every student enrolled in this class will be given an engineering computing account. If this is your first time using your Engineering account you will need to activate the account by going to the following website:
https://www.egr.msu.edu/decs/myaccount/?page=activate
Once your account is activated you can access the classroom JupyterHub server using the following instructions:
Open up a web browser and go to the following URL: https://jupyterhub.egr.msu.edu
Type your engineering login name. This will be your MSU NetID.
Type your engineering password.
If everything is working properly you will see the main “Files” windows in the Jupyter interface.
If you ever end up working on your assignments using JupyterHub, the remaining directions should serve as a reference for how you can go about uploading and downloading Jupyter notebooks and turning them in.
Instructions for getting Jupyter notebook files onto JupyterHub:#
Jupyter notebooks are files that end with the .ipynb extension. These files can be found here on the course website (https://cmse.msu.edu/cmse201) and downloaded using the Download button in the top right. Be sure to download them in .ipynb format!
Once you have an ipynb file you can load it into Jupyter using the “upload” button on the main “Files” tab in the Jupyter web interface. Hitting this button will cause a file browser window to open. Just navigate to your ipynb file, select it and hit the open button.
Once you see your filename in the jupyter window you can just click on that name to start using that file.
Instructions for making a copy of Jupyter notebooks from JupyterHub and turning them in:#
To turn your notebook in, you will need to download the ipynb file from the JupyterHub interface.
With the notebook file open in Jupyter, go to the “File” menu, select the “Download as” menu option and then choose “iPython Notebook (.ipynb)”
Pick a place to save the file (The desktop is a good choice).
Make sure you make a copy of the .ipynb file for your own records.
Go to the Desire 2 Learn (http://d2l.msu.edu) class site and upload the .ipynb file into the assignment folder.