each time it's used, so changes depending on the state of the engine.
See http://ccl.northwestern.edu/netlogo/docs/dictionary.html#patches"
- *patches*)
+ :patches)
(defun turtles ()
"TURTLES => ALL-TURTLES
each time it's used, so changes depending on the state of the engine.
See http://ccl.northwestern.edu/netlogo/docs/dictionary.html#turtles"
- *turtles*)
+ :turtles)
-(defun ask (agent-set fn)
- "ASK AGENT-SET FN => RESULT
+(defun ask (agent-or-agentset fn)
+ "ASK AGENT-OR-AGENTSET FN => RESULT
+
+ AGENT-OR-AGENTSET: AGENT | AGENTSET
ARGUMENTS AND VALUES:
- AGENT-SET: a NetLogo agentset
FN: a function, run on each agent
RESULT: undefined, commands don't return
+ AGENT: a NetLogo agent
+ AGENTSET: a NetLogo agentset
DESCRIPTION:
ASK is equivalent to ask in NetLogo.
- The specified AGENT-SET runs the given FN. The order in which the agents
- are run is random each time, and only agents that are in the set at the
- beginning of the call.
+ The specified AGENTSET or AGENT runs the given FN. In the case of an
+ AGENTSET, the order in which the agents are run is random each time,
+ and only agents that are in the set at the beginning of the call.
See http://ccl.northwestern.edu/netlogo/docs/dictionary.html#ask"
- (let
- ((iter (shufflerator (agent-set-list agent-set))))
- (loop
- :for agent := (funcall iter)
- :while agent
- :do (let ((*myself* *self*) (*self* agent)) (funcall fn)))))
+ (cond
+ ((agentset-p agent-or-agentset)
+ (let
+ ((iter (shufflerator (agentset-list agent-or-agentset))))
+ (loop
+ :for agent := (funcall iter)
+ :while agent
+ :do (let ((*myself* *self*) (*self* agent)) (funcall fn)))))
+ ((agent-p agent-or-agentset)
+ (let ((*myself* *self*) (*self* agent-or-agentset)) (funcall fn)))
+ (t
+ (error "Ask requires an agentset or agent but got: ~A" agent-or-agentset))))
+
+(defun count (agentset)
+ "COUNT AGENTSET => N
+
+ARGUMENTS AND VALUES:
+
+ AGENTSET: a NetLogo agentset
+ N: a number
+
+DESCRIPTION:
-(defun of (fn agent-set)
- "OF FN AGENT-SET => RESULT
+ COUNT is equivalent to count in NetLogo. Returns N, the number of
+ agents in AGENTSET.
+
+ See http://ccl.northwestern.edu/netlogo/docs/dictionary.html#count"
+ (coerce (length (agentset-list agentset)) 'double-float))
+
+(defun of (fn agent-or-agentset)
+ "OF FN AGENT-OR-AGENTSET => RESULT
+
+ AGENT-OR-AGENTSET: AGENT | AGENTSET
+ RESULT: RESULT-LIST | RESULT-VALUE
ARGUMENTS AND VALUES:
FN: a function, run on each agent
- AGENT-SET: a NetLogo agentset
- RESULT: a list
+ AGENT: a NetLogo agent
+ AGENTSET: a NetLogo agentset
+ RESULT-LIST: a list
+ RESULT-VALUE: a single value
DESCRIPTION:
OF is equivalent to of in NetLogo.
- The specified AGENT-SET runs the given FN. The order in which the agents
- are run is random each time, and only agents that are in the set at the
- beginning of the call. A list is returned of the returned valuse of
- FN.
+ The specified AGENTSET or AGENT runs the given FN. In the case of an
+ AGENTSET, the order in which the agents are run is random each time,
+ and only agents that are in the set at the beginning of the call.
- See http://ccl.northwestern.edu/netlogo/docs/dictionary.html#of"
- (let
- ((iter (shufflerator (agent-set-list agent-set))))
- (loop
- :for agent := (funcall iter)
- :while agent
- :collect (let ((*myself* *self*) (*self* agent)) (funcall fn)))))
+ RESULT-LIST is returned when the input is an AGENTSET, but RESULT-VALUE
+ is returned when only passed an AGENT.
-(defun shufflerator (agent-set-list)
+ See http://ccl.northwestern.edu/netlogo/docs/dictionary.html#of"
+ (cond
+ ((agentset-p agent-or-agentset)
+ (let
+ ((iter (shufflerator (agentset-list agent-or-agentset))))
+ (loop
+ :for agent := (funcall iter)
+ :while agent
+ :collect (let ((*myself* *self*) (*self* agent)) (funcall fn)))))
+ ((agent-p agent-or-agentset)
+ (let ((*myself* *self*) (*self* agent-or-agentset)) (funcall fn)))
+ (t
+ (error "Of requires an agentset or agent but got: ~A" agent-or-agentset))))
+
+(defun shufflerator (agentset-list)
(let
- ((copy (copy-list agent-set-list))
+ ((copy (copy-list agentset-list))
(i 0)
(agent nil))
(flet
(max (+ (max-pycor) 0.5d0)))
(+ min (clnl-random:next-double (- max min)))))
-(defun one-of (agent-set)
- "ONE-OF AGENT-SET => RESULT
+(defun one-of (list-or-agentset)
+ "ONE-OF LIST-OR-AGENTSET => RESULT
- RESULT: RANDOM-AGENT | :nobody
+ LIST-OR-AGENTSET: LIST | AGENTSET
+ RESULT: RANDOM-VALUE | RANDOM-AGENT | :nobody
ARGUMENTS AND VALUES:
- AGENT-SET: An agent set
- RANDOM-AGENT: an agent if AGENT-SET is non empty
+ LIST: A list
+ AGENTSET: An agent set
+ RANDOM-VALUE: a value in LIST
+ RANDOM-AGENT: an agent if AGENTSET is non empty
DESCRIPTION:
- From an agentset, returns a random agent. If the agentset is empty, returns nobody.
+ From an AGENTSET, returns a RANDOM-AGENT. If the agentset is empty, returns :nobody.
+ From a list, returns a RANDOM-VALUE. If the list is empty, an error occurs.
See http://ccl.northwestern.edu/netlogo/docs/dictionary.html#one-of"
- (let*
- ((agent-set-list (agent-set-list agent-set))
- (length (length agent-set-list)))
- (if (zerop length) :nobody (nth (clnl-random:next-int length) agent-set-list))))
+ (cond
+ ((agentset-p list-or-agentset)
+ (let*
+ ((agentset-list (agentset-list list-or-agentset))
+ (length (length agentset-list)))
+ (if (zerop length) :nobody (nth (clnl-random:next-int length) agentset-list))))
+ ((listp list-or-agentset)
+ (let*
+ ((length (length list-or-agentset)))
+ (if (zerop length)
+ (error "one-of requires a nonempty list")
+ (nth (clnl-random:next-int length) list-or-agentset))))
+ (t (error "one-of requires a list or agentset"))))
(defun jump (n)
(when (not (turtle-p *self*)) (error "Gotta call jump in turtle scope, dude (~A)" *self*))