Module ndarray 

Dense numeric feature extraction: build an ndarray::Array2 of replay features for ML/analytics.

What feature adders are

A NDArrayCollector runs the replay frame by frame and, for each sampled frame, asks a list of feature adders to append their numbers to that frame’s row. Each adder owns a fixed set of named columns and knows how to compute them from the current ProcessorView (and, for analysis-backed adders, from analysis-graph state). The collector concatenates every adder’s columns into one wide matrix plus a header list, so the set of adders you choose is your feature schema.

There are two flavours, each in a global and a per-player form:

• FeatureAdder / PlayerFeatureAdder — compute directly from frame and processor state.
• AnalysisFeatureAdder / AnalysisPlayerFeatureAdder — additionally read AnalysisGraph state, declaring their node dependencies so the collector wires up the graph.

The LengthChecked* trait variants let an adder fix its column count at compile time. Player adders emit their columns once per player.

Registering adders

• Explicitly: construct adders and pass them to the collector (see the builder methods on NDArrayCollector).
• By name: NDArrayCollector::from_strings / from_strings_typed look up adders in a built-in string registry — convenient for the Python/JS bindings.

Recognized global (ball / game) names include BallRigidBody, BallRigidBodyNoVelocities, BallRigidBodyQuaternions, BallRigidBodyBasis, InterpolatedBallRigidBodyNoVelocities, CurrentTime, FrameTime, SecondsRemaining, and BallHasBeenHit. Recognized per-player names include PlayerRigidBody, PlayerRigidBodyNoVelocities, PlayerRelativeBallPosition, PlayerLocalRelativeBallVelocity, PlayerBoost, PlayerJump, PlayerAnyJump, PlayerDodgeRefreshed, PlayerDemolishedBy, and PlayerBallDistance. Analysis-backed per-player event features are also addressable by mechanic name (e.g. touch, flick, whiff, bump, pass, rotation, movement, positioning). The matching arms in collector.rs and analysis_builtins.rs are the authoritative list.

Re-exports

pub use ::derive_new;

pub use ::paste;

Macros

analysis_global_feature_adder

Implements the ndarray traits for an existing analysis-backed global feature type.

analysis_player_feature_adder

Implements the ndarray traits for an existing analysis-backed per-player feature type.

build_analysis_global_feature_adder

Declares a new analysis-backed global feature-adder type.

build_analysis_player_feature_adder

Declares a new analysis-backed per-player feature-adder type.

build_global_feature_adder

Declares a new global feature-adder type and wires it into the ndarray traits.

build_player_feature_adder

Declares a new per-player feature-adder type and wires it into the ndarray traits.

convert_all

Converts a fixed list of values with a caller-supplied error mapper.

convert_all_floats

Converts a fixed list of float-like values using convert_float_conversion_error.

global_feature_adder

Implements the ndarray feature-adder traits for an existing global feature type.

impl_analysis_feature_adder

Implements AnalysisFeatureAdder for a fixed-width analysis-backed type.

impl_analysis_player_feature_adder

Implements AnalysisPlayerFeatureAdder for a fixed-width analysis-backed type.

impl_feature_adder

Implements FeatureAdder for a type that already satisfies LengthCheckedFeatureAdder.

impl_player_feature_adder

Implements PlayerFeatureAdder for a type that satisfies LengthCheckedPlayerFeatureAdder.

player_feature_adder

Implements the ndarray feature-adder traits for an existing per-player feature type.

Structs

AnalysisFeatureContext

Typed, read-only view of analysis state available to analysis-backed features.

AnalysisPlayerBallCarries

AnalysisPlayerBoostPickups

AnalysisPlayerBoostRespawns

AnalysisPlayerBumps

AnalysisPlayerCeilingShots

AnalysisPlayerCenters

AnalysisPlayerDodgeResets

AnalysisPlayerDoubleTaps

AnalysisPlayerFeatureInput

Arguments supplied to object-safe per-player analysis feature adders.

AnalysisPlayerFlicks

AnalysisPlayerFlipImpulses

AnalysisPlayerFlipResetDodges

AnalysisPlayerHalfFlips

AnalysisPlayerHalfVolleys

AnalysisPlayerMovementEvents

AnalysisPlayerOneTimers

AnalysisPlayerPasses

AnalysisPlayerPositioningEvents

AnalysisPlayerPowerslides

AnalysisPlayerRotationEvents

AnalysisPlayerSpeedFlips

AnalysisPlayerTouches

AnalysisPlayerWallAerialShots

AnalysisPlayerWallAerials

AnalysisPlayerWavedashes

AnalysisPlayerWhiffs

BallHasBeenHit

BallRigidBody

BallRigidBodyBasis

BallRigidBodyNoVelocities

BallRigidBodyQuaternionVelocities

BallRigidBodyQuaternions

CurrentTime

DynamicAnalysisFeatureAdder

DynamicAnalysisPlayerFeatureAdder

FrameTime

InterpolatedBallRigidBodyNoVelocities

Global feature adder that samples an interpolated ball rigid body.

InterpolatedPlayerRigidBodyNoVelocities

Per-player feature adder that samples an interpolated car rigid body.

NDArrayCollector

Collects replay frames into a dense 2D feature matrix.

NDArrayColumnHeaders

Column headers for the frame matrix emitted by NDArrayCollector.

PlayerAnyJump

PlayerBallDistance

PlayerBoost

PlayerDemolishedBy

PlayerDodgeRefreshed

PlayerJump

PlayerLocalRelativeBallPosition

PlayerLocalRelativeBallVelocity

PlayerRelativeBallPosition

PlayerRelativeBallVelocity

PlayerRigidBody

PlayerRigidBodyBasis

PlayerRigidBodyNoVelocities

PlayerRigidBodyQuaternionVelocities

PlayerRigidBodyQuaternions

ReplayMetaWithHeaders

Replay metadata bundled with the ndarray column layout used to produce it.

ReplicatedGameStateTimeRemaining

ReplicatedStateName

SecondsRemaining

VelocityAddedBallRigidBodyNoVelocities

VelocityAddedPlayerRigidBodyNoVelocities

Enums

NDArrayFeatureAdder

NDArrayPlayerFeatureAdder

Traits

AnalysisFeatureAdder

Object-safe interface for frame-level features backed by the analysis graph.

AnalysisPlayerFeatureAdder

Object-safe interface for per-player features backed by the analysis graph.

FeatureAdder

Object-safe interface for frame-level feature extraction.

LengthCheckedAnalysisFeatureAdder

Fixed-width analysis-backed feature extractor with compile-time column count validation.

LengthCheckedAnalysisPlayerFeatureAdder

Fixed-width per-player analysis-backed feature extractor.

LengthCheckedFeatureAdder

Fixed-width feature extractor with compile-time column count validation.

LengthCheckedPlayerFeatureAdder

Fixed-width per-player feature extractor with compile-time column count validation.

PlayerFeatureAdder

Object-safe interface for per-player feature extraction.

Functions

convert_float_conversion_error

Maps arbitrary conversion failures into a generic float-conversion error.

dynamic_analysis_feature_adder

dynamic_analysis_player_feature_adder

get_rigid_body_properties

Converts a rigid body into position, Euler rotation, and velocity features.

get_rigid_body_properties_basis

Converts a rigid body into position, basis vectors, and velocity features.

get_rigid_body_properties_no_velocities

Converts a rigid body into position and quaternion-rotation features only.

get_rigid_body_properties_quaternion

Converts a rigid body into position, quaternion rotation, and velocity features.

Type Aliases

NDArrayFeatureAdders

NDArrayPlayerFeatureAdders