Claw User Guide

Table of Contents

1. Introduction

1.1 Purpose

Gridraven Claw is a revolutionary self-service platform designed to empower utilities and grid operators by enabling the modeling, simulation, and deployment of Dynamic Line Ratings (DLR) and Ambient Adjusted Ratings (AAR) without requiring physical sensors. The platform integrates user-provided line parameters with advanced AI-driven weather forecasting and topographical data to deliver precise, span-level capacity assessments, enhancing grid efficiency and safety.

1.2 Target Users

The primary users are utilities and grid operators who need to optimize transmission and distribution line performance. This includes engineers and administrators responsible for line modeling, weather forecasting integration, and real-time ampacity calculations, as well as decision-makers who rely on customizable confidence intervals and forecast data to balance risk and capacity.

1.3 Key Features

  • Self-Service Line Modeling: Input tower coordinates and conductor specifications, with automated integration of Digital Surface Models (DSM), Digital Terrain Models (DTM), satellite imagery, and LIDAR data.
  • Hyper-Local Weather Forecasting: Leverages sub-meter resolution data and machine learning trained on 30,000+ weather stations for accurate span-level forecasts, including 50% improved wind predictions in sheltered areas.
  • Span-Level Line Rating Calculations: Computes DLR (up to 72 hours ahead) and AAR (up to 10 days ahead) based on IEEE and CIGRE standards, considering wind cooling, temperature, solar irradiation, and clearance constraints.
  • Confidence Intervals: Offers tunable confidence levels (95%, 98%, 99%) with probabilistic modeling based on millions of weather measurements.
  • Platform Advantages: Global applicability, REST API, integration module for SCADA/EMS systems, and a user-friendly interface.

2. Functionalities

2.1 Signing up

If you have not received an invitation to join an existing organization, you can sign up yourself and create your own organization. Follow these steps to complete the sign-up process:

  1. Open your web browser and navigate to claw.gridraven.com.
  2. Click the "Sign-up" button.
  3. Enter your email address in the provided field and click "Continue" (you may also have the option to "Continue with Google" for faster registration).
  4. Fill in all required fields
  5. Click the "Sign up to Gridraven Claw" button
  6. Upon successful sign-up, confirm your email in your Inbox, and you will be logged in automatically, directing you to your new organization's World map view (see section 2.4).

Note: If you have an invitation email from an existing organization, follow the link in the email instead to join directly without creating a new organization.

  1. Now you should add your first line (see section 2.4 and/or 2.8) to see your first DLR!

2.2 Logging In

  1. Open your web browser and navigate to claw.gridraven.com.
  2. Click the "Sign-in" button.
  3. Enter your username and password (or use your Google account) in the login fields.
  4. Upon successful login, you will see your organization’s Dashboard view (see p 2.3).

2.3 Navigation Menu

The navigation menu is located on every page, on the left sidebar and includes the following options:

  • World: Access global line data.
  • Dashboard: View the central hub for line overviews of your organization and logs.
  • Map: Visualize line locations and ratings.
  • Ratings: Explore DLR and AAR calculations.
  • Lines: Manage individual line parameters.
  • API: Configure integration with SCADA/EMS systems.
  • Settings: Manage your subscription

2.4 World Tab

The World tab features a world map displaying electrical lines based on OpenStreetMap.com data.

On this page you can easily add lines to your organization by selecting a line on the map:

  1. Zoom in and select a line on the map to add it to your organization.
  2. Click the selected line to see a detailed view of that line.

  1. Click the "Add to my lines" button in the top-right corner to add the line.
  2. Change parameters if needed and click on Save and Proceed

      Now new line is added and you can see it on the other tabs as well.

2.5 Dashboard

On the Dashboard you can see a centralized view of your organization’s lines.

  1. Lines Overview: a summary section showing key metrics, e.g.:

  1. On the Logs section you can see activity logs with columns for Date, ID, Action, and User.

2.6 Map tab

The Map tab shows a general map similar to the World tab’s demo view where all the lines of your organization are shown on the map:

To see the details:

  • Select a forecast timestamp (in the top-right corner) to view data for a specific hour; if no timestamp is selected, it defaults to the current hour.
    1. Use the dropdown menu to choose what to display on the map:

        If nothing is selected, view the increase in ampacity compared to the baseline (static rating)

    1. Click on a line to navigate to the selected time and line “Ratings” view for more details (explained in section 2.6 Ratings tab)
    2. Hover over a line to see the numerical value of the selected dropdown item and highlight the line.

    2.7 Weather tab

    The feature Virtual weather station is for validation purposes. This allows you to add a validation point anywhere, retrieve real-time weather data for that location, and easily compare it against your own weather station's readings.

    1. To add a weather station click on Weather tab and click on Add a station button

        Next you need to select how do you want to add your weather station:

    1. Weather stations forecast can be viewed per station by selecting the corresponding station:

        Hover over the graph to see hourly data for a detailed, time-based analysis of ratings:

        The graph shows data from now up to the next 3-6 days. There you can see aggregated values as solar irradiance, temperature, wind speed.

        For more detailed view click on the Forecast button next to the weather station’s name.

        On the Forecast detailed view you can see map view, the Weather Forecast graph and hourly forecast table. You can select a timestamp (described in section 2.6.1) and modify the DLR % value above the ratings graph

        You can also export this hourly table to an xls-fail by clicking the “Export XLS” button:

    2. For modifying the weather station configuration, select a station from the list and click "Configuration" button:

        After modifying the weather station configuration, click the “Update weather station” button:

    2.8 Ratings tab

    The Ratings tab displays you Rating forecast and weather parameters forecast.

    The first rating appears a few minutes after adding a line, initially based on an AAR (Ambient Adjusted rating) rating. The DLR (Dynamic Line Rating) rating calculation takes a bit longer, with the first DLR rating appearing approximately 2-4 hours after adding the line.

    Ratings can be viewed per line by selecting the corresponding line from the Lines section:

    1. Select a line from the Lines section below to view its ratings.

        In the list of lines you can see each line’s name and the aggregated data: current DLR mean, current DLR 90%, current DLR 95%, current DLR 98% and current AAR.

    2. Hover over the graph to see hourly data for a detailed, time-based analysis of ratings:
      1. Rating Forecast graph shows data from now up to the next 3-6 days. There you can see aggregated values as AAR, DLR 95%, SR.
      2. Weather forecast graph shows data from now up to the next 3-6 days. There you can see aggregated values as solar irradiance, temperature, wind speed
    3. For more detailed view click on the Forecast button next to the line’s name:
    4. On the the Forecast detailed view you can see map view, Rating Forecast graph and Weather Forecast graph:
    • The map view has the same functionalities described in section 2.6 (e.g selecting timestamp, choosing forecast parameters), but everything on this map is focused on span level (each span has its own line ratings).
    1. Select a timestamp (described in section 2.6.1)
    2. Select spans – you can either choose it directly from the map by moving the mouse along the line, or select it from the drop-down menu above (next to the line’s Name) by span ranges:
    3. Select parameters according to what rating you would like to see there and the color scheme will be dynamic to show what span might be limiting the rating at this exact moment:
    4. The Ratings Forecast and Weather Forecast graphs on the right side are showing forecast for selected spans. Hover over the graph to see hourly data for a detailed, time-based analysis of ratings:
    5. You can also export ratings results to the Excel by clicking on the Export XLS button on the top-right.

    2.9 Lines Tab

    The Lines tab shows all lines added to your organization. The list displays key line data, such as Line name, Conductor types, Voltage, Number of spans, Length and Status (only active lines are forecasted).

    1. There are 3 buttons on the top-right corner of the line list:
    • By clicking the Conductors button, you can see the list of conductor types and search for the one you need. The search can be refined by using the Aluminium Type or Country filter.
    • By clicking the "Configure static rating" button, you can view and modify static rating rules. You can add a new temperature rule and a new amperage rule.
      • To add a new temperature rule, click on the "New temperature rule" button and then "Add new row". Fill in the data and click the "Save" button
      • To add a new amperage rule, click on the "New amperage rule" button and then "Add new row". Fill in the data and click the "Save" button.
    • By clicking the "Add line" button, you can add new lines.

        First you need to choose if you have a csv file for adding new line or you can add it from Openstreetmap as it’s described in section 2.3 (by choosing the file from map or adding OpenStreetMap ID) or you can pick a line from the map.

      • If you choose “I have a CSV file”, you need the CSV with tower coordinates, it must include following mandatory columns:
        • Tower ID - can be automatic if user does not have its own
        • Tower name
        • Coordinate X
        • Coordinate Y
        • Click on “I have a CSV file” and follow the instructions to upload the file. The system generates new line based on the data in this file.

          Fill/change line specification and click on Save and proceed.

      • If you know the OSM ID, click on “I have a OSM ID”, add the ID

          The system generates the new line. Fill/change line specification and click on Save and proceed.

      • Or you can just zoom and select a line from the map, click on selected line and on button Add to my lines:

          Fill/change line specification and click on Save and proceed:

    1. For the detailed view of the line, click on a specific line from the list.
    • Spans View (Default): Shows spans for the selected line, with a map on the right. You can choose the span from the list and see its location on the map:
    • Towers View: Displays all towers for the line, including Name, X, Y. The map on the right allows zooming to each tower.
      • Edit Tower: Click "Edit" to modify tower data
      • Add Tower: Click "Add Tower" to add a new tower, fill in details, and click "Save"
    • Limitations view
      • Enables to add limiting elements for each line, f.e voltage transformer.
      • Click on Add Limiting Element button and select the element type you need, change default parameters, add amperage limit and click on Create button.
    • Line View:
      • Shows line metadata and allows editing line status (Active/Inactive) via the Status field
      • Edit Line: Click "Edit Line" to modify line details (e.g., Name, Voltage, CRS, Default Conductor Type, Default max allowed Temperature, Default Emissivity, Default Number of Conductors, Default Absorptivity) and save changes:
      • Delete Line: Click "Delete Line" on the right to remove the line.

    2.10 API Tab

    The API tab describes Claw REST API capabilities for integration with other systems, e.g SCADA/EMS systems. This provides customizable endpoints for line ratings and weather forecasts. The API page provides examples in all common programming languages

    The API offers four main endpoints:

    • Lines: List all power lines with their status.
    • Line Rating Forecasts: Get forecasted ratings for a specific power line up to 10 days ahead.
    • Weather Sites: List all available sites with their details.