✦

# 4DSTAR Toolbox

Toolbox for 4DSTAR related programs

## Getting Started

Choose a tool from the sidebar to begin your analysis:

LP

### libplugin Bundle Manager

Create, open, and manage plugin bundles build with libplugin.

OC

### OPAT File Inspector

Inspect and analyze OPAT (Opacity Table) files. View table data and explore index vectors.

KM

### Key Management

Manage cryptographic keys for bundle signing and verification.

LC

### libconstants

Access physical constants as defined in libconstants.

SL

### SERiF Libraries

Under Construction....

### Quick Tips

- Use the sidebar navigation to switch between different tools
- Each tool has its own dedicated workspace and features
- File operations and settings are accessible from the top menu bar
- Hover over sidebar icons for quick tool descriptions

LP

# libplugin Bundle Manager

Create, manage, and edit plugin bundles build with libplugin.

## Bundle Management

### 📁 Open Bundle

Load an existing plugin bundle for analysis and modification.

### ➕ Create Bundle

Start a new plugin bundle with custom parameters and configurations.

### 🔧 Build Bundle

Compile and execute plugin bundle.

### About libplugin

The libplugin Bundle Manager provides a comprehensive interface for managing plugin bundles build with libplugin. Users can create new bundles from existing plugins, open and modify existing bundles, and build precompiled dynamic libraries for bundles for other architectures. Docker must be installed and running to build bundles for other architectures.

OC

# OPAT File Inspector

Analyze opacity tables and stellar atmosphere data

## OPAT Analysis Tools

### 📊 Load OPAT File

Import and parse OPAT (Opacity Table) files for detailed inspection.

### 🔍 Explore Data

Navigate through index vectors and examine table structures and metadata.

### 📈 View Tables

Display opacity data in interactive tables with full or filtered views.

### About OPAT Files

OPAT (Opacity Table) files contain crucial stellar atmosphere data including opacity coefficients, temperature and density grids, and related thermodynamic properties used in stellar evolution calculations.

LC

# libconstants

Physical constants and stellar parameters

## Constants Management

### 🔢 Physical Constants

Access fundamental physical constants used in stellar evolution calculations.

### About libconstants

The libconstants module provides a centralized repository of physical constants, conversion factors, and stellar parameters essential for accurate stellar evolution modeling and analysis.

SL

# SERiF Libraries

Stellar Evolution and Rotation in 4D

## SERiF Tools

### 🔨 Under Construction

This page will provide a unified installer and help users get started with SERiF and related libraries.

### About SERiF

SERiF is a stellar structure and evolution program written in C++. This README will eventually provide guidance on how end users (i.e. non SERiF developers) can use the code. However, due to the early stage of development we are in, this README is currently intended only for developers. Its purpose is to provide an overview of the build system, development philosphy, development process, and current state of the code. Further, general information tasks which need doing will also be included (though for more detailed information on this please refer to the issue tracker or the 4DSSE project board)./p>

📚

# Documentation Viewer

Browse and view Doxygen documentation for 4DSTAR libraries

## Available Documentation

### About Documentation

This viewer provides access to Doxygen-generated documentation for various 4DSTAR libraries and tools. Click on any library below to view its documentation in an integrated viewer.

#### Features:

- Browse documentation for multiple libraries
- Integrated iframe viewer for seamless experience
- Quick access to GitHub repositories
- Search and filter by category

## Documentation Viewer

## OPAT File Inspector

#### All Table Tags

#### Data Card Explorer

Select Index Vector:

#### Table Viewer

Click on a table from the 'Data Card Explorer' above to view its data here.

#### Plot Configuration

Index Vector:
Data Table:
X-Axis:
Y-Axis:
Plot Type:
Plot Title:

#### Plot Display

Configure your plot settings above and click "Create Plot" to generate a visualization.

##

### Fill Bundle with Compiled Binaries

Select the targets you want to build and add to the bundle:

Loading available targets...

No fillable targets available. The bundle may already be complete.

#### Build Progress

### Initialize New Plugin

Create a new Meson-based C++ plugin project from an interface header.

Project Name:
Interface Header File:
No file selected
Select Interface to Implement:

##### Methods to implement:

Output Directory:
Version:
libplugin Revision:

### Validate Plugin Project

Check a plugin project's structure and meson.build file for correctness.

Plugin Directory:

### Extract Plugin from Bundle

Extract a plugin's source code from a bundle.

Plugin Name:
Bundle File:
No file selected
Output Directory:

### Compare Plugin Sources

Compare the source code of a plugin between two different bundles.

Plugin Name:
First Bundle:
No file selected
Second Bundle:
No file selected

### Trusted Keys

Manage cryptographic keys for bundle signing and verification.

🔑

### Loading Keys...

Please wait while we load your trusted keys.

### Generate New Key Pair

Create a new cryptographic key pair for signing bundles.

Key Name: Base name for the generated key files
Key Type:
Ed25519 is faster and more secure than RSA
Output Directory: Directory where keys will be saved
⚠️
Security Notice: Keep your private key secure and never share it. Only share the public key (.pub or .pub.pem files) with others who need to verify your bundles.

### Add Trusted Key

Add a public key to your trust store for bundle verification.

ℹ️
Supported formats: .pub, .pub.pem, and .pem files containing public keys.

### Remote Key Sources

Manage Git repositories that contain trusted public keys.

#### Add New Remote Source

Name:
Git Repository URL:
🌐

### Loading Remote Sources...

Please wait while we load your remote key sources.

×

###

Processing...

### Save Metadata Changes

⚠️
Signature Warning: This operation will invalidate the bundle's digital signature. You will need to re-sign the bundle using the Sign button and a PEM private key file.

How would you like to save your metadata changes?

## ⚠️ Signature Warning

This operation will invalidate the bundle's digital signature.

After making changes, you will need to re-sign the bundle using:

- The Sign button in the action bar
- A valid PEM private key file

Do you want to continue?

### About 4DSTAR

#### 4DSTAR Bundle Manager

Author: Emily M. Boudreaux

Version: 1.0.0

Description: A modern bundle management tool for 4DSTAR stellar evolution models, providing an intuitive interface for creating, signing, validating, and filling binary bundles.

🔗 View on GitHub

#### License Information

License: GNU General Public License v3.0

This software is licensed under GPL v3. License text will be added here.

#### Funding & Support

GridFire is a part of the 4D-STAR collaboration. 4D-STAR is funded by European Research Council (ERC) under the Horizon Europe programme (Synergy Grant agreement No. 101071505: 4D-STAR) Work for this project is funded by the European Union. Views and opinions expressed are however those of the author(s) only and do not necessarily reflect those of the European Union or the European Research Council.

#### Help & Documentation

##### Getting Started

- Open Bundle: Click "Open Bundle" to load an existing .fbundle file
- Create Bundle: Click "Create Bundle" to build a new bundle from plugins
- Sign Bundle: Use the Sign button to digitally sign your bundle with a PEM key
- Fill Bundle: Use the Fill tab to compile and add binaries for different platforms

##### Bundle Operations

- Validate: Check bundle integrity and compatibility
- Edit Metadata: Click pencil icons to edit version, author, and comments
- Clear: Remove all compiled binaries from the bundle

×

## Fill Bundle

Select the targets you want to build: