840c9755d5
Currently, openEMS doesn't have any special code to handle SIGINT (which is raised by pressing Control-C). By default, the program is terminated without saving data. This worked okay in the past, but now its limitations are becoming obvious. 1. When openEMS is used as a Python module, Control-C stops working because SIGINT is now managed by Python in order to generate KeyboardInterrupt exceptions, normally this isn't a problem, but if we are running an external C++ (Cython) function such as openEMS, the Python interpreter mainloop has no control until we return. As a result, SIGINT is received but never handled. In Cython, programs are expected to call PyErr_CheckSignals() in its blocking loop periodically to temporally transfer control back to Python to handle signals. But this introduces a dependency of Cython in the FDTD mainloop. 2. During a simulation, it's not possible to abort it gracefully by pressing Control-C, this is a limitation of openEMS itself, it's always a force exit. Currently the only supported method for graceful exit is creating a file called "ABORT" in the simulation directory. If we already need to implement a signal handler, adding a graceful exit at the same time would be a good idea. This commit installs SIGINT handlers during SetupFDTD() and RunFDTD(). 1. In RunFDTD(), if SIGINT is received once, a status flag is set, which is then checked in CheckAbortCond(), allowing a graceful exit with the same effect of an "ABORT" file. If SIGINT is received twice, openEMS force exit without saving data (just like the old default behavior). 2. In SetupFDTD(), if SIGINT is received, openEMS immediately force exit without saving data, identical to the old behavior. In a huge simulation, initializing and compressing operators may have a long time. so we want an early exit before RunFDTD(). 3. Before RunFDTD() and SetupFDTD() return, the original signal handler for SIGINT is restored. This is important since when we're acting as a shared library. When a program (such as the Python interpreter) calls us, changing the SIGINT handler unilaterally may overwrite the original handler and affect the functionality of the original program. For example, Python would never be able to raise KeyboardInterrupt again. Thus, we save the original handler and restore it later. Signed-off-by: Yifeng Li <tomli@tomli.me> |
||
|---|---|---|
| Analyse | ||
| Common | ||
| FDTD | ||
| TESTSUITE | ||
| cmake/Modules | ||
| linux | ||
| matlab | ||
| nf2ff | ||
| python | ||
| tools | ||
| .gitattributes | ||
| .gitignore | ||
| CMakeLists.txt | ||
| COPYING | ||
| Doxyfile | ||
| INSTALL | ||
| NEWS | ||
| README | ||
| TODO | ||
| astyle.sh | ||
| known_bugs | ||
| known_problems | ||
| main.cpp | ||
| openEMS.sh | ||
| openEMS_MPI.sh | ||
| openems.cpp | ||
| openems.h | ||
| openems_global.h | ||
README
* * openEMS - a free and open electromagnetic field solver * * Copyright (C) 2010-2015 Thorsten Liebig * openEMS is licensed under the terms of the GPLv3, see <http://www.gnu.org/licenses/>. Website: http://openems.de Forum: http://openems.de/forum/ Tutorials: http://openems.de/index.php/Tutorials To use openEMS from Matlab or Octave, you need to include the <openEMS-install-folder>/matlab folder in the respective environment: > addpath( '<openEMS-install-folder>/matlab' ); To verify the correct installation follow the instructions at: http://openems.de/index.php/Tutorial:_First_Steps