Professional Documents
Culture Documents
Environments (IDEs)
Contents
Integrated Development Environments (IDEs)
Anaconda
JupyterLab
Sublime
Atom
Print to PDF
The teaching contents of this eBook build on so-called Application Programming Interfaces APIs) and
Integrated Development Environments (IDEs).
An API represents a computing interface that enables interactions between multiple software
intermediaries. Modular programming becomes easy with an API because it systematically hides complex
information that is not necessarily needed to write code according to industry standards. For instance, an
API can define the interface between an application (such as Python or Word) and an Operating System (OS)
such as Windows, Linux, or macOS (also referred to as platform).
An IDE enables the definition of a project to use, for example, a specific Python environment, and it enables
robust coding by pointing out issues directly in the code, even before it ran for the first time. Powerful
IDEs go even further and assist in documenting code with markdown (.md files) and directly pipe into git (see
the Version Control : git).
The answer to this question depends on the platform you are using (e.g., Windows or Linux), your
personal preferences, and your goals.
For writing Python software itself, the Author’s preference is in general Atom (optionally and on
Windows only: PyCharm). To test and run Python code (software) locally, for Windows users, the
installation of Anaconda is almost indispensable. Linux users will be mostly fine with their system
setup without the need to install Anaconda or PyCharm.
For code documentation, examples, and the best learning experience in the Python courses
featured in this eBook, consider installing JupyterLab locally. Windows users find instructions in
the Jupyter on Windows section. Linux users find instructions in the Jupyter on Linux section.
Once you have an IDE installed, carefully read the instructions for installing Python.
Anaconda is the favorite solution for working with the Python tutorials in this eBook on Windows. Linux
users may want to install the text and code editor Atom and optionally Jupyter on Linux.
Anaconda Navigator
Use Anaconda on Windows
Anaconda works well on Windows, but Linux (or also macOS) users will have a better experience
with advanced text editors such as Atom.
Anaconda is a Python and R distribution that enables the usage of a couple of IDEs such as PyCharm, Spyder,
or JupyterLab (Notebook).
The very first step to getting started with Anaconda consists in downloading and installing Anaconda where
students may use the individual license for educational training purposes (note that a commercial license
needs to be purchased for for-profit organizations). On Windows, Anaconda should be installed in the LOCAL
user folder (e.g., C:\users<your-user-name>\AppData\Local). Linux or macOS users find download and
installation instructions directly at the developer’s website, tailored for their specific distribution, even
though they might be better of with Atom.
After the successful installation of Anaconda, IDEs for Python programming or markdown editing can be
Skip
directly installed by launching the Anaconda to main content
navigator. conda environments can be created later, following
the instructions in the conda env (Windows Preference) section.
Learn more about installing Anaconda (with Python) and this eBook’s support package called flusstools in the
Python conda quick guide section and in the video below.
Miniconda
Anaconda may create large environments that require several gigabytes of storage. To install lightweight
environments, use Miniconda. Miniconda does not include Anaconda Navigator and to enable working with
Jupyter notebooks (in Windows):
1. Click on Start.
2. Type Anaconda Prompt and hit enter (use Miniconda3). A Terminal window (black background) opens.
3. In Anaconda prompt type conda install jupyter and confirm with y when the Terminal asks
Proceed ([y]/n)? .
PyCharm is available as a module within Anaconda Navigator (i.e., Anaconda’s graphical user interface). To
enable PyCharm in Anaconda, download PyCharm from the developer’s website and install PyCharm. A reboot
may be required after the installation.
All set - you are ready to edit Python ( .py ), markdown ( .md for documentation), and other file types.
Jupyter is a spin-off of IPython, which is “a rich architecture for interactive computing”. JupyterLab is a
product of the nonprofit organization Project Jupyter, which develops “open-source software, open-
standards, and services for interactive computing across dozens of programming languages”. A Jupyter
Skipof
notebook (.ipynb file) enables the combination to markdown
main content
text blocks with executable code blocks.
Essentially, a Jupyter Notebook is a JavaScript Object Notation (JSON file. The structure of JSON files
enables the easy export of .ipynb notebooks to many other open standard output formats such as HTML,
LaTeX, Markdown, Python, presentation slides, or PDF. The Jupyter kernels support the three core
programming languages Julia, Python and R, and many more Jupyter kernels (currently 49) for other
programming languages exist.
Get familiar with JupyterLab, by creating files, adding new Markdown or Python cells, and running
cells. The essentials of markdown are explained in the Markdown section (short read). Learning
Python is more than a short read and the Python Basics chapter provides some insights (takes
time).
Jupyter on Windows
Anaconda Navigator alternatively provides the application Jupyter Notebook. However, JupyterLab is the
Project Jupyter’s next-generation user interface, which is more flexible and powerful. This is why this
website refers to JupyterLab rather than the Jupyter Notebook app. The following sections explain how to
install it on your Windows computer, either by using the graphical user interface of Anaconda Navigator, or
the conda prompt command line (recommended).
jupyter lab
If the command fails, try either jupyter-lab or start Jupyter notebook by typing jupyter
notebook . The Jupyter Notebook application will open in the default webbrowser.
When reading through the Python tutorials on this website, you will probably find one or another spelling
mistake (please report mistakes!). In particular, the Python sections may be affected because they were
created with JupyterLab, where there is no spell checker pre-installed. To avoid at least the most
unpleasant errors you can install a spellchecker in Jupyter. One solution is to install @ijmbbarrs
spellchecker, which requires installing nodejs (through Anaconda Prompt and in addition to nbextensions):
The spellchecker uses Typo.js as a dictionary and only identifies misspelled words without proposing
corrections. More details on spellchecking are available at the developer’s website.
In the case that several warning messages occur when starting JupyterLab (such as [W 18:49:22.283
NotebookApp] Config option template_path not recognized by LenvsHTMLExporter.
Did you mean one of: template_file, template_name, template_paths? ), downgrade
Jupyter Notebook from version 6.x to 5.6.1 (there is currently an issue with the temp_path variable):
Export the user-level bin to the PATH environment and install JupyterLab in the user space with the
following commands:
export PATH="$HOME/.local/bin:$PATH"
pip install --user jupyterlab
Note
It might be necessary to replace pip with pip3 (depending on the Linux distribution).
jupyter-lab
The command jupyter-lab starts a localhost server that runs JupyterLab, which will open up in a web
browser like an interactive website.
Warning
Closing Terminal will also terminate the localhost that runs JupyterLab. Thus, do not close
Terminal as long as you are working with JupyterLab, in particular, when there are unsaved books.
To install it on Debian Linux platforms, open Terminal and tap (source: https://www.sublimetext.com/docs):
Then select the stable channel (the dev channel has more features but also more bugs):
If an error message occurs, make sure apt works with https sources:
When working with sublime, consider using an advanced spell check package, such as LanguageTool. More
useful packages for sublime can be found at packagecontrol.io. Packages can also be found by hitting the
CTRL + Shift + P keys (in Sublime) to open Package Control. Then, type install and enter the name
of the package you are looking for in the box.
To enable modification of user settings, go to Preferences (top menu bar) > Settings and save the opening
settings file either as
~./config/sublime-text/Packages/Default/Preferences.sublime-settings (recommended
for first-time saving) or
~./config/sublime-text/Packages/User/Preferences.sublime-settings . Then, edit the
desired settings: for instance, look for spell_check and set it to true to default-enable spell
checking. Save the .sublime-settings file to apply changes.
Atom is a hackable text editor that is compatible with almost any programming language. While its bare
installation has little functionality, the omni-compatibility can be enabled by installing desired packages
Skip to main content
(e.g., for Python, Markdown, or LaTex). Another big advantage of Atom is the availability of powerful spell
checker packages.
The Atom developers at GitHub (i.e., Microsoft) announced that they sunset (archive) Atom on
December 15, 2022 read more. That means, no updates and no maintenance are available as of
December 15, 2022, but Atom can still be downloaded. It is not yet clear if Atom will reach its end
of life or if some one will take up the maintenance and development of Atom.
Installation
Linux Windows
Linux users find installers for various distributions at atom.io. Debian (Ubuntu), Red Hat / CentOS, Fedora,
and SUSE find easy installation guides at https://flight-manual.atom.io.
Atom Packages
The following (additional) packages are useful for working with the contents of this eBook:
for Python code formatting, definitions, refactoring (renaming), and many more, ONE of the following
options may be used (avoid installing multiple packages that do the same job):
python-tools
python-black
atom-beautify - make sure to also pip install yapf , and pip install --upgrade
autopep8 and define the autopep8 script directory as autopep8 interpreter of the package
settings (e.g., on Linux set /home/user/venv/vflussenv/bin/autopep8 in Atom > Edit >
Preferences > Packages > Atom Beautify > Settings > Executables > autopep8 > Binary/Script
Path)
script enables to run Python and many other code types (read the docs); after the installation,
running a code (Python) file can be triggered by clicking on the Packages top menu > Script > Run Script.
Spell Checking
The default-installed spell-check package runs basic spellcheck for plain text, GitHub Markdown, AsciiDoc,
and reStructuredText by using the system’s default dictionaries.
If spell-check is not revising the current document, click on the document in question in Atom and open
the Command Palette (Windows: press CTRL + Shift + P ). In the Command Palette type Editor:
Log Cursor Scope . A pop-up window will show the current scope. To make sure that the current scope is
checked by spell-check , open the Atom Settings
Skip to main(on Windows) or Preferences (on Linux) and find the
content
spell-check package. Click on Settings and find the Grammars field. Click in the Grammars field and add
the current scope here. Restart Atom to make sure that the changes are implemented.
Debian Linux users can install the hunspell package with support for many languages:
Warning
linter * packages might conflict with spell-check . If your files are not spell-checked
anymore after installing linter * , roll back the installation of linter and reset
spell-check .
Read more at atom.io for more information on other distributions and dictionaries.
To enable Python compatibility, first, visit the Python (Installation) section and install flusstools
for your system (i.e., either in a virtual or conda environment).
Linux Windows
Open Terminal and activate the environment where flusstools is installed. For instance, if
flusstools is installed in a virtual environment called vflussenv that lives in the user home
cd ~
source vflussenv/bin/activate
Then, start Atom in the (pip or conda) environment through Terminal (Linux) or Anaconda Prompt (Windows):
atom
Atom should open and provide the option to select a folder where a Python project will live or is already
living. After selecting a folder, start editing your Python ( .py ) files. For running Python scripts, there are
two options:
Either go to Packages > Script > Run with profile and select flussprofile
Or press Alt + Ctrl + Shift + B