CSCI 1933 Project 4 setup instructions

Step 1) Open VOLE, SSH with XQuartz, or log onto a CSE labs computer. (You may also use your own computer for this tutorial if it is Unix-based, has the latest version of Java 8, and has IntelliJ.)

Step 2) Download and unzip the given folder into a location you wish

Step 3) Search for and open the IntelliJ IDEA application

Step 4) When the Import IntelliJ settings prompt pops up, click okay.

Step 5) Scroll to the end of the Terms and Conditions pop-up and click accept.

Step 6) Click any option you desire for the Data Sharing prompt.

Step 7) Click “Skip Remaining and Set Defaults”

Step 8) Click “Open”

Step 9) Navigate to the location of the extracted CSCI1933project4, select CSCI1933project4, and open it.

Step 10) When the tip of the day pop-up is seen, click close.

Step 11) Now, there are two main ways areas of the simulation can be run:

	Simulation aspect 1 (used for running actual simulation):

	11 a) Do the key command Alt + 1 or Option + 1 to show the project view if it cannot be seen.

	11 b) In the project view that shows up expand CSCI1933project4, src, and project4

	11 c) Open the Runner class

	11 d) If it says that the SDK is not defined, click Setup SDK.

	11 e) Select the SDK given if it is at least JDK 8 or higher or search for it if it is not. Once this is selected, wait for IntelliJ to show no errors in Runner (no red in the scroll bar for Runner)

	11 f) Scroll down until the Runner’s main method can be found, and click the green play button to its left and click Run Runner.main()

	11 g) This will test the simulation with the default values of having a total duration of 10000 seconds, having the Runner arrival period as 120 seconds, and having the regular and express buses at 7 buses each.

	11 h) If you wish to change this, click Runner in the upper-right corner between the hammer and play icons and click Edit Configurations.

	11 i) If it is not already selected, click Runner from the left list of Applications, and you can adjust the program arguments to match the way you wish to test the project. For example, putting “20000 240 8 4” without quotations would have Runner test the simulation with a total duration of 20000, rider arrival period of 240 seconds, 8 regular buses, and 4 express buses.

	11 j) After setting the arguments you wish to test, click apply in the lower-right corner and hit okay. Then, running the Runner file by clicking the green play button, it will run the simulation with your given values.

	Simulation aspect 2 (used for running tests to determine what bus numbers can be used to achieve approximate equilibrium):

	11 k) Follow steps 11 a – e with Statistics if you have not already done so.

	11 l) Scroll down until the Statistics’ main method can be found, and click the green play button to its left and click Run Statistics.main().

	11 m) This will run the test with having a default rider arrival period of 120 seconds and a default maximum number of buses as 14. If nothing is printed as one would expect, this means that there is no combination of regular and express buses if the maximum number of buses is 14 such that an equilibrium can be reached.

	11 n) To change the parameters passed, follow step 11 h but with Statistics instead of Runner.

	11 o) If it is not already selected, click Statistics from the left list of Applications, and you can adjust the program arguments to match the way you wish to test the project. For example, putting “480 14” without quotations would have Statistics test the simulation with a rider arrival period of 480 seconds and allow a maximum of 14 buses.

	11 p) Follow 11 j with Statistics instead of Runner.

I understand this is a rather complicated set-up for testing, so this can be done a lot faster with a TA with knowledge of how IntelliJ works. However, if you are testing the project and wish to have some assistance setting the project up, please feel free to contact me at chawl025@umn.edu, and I can help get everything set up.