Update documentation

Author: jhd-old

docs/source/examples.rst

@@ -5,7 +5,6 @@ Below are various example scripts from the ``TransientBVD/examples`` directory,
 demonstrating how to use TransientBVD in different scenarios. Each snippet is
 embedded here for convenient reference.
 
-
 Basic Example
 -------------
 A minimal script showing how to import TransientBVD and call a simple method.
@@ -22,35 +21,36 @@ Demonstrates creating a predefined transducer object and using library methods.
    :language: python
    :linenos:
 
-Decay Time Example
-------------------
-Shows how to compute decay time (τ) in different conditions.
+Deactivation Time Example
+-------------------------------
+Shows how to compute deactivation time (τ) in different conditions for deactivation.
 
-.. literalinclude:: ../../examples/decay_time_example.py
+.. literalinclude:: ../../examples/deactivation_time_example.py
    :language: python
    :linenos:
 
-Decay Time Over Rp Example
---------------------------
-Explores how decay time changes over various parallel resistance values (Rp).
+Deactivation Time Over Rp Example
+----------------------------------------
+Explores how deactivation time changes over various parallel resistance values (Rp)
+in the deactivation scenario.
 
-.. literalinclude:: ../../examples/decay_time_over_rp_example.py
+.. literalinclude:: ../../examples/deactivation_time_over_rp_example.py
    :language: python
    :linenos:
 
 Optimum Resistance Example
 --------------------------
-Uses the library’s optimization routine to find the best Rp for minimal decay.
+Uses the library’s optimization routine to find the best Rp for minimal deactivation time.
 
 .. literalinclude:: ../../examples/optimum_resistance_example.py
    :language: python
    :linenos:
 
-Plot Closed Current Example
----------------------------
-Plots the transient current response under a closed-circuit with overboost.
+Plot Activation Current Example
+-------------------------------
+Plots the transient current response under an activation scenario with overboost.
 
-.. literalinclude:: ../../examples/plot_closed_current_example.py
+.. literalinclude:: ../../examples/activation_current_plot_example.py
    :language: python
    :linenos:
 
@@ -68,4 +68,4 @@ Showcases how to capture and save computation results (e.g., to CSV or JSON).
 
 .. literalinclude:: ../../examples/results_saving_example.py
    :language: python
-   :linenos:
+   :linenos:

docs/source/index.rst

@@ -7,7 +7,7 @@ TransientBVD — Transient Response Analysis
 **TransientBVD** is a Python library for analyzing and optimizing the transient
 response of ultrasound transducers (or other resonant systems) modeled by the
 Butterworth-Van Dyke (BVD) equivalent circuit. It implements advanced methods
-for both open-circuit (resistive damping) and closed-circuit (voltage overboost)
+for both deactivation (resistive damping) and activation (voltage overboost)
 strategies, significantly reducing transient response times.
 
 This library is developed at the
@@ -42,9 +42,9 @@ If you find **TransientBVD** helpful in your own research, please cite:
 
 .. code-block:: bibtex
 
-   @article{doersamSuppeltKupnik2024,
+   @article{doersamTransientBVD2024,
      title     = {Rapid Transient Control Strategies for Ultrasound Transducers},
-     author    = {Dörsam, Jan Helge and Suppelt, Sven and Kupnik, Mario},
+     author    = author    = {Dörsam, Jan H. and Suppelt, Sven and Kleber, Carsten and Altmann, Alexander A. and Schrödel, Yannick and Schmitt, Daniel and Schmitt, Toni and Haugwitz, Christoph and Wismath, Sonja and Soennecken, Soeren and Heyl, Christoph and Kupnik, Mario},
      journal   = {IEEE TRANSACTIONS ON ULTRASONICS, FERROELECTRICS, AND FREQUENCY CONTROL},
      year      = {2025},
      volume    = {??},
@@ -73,12 +73,8 @@ This work was supported through multiple grants and collaborations:
    funding by Austria, Belgium, Czech Republic, Germany, Netherlands, Norway,
    and Spain).
 
-
-
 Indices and tables
 ------------------
 * :ref:`genindex`
 * :ref:`modindex`
 * :ref:`search`
-
-

docs/source/usage.rst

@@ -12,7 +12,7 @@ Use Poetry or pip. Example (pip):
 
 Basic Example
 -------------
-Using open-circuit potential analysis:
+Using deactivation potential analysis:
 
 .. code-block:: python
 
@@ -25,7 +25,7 @@ Using open-circuit potential analysis:
        c0=3970.1e-12
    )
 
-Closed-circuit potential with overboost:
+Activation potential with overboost:
 
 .. code-block:: python