FluidDomainSettings(bpy_struct)

base class — bpy_struct

class bpy.types.FluidDomainSettings(bpy_struct)

Fluid domain settings

adapt_margin

Margin added around fluid to minimize boundary interference

Type:

int in [2, 24], default 4

adapt_threshold

Minimum amount of fluid a cell can contain before it is considered empty

Type:

float in [0, 1], default 0.02

additional_res

Maximum number of additional cells

Type:

int in [0, 512], default 0

alpha

Buoyant force based on smoke density (higher value results in faster rising smoke)

Type:

float in [-5, 5], default 1.0

beta

Buoyant force based on smoke heat (higher value results in faster rising smoke)

Type:

float in [-5, 5], default 1.0

burning_rate

Speed of the burning reaction (higher value results in smaller flames)

Type:

float in [0.01, 4], default 0.75

cache_data_format

Select the file format to be used for caching volumetric data

Type:

enum in [‘NONE’], default ‘NONE’

cache_directory

Directory that contains fluid cache files

Type:

string, default “”, (never None)

cache_frame_end

Frame on which the simulation stops (last frame baked)

Type:

int in [-1048574, 1048574], default 250

cache_frame_offset

Frame offset that is used when loading the simulation from the cache. It is not considered when baking the simulation, only when loading it.

Type:

int in [-1048574, 1048574], default 0

cache_frame_pause_data
Type:

int in [-inf, inf], default 0

cache_frame_pause_guide
Type:

int in [-inf, inf], default 0

cache_frame_pause_mesh
Type:

int in [-inf, inf], default 0

cache_frame_pause_noise
Type:

int in [-inf, inf], default 0

cache_frame_pause_particles
Type:

int in [-inf, inf], default 0

cache_frame_start

Frame on which the simulation starts (first frame baked)

Type:

int in [-1048574, 1048574], default 1

cache_mesh_format

Select the file format to be used for caching surface data

Type:

enum in [‘NONE’], default ‘NONE’

cache_noise_format

Select the file format to be used for caching noise data

Type:

enum in [‘NONE’], default ‘NONE’

cache_particle_format

Select the file format to be used for caching particle data

Type:

enum in [‘NONE’], default ‘NONE’

cache_resumable

Additional data will be saved so that the bake jobs can be resumed after pausing. Because more data will be written to disk it is recommended to avoid enabling this option when baking at high resolutions.

Type:

boolean, default False

cache_type

Change the cache type of the simulation

  • REPLAY Replay – Use the timeline to bake the scene.

  • MODULAR Modular – Bake every stage of the simulation separately.

  • ALL All – Bake all simulation settings at once.

Type:

enum in [‘REPLAY’, ‘MODULAR’, ‘ALL’], default ‘REPLAY’

cell_size

Cell Size

Type:

mathutils.Vector of 3 items in [-inf, inf], default (0.0, 0.0, 0.0), (readonly)

cfl_condition

Maximal velocity per cell (greater CFL numbers will minimize the number of simulation steps and the computation time.)

Type:

float in [0, 10], default 2.0

clipping

Value under which voxels are considered empty space to optimize rendering

Type:

float in [0, 1], default 1e-06

color_grid

Smoke color grid

Type:

float array of 32 items in [-inf, inf], default (0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0), (readonly)

color_ramp
Type:

ColorRamp, (readonly)

color_ramp_field

Simulation field to color map

Type:

enum in [‘NONE’], default ‘NONE’

color_ramp_field_scale

Multiplier for scaling the selected field to color map

Type:

float in [0.001, 100000], default 1.0

delete_in_obstacle

Delete fluid inside obstacles

Type:

boolean, default False

density_grid

Smoke density grid

Type:

float array of 32 items in [-inf, inf], default (0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0), (readonly)

display_interpolation

Interpolation method to use for smoke/fire volumes in solid mode

  • LINEAR Linear – Good smoothness and speed.

  • CUBIC Cubic – Smoothed high quality interpolation, but slower.

  • CLOSEST Closest – No interpolation.

Type:

enum in [‘LINEAR’, ‘CUBIC’, ‘CLOSEST’], default ‘LINEAR’

display_thickness

Thickness of smoke display in the viewport

Type:

float in [0.001, 1000], default 1.0

dissolve_speed

Determine how quickly the smoke dissolves (lower value makes smoke disappear faster)

Type:

int in [1, 10000], default 5

domain_resolution

Smoke Grid Resolution

Type:

int array of 3 items in [-inf, inf], default (0, 0, 0), (readonly)

domain_type

Change domain type of the simulation

  • GAS Gas – Create domain for gases.

  • LIQUID Liquid – Create domain for liquids.

Type:

enum in [‘GAS’, ‘LIQUID’], default ‘GAS’

effector_group

Limit effectors to this collection

Type:

Collection

effector_weights
Type:

EffectorWeights, (readonly)

export_manta_script

Generate and export Mantaflow script from current domain settings during bake. This is only needed if you plan to analyze the cache (e.g. view grids, velocity vectors, particles) in Mantaflow directly (outside of Blender) after baking the simulation.

Type:

boolean, default False

flame_grid

Smoke flame grid

Type:

float array of 32 items in [-inf, inf], default (0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0), (readonly)

flame_ignition

Minimum temperature of the flames (higher value results in faster rising flames)

Type:

float in [0.5, 5], default 1.5

flame_max_temp

Maximum temperature of the flames (higher value results in faster rising flames)

Type:

float in [1, 10], default 3.0

flame_smoke

Amount of smoke created by burning fuel

Type:

float in [0, 8], default 1.0

flame_smoke_color

Color of smoke emitted from burning fuel

Type:

mathutils.Color of 3 items in [0, inf], default (0.7, 0.7, 0.7)

flame_vorticity

Additional vorticity for the flames

Type:

float in [0, 2], default 0.5

flip_ratio

PIC/FLIP Ratio. A value of 1.0 will result in a completely FLIP based simulation. Use a lower value for simulations which should produce smaller splashes.

Type:

float in [0, 1], default 0.97

fluid_group

Limit fluid objects to this collection

Type:

Collection

force_collection

Limit forces to this collection

Type:

Collection

fractions_distance

Determines how far apart fluid and obstacle are (higher values will result in fluid being further away from obstacles, smaller values will let fluid move towards the inside of obstacles)

Type:

float in [-5, 5], default 0.5

fractions_threshold

Determines how much fluid is allowed in an obstacle cell (higher values will tag a boundary cell as an obstacle easier and reduce the boundary smoothening effect)

Type:

float in [0.001, 1], default 0.05

gravity

Gravity in X, Y and Z direction

Type:

mathutils.Vector of 3 items in [-1000.1, 1000.1], default (0.0, 0.0, -9.81)

gridlines_cell_filter

Cell type to be highlighted

  • NONE None – Highlight the cells regardless of their type.

  • FLUID Fluid – Highlight only the cells of type Fluid.

  • OBSTACLE Obstacle – Highlight only the cells of type Obstacle.

  • EMPTY Empty – Highlight only the cells of type Empty.

  • INFLOW Inflow – Highlight only the cells of type Inflow.

  • OUTFLOW Outflow – Highlight only the cells of type Outflow.

Type:

enum in [‘NONE’, ‘FLUID’, ‘OBSTACLE’, ‘EMPTY’, ‘INFLOW’, ‘OUTFLOW’], default ‘NONE’

gridlines_color_field

Simulation field to color map onto gridlines

  • NONE None – None.

  • FLAGS Flags – Flag grid of the fluid domain.

  • RANGE Highlight Range – Highlight the voxels with values of the color mapped field within the range.

Type:

enum in [‘NONE’, ‘FLAGS’, ‘RANGE’], default ‘NONE’

gridlines_lower_bound

Lower bound of the highlighting range

Type:

float in [-inf, inf], default 0.0

gridlines_range_color

Color used to highlight the range

Type:

float array of 4 items in [0, inf], default (1.0, 0.0, 0.0, 1.0)

gridlines_upper_bound

Upper bound of the highlighting range

Type:

float in [-inf, inf], default 1.0

guide_alpha

Guiding weight (higher value results in greater lag)

Type:

float in [1, 100], default 2.0

guide_beta

Guiding size (higher value results in larger vortices)

Type:

int in [1, 50], default 5

guide_parent

Use velocities from this object for the guiding effect (object needs to have fluid modifier and be of type domain))

Type:

Object

guide_source

Choose where to get guiding velocities from

  • DOMAIN Domain – Use a fluid domain for guiding (domain needs to be baked already so that velocities can be extracted). Guiding domain can be of any type (i.e. gas or liquid)..

  • EFFECTOR Effector – Use guiding (effector) objects to create fluid guiding (guiding objects should be animated and baked once set up completely).

Type:

enum in [‘DOMAIN’, ‘EFFECTOR’], default ‘DOMAIN’

guide_vel_factor

Guiding velocity factor (higher value results in greater guiding velocities)

Type:

float in [0, 100], default 2.0

has_cache_baked_any
Type:

boolean, default False

has_cache_baked_data
Type:

boolean, default False

has_cache_baked_guide
Type:

boolean, default False

has_cache_baked_mesh
Type:

boolean, default False

has_cache_baked_noise
Type:

boolean, default False

has_cache_baked_particles
Type:

boolean, default False

heat_grid

Smoke heat grid

Type:

float array of 32 items in [-inf, inf], default (0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0), (readonly)

highres_sampling

Method for sampling the high resolution flow

Type:

enum in [‘FULLSAMPLE’, ‘LINEAR’, ‘NEAREST’], default ‘FULLSAMPLE’

is_cache_baking_any
Type:

boolean, default False

is_cache_baking_data
Type:

boolean, default False

is_cache_baking_guide
Type:

boolean, default False

is_cache_baking_mesh
Type:

boolean, default False

is_cache_baking_noise
Type:

boolean, default False

is_cache_baking_particles
Type:

boolean, default False

mesh_concave_lower

Lower mesh concavity bound (high values tend to smoothen and fill out concave regions)

Type:

float in [0, 10], default 0.4

mesh_concave_upper

Upper mesh concavity bound (high values tend to smoothen and fill out concave regions)

Type:

float in [0, 10], default 3.5

mesh_generator

Which particle level set generator to use

  • IMPROVED Final – Use improved particle level set (slower but more precise and with mesh smoothening options).

  • UNION Preview – Use union particle level set (faster but lower quality).

Type:

enum in [‘IMPROVED’, ‘UNION’], default ‘IMPROVED’

mesh_particle_radius

Particle radius factor (higher value results in larger (meshed) particles). Needs to be adjusted after changing the mesh scale.

Type:

float in [0, 10], default 2.0

mesh_scale

The mesh simulation is scaled up by this factor (compared to the base resolution of the domain). For best meshing, it is recommended to adjust the mesh particle radius alongside this value.

Type:

int in [1, 100], default 2

mesh_smoothen_neg

Negative mesh smoothening

Type:

int in [0, 100], default 1

mesh_smoothen_pos

Positive mesh smoothening

Type:

int in [0, 100], default 1

noise_pos_scale

Scale of noise (higher value results in larger vortices)

Type:

float in [0.0001, 10], default 2.0

noise_scale

The noise simulation is scaled up by this factor (compared to the base resolution of the domain)

Type:

int in [1, 100], default 2

noise_strength

Strength of noise

Type:

float in [0, 10], default 1.0

noise_time_anim

Animation time of noise

Type:

float in [0.0001, 10], default 0.1

openvdb_cache_compress_type

Compression method to be used

  • ZIP Zip – Effective but slow compression.

  • BLOSC Blosc – Multithreaded compression, similar in size and quality as ‘Zip’.

  • NONE None – Do not use any compression.

Type:

enum in [‘ZIP’, ‘BLOSC’, ‘NONE’], default ‘BLOSC’

openvdb_data_depth

Bit depth for fluid particles and grids (lower bit values reduce file size)

Type:

enum in [‘NONE’], default ‘NONE’

particle_band_width

Particle (narrow) band width (higher value results in thicker band and more particles)

Type:

float in [0, 1000], default 3.0

particle_max

Maximum number of particles per cell (ensures that each cell has at most this amount of particles)

Type:

int in [0, 1000], default 16

particle_min

Minimum number of particles per cell (ensures that each cell has at least this amount of particles)

Type:

int in [0, 1000], default 8

particle_number

Particle number factor (higher value results in more particles)

Type:

int in [1, 5], default 2

particle_radius

Particle radius factor. Increase this value if the simulation appears to leak volume, decrease it if the simulation seems to gain volume.

Type:

float in [0, 10], default 1.0

particle_randomness

Randomness factor for particle sampling

Type:

float in [0, 10], default 0.1

particle_scale

The particle simulation is scaled up by this factor (compared to the base resolution of the domain)

Type:

int in [1, 100], default 1

resolution_max

Resolution used for the fluid domain. Value corresponds to the longest domain side (resolution for other domain sides is calculated automatically).

Type:

int in [6, 10000], default 32

show_gridlines

Show gridlines

Type:

boolean, default False

show_velocity

Visualize vector fields

Type:

boolean, default False

simulation_method

Change the underlying simulation method

  • FLIP FLIP – Use FLIP as the simulation method (more splashy behavior).

  • APIC APIC – Use APIC as the simulation method (more energetic and stable behavior).

Type:

enum in [‘FLIP’, ‘APIC’], default ‘FLIP’

slice_axis
  • AUTO Auto – Adjust slice direction according to the view direction.

  • X X – Slice along the X axis.

  • Y Y – Slice along the Y axis.

  • Z Z – Slice along the Z axis.

Type:

enum in [‘AUTO’, ‘X’, ‘Y’, ‘Z’], default ‘AUTO’

slice_depth

Position of the slice

Type:

float in [0, 1], default 0.5

slice_per_voxel

How many slices per voxel should be generated

Type:

float in [0, 100], default 5.0

sndparticle_boundary

How particles that left the domain are treated

  • DELETE Delete – Delete secondary particles that are inside obstacles or left the domain.

  • PUSHOUT Push Out – Push secondary particles that left the domain back into the domain.

Type:

enum in [‘DELETE’, ‘PUSHOUT’], default ‘DELETE’

sndparticle_bubble_buoyancy

Amount of buoyancy force that rises bubbles (high value results in bubble movement mainly upwards)

Type:

float in [0, 100], default 0.5

sndparticle_bubble_drag

Amount of drag force that moves bubbles along with the fluid (high value results in bubble movement mainly along with the fluid)

Type:

float in [0, 100], default 0.6

sndparticle_combined_export

Determines which particle systems are created from secondary particles

  • OFF Off – Create a separate particle system for every secondary particle type.

  • SPRAY_FOAM Spray + Foam – Spray and foam particles are saved in the same particle system.

  • SPRAY_BUBBLES Spray + Bubbles – Spray and bubble particles are saved in the same particle system.

  • FOAM_BUBBLES Foam + Bubbles – Foam and bubbles particles are saved in the same particle system.

  • SPRAY_FOAM_BUBBLES Spray + Foam + Bubbles – Create one particle system that contains all three secondary particle types.

Type:

enum in [‘OFF’, ‘SPRAY_FOAM’, ‘SPRAY_BUBBLES’, ‘FOAM_BUBBLES’, ‘SPRAY_FOAM_BUBBLES’], default ‘OFF’

sndparticle_life_max

Highest possible particle lifetime

Type:

float in [0, 10000], default 25.0

sndparticle_life_min

Lowest possible particle lifetime

Type:

float in [0, 10000], default 10.0

sndparticle_potential_max_energy

Upper clamping threshold that indicates the fluid speed where cells no longer emit more particles (higher value results in generally less particles)

Type:

float in [0, 1000], default 5.0

sndparticle_potential_max_trappedair

Upper clamping threshold for marking fluid cells where air is trapped (higher value results in less marked cells)

Type:

float in [0, 1000], default 20.0

sndparticle_potential_max_wavecrest

Upper clamping threshold for marking fluid cells as wave crests (higher value results in less marked cells)

Type:

float in [0, 1000], default 8.0

sndparticle_potential_min_energy

Lower clamping threshold that indicates the fluid speed where cells start to emit particles (lower values result in generally more particles)

Type:

float in [0, 1000], default 1.0

sndparticle_potential_min_trappedair

Lower clamping threshold for marking fluid cells where air is trapped (lower value results in more marked cells)

Type:

float in [0, 1000], default 5.0

sndparticle_potential_min_wavecrest

Lower clamping threshold for marking fluid cells as wave crests (lower value results in more marked cells)

Type:

float in [0, 1000], default 2.0

sndparticle_potential_radius

Radius to compute potential for each cell (higher values are slower but create smoother potential grids)

Type:

int in [1, 4], default 2

sndparticle_sampling_trappedair

Maximum number of particles generated per trapped air cell per frame

Type:

int in [0, 10000], default 40

sndparticle_sampling_wavecrest

Maximum number of particles generated per wave crest cell per frame

Type:

int in [0, 10000], default 200

sndparticle_update_radius

Radius to compute position update for each particle (higher values are slower but particles move less chaotic)

Type:

int in [1, 4], default 2

start_point

Start point

Type:

mathutils.Vector of 3 items in [-inf, inf], default (0.0, 0.0, 0.0), (readonly)

surface_tension

Surface tension of liquid (higher value results in greater hydrophobic behavior)

Type:

float in [0, 100], default 0.0

sys_particle_maximum

Maximum number of fluid particles that are allowed in this simulation

Type:

int in [0, inf], default 0

temperature_grid

Smoke temperature grid, range 0 to 1 represents 0 to 1000K

Type:

float array of 32 items in [-inf, inf], default (0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0), (readonly)

time_scale

Adjust simulation speed

Type:

float in [0.0001, 10], default 1.0

timesteps_max

Maximum number of simulation steps to perform for one frame

Type:

int in [1, 100], default 4

timesteps_min

Minimum number of simulation steps to perform for one frame

Type:

int in [1, 100], default 1

use_adaptive_domain

Adapt simulation resolution and size to fluid

Type:

boolean, default False

use_adaptive_timesteps

Automatically decide when to perform multiple simulation steps per frame

Type:

boolean, default True

use_bubble_particles

Create bubble particle system

Type:

boolean, default False

use_collision_border_back

Enable collisions with back domain border

Type:

boolean, default False

use_collision_border_bottom

Enable collisions with bottom domain border

Type:

boolean, default False

use_collision_border_front

Enable collisions with front domain border

Type:

boolean, default False

use_collision_border_left

Enable collisions with left domain border

Type:

boolean, default False

use_collision_border_right

Enable collisions with right domain border

Type:

boolean, default False

use_collision_border_top

Enable collisions with top domain border

Type:

boolean, default False

use_color_ramp

Render a simulation field while mapping its voxels values to the colors of a ramp or using a predefined color code

Type:

boolean, default False

use_diffusion

Enable fluid diffusion settings (e.g. viscosity, surface tension)

Type:

boolean, default False

use_dissolve_smoke

Let smoke disappear over time

Type:

boolean, default False

use_dissolve_smoke_log

Dissolve smoke in a logarithmic fashion. Dissolves quickly at first, but lingers longer.

Type:

boolean, default True

use_flip_particles

Create liquid particle system

Type:

boolean, default False

use_foam_particles

Create foam particle system

Type:

boolean, default False

use_fractions

Fractional obstacles improve and smoothen the fluid-obstacle boundary

Type:

boolean, default False

use_guide

Enable fluid guiding

Type:

boolean, default False

use_mesh

Enable fluid mesh (using amplification)

Type:

boolean, default True

use_noise

Enable fluid noise (using amplification)

Type:

boolean, default False

use_slice

Perform a single slice of the domain object

Type:

boolean, default False

use_speed_vectors

Caches velocities of mesh vertices. These will be used (automatically) when rendering with motion blur enabled.

Type:

boolean, default False

use_spray_particles

Create spray particle system

Type:

boolean, default False

use_tracer_particles

Create tracer particle system

Type:

boolean, default False

use_viscosity

Simulate fluids with high viscosity using a special solver

Type:

boolean, default False

vector_display_type
  • NEEDLE Needle – Display vectors as needles.

  • STREAMLINE Streamlines – Display vectors as streamlines.

  • MAC MAC Grid – Display vector field as MAC grid.

Type:

enum in [‘NEEDLE’, ‘STREAMLINE’, ‘MAC’], default ‘NEEDLE’

vector_field

Vector field to be represented by the display vectors

  • FLUID_VELOCITY Fluid Velocity – Velocity field of the fluid domain.

  • GUIDE_VELOCITY Guide Velocity – Guide velocity field of the fluid domain.

  • FORCE Force – Force field of the fluid domain.

Type:

enum in [‘FLUID_VELOCITY’, ‘GUIDE_VELOCITY’, ‘FORCE’], default ‘FLUID_VELOCITY’

vector_scale

Multiplier for scaling the vectors

Type:

float in [0, 1000], default 1.0

vector_scale_with_magnitude

Scale vectors with their magnitudes

Type:

boolean, default False

vector_show_mac_x

Show X-component of MAC Grid

Type:

boolean, default True

vector_show_mac_y

Show Y-component of MAC Grid

Type:

boolean, default True

vector_show_mac_z

Show Z-component of MAC Grid

Type:

boolean, default True

velocity_grid

Smoke velocity grid

Type:

float array of 32 items in [-inf, inf], default (0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0), (readonly)

velocity_scale

Factor to control the amount of motion blur

Type:

float in [0, inf], default 1.0

viscosity_base

Viscosity setting: value that is multiplied by 10 to the power of (exponent*-1)

Type:

float in [0, 10], default 1.0

viscosity_exponent

Negative exponent for the viscosity value (to simplify entering small values e.g. 5*10^-6)

Type:

int in [0, 10], default 6

viscosity_value

Viscosity of liquid (higher values result in more viscous fluids, a value of 0 will still apply some viscosity)

Type:

float in [0, 10], default 0.05

vorticity

Amount of turbulence and rotation in smoke

Type:

float in [0, 4], default 0.0

classmethod bl_rna_get_subclass(id, default=None)
Parameters:

id (str) – The RNA type identifier.

Returns:

The RNA type or default when not found.

Return type:

bpy.types.Struct subclass

classmethod bl_rna_get_subclass_py(id, default=None)
Parameters:

id (str) – The RNA type identifier.

Returns:

The class or default when not found.

Return type:

type

Inherited Properties

Inherited Functions

References