SAPsim 1.0.4

Simulation of SAP (Simple As Possible) computer programs from COMP311 (Computer Organization) @ UNC

SAPsim

Simulation of SAP (Simple As Possible) computer programs from COMP311 (Computer Organization) @ UNC.

Install

pip install SAPsim

Your Python version needs to be 3.9+. Check with python --version.

If python doesn't work, try python3. If pip doesn't work, try pip3.

Usage

Write a SAP program in the CSV file format shown below.

ex1.csv

You may edit the .csv file with any program (Microsoft Excel, Google Sheets, etc.), as long as you preserve the .csv extension.

Open a Python terminal. Import SAPsim's run() function, and pass the path to your SAP program as an argument.

>>> from SAPsim import run
>>> run("ex1.csv")                 # run ex1.csv at full speed (default)
...
>>> run("ex1.csv", debug=True)     # run ex1.csv in debug (step) mode
...

Note: There is a debug (step) mode, as shown above.

Here's a list of additional settings (e.g., table format).

Rules

It's easy to just mimic the example programs, but if you need it, here's the list of rules for SAPsim programs.

SAP instruction set

Documentation

https://SAPsim.readthedocs.io