# *************************************************************************** # * Copyright (c) 2017 Markus Hovorka * # * * # * This program is free software; you can redistribute it and/or modify * # * it under the terms of the GNU Lesser General Public License (LGPL) * # * as published by the Free Software Foundation; either version 2 of * # * the License, or (at your option) any later version. * # * for detail see the LICENCE text file. * # * * # * This program is distributed in the hope that it will be useful, * # * but WITHOUT ANY WARRANTY; without even the implied warranty of * # * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the * # * GNU Library General Public License for more details. * # * * # * You should have received a copy of the GNU Library General Public * # * License along with this program; if not, write to the Free Software * # * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 * # * USA * # * * # *************************************************************************** """ Execute Solver and obtain Reports and Results. Integral part of the Solver Framework which contains components responsible for executing the solver in the background. Also provides an asynchronous communication system with the solver running in the background. The purpose of this module is to be as generic as possible. It can execute every solver supported by the fem workbench. The threading and communication support is mainly implemented by the :mod:`femsolver.task` and :mod:`femsolver.signal` modules. """ __title__ = "FreeCAD FEM solver run" __author__ = "Markus Hovorka" __url__ = "http://www.freecadweb.org" import os import os.path # import threading # not used ATM import shutil import FreeCAD as App import femtools.femutils as femutils from . import settings from . import signal from . import task if App.GuiUp: import FreeCADGui from PySide import QtGui CHECK = 0 PREPARE = 1 SOLVE = 2 RESULTS = 3 DONE = 4 _machines = {} _dirTypes = {} def run_fem_solver(solver, working_dir=None): """ Execute *solver* of the solver framework. Uses :meth:`getMachine ` to obtain a :class:`Machine` instance of the solver. It than executes the Machine with using the ``RESULTS`` target (see :class:`Machine` for infos about different targets). This method is blocking, it waits for the solver to finished before returning. Be aware of :class:`Machine` caching when using the function. :param solver: A document object which must be a framework compliant solver. This means that it should be derived from the document object provided by :mod:`femsolver.solverbase` and implement all required methods correctely. Of particular importance is :meth:`getMachine ` as it is used by this method the get the :class:`Machine` used to execute the solver. :param working_dir: If specified it overwrites the automatic and user configurable working directory management of the Solver framework. Should always be a absolute path because the location of the binary is not consistent among platforms. If ``None`` the automatic working directory management is used. :note: There is some legacy code to execute the old Calculix solver (pre-framework) which behaives differently because it doesn't use a :class:`Machine`. """ if solver.Proxy.Type == "Fem::FemSolverCalculixCcxTools": App.Console.PrintMessage("CalxuliX ccx tools solver!\n") from femtools.ccxtools import CcxTools as ccx fea = ccx(solver) fea.reset_mesh_purge_results_checked() if working_dir is None: fea.run() else: fea.update_objects() fea.setup_working_dir(working_dir) fea.setup_ccx() message = fea.check_prerequisites() if not message: fea.write_inp_file() fea.ccx_run() fea.load_results() else: App.Console.PrintError("Houston, we have a problem ...!\n{}\n".format(message)) else: # App.Console.PrintMessage("Frame work solver!\n") try: if working_dir is not None: machine = getMachine(solver, working_dir) else: machine = getMachine(solver) except femutils.MustSaveError: error_message = ( "Please save the file before executing the solver. " "This must be done because the location of the working " "directory is set to \"Beside *.FCStd File\"." ) App.Console.PrintError(error_message + "\n") if App.GuiUp: QtGui.QMessageBox.critical( FreeCADGui.getMainWindow(), "Can't start Solver", error_message ) return except femutils.DirectoryDoesNotExistError: error_message = "Selected working directory doesn't exist." App.Console.PrintError(error_message + "\n") if App.GuiUp: QtGui.QMessageBox.critical( FreeCADGui.getMainWindow(), "Can't start Solver", error_message ) return if not machine.running: machine.reset() machine.target = RESULTS machine.start() machine.join() # wait for the machine to finish. def getMachine(solver, path=None): """ Get or create :class:`Machine` using caching mechanism. :param solver: A document object which must be a framework compliant solver. This means that it should be derived from the document object provided by :mod:`femsolver.solverbase` and implement all required methods correctely. Of particular importance is :meth:`getMachine ` as it is used by this method to create a new :class:`Machine` on cache miss. :param path: A valid filesystem path which shall be associetad with the machine. """ _DocObserver.attach() m = _machines.get(solver) if m is None or not _isPathValid(m, path): m = _createMachine(solver, path, testmode=False) return m def _isPathValid(m, path): t = _dirTypes.get(m.directory) # setting default None setting = settings.get_dir_setting() if path is not None: return t is None and m.directory == path if setting == settings.DirSetting.BESIDE: if t == settings.DirSetting.BESIDE: base = os.path.split(m.directory.rstrip("/"))[0] return base == femutils.get_beside_base(m.solver) return False if setting == settings.DirSetting.TEMPORARY: return t == settings.DirSetting.TEMPORARY if setting == settings.DirSetting.CUSTOM: if t == settings.DirSetting.CUSTOM: firstBase = os.path.split(m.directory.rstrip("/"))[0] customBase = os.path.split(firstBase)[0] return customBase == femutils.get_custom_base(m.solver) return False def _createMachine(solver, path, testmode): global _dirTypes setting = settings.get_dir_setting() if path is not None: _dirTypes[path] = None elif setting == settings.BESIDE: path = femutils.get_beside_dir(solver) _dirTypes[path] = settings.BESIDE elif setting == settings.TEMPORARY: path = femutils.get_temp_dir(solver) _dirTypes[path] = settings.TEMPORARY elif setting == settings.CUSTOM: path = femutils.get_custom_dir(solver) _dirTypes[path] = settings.CUSTOM m = solver.Proxy.createMachine(solver, path, testmode) oldMachine = _machines.get(solver) if oldMachine is not None and _dirTypes.get(oldMachine.directory) is not None: del _dirTypes[oldMachine.directory] _machines[solver] = m return m def _getUniquePath(path): postfix = 1 if path in _dirTypes: path += "_%03d" % postfix while path in _dirTypes: postfix += 1 path = path[:-4] + "_%03d" % postfix return path class BaseTask(task.Thread): def __init__(self): super(BaseTask, self).__init__() self.solver = None self.directory = None self.testmode = None @property def analysis(self): return femutils.findAnalysisOfMember(self.solver) class Machine(BaseTask): def __init__( self, solver, directory, check, prepare, solve, results, testmode): super(Machine, self).__init__() self.solver = solver self.directory = directory self.signalState = set() self.check = check self.prepare = prepare self.solve = solve self.results = results self.target = RESULTS self._state = CHECK self._pendingState = None self._isReset = False self.testmode = testmode @property def state(self): return self._state def run(self): self._confTasks() self._isReset = False self._pendingState = self.state while ( not self.aborted and not self.failed and self._pendingState <= self.target ): task = self._getTask(self._pendingState) self._runTask(task) self.report.extend(task.report) if task.failed: self.fail() elif task.aborted: self.abort() else: self._pendingState += 1 self._applyPending() def reset(self, newState=CHECK): state = (self.state if self._pendingState is None else self._pendingState) if newState < state: self._isReset = True self._state = newState signal.notify(self.signalState) def _confTasks(self): tasks = [ self.check, self.prepare, self.solve, self.results ] for t in tasks: t.solver = self.solver t.directory = self.directory t.testmode = self.testmode def _applyPending(self): if not self._isReset: self._state = self._pendingState signal.notify(self.signalState) self._isReset = False self._pendingState = None def _runTask(self, task): def statusProxy(line): self.pushStatus(line) def killer(): task.abort() self.signalAbort.add(killer) task.signalStatus.add(statusProxy) task.start() task.join() self.signalAbort.remove(killer) task.signalStatus.remove(statusProxy) def _getTask(self, state): if state == CHECK: return self.check elif state == PREPARE: return self.prepare elif state == SOLVE: return self.solve elif state == RESULTS: return self.results return None class Check(BaseTask): def checkMesh(self): meshes = femutils.get_member( self.analysis, "Fem::FemMeshObject") if len(meshes) == 0: self.report.error("Missing a mesh object.") self.fail() return False elif len(meshes) > 1: self.report.error( "Too many meshes. " "More than one mesh is not supported.") self.fail() return False return True def checkMaterial(self): matObjs = femutils.get_member( self.analysis, "App::MaterialObjectPython") if len(matObjs) == 0: self.report.error( "No material object found. " "At least one material is required.") self.fail() return False return True def checkSupported(self, allSupported): for m in self.analysis.Group: if femutils.is_of_type(m, "Fem::Constraint"): supported = False for sc in allSupported: if femutils.is_of_type(m, *sc): supported = True if not supported: self.report.warning( "Ignored unsupported constraint: %s" % m.Label) return True class Solve(BaseTask): def _observeSolver(self, process): output = "" line = femutils.pydecode(process.stdout.readline()) self.pushStatus(line) output += line line = femutils.pydecode(process.stdout.readline()) while line: line = "\n%s" % line.rstrip() self.pushStatus(line) output += line line = femutils.pydecode(process.stdout.readline()) return output class Prepare(BaseTask): pass class Results(BaseTask): pass class _DocObserver(object): _instance = None _WHITELIST = [ "Fem::Constraint", "App::MaterialObject", "Fem::FemMeshObject", ] _BLACKLIST_PROPS = [ "Label", "ElmerOutput", "ElmerResult" ] def __init__(self): self._saved = {} for doc in iter(App.listDocuments().values()): for obj in doc.Objects: if obj.isDerivedFrom("Fem::FemAnalysis"): self._saved[obj] = obj.Group @classmethod def attach(cls): if cls._instance is None: cls._instance = cls() App.addDocumentObserver(cls._instance) def slotDeletedObject(self, obj): self._checkModel(obj) if obj in _machines: self._deleteMachine(obj) def slotChangedObject(self, obj, prop): if prop not in self._BLACKLIST_PROPS: self._checkAnalysis(obj) self._checkEquation(obj) self._checkSolver(obj) self._checkModel(obj) def slotDeletedDocument(self, doc): for obj in doc.Objects: if obj in _machines: self._deleteMachine(obj) def _deleteMachine(self, obj): m = _machines[obj] t = _dirTypes[m.directory] m.abort() if t == settings.DirSetting.TEMPORARY: shutil.rmtree(m.directory) del _machines[obj] del _dirTypes[m.directory] def _checkEquation(self, obj): for o in obj.Document.Objects: if ( femutils.is_derived_from(o, "Fem::FemSolverObject") and hasattr(o, "Group") and obj in o.Group ): if o in _machines: _machines[o].reset() def _checkSolver(self, obj): analysis = femutils.findAnalysisOfMember(obj) for m in iter(_machines.values()): if analysis == m.analysis and obj == m.solver: m.reset() def _checkAnalysis(self, obj): if femutils.is_derived_from(obj, "Fem::FemAnalysis"): deltaObjs = self._getAdded(obj) if deltaObjs: reset = False for o in deltaObjs: if self._partOfModel(o): reset = True if reset: self._resetAll(obj) def _checkModel(self, obj): if self._partOfModel(obj): analysis = femutils.findAnalysisOfMember(obj) if analysis is not None: self._resetAll(analysis) def _getAdded(self, analysis): if analysis not in self._saved: self._saved[analysis] = [] delta = set(analysis.Group) - set(self._saved[analysis]) self._saved[analysis] = analysis.Group return delta def _resetAll(self, analysis): for m in iter(_machines.values()): if analysis == m.analysis: m.reset() def _partOfModel(self, obj): for t in self._WHITELIST: if femutils.is_derived_from(obj, t): return True return False