Introducing the Forecasts API — Event-driven forecasts for precise demand planning. Fast, accurate, and easy to run.
Explore Now
LogoLogo
Visit websiteWebAppGet DemoTry for Free
  • Introduction
  • Swagger UI
  • Loop
  • System Status
  • Getting Started
    • API Quickstart
    • Data Science Notebooks
    • PredictHQ Data
      • Data Accuracy
      • Event Categories
        • Attendance-Based Events
        • Non-Attendance-Based Events
        • Unscheduled Events
        • Live TV Events
      • Labels
      • Entities
      • Ranks
        • PHQ Rank
        • Local Rank
        • Aviation Rank
      • Predicted Attendance
      • Predicted End Times
      • Predicted Event Spend
      • Predicted Events
      • Predicted Impact Patterns
    • Guides
      • Geolocation Guides
        • Overview
        • Searching by Location
          • Find Events by Latitude/Longitude and Radius
          • Find Events by Place ID
          • Find Events by IATA Code
          • Find Events by Country Code
          • Find Events by Placekey
          • Working with Location-Based Subscriptions
        • Understanding Place Hierarchies
        • Working with Polygons
        • Join Events using Placekey
      • Date and Time Guides
        • Working with Recurring Events
        • Working with Multi-day and Umbrella Events
        • Working with Dates, Times and Timezones
      • Events API Guides
        • Understanding Relevance Field in Event Results
        • Attendance-Based Events Notebooks
        • Non-Attendance-Based Events Notebooks
        • Severe Weather Events Notebooks
        • Academic Events Notebooks
        • Working with Venues Notebook
      • Features API Guides
        • Increase Accuracy with the Features API
        • Get ML Features
        • Demand Forecasting with Event Features
      • Forecasts API Guides
        • Getting Started with Forecasts API
        • Understanding Forecast Accuracy Metrics
        • Troubleshooting Guide for Forecasts API
      • Live TV Event Guides
        • Find Broadcasts by County Place ID
        • Find Broadcasts by Latitude and Longitude
        • Find all Broadcasts for an Event
        • Find Broadcasts for Specific Sport Types
        • Aggregating Live TV Events
        • Live TV Events Notebooks
      • Beam Guides
        • ML Features by Location
        • ML Features by Group
      • Demand Surge API Guides
        • Demand Surge Notebook
      • Guide to Protecting PredictHQ Data
      • Streamlit Demo Apps
      • Guide to Bulk Export Data via the WebApp
      • Industry-Specific Event Filters
      • Using the Snowflake Retail Sample Dataset
      • Tutorials
        • Filtering and Finding Relevant Events
        • Improving Demand Forecasting Models with Event Features
        • Using Event Data in Power BI
        • Using Event Data in Tableau
        • Connecting to PredictHQ APIs with Microsoft Excel
        • Loading Event Data into a Data Warehouse
        • Displaying Events in a Heatmap Calendar
        • Displaying Events on a Map
    • Tutorials by Use Case
      • Demand Forecasting with ML Models
      • Dynamic Pricing
      • Inventory Management
      • Workforce Optimization
      • Visualization and Insights
  • Integrations
    • Integration Guides
      • Keep Data Updated via API
      • Integrate with Beam
      • Integrate with Loop Links
    • Third-Party Integrations
      • Receive Data via Snowflake
        • Example SQL Queries for Snowflake
        • Snowflake Data Science Guide
          • Snowpark Method Guide
          • SQL Method Guide
      • Receive Data via AWS Data Exchange
        • CSV/Parquet Data Structure for ADX
        • NDJSON Data Structure for ADX
      • Integrate with Databricks
      • Integrate with Tableau
      • Integrate with a Demand Forecast in PowerBI
      • Google Cloud BigQuery
    • PredictHQ SDKs
      • Python SDK
      • Javascript SDK
  • API Reference
    • API Overview
      • Authenticating
      • API Specs
      • Rate Limits
      • Pagination
      • API Changes
      • Attribution
      • Troubleshooting
    • Events
      • Search Events
      • Get Event Counts
    • Broadcasts
      • Search Broadcasts
      • Get Broadcasts Count
    • Features
      • Get ML Features
    • Forecasts
      • Models
        • Create Model
        • Update Model
        • Replace Model
        • Delete Model
        • Search Models
        • Get Model
        • Train Model
      • Demand Data
        • Upload Demand Data
        • Get Demand Data
      • Forecasts
        • Get Forecast
      • Algorithms
        • Get Algorithms
    • Beam
      • Create an Analysis
      • Upload Demand Data
      • Search Analyses
      • Get an Analysis
      • Update an Analysis
      • Partially Update an Analysis
      • Get Correlation Results
      • Get Feature Importance
      • Refresh an Analysis
      • Delete an Analysis
      • Analysis Groups
        • Create an Analysis Group
        • Get an Analysis Group
        • Search Analysis Groups
        • Update an Analysis Group
        • Partially Update an Analysis Group
        • Refresh an Analysis Group
        • Delete an Analysis Group
        • Get Feature Importance for an Analysis Group
    • Demand Surge
      • Get Demand Surges
    • Suggested Radius
      • Get Suggested Radius
    • Saved Locations
      • Create a Saved Location
      • Search Saved Locations
      • Get a Saved Location
      • Search Events for a Saved Location
      • Update a Saved Location
      • Delete a Saved Location
    • Loop
      • Loop Links
        • Create a Loop Link
        • Search Loop Links
        • Get a Loop Link
        • Update a Loop Link
        • Delete a Loop Link
      • Loop Settings
        • Get Loop Settings
        • Update Loop Settings
      • Loop Submissions
        • Search Submitted Events
      • Loop Feedback
        • Search Feedback
    • Places
      • Search Places
      • Get Place Hierarchies
  • WebApp Support
    • WebApp Overview
      • Using the WebApp
      • API Tools
      • Events Search
      • How to Create an API Token
    • Getting Started
      • Can I Give PredictHQ a Go on a Free Trial Basis?
      • How Do I Get in Touch if I Need Help?
      • Using AWS Data Exchange to Access PredictHQ Events Data
      • Using Snowflake to Access PredictHQ Events Data
      • What Happens at the End of My Free Trial?
      • Export Events Data from the WebApp
    • Account Management
      • Managing your Account Settings
      • How Do I Change My Name in My Account?
      • How Do I Change My Password?
      • How Do I Delete My Account?
      • How Do I Invite People Into My Organization?
      • How Do I Log In With My Google or LinkedIn Account?
      • How Do I Update My Email Address?
      • I Signed Up Using My Google/LinkedIn Account, but I Want To Log In With My Own Email
    • API Plans, Pricing & Billing
      • Do I Need To Provide Credit Card Details for the 14-Day Trial?
      • How Do I Cancel My API Subscription?
      • Learn About Our 14-Day Trial
      • What Are the Definitions for "Storing" and "Caching"?
      • What Attribution Do I Have To Give PredictHQ?
      • What Does "Commercial Use" Mean?
      • What Happens If I Go Over My API Plan's Rate Limit?
    • FAQ
      • How Does PredictHQ Support Placekey?
      • Using Power BI and Tableau With PredictHQ Data
      • Can I Download a CSV of Your Data?
      • Can I Suggest a New Event Category?
      • Does PredictHQ Have Historical Event Data?
      • Is There a PredictHQ Mobile App?
      • What Are Labels?
      • What Countries Do You Have School Holidays For?
      • What Do The Different Event Ranks Mean?
      • What Does Event Visibility Window Mean?
      • What Is the Difference Between an Observed Holiday and an Observance?
    • Tools
      • Is PHQ Attendance Available for All Categories?
      • See Event Trends in the WebApp
      • What is Event Trends?
      • Live TV Events
        • What is Live TV Events?
        • Can You Access Live TV Events via the WebApp?
        • How Do I Integrate Live TV Events into Forecasting Models?
      • Labels
        • What Does the Closed-Doors Label Mean?
    • Beam (Relevancy Engine)
      • An Overview of Beam - Relevancy Engine
      • Creating an Analysis in Beam
      • Uploading Your Demand Data to Beam
      • Viewing the List of Analysis in Beam
      • Viewing the Table of Results in Beam
      • Viewing the Category Importance Information in Beam
      • Feature Importance With Beam - Find the ML Features to Use in Your Forecasts
      • Beam Value Quantification
      • Exporting Correlation Data With Beam
      • Getting More Details on a Date on the Beam Graph
      • Grouping Analyses in Beam
      • Using the Beam Graph
      • Viewing the Time Series Impact Analysis in Beam
    • Location Insights
      • An Overview of Location Insights
      • How to Set a Default Location
      • How Do I Add a Location?
      • How Do I Edit a Location?
      • How Do I Share Location Insights With My Team?
      • How Do I View Details for One Location?
      • How Do I View My Saved Locations as a List?
      • Search and View Event Impact in Location Insights
      • What Do Each of the Columns Mean?
      • What Is the Difference Between Center Point & Radius and City, State, Country?
Powered by GitBook

PredictHQ

  • Terms of Service
  • Privacy Policy
  • GitHub

© 2025 PredictHQ Ltd

On this page
  • What is an Analysis?
  • Why group Analyses?
  • How to effectively create Groups
  • How to create Group Analyses in Beam
  • How to use Category Importance
  • Considerations and Watchouts

Was this helpful?

  1. WebApp Support
  2. Beam (Relevancy Engine)

Grouping Analyses in Beam

PreviousGetting More Details on a Date on the Beam GraphNextUsing the Beam Graph

Last updated 1 month ago

Was this helpful?

What is an Analysis?

An Analysis in is an evaluation of a particular demand data set for a specific location and date range. This can be created in the from any location you define or one of your saved locations in . Alternatively, you can create Analyses at scale via the .

Why group Analyses?

While single Analyses are ideal, offering insights tailored to each store or location, grouping Analyses can present a more practical approach as it provides a manageable, aggregated view across multiple stores or locations. This can be useful for businesses, such as retail chains, that manage operations at a regional or state level. Group Analyses support these operations, like marketing campaigns, inventory management, and demand forecasting, by delivering aggregated insights consolidated across all stores.

How to effectively create Groups

Creating groups within Beam requires careful thought and consideration. Follow these guidelines for optimal results:

  1. Group Size: Include at least two Analyses in a Group.

  2. Location Replication: Prevent unwanted bias by ensuring each Analysis within a Group corresponds to a unique store or location.

  3. Demand Consistency: Ensure all Analysis within a Group are based on the same demand and unit of measurement. For example, in-store pizza sales in $US.

  4. Country Consistency: Ensure all stores or locations are within the same country to maintain a level of homogeneity.

  5. Temporal Consistency: Aim for either identical, or at least, substantial overlap in date ranges across Analyses.

  6. Industry Consistency: Ensure all Analyses in a Group are from the same industry, such as accommodation, hospitality, retail, or parking.

  7. Group Membership: Define Groups based on meaningful criteria that offer strategic value. Common grouping parameters include:

    • Geographical Location: e.g. by state, region, or city.

    • Type of Area: e.g. urban or rural areas.

    • Store Characteristics: e.g. standalone or inside a mall.

    • Performance: e.g. high, medium or low sales.

How to create Group Analyses in Beam

At least two Analyses are required to create a meaningful Group. First create Analyses, then create Groups.

Analyses:

  • Analysis name: This user-defined field serves labeling and identification purposes. Incorporating group membership details into the Analysis name helps in identifying relevant Analyses, thereby speeding up the group creation step. For example, ‘groupA__store123__instore_pizza_sales__2022’.

Groups:

  • User-defined grouping: Users can define their own Groups based on business needs.

  • Flexible group membership: An Analysis can be part of more than one Group, providing greater flexibility.

How to use Category Importance

As with single Analyses, the important categories highlight key drivers of demand for your stores or locations, though with a more generalized view. Different strategic actions can be taken based on these insights, for example:

  1. Improved demand forecasting accuracy:

  2. Informed marketing strategies:

    • Run targeted campaigns to capitalize on events occurring near your stores or locations, taking advantage of the buzz around events.

    • Run off-season promotions during quiet periods to stimulate demand and maintain customer engagement.

  3. Partnerships and sponsorships:

    • Collaborate with event organizers or related businesses for cross-promotional opportunities.

  4. Tailored product offerings:

    • Develop and offer products or services that align with the interests and needs of customers attending these events.

Considerations and Watchouts

  1. Impact of demand share: The aggregation of Category Importance assigns weight to analyses based on their average daily demand, naturally giving more weight to those with a higher demand. This approach is designed to reflect the real-world impact of each analysis. If more balanced results are desired, consider grouping analyses with comparable levels of demand to prevent any single analysis dominating the overall results.

Analysis creation: can be created in the or via the .

Group creation: Groups can be created in the by selecting specific Analyses or via the by passing a list of Analysis IDs.

Category importance at the group-level follows a similar interpretation as that of single . It represents a weighted aggregation of the Category Importance from each contributing Analysis, where the weights are proportional to the average daily demand of each. This gives more influence to Analyses with a larger share of the overall group demand.

Integrate Category Importance results using the and by introducing specific event features to your models. See for an example of how to get features for all your stores or locations.

Integration with Features API: The provides a list of features for each important category, which can be incorporated into your models via the . Ideally, these features should be tailored to the store or location of interest but using group-level features is a viable alternative if store or location-level modeling is impractical. However, this may lead to some stores or locations having features that are entirely zeros, which is something to consider and take into account.

Beam
WebApp
Location Insights
Beam API
Analyses
WebApp
Beam API
WebApp
Beam API
Analyses
Beam API
Features API
this notebook
Beam API
Features API