user: What is Options and how is it used in Blender Python scripting?

assistant: [[image reference removed]](../../../_images/modeling_modifiers_physics_particle-instance_panel.png)

The Particle Instance modifier.

Object
:   The target object which has a particle system associated with it.

Particle System
:   Which particle system from the target *Object* to apply this modifier to.

Create Instances
:   Regular
    :   When enabled, the modifier will use the regular (parents) particles
        to duplicate the mesh of the modified object.

    Children
    :   When enabled, the modifier will use the [children](../../../physics/particles/emitter/children.html) particles
        to duplicate the mesh of the modified object.

    Size
    :   Scale the instanced copies of the mesh by the particle size attribute.
        When this is disabled, all the copies appear the same size as the origin.

        See the particle system’s [Render](../../../physics/particles/emitter/render.html)
        and [Children](../../../physics/particles/emitter/children.html) panels for particle’s size options.

Show
:   Unborn
    :   When enabled, the modifier will use the unborn particles
        to duplicate the mesh of the modified object.

    Alive
    :   When enabled, the modifier will use the alive particles
        to duplicate the mesh of the modified object.

    Dead
    :   When enabled, the modifier will use the dead particles
        to duplicate the mesh of the modified object.

Amount
:   The proportion of particles to be used.
    Allows you to **randomly** skip particles to adjust the amount of instances.

Offset
:   A relative offset in the range of particles used for instantiation.
    Allows you to avoid overlapping of the used particles,
    when the same particle system is used in multiple modifier instances.

Coordinate Space
:   World, Local
    :   Use [World Space](../../../glossary/index.html#term-World-Space), or [Local Space](../../../glossary/index.html#term-Local-Space) of the target object (that the particle system is assigned to).

        - World space means that the locations of the copies of the modified mesh will depend
          on the location of the modified object **and** of the target object.
        - Local space means that the locations of the copies of the modified mesh will depend
          only on the location of the modified object.

Axis
:   Specify which axis of the modified object to use as pole axis to apply
    the rotation from the instantiated particles.

### Create Along Paths

By default, the instances are placed depending on the particles position in the current frame.
By enabling *Create Along Paths*, the instance of the modified object follows
deforms its shape along the particle path (or the hair strand).
This allows you to select the position along the particles path regardless of the current frame.

Position
:   Specify what percentage of the path that the instance fills,
    or the position on the path if the *Keep Shape* option is enabled.

Random
:   Adds randomness to the *Position* value of each instance.

Rotation
:   Specifies the rotation around the path.

Random
:   Adds randomness to the *Rotation* value of each instance.

Keep Shape
:   Enabling this prevents the instance from being deformed,
    and places it on the path according to the *Position* value.

### Layers

With these fields you can select the Color Attribute,
which will be filled with colors based on the particles information.
These Color Attributes can be used, for example, in a shader to add variance to a material.

Index
:   A Color Attribute for values based on the particles index.

Value
:   A Color Attribute for random per-particle values.