NetLogo View2.5d Extension

The View2.5D extension offers visualization for Patch and Turtle reporters, in real time, in a simulation’s context.

How to Use

The view2.5d extension is pre-installed in NetLogo.

To use the view2.5d extension in your model, add a line to the top of your Code tab:

extensions [view2.5d]

If your model already uses other extensions, then it already has an extensions line in it, so just add view2.5d to the list.

For more information on using NetLogo extensions, see the Extensions Guide

Incorporating Into Models

open a window using either the view2.5d:patch-view or view2.5d:turtle-view commands (it can be a good idea to put these in your ‘SETUP’ procedure or a separate button).

update your window’s view using one of the update commands (put these in your ‘GO’ procedure).

See the View2.5d Code Examples in the NetLogo models library.

Feedback

Send comments, bugs, or other feedback to CCL Feedback and/or Corey Brady.

Primitives

view2.5d:patch-view view2.5d:decorate-patch-view view2.5d:undecorate-patch-view view2.5d:turtle-view view2.5d:update-all-patch-views view2.5d:update-patch-view view2.5d:update-turtle-view view2.5d:get-z-scale view2.5d:set-z-scale view2.5d:set-turtle-stem-thickness view2.5d:get-observer-angles view2.5d:set-observer-angles view2.5d:get-observer-xy-focus view2.5d:set-observer-xy-focus view2.5d:get-observer-distance view2.5d:set-observer-distance view2.5d:remove-patch-view view2.5d:remove-turtle-view view2.5d:remove-all-patch-views view2.5d:remove-all-turtle-views view2.5d:count-windows

view2.5d:patch-view

view2.5d:patch-view Title Reporter

This command must be called from the Observer context. (Attempting to call from another context causes an error) The Title is a string, which will be used to label the new Window and to call for subsequent updates and modifications. Specification of the Reporter uses the NetLogo anonymous procedure syntax, from the Observer perspective.

Example:

view2.5d:decorate-patch-view

view2.5d:decorate-patch-view Title

This command must be called from the Observer context. (Attempting to call from another context causes an error) The Title is a string, the label of an existing Patch View Window. Effect: draws the turtles of the model at their current location, on top of the Patch view display

NOTE: only has an effect in the “structures” patch view (in the others, the patch value is inclined based on neighbors & gradient)

NOTE: for negative patch values, the turtle shapes are drawn below (orbit underneath to see them)

Example:

view2.5d:undecorate-patch-view

view2.5d:undecorate-patch-view Title

This command must be called from the Observer context. (Attempting to call from another context causes an error)

The Title is a string, the label of an existing Patch View Window. Effect: STOPS drawing the turtles of the model at their current location, on top of the Patch view display

Example:

view2.5d:turtle-view

view2.5d:turtle-view Title Agents Reporter

This command must be called from the Observer context. (Attempting to call from another context causes an error) The Title is a string, which will be used to label the new Window and to call for subsequent updates. The turtle-set is any selector for turtles. Specification of the Reporter uses the NetLogo task syntax, from the Observer perspective.

Example:

view2.5d:turtle-view "Test" turtles with [color = red] [[energy] of ?1]
; This would create a new 2.5d window, plotting the ENERGY value of all turtles that are red.

view2.5d:update-all-patch-views

view2.5d:update-all-patch-views

This command must be called from the Observer context. Updates all existing patch-view windows according to the latest values.

view2.5d:update-patch-view

view2.5d:update-patch-view Title

This command must be called from the Observer context. Updates only the patch-view window with the specified title (if any).

view2.5d:update-turtle-view

view2.5d:update-turtle-view Title Agents

This command must be called from the Observer context. Updates only the turtle-view window with the specified title (if any). The turtle-set selector must be supplied to refresh the set of turtles.

view2.5d:get-z-scale

view2.5d:get-z-scale title

This reporter must be called from the Observer context. Returns the current z-scale of the turtle-view or patch-view window with the specified title (if any).

view2.5d:set-z-scale

view2.5d:set-z-scale Title new-z-scale

This command must be called from the Observer context. Updates only the turtle-view or patch-view window with the specified title (if any). The view is now displayed with the new z-scale.

view2.5d:set-turtle-stem-thickness

view2.5d:set-turtle-stem-thickness Title thickness

This command must be called from the Observer context. Updates only the turtle-view window with the specified title (if any). Turtles are now drawn with “pins” or “stems” that have the specified thickness (instead of the hairline default)

view2.5d:get-observer-angles

view2.5d:get-observer-angles Title

This reporter must be called from the Observer context. Returns a list reflecting the observer’s angular perspective { heading pitch } (the place on an imaginary sphere at the zoom distance is updated to obey heading & pitch given)

view2.5d:set-observer-angles

view2.5d:set-observer-angles Title heading pitch

This command must be called from the Observer context. Updates only the turtle-view window with the specified title (if any). Sets the observer’s angular perspective (the place on an imaginary sphere at the zoom distance is updated to obey heading & pitch given)

view2.5d:get-observer-xy-focus

view2.5d:get-observer-xy-focus Title

This reporter must be called from the Observer context. Returns a list reflecting the x and y coordinates the observer is “looking at” in the patch plane.

view2.5d:set-observer-xy-focus

view2.5d:set-observer-xy-focus Title number ycor

This command must be called from the Observer context. Updates only the turtle-view window with the specified title (if any). Sets the x and y coordinates the observer that is “looking at” in the patch plane.

view2.5d:get-observer-distance

view2.5d:get-observer-distance Title

This reporter must be called from the Observer context. Returns the observer’s distance from its “focus point”

view2.5d:set-observer-distance

view2.5d:set-observer-distance Title new-distance

This command must be called from the Observer context. Updates only the turtle-view window with the specified title (if any). Sets the observer’s distance from its “focus point”

view2.5d:remove-patch-view

view2.5d:remove-patch-view Title

This command closes and removes the specified patch view programmatically (equivalent to closing the window manually).

view2.5d:remove-turtle-view

view2.5d:remove-turtle-view Title

This command closes and removes the specified turtle view programmatically (equivalent to closing the window manually).

view2.5d:remove-all-patch-views

view2.5d:remove-all-patch-views

This command closes and removes all patch views programmatically (equivalent to closing the windows manually).

view2.5d:remove-all-turtle-views

view2.5d:remove-all-turtle-views

This command closes and removes all turtle views programmatically (equivalent to closing the windows manually).

view2.5d:count-windows

view2.5d:count-windows

This reporter returns the number of turtle and patch views that are currently active.