Green City Library Help

BatteryType

Template for battery data record. The record includes the following data:

  • VoltageDataFile File of open-circuit-voltage characteristics

    • Uses measurement data to calculate the open-circuit-voltage curve

    • File is saved under GreenCity/Data/ModelData/battery

    • First column in table corresponds to the SoC in % and a support point should be set shortly after an SoC of 0% for stability

    • Second column in table corresponds to the open-circuit cell/module voltage of the battery at the respective SoC

  • ImpedanceDataFile File of impedance characteristics

    • Defines the resistance curve of the battery using a resistance model consisting of 2 ZARC-Element

    • File is saved under GreenCity/Data/ModelData/battery

    • For every table

      • First column in table corresponds to the temperature in K

      • First row in table corresponds to the SoC (value from 0 to 1)

      • Values of the matrix are for the exponents of the Widerstandsmodells P without unit (e.g. table CPE_P1)

      • Values of the matrix are for the resistances of the Widerstandsmodells R in (more precisely in )

      • Values of the matrix are for the capacities of the CPE of the Widerstandsmodells T in F (more precisely in )

  • CapacityDataFile File of capacity characteristics

    • Describes the relative change in capacity as a function of battery temperature

    • File is saved under GreenCity/Data/ModelData/battery

    • For every table

      • First column in table corresponds to the battery temperature in K

      • Second column in table describes the relative minimum or maximum capacity compared to the nominal capacity without unit

  • AgingDataFile Aging data file

    • Describes the aging of the battery cells

    • File is saved under GreenCity/Data/ModelData/battery

    • lambda_Ah

      • First column in table corresponds to the current state of charge SOC in %

      • Second column in table describes the reciprocal of the achievable capacity throughput as a function of the state of charge SOC without unit

      • For a right calculation the first column should have a value at -100% and a value at 200% of the SoC. These values should be the same value at 0% SOC for -100% SOC and at 100% for 200% so that the interpolation of small numerical inaccuracies (e.g. slightly negative values) does not distort the results.

    • lambda_SOC

      • First column in table corresponds to the maximum state of charge difference within a charging or discharging process (SoC from 0-100%) in %

      • Second column in table describes the reciprocal of the number of achievable charge cycles of the battery depending on the maximum state of charge difference within a charging or discharging process without unit

      • For a right calculation the first column should have a value of -100% and a value of 200% of the SoC. These values should correspond to the value at 0% for -100% and at 100% for 200% so that the interpolation of small numerical inaccuracies (e.g. slightly negative values) does not distort the results.

    • lambda_T

      • First column in table corresponds to the battery temperature in K

      • Second column in table describes the ratio of the achievable calendar service life as a function of temperature to the achievable calendar service life at 25°C (35 years) without unit

  • VModuleNom Module voltage in V

  • CModuleNom Module capacity in Ah

  • VModuleMin Minimum module voltage in V

  • VModuleMax Maximum module voltagein V

  • alphaVoc Temperature coefficient of voltage in mV

  • CHeat Heat Capacity in J/K

  • gThermal Heat Conductance in W/K

  • TMax Maximum battery temperature in K

  • TMin Minimum battery temperature in K

20 August 2025