glaivepro/iaafpoints

PHP library to calculate World Athletics (IAAF) scoring points of athletics and World Athletics (IAAF) scoring points for combined events.

1.0.0 2021-05-17 23:55 UTC

This package is auto-updated.

Last update: 2022-06-21 23:02:51 UTC


README

PHP library to calculate World Athletics (IAAF) scoring points of athletics and WA (IAAF) scoring points for combined events. And some other evaluations of track and field results.

IAAF is rolling a rebrand to WA, but we currently have no plans to rename the package or any of classes.

The WA scoring tables that we reproduce are these ones: https://www.worldathletics.org/about-iaaf/documents/technical-information#collapsescoring-tables

This package is used for the stats system of Latvian Athletics Association.

Table of Contents

Installation

Use composer:

composer require glaivepro/iaafpoints

Usage

This package provides mutliple calculators that all provide the same interface.

// Calculator and use-case specific options.
$options = [
	'gender' => 'm',
	'venueType' => 'outdoor',
	'discipline' => '200m',
];

// Create a calculator instance
$calculator = new \GlaivePro\IaafPoints\IaafCalculator($options);

// Evaluate a result getting some points or a class assigned to result.
$points = $calculator->evaluate(21.61);
// 980

// Update options
$calculator->setOptions(['gender' => 'f']);
$points = $calculator->evaluate(21.61);
// 1279

See docs for more details.

Changelog

It's here.

License

This package is licensed under the MIT license.