CMSE 201 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 for this course#
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” to skip the providing your email step. Then click the “Download” button.
Make sure you are dowloading the installer for the appropriate operating system (Windows | macOS | Linux) for your computer (it may auto-detect the correct operating system).
Download the Python 3.12 version (64 bit recommended).
Follow the online documentation to install Python for your specific operating system: https://docs.anaconda.com/anaconda/install/
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. We believe that this will provide an excellent avenue to have discussions not only with course instructors, TAs, and LAs, but also between you and your fellow classmates. In order to join the Teams group that we’ve created for the course you should complete the following steps:
Visit this link
Once there, sign up using your @msu.edu email address.
Once you’ve joined the CMSE Courses Teams, make sure to find the appropriate “help” and section-specific channels for this course. The details for these channel names can be found on the front page of this website. You should be able to find these channels in your list of channels once you’ve joined and you should make sure you follow discussions in the channels relevant for the course and your corresponding section number. Some channels may initially be “hidden” and you will need to “show” them to see them in your list. You may also wish to hide the channels that aren’t relevant to you.
The “help” channel will be the place to go for any questions about assignments in the course or issues you’re having with your computer or Python. We encourage you to help out other classmates when you can! The section-specific channel will be used by your instructor for important messages relevant only to your section of the course.
Teams usage rules#
In order to ensure that Teams is an appropriately used tool that does not become overly time-consuming for the course instructors, TAs, or LAs, we have a list of rules for how we expect you to use Teams. They are:
Before you ask a question, be sure to check the main help channel and other section channels to see if the question has already been answered.
The Teams group is primarily for you, the students, so help each other.
The TAs and LAs will monitor the channels, but will defer to the students to work through things. They will only enter a conversation if students are going down the wrong path and/or there are too few other students involved. However, you should not expect that the TAs or LAs will always be available. The TAs and LAs will spend a limited amount of time “logged in” to Teams and we ask that you be respectful of their time.
Teams is meant to be used to help you when you are stuck with a minor issue. If you are having major issues or trouble understanding the concept, go to office hours or help room hours as they are meant for more in-depth discussions of course content.
Course instructors will rarely check Teams, only to examine progress. While they may offer help, do not rely on it. Instructors will not respond to the same student twice within a 30 minute time interval.
Only in rare cases should you contact an instructor through a private channel. But, if you are struggling, feel free to use this option.
Do not post your solutions to out-of-class assignments directly into Teams unless prompted by an instructor.
Be courteous to everyone on Teams. Students who are being rude or who are excessively posting might be banned from posting on the course Teams channel.
MSU’s JupyterHub Interface (a backup option if things fail on your computer)#
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 on the class website (https://cmse.msu.edu/cmse201) and downloaded using the Download button in the top right. Be sure to download them in .pynb 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:#
If your notebook needs to be turned in (e.g. Pre-class assignments, Homeworks and Exams), 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.