gis:create-turtles-from-points-manual

gis:create-turtles-from-points-manual vector-dataset breed property-mapping commands

Like create-turtles-from-points, creates a turtle for each point in a VectorDataset of points and populates their variables with the values of corresponding gis properties.

This primitive can be used to specify additional mappings between gis property names and NetLogo variable names. These mappings are specified as a list of lists of strings like so: [["property-name" "turtle-variable-name"] ["property-name" "turtle-variable-name"] (etc.)]

These manual mappings modify the automatic mapping process that takes place in the create-turtles-from-points primitive, so you only need to specify the changes you want to make to the default mappings, and the rest of the mappings will be untouched.

To return to the cities example from the create-turtles-from-points entry, the variable name “capital” is not very descriptive. something like “is-capital?” fits the NetLogo style much better. To make that change, you would modify the example like so.

extensions [gis]
breed [cities city]
cities-own [name country population is-capital?]
globals [cities-dataset]

to setup
  set cities-dataset gis:load-dataset "cities.shp"
  ;; Since we only want to change how the "CAPITAL" property is mapped, we only need to specify that one change.
  gis:create-turtles-from-points-manual cities-dataset cities [["CAPITAL" "is-capital?"]] [
    set shape "circle"
  ]
  ;; Each city turtle still has a name, country, and population set just like the non-manual version.
end