Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/sonodar/doubles-member-generator

Badminton Club Private Game Scheduler
https://github.com/sonodar/doubles-member-generator

Last synced: 28 days ago
JSON representation

Badminton Club Private Game Scheduler

Awesome Lists containing this project

README 

        
# [バドミントンダブルスメンバー決めるくん](https://badminton.sonodar.net)



バドミントンサークルなどでコートのメンバーをランダムにアサインするためのツールです。  

なるべく似通った組み合わせが連続しないように工夫しています。



### 仕様



- バドミントンのサークル活動において、参加者全員でダブルスゲームをする際にコートに入るメンバーをランダムで調整する。

- サークルの時間内でできるゲーム数は 1 回だけではない。時間が許す限り何度もゲームを行う。

- 1 ゲームあたりの所要時間は一定ではないため、時間やゲーム数はパラメータとはならない。

- メンバー各人には 1 〜 参加人数 までの数値が一意に割り振られている（システム外で割り当てる）。

- ダブルスなので、コート内に入れるメンバー 1 コートあたり 4 人とする。

- ダブルスのペアはこの機能では決めない（コート内に入った 4 人がじゃんけんなどで決定する）。

- なるべく重複が発生しないように、コート内に入るメンバーの組み合わせをすべての履歴と照らし合わせて、編集距離がなるべく大きくなるようにする。

- なるべくコート内にずっと入れないメンバーが発生しないようにする（例えば、3 連続でコートに入れない、などが発生しづらいようにする）。



## アルゴリズム



- 履歴がない場合（最初の1回目）は完全にランダム。

- ランダム選出を何度か繰り返し、その中から似通った履歴がないものを選出します。かつ、各メンバーのプレイ回数がなるべく平準化されるようにします。

  - 繰り返す回数は現在のメンバー数によって異なります（チューニング予定）。

  - 履歴と似通っているかどうかの判定は編集距離を用います。コートとコートに入るメンバーは二次元の数値配列です。二次元配列の編集距離は以下のように求めます。

    - コートメンバーの配列は順序が異なっても同じとして扱うため、まず二次元配列を一定の規則に従ってソートします。

    - 二次元配列を flat で一次元配列に変換して、動的計画法により編集距離を求めます。

  - 各メンバーのプレイ回数を平準化するために以下の方法で複数のランダム選出された配列の中からもっとも平準化されそうなものを選びます。

    - 各プレイヤーのプレイ回数の、最大値と最小値の差が一番小さいものを選出します。

    - 最大値と最小値の差が同値のものは、各プレイヤーのプレイ回数の標準偏差がもっとも小さいものを選出します。

    - 遅れて参加した場合は参加時点での他のプレイヤーの参加回数の最頻値を補正値として保持し、上記計算時にはその値を加算します。

- このアルゴリズムは、履歴やメンバー数が多くなると指数関数的に計算量が増えます。履歴数が少ない（そんなに何度も試合できない）ことを前提としています。



> このアルゴリズムは暫定です。もっと良いアルゴリズムがあるかもしれないので（コントリビュート歓迎）。



## 改善要望



このリポジトリで Issue を立てるか、X(旧Twitter)の[@𝕤𝕠𝕟𝕠𝕕𝕒𝕣](https://x.com/ryoryoryohei) にメンションしてください。