FuncCraft Documentation

FuncCraft is a C++17 library with a Python interface for generating scalable black-box optimization benchmark suites. It builds benchmark functions from editable YAML files, packaged suite collections, primitive benchmark functions, coordinate transforms, value transforms, and composition rules.

Choose the language track first:

Python

A compact YAML/dictionary-first interface with a small public API.

C++

A native API with runtime objects plus typed construction structs for advanced control.

The shared concept pages explain the construction model and implemented mechanisms without assuming either interface.

Start Here

• Installation
  • Python package
  • Build from source
  • Native C++ build
  • Build options
  • Use in another C++ project
  • Build the documentation

Shared Concepts

• Construction model
  • Components
  • Coordinate transforms and optimum placement
  • CPM and DPM compositions
  • Suite generation
  • Design constraints
  • Final scaling
• Implemented mechanisms
  • Base functions
  • Coordinate transforms
  • Value transforms
  • Composition modes
  • Name aliases
• Runtime objects and packaged suite
  • Python
  • C++
  • Construction paths
  • Dimension and identity
  • Exporting
  • FuncCraft 2026 v1 suite
• Primitive base function IDs

Examples and API

• Python Interface
  • Python examples
  • Python API
• C++ Interface
  • C++ examples
  • C++ API

2D Plots

• 2D Plots

Project

• Testing and CI
• MIT License

Indices and tables

• Index

• Module Index

• Search Page