If auto execution is enabled when creating an refine AIM, the AIM will execute refine just-in-time with the command line:

ref $(cat refInput.txt) > refOutput.txt

where preAnalysis generated the file "refInput.txt" which contains commandline arguments for ref.

The refine analysis directory is assumed to contain a metric.meshb file. This file will be generated automatically with preAnalysis using ScalarFieldFile or HessianFieldFile inputs, or can be generated manually via system calls to refine and setting MetricFieldFile.

The analysis can be also be explicitly executed with caps_execute in the C-API or via Analysis.runAnalysis in the pyCAPS API.

Calling preAnalysis and postAnalysis is NOT allowed when auto execution is enabled.

Auto execution can also be disabled when creating an refine AIM object. In this mode, caps_execute and Analysis.runAnalysis can be used to run the analysis, or refine can be executed by calling preAnalysis, system call, and posAnalysis as demonstrated below with a pyCAPS example:

print ("\n\preAnalysis......")
refine.preAnalysis()
 
print ("\n\nRunning......")
refine.system("ref $(cat refInput.txt) > refOutput.txt"); # Run via system call
 
print ("\n\postAnalysis......")
refine.postAnalysis()