Skip to content

Configure Models

The configuration system in MINT allows you to define how models should run with specific parameters and file requirements. This section explains how to set up and manage model configurations and their setups.

Accessing Configuration Interface

To add new model configurations and setups, go to the prepare models section and click on configure models:

Understanding the Configuration Hierarchy

The configuration system follows a hierarchical structure:

  • Models: Top-level organization of related model versions
  • Versions: Group configurations that share the same software revision
  • Configurations: Define specific software parameters and file requirements
  • Setups: Provide specific values for configurations

The configure models page presents a tree view showing this hierarchy:

  • Models (default color)
  • Versions (grouped under models)
  • Configurations (green) below versions
  • Setups (blue) below configurations

Working with Configurations

What is a Configuration?

A configuration defines:

  • The specific software version to run
  • Required input parameters
  • Input and output file specifications
  • Variable requirements for each file

You can view detailed configuration information by clicking the expand button:

Managing Parameters

Input Parameters

Each configuration defines its required parameters with:

  • Description and purpose
  • Parameter order
  • Default values
  • Data types
  • Validation rules
  • Other metadata

File Specifications

Configurations specify:

  • Required input files
  • Expected output files
  • Variable requirements for each file
  • File format specifications

Creating and Editing Configurations

  1. Add New Configuration

  2. Click add new configuration to create a new configuration

  3. Or click edit to modify an existing one

  4. Manage Parameters

  5. Add, edit, or remove parameters

  6. Define parameter metadata

  7. Set validation rules

  8. Parameter Form

  9. Use the parameter form to define:

    • Parameter names
    • Data types
    • Default values
    • Validation rules

  10. File Management

  11. Define input file requirements
  12. Specify output file formats
  13. Set variable requirements

Working with Setups

What is a Setup?

A setup is the most specific level of configuration, providing:

  • Concrete values for parameters
  • Specific input files
  • Pre-configured settings for the modeling step

Creating and Managing Setups

  1. Access Setup Interface

  2. Select or create a setup from the left panel

  3. Setup Configuration

  4. Set specific values for parameters
  5. Select input files
  6. Configure user-adjustable settings

Parameter Configuration in Setups

In setups, you can:

  • Set pre-selected values for parameters
  • Mark parameters as user-adjustable
  • Define parameter ranges
  • Set default values

File Configuration in Setups

For input files, you can:

  • Select specific files
  • Define file collections
  • Set default selections
  • Configure file validation

Best Practices

  1. Configuration Organization

  2. Group related configurations under appropriate versions

  3. Use clear, descriptive names

  4. Document parameter purposes

  5. Parameter Management

  6. Set appropriate default values

  7. Define clear validation rules

  8. Document parameter dependencies

  9. Setup Creation

  10. Create setups for common use cases

  11. Provide meaningful default values

  12. Mark frequently adjusted parameters as user-adjustable

  13. File Management

  14. Validate file formats
  15. Document required variables
  16. Set appropriate file constraints