MagBridge-Battery v1.0
========================

License summary
---------------

The MagBridge-Battery v1.0 generated synthetic dataset is released under
CC-BY-4.0. The bridge code, loader, and benchmark scripts are released
under Apache-2.0.

Full license texts:
  - CC-BY-4.0: https://creativecommons.org/licenses/by/4.0/legalcode
  - Apache-2.0: https://www.apache.org/licenses/LICENSE-2.0
  - Human-readable CC-BY-4.0 summary: https://creativecommons.org/licenses/by/4.0/

The Apache-2.0 text governing the code is also reproduced in the
companion file LICENSE-CODE in this bundle. The MIT License notice
referenced by the PulseBat code repository is reproduced in
NOTICE-PULSEBAT.


What is licensed under CC-BY-4.0
--------------------------------

The 6,760 MagBridge-generated synthetic magnetic-signature samples,
their per-row metadata, the two benchmark split files, and the
generation manifest are authored by the MagBridge authors as a derived
synthetic benchmark, and are released under CC-BY-4.0, subject to
attribution of the upstream sources listed below.


What is licensed under Apache-2.0
---------------------------------

The bridge implementation, the minimal Python loader (load_example.py),
the ablation scripts, and the benchmark suite scripts are released
under the Apache License 2.0. See LICENSE-CODE for the full text.


What is NOT redistributed
-------------------------

This release does not contain the raw upstream OSF magnetometry scan
files or the raw PulseBat data files.

The bridge implementation includes compact aggregate statistics
derived from the OSF magnetometry archive --- specifically per-anchor
mean trajectories and per-channel variances across scan positions ---
solely to enable reproducible synthetic generation from the bridge.

PulseBat-derived state labels (SOH, SOC) and feature vectors are used
as conditioning inputs to the bridge; the released records are
MagBridge-generated synthetic outputs and the associated metadata.


Suggested attribution for MagBridge-Battery
-------------------------------------------

  Gunasekar, S. P. and Rangarajan, P. K. "MagBridge-Battery:
  A Synthetic Bridge Dataset for Li-ion Magnetometry and State-of-Health
  Diagnostics." arXiv preprint, 2026.

  Gunasekar, S. P. and Rangarajan, P. K. "MagBridge-Battery v1.0
  [Data set]." Zenodo, 2026. CC-BY-4.0. DOI: 10.5281/zenodo.20260147.

Users of MagBridge-Battery are kindly requested to cite BOTH:
  (1) the paper (primary citation), AND
  (2) the dataset DOI (for the data artifact specifically).

See CITING.md and CITATION.cff for machine-readable and copy-paste forms.


Upstream attribution / notice
-----------------------------

Upstream source 1:
  OSF Battery Magnetometry Data 2019-2020,
  Mohammadi, Jerschow, Hu et al.,
  OSF DOI: 10.17605/OSF.IO/CW8ZV  (https://osf.io/cw8zv/).

  Used by MagBridge-Battery to derive magnetic-morphology statistics
  (per-anchor mean trajectories and per-channel variances). No raw
  OSF scan files are redistributed in this release.

  The OSF project page lists "No License" at the time of
  MagBridge-Battery v1.0 release. The data archive is publicly
  accessible and associated with a peer-reviewed publication. In
  correspondence dated 2026-05-16 the principal investigator
  Prof. Alexej Jerschow granted MagBridge-Battery explicit permission
  for derivative use with citation, with co-authors Geoffrey Iwata,
  Yinan Hu, and Dmitry Budker copied. MagBridge-Battery uses only
  derived statistical aggregates and does not redistribute raw
  upstream files; users wishing to derive their own work from the OSF
  archive should themselves consult the OSF project for any updated
  licensing statement.

  Please cite the OSF archive itself and the associated paper:

    Hu, Y., Iwata, G. Z., Mohammadi, M., Silletta, E. V., Wickenbrock,
    A., Blanchard, J. W., Budker, D., and Jerschow, A. "Sensitive
    magnetometry reveals inhomogeneities in charge storage and weak
    transient internal currents in Li-ion cells." PNAS 117(20):
    10667-10672, 2020. DOI: 10.1073/pnas.1917172117.


Upstream source 2:
  PulseBat dataset, Tao et al.,
  Zenodo DOI: 10.5281/zenodo.13360631
  (https://zenodo.org/records/13360631).

  The PulseBat Zenodo record declares the dataset under the Creative
  Commons Attribution 4.0 International (CC-BY-4.0) license. The
  associated PulseBat code repository on GitHub
  (terencetaothucb/Pulse-Voltage-Response-Generation) is released
  under the MIT License, and its README states that the raw data and
  processed features are accessible under the MIT licence.

  MagBridge-Battery uses PulseBat-derived values (SOH, SOC,
  U-features) as conditioning inputs to the bridge function; it does
  not redistribute the raw PulseBat data files or the PulseBat code.
  MagBridge-Battery provides attribution for the CC-BY-4.0 Zenodo
  record and includes/references the MIT license notice associated
  with the PulseBat GitHub repository (see NOTICE-PULSEBAT).

  Please cite:

    Tao, S., Ma, R., Zhao, Z., et al. "Generative learning assisted
    state-of-health estimation for sustainable battery recycling with
    random retirement conditions." Nature Communications 15: 10154,
    2024. DOI: 10.1038/s41467-024-54454-0.


Third-party data and licenses
-----------------------------

The original upstream datasets remain governed by their respective
authors' licenses and terms. MagBridge-Battery does not relicense
the original OSF Battery Magnetometry Data archive or the original
PulseBat dataset. Users wishing to access or redistribute the raw
upstream data should obtain it from the original sources under the
upstream authors' terms.


License of this LICENSE file
----------------------------

This LICENSE file itself is dedicated to the public domain under the
CC0-1.0 Universal license, so other dataset authors may freely adapt
this wording for their own releases.
