ManualFlowgaugeProcessor¶

1. What is an OTT MF Pro?¶

Link to manufacturers webpage: (https://www.ott.com/products/water-flow-3/ott-mf-pro-water-flow-meter-968/)

2. Extracting Survey Data¶

It is expected that when exporting flow gauging surveys off of the OTT MF Pro, each survey is exported as a single file in the following format:

• 1x .tsv file

This is also the format that is expected from extract_ottmfpro_surveys.

The following extract function creates a list of OTTMFPro class objects with high-level metadata and specific sub-files as attributes.

from flowgaugeprocessor.extract import extract_ottmfpro_surveys

path = "path_to_your_OTTMFPro_survey_files"

surveys = extract_ottmfpro_surveys(path)

3. Exporting Survey Data¶

If you simply want to export all of your survey data out into more standard file-formats, exporting single or grouped surveys will create either csv or parquet files contaning the data contained within the raw survey files.

Options for dataframe at the survey level:

• "metadata": One row per survey. All survey metadata, location, datetime, equipment information; flow and depth
• "data": One row per vertical. All vertical data, flow and velocity at each quintile

3.1 Single Survey Export¶

Function to be added, creates all files mentioned above, 1x per survey.

3.2 Group Survey Export¶

For bulk exporting all extracted surveys in a single file, can be split back into individual surveys using the "site_id" and "site_name" columns.

from flowgaugeprocessor.extract import extract_ottmfpro_surveys
from flowgaugeprocessor.utils import export_group_survey_data

input_path = "path_to_your_OTTMFPro_survey_folders"
output_path = "path_to_your_output_directory"

surveys = extract_ottmfpro_surveys(path)

export_group_survey_data(
    surveys=surveys, 
    survey_type="OTTMFPro", 
    dataframe="metadata", 
    export_path=out_path, 
    file_out_name="OTT Metadata", 
    add_metadata=False, 
    file_type="csv")

export_group_survey_data(
    surveys=surveys, 
    survey_type="OTTMFPro", 
    dataframe="data", 
    export_path=out_path, 
    file_out_name="OTT Data", 
    add_metadata=False, 
    file_type="csv")

3.3 Site Timeseries Export¶

Note: Function is a WIP as final format is being developed

To add: Option for file type, currently only parquet

For exporting a minimal timeseries file for each site surveted, contains:

• "Discharge" - recorded in m³/s,
• "Mean-depth" - recorded in m,
• "Temperature" - not recorded by the OTT MF Pro,
• "Survey Type" - classified as "ElectroMagnetic Flowstick" for the OTT MF Pro

from flowgaugeprocessor.extract import extract_ottmfpro_surveys
from flowgaugeprocessor.fdri_timeseries_export import survey_to_fdri_timeseries

input_path = "path_to_your_OTTMFPro_survey_folders"
output_path = "path_to_your_output_directory

surveys = extract_ottmfpro_surveys(path)

surveys_to_fdri_timeseries(surveys, output_path)