--- title: "Liquid Simulator" canonical: "https://documentation.chaos.com/space/PHX4MAYA/125765148/Liquid%20Simulator" format: markdown --- This page introduces the Simulator object (PhoenixFDSimulator) and its rollouts. ## **Overview** --- > Macro (ui-text-box) > > Phoenix generates particles for liquids because they are useful for representing the characteristics and behavior of a fluid, and as a result look more natural when rendering liquids, especially when generated in very large amounts. The particles emulate real-world fluids by moving through 3D space within the simulation grid, and unlike voxels, each particle carries its own fluid properties with it, such as Position, Age, Velocity and so forth. These properties contained in each of the particles are called Particle Channels, and their values can change every frame, based on each channel's [Particle Channel Range](https://docs-chaos.atlassian.net/wiki/spaces/PHX4MAYA/pages/125732062). Besides Liquid Particles, the simulator provides built-in helper simulators for Foam, Wetmap, Splash, and Mist Particles. In certain cases, the splash and mist can be considered as part of the liquid simulation, because liquid, splash and mist can be converted to each other during the simulation process. You can go through the [FLIP Particles Life Cycle](https://docs-chaos.atlassian.net/wiki/spaces/PHX4MAYA/pages/125862753) page for an in-depth explanation of this process. When running a simulation, the Liquid sim will typically output an entire animation sequence. That sequence is saved as individual files, called caches, which contain raw simulation data for each timeline frame. When the Liquid Simulator saves its caches, the Liquid Particles get turned into grids, so in essence, the cache data contains grids and particles, which describe the fluid’s behavior. Liquid sim cache files can then be previewed in the viewport, as well as rendered, in order to create captivating and realistic images. The simulator also offers multiple render modes, where the mesh mode is typically used to render Liquid simulations, and the volumetric render modes are typically used for rendering Fire/Smoke simulations. Phoenix offers a lot of flexibility though, so there is the option to render Liquid simulations as volumes and Fire/Smoke simulations as meshes, in order to achieve even more diverse effects. When rendering other particle types besides Phoenix Liquid Particles, Phoenix has a separate [Particle Shader](https://docs-chaos.atlassian.net/wiki/spaces/PHX4MAYA/pages/125830144) geometry type, which is used to shade particles. > Macro (ui-text-box) > > The Particle Shader component is most often used in conjunction with Liquid simulations to shade particles such as Splash, Mist and Foam.  However, it can also shade particles created from the Fire/Smoke Simulator, as well as standard particle systems such as nParticles in Maya. > Macro (ui-text-box) > > Note that the simulator is represented as a single object for convenience. Internally, it contains two completely separate parts: a simulator component, and a rendering component. Parameters that control the simulation are separated from those associated with the shading, meshing and rendering processes. As a result, no rollout will contain mixed parameters, and no parameter will affect both the simulation and rendering. ## **Rollouts** --- After creating a Phoenix Simulator object, the following rollouts can be accessed in the Attribute Editor: - [Simulation](https://docs-chaos.atlassian.net/wiki/spaces/PHX4MAYA/pages/125701902) - Controls the simulation and displays statistics such as simulation times, as well as information about the data contained in the sim for the current frame. - [Simulation Speed](https://docs-chaos.atlassian.net/wiki/spaces/PHX4MAYA/pages/125737236) - Helps identifying the heaviest computation phases of the simulation and provides tips on how to get results faster and more efficiently. - [Resimulation](https://docs-chaos.atlassian.net/wiki/spaces/PHX4MAYA/pages/125701768) - Uses a base simulated cache sequence with exported velocity to drive a new simulation, in order to enhance details, increase its resolution, or slow down or speed up the simulation. For liquid simulations, it modifies an existing cache sequence to improve features or change specified particle systems. - [Grid](https://docs-chaos.atlassian.net/wiki/spaces/PHX4MAYA/pages/125995969) - Controls the boundaries, size and resolution of the simulation grid. - [Dynamics](https://docs-chaos.atlassian.net/wiki/spaces/PHX4MAYA/pages/125637296) - Offers parameters to affect fire/smoke dynamics when simulating, such as cooling, smoke dissipation, vorticity, advection, etc. - [Foam](https://docs-chaos.atlassian.net/wiki/spaces/PHX4MAYA/pages/125964038) - Controls the simulation of bubbles and foam. - [Splash and Mist](https://docs-chaos.atlassian.net/wiki/spaces/PHX4MAYA/pages/126093096) - Controls the simulation of splash and mist. - [Scene Interaction](https://docs-chaos.atlassian.net/wiki/spaces/PHX4MAYA/pages/125737180) - Specifies how the simulator interacts with other objects in the scene. - [Output](https://docs-chaos.atlassian.net/wiki/spaces/PHX4MAYA/pages/125899086) - Specifies how and where the simulation cache files are saved. - [Input](https://docs-chaos.atlassian.net/wiki/spaces/PHX4MAYA/pages/125736790) - Determines the path of the input files for rendering and previewing, and offers settings and controls for playback. - [Preview](https://docs-chaos.atlassian.net/wiki/spaces/PHX4MAYA/pages/125736916) - Controls how the simulation is displayed in the viewport. - [Rendering](https://docs-chaos.atlassian.net/wiki/spaces/PHX4MAYA/pages/125737010) - Controls how the simulation is rendered, and includes additional volumetric options for shading Fire/Smoke simulations. - [Presets](https://docs-chaos.atlassian.net/wiki/spaces/PHX4MAYA/pages/126289195) – Allows the parameters of the simulator to be saved to your storage, and then loaded back as a preset. ## **Upgrading from Previous Versions of Phoenix** --- Due to many improvements to the Phoenix solver, recreating simulations the same way you did in older versions of Phoenix may not be possible because of changes to the solvers and the UI. Here are some things to be aware of when upgrading from older versions of Phoenix. - If you have a scene created with Phoenix version 3 and you open it with version 4, it will keep all the old settings for you, including some which are not visible to newer versions, in order for the results to be roughly the same. - If you try to manually replicate an older simulation setup with a new Phoenix simulator using Phoenix version 4, and set all the parameters with the same values as the older version, you may not obtain the same result as in Phoenix version 3 or older. - Since the release of Phoenix version 3, Phoenix started using a new solver for liquids and fire/smoke simulations, so simulation results will be different between Phoenix version 3 and version 2.