Software Open Access
SplitFit - a Python package for parameter fitting in quantum chemical calculations
Pospiech, Solveig;
Gericke, Robert
MARC21 XML Export
<?xml version='1.0' encoding='UTF-8'?>
<record xmlns="http://www.loc.gov/MARC21/slim">
<leader>00000nmm##2200000uu#4500</leader>
<datafield tag="999" ind1="C" ind2="5">
<subfield code="x">**Condon:** Speldrich et al. *Journal of Computational Chemistry*, 2017 DOI: [10.1002/jcc.25389](https://doi.org/10.1002/jcc.25389)</subfield>
</datafield>
<datafield tag="999" ind1="C" ind2="5">
<subfield code="x">Till Sawallisch, Dennis Grödler, Adrian Näder, Clara L. Silva, Peter Kaden, Michael Patzschke, Lucia Amidani, Kristina O. Kvashnina, Solveig Pospiech, Jan van Leusen, Moritz Schmidt, Thorsten Stumpf and Robert Gericke, Hexa-Coordinate Actinide(IV) Compounds: Benchmark Complexes for Magnetism and Electronic Structure Analysis, 2026.</subfield>
</datafield>
<datafield tag="245" ind1=" " ind2=" ">
<subfield code="a">SplitFit - a Python package for parameter fitting in quantum chemical calculations</subfield>
</datafield>
<datafield tag="773" ind1=" " ind2=" ">
<subfield code="a">https://www.hzdr.de/publications/Publ-43560</subfield>
<subfield code="i">isIdenticalTo</subfield>
<subfield code="n">url</subfield>
</datafield>
<datafield tag="773" ind1=" " ind2=" ">
<subfield code="a">10.14278/rodare.4735</subfield>
<subfield code="i">isVersionOf</subfield>
<subfield code="n">doi</subfield>
</datafield>
<datafield tag="520" ind1=" " ind2=" ">
<subfield code="a"><p># SplitFit</p>
<p>**Version:** This version of SplitFit was published as used to calculate the values for the publication of</p>
<p>Till Sawallisch, Dennis Gr&ouml;dler, Adrian N&auml;der, Clara L. Silva, Peter Kaden, Michael Patzschke, Lucia Amidani, Kristina O. Kvashnina, Solveig Pospiech, Jan van Leusen, Moritz Schmidt, Thorsten Stumpf and Robert Gericke, Hexa-Coordinate Actinide(IV) Compounds: Benchmark Complexes for Magnetism and Electronic Structure Analysis, 2026.</p>
<p><br>
## Introduction</p>
<p>SplitFit is a Python package for parameter fitting in quantum chemical calculations, specifically designed to optimize fitting of ligand field parameters obtained from CONDON 3. The package uses a combination of Quasi-Monte Carlo (method Sobol) sampling and iterative refinement to find optimal parameter combinations that minimize the difference between calculated and experimental energy levels.</p>
<p>The core workflow involves:</p>
<p>1. Running quantum chemistry calculations via CONDON 3</p>
<p>2. Sampling parameter space using low-discrepancy Sobol sequences</p>
<p>3. Iteratively refining parameter ranges based on best-matching results</p>
<p><br>
## Sampling Methods&nbsp; - Quasi-Monte Carlo (Sobol Sequences)</p>
<p>SplitFit uses **Sobol sequences** as the primary sampling method for exploring the parameter space. Sobol sequences are a type of **low-discrepancy sequence** that provides more uniform coverage of the parameter space compared to pseudo-random sampling.</p>
<p><br>
## Input File Format</p>
<p>The input file (`input.txt`) uses a simple text-based format with sections separated by `--end--` markers. Lines starting with `#` are treated as comments.</p>
<p>### Example `input.txt`</p>
<p>```text<br>
FITINPUT<br>
size_sampling: 8100<br>
fit_loops: 10<br>
fit_ratio: 0.7<br>
fit_threshold: 10</p>
<p>--end--</p>
<p># here are some comments</p>
<p>BKQ</p>
<p>Bkq, lower_limit, upper_limit<br>
B20,&nbsp; 2480, 2884<br>
B40,&nbsp; 4558, 5507<br>
B44,&nbsp; 3214, 3814<br>
B60,&nbsp; 6806, 8173<br>
B64, -8665, -7851</p>
<p>--end--</p>
<p>ENERGYLEVEL</p>
<p>&nbsp; &nbsp;0.00<br>
&nbsp;676.56<br>
&nbsp;988.76<br>
1138.46&nbsp;<br>
1345.10&nbsp;<br>
1569.05<br>
2413.42<br>
2548.75&nbsp;<br>
2630.14</p>
<p>--end--<br>
```</p>
<p><br>
## Configuration</p>
<p>### Config File (`config.yaml`)</p>
<p>```yaml<br>
paths:<br>
&nbsp; input_data: &quot;data/input.txt&quot;&nbsp; &nbsp; &nbsp; # Path to your input.txt file<br>
&nbsp; condon_files: &quot;data/&quot;&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;# Directory containing Condon files and QMC schemes<br>
```</p>
<p><br>
## Output Files</p>
<p>After running, the following files are generated in the `condon_files` directory:</p>
<p>| File | Description |<br>
|------|-------------|<br>
| `BXX_output_XX_orig.dat` | All results from iteration XX (unsorted) |<br>
| `BXX_output_XX.dat` | Sorted results for iteration XX (top % only) |<br>
| `bkq_summary_XX.csv` | Summary statistics with refined parameter ranges for next iteration |</p>
<p><br>
## Workflow Diagram</p>
<p>```<br>
┌─────────────────────────────────────────────────────────────┐<br>
│&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; Configuration Load&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; │<br>
│&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;(config.yaml &rarr; paths_from_config)&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; │<br>
└─────────────────────────────────────────────────────────────┘<br>
&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; │<br>
&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; ▼<br>
┌─────────────────────────────────────────────────────────────┐<br>
│&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; Input File Parsing&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; │<br>
│&nbsp; &nbsp; &nbsp; &nbsp; &nbsp;(input.txt &rarr; fitinput, BKQ_ranges, energylevels)&nbsp; &nbsp; &nbsp;│<br>
└─────────────────────────────────────────────────────────────┘<br>
&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; │<br>
&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; ▼<br>
┌─────────────────────────────────────────────────────────────┐<br>
│&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; Initial Condon Run&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; │<br>
│&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; (Generate fort.* files)&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;│<br>
└─────────────────────────────────────────────────────────────┘<br>
&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; │<br>
&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; ▼<br>
┌─────────────────────────────────────────────────────────────┐<br>
│&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;QMC Sampling Setup&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;│<br>
│&nbsp; &nbsp; (Load Sobol sequence, map to filtered parameter ranges)&nbsp; &nbsp;│<br>
└─────────────────────────────────────────────────────────────┘<br>
&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; │<br>
&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; ▼<br>
┌─────────────────────────────────────────────────────────────┐<br>
│&nbsp; &nbsp; &nbsp;┌─────────────────────────────────────────────────┐&nbsp; &nbsp; &nbsp; │<br>
│&nbsp; &nbsp; &nbsp;│&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; FITTING LOOP (fit_loops)&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;│&nbsp; &nbsp; &nbsp; │<br>
│&nbsp; &nbsp; &nbsp;├─────────────────────────────────────────────────┤&nbsp; &nbsp; &nbsp; │<br>
│&nbsp; &nbsp; &nbsp;│&nbsp; For each sample (size_sampling):&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;│&nbsp; &nbsp; &nbsp; │<br>
│&nbsp; &nbsp; &nbsp;│&nbsp; &nbsp; 1. Get Bxx from QMC&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; │&nbsp; &nbsp; &nbsp; │<br>
│&nbsp; &nbsp; &nbsp;│&nbsp; &nbsp; 2. Update BWYBIN.DAT&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;│&nbsp; &nbsp; &nbsp; │<br>
│&nbsp; &nbsp; &nbsp;│&nbsp; &nbsp; 3. Clear old fort files&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; │&nbsp; &nbsp; &nbsp; │<br>
│&nbsp; &nbsp; &nbsp;│&nbsp; &nbsp; 4. Run Condon&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; │&nbsp; &nbsp; &nbsp; │<br>
│&nbsp; &nbsp; &nbsp;│&nbsp; &nbsp; 5. Extract SQX and energy levels&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;│&nbsp; &nbsp; &nbsp; │<br>
│&nbsp; &nbsp; &nbsp;└─────────────────────────────────────────────────┘&nbsp; &nbsp; &nbsp; │<br>
│&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; │&nbsp; &nbsp; &nbsp; │<br>
│&nbsp; &nbsp; &nbsp;Normalize: sqx_norm + energy_norm&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;│&nbsp; &nbsp; &nbsp; │<br>
│&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; │&nbsp; &nbsp; &nbsp; │<br>
│&nbsp; &nbsp; &nbsp;Score = fit_ratio &times; sqx_norm + (1-fit_ratio) &times; energy_norm │<br>
│&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; │&nbsp; &nbsp; &nbsp; │<br>
│&nbsp; &nbsp; &nbsp;Sort and select top fit_threshold%&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; │&nbsp; &nbsp; &nbsp; │<br>
│&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; │&nbsp; &nbsp; &nbsp; │<br>
│&nbsp; &nbsp; &nbsp;Write: BXX_output_XX.dat, bkq_summary_XX.csv&nbsp; &nbsp; &nbsp; &nbsp;│&nbsp; &nbsp; &nbsp; │<br>
│&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; │&nbsp; &nbsp; &nbsp; │<br>
│&nbsp; &nbsp; &nbsp;Refine ranges for next iteration&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;│&nbsp; &nbsp; &nbsp; │<br>
│&nbsp; &nbsp; &nbsp;└─────────────────────────────────────────────────┘&nbsp; &nbsp; &nbsp; │<br>
└─────────────────────────────────────────────────────────────┘<br>
&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; │<br>
&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; ▼<br>
┌─────────────────────────────────────────────────────────────┐<br>
│&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;Complete&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;│<br>
│&nbsp; &nbsp; &nbsp; &nbsp; (Use bkq_summary_XX.csv for next run or analysis)&nbsp; &nbsp; │<br>
└─────────────────────────────────────────────────────────────┘<br>
```</p>
<p>## Dependencies</p>
<p>- Python &ge; 3.8<br>
- NumPy<br>
- Pandas<br>
- PyYAML</p>
<p><br>
## License</p>
<p>This software is provided for academic use. Please cite the relevant publications when using this code in your research:</p>
<p>- **SplitFit:** Pospiech &amp; Gericke, 2026</p>
<p>- **Condon:** Speldrich et al. *Journal of Computational Chemistry*, 2017 DOI: [10.1002/jcc.25389](https://doi.org/10.1002/jcc.25389)</p>
<p><br>
## Contact For questions regarding this package, please refer to the original publication:</p>
<p>Till Sawallisch, Dennis Gr&ouml;dler, Adrian N&auml;der, Clara L. Silva, Peter Kaden, Michael Patzschke, Lucia Amidani, Kristina O. Kvashnina, Solveig Pospiech, Jan van Leusen, Moritz Schmidt, Thorsten Stumpf and Robert Gericke, Hexa-Coordinate Actinide(IV) Compounds: Benchmark Complexes for Magnetism and Electronic Structure Analysis, 2026.</p></subfield>
</datafield>
<datafield tag="700" ind1=" " ind2=" ">
<subfield code="a">Gericke, Robert</subfield>
<subfield code="0">(orcid)0000-0003-4669-0206</subfield>
</datafield>
<controlfield tag="005">20260715123405.0</controlfield>
<datafield tag="856" ind1="4" ind2=" ">
<subfield code="s">104478130</subfield>
<subfield code="u">https://rodare.hzdr.de/record/4736/files/splitfit_v001.zip</subfield>
<subfield code="z">md5:55b6ba7df1311cae9f5ff94b1cf2434a</subfield>
</datafield>
<controlfield tag="001">4736</controlfield>
<datafield tag="260" ind1=" " ind2=" ">
<subfield code="c">2026-06-25</subfield>
</datafield>
<datafield tag="980" ind1=" " ind2=" ">
<subfield code="a">user-energy</subfield>
</datafield>
<datafield tag="980" ind1=" " ind2=" ">
<subfield code="a">user-rodare</subfield>
</datafield>
<datafield tag="650" ind1="1" ind2="7">
<subfield code="a">cc-by</subfield>
<subfield code="2">opendefinition.org</subfield>
</datafield>
<datafield tag="542" ind1=" " ind2=" ">
<subfield code="l">open</subfield>
</datafield>
<datafield tag="909" ind1="C" ind2="O">
<subfield code="o">oai:rodare.hzdr.de:4736</subfield>
<subfield code="p">software</subfield>
<subfield code="p">user-rodare</subfield>
<subfield code="p">user-energy</subfield>
</datafield>
<datafield tag="980" ind1=" " ind2=" ">
<subfield code="a">software</subfield>
</datafield>
<datafield tag="540" ind1=" " ind2=" ">
<subfield code="u">https://creativecommons.org/licenses/by/4.0/legalcode</subfield>
<subfield code="a">Creative Commons Attribution 4.0 International</subfield>
</datafield>
<datafield tag="024" ind1=" " ind2=" ">
<subfield code="a">10.14278/rodare.4736</subfield>
<subfield code="2">doi</subfield>
</datafield>
<datafield tag="100" ind1=" " ind2=" ">
<subfield code="a">Pospiech, Solveig</subfield>
<subfield code="0">(orcid)0000-0003-2727-2375</subfield>
</datafield>
<datafield tag="041" ind1=" " ind2=" ">
<subfield code="a">eng</subfield>
</datafield>
<datafield tag="653" ind1=" " ind2=" ">
<subfield code="a">python</subfield>
</datafield>
<datafield tag="653" ind1=" " ind2=" ">
<subfield code="a">condon</subfield>
</datafield>
<datafield tag="653" ind1=" " ind2=" ">
<subfield code="a">quantum chemistry</subfield>
</datafield>
</record>
121
1
views
downloads
| All versions | This version | |
|---|---|---|
| Views | 121 | 121 |
| Downloads | 1 | 1 |
| Data volume | 104.5 MB | 104.5 MB |
| Unique views | 101 | 101 |
| Unique downloads | 1 | 1 |
- Publication date:
- June 25, 2026
- DOI:
-
- Keyword(s):
- python condon quantum chemistry
- Related identifiers:
- Identical to:
https://www.hzdr.de/publications/Publ-43560 - Communities:
- License (for files):
- Creative Commons Attribution 4.0 International