÷ƒ’À;è TeX output 1998.01.28:1948‹ÿÿÿÿ “ºâ ýxºâïcolor push Blackïhtml:ï html:ŸüfdŽŽŽ’Ôï color popŽŽ ^ºâ ýÆïhtml:ï html:ŸIyóÓߌ˜¼j ptmb7t½Swarm–/Space“LibraryŽŸÕ§ó3{Ù ptmr7t¼The– MSwægarm“Space“library“is“the“beÙ ginnings“of“a“library“to“assist“in“bÌÐuilding“en™Ÿvironments“for“interacting“agents.‘¸€InŽ¤ general,‘_êen™Ÿvironments–3"can“be“just“as“všÀaried“as“the“agents“themselvÙ es“(in“one“vie˜w‘ÿY ,‘_êthe“en™Ÿvironment“itself“is“simplyŽ¡another›9 agent).‘D÷Ho•Àwe“v•Ù er™Ÿ,‘ggman“y˜simulations˜haÌÐv“e˜similar˜types˜of˜en™Ÿvironments˜that˜can˜be˜helpfully˜supported˜byŽ¡generic‘€code.ŽŸ›_ïhtml:ï html:Ÿ :H‘0óßêï html:todo“listïhtml:ï html:Ž¤ d€‘0(../todo.html)Ž¡‘0for–?ýideas.‘ úBriefly,“coordinates“need“to“be“elevated“to“the“status“of“objects,“whichŽ¤ ‘0should–?ýhopefully“allow“spaces“of“different“scales“and“boundary“conditions“to“interactŽ¡‘0through–?ýa“common“reference“system.‘ úIn“addition,“other“types“of“spaces“are“desired:Ž¡‘0continuous–?ýcoordinates,“other“dimensions,“arbitrary“graphs,“etc.ŽŸ8äïhtml:ï html:ŸÇ‘0„¤ŽŽ¤G®ïhtml:ï html:Ÿ êóÓߌ˜G® ptmb7t¿Discr°gete2dŽŸ c¼Root–‰lclass“of“all“2d“discrete“spaces.›5ÜA‘‰(Discrete2d“is“basically“a“2d“array“of“ids.˜Subclasses“add“particular“spaceŽ¡semantics–€onto“this.‘˜Currently“Discrete2d“grids“are“accessed“by“inteÙ ger“pairs“of“X“and“Y“coordinates.ŽŸžïhtml:ï html:ŸöóÓߌ˜ff ptmb7tÀCr½«eationŽŸ 9 ïhtml:ï html:¤ïhtml:ï html:ïhtml:ï html:Ÿ +`‘:ó0ˆÛ pcrr7tÁ-–ffsetSizeX:“(int)x“Y:“(int)yŽ©bÌïhtml:ï html:Ÿ ´‘X¾Set–?ýthe“world“size.Ž¡ïhtml:ï html:ïhtml:ï html:Ÿ d€‘:Á-‘ffcreateEndŽžÉïhtml:ï html:Ÿ G·‘X¾Create–?ýthe“lattice,“precompute“the“offsets“based“on“Y“coordinate.ŽŸŸJïhtml:ï html:ŸsJÀQuerying–™™Discr½«ete2d“stateŽŸ î&ïhtml:ï html:¡ïhtml:ï html:ïhtml:ï html:Ÿ vZ‘:Á-–ff(int)getSizeX“and“-“(int)getSizeYŽ¦ïhtml:ï html:© ´‘X¾Get–?ýthe“size“of“the“lattice.ŽŸffïhtml:ï html:Ÿ¬.ÀGlobal‘™™OperationsŽŸ î&ïhtml:ï html:¡ïhtml:ï html:ïhtml:ï html:Ÿ vZ‘:Á-‘fffastFillWithValue:‘ ÌÌ(int)aValueŽ¤ýoïhtml:ï html:ïhtml:ï html:Ÿ g‘:-‘fffastFillWithObject:‘ ÌÌanObjectŽŸbÌïhtml:ï html:ïhtml:ï html:¦‘:-‘fffillWithValue:‘ ÌÌ(int)aValueŽ¡ïhtml:ï html:ïhtml:ï html:Ÿ g‘:-‘fffillWithObject:‘ ÌÌanObjectŽŸbÌïhtml:ï html:ŽŸ*ºâïcolor push Black’Ôï color popŽŽŒ‹* “ºâ ýxºâïcolor push Blackïhtml:ï html:ŸüfdŽŽŽ’Ôï color popŽŽ ^ ýБWºâ¾These–?ýmethods“will“fill“the“entire“space“with“a“specified“value“or“object.Ž¤ ‘WºâThe–?ýdifference“between“the“`fill'“and“`fastFill'“methods“is“that“the“formerŽ¡‘Wºâuse–?ýïhtml:ï html:ÁputObject“¾and“ïhtml:ï html:ÁputValue“¾internally,“in“other“words,“they“are“sensitiveŽ¡‘Wºâto–?ýany“subclassing“and“alteration“of“these“methods,“whereas“the“latter“useŽ¡‘Wºâïhtml:ï html:low–?ýlevel“access“routinesïhtml:ï html:ŽŸ N\‘Wºâdirectly–?ýand“are“therefore“much“faster“(and“remain“unaffected“by“subclassing).Žºâ©8äïhtml:ï html:ïhtml:ï html:Ÿ x‘:Á-–ffcopyDiscrete2d:› ÌÌ(Discrete2d“*)a“toDiscrete2d:˜(Discrete2d“*)b;ŽŸbÌïhtml:ï html:Ÿ ë‘X¾This–?ýmethod“copies“the“data“in“one“Discrete2d“object“to“another“Discrete2dŽ¡‘Xobject.‘ úIt–?ýassumes“that“both“objects“already“exist.Ž¦ïhtml:ï html:ïhtml:ï html:Ÿ x‘:Á-–ff(int)setDiscrete2d:› ÌÌ(Discrete2d“*)a“toFile:˜(const“char“*)filename;ŽŸýoïhtml:ï html:Ÿ Pí‘X¾This–?ýmethod“reads“a“PGM“formatted“file“and“pipes“the“data“into“a“Discrete2dŽ¡‘Xobject.ŽŸŸJïhtml:ï html:Ÿ]&ÀAccessing‘™™elementsŽŸò3¼The–‡öDiscrete2d“is“essentially“a“2d“array“of“ids.‘1zHo•Àwe“vÙ er™Ÿ,‘‰ówe–‡öalso“alloÀw“users“to“access“the“array“as“if“it“were“an“arrayŽ¡of–ï html:Ÿïhtml:ï html:ïhtml:ï html:Ÿ $$‘:Á-–ffgetObjectAtX:“(int)x“Y:“(int)yŽ¤bÌïhtml:ï html:Ÿ ë‘X¾Return–?ýthe“pointer“stored“at“(x,y).Ž¦ïhtml:ï html:ïhtml:ï html:Ÿ x‘:Á-–ffgetValueAtX:“(int)x“Y:“(int)yŽ¡ïhtml:ï html:Ÿ ë‘X¾Return–?ýthe“integer“stored“at“(x,y).Ž¦ïhtml:ï html:ïhtml:ï html:Ÿ x‘:Á-–ffputObject:‘ ÌÌanObject“atX:“(int)x“Y:“(int)yŽ¡ïhtml:ï html:Ÿ ë‘X¾Put–?ýthe“given“pointer“to“(x,y)“overwriting“whatever“was“there.Ž¦ïhtml:ï html:ïhtml:ï html:Ÿ x‘:Á-–ffputValue:‘ ÌÌ(int)v“atX:“(int)x“Y:“(int)yŽ¡ïhtml:ï html:© ë‘X¾Put–?ýthe“given“integer“to“(x,y)“overwriting“whatever“was“there.ŽŸŸJïhtml:ï html:Ÿ]&ÀLo•Û$w›™™leȽv“el˜accessŽŸò3¼FÙ or–»’speed,‘Êwsometimes“you“wægant“to“go“belošÀw“the“method“call“layer“and“access“cells“quickly‘ÿY .‘ÌNT‘ÿ37o“allo˜w“this“Discrete2dŽ¤ de nes–|þsome“macros“that“gišÀvÙ e“you“internal“access.‘—Use“these“at“your“o˜wn“peril!‘—In“particular™Ÿ,‘}˜subclasses“haÌÐvÙ e“no“wægayŽ¡to–€rede ne“the“macros.ŽŸ ´ïhtml:ï html:Ÿïhtml:ï html:ïhtml:ï html:Ÿ /¨‘:Á-–ff(id“*)getLatticeŽ¤bÌïhtml:ï html:¦‘X¾Returns–?ýthe“lattice“pointer“-“use“this“for“fast“access.ŽŸ8äïhtml:ï html:ïhtml:ï html:Ÿ x‘:Á-–ffdiscrete2dSiteAt(lattice,“offsets,“x,“y)Ž¡ïhtml:ï html:¦‘X¾Macro–?ýto“return“a“pointer“to“the“value“at“site“x,“y.‘ úlattice“is“the“returnŽŸ ‘Xvalue–?ýfrom“getLattice,“offsets“is“the“precomputed“offsets“(stored“in“self->offsets).ŽŸŸJïhtml:ï html:Ÿ]&ÀMiscellaneousŽŸò3¼These–€methods“are“used“in“ïhtml:ï html:Á-‘ffcreateEnd“¼to“actually“allocate“the“array‘ÿY .‘˜Subclasses“might“need“to“use“these.ŽŽŸ*ºâïcolor push Black’Ôï color popŽŽŒ‹ ˆ “ºâ ýxºâïcolor push Blackïhtml:ï html:ŸüfdŽŽŽ’Ôï color popŽŽ ^ºâ ýÆïhtml:ï html:ïhtml:ï html:ïhtml:ï html:Ÿ ‘:Á-‘ffmakeOffsetsŽž+Ãïhtml:ï html:Ÿ x ‘X¾Given–?ýan“array“size,“compute“the“offsets“array“that“caches“the“multiplicationŽ© ‘Xby–?ýysize.‘ úSee“the“ïhtml:ï html:Ádiscrete2dSiteAt“¾macro.ŽŸ8äïhtml:ï html:ïhtml:ï html:Ÿ k‘:Á-–ff(id“*)allocLatticeŽŸýoïhtml:ï html:Ÿ ¦ô‘X¾Allocate–?ýmemory“for“the“lattice.ŽŸ‘0„¤ŽŽ¤G®ïhtml:ï html:Ÿ`Í¿Grid2dŽŸJF¼Grid2d–‘„is“a“generic“container“class“to“represent“agent“position“on“a“2d“lattice.‘N#It“gets“most“of“its“behaÌÐviour“fromŽ¡Discrete2d,‘ï¢adding–ÙNešÙ xtra“code“to“check“that“you“don'Ñðt“o˜v˜erwrite“things“by“accident.‘%ƒGrid2d“is“pretty“primitiÀv˜e:‘Ì5onlyŽ¡one–€object“can“be“stored“at“a“site,“no“boundary“conditions“are“implied,“etc.‘˜A“fšægancier“Grid2d“is“in“the“w˜orks.ŽŸžïhtml:ï html:ŸÁÙÀNew‘™™MethodsŽ¤ 9 ïhtml:ï html:Ÿïhtml:ï html:ïhtml:ï html:Ÿ kC‘:Á-‘ffsetOverwriteWarnings:‘ ÌÌ(BOOL)bŽŸbÌïhtml:ï html:Ÿ A—‘X¾If–?ýset“to“true,“then“if“you“try“to“store“something“at“a“site“that“doesn'tŽ¦‘Xhave–?ý0x0“there,“a“warning“will“be“generated.ŽŸŸJïhtml:ï html:Ÿ³-ÀOvÛ$erridden‘™™methodsŽ¡ïhtml:ï html:Ÿïhtml:ï html:ïhtml:ï html:Ÿ kC‘:Á-–ffputObject:‘ ÌÌanObject“atX:“(int)x“Y:“(int)yŽ¤bÌïhtml:ï html:Ÿ A—‘X¾Replaces–?ýthe“Discrete2d“method.‘ úFirst“check“to“see“if“it“should“do“overwriteŽ¦‘Xwarnings,–?ýand“if“so“if“you're“going“to“overwrite:‘ úif“both“conditions“areŽ¦‘Xtrue,–?ýprint“out“a“warning“message.‘ úRegardless“of“the“check,“it“writes“theŽ¦‘Xnew–?ýobject“in.ŽŸ8äïhtml:ï html:ïhtml:ï html:Ÿ k‘:Á+‘ffcreateBegin:‘ ÌÌaZoneŽ¡ïhtml:ï html:Ÿ A—‘X¾Make–?ýoverwrite“warnings“be“on“by“default.ŽŸ‘0„¤ŽŽ¤G®ïhtml:ï html:Ÿ`Í¿DblBu er2dŽŸJF¼DblBu er2d– Öaugments“Discrete2d“to“proÙ vide“a“form“of“double“bÌÐu ered“space.‘óŠT‘ÿ37wægo“lattices“are“maintained:‘àƒlattice“(theŽ¡current–¨jstate),›²„and“neÀwLattice“(the“future“state).‘’ÕAll“reads“takæge“place“from“lattice,˜all“writes“takæge“place“to“neÀwLattice.Ž¡neÀwLattice–wis“copied“to“lattice“when“ïhtml:ï html:Á-‘ffupdateLattice“¼is“called.‘DblBu er2d“can“be“used“to“implement“one“modelŽ¡of–\íconcurrent“action,‘”(likæge“in“Ca2ds.‘°_ïhtml:ï html:¾NOTE¼:“be“všÙ ery“careful“if“you'‘ÿÿre“using“lo•Àw-le“v˜el–\ímacro“access“to“the“wægorld,‘”(inŽ¡particular–€be“sure“that“you“preservÙ e“the“write“semantics“on“the“neÀwLattice.ŽŽŸ*ºâïcolor push Black’Ôï color popŽŽŒ‹ù “ºâ ýxºâïcolor push Blackïhtml:ï html:ŸüfdŽŽŽ’Ôï color popŽŽ ^ºâ ýÆïhtml:ï html:Ÿ ÀNew‘™™MethodsŽŸ 9 ïhtml:ï html:Ÿïhtml:ï html:ïhtml:ï html:Ÿ ‘:Á-‘ffupdateLatticeŽ¤bÌïhtml:ï html:© Ûä‘X¾Copy–?ýnewLattice“to“lattice,“in“effect“updating“the“lattice.ŽŸ8äïhtml:ï html:ïhtml:ï html:Ÿ Ì‘:Á-–ff(id“*)getNewLatticeŽ¡ïhtml:ï html:¦‘X¾Like›?ýïhtml:ï html:Á-–ff(id“*)getLattice¾:‘ úreturn˜a˜pointer˜to˜the˜newLattice˜buffer.ŽŸŸJïhtml:ï html:ŸMzÀOvÛ$erridden‘™™MethodsŽŸ 9 ïhtml:ï html:Ÿïhtml:ï html:ïhtml:ï html:Ÿ ‘:Á-‘ffcreateEndŽžÉïhtml:ï html:Ÿ !ç‘X¾Rewrites–?ýthe“method“from“Discrete2d.‘ úAllocate“two“lattices,“makes“the“offsets.ŽŸcïhtml:ï html:ïhtml:ï html:Ÿ Û#‘:Á-–ffputObject:› ÌÌanObject“atX:“(int)x“Y:“(int)y–?ý¾and“ïhtml:ï html:Á-–ffputValue:˜(int)value“atX:ŽŸ ‘D(int)x–ffY:“(int)y‘?ý¾andŽ¡ïhtml:ï html:¦‘XOverridden–?ýso“writes“happen“to“newLattice.ŽŸ‘0„¤ŽŽŸG®ïhtml:ï html:Ÿû¿Ca2dŽŸ䓼Inherits–€from“DblBu er2d,“de nes“abstract“protocol“for“cellular“automata.ŽŸžïhtml:ï html:Ÿ\&ÀNew‘™™MethodsŽŸ 9 ïhtml:ï html:¤ïhtml:ï html:ïhtml:ï html:Ÿ ‘:Á-‘ffsetNumStates:‘ ÌÌ(int)dŽŸýoïhtml:ï html:Ÿ AA‘X¾Record–?ýthe“number“of“states“the“CA“understands.Ž¡ïhtml:ï html:ïhtml:ï html:Ÿ >°‘:Á-‘ffinitializeLatticeŽžÉïhtml:ï html:Ÿ !ç‘X¾Use–?ýthis“to“set“up“your“CA“to“a“default“initial“state.‘ úUnimplemented“in“Ca2d.ŽŸ8äïhtml:ï html:ïhtml:ï html:Ÿ Ì‘:Á-‘ffstepRuleŽŸbÌïhtml:ï html:¦‘X¾One–?ýiteration“of“the“CA“rule.‘ úUnimplemented“in“Ca2d.ŽŸŸJïhtml:ï html:ŸMzÀOvÛ$erridden‘™™MethodsŽŸ 9 ïhtml:ï html:¡ïhtml:ï html:ïhtml:ï html:Ÿ ‘:Á-‘ffcreateEndŽžÉïhtml:ï html:Ÿ !ç‘X¾Check–?ýthat“numStates“has“been“set.ŽŸ‘0„¤ŽŽŸG®ïhtml:ï html:Ÿû¿ConwayLife2dŽŸ䓼Classic–€2d“Conwægay'‘ÿs8s“Life“CA.ŽŽŸ*ºâïcolor push Black’Ôï color popŽŽŒ‹( “ºâ ýxºâïcolor push Blackïhtml:ï html:ŸüfdŽŽŽ’Ôï color popŽŽ ^ºâ ýÆïhtml:ï html:Ÿ ÀOvÛ$erridden‘™™MethodsŽŸ 9 ïhtml:ï html:¤ïhtml:ï html:ïhtml:ï html:Ÿ Îæ‘:Á+createBegin:‘ ÌÌaZoneŽ©bÌïhtml:ï html:Ÿ ¥:‘X¾Set–?ýnumber“of“states“to“2.Ž¡ïhtml:ï html:ïhtml:ï html:Ÿ ‘:Á-‘ffinitializeLatticeŽžÉïhtml:ï html:Ÿ ë=‘X¾Initialize–?ýlattice“to“random“1/3“in“state“1.ŽŸÕSïhtml:ï html:ïhtml:ï html:Ÿ 2³‘:Á-‘ffstepRuleŽ¦ïhtml:ï html:Ÿ ¥:‘X¾Run–?ýConway's“Life“rule“(simpleminded“version).ŽŸ‘0„¤ŽŽŸG®ïhtml:ï html:ŸÄp¿Di use2dŽŸ­é¼Discrete–€2nd“order“approximation“to“2d“di usion“with“e•Àv“aporation.‘˜Math–€is“done“in“inteÙ gers“on“the“range“[0,0x7 Àf].ŽŸžïhtml:ï html:Ÿ%|ÀNew‘™™MethodsŽŸ 9 ïhtml:ï html:¡ïhtml:ï html:ïhtml:ï html:Ÿ Îæ‘:Á-‘ffsetDiffusionConstant:‘ ÌÌ(double)dŽŸýoïhtml:ï html:Ÿ —‘X¾Set–?ýthe“diffusion“constant.‘ úValues“over“1.0“might“not“be“valid.ŽŸ8äïhtml:ï html:ïhtml:ï html:Ÿ Ï"‘:Á-‘ffsetEvaporationRate:‘ ÌÌ(double)dŽ¦ïhtml:ï html:Ÿ ¥:‘X¾Set–?ýthe“evaporation“rate.‘ úValues“over“1.0“don't“make“much“sense.ŽŸŸJïhtml:ï html:ŸÐÀOvÛ$erridden‘™™MethodsŽŸ 9 ïhtml:ï html:¡ïhtml:ï html:ïhtml:ï html:Ÿ Îæ‘:Á+createBegin:‘ ÌÌaZoneŽ¦ïhtml:ï html:Ÿ ¥:‘X¾Set–?ýdiffusion“constant“and“evaporation“rate“to“1.0,“numStates“to“0x7fff.ŽŸ8äïhtml:ï html:ïhtml:ï html:Ÿ Ï"‘:Á-‘ffinitializeLatticeŽžÉïhtml:ï html:Ÿ ë=‘X¾Initialize–?ýworld“to“0.Ž¡ïhtml:ï html:ïhtml:ï html:Ÿ ‘:Á-‘ffstepRuleŽ¦ïhtml:ï html:Ÿ ¥:‘X¾Run–?ýdiscrete“approximation“to“diffusion.‘ úRoughly,“it'sŽ¤8äïhtml:ï html:© Ï"‘XnewHeat–?ý=“evapRate“*“(self“+“diffuseConstant*(nbdavg“-“self))Ž¡ïhtml:ï html:¦‘Xwhere–?ýnbdavg“is“the“weighted“average“of“the“8“neighbours.ŽŸ‘0„¤ŽŽ¤G®ïhtml:ï html:ŸÄp¿Object2dDisplayŽŸ­é¼Object2dDisplay–Ôhelps“display“2d“arrays“of“objects.‘æCreate“a“Object2dDisplay‘ÿY ,‘é giÀvšÙ e“it“a“Raster“widget“to“dra˜w“on,‘é aŽ¡Discrete2d,››Óa––Cmessage“to“call“on“each“object,˜and“(optionally)“a“collection“of“objects“and“it“will“dispatch“the“messageŽ¡to–€all“objects“with“the“Raster“widget“as“an“arÑðgument.‘˜In“addition,“Object2dDisplay“can“help“you“makæge“probees.ŽŽŸ*ºâïcolor push Black’Ôï color popŽŽŒ‹2u “ºâ ýxºâïcolor push Blackïhtml:ï html:ŸüfdŽŽŽ’Ôï color popŽŽ ^ºâ ýÆïhtml:ï html:Ÿ ÀCr½«eation‘™™PhaseŽŸ 9 ïhtml:ï html:Ÿïhtml:ï html:ïhtml:ï html:Ÿ 0S‘:Á-–ffsetDisplayWidget:‘ ÌÌ(Raster“*)rŽ¤bÌïhtml:ï html:© §‘X¾Set–?ýthe“display“widget“to“use“for“drawing.ŽŸ8äïhtml:ï html:ïhtml:ï html:Ÿ 0‘:Á-–ffsetDiscrete2dToDisplay:‘ ÌÌ(Discrete2d“*)cŽ¡ïhtml:ï html:¦‘X¾Set–?ýthe“2d“array“to“drawŽŸ8äïhtml:ï html:ïhtml:ï html:Ÿ 0‘:Á-‘ffsetDisplayMessage:‘ ÌÌ(SEL)sŽ¡ïhtml:ï html:¦‘X¾Set–?ýthe“message“to“be“sent“to“each“object“in“the“grid“to“make“it“draw“itself.ŽŸ8äïhtml:ï html:ïhtml:ï html:Ÿ 0‘:Á-‘ffsetObjectCollection:‘ ÌÌobjectsŽ¡ïhtml:ï html:¦‘X¾(optional)–?ýset“a“collection“of“objects“to“be“displayed.‘ úIf“this“is“not“given,Ž¤ ‘Xthen–?ýObject2dDisplay“loops“through“the“2d“grid“sending“draw“messages“to“allŽ¡‘Xobjects–?ýit“finds“there.‘ úGiving“an“explicit“collection“of“objects“to“drawŽ¡‘Xis–?ýmore“efficient“if“your“grid“is“sparsely“populated.ŽŸŸJïhtml:ï html:Ÿx=ÀUseŽŸ 9 ïhtml:ï html:Ÿïhtml:ï html:ïhtml:ï html:Ÿ 0S‘:Á-‘ffdisplayŽŸbÌïhtml:ï html:¦‘X¾Draw–?ýall“objects“in“the“array“(or“optionally,“the“collection)“on“the“rasterŽ¡‘Xwidget.‘ úAll–?ýthat“happens“here“is“the“display“message“is“sent“to“each“objectŽ¡‘X-–?ýit“is“the“object's“responsibility“to“render“itself.ŽŸ8äïhtml:ï html:ïhtml:ï html:Ÿ 0‘:Á-–ffmakeProbeAtX:“(int)x“Y:“(int)yŽŸbÌïhtml:ï html:¦‘X¾Find–?ýan“object“at“the“given“(x,y)“coordinate“and“build“a“probe“display“forŽ¡‘Xit.‘ úThis–?ýis“a“good“method“to“make“a“button“client“for“a“raster“widget“likeŽŸ8äïhtml:ï html:Ÿ 0‘0Á[aRaster–ffsetButtonClient:“aObject2dDisplay“Message:“M(makeProbeAtX:Y:)]ŽŸ‘0„¤ŽŽ¤G®ïhtml:ï html:Ÿ%Ý¿V‘þialue2dDisplayŽŸV¼V›þã×alue2dDisplay–›`helps“display“2d“arrays“of“vÀalues.‘k·V˜alue2dDisplay“goes“through“a“giÀvÙ en“Discrete2d“array‘ÿY ,‘¢8turn“statesŽ¡into–€colours,“and“draÙ ws“them“into“a“Raster“widget.ŽŸžïhtml:ï html:Ÿ†éÀCr½«eation‘™™PhaseŽŸ 9 ïhtml:ï html:Ÿïhtml:ï html:ïhtml:ï html:Ÿ 0S‘:Á-–ffsetDisplayWidget:› ÌÌ(Raster“*)r“Colormap:˜(XColormap“*)cŽ¤bÌïhtml:ï html:¦‘X¾Set–?ýthe“display“widget“and“the“colourmap“to“use“to“draw“the“value“array.ŽŸ8äïhtml:ï html:ïhtml:ï html:Ÿ 0‘:Á-–ffsetDiscrete2dToDisplay:‘ ÌÌ(Discrete2d“*)cŽ¡ïhtml:ï html:¦‘X¾Set–?ýwhich“array“to“draw.ŽŸ8äïhtml:ï html:ïhtml:ï html:Ÿ 0‘:Á-–ffsetDisplayMappingM:“(int)m“C:“(int)cŽ¡ïhtml:ï html:¦‘X¾Linear–?ýtransform“of“states“to“colours“for“drawing.ŽŸ8äïhtml:ï html:ŽŸ*ºâïcolor push Black’Ôï color popŽŽŒ‹>& “ºâ ýxºâïcolor push Blackïhtml:ï html:ŸüfdŽŽŽ’Ôï color popŽŽ ^ ýБWºâ¾color–?ý=“state“/“m“+“cŽºâŸÕSïhtml:ï html:Ÿ ;Ó‘XIf–?ýnot“set,“assume“m“==“1“and“c“==“0.ŽŸÉóïhtml:ï html:ŸõGÀUseŽŸ 9 ïhtml:ï html:©ïhtml:ï html:ïhtml:ï html:Ÿ Ø‘:Á-‘ffdisplayŽŸbÌïhtml:ï html:Ÿ ®Z‘X¾Draw–?ýthe“array“on“the“given“widget.‘ úNote“that“you“still“have“to“tell“theŽ¤ ‘Xwidget–?ýto“draw“itself“afterwards.‘ úThe“code“for“display“uses“the“fast“macroŽ¡‘Xaccess–?ýin“Discrete2d“on“the“cached“return“value“from“getLattice.‘ úIt“alsoŽ¡‘Xcaches–?ýthe“ïhtml:ï html:ÁdrawPointX:Y:“¾method“lookup“on“the“display“widget“-“this“is“a“niceŽ¡‘Xtrick–?ýthat“you“might“want“to“look“at.ŽŸ‘0„¤ŽŽŸG®ïhtml:ï html:ŸÍ¿Int2dFilerŽŸ· ¼The–€Int2dFiler“class“is“used“to“saÌÐvšÙ e“the“state“of“an˜y“Discrete2d“object“(or“a“subclass“thereof)“to“a“speci ed“ le.ŽŸžïhtml:ï html:Ÿ.œÀA–™™Note“on“Output“F£×ormatsŽŸ´ý¼The–,”issue“of“what“format(s)“the“class“should“knoÀw“about“is“still“open.‘ýÊFšÙ or“the“purposes“that“I‘,haÌÐv˜e“encountered,‘=CsimplyŽ¡storing–€the“vÀalues“in“space-delimited“line“format:ŽŸ Îïhtml:ï html:ïhtml:ï html:Ÿ æî‘0Ávalue0_0–ffvalue0_1“...Ž¤ &‘0value1_0–ffvalue1_1“...Ž¡‘0...Ž¡‘0...Ž¡¼has–€been“sucient.‘˜In“particular™Ÿ,“the“output“of“this“class“has“been“used,“in“conjunction“with“the“ïhtml:ï html:¾fragstatsïhtml:ï html:Ž¡(ftp://ftp.fsl.orst.edu/pub/fragstats.2.0/)Ž¡¼package,–€to“apply“landscape“metrics“to“the“output“of“a“Swægarm“simulation.‘˜NeÀvÙ ertheless,“I“(ïhtml:ï html:¾Manor‘?ýAskenaziïhtml:ï html:Ž¡(mailto:‘ úmanor@santafe.edu)Ž¡¼)–@Çwægould“be“všÙ ery“interested“in“hearing“from“end-users“about“an˜y“other“(presumably“more“comple˜x“formats),‘Mlas“the“needŽ¤ arises.ŽŸ ´ïhtml:ï html:¦ïhtml:ï html:ïhtml:ï html:Ÿ òr‘:¾-–?ýsetDiscrete2dToFile:‘ ú(Discrete2d“*)aSpaceŽŸ8äïhtml:ï html:© ØB‘XSet–?ýthe“target“space“to“be“filled.‘ úThis“message“can“be“used“more“than“once,Ž¡‘Xbut–?ýoften“it“is“useful“to“keep“one“Int2dFiler“per“space“(e.g.‘ úwhen“the“spaceŽ¡‘Xis–?ýsaved“multiple“times).ŽŸ8äïhtml:ï html:ïhtml:ï html:¦‘:-‘?ýsetValueMessage:‘ ú(SEL)aSelectorŽŸ8äïhtml:ï html:¦‘XThis–?ýmessage“is“optional.‘ úIt“is“used“when“the“target“Discrete2d“containsŽ¡‘Xobjects.‘ úBy–?ýsending“each“object“the“message“specified“by“the“selector,“theŽ¡‘XInt2dFiler–?ýis“able“to“get“from“the“object“an“integer“representing“its“state,Ž¡‘Xwhich–?ýit“then“writes“to“the“file.ŽŸïhtml:ï html:ïhtml:ï html:Ÿ &‘:-‘?ýsetBackground:‘ ú(int)aValueŽŸ8äïhtml:ï html:ŽŸ*ºâïcolor push Black’Ôï color popŽŽŒ‹Ke “ºâ ýxºâïcolor push Blackïhtml:ï html:ŸüfdŽŽŽ’Ôï color popŽŽ ^ ýБWºâ¾This–?ýmessage“is“optional.‘ úIt“is“used“when“the“target“Discrete2d“containsŽ¤ ‘Wºâobjects.‘ úIf–?ýa“particular“location“in“the“space“has“no“resident“object,“theŽ¡‘Wºâargument–?ýof“this“message“is“the“value“which“gets“writtent“to“the“file.‘ úTheŽ¡‘Wºâdefault–?ýbackground“value“is“0.Žºâ©8äïhtml:ï html:ïhtml:ï html:Ÿ Ç‘:-–?ýfileTo:‘ ú(const“char“*)fileNameŽŸÕSïhtml:ï html:Ÿ *­‘XWhen–?ýthe“Int2dFiler“receives“this“message,“it“opens“a“file“called“ïhtml:ï html:óßêï html:¡‘0ÄMarcus–?ýG.“Daniels“ïhtml:ï html:‘¼rïhtml:ï html:Ž¡‘0(mailto:mgd@santafe.edu)Ž¦ïhtml:ï html:Ÿ Ç‘0¾Last‘?ýmodified:‘ ú1997-12-17ŽŽŸ*ºâïcolor push Black’Ôï color popŽŽŒøWõƒ’À;è—T~Óºâ óßê