Required Environment

Required Solver

  • fsolve (preinstalled with MATLAB)

User Options

  • Use Block Decomposition: Activates a Dulmage-Mendelssohn Decomposition to divide the algebraic equation system into blocks, which can be solved individually by MATLAB.
  • TolFun: MATLAB’s option to set the convergence criterion for fsolve. For more information refer to MATLAB’s documentation
  • Use Analytic Derivatives: If this option is set to “yes”, MOSAIC provides a symbolic form of the Jacobian matrix to fsolve.
  • MaxIter: MATLAB’s option to set the maximum number of iterations for fsolve. For more information refer to MATLAB’s documentation.
  • Use Sparse Jacobian: If this option is set to “yes”, MOSAIC provides the Jacobian in a sparse form to fsolve.

Usage for Simulation

  1. Open an NLE Evaluation in MOSAIC
  2. Set the variable specs to obtain a degree of freedom of zero.
  3. Select the Predefined Language Specification “MATLAB NLE”.
  4. Choose the Code Generator and Solver Properties in accordance with the User Options above.
  5. Press Generate Code.
  6. Copy everything from the View Code tab and paste it to a new m-file inside MATLAB’s IDE.
  7. Save the new m-file
  8. Press run inside MATLAB’s IDE.
  9. After completion the results appear in MATLAB’s command line window.
  10. Copy the lines containing the variable names and their final values and paste them into the Import tab of MOSAIC’s evaluation environment.
  11. Select the Predefined Language Specification “MATLAB NLE” and press Import.
  12.  The results will automatically update the Initial values in the Variable Specification tab and can be saved for future use by pressing Save As.