### NS-3 Python Binding Documentation and Examples #### Overview of NS-3 Python Bindings NS-3 is a discrete-event network simulator used primarily for research and educational purposes. The project has developed Python bindings to allow users to script simulations using Python instead of C++. This provides an easier entry point for new users who are more familiar with Python or prefer its syntax over C++[^1]. #### Installation Process To use the Python bindings, one must first install ns-3 from source code since not all distributions may include this feature by default. After cloning the repository, specific configuration options need enabling during setup to ensure that Python support gets included. For instance, when configuring ns-3, adding `--enable-python` ensures compilation includes necessary components for interfacing with Python scripts: ```bash ./waf configure --enable-examples --enable-tests --enable-python ``` This command prepares the environment so that both tests and examples can be run alongside core functionalities while ensuring compatibility between C++ modules and their corresponding Python interfaces[^2]. #### Example Usage Once installed correctly, creating simple simulation scenarios becomes straightforward through Python scripting. Below demonstrates how to set up two nodes connected via point-to-point links—a common starting scenario in many tutorials: ```python import ns.core import ns.network import ns.point_to_point import ns.applications def main(argv): cmd = ns.core.CommandLine() cmd.Parse(argv) nNodes = 2 ptp = ns.point_to_point.PointToPointHelper() ptp.SetDeviceAttribute("DataRate", ns.core.StringValue("5Mbps")) ptp.SetChannelAttribute("Delay", ns.core.StringValue("2ms")) nodes = ns.network.NodeContainer() nodes.Create(nNodes) pointToPointDevices = ptp.Install(nodes) stack = ns.internet.InternetStackHelper() stack.Install(nodes) address = ns.internet.Ipv4AddressHelper() address.SetBase("10.1.1.0", "255.255.255.0") ipv4Interfaces = address.Assign(pointToPointDevices) if __name__ == '__main__': import sys main(sys.argv[1:]) ``` The above example sets up basic networking elements like devices, channels, addresses, etc., demonstrating fundamental operations within ns-3's framework but now accessible directly from Python without needing any knowledge about underlying C++ implementations[^3]. #### Additional Resources Further exploration into advanced features such as customizing attributes dynamically at runtime, integrating external libraries, or even extending existing models requires consulting official documentation available online along with community-contributed guides found across various platforms including GitHub repositories dedicated specifically towards enhancing usability around these bindings.