cartesian_line_extract

This function generates an array of start and end pairs of x,y co-ordinates to draw straight lines on a plot. This is suitable for visual representation using the create_vector_plot function. This is particularly useful for mapping the locations and directions of specific events or actions on a defined space, such as shots a football pitch.

Basic format: ["cartesian_line_extract", "row_name", [search_criteria], "cartesian_start_name", "cartesian_end_name", "x_max", "y_max"] 

• row_name (string): Specifies the Angles row name of your clips

• search_criteria (list of dictionaries): Defines the conditions that the data must meet to be included

• cartesian_start_name (string): Identifies the name of the 'Start' Cartesian attribute or qualifier to be extracted

• cartesian_end_name (string): Identifies the name of the 'End' Cartesian attribute or qualifier to be extracted

• x_max (value): Defines the maximum value on the x-axis used on the cartesian button in the Angles Markup

• y_max (value): Defines the maximum value on the y-axis used on the cartesian button in the Angles Markup

In the following example, we want to extract the start and end co-ordinates from the attributes named 'LOCATION' and 'LOCATION END' which exist in 'Shot' qualifiers found in the 'In Possession' clips. These co-ordinates will be no larger than 100 for the x value and 100 for the y value:

e.g: "Shot_line_data": ["cartesian_line_extract", "In Possession", [{"Event":"Shot"}], "LOCATION", "LOCATION END", 100, 100]