-
Notifications
You must be signed in to change notification settings - Fork 16
/
Copy pathPatches.js.html
326 lines (307 loc) · 28.8 KB
/
Patches.js.html
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
<!DOCTYPE html><html lang="en" style="font-size:16px"><head><meta charset="utf-8"><meta name="viewport" content="width=device-width,initial-scale=1"><link rel="icon" href="../favicon.ico"><title>Source: Patches.js</title><!--[if lt IE 9]>
<script src="//html5shiv.googlecode.com/svn/trunk/html5.js"></script>
<![endif]--><script src="scripts/third-party/hljs.js" defer="defer"></script><script src="scripts/third-party/hljs-line-num.js" defer="defer"></script><script src="scripts/third-party/popper.js" defer="defer"></script><script src="scripts/third-party/tippy.js" defer="defer"></script><script src="scripts/third-party/tocbot.min.js"></script><script>var baseURL="/",locationPathname="";baseURL=(locationPathname=document.location.pathname).substr(0,locationPathname.lastIndexOf("/")+1)</script><link rel="stylesheet" href="styles/clean-jsdoc-theme.min.css"><svg aria-hidden="true" version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" style="display:none"><defs><symbol id="copy-icon" viewbox="0 0 488.3 488.3"><g><path d="M314.25,85.4h-227c-21.3,0-38.6,17.3-38.6,38.6v325.7c0,21.3,17.3,38.6,38.6,38.6h227c21.3,0,38.6-17.3,38.6-38.6V124 C352.75,102.7,335.45,85.4,314.25,85.4z M325.75,449.6c0,6.4-5.2,11.6-11.6,11.6h-227c-6.4,0-11.6-5.2-11.6-11.6V124 c0-6.4,5.2-11.6,11.6-11.6h227c6.4,0,11.6,5.2,11.6,11.6V449.6z"/><path d="M401.05,0h-227c-21.3,0-38.6,17.3-38.6,38.6c0,7.5,6,13.5,13.5,13.5s13.5-6,13.5-13.5c0-6.4,5.2-11.6,11.6-11.6h227 c6.4,0,11.6,5.2,11.6,11.6v325.7c0,6.4-5.2,11.6-11.6,11.6c-7.5,0-13.5,6-13.5,13.5s6,13.5,13.5,13.5c21.3,0,38.6-17.3,38.6-38.6 V38.6C439.65,17.3,422.35,0,401.05,0z"/></g></symbol><symbol id="search-icon" viewBox="0 0 512 512"><g><g><path d="M225.474,0C101.151,0,0,101.151,0,225.474c0,124.33,101.151,225.474,225.474,225.474 c124.33,0,225.474-101.144,225.474-225.474C450.948,101.151,349.804,0,225.474,0z M225.474,409.323 c-101.373,0-183.848-82.475-183.848-183.848S124.101,41.626,225.474,41.626s183.848,82.475,183.848,183.848 S326.847,409.323,225.474,409.323z"/></g></g><g><g><path d="M505.902,476.472L386.574,357.144c-8.131-8.131-21.299-8.131-29.43,0c-8.131,8.124-8.131,21.306,0,29.43l119.328,119.328 c4.065,4.065,9.387,6.098,14.715,6.098c5.321,0,10.649-2.033,14.715-6.098C514.033,497.778,514.033,484.596,505.902,476.472z"/></g></g></symbol><symbol id="font-size-icon" viewBox="0 0 24 24"><path fill="none" d="M0 0h24v24H0z"/><path d="M11.246 15H4.754l-2 5H.6L7 4h2l6.4 16h-2.154l-2-5zm-.8-2L8 6.885 5.554 13h4.892zM21 12.535V12h2v8h-2v-.535a4 4 0 1 1 0-6.93zM19 18a2 2 0 1 0 0-4 2 2 0 0 0 0 4z"/></symbol><symbol id="add-icon" viewBox="0 0 24 24"><path fill="none" d="M0 0h24v24H0z"/><path d="M11 11V5h2v6h6v2h-6v6h-2v-6H5v-2z"/></symbol><symbol id="minus-icon" viewBox="0 0 24 24"><path fill="none" d="M0 0h24v24H0z"/><path d="M5 11h14v2H5z"/></symbol><symbol id="dark-theme-icon" viewBox="0 0 24 24"><path fill="none" d="M0 0h24v24H0z"/><path d="M10 7a7 7 0 0 0 12 4.9v.1c0 5.523-4.477 10-10 10S2 17.523 2 12 6.477 2 12 2h.1A6.979 6.979 0 0 0 10 7zm-6 5a8 8 0 0 0 15.062 3.762A9 9 0 0 1 8.238 4.938 7.999 7.999 0 0 0 4 12z"/></symbol><symbol id="light-theme-icon" viewBox="0 0 24 24"><path fill="none" d="M0 0h24v24H0z"/><path d="M12 18a6 6 0 1 1 0-12 6 6 0 0 1 0 12zm0-2a4 4 0 1 0 0-8 4 4 0 0 0 0 8zM11 1h2v3h-2V1zm0 19h2v3h-2v-3zM3.515 4.929l1.414-1.414L7.05 5.636 5.636 7.05 3.515 4.93zM16.95 18.364l1.414-1.414 2.121 2.121-1.414 1.414-2.121-2.121zm2.121-14.85l1.414 1.415-2.121 2.121-1.414-1.414 2.121-2.121zM5.636 16.95l1.414 1.414-2.121 2.121-1.414-1.414 2.121-2.121zM23 11v2h-3v-2h3zM4 11v2H1v-2h3z"/></symbol><symbol id="reset-icon" viewBox="0 0 24 24"><path fill="none" d="M0 0h24v24H0z"/><path d="M18.537 19.567A9.961 9.961 0 0 1 12 22C6.477 22 2 17.523 2 12S6.477 2 12 2s10 4.477 10 10c0 2.136-.67 4.116-1.81 5.74L17 12h3a8 8 0 1 0-2.46 5.772l.997 1.795z"/></symbol><symbol id="down-icon" viewBox="0 0 16 16"><path fill-rule="evenodd" clip-rule="evenodd" d="M12.7803 6.21967C13.0732 6.51256 13.0732 6.98744 12.7803 7.28033L8.53033 11.5303C8.23744 11.8232 7.76256 11.8232 7.46967 11.5303L3.21967 7.28033C2.92678 6.98744 2.92678 6.51256 3.21967 6.21967C3.51256 5.92678 3.98744 5.92678 4.28033 6.21967L8 9.93934L11.7197 6.21967C12.0126 5.92678 12.4874 5.92678 12.7803 6.21967Z"></path></symbol><symbol id="codepen-icon" viewBox="0 0 24 24"><path fill="none" d="M0 0h24v24H0z"/><path d="M16.5 13.202L13 15.535v3.596L19.197 15 16.5 13.202zM14.697 12L12 10.202 9.303 12 12 13.798 14.697 12zM20 10.869L18.303 12 20 13.131V10.87zM19.197 9L13 4.869v3.596l3.5 2.333L19.197 9zM7.5 10.798L11 8.465V4.869L4.803 9 7.5 10.798zM4.803 15L11 19.131v-3.596l-3.5-2.333L4.803 15zM4 13.131L5.697 12 4 10.869v2.262zM2 9a1 1 0 0 1 .445-.832l9-6a1 1 0 0 1 1.11 0l9 6A1 1 0 0 1 22 9v6a1 1 0 0 1-.445.832l-9 6a1 1 0 0 1-1.11 0l-9-6A1 1 0 0 1 2 15V9z"/></symbol><symbol id="close-icon" viewBox="0 0 24 24"><path fill="none" d="M0 0h24v24H0z"/><path d="M12 10.586l4.95-4.95 1.414 1.414-4.95 4.95 4.95 4.95-1.414 1.414-4.95-4.95-4.95 4.95-1.414-1.414 4.95-4.95-4.95-4.95L7.05 5.636z"/></symbol><symbol id="menu-icon" viewBox="0 0 24 24"><path fill="none" d="M0 0h24v24H0z"/><path d="M3 4h18v2H3V4zm0 7h18v2H3v-2zm0 7h18v2H3v-2z"/></symbol></defs></svg></head><body data-theme="dark"><div class="sidebar-container"><div class="sidebar" id="sidebar"><a href="/" class="sidebar-title sidebar-title-anchor">Home</a><div class="sidebar-items-container"><div class="sidebar-section-title with-arrow" data-isopen="false" id="sidebar-classes"><div>Classes</div><svg><use xlink:href="#down-icon"></use></svg></div><div class="sidebar-section-children-container"><div class="sidebar-section-children"><a href="AgentArray.html">AgentArray</a></div><div class="sidebar-section-children"><a href="AgentList.html">AgentList</a></div><div class="sidebar-section-children"><a href="AgentSet.html">AgentSet</a></div><div class="sidebar-section-children"><a href="Animator.html">Animator</a></div><div class="sidebar-section-children"><a href="DataSet.html">DataSet</a></div><div class="sidebar-section-children"><a href="GUI.html">GUI</a></div><div class="sidebar-section-children"><a href="GeoDataSet.html">GeoDataSet</a></div><div class="sidebar-section-children"><a href="Keyboard.html">Keyboard</a></div><div class="sidebar-section-children"><a href="Link.html">Link</a></div><div class="sidebar-section-children"><a href="Links.html">Links</a></div><div class="sidebar-section-children"><a href="Model.html">Model</a></div><div class="sidebar-section-children"><a href="Model3D.html">Model3D</a></div><div class="sidebar-section-children"><a href="Mouse.html">Mouse</a></div><div class="sidebar-section-children"><a href="Patch.html">Patch</a></div><div class="sidebar-section-children"><a href="Patches.html">Patches</a></div><div class="sidebar-section-children"><a href="RGBDataSet.html">RGBDataSet</a></div><div class="sidebar-section-children"><a href="ThreeDraw.html">ThreeDraw</a></div><div class="sidebar-section-children"><a href="Turtle.html">Turtle</a></div><div class="sidebar-section-children"><a href="Turtle3D.html">Turtle3D</a></div><div class="sidebar-section-children"><a href="Turtles.html">Turtles</a></div><div class="sidebar-section-children"><a href="TwoDraw.html">TwoDraw</a></div><div class="sidebar-section-children"><a href="World.html">World</a></div></div><div class="sidebar-section-title with-arrow" data-isopen="false" id="sidebar-modules"><div>Modules</div><svg><use xlink:href="#down-icon"></use></svg></div><div class="sidebar-section-children-container"><div class="sidebar-section-children"><a href="module-src_geojson.html">src/geojson</a></div><div class="sidebar-section-children"><a href="module-src_gis.html">src/gis</a></div><div class="sidebar-section-children"><a href="module-src_utils.html">src/utils</a></div></div><div class="sidebar-section-title with-arrow" data-isopen="false" id="sidebar-tutorials"><div>Tutorials</div><svg><use xlink:href="#down-icon"></use></svg></div><div class="sidebar-section-children-container"><div class="sidebar-section-children"><a href="tutorial-1 - AgentScript.html">1 - AgentScript</a></div><div class="sidebar-section-children"><a href="tutorial-2 - JavaScript.html">2 - JavaScript</a></div><div class="sidebar-section-children"><a href="tutorial-3 - Browser.html">3 - Browser</a></div><div class="sidebar-section-children"><a href="tutorial-4 - Model.html">4 - Model</a></div><div class="sidebar-section-children"><a href="tutorial-5 - View.html">5 - View</a></div><div class="sidebar-section-children"><a href="tutorial-6.1 - AnimatorController.html">6.1 - AnimatorController</a></div><div class="sidebar-section-children"><a href="tutorial-6.2 - KeyboardController.html">6.2 - KeyboardController</a></div><div class="sidebar-section-children"><a href="tutorial-6.3 - GuiController.html">6.3 - GuiController</a></div><div class="sidebar-section-children"><a href="tutorial-6.4 - MouseController.html">6.4 - MouseController</a></div><div class="sidebar-section-children"><a href="tutorial-7 - CodePenServer.html">7 - CodePenServer</a></div></div></div></div></div><div class="navbar-container" id="VuAckcnZhf"><nav class="navbar"><div class="navbar-left-items"><div class="navbar-item"><a id="github" href="https://github.com/backspaces/agentscript" target="">Github</a></div><div class="navbar-item"><a id="AgentScript" href="https://code.agentscript.org" target="">AgentScript.org</a></div><div class="navbar-item"><a id="npm" href="https://www.npmjs.com/package/agentscript" target="">npm</a></div><div class="navbar-item"><a id="unpkg" href="https://unpkg.com/browse/agentscript/" target="">unpkg</a></div></div><div class="navbar-right-items"><div class="navbar-right-item"><button class="icon-button search-button" aria-label="open-search"><svg><use xlink:href="#search-icon"></use></svg></button></div><div class="navbar-right-item"><button class="icon-button theme-toggle" aria-label="toggle-theme"><svg><use class="theme-svg-use" xlink:href="#light-theme-icon"></use></svg></button></div><div class="navbar-right-item"><button class="icon-button font-size" aria-label="change-font-size"><svg><use xlink:href="#font-size-icon"></use></svg></button></div></div><nav></nav></nav></div><div class="toc-container"><div class="toc-content"><span class="bold">On this page</span><div id="eed4d2a0bfd64539bb9df78095dec881"></div></div></div><div class="body-wrapper"><div class="main-content"><div class="main-wrapper"><section id="source-page" class="source-page"><header><h1 id="title" class="has-anchor">Patches.js</h1></header><article><pre class="prettyprint source lang-js"><code>import * as util from './utils.js'
// import AgentArray from './AgentArray.js'
import AgentList from './AgentList.js'
import AgentSet from './AgentSet.js'
import DataSet from './DataSet.js'
/**
* Patches are the world other AgentSets live on.
* They define a coord system from the Model's World values:
* minX, maxX, minY, maxY, (minZ, maxZ) (z optional)
*
* Patches form a grid of Patch objects which can store world data
* (elevation, fires, ant pheromones, buildings, roads, gis spatial data, water and so on)
*
* Created by class Model. Used by modeler in their Model subclass
*/
class Patches extends AgentSet {
/**
* Creates an instance of Patches.
* @param {Model} model An instance of class Model
* @param {Patch} AgentClass The Patch class managed by Patches
* @param {string} name Name of the AgentSet
*/
constructor(model, AgentClass, name, baseSet = null) {
// AgentSet sets these variables:
// model, name, baseSet, world: model.world, agentProto: new AgentClass
// REMIND: agentProto: defaults, agentSet, world, [name]=agentSet.baseSet
super(model, AgentClass, name, baseSet)
// Skip if a breedSet (don't rebuild patches!).
if (this.isBreedSet()) return
this.populate()
// this.setPixels()
this.labels = [] // sparse array for labels
}
// Set up all the patches.
populate() {
util.repeat(this.model.world.numX * this.model.world.numY, i => {
this.addAgent() // Object.create(this.agentProto))
})
}
// Return the offsets from a patch for its 8 element neighbors.
// Specialized to be faster than inRect below.
neighborsOffsets(x, y) {
const { minX, maxX, minY, maxY, numX } = this.model.world
if (x === minX) {
if (y === minY) return [-numX, -numX + 1, 1]
if (y === maxY) return [1, numX + 1, numX]
return [-numX, -numX + 1, 1, numX + 1, numX]
}
if (x === maxX) {
if (y === minY) return [-numX - 1, -numX, -1]
if (y === maxY) return [numX, numX - 1, -1]
return [-numX - 1, -numX, numX, numX - 1, -1]
}
if (y === minY) return [-numX - 1, -numX, -numX + 1, 1, -1]
if (y === maxY) return [1, numX + 1, numX, numX - 1, -1]
return [-numX - 1, -numX, -numX + 1, 1, numX + 1, numX, numX - 1, -1]
}
// Return the offsets from a patch for its 4 element neighbors (N,S,E,W)
neighbors4Offsets(x, y) {
const numX = this.model.world.numX
return this.neighborsOffsets(x, y).filter(
n => Math.abs(n) === 1 || Math.abs(n) === numX
) // slightly faster
// .filter((n) => [1, -1, numX, -numX].indexOf(n) >= 0)
// .filter((n) => [1, -1, numX, -numX].includes(n)) // slower than indexOf
}
/**
* Return the 8 patch
* ["Moore" neighbors](https://en.wikipedia.org/wiki/Moore_neighborhood)
* of the given patch.
* Will be less than 8 on the edge of the patches
*
* @param {Patch} patch a Patch instance
* @returns {AgentList} An array of the neighboring patches
*/
neighbors(patch) {
const { id, x, y } = patch
const offsets = this.neighborsOffsets(x, y)
// const as = new AgentArray(offsets.length)
const as = new AgentList(this.model, offsets.length)
offsets.forEach((o, i) => {
as[i] = this[o + id]
})
return as
}
/**
* Return the 4 patch
* ["Van Neumann" neighbors](https://en.wikipedia.org/wiki/Von_Neumann_neighborhood)
* of the given patch.
* Will be less than 4 on the edge of the patches
*
* @param {Patch} patch a Patch instance
* @returns {AgentList} An array of the neighboring patches
*/
neighbors4(patch) {
const { id, x, y } = patch
const offsets = this.neighbors4Offsets(x, y)
// const as = new AgentArray(offsets.length)
const as = new AgentList(this.model, offsets.length)
offsets.forEach((o, i) => {
as[i] = this[o + id]
})
return as
}
/**
* Assign a DataSet's values into the patches as the given property name
*
* @param {DataSet} dataSet An instance of [DataSet](./DataSet.html)
* @param {string} property A Patch property name
* @param {boolean} [useNearest=false] Resample to nearest dataset value?
*/
importDataSet(dataSet, property, useNearest = false) {
if (this.isBreedSet()) {
// REMIND: error
util.warn('Patches: exportDataSet called with breed, using patches')
this.baseSet.importDataSet(dataSet, property, useNearest)
return
}
const { numX, numY } = this.model.world
const dataset = dataSet.resample(numX, numY, useNearest)
this.ask(p => {
p[property] = dataset.data[p.id]
})
}
/**
* Extract a property from each Patch as a DataSet
*
* @param {string} property The patch numeric property to extract
* @param {Type} [Type=Array] The DataSet array's type
* @returns {DataSet} A DataSet of the patche's values
*/
exportDataSet(property, Type = Array) {
if (this.isBreedSet()) {
util.warn('Patches: exportDataSet called with breed, using patches')
return this.baseSet.exportDataSet(property, Type)
}
const { numX, numY } = this.model.world
// let data = util.arrayProps(this, property)
let data = this.props(property)
data = util.convertArrayType(data, Type)
return new DataSet(numX, numY, data)
}
// Return id/index given valid x,y integers
/**
* Return index into Patches given valid x,y integers
*
* @param {number} x Integer X value
* @param {number} y Integer Y value
* @returns {number} Integer index into Patches array
*/
patchIndex(x, y) {
const { minX, maxY, numX } = this.model.world
return x - minX + numX * (maxY - y)
}
// Return patch at x,y float values
// Return undefined if off-world
patch(x, y) {
// Benny suggests: (in PR wrap x and y in patches.patch(x, y))
// const intX = Math.round(util.wrap(x, this.model.world.minXcor, this.model.world.maxXcor))
// const intY = Math.round(util.wrap(y, this.model.world.minYcor, this.model.world.maxYcor))
if (!this.model.world.isOnWorld(x, y)) return undefined
const intX =
x === this.model.world.maxXcor
? this.model.world.maxX
: Math.round(x) // handle n.5 round up to n + 1
const intY =
y === this.model.world.maxYcor
? this.model.world.maxY
: Math.round(y)
return this.patchXY(intX, intY)
}
// Return the patch at x,y where both are valid integer patch coordinates.
patchXY(x, y) {
return this[this.patchIndex(x, y)]
}
// Patches in rectangle dx, dy from p, dx, dy integers.
// Both dx & dy are half width/height of rect
patchRect(p, dx, dy = dx, meToo = true) {
// Return cached rect if one exists.
if (p.rectCache) {
const index = this.cacheIndex(dx, dy, meToo)
const rect = p.rectCache[index]
if (rect) return rect
}
// const rect = new AgentArray()
const rect = new AgentList(this.model)
let { minX, maxX, minY, maxY } = this.model.world
minX = Math.max(minX, p.x - dx)
maxX = Math.min(maxX, p.x + dx)
minY = Math.max(minY, p.y - dy)
maxY = Math.min(maxY, p.y + dy)
for (let y = minY; y <= maxY; y++) {
for (let x = minX; x <= maxX; x++) {
const pnext = this.patchXY(x, y)
if (p !== pnext || meToo) rect.push(pnext)
}
}
return rect
}
// Return patchRect given legal x, y values
patchRectXY(x, y, dx, dy = dx, meToo = true) {
return this.patchRect(this.patch(x, y), dx, dy, meToo)
}
// Performance: create a cached rect of this size in sparse array.
// Index of cached rect is dx * dy + meToo ? 0 : -1.
// This works for edge rects that are not that full size.
// patchRect will use this if matches dx, dy, meToo.
cacheIndex(dx, dy = dx, meToo = true) {
return (2 * dx + 1) * (2 * dy + 1) + (meToo ? 0 : -1)
}
cacheRect(dx, dy = dx, meToo = true, clear = true) {
const index = this.cacheIndex(dx, dy, meToo)
this.ask(p => {
if (!p.rectCache || clear) p.rectCache = []
const rect = this.inRect(p, dx, dy, meToo)
p.rectCache[index] = rect
})
}
// Return patches within the patch rect, dx, dy integers
// default is square & meToo
inRect(patch, dx, dy = dx, meToo = true) {
const pRect = this.patchRect(patch, dx, dy, meToo)
if (this.isBaseSet()) return pRect
return pRect.withBreed(this)
}
// Return patches within float radius distance of patch
inRadius(patch, radius, meToo = true) {
const dxy = Math.ceil(radius)
const pRect = this.inRect(patch, dxy, dxy, meToo)
return pRect.inRadius(patch, radius, meToo)
}
// Patches in cone from patch in direction `heading`,
// with `coneAngle` width and within float `radius`
inCone(patch, radius, coneAngle, heading, meToo = true) {
const dxy = Math.ceil(radius)
const pRect = this.inRect(patch, dxy, dxy, meToo)
// // Using AgentArray's inCone, using radians
// heading = this.model.toRads(heading)
// coneAngle = this.model.toAngleRads(coneAngle)
// return pRect.inCone(patch, radius, coneAngle, heading, meToo)
return pRect.inCone(patch, radius, coneAngle, heading, meToo)
}
// Return patch at distance and angle from obj's (patch or turtle)
// x, y (floats). If off world, return undefined.
// Does not take into account the angle of the agent.
patchAtHeadingAndDistance(agent, heading, distance) {
heading = this.model.toRads(heading)
let { x, y } = agent
x = x + distance * Math.cos(heading)
y = y + distance * Math.sin(heading)
return this.patch(x, y)
}
// Return true if patch on edge of world
isOnEdge(patch) {
const { x, y } = patch
const { minX, maxX, minY, maxY } = this.model.world
return x === minX || x === maxX || y === minY || y === maxY
}
// returns the edge patches for this breed.
// generally called with patches.baseSet/model.patches.
edgePatches() {
return this.filter(p => this.isOnEdge(p))
}
// Diffuse the value of patch variable `p.v` by distributing `rate` percent
// of each patch's value of `v` to its neighbors.
// If the patch has less than 4/8 neighbors, return the extra to the patch.
diffuse(v, rate) {
this.diffuseN(8, v, rate)
}
diffuse4(v, rate) {
this.diffuseN(4, v, rate)
}
diffuseN(n, v, rate) {
// Note: for-of loops removed: chrome can't optimize them
// test/apps/patches.js 22fps -> 60fps
// zero temp variable if not yet set
if (this[0]._diffuseNext === undefined) {
// for (const p of this) p._diffuseNext = 0
for (let i = 0; i < this.length; i++) this[i]._diffuseNext = 0
}
// pass 1: calculate contribution of all patches to themselves and neighbors
// for (const p of this) {
for (let i = 0; i < this.length; i++) {
const p = this[i]
const dv = p[v] * rate
const dvn = dv / n
const neighbors = n === 8 ? p.neighbors : p.neighbors4
const nn = neighbors.length
p._diffuseNext += p[v] - dv + (n - nn) * dvn
// for (const n of neighbors) n._diffuseNext += dvn
for (let i = 0; i < neighbors.length; i++) {
neighbors[i]._diffuseNext += dvn
}
}
// pass 2: set new value for all patches, zero temp,
// for (const p of this) {
for (let i = 0; i < this.length; i++) {
const p = this[i]
p[v] = p._diffuseNext
p._diffuseNext = 0
}
}
}
export default Patches
</code></pre></article></section><footer class="footer" id="PeOAagUepe"><div class="wrapper">AgentScript version: 0.10.20 using clean-jsdoc-theme</div></footer></div></div></div><div class="search-container" id="PkfLWpAbet" style="display:none"><div class="wrapper" id="iCxFxjkHbP"><button class="icon-button search-close-button" id="VjLlGakifb" aria-label="close search"><svg><use xlink:href="#close-icon"></use></svg></button><div class="search-box-c"><svg><use xlink:href="#search-icon"></use></svg> <input type="text" id="vpcKVYIppa" class="search-input" placeholder="Search..." autofocus></div><div class="search-result-c" id="fWwVHRuDuN"><span class="search-result-c-text">Type anything to view search result</span></div></div></div><div class="mobile-menu-icon-container"><button class="icon-button" id="mobile-menu" data-isopen="false" aria-label="menu"><svg><use xlink:href="#menu-icon"></use></svg></button></div><div id="mobile-sidebar" class="mobile-sidebar-container"><div class="mobile-sidebar-wrapper"><a href="/" class="sidebar-title sidebar-title-anchor">Home</a><div class="mobile-nav-links"><div class="navbar-item"><a id="github-mobile" href="https://github.com/backspaces/agentscript" target="">Github</a></div><div class="navbar-item"><a id="AgentScript-mobile" href="https://code.agentscript.org" target="">AgentScript.org</a></div><div class="navbar-item"><a id="npm-mobile" href="https://www.npmjs.com/package/agentscript" target="">npm</a></div><div class="navbar-item"><a id="unpkg-mobile" href="https://unpkg.com/browse/agentscript/" target="">unpkg</a></div></div><div class="mobile-sidebar-items-c"><div class="sidebar-section-title with-arrow" data-isopen="false" id="sidebar-classes"><div>Classes</div><svg><use xlink:href="#down-icon"></use></svg></div><div class="sidebar-section-children-container"><div class="sidebar-section-children"><a href="AgentArray.html">AgentArray</a></div><div class="sidebar-section-children"><a href="AgentList.html">AgentList</a></div><div class="sidebar-section-children"><a href="AgentSet.html">AgentSet</a></div><div class="sidebar-section-children"><a href="Animator.html">Animator</a></div><div class="sidebar-section-children"><a href="DataSet.html">DataSet</a></div><div class="sidebar-section-children"><a href="GUI.html">GUI</a></div><div class="sidebar-section-children"><a href="GeoDataSet.html">GeoDataSet</a></div><div class="sidebar-section-children"><a href="Keyboard.html">Keyboard</a></div><div class="sidebar-section-children"><a href="Link.html">Link</a></div><div class="sidebar-section-children"><a href="Links.html">Links</a></div><div class="sidebar-section-children"><a href="Model.html">Model</a></div><div class="sidebar-section-children"><a href="Model3D.html">Model3D</a></div><div class="sidebar-section-children"><a href="Mouse.html">Mouse</a></div><div class="sidebar-section-children"><a href="Patch.html">Patch</a></div><div class="sidebar-section-children"><a href="Patches.html">Patches</a></div><div class="sidebar-section-children"><a href="RGBDataSet.html">RGBDataSet</a></div><div class="sidebar-section-children"><a href="ThreeDraw.html">ThreeDraw</a></div><div class="sidebar-section-children"><a href="Turtle.html">Turtle</a></div><div class="sidebar-section-children"><a href="Turtle3D.html">Turtle3D</a></div><div class="sidebar-section-children"><a href="Turtles.html">Turtles</a></div><div class="sidebar-section-children"><a href="TwoDraw.html">TwoDraw</a></div><div class="sidebar-section-children"><a href="World.html">World</a></div></div><div class="sidebar-section-title with-arrow" data-isopen="false" id="sidebar-modules"><div>Modules</div><svg><use xlink:href="#down-icon"></use></svg></div><div class="sidebar-section-children-container"><div class="sidebar-section-children"><a href="module-src_geojson.html">src/geojson</a></div><div class="sidebar-section-children"><a href="module-src_gis.html">src/gis</a></div><div class="sidebar-section-children"><a href="module-src_utils.html">src/utils</a></div></div><div class="sidebar-section-title with-arrow" data-isopen="false" id="sidebar-tutorials"><div>Tutorials</div><svg><use xlink:href="#down-icon"></use></svg></div><div class="sidebar-section-children-container"><div class="sidebar-section-children"><a href="tutorial-1 - AgentScript.html">1 - AgentScript</a></div><div class="sidebar-section-children"><a href="tutorial-2 - JavaScript.html">2 - JavaScript</a></div><div class="sidebar-section-children"><a href="tutorial-3 - Browser.html">3 - Browser</a></div><div class="sidebar-section-children"><a href="tutorial-4 - Model.html">4 - Model</a></div><div class="sidebar-section-children"><a href="tutorial-5 - View.html">5 - View</a></div><div class="sidebar-section-children"><a href="tutorial-6.1 - AnimatorController.html">6.1 - AnimatorController</a></div><div class="sidebar-section-children"><a href="tutorial-6.2 - KeyboardController.html">6.2 - KeyboardController</a></div><div class="sidebar-section-children"><a href="tutorial-6.3 - GuiController.html">6.3 - GuiController</a></div><div class="sidebar-section-children"><a href="tutorial-6.4 - MouseController.html">6.4 - MouseController</a></div><div class="sidebar-section-children"><a href="tutorial-7 - CodePenServer.html">7 - CodePenServer</a></div></div></div><div class="mobile-navbar-actions"><div class="navbar-right-item"><button class="icon-button search-button" aria-label="open-search"><svg><use xlink:href="#search-icon"></use></svg></button></div><div class="navbar-right-item"><button class="icon-button theme-toggle" aria-label="toggle-theme"><svg><use class="theme-svg-use" xlink:href="#light-theme-icon"></use></svg></button></div><div class="navbar-right-item"><button class="icon-button font-size" aria-label="change-font-size"><svg><use xlink:href="#font-size-icon"></use></svg></button></div></div></div></div><script type="text/javascript" src="scripts/core.min.js"></script><script src="scripts/search.min.js" defer="defer"></script><script src="scripts/third-party/fuse.js" defer="defer"></script><script type="text/javascript">var tocbotInstance=tocbot.init({tocSelector:"#eed4d2a0bfd64539bb9df78095dec881",contentSelector:".main-content",headingSelector:"h1, h2, h3",hasInnerContainers:!0,scrollContainer:".main-content",headingsOffset:130,onClick:bringLinkToView})</script></body></html>