Group Name: Project Group 76 | Group Member: Xunyong Tan , Tianyan Wang | UNIs: [xt2227,tw2730]
This file is written to describe the tools, the use and the behaviour of this webapplication for squirrel sighting tracking, intended to give users full control over their interactions with squirrels in Central Park, New York City.
- Functions
- Dataset
- Installation
- Installation of Dependencies
- Management Commands
- API
- Deployment
- Detailed Background
- Issue Tracker and Mailing List
- Contributors
This Squirrel Sighting Tracking Webapplication is based on Django development and keeps track of all the known and recorded squirrels in 2018 at the Central Park. In this webapplication, the squirrel tracking dataset is imported. Users can add, delete, edit and view the statistics of Squirrel Sighting data and get the view of all the squirrel sightings on a map. To explore more about the functions in deployed web, you can open Squirrel Sightings and follow the guide.
The squirrel sighting data for this webapplication can be imported from 2018 Central Park Squirrel Census, which was collected and published by the Squirrel Census Community in 2019.
This dataset contains data from 3,023 different squirrel sightings, including location coordinates, age, primary and secondary fur color, elevation, activities, communications, and interactions between squirrels and with humans at the Central Park.
Clone this repository into your project with the following SSH:
git@github.com:tanxunyong/Squirrel_Sightings.git
As many platforms and Services expect a requirements.txt file in the root of projects, install the production requirements using this code:
$ pip install -r requirements.txt
To import and export the dataset, use these management commands:
Import: A command that can be used to import the data from the 2018 census file in CSV format. The file path should be specified at the command line after the name of the management command.
$ python manage.py import_squirrel_data /path/to/file.csv
Export: A command that can be used to export the data from the 2018 cencus file in CSV format. The file path should be specified at the command line after the name of the management command.
$ python manage.py export_squirrel_data /path/to/file.csv
Run the server and then go to the brower to open the development server, adding different views location to the url will lead to different API with different function.
Map:
- Behavior: Map is a view that shows a map that displays the location of the squirrel sightings on an OpenStreets map.
- Located at: /map
- Warning: If you plot 100 sightings at once, the browser may freeze for a while.
Sightings:
- Behavior: Sightings is a view that lists all squirrel sightings with links to edit and add sightings.
- Located at: /sightings
Update:
- Behavior: Update is a view to update a particular sighting. Add a specific unique squirrel id in the location to check and update the individual information of a squirrel.
- Located at: /sightings/
Add:
- Behavior: Add is a view to create a new sighting to the database. Open the link and input the necessary information: Latitude, Longitude, Unique Squirrel ID, Shift, Date, Age, Primary Fur Color, Location, Specific Location, Running, Chasing, Climbing, Eating, Foraging, Other Activities, Kuks, Quaas, Moans, Tail flags, Tail twitches, Approaches, Indifferent and Runs from. After adding the squirrel, it will be added to the sighting list and be updated.
- Located at: /sightings/add
Delete:
- Behavior: Delete is a view to update a particular sighting. Add a specific unique squirrel id in the location to view and delete individual information of a squirrel.
- Located at: /sightings/
General:
- Behavior: General Stats is a view to view important general information about the squirrel sightings. In this page, typical attributes of all the squirrel sightings are listed.
- Located at: /sightings/stats
To explore the deployed webapplication, open the following link and click the link shown in the guide page.
https://green-webbing-255500.appspot.com or https://instance-3-255500.appspot.com.
Eccentric billionaire Joffrey Hosencratz just purchased the web development company we work for. We’ve met him once in an elevator and he relayed that his most recent trip to Sedona, AZ has left him in a bit of trouble. See, he fancies the show [**Rick and Morty**](https://www.youtube.com/watch?v=C5SU_K-GFKk/) and a particular scene coupled with a traumatic childhood squirrel experience and a bad crystal bath experience in Sedona as left him wanting.He would like to start keeping track of all the known squirrels and plans to start with Central Park. Therefore we are asked to build an application that can import the 2018 Central Park Squirrel Census data and allow his team to add, update, and delete squirrel data.
Bug reports are welcome! You can submit pull requests on GitHub <git@github.com:tanxunyong/Squirrel_Sightings.git> if you spot any issues when executing our code.
Group Name: Project Group 76
Group Member: Xunyong Tan(uni: xt2227), Tianyan Wang(uni: tw2730)
UNIs: [xt2227 , tw2730]