https://github.com/googleinterns/pieced
PIECED is a webapp that visualizes the declining populations of 1200+ animal species and highlights their vulnerability status.
https://github.com/googleinterns/pieced
Last synced: 11 months ago
JSON representation
PIECED is a webapp that visualizes the declining populations of 1200+ animal species and highlights their vulnerability status.
- Host: GitHub
- URL: https://github.com/googleinterns/pieced
- Owner: googleinterns
- License: apache-2.0
- Created: 2020-06-19T16:34:32.000Z (almost 6 years ago)
- Default Branch: master
- Last Pushed: 2022-09-01T23:29:52.000Z (almost 4 years ago)
- Last Synced: 2023-03-09T06:21:19.792Z (over 3 years ago)
- Language: Java
- Homepage: http://step129-2020.appspot.com
- Size: 38.3 MB
- Stars: 3
- Watchers: 2
- Forks: 3
- Open Issues: 6
-
Metadata Files:
- Readme: README.md
- License: LICENSE
- Codeowners: CODEOWNERS
Awesome Lists containing this project
README
# PIECED
 
**[LIVE DEMO](https://step129-2020.appspot.com)**
PIECED aims to visualize the declining populations of different species and highlight their vulnerability status. We hope to spread awareness to the public about these environmental issues and showcase just how close some species are to extinction.
Inspired by the 2008 WWF Japan Campaign [Population By Pixel](https://www.boredpanda.com/endagered-animals-pixels-extinction/?utm_source=google&utm_medium=organic&utm_campaign=organic), our project highlights population disparities by pixelating species images based on the number of individuals left. We manipulated CSS filters to alter image blurring and smoothing, giving us a controllable pixelation effect where the number of pixels in the image is approximately equal to the estimated population of a given species. We also added animations to transition between the original, full-resolution image and its pixelated counterpart.
## Meet the Team
PIECED was developed by Fiza ([@fgoyal](https://github.com/fgoyal)),
Ariana ([@arianazhu](https://github.com/arianazhu)), and
Maxwell ([@maxhchen](https://github.com/maxhchen)) as a capstone project for Google's
2020 STEP internship program.
## Data Collection
We collected data on over 1200 species. Most of the data was extracted by web-scraping [Wikipedia](https://en.wikipedia.org/wiki/Lists_of_organisms_by_population), but we supplemented it by retrieving data from the [GBIF API](https://www.gbif.org/developer/species) and [Google Knowledge Graph Search API](https://developers.google.com/knowledge-graph).
Information was collected as follows:
| Wikipedia | GBIF | Knowledge Graph |
| ------------- | ------------- | ------------- |
| Scientific name (key) | Kingdom | Description |
| Common name | Phylum | - |
| Population | Class | - |
| Population trend | Order | - |
| IUCN status | Family | - |
| Image | Genus | - |
## Technologies Used
This project uses the following tools/libraries:
- [AppEngine on Google Cloud](https://cloud.google.com/appengine) for deploying
- [Java Servlets](https://docs.oracle.com/javaee/5/tutorial/doc/bnafe.html) for back-end
- [jsoup](https://jsoup.org/) for web-scraping Wikipedia
- [GBIF API](https://www.gbif.org/developer/species) for data collection
- [Google Knowledge Graph Search API](https://developers.google.com/knowledge-graph) for data collection
- [Google Cloud Datastore](https://cloud.google.com/datastore) for storing data
- [Bootstrap 4](https://getbootstrap.com/docs/4.5/getting-started/introduction/) for setting up the front-end
- [Masonry.js](https://masonry.desandro.com/) for the gallery view
## Usage and Deployment
To run the project, you need to install Maven and the Google Cloud
Platform SDK.
You can run a local test server using
```
mvn package appengine:run
```
You can run just the Java data collection files using
```
mvn exec:java
```
## License
[Apache License 2.0](LICENSE.md)
Copyright 2020 Fiza Goyal, Ariana Zhu, Maxwell Chen