Skip to content
Snippets Groups Projects
Commit 2cccd982 authored by Wuttke, Joachim's avatar Wuttke, Joachim
Browse files

[j.0] hugo: explain installation of development snapshot ()

Merging branch 'j.0'  into 'main'.

See merge request !2818
parents e489cbfb 380c2dfe
No related branches found
No related tags found
1 merge request!2818hugo: explain installation of development snapshot
Pipeline #184932 passed
Showing
with 60 additions and 23 deletions
File moved
......@@ -7,8 +7,8 @@ weight = 10
As a prerequisite, Python and some Python modules must be installed.
For the recommended installation under pyenv, see
* [Python on Linux](/installation/py/linux).
* [Python on Mac](/installation/py/mac).
* [Python on Linux](/deploy/py/linux).
* [Python on Mac](/deploy/py/mac).
Further required software:
......@@ -61,7 +61,7 @@ $ sudo apt-get install build-essential git cmake \
If CMake fails with "Could NOT find OpenGL", then install `libgl1-mesa-dev`.
If it fails with "Could NOT find OpenGL (missing: EGL)", then install `libegl1-mesa-dev`.
We assume that Python is [installed under pyenv]({{% relref "installation/py/linux" %}}));
We assume that Python is [installed under pyenv]({{% relref "deploy/py/linux" %}}));
otherwise we also need the packages
```
python3 python3-dev python3-pip python3-numpy python3-matplotlib python3-lmfit
......@@ -80,7 +80,7 @@ $ sudo zypper install gcc-c++ git-core cmake gsl-devel \
libqt6-qtbase-devel libqt6-qttools-devel libqt6-qtsvg-devel
```
We assume that Python is [installed under pyenv]({{% relref "installation/py/linux" %}}));
We assume that Python is [installed under pyenv]({{% relref "deploy/py/linux" %}}));
otherwise we also need the packages
```
python3-devel python3-pip \
......@@ -100,7 +100,7 @@ pip3 install matplotlib numpy
By default, Homebrew installs packages to `/opt/homebrew` or `/usr/local`,
depending on the architecture dependent MacOS version.
Possibly, this path has to be passed to CMake using the argument `-DCMAKE_PREFIX_PATH`
(see the [build instructions]({{% relref "installation/building/unix/build-and-install" %}})).
(see the [build instructions]({{% relref "deploy/building/unix/build-and-install" %}})).
Add Qt to your path environment variable:
```
......
......@@ -41,7 +41,7 @@ Download the **Windows x64 Installer** from the official website [cmake.org/down
#### Python + Packages
Python and some Python modules must be installed, as described in
[Python on Windows](/installation/py/win).
[Python on Windows](/deploy/py/win).
#### SWIG
......
+++
title = "Install BornAgain"
weight = 10
+++
## Installing BornAgain
To install BornAgain from binary packages, follow these platform-specific instructions:
* [Linux](linux)
* [Windows](windows)
* [Mac](macos)
Usually, we recommend installing the latest public release.
However, users who need specific novel features or/and are willing to help us as testers
are welcome to download the latest
* [development snapshot](snapshot)
......@@ -10,7 +10,7 @@ weight = 30
##### Python
As a prerequisite, Python must be installed.
For the recommended installation under pyenv, see [Python on Linux](/installation/py/linux).
For the recommended installation under pyenv, see [Python on Linux](/deploy/py/linux).
##### glibc
......
......@@ -7,7 +7,7 @@ weight = 70
#### Prequisite: Python
As a prerequisite, Python must be installed, see [Python on Mac](/installation/py/mac).
As a prerequisite, Python must be installed, see [Python on Mac](/deploy/py/mac).
#### Install BornAgain as Python-only package
......
+++
title = "Development snapshot"
weight = 90
+++
## Install development snapshot
Usually, we recommend installing the latest public release.
However, users who need specific novel features or/and are willing to help us as testers
are welcome to download the latest development snapshot.
Here, we explain the download path for Windows.
For other platforms, pertinent paths will be easily found by analogy.
Go to the jobs listing at https://jugit.fz-juelich.de/mlz/bornagain/-/jobs.
Look for an entry like
{{< figscg src="/img/job_win_main.png" class="float-left">}}
that has the green tag <img src="/img/job_tag_passed.png"/>,
the gray tag <img src="/img/job_tag_main.png"/>,
and the blue tag <img src="/img/job_tag_win.png"/>.
Follow the link underneath the green "Passed" tag <img src="/img/job_tag_passed.png"/> to page
that shows the build log. On the right margin,
there is a "Job artifacts" section:
{{< figscg src="/img/job_artifacts.png" class="float-left">}}
Follow the link "Browse", then "build", then "installer".
With two more clicks, download the installer.
......@@ -7,7 +7,7 @@ weight = 50
#### Install Python environment
As a prerequisite, Python must be installed, see [Python on Windows](/installation/py/win).
As a prerequisite, Python must be installed, see [Python on Windows](/deploy/py/win).
#### Install BornAgain as a Python package
......@@ -48,7 +48,7 @@ Frequent problems include the following:
This message appears on running `BornAgain.exe` if BornAgain cannot find Python libraries.
If Python is correctly installed on the system according to [Install Python environment]({{% relref "installation/install/windows#install-python-environment" %}}), check if it discoverable by the system. Open command line or PowerShell and type
If Python is correctly installed on the system according to [Install Python environment]({{% relref "deploy/install/windows#install-python-environment" %}}), check if it discoverable by the system. Open command line or PowerShell and type
```
$ python
```
......
......@@ -11,7 +11,7 @@ The only exception is if BornAgain has been specially built
with the flag `BORNAGAIN_PYTHON=OFF`, which results in a GUI app
that has no support for import or export of Python scripts.
Therefore, before [installing](/installation/install) or [building](/installation/building)
Therefore, before [installing](/deploy/install) or [building](/deploy/building)
BornAgain, install Python following these operating-system specific instructions:
* [Python on Linux](linux)
......
......@@ -61,4 +61,4 @@ which python # shows path in virtual environment
# install Python modules
pip install numpy matplotlib corner emcee lmfit scipy tqdm wheel auditwheel setuptools
```
For explanations, see the page on required or recommended [modules](/installation/py/modules/).
For explanations, see the page on required or recommended [modules](/deploy/py/modules/).
File moved
File moved
......@@ -120,7 +120,7 @@ CMake Error at GUI/CMakeLists.txt:18 (find_package):
The error message can also complain about "Qt5Widgets" instead of "Qt5Designer".
First, make sure that all Qt5 libraries are installed as required in the [build instructions]({{% relref "installation/building/unix" %}}).
First, make sure that all Qt5 libraries are installed as required in the [build instructions]({{% relref "deploy/building/unix" %}}).
If this is the case, a first possible cause for this to happen, is that `cmake` cannot find the cmake config files for the required Qt5 modules, because it doesn't know the location. This can be fixed by adding the path to the Qt5 binaries to the `PATH` environment variable:
......
+++
title = "Install BornAgain"
weight = 10
+++
## Installing BornAgain
Here are the platform specific instructions to install BornAgain as a binary.
{{% children %}}
0% Loading or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment