Skip to content

Invalid Configuration Examples

Common configuration mistakes and their validation errors.

Info

These examples intentionally fail schema validation to demonstrate error messages and constraint enforcement.

Invalid Solver Name

{
  "velocity_method": "Waterloo",
  "solver": "RungeKutta4",
  "adaptive": {
    "tolerance": 1e-6,
    "safety": 0.9,
    "alpha": 0.2,
    "min_scale": 0.2,
    "max_scale": 5.0,
    "max_rejects": 10,
    "min_dt": 1e-10,
    "euler_dt": 1.0
  },
  "dispersion": {
    "method": "None"
  },
  "retardation_enabled": false,
  "capture": {
    "max_time": 365250.0,
    "max_steps": 1000000,
    "stagnation_velocity": 1e-12,
    "stagnation_limit": 100
  },
  "initial_dt": 1.0,
  "max_dt": 100.0,
  "direction": 1.0
}

Validation Error

'RungeKutta4' is not one of ['Euler', 'Rk4StepDoubling', 'DormandPrince', 'CashKarp', 'VernerRobust', 'VernerEfficient']

Fix: Use one of the exact solver names listed in the error message.

Invalid Direction Value

{
  "velocity_method": "Waterloo",
  "solver": "DormandPrince",
  "adaptive": {
    "tolerance": 1e-6,
    "safety": 0.9,
    "alpha": 0.2,
    "min_scale": 0.2,
    "max_scale": 5.0,
    "max_rejects": 10,
    "min_dt": 1e-10,
    "euler_dt": 1.0
  },
  "dispersion": {
    "method": "None"
  },
  "retardation_enabled": false,
  "capture": {
    "max_time": 365250.0,
    "max_steps": 1000000,
    "stagnation_velocity": 1e-12,
    "stagnation_limit": 100
  },
  "initial_dt": 1.0,
  "max_dt": 100.0,
  "direction": 0.5
}

Validation Error

0.5 is not one of [1.0, -1.0]

Fix: Use 1.0 for forward tracking or -1.0 for backward tracking.

Missing Required Field

{
  "velocity_method": "Waterloo",
  "adaptive": {
    "tolerance": 1e-6,
    "safety": 0.9,
    "alpha": 0.2,
    "min_scale": 0.2,
    "max_scale": 5.0,
    "max_rejects": 10,
    "min_dt": 1e-10,
    "euler_dt": 1.0
  },
  "dispersion": {
    "method": "None"
  },
  "retardation_enabled": false,
  "capture": {
    "max_time": 365250.0,
    "max_steps": 1000000,
    "stagnation_velocity": 1e-12,
    "stagnation_limit": 100
  },
  "initial_dt": 1.0,
  "max_dt": 100.0,
  "direction": 1.0
}

Validation Error

'solver' is a required property

Fix: Add the "solver" field with a valid solver name. All required fields are: velocity_method, solver, adaptive, dispersion, retardation_enabled, capture, initial_dt, max_dt, direction.

Negative Dispersivity

{
  "velocity_method": "Waterloo",
  "solver": "DormandPrince",
  "adaptive": {
    "tolerance": 1e-6,
    "safety": 0.9,
    "alpha": 0.2,
    "min_scale": 0.2,
    "max_scale": 5.0,
    "max_rejects": 10,
    "min_dt": 1e-10,
    "euler_dt": 1.0
  },
  "dispersion": {
    "method": "Gsde",
    "alpha_l": -5.0,
    "alpha_th": 1.0,
    "alpha_tv": 0.1
  },
  "retardation_enabled": false,
  "capture": {
    "max_time": 365250.0,
    "max_steps": 1000000,
    "stagnation_velocity": 1e-12,
    "stagnation_limit": 100
  },
  "initial_dt": 1.0,
  "max_dt": 100.0,
  "direction": 1.0
}

Validation Error

{'method': 'Gsde', 'alpha_l': -5.0, 'alpha_th': 1.0, 'alpha_tv': 0.1} is not valid under any of the given schemas

Fix: Dispersivity values (alpha_l, alpha_th, alpha_tv) must be zero or positive. Change alpha_l from -5.0 to a non-negative value.

Wrong Type

{
  "velocity_method": "Waterloo",
  "solver": 42,
  "adaptive": {
    "tolerance": 1e-6,
    "safety": 0.9,
    "alpha": 0.2,
    "min_scale": 0.2,
    "max_scale": 5.0,
    "max_rejects": 10,
    "min_dt": 1e-10,
    "euler_dt": 1.0
  },
  "dispersion": {
    "method": "None"
  },
  "retardation_enabled": false,
  "capture": {
    "max_time": 365250.0,
    "max_steps": 1000000,
    "stagnation_velocity": 1e-12,
    "stagnation_limit": 100
  },
  "initial_dt": 1.0,
  "max_dt": 100.0,
  "direction": 1.0
}

Validation Error

42 is not of type 'string'

Fix: The solver field must be a string, not a number. Use "DormandPrince" instead of 42.

See Also