fiqus 2025.2.0__py3-none-any.whl → 2025.10.0__py3-none-any.whl

fiqus/data/DataFiQuSConductorAC_Strand.py

@@ -1,565 +1,701 @@
-from pydantic import BaseModel, Field
-from typing import List, Literal, Optional
-
-
-# ============= GEOMETRY ============= #
-# -- Input/Output settings -- #
-class CACStrandIOsettingsLoad(BaseModel):
-    """
-    Level 3: Class for Input/Output settings for the cable geometry
-    """
-
-    load_from_yaml: Optional[bool] = Field(
-        default=False,
-        description="True to load the geometry from a YAML file, false to generate the geometry.",
-    )
-    filename: Optional[str] = Field(
-        default=None,
-        description="Name of the YAML file from which to load the geometry.",
-    )
-
-class CACStrandIOsettingsSave(BaseModel):
-    """
-    Level 3: Class for Input/Output settings for the cable geometry
-    """
-
-    save_to_yaml: Optional[bool] = Field(
-        default=False,
-        description="True to save the geometry to a YAML-file, false to not save the geometry.",
-    )
-    filename: Optional[str] = Field(
-        default=None,
-        description="Name of the output geometry YAML file.",
-    )
-
-class CACStrandGeometryIOsettings(BaseModel):
-    """
-    Level 2: Class for Input/Output settings for the cable geometry
-    """
-
-    load: CACStrandIOsettingsLoad = (
-        CACStrandIOsettingsLoad()
-    )
-    save: CACStrandIOsettingsSave = (
-        CACStrandIOsettingsSave()
-    )
-
-# -- Strand geometry parameters -- #
-class CACStrandGeometry(BaseModel):
-    """
-    Level 2: Class for strand geometry parameters
-    """
-    io_settings: CACStrandGeometryIOsettings = CACStrandGeometryIOsettings()
-    hexagonal_filaments: Optional[bool] = Field(
-        default=None,
-        description="Field for specifying the shape of the filaments. True for hexagonal, False for circular.",
-    )
-    filament_circular_distribution: Optional[bool] = Field(
-        default=None,
-        description="Field for specifying the geometrical distribution of the filaments. Set True to distribute the filaments in a circular pattern and False to distribute them in a hexagonal pattern."
-    )
-    air_radius: Optional[float] = Field(
-        default=None, description="Radius of the circular numerical air region (m)."
-    )
-
-
-# ============= MESH ============= #
-# -- Filament mesh settings -- #
-class CACStrandMeshFilaments(BaseModel):
-    """
-    Level 3: Class for FiQuS ConductorAC
-    """
-
-    boundary_mesh_size_ratio: Optional[float] = Field(
-        default=None,
-        description="Mesh size at filament boundaries, relative to the radius of the filaments. E.g. 0.1 means that the mesh size is 0.1 times the filament radius.",
-    )
-    center_mesh_size_ratio: Optional[float] = Field(
-        default=None,
-        description="Mesh size at filament center, relative to the radius of the filaments. E.g. 0.1 means that the mesh size is 0.1 times the filament radius.",
-    )
-    amplitude_dependent_scaling: Optional[bool] = Field(
-        default=False,
-        description="Amplitude dependent scaling uses the field amplitude to approximate the field penetration distance in the filaments to alter the filament mesh. If the field penetration distance is low (i.e. for low field amplitudes) this feature increases mesh density in the region where the field is expected to penetrate, and decreases the mesh resolution in the region where the field does not penetrate.",
-    )
-    field_penetration_depth_scaling_factor: Optional[float] = Field(
-        default=None,
-        description="Scaling factor for the estimate of the field penetration depth, used for amplitude dependent scaling. ",
-    )
-    desired_elements_in_field_penetration_region: Optional[float] = Field(
-        default=None,
-        description="Desired number of elements in the field penetration region. This parameter is used for amplitude dependent scaling, and determines the number of elements in the region where the field is expected to penetrate.",
-    )
-
-# -- Matrix mesh settings -- #
-class CACStrandMeshMatrix(BaseModel):
-    """
-    Level 3: Class for FiQuS ConductorAC
-    """
-
-    mesh_size_matrix_ratio_inner: Optional[float] = Field(
-        default=None,
-        description="Mesh size at the matrix center, relative to the filament radius.",
-    )
-    mesh_size_matrix_ratio_middle: Optional[float] = Field(
-        default=None,
-        description="Mesh size at the matrix middle partition, relative to the filament radius.",
-    )
-    mesh_size_matrix_ratio_outer: Optional[float] = Field(
-        default=None,
-        description="Mesh size at the matrix outer boundary, relative to the filament radius.",
-    )
-    interpolation_distance_from_filaments_ratio: Optional[float] = Field(
-        default=None,
-        description="The mesh size is interpolated from the filament boundaries into the matrix, over a given distance. This parameter determines the distance over which the mesh size is interpolated.",
-    )
-    rate_dependent_scaling_matrix: Optional[bool] = Field(
-        default=False,
-        description="Rate dependent scaling uses the expected skin depth in the matrix to determine the matrix mesh. If the skin depth is low (i.e. for high frequencies) this feature increases mesh density in the region where the current is expected to flow, while decreasing the mesh resolution in the region where the current is not expected to flow.",
-    )
-    skindepth_scaling_factor: Optional[float] = Field(
-        default=None,
-        description="Scaling factor for the estimate of the skin depth, used for rate dependent scaling.",
-    )
-    desired_elements_in_skindepth: Optional[float] = Field(
-        default=None, description="Desired number of elements in the skin depth region. This parameter is used for rate dependent scaling, and determines the number of elements in the region where the current is expected to flow."
-    )
-
-# -- Air mesh settings -- #
-class CACStrandMeshAir(BaseModel):
-    """
-    Level 3: Class for FiQuS ConductorAC
-    """
-
-    max_mesh_size_ratio: Optional[float] = Field(
-        default=None,
-        description="Mesh size at the outer boundary of the air region, relative to the filament radius. E.g. 10 means that the mesh size is 10 times the filament radius.",
-    )
-
-# -- Strand mesh settings -- #
-class CACStrandMesh(BaseModel):
-    """
-    Level 2: Class for FiQuS ConductorAC
-    """
-
-    scaling_global: Optional[float] = Field(
-        default=1, description="Global scaling factor for mesh size."
-    )
-    filaments: CACStrandMeshFilaments = CACStrandMeshFilaments()
-    matrix: CACStrandMeshMatrix = CACStrandMeshMatrix()
-    air: CACStrandMeshAir = CACStrandMeshAir()
-
-
-# ============= SOLVE ============= #
-# -- General parameters -- #
-class CACStrandSolveGeneralparameters(BaseModel):
-    """
-    Level 3: Class for general parameters
-    """
-    temperature: float = Field(default=1.9, description="Temperature (K) of the strand.")
-    superconductor_linear: Optional[bool] = Field(default=False, description="For debugging: replace LTS by normal conductor.")
-
-
-# -- Initial conditions -- #
-class CACStrandSolveInitialconditions(BaseModel):
-    """
-    Level 3: Class for initial conditions
-    """
-
-    init_from_pos_file: bool = Field(
-        default=False, description="This field is used to initialize the solution from a non-zero field solution stored in a .pos file."
-    )
-    pos_file_to_init_from: Optional[str] = Field(
-        default=None,
-        description="Name of .pos file for magnetic field (A/m) from which the solution should be initialized."
-        " Should be in the Geometry_xxx/Mesh_xxx/ folder in which the Solution_xxx will be saved.",
-    )
-
-
-# -- Source parameters -- #
-class CACStrandSolveSourceparametersSineSuperimposedDC(BaseModel):
-    """
-    Level 5: Class for superimposed DC field or current parameters for the sine source
-    """
-    field_magnitude: Optional[float] = Field(default=0.0, description="DC field magnitude (T) (direction along y-axis). Solution must be initialized with a non-zero field solution stored in a .pos file if non-zero DC field is used.")
-    current_magnitude: Optional[float] = Field(default=0.0, description="DC current magnitude (A). Solution must be initialized with a non-zero field solution stored in a .pos file if non-zero DC current is used.")
-
-class CACStrandSolveSourceparametersSine(BaseModel):
-    """
-    Level 4: Class for Sine source parameters
-    """
-    frequency: Optional[float] = Field(default=None, description="Frequency of the sine source (Hz).")
-    field_amplitude: Optional[float] = Field(default=None, description="Amplitude of the sine field (T).")
-    current_amplitude: Optional[float] = Field(default=None, description="Amplitude of the sine current (A).")
-    field_angle: Optional[float] = Field(default=90, description="Angle of the sine field direction, with respect to the x-axis (degrees).")
-    superimposed_DC: CACStrandSolveSourceparametersSineSuperimposedDC = CACStrandSolveSourceparametersSineSuperimposedDC()
-
-class CACStrandSolveSourceparametersPiecewise(BaseModel):
-    """
-    Level 4: Class for piecewise (linear) source parameters
-    """
-    source_csv_file: Optional[str] = Field(default=None, description="File name for the from_file source type defining the time evolution of current and field (in-phase). Multipliers are used for each of them. The file should contain two columns: 'time' (s) and 'value' (field/current (T/A)), with these headers. If this field is set, times, applied_fields_relative and transport_currents_relative are ignored.")
-    times: Optional[List[float]] = Field(default=None, description="Time instants (s) defining the piecewise linear sources. Used only if source_csv_file is not set. Can be scaled by time_multiplier.")
-    applied_fields_relative: Optional[List[float]] = Field(default=None, description="Applied fields relative to multiplier applied_field_multiplier at the time instants 'times'. Used only if source_csv_file is not set.")
-    transport_currents_relative: Optional[List[float]] = Field(default=None, description="Transport currents relative to multiplier transport_current_multiplier at the time instants 'times'. Used only if source_csv_file is not set.")
-    time_multiplier: Optional[float] = Field(default=None, description="Multiplier for the time values in times (scales the time values). Also used for the time values in the source_csv_file.")
-    applied_field_multiplier: Optional[float] = Field(default=None, description="Multiplier for the applied fields in applied_fields_relative. Also used for the values in the source_csv_file.")
-    transport_current_multiplier: Optional[float] = Field(default=None, description="Multiplier for the transport currents in transport_currents_relative. Also used for the values in the source_csv_file.")
-
-class CACStrandSolveSourceparameters(BaseModel):
-    """
-    Level 3: Class for material properties
-    """
-
-    source_type: Literal['sine', 'piecewise'] = Field(
-        default='sine',
-        description="Time evolution of applied current and magnetic field. Supported options are: sine, sine_with_DC, piecewise_linear, from_list.",
-    )
-    boundary_condition_type: str = Field(
-        default="Natural",
-        description="Boundary condition type. Supported options are: Natural, Essential. Do not use essential boundary condition with induced currents.",
-    )
-    sine: CACStrandSolveSourceparametersSine = CACStrandSolveSourceparametersSine()
-    piecewise: CACStrandSolveSourceparametersPiecewise = CACStrandSolveSourceparametersPiecewise()
-
-
-# -- Numerical parameters -- #
-class CACStrandSolveNumericalparametersSine(BaseModel):
-    """ 
-    Level 4: Numerical parameters corresponding to the sine source
-    """
-    timesteps_per_period: Optional[float] = Field(default=None, description="Initial value for number of time steps (-) per period for the sine source. Determines the initial time step size.")
-    number_of_periods_to_simulate: Optional[float] = Field(default=None, description="Number of periods (-) to simulate for the sine source.")
-
-class CACStrandSolveNumericalparametersPiecewise(BaseModel):
-    """
-    Level 4: Numerical parameters corresponding to the piecewise source
-    """
-    time_to_simulate: Optional[float] = Field(default=None, description="Total time to simulate (s). Used for the piecewise source.")
-    timesteps_per_time_to_simulate: Optional[float] = Field(default=None, description="If variable_max_timestep is False. Number of time steps (-) per period for the piecewise source.")
-    force_stepping_at_times_piecewise_linear: bool = Field(default=False, description="If True, time-stepping will contain exactly the time instants that are in the times_source_piecewise_linear list (to avoid truncation maximum applied field/current values).")
-
-    variable_max_timestep: bool = Field(default=False, description="If False, the maximum time step is kept constant through the simulation. If True, it varies according to the piecewise definition.")
-    times_max_timestep_piecewise_linear: Optional[List[float]] = Field(default=None, description="Time instants (s) defining the piecewise linear maximum time step.")
-    max_timestep_piecewise_linear: Optional[List[float]] = Field(default=None, description="Maximum time steps (s) at the times_max_timestep_piecewise_linear. Above the limits, linear extrapolation of the last two values.")
-
-class CACStrandSolveNumericalparameters(BaseModel):
-    """
-    Level 3: Class for numerical parameters
-    """
-
-    sine: CACStrandSolveNumericalparametersSine = CACStrandSolveNumericalparametersSine()
-    piecewise: CACStrandSolveNumericalparametersPiecewise = CACStrandSolveNumericalparametersPiecewise()
-
-
-# -- Formulation parameters -- #
-class CACStrandSolveFormulationparameters(BaseModel):
-    """
-    Level 3: Class for finite element formulation parameters
-    """
-
-    formulation: Literal['voltage_based'] = Field(
-        default='voltage_based',
-        description="Currently, only possible option is voltage_based."
-    )
-    dynamic_correction: Optional[bool] = Field(
-        default=True,
-        description="In the voltage_based case, do we activate the dynamic correction?",
-    )
-    compute_temperature: Optional[bool] = Field(
-        default=False, description="Do we compute the temperature?"
-    )
-
-    two_ell_periodicity : Optional[bool] = Field(
-        default=True, description="True to integrate over twice the shortest periodicity length, False to integrate over the shortest periodicity length. "
-    )
-
-
-class CACStrandSolve(BaseModel):
-    """
-    Level 2: Class for FiQuS ConductorAC Strand solver settings
-    """
-    pro_template: Optional[Literal['ConductorAC_template.pro']] = Field(
-        default='ConductorAC_template.pro',
-        description="Name of the .pro template file."
-    )
-    conductor_name: Optional[str] = Field(
-        default=None, description="Name of the conductor. Must match a conductor name in the conductors section of the input YAML-file."
-    )
-    formulation_parameters: CACStrandSolveFormulationparameters = (
-        CACStrandSolveFormulationparameters()
-    )
-    general_parameters: CACStrandSolveGeneralparameters = (
-        CACStrandSolveGeneralparameters()
-    )
-    # material_properties: CACStrandSolveMaterialproperties = (
-    #     CACStrandSolveMaterialproperties()
-    # )
-    initial_conditions: CACStrandSolveInitialconditions = (
-        CACStrandSolveInitialconditions()
-    )
-    source_parameters: CACStrandSolveSourceparameters = (
-        CACStrandSolveSourceparameters()
-    )
-    numerical_parameters: CACStrandSolveNumericalparameters = (
-        CACStrandSolveNumericalparameters()
-    )
-
-
-# ============= POSTPROC ============= #
-class CACStrandPostprocBatchpostprocLossMapCrossSection(BaseModel):
-    """
-    Level 5: Class with settings for plotting a cross-section of the loss map.
-    """
-    plot_cross_section: bool = Field(
-        default=False, description="Set True to plot a cross-section of the loss map."
-    )
-    save_plot: bool = Field(default=False, description="Set True to save the plot.")
-    filename: str = Field(default="cross_section", description="Name of the plot file.")
-    axis_to_cut: str = Field(
-        default="x", description="Axis to cut for the cross-section."
-    )
-    cut_value: float = Field(
-        default=0, description="Value of the axis to cut for the cross-section."
-    )
-
-    ylabel: str = Field(default="Loss", description="Label of the y-axis.")
-    title: Optional[str] = Field(
-        default=None,
-        description="Title of the plot. The placeholder <<cut_value>> can be used to indicate the value of the cut axis.",
-    )
-
-
-class CACStrandPostprocBatchpostprocLossMapCrossSectionSweep(BaseModel):
-    """
-    Level 5: Class with settings for animating a cross-section sweep of the loss map along one axis.
-    """
-    animate_cross_section_sweep: bool = Field(
-        default=False,
-        description="Set True to animate a cross-section sweep of the loss map along one axis.",
-    )
-    save_plot: bool = Field(
-        default=False, description="Set True to save the animation."
-    )
-    filename: str = Field(
-        default="crossSectionSweep", description="Name of the animation file."
-    )
-    axis_to_sweep: str = Field(
-        default="x", description="Axis to sweep for the animation."
-    )
-    ylabel: str = Field(default="Loss", description="Label of the y-axis.")
-    title: Optional[str] = Field(
-        default=None,
-        description="Title of the plot. Use <<sweep_value>> to indicate the value of the sweep axis.",
-    )
-
-
-class CACStrandPostprocBatchpostprocLossMap(BaseModel):
-    """
-    Level 4: Class with settings for generating loss maps
-    """
-    produce_loss_map: bool = Field(
-        default=False, description="Set True to produce a loss map."
-    )
-    save_plot: bool = Field(default=False, description="Set True to save the plot.")
-    filename: str = Field(default="loss_map", description="Name of the plot file.")
-    x_val: Optional[str] = Field(
-        default=None, description="Parameter to be plotted on the x-axis. This field corresponds to a parameter in the input YAML-file. E.g. 'solve.source_parameters.sine.frequency' will plot the loss map for different frequencies."
-    )
-    y_val: Optional[str] = Field(
-        default=None, description="Parameter to be plotted on the y-axis. This field corresponds to a parameter in the input YAML-file. E.g. 'solve.source_parameters.sine.field_amplitude' will plot the loss map for different applied field amplitudes."
-    )
-    x_steps: int = Field(default=20, description="Number of steps on the x-axis.")
-    y_steps: int = Field(default=20, description="Number of steps on the y-axis.")
-    loss_type: Literal['TotalLoss', 'FilamentLoss', 'CouplingLoss', 'EddyLoss'] = Field(
-        default='TotalLoss',
-        description="Type of loss to be plotted. Supported options are: TotalLoss, FilamentLoss, CouplingLoss, EddyLoss."
-    )
-    x_log: bool = Field(
-        default=True, description="Set True to plot x-axis in log-scale."
-    )
-    y_log: bool = Field(
-        default=True, description="Set True to plot y-axis in log-scale."
-    )
-    loss_log: bool = Field(
-        default=True, description="Set True to plot loss in log-scale."
-    )
-    x_norm: float = Field(default=1, description="Normalization factor for x-axis.")
-    y_norm: float = Field(default=1, description="Normalization factor for y-axis.")
-    loss_norm: float = Field(default=1, description="Normalization factor for the AC-loss.")
-    show_datapoints: bool = Field(
-        default=True, description="Set True to show markers for all the datapoints in the loss map."
-    )
-
-    title: Optional[str] = Field(default=None, description="Title for the plot.")
-    xlabel: Optional[str] = Field(default=None, description="Label for the x-axis.")
-    ylabel: Optional[str] = Field(default=None, description="Label for the y-axis.")
-
-    # lossType_dominance_contour: CACStrandPostprocBatchpostprocLossMapDominanceCountour = (
-    #     CACStrandPostprocBatchpostprocLossMapDominanceCountour()
-    # )
-
-    show_loss_type_dominance_contour: bool = Field(
-        default=False,
-        description="Set True to plot a contour curve separating regions where different loss types dominate. ",
-    )
-
-    cross_section: CACStrandPostprocBatchpostprocLossMapCrossSection = (
-        CACStrandPostprocBatchpostprocLossMapCrossSection()
-    )
-    cross_section_sweep: CACStrandPostprocBatchpostprocLossMapCrossSectionSweep = (
-        CACStrandPostprocBatchpostprocLossMapCrossSectionSweep()
-    )
-
-
-class CACStrandPostprocBatchpostprocPlot2d(BaseModel):
-    """
-    Level 4: Class for 2D plot settings
-    """
-    produce_plot2d: bool = Field(
-        default=False, description="Set True to produce a 2D plot."
-    )
-    combined_plot: bool = Field(
-        default=False,
-        description="Set True to produce a combined plot for all simulations. If False, a separate plot is produced for each simulation.",
-    )
-    save_plot: bool = Field(default=False, description="Set True to save the plot.")
-    filename: str = Field(default="plot2d", description="Name of the plot file.")
-    x_val: Optional[str] = Field(
-        default=None, description="Value to be plotted on the x-axis. Parameters in the input YAML-file and class-variables from the plotter 'SimulationData' class can be accessed trough the notation << . >>. E.g. '<<solve.source_parameters.sine.frequency>>' will create a 2D plot with frequency on the x-axis. '<<time>>' will create a plot with time on the x-axis."
-    )
-    y_vals: Optional[List[str]] = Field(
-        default=None, description=" List of values to be plotted on the y-axis. Parameters in the input YAML-file and class-variables from the plotter 'SimulationData' class can be accessed trough the notation << . >>. E.g. total AC-loss per cycle can be accessed as ['<<total_power_per_cycle['TotalLoss_dyn']>>']."
-    )
-    labels: Optional[List[str]] = Field(
-        default=None,
-        description="List of labels for the plot. Each label corresponding to a value in y_val.",
-    )
-    linestyle: Optional[str] = Field(
-        default=None, description="Linestyle for the plot."
-    )
-
-    title: Optional[str] = Field(default=None, description="Title for the plot.")
-    xlabel: Optional[str] = Field(default=None, description="Label for the x-axis.")
-    ylabel: Optional[str] = Field(default=None, description="Label for the y-axis.")
-    x_log: bool = Field(default=False, description="Set True to plot x-axis in log-scale.")
-    y_log: bool = Field(default=False, description="Set True to plot y-axis in log-scale.")
-    legend: bool = Field(default=True, description="Set True to show legend.")
-
-
-class CACStrandPostprocBatchpostprocFilter(BaseModel):
-    """
-    Level 4: Field for filtering simulations based on simulation parameters for batch post-processing
-    """
-    apply_filter: bool = Field(
-        default=False,
-        description="Set True to filter simulations by parameters from the input YAML-file.",
-    )
-    filter_criterion: Optional[str] = Field(
-        default=None,
-        description="Criterion used to filter simulations based on simulation parameters. For example will '<<solve.source_parameters.sine.frequency>> > 100' disregard simulations done with frequencies lower than 100Hz.",
-    )
-
-
-class CACStrandPostprocBatchpostprocSort(BaseModel):
-    """
-    Level 4: Field for sorting simulations based on simulation parameters for batch post-processing
-    """
-    apply_sort: bool = Field(default=False, description="Set True to sort simulations.")
-    sort_key: Optional[str] = Field(
-        default=None,
-        description="Criterion used to sort simulations based on simulation parameters. For example will 'sd.total_power_per_cycle['TotalLoss'] sort simulations based on the total loss.",
-    )
-
-
-class CACStrandPostprocBatchpostproc(BaseModel):
-    """
-    Level 3: Class for batch post-processing settings
-    """
-    postProc_csv: Optional[str] = Field(
-        default=None,
-        description="Name of the .csv file for post-processing (without file extension). This file specifies the simulations to be post-processed. The file is structured into three columns, specifying the folder names to access the simulation results: 'input.run.geometry', 'input.run.mesh' and 'input.run.solve'. Each row corresponds to a simulation to be post-processed.",
-    )
-    output_folder: Optional[str] = Field(
-        default=None,
-        description="Batch post-processing creates a folder with the given name in the output directory, where all the plots are saved.",
-    )
-    filter: CACStrandPostprocBatchpostprocFilter = CACStrandPostprocBatchpostprocFilter()
-    sort: CACStrandPostprocBatchpostprocSort = CACStrandPostprocBatchpostprocSort()
-    loss_map: CACStrandPostprocBatchpostprocLossMap = CACStrandPostprocBatchpostprocLossMap()
-    plot2d: CACStrandPostprocBatchpostprocPlot2d = CACStrandPostprocBatchpostprocPlot2d()
-
-
-class CACStrandPostprocPlotInstPower(BaseModel):
-    """
-    Level 3: Class with settings for generating plots of instantaneous power
-    """
-    show: bool = Field(default=False, description="Creates a plot for the calculated instantaneous AC loss (W/m) as a function of time (s).")
-    title: str = Field(default="Instantaneous Power", description="Title for the plot.")
-    save: bool = Field(default=False, description="Set True to save the plot.")
-    save_file_name: str = Field(
-        default="instantaneous_power", description="Name of the plot file."
-    )
-
-
-class CACStrandPostprocCleanup(BaseModel):
-    """
-    Level 3: Class for cleanup settings
-    """
-    remove_pre_file: bool = Field(
-        default=False,
-        description="Set True to remove the .pre-file after post-processing, to save disk space.",
-    )
-    remove_res_file: bool = Field(
-        default=False,
-        description="Set True to remove the .res-file after post-processing, to save disk space.",
-    )
-    remove_msh_file: bool = Field(
-        default=False,
-        description="Set True to remove the .msh-file after post-processing, to save disk space.",
-    )
-
-
-class CACStrandPostproc(BaseModel):
-    """
-    Level 2: Class for FiQuS ConductorAC
-    """
-
-    generate_pos_files: bool = Field(
-        default=True,
-        description="Set True to generate .pos-files during post-processing",
-    )
-    plot_instantaneous_power: CACStrandPostprocPlotInstPower = (
-        CACStrandPostprocPlotInstPower()
-    )
-    compute_current_per_filament: bool = Field(
-        default=False,
-        description="Computes current in every filament, with decomposition into magnetization and transport current.",
-    )
-    save_last_current_density: Optional[str] = Field(
-        default=None,
-        description="Saves the last current density field solution (out-of-plane) in the file given as a string."
-        " The '.pos' extension will be appended to it. Nothing is done if None."
-        " This can be for using the current density as an initial condition (but not implemented yet).",
-    )
-    save_last_magnetic_field: Optional[str] = Field(
-        default=None,
-        description="Saves the last magnetic field solution (in-plane) in the file given as a string."
-        " The '.pos' extension will be appended to it. Nothing is done if None."
-        " This is for using the magnetic field as an initial condition for another resolution.",
-    )
-    cleanup: CACStrandPostprocCleanup = CACStrandPostprocCleanup()
-    batch_postproc: CACStrandPostprocBatchpostproc = CACStrandPostprocBatchpostproc()
-
-# ============= BASE ============= #
-class CACStrand(BaseModel):
-    """
-    Level 1: Class for FiQuS ConductorAC
-    """
-
-    type: Literal["CACStrand"]
-    geometry: CACStrandGeometry = CACStrandGeometry()
-    mesh: CACStrandMesh = CACStrandMesh()
-    solve: CACStrandSolve = CACStrandSolve()
-    postproc: CACStrandPostproc = CACStrandPostproc()
-    
+from pydantic import BaseModel, Field, field_validator
+from typing import List, Literal, Optional, Union
+
+
+# ============= GEOMETRY ============= #
+# -- Input/Output settings -- #
+class CACStrandIOsettingsLoad(BaseModel):
+    """
+    Level 3: Class for Input/Output settings for the cable geometry
+    """
+
+    load_from_yaml: Optional[bool] = Field(
+        default=False,
+        description="True to load the geometry from a YAML file, false to generate the geometry.",
+    )
+    filename: Optional[str] = Field(
+        default=None,
+        description="Name of the YAML file from which to load the geometry.",
+    )
+
+class CACStrandIOsettingsSave(BaseModel):
+    """
+    Level 3: Class for Input/Output settings for the cable geometry
+    """
+
+    save_to_yaml: Optional[bool] = Field(
+        default=False,
+        description="True to save the geometry to a YAML-file, false to not save the geometry.",
+    )
+    filename: Optional[str] = Field(
+        default=None,
+        description="Name of the output geometry YAML file.",
+    )
+
+class CACStrandGeometryIOsettings(BaseModel):
+    """
+    Level 2: Class for Input/Output settings for the cable geometry
+    """
+
+    load: CACStrandIOsettingsLoad = (
+        CACStrandIOsettingsLoad()
+    )
+    save: CACStrandIOsettingsSave = (
+        CACStrandIOsettingsSave()
+    )
+
+# -- Strand geometry parameters -- #
+class CACStrandGeometry(BaseModel):
+    """
+    Level 2: Class for strand geometry parameters
+    """
+    io_settings: CACStrandGeometryIOsettings = CACStrandGeometryIOsettings()
+    hexagonal_filaments: Optional[bool] = Field(
+        default=None,
+        description="Field for specifying the shape of the filaments. True for hexagonal, False for circular.",
+    )
+    hexagonal_holes: Optional[bool] = Field(
+        default=None,
+        description="Field for specifying the shape of the filament holes. True for hexagonal, False for circular.",
+    )
+    filament_circular_distribution: Optional[bool] = Field(
+        default=None,
+        description="Field for specifying the geometrical distribution of the filaments. Set True to distribute the filaments in a circular pattern and False to distribute them in a hexagonal pattern."
+    )
+    air_radius: Optional[float] = Field(
+        default=None, description="Radius of the circular numerical air region (m)."
+    )
+    type: Literal['strand_only', 'periodic_square', 'coil'] = Field(
+        default='strand_only', 
+        description="Type of model geometry which will be generated. Supported options are: strand_only, periodic_square"
+                    "strand_only models the strand in an circular air domain (natural boundary condition)"
+                    "periodic_square models the strand in an square air domain (periodic boundary condition)"
+                    "coil models a single coil winding in open space (uses hybrid boundary conditions)"
+    )
+    coil_radius: Optional[float] = Field(
+        default=None, description="used in geometry type 'coil' to determine the distance from strand center to mirroring plane (m). Should always be bigger than strand radius." 
+    )
+    rotate_angle: Optional[float] = Field(
+        default=None, description="Rotates strand geometry by specified angle in deg counterclockwise around the z axis and x=0 and y=0"
+    )
+# ============= MESH ============= #
+# -- Filament mesh settings -- #
+class CACStrandMeshFilaments(BaseModel):
+    """
+    Level 3: Class for FiQuS ConductorAC
+    """
+
+    boundary_mesh_size_ratio: Optional[float] = Field(
+        default=None,
+        description="Mesh size at filament boundaries, relative to the radius of the filaments. E.g. 0.1 means that the mesh size is 0.1 times the filament radius.",
+    )
+    center_mesh_size_ratio: Optional[float] = Field(
+        default=None,
+        description="Mesh size at filament center, relative to the radius of the filaments. E.g. 0.1 means that the mesh size is 0.1 times the filament radius.",
+    )
+    amplitude_dependent_scaling: Optional[bool] = Field(
+        default=False,
+        description="Amplitude dependent scaling uses the field amplitude to approximate the field penetration distance in the filaments to alter the filament mesh. If the field penetration distance is low (i.e. for low field amplitudes) this feature increases mesh density in the region where the field is expected to penetrate, and decreases the mesh resolution in the region where the field does not penetrate.",
+    )
+    field_penetration_depth_scaling_factor: Optional[float] = Field(
+        default=None,
+        description="Scaling factor for the estimate of the field penetration depth, used for amplitude dependent scaling. ",
+    )
+    desired_elements_in_field_penetration_region: Optional[float] = Field(
+        default=None,
+        description="Desired number of elements in the field penetration region. This parameter is used for amplitude dependent scaling, and determines the number of elements in the region where the field is expected to penetrate.",
+    )
+
+# -- Matrix mesh settings -- #
+class CACStrandMeshMatrix(BaseModel):
+    """
+    Level 3: Class for FiQuS ConductorAC
+    """
+
+    mesh_size_matrix_ratio_inner: Optional[float] = Field(
+        default=None,
+        description="Mesh size at the matrix center, relative to the filament radius.",
+    )
+    mesh_size_matrix_ratio_middle: Optional[float] = Field(
+        default=None,
+        description="Mesh size at the matrix middle partition, relative to the filament radius.",
+    )
+    mesh_size_matrix_ratio_outer: Optional[float] = Field(
+        default=None,
+        description="Mesh size at the matrix outer boundary, relative to the filament radius.",
+    )
+    interpolation_distance_from_filaments_ratio: Optional[float] = Field(
+        default=None,
+        description="The mesh size is interpolated from the filament boundaries into the matrix, over a given distance. This parameter determines the distance over which the mesh size is interpolated.",
+    )
+    rate_dependent_scaling_matrix: Optional[bool] = Field(
+        default=False,
+        description="Rate dependent scaling uses the expected skin depth in the matrix to determine the matrix mesh. If the skin depth is low (i.e. for high frequencies) this feature increases mesh density in the region where the current is expected to flow, while decreasing the mesh resolution in the region where the current is not expected to flow.",
+    )
+    skindepth_scaling_factor: Optional[float] = Field(
+        default=None,
+        description="Scaling factor for the estimate of the skin depth, used for rate dependent scaling.",
+    )
+    desired_elements_in_skindepth: Optional[float] = Field(
+        default=None, description="Desired number of elements in the skin depth region. This parameter is used for rate dependent scaling, and determines the number of elements in the region where the current is expected to flow."
+    )
+    force_center_symmetry: Optional[bool] = Field(
+        default=False, description="This option can be set in strands without center filament to enforce a cross of symmetric nodes in the center of the strand mesh - used within Glock thesis."
+    )
+
+# -- Air mesh settings -- #
+class CACStrandMeshAir(BaseModel):
+    """
+    Level 3: Class for FiQuS ConductorAC
+    """
+
+    max_mesh_size_ratio: Optional[float] = Field(
+        default=None,
+        description="Mesh size at the outer boundary of the air region, relative to the filament radius. E.g. 10 means that the mesh size is 10 times the filament radius.",
+    )
+
+# -- Strand mesh settings -- #
+class CACStrandMesh(BaseModel):
+    """
+    Level 2: Class for FiQuS ConductorAC
+    """
+
+    scaling_global: Optional[float] = Field(
+        default=1, description="Global scaling factor for mesh size."
+    )
+    filaments: CACStrandMeshFilaments = CACStrandMeshFilaments()
+    matrix: CACStrandMeshMatrix = CACStrandMeshMatrix()
+    air: CACStrandMeshAir = CACStrandMeshAir()
+
+
+# ============= SOLVE ============= #
+# -- General parameters -- #
+class CACStrandSolveGeneralparameters(BaseModel):
+    """
+    Level 3: Class for general parameters
+    """
+    temperature: float = Field(default=1.9, description="Temperature (K) of the strand.")
+    superconductor_linear: Optional[bool] = Field(default=False, description="For debugging: replace LTS by normal conductor.")
+
+    noOfMPITasks: Optional[Union[bool, int]] = Field(
+        default=False,
+        title="No. of tasks for MPI parallel run of GetDP",
+        description=(
+            "If integer, GetDP will be run in parallel using MPI. This is only valid"
+            " if MPI is installed on the system and an MPI-enabled GetDP is used." 
+            " If False, GetDP will be run in serial without invoking mpiexec."
+        ),
+    )
+
+# -- Initial conditions -- #
+class CACStrandSolveInitialconditions(BaseModel):
+    """
+    Level 3: Class for initial conditions
+    """
+
+    init_type: Optional[Literal['virgin', 'pos_file', 'uniform_field']] = Field(
+        default='virgin', 
+        description="Type of initialization for the simulation. (i) 'virgin' is the default type, the initial magnetic field is zero,"
+        " (ii) 'pos_file' is to initialize from the solution of another solution, given by the solution_to_init_from entry,"
+        " and (iii) 'uniform_field' is to initialize at a uniform field, which will be the applied field at the initial time of the simulation."
+        " Note that the uniform_field option does not allow any non-zero transport current."
+    )
+    solution_to_init_from: Optional[Union[int, str]] = Field(
+        default=None,
+        description="Name xxx of the solution from which the simulation should be initialized. The file last_magnetic_field.pos of folder Solution_xxx will be used for the initial solution."
+        " It must be in the Geometry_xxx/Mesh_xxx/ folder in which the Solution_xxx will be saved.",
+    )
+
+
+# -- Source parameters -- #
+class CACStrandSolveSourceparametersSineSuperimposedDC(BaseModel):
+    """
+    Level 5: Class for superimposed DC field or current parameters for the sine source
+    """
+    field_magnitude: Optional[float] = Field(default=0.0, description="DC field magnitude (T), in the same direction as the AC applied field. Solution must be initialized with a non-zero field solution, either stored in a .pos file, or a uniform field, if non-zero DC field is used.")
+    current_magnitude: Optional[float] = Field(default=0.0, description="DC current magnitude (A). Solution must be initialized with a non-zero field solution stored in a .pos file if non-zero DC current is used.")
+
+class CACStrandSolveSourceparametersSine(BaseModel):
+    """
+    Level 4: Class for Sine source parameters
+    """
+    frequency: Optional[float] = Field(default=None, description="Frequency of the sine source (Hz).")
+    field_amplitude: Optional[float] = Field(default=None, description="Amplitude of the sine field (T).")
+    current_amplitude: Optional[float] = Field(default=None, description="Amplitude of the sine current (A).")
+    superimposed_DC: CACStrandSolveSourceparametersSineSuperimposedDC = CACStrandSolveSourceparametersSineSuperimposedDC()
+
+class CACStrandSolveSourceparametersRotating(BaseModel):
+    """
+    Level 4: Class for Rotating magnetic source field parameters
+    """
+    frequency: Optional[float] = Field(default=None, description="Frequency of field rotation around z-axis")
+    field_magnitude: Optional[float] = Field(default=None, description="constant Magnitude of the rotating field (T).")
+
+
+class CACStrandSolveSourceparametersPiecewise(BaseModel):
+    """
+    Level 4: Class for piecewise (linear) source parameters
+    """
+    source_csv_file: Optional[str] = Field(default=None, description="File name for the from_file source type defining the time evolution of current and field (in-phase)."
+    " Multipliers are used for each of them. The file should contain two columns: 'time' (s) and 'value' (field/current (T/A)), with these headers."
+    " If this field is set, times, applied_fields_relative and transport_currents_relative are ignored.")
+    times: Optional[List[float]] = Field(default=None, description="Time instants (s) defining the piecewise linear sources. Used only if source_csv_file is not set. Can be scaled by time_multiplier.")
+    applied_fields_relative: Optional[List[float]] = Field(default=None, description="Applied fields relative to multiplier applied_field_multiplier at the time instants 'times'. Used only if source_csv_file is not set.")
+    transport_currents_relative: Optional[List[float]] = Field(default=None, description="Transport currents relative to multiplier transport_current_multiplier at the time instants 'times'. Used only if source_csv_file is not set.")
+    time_multiplier: Optional[float] = Field(default=None, description="Multiplier for the time values in times (scales the time values). Also used for the time values in the source_csv_file.")
+    applied_field_multiplier: Optional[float] = Field(default=None, description="Multiplier for the applied fields in applied_fields_relative. Also used for the values in the source_csv_file.")
+    transport_current_multiplier: Optional[float] = Field(default=None, description="Multiplier for the transport currents in transport_currents_relative. Also used for the values in the source_csv_file.")
+
+class CACStrandSolveSourceparameters(BaseModel):
+    """
+    Level 3: Class for material properties
+    """
+
+    source_type: Literal['sine', 'piecewise', 'rotating'] = Field(
+        default='sine',
+        description="Time evolution of applied current and magnetic field. Supported options are: sine, sine_with_DC, piecewise_linear, from_list, rotating.",
+    )
+    sine: CACStrandSolveSourceparametersSine = CACStrandSolveSourceparametersSine()
+    piecewise: CACStrandSolveSourceparametersPiecewise = CACStrandSolveSourceparametersPiecewise()
+    rotating: CACStrandSolveSourceparametersRotating = CACStrandSolveSourceparametersRotating()
+    field_angle: Optional[float] = Field(default=90, description="Angle of the source magnetic field, with respect to the x-axis (degrees).")
+
+
+# -- Numerical parameters -- #
+class CACStrandSolveNumericalparametersSine(BaseModel):
+    """ 
+    Level 4: Numerical parameters corresponding to the sine source
+    """
+    timesteps_per_period: Optional[float] = Field(default=None, description="Initial value for number of time steps (-) per period for the sine source. Determines the initial time step size.")
+    number_of_periods_to_simulate: Optional[float] = Field(default=None, description="Number of periods (-) to simulate for the sine source.")
+
+class CACStrandSolveNumericalparametersRotating(BaseModel):
+    """ 
+    Level 4: Numerical parameters corresponding to the sine source
+    """
+    timesteps_per_period: Optional[float] = Field(default=None, description="Initial value for number of time steps (-) per period for source rotation. Determines the initial time step size.")
+    number_of_periods_to_simulate: Optional[float] = Field(default=None, description="Number of periods (-) to simulate for the source rotation.")
+
+class CACStrandSolveNumericalparametersPiecewise(BaseModel):
+    """
+    Level 4: Numerical parameters corresponding to the piecewise source
+    """
+    time_to_simulate: Optional[float] = Field(default=None, description="Total time to simulate (s). Used for the piecewise source.")
+    timesteps_per_time_to_simulate: Optional[float] = Field(default=None, description="If variable_max_timestep is False. Number of time steps (-) per period for the piecewise source.")
+    force_stepping_at_times_piecewise_linear: bool = Field(default=False, description="If True, time-stepping will contain exactly the time instants that are in the times_source_piecewise_linear list (to avoid truncation maximum applied field/current values).")
+
+    variable_max_timestep: bool = Field(default=False, description="If False, the maximum time step is kept constant through the simulation. If True, it varies according to the piecewise definition.")
+    times_max_timestep_piecewise_linear: Optional[List[float]] = Field(default=None, description="Time instants (s) defining the piecewise linear maximum time step.")
+    max_timestep_piecewise_linear: Optional[List[float]] = Field(default=None, description="Maximum time steps (s) at the times_max_timestep_piecewise_linear. Above the limits, linear extrapolation of the last two values.")
+
+class CACStrandSolveNumericalparameters(BaseModel):
+    """
+    Level 3: Class for numerical parameters
+    """
+    sine: CACStrandSolveNumericalparametersSine = CACStrandSolveNumericalparametersSine()
+    piecewise: CACStrandSolveNumericalparametersPiecewise = CACStrandSolveNumericalparametersPiecewise()
+    rotating: CACStrandSolveNumericalparametersRotating = CACStrandSolveNumericalparametersRotating()
+
+
+# -- Formulation parameters -- #
+class CACStrandSolveFormulationparameters(BaseModel):
+    """
+    Level 3: Class for finite element formulation parameters
+    """
+    formulation: Literal['CATI', 'AI_uncoupled'] = Field(
+        default='CATI',
+        description="Which formulation? CATI is the default and usual choice (was named voltage_based before -> to be changed from now on) to model hysteresis/coupling/eddy currents with the CATI method."
+        " AI_uncoupled is a conventional 2D formulation with axial currents modelling UNCOUPLED filaments (and eddy currents in matrix)."
+    )
+    dynamic_correction: Optional[bool] = Field(
+        default=True,
+        description="With the CATI method, do we activate the dynamic correction?",
+    )
+    compute_temperature: Optional[bool] = Field(
+        default=False, description="Do we compute the temperature?"
+    )
+    two_ell_periodicity : Optional[bool] = Field(
+        default=True, description="With CATI method: True to integrate over twice the shortest periodicity length (recommended), False to integrate over the shortest periodicity length (not recommended)."
+    )
+
+class CACStrandSolveDiffusionBarriers(BaseModel):
+    enable: Optional[bool] = Field(
+        default=False, description="Set True to enable diffusion barriers."
+    )
+
+    load_data_from_yaml: Optional[bool] = Field(
+        default=False, description="Set True to load the diffusion barrier data from the input YAML-file. Otherwise, the thickness and resistivity specified in this file are used."
+    )
+
+    resistivity: Optional[float] = Field(
+        default=1e-6, description="Resistivity of the diffusion barriers (Ohm*m)."
+    )
+    thickness: Optional[float] = Field(
+        default=1e-6, description="Thickness of the diffusion barriers (m)."
+    )
+
+class CACStrandSolve(BaseModel):
+    """
+    Level 2: Class for FiQuS ConductorAC Strand solver settings
+    """
+    pro_template: Optional[Literal['ConductorAC_template.pro']] = Field(
+        default='ConductorAC_template.pro',
+        description="Name of the .pro template file."
+    )
+    conductor_name: Optional[str] = Field(
+        default=None, description="Name of the conductor. Must match a conductor name in the conductors section of the input YAML-file."
+    )
+    formulation_parameters: CACStrandSolveFormulationparameters = (
+        CACStrandSolveFormulationparameters()
+    )
+    general_parameters: CACStrandSolveGeneralparameters = (
+        CACStrandSolveGeneralparameters()
+    )
+    initial_conditions: CACStrandSolveInitialconditions = (
+        CACStrandSolveInitialconditions()
+    )
+    diffusion_barriers: CACStrandSolveDiffusionBarriers = (
+        CACStrandSolveDiffusionBarriers()
+    )
+    global_diffusion_barrier: CACStrandSolveDiffusionBarriers = Field(
+            default=CACStrandSolveDiffusionBarriers(), description="Additional diffusion barrier around all filaments together (global)."
+                                                                   "This is created on a line between two strand matrix regions."
+                                                                   "One around the filaments and the other for the external ring."
+    )
+    source_parameters: CACStrandSolveSourceparameters = (
+        CACStrandSolveSourceparameters()
+    )
+    numerical_parameters: CACStrandSolveNumericalparameters = (
+        CACStrandSolveNumericalparameters()
+    )
+
+
+# ============= POSTPROC ============= #
+class CACStrandPostprocBatchpostprocLossMapCrossSection(BaseModel):
+    """
+    Level 5: Class with settings for plotting a cross-section of the loss map.
+    """
+    plot_cross_section: bool = Field(
+        default=False, description="Set True to plot a cross-section of the loss map."
+    )
+    save_plot: bool = Field(default=False, description="Set True to save the plot.")
+    filename: str = Field(default="cross_section", description="Name of the plot file.")
+    axis_to_cut: str = Field(
+        default="x", description="Axis to cut for the cross-section."
+    )
+    cut_value: float = Field(
+        default=0, description="Value of the axis to cut for the cross-section."
+    )
+
+    ylabel: str = Field(default="Loss", description="Label of the y-axis.")
+    title: Optional[str] = Field(
+        default=None,
+        description="Title of the plot. The placeholder <<cut_value>> can be used to indicate the value of the cut axis.",
+    )
+
+
+class CACStrandPostprocBatchpostprocLossMapCrossSectionSweep(BaseModel):
+    """
+    Level 5: Class with settings for animating a cross-section sweep of the loss map along one axis.
+    """
+    animate_cross_section_sweep: bool = Field(
+        default=False,
+        description="Set True to animate a cross-section sweep of the loss map along one axis.",
+    )
+    save_plot: bool = Field(
+        default=False, description="Set True to save the animation."
+    )
+    filename: str = Field(
+        default="crossSectionSweep", description="Name of the animation file."
+    )
+    axis_to_sweep: str = Field(
+        default="x", description="Axis to sweep for the animation."
+    )
+    ylabel: str = Field(default="Loss", description="Label of the y-axis.")
+    title: Optional[str] = Field(
+        default=None,
+        description="Title of the plot. Use <<sweep_value>> to indicate the value of the sweep axis.",
+    )
+
+class CACStrandPostprocBatchpostprocROHFgrid(BaseModel):
+    """
+    Level 4: Class with settings to perform actions on a ROHF model based on a grid of simulations.
+    """    
+    produce_error_map: bool = Field(
+        default=False, description="Set True to produce a error map of the definced error_type. If the fit_rohf option is enabled it will compute the map for the new ROHF model ignoring everything in the fluxmodel.csv."
+    )
+    interpolate_error_map: bool = Field(default=False, description="Interpolate colormap linear between the computed values (graphical purposes)")
+    error_type: str = Field(default="pc_loss", description="realtive error metric displayed by the map. Options: pc_loss, flux, dyn_loss")
+
+    fit_rohf: bool = Field(default=False, description="Fit a ROHF model on the simulation grid given in the simulation.csv")
+    fit_rohf_N: Optional[int] = Field(
+        default=7,
+        description="Number of ROHF cells to use for the fit. Default is 7.",
+    )
+    fit_rohf_tausweep_IIC: Optional[float] = Field(
+        default=1.0,
+        description="I/Ic ratio used to fit the ratedependence parameters (taus)."
+    )
+
+class CACStrandPostprocBatchpostprocLossMap(BaseModel):
+    """
+    Level 4: Class with settings for generating loss maps
+    """
+    produce_loss_map: bool = Field(
+        default=False, description="Set True to produce a loss map."
+    )
+    save_plot: bool = Field(default=False, description="Set True to save the plot.")
+    filename: str = Field(default="loss_map", description="Name of the plot file.")
+    x_val: Optional[str] = Field(
+        default=None, description="Parameter to be plotted on the x-axis. This field corresponds to a parameter in the input YAML-file. E.g. 'solve.source_parameters.sine.frequency' will plot the loss map for different frequencies."
+    )
+    y_val: Optional[str] = Field(
+        default=None, description="Parameter to be plotted on the y-axis. This field corresponds to a parameter in the input YAML-file. E.g. 'solve.source_parameters.sine.field_amplitude' will plot the loss map for different applied field amplitudes."
+    )
+    x_steps: int = Field(default=20, description="Number of steps on the x-axis.")
+    y_steps: int = Field(default=20, description="Number of steps on the y-axis.")
+    loss_type: Literal['TotalLoss', 'FilamentLoss', 'CouplingLoss', 'EddyLoss'] = Field(
+        default='TotalLoss',
+        description="Type of loss to be plotted. Supported options are: TotalLoss, FilamentLoss, CouplingLoss, EddyLoss."
+    )
+    x_log: bool = Field(
+        default=True, description="Set True to plot x-axis in log-scale."
+    )
+    y_log: bool = Field(
+        default=True, description="Set True to plot y-axis in log-scale."
+    )
+    loss_log: bool = Field(
+        default=True, description="Set True to plot loss in log-scale."
+    )
+    x_norm: float = Field(default=1, description="Normalization factor for x-axis.")
+    y_norm: float = Field(default=1, description="Normalization factor for y-axis.")
+    loss_norm: float = Field(default=1, description="Normalization factor for the AC-loss.")
+    show_datapoints: bool = Field(
+        default=True, description="Set True to show markers for all the datapoints in the loss map."
+    )
+
+    title: Optional[str] = Field(default=None, description="Title for the plot.")
+    xlabel: Optional[str] = Field(default=None, description="Label for the x-axis.")
+    ylabel: Optional[str] = Field(default=None, description="Label for the y-axis.")
+
+    # lossType_dominance_contour: CACStrandPostprocBatchpostprocLossMapDominanceCountour = (
+    #     CACStrandPostprocBatchpostprocLossMapDominanceCountour()
+    # )
+
+    show_loss_type_dominance_contour: bool = Field(
+        default=False,
+        description="Set True to plot a contour curve separating regions where different loss types dominate. ",
+    )
+
+    cross_section: CACStrandPostprocBatchpostprocLossMapCrossSection = (
+        CACStrandPostprocBatchpostprocLossMapCrossSection()
+    )
+    cross_section_sweep: CACStrandPostprocBatchpostprocLossMapCrossSectionSweep = (
+        CACStrandPostprocBatchpostprocLossMapCrossSectionSweep()
+    )
+
+
+class CACStrandPostprocBatchpostprocPlot2d(BaseModel):
+    """
+    Level 4: Class for 2D plot settings
+    """
+    produce_plot2d: bool = Field(
+        default=False, description="Set True to produce a 2D plot."
+    )
+    combined_plot: bool = Field(
+        default=False,
+        description="Set True to produce a combined plot for all simulations. If False, a separate plot is produced for each simulation.",
+    )
+    save_pgfdata: bool = Field(
+        default=False,
+        description="Set True to export the plot data in pgfplot readable .txt format stored in output_folder. Currently only supports combined plots.",
+    )
+    save_plot: bool = Field(default=False, description="Set True to save the plot.")
+    filename: str = Field(default="plot2d", description="Name of the plot file.")
+    x_val: Optional[str] = Field(
+        default=None, description="Value to be plotted on the x-axis. Parameters in the input YAML-file and class-variables from the plotter 'SimulationData' class can be accessed trough dot notation 'simulation.' E.g. 'simulation.f' will create a 2D plot with sine source frequency on the x-axis. 'simulation.time' will create a plot with time on the x-axis."
+    )
+    y_vals: Optional[List[str]] = Field(
+        default=None, description=" List of values to be plotted on the y-axis. Parameters in the input YAML-file and class-variables from the plotter 'SimulationData' class can be accessed trough dot notation 'simulation.' E.g. total AC-loss per cycle can be accessed as ['simulation.total_power_per_cycle['TotalLoss_dyn']']."
+    )
+    y_val_fluxmodel: Optional[str] = Field(
+        default=None, description=" Attribute of the 'ROHFmodel' class which is plotted on the y-axis. Access via dot notation with 'fluxmodel.' and 'simulation.' E.g. ROHF computed flux - 'fluxmodel.compute(I=simulation.I_transport,time=simulation.time)[0]'"
+    )
+    reference_vals: Optional[List[str]] = Field(default=None, description="reference values as set of two list [xvals, yvals] which will be plotted in the combined plot (For reference curves)")
+    reference_label: Optional[str] = Field(default=None, description="label text for the reference data in the plot legend")
+    labels: Optional[List[str]] = Field(
+        default=None,
+        description="List of labels for the plot. Each label corresponding to a value in y_val.",
+    )
+    linestyle: Optional[str] = Field(
+        default=None, description="Linestyle for the plot."
+    )
+
+    title: Optional[str] = Field(default=None, description="Title for the plot.")
+    xlabel: Optional[str] = Field(default=None, description="Label for the x-axis.")
+    ylabel: Optional[str] = Field(default=None, description="Label for the y-axis.")
+    x_log: bool = Field(default=False, description="Set True to plot x-axis in log-scale.")
+    y_log: bool = Field(default=False, description="Set True to plot y-axis in log-scale.")
+    legend: bool = Field(default=True, description="Set True to show legend.")
+
+
+class CACStrandPostprocBatchpostprocFilter(BaseModel):
+    """
+    Level 4: Field for filtering simulations based on simulation parameters for batch post-processing
+    """
+    apply_filter: bool = Field(
+        default=False,
+        description="Set True to filter simulations by parameters from the input YAML-file.",
+    )
+    filter_criterion: Optional[str] = Field(
+        default=None,
+        description="Criterion used to filter simulations based on simulation parameters. For example will '<<solve.source_parameters.sine.frequency>> > 100' disregard simulations done with frequencies lower than 100Hz.",
+    )
+
+
+class CACStrandPostprocBatchpostprocSort(BaseModel):
+    """
+    Level 4: Field for sorting simulations based on simulation parameters for batch post-processing
+    """
+    apply_sort: bool = Field(default=False, description="Set True to sort simulations.")
+    sort_key: Optional[str] = Field(
+        default=None,
+        description="Criterion used to sort simulations based on simulation parameters. For example will 'sd.total_power_per_cycle['TotalLoss'] sort simulations based on the total loss.",
+    )
+
+
+class CACStrandPostprocBatchpostproc(BaseModel):
+    """
+    Level 3: Class for batch post-processing settings
+    """
+    simulations_csv: Optional[str] = Field(
+        default=None,
+        description="Name of the .csv file for post-processing (without file extension). This file specifies the simulations to be post-processed. The file is structured into three columns, specifying the folder names to access the simulation results: 'input.run.geometry', 'input.run.mesh' and 'input.run.solve'. Each row corresponds to a simulation to be post-processed.",
+    )
+    fluxmodels_csv: Optional[str] = Field(
+        default=None,
+        description="Name of the .csv file for post-processing (without file extension). This file specifies the fluxmodels to be post-processed. The file is structured into three columns, specifying the folder names to access the simulation results: 'input.run.geometry', 'input.run.mesh' and 'input.run.solve'. Each row corresponds to a simulation to be post-processed.",
+    )
+    filter: CACStrandPostprocBatchpostprocFilter = CACStrandPostprocBatchpostprocFilter()
+    sort: CACStrandPostprocBatchpostprocSort = CACStrandPostprocBatchpostprocSort()
+    loss_map: CACStrandPostprocBatchpostprocLossMap = CACStrandPostprocBatchpostprocLossMap()
+    rohf_on_grid: CACStrandPostprocBatchpostprocROHFgrid = CACStrandPostprocBatchpostprocROHFgrid()
+    plot2d: CACStrandPostprocBatchpostprocPlot2d = CACStrandPostprocBatchpostprocPlot2d()
+
+class CACStrandPostprocPlotFlux(BaseModel):
+    """
+    Level 3: Class with settings flux related plots and the related - reduced order hysteretic flux (ROHF) model.
+    The ROHF model can either be initialized from a predefined parameter file or freshly fitted on the solution with a given number_of_cells and kappa_spacing_type (will not be rate dependent).
+    """
+    show: Optional[bool] = Field(
+        default=False,
+        description="Enable flux related plots.",
+    ) 
+    rohf: Optional[bool] = Field(
+        default=False,
+        description="Enable ROHF model.",
+    ) 
+
+    rohf_file: Optional[str] = Field(
+        default=None,
+        description="Name of a .txt file in the geometry folder containing tau, kappa and alpha values. The file has to be structured into three columns (separated by whitespaces) with the preliminary header-row 'taus kappas alphas'. Each row corresponds to one cell of the multicell ROHF model.",
+    )
+    rohf_N: Optional[int] = Field(
+        default=None,
+        description="Total number of cells (N) for the ROHF model. If a parameter_file_name is given this option will be disregarded in favour of the parameterfile definitions.",
+    )
+    rohf_kappa_spacing: Optional[str] = Field(
+        default=None,
+        description="Spacing strategy for the N kappa values of the ROHF model. Options: 'linear', 'log', 'invlog' if left blank it will set the kappa interval based on a error minimization. If a parameter_file_name is given this option will be disregarded in favour of the parameterfile definitions.",
+    )
+
+
+class CACStrandPostprocPlotInstPower(BaseModel):
+    """
+    Level 3: Class with settings for generating plots of instantaneous power
+    """
+    show: bool = Field(default=False, description="Creates a plot for the calculated instantaneous AC loss (W/m) as a function of time (s).")
+    title: str = Field(default="Instantaneous Power", description="Title for the plot.")
+    save: bool = Field(default=False, description="Set True to save the plot.")
+    save_file_name: str = Field(
+        default="instantaneous_power", description="Name of the plot file."
+    )
+
+
+class CACStrandPostprocCleanup(BaseModel):
+    """
+    Level 3: Class for cleanup settings
+    """
+    remove_pre_file: bool = Field(
+        default=False,
+        description="Set True to remove the .pre-file after post-processing, to save disk space.",
+    )
+    remove_res_file: bool = Field(
+        default=False,
+        description="Set True to remove the .res-file after post-processing, to save disk space.",
+    )
+    remove_msh_file: bool = Field(
+        default=False,
+        description="Set True to remove the .msh-file after post-processing, to save disk space.",
+    )
+
+class CACStrandPostprocPosFiles(BaseModel):
+    """
+    Level 3: Class for cleanup settings
+    """
+    quantities: Optional[List[str]] = Field(
+        default=None, description="List of GetDP postprocessing quantity to write to .pos file. Examples of valid entry is: phi, h, b, b_reaction, j, jz, jc, power_filaments, power_matrix, sigma_matrix, j_plane, v_plane, hsVal"
+    )
+    regions: Optional[List[str]] = Field(
+        default=None, description="List of GetDP region to to write to .pos file postprocessing for. Examples of valid entry is: Matrix, Filaments, Omega (full domain), OmegaC (conducting domain), OmegaCC (non conducting domain)"
+    )
+
+    @field_validator("quantities", 'regions', mode="before")
+    @classmethod
+    def convert_none_to_empty_list(cls, v):
+        pass
+        if v is None:
+            return []   # if None default to empty list. Jinja relies on list for looping in the pro template. The default is not a list to be consistent with SDK entries.
+        return v
+
+    model_config = {
+        "validate_default": True
+    }
+
+class CACStrandPostproc(BaseModel):
+    """
+    Level 2: Class for FiQuS ConductorAC
+    """
+    pos_files: CACStrandPostprocPosFiles = Field(
+        default=CACStrandPostprocPosFiles(),
+        description="Entries controlling output of .pos files. If None or empty lists are given, no .pos files are written. Note that not all combinations of quantities and regions make sense.",
+    )
+    compute_current_per_filament: bool = Field(
+        default=False,
+        description="Computes current in every filament, with decomposition into magnetization and transport current.",
+    )
+    output_folder: Optional[str] = Field(
+        default='Results',
+        description="Batch post-processing creates a folder with the given name in the output directory, where all the plots are saved.",
+    )
+    generate_report: Optional[bool] = Field(
+        default=False,
+        description="Generates a PDF report including all postprocessing graphs. File is saved in the output_folder."
+    )
+    cleanup: CACStrandPostprocCleanup = CACStrandPostprocCleanup()
+    plot_flux: CACStrandPostprocPlotFlux = CACStrandPostprocPlotFlux()
+    plot_instantaneous_power: CACStrandPostprocPlotInstPower = CACStrandPostprocPlotInstPower()
+    batch_postproc: CACStrandPostprocBatchpostproc = CACStrandPostprocBatchpostproc()
+
+# ============= BASE ============= #
+class CACStrand(BaseModel):
+    """
+    Level 1: Class for FiQuS ConductorAC
+    """
+
+    type: Literal["CACStrand"]
+    geometry: CACStrandGeometry = CACStrandGeometry()
+    mesh: CACStrandMesh = CACStrandMesh()
+    solve: CACStrandSolve = CACStrandSolve()
+    postproc: CACStrandPostproc = CACStrandPostproc()
+