{"id":37,"date":"2017-06-20T14:45:49","date_gmt":"2017-06-20T13:45:49","guid":{"rendered":"http:\/\/documentation.particleflocker.com\/?post_type=docs&#038;p=37"},"modified":"2017-07-18T23:23:45","modified_gmt":"2017-07-18T22:23:45","slug":"particle-flocker-attributes","status":"publish","type":"docs","link":"https:\/\/documentation.particleflocker.com\/?docs=particle-flocker-user-guide\/system-components\/particleflocker\/particle-flocker-attributes","title":{"rendered":"Particle Flocker Attributes"},"content":{"rendered":"<p>Each <a href=\"http:\/\/documentation.particleflocker.com\/?docs=particle-flocker-user-guide\/system-components\/particleflocker\">ParticleFlocker <\/a>node exposes a number of attributes which control the behaviour of the flocking system.<\/p>\n<h3>Simulation Accuracy<\/h3>\n<p>This attribute ranges from 0-1 and controls the accuracy of the simulation.<\/p>\n<p>The system sets the accuracy by intermittently skipping simulation steps. The Simulation Accuracy attribute controls the <em>probability<\/em> that a particle will perform its simulation step on each frame. So for example a value of 0.5 means that there is a 50% probability that a particle will perform a simulation calculation on each frame whereas a value of 1 means that particles will always perform the simulation calculations.<\/p>\n<p>Reducing the Simulation Accuracy attribute will improve the simulation performance in Maya and can be used to speed up playback when working with complex scenes or very high numbers of particles. However it should also be noted that reducing the accuracy of the simulation will result in more particle or obstacle intersections and less exact steering behaviour.<\/p>\n<h3>Number of Neighbours<\/h3>\n<p>This attribute sets the number of neighbouring particles that each particle will react to. For example if this value is set to 2, each particle will consider its 2 nearest neighbours during the simulation.<\/p>\n<p>Flocking systems work because individual members of the flock will react to other flock members. Without this &#8220;awareness&#8221; of their neighbours, particles would not be able to move as a flock.<\/p>\n<p>It is important to note that determining the nearest neighbours of a particular particle is quite an expensive (slow) operation and so the higher this number, the slower the simulation.<\/p>\n<h3>Boid Separation<\/h3>\n<p>This attribute controls how far apart individual particles will attempt to stay away from one another.<\/p>\n<p>See <a href=\"http:\/\/documentation.particleflocker.com\/?docs=flocking-systems\/standard-flocking-behaviour\/separation\">Separation <\/a>for more information on this behaviour type.<\/p>\n<p>This value is specified in Maya&#8217;s current UI units, meaning that the value will vary depending on the units Maya is currently working in (i.e. centimeters, meters etc.)<\/p>\n<h3 id=\"obstacle_separation\">Obstacle Separation<\/h3>\n<p>This attribute controls how far particles will attempt to stay away from the surface of obstacles and containers. See <a href=\"http:\/\/documentation.particleflocker.com\/?docs=particle-flocker-user-guide\/system-components\/obstacles\">Obstacles <\/a>for details on how this is used.<\/p>\n<p>This value is specified in Maya&#8217;s current UI units, meaning that the value will vary depending on the units Maya is currently working in (i.e. centimeters, meters etc.)<\/p>\n<h3>Maximum Speed<\/h3>\n<p>This attribute sets the maximum speed at which particles are able to travel.<\/p>\n<p>Because particles are controlled by simple physical forces, the higher the speed of a particle the higher the force required to make them change direction.<\/p>\n<p>This value is specified in Maya&#8217;s current units per second, meaning that the value will vary depending on the units Maya is currently working in (i.e. centimeters per second, meters per second etc.)<\/p>\n<h3>Maximum Force<\/h3>\n<p>This attribute sets the maximum force that can be applied to a particle in order to steer.<\/p>\n<p>This applies to all particle steering, including standard flocking behaviour, steering behaviour and obstacle avoidance.<\/p>\n<p>This value is specified in Maya&#8217;s current UI units per second per second, meaning that the value will vary depending on the units Maya is currently working in (i.e. centimeters per second per second, meters\u00a0per second per second etc)<\/p>\n<h3 id=\"boid_sep_urge\">Boid Separation Urge<\/h3>\n<p>This attribute controls the strength of the particle&#8217;s <a href=\"http:\/\/documentation.particleflocker.com\/?docs=flocking-systems\/standard-flocking-behaviour\/separation\">Separation <\/a>urge.<\/p>\n<p>A value of 1 means the particle will fully perform this standard behaviour while a value of 0 means this behaviour will be ignored. You may also use values greater than 1 to boost the urgency of this behaviour.<\/p>\n<h3>Flock Centring Urge<\/h3>\n<p>This attribute controls the strength of the particle&#8217;s <a href=\"http:\/\/documentation.particleflocker.com\/?docs=flocking-systems\/standard-flocking-behaviour\/flock-centring\">Flock Centring<\/a> urge.<\/p>\n<p>A value of 1 means the particle will fully perform this flocking behaviour, while a value of 0 means this behaviour will be ignored. You may also use values greater than 1 to boost the urgency of this behaviour.<\/p>\n<h3>Velocity Matching Urge<\/h3>\n<p>This attribute controls the strength of the particle&#8217;s <a href=\"http:\/\/documentation.particleflocker.com\/?docs=flocking-systems\/standard-flocking-behaviour\/velocity-matching\">Velocity Matching<\/a> urge.<\/p>\n<p>A value of 1 means the particle will fully perform this flocking behaviour, while a value of 0 means this behaviour will be ignored. You may also use values greater than 1 to boost the urgency of this behaviour.<\/p>\n","protected":false},"author":1,"featured_media":0,"parent":34,"menu_order":0,"comment_status":"closed","ping_status":"closed","template":"","meta":[],"doc_tag":[],"_links":{"self":[{"href":"https:\/\/documentation.particleflocker.com\/index.php?rest_route=\/wp\/v2\/docs\/37"}],"collection":[{"href":"https:\/\/documentation.particleflocker.com\/index.php?rest_route=\/wp\/v2\/docs"}],"about":[{"href":"https:\/\/documentation.particleflocker.com\/index.php?rest_route=\/wp\/v2\/types\/docs"}],"author":[{"embeddable":true,"href":"https:\/\/documentation.particleflocker.com\/index.php?rest_route=\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/documentation.particleflocker.com\/index.php?rest_route=%2Fwp%2Fv2%2Fcomments&post=37"}],"version-history":[{"count":10,"href":"https:\/\/documentation.particleflocker.com\/index.php?rest_route=\/wp\/v2\/docs\/37\/revisions"}],"predecessor-version":[{"id":766,"href":"https:\/\/documentation.particleflocker.com\/index.php?rest_route=\/wp\/v2\/docs\/37\/revisions\/766"}],"up":[{"embeddable":true,"href":"https:\/\/documentation.particleflocker.com\/index.php?rest_route=\/wp\/v2\/docs\/34"}],"next":[{"title":"Attribute Output Types","link":"https:\/\/documentation.particleflocker.com\/?docs=particle-flocker-user-guide\/system-components\/particleflocker\/attribute-output-types","href":"https:\/\/documentation.particleflocker.com\/index.php?rest_route=\/wp\/v2\/docs\/283"}],"wp:attachment":[{"href":"https:\/\/documentation.particleflocker.com\/index.php?rest_route=%2Fwp%2Fv2%2Fmedia&parent=37"}],"wp:term":[{"taxonomy":"doc_tag","embeddable":true,"href":"https:\/\/documentation.particleflocker.com\/index.php?rest_route=%2Fwp%2Fv2%2Fdoc_tag&post=37"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}