Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

UI Text Box
typenote

Exporting the Grid Temperature/Liquid Channel will automatically convert Liquid particles to a grid during export, which is why they can be rendered as a mesh and shaded using standard materials. In addition, the Liquid mesh can also be previewed in the viewport. 

Note that only Liquid particles can be automatically converted to a grid. The other particle systems (e.g. Foam, Splash, Mist etc.) are exported only as particles, and must be shaded using the Particle Shader

UI Text Box
typetip

UI Path: ||Select PhoenixFDSim|| > Attribute Editor > Output rollout

...

UI Expand
titleClick Here to expand additional $(VARIABLE) information

$(work_path) – $(data_dir)/$(scene)_Phoenix_frames/$(nodename)_####.aur

$(data_path) – $(data_dir)/$(scene)_Phoenix2_frames/$(nodename)_####.aur
$(scene_path)
 – $(dir)/$(scene)_Phoenix_frames/$(nodename)_####.aur
$(scene_dir) – $(dir)/$(scene)_Phoenix2_frames/$(nodename)_####.aur
$(implicit) – Same as $(data_path).
$(dir) – The scene directory.
$(data_dir) – The current workspace data directory. This can be overridden from the Phoenix Global Preferences' Default Cache Path option.
$(scene) – The scene file name.
$(nodename) – The name of the node.
$(fullname) – The full name of the node.
$(workspace) – The current workspace directory.
$env(<variable_name>) – An environment variable. See Using Environment Variables below.

If you are transferring your scene and assets between Windows and Linux, prefixing your path with the $(workspace) or $env(<variable_name>) macros can make it possible to use the same scene without any manual modifications to the cache path.

#### is the frame number formatted with at least as many digits as the hash signs. If the frame digits are less than the hashes, the number is padded with zeroes to the left. As an example, the following table shows how different numbers of hash signs affect the formatting of different frame numbers.

Align
aligncenter

 Result
Frame Number#######
11010001
1010100010
1000100010001000
UI Text Box
typenote

Since version 3.00.02, Phoenix can export VDB grid data. Check the How to export PhoenixFD simulation to OpenVDB format video.
Appending a .vdb extension after the Output Path tells Phoenix to write its data in the OpenVDB format. Particle data can also be exported using the .aur or the .vdb format.

Note that due to the difference between the compression algorithms used by Phoenix's Aura format and the OpenVDB format, exported VDB caches may produce a slightly different result at render time compared to Aura caches when the Storage Quality is set to a value lower than 20 (i.e. Lossless). 


UI Text Box
typeinfo

 Clicking the "..." button will open a menu with the following options:

 


 


Browse - Opens a dialog where you can select where the simulation caches will be written to. The filename you type in must contain # signs so each simulation frame will be written to a differently numbered file. Also, you can choose between two file formats - AUR and VDB cache files. In order to write the simulation caches to VDB in the default simulation path, you can just edit the Simulation Save Path to $(work_path).vdb.

Delete Cache Files - Clears the cache files matching the provided Simulation Save Path pattern.

Reset to Default - Resets the Simulation Save Path to default.

Help - Opens this Help page.

...

Storage Quality | storageQuality – The output grid and particle channels are compressed by default in order to increase the performance (faster cache loading) and to avoid excessive memory consumption. This parameter can range from 8 to 20 - 8 is the smallest size, while 20 is the best quality and is uncompressed. If this value is set too low, different artifacts may start appearing depending on the type of scene. For grid channels, artifacts shaped like horizontal slices may appear in preview and rendering, such as in the following image: 

...

Example: Fire/Smoke compression

...

artifacts

...

Image Modified

...

 


Anchor
BackupInterval
BackupInterval
Backup Interval | backupInterval – The frame interval between two backups of the full simulation state. You can later continue a stopped simulation from such frames (see the Restore button in the Simulation rollout). To make a Restore possible at every frame, set this parameter to 1. A value of 0 means no backup frames will be exported.

Compress Particles | prtcompress – Enables compression of the simulated particle systems when they are written to AUR cache files. VDB cache files exported from Phoenix do not support particle compression. Simulations with very high particle counts, such as 50 million or more, will produce large caches, so particle compression will help reduce the cache sizes significantly. If you are writing or reading the cache files over the network or to a disk drive, this could significantly speed up simulation and rendering. However, if you are writing the simulation caches to an SSD drive or other fast storage, and you can afford to have large cache files, then disabling the compression could actually speed up the simulation. 


Anchor

...

OutputChannels
OutputChannels
Output Grid Channels

Example: Particle compression artifacts

 

...

...

UI Text Box
typeinfo

For particle systems such as Liquid or Foam, the artifacts would look like ordered lines of particles, as in the following comparison (click to zoom in):

Section
Column
width33%
Image Removed

Storage quality = 19

Column
width33%

Image Removed

Storage quality = 14
(artifacts in the lower left corner)

Column
width33%

Image Removed

Storage quality = 8

...

UI Text Box
typeinfo

Fluid properties are written inside Grid Channels. Here you can choose which Grid Channels will be exported to the cache files when running a simulation.

Each channel stores a type of value, such as Temperature/Liquid, Smoke, RGB, Velocity and so forth, with its own range of possible values that is most efficient for that specific channel type (see the Grid Channel Ranges). Phoenix determines the fluid’s behavior at a given time, based on the content of these Grid Channels.

UI Text Box
typenote

Note that the more channels are used, the slower the simulation runs and the larger the output files are. While scrolling the timeline, you can check which channels are present in the loaded cache file for the current frame, from the Cache File Content section in the Simulation rollout.

Also note that in the case of FLIP / Liquid simulations, currently only Liquid particles can be automatically converted to a grid during export, while all the other systems (e.g. Foam, Splash, etc.) are exported only as particles.

...

Grid Temper./Liquid | outTemp – If this is a fire/smoke simulation, exports the Temperature channel. If it's a liquid simulation, exports the liquid amount which is needed so that you can render the Liquid as a mesh and also preview it as a mesh in the viewport.

Grid Smoke outSmoke – Export the smoke density.

Grid RGB | outUVW – Export the RGB color. You can use this for simulations where you are mixing different liquid colors or materials through a Phoenix Grid Texture.

Grid Wavelet outWavelet – Export the wavelet data of a fire/smoke simulation. You need this if you are going to resimulate a fire/smoke simulation in order to increase the resolution and add more detail using wavelet turbulence.

Grid Speed | outSpeed – Export the speed of the simulation. You can use this for coloring the simulation at render time based on how fast different parts of the fluid move.

Grid Velocity | outVel – Export the velocity of the simulation. The difference between the Speed and Velocity channels is that Velocity is a vector and takes 3 times more space in the cache file than the Speed channel. However, Velocity has direction and is needed for Resimulation and motion blur of the fire/smoke simulation or the liquid mesh. Because Speed can be calculated from the Velocity, it is not exported separately when Velocity is exported.

Grid Viscosity | outVisc - Export the Viscosity channel. Required for variable Viscosity simulations  You may also choose to enable this if, for instance, your setup requires that you use the Viscosity channel as a mask through a Phoenix Grid Texture.

Grid Fuel outFuel – Export the fuel density in the simulation.

Grid Texture UVW  | outTexUVW – Export the Texture UVW channel. Enable this to generate texture mapping coordinates that follow the movement of the fluid. This way you can change the textures you want mapped over your fluid even after the simulation has ended, without the need to simulate again. For more information on TexUVW, please check the Texture mapping, moving textures with fire/smoke/liquid, and TexUVW page.

Grid Advection Origin outAdvPos – Export the advection origin of each voxel in the simulation. This is needed for the Precise Tracing Blend Method for retiming simulated sequences in the Input rollout, and is also needed for the Use Advection Origin for Motion Blur option in the Simulation rollout.

Special | outSpecial – Export internal or special channels into the Special channel (alias to the Smoke channel) so they can be visualized using one of the volumetric shaders of the Simulator (with Mode set to VolumetricVolumetric Geometry, or Volumetric Heat Haze). Such channels can also be read by the Grid Texture and used for rendering.

Solid Voxels – Exports the solid voxels as smoke. Voxels covered by many obstacles contain more smoke.
Divergence Symm – Exports the negative divergence of each voxel. 
Divergence Smooth  – Exports the blurred negative divergence of each voxel. 
Vorticity – Exports the length of the curl of each voxel. Can be used for whitewater shading. 
Vorticity Smooth  – Exports the blurred length of the curl of each voxel. Can be used for whitewater shading. 
Velocity Gradient –  Exports the length of the gradient of the velocity field. 
Injector  – Exports the pressure term created by sources in Inject mode or formed during the simulation.
Liquid Surface – Exports the surface created by the simulation.
Solid Geom Type – Exports the internal geometry type in each voxel.
Hydrostatic Pressure – Exports the pressure of the liquid at each voxel due to the effect of gravity.
Voxelization Issues – Exports voxels where the solver would produce wrong results during simulation. Such voxels are near overlapping triangles, inverted normals, open edges or other geometry issues.

...

Output Particles

UI Text Box
typeinfo

Phoenix particle systems contain Particle Channels for each particle, which represent the properties of the fluid simulation. Each Particle Channel has its own range of possible values that is most efficient for that specific channel type (see the Particle Channel Ranges).

Here in the Output rollout, you can choose which Particle Channels will be exported to the cache files.

UI Text Box
typenote

The particle export parameters share a User Interface to keep the user interface compact. Each particle system can be selected individually from the Output Particles list, and the output settings can be selected for that particle system. When a particle system is selected again, the same settings are retained.

...

 

Export Selected Particle System – When enabled, the selected system will be exported.

Note that writing more channels to the cache files takes more time and will add up to the simulation time, so if you know in advance that you will not be needing a certain channel for rendering, then it would help the simulation times if you turn it off.

Particle Velocity – The particle velocity channel will be exported. Use this option when you need motion blur for the particle systems such as Foam, Splash, etc.

Particle ID – When enabled, the particle ID channel will be exported. This channel is used during rendering to identify each particle. Use it when render time size variation is needed, if you would use the Particle Shader's Count Multiplier, or when frame blending will be involved (animated frame index or non-integer play speed).

Particle Age – When enabled, the particle age channel will be exported. The particle age channel will be exported. This channel can be used for animation effect based on the particle age, which can be needed by the Phoenix Particle Texture, Phoenix Source, Particle Shader, or Particle Tuner.

UI Text Box
typenote

 The Age channel is affected by the Time Scale option under the Dynamics rollout which acts a multiplier for the Age.

Particle Viscosity - The particle Viscosity channel will be exported. Enable this if your Resimulation requires the calculation of viscosity.

Particle RGB – When enabled, the particle RGB channel will be exported. You can use this for simulations where you are mixing different particle colors or you shade the particles by the particle RGB channel through a Phoenix Particle Texture. Also, enable this if you want to be able to preview the RGB channel as a particle color in the viewport.

...

Fluid properties are written inside Grid Channels. Here you can choose which Grid Channels will be exported to the cache files when running a simulation.

Each channel stores a type of value, such as Temperature/Liquid, Smoke, RGB, Velocity and so forth, with its own range of possible values that is most efficient for that specific channel type (see the Grid Channel Ranges). Phoenix determines the fluid’s behavior at a given time, based on the content of these Grid Channels.

UI Text Box
typenote

Note that the more channels are used, the slower the simulation runs and the larger the output files are. While scrolling the timeline, you can check which channels are present in the loaded cache file for the current frame, from the Cache File Content section in the Simulation rollout.

Also note that in the case of FLIP / Liquid simulations, currently only Liquid particles can be automatically converted to a grid during export, while all the other systems (e.g. Foam, Splash, etc.) are exported only as particles.


Image Added


Grid Temperature | outTemp – Exports the Temperature channel.

Grid Smoke outSmoke – Export the smoke density.

Grid RGB | outUVW – Export the RGB color. You can use this for simulations where you are mixing different liquid colors or materials through a Phoenix Grid Texture.

Grid Wavelet outWavelet – Export the wavelet data of a fire/smoke simulation. You need this if you are going to resimulate a fire/smoke simulation in order to increase the resolution and add more detail using wavelet turbulence.

Grid Speed | outSpeed – Export the speed of the simulation. You can use this for coloring the simulation at render time based on how fast different parts of the fluid move.

Grid Velocity | outVel – Export the velocity of the simulation. The difference between the Speed and Velocity channels is that Velocity is a vector and takes 3 times more space in the cache file than the Speed channel. However, Velocity has direction and is needed for Resimulation and motion blur of the fire/smoke simulation or the liquid mesh. Because Speed can be calculated from the Velocity, it is not exported separately when Velocity is exported.

Grid Texture UVW  | outTexUVW – Export the Texture UVW channel. Enable this to generate texture mapping coordinates that follow the movement of the fluid. This way you can change the textures you want mapped over your fluid even after the simulation has ended, without the need to simulate again. For more information on TexUVW, please check the Texture mapping, moving textures with fire/smoke/liquid, and TexUVW page.

Grid Fuel outFuel – Export the fuel density in the simulation.

Grid Advection Origin outAdvPos – Export the advection origin of each voxel in the simulation. This is needed for the Precise Tracing Blend Method for retiming simulated sequences in the Input rollout, and is also needed for the Use Advection Origin for Motion Blur option in the Simulation rollout.

Grid Special | outSpecial – Export internal or special channels into the Special channel (alias to the Smoke channel) so they can be visualized using one of the volumetric shaders of the Simulator (with Mode set to VolumetricVolumetric Geometry, or Volumetric Heat Haze). Such channels can also be read by the Grid Texture and used for rendering.

Solid Voxels – Exports the solid voxels as smoke. Voxels covered by many obstacles contain more smoke.
Divergence Symm – Exports the negative divergence of each voxel. 
Divergence Smooth  – Exports the blurred negative divergence of each voxel. 
Vorticity – Exports the length of the curl of each voxel. Can be used for whitewater shading. 
Vorticity Smooth  – Exports the blurred length of the curl of each voxel. Can be used for whitewater shading. 
Velocity Gradient –  Exports the length of the gradient of the velocity field. 
Injector  – Exports the pressure term created by sources in Inject mode or formed during the simulation.
Liquid Surface – Exports the surface created by the simulation.
Solid Geom Type – Exports the internal geometry type in each voxel.
Hydrostatic Pressure – Exports the pressure of the liquid at each voxel due to the effect of gravity.
Voxelization Issues – Exports voxels where the solver would produce wrong results during simulation. Such voxels are near overlapping triangles, inverted normals, open edges or other geometry issues.


Anchor
environmentVariables
environmentVariables

...