Please note that some links on the course syllabus page are only accessible to registered students.
Instructor: Luyao Zhang
Instructor: Samarendra Hedaoo
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 Slack/Zoom: By appointment. Choose a time slot from on https://tinyurl.com/samarendra-office-hours or email me any 4 time slots that work for you. You can also tag or DM me @hedaoos on Slack if you have a question.
- Luyao Zhang (Instructor): email@example.com
Office hours on Slack: To be announced by the end of the week 1. Until then you can post on Piazza.
TA assignments and contact information will be provided in an announcement by the end of Week 1 too.
Piazza (a Q&A forum for help from the instructor and other students)
Slack (a forum for more informal interaction with other students, and also for office hours)
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 Piazza 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.
Slack is a forum for more informal interaction with your fellow students. It is also where TAs and I will hold office hours. Please connect to the Workspace (oregonstate.enterprise.slack.com) - this is the central connection point for all OSU-oriented slack workspaces. You should then select the "Sign in with ONID" and be able to connect.
Here's how we'll use the Class Slack Workspace:
The landing channel when you first join. We will use this for announcements specific to Slack.
Random chat among course members (students and teachers). Bring your own memes here!
#general (You will have to join this channel manually to really get anything out of Slack)
Class-specific discussions, office hours, etc.
On Slack 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 Slack 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:
lick the icon and select
- 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.