COMSOL
==========
COMSOL Multiphysics is a finite element analyzer, solver, and simulation software package
for various physics and engineering applications.
Learn more in the `official COMSOL documentation `__.
Launching COMSOL
----------------
**Using Magellano OnDemand:** from the ``Interactive Apps`` menu, click on ``COMSOL``.
Fill the form with the required job options and click ``Launch``.
Note that **COMSOL license** is a mandatory option. See `Licensing <#Licensing>`__ for more info.
When your job is up and running, click on the ``Launch COMSOL`` in the ``My Interactive Sessions`` page.
You will be redirected to a new browser tab. From there you can use the COMSOL GUI in a VNC session.
**Using Environment Modules:** load the COMSOL module and run COMSOL as in the example below::
# Set the path to your license file
export LMCOMSOL_LICENSE_FILE=/home/users/neo/comsol.lic
# or the license server as PORT@SERVER
export LMCOMSOL_LICENSE_FILE=1718@lm-comsol.infn.it
# Load the environment module
module load comsol/${COMSOL_VERSION}
# Launch COMSOL specifying the number of allocated processors
comsol -np $SLURM_NPROCS
Licensing
---------
COMSOL reads the information about your license from the ``LMCOMSOL_LICENSE_FILE`` environment variable.
When launching COMSOL from the OnDemand web interface, this variable is passed by the **COMSOL license** entry of the submit form.
If ``LMCOMSOL_LICENSE_FILE`` is not set or your license is not valid, the app will exit with an error.
The ``LMCOMSOL_LICENSE_FILE`` variable can point to a license file or to a license server.
The format for the license server is ``PORT@SERVER``.
If you wish to use the **INFN national COMSOL license**, plese follow the instruction on the `INFN wiki page `__.
After registration, the ``LMCOMSOL_LICENSE_FILE`` variable must be set to ``1718@lm-comsol.infn.it``.
Comsol from your desktop
-----------------------