Home
Run nanoFluidX
How to run a nanoFluidX model.
Troubleshoot a Simulation
How to troubleshoot a simulation which fails to run or stops prematurely.

Welcome
What's New
View new features for nanoFluidX 2024.
Overview
nanoFluidX is a software to simulate single and multi-phase flows based on the Lagrangian Particle Method Smoothed Particle Hydrodynamics (SPH).
Video Tutorials
Discover nanoFluidX functionality with interactive tutorials.
Pre-processing with SimLab
Create a nanoFluidX model using SimLab.
Run nanoFluidX
How to run a nanoFluidX model.
- Platform and Hardware Requirements
  Platforms, operating systems, and processors supported by nanoFluidX and recommended and required hardware.
- Basic Usage
  Sample configuration files and geometry input files are provided with the binary to test the proper system setting and see if the simulation starts correctly on the system.
- Launch a Simulation
  Launch a simulation via a Linux or Windows terminal, or via PBS access.
- Multi-node Jobs
  Recommendations for running multi-node jobs.
- nanoFluidX Prep
  nanoFluidX prep, shortened as nFX[p], is an auxiliary executable for nanoFluidX intended to eliminate a number of potential user errors during the pre-processing phase.
- nanoFluidX Companion
  nanoFluidX companion, also known as nFX[c], is a post-processing tool developed to accompany the nanoFluidX solver allowing for an easier execution of certain post-processing tasks.
- nanoFluidX Monitor
  nanoFluidX monitor, known as nFX[m], is a single file portable Python executable that is aimed for helping with monitoring a nanoFluidX simulation during runtime.
- Restart a Simulation
- Troubleshoot a Simulation
  How to troubleshoot a simulation which fails to run or stops prematurely.
  - Case and System Information
    The check_nFX script is able to collect case and system information for debugging. This can be done by executing scripts with the provided path to the case directory: check_nFX -c <path/to/case/directory>.
Post-processing with ParaView
How to post-process nanoFluidX results using ParaView.
Simulation Guidance
Guidance on modeling specific usecases with nanoFluidX.
Command Reference
nanoFluidX commands and parameters with examples.
Theory Manual
Physics and theory for nanoFluidX.
Validation Cases
Validation cases for the dynamic testing of nanoFluidX.
Performance Benchmarks
Performance benchmark results for nanoFluidX.
Error and Warning Messages
This glossary contains generic messages generated by nanoFluidX, their likely causes, and possible methods to resolve the related issues.
Frequently Asked Questions
This section provides quick responses to typical and frequently asked questions regarding nanoFluidX.
Bibliography
References used throughout the nanoFluidX manual.

View All Altair HyperWorks Help

Troubleshoot a Simulation

How to troubleshoot a simulation which fails to run or stops prematurely.

Simulation Error

If there is an error, read the .log file and check for warnings and errors. Any errors or warnings will have a code which can be used to search the Error and Warning Glossary document for full details.

Tip: The nanoFluidX_2024_error_and_warning_glossary document is provided with the nanoFluidX binary in the HyperMesh CFD installation directory.

Inspect your .cfg file and verify the following:

Make sure the vector quantities are correctly defined.
Make sure that there are no input scalar values where there should be vectors and vice versa.
Make sure that the Min/Max boundary values are actually set in order. For example, -0.04 > -0.1.
Check the reference values, especially reference velocity.
Check for overlapping particles.
Make sure your units are consistent.

For more information on diagnosing a simulation which has problems, see Investigate Simulation Problems.