Saddlescape V1.0: A Python Package for Constructing Solution Landscapes via High-Index Saddle Dynamics

Read full text
Authors: Yuyang Liu, Hua Su, Zixiang Xiao, Lei Zhang, Jin Zhao
Cited by: 0

Abstract

We present SaddleScape V1.0, a Python software package designed for the exploration and construction of solution landscapes in complex systems. The package implements the High-index Saddle Dynamics (HiSD) framework and its variants, including the Generalized HiSD for non-gradient systems and the Accelerated HiSD. SaddleScape V1.0 enables the systematic identification of critical points, including both local minima and high-index saddle points, by dynamically updating both the state estimate and an associated subspace characterizing the saddle’s local manifold. It supports both gradient systems, defined by energy functions/functionals, and general non-gradient autonomous dynamical systems. Key features include automatic differentiation for symbolic inputs, numerical approximation techniques for Hessian-vector products, diverse eigenvalue solvers, and algorithms for constructing solution landscapes. The software offers a user-friendly interface with flexible parameter configuration, tools for trajectory and landscape visualization, and data export capabilities. By providing an efficient and accessible implementation of advanced saddle dynamics, SaddleScape V1.0 facilitates the construction of solution landscapes, empowering researchers in various scientific disciplines to gain deeper insights into the hierarchical structure of complex systems. The source code is available at https://github.com/HiSDpackage/saddlescape. The package’s introductory website is available at https://hisdpackage.github.io/saddlescape.

Fields of Study & Subjects

Protein Structure and Dynamics Model Reduction and Neural Networks Stochastic Gradient Optimization Techniques

Publication details

Journal / source
Journal of Computational Mathematics
Volume
45
Issue
1
Pages
52–100
Publication date
30 September 2026