Added meta data to CellML files.

models-cellml-v1/vc-level-0.cellml

@@ -1,4 +1,43 @@
 <?xml version='1.0' encoding='UTF-8'?>
+<!--
+Model of a voltage-clamp experiment [1-6].
+
+This is the full version of the model, including a 2-pole stimulus filter,
+a 6-pole and 4-pole Bessel output filter, a finite amplifier speed and fast
+capacitance cancellation.
+
+[1] Lei, C. L., Clark, A. P., Clerx, M., Wei, S., Bloothooft, M., De Boer,
+    T., Christini, D. J., Krogh-Madsen, T., & Mirams, G. R. (2025)
+    Resolving Artifacts in Voltage-Clamp Experiments with Computational
+    Modeling: An Application to Fast Sodium Current Recordings. Advanced
+    Science.
+    https://doi.org/10.1002/advs.202500691
+
+[2] Lei, C. L., Clerx, M., Whittaker, D. G., Gavaghan, D. J., De Boer, T.
+    P., & Mirams, G. R. (2020) Accounting for variability in ion current
+    recordings using a mathematical model of artefacts in voltage-clamp
+    experiments. Phil. Trans. R. Soc. A. 378: 20190348
+    https://doi.org/10.1098/rsta.2019.0348
+
+[3] Abrasheva, V. O., Kovalenko, S. G., Slotvitsky, M., Romanova, S. A.,
+    Aitova, A. A., Frolova, S., Tsvelaya, V., & Syunyaev, R. A. (2024)
+    Human sodium current voltage-dependence at physiological temperature
+    measured by coupling a patch-clamp experiment to a mathematical model.
+    J. Physiol., 602: 633-661.
+    https://doi.org/10.1113/JP285162
+
+[4] Weerakoon, P., Culurciello, E., Klemic, K. G., & Sigworth, F. J. (2009)
+    An Integrated Patch-Clamp Potentiostat With Electrode Compensation.
+    IEEE Trans. Biomed. Circ. 3-2: 117-125
+    https://doi.org/10.1109/TBCAS.2008.2005419
+
+[5] Sigworth, F. J. (1995) Electronic design of the patch clamp.
+    In: Single-channel recording (1995): 95-127.
+    https://doi.org/10.1007/978-1-4419-1229-9_4
+
+[6] Clerx, M. (2026) Voltage-clamp model tutorial.
+    https://github.com/CardiacModelling/VoltageClampModel
+-->
 <model xmlns="http://www.cellml.org/cellml/1.1#" xmlns:cellml="http://www.cellml.org/cellml/1.1#" xmlns:cmeta="http://www.cellml.org/metadata/1.0#" xmlns:bqbiol="http://biomodels.net/biology-qualifiers/" xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#" name="voltage_clamp_model_level_0">
   <units name="A_per_F">
     <unit units="gram" multiplier="1000"/>

models-cellml-v1/vc-level-1.cellml

@@ -1,4 +1,44 @@
 <?xml version='1.0' encoding='UTF-8'?>
+<!--
+"Level 1" simplified model of a voltage-clamp experiment [1-6].
+
+Simplifications:
+
+- L1: Output filters replaced by a single filter. All filters implemented
+  as first order.
+
+[1] Lei, C. L., Clark, A. P., Clerx, M., Wei, S., Bloothooft, M., De Boer,
+    T., Christini, D. J., Krogh-Madsen, T., & Mirams, G. R. (2025)
+    Resolving Artifacts in Voltage-Clamp Experiments with Computational
+    Modeling: An Application to Fast Sodium Current Recordings. Advanced
+    Science.
+    https://doi.org/10.1002/advs.202500691
+
+[2] Lei, C. L., Clerx, M., Whittaker, D. G., Gavaghan, D. J., De Boer, T.
+    P., & Mirams, G. R. (2020) Accounting for variability in ion current
+    recordings using a mathematical model of artefacts in voltage-clamp
+    experiments. Phil. Trans. R. Soc. A. 378: 20190348
+    https://doi.org/10.1098/rsta.2019.0348
+
+[3] Abrasheva, V. O., Kovalenko, S. G., Slotvitsky, M., Romanova, S. A.,
+    Aitova, A. A., Frolova, S., Tsvelaya, V., & Syunyaev, R. A. (2024)
+    Human sodium current voltage-dependence at physiological temperature
+    measured by coupling a patch-clamp experiment to a mathematical model.
+    J. Physiol., 602: 633-661.
+    https://doi.org/10.1113/JP285162
+
+[4] Weerakoon, P., Culurciello, E., Klemic, K. G., & Sigworth, F. J. (2009)
+    An Integrated Patch-Clamp Potentiostat With Electrode Compensation.
+    IEEE Trans. Biomed. Circ. 3-2: 117-125
+    https://doi.org/10.1109/TBCAS.2008.2005419
+
+[5] Sigworth, F. J. (1995) Electronic design of the patch clamp.
+    In: Single-channel recording (1995): 95-127.
+    https://doi.org/10.1007/978-1-4419-1229-9_4
+
+[6] Clerx, M. (2026) Voltage-clamp model tutorial.
+    https://github.com/CardiacModelling/VoltageClampModel
+-->
 <model xmlns="http://www.cellml.org/cellml/1.1#" xmlns:cellml="http://www.cellml.org/cellml/1.1#" xmlns:cmeta="http://www.cellml.org/metadata/1.0#" xmlns:bqbiol="http://biomodels.net/biology-qualifiers/" xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#" name="voltage_clamp_model_level_1">
   <units name="A_per_F">
     <unit units="gram" multiplier="1000"/>

models-cellml-v1/vc-level-2.cellml

@@ -1,4 +1,45 @@
 <?xml version='1.0' encoding='UTF-8'?>
+<!--
+"Level 2" simplified model of a voltage-clamp experiment [1-6].
+
+Simplifications:
+
+- L1: Output filters replaced by a single filter. All filters implemented
+  as first order.
+- L2: Idealised op-amp, without stray capacitance Cf.
+
+[1] Lei, C. L., Clark, A. P., Clerx, M., Wei, S., Bloothooft, M., De Boer,
+    T., Christini, D. J., Krogh-Madsen, T., & Mirams, G. R. (2025)
+    Resolving Artifacts in Voltage-Clamp Experiments with Computational
+    Modeling: An Application to Fast Sodium Current Recordings. Advanced
+    Science.
+    https://doi.org/10.1002/advs.202500691
+
+[2] Lei, C. L., Clerx, M., Whittaker, D. G., Gavaghan, D. J., De Boer, T.
+    P., & Mirams, G. R. (2020) Accounting for variability in ion current
+    recordings using a mathematical model of artefacts in voltage-clamp
+    experiments. Phil. Trans. R. Soc. A. 378: 20190348
+    https://doi.org/10.1098/rsta.2019.0348
+
+[3] Abrasheva, V. O., Kovalenko, S. G., Slotvitsky, M., Romanova, S. A.,
+    Aitova, A. A., Frolova, S., Tsvelaya, V., & Syunyaev, R. A. (2024)
+    Human sodium current voltage-dependence at physiological temperature
+    measured by coupling a patch-clamp experiment to a mathematical model.
+    J. Physiol., 602: 633-661.
+    https://doi.org/10.1113/JP285162
+
+[4] Weerakoon, P., Culurciello, E., Klemic, K. G., & Sigworth, F. J. (2009)
+    An Integrated Patch-Clamp Potentiostat With Electrode Compensation.
+    IEEE Trans. Biomed. Circ. 3-2: 117-125
+    https://doi.org/10.1109/TBCAS.2008.2005419
+
+[5] Sigworth, F. J. (1995) Electronic design of the patch clamp.
+    In: Single-channel recording (1995): 95-127.
+    https://doi.org/10.1007/978-1-4419-1229-9_4
+
+[6] Clerx, M. (2026) Voltage-clamp model tutorial.
+    https://github.com/CardiacModelling/VoltageClampModel
+-->
 <model xmlns="http://www.cellml.org/cellml/1.1#" xmlns:cellml="http://www.cellml.org/cellml/1.1#" xmlns:cmeta="http://www.cellml.org/metadata/1.0#" xmlns:bqbiol="http://biomodels.net/biology-qualifiers/" xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#" name="voltage_clamp_model_level_2">
   <units name="A_per_F">
     <unit units="gram" multiplier="1000"/>

models-cellml-v1/vc-level-3.cellml

@@ -1,4 +1,46 @@
 <?xml version='1.0' encoding='UTF-8'?>
+<!--
+"Level 3" simplified model of a voltage-clamp experiment [1-6].
+
+Simplifications:
+
+- L1: Output filters replaced by a single filter. All filters implemented
+  as first order.
+- L2: Idealised op-amp, without stray capacitance Cf.
+- L3: Removed fast capacitative current and its cancellation.
+
+[1] Lei, C. L., Clark, A. P., Clerx, M., Wei, S., Bloothooft, M., De Boer,
+    T., Christini, D. J., Krogh-Madsen, T., & Mirams, G. R. (2025)
+    Resolving Artifacts in Voltage-Clamp Experiments with Computational
+    Modeling: An Application to Fast Sodium Current Recordings. Advanced
+    Science.
+    https://doi.org/10.1002/advs.202500691
+
+[2] Lei, C. L., Clerx, M., Whittaker, D. G., Gavaghan, D. J., De Boer, T.
+    P., & Mirams, G. R. (2020) Accounting for variability in ion current
+    recordings using a mathematical model of artefacts in voltage-clamp
+    experiments. Phil. Trans. R. Soc. A. 378: 20190348
+    https://doi.org/10.1098/rsta.2019.0348
+
+[3] Abrasheva, V. O., Kovalenko, S. G., Slotvitsky, M., Romanova, S. A.,
+    Aitova, A. A., Frolova, S., Tsvelaya, V., & Syunyaev, R. A. (2024)
+    Human sodium current voltage-dependence at physiological temperature
+    measured by coupling a patch-clamp experiment to a mathematical model.
+    J. Physiol., 602: 633-661.
+    https://doi.org/10.1113/JP285162
+
+[4] Weerakoon, P., Culurciello, E., Klemic, K. G., & Sigworth, F. J. (2009)
+    An Integrated Patch-Clamp Potentiostat With Electrode Compensation.
+    IEEE Trans. Biomed. Circ. 3-2: 117-125
+    https://doi.org/10.1109/TBCAS.2008.2005419
+
+[5] Sigworth, F. J. (1995) Electronic design of the patch clamp.
+    In: Single-channel recording (1995): 95-127.
+    https://doi.org/10.1007/978-1-4419-1229-9_4
+
+[6] Clerx, M. (2026) Voltage-clamp model tutorial.
+    https://github.com/CardiacModelling/VoltageClampModel
+-->
 <model xmlns="http://www.cellml.org/cellml/1.1#" xmlns:cellml="http://www.cellml.org/cellml/1.1#" xmlns:cmeta="http://www.cellml.org/metadata/1.0#" xmlns:bqbiol="http://biomodels.net/biology-qualifiers/" xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#" name="voltage_clamp_model_level_3">
   <units name="GOhm">
     <unit units="gram" multiplier="1000000000000"/>

models-cellml-v1/vc-level-4.cellml

@@ -1,4 +1,45 @@
 <?xml version='1.0' encoding='UTF-8'?>
+<!--
+"Level 4" simplified model of a voltage-clamp experiment [1-6].
+
+Simplifications:
+
+- L2: Idealised op-amp, without stray capacitance Cf.
+- L3: Removed fast capacitative current and its cancellation.
+- L4: All filters removed.
+
+[1] Lei, C. L., Clark, A. P., Clerx, M., Wei, S., Bloothooft, M., De Boer,
+    T., Christini, D. J., Krogh-Madsen, T., & Mirams, G. R. (2025)
+    Resolving Artifacts in Voltage-Clamp Experiments with Computational
+    Modeling: An Application to Fast Sodium Current Recordings. Advanced
+    Science.
+    https://doi.org/10.1002/advs.202500691
+
+[2] Lei, C. L., Clerx, M., Whittaker, D. G., Gavaghan, D. J., De Boer, T.
+    P., & Mirams, G. R. (2020) Accounting for variability in ion current
+    recordings using a mathematical model of artefacts in voltage-clamp
+    experiments. Phil. Trans. R. Soc. A. 378: 20190348
+    https://doi.org/10.1098/rsta.2019.0348
+
+[3] Abrasheva, V. O., Kovalenko, S. G., Slotvitsky, M., Romanova, S. A.,
+    Aitova, A. A., Frolova, S., Tsvelaya, V., & Syunyaev, R. A. (2024)
+    Human sodium current voltage-dependence at physiological temperature
+    measured by coupling a patch-clamp experiment to a mathematical model.
+    J. Physiol., 602: 633-661.
+    https://doi.org/10.1113/JP285162
+
+[4] Weerakoon, P., Culurciello, E., Klemic, K. G., & Sigworth, F. J. (2009)
+    An Integrated Patch-Clamp Potentiostat With Electrode Compensation.
+    IEEE Trans. Biomed. Circ. 3-2: 117-125
+    https://doi.org/10.1109/TBCAS.2008.2005419
+
+[5] Sigworth, F. J. (1995) Electronic design of the patch clamp.
+    In: Single-channel recording (1995): 95-127.
+    https://doi.org/10.1007/978-1-4419-1229-9_4
+
+[6] Clerx, M. (2026) Voltage-clamp model tutorial.
+    https://github.com/CardiacModelling/VoltageClampModel
+-->
 <model xmlns="http://www.cellml.org/cellml/1.1#" xmlns:cellml="http://www.cellml.org/cellml/1.1#" xmlns:cmeta="http://www.cellml.org/metadata/1.0#" xmlns:bqbiol="http://biomodels.net/biology-qualifiers/" xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#" name="voltage_clamp_model_level_4">
   <units name="GOhm">
     <unit units="gram" multiplier="1000000000000"/>

models-cellml-v1/vc-level-5.cellml

@@ -1,4 +1,48 @@
 <?xml version='1.0' encoding='UTF-8'?>
+<!--
+"Level 5" simplified model of a voltage-clamp experiment [1-6].
+
+This version assumes perfect slow capacitance cancellation.
+
+Simplifications:
+
+- L2: Idealised op-amp, without stray capacitance Cf.
+- L3: Removed fast capacitative current and its cancellation.
+- L4: All filters removed.
+- L5: Removed charging current and its cancellation.
+
+[1] Lei, C. L., Clark, A. P., Clerx, M., Wei, S., Bloothooft, M., De Boer,
+    T., Christini, D. J., Krogh-Madsen, T., & Mirams, G. R. (2025)
+    Resolving Artifacts in Voltage-Clamp Experiments with Computational
+    Modeling: An Application to Fast Sodium Current Recordings. Advanced
+    Science.
+    https://doi.org/10.1002/advs.202500691
+
+[2] Lei, C. L., Clerx, M., Whittaker, D. G., Gavaghan, D. J., De Boer, T.
+    P., & Mirams, G. R. (2020) Accounting for variability in ion current
+    recordings using a mathematical model of artefacts in voltage-clamp
+    experiments. Phil. Trans. R. Soc. A. 378: 20190348
+    https://doi.org/10.1098/rsta.2019.0348
+
+[3] Abrasheva, V. O., Kovalenko, S. G., Slotvitsky, M., Romanova, S. A.,
+    Aitova, A. A., Frolova, S., Tsvelaya, V., & Syunyaev, R. A. (2024)
+    Human sodium current voltage-dependence at physiological temperature
+    measured by coupling a patch-clamp experiment to a mathematical model.
+    J. Physiol., 602: 633-661.
+    https://doi.org/10.1113/JP285162
+
+[4] Weerakoon, P., Culurciello, E., Klemic, K. G., & Sigworth, F. J. (2009)
+    An Integrated Patch-Clamp Potentiostat With Electrode Compensation.
+    IEEE Trans. Biomed. Circ. 3-2: 117-125
+    https://doi.org/10.1109/TBCAS.2008.2005419
+
+[5] Sigworth, F. J. (1995) Electronic design of the patch clamp.
+    In: Single-channel recording (1995): 95-127.
+    https://doi.org/10.1007/978-1-4419-1229-9_4
+
+[6] Clerx, M. (2026) Voltage-clamp model tutorial.
+    https://github.com/CardiacModelling/VoltageClampModel
+-->
 <model xmlns="http://www.cellml.org/cellml/1.1#" xmlns:cellml="http://www.cellml.org/cellml/1.1#" xmlns:cmeta="http://www.cellml.org/metadata/1.0#" xmlns:bqbiol="http://biomodels.net/biology-qualifiers/" xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#" name="voltage_clamp_model_level_5">
   <units name="GOhm">
     <unit units="gram" multiplier="1000000000000"/>

models-cellml-v2/vc-level-0.cellml

@@ -1,4 +1,43 @@
 <?xml version='1.0' encoding='UTF-8'?>
+<!--
+Model of a voltage-clamp experiment [1-6].
+
+This is the full version of the model, including a 2-pole stimulus filter,
+a 6-pole and 4-pole Bessel output filter, a finite amplifier speed and fast
+capacitance cancellation.
+
+[1] Lei, C. L., Clark, A. P., Clerx, M., Wei, S., Bloothooft, M., De Boer,
+    T., Christini, D. J., Krogh-Madsen, T., & Mirams, G. R. (2025)
+    Resolving Artifacts in Voltage-Clamp Experiments with Computational
+    Modeling: An Application to Fast Sodium Current Recordings. Advanced
+    Science.
+    https://doi.org/10.1002/advs.202500691
+
+[2] Lei, C. L., Clerx, M., Whittaker, D. G., Gavaghan, D. J., De Boer, T.
+    P., & Mirams, G. R. (2020) Accounting for variability in ion current
+    recordings using a mathematical model of artefacts in voltage-clamp
+    experiments. Phil. Trans. R. Soc. A. 378: 20190348
+    https://doi.org/10.1098/rsta.2019.0348
+
+[3] Abrasheva, V. O., Kovalenko, S. G., Slotvitsky, M., Romanova, S. A.,
+    Aitova, A. A., Frolova, S., Tsvelaya, V., & Syunyaev, R. A. (2024)
+    Human sodium current voltage-dependence at physiological temperature
+    measured by coupling a patch-clamp experiment to a mathematical model.
+    J. Physiol., 602: 633-661.
+    https://doi.org/10.1113/JP285162
+
+[4] Weerakoon, P., Culurciello, E., Klemic, K. G., & Sigworth, F. J. (2009)
+    An Integrated Patch-Clamp Potentiostat With Electrode Compensation.
+    IEEE Trans. Biomed. Circ. 3-2: 117-125
+    https://doi.org/10.1109/TBCAS.2008.2005419
+
+[5] Sigworth, F. J. (1995) Electronic design of the patch clamp.
+    In: Single-channel recording (1995): 95-127.
+    https://doi.org/10.1007/978-1-4419-1229-9_4
+
+[6] Clerx, M. (2026) Voltage-clamp model tutorial.
+    https://github.com/CardiacModelling/VoltageClampModel
+-->
 <model xmlns="http://www.cellml.org/cellml/2.0#" xmlns:cellml="http://www.cellml.org/cellml/2.0#" name="voltage_clamp_model_level_0">
   <units name="A_per_F">
     <unit units="gram" multiplier="1000"/>

models-cellml-v2/vc-level-1.cellml

@@ -1,4 +1,44 @@
 <?xml version='1.0' encoding='UTF-8'?>
+<!--
+"Level 1" simplified model of a voltage-clamp experiment [1-6].
+
+Simplifications:
+
+- L1: Output filters replaced by a single filter. All filters implemented
+  as first order.
+
+[1] Lei, C. L., Clark, A. P., Clerx, M., Wei, S., Bloothooft, M., De Boer,
+    T., Christini, D. J., Krogh-Madsen, T., & Mirams, G. R. (2025)
+    Resolving Artifacts in Voltage-Clamp Experiments with Computational
+    Modeling: An Application to Fast Sodium Current Recordings. Advanced
+    Science.
+    https://doi.org/10.1002/advs.202500691
+
+[2] Lei, C. L., Clerx, M., Whittaker, D. G., Gavaghan, D. J., De Boer, T.
+    P., & Mirams, G. R. (2020) Accounting for variability in ion current
+    recordings using a mathematical model of artefacts in voltage-clamp
+    experiments. Phil. Trans. R. Soc. A. 378: 20190348
+    https://doi.org/10.1098/rsta.2019.0348
+
+[3] Abrasheva, V. O., Kovalenko, S. G., Slotvitsky, M., Romanova, S. A.,
+    Aitova, A. A., Frolova, S., Tsvelaya, V., & Syunyaev, R. A. (2024)
+    Human sodium current voltage-dependence at physiological temperature
+    measured by coupling a patch-clamp experiment to a mathematical model.
+    J. Physiol., 602: 633-661.
+    https://doi.org/10.1113/JP285162
+
+[4] Weerakoon, P., Culurciello, E., Klemic, K. G., & Sigworth, F. J. (2009)
+    An Integrated Patch-Clamp Potentiostat With Electrode Compensation.
+    IEEE Trans. Biomed. Circ. 3-2: 117-125
+    https://doi.org/10.1109/TBCAS.2008.2005419
+
+[5] Sigworth, F. J. (1995) Electronic design of the patch clamp.
+    In: Single-channel recording (1995): 95-127.
+    https://doi.org/10.1007/978-1-4419-1229-9_4
+
+[6] Clerx, M. (2026) Voltage-clamp model tutorial.
+    https://github.com/CardiacModelling/VoltageClampModel
+-->
 <model xmlns="http://www.cellml.org/cellml/2.0#" xmlns:cellml="http://www.cellml.org/cellml/2.0#" name="voltage_clamp_model_level_1">
   <units name="A_per_F">
     <unit units="gram" multiplier="1000"/>