Properties and units#

Every quantity you author — {"value": 5.0, "unit": "Ah"} under a properties key — is mapped to an EMMO class, and every unit symbol to a unit IRI, by the curated mapping tables under assets/mappings/domain-battery/ — the single source of truth for the semantics of emitted JSON-LD. This page is generated from those tables.

Properties (102)#

The keys accepted in properties={...} on a cell spec, and the EMMO class each becomes in JSON-LD:

Key

EMMO class

ac_internal_resistance

ACInternalResistance

areal_mass

AreaDensity

available_volume

Volume

calendar_life

CalendarLife

cap_assembly_weight

Mass

capacity_fade

CapacityFadeRate

capacity_threshold_exhaustion

EndOfLifeCapacityThreshold

certified_usable_energy

NominalEnergy

charging_capacity

ChargingCapacity

charging_cutoff_voltage

UpperVoltageLimit

charging_energy

ChargingEnergy

charging_temperature_max

MaximumChargingTemperature

charging_temperature_min

MinimumChargingTemperature

charging_time

ChargingTime

charging_voltage

ChargingVoltage

conductivity_activation_energy

ActivationEnergyOfElectrolyteConductivity

continuous_charging_current

MaximumContinuousChargingCurrent

continuous_discharging_current

MaximumContinuousDischargingCurrent

cycle_life

CycleLife

d50_particle_size

D50ParticleSize

dc_internal_resistance

DCInternalResistance

density

Density

diameter

Diameter

diffusivity_activation_energy

ActivationEnergy

discharging_capacity

DischargingCapacity

discharging_cutoff_voltage

LowerVoltageLimit

discharging_energy

DischargingEnergy

discharging_temperature_max

MaximumDischargingTemperature

discharging_temperature_min

MinimumDischargingTemperature

double_side_loading

MassLoading

electrode_area

Area

electrolyte_diffusivity

ChargeCarrierDiffusivityInElectrolyte

electronic_conductivity

ElectronicConductivity

energy_density

EnergyDensity

external_surface_area

Area

foil_thickness

Thickness

height

Height

impedance

ElectricImpedance

initial_coulombic_efficiency

InitialCoulombicEfficiency

internal_resistance

InternalResistance

ionic_conductivity

IonicConductivity

length

Length

mass

Mass

max_concentration

MaximumConcentration

maximum_charging_temperature

MaximumChargingTemperature

maximum_continuous_charging_current

MaximumContinuousChargingCurrent

maximum_continuous_discharging_current

MaximumContinuousDischargingCurrent

maximum_discharging_temperature

MaximumDischargingTemperature

maximum_power

MaximumPower

maximum_pulse_charging_current

MaximumPulseChargingCurrent

maximum_pulse_discharging_current

MaximumPulseDischargingCurrent

maximum_storage_temperature

MaximumStorageTemperature

min_capacity

MinimumCapacity

minimum_capacity

MinimumCapacity

minimum_charging_temperature

MinimumChargingTemperature

minimum_discharging_temperature

MinimumDischargingTemperature

minimum_storage_temperature

MinimumStorageTemperature

n_p_ratio

NPRatio

nominal_capacity

NominalCapacity

nominal_energy

NominalEnergy

nominal_voltage

NominalVoltage

ocp

OpenCircuitVoltage

operating_temperature_max

MaximumOperatingTemperature

operating_temperature_min

MinimumOperatingTemperature

particle_radius

ParticleRadius

porosity

Porosity

power_capability

MaximumPower

power_density

PowerDensity

power_energy_ratio

PowerToEnergyRatio

press_density

CalenderedDensity

pulse_charging_current

MaximumPulseChargingCurrent

pulse_discharging_current

MaximumPulseDischargingCurrent

rated_areal_discharge_capacity

AreicCapacity

rated_capacity

RatedCapacity

rated_energy

NominalEnergy

rated_specific_discharge_capacity

DischargingSpecificCapacity

reaction_rate_activation_energy

ActivationEnergy

reaction_rate_constant

ReactionRateConstant

round_trip_energy_efficiency

RoundTripEnergyEfficiency

self_discharge_rate

SelfDischargeRate

series_resistance

InternalResistance

single_side_loading

MassLoading

specific_capacity

SpecificCapacity

specific_energy

SpecificEnergy

specific_power

SpecificPower

state_of_health

StateOfHealth

stoichiometry_max

MaximumStoichiometricCoefficient

stoichiometry_min

MinimumStoichiometricCoefficient

storage_temperature_max

MaximumStorageTemperature

storage_temperature_min

MinimumStorageTemperature

surface_area_per_volume

VolumetricSurfaceArea

theoretical_capacity

TheoreticalCapacity

thickness

Thickness

tortuosity

Tortuosity

transference_number

ChargeCarrierTransportNumber

typical_capacity

TypicalCapacity

typical_energy

NominalEnergy

upper_voltage_limit

UpperVoltageLimit

volume

Volume

wall_thickness

Thickness

weight

Mass

width

Width

Units (48)#

The unit symbols accepted in quantity dicts, and the unit IRI each maps to (EMMO where a term exists, QUDT as the documented fallback):

Chemistry labels (33)#

The recognised values of chemistry on a cell spec. A label names the electrochemical couple and nothing else. Whether the cell is rechargeable goes in rechargeable, and the electrode materials of a Li-ion cell go in positive_electrode_basis and negative_electrode_basis.

Some labels are narrower than others: a li-mno2 cell is also a li-metal cell. State the narrowest one you know. Matching ignores case, so Li-ion and li-ion are the same label. A value that is not listed is kept as plain text and the record gets no battery class from it.

Label

Narrower than

Battery class

li-ion

LithiumIonBattery

li-metal

LithiumMetalBattery

li-mno2

li-metal

LithiumManganeseDioxideBattery

li-fes2

li-metal

LithiumIronDisulphideBattery

li-cfx

li-metal

LithiumCarbonMonofluorideBattery

li-socl2

li-metal

LithiumThionylChlorideBattery

li-cuo

li-metal

LithiumCopperOxideBattery

li-s

li-metal

LithiumSulfurBattery

li-air

li-metal

LithiumAirBattery

na-ion

SodiumIonBattery

k-ion

PotassiumIonBattery

mg-ion

MagnesiumIonBattery

ca-ion

CalciumIonBattery

zn-mno2

ZincBattery

alkaline-zn-mno2

zn-mno2

AlkalineZincManganeseDioxideBattery

zinc-carbon

zn-mno2

ZincCarbonBattery

leclanche

zinc-carbon

LeclancheBattery

zinc-chloride

zinc-carbon

ZincChlorideBattery

zn-air

ZincAirBattery

zn-hgo

MercuryBattery

ni-mh

NickelMetalHydrideBattery

ni-cd

NickelCadmiumBattery

ni-fe

NickelIronBattery

ni-zn

NickelZincBattery

lead-acid

LeadAcidBattery

al-air

AluminiumAirBattery

fe-air

IronAirBattery

mg-air

MagnesiumAirBattery

si-air

SiliconAirBattery

na-air

SodiumAirBattery

vanadium-flow

VanadiumRedoxFlowBattery

zn-br-flow

ZincBromineFlowBattery

fe-flow

IronRedoxFlowBattery

Older spellings that still resolve. Validation flags them with the label to use instead:

Older label

Use

Why

li-primary

li-metal

Rechargeability is not a chemistry. Write li-metal (or the specific system, e.g. li-mno2) and set rechargeable to false.

alkaline

alkaline-zn-mno2

Alkaline names an electrolyte; several couples use one. Write alkaline-zn-mno2.

znmno2

zn-mno2

Spelling variant. Write zn-mno2.

Unknown keys and symbols are refused, not guessed — see the validation contract for how mapping gaps surface as machine-readable issues.