Please note that some links on the course syllabus page are only accessible to registered students.
Two fundamental rules
- You are responsible for knowing the contents of the syllabus and all of the information about the course provided on Canvas.
- You are responsible for knowing the contents of instructor announcements made on Canvas, which means that you should make sure you receive such announcements and that you check for new ones at least once a day.
When to email?
For all class-wide questions, we encourage you to first post on Ed Discussion if you can't make to an office hour. Only questions of a personal nature or related to your own grade should be emailed to a TA or Instructor. If you are hesitant to ask a question on Ed Discussion, you can always post anonymously and no one including the Instructors will know who posted it :) Remember, there are no stupid questions!
When you email your TA or us (the instructors), you can normally expect a response within 24 hours. You should usually expect your assignments to be graded within five days of the due date. Projects 2 and 8b require more manual grading from the TAs, so they may need one additional day. Some extra time may also be needed to grade the portfolio project, due to its complexity.
Contact Information is in the "Where to go for help?" section of the Syllabus.
Instructor: Luyao Zhang
Instructor: Samarendra Hedaoo
Instructor: Doshna Umma Reddy
Please put the prefix [CS162] in the subject when you send emails to us so we can identify your emails quickly.
- Samarendra Hedaoo (Instructor): firstname.lastname@example.org
- Office hours on Teams/Zoom: Schedule an office hour using the instructions at https://eecs.oregonstate.edu/~hedaoos . I usually pop-in on Teams at random times but you can tag or DM me @hedaoos if required. Please always include [CS162] in your subject line when emailing.
- Luyao Zhang (Instructor): email@example.com
- Doshna Umma Reddy (Instructor): firstname.lastname@example.org
- Every Wednesday 2pm-4pm on teams. If you need to meet outside the office hour timings feel free to email me. Please always include [CS162] in your subject line when emailing.
- Samarendra Hedaoo (Instructor): email@example.com
TA Office hours on Teams and Zoom: To be announced by the end of the week 0. Until then you can post on Ed Discussion.
TA assignments and contact information will be provided in an announcement by the beginning of Week 1.
Ed Discussion (a Q&A forum for help from the instructor and other students)
Teams (a forum for office hours and also for more informal interaction with other students)
Canvas is the LMS (Learning Management System) that you are using right now to view this course. For questions about Canvas, check this list of help topics.
There is a link to Ed Discussion in the left sidebar of Canvas. This ongoing Q&A forum is a valuable resource for getting official answers to your questions (and often helpful student responses also). It's good to use the search box before posting, to see if your question has already been addressed.
Teams is a forum for more informal interaction with your fellow students. It is also where TAs and the Instructors will hold office hours.
You can download and install the desktop or mobile app from here or also use it from the browser.
Here's how we'll use Teams:
- AnnouncementsAll announcements relevant to Teams (e.g. office hour change) will be posted here by the TAs and Instructors.
The landing channel when you first join. This is where office hours will be held and where you can discuss course-related questions with other students.
Random chat among course members (students and teachers)
On Teams you can:
- Create your own channels
For group-work or study-groups you can create your own (private or public) channels!
- Create ad-hoc teleconference sessions
Click the "phone" icon next to the channel title and invite people to join you!
- Engage with the TAs and Instructor during office hours
- Engage with each other
OSU's primary motivation in providing this Teams experience is to give you, the student, a built-in mechanism for building relationships and collaborations among yourselves.
PyCharm is the IDE (Integrated Development Environment) that you will use in this course to develop your assignments. There are a few steps you'll need to follow to get PyCharm set up on your computer:
- Download and install the current version of Python 3, found here.
- Download and install the Community edition of PyCharm, found here.
- Run PyCharm and answer the setup questions (accept the default if you aren't sure). When you reach the welcome screen, click on "Create New Project". You should now see this screen:
- In the "Location" path, replace "untitled" with "greeting". This will be the name of your project.
- Click on the little arrow to the left of "Project Interpreter". You should now see the following:
- Click on "Existing interpreter" and select whatever version of Python 3 you installed. PyCharm will remember this choice as the default for future projects (which is good, since Python 3 is what we'll use throughout the course). [If the Python 3 interpreter you installed doesn't appear, open the Settings/Preferences dialog, select Add. Next select System Interpreter and then select your installation of Python 3.] You should now see this screen:
- Near the top of the left pane, right-click on the project folder ("greeting"), select "New/Python File", and name the new file "greeting.py". In your new document, type the following: print("Hello world.")
- Right-click anywhere on the document and select "Run 'greeting'" (which has a little green triangle icon to its left). This should make "Hello world." print to the output window. Congratulations - you've just created and run a program in Python!
- Click on "Python Console" at the bottom left of your screen. This changes the bottom window from an output window to a console window, where you can use Python commands interactively. Try entering in this window the same print command that you put in your program. Interactive mode is handy for trying out simple things quickly, but for more complex things it's easier to write a program (or "script" as they're often called in interpreted languages such as Python). If you run your program again, the bottom window will switch back to showing the output of your program.
GitHub is a popular web hosting service for Git repositories. Git is a distributed version control system that makes it easy to keep backups of different versions of your code and track changes that are made to it. You'll be using GitHub to host your assignment code. The assignment page in Canvas will contain a GitHub invitation link for each coding project. When you accept that invitation, GitHub will create a repository for you for that project. Your project's repository contains all of your project's files and stores each file's revision history. You can clone these repositories and then commit and push updates to them from within PyCharm. Cloning a repository creates a local copy of it. Committing a change updates your local copy. Pushing a change updates your repository on GitHub.
- Download and install Git.
- In the Settings/Preferences dialog of PyCharm, select Version Control | Git in the left pane and specify the path to the Git executable.
Use PyCharm to clone your repository from GitHub:
- From the welcome screen, choose Checkout from Version Control | Git.
- In the Clone Repository dialog, specify the URL of the remote repository you want to clone (there are detailed steps on the Assignment 1 page). You can click Test to make sure that connection to the remote can be established.
- In the Directory field, specify the path where the folder for your local Git repository will be created into which the remote repository will be cloned (you can use the default path provided).
- Click Clone. To create a PyCharm project based on the sources you have cloned, click Yes in the confirmation dialog.
Use PyCharm to commit and push changes:
- To invoke the Commit Changes dialog, select the files (or an entire changelist) in the Local Changes view (in the Version Control tab in the lower left) and click on the toolbar (or right-click and choose Commit Changes). The Commit Changes dialog lists all files that have been modified since the last commit, and all newly added unversioned files.
- Enter a commit message. You can click to choose from the list of recent commit messages.
- From the Commit drop-down selection choose "Commit and Push". Then in the pane that pops up, confirm the Push.
- From the Commit drop-down selection choose "Commit and Push". Then in the pane that pops up, confirm the Push. Make sure that you commit and push. If you just commit, that will only update your local copy of the repository, not the copy on GitHub. The push is what updates the copy on GitHub.
At the bottom of each assignment page is a link to Gradescope, which will open in a new tab. On Gradescope you'll be able to click a link to submit your projects from GitHub.
Repl.it is the tool that was used to create the interactive exercises in the lessons. The exercises are embedded in the lesson pages in Canvas, but you will need to be logged into Repl.it in order to view them. You'll receive an invitation to join the Repl.it "classroom" around the first day of class.
The syllabus page shows a table-oriented view of the course schedule, and the basics of course grading. You can add any other comments, notes, or thoughts you have about the course structure, course policies or anything else.
To add some comments, click the "Edit" link at the top.