Overblik over API'et
--------------------

``AgentsPy`` er et bibliotek, der tilbyder værktøjer, som kan bruges til agent-baseret modellering. Agent-baseret modellering fungerer ved først at opbygge et miljø med agenter, der har en prædefineret opførsel, og så simulere hele systemet baseret på agenternes opførsel. Modellen kan så vise, hvordan agenterne interagerer med hinanden, og systemet som helhed. I ``AgentsPy`` kaldes en agent passende for ``Agent``, et "felt" i miljøet kaldes en ``Tile``, og miljøet som helhed kaldes en ``Model``.

For at give agenterne deres prædefinerede opførsel, skal man kode dem. Dette gøres typisk ved først at definere en klasse, som nedarver fra ``Agent``, for eksempel ``Person`` i epidemimodellen. Heri kan man så definere en ``step`` funktion, der beskriver, hvordan agenten opfører sig i et enkelt simulationstrin. Et eksempel kunne være::

  def step(model):
      self.forward()

hvilket rykker agenten et skridt fremad ved hver trin.

Man kan så lave en ``model_step`` funktion, der simulerer alle agenterne i en model::

  def model_step(model):
      for a in model.agents:
	      a.step(model)

Miljøet ændres oftest som en direkte konsekvens af agenternes opførsel. Man kan for eksempel vælge at farve de felter, en agent har besøgt, røde::

  def step(model):
      self.forward()
	  t = self.current_tile()
	  t.color (255, 0, 0)

``AgentsPy`` tilbyder også muligheden for at justere på simulationen undervejs. Man kan for eksempel bruge en knap til at starte og stoppe simulationen::

  model.add_toggle_button("Go", model_step)

De funktioner, der kan bruges til at tilføje elementer til kontrolpanelet, er:

* ``add_button``: Tilføjer en knap, der kan klikkes på gentagne gange.
* ``add_toggle_button``: Tilføjer en knap, der kan slås til og fra.
* ``add_slider``: Tilføjer en bevægelig knap, der kan bruges til at justere værdien af en numerisk variabel i modellen.
* ``add_checkbox``: Tilføjer et afkrydsningsfelt, der kan bruges til at justere værdien af en sandhedsvariabel i modellen.

Ud over funktioner til kontrolpanelet, er der også funktioner som tilføjer forskellige slags grafer til modellen, som løbende viser data, herunder:

* ``line_chart``: Tilføjer en graf med en eller flere linjer, der beskriver modellens variable over tid.
* ``bar_chart``: Tilføjer et søjlediagram, der viser værdien af modellens variable i øjeblikket.
* ``histogram``: Tilføjer et histogram, der viser, hvordan en bestemt variabel for alle agenterne fordeler sig i givne intervaller.
* ``agent_line_chart``: Tilføjer en graf med en linje for hver agent, der viser værdien af denne variabel over tid.
* ``monitor``: Tilføjer et lille felt til kontrolpanelet, der viser værdien for en enkelt variabel i modellen.