Update documentation for native examples

Author: dieriver

examples/nativeMode/corrRNG/README.md

@@ -0,0 +1,64 @@
+# Correlated Random Number Generator
+
+In this example, we have only two nodes: Alice and Bob.
+
+Alice and Bob will locally connect to their virtual nodes. The classical control communication is done by
+letting Alice run a client and Bob a server. Alice generates the EPR pair, and sends half to Bob. She subsequently
+performs the teleportation operation. She informs Bob of the outcome of the teleportation measurement, as well as the
+identity of the virtual qubit he received (assumed to be unknown to Bob here).
+
+Bob proceeds to recover the teleported qubit.
+
+In this example, we simply print out the initial state to be teleported, as well as the final state received by
+Bob to check whether the teleportation worked correctly.
+
+
+# How to run
+
+To run this example, first make sure that the python virtual environment is activated. You can easily check this
+with the terminal command prompt, which shows the active python virtual environment in parentheses:
+```
+(simulaqron) user@machine_name:~$
+```
+If you don't see the name of the virtual environment, please check the SimulaQron README file to know how to
+create and activate it.
+
+Once the environment is active, we need to start the simulaqron network:
+```bash
+simulaqron start --nodes=Alice,Bob --network-config-file classicalNet.json
+```
+
+This will read the JSON configuration files and start the SimulaQron virtual nodes for nodes `Alice` and `Bob`.
+
+After this, you can simply run the example by using the `run` script:
+```bash
+./run.sh
+```
+
+# How to stop the execution in case the test execution stalls.
+
+To fully stop the execution, you can use the `terninate` script:
+```bash
+./terminate.sh
+```
+
+Us you want to terminate the current execution and start a new one, you can use the `doNew` script. This will stop
+the current execution and run the example once again:
+```bash
+./doNew.sh
+```
+
+
+# Troubleshooting
+
+## Trying to start the network gives "Network with name <name> is already running" message
+
+This usually happens when you stopped the network "manually" by killing processes (`kill -9`). If this happens,
+please make sure that you kill all related processes (use `ps aux | grep python` to search) and then delete the
+PID file for the running network. This file is located in `~/simulaqron_pids` and it is called
+`simulaqron_network_<network_name>.pid`:
+```bash
+rm ~/simulaqron_pids/simulaqron_network_<network_name>.pid
+```
+
+After this, you can try to start the network again.

examples/nativeMode/corrRNG/README.txt

@@ -0,0 +1,55 @@
+# Extended GHZ states
+
+TODO
+
+# How to run
+
+To run this example, first make sure that the python virtual environment is activated. You can easily check this
+with the terminal command prompt, which shows the active python virtual environment in parentheses:
+```
+(simulaqron) user@machine_name:~$
+```
+If you don't see the name of the virtual environment, please check the SimulaQron README file to know how to
+create and activate it.
+
+Once the environment is active, we need to start the simulaqron network:
+```bash
+simulaqron start --nodes=Alice,Bob,Charlie --network-config-file classicalNet.json
+```
+
+This will read the JSON configuration files and start the SimulaQron virtual nodes for nodes `Alice`, `Bob` and
+`Charlie`.
+
+After this, you can simply run the example by using the `run` script:
+```bash
+./run.sh
+```
+
+# How to stop the execution in case the test execution stalls.
+
+To fully stop the execution, you can use the `terninate` script:
+```bash
+./terminate.sh
+```
+
+Us you want to terminate the current execution and start a new one, you can use the `doNew` script. This will stop
+the current execution and run the example once again:
+```bash
+./doNew.sh
+```
+
+
+# Troubleshooting
+
+## Trying to start the network gives "Network with name <name> is already running" message
+
+This usually happens when you stopped the network "manually" by killing processes (`kill -9`). If this happens,
+please make sure that you kill all related processes (use `ps aux | grep python` to search) and then delete the
+PID file for the running network. This file is located in `~/simulaqron_pids` and it is called
+`simulaqron_network_<network_name>.pid`:
+```bash
+rm ~/simulaqron_pids/simulaqron_network_<network_name>.pid
+```
+
+After this, you can try to start the network again.
+

examples/nativeMode/extendGHZ/README.md

@@ -0,0 +1,60 @@
+# Distributed Graph States
+
+In this example Alice, Bob, Charlie and David generate a graph state and transform this into a
+GHZ-like state and measure their qubits to achieve correlated outcomes. For a complete description
+of this example, see the description in the documentation under:
+    * Examples
+        * Programming via SimulaQron's native Python Twisted Interface (specific to SimulaQron)
+            * Distributing a graph state
+
+# How to run
+
+To run this example, first make sure that the python virtual environment is activated. You can easily check this
+with the terminal command prompt, which shows the active python virtual environment in parentheses:
+```
+(simulaqron) user@machine_name:~$
+```
+If you don't see the name of the virtual environment, please check the SimulaQron README file to know how to
+create and activate it.
+
+Once the environment is active, we need to start the simulaqron network:
+```bash
+simulaqron start --nodes=Alice,Bob,Charlie,David --network-config-file classicalNet.json --simulaqron-config-file simulaqron_settings.json
+```
+
+This will read the JSON configuration files and start the SimulaQron virtual nodes for nodes `Alice`, `Bob`,
+`Charlie` and `David`.
+
+After this, you can simply run the example by using the `run` script:
+```bash
+./run.sh
+```
+
+# How to stop the execution in case the test execution stalls.
+
+To fully stop the execution, you can use the `terninate` script:
+```bash
+./terminate.sh
+```
+
+Us you want to terminate the current execution and start a new one, you can use the `doNew` script. This will stop
+the current execution and run the example once again:
+```bash
+./doNew.sh
+```
+
+
+# Troubleshooting
+
+## Trying to start the network gives "Network with name <name> is already running" message
+
+This usually happens when you stopped the network "manually" by killing processes (`kill -9`). If this happens,
+please make sure that you kill all related processes (use `ps aux | grep python` to search) and then delete the
+PID file for the running network. This file is located in `~/simulaqron_pids` and it is called
+`simulaqron_network_<network_name>.pid`:
+```bash
+rm ~/simulaqron_pids/simulaqron_network_<network_name>.pid
+```
+
+After this, you can try to start the network again.
+

examples/nativeMode/extendGHZ/run.sh

@@ -25,7 +25,7 @@ create and activate it.
 
 Once the environment is active, we need to start the simulaqron network:
 ```bash
-siumulaqron start --nodes Alice,Bob
+simulaqron start --nodes Alice,Bob
 ```
 
 This will read the JSON configuration files and start the SimulaQron virtual nodes for nodes `Alice` and `Bob`.
@@ -37,8 +37,13 @@ After this, you can simply run the example by using the `run` script:
 
 # How to stop the execution in case the test execution stalls.
 
-To fully stop the execution, you can use the `doNew` script. This will stop the current execution and run the
-example once again:
+To fully stop the execution, you can use the `terninate` script:
+```bash
+./terminate.sh
+```
+
+Us you want to terminate the current execution and start a new one, you can use the `doNew` script. This will stop
+the current execution and run the example once again:
 ```bash
 ./doNew.sh
 ```
@@ -56,4 +61,4 @@ PID file for the running network. This file is located in `~/simulaqron_pids` an
 rm ~/simulaqron_pids/simulaqron_network_<network_name>.pid
 ```
 
-After this, you can try to start the network again
+After this, you can try to start the network again.

examples/nativeMode/graphState/README.md

@@ -25,7 +25,7 @@ Each one of those nodes defines 3 entries:
 ## Adding new nodes
 
 To add a new node named "Eva", follow these steps:
-1. Open the config.json file in a text editor.
+1. Open the `network_config.json` file in a text editor.
 2. Locate the "nodes" array inside the "default" object.
 3. Add a new object to the "nodes" array for "Eva". The structure should match the existing nodes:
 ```json
@@ -40,8 +40,6 @@ To add a new node named "Eva", follow these steps:
   Replace PORT_NUMBER with unique port numbers for each socket type (e.g., 8851, 8852, 8853). The result should
   look like:
 ```json
-Copy
-
 {
     "name": "default",
     "nodes": [