Narzędzie oceny siły rąk brydżowych w oparciu o algorytmy licytacji naturalnej Łukasza Sławińskiego
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
bin
tests
web
LICENSE
README.md
index.php
osika.zip

README.md

OSiKa

Narzędzie oceny siły rąk brydżowych w oparciu o algorytmy licytacji naturalnej Łukasza Sławińskiego

Wymagania systemowe

Wersja konsolowa:

  • interpreter PHP 5.4+ z modułem JSON

Wersja interaktywna (WWW), dodatkowo:

Instalacja

Wersja konsolowa:

Wystarczające jest ściągnięcie paczki z głównego katalogu repozytorium albo ręczne ściągnięcie całości katalogu /bin/ z repozytorium.

Wersja interaktywna:

Po ściągnięciu z repozytorium katalogów /web/ oraz /bin/, należy:

  • umieścić zawartość katalogu /web/ w miejscu dostępnym dla serwera WWW
  • w podkatalogu /web/lib/ umieścić wymagane biblioteki JavaScript (niedostarczane z aplikacją)
  • jeśli potrzeba, w pliku /web/index.html edytować ścieżki do bibliotek JavaScript
  • w pliku /web/osika.php edytować linię rozpoczynającą się od require_once tak, aby wskazywała na odpowiedni plik katalogu /bin/lib/

Użycie

Wersja konsolowa:

W katalogu instalacji wydać polecenie:

php osika [OPCJE] REKA

Dodatkowo, w systemach uniksowych, po nadaniu praw do wykonywania dla pliku /bin/osika, możliwe jest bezpośrednie wywołanie:

./osika [OPCJE] REKA

REKA

Dane wejściowe - zawartość ręki. Wszystkie 13 kart w formacie przecinkowym, tj. xxx,xxx,xxxx,xxx. Dodatkowo:

  • ignorowane są białe znaki.
  • wielkość liter nie ma znaczenia
  • ręka musi zawierać 13 kart
  • x oznacza dowolną blotkę (ale cyfry również dozwolone)
  • Dama = Q/D, Walet = J/W, 10 = 10/T
  • w pojedynczym kolorze nie mogą duplikować się honory ani 9
  • kolejność kart w kolorze nie ma znaczenia
  • blotki nie są weryfikowane (kolor może posiadać zduplikowane blotki, może też posiadać niemożliwą liczbę blotek, np. 10)

OPCJE

-h, --help: wyświetlają instrukcję obsługi

-f FORMAT, --format FORMAT: format wyników programu; dostępne wartości: raw, table, json; wartość domyślna: table

-s KOLORY, --suits KOLORY: lista kolorów, dla których podawane są wyniki (rozdzielona przecinkami); dostępne wartości: s, h, d, c, total, all; wartość domyślna: all

-c KATEGORIE, --categories KATEGORIE: lista składników analizy siły ręki (rozdzielona przecinkami); dostępne wartości wymienione są w pomocy programu (php osika -h); wartość domyślna: all

Wersja interaktywna:

Się wpisuje, się klika i się wyświetla.

Podziękowania i autorstwo

Autorem algorytmów licytacji naturalnej (w tym algorytmu oceny siły karty OSiKa) jest Łukasz Sławiński (Pikier).

Program powstał z pomysłu i przy aktywnym współudziale użytkowników forumbridge.pl, w szczególności:

  • Tomasza Radko (TRad)
  • Marka Walczaka (walec)

Autorem kodu źródłowego jest Michał Klichowicz (mkl).

Licencja

Program udostępniany jest na licencji GPL wersji 2.

Szczegóły licencji znajdują się w pliku LICENSE


She said, do me a favour, and stop flattering yourself.