Overview

HTTPS SSH
Edgar Sioson
12-2-2011

	Flora is a discrete-event, agent-based simulation model. It consists of a testbed module for 
	simulating natural processes (resources, person fitness, locations), a decision module for 
	built-in decision engines that assigns activity cycles and interrupt requests during a 
	simulation run, and an infrastructure module for built-in sociotechnical systems to assist
	an engine in decision-making. Note that the decision and infrastructure modules are extensible,
	with the option for the testbed to call extenal (networked) decision engines and 
	infrastructure components. Refer to the [paper reference] for more information.


Released under the MIT License
	Copyright (C) 2011 by Edgar Sioson <siosonel at g m a i l>

	Permission is hereby granted, free of charge, to any person obtaining a copy
	of this software and associated documentation files (the "Software"), to deal
	in the Software without restriction, including without limitation the rights
	to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
	copies of the Software, and to permit persons to whom the Software is
	furnished to do so, subject to the following conditions:

	The above copyright notice and this permission notice shall be included in
	all copies or substantial portions of the Software.

	THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
	IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
	FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
	AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
	LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
	OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
	THE SOFTWARE.

	
	
Requirements:    
	***Server-side*** 
	Apache 2.2 or later
	PHP 5.2.0 or later
	
	***Client-side***
	Any modern browser
	
	See http://tyaga.org/flora/ for more information.    

	
Credits
	- Props to the creators/developers of Apache, PHP, and Dygraphs.
	- Refer to the citations in [paper reference].
	
Download / Source Control:
	You can view and download at https://bitbucket.org/siosonel/flora.

Installation
	Apache with mod PHP should already be installed. If not, there are two common ways to do so:
		(Only Windows instruction is given here. If you use Linux (ubuntu), 
		just use "sudo apt install lamp-server".)
			
		(a) RECOMMENDED for security, but a tiny bit more involved: 
			- install Apache, http://httpd.apache.org/download.cgi
				- Select a trusted mirror site
				- Under best available vesrion: 
					Select Win32Binary (does not matter in our case if it has OPENSSL or not)
				- Configure 
			- install PHP, http://www.php.net/manual/en/install.windows.installer.msi.php
			
		(b) Alternatively and much more simply, use XAMPP for windows, 
		http://www.apachefriends.org/en/xampp-windows.html#1167
	
	After downloading the source code, 
	just put the package somewhere under your web document root. That's it.
	
		
Documentation:	
	Just load index.php on your browser, configure your run parameters, and click run.