ENGRI 1101 Labs

NOTE: This repo was transferred from Cornell's GitHub in July 2022. For more details on the transfer, see bfg_report.

This repo serves as the standard for ENGRI 1101 lab software / files. Overleaf serves as the standard for pre-lab/lab handouts. Archives of distribution files (including both pre-lab and lab handouts) can be found on box. The archive currently includes the Fall 2020 and Spring 2022 semesters. If you need access to this archive, please email Ricky ([email protected]).

GitHub Large File Storage

This repository currently has source files that are larger than the 100MB file size limit. In order to version control these files, we use GitHub Large File Storage. You will need to have this tool installed before cloning the repository. On macOS, the recommended way to do this is using Homebrew, a package manager for macOS. If you do not have it installed, see the installation instructions here. After installing, install LFS with this command.

brew install git-lfs
git lfs install

For Windows installation instructions or to install on macOS without Homebrew, see these instructions.

Installation

See GitHub Large File Storage before cloning. To clone the repo and create distribution files for the latest versions of these labs, run the following commands. Be aware this takes a moment.

git clone [email protected]:engri-1101/textbook.git
cd labs
make all

This will create a distribution file called <lab_name>_lab.zip within each lab directory. Note that this distribution file does not include any pre-lab or lab handouts.

Development

See GitHub Large File Storage before cloning. To work on developing these labs, you will need to run an additional command after cloning the repository. If you are new to using Git, see the Git Tutorial.

git clone [email protected]:engri-1101/textbook.git
git config --local include.path ../.gitconfig

Here, the last command configures git to filter out Jupyter Notebook output and metadata. This makes version control of Jupyter Notebooks more pleasant. See the labs README for instructions on creating a new lab.

Directory Structure

• labs contains all lab directories and a README summarizing how to build labs, lab directory structure, and a list of labs.
• software_install contains software installation instructions and a notebook to test the installation.
• tutorials contains tutorials for OR-Tools (aimed at teaching assistants who come from an AMPL background).
• lp_models_and_examples contains a large selection of example LP and IP models written in OR-Tools.
• lp_package_testing contains analysis of potential Python-based LP packages (Summer 2020).
• gilp_lab_submissions contains parsed student lab submissions (Fall 2020) for labs using the gilp python package.

TODO

Link	TODO	Assigned
minimum_spanning_tree	Review clustering application to NYC taxi data
redistricting	Optimize the redistricting 5x10 example Tetrominoes Tetris completion example	scs293
vinal package	Make bottom text more visible (highlight / color)	hwr26
baseball_elimination	Finish incorporating ECAC Cornell Hockey
N/A	Github Markup rendering	hwr26
N/A	Build labs from parts in separate notebooks	hwr26
make_student_version.py	Make this script more robust	hwr26
project_selection	Review and standardize
minimum_cut	Review and standardize
fws	Review and standardize
game_theory	Review and standardize
game_theory	Verify correctness of penalty kick game
shortest_path	Port line break demo GUI to Bokeh
shortest_path	Port inventory demo GUI to Bokeh