Warning, /AID2E-framework/examples/configurations/README.md is written in an unsupported language. File is not indexed.
0001 # Example Configuration Files
0002
0003 This directory contains example configuration files for the AID2E framework.
0004
0005 ## Available Examples
0006
0007 ### 1. DTLZ2 Toy Problem (`dtlz2_optimization.yml`)
0008 A basic multi-objective optimization of the DTLZ2 benchmark problem with 10 variables and 2 objectives.
0009
0010 **Usage:**
0011 ```bash
0012 aid2e load examples/configurations/dtlz2_optimization.yml
0013 ```
0014
0015 **Features:**
0016 - Generic design space configuration
0017 - Parameter constraints
0018 - Multi-objective Bayesian optimization
0019 - Parallel evaluations
0020
0021 ### 2. ePIC Tracking Detector (`epic_tracking_optimization.yml`)
0022 Optimization of ePIC detector tracking system with XML parameter integration.
0023
0024 **Usage:**
0025 ```bash
0026 aid2e load examples/configurations/epic_tracking_optimization.yml
0027 ```
0028
0029 **Features:**
0030 - ePIC-specific design configuration
0031 - XML file modifications
0032 - Multiple parameter groups (vertex barrel, silicon tracker)
0033 - Complex geometric constraints
0034 - Optimization groups for selective parameter optimization
0035 - Environment setup for ePIC/EIC software
0036
0037 ## Configuration Structure
0038
0039 All configuration files follow this structure:
0040
0041 ```yaml
0042 problem:
0043 name: "Problem Name"
0044 problem_type: "PROBLEM_TYPE" # e.g., DTLZ2, EPIC_TRACKING
0045 output_location: "./output/dir"
0046 work_location: "./work/dir"
0047
0048 design_config:
0049 # For generic problems:
0050 design_parameters: {...}
0051
0052 # For ePIC problems:
0053 epic_design_parameters: {...}
0054
0055 parameter_constraints: [...]
0056
0057 # Optional: for ePIC problems
0058 epic_configuration:
0059 singularity_image: "path/to/image.sif"
0060 epic_install: "path/to/epic"
0061
0062 optimization:
0063 name: "Optimization Name"
0064 description: "Description"
0065
0066 optimizer:
0067 name: "MOBO" # or "Genetic", "RandomSearch", etc.
0068 type: "Bayesian" # or "evolutionary", "grid", etc.
0069 parameters: {...}
0070
0071 objectives: [...]
0072 constraints: [...]
0073
0074 n_iterations: 100
0075 n_initial_samples: 20
0076 parallel_evaluations: 4
0077 ```
0078
0079 ## Testing Configurations
0080
0081 To validate a configuration without running:
0082 ```bash
0083 aid2e load config.yml --validate-only
0084 ```
0085
0086 To see detailed information:
0087 ```bash
0088 aid2e info config.yml
0089 ```
