Skip to content

Latest commit

 

History

History
95 lines (63 loc) · 3.19 KB

README.md

File metadata and controls

95 lines (63 loc) · 3.19 KB
Raw

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.