To download a copy of this document, click on the PDF icon above the first section. If you have a suggestion on how to improve this documentation, please follow the instructions in the “Send Us Feedback” section.
This document was last updated on February 25, 2020.
Monitor My Watershed® lets you share and explore sensor data from the EnviroDIY™ environmental science and monitoring community and macroinvertebrate data from the Leaf Pack Network®. Monitor My Watershed is part of the WikiWatershed® Toolkit, an initiative of Stroud™ Water Research Center.
Our vision is that the sharing of ideas and experiences by the Monitor My Watershed community will result in open-source data sharing and collection tool that is easy to learn and easy to use. Our goal is that this resource will create a wealth of high-quality, real-time data that transforms the practice of environmental science, resource monitoring, and watershed protection.
This document explains how to use Monitor My Watershed to explore EnviroDIY sensor data. For tips on exploring Leaf Pack Network macroinvertebrate data, please consult this document.
- EnviroDIY: A community for do-it-yourself environmental science and monitoring. EnviroDIY is part of the WikiWatershed® Toolkit (see below).
- WikiWatershed: A web toolkit designed to help citizens, conservation practitioners, municipal decision-makers, researchers, educators, and students advance knowledge and stewardship of fresh water. WikiWatershed is an initiative of Stroud Water Research Center.
- Leaf Pack Network: An international network of teachers, students, and citizen monitors investigating their local stream ecosystems. Leaf Pack Network is part of the WikiWatershed Toolkit.
- Mayfly Data Logger: A user-programmable microprocessor board that is fully compatible with the Arduino IDE software; the data logger used in an EnviroDIY Sensor Station.
- Times Series Analyst: A component of Monitor My Watershed where raw data from sensor stations are collected, analyzed, compared, and graphed. TSA allows users to make graphs that compare several variables over customizable time periods.
- Site code: A brief and unique text string that identifies a sampling site (e.g., “DEL_PHIL”).
- Site name: A more descriptive name for a sampling site (e.g., “Delaware River near Phillipsburg”).
- SL### (Stroud Logger###): Unique identifier of an EnviroDIY Sensor Station built and deployed by Stroud Water Research Center.
- Time-series data: Data points collected over time at equally spaced intervals. For EnviroDIY Sensor Stations measurements are recorded every five minutes.
- Continuous data: Term used interchangeably with “time-series data;” it refers to the continuous stream of data generated at specific time intervals.
- Discharge: Quantity of water flowing in a stream over time (m3/s or ft3/s).
- Turbidity: Measure of light passage through water (i.e., measure of the cloudiness of water). Measured in Nephelometric Turbidity Units (NTU) and others (e.g., JTU, FNU).
- Conductivity: A measure of water’s capability to pass electrical flow; it is directly related to the amount dissolved material (ions) in the water. Measured as microsiemens per centimeter (μS/cm).
- CTD sensor: A sensor that measures Conductivity (μS/cm), Temperature (C°),and Depth (mm).
NOTE: It is not necessary to create an account to view data on Monitor My Watershed. You must have an account in order to share data. It might also be helpful to have an account if you regularly check on specific sites owned by other users (see Section 4.4 for instructions on how to follow sites).
3.1.Create an Account
To create an account, click the “Sign Up” button on the Monitor My Watershed homepage or click “Sign Up” in the main menu. Fill out the following fields.
Please note that your first and last names will be displayed publicly with your data; if you do not want your name to be visible, please do not sign up for an account.
This will be used for password recovery (not for logging in!) and will not be visible to the public.
Choose a username. Make a note of it — you will need it to login because the site does not currently allow you to log in with your email address.
Choose and confirm a strong password.
If applicable, select the organization you are with. If you are independent of an organization, you do not need to include one. To avoid duplicate entries for a single organization, please check the list of existing organizations by typing your organization name in the box. If you see “No results found,” clear your entry, click on the drop-down list, and choose “Add New Organization” (Figure 1). You will be prompted to add in about your organization, including an organization code, name, organization type, description, and organization link (Figure 2). People will be able to search the data by organization so make sure you do not create a duplicate entry for an existing organization.
3.2.Edit Your Account
If you need to edit your account after registration:
- Log into Monitor My Watershed.
- Click the “Logged in as (username)” link in the main menu, then click “My Account.”
- Click the pencil icon.
- Make the desired changes and click “Save Changes.”
The My Sites page becomes available in the Monitor My Watershed menu when a user creates an account (Figure 3). It displays the user’s registered sites and the sites the user follows, on a map and in list form. This page also includes a button to register a new site.
4.1.Register a Site
- Click on “My Sites” in the Monitor My Watershed main menu.
- Click the “Register a New Site” button.
- Fill out the data fields for your site.
- Site code: enter a brief and unique text string to identify your site (e.g., “DelRiv_Phil”).
- Site name: enter a brief but descriptive name for your site (e.g., “Delaware River near Phillipsburg”).
- Site type: select the type of site you are deploying to from the menu.
- Stream name: *it is encouraged to enter a name even if it is ‘unknown tributary XXX.’
- Major watershed and sub-basin (optional)
- Closest town (optional)
- Notes (optional)
- Latitude and longitude: enter your lat/long in decimal degrees OR zoom in on the map, click to place a pin at your site location, and the lat/long will be auto-generated.
- Elevation and elevation datum: auto-generated from your lat/long.
You may also check a box to be notified if the website stops receiving sensor data from your site.
4.2.Edit a Site
- Click on “My Sites” in the Monitor My Watershed main menu.
- Scroll down to find the site you’d like to edit. Click on the Site Code to go to the site page.
- Once on the site page, click the “Edit” button.
- Edit your site data and click the “Save Edits” button.
4.3.Delete a Site
- Click on “My Sites” in the Monitor My Watershed main menu.
- Scroll down to find the site you’d like to edit. Click on the Site Code to go to the site page.
- Click the red delete button above the map to delete the experiment.
4.4.Follow a Site
- Click on “Browse Sites” in the Monitor My Watershed main menu.
- In the “Browse Data Collection Sites” sidebar, under “Data Types,” check the “EnviroDIY” box.
- Click on a map marker and then on the “View data for this site” link.
- Check the “Follow” box in the right corner above the map. The sites you follow will appear on your “My Sites” page, below your registered sites.
The Browse Sites page allows you to search all of sites streaming data to Monitor My Watershed. Users, regardless if they have an account, can access all information selected from every site in the data portal.
When the Browse Sites page is opened, you will see a map with markers indicating different sites around the world. The color and shape of the map markers indicate data age and ownership, as shown in the marker legend (Figure 4). The legend can be toggled open or closed (Figure 5).
5.2.View Site Data
Once you have chosen a site you’re interested in, click on the site marker to open the pop-up site summary pane. You will see a summary of the site identification information and a View data for this site link (Figure 9). Click the link to be taken to the Site Details page.
5.2.1.Site Identification Information
At the top of the Site Details page you will see the site identification information (metadata) for the site. Depending on the information entered when the site was registered, the metadata can include some or all of the following information: name of the individual that registered the site; organization that deployed the sensor/site; registration date; sensor deployment date; site latitude, longitude, and elevation; other elevation datum; site type; stream name; major watershed; sub basin; the closest city/town to the site, and miscellaneous notes provided by the registrar of the site.
Scroll down on the Site Details (http://monitormywatershed.org/sites/xxx/) page, below the site metadata, to see sensor observation data for the site. Depending on the sensor deployed at the site, the data collected could have some or all of the following information:
- Depth of the water where the sensor was deployed (in millimeters).
- Temperature of the water the sensor is located in (in Celsius).
- Conductivity of the water in which the sensor is immersed (μS/cm).
- Temperature of the transmitting station box deployed near the sensor (in Celsius).
- Battery voltage of the measurement equipment.
- Signal strength of the sensor.
You will see graphs showing the last 72 hours of data collected from the sensor (Figure 10). Below the graph you will see the latest observation, the medium in which the sensor is located, and the full name of the sensor.
22.214.171.124.View in Time Series Analyst
The first data viewing option is to click the first icon in the graph header (Figure 11) to open Time Series Analyst. See Section 6 for detailed instructions on how to use the Time Series Analyst. Note: clicking this link will graph only this specific dataset in Time Series Analyst. If you want to graph all of the variables for the site, see the second option in Section 6.1.
Another data viewing option is to download the data. Click the second icon in the graph header (Figure 12) to download all the data for the selected variable as a CSV file. The file will contain all the data points collected and uploaded by the sensor from the time of its deployment to the current day. Depending on how long the sensor has been deployed, the download may take a long time.
126.96.36.199.View as Data Table
The last data viewing option is to open a data table. Click the third icon (Figure 13) and the raw data from the sensor from the last 72 hours will be displayed in a pop-up pane. The table contains the sample date and time in Coordinated Universal Time (UCT), the number of hours to adjust to accommodate the time zone, and the data point collected from the sensor.
6.Times Series Analyst
Time Series Analyst is a powerful tool to evaluate and analyze data found on Monitor My Watershed. You can graph, compare, and analyze multiple variables all on one graph and set custom time frames to analyze data from a specific period of time. Users, regardless if they have an account, can analyze all information selected from every site streaming data to Monitor My Watershed.
6.1.Paths to TSA
There are several different paths to obtaining sensor data for a site in the Time Series Analyst. They are listed here in an order that yields the least specific to most specific data views.
Monitor My Watershed Menu > Time Series Analyst Map Tab
(For viewing all sites streaming to Monitor My Watershed)
Clicking on Time Series Analyst in the Monitor My Watershed menu (Figure 14) will open all sites in the Time Series Analyst Map tab. To narrow your focus to a single site, follow the instructions in Section 6.2 (Map tab) or Section 6.3 (Datasets tab).
Browse Sites > Selected Site > Time Series Analyst Datasets Tab
(For viewing all variables for a specific site streaming to Monitor My Watershed)
Click on Browse Sites in the Monitor My Watershed menu to select a site (see Sections 5.1 and 5.2) and then view the last 72 hours of data for that site. Clicking on the Time Series Analyst link (Figure 15) on the Site Details page will take you to the TSA Datasets tab with all datasets for that specific site displayed. See Section 6.3 for what to do next.
Browse Sites > Selected Site > Selected Variable > Time Series Analyst Visualization Tab
(For viewing a single variable for a specific site streaming to Monitor My Watershed)
Click on Browse Sites in the Monitor My Watershed menu to select a site (see Sections 5.1 and 5.2) and then view the last 72 hours of data for that site. The header above each graph contains three icons. Clicking on the first icon (Figure 16) will take you directly to the Time Series Analyst Visualization tab with an expanded graph for that specific variable. See Section 6.4 for what to do next.
When accessed from the main menu on Monitor My Watershed, the Time Series Analyst will open in the Map tab. The map is interactive and can be used to view sites around the world. You can add filters to the map (see Navigation section below). Time Series Analyst displays different markers for different site types. The legend for those markers is show in Figure 17.
Changing Map Views
The map view can be modified using the Map and Satellite buttons just below the Map tab (Figure 18). The default map view includes terrain. This can be removed by hovering your cursor over the Map button and unchecking Terrain. You can switch to a satellite map by clicking the Satellite button. The default satellite view includes the outlines of each country, province, and/or state on the land mass. These outlines can be removed by hovering your cursor over the Satellite button and unchecking Labels.
Navigating in the Map Tab
There are three ways to navigate in the Time Series Analyst Map tab: using the filter bar, clicking on an individual site marker of interest, or zooming in on the map and selecting a site based on a desired location.
Using the filter bar works well if you wish to locate specific information. Use the filter bar on the left side of the screen (Figure 19) to filter by network, site, variable category, specific variable, quality control level, and/or variable level. Any and all combinations of information can be selected. After checking the appropriate boxes, the map will display the sites that fulfill the filters selected. You can then click on the site marker of the site you wish to examine further.
Alternatively, if you wish to locate a specific site on the map you can click on site markers in an area of interest. Continue clicking on markers until you find the site you wish to examine further.
The last option available for navigating the Map tab is to pick an area of the map and zoom in. This option may be best for users who know which area they are interested in, but do not know which organization has the information they require. Zooming in is done by clicking the plus and minus symbols at the top left corner of the map (Figure 20).
Once you’ve found a site you’re interested in, click on the site marker and a box will pop up showing site summary information. Clicking on the View Dataseries button (Figure 21) will open site data in the Datasets tab. See Section 6.3 for information on using the Datasets tab.
You can bypass the Map tab if you know which site, sensor, or variable you are looking for. When you click on the Dataset tab you are presented with all of the data available on Monitor My Watershed and you can use the filter bar on the left to narrow your search (Figure 22).
When searching for a specific site by name, the most effective way to locate the site is to select Show More under the Sites filter in the filter bar. You can then hit Ctrl+ F and type in the name of the site they are looking for. This same method (Ctrl +F to find specific pieces of information) can be used to search through all presented data on the site.
Five buttons are displayed along the top right-hand side of the Datasets tab: Show All, Show Selected, Clear Selected, Export Selected (.zip), and Show/Hide Columns (Figure 23).
- Click the Show All button to display all variables from all sites and sensors. Users can use the filter bar on the left to find and select new site information to display. When you select Show All, any previously selected data will stay checked.
- To display specific datasets, check boxes in the Plot column and then click the Show Selected button.
- Click the Clear Selected button to clear the checkboxes in the Plot column.
- Click the Export Selected button to download the selected information as a zip file containing separate CSV files for each dataset. You can download up to five datasets at a time.
- Click the Show/Hide Column button to add or remove columns from the data you are observing. Columns on the table can be added or removed to help you locate the specific information more quickly. Adding and removing columns can also streamline the table you see when you launch the Visualization tab.
After you have selected the datasets you wish to graph (up to five at a time), you can then click Visualization tab.
The Visualization tab (Figure 24) allows users to plot selected variables. This function allows users to select data over a specific time period, and graph up to five variables on the same graph. Time Series Analyst auto-generates the increments on each axis. When several variables are selected with different units, the application will create a graph with appropriate units depending on the type of graph.
6.4.1.Selecting Data to Visualize
The Visualization tab displays data you select in the Datasets tab (unless you come directly to the Visualization tab via the third path in Section 6.1). If you select the Visualization tab without first adding variables from the Dataset tab you will see a blank pane with empty legend and summary statistics boxes. See Section 6.3 for several ways to select data to visualize.
By default, the plot will show data for the last month as a time series. The Plot Options box (Figure 25) allows you to select different dates and different visualization types. Using the buttons at the top of the box you can view the data collected over the last week, over the last month, or over the entire period of time the sensor has been collecting data. You can also plot a custom date range using the Begin Date and End Date boxes.
The Visualization tab legend displays the following information for each dataset in the plot: sensor name, variable name, site code, site name, and quality control level (Figure 26). Plot lines for the variables are assigned a specific color according to the order in which they were selected in the Datasets tab. The order of the colors is as follows: first = blue; second = orange; third = green; fourth = red; and fifth = purple.
Time Series Analyst generates statistical data for the data and time frame selected by the user. The Summary Statistics box includes Arithmetic Mean, Geometric Mean, Maximum, Minimum, Standard Deviation, and the total number of observations. It also includes 10%, 25%, 50% (median), 75%, and 90% values.
Time Series Analyst produces a primary graph (Figure 29) based on the period of time and the graph type you select. It auto-generates the increments on each axis. When several variables are selected with different units, the application will create a graph with the appropriate units depending on the type of graph.
Time Series Analyst also allows you to zoom in and focus on one particular area of the timeline by manipulating a secondary graph. Zoom in on this graph by left-clicking and holding on a mouse or touchpad, and then dragging the mouse on the target area. Doing this will result in a little gray box (Figure 30). The area selected will be magnified on the main graph. You can then further analyze a specific period of time within the selected data window.
7.Sending/Uploading Sensor Data
After registering your site, you’re ready to add sensor data to it.
Sending Data From a Data Logger
You can send sensor data from an Arduino data logger by following the detailed instructions in the EnviroDIY GitHub repository, Modular Sensors wiki.
REST POST Request Syntax
REST POST request syntax examples can be found in documentation on the Monitor My Watershed GitHub repository.
Uploading CSV Sensor Data
- You must be logged in to MonitorMyWatershed.org and be the owner of the site in order to upload data. (Detailed instructions for registering a site on Monitor My Watershed are available in Section 4.1.)
- Make sure that you’ve registered all the variables for your site.
- Add sensors/variables as needed by selecting “Manage Sensors” in the Sensor Observations section of your site page and adding them with the “+” button.
- Note: many sensors can record multiple types of data or “variables” – e.g., conductivity and temperature. For those sensors, you must add every variable you’re measuring independently.
- Create a comma delimited data file (csv) with your sensor values and time stamps
- Only include data from a single site; do not mix data from multiple sites!
- The timestamp must be in the first column with data values in subsequent columns.
- The timestamp must be formatted as yyyy-mm-dd HH:MM:SS (e.g., 2019-07-31 11:15:00). If you are editing your file in Excel, you must manually select this date format. By default, Excel will format the timestamp incorrectly! To manually select the correct date format:
- Select the cells containing timestamp data.
- Right-click and select “Format Cells.”
- Make sure you are on the “Number” tab and that “Custom” is selected in the Category list.
- The “Type” field will show m/d/yyyy h:mm. DELETE that format completely and type in yyyy-mm-dd HH:MM:SS (Figure 31).
- Click OK to save the changes. Please note: the “Custom” time format is not persistent. If you open the file again with Excel it will revert back to Excel default timestamp format and you will have to change it to yyyy-mm-dd HH:MM:SS again. You may consider using a text editor like Notepad or Notepad++ for any subsequent file editing.
- All of your timestamps must be in the same time zone – that is, not corrected for daylight savings time. If your timestamps are in local time (with a daylight savings time adjustment) you must recalculate the times to be in a single time zone.
- Add the following header rows to the top of your CSV:
Sampling Feature UUID: [sampling feature UUID] Date and Time in UTC[timezone] Result UUID: [variable 1 UUID] [variable 2 UUID] [variable 3 UUID] … [yyyy-mm-dd HH:MM:SS] [data] [data] [data] … … … … …
- Replace [sampling feature UUID] with the sampling feature UUID shown at the bottom of the site information on your site page.
- A UUID is a Universally Unique Identifier (also called a GUID or Globally Unique Identifier). They are 36 characters long and are made of numbers 0-9 and the letters a-f, e.g.,12345678-abcd-1234-efgh-1234567890ab.
- Hint: Clicking on the text of the Sampling Feature UUID on the page will cause it to be copied to your clipboard.
- Replace [timezone] with the correct UTC offset of your data. Eastern Standard Time would be UTC-5.
- Replace [variables 1 UUID] (and subsequent variables) with the UUID of those variables.
- The UUID for each variable is shown below the plot of recent data for that variable on the site page. You can also see the UUID of a variable at the top of the window when editing an already existing variable (but not when creating a new one).
- Hint: the UUIDs necessary to upload data to Monitor My Watershed will be visible under the plot for each variable or all together via the white button at the top of the page (Figure 32). You have to be logged in and the owner of the site in order to get these UUIDs. If you are not logged in or do not own the site, you will not be able to see any UUIDs or upload any data files. Each individual UUID can be quickly copied by hovering your mouse over the value and clicking on it. Note that the registration token is not needed to upload csv files. That value is only needed to post live data.
- Add your data below the header.
- Here is an example of a file ready for upload. Remember, if you view this CSV file in Excel, the timestamp will be automatically converted and will no longer be in the correct format!
- Upload the file to your site by selecting “Manage Sensors” in the Sensor Observations section of your site page and clicking on the paper clip button below the list of variables. Navigate to and select your file and then click “upload.”
- The maximum size for a single file at this time is only 1MB. If your file is bigger than that, you will need to break it into multiple files.
- After you click the upload button, it may take some time for the file to be processed. A pop-up will appear at the bottom of the page and you will receive an email with the processing finishes.
- You should be able to see the uploaded data immediately after the processing finishes on both your site page and in Time Series Analyst.
Additional help for Monitor My Watershed can be accessed using the Help link found on the top menu bar (Figure 33).
Clicking the Help link takes you to the WikiWatershed.org Help page. This page displays help resources for all of the tools in the WikiWatershed Toolkit. For sensor data help resources, scroll to the Monitor My Watershed/EnviroDIY box and click the “View Help Resources” button (Figure 34).
Once you are on the sensor data help page, you will see a list of all of the help resources for using Monitor My Watershed to view and share sensor data, including a Model My Watershed Quick Reference Guide, two tutorial videos, and the link to this manual.
You will also see how you can ask for help on the EnviroDIY.org forum and how you can use GitHub to search for known issues and report new ones.
9.Ask a Question
Before submitting a question by email, please do the following:
- Search the EnviroDIY forums for similar issues. If you don’t find the answer, try posting your question on the forum to allow EnviroDIY community members to help.
- Check our GitHub issue tracker for known issues and GitHub milestones to see scheduled bug fixes and feature additions. GitHub users are welcome to report problems in the issue tracker.
If you’ve reviewed this document, searched the EnviroDIY forum, checked GitHub, and still have a question or issue, please submit it on the Contact page (https://wikiwatershed.org/contact/). For the “What do you need help with?” question, be sure to choose “Monitor My Watershed/EnviroDIY Sensor Data.”
Monitor My Watershed® is part of WikiWatershed®, an initiative of Stroud™ Water Research Center (https://www.stroudcenter.org/). The Stroud Center seeks to advance knowledge and stewardship of freshwater systems through global research, education, and watershed restoration.
- William Penn Foundation
- National Science Foundation awards EAR-1331856 and ACI-1339834
- Stroud Water Research Center
- David Bressler, Citizen Science Project Coordinator, Stroud Water Research Center
- Heather Brooks, Web Developer, Stroud Water Research Center
- Katie Chambers, Volunteer, Stroud Water Research Center
- Sara Damiano, Research Technician, Stroud Water Research Center
- David Kline, Watershed Education Specialist, Stroud Water Research Center
11.Send Us Feedback
Please help us improve this guide. You can leave feedback by looking for the “Was this helpful? Yes or No” text at the end of each section. If your answer is no, or if you see something that needs to be changed, please use the “Suggest an edit” link and fill out a quick form.
Your feedback will not be displayed on the webpage but will be emailed to the webmaster.
Additional resources can be found on the WikiWatershed help page.