How mala-project/mala works
MALA builds machine-learning surrogates for density-functional-theory data. Users configure descriptor and target calculations, prepare snapshots into scaled datasets, train or optimize a neural network, then predict physical quantities; predictions can also feed an ASE calculator. The graph preserves the documented preprocessing, modeling, and postprocessing capabilities. Some components are supported by the source index or README rather than excerpts, so their relationships are omitted or marked unverified where necessary.
Main entry points: descriptor.py Descriptor base · runner.py Runner · data_handler.py Data handler · target.py Target base
Components 29
Configuration & runtime
- Parameters
mala/common/parameters.py - Parallel runtime
mala/common/parallelizer.py
Physical data
- Physical data I/O
mala/common/physical_data.py - Descriptor base
mala/descriptors/descriptor.py - Bispectrum
mala/descriptors/bispectrum.py - Atomic density
mala/descriptors/atomic_density.py - ACE descriptors
mala/descriptors/ace.py - ACE coupling
mala/descriptors/acelib/coupling_utils.py - Target base
mala/targets/target.py - LDOS targets
mala/targets/ldos.py - DOS targets
mala/targets/dos.py - Density targets
mala/targets/density.py - Calculation helpers
mala/targets/calculation_helpers.py
Data preparation
- Data handler
mala/datahandling/data_handler.py - Handler base
mala/datahandling/data_handler_base.py - Data scaler
mala/datahandling/data_scaler.py - Tensor datasets
mala/datahandling/fast_tensor_dataset.py - Data converter
mala/datahandling/data_converter.py
Modeling
- Neural network
mala/network/network.py - Trainer
mala/network/trainer.py - Runner
mala/network/runner.py - Predictor
mala/network/predictor.py - Hyperparameter optimization
mala/network/hyper_opt.py - Descriptor scoring
mala/network/descriptor_scoring_optimizer.py
Applications
- Trajectory analysis
mala/datageneration/trajectory_analyzer.py - OF-DFT initialization
mala/datageneration/ofdft_initializer.py - ASE calculator
mala/interfaces/ase_calculator.py
Other components
- User
- DFT calculations
Connections 38
- User → Parameters: configures
README.md - Handler base → Parameters: reads settings
mala/datahandling/data_handler_base.py - Data handler → Handler base: extends
mala/datahandling/data_handler.py - Data handler → Data scaler: uses
mala/datahandling/data_handler.py - Data handler → Tensor datasets: loads datasets
mala/datahandling/data_handler.py - Handler base → Descriptor base: creates calculator
mala/datahandling/data_handler_base.py - Handler base → Target base: creates calculator
mala/datahandling/data_handler_base.py - Descriptor base → Parameters: reads settings
mala/descriptors/descriptor.py - Descriptor base → Bispectrum: dispatches descriptor
mala/descriptors/descriptor.py - Descriptor base → Atomic density: dispatches descriptor
mala/descriptors/descriptor.py - Descriptor base → ACE descriptors: dispatches descriptor
mala/descriptors/descriptor.py - ACE descriptors → ACE coupling: uses coupling
mala/descriptors/ace.py - Target base → LDOS targets: dispatches target
mala/targets/target.py - Target base → DOS targets: dispatches target
mala/targets/target.py - Target base → Density targets: dispatches target
mala/targets/target.py - Target base → Calculation helpers: uses calculations
mala/targets/target.py - LDOS targets → DOS targets: uses target
mala/targets/ldos.py - LDOS targets → Density targets: uses target
mala/targets/ldos.py - Density targets → Calculation helpers: uses calculations
mala/targets/density.py - Physical data I/O → Parallel runtime: uses runtime
mala/common/physical_data.py - User → Data handler: prepares data
README.md - User → Trainer: trains model
README.md - Trainer → Runner: uses runner
mala/network/trainer.py - Runner → Neural network: runs network
mala/network/runner.py - Runner → Data handler: consumes data
mala/network/runner.py - Runner → Data scaler: scales data
mala/network/runner.py - Runner → Tensor datasets: batches data
mala/network/runner.py - Predictor → Runner: uses runner
- User → Hyperparameter optimization: optimizes model
- Descriptor scoring → Data converter: converts data
mala/network/descriptor_scoring_optimizer.py - Descriptor scoring → Hyperparameter optimization: uses optimizer
mala/network/descriptor_scoring_optimizer.py - Trajectory analysis → Descriptor base: uses descriptors
mala/datageneration/trajectory_analyzer.py - Trajectory analysis → Parameters: reads settings
mala/datageneration/trajectory_analyzer.py - User → Trajectory analysis: analyzes trajectories
README.md - User → OF-DFT initialization: initializes OF-DFT
README.md - ASE calculator → DFT calculations: interfaces with
- User → ASE calculator: runs predictions
README.md - DFT calculations → Data handler: provides reference data