DOCS: Update diff vias example (#394)

Co-authored-by: Samuel Lopez <[email protected]>

Author: Devin-Crawford

examples/00_edb/legacy_standalone/differential_vias.py

@@ -1,43 +1,52 @@
-# # EDB: geometry creation
-
-# This example shows how you can use EDB to create a layout.
-# ## Final expected project
+# # Parametric differential vias
+#
+# This example demonstrates how a differential via pair can be created using the EDB Python
+# interface.
+#
+# The final differential via pair is shown below.
 #
 # <img src="_static/diff_via.png" width="500">
+#
+# Keywords: **Differential Via**
 
 
-# ## Perform imports and define constants
+# ## Prerequisites
 #
-# Perform required imports.
+# ### Perform imports
 
-# +
 import os
 import tempfile
-
 import pyedb
-# -
+
+# ### Define constants
+# Constants help ensure consistency and avoid repetition throughout the example.
+
+AEDT_VERSION = "2025.1"
+NG_MODE = False  # Open AEDT UI when it is launched.
+
+temp_folder = tempfile.TemporaryDirectory(suffix=".ansys")
+
+# ### Start the EDB
 
 # +
-temp_dir = tempfile.TemporaryDirectory(suffix=".ansys")
-aedb_path = os.path.join(temp_dir.name, "create_via.aedb")
+aedb_path = os.path.join(temp_folder.name, "diff_via.aedb")
 print(f"AEDB file path: {aedb_path}")
 
-# Select EDB version (change it manually if needed, e.g. "2025.1")
-edb_version = "2025.1"
-print(f"EDB version: {edb_version}")
-
-edb = pyedb.Edb(edbpath=aedb_path, edbversion=edb_version)
+edb = pyedb.Edb(edbpath=aedb_path, edbversion=AEDT_VERSION)
 # -
 
-# ## Add stackup layers
-# Add stackup layers.
-# A stackup can be created layer by layer or imported from a CSV file or XML file.
+# ## Model Creation
+#
+# ### Add stackup layers
+#
+# A stackup can be created layer by layer or imported from a 
+# [configuration file](https://examples.aedt.docs.pyansys.com/version/dev/examples/00_edb/use_configuration/import_stackup.html).
 
 edb.stackup.add_layer("GND")
 edb.stackup.add_layer("Diel", "GND", layer_type="dielectric", thickness="0.1mm", material="FR4_epoxy")
 edb.stackup.add_layer("TOP", "Diel", thickness="0.05mm")
 
-# ## Create signal net and ground planes
+# ### Create signal nets and ground planes
 # Create a signal net and ground planes.
 
 points = [[0.0, 0], [100e-3, 0.0]]
@@ -48,8 +57,7 @@
 edb.modeler.create_polygon(points, "TOP")
 
 
-# ## Create vias with parametric positions
-# Create vias with parametric positions.
+# ## Place vias
 
 edb.padstacks.create("MyVia")
 edb.padstacks.place([5e-3, 5e-3], "MyVia")
@@ -62,26 +70,29 @@
 edb.padstacks.place([45e-3, -5e-3], "MyVia")
 
 
-# ## Generate geometry plot
+# ### View the nets
 
 edb.nets.plot(None, color_by_net=True)
 
-# ## Generate stackup plot
+# ### View the stackup
 
 edb.stackup.plot(plot_definitions="MyVia")
 
-# ## Save and close EDB
+# ## Finish
+#
+# ### Save the project
 # Save and close EDB.
 
 if edb:
     edb.save_edb()
     edb.close_edb()
 print("EDB saved correctly to {}. You can import in AEDT.".format(aedb_path))
 
-# ### Clean up temporary directory
+# ### Clean up
 #
-# The following command removes the project and the temporary directory.
-# If you'd like to save this project, save it to a folder of your choice
-# prior to running the following cell.
+# All project files are saved in the folder ``temp_folder.name``.
+# If you've run this example as a Jupyter notebook, you
+# can retrieve those project files. The following cell
+# removes all temporary files, including the project folder.
 
-temp_dir.cleanup()
+temp_folder.cleanup()