Submission for National Day of Civic Hacking EPA Challenges
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
 
 
 
 
RemyD d4f38615a9 Merge branch 'master' of github.com:decause/ndoch-epa. Fixes #2. 8 years ago
epauv Merge branch 'master' of github.com:decause/ndoch-epa 8 years ago
state Added the default example of state-by-state chloropleth. Shout-out to 8 years ago
.gitignore super-basic view working 8 years ago
CHANGES.rst move txt -> rst, plus make an inital readme and stuff 8 years ago
MANIFEST.in pcreate -s alchemy, baby 8 years ago
README.rst Added some descriptions to go with the Images 8 years ago
development.ini super-basic view working 8 years ago
production.ini Add mako directories config line to production.ini. 8 years ago
setup.cfg pcreate -s alchemy, baby 8 years ago
setup.py zip view prints out the JSON for a zipcode :D 8 years ago
stylenotes.txt Tweaks/additions to style notes 8 years ago
uvindex.py Very simple example of parsing EPA UVIndex JSON API, and visualizing with 8 years ago

README.rst

EPAUV
=====

This is a project started by a few FOSS@RIT hackers in Rochester, NY for the
first-ever National Day of Civic Hacking. We hope to expose publicly-available
UV index data provided by the Environmental Protection Agency to create an
attractive, interesting interface to this data.


Front Page
==========

The front page is a simple 3 column view that gives a quick description,
provides a form for inputting your Zipcode, and links to the project source and
license.

.. image:: /epauv/static/images/zipform.png
:height: 100px
:width: 200 px
:align: center


Desktop View
============

This is a screenshot of what the results look like from a desktop view. The
index shown at the top is calculated by checking the time the page was visited
against the hourly index. The colors are mapped to the severity levels listed
on the EPA informational website.

.. image:: /epauv/static/images/result-desktop.png
:height: 100px
:width: 200 px
:align: center


Mobile View
===========

As the page was designed using Unresponsive CSS, we get a fluid page that
scales with the size of the viewport (aka we get mobile friendly pages without
having to write separate code just for mobile devices.)

.. image:: /epauv/static/images/result-mobile.png
:height: 100px
:width: 200 px
:align: center


Hourly Results
==============

Hourly results for the day are colored based on UV Index severity, and include
tips and advice based on EPA information, such as time until skin damage, and
precautions to take based on UV Levels.

.. image:: /epauv/static/images/result-list.png
:height: 100px
:width: 200 px
:align: center


License
-------

This software is released under the GNU GPL version 3 or later.

Getting Started
---------------

We hack on this project in a virtualenv, and you should, too!

EPAUV requires that you have the ``python-lxml`` package installed.
This is used by pygal to generate coolio SVG diagrams.

- cd <directory containing this file>

- $venv/bin/python setup.py develop

- $venv/bin/initialize_EPAUV_db development.ini

- $venv/bin/pserve development.ini

Contributors
------------

- Nate Case

- Remy DeCausemaker

- David Gay