View on GitHub


Social.Water code for CrowdHydrology and other environmental applications

Download this project as a .zip file Download this project as a tar.gz file

Social.Water -- a python software package to acquire measurements sent by citizen-scientists via text messages. Version 1.1 --- March 13, 2013

Documentation: Fienen, M.N., and Lowry, C.S., 2012, Social.Water-A crowdsourcing tool for environmental data acquisition. Computers & Geosciences 49, 164-169, doi:10.1016/j.cageo.2012.06.015. Lowry, C. S. and Fienen, M. N., 2013, CrowdHydrology: Crowdsourcing Hydrologic Data and Engaging Citizen Scientists. Ground Water 51, 151-156, doi:10.1111/j.1745-6584.2012.00956.x.

GENERAL USE The driver program is src/

An xml configuration file must be created to provide information about a specific site and related email account. The file src/EXAMPLE_social.water.xml shows the format of such a configuration file.

To run the program, navigate to the src directory and run: python EXAMPLE_social.water.xml

The specific name of the xml file is provided as a command line argument as in the above example.

The remaining codes and directory structure must remain as they are. The html and csv files in place are from the CrowdHydrology paper and included as examples - they should all be removed prior to deployment on another project.

Contact Mike Fienen < mnfienen (at) usgs [dot] gov >

DISCLAIMER and NOTICE Please refer to the USGS Software User Rights Notice ( for complete use, copyright, and distribution information. The USGS provides no warranty, expressed or implied, as to the correctness of the furnished software or the suitability for any purpose. The software has been tested, but as with any complex software, there could be undetected errors. Users who find errors are requested to report them to the USGS.

References to non-USGS products, trade names, and (or) services are provided for information purposes only and do not constitute endorsement or warranty, express or implied, by the USGS, U.S. Department of Interior, or U.S. Government, as to their suitability, content, usefulness, functioning, completeness, or accuracy.