Settings

All settings of a run are YAML files in the data/ directory of this package. The example scripts call set_data_path on that directory, so the kite model reads them from here instead of from its own data directory. You can change the wind, the tether, the winch or the controller tuning without editing V3Kite.

The system project

A run starts from one system project, a file data/system_*.yaml. It holds no settings of its own. Its system: section lists the YAML files that together describe the complete system and its controllers. For example, data/system_reelout_180m.yaml:

system:
    sim_settings: "settings_reelout_180m.yaml"
    wc_settings: "wc_settings.yaml"
    fc_settings: "fc_settings_reelout.yaml"
    traj_opt_settings: "traj_opt.yaml"
    winch_table: "winch_table.yaml"
    turn_rate_coeffs: "turn_rate_coeffs.yaml"
    course_loop_model: "course_loop_model.yaml"
    kite_correction: "kite_correction_measured.csv"
    kite_settings: "kite_settings_psm.yaml"
    structural_geometry: "struc_geometry.yaml"
    aero_geometry: "cfd_aero_geometry.yaml"
    vsm_settings: "vsm_settings.yaml"
    settle_settings: "settle_settings_default.yaml"
    heading_settings: "heading_settings_psm.yaml"

project_file resolves a project name such as "system_reelout_180m.yaml" to this package's data/ directory. The functions fc_settings, turn_rate_coeffs_file, course_loop_model_file, kite_correction_file, winch_table_file and traj_opt_settings_file each return one entry of the system: section, in the same way as KiteUtils.wc_settings.

These projects are included (all names without the .yaml extension):

Project	Run	`sim_settings`	`fc_settings`
`system_fig8_150m`	fig8, 150 m	`settings_fig8_150m`	`fc_settings_fig8_150m`
`system_fig8_200m`	fig8, 200 m	`settings_fig8_200m`	`fc_settings`
`system_fig8_300m`	fig8, 300 m	`settings_fig8_300m`	`fc_settings`
`system_reelout_maasvlakte`	reel-out, 150 m	`settings_reelout_150m`	`fc_settings_reelout`
`system_reelout_180m`	reel-out, 180 m	`settings_reelout_180m`	`fc_settings_reelout`
`system_reelout_cabauw`	reel-out, Cabauw	`settings_reelout_cabauw`	`fc_settings_reelout`

system_fig8_200m.yaml is the default project: project_file uses it when no name is given, and the turn-rate table and the course-loop model are loaded against it when the package loads.

The files a project names

sim_settings → settings_*.yaml, read into KiteUtils.Settings: the plant and the simulation. Wind speed and profile, tether length, mass, winch model, KCU, solver, sim_time and sample_freq (the time step).
wc_settings → wc_settings.yaml, read into WCSettings: the winch controllers. The torque block (V3Kite's position and force modes) and the speed block (WinchControllers.jl's reel-out law and its force limiters).
fc_settings → fc_settings*.yaml, read into FC_Settings: the flight controller. Entry state machine, pattern geometry, heading/course PID, feed-forward, reel-out phases and the run's pass criteria.
traj_opt_settings → traj_opt.yaml, read into TrajOptSettings: the AWETrim client, one section per part: server, guess, depower seed, pattern box, gates and re-optimization; only used by simple_opt_fig8.jl and simple_opt_reelout.jl.
winch_table → winch_table.yaml, read by winch_f_low and winch_force_limit: wind-dependent winch-law parameters. Reel-out projects only.
turn_rate_coeffs → turn_rate_coeffs.yaml, read by turn_rate_coeffs: the identified turn-rate law (c1, c2, delay) per body damping and depower.
course_loop_model → course_loop_model.yaml, read into CourseLoopModel: the other identified parameters of the linear course-loop model of the stability analysis (tape lag, scaling of the kite's dead time and lag, pattern delay approximation, kite correction). Every key is required.
kite_correction → kite_correction_measured.csv, read with load_course_correction: the measured kite correction, gain and phase over frequency, written by examples/identify_kite_correction.jl; the guided-loop margins of stability_opt_reelout.jl are also evaluated with it.
kite_settings → kite_settings_psm*.yaml in this package, read into V3Kite's V3KiteConfig: wing model, aerodynamics mode, backend and in-flight damping.
structural_geometry, aero_geometry, vsm_settings, settle_settings, heading_settings → V3Kite's own files: geometry, polars, VSM and settling settings, read from V3Kite's data directory.

V3Kite looks for each of these files beside the project first and in its own data directory after. The figure-of-eight projects and system_reelout_180m.yaml name kite_settings_psm.yaml, a local copy of V3Kite's file, so an upstream change does not reach these runs unnoticed. system_reelout_maasvlakte.yaml and system_reelout_cabauw.yaml name kite_settings_psm_kernel.yaml, a local variant whose only difference in effect is analytic_jacobian: true. The vsm_interval in these files is not read by the runs of this package: they pass run.vsm_interval of fc_settings to step!.

Not named by any project:

gui.yaml: the choices of the example menu (project, simulation time, plots, wind speed), see State of the example menu. It is created from gui.yaml.default on first use and is not under version control.

Rules shared by the settings files

Every key of traj_opt.yaml is a field of the struct it is loaded into. A missing key falls back to the struct default; an unknown key is an error (see load_yaml_fields!).
fc_settings*.yaml has one section per part of FC_Settings: course, feedforward, pattern, wind_ramp, winch, reelout and run. Each key of a section is a field of that part, with the same rules. A figure-of-eight run can leave out the reelout section. Files archived before this layout, with all keys directly under fc_settings:, still load.
The struct docstrings (on the API pages) say in one line what a field is. The comments in the YAML files give the longer notes and the reason for the value chosen there. The history of the tuning is in docs/fig8_tuning_log.md.
fc_settings_fig8_150m.yaml and fc_settings_reelout.yaml started as copies of fc_settings.yaml. Keys they share must be kept in step by hand.
An example script can override single fields for one run without editing a file, see apply_overrides!.

Example: `fc_settings_reelout.yaml`

The flight-controller settings of all reel-out projects, shown here as shipped:

# Flight-controller settings flown by examples/simple_reelout.jl and
# simple_opt_reelout.jl, named by the system_reelout_*.yaml projects next to it.
# A copy of fc_settings.yaml (simple_fig8.jl) with `compliance: 0`: REEL_OUT and
# V3Kite's FORCE mode both drive the winch, and simple_reelout.jl errors rather
# than picking one. Each section is a part of `FC_Settings` (src/fc_settings.jl)
# and each key a field of that part. The docstrings there stay on one line, the
# comments below carry the longer notes; a missing key falls back to the struct default,
# an unknown key is an error. The plant (sim_time, sample_freq, v_wind,
# l_tethers) is in the system project's settings file, the winch gains in
# wc_settings.yaml. Tuning history: docs/fig8_tuning_log.md.
fc_settings:
  course:  # heading/course loop: entry state machine, depower, PID, feedback, descent limiter
    park_time:          2.0      # Park: zero steering while the transients decay     [s]
    chi_dive:          -145.0    # Dive course; >90 descends, <90 climbs, 90 flat    [deg]
    chi_hold:           -90.0    # Course commanded during the hold                 [deg]
    dive_el_margin:     17.0     # Margin above el_center where the dive ends       [deg]
    hold_time:          0.8      # Duration of the hold                               [s]
    fig8_d_gate:        4.0      # Cross-track error, transition -> fig8            [deg]
    # 0.25 with the 73° relay sweeps' table; /1.084 = 0.23 with the low-elevation table, whose
    # c1(depower_setpoint)/c1(entry_depower) is 1.084 x higher, so the entry flies as tuned (2026-09-29).
    entry_gain:         0.23     # Factor on heading_p during the entry phases        [-]
    entry_depower:      0.34     # Depower during the entry phases                    [-]
    depower_setpoint:   0.274    # Depower on the pattern; 0.278 is the curvature ceiling at 150 m [-]
    depower_blend_time: 2.5      # Ramp of `rel_depower` to a new ladder target; 0 = step [s]
    # heading_p +8 % for guided α 0.306 and lower RMS d (2026-09-29).
    heading_p:          0.183805 # Gain at v_app_ref                                  [-]
    heading_i:          false    # Integral time [s], or false for no integral action
    heading_d:          0.146    # Derivative time; raised for the guided disk margin (2026-09-28, 2026-09-29, 2026-10-05) [s]
    heading_d_n:        2.0      # Derivative filter, max gain of the D path          [-]
    v_app_ref:          27.0     # Speed flown in phase 3; anchors the gain schedule [m/s]
    v_app_min:          10.0     # Lower clamp on v_app, limits the gain boost      [m/s]
    v_kite_heading:     5.0      # At/below: pure heading feedback                  [m/s]
    v_kite_course:      10.0     # At/above: pure course feedback                   [m/s]
    fig8_pure_course:   false    # Course alone from phase 3 on; schedule governs entry
    max_steering:       0.32     # Command limit; raising it is CLOSED, see the log    [-]
    entry_chi_max:      95.0     # Steepest course while off-path; 180 disables it   [deg]
    entry_d_gate:       12.0     # Cross-track error below which it is bypassed     [deg]
    entry_d_blend:      4.0      # Blend band above the gate, 0 = hard switch       [deg]
    entry_cut_margin:   30.0     # Distance from ±180° where chi_set's sign is noise [deg]

  feedforward:  # steering feed-forward from the path's curvature, phase 4 on
    # 0.7 with the 73° relay sweeps' table (deleted 2026-10-01); x1.084 = 0.76 with the low-elevation
    # table, turn_rate_coeffs.yaml, whose c1 at depower_setpoint is 1.084 x higher, so u_ff stays as
    # tuned (2026-09-29).
    ff_gain:            0.76     # Curvature feed-forward, u_ff = psi_dot_path/(c1 v_app); 0 = off, 1 = the law [-]
    ff_lead_time:       0.35     # Read the path's course rate this far ahead of Q; ~the dead time [s]
    ff_smooth:          6.0      # Arc the tangent change is averaged over               [deg]
    ff_tau:             0.2      # Low-pass on u_ff and the chord correction; 0 = none    [s]
    ff_d_fade:          6.0      # Cross-track error at which the ff is fully off; fades from half [deg]
    ff_err_fade:        60.0     # Course error at which the ff is fully off; fades from half  [deg]
    # Gravity turn of the turn-rate law in its fixed-c3 form, c3·sin(χ)·cos(β), read off the path at the
    # lead point (2026-10-04). Without it the P-only loop holds the gravity turn off with a course error and
    # the kite flies 1.1-2.2° below the path on horizontal legs at every wind speed. The free-c2 form
    # c2/v_a overshoots at low v_a and falls short at high v_a. 0.23 is the identified c3
    # (docs/turn_rate_fixed_c3.md); with el_offset_wing 0.5 the 22 replays pass, RMS d -2 to -31 % in 19.
    ff_gravity_rate:     0.23    # Gravity turn rate cancelled by the feed-forward, c3; 0 = off [1/s]

  pattern:  # pattern geometry and attractor; a SMALLER lemniscate is a TIGHTER one
    f8_a:               20.0     # Width of the eight, azimuth spans ±A; sweep optimum [deg]
    f8_b:               11.0     # Height, elevation spans ±B/2; picked for margin 1.07 [deg]
    el_center:          18.0     # Centre elevation; lower turns easier, costs energy [deg]
    # 8.0 -> 9.75 (2026-10-02, retune_guided.jl, target 0.4): worst guided disk margin of the 22
    # scenarios 0.332 -> 0.401 (weak winds, where this floor sets the attractor); replays at
    # maasvlakte 3.5/8.0 and cabauw 3.0 m/s pass all criteria, RMS d +20 - 29 %, power unchanged.
    # 9.75 -> 8.25 (2026-10-03, retune_guided.jl tighten, floor 0.51): worst guided disk margin
    # 0.523 -> 0.515, now maasvlakte 5 m/s; 8 m/s and up unchanged. Aim: lower RMS tracking error.
    # Floor ∝ 1/L since 2026-10-03: a fixed arc of 25.3 m, 8.35° at 175 m (9.7° at 150 m, 3.8° at
    # 380 m). Only attractor_dist * attractor_dist_ref_length matters; the smallest product keeping
    # the worst guided margin of the 22 scenarios >= 0.51 is 8.31° x 175 m (the same at L_ref 150-300).
    # Replays on the archived paths: RMS d -31 % maasvlakte 3.5, -28 % 5, -20 % 8, -25 % cabauw 4,
    # -5 % 6, -3 % 9 m/s; power within 2 %, max force unchanged, all criteria passed.
    attractor_dist:      8.35    # Arc distance Q -> attractor at attractor_dist_ref_length; the FLOOR under a lead time [deg]
    attractor_dist_ref_length: 175.0 # Tether length where attractor_dist holds, floor ∝ 1/L; 0 = fixed [m]
    # attractor_lead_time: ω_g below the course loop, guided disk margin >= 0.30 with c3 (2026-09-28);
    # 0.96 -> 1.05 (2026-10-03): Cabauw 10 m/s guided disk margin 0.477 -> 0.534, RMS cross-track error 1.27 -> 1.21°.
    # 1.05 -> 1.21 with heading_d 0.141 -> 0.146 (2026-10-05, retune_guided.jl, target 0.51): with wing drag
    # 0.03 Cabauw 9-10 m/s fly depower 0.365-0.393, where the kite responds slower; guided disk margin
    # 0.451/0.442 -> 0.524/0.515, worst of the 22 scenarios 0.513 (Maasvlakte 3.5 m/s).
    # 1.21 -> 1.05 (2026-10-06, retune_guided.jl tighten, floor 0.505): with the pattern delay approximation, depower
    # factor and kite correction re-identified with the wing drag the kite responds faster at high v_a;
    # guided disk margin of Cabauw 9-10 m/s 0.672/0.677 -> 0.611/0.617, worst 0.506 (Maasvlakte 3.5 m/s,
    # set by the arc's floor) unchanged.
    attractor_lead_time: 1.05    # Lead as flight time, arc = t*v_app/L; 0 = off   [s]
    reacquire_margin:    6.0     # Global best must beat the in-window best by this  [deg]
    up_loops:           false    # Up-loops instead of down-loops; down crosses the centre

  winch:  # compliance of the force-mode winch (its gains are in wc_settings.yaml) and force guards
    compliance:         0.0      # Fixed at POSITION mode; REEL_OUT needs the drum free [-]
    entry_f_min:        350.0    # Entry-guard (guard_lfc) force floor, phases 0-2; not wc's f_low [N]
    first_lap_force_frac: 0.93   # f_high x this in lap 1 AND for the startup solve; 1.0 = no lap-1 de-rating [-]

  reelout:  # REEL_OUT winch and phase 5; kv/f_low/f_high/v_sat are in wc_settings.yaml
    reelout_l_max:      380.0    # Length at which reel-out stops; AWETrim's reopt ceiling is ~325 m [m]
    n_fig_eight:        0        # Laps after which reel-out stops; 0 = length only [-]
    reelout_softstart:  12.0     # Ramps the COMMANDED speed 0 -> v_set over this long  [s]
    reelout_softstop:   1.5      # Linear decel trigger at the far end               [s]
    reelout_delay:      4.2      # Wait after phase 3 before reel-out starts          [s]
    reelout_f_trigger:  6400.0   # Force that releases reel-out EARLY; Inf disables it [N]
    final_time:         30.0     # Sim time flown in phase 5 before the run ends; Inf = full run [s]
    depower_final:      0.35     # Flown from phase 5; tuned to hold ~3458 N at 6 m/s [-]
    depower_final_max:  0.42     # Ceiling of the phase-5 force limiter; = depower_final is OFF [-]
    depower_final_f_target: 7500.0 # Force the limiter holds, under 8400 N by the lobe swing [N]
    depower_final_f_gain: 6.0e-5 # Limiter integrator gain, depower per N per s    [1/(N s)]
    depower_final_f_gain_stop: 1.0e-4 # Same during the soft-stop ramp: 0.35 -> 0.40 in 3 s [1/(N s)]
    park_final:         true     # Phase 5 steers straight up (course 0), out of the power zone [-]
    park_lead:          6.0      # Parking climb starts this long before reel-out ends [s]
    el_offset_final:     1.0     # Extra lift of the path once reel-out ends       [deg]
    el_offset_lead:      8.0     # How early the lift starts; gets it past the phase-5 gate [s]
    final_margin_min:    1.5     # Phase-5 path below this curvature margin falls back; 0 = off [-]
    # 1.0 -> 0.5 with ff_gravity_rate 0.23 (2026-10-04): the kite no longer sags at the lobes, and the full
    # lift cost Maasvlakte 8.5-11 m/s 1.3-2.9 % of power and +12-28 % RMS d to the unlifted path.
    el_offset_wing:      0.5     # Extra lift at the LOBES, none in the centre       [deg]
    el_offset_wing_az:  10.0     # |azimuth| beyond which that lift is full   [deg or fraction of A]
    el_offset_wing_blend: 8.0    # Ramp width below it; NOT monotone, see the docstring  [same units]
    el_offset_wing_mode: "azimuth"  # azimuth (deg) | azimuth_frac (of the path's own A)

  low_wind:  # per wind speed at low_wind_height, linear in between, first row held below; off from the last row on
    # Flown 2026-10-02, the guided disk margin was 0.41-0.44 at 150 m: Maasvlakte 3.5 m/s (4.51 at 100 m),
    # Maasvlakte 4 m/s (5.15), Cabauw 3 m/s (5.80); Maasvlakte 5 m/s (6.44) is robust as the files fly it.
    # The last row is the files' own values: l_tethers and traj_opt's guess_el_center.
    low_wind_height:          100.0                      # Height of the wind the schedule is keyed on [m]
    low_wind_speeds:          [4.51, 5.15, 5.80, 6.40]   # Wind speed at low_wind_height, ascending [m/s]
    low_wind_l_tether:        [195.0, 195.0, 195.0, 150.0] # Tether length reel-out starts at; less guidance phase lag [m]
    low_wind_guess_el_center: [25.0, 27.0, 27.0, 29.0]   # Startup guess; 29° at 195 m lands in a 470 W optimum [deg]

  run:  # simulation conditions and pass criteria
    vsm_interval:       5        # Steps between VSM aero updates, 1 = tightest; at 10 the identification flights sink at depower 0.375 (2026-10-02) [-]
    elevation:          73.0     # Where init settles the kite; in the settled-state cache key [deg]
    warmup_time:        2.0      # Discarded warm-up run, right after `init`          [s]
    body_damping:       [0.0, 0.0, 40.0]  # Per axis; the turn_rate_coeffs key (settles to 0.8x)
    v_app_abort:        55.0     # Stop the run above this apparent wind speed      [m/s]
    entry_time:         62.0     # Settle time after park_time before the metrics     [s]
    min_elevation:       6.5     # Floor criterion over the WHOLE run; also the reopt install gate [deg]
    min_span_frac:      0.7      # Pattern-SIZE criterion, fraction of f8_a / f8_b    [-]

Example: `traj_opt.yaml`

The settings of the AWETrim client, read into TrajOptSettings and used by simple_opt_fig8.jl and simple_opt_reelout.jl, shown here as shipped:

# Externally optimized path settings. Loaded into a `TrajOptSettings` struct; each section
# below is a part of that struct (src/traj_opt_settings.jl) and each key a field of that
# part. A missing key falls back to the struct default, an unknown key is an error.
# Tuning record in docs/fig8_tuning_log.md.
traj_opt:
  server:  # AWETrim server, request caches and the winch law sent
    base_url: "http://127.0.0.1:8000"  # address of the AWETrim server
    opt_failure_cache: true  # skip requests recorded as failing; see the docstring
    opt_success_cache: true  # replay applied results of an identical request chain; clear after an AWETrim change
    opt_warm_start_awe_trim: 1.0   # use_awe_trim of the seeding solve; 0.0 = off  [-]
    opt_awe_trim:      1.0 # use_awe_trim sent to the server; < 0 follows wc_settings [-]
    free_speed_reference_points: 6  # free_speed solves for the reference power AFTER the run; 0 = off [-]

  guess:  # initial guess; seeds a multi-modal solve: changes the answer, not the run time
    guess_a:          30.0   # width of the guess; azimuth spans ±guess_a    [deg]
    guess_b:          12.0   # height of the guess, peak to peak             [deg]
    guess_el_center:  29.0   # centre elevation of the guess; first knob to move on a 422 [deg]
    guess_el_center_high:      30.0   # centre elevation at/above the ref wind (a step, not a ramp) [deg]
    guess_el_center_wind_ref:   8.0   # wind at/above which guess_el_center_high applies [m/s]
    startup_retry_el_offsets: [-1.0, 2.0]   # seeds tried in order on a startup 422; [] never retries [deg]

  seed:  # depower seed of the solve, ramped with the wind
    input_depower:     1.6   # depower SEED in metres of tape (server bounds 1.1-2.3), not depower_setpoint [m]
    input_depower_wind_ref:  7.0   # wind at which input_depower IS the seed  [m/s]
    input_depower_per_wind:  0.25  # tape added per m/s above that; one-sided [m/(m/s)]
    input_depower_seed_max:  1.85  # ramp ceiling, below the server's 2.3 m  [m]
    # Estimate of the tape length the startup reply is FLOWN at, which sizes the turn-radius
    # request; 0 takes the seed above. Fitted 2026-10-05 to the startup replies of the base
    # runs (Cabauw 4-10, Maasvlakte 8, 11 m/s) against the wind at the caps' height (100 m):
    # 1.43-1.47 m up to ~12 m/s there, then ~0.05 m per m/s (Cabauw 10 m/s, 19.3 m/s: 1.91 m).
    # The seed ramps on the 6 m wind and seeded Maasvlakte 8 m/s at 1.85 m against 1.46 m flown.
    request_depower:          1.45  # estimate at and below the ref wind aloft [m]
    request_depower_wind_ref: 10.4  # wind at the caps' height above which it ramps [m/s]
    request_depower_per_wind: 0.05  # tape added per m/s of wind aloft above that [m/(m/s)]

  box:  # pattern box the optimizer solves UNDER; 0.0 keeps the server default (|az| <= 45.8, 0.6 <= el <= 51.6)
    pattern_azimuth_max: 28.0        # closes the wide basin seen at 5.5 m/s; good runs fly ±18-25 [deg]
    pattern_azimuth_max_high: 34.0   # cap at/above pattern_elevation_amplitude_max_wind_ref: under the 45° climb
                                     # limit Cabauw 10 needs ±28.4-28.8° at 150 m and IPOPT 2-3° of room: 422 under
                                     # 28 and 29 at r_min 22.8 m, under 30 at 23.5 m (quadratic depower
                                     # conversion); converges under 31 and 32 (2026-10-03). 36 -> 34 (2026-10-05):
                                     # at 36 the re-optimizations at Cabauw 10 grew to ±32° x 21°, RMS d 1.61°;
                                     # at 34 ±22° x 16°, RMS d 1.44°, 22.7 instead of 20.4 kW [deg]
    pattern_elevation_amplitude_max: 8.5   # largest elevation HALF-SPAN of the figure; 0.0 = off [deg];
                                           # 8.0 left Maasvlakte 3.5 m/s infeasible at 8.12° (2026-09-24)
    pattern_elevation_amplitude_max_high:     13.0  # cap at/above the ref wind (a step, not a ramp) [deg]
    pattern_elevation_amplitude_max_wind_ref: 13.2  # wind AT the height below at/above which the high cap
                                                    # applies: Maasvlakte 10 m/s is 12.9 there and flies under
                                                    # 8°, Maasvlakte 11 (14.2) and Cabauw 7-10 (13.5-19.3) need
                                                    # 10° or the startup solve loses its basin (2026-09-21);
                                                    # 11° since 2026-09-23: Cabauw 10 at f_high 7200 N needs
                                                    # 10.5-10.7° at the 150 m startup [m/s]
    pattern_elevation_amplitude_max_wind_height: 100.0  # height that wind is taken at; 0 = the 6 m wind [m]
    pattern_symmetric: true       # mirror-symmetric figure about azimuth 0; the solve is multi-modal and
                                  # otherwise lands lopsided (Cabauw 2026-09-25: centre -2.3°, lobes 214/147 points)
    pattern_climb_angle_max: 45.0 # steepest climb of the path in the az/el plane; descending is free; 0 is off [°]

  gates:  # every returned path, at startup and after a re-optimization
    min_feasibility_margin: 0.82  # curvature gate AND request (as min_turn_radius); 0.0 = off; an 8 m/s number [-]
    turn_radius_headroom: 1.25    # factor on the margin sent; covers the gate's own bites, makes slack [-]
    min_height: 40.0              # clearance gate at the anchor radius                                 [m]
    candidate_elevation_margin: 3.0   # gate margin above fc_settings' min_elevation [deg]

  reopt:  # re-optimization while the tether grows (simple_opt_reelout.jl)
    reopt_every_n_laps: 1    # laps between requests; never two solves at once   [-]
    max_reopt: 7             # bound on re-optimizations per run                 [-]
    reopt_blocking: true     # freeze the simulation until the reply lands       [-]
    path_blend_time: 6.0     # seconds over which the new path replaces the old  [s]
    blend_max_retries: 3     # fresh solves per rejected reply                   [-]
    size_box_growth: 1.3     # box SENT with a re-opt: this x the previous install's size; 0 is off [-]
    challenge_growth: 1.1    # growth above which a reply predicting less than the previous install 
                             # is cross-checked by a cold solve; 0 is off        [-]

  reopt_gates:  # the extra gates of a re-optimization reply
    min_power_frac: 0.3      # fraction of the startup install's power              [-]
    min_power_frac_prev: 0.85 # fraction of the previous install's power; 0 is off  [-]
    power_gate_wind_min: 4.0 # mean wind below which a negative pred bypasses     [m/s]
    max_size_growth: 1.3     # largest size ratio vs the previous install; 0 is off [-]
    blend_fold_margin: 0.5   # blend_folds: fraction of the endpoints' own radius   [-]