This document provides instructions for installing and using the Safety Management System Tools software. It describes how to configure the workspace by setting up the database server, turning on the database, checking that PhpMyAdmin is working, and starting the application. It then outlines steps for importing data from local files or the database, conducting analysis on road segments, determining countermeasure effectiveness, and visualizing crash data. The software was created by students at California State University Sacramento to implement predictive safety analysis methods from the California Highway Safety Manual.

2.
Project Team:
Team Null
Team Members:
Gabriel Pastor
David Suon
Lloyd Foreman
Charlie Thach
Mohammad I Safdar
Project Sponsor: ​Dr. Khan
This document is the Software User Manual for the Safety Management System Tools project. This
Software User Manual instructs how to install and use the Safety Management System Tools
software. This software was created as part of the Senior Project requirement for Computer Science
majors for California State University Sacramento. This software implements the Predictive method
for several road segments, described in the California Highway Safety Manual.
This application is designed to provide information only in regard to the subject matter covered. It is
distributed with the understanding that the publisher is not engaged in rendering legal, accounting, or
other professional services. If legal advice or other expert assistance is required, advice from local
law enforcement and social service agencies, and/or the services of a competent professional
should be sought.

3. Background:
The Highway Safety Manual Tool(HSMT) program will identify sites with potential for safety
improvement, diagnose conditions at the site, evaluate conditions and the effectiveness at
reducing crashes of the programmed treatments. HSMT will have a predictive method to
estimate crash frequency and severity. In addition, the program will have access to a
MySQL database and database manage (PhpMyAdmin), where the crash information can
be retrieve/store.
Configuring workspace:
1. Setup Database Server
a. Install Database
i. Install VirtualBox (Can be download:
https://www.virtualbox.org/wiki/Downloads​)
ii. Double click WorkingLamp.ova and import it to your virtualBox.
b. Turn on Database
i. Login into Database (User Name: *****, Password: *****)
ii. The IP address of the server should be: *****************
c. Check PhpMyAdmin
i. Check that PhpMyAdmin is working by going onto the host web browser
by : **************/phpmyadmin
ii. There should be the login for the database. (User: root, Password: root)
iii. Once you can successfully login, then the server is on and working.
2. Starting the Application
a. In order to start the program, the user must double­click on the executable jar
file.
b. Home screen

4.
3. Import data
a. Import data from Local:
i. From the Home Screen, click on the “Import Crash Data” button.

5. ii. An additional window will pop up prompting to select from a local or
database option. Select Local.
iii. An additional window will prompt the user to the files they wish to load.

6. b. Import data from Database:
i. From main menu click “Crash Import Data”, then click the “Database”.
This should import all the files from the “dropbox” folder into the
database.
4. Conduct Analysis
a. To conduct analysis on a specific road segment, click on the “Conduct
Analysis” button.
b. Select the type of road segment that you would like to analyze.

7. c. Select the specific road segment from the list of road types available
d. Fill out any additional info that is prompted in the window.

8. e. After navigating through all the additional information windows, an output
screen will be displayed with information, including the predicted Crash
Reduction Factor and recommended Countermeasures.
f. In order to save the analysis for Determining Countermeasure Effectiveness,
select the save button at the button. A screen will open which will allow the
user to name file and specify the file location.
5. Determine Countermeasure Effectiveness
a. To determine Countermeasure Effectiveness, click on the “Determine
Countermeasure Effectiveness” button.

9.
b. Once the button is pressed, a new window will open prompting to choose the
desired analysis file (from the Conduct Analysis section)
c. Once the file is opened, a new window will prompt the user to select the
desired Countermeasure.

10.
d. Once the Countermeasure is selected, the user will be prompted to enter the
average annual crash value for the road segment.

11. e. Once the data is entered, the results of the chosen Countermeasure will be
displayed on the screen.
6. Visual Data
a. From the main menu, click on the “Visual Crash Data” button.

12. b. A new pop­up window should appear prompting for a Three Legged or Four
Legged Intersection selection.
c. A new window will appear, prompting to enter the name of the Main and Minor
roads.

13. d. Output
Three Legged
Four Legged

14. PhpMyAdmin:
Turn on the virtual machine server.
Once server is on, you can access database in linux or browser. Browser will require to login into
PhpMyAdmin

15. An example of setting primary keys or unique keys.