Current collectors#

How to describe current collectors: a current-collector-spec is the foil or mesh product, a current-collector instance is one physical roll or lot. Electrodes usually describe their collector inline; the standalone record is for a foil shared across designs or tracked as its own supply.

The spec is the foil or mesh product; an instance is one physical roll or lot.
The name and material/form derive the typed node: ‘Aluminium foil’ emits [CurrentCollector, Aluminium, Foil].
Electrodes usually embed their collector inline (current_collector holder); the standalone record is for a shared or tracked foil, cited via material_spec_id.
Author with create_current_collector_spec(...) / create_current_collector(spec_id=...).

Define one#

The product#

Python

from battinfo.api import create_current_collector_spec

record = create_current_collector_spec(
    uid="vq83-2hkm-7tpn-9fdx",
    name="Aluminium foil",
    material="Al",
    form="foil",
    property={"thickness": {"value": 15, "unit": "um"}},
    source_type="datasheet",
)

Canonical record

{
  "schema_version": "0.2.0",
  "current_collector_spec": {
    "id": "https://w3id.org/battinfo/spec/7d9k-2m4p-8t3x-6nq5",
    "short_id": "7d9k2m",
    "name": "Aluminium foil",
    "material": "Al",
    "form": "foil",
    "property": {
      "thickness": {
        "value": 15,
        "unit": "um"
      }
    }
  },
  "provenance": {
    "source_type": "datasheet",
    "retrieved_at": 1750000000,
    "battinfo_version": "0.7.0"
  }
}

JSON-LD

Emitted by record_to_jsonld, hosted-context mode.

{
  "@context": [
    "https://w3id.org/emmo/domain/battery/context",
    {
      "schema": "https://schema.org/",
      "dcterms": "http://purl.org/dc/terms/",
      "battinfo": "https://w3id.org/battinfo/"
    }
  ],
  "@type": [
    "Description",
    "schema:ProductModel",
    "schema:CreativeWork"
  ],
  "isDescriptionFor": {
    "@type": [
      "CurrentCollector",
      "Aluminium",
      "Foil"
    ],
    "schema:name": "Aluminium foil",
    "hasProperty": {
      "@type": [
        "Thickness",
        "ConventionalProperty"
      ],
      "skos:prefLabel": "Thickness",
      "hasNumericalPart": {
        "@type": "RealData",
        "hasNumberValue": 15
      },
      "hasMeasurementUnit": "https://w3id.org/emmo#MicroMetre"
    },
    "skos:prefLabel": "Aluminium foil",
    "@id": "https://w3id.org/battinfo/spec/7d9k-2m4p-8t3x-6nq5#described"
  },
  "@id": "https://w3id.org/battinfo/spec/7d9k-2m4p-8t3x-6nq5",
  "schema:name": "Aluminium foil"
}

A physical lot#

Python

from battinfo.api import create_current_collector

record = create_current_collector(
    uid="tr5k-8wq2-3npx-6mvh",
    spec_id="https://w3id.org/battinfo/spec/vq83-2hkm-7tpn-9fdx",
    lot_id="AL15-2026-031",
)

Canonical record

{
  "schema_version": "0.2.0",
  "current_collector": {
    "id": "https://w3id.org/battinfo/current-collector/7d9k-2m4p-8t3x-6nq5",
    "current_collector_spec_id": "https://w3id.org/battinfo/spec/y9xy-kr0v-y5tn-dfj7",
    "short_id": "7d9k2m",
    "lot_id": "AL15-2026-031"
  },
  "provenance": {
    "source_type": "lab",
    "retrieved_at": 1750000000,
    "battinfo_version": "0.7.0"
  }
}

JSON-LD

Emitted by record_to_jsonld, hosted-context mode.

{
  "@context": [
    "https://w3id.org/emmo/domain/battery/context",
    {
      "schema": "https://schema.org/",
      "dcterms": "http://purl.org/dc/terms/",
      "battinfo": "https://w3id.org/battinfo/"
    }
  ],
  "@type": "CurrentCollector",
  "@id": "https://w3id.org/battinfo/current-collector/7d9k-2m4p-8t3x-6nq5",
  "schema:isVariantOf": {
    "@id": "https://w3id.org/battinfo/spec/y9xy-kr0v-y5tn-dfj7"
  }
}

Common examples#

A selection of real, validated records from the packaged examples corpus — each one click away, included from its single source under examples/. The full, living library is the registry: browse it there.

Fields#

Generated from the packaged JSON Schemas — the same files battinfo validate and the registry’s publish gate enforce. Every record also carries the shared envelope (schema_version, provenance, and optional notes, funding, contributor, license). Quantities are {value, unit} maps and may also carry value_basis (Measured, Conventional, Rated, or Nominal) and conditions (the parameters under which the value holds, each itself a quantity; a qualitative condition may be value_text alone). In JSON-LD, conditions ride a measurement node the quantity isOutputOf; the voltage_reference key instead becomes a hasMetrologicalReference datum on the quantity, beside its unit. When authoring, an instance references its spec with the spec_id= kwarg; the record stores the self-describing <type>_spec_id key shown in the tables below.