Hjælpeprogram til skoleskibet Georg Stage
Project description
Georg Stage vagtplanlægger
Version 0.2.1
Dette er et hjælpeprogram til vagtplanlægning ombord på Georg Stage (søvagter). Matematikken bag programmet benytter lineær programming (LP) til at optimere vagterne, således at alle opgaver varetages, samtidigt med at opgaverne fordeles mellem gasterne så fair som muligt.
Installation
Til lokal udvikling:
pip install -e '.[test]'
Kør tests:
make test
make lint
Start program:
make run_local
# or
python src/cli.py
Publicer ny version
Husk altid at køre tests før du publicerer. TODO: automatiser tests
Kør test:
# pip install -e '.[test]'
make lint
make test
Hvis en version er tagget med 'v*', f.eks. 'v0.0.1', så vil en Github action sørge for at der bliver bygget executables til Windows og Mac OS.
# Husk: skift version til den rigtige
git tag v0.0.1 master
git push origin v0.0.1
Brugervejledning
Kommer snart...
Kode eksempler
Hvis du kan kode Python, kan du bruge Georg Stages API via kode.
Auto-udfyldning:
from georgstage import GeorgStage, Opgave, Vagt
import pandas as pd
# initialiser GeorgStage med kode
vagter = [
Vagt(dato='2021-05-01', vagt_tid=0, gast=1, opgave=Opgave.VAGTHAVENDE_ELEV),
Vagt(dato='2021-05-01', vagt_tid=0, gast=2, opgave=Opgave.ORDONNANS),
Vagt(dato='2021-05-01', vagt_tid=0, gast=3, opgave=Opgave.RORGAENGER),
Vagt(dato='2021-05-01', vagt_tid=0, gast=4, opgave=Opgave.UDKIG)
]
gs = GeorgStage(vagter)
# fyld et par uger ud automatisk
for dt in pd.date_range(start='2021-05-01', end='2021-05-14', closed=None).date:
print(dt)
fill_result = gs.autofill(dt)
if fill_result.status == 1:
gs[dt] = fill_result.vagter
# Check antal dage:
print(f'Antal dage = {len(gs)}')
Load og save:
# Create gs from other gs
gs2 = GeorgStage(gs.get_vagter())
# Create gs from dataframe
gs3 = GeorgStage.from_dataframe(gs.to_dataframe())
# Save GeorgStage til file
gs.to_dataframe().to_csv('vagter.csv', index=False)
# Load GeorgStage fra file (CSV)
df_vagter = pd.read_csv('vagter.csv')
gs4 = GeorgStage.from_dataframe(df_vagter)
Diverse:
# Eksporter som dataframe (Pandas)
gs.to_dataframe()
# Eksporter som liste af vagter
gs.get_vagter()
# Eksporter datoer
gs.get_datoer()
Regler vedr. vagter på Georg Stage
Regler for søvagter, som gælder delvist for ankervagter:
- Elever er organiseret i 3 skifter (holod) med 20 gaster (elever) på hver
- Skifte 1: gaster 1-20
- Skifte 2: gaster 21-40
- Skifte 3: Gaster 41-60
- Gaster 61-63 er kokke elever og er altid i køkkenet.
- Vagterne er går igen i 6 perioder per dag, som fordeles på skifte 1-3, så hver
skifte får to perioder per dag
- Klokken 00 - 04
- Klokken 04 - 08
- Klokken 08 - 12
- Klokken 12 - 16
- Klokken 16 - 20
- Klokken 20 - 24
- Det skal være fair, så alle få alle poster cirka lige mange gange
- De faste vagter er
- Der er 1 kvartermester til hver skifte
- Der er 1 udkig til hver skifte
- Der er 1 rorgænger til hver skifte
- Der er 1 ordonnans til hver skifte
- Der er 1 vagthavende elev til hver skifte
- De særlige vagter er:
- Der er 1 dækselev i kabys, kun 8-12 (morgenmad), 12-16 (frokost), 16-20 (aftensmad)
- Den vagthavende elev er den samme gast både morgen og aften, går på tur, dag for dag, også når skifterne får nye vagter.
- Pejlegast A fra dagen før, er pejlegast B dagen efter.
- pejlegaster findes kun på 16-20 vagten
- Der er udvalgte gaster der udtages til håndværksmæssig uddannelse hver dag.
Der findes også ankervagter, men det kører en smule anderledes.
Til udviklere
Sådan kører du tests
Ved hjælp af make:
make test
Sådan publicerer du en ny version
Trin (kan måske forbedre):
- Opdater version and download_url felter i setup.py
- Kør git add + commit + push
- Opret ny release på GitHub (check source-code link, skal matche download_url i setup.py)
- Kør
python setup.py sdist
- Kør
twine upload dist/* --verbose
(hvis ej installet, kørpip install twine
først)
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.