diff --git a/docs/05.tools/01.probing.md b/docs/05.tools/01.probing.md new file mode 100644 index 0000000..63064f0 --- /dev/null +++ b/docs/05.tools/01.probing.md @@ -0,0 +1,57 @@ +# Probing + +*Probing allows you to probe the location of any point on an imported geometry. This tool is useful for inspecting specific locations, measuring distances, and verifying geometry coordinates.* + +--- + +## **Overview** + +Probing provides a way to interactively select and inspect point locations on geometry loaded in the viewer. When you click on a point, its location is temporarily stored until a new point is clicked, allowing you to quickly check coordinates at different locations. + +--- + +## **Accessing Probing** + +The Probing tool is available when: + +- Geometry is loaded in the viewer +- The probe tool icon appears in the viewer toolbar +- Clicking the probe icon opens the "Probe location" panel + +
+ +![Probe](./Figures/probe.png) + +
+ +--- + +## **Operating Modes** + +Probing offers two modes of operation: + +### **Selection in Viewer** + +In this mode, you can directly click on any point in the 3D viewer to probe its location. + +- Click anywhere on the geometry surface in the viewer +- The location coordinates are automatically displayed +- The probed location is highlighted or marked in the viewer +- Clicking a new point replaces the previous probed location + +### **Location Specification** + +In this mode, you can manually specify the coordinates of the point you want to probe. + +- Enter the X, Y, and Z coordinates directly +- The specified location is displayed in the viewer +- Useful for probing exact locations or locations that may be difficult to click + +--- + +## **Interface Elements** + +The Probing interface appears as a pop-up panel with the following elements: + +- **Location field**: Labeled "Location -" with an edit icon, displays or allows input of the X, Y, Z coordinates +- **Entity Name field**: Labeled "Entity Name -", shows the entity or surface name at the probed location \ No newline at end of file diff --git a/docs/05.tools/02.variable-settings.md b/docs/05.tools/02.variable-settings.md new file mode 100644 index 0000000..7f5fe24 --- /dev/null +++ b/docs/05.tools/02.variable-settings.md @@ -0,0 +1,128 @@ +# Variable Settings + +*The Variable Settings tab allows you to create and manage user-defined variables for use in simulations and post-processing. Variables can be defined using mathematical expressions involving constants, units, and other variables.* + +--- + +## **Accessing Variable Settings** + +
+ +![Settings](./Figures/settings.png) + +
+ +--- + +## **Variable Types** + +The Variable Settings tool organizes variables into different categories through a tabbed interface: + +### **Custom Variables** + +The "Custom variables" tab displays user-defined variables in a table format with columns: + +- **Name**: The variable name (e.g., `velocity_ref`, `rho`, `q_inf`) +- **Expression**: The mathematical expression defining the variable (e.g., `100*u.m/u.s`, `1.225*u.kg/u.m**3`, `0.5*rho*velocity_ref**2`) +- **Description**: Optional description field for documenting the variable + +#### **Simulation Parameter** + +Variables that can be used as inputs to the simulation, such as boundary condition values. + +#### **Post-processing** + +Variables defined for output and visualization purposes. + +### **Solution Variables** + +Contains pre-computed quantities from the solver organized into volume mesh and surface mesh variables. Volume mesh variables include flow field quantities (density, velocity, pressure, temperature), derived quantities (Mach number, vorticity, Q-criterion, entropy), turbulence quantities, gradient fields, and geometric quantities. Surface mesh variables include skin friction, heat flux, heat transfer coefficients, surface forces, wall shear stress, and surface geometry. + +--- + +## **Library** + +The library allows you to pre-define variables which can be later imported to the custom variable panel. + +--- + +## **Creating Variables** + +To create a new variable: + +1. Open the Variable Settings tool from the viewer toolbar +2. Navigate to the "Custom variables" tab or "Library" tab +3. Click the green "+ Add variable" button located to the right of the variables table +4. Enter the variable name in the "Name" column +5. Define the expression in the "Expression" box using: + - Constants with units (e.g., `100*u.m/u.s`) + - Mathematical operations (`+`, `-`, `*`, `/`, `**`) + - References to other variables + - Solution variables +6. Optionally add a description in the "Description" box + +### **Importing a Variables from Library** + +To import solution variables into custom variables you can either: + +1. Navigate to the "Custom Variables" tab and select "Import from Library" **or** navigate directly to the "Library" tab. + +3. This brings you to the "Library" page, select the variables you want to import and then click on "Import to custom variables". The variables will appear in the "Custom Variables" tab. + +--- + +## **Variable Expression Syntax** + +Variables support a rich expression syntax: + +- **Units**: Access units through the `u` namespace (e.g., `u.m`, `u.s`, `u.kg`, `u.Pa`) +- **Mathematical operations**: Standard arithmetic and functions +- **Variable references**: Reference other custom variables by name +- **Solution variables**: Access solver quantities + +--- + +## **Example Variables** + +Compute a dimensional time step for a rotor simulation with the following variables: + +
+ +![VariablesExample](./Figures/variables.png) + +
+ +then you can set the rotational speed with: + +
+ +![RotorSpeed](./Figures/rotor_speed.png) + +
+ +and the time step with: + +
+ +![TimeStep](./Figures/time_settings.png) + +
+ +--- + +
+

❓ Frequently Asked Questions

+ +- **Where can I use custom variables?** + > Custom variables can be used in boundary conditions, initial conditions, output expressions, and other simulation parameters that accept expressions. + +- **What happens if I reference a variable that doesn't exist?** + > Flow360 will display an error indicating that the variable is not defined. Make sure to define variables before referencing them. + +- **Can I import variables from a library?** + > The Variable Settings tool includes a library feature that allows you to select and import pre-defined solution variables into your custom variables. + +- **How do I delete a variable?** + > Variables can be removed through the Variable Settings interface. Note that variables referenced elsewhere may need to be updated first. + +
diff --git a/docs/05.tools/03.surface-mesh-diagnostics.md b/docs/05.tools/03.surface-mesh-diagnostics.md new file mode 100644 index 0000000..5e96234 --- /dev/null +++ b/docs/05.tools/03.surface-mesh-diagnostics.md @@ -0,0 +1,67 @@ +# Surface Mesh Diagnostics + +*The Surface Mesh Diagnostics tool provides comprehensive analysis capabilities for assessing the quality of surface meshes. When a surface mesh is loaded, this tool becomes available to help identify potential mesh quality issues.* + +--- + +## **Overview** + +The Surface Mesh Diagnostics tool opens a dedicated panel that allows you to inspect surface mesh quality based on pre-computed metrics. This tool is essential for: + +- Identifying poor quality mesh elements +- Verifying mesh quality before volume mesh generation +- Understanding mesh characteristics across different surfaces +- Diagnosing potential issues that could affect simulation accuracy + +--- + +## **Accessing Surface Mesh Diagnostics** + +The Surface Mesh Diagnostics tool is available when: + +- A surface mesh is loaded in the viewer +- The "Surface Mesh Diagnostic" button appears in the viewer toolbar + +
+ +![InspectionButton](./Figures/inspection.png) + +
+ +- Clicking the button opens the "Surface Mesh Diagnostic" interface + +--- + +## **Diagnostic Features** + +### **Quality Metrics** + +The "Surface mesh metrics" section provides access to various pre-computed mesh quality metrics through a searchable dropdown: + +- **None**: Option to disable metric visualization +- **Area**: Surface element area +- **Aspect Ratio**: Ratio of longest to shortest edge +- **Incircle/Circumcircle Radius Ratio Quality**: Quality measure based on inscribed and circumscribed circles +- **Maximum Angle**: Largest angle in the element +- **Minimum Angle**: Smallest angle in the element +- **Minimum Edge Length**: Shortest edge length in the element +- **Skewness Quality**: Measure of element distortion + +> The dropdown includes a search bar that allows you to quickly find metrics by typing (e.g., typing "Area" highlights the Area option). + +### **Surfaces List** + +The diagnosis settings panel includes a "Surfaces list" section that allows you to select which surfaces to analyze: + +- **Search bar**: Search bar with magnifying glass icon to filter surfaces by name +- **Surface selection**: List of available surfaces (e.g., "body00001") + +### **Quality Filtering** + +The "Poor quality elements" tab allows you to filter and identify problematic mesh elements: + +- **Metric selection**: Choose a mesh quality metric from the dropdown (e.g., Aspect Ratio) +- **Condition operators**: Set comparison operators (">", "<", ">=", "<=", "=", "≠") +- **Threshold values**: Enter numerical thresholds (e.g., "25" for Aspect Ratio > 25) +- **Add conditions**: Use the "+ Add condition" button to combine multiple quality criteria +- **Apply filters**: Click the green "Apply" button to filter elements based on conditions diff --git a/docs/05.tools/04.volume-mesh-diagnostics.md b/docs/05.tools/04.volume-mesh-diagnostics.md new file mode 100644 index 0000000..5d75406 --- /dev/null +++ b/docs/05.tools/04.volume-mesh-diagnostics.md @@ -0,0 +1,74 @@ +# Volume Mesh Diagnostics + +*The Volume Mesh Diagnostics tool provides comprehensive analysis capabilities for assessing the quality of volume meshes through automatically generated slices. This tool helps identify mesh quality issues in the 3D volume mesh.* + +--- + +## **Overview** + +The Volume Mesh Diagnostics tool opens a dedicated panel that allows you to inspect volume mesh quality by analyzing cross-sectional slices through the mesh. When a volume mesh is loaded, this tool becomes available to help: + +- Identify poor quality volume elements +- Inspect mesh quality at different locations +- Understand mesh characteristics throughout the domain +- Diagnose potential issues that could affect simulation accuracy + +--- + +## **Accessing Volume Mesh Diagnostics** + +The Volume Mesh Diagnostics tool is available when: + +- A volume mesh is loaded in the viewer +- The "Volume Mesh Diagnostic" button appears in the viewer toolbar (below the file path in the top bar) + +
+ +![VolumeDiagnosis](./Figures/inspection.png) + +
+ +- Clicking the button opens the "Volume Mesh Diagnostic" interface + +--- + +## **Diagnostic Features** + +### **Quality Metrics** + +The automatically generated slices allow you to inspect the quality of the volume mesh cells visualized in each slice. You can analyze the following mesh quality metrics for the cells displayed: + +- **Aspect Ratio**: Ratio of longest to shortest edge of the volume cells +- **Minimum Edge Length**: Shortest edge length in the volume cells +- **Maximum Edge Length**: Longest edge length in the volume cells +- **Volume**: Volume of the individual cells in the slice +- **Maximum Aspect Ratio**: Largest aspect ratio found in the slice + +These metrics help you identify cells with poor quality, such as highly stretched elements (high aspect ratio), cells with very small edges (minimum edge length), or cells with unusual volumes that may affect simulation accuracy. + +### **Automatic Slice Generation** + +The tool automatically creates slices for analysis: + +- **Worst-quality slices**: Slices are automatically generated based on worst aspect ratio and minimum edge length locations +- **Default slices**: Several default slices are automatically created close to bodies in the domain +- **Slice orientation**: Slices are created along x-normal, y-normal, and z-normal directions + +### **Slice Management** + +The diagnosis settings panel provides comprehensive slice management: + +- **Slices list section**: View and manage all available slices in the "Slices list" section +- **Search functionality**: Use the "Search" input field to filter slices by name or criteria +- **Visibility toggle**: Eye icon next to each slice entry allows you to show or hide individual slices in the viewer +- **Slice switching**: "Switch to crinkled" button toggles between crinkled (showing actual mesh element boundaries) and smooth slice visualization + +
+ +![CrinkledView](./Figures/crinkled.png) + +
+ +- **Slice information**: Hover over slice entries to see tooltips with detailed information: + - Example: "Worst-quality x-normal slice based on smallest minimum edge length in zone farfield" + - Example: "Worst-quality x-normal slice based on maximum aspect ratio in zone farfield" diff --git a/docs/05.tools/05.mesh-statistics-panel.md b/docs/05.tools/05.mesh-statistics-panel.md new file mode 100644 index 0000000..5853a84 --- /dev/null +++ b/docs/05.tools/05.mesh-statistics-panel.md @@ -0,0 +1,87 @@ +# Mesh Statistics Panel + +*The Mesh Statistics Panel provides detailed numerical information about the mesh, including element counts, node information, and boundary statistics. This panel is accessible directly from the viewer and provides a comprehensive overview of mesh characteristics.* + +--- + +## **Accessing the Mesh Statistics Panel** + +The Mesh Statistics Panel is accessed by: + +- Clicking on the node count display in the viewer + +
+ +![MeshStatisticsButton](./Figures/nodes.png) + +
+ +- The panel opens in the main content area, replacing the 3D viewer +- The panel displays comprehensive mesh statistics organized into sections + +--- + +## **Metrics Section** + +The panel displays comprehensive mesh information organized under the "Metrics" heading: + +### **Mesh Statistics** + +Overall mesh information displayed in a structured list format: + +- **Nodes**: Total number of nodes in the mesh +- **Triangles**: Number of triangular surface elements +- **Prisms**: Number of prismatic volume elements +- **Quadrilaterals**: Number of quadrilateral surface elements +- **Pyramids**: Number of pyramid volume elements +- **Tetrahedrons**: Number of tetrahedral volume elements +- **Hexahedrons**: Number of hexahedral volume elements + +Each statistic is displayed with its numerical value, providing a quick overview of mesh composition. + +### **Boundary Section** + +For surface meshes, the "Boundary" section shows: + +- **Face list**: Faces are listed in the format `volume_zone_name/surface_name(NUMBER)` where: + - `volume_zone_name` indicates the volume zone identifier (e.g., `fluid`) + - `surface_name` indicates the surface identifier (e.g., `body00001_face00001`) + - `(NUMBER)` indicates the element count for that face. +- **Expandable entries**: Each boundary face entry has a right-pointing triangle indicating it can be expanded to show detailed statistics tables + +#### **Boundary Statistics Table** + +When you expand a boundary face entry, a detailed statistics table is displayed with the following columns: + +- **Title**: The name of the mesh quality metric (e.g., `area`, `areaRatio`, `aspectRatio`, `firstLayerThickness`) +- **Arithmetic Mean**: The average value of the metric across all elements in the boundary face +- **Max**: The maximum value observed for the metric +- **Max Element Types**: The type(s) of mesh elements associated with the maximum value (e.g., `Triangle`, `Node`) +- **Max Location**: The 3D coordinates (X, Y, Z) where the maximum value occurs, with a copy icon to copy coordinates +- **min**: The minimum value observed for the metric +- **Min Element Types**: The type(s) of mesh elements associated with the minimum value +- **Min Location**: The 3D coordinates (X, Y, Z) where the minimum value occurs, with a copy icon to copy coordinates + +### **Volumetric Section** + +For volume meshes, the "Volumetric" section shows: + +- **Zone list**: Zones are listed in the format `zone_name (ELEMENT_COUNT)` (e.g., `fluid (25,092,608)`) +- **Expandable zones**: Each volume zone entry has a right-pointing triangle indicating it can be expanded to show detailed statistics tables + +#### **Volumetric Statistics Table** + +When you expand a volume zone entry, a detailed statistics table is displayed with the following columns: + +- **Title**: The name of the mesh quality metric (e.g., `aspectRatio`, `volume`) +- **Arithmetic Mean**: The average value of the metric across all elements in the volume zone +- **Max**: The maximum value observed for the metric +- **Max Element Types**: The type(s) of mesh elements associated with the maximum value (e.g., `Prism`, `Tetrahedron`) +- **Max Location**: The 3D coordinates (X, Y, Z) where the maximum value occurs, with a copy icon to copy coordinates +- **min**: The minimum value observed for the metric +- **Min Element Types**: The type(s) of mesh elements associated with the minimum value +- **Min Location**: The 3D coordinates (X, Y, Z) where the minimum value occurs, with a copy icon to copy coordinates + +### **Visualization Section** + +The panel also includes a "Visualization" section that shows mesh screenshots. diff --git a/docs/05.tools/Figures/crinkled.png b/docs/05.tools/Figures/crinkled.png new file mode 100644 index 0000000..a5cf70d Binary files /dev/null and b/docs/05.tools/Figures/crinkled.png differ diff --git a/docs/05.tools/Figures/inspection.png b/docs/05.tools/Figures/inspection.png new file mode 100644 index 0000000..9a8c47b Binary files /dev/null and b/docs/05.tools/Figures/inspection.png differ diff --git a/docs/05.tools/Figures/nodes.png b/docs/05.tools/Figures/nodes.png new file mode 100644 index 0000000..0e794ea Binary files /dev/null and b/docs/05.tools/Figures/nodes.png differ diff --git a/docs/05.tools/Figures/probe.png b/docs/05.tools/Figures/probe.png new file mode 100644 index 0000000..caaef10 Binary files /dev/null and b/docs/05.tools/Figures/probe.png differ diff --git a/docs/05.tools/Figures/rotor_speed.png b/docs/05.tools/Figures/rotor_speed.png new file mode 100644 index 0000000..667812d Binary files /dev/null and b/docs/05.tools/Figures/rotor_speed.png differ diff --git a/docs/05.tools/Figures/settings.png b/docs/05.tools/Figures/settings.png new file mode 100644 index 0000000..5495026 Binary files /dev/null and b/docs/05.tools/Figures/settings.png differ diff --git a/docs/05.tools/Figures/time_settings.png b/docs/05.tools/Figures/time_settings.png new file mode 100644 index 0000000..1f31c27 Binary files /dev/null and b/docs/05.tools/Figures/time_settings.png differ diff --git a/docs/05.tools/Figures/variables.png b/docs/05.tools/Figures/variables.png new file mode 100644 index 0000000..2d51eb9 Binary files /dev/null and b/docs/05.tools/Figures/variables.png differ diff --git a/docs/05.tools/README.md b/docs/05.tools/README.md new file mode 100644 index 0000000..ac25def --- /dev/null +++ b/docs/05.tools/README.md @@ -0,0 +1,11 @@ +# Tools + +*Flow360 provides various tools to assist with geometry inspection, mesh quality assessment, and variable management during simulation setup and analysis.* + +This section covers the available tools in the Flow360 webUI: + +- [Probing](./01.probing.md) - Inspect point locations on imported geometry +- [Variable Settings](./02.variable-settings.md) - Create and manage user-defined variables +- [Surface Mesh Diagnostics](./03.surface-mesh-diagnostics.md) - Analyze surface mesh quality +- [Volume Mesh Diagnostics](./04.volume-mesh-diagnostics.md) - Inspect volume mesh quality through slices +- [Mesh Statistics Panel](./05.mesh-statistics-panel.md) - View detailed mesh statistics diff --git a/docs/README.md b/docs/README.md index e35dac7..0021fa5 100644 --- a/docs/README.md +++ b/docs/README.md @@ -31,6 +31,12 @@ Content: - [Coordinate Systems](./04.entities-browser/11.coordinate-systems.md) - [Environment](./04.entities-browser/09.environment.md) - [Entity Tags](./04.entities-browser/12.entity-tags.md) +- [Tools](./05.tools/README.md) + - [Probing](./05.tools/01.probing.md) + - [Variable Settings](./05.tools/02.variable-settings.md) + - [Surface Mesh Diagnostics](./05.tools/03.surface-mesh-diagnostics.md) + - [Volume Mesh Diagnostics](./05.tools/04.volume-mesh-diagnostics.md) + - [Mesh Statistics Panel](./05.tools/05.mesh-statistics-panel.md) See full [documentation](https://docs.flexcompute.com/projects/flow360/en/stable/) @@ -42,4 +48,5 @@ See full [documentation](https://docs.flexcompute.com/projects/flow360/en/stable 02.simulation-setup/README.md 03.analysis/README.md 04.entities-browser/README.md +05.tools/README.md ``` \ No newline at end of file