glaivepro/iaafpoints

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

1.2.1 2024-03-19 19:17 UTC

Requires

• php: >=8.0 <8.4

Requires (Dev)

• phpunit/phpunit: >=4.0 <11.0

MIT

• Juris Evertovskis

• iaaf
• track and field
• athletics
• scoring tables
• world athletics

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
• Usage
• Contributing
• Changelog
• License

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.

Contributing

Important

Do not edit anything in data/, edit it in resources/. The files in data/ are auto-generated from files in resources/.

More here.

Changelog

It's here.

License

This package is licensed under the MIT license.