Skip to main content

Reports

Generate data report of instruments / station-group

S
Written by Sameer Shaik Abdul Rahaman
Updated over 2 weeks ago

Introduction

The Report Page in GeoSens is designed to help users generate and review data-driven reports. By selecting specific instruments/station groups, date ranges, and output formats, you can produce plots and tables to track instrument performance and site conditions over time. You can use either the left panel (for Instruments) or the right panel (for Station Groups) to build your reports.

The sections on this page are briefly introduced in the table below:

Section Name

Function

Instrument Section

This panel allows users to filter and select instruments for generating reports.

Station-Group Section

This panel allows filtering and selecting station groups based on various criteria.

Chart Display Area

Shows a line chart with data points plotted against a timeline. Please refer to Charts - Chart Display for further instructions.

Data Table

Displays the selected data based on filter settings, with columns representing various metrics (e.g., lateral displacement, vertical displacement). Please refer to Charts - Data Table for further instructions.


1. Instrument Selection

1) Select and Filter Instruments

  1. Choose Instrument Type

    • From the Instrument Type dropdown, select the category (e.g., Inclinometer, Piezometer, Extensometer) you want to report on.

  2. Refine by Category

    • If applicable, pick a sub-category (site, location, project) to narrow down the list.

  3. Pick Specific Instruments

    • Use the checkboxes to select individual instruments.

    • Or click Select All to include every instrument in that category.


2) Generating a Plot (Instruments)

  1. Review Selections

    • Confirm the instruments

  2. Specify Time Range

    • In the Time Filter, set a custom date range (Start Date → End Date) if you wish.

    • Last num. of Hours (Optional)
      Retrieves data for a set number of hours before the End Date/Time.

    • Last num. of Records (Optional)
      Retrieves the most recent data points, regardless of time.

  3. Choose Plot Type

    • Depending on your data (Vertical Displacement, Lateral Displacement, etc.), ensure the correct plot type is selected in the system’s Plot Settings.

  4. Click “Plot”

    • The system fetches and displays the data in the Main Display Area.

    • If “No data found” appears, recheck your instrument selections or date range.

Additional Features and Icons

  1. Attachments / Project Files (Paperclip Icon)

    • Manage documents, images, or files linked to your selected instrument or station.

  2. Pin / Map View (Pushpin Icon)

    • Pin Status: Check alarms if the instrument is in an alert state.

    • Pin instrument: View your selected item on a map.

  3. Export (Document/Arrow Icon)

    • Quick-export the current data table in Excel format.


3) Generating and Viewing the Report (Instruments)

  1. Click “Report”

    • Opens the Report Settings dialog.

  1. Specify the Plot Type

  2. Confirm whether you want VD (Vertical Displacement) or LD (Lateral Displacement), etc. The plot type varies based on the instrument type.

  3. Set the Time Range

    • You can adjust here if you missed or need a different date range.

      Start Date/Time
      Specifies the beginning of the data range.

      End Date/Time
      Specifies the end of the data range.

      Num. Initial Hours
      Retrieves data for a set number of hours after the Start Date/Time.

      Last num. of Hours
      Retrieves data for a set number of hours before the End Date/Time.

      Last num. of Records
      Retrieves the most recent data points, regardless of time.

  4. Choose Report Format

    • PDF for a polished, presentation-ready file.

    • CSV/Excel for further data manipulation or custom analysis.

    • Both: The output will be a zip file which consists of both excel and PDF.

  5. Checkable Options

    • AlarmLimits: Show threshold limits.

    • Chart: Include the plot in the report.

    • DataTable: Include raw/processed readings in tabular form.

    • LocationMap: Embed a site map with instrument locations.

    • Sketch: Include relevant tunnel or site sketches.

    • RemarkSummary: Include notes/observations.

    • Attachments & Annotations (if available).

    • EventRegistry (if available).

      Uploaded image

  6. Generate Report

    • Click Export to produce the final file(s).

    • Check your browser’s download folder or prompt to retrieve the document.


2. Station Group Selection (Right Panel)

1) Select and Filter Station Groups

  1. Choose Station Type

    • From the Station Type dropdown, pick the group type (e.g., “TCFV,” “SSP,” etc.).

  2. Refine by Category

    • Narrow down by site, function, or other sub-categories as needed.

  3. Pick Specific Groups

    • Select the group(s) you want to include.

    • Optionally, choose a single group which automatically includes all instruments under that group.


2) Generating a Plot (Station Groups)

  1. Specify Time Range

  2. Use the Time Filter to pick from quick ranges or set a custom date range.

    From Date-Time / To Date-Time
    Defines the start and end of the data range.

    Last num of Hours
    Fetches data for a set number of hours before the end time.

    Last num of Records
    Fetches the most recent X data points, regardless of time.

  3. Click “Plot Station”

    • A chart should appear in the Main Display Area.

    • If you see “No data found,” verify your station group and date filters.

Additional Features and Icons

  1. Attachments / Project Files (Paperclip Icon)

    • Manage documents, images, or files linked to your selected instrument or station.

  2. Pin / Map View (Pushpin Icon)

    • Pin Status: Check alarms if the instrument is in an alert state.

    • Pin instrument: View your selected item on a map.


3) Generating and Viewing the Report (Station Groups)

  1. Click “Report”

    • Opens the Report Settings dialog.

  1. Specify the Plot Type

  2. Confirm whether you want VD (Vertical Displacement) or LD (Lateral Displacement), etc. The plot type varies based on the instruments type.

  3. Set the Time Range

    • You can adjust here if you missed or need a different date range.

      Start Date/Time
      Specifies the beginning of the data range.

      End Date/Time
      Specifies the end of the data range.

      Num. Initial Hours
      Retrieves data for a set number of hours after the Start Date/Time.

      Last num. of Hours
      Retrieves data for a set number of hours before the End Date/Time.

      Last num. of Records
      Retrieves the most recent data points, regardless of time.

  4. Choose Report Format

    • PDF for a polished, presentation-ready file.

    • CSV/Excel for further data manipulation or custom analysis.

    • Both: The output will be a zip file which consists of both excel and PDF.

  5. Checkable Options

    • AlarmLimits: Show threshold limits.

    • Chart: Include the plot in the report.

    • DataTable: Include raw/processed readings in tabular form.

    • LocationMap: Embed a site map with instrument locations.

    • Sketch: Include relevant tunnel or site sketches.

    • RemarkSummary: Include notes/observations.

    • Attachments & Annotations (if available).

    • EventRegistry (if available).

      Uploaded image

  6. Generate Report

    • Click Export to produce the final file(s).

    • Check your browser’s download folder or prompt to retrieve the document.


3. Additional Export Functions - Combine/Batch

Combine: When you select more that one instruments, you can combine them into one file.

Batch: When you select more than one instruments, you can get them by batch.

1) Combine Function

What It Does:

  • The Combine function allows you to merge data from several instruments into a single report file.

  • This is useful when you want an integrated view of your data, such as comparing performance metrics side-by-side or when a unified dataset is more convenient for analysis.

Example: Imagine you have three instruments monitoring different parts of a site. By selecting all three and using the Combine function, the system will generate one CSV or PDF report based on the user's preference. This way, you don’t have to open separate files to review each instrument’s data, making it easier to detect correlations or overall patterns.

2) Batch Function

What It Does:

  • The Batch function, on the other hand, generates separate files for each selected instrument or group.

  • This is beneficial if you need detailed, instrument-specific reports for further individual analysis, or if different team members are responsible for monitoring different instruments.

Example: Continuing with the scenario above, suppose you now want to review each instrument's performance independently. By selecting the Batch function with the same three instruments:

  • The system will produce three separate files—each file containing individual report.

  • This makes it simpler to send individual reports to different stakeholders who are only interested in a specific part of the site.

*The output will be a zip file which contains selected instruments reports.


4. Typical Exported Report

The purpose of this section is to help users understand the various sections in the report and what to expect.

1) For report exported in Excel format

Excel format can be used to view data in detail down to specific points.

In general, there are 3 types of contents, Charts & Report, Data, and Alarm limits, in different worksheets.

  • Chart & Report worksheet: This worksheet contains the main report, which is where the PDF report is converted from. Based on the Report Items selected (see the description of the report setting above), the report may contain Report Header section, Charts, Location Map, Report Data Table, and Remark Summary.

  • Data worksheet: Survey readings of instruments / station groups will be shown on this page, including date-time, easting, northing, reduce level, original readings, calculations.

  • Alarm Limits worksheet: The alarm limit information for this instrument / station group report will be shown on this page.

2) For report exported in PDF format

  • The PDF Report format is converted from the first worksheet in the Excel format.

  • All the information of charts, data table, location map, tunnel sketch, remark summary will be shown on this page (if they are selected in the report setting page / subjected to different instrument types). In the headings, the information about instrument No., location, easting/northing, reporting period, alarm limits will appear.


5. Troubleshooting & Tips

  1. No Data Found:

    • Confirm you have selected the correct instrument(s), station(s), and time range.

    • Check that the instrument is actively logging data.

  2. Slow Load Times:

    • If you are querying large date ranges or many instruments, try narrowing your selections.

  3. Plot Does Not Appear:

    • Ensure you have clicked “Plot” after making your selections.

    • Check internet connectivity or system status if the chart never loads.

  4. PDF/Report Generation Issues:

    • Verify pop-up blockers are disabled or that you have permission to download files.

    • Check your browser’s download folder for the generated file.


Did this answer your question?