Home
Get Started
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.1.
Get Started
- Overview
  nanoFluidX is a software to simulate single and multi-phase flows based on the Lagrangian Particle Method Smoothed Particle Hydrodynamics (SPH).
- Platform and Hardware Requirements
  Platforms, operating systems, and processors supported by nanoFluidX and recommended and required hardware.
- Installation
  Installation options and recommendations for nanoFluidX.
- Launch a Simulation
  Launch a simulation via a Linux or Windows terminal, or via PBS access.
- 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
  Set up different restart options.
- 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>.
Tutorials
Discover nanoFluidX functionality with interactive tutorials.
Pre-processing
Create a nanoFluidX model using SimLab.
Command Reference
nanoFluidX commands and parameters with examples.
Post-processing
Theory Manual
Physics and theory for nanoFluidX.
Validation Manual
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.1_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.