What’s new#

Version 0.3.0 (development)#

moarchiving, paretobench and patatune are now included in the benchmarks.
r2_exact() implements the exact computation of the R2 indicator for bi-objective solution sets.
hypervolume() is significantly faster for more than four dimensions (Andreia P. Guerreiro).
hypervolume() now handles 1D inputs and provides a clear error for 0D inputs (#58).
is_nondominated() and filter_dominated() implement the best-known \(O(n(\log_2 n)^{m-2})\) algorithm, thus they are significantly faster for 4D and above. See Identifying nondominated points benchmarks.
New shapes "inverted-simplex" and "concave-simplex" added to generate_ndset(). Shape "convex-simplex" is now equivalent to generate_ndset(..., method="simplex") ** 2, which is slightly more uniform than the previous approach.

Requires numpy>=1.24.
Optuna is now included in the benchmarks.
New Nondominated Sorting (Pareto ranking) benchmarks.
pareto_rank() is faster in 3D.
HV3D+ is slightly faster with repeated coordinates (#41).
igd(), igd_plus(), avg_hausdorff_dist() are faster.
Fix wrong values returned by epsilon_mult() when mixing minimization and maximization.
Fix documentation of Epsilon metric (@leandrolanzieri)
hypervolume() uses the inclusion-exclusion algorithm for small inputs of up to 15 points, which is significantly faster.

hv_contributions() ignores dominated points by default. Set ignore_dominated=False to restore the previous behavior. The 3D case uses the HVC3D algorithm.
New function any_dominated() to quickly detect if a set is nondominated.
New function generate_ndset() to generate random nondominated sets with different shapes.
New example Sampling Random Nondominated Sets.
is_nondominated(), any_dominated(), pareto_rank() now handle single-objective inputs correctly (#27, #29).
Ranks returned by pareto_rank() are 0-based.
is_nondominated() and filter_dominated() are faster for dimensions larger than 3.
moocore wheels are now built for aarch64 (ARM64) in Linux and Windows. See the installation instructions.
is_nondominated() and filter_dominated() are now stable in 2D and 3D with !keep_weakly, that is, only the first of duplicated points is marked as nondominated.

Correct license to LGPL v2.1 or later.
Bump dependencies to cffi>=1.17.1 and setuptools>=77.0.3.
eaf(), vorob_t() and vorob_dev() take the set indices as a separate argument sets following the API of the R package.
New example Empirical Attainment Function.
Document EAF and Vorob’ev expectation and deviation in more detail.
New online dataset: DTLZLinearShape.8d.front.60pts.10 (see get_dataset()).
New default method in hv_approx(). Computation is now done in C, so it is much faster.
hv_contributions() is much faster for 2D inputs.

hypervolume() now uses the HV3D⁺ algorithm for the 3D case and the HV4D⁺ algorithm for the 4D case. For dimensions larger than 4, the recursive algorithm uses HV4D⁺ as the base case, which is significantly faster.
read_datasets() is significantly faster for large files.
is_nondominated() and filter_dominated() are faster for 3D inputs.
New function: hv_contributions().
New online datasets: test2D-200k.inp.xz and ran.1000pts.3d.10 (see get_dataset()).

New function: largest_eafdiff().
New class: RelativeHypervolume.
New dataset tpls50x20_1_MWT.csv.
Extended example Computing Multi-Objective Quality Metrics.
vorobT() and vorobDev() were renamed to vorob_t() and vorob_dev() to follow Python convention.
get_dataset_path() and get_dataset() can download large datasets from a remote repository.

Improved example Using moocore with Pandas to work in Pandas version >= 2.
Changed behavior of apply_within_sets(). The previous behavior could lead to subtle bugs.

New: Hypervolume: Object-oriented API for hypervolume indicator.
New: apply_within_sets(): Utility function to apply operations to individual datasets.
New: is_nondominated_within_sets(): Utility function to identify nondominated points within sets.
New example using pandas.DataFrame in Using moocore with Pandas.
Fix bug in normalise() when the input is pandas.DataFrame or some other non-contiguous array.