How to Detect Basketball Movement Profile (BMP) Metrics

Setting up to Detect Basketball Movement Profile (BMP) Metrics

• Download and install OpenField Console version 3.13.0 or higher.

Setting Device Location

The Basketball Movement Profile has been engineered to detect and categorise basketball movements for devices that are located either in a Catapult vest, or on the athlete's waist.

The Device Location is set at the Team level in OpenField Cloud.

For the most accurate BMP results, it is important to set the correct Device Location before processing device data.

To set the Device Location:

1. Log into OpenField Cloud.
2. Navigate to Settings > Teams > select desired team.
3. Scroll down to Device Location.
4. Select the desired Device Location, either Vest or Waist.
5. Select Save Changes.
   
6. In OpenField Console, run a Sync to sync down Device Location settings changes.

Detecting and Viewing Basketball Movement Profile Metrics in OpenField Cloud

BMP metrics are available to be viewed and reported on Post-download via OpenField Cloud.

For information on how to detect Indoor Jumps Live and Post in OpenField Console and Cloud, see How to Detect Indoor Analytics.

1. In OpenField Console, download and process sessions from devices or reprocess desired historical raw files
   For more information see Downloading data from devices and Reprocessing Raw Files.
2. Perform a Sync to upload BMP data to OpenField Cloud.
3. Log in to OpenField Cloud.
4. In a dashboard, create a Cloud widget with any of the parameters in the Basketball or Indoor Analytics category, then load your desired activities for analysis.
    
   Please see Cloud Widgets for more information.

Viewing Basketball Movement Profile Events in Connect API

Individual Basketball Movement Profile events per athlete (per activity or period) can be retrieved via our Connect API via the /events API endpoint.

Each BMP event will return the following attributes:

• basketball_load - with a value displaying the basketball load acquired during the BMP event
• movement_type - with a value that represents the detected BMP movement type
• jump_attribute - if the BMP movement type is a Jump then this attribute will be returned with a value displaying the jump width in centiseconds

An example partial API response containing these attributes is below:

...
{
  "start_time": 1707836548.66,
  "end_time": 1707836549.62,
  "version": "2.3",
  "movement_type": 104,
  "basketball_load": 0.87511,
  "jump_attribute": 91
},
...

For more information on the Connect API and the Basketball events please see our Connect API documentation.

Basketball Movement Profile Parameter Definitions

Basketball Parameter definitions can be found in Basketball Movement Profile (BMP) Parameter Definitions.