osu-sr-calculator 1.0.0

MrHelix's osu! star rating calculator rewritten for your Python needs

osu_sr_calculator

Package to calculate star rating of any osu beatmap with any mod combination.

Updated on: 19.02.2021

Disclaimer

calculated star ratings may be varying slightly from original values (margin of 0.01)

Yeah, thats a complete bullshit right now, its pretty bugged. For example:

for i in range(10):
    sr = calculateStarRating(filepath='test.osu')
    print(sr)

produces 10 different star rating values:

{'nomod': 5.955382197693518}
{'nomod': 6.109616666952475}
{'nomod': 6.172281009645555}
{'nomod': 6.20557690741399}
{'nomod': 6.225886061332697}
{'nomod': 6.239371401049138}
{'nomod': 6.248839053432763}
{'nomod': 6.255751258545029}
{'nomod': 6.2609497007447885}
{'nomod': 6.264954757521128}

I guess lack of any tests does not help at all.

Usage

from osu_sr_calculator import calculateStarRating
starRating = calculateStarRating(returnAllDifficultyValues, filepath, map_id, mods, allCombinations)

calculateStarRating method accepts these parameters:

• returnAllDifficultyValues: returns total star rating value if False. when set to True, method will also return aim and speed difficulty
• filepath (optional if map_id is set): Path to .osu file
• map_id (optional if filepath is set): BeatmapID number of a beatmap
• mods (optional): Specify which mods to include during star rating calculation
• allCombinations (optional): when set to True, will return star rating of every possible mod combination

Examples

• local file nomod star rating:

starRating = calculateStarRating(filepath='path/to/file.osu')
# Response: { 'nomod': x.xxxx }

• BeatmapID DT star rating:

starRating = calculateStarRating(map_id=123456, mods=['DT'])
# Response: { 'DT': x.xxxx }

• All possible star ratings:

starRatings = calculateStarRating(filepath='path/to/file.osu', allCombinations=True)
# Response:
# {
#     nomod: x.xxxx,
#     DT: x.xxxx,
#     HT: x.xxxx,
#     HR: x.xxxx,
#     HRDT: x.xxxx,
#     HRHT: x.xxxx,
#     EZ: x.xxxx,
#     EZDT: x.xxxx,
#     EZHT: x.xxxx,
# }

• Aim and Speed ratings:

starRatings = calculateStarRating(filepath='path/to/file.osu', returnAllDifficultyValues=True)
# Response:
# {
#     nomod: {
#         aim: x.xxxx,
#         speed: x.xxxx,
#         total: x.xxxx,
#     }
# }