WikiWatershed is an initiative of Stroud™ Water Research Center. The Stroud Center seeks to advance knowledge and stewardship of freshwater systems through global research, education, and watershed restoration.

Home » Help Resources » Sensor Data Help » Monitor My Watershed Sensor Data Manual

Monitor My Watershed Sensor Data Manual

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.

1.Introduction #

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.

Yes No Suggest edit
Last updated on 2020-02-26
1 of 1 users found this section helpful

2.Key Terms #

  • 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 Visualization: A component of Monitor My Watershed where raw data from sensor stations are collected, analyzed, compared, and graphed. TSV 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).
Yes No Suggest edit
Last updated on 2022-02-02
1 of 1 users found this section helpful

3.Account Information #

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).

Yes No Suggest edit
Last updated on 2020-02-27
0 of 0 users found this section helpful

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.

Your Name
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.

Email Address
This will be used for password recovery (not for logging in!) and will not be visible to the public.

Username
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.

Password
Choose and confirm a strong password.

Organization
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.

Terms of Use
You must agree to the Terms of Use in order to register. If you wish to read the terms, you may click the link in the agreement on the Sign Up page, or use this link. Accept the terms and click the Register button.

Yes No Suggest edit
Last updated on 2020-02-27
0 of 0 users found this section helpful

3.2.Edit Your Account #

If you need to edit your account after registration:

  1. Log into Monitor My Watershed.
  2. Click the “Logged in as (username)” link in the main menu, then click “My Account.”
  3. Click the pencil icon.
  4. Make the desired changes and click “Save Changes.”
Yes No Suggest edit
Last updated on 2020-02-25
1 of 1 users found this section helpful

4.My Sites #

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.

Figure 3. My Sites link.

Yes No Suggest edit
Last updated on 2020-02-27
1 of 1 users found this section helpful

4.1.Register a Site #

  1. Click on “My Sites” in the Monitor My Watershed main menu.
  2. Click the “Register a New Site” button.
  3. 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.

Yes No Suggest edit
Last updated on 2020-02-27
1 of 1 users found this section helpful

4.2.Edit a Site #

  1. Click on “My Sites” in the Monitor My Watershed main menu.
  2. Scroll down to find the site you’d like to edit. Click on the Site Code to go to the site page.
  3. Once on the site page, click the “Edit” button.
  4. Edit your site data and click the “Save Edits” button.
Yes No Suggest edit
Last updated on 2020-02-25
0 of 0 users found this section helpful

4.3.Delete a Site #

  1. Click on “My Sites” in the Monitor My Watershed main menu.
  2. Scroll down to find the site you’d like to edit. Click on the Site Code to go to the site page.
  3. Click the red delete button above the map to delete the experiment.
Yes No Suggest edit
Last updated on 2020-02-25
0 of 0 users found this section helpful

4.4.Follow a Site #

  1. Click on “Browse Sites” in the Monitor My Watershed main menu.
  2. In the “Browse Data Collection Sites” sidebar, under “Data Types,” check the “EnviroDIY” box.
  3. Click on a map marker and then on the “View data for this site” link.
  4. 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.
Yes No Suggest edit
Last updated on 2019-04-26
0 of 0 users found this section helpful

5.Browse 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).

Yes No Suggest edit
Last updated on 2020-02-27
0 of 0 users found this section helpful

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.

Figure 9. View data for this site link.

Yes No Suggest edit
Last updated on 2020-02-27
0 of 0 users found this section helpful

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.

Yes No Suggest edit
Last updated on 2020-02-27
0 of 0 users found this section helpful

5.2.2.Sensor Observations #

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.

Figure 10. Graphs of sensor observations.

 

Yes No Suggest edit
Last updated on 2020-02-27
0 of 0 users found this section helpful

5.2.2.1.View in Time Series Visualization #

The first data viewing option is to click the first icon in the graph header (Figure 11) to open Time Series Visualization. See Section 6 for detailed instructions on how to use the Time Series Visualization. Note: clicking this link will graph only this specific dataset in Time Series Visualization. If you want to graph all of the variables for the site, see the second option in Section 6.1.

Figure 11. Link to the Time Series Analyst.

 

Yes No Suggest edit
Last updated on 2022-02-02
0 of 0 users found this section helpful

5.2.2.2.Download Data #

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.

Figure 12. Link to download data as a CSV file.

Yes No Suggest edit
Last updated on 2020-02-27
0 of 0 users found this section helpful

5.2.2.3.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.

Figure 13. Link to open the data table.

Yes No Suggest edit
Last updated on 2020-02-27
0 of 0 users found this section helpful

6.Times Series Visualization #

Time Series Visualization is a powerful tool to evaluate and analyze data found on Monitor My Watershed. You can graph and compare multiple variables and sites all on one graph and set custom time frames to visualize data from a specific period of time. Users, regardless if they have an account, can visualize all information selected from every site streaming data to Monitor My Watershed.

Yes No Suggest edit
Last updated on 2022-02-02
0 of 0 users found this section helpful

6.1.Paths to TSV #

There are several different paths to obtaining sensor data for a site in the Time Series Visualization. They are listed here in an order that yields the least specific to most specific data views.

Monitor My Watershed Menu > Time Series Visualization Tab

Clicking on Time Series Visualization in the Monitor My Watershed menu (Figure 14) will open a blank visualization screen for you to customize (see Section 6.2).

Figure 14. TSV tab in Monitor My Watershed menu bar.

Browse Sites > Selected Site > Time Series Visualization 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 Visualization link (Figure 15) on the Site Details page will take you to the TSV screen pre-populated with the site. Add a parameter to the plot using the Add Series list in the lower right hand corner.

Figure 15. Time Series Visualization icon on the Site page.

Browse Sites > Selected Site > Selected Variable > Time Series 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.

Figure 16. The Time Series Analyst link for a single variable.

Yes No Suggest edit
Last updated on 2022-02-02
0 of 0 users found this section helpful

6.2.Customizing Visualizations #

Time Series Visualization (Figure 17) allows users to plot selected variables and adjust the time scale.

Figure 17. Blank TSV interface.

Add a site for visualization from the drop-down list in the upper right hand corner (Figure 18), then click the Load Site button to populate a list of parameters to select from.

Figure 18. Site selection drop-down list.

Select the check box for the parameter series to add; all records for that parameter will be added to the plot. Adjust the date range by clicking and dragging over the plot or by using the Date Range functions (Figure 19).

Figure 19. The time series for a parameter can be adjusted using the Date Range functions.

Additional parameters and sites can be added to the plot by repeating these steps.

Yes No Suggest edit
Last updated on 2022-02-02
0 of 0 users found this section helpful

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

  1. 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.)
  2. Make sure that you’ve registered all the variables for your site.
    1. Add sensors/variables as needed by selecting “Manage Sensors” in the Sensor Observations section of your site page and adding them with the “+” button.
    2. 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.
  3. Create a comma delimited data file (csv) with your sensor values and time stamps
    1. Only include data from a single site; do not mix data from multiple sites!
    2. The timestamp must be in the first column with data values in subsequent columns.
    3. 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:
      1. Select the cells containing timestamp data.
      2. Right-click and select “Format Cells.”
      3. Make sure you are on the “Number” tab and that “Custom” is selected in the Category list.
      4. The “Type” field will show m/d/yyyy h:mm. DELETE that format completely and type in yyyy-mm-dd HH:MM:SS (Figure 20).

        Figure 20. Forcing the correct date time format in Excel.

      5. 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.
    4. 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.
  4.  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]
    1. Replace [sampling feature UUID] with the sampling feature UUID shown at the bottom of the site information on your site page.
    2. 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.
    3. Hint: Clicking on the text of the Sampling Feature UUID on the page will cause it to be copied to your clipboard.
    4. Replace [timezone] with the correct UTC offset of your data. Eastern Standard Time would be UTC-5.
    5. Replace [variables 1 UUID] (and subsequent variables) with the UUID of those variables.
    6. 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).
    7. 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 21). 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.
      Button to view the token UUID list

      Figure 21. View Token UUID List button.

    8. Add your data below the header.
  5. 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!
  6. 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.”
    1. 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.
    2. 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.
    3. You should be able to see the uploaded data immediately after the processing finishes on both your site page and in Time Series Analyst.
Yes No Suggest edit
Last updated on 2022-02-02
1 of 1 users found this section helpful

8.Additional Help #

Additional help for Monitor My Watershed can be accessed using the Help link found on the top menu bar (Figure 22).

Figure 22. Monitor My Watershed help link.

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 23).

Figure 23. Link to Monitor My Watershed/EnviroDIY sensor data help resources.

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.

Yes No Suggest edit
Last updated on 2022-02-02
0 of 0 users found this section helpful

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.”

Yes No Suggest edit
Last updated on 2020-02-27
0 of 0 users found this section helpful

10.Credits #

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.

Collaborating Organizations

Support

Documentation Contributors

  • 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
Yes No Suggest edit
Last updated on 2020-02-27
0 of 0 users found this section helpful

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.

Yes No Suggest edit
Last updated on 2020-02-27
0 of 0 users found this section helpful
Suggest Edit
Model My Watershed Maintenance

Model My Watershed will be undergoing scheduled maintenance on Monday, January 17 from 11 a.m. to 3 p.m. EST. The model will be unavailable during that time.

Upgrade announcement coming soon!