Back to PIA's main page

Initialization V2

This tab contains parameters relate to the initialization of BOIDs in the scene - initial positioning, initial heading, and BOID orientation.

Initial Position ParametersEdit

PySwarm offers a number of different ways to initialize BOIDs' positions within the scene.

Positioning OptionsEdit

There are three options available to initialize the starting positions of the BOIDs in the scene:

  1. Use the current placement of the BOIDs (don’t move them)
  2. Place them randomly inside containment zone #1
  3. Place them randomly inside a sphere with a predefined center and radius flat surface)

Sphere's RadiusEdit

The radius of the sphere (in feet) when the third positioning option is selected.

Sphere's CenterEdit

The center of the sphere (x,y,z coordinates in feet) when the third positioning option is selected.

Note Icon

Note: You will not be able to edit the sphere radius and center parameter fields until you select the "Inside a Sphere" radio button in the Initial Positioning Options group.

Tips and LimitationsEdit

  1. If you are creating a multiple segment animation, you will probably want to use the "Current BOID Position" option after the first segment has been imported. This will force PySwarm to use the current position for animating the next segment.
  2. The Containment Rule does not have to be active to use the "Inside Containment Zone #1" option; however, you must check Zone #1's "Active Zone" checkbox (in the Containment tab).

Initial Heading ParametersEdit

You also have a number of options available to initiate BOID headings at the start of the animation.

Heading OptionsEdit

There are three options to initialize the heading of BOIDs at the start of the animation sequence.

  1. Use the BOIDs' current heading
  2. Randomly set the heading of each BOID
  3. Use a predefined heading (described using the "Initial Heading" and "Initial Pitch" parameters below).

Initial HeadingEdit

When the third option is selected, all BOIDs' heading begins with this value (in degrees). A value of 0.0 degrees points in the +x axis; 90.0 degrees in the +y axis; etc.

Initial PitchEdit

With the third option selected, you can also specify the angle (in degrees) that all BOIDs will move in (up and down). A positive angle positions the BOIDs moving upwards; a negative angle points the BOIDs downwards. This angle cannot exceed +/- 90.0 degrees.

Note Icon

Note: You will not be able to edit the initial heading and initial pitch parameter fields until you select the "Predefined Heading" radio button in the Initial Heading Options group.

Tips and LimitationsEdit

  1. BOIDs' speed is set using the "Initial Speed" parameter described in the Movement tab here.
  2. The initial pitch must be between the minimum and maximum pitch values set in the Movement tab here.

Orientation ParameterEdit

PySwarm expects BOIDs to be facing in the +X axis in their default orientation (all orientation and rotation angles set to zero). There will be occasions that objects you want to use a BOIDs are not in this orientation. The orientation parameter allows you to use a number of default orientations.

Default BOID OrientationEdit

Select one of the orientation options from the pulldown list.

Tips and LimitationsEdit

  1. To know what your BOID's default orientation is, select the BOID object in Carrara and go to the Motion tab. Under the Transform section, clear out (zero) the X, Y, and Z values for Orient. and Rotation. Your BOID is now in its default orientation.
  2. Currently, only the orientations in the list are supported by PySwarm. If the orientation of your BOID object is not in this list, you will need to select all of the child objects in your BOID and rotate them into a position that is supported.

Ad blocker interference detected!

Wikia is a free-to-use site that makes money from advertising. We have a modified experience for viewers using ad blockers

Wikia is not accessible if you’ve made further modifications. Remove the custom ad blocker rule(s) and the page will load as expected.