Implements regulators for the Euclidean coordinates of Point entities,
automatically creating all three of them for each added point entity. When
such a regulator is set, it freezes the corresponding representation
coordinate to the set point. In addition, if all three coordinates of a
given Point are set, the coradius coordinate (which holds the norm of the
point) is frozen as well.
Note that a PointCoordinateRegulator must be created with a Point as the
subject. This commit modifies HalfCurvatureRegulator analogously, so that
it can only be created with a Sphere.
A couple of prospective issues that should be filed in association with
this commit:
* The new coordinate regulators create redundant display information with
the raw representation coordinates of a point that are already shown in
the outline view.
* The optimization status of these regulators together with HalfCurvature
regulators (i.e., the ones implemented by freezing coordinates) is different
from InversiveDistance regulators when an Assembly is unrealizable: the
frozen-coordinate constraints will be "hard" in that they will be forced
to precisely equal their set point, whereas the distance regulators are
"soft" in that they can be relaxed from their set points in an effort to
minimize the loss function of the configuration as compared to the values
of the constraints. Perhaps at some point we should/will have a mechanism
to specify the softness/hardness of constraints, but in the meantime,
there should not be two different categories of constraints. Suppose we
decide that by default that all constraints are soft. Then the optimizer
should be able to search changing, for example, the radius of a
curvature-constrained sphere, so as to minimize the loss function (for a
loss that would therefore presumably have a term akin to the square of the
difference between the specified and actual half-curvature of the sphere).
For example, suppose you specify that the half-curvature of a sphere is 1
(so it has radius 1/2) but that its distance to a point is -1. These
constraints cannot be satisfied, so the optimization fails, presumably
with the point at the sphere center, and the sphere with radius 1/2.
So all of the loss is concentrated in the difference between the actual
point-sphere distance being -1/2, not -1. It would be more appropriate
(in the all-soft constraint regime) to end up at something like a sphere of
half-curvature 1/√2 with the point at the center, so that the loss is split
between both the half-curvature and the distance to the sphere being off by
1 - 1/√2. (At a guess, that would minimize the sum of the squares of the
two differences.)
Adds a `Diagnostics` component that shows the following diagnostics from the last realization:
- Confirmation of success or a short description of what failed.
- The value of the loss function at each step.
- The spectrum of the Hessian at each step.
The loss and spectrum plots are shown on switchable panels.
Also includes some refactoring/renaming of existing code.
Co-authored-by: Aaron Fenyes <aaron.fenyes@fareycircles.ooo>
Reviewed-on: StudioInfinity/dyna3#92
Co-authored-by: Vectornaut <vectornaut@nobody@nowhere.net>
Co-committed-by: Vectornaut <vectornaut@nobody@nowhere.net>
Previously, dyna3 used storage keys to refer to elements, necessitating passing around element containers to various functions so that they could access the relevant elements. These storage keys have been replaced with reference-counted pointers, used for tasks like these:
- Specifying the subjects of regulators.
- Collecting the regulators each element is subject to
- Handling selection.
- Creating interface components.
Also, systematizes the handling of serial numbers for entities, through a Serial trait.
And updates to rust 1.86 and institutes explicit checking of the rust version.
Co-authored-by: Aaron Fenyes <aaron.fenyes@fareycircles.ooo>
Reviewed-on: StudioInfinity/dyna3#84
Co-authored-by: Vectornaut <vectornaut@nobody@nowhere.net>
Co-committed-by: Vectornaut <vectornaut@nobody@nowhere.net>
Adds a continuous integration workflow to the repository, using the [Forgejo Actions](https://forgejo.org/docs/next/user/actions/) framework.
Concurrently, Aaron added a [wiki page](https://code.studioinfinity.org/glen/dyna3/wiki/Continuous-integration) to document the continuous integration system. In particular, this page explains how to [run continuous integration checks on a development machine](wiki/Continuous-integration#execution), either directly or in a container.
Co-authored-by: Aaron Fenyes <aaron.fenyes@fareycircles.ooo>
Co-authored-by: Glen Whitney <glen@studioinfinity.org>
Reviewed-on: StudioInfinity/dyna3#75
Co-authored-by: Vectornaut <vectornaut@nobody@nowhere.net>
Co-committed-by: Vectornaut <vectornaut@nobody@nowhere.net>
