Pagmo.NET 1.0.0-beta.2

Pagmo.NET

Pagmo.NET is a C# wrapper for pagmo2, a C++ library providing high-quality metaheuristic and gradient-based optimization algorithms with multi-island parallel evolution support.

Supported platforms: Windows x64 and Linux x64 — native runtime libraries are bundled in the package. No additional installation required.

Installation

dotnet add package Pagmo.NET --version 1.0.0-beta.2

Quickstart

using pagmo;

public sealed class SphereProblem : ManagedProblemBase
{
    public override PairOfDoubleVectors get_bounds() => Bounds(
        new[] { -5.0, -5.0 },
        new[] { 5.0, 5.0 });

    public override DoubleVector fitness(DoubleVector x)
        => Vec(x[0] * x[0] + x[1] * x[1]);

    public override ThreadSafety get_thread_safety() => ThreadSafety.Basic;
}

using IAlgorithm algo = new de(100u);
using var udp = new SphereProblem();
using var isl = island.Create(algo, udp, popSize: 64u, seed: 2u);
isl.evolve(1u);
isl.wait_check();

using var result = isl.get_population();
using var bestX = result.champion_x();
using var bestF = result.champion_f();

Use island.Create(...) for single-island runs and archipelago.push_back_island(...) for multi-island parallel search.

Defining custom problems

Implement IProblem or inherit from ManagedProblemBase. Only two methods are required:

public override DoubleVector fitness(DoubleVector x) { ... }
public override PairOfDoubleVectors get_bounds() { ... }

Optional capabilities — gradients, hessians, batch evaluation, seed hooks, metadata — have safe defaults and can be overridden as needed. ManagedProblemBase includes helpers Vec(...) and Bounds(lower, upper) for concise authoring.

Threading

thread_bfe and archipelago with managed UDPs require parallel-safety opt-in:

public override ThreadSafety get_thread_safety() => ThreadSafety.Basic;

Managed UDPs declaring ThreadSafety.None are rejected on threaded execution paths.

Runnable examples

dotnet run --project Examples/Examples.Pagmo.NET/Examples.Pagmo.NET.csproj -- all

Scenarios: single, archipelago, policies, maneuver. Add --verbose to print algorithm logs after each scenario.

What's included

FAQ

Why .NET and C#? The .NET ecosystem is underappreciated for scientific computing. C# performance is competitive with C++ for many workloads, and .NET's open-source trajectory makes it a strong foundation for numerical work. Pagmo.NET lets teams use pagmo's optimization power without a Python runtime dependency.

Why SWIG? SWIG handles the repetitive wrapping work across a large API surface. The .i interface file is also a useful starting point for bindings in other languages.

Where's IPOPT? Included and statically linked on both Windows and Linux. OptionalSolverAvailability.IsIpoptAvailable returns true out of the box.

Where's SNOPT7? SNOPT7 is proprietary and cannot be bundled. Users with a SNOPT7 license can build Pagmo.NET from source with SNOPT7 support — see the repository README for instructions.

Is this affiliated with ESA or the pagmo2 team? No — Pagmo.NET is an independent .NET binding, not affiliated with ESA or the pagmo2 developers.

Links

• Source repository
• pagmo2 documentation
• Release notes