2. Introduction¶
pSeven Core major features are implemented in the main set of Python modules, the Generic Tools. The pSeven Core toolkit also includes additional components for other tasks and a few more other notable features.
2.1. Generic Tools¶
The Generic Tools are major pSeven Core components, implemented as Python modules.
GTOpt (Generic Tool for Optimization) — optimization problem solver. Supports single- and multi-objective nonlinear optimization, stochastic optimization, mixed-integer problems, surrogate based optimization and other.
— Quick Start — Examples — User’s Guide —
da.p7core.gtopt
— Options
GTApprox (Generic Tool for Approximation) — the tool to train and evaluate approximation models. Provides a wide range of approximation methods for various training sample sizes and dimensions, supports model smoothing, model export and other advanced features.
— Quick Start — Examples — User’s Guide —
da.p7core.gtapprox
— Options
GTSDA (Generic Tool for Sensitivity and Dependency Analysis) — the tool to perform global sensitivity analysis, correlation tests, forward and backward feature selection.
— Quick Start (Correlations) — Quick Start (Sensitivity) — Quick Start (Feature selection) — User’s Guide —
da.p7core.gtsda
— Options
GTDF (Generic Tool for Data Fusion) — advanced approximation tool with the support for multiple training samples of different fidelity.
— Quick Start — Examples — User’s Guide —
da.p7core.gtdf
— Options
GTDoE (Generic Tool for Design of Experiments) — design of experiments generator. Supports batch and sequential generation methods, and adaptive DoE generation.
— Quick Start — Examples — User’s Guide —
da.p7core.gtdoe
— Options
GTDR (Generic Tool for Dimension Reduction) — the tool to train data-based dimension reduction models and apply data compression and decompression.
— Quick Start — Examples — User’s Guide —
da.p7core.gtdr
— Options
2.2. Extras¶
Extras are additional pSeven Core tools and components that are not Python modules. They are included in the package and require pSeven Core installed.
GTModel — C and Java interfaces to GTApprox models.
2.3. Features¶
pSeven Core offers a number of features that enhance its core functionality, adding new capabilities, advanced methods, or improving usability of the package.
- General:
- NumPy integration: pSeven Core is tightly integrated with NumPy, a widely used Python package for scientific computing.
- pandas compatibility: pSeven Core supports pandas data structures as input data for its modeling and data analysis methods.
- Statistical utilities: pSeven Core includes an additional module for calculating elementary statistics, outlier detection and distribution tests.
- Generic Tool for Optimization (GTOpt):
- Evaluation history: GTOpt can save a history of evaluations (variables and calculated values of objectives and constraints), which can then be used for problem analysis, GTApprox model training, and other methods.
- Stochastic problems: GTOpt supports problems with randomized variables.
- Surrogate based optimization: when configuring an optimization problem, you can specify that some of the objective or constraint functions are computationally expensive; when solving, GTOpt will automatically replace such functions with fast GTApprox models in order to reduce the number of real evaluations.
- Generic Tool for Approximation (GTApprox):
- Model export: GTApprox supports model export to various formats, including export to C, both as a shared library and a complete standalone C program.
- Smart technique selection: GTApprox includes many approximation techniques that can be selected manually or automatically; automatic selection is based on training sample properties and carefully selected presets.
- Model smoothing: GTApprox provides several model smoothing methods, including advanced componentwise smoothing for multi-dimensional functions.
- Accuracy evaluation: GTApprox models can include a special function that calculates an estimate of the model’s accuracy at any given point.
- Generic Tool for Data Fusion (GTDF):
- Variable fidelity training data: GTDF includes a basic data fusion method that uses two training samples (fine and coarse), and an advanced method that allows an unlimited number of samples of different fidelity.
- Generic Tool for Design of Experiments (GTDoE):
- Adaptive DoE: in addition to common space-filling DoE generation methods, GTDoE supports adaptive generation that accounts for model properties and allows to train a more accurate GTApprox model with a limited number of real evaluations.
2.4. Non-Regression Tests¶
pSeven Core is routinely tested for stability and performance. The test suite includes non-regression tests for GTOpt and GTApprox.
Detailed description is found in section Non-Regression Tests. This section also includes test results comparing a few latest versions of pSeven Core.
2.5. Documentation¶
pSeven Core documentation contains:
- usage guides for all pSeven Core components (GTOpt, GTApprox, GTDF, GTDoE, GTSDA, GTDR, Statistical Utilities, Extras),
- full API reference,
- system requirements information, installation and license setup guides,
- known issues and version compatibility information,
- quick start tutorials, detailed examples and advanced code samples,
- non-regression test reports, and
- detailed changelog.