Skip to content

[Metadata] Declared fields: tags, references, Corleone, reference solution #379

Closed

Description

@ocots

Agents: read the guide for agents in #310 first. Specification: this description, #306 and its comments.

Sub-issue of #306, part 5 of 5. Independent, low priority.

Scope

From the table of #306: :tags (controlled vocabulary defined in src and checked: e.g. :hard, :analytic, :large_state), :references (bibliographic sources), :corleone (optional pointer to a related problem of SciML's OptimalControlBenchmarks), :reference_solution (optional analytic x(t), u(t)). Each in METADATA_SCHEMA with its type, checked by the consistency tests.

Done when

  • Fields in the schema, typed and tested; filled where known.

Refs #306, #310

Activity

  1. added a commit that references this issue on Nov 7, 2026
  2. ocots commented on Nov 7, 2026

    @ocots
    MemberAuthor

    Done in #403.

    What was done

    • :reference_solution, optional, in ext/MetaData/<p>.jl: a function of the parameters giving the analytic solution of the continuous problem, (state, control, objective, source), or nothing where it is not known. Read with OptimalControlProblems.reference_solution_data(problem, parameters).
    • Filled for beam and bryson_denham: the Bryson–Denham solution with a boundary arc (ℓ ≤ 1/6), J = 8/(9ℓ) and 4/(9ℓ) (Bryson, Denham & Dreyfus 1963). The formulas live once, in src/solutions.jl.
    • Checked against the OptimalControl model: at the analytic point, the constraint violation and the objective gap of the trapezoidal discretization vanish at order 2. The test fails on a wrong objective.
    • Every description cites its sources: a test checks for a References section with at least one entry. The sources stay in the descriptions, so there is no :references field.

    What was dropped

    For later. A description of the structure of a problem, made of characteristics rather than judgments: singular arcs, boundary arcs, stiffness, turnpike. It depends on the parameters, as :expected_structure did in #306.

    Checked after #406: main CI green at c3ade68.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

Labels

No labels
No labels

Type

No type

Projects

No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions