From 33e57c836588db9bba2adefadfd62b257b5dcbd5 Mon Sep 17 00:00:00 2001
From: Cookie <58516648+Cookie-CHR@users.noreply.github.com>
Date: Wed, 10 Jun 2020 11:06:32 +0200
Subject: [PATCH] Update README.md

Ampliata relazione
---
 README.md | 68 +++++++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 68 insertions(+)

diff --git a/README.md b/README.md
index b34d5fa..a01874e 100644
--- a/README.md
+++ b/README.md
@@ -3,3 +3,71 @@
 Questo progetto estende il progetto [`2-base`](https://github.com/Steffo99/turtle007/tree/2-base) aggiungendo due pozze di veleno che uccidono le formiche che provano a raccoglierlo.
 
 Le formiche morte rilasciano feromoni "negativi", che invitano le formiche circostanti ad evitare l'area con il veleno.
+
+## Ambiente
+
+### Variabile patches-own
+
+Al modello è stata aggiunta la variabile patches-own `poison`, che indica se quella particolare patch contiene veleno.
+
+### Aggiunte sorgenti di veleno
+
+Sono state aggiunte due sorgenti di veleno, entrambe di range 4:
+
+- poison1, di coordinate (14;-18);
+- poison2, di coordinate (-14;14), particolarmente utile perché si trova sul percorso minimo per andare ad una delle sorgenti di cibo.
+
+### Aggiunta funzione: t-subtract-pheromone
+
+Questa funzione permette di sottrarre una elevata quantità di feromone dall'ambiente, fino a renderlo negativo: per una formica, è l'eqivalente del rilascio di "feromoni di allarme" volti ad allertare le compagne della presenza di veleno.
+
+```to t-subtract-pheromone
+  ask patch-here [
+    set pheromone pheromone - 240
+  ]
+end
+```
+### Modifica funzione: t-paint-patch
+
+```ifelse pheromone >= 0
+    [ set pcolor scale-color pheromone-color pheromone 0 pheromone-max]
+    [ set pcolor scale-color poison-color pheromone 0 pheromone-min]
+```
+
+### Comportamento delle formiche
+
+Il comportamento delle formiche è stato cambiato nei seguenti modi:
+
+#### Aggiunta funzione: `t-is-over-poison`
+
+```to-report t-is-over-poison
+  report ([poison] of patch-here = 1)
+end
+```
+
+#### Aggiunta funzione: `t-try-pick up poison`
+
+```to t-try-pick-up-poison
+  if carrying-food = 0 and t-is-over-poison [
+    t-pick-up-poison
+  ]
+end
+```
+
+#### Aggiunta funzione: `t-pick-up-poison`
+
+```to t-pick-up-poison
+  ask patch-here [
+    set poison 0
+  ]
+  t-subtract-pheromone
+  die
+  rt 180
+end
+```
+
+## Dinamica del sistema
+
+Come nella precedente versione, le formiche vagano alla ricerca di cibo. Se trovano del veleno, lo raccolgono credendolo cibo, e per questo muoiono. Alla loro morte rilasciano una grande quantità di feromoni negativi, in modo da tentare di evitare che le compagne facciano la stessa fine. Per un po' i ferormoni negativi tengono lontane le formiche, ma con il tempo suddetto feromone evapora, e una nuova formica torna a cadere nella trappola.
+
+Tale trappola è molto efficace se messa sul cammino per una fonte di cibo (come è accaduto con poison2): le formiche che trasportano cibo al nido rilasciano feromoni in ogni momento, quindi anche mentre passano sopra al veleno, e questo contribuisce a mitigare l'effetto degli ormoni negativi e a far dirigere ancora più formiche verso la trappola velenosa.