Repository navigation
DESDEO 2.8.0
[2.8.0] - 13.10.2026
Highlights
This release fixes two defects that users should be aware of. The infix parser
grouped chains of mixed operators wrongly, so a / b * c was parsed as
a / (b * c). This affects every function given as a string, so problems
defined with such expressions may evaluate differently after upgrading. In the
Web API, a decision maker could use another user's interactive session or
parent state by passing its id; this is now refused.
Core logic
Added
- Added
DifferentialEvolutionCrossover(DE/rand/1/bin, Storn and Price 1997)
andParentCentricCrossover(PCX, Deb, Anand and Joshi 2002), with
DifferentialEvolutionCrossoverOptionsandParentCentricCrossoverOptions,
and theSCALING_FACTOR,SIGMA_ZETAandSIGMA_ETAcrossover message
topics. Both recombine more than two parents and take their step size from the
population. - Added
UniformCrossoverandUniformCrossoverOptions, a discrete crossover
for continuous problems in which every decision variable is inherited whole
from one parent or the other, withpair_xover_probabilityand
uniform_xover_probabilityparameters. - Added
swap_uncrossed_variablesto simulated binary crossover, which
exchanges the variables not selected for crossover between the two offspring,
to reproduce jMetal (Java). Defaults toFalse. - Added
uniform_xover_probabilityto the bounded exponential crossover, the
same uniform-crossover component simulated binary crossover already has.
Defaults to 0.0, which reproduces the previous offspring exactly. - Added an
include_perturbedkeyword torpm_solve_solutions. WhenFalse,
only the solution for the given reference point is computed and returned,
without the k solutions for the perturbed reference points. Defaults to
True. - Added the D-PHI and PHI+ unary indicators to
desdeo/tools/indicators_unary.py
(d_phi_indicator,d_phi_batch,phi_plus_indicator,phi_plus_batch,
desirability_values, and theDPhiIndicatorsandPhiPlusIndicator
result models) (#595). - Added
desdeo/gdm/grp_subproblem.pyfor aggregating the reference points of a
group fairly in NAUTILI:build_grp_subproblemassembles the Group Reference
Point subproblem from a local preference model
(additive_preference_constraintsor
symmetric_cones_preference_constraints) and a max-min fairness model
(maxmin_fairness_constraints,maxmin_fairness_objective). All are exported
fromdesdeo.gdm(#572). - Added a
cluster_extremesfield toSCOREBandsResult, which reports the
minimum and maximum value attained by the solutions of each cluster, as
opposed to the limits of the band drawn from the cluster. - Added the test problems
re31(two bar truss),re32(welded beam),re33
(disc brake) andre42(conceptual marine design), and exported them, along
withre34,re37,re41andre61, fromdesdeo.problem.testproblems. - Added the General Aviation Aircraft product family design problem,
gaa
(gaa_problem.py): ten objectives, 27 continuous variables and a single
aggregated constraint, with coefficients checked bit for bit against the MOEA
Framework implementation. - Added the microalloyed steel design problem of Saini et al. (2023),
metallurgical_application(metallurgical_application_problem.py). Four
objectives come from surrogate models that are trained on first use and
cached; the datasets are read from the repository or downloaded from GitHub. - Added
forest_problem_income_carbon_habitat(forest_problem.py), the
discrete forest management problem with income, carbon storage and habitat
suitability objectives used in R-XIMO and INFRINGER, with its dataset
datasets/forest_income_carbon_habitat.csv.non_dominated_only=Truekeeps
only the 1247 non-dominated rows of the 1728.
Changed
- Subscribers now register themselves with their publisher once they have been
constructed, through a metaclass that calls the newSubscriber.__post_init__.
The EA factories inEAs.pyandemo_constructorno longer subscribe the
components by hand.Publisher.subscribeandPublisher.register_topicsare
now idempotent, so existing code that still subscribes explicitly does not
receive each message twice. RVEASelectornow uses the provisional ideal point, when one is given, until
the population has a feasible solution, and only then builds the ideal point
from feasible solutions.RVEASelectornow adapts its reference vectors periodically under the
function evaluation based strategy, instead of only once.CompositeTerminatornow forwards messages to its children and exposes their
topics, so that a limit inside a composite counts. Children the publisher
already delivers to are skipped.- Renamed
MaxTimeTerminatorOptions.max_timetomax_time_in_seconds, to match
theMaxTimeTerminatorconstructor. dmitry_forest_problem_discnow removes duplicate objective vectors, and its
objectives carry full names and units.- Documented that
r2_indicatorreturns the utility form of R2 (higher is
better, always negative), the negation of the distance form reported by
PlatEMO and jMetal, and pinned the relationship with tests. - The MCWB problem module docstring now names its source, Kenny, Ray and Singh
(EMO 2025), and the authors' reference implementation.
Fixed
- Fixed the infix parser grouping mixed operator chains to the right: when the
operator changed mid-chain, the rest of the chain became the right operand,
soa / b * cparsed asa / (b * c). Chains are now folded from the left.
Chains of a single operator and parenthesized expressions were not affected. - Fixed the six MCWB welded beam problems (
mcwb_*_problem): the parser defect
inverted their polar moment, which silenced the shear-stress constraint and
made the tapered deflection NaN, and the formulations had drifted from the
authors' code (extra and missing constraints, a lost factor of twelve in the
tapered inertia, a wrong channel bound, mixed units in the Ragsdell variant).
Every objective and constraint now agrees with the reference implementation
to machine precision. - Fixed
RVEASelectorcrashing on a generation with no feasible member, since
the ideal point was updated from an empty selection. - Fixed the decomposition-based selectors raising
TypeErroron construction
whenReferenceVectorOptionshadnon_preferred_solutionsset: the
norm_orderargument ofinteractive_adapt_2was passed asord. - Fixed adaptive IBEA dividing by zero when the population collapses onto one
objective vector.IBEASelectornow falls back to the configured kappa when
the adaptive scale is zero; runs that completed before are unchanged. - Fixed
terminator_constructorfor composite, external check and maximum time
terminators, none of which could previously be built from options. - Fixed the verbose state messages of the EMO evaluator, generators and
selectors emitting a polarsDeprecationWarningon every message, by using
DataFrame.hstackinstead ofpl.concat(how="horizontal"). - Fixed
plot_scoreusingmatplotlib.cm.get_cmap, which was removed in recent
matplotlib versions.
Web API
Added
- Added
include_perturbedtoRPMSolveRequest, passed on to
rpm_solve_solutions, so that the reference point method endpoint can return
a single solution. Defaults toTrue.
Fixed
- Fixed the reference point method router not persisting its states. It now
creates them withStateDB.create, links them to their parent state, and
stores the preference inRPMState.
Security
- Fixed
SessionContextGuardaccepting other users' interactive sessions and
parent states.fetch_interactive_sessionnow checks that the session belongs
to the user, andfetch_parent_stateonly accepts a state in one of the
user's own sessions or, for a state outside any session, a state of a problem
the user may access. Analysts and admins are unaffected. A state the user may
not access is reported as not found.
Documentation
Added
- Added a how-to guide on solving problems with the web GUI on a local machine
(docs/howtoguides/webui_solving_problems.md) (#579). - Added a how-to guide on solving the RE problems
(docs/howtoguides/re_problems.ipynb). - Replaced the NAUTILI how-to guide with an executable notebook
(docs/howtoguides/nautili.ipynb) (#572).
Changed
- Updated the guide on using uv with conda (#579).
- The installation guide now clones the repository over HTTPS instead of SSH.
- Moved the solver check in the OpenShift deployment guide after the API
deployment has rolled out (#576, #577). - Listed D-PHI and PHI+ in the features page, and updated the crossover
explanation notebook for the new operators. - Fixed typos throughout the documentation (#588).
- Re-executed the cached EA how-to notebooks so that they no longer show the
polars deprecation warnings.
Tooling, CI, and deployment
Added
- Added command line options to
run_fullstack.py:--host,--port,
--frontend-port,--no-open,--no-reloadand--log-level.
Changed
run_fullstack.pynow locatesnpmonPATH, so it also works on Windows,
and reports when it cannot be found (#579).- Reformatted
pyproject.tomlto two-space indentation and updated the lock
file.