TUFLOW Viewer - Exporting An Animation

Tool Description

Animations can be exported from TUFLOW Viewer for all accepted result types (map outputs, time series, particles etc). The process for animation creation is the same regardless of the result type and leverages the QGIS print layout. The tool will export an image for each timestep in a given range and then use ffmpeg to convert the images into a video. TUFLOW Viewer offers the additional functionality of adding dynamic plots and dynamic time text. It also offers convenience functionality for adding items such as a legend, images etc, however these can also be added manually in the print layout.

The following steps through the process of creating an animation with TUFLOW Viewer.

1. Download ffmpeg - https://ffmpeg.org/download.html
   • ffmpeg is a free and powerful (and open source) video converter and manipulator. TUFLOW Viewer will call ffmpeg as the last step to create the video
   • TUFLOW Viewer will take care of all the interaction with ffmpeg and the user is not required to learn how to use ffmpeg
2. Open the export animation tool via Export >> Export Animation
   
3. Set the General settings
   
   
   1. Start Time - The output time to start on
   2. End Time - The output time to end on
   3. Result - The result to animate - currently can only animate one result (result types with the same name (time series, particles - particles will have _ptm in its name) will be included in the same animation
   4. Active Scalar Result - Active scalar result type to animate - can only choose one, can select -None- to not use any
   5. Active Vector Result - Active vector result type to animate - can only choose one, can select -None- to not use any
   6. Width - Animation video width - can be changed later in the print layout - will be overriden by template if one is specified
   7. Height - Animation video height - can be changed later in the print layout - will be overriden by template if one is specified
   8. Output - Output location of video file
   9. Revert to old method - Kept for backward compatibility - will ignore Target Duration and the duration will be determined by number of output timesteps (i.e. the frames) and the speed
   10. Speed - Animation video frames per second (fps) - unless using the 'old method' this will not affect the video duration. Will not interpolate between frames, however can still produce a smoother video in some situations over the 'old method'
   11. Target Duration - Animation duration - this setting is ignored if using the 'old method'
4. On the layout tab, the user has the option to use a Default Layout or a Custom Layout. A cusom layout uses a Print Layout Template (.qpt) as an input. The recommended workflow is to:
   1. Use the Default Layout as a starting point
   2. Customise the layout using the print layout in QGIS
   3. Export the print layout as a template (.qpt)
   4. Use Custom Layout using the template file

   

5. Assuming the above workflow, the Default Layout lets the user specify some items to add to the layout. Starting with the first three, each of these has the ability to add an additional label to the item and set properties such as the font, background colour, background border, and position in the layout (all of these properties can be changed later in the print layout):
   1. Title - Text that will be added to the layout - can be added later in the print layout
   2. Time - Dynamic text to show the current time - will use date-time format if Show as dates is on. This can be added later, however it's recommended to add it through the Default Layout. It can be added later manually in the print layout by adding a label item and giving it an id 'time' (note id is not the same as the label text).
   3. Legend - A legend item - can be added / modified later in the print layout
      

   

6. The next layout item is Plots. These are dynamic plot objects that will be added to the animation. To add a plot, the plot must already be available in one of the TUFLOW Viewer plotting windows
   
   1. Use the add button to add a plot
   2. Select the source of the plot lines that will be added (i.e. time series, cross section etc.)
   3. Select the plotting lines to add to the plot. Users can add more than one line or split the lines onto multiple plots. If the line is on secondary axis, this will be retained unless the need for the secondary axis becomes redundant (e.g. it's the only line on the plot)
   4. Set the position. This is only the starting position and can be moved later in the print layout
   5. Set the plot properties. When the user clicks this button, TUFLOW Viewer will calculate the min/max for the plot axes. For lines on the cross-section and vertical profile plots, this can take some time as TUFLOW Viewer will need to step through every timestep to find the min/max values.
      
      1. Plot Title - can be useful to indicate where the plot was extracted from by aligning the title with labels in the print layout
      2. Axis labels - will be populated with default values
      3. Axis Limits - will be populated with calculated extents and the extents can be recalculated using Auto Calc
      4. Legend - legend can be added or removed. Legend location options are not as extensive as the TUFLOW Viewer itself, most notably 'Auto' is not available. 'Auto' can cause the legend to change location during the animation which is undesirable behaviour.
      5. Grid lines - can be toggled on/off
      6. Figure Size - will default to 100 x 100. This can be changed in the print layout and the plot will be re-rendered prior to the animation to fit the desired size.
   6. If the plot point/line was drawn by the user (not a vector layer), a graphic object will be added to the appropriate location to indicate the extraction location. This can be toggled off by unchecking this box.
   7. Label for the graphic object - this can be changed later in the print layout
   8. Label position relative to the graphic object
   9. Label properties:
      
      1. Label font settings
      2. Background and box settings
7. Last item in the Default Layout options is the ability add images to the layout. Adding images can also be added / edited later in the print layout
   
   1. Use the add button to add an image
   2. Browse or copy the file path location of the image to be added
   3. Position - this is the starting position and can be changed later in the print layout
   4. Image properties:
      
      1. Image size options - this can be changed later in the print layout

Examples

The above steps serve as an example of how to create an animation. There is also a youtube video at the below link:
Create an Animation With Embedded Dynamic Plots

Links

Back to TUFLOW Viewer Page

• Back to TUFLOW Viewer Main Page