Skip to main content
All CollectionsPrevious Updates2023
27 July 2023 - Understanding and Using the New "Intra-Region" Parameter on Kpler
27 July 2023 - Understanding and Using the New "Intra-Region" Parameter on Kpler
Charles Bozik avatar
Written by Charles Bozik
Updated over a week ago

Kpler has always been committed to providing solutions that enhance your ability to track and analyze flows. Taking into account valuable feedback from our users, we have developed a new feature - the "Intra-Region" parameter, that will further refine your data analysis and interpretation.

What is the "Intra-Region" Parameter?

The "Intra-Region" parameter allows users to include or exclude flows and trades delivered within the same region they originate from. This is particularly useful when you wish to focus your analysis on external imports to a region, excluding those originating within that region. For example, if you want to view all imports to Europe while excluding intra-region flows, this parameter will provide a view of all flows from outside of Europe (e.g., Americas, Middle East, Asia, etc.) to Europe.

How it Works

For Liquids / LPG / Dry Users

If you're a Liquids / LPG / Dry user, this new parameter is simply an addition to your current features. It complements the "Intra-Country" parameter that you're already familiar with.

For LNG Users

For LNG users, there will be a significant change in your user experience. Previously, the “Intra-Region” toggle on LNG acted as both an intra-country and intra-region filter simultaneously. With the introduction of the new "Intra-Region" parameter, this behavior has been modified to provide a more nuanced and accurate view of your LNG flow data.

Case Study/Example

If users were to look at “Asia” imports “Intra-region” = False: it means that our system excludes “Asia” to “Asia” Flows. When you have both origin & destination zones specified, this check is being performed twice for each of the sets of zone (on an example of “Russia to Europe Exports, intra-flow = False”) :

  1. System considers all flows from Russia to Europe

  2. System excludes all flows going from Russia to Russia [because intra-region set to false]

  3. System excludes all flows going from Europe to Europe [because intra-region set to false]

  4. Show all the other flows (if any remaining)

In step #3 all exports from European part of Russia to Europe are excluded, therefore returning to user only exports from Far East part of Russia to Europe.

Please note, if both intra-country and intra-region are selected, these criteria are checked by the system in parallel - Flows can be filtered out by either one of them.

And in the above example, “Europe Imports intra-country=false; intra-region=true” would mean that Norway -> Spain flows would be included, but Norway -> Norway would not (because the latter would pass the second check [intra-region=true], but not the first check [intra-country=false].

Default Settings

To facilitate a smooth transition, we've set default behavior for the new parameter: Intra-Region = TRUE, Intra-Country = FALSE across all platforms. This means, by default, the system includes energy flows within the same region but excludes those within the same country.

For API Users

Within the API, across platforms, withIntraCountry now only includes or excludes intra-country flows. A new parameter withIntraRegion has been added. It shares the default settings as for the Front End: withIntraCountry = false , withIntraRegion = true.

API Documentation:

Conclusion

We believe that this new feature will greatly enhance your flow analysis on Kpler. We're excited for you to experience the enhanced granularity this feature will bring to your tracking capabilities.

For any further questions or assistance, please feel free to reach out to our support team. We're here to help ensure that you get the most out of Kpler.

Did this answer your question?