Table of Contents

Corning Community College

CSCS2320 Data Structures

PROJECT: Assorted Beginning Concepts (ABC0)

OBJECTIVE

To get started on the course and semester. Bootstrap your access and configuration of various resources, following instructions, contributing to documentation, and asking questions in the discord.

EDIT

You will want to go here to edit and fill in the various sections of the document:

ABC0

NOTE: this is a collaborative document among ALL my classes this semester. That means more people editing. Be mindful that only one person can edit the document at a time.

Only task headings have been provided. You are not expected to know how to do the task given just that description (although in some cases it can be adequately figured out). Instead, if no further information is yet present, ASK FOR DETAILS on the discord.

If something is missing: add it.

If something is present but needs polish: spruce it up.

If something is present but is incorrect: please fix it.

This is intended to be an informative, useful document that all can benefit from.

Those with prior experience, please be mindful not to gobble up all the low-hanging fruit from the newcomers.

Get on discord and into class channels

If for somehow you made it this far into the CS program yet are not in the lab46 discord, there is a link on the respective class syllabus. Click the link, and you will be transported to the channel. Also, you may have to identify yourself to the admin / class.

Getting an editor

You will need a text editor for class, vim is recommended

On WSL you can install it with:

sudo apt-get update
sudo apt-get upgrade
sudo apt-get install vim

On Arch you can install it with:

sudo pacman -Syu
sudo pacman -S vim

Log into Lab46 (shell)

Change lab46 password
Clone lab46 semester repo on lab46 (fixrepo)

Log into Lab46 wiki

  • If you are reading this, YOU FOUND THE LAB46 WIKI!
  • Click login in the upper right and enter your user name and password
  • Your username is the beginning of your CCC email (i.e jsmith@corning-cc.edu user = jsmith)
  • Your password is your CCC i.d. (i.e. C00######)
Change lab46 wiki password (can be same as lab46)
  • Once logged in click update profile in the upper right and there is a menu to update your password

Set up personal development system

Clone lab46 semester repo on your system
  • On your system of choice, Virtual Machine or Pi, open a terminal
  • Option 1:
    • If on a Pi or Debian based distro the following command should work
wget -q https://lab46.g7n.org/~wedge/piph/download -O piph
bash ./piph
  • Option 2:
    • Not taking the shortcut route, use these two commands
hg clone ssh://USER@lab46.g7n.org//var/repos/hg/user/USER ~/src
hg clone ssh://USER@lab46.g7n.org//var/repos/hg/user/USER/spring2024 ~/src/spring2024
  • Of course replacing USER with your username
Create info.text file with information

Create using touch, vi, echo, nano, etc.

If requirements for this semester's 'info.text' file are the same as past semesters, the file should include the following information: name, email, discord username, and program.

Example format:

  • name: John
  • email: jdoe@corning-cc.edu
  • disord: JohnDoe
  • program: Computer Science
Create, compile, and execute hello.c

Similarly to info.txt, you can need to create a file using a text editor like nano or vim.

Using one of the text editors, create a new file and name it “hello.c”

Within your file write out your C code for hello world

To compile you can use the gcc command with certain flags like this

USER@lab46:~/src/fall2024/DESIG$ gcc -Wall -std=gnu18 -o "OUTPUTFILE" INPUTFILE 

where INPUTFILE is your uncompiled code, and OUTPUTFILE is your compiled code

Once you have compiled your code you can execute it with ./OUTPUTFILE

Add, Commit, Push changes to repo

In order to move files between Lab46 and your personal computer you can do this by doing hg add, hg commit and hg push and pull. Using hg add will start tracking files. Using hg commit will commit those files and save them (hg commit -m “put commit message here”) and doing hg push will push them out to the other destination where you want to access them. After using hg push make sure to go the destination and use hg pull to get access to the updated files.

Pull and Update project changes on Lab46

Submit project files on lab46

submitting files on lab46 uses the submit command

USER@lab46:~/src/fall2024/DESIG$ submit DESIG PROJECT FILE1 FILE2 FILE3 ...

sub in the class you are taking in place of DESIG, the project you are submitting in place of PROJECT, in this case abc0, and the files you are submitting in place of FILE, in this case your C code and info.txt file. For example, if you were in data submitting abc0:

USER@lab46:~/src/fall/2024/data/abc0$ submit data abc0 helloworld.c info.txt

Customize journal title and intro, edit week1 entry

Each classmate has their own journal that you can see and read, Giving an intro helps introduce yourself. shocking, I know. This is also a great place to be creative and experiment with the text editor. Have fun!

Completing the weekly journal earns you points towards your grade, as well as getting you in the mindset of documenting progress.

Class notes

Class Notes 8/27 Data/Discrete

Preamble:


-Your soul is now on fire!

-Brief history lesson on tables

-Discussed AI policies, don't do it

-Opening projects: abc0 and btt0, do it

-Next due project, making space invaders (msi0 and after that msi1)

-First four pct's are available as of writing. 0 and 1 are due end of tomorrow.

-Journals / Class documents available

Class Discussion:


msi0 - using malloc'ed ARRAYS of structs, make space invaders. On the screen, the player at the bottom will shoot enemies at the top of the screen. They in the form of a grid, all aligned evenly, and if the player's bolt hits the enemy, they should go away with the bolt. The enemies march to one side of the screen and move down a row. The enemies should also shoot back. The player should die and cause a game over when the enemies either hit the player head-on or if their bolt hits the enemy. Consider have a score count on screen. Other bonus features are optional, like shields or powerups.

In your struct for sprites (sprites being the things on screen), consider an X and Y for each on screen.

*Key instruction, how to form arrays with pointers: Sprite *array = NULL; array = (Sprite *)malloc(sizeof(sprite) * 15);

msi1 - the same project, but converting msi0 to use a linked list instead of an array, possibly the conversation for Thursday 8/29

Matt's class will make you think so hard, it'll make you physically ill!

 

SUBMISSION

To be successful in this project, the following criteria (or their equivalent) must be met:

Submit Tool Usage

Let's say you have completed work on the project, and are ready to submit, you would do the following:

lab46:~/src/SEMESTER/DESIG/PROJECT$ submit DESIG PROJECT file1 file2 file3 ... fileN

You should get some sort of confirmation indicating successful submission if all went according to plan. If not, check for typos and or locational mismatches.

RUBRIC

I'll be evaluating the project based on the following criteria:

13:abc0:final tally of results (13/13)
*:abc0:submitted information for project by duedate [3/3]
*:abc0:got situated in and used class discord [3/3]
*:abc0:contributed to project documentation [1/1]
*:abc0:committed project related changes to semester repo [3/3]
*:abc0:logged into lab46 via SSH [3/3]

Pertaining to the collaborative authoring of project documentation

Additionally