Skip to content

Commit dbfb8af

Browse files
Dominik-VogelWilliamHPNielsen
authored andcommitted
New documentation for getting started (#909)
* corrected activate env * updated installation instructions
1 parent bd43328 commit dbfb8af

File tree

1 file changed

+57
-36
lines changed

1 file changed

+57
-36
lines changed

docs/start/index.rst

Lines changed: 57 additions & 36 deletions
Original file line numberDiff line numberDiff line change
@@ -10,71 +10,92 @@ Getting Started
1010
Requirements
1111
------------
1212

13-
For scientist we require to install Anaconda, because it makes
14-
easy to get all dependencies.
15-
Download and install `here <https://www.anaconda.com/download>`_.
16-
Make sure to download the latest version with python 3.6.
13+
You need a working python 3.x installation to be able to use QCoDeS. We highly
14+
recommend installing Anaconda, which takes care of installing Python and
15+
managing packages. In the following it will be assumed that you use Anaconda.
16+
Download and install it from `here <https://www.anaconda.com/download>`_. Make
17+
sure to download the latest version with python 3.6.
1718

18-
Once you download, install Anaconda according to the instructions on screen.
19-
20-
If you use \*nix, you really should use the source.
19+
Once you download, install Anaconda according to the instructions on screen,
20+
choosing the single user installation option.
2121

2222
The next section will guide you through the installation of QCoDeS
23-
on Windows, although most of the things also work for osx and Linux.
24-
(that is, assuming you did not change your $PATH, and or have virtual envs,
25-
but in that case you should once more just use the source)
23+
on Windows, although most of the things also work for macOS and Linux.
2624

2725
Installation
2826
------------
27+
Before you install QCoDeS you have to decide whether you want to install the
28+
latest stable release or if you want to get the developer version from GitHub.
2929

30-
To setup an Anaconda environment for QCoDeS it's convenient to download
31-
QCoDeS environment.yml file from
32-
`here <https://github.com/QCoDeS/Qcodes/blob/master/environment.yml>`__.
33-
Right click on `this link <https://raw.githubusercontent.com/QCoDeS/Qcodes/master/environment.yml>`__
30+
Installing the latest QCoDeS release
31+
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
32+
First download the QCoDeS environment.yml file by right
33+
clicking on `this link <https://raw.githubusercontent.com/QCoDeS/Qcodes/master/environment.yml>`__
3434
and select save link as and download the file to a location
3535
that you can find again.
36-
Once Anaconda is installed and the environment.yml file downloaded
37-
launch an Anaconda Prompt.
36+
Next launch an Anaconda Prompt (start typing anaconda in the start menu and
37+
click on *Anaconda Prompt*).
3838

39-
Now you are ready to install QCoDeS, type in the terminal.
39+
Here type in the prompt:
4040

4141
.. code:: bash
4242
4343
conda env create -f environment.yml
44+
activate qcodes
4445
pip install qcodes
4546
46-
Enter QCoDes
47-
------------
48-
In general follow this steps to get a terminal back:
47+
The first line creates a new anaconda environment that is called *qcodes*
48+
and will install all the required dependendencies. The second line activates
49+
this freshly created environment, so that the command in the third line will
50+
install qcodes for this environment.
4951

52+
Installing QCoDeS from GitHub
53+
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
54+
Clone the QCoDeS repository from GitHub from https://github.com/QCoDeS/Qcodes
55+
Then create an environment, that contains all of the dependencies for QCoDeS,
56+
from the *environment.yml* file in the root of the repository and activate it:
5057

51-
- Open navigator
52-
- On the left side click on "Environments".
53-
- Click qcodes to activate it
54-
- Click the green arrow to open a terminal inside it.
58+
.. code:: bash
5559
56-
Now go to the directory of your experiment, and start a notebook or spyder.
60+
conda env create -f <path-to-environment.yml>
61+
activate qcodes
62+
63+
Finally install QCoDeS add the repository via
5764

5865
.. code:: bash
5966
60-
cd my_experiment
61-
jupyter notebook
67+
pip install -e <path-to-repository>
68+
6269
63-
or
70+
Using QCoDes
71+
------------
72+
For using QCoDeS, as with any other python library, it is useful to use an
73+
application that facilitates the editing and execution of python files. With
74+
Anaconda there come two preinstalled options:
75+
76+
* **Jupyter**, a browser based notebook
77+
* **Spyder**, an integrated development environment
78+
79+
To start either of them you can use the shortcuts in the start menu under
80+
*Anaconda3* with a trailing *(qcodes)*.
81+
82+
For other options you can launch a terminal either via the *Anaconda Navigator*
83+
by selecting *qcodes* in the *Environments tab* and left-clicking on the *play*
84+
button or by entering
6485

6586
.. code:: bash
6687
67-
cd my_experiment
68-
spyder
88+
activate qcodes
89+
90+
in the *Anaconda prompt*
6991

70-
Then:
92+
From the terminal you can then start any other application, such as *IPython* or
93+
just plain old *Python*.
7194

72-
- build quantum computer
73-
- profit
7495

75-
Usage
76-
-----
96+
Getting started
97+
---------------
7798

78-
Read the :ref:`userguide`, and or browse the examples:
99+
Have a look at :ref:`userguide`, and or browse the examples at:
79100

80101
https://github.com/QCoDeS/Qcodes/tree/master/docs/examples

0 commit comments

Comments
 (0)