https://github.com/gradr-dev/gradr_lib
Utilities for converting and detecting climbing grading systems
https://github.com/gradr-dev/gradr_lib
bouldering calculator climbing climbing-grades converter detect grades grading-system lead sport-climbing
Last synced: 4 months ago
JSON representation
Utilities for converting and detecting climbing grading systems
- Host: GitHub
- URL: https://github.com/gradr-dev/gradr_lib
- Owner: gradr-dev
- License: mit
- Created: 2022-01-16T11:55:36.000Z (over 4 years ago)
- Default Branch: main
- Last Pushed: 2022-07-17T10:11:27.000Z (almost 4 years ago)
- Last Synced: 2025-10-23T01:26:45.142Z (8 months ago)
- Topics: bouldering, calculator, climbing, climbing-grades, converter, detect, grades, grading-system, lead, sport-climbing
- Language: Dart
- Homepage:
- Size: 436 KB
- Stars: 4
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
README
Convert climbing grading systems with a really simple interface.
[](https://pub.dev/packages/gradr_lib)
---
> WORK IN PROGRESS, use at your own risk.
Have you ever needed to convert from one grading system to another? and had to implement the calculations by yourself? `gradr_lib` offers utilities for converting climbing grading systems with a really simple interface so you don't have to reinvent the wheel.
The library was initial going to be developed for the [Gradr App]() I've also created, but thought it might be cool to make it open-source and let the community use it and hopefully help improve it too!
> Gradr does all it can to make sense of the differences and inconsistencies between grading systems, so take note that converting from one grading system to another might not always be acurate.
> You can take a look at [this]() writup on how gradr handles this. Feel free to offer any advice or help in this regard!
## Features
* Grading systems
* [x] V-Scale
* [x] Font
* [x] French
* [x] YDS
* [ ] South africa
* [ ] Brazil
* [ ] UK
* [ ] IRCRA
* [ ] UIAA
* ...
* [x] Conversion between grading systems
* [x] Grading system detector
## Getting started
To install the package check the install [guide](https://pub.dev/packages/gradr_lib/install)
## Usage
### Convert between Grading Systems
Here is an example on how to convert from V-Scale to Font scale and viceversa, using GradeCalculator:
```dart
final vToFont = GradeCalculator(
systemA: verminGradeSystem,
systemB: fontGradeSystem,
);
// Convert from grading system A (vScale) to system B (fontScale)
vToFont.atob(
vScale.findByName('V3')
);
// > 6B
// Convert from grading system B (fontScale) to system A (vScale)
vToFont.btoa(
fontScale.findByName('6B')
);
// > V3
```
You can also convert using the from-to interface, as follows:
```dart
fontGradeSystem.convert('v3').from(verminGradeSystem); // 6b
fontGradeSystem.convert('6b').to(verminGradeSystem); // v3
```
### Detect Grading System
Gradr also offers a utility to detect grading systems.
```dart
final detector = GradeSystemDetector(
detectors: [
VScaleGradeDetector(),
FontGradeDetector(),
FontGradeDetector(),
],
);
GradeDetectorResult detectedResult = detector.detect(grade);
// A list of posible grading systems is returnes in the result
detectedResult.detectedSystems;
// It also returns a list of "formalized" grades (instance of Gradr Grade class).
detectedResult.formalizedGrades;
// It also returns the original input
detectedResult.originalInput;
```
* Note that the GradeSystemDetector allows you to pass in the detectors you need, and/or custom detectors.
## Need Gradr for another platform?
You might be in luck, at gradr we're trying to offer the libraries for most common languages and frameworks. Take a look and see if the one you need is already done.
* [x] Dart
* [ ] JavaScript
* [ ] React
* [ ] Angular
* [ ] Ionic
* [ ] Vue
* [ ] Java
* [ ] PHP
> If your platform or language is missing, feel free to file an issue and we will try to implement it. Or if you feel like it and have the time, you can contact us to help build it, we love that kind of stuff! :heart:
## Additional info
There are some examples [here](https://github.com/nombrekeff/gradr_lib/tree/main/example) and [here](https://github.com/nombrekeff/gradr_lib/tree/main/test).
If you encounter any problems or fancy a feature to be added please head over to the GitHub [repository](https://github.com/nombrekeff/gradr_lib/) and [drop an issue](https://github.com/nombrekeff/gradr_lib/issues/new).
## Support the project
I tend to open source anything I can, and love to help people that might need help with the project.
If you are using this project and are happy with it or just want to encourage me to continue creating stuff, there are few ways you can do so:
- Starring and sharing the project 🚀
- Reporting bugs 🐛
- Sending feedback
- Or even coding :P
Thanks! ❤️