Streamtube

Overview

The streamtube insight type is used to create 3D streamtube plots for visualizing flow or vector field data. Streamtubes effectively represent fluid flow, electromagnetic fields, or any vector data in three dimensions, showing both direction and magnitude.

You can customize the color, tube size, and vector paths to highlight patterns and behaviors in the flow data.

Common Uses

• Fluid Dynamics: Visualizing fluid flow in 3D space.
• Vector Field Analysis: Representing wind, magnetic, or electric fields.
• Flow Visualization: Showing flow behavior across time or space.

Check out the Attributes for the full set of configuration options

Examples

Common Configurations

Simple Streamtube InsightStreamtube Insight with Color MappingStreamtube Insight with Custom Tube Sizes

sources:
  - name: streamtube-data-source
    type: duckdb
    database: target/seeds/streamtube_data.duckdb
    seeds:
      - table_name: model
        args:
          - curl
          - -sL
          - https://raw.githubusercontent.com/plotly/datasets/master/streamtube-basic.csv
models:
  - name: streamtube-data
    source: ${ref(streamtube-data-source)}
    sql: select * from model
insights:
  - name: Simple Streamtube Insight
    props:
      type: streamtube
      x: ?{${ref(streamtube-data).x}}
      y: ?{${ref(streamtube-data).y}}
      z: ?{${ref(streamtube-data).z}}
      u: ?{${ref(streamtube-data).u}}
      v: ?{${ref(streamtube-data).v}}
      w: ?{${ref(streamtube-data).w}}
charts:
  - name: Simple Streamtube Chart
    insights:
      - ${ref(Simple Streamtube Insight)}
    layout:
      title:
        text: Simple Streamtube Plot<br><sub>3D Vector Field Visualization</sub>

sources:
  - name: streamtube-data-source
    type: duckdb
    database: target/seeds/streamtube_data.duckdb
    seeds:
      - table_name: model
        args:
          - curl
          - -sL
          - https://raw.githubusercontent.com/plotly/datasets/master/streamtube-basic.csv
models:
  - name: streamtube-data
    source: ${ref(streamtube-data-source)}
    sql: select * from model
insights:
  - name: Streamtube Insight with Color Mapping
    props:
      type: streamtube
      x: ?{${ref(streamtube-data).x}}
      y: ?{${ref(streamtube-data).y}}
      z: ?{${ref(streamtube-data).z}}
      u: ?{${ref(streamtube-data).u}}
      v: ?{${ref(streamtube-data).v}}
      w: ?{${ref(streamtube-data).w}}
      colorscale: "Viridis"
charts:
  - name: Streamtube Chart with Color Mapping
    insights:
      - ${ref(Streamtube Insight with Color Mapping)}
    layout:
      title:
        text: Streamtube Plot with Color Mapping<br><sub>Vector Magnitude Represented by Color</sub>

sources:
  - name: streamtube-data-source
    type: duckdb
    database: target/seeds/streamtube_data.duckdb
    seeds:
      - table_name: model
        args:
          - curl
          - -sL
          - https://raw.githubusercontent.com/plotly/datasets/master/streamtube-basic.csv
models:
  - name: streamtube-data
    source: ${ref(streamtube-data-source)}
    sql: select * from model
insights:
  - name: Streamtube Insight with Custom Tube Sizes
    props:
      type: streamtube
      x: ?{${ref(streamtube-data).x}}
      y: ?{${ref(streamtube-data).y}}
      z: ?{${ref(streamtube-data).z}}
      u: ?{${ref(streamtube-data).u}}
      v: ?{${ref(streamtube-data).v}}
      w: ?{${ref(streamtube-data).w}}
      sizeref: 0.5
charts:
  - name: Streamtube Chart with Custom Tube Sizes
    insights:
      - ${ref(Streamtube Insight with Custom Tube Sizes)}
    layout:
      title:
        text: Streamtube Plot with Custom Tube Sizes<br><sub>Vector Magnitude Represented by Tube Size</sub>