Setting custom simulation parameters

Create a custom parameter dictionary for a Star or Cluster run, and optionally restrict the ages saved in output tracks using AgesOut.

Prerequisites

Install MORS and download stellar evolution data:

pip install fwl-mors
mors download all

Step 1: Start from the default parameter set

Create a parameter dictionary identical to the internal defaults:

import mors

my_params = mors.NewParams()

This returns a standard Python dictionary that you can inspect and modify freely.

Step 2: Change one or more parameters

Option A: pass values directly to NewParams (recommended)

import mors

my_params = mors.NewParams(Kwind=15.0, dAgeMax=10.0)

Option B: edit the dictionary after creation

import mors

my_params = mors.NewParams()
my_params['Kwind'] = 15.0
my_params['dAgeMax'] = 10.0

See the Parameters page for the full list of available parameters and their defaults.

Step 3: Pass the parameter dictionary into Star or Cluster

import mors

star = mors.Star(Mstar=1.0, Omega=10.0, params=my_params)
cluster = mors.Cluster(Mstar=Mstar, Omega=Omega, params=my_params)

Step 4: Print the current parameter values

PrintParams uses the logging system, so configure logging first:

import mors
from mors.logs import setup_logger

setup_logger("INFO")

# print all defaults
mors.PrintParams()

# or print a custom dictionary
mors.PrintParams(params=my_params)

Step 5: Restrict output ages with AgesOut (optional)

By default, MORS saves tracks on its internal adaptive age grid. If you only need values at specific ages, pass AgesOut to restrict the saved output to those ages:

Single age:

import mors

star = mors.Star(Mstar=1.0, Omega=10.0, AgesOut=100.0)  # Myr

Multiple ages:

import numpy as np
import mors

ages = np.array([100.0, 200.0, 300.0, 400.0])  # Myr, must be ascending
star = mors.Star(Mstar=1.0, Omega=10.0, AgesOut=ages)

Common pitfalls

• AgesOut is in Myr.
• The simulation always starts at 1 Myr regardless of AgesOut.
• If you later need to query many arbitrary ages, prefer the default age grid rather than a sparse AgesOut.
• PrintParams produces no output unless logging is configured.