desk_banner_IS115

IS 115 ~ Introduction to Programming

Course Description

This course introduces the student to problem-solving and algorithm development using a modern programming language, such as Python. Students will use popular algorithms as well as crafting their own to create simple applications that will accept user input, process that input, and generate output per assignment specifications.

Prerequisite: Students will need to have basic computer (IS 101) and math (MATH 095, or a satisfactory ACT/SAT/Placement Test score that places the student in MATH 96 or above) skills in order to complete this course.

This course can only be completed on the following platforms: Windows, Mac, Linux.

This Syllabus is subject to change as deemed appropriate
by the instructor with advance notification.


Meeting Times
Section(s): 1007:
3004:
online
web remote 9:30a - 12:20p We
Length: 16 Weeks
18 Jan 2022 -- 15 May 2022
Weekly Contact Hours  (for on-campus sections):
  • 3 total
Weekly Study Hours:
  • On-campus courses
  • 3 hours minimum
  • Off-campus courses
  • 6 hours minimum

You must be registered to take this class.

Instructor Information

Professor: Dr. David Brodersen
Office Location: Henderson C201D
Office Hours:
  • Virtually, using Canvas BBB and Discord
  • Monday -- Thursday, 2 pm - 3:30 pm Pacific
  • Appointments are not limited to the above times
Phone: 702-651-3151
CSN email: david.brodersen@csn.edu
I will reply to emails sent using Canvas email or to my CSN email address, above, within 72 hours. Sometimes Canvas Email doesn't work. If you do not receive a reply within 72 hours, please resend your email to the address above using your student email account. I do not read emails during the weekend. Please use your CSN email address for official communications and make sure to include your name, class, and section number.

Late Instructor Policy: When meeting synchronously (classroom or web-remote), students must wait for 15 minutes if the instructor is late. The class is excused if the instructor is delayed beyond 15 minutes. Check Canvas for updates. The same is true if students are late. If a class is scheduled to meet at 6:00 pm, I will wait until 6:15 pm. If no students show up for the virtual or class meeting by 15 minutes after the start time, I'll close the meeting.


The learning outcomes

By the end of the semester, students who earn a grade of C or better will be able to:

  1. Describe the steps required to perform calculations and to complete tasks.
  2. Translate algorithms into computer programs.
  3. Create programs that process user input and produce output.
  4. Code programs that use appropriate loops and decision structures.
  5. Create programs that read and write files.
  6. Code programs that use array processing.
  7. Use generally accepted principles of good programming style and documentation.
The textbook

Required:

Prelude to Programming – concepts and design, 6th edition. Venit & Drake, Pearson – ISBN: 9780133741636

The software

This course can only be completed on the following platforms: Windows, Mac, Linux.

CSN provides computer labs with any needed software for you to complete your work. However, most students prefer to do their work from home. You may also access the department's Linux server remotely, e.g., from your home.

Most of the software used in the course will be applications that you already have on your computer, such as the Chrome Browser. Below you will find the three major areas that either utilize existing software on your systems or require that you install additional software.


Canvas_Icon.png
Canvas

This class makes use of Canvas, CSN's Learning Management System (LMS). You can access Canvas via the link: https://csn.instructure.com/ using most modern Web browsers. Once you are in Canvas, the verticle blue bar on the left is known as the global navigation menu because it allows you to access areas outside of your course. Just to the right of the global navigation menu is the course navigation links, which provide you with access to the various areas in the course.

Discord_Icon.png
Discord

Discord is an online application for messaging and audio/video communication. If you go to https://support.discord.com, you can view all the information you need for setting up and using discord, which includes downloading discord apps to your desktop and/or mobile devices. We will make extensive use of Discord this semester to provide academic support for software students, such as tutoring or obtaining answers to questions. The invitation link to join our server is https://discord.gg/QeSDuCqV. This link will take you to the #course-request channel. Post your

You should be granted access within 24 hours. If you have any problems with the link to join the server, please let me know.

Raptor_Icon.png
Raptor (Windows Only, Free)

Raptor is a flowcharting tool that will actually run the flowchart as though it’s an actual program. The latest version of Raptor can be downloaded from http://raptor.martincarlisle.com/. Raptor will only run under Windows – Sorry Mac users! To install raptor, download the Windows Setup file by going to: https://raptor.martincarlisle.com/raptor2019.msi. (Download and install like any other windows application.)

Using Raptor on a Mac or Linux OS requires the installation of a Virtual Machine. Online access to Raptor will be provided later.

Python_Icon.png
Pycharm (All Platforms, Free)

For the second half of the semester. Is an Integrated Development Environment where you can better edit and debug your programs. Pycharm was created by Jetbrains. Is best to download and use the Toolbox App to download PyCharm and its future updates. The latest version can be downloaded from https://www.jetbrains.com/pycharm/download. (Should automatically detect your platform)


The Schedule, assignments, and grading

Schedule_Icon.png
Schedule

Week Number Week Beginning Planned Activity
01 Jan 17 (Monday Off) Getting Started
02 Jan 24 Complete Getting Started, Chapter 00 - Introduction
03 Jan 31 Chapter 01 - Intro to Programming
04 Feb 07 Chapter 02 - Data Representation
05 Feb 14 Chapter 03 - Developing a Program
06 Feb 21 (Monday Off) Chapter 04 - Selection Structures
07 Feb 28 Chapter 05 - Repetition Structures
08 Mar 07 Midterm Exam
09 Mar 14 Chapter 06 - Loops and Decisions
10 Mar 21 Chapter 07 - Arrays: Lists and Tables
11 Mar 28 Chapter 07 (cont)
12 Apr 04 Chapter 08 - Searching and Sorting Arrays
13 *** Apr 11 *** Spring Break
14 Apr 18 Chapter 08 Continued
15 Apr 25 Chapter 09 - Functions
16 May 02 Ch 09 Continued
17 May 09 Final Exam
This schedule is tentative and subject to change as deemed appropriate by the instructor with advanced notification. Notification will be provided in class or in canvas.

Important_Dates_2
Important Dates:

Date Event
Jan 17 College Closed, Martin Luther King, Jr. Day
Jan 18 First Day of Instruction for 16-Week Session
Jan 24 Last Day for 100% Refund for 16-Week Session
Last Day to Register by 11:59 P.M. for 16-Week Session
Jan 31 Last Day for 50% Refund for 16-Week Session
Last Day to Drop a class WITHOUT a grade of W for 16-Week Session
Feb 21 Labor Day Holiday (No Classes -- CSN closed)
Mar 04 Last Day to Apply for Spring 2022 Graduation
Mar 25 Last Day to Drop a class WITH a grade of W for 16-Week Session
Last Day to Change from Credit to Audit for 16-Week Session
*** Apr 11 *** Spring Break: April 11 - 17
May 09 Final Exam Week: Due Date is posted in Canvas
May 15 Last Day of Instruction for 16-Week Session
May 18 Grades are Due from Instructors for 16-Week Session

Assignments_Icon.png
Assignments:

All Assignments are scheduled in Canvas. As a general rule, I schedule one quiz, lab, and programming assignment for each chapter. However, some chapters require that I schedule two assignments to avoid making assignments too complicated. Due dates are posted in canvas and are strictly enforced.

Please note: I do not accept late assignments, nor do I provide makeup assignments. It is best to work ahead if you know you are going to have conflicts or time constraints.

Exams are scheduled, but you can expect some unannounced quizzes. If I feel that students are not "getting it," I may add an additional assignment to foster understanding.

Grading_Icon.png
Grading:

If they are available, I will be using TAs to grade your work. The standard used for grading an assignment is called a grading rubric. Complete details on the grading rubric can be accessed by picking the Grading Rubric button on the Canvas Home Page for this course.

How Grades are Determined

I calculate an overall score based on your performance on homework assignments, labs, and assessments. Assessments are scheduled with specific due dates/times. The following weights are applied to determine your course grade:

Metric Weight
Programming assignments 30%
Labs 10%
Quizzes 10%
Midterm Exam 25%
Final Exam 25%
To pass the course with a grade of C or better, you must have a lab score of 70% or better and take both the midterm and final

The Grading Scale

The following scale is used to determine your final grade from the percentage earned in this course.

Letter Grade Overall Score
A 100 to 94%
A- < 94 to 90%
B+ < 90 to 87%
B < 87 to 84%
B- < 84 to 80%
c+ < 80 to 77%
C < 77 to 74%
C- < 74 to 70%
D+ < 70 to 67%
D < 67 to 64%
D- < 64 to 60%
F < 60%
I reserve the right to adjust your final grade up/down based on your attendance, participation, and effort.

Withdrawal Policy

Instructors do not have the option of withdrawing students from a course. The official withdrawal date is available in the calendar for the current semester on the CSN Online Calendar.

You are strongly encouraged to discuss your decisions with an academic counselor, academic adviser or success coach AND Student Financial Services, because these decisions may affect your financial aid and Satisfactory Academic Progress. Students receiving financial aid may find their awards reduced.

If you wish to receive a W in lieu of a grade, you MUST withdraw yourself officially from the class. Once you have withdrawn (dropped), you must discontinue attending class. Alternatively, you may wish to change from Credit to Audit and continue to attend the class.

You will need to complete the Auditing Classes Form if you wish to change to audit. Instructions for submitting the form are included in the instructions at the top of the form.

Attendance_Icon.png
Attendance:

Attendance and participation are mandatory.

Additional information unique to the class or instructor

  1. We are all adults. You can expect me to treat you with courtesy and respect, and I expect the same from you when interacting with your classmates or me.
  2. I like to encourage a casual and friendly atmosphere. In that spirit, feel free to call me David or Dave. A suitable alternative is "Dr. Dave."
  3. I tend to get a little grumpy when I catch students cheating because of the frustration of watching someone do damage to their future employment success.

CSN Standard Syllabus Statements

Important note

If you have any concerns about this course and/or me, please contact me first. Give me at least 72 hours to respond. If I cannot resolve your issue, you are welcome to contact CIT Department Office at 702-651-5976. You will be directed to the appropriate Program Director or the Department Chair who will first ask you if you contacted me and gave me time to respond to your concerns. You will remain anonymous, if possible, and all communications will be strictly confidential. Please DO NOT wait until the last minute to make your concerns known to me and/or to the CIT Department. I have been teaching for nearly 40 years and have had much practice addressing concerns both for myself and other instructors. It is very rare that I am unable to effectively address a concern to the satisfaction of a student.

CIT software lab

The software lab will be virtual and will be available on January 19, 2021. For location/date/time information, please visit https://at.csn.edu/cit-information. Click on Networking and Software Lab Hours.

Counseling & Retention Services

Counselors assist students who are on academic warning/probation/suspension and financial aid warning/suspension. Counselors prepare academic suspension and financial aid appeals. Counselors help students who are having academic challenges and also those who have been referred by their instructors through the MyCoyotePLAN Early Alert program. Counselors connect students to college and community resources and help them evaluate their options to make informed decisions. For more information about Counseling & Retention Services, please visit: https://www.csn.edu/counselingdepartment

References

Safari Tech Books Online, available through the library, offers an excellent source of supplemental resources that you may use for this course.

To find Safari Tech Books Online, go to the library's Web site at: https://library.csn.edu. Click the Databases button. In the A-Z Databases page that appears, click S to filter. The link to Safari Tech Books Online should be at or near the top of the list.

Initially, you will have to enter your CSN student email address, then create an account with Safari Tech Books Online. Subsequently, you will use your email address and your Safari password to access the Safari resources.

Required extra- or co-curricular activities

All activities are based on projects and exams assigned throughout the course. Any required extra activities will be clearly explained in class.

Safety

This class does not have an experiment lab and therefore we will not be concerned about following specific safety strategies.

Additional fees

There are no additional fees for this course.

Excess credit fee information

Please visit https://www.csn.edu/excess-credit-information for information about the excess credit fee applied in certain circumstances.

Title IX resources

More information is available at https://www.csn.edu/institutional-equity.

Objectionable materials

Instructors have the responsibility to set and maintain standards of classroom behavior appropriate to the discipline and method of instruction. No objectionable materials or language will be used during this class. This includes all possible modes of the class: online and in person. The instructor will make the final determination regarding any objectionable materials or language. Students may not engage in activities the instructor deems disruptive or counterproductive to the goals of the class. Instructors have the right to remove offending students from class.

Academic integrity

You are expected to complete your own work in this class. Cheating on exams or lab exercises is not fair to students who are studying honestly. Cheating is also subject to penalties, which can include getting a zero for the assignment or failing the course. The full list of possible penalties is listed in the CSN Student Academic Integrity Policy. Please make yourself familiar with this policy (https://at.csn.edu/documents/student-academic-integrity-policy).

Stay out of trouble by following these rules:

Rule 1: You must not look at solutions or program codes that are not your own.

It is an act of plagiarism to submit work that is copied or derived from the work of others and submitted as your own. For example, using a solution from the Internet or a solution from another student (past or present) or some other source, in part or in whole, that is not your own work is a violation of the Academic Integrity Policy. Many infractions I see make use of solution code found online. The best way to steer clear of this possibility is not to search for online solutions to the programming assignments. Moreover, looking at someone else's solution code in order to determine how to solve the problem yourself is also an infraction of the Academic Integrity Policy. In essence, you should not be looking at someone else's code in order to solve the problems in this class. This is not an appropriate way to "check your work," "get a hint," or "see alternative approaches."

Rule 2: You must not share your solution code with other students.

In particular, you should not ask anyone to give you a copy of their code or, conversely, give your code to another student who asks you for it. Similarly, you should not discuss your algorithmic strategies to such an extent that you and your collaborators end up turning in the same code. Moreover, you are expected to take reasonable measures to maintain the privacy of your solutions. For example, you should not leave copies of your work on public computers nor post your solution code on websites.

Rule 3: You must indicate on your submission any assistance you received.

If you received aid while producing your solution, you should indicate from whom you got help and what help you received. A proper citation should specifically identify the source (e.g., person's name, book title, website URL, etc.) and a clear indication of how this assistance influenced your work (be as specific as possible). For example, you might write "I discussed the approach used for sorting numbers in the sort_numbers function with TA Mary Smith." If you make use of such assistance without giving proper credit, you may be guilty of plagiarism.

It is also important to make sure that the assistance you receive consists of general advice that does not include having someone else write the actual code or show you their code. It is fine to discuss ideas and strategies, but you should be careful to write your programs on your own, as indicated in Rules 1 and 2.

I have no desire to create a climate in which students feel as if they are under suspicion. A key point of the Academic Integrity Policy is that we all benefit from working in an atmosphere of mutual trust. Students who deliberately take advantage of that trust will poison that atmosphere for everyone. I only ask that you be upfront and transparent. If you use a Web resource**, just cite the exact source(s). This becomes part of the formal documentation for your program and a ready reference for yourself in the future:

Just be transparent, please. Sneaky behavior destroys trust really quickly.

Penalties

Incident | Penalty
First: You will receive a zero on the assignment, and I will reduce your final course grade by one full letter grade (e.g., if you would have earned a B+, I will assign a C+ instead).
Second: You will receive a failing grade for the course. The class cannot be dropped to avoid a failing grade.

Disability Resource Center (DRC)

The College of Southern Nevada is committed to making physical facilities and instructional programs accessible to students with disabilities. If you have a disability that may have some impact on your work in this class and for which you may require accommodations, please visit the Disability Resource Center (DRC) so that such accommodations can be considered. All discussions will remain confidential. The Disability Resource Center (DRC) has offices at all three campus locations as the focal point for the coordination of services for students with disabilities. If you have a physical, emotional, or mental disability that “substantially limits one or more major life activities (including walking, seeing, hearing, speaking, breathing, learning and working),” and will require accommodation in this class, please contact the DRC at WC (702) 651-5644, or email at WCDRCStaff@csn.edu at NLV (702) 651-4045, or email at CYDRCStaff@csn.edu and at HNC (702) 651-3795, or email at HCDRCStaff@csn.edu. For Deaf and Hard of Hearing Services contact (702) 651- 4448, or email at Deaf.HH.Services@csn.edu. Students that receive accommodation letters, please meet with me to discuss the provisions of those accommodations as soon as possible.

Counseling and Psychological Services (CAPS)

The Counseling and Psychological Services (CAPS offers short-term, problem-focused counseling to CSN students who may feel overwhelmed by the responsibilities of college, work, family, and relationships. Clinicians are available to help students cope with stresses and personal issues that may interfere with their ability to perform in school. The service is provided confidentially and free to currently enrolled students. To schedule an appointment, please call CAPS at WC (702) 651-5518, at NLV (702) 651-4099, and at HN (702) 651-3099.

Food and Housing Insecurity Support

Any student who has difficulty affording groceries or accessing sufficient food to eat every day, or who lacks a safe and stable place to live, and believes this may affect their performance in the course, is urged to contact Counseling & Psychological Services (CAPS), for a list of resources and support.

Student rights & responsibilities

When you choose to become a student at CSN, you accept the rights and responsibilities of membership in CSN’s academic and social community. You can find policies covering students such as the Student Conduct, Students’ Right to Know, Students’ Academic Integrity, and Disruptive and Abusive Student in the following locations:

CSN Libraries

CSN Libraries provides support for students completing assignments that require research and the use of information. Librarians are available to students for one-on-one assistance locating and citing quality information either online (https://library.csn.edu/ask/) or at one of our campus libraries. Find more information on our website (https://library.csn.edu/).

Public health directives (COVID-19)

Students must follow all active CSN public health directives while enrolled in this class. Properly worn face coverings are mandatory for all faculty and students in the classroom as well as on campus. CSN public health directives are found at https://at.csn.edu/covid-19. Students who do not comply with these directives will be asked to leave the classroom. Refusal to follow the guidelines may result in further disciplinary action according to the CSN Student Conduct Code https://www.csn.edu/sites/default/files/documents/student_conduct_code_policy_1.pdf, including being dropped from the course.

Recording class

You are welcome to record this class.

Centers for Academic Success (CAS)

Centers for Academic Success (CAS) provides quality DROP-IN academic assistance to all students enrolled in for-credit courses at CSN. Tutors are available for most general education courses and some historically challenging courses, such as computer programming courses, math, physics, and chemistry. Academic learning support includes assistance with learning strategies, Canvas, Smarthinking online tutoring, Microsoft Office, reading, writing, oral presentations, math, and science. CAS tutors also provide support to study groups and assistance for placement test preparation. CAS is open Monday through Sunday to be more accessible to all students. Hours for all locations are Monday – Thursday 9:00 am to 6:00 pm and Friday – Sunday 11:00 am to 4:00 pm. You may visit www.csn.edu/centers-academic-success for more details about online and in-person services. You may also contact us at one of our offices: Charleston Centers 702–651–5732, North Las Vegas Learning Commons 702–651–4232, Henderson Learning Commons 702–651–3125.

Early Alert Referral Program

A referral program to connect students with college resources when assistance is needed to achieve success. Referrals may be initiated by faculty and staff as well by students through MyCoyotePLAN. After a referral is submitted, students will receive an email notification and will be contacted by the department to which they were referred to offer assistance.

Disclaimer

Information contained in this syllabus is subject to change with notice. I will make an announcement of any change in class and in the college's learning management system for this course. Please be sure to read class announcements in the learning management system every time you log in. It is your responsibility to stay informed!


Python General Programming Requirements

The general programming assignment requirements differ from the examples provided in the text, in that the text only provides pseudocode. Your submissions must follow the guidelines presented below. That is, the coding standards presented below and specified in your assignments take precedence over all other sources that specify code format and styling.

  1. Limit your code to Python commands that were presented in and before the current chapter of the text, labs, or lectures.

  2. For each lab assignment, you are welcome to work with another student as long as you include his / her name in the header comment as an author. If you do work with another student you must heavily comment your code to make sure that I know you understand the commands.

  3. For each programming assignment, you must work individually unless instructed otherwise. You may discuss the problem with classmates, but at no time should you discuss code in any form. You may not show another student your code, share your file with another student, look at another student's code, or tell another student what to type. Evidence of academic dishonesty will result in a score of zero for all the students involved. If you're unsure about what you can share while working on an assignment, be sure and ask.

  4. Your program must follow the problem statement requirements in the assignment as well as the coding standards below. You will lose points for failing to follow the standards.

    1. A header comment must be included at the top of each submitted file. Submissions without this header comment will receive a grade of zero. Copy the header comment found in https://dbrodersen.net/comments and paste it at beginning of every assignment you create. The header comment consists of the following information. Include any documentation annotations (annotations begin with a colon character (:).

      • Failure to disclose assistance, regardless of source, may be interpreted as academic dishonesty.
    2. Basic blocks:

      1. Blocks will always be indented, otherwise they won't work.
      2. Statements in the block should be indented consistent with logical nesting. Use 4 spaces per indent level. Never use tabs in source code or output.
    3. Variables:

      1. Use descriptive names for variables with naming standards discussed in class.
      2. Reduce the scope of variables so that they are only visible in the scope where they're used. Global variables are never permitted; global constants are permitted, when appropriate.
      3. Use one line of code for each variable declaration. Although the textbook may provide pseudocode examples of declaring multiple variables in one line, it is not permitted in the assignments because doing so limits one's ability to document the purpose of the variable.
      4. Document the purpose of every identifier you create (e.g., constants, variables, functions, etc.).
      5. Variable declarations should appear at the beginning of the block of code in which they're used. Do not intermix declarations with code.
    4. Statements:

      1. No more than one statement may be written on a single line.
      2. The following may not be used: 'exit', continue', 'goto', and 'break' not in a switch structure.
      3. Lines of code should be no more than 80 characters long.
      4. Diagnostic/debug print statements should be disabled or deleted in the final submission.
    5. Functions:

      1. Use descriptive names for functions using naming standards discussed in class.

      2. All functions must be documented using a documentation header with the following information:

        1. Purpose - A statement or a set of statements that describes the purpose of the function.
        2. Parameter(s) - The purpose of each parameter should be described.
        3. Return value - For value-returning functions only, describe what the function returns.
        4. If you need to include a citation, then include 'see'
        5. If you have additional notes, then include 'note'
        6. If you have to add a warning about using the function, then add 'warning'

        Here is an example of a function documentation header will all the options:

      3. Function bodies should not be of extended length when easily separated into multiple functions (i.e., functions should do one thing and nothing more).

      4. Non-recursive functions should contain exactly one return statement. Functions should have one entry point and one exit point (i.e., non-recursive functions should have no more than one return statement).

  5. Programs must be submitted on time. Late programs or programs that do not run will receive no points. Your program must run without any warnings or error messages.

    It is better to submit a partially correct program that compiles than no program at all.

  6. Submit the program file(s) electronically using the procedure shown in the assignment. You may submit your program file(s) as many times as you want before the deadline. Each submission will replace any earlier submission. I can only see and grade your most recent submission. Be careful to submit the correct file. You will not get credit for your work if you accidentally submit the wrong file. Be sure to submit all required files with each submission. You cannot submit any work after the deadline has expired.

Grading Rubric

Limits:

Did you limit your code to commands that were presented in and before the current chapter of the text, labs, or lectures?

Did you use the 'break' command? (hopefully not)

Did you use the 'continue' statement? (hopefully not)

Did you use the 'goto' statement? (hopefully not)

Did you use the 'exit' statement? (hopefully not)

Comments:

Does your code have a properly completed header comment?

Did you cite any sources of code that wasn't your own in the comments?

Did you include the names of anyone who helped you, besides your instructor in the comments?

Did you add comments to your code that describe why the code was included in your program?

Code Blocks:

Did you remember to indent each new code block using 4-spaces?

Did you make sure there are no TAB characters in your code?

Do all your blocks have curly braces around them regardless of the number of lines of code in the block?

Variables:

Did you use descriptive names for variables using naming standards discussed in class?

Did you make sure you don't have any global variables?

Did you reduce the scope of your variables so that they are only visable in the scope where they are used?

Are each of the variables declared on their own line?

Did you declare your variables at the beginning of the block of code in which they're used?

Did you provide a comment for each variable that describes its use?

Statements:

Do you have more than one statement on a single line?

Did you make sure not to use continue, goto, break (unless it's in a switch structure)?

Did you make sure not to use exit?

Did you limit your lines of code to 80 characters?

Did you disable or delete any code that you used to debug your program?

Functions:

Did you use descriptive names for functions using naming standards discussed in class.

Did you place a function documentation header above each function implementation that included the purpose, parameters, what value returning functions were retruning? (Note: large projects need the comments above the function prototypes in the interface files.)

Are your functions small and do they perform a single basic task?

Do your value returning functions have only one return statement and is it at the end of the function.

Submission:

Is your program correctly named?

Does your program compile on the Bellagio Server with no warnings?

Does your program run exactly as specified?

Does your program exactly match the sample output provided in the assignment?

Did you use the correct Linux command with the correct options and arguments to submit your program?


Criteria Ratings Pts
Program Specifications / Correctness 40 pts
Excellent
32 pts
Above Average
24 pts
Average
16 pts
Below Average
0 pts
Not Met
40 pts
Readability 20 pts
Excellent
16 pts
Above Average
12 pts
Average
8 pts
Below Average
0 pts
Not Met
20 pts
Documentation 20 pts
Excellent
16 pts
Above Average
12 pts
Average
8 pts
Below Average
0 pts
Not Met
20 pts
Code Efficiency 10 pts
Excellent
8 pts
Above Average
6 pts
Average
4 pts
Below Average
0 pts
Not Met
10 pts
Miscellaneous 10 pts
Excellent
8 pts
Above Average
6 pts
Average
4 pts
Below Average
0 pts
Not Met
10 pts
Total Points: 100 pts
Documentation: Failing to document your code can result in a 0 for the assignment.
Use of the following commands can result in a 0 for the assignment: 'exit', 'continue', 'goto', and 'break'

Program Specifications / Correctness

This is the most important criterion. A program must meet its specifications (whether from a textbook problem or as written in the assignment) and function correctly. This means that it behaves as desired, producing the correct output for a variety of inputs. (In the beginning, I will be lenient with regards to producing correct output for all inputs, as we may not always have the tools needed to accomplish that, yet.) This criterion includes the need to meet specifications by writing a program in a particular way or using a particular language feature, if such a thing is specified in the problem.

If a specification is ambiguous or unclear, you have two choices: You can either make a reasonable assumption about what is required, based on what makes the most sense to you, or you can ask the instructor. If you make an assumption about an ambiguous specification, you should mention that somewhere in a comment so that the reader/grader knows what you were thinking. Points may be taken off for poor assumptions, however.


Readability

Code needs to be readable to both you and a knowledgeable third party. This involves: Using indentation consistently (e.g.., every function’s body is indented to the same level)

Adding whitespace (blank lines, spaces) where appropriate to help separate distinct parts of the code (e.g.., space after commas in lists, blank lines between functions or between blocks of related lines within functions, etc.) Giving variables meaningful names. Variables named a, b, and c or foo, bar, and baz give the reader no information whatsoever about their purpose or what information they may hold. Names like principal, maximum, and counter are much more useful. Loop variables are a common exception to this idea, and loop variables named i, j, etc. are okay. The code should be well organized. Once we have learned about functions, code should be organized into functions so that blocks of code that need to be reused are contained within functions to enable that, and functions should have meaningful names. This is a concept that we will be learning about as we write more code, and so few points, if any, will be taken off for organization issues that we have not yet addressed.


Documentation

Documentation standards can be found at https://dbrodersen.net/comments.

Every file containing code should start with a header comment:

At the very least, this header should contain the information above. Other details you might include are a more detailed description of the approach used in the code if it is complex or may be misunderstood, or references to resources that you used to help you write it.

All code should also be well-commented. This requires striking a balance between commenting everything, which adds a great deal of unneeded noise to the code, and commenting nothing, in which case the reader of the code (or you, when you come back to it later) has no assistance in understanding the more complex or less obvious sections of code. In general, aim to put a comment on any line of code that you might not understand yourself if you came back to it in a month without having thought about it in the interim. Like code organization, appropriate commenting is also something we will be learning about as we write code throughout the semester, so while corrections may be made, points will only be taken off for things that have been emphasized in class already.

From time-to-time I may ask you to heavily comment your code as part of the assignment. In those cases, you should include more comments than usual that describe why the code is needed to meet assignment specifications.


Code Efficiency

There are often many ways to write a program that meets a particular specification, and several of them are often poor choices. Although you are not expected to write programs that are stellar in terms of efficiency, you are expected to implement the methods discussed in your text. Poor coding choices are indicated by many more lines of code (and thus your effort and time) than needed, or taking much more of the computer's time to execute than needed. For example, a certain section of code can be executed ten times by copying and pasting it ten times in a row rather than putting it in a simple for loop. The latter is far superior and greatly preferred because it is easier to write and maintain.

However, trying to make your code more efficient, does not give you license to implement advanced commands. Keep your attempts to code more efficiently to using commands that have been covered in the labs, lectures, or chapters covered at the moment.

Assignment Specifications

Assignments will usually contain specifications and/or requirements outside of the programming problems themselves, such as:

 

Note: The page you are viewing
is not sanctioned by CSN.