MERRILL Tutorial 1 – Example Files
====================================

This folder contains all files needed to follow Tutorial 1.
See /tutorials/1 on the MERRILL website for the full walkthrough video.


MESH FILE
---------
prism_example1.pat
    Patron-format tetrahedral mesh for a prism-shaped magnetic grain.
    Used as the geometry input for all four example scripts.


EXAMPLE SCRIPTS AND SOLUTIONS
------------------------------
Each script is a MERRILL input file that specifies the material, temperature,
minimisation settings, and applied field protocol. The matching .tec file is
the TecPlot-format solution produced by that script.

  example_script1  /  prism_example1_solution_mult.tec
      Magnetite at 20 °C — random initial magnetization guess.

  example_script2  /  prism_example2_solution_mult.tec
      Magnetite at 20 °C — random initial magnetization guess (second run,
      different random seed to explore alternative energy minima).

  example_script3  /  prism_example3_solution_mult.tec
      Magnetite at 500 °C — random initial magnetization guess.
      Demonstrates the effect of elevated temperature on magnetic structure.

  example_script4  /  prism_example4_solution_mult.tec
      TM54 (titanomagnetite) at 20 °C — uniform initial magnetization
      aligned with the +Z axis.


HOW TO USE
----------
1. Open a terminal and navigate to this folder.
2. Run MERRILL with one of the example scripts, e.g.:
       merrill example_script1
3. Compare your output to the provided .tec solution file in ParaView or TecPlot.
4. Repeat for scripts 2–4 to see how material and temperature affect the result.


FILE FORMATS
------------
.pat   Patron mesh format (MERRILL native geometry input)
.tec   TecPlot ASCII format (magnetization structure output, viewable in ParaView)
