diff --git a/README.md b/README.md index ef25be3..0495e70 100644 --- a/README.md +++ b/README.md @@ -3,20 +3,19 @@ The QNE-ADK is a Quantum Network Explorer - Application Development Kit that all With the ADK you can create your own application using the ``qne application create`` command (see Commands below). An application directory is generated for you with all the necessary files for you to configure and prepare for an experiment. When configuring an application, you specify the different roles and what types of inputs your application uses. In addition, you write the functionality of your application using the NetQASM library. -After creating and configuring an application, you can create an experiment for it using the ``qne experiment create`` command. Also here an experiment directory is generated with all necessary files. When configuring your experiment you can give values to the inputs that were specified when creating your application. You also choose which channels and nodes you use in your network and which role is linked to which node. A network consists of channels and each channel consists of two nodes. The nodes can communicate with each other using the channel between them. +After creating and configuring an application, you can create an experiment for it using the ``qne experiment create`` command. Also, here an experiment directory is generated with all necessary files. When configuring your experiment you can give values to the inputs that were specified when creating your application. You also choose which channels and nodes you use in your network and which role is linked to which node. A network consists of channels and each channel consists of two nodes. The nodes can communicate with each other using the channel between them. Once your experiment is configured you are ready to run it using the ``qne experiment run`` command. Your experiment is parsed and sent to the NetSquid simulator. After some time your experiment run will be finished and a results directory will be generated in which all the results of your experiment are stored. ## Prerequisites -- A modern Linux or MacOS (10 or 11) 64-bit (x86_64) operating system. If you don’t have Linux or MacOS you could run it via virtualization, e.g. using VirtualBox. If you have Windows 10 or 11 you can also use the [Bash on Ubuntu](https://docs.microsoft.com/en-us/windows/wsl/) subsystem. +- A modern Linux or macOS (10 or 11) 64-bit (x86_64) operating system. If you don’t have Linux or macOS you could run it via virtualization, e.g. using VirtualBox. If you have Windows 10 or 11 you can also use the [Bash on Ubuntu](https://docs.microsoft.com/en-us/windows/wsl/) subsystem. - A [virtual environment](https://docs.python.org/3/library/venv.html) should be created and activated before creating an application. - Python version 3.7 or higher and pip version 19 or higher. - NetQASM makes use of SquidASM for which you need credentials in order to use it. These credentials can be obtained by registering on the forum of [NetSquid](https://forum.netsquid.org/). ## Installation - To install all the required packages, execute the following command: ``` @@ -31,17 +30,16 @@ pip install squidasm --extra-index-url=https://{netsquid-user-name}:{netsquid-pa Now everything should be setup and ready in order to create your own applications and experiments and run them on the simulator! -### Troubleshooting - +## Troubleshooting If you have any issues installing SquidASM (e.g. it only seems to use version 0.0.1), check the following: - Make sure you're using the latest version of `pip` (run: `python -m pip install --upgrade pip`) -- Check you're using a supported Python version [here](https://pypi.netsquid.org/netsquid/). In the wheel filenames, cpXX indicates the version - so if you have Python 3.10, but there is no cp310 wheel, it won't work. Check the OS is also compatible. +- Check you're using a supported Python version [here](https://pypi.netsquid.org/netsquid/). In the wheel filenames, cpXX indicates the version - so if you have Python 3.10, but there is no cp310 wheel, switch to a supported version of Python. Check the OS is also compatible. - If `pydynaa` is failing, check the same as above [here](https://pypi.netsquid.org/pydynaa/). -- For help with python versions, check out [pyenv](https://github.com/pyenv/pyenv). You should probably be using [virtualenv](https://virtualenv.pypa.io/en/latest/) or [venv](https://docs.python.org/3/library/venv.html) too. +- For help with Python versions, check out [pyenv](https://github.com/pyenv/pyenv). You should probably be using [virtualenv](https://virtualenv.pypa.io/en/latest/) or [venv](https://docs.python.org/3/library/venv.html) too. ## Commands -The QNE-ADK uses various commands to create and run your applications and experiments. All of the commands are listed below: +The QNE-ADK uses various commands to create and run your applications and experiments. All commands are listed below:
diff --git a/docs/introduction.rst b/docs/introduction.rst index dbc1270..66e126c 100644 --- a/docs/introduction.rst +++ b/docs/introduction.rst @@ -10,7 +10,7 @@ experiment. When configuring an application, you specify the different roles and application uses. In addition, you write the functionality of your application using the NetQASM library. After creating and configuring an application, you can create an experiment for it using the ``qne experiment create`` -command. Also here an experiment directory is generated with all necessary files. When configuring your experiment +command. Also, here an experiment directory is generated with all necessary files. When configuring your experiment you can give values to the inputs that were specified when creating your application. You also choose which channels and nodes you use in your network and which role is linked to which node. A network consists of channels and each channel consists of two nodes. The nodes can communicate with each other using the channel between them. @@ -22,7 +22,7 @@ directory will be generated in which all the results of your experiment are stor Prerequisites ------------- -* A modern Linux or MacOS (10 or 11) 64-bit (x86_64) operating system. If you don't have Linux or MacOS you could run +* A modern Linux or macOS (10 or 11) 64-bit (x86_64) operating system. If you don't have Linux or macOS you could run it via virtualization, e.g. using VirtualBox. If you have Windows 10 or 11 you can also use the `Bash on Ubuntu `_ subsystem. * A `virtual environment `_ should be created and activated before @@ -85,9 +85,22 @@ To build the 'readthedocs' documentation do: The documentation is then build in 'docs/_build/html' and can be viewed `here `_. +Troubleshooting +--------------- +If you have any issues installing SquidASM (e.g. it only seems to use version 0.0.1), check the following: + +- Make sure you're using the latest version of `pip` (run: `python -m pip install --upgrade pip`) +- Check you're using a supported Python version `here `_. In the wheel filenames, + cpXX indicates the version - so if you have Python 3.10, but there is no cp310 wheel, switch to a supported version + of Python. Check the OS is also compatible. +- If `pydynaa` is failing, check the same as above `here `_. +- For help with Python versions, check out `pyenv `_. You should probably be + using `virtualenv `_ + or `venv `_ too. + Commands -------- -The QNE-ADK uses various commands to create and run your applications and experiments. All of the commands are +The QNE-ADK uses various commands to create and run your applications and experiments. All commands are listed below: application list