Group Members: Vamshi Chilukamari, Aditya Devarakonda, Akhilesh Maddali, Vladimir Samokhin, Sanket Wagle

We recommend that you use our website: http://se1.engr.rutgers.edu/~group7 (access this directly if already on Rutgers Network.)

in order to evaluate the code. Attempting to run the program on a local machine requires, Apache2 web server, MySQL server, Python with MySQL libraries, PHP5 with MySQL libraries.

If you are evaluating from home without RUWireless or Rutgers Network then do the following:

	open a web browser and go to: apps.rutgers.edu
	
	a permission to run java applet should pop-up; click "Run".
	
	a new window with a VNC login screen should appear.

	log-in using your NETID and corresponding PASSWORD.

	once successfully logged in, open a firefox browser and navigate to : http://se1.engr.rutgers.edu/~group7

	Our Traffic Monitoring system should load and you can begin testing/using the software.


Structure of EPA
    |
    +-----> Design			// Contains the UML Diagrams from Report 3.
    |
    +--+--> Documentation	       // Contains all demo material and reports.
    |  |
    |  +-------> Reports     		// Contains Reports 1,2 & 3
    |  |
    |  +-------> Demo Materials	 	// Contains Demo slides and Pamphlet.
    |
    +-----> Pics          		// Screenshots and Pictures of User Interface.
    |
    +-----> DatabaseDump 		// Sample data in the format of a mysql dump.
    |
    +-----> DatabaseSchema 		// Shows the database table structure without data.
    |
    +--+--> Code          		// project code
       |
       +-------> DataCollector    	// Contains all of the code necessary for the data collector.
       |
       +--+----> public_html  		// contains the php classes and html files for the website and GUI only.
       |  |
       |  +----> include		// contains the php classes for the DataAggregator, DatabaseInterface, SeverityCalc,GeoCoder and Goolge APIs.
       |
       +-------> images   		// png's of the marker icons.


************DESIGN FOLDER*************
Activity Diagrams.pptx - This powerpoint has all of the activity diagrams.
Class Diagrams.pptx - Contains all of the class diagrams for the project.
DomainModel.pptx - has the updated domain models for the system.
IdentifyingSubstation.pptx - Has the colored, updated subsystem.
InteractionDiagrams.pptx - Contains the figures showing how the system works.
System Sequence Diagram.pptx - contains the diagrams of all of the use cases.
Use case Diagram.pptx - shows the overall, broader view of our system.

************DOCUMENTATION FOLDER*******
DEMOMATERIALS FOLDER
--------------------
	Demo1Presentation.pptx - contains the slides used during Demo1.
	Pamphlet.pdf - contains the updated brochure for the entire project.
REPORTS FOLDER
--------------
	Report 1.pdf - The first iteration report of the system.
	Report 2.pdf - The second iteration of the report for the system.
	Report 3.pdf - The final technical document, containing information about our experiences and potential future work.

*************PICS FOLDER****************
Rather than list all of the filenames, we describe the content.

This folder contains several screenshots of our GUI progress throughout the entire semester. It also contains 3 pictures showing the sector demarcations for each highway in each region of NJ.

*************DATABASE SCHEMA FOLDER*****
databaseschema.sql - An sql file which contains the table descriptions for the TRAFFIC and WEATHER tables.

************DATABASE DUMP FOLDER********
datacollectiondump.sql - An sql file which contains some sample data with information stored in the TRAFFIC and WEATHER tables described in the database schema folder.

************CODE FOLDER*****************
DATACOLLECTOR FOLDER
-------------------
	collectionsys.cron - A crontab file which is loaded on to the crontab UNIX scheduling daemon. It runs the collection system every hour, on the hour.
	CollectScript.py - This is the script that is linked to the crontab daemon. It will create instances of the TrafficParser and WeatherParser objects and initiate the parsing process.
	TrafficParser.py - Encapsulates the object which connects to 511nj.org parses the html code, extracts relevant information and adds to database.
	WeatherParser.py - Encapsulates the object which connects to weather.com RSS Feeds, parses the html code, extracts relevant information and adds to database.
TrafficParser.pyc & WeatherParser.pyc - the compiled python code.

PUBLIC_HTML FOLDER
-----------------
	about.html - An informative html file which displays some information about our system version and group members.
	help.html - A help html page for how to use our system and what sort of requests it can handle.
	index.php - This is the GUI generator which displays buttons, checkboxes, dropdown menus for the user to select from.
	
	include folder
		DataAggregator.php - Responsible for mapping data to markers.
		DatabaseInterface.php - Provides an API for accessing the database and extracting the required information.
		GeoCoder.php - Acts as a wrapper around the Google API and sets up the map configurations including zoom level, live traffic overlay and marker colors.
		SeverityCalc.php - This contains the severity calculation algorithm and returns the severity level of a marker in the form of a color.
		GoogleMap.php & JSMin.php - APIs provided by Google in order to use their Maps.	



	

      
