This is a web-based version of Robert and Jonas Gifford's "FISH", a fish banks simulator for environmental psychology studies.

More information on the original FISH here: http://web.uvic.ca/~rgifford/fish/

Requirements

Please ensure these requirements are installed before proceeding to the Installation section.

• Node (and npm)
• Mongodb
• Ruby
• Sass (through gem install sass)

Installation

1. Navigate to the fish directory in a terminal window
2. Run the command npm install (install dependencies specified in the package.json file)

• Note: You may need escalated privileges to run and will get an error. If so, use the command sudo npm install instead.
• NOTE: This will run a script post install as well. See: Usage.

3. Run the command npm start (on Windows or OSX) or nodejs app.js on Linux to start the server.
4. Navigate to localhost:8080

Usage

Scripts for Developers

These are located in the developer_scripts folder

• npm run populatedb Run post-install.
• This populates the database with a user "Admin" and a password "123456789"
• npm run cleandb This will clean all the collections defined in the file (experimenters, microworlds, and sessions)
• npm run resetdb runs cleandb then populatedb
• npm run devreset runs cleandb then populate db and then starts up the server.
• npm run sass watches for style changes

Administrator

1. Navigate to http://localhost:8080/admin

2. Log in with the following credentials:

   • Username: Admin
   • Password: 123456789

3. You now have access to the microworlds

4. Create and activate a microworld if you wish to run an experiment with users Note: Look at the Code for the experiment on an active microworld. eg Active Microworld: QQ5HQP

Users (identified by an arbitrary ID#, which is not pre-assigned. Any number will work.)

1. Navigate to http://localhost:8080/
2. Enter the Experiment number of an active microworld
3. Enter an ID number
4. Fish!

Attributions

• Black Fish Icon made by Freepik from www.flaticon.com is licensed under CC BY 3.0
• Lighthouse Icon made by Icons8 from www.flaticon.com is licensed under CC BY 3.0
• Sailboat Icon made by Freepik from www.flaticon.com is licensed under CC BY 3.0
• Fishing Icon made by Icons8 from www.flaticon.com is licensed under CC BY 3.0