diff --git a/.gitignore b/.gitignore
index b2a8c02bc2d89c5549f64e9b31e36e7cd0a77dbb..05a38651fc3f861901032005a6d7e5ad811a89a5 100644
--- a/.gitignore
+++ b/.gitignore
@@ -797,3 +797,5 @@ MigrationBackup/
 
 ### JetBrains IDE ###
 .idea
+
+docs/build
\ No newline at end of file
diff --git a/.gitlab-ci.yml b/.gitlab-ci.yml
index 793a5052644470979adce21b097e79cb50e308ec..01b751c70ac63d177cceca99f074e52a0d56147b 100644
--- a/.gitlab-ci.yml
+++ b/.gitlab-ci.yml
@@ -16,6 +16,7 @@
 # along with this program.  If not, see <https://www.gnu.org/licenses/>.
 #
 stages:
+  - docs
   - build_environment
   - pre-build-checks
   - build
@@ -23,6 +24,32 @@ stages:
   - build_installer
   - deploy
 
+
+# Change pip's cache directory to be inside the project directory since we can
+# only cache local items.
+variables:
+  PIP_CACHE_DIR: "$CI_PROJECT_DIR/.cache/pip"
+
+cache:
+  paths:
+    - .cache/pip
+
+# Documentation build, so we know it can be built and can download the website as an artifact
+sphinx:
+  image: python:3.10
+  stage: docs
+  script:
+    - cd docs
+    - pip install -r requirements.txt
+    - make html
+    - mv build/html/ ../public/
+  artifacts:
+    paths:
+      - public
+  rules:
+    - if: $CI_COMMIT_BRANCH == $CI_DEFAULT_BRANCH
+    - if: $CI_PIPELINE_SOURCE == "merge_request_event"
+
 ###############################################################################
 # Linux CI
 ###############################################################################
diff --git a/docs/.readthedocs.yaml b/docs/.readthedocs.yaml
new file mode 100644
index 0000000000000000000000000000000000000000..bf97e7c6308db548717253985cffeba2e1b03b57
--- /dev/null
+++ b/docs/.readthedocs.yaml
@@ -0,0 +1,18 @@
+version: "2"
+
+build:
+  os: "ubuntu-22.04"
+  tools:
+    python: "3.10"
+
+python:
+  install:
+    - requirements: docs/requirements.txt
+
+sphinx:
+  configuration: docs/source/conf.py
+
+
+formats:
+  - pdf
+  - epub
\ No newline at end of file
diff --git a/docs/Makefile b/docs/Makefile
new file mode 100644
index 0000000000000000000000000000000000000000..1e442609e5f5752ab40e80f10eccbe00d2153540
--- /dev/null
+++ b/docs/Makefile
@@ -0,0 +1,20 @@
+# Minimal makefile for Sphinx documentation
+#
+
+# You can set these variables from the command line, and also
+# from the environment for the first two.
+SPHINXOPTS    ?= -T -E -d doctree -b html
+SPHINXBUILD   ?= sphinx-build
+SOURCEDIR     = source
+BUILDDIR      = build
+
+# Put it first so that "make" without argument is like "make help".
+help:
+	@$(SPHINXBUILD) -M help "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O)
+
+.PHONY: help Makefile
+
+# Catch-all target: route all unknown targets to Sphinx using the new
+# "make mode" option.  $(O) is meant as a shortcut for $(SPHINXOPTS).
+%: Makefile
+	@$(SPHINXBUILD) -M $@ "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O)
diff --git a/docs/make.bat b/docs/make.bat
new file mode 100644
index 0000000000000000000000000000000000000000..9534b018135ed7d5caed6298980c55e8b1d2ec82
--- /dev/null
+++ b/docs/make.bat
@@ -0,0 +1,35 @@
+@ECHO OFF
+
+pushd %~dp0
+
+REM Command file for Sphinx documentation
+
+if "%SPHINXBUILD%" == "" (
+	set SPHINXBUILD=sphinx-build
+)
+set SOURCEDIR=source
+set BUILDDIR=build
+
+if "%1" == "" goto help
+
+%SPHINXBUILD% >NUL 2>NUL
+if errorlevel 9009 (
+	echo.
+	echo.The 'sphinx-build' command was not found. Make sure you have Sphinx
+	echo.installed, then set the SPHINXBUILD environment variable to point
+	echo.to the full path of the 'sphinx-build' executable. Alternatively you
+	echo.may add the Sphinx directory to PATH.
+	echo.
+	echo.If you don't have Sphinx installed, grab it from
+	echo.http://sphinx-doc.org/
+	exit /b 1
+)
+
+%SPHINXBUILD% -M %1 %SOURCEDIR% %BUILDDIR% %SPHINXOPTS% %O%
+goto end
+
+:help
+%SPHINXBUILD% -M help %SOURCEDIR% %BUILDDIR% %SPHINXOPTS% %O%
+
+:end
+popd
diff --git a/docs/requirements.txt b/docs/requirements.txt
new file mode 100644
index 0000000000000000000000000000000000000000..43f17944234cdcad4be97e0a3739e14af0b66515
--- /dev/null
+++ b/docs/requirements.txt
@@ -0,0 +1,7 @@
+sphinx~=6.2.1
+sphinx_design==0.5.0
+sphinx-book-theme==1.0.1
+sphinx-favicon==1.0.1
+sphinx-notfound-page==1.0.0
+myst-parser==2.0.0
+sphinx-tippy==0.4.1
\ No newline at end of file
diff --git a/docs/source/_static/css/custom.css b/docs/source/_static/css/custom.css
new file mode 100644
index 0000000000000000000000000000000000000000..cf6a224a2bd08d76a478f4a25f08d20a884fa960
--- /dev/null
+++ b/docs/source/_static/css/custom.css
@@ -0,0 +1,54 @@
+/* Provided by Sphinx's 'basic' theme, and included in the final set of assets */
+@import "../basic.css";
+
+:root {
+    /*Set main color to match color of main logo color */
+    --pst-color-primary: 74, 163, 196;
+    --pst-font-size-base: 15px;
+}
+
+.bd-header-announcement {
+    background-color: rgb(221, 21, 21) !important;
+}
+
+img {
+    /* align center default for images */
+    display: block;
+    margin-left: auto;
+    margin-right: auto;
+}
+
+h1,
+h2 {
+    color: #4AA3C4 !important;
+    font-weight: bolder;
+}
+
+h3,
+h4,
+h5,
+h6 {
+    color: #4AA3C4 !important;
+}
+
+/* Main index page overview cards */
+
+.intro-card {
+    padding: 10px 10px 10px 10px;
+}
+
+.intro-card .sd-card-img-top {
+    margin: 0px;
+    height: 80px;
+    background: none !important;
+}
+
+.intro-card .sd-card-title {
+    color: var(--pst-color-primary);
+    font-size: var(--pst-font-size-h5);
+    padding: 0rem 0rem 0.25rem 0rem;
+}
+
+.intro-card .sd-card-hover {
+    border-color: color: var(--pst-color-primary) transform: scale(2.01);
+}
\ No newline at end of file
diff --git a/docs/source/_static/css/tippy.css b/docs/source/_static/css/tippy.css
new file mode 100644
index 0000000000000000000000000000000000000000..b19b2eb848a2a7dd382dbb2396b139b3bac84993
--- /dev/null
+++ b/docs/source/_static/css/tippy.css
@@ -0,0 +1,5 @@
+.tippy-box {
+    background-color: var(--pst-color-surface);
+    color: var(--pst-color-text-base);
+    border: 1px solid var(--pst-color-border);
+}
\ No newline at end of file
diff --git a/docs/source/_static/favicon.svg b/docs/source/_static/favicon.svg
new file mode 100644
index 0000000000000000000000000000000000000000..a2916716c45c58fc06be6acac977999066e66a4f
--- /dev/null
+++ b/docs/source/_static/favicon.svg
@@ -0,0 +1,60 @@
+<?xml version="1.0" encoding="UTF-8" standalone="no"?>
+<svg
+   xmlns:dc="http://purl.org/dc/elements/1.1/"
+   xmlns:cc="http://creativecommons.org/ns#"
+   xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"
+   xmlns:svg="http://www.w3.org/2000/svg"
+   xmlns="http://www.w3.org/2000/svg"
+   xmlns:sodipodi="http://sodipodi.sourceforge.net/DTD/sodipodi-0.dtd"
+   xmlns:inkscape="http://www.inkscape.org/namespaces/inkscape"
+   sodipodi:docname="favicon.svg"
+   inkscape:version="1.0 (4035a4fb49, 2020-05-01)"
+   id="svg8"
+   version="1.1"
+   viewBox="0 0 11.035559 16.761164"
+   height="16.761164mm"
+   width="11.035559mm">
+  <defs
+     id="defs2" />
+  <sodipodi:namedview
+     inkscape:window-maximized="1"
+     inkscape:window-y="-8"
+     inkscape:window-x="-8"
+     inkscape:window-height="1017"
+     inkscape:window-width="1920"
+     showgrid="false"
+     inkscape:document-rotation="0"
+     inkscape:current-layer="layer1"
+     inkscape:document-units="mm"
+     inkscape:cy="31.479478"
+     inkscape:cx="29.892636"
+     inkscape:zoom="11.2"
+     inkscape:pageshadow="2"
+     inkscape:pageopacity="0.0"
+     borderopacity="1.0"
+     bordercolor="#666666"
+     pagecolor="#ffffff"
+     id="base" />
+  <metadata
+     id="metadata5">
+    <rdf:RDF>
+      <cc:Work
+         rdf:about="">
+        <dc:format>image/svg+xml</dc:format>
+        <dc:type
+           rdf:resource="http://purl.org/dc/dcmitype/StillImage" />
+        <dc:title></dc:title>
+      </cc:Work>
+    </rdf:RDF>
+  </metadata>
+  <g
+     transform="translate(-124.53548,-133.03746)"
+     id="layer1"
+     inkscape:groupmode="layer"
+     inkscape:label="Ebene 1">
+    <path
+       id="path24"
+       d="m 128.43631,149.45371 c -5.5152,-2.46896 -5.06229,-14.75146 0.60018,-16.27621 4.88446,-1.31524 8.35003,6.91015 5.5111,13.08038 -1.34189,2.9165 -3.82942,4.21733 -6.11128,3.19583 z m 3.33431,-1.2776 c 2.03828,-1.3497 3.28741,-5.56477 2.61534,-8.82521 -0.4048,-1.96379 -0.86584,-2.88903 -2.06146,-4.13703 -1.05851,-1.10489 -2.30392,-1.48138 -3.26502,-0.987 -3.56324,1.83288 -4.71988,7.91584 -2.3081,12.1387 1.32226,2.3152 3.22215,3.00053 5.01924,1.81054 z m -2.14368,-5.09323 v -1.19063 h -1.19063 c -1.01423,0 -1.19062,-0.0784 -1.19062,-0.52916 0,-0.45078 0.17639,-0.52917 1.19062,-0.52917 h 1.19063 v -1.19063 c 0,-1.01423 0.0784,-1.19062 0.52916,-1.19062 0.45078,0 0.52917,0.17639 0.52917,1.19062 v 1.19063 h 1.19063 c 1.01423,0 1.19062,0.0784 1.19062,0.52917 0,0.45077 -0.17639,0.52916 -1.19062,0.52916 h -1.19063 v 1.19063 c 0,1.01423 -0.0784,1.19062 -0.52917,1.19062 -0.45077,0 -0.52916,-0.17639 -0.52916,-1.19062 z"
+       style="fill:#000000;stroke-width:0.264583" />
+  </g>
+</svg>
diff --git a/docs/source/_static/logo.png b/docs/source/_static/logo.png
new file mode 100644
index 0000000000000000000000000000000000000000..7e1c794c8e331a3d3db07d724a3af55673c1f3b4
Binary files /dev/null and b/docs/source/_static/logo.png differ
diff --git a/docs/source/calibration/calibration.md b/docs/source/calibration/calibration.md
new file mode 100644
index 0000000000000000000000000000000000000000..306fdb01554ecad42bcc0d53d19606ac8d06da46
--- /dev/null
+++ b/docs/source/calibration/calibration.md
@@ -0,0 +1,11 @@
+# Calibration
+
+Das ist die Kapiteluebersicht zu Kalibration. Hier kriegt man kurz erklaert, was Kalibration ist, wieso sie wichtig ist, und wird auf weitere Seiten weitergeleitet.
+
+## Contents
+
+:::{toctree}
+:maxdepth: 1
+intrinsic_calibration
+extrinsic_calibration
+:::
\ No newline at end of file
diff --git a/docs/source/calibration/extrinsic_calibration.md b/docs/source/calibration/extrinsic_calibration.md
new file mode 100644
index 0000000000000000000000000000000000000000..ef3623fb418d0a1963e544eef4c33abaea0ff47b
--- /dev/null
+++ b/docs/source/calibration/extrinsic_calibration.md
@@ -0,0 +1,3 @@
+# Extrinsic Calibration
+
+Page about extrinsic calibration.
\ No newline at end of file
diff --git a/docs/source/calibration/intrinsic_calibration.md b/docs/source/calibration/intrinsic_calibration.md
new file mode 100644
index 0000000000000000000000000000000000000000..8760a3223ffb7b4f879ac1e3466aba89ea820262
--- /dev/null
+++ b/docs/source/calibration/intrinsic_calibration.md
@@ -0,0 +1,5 @@
+# Intrinsic Calibration
+
+Page about intrinsic calibration.
+
+Wir haben eine Aenderung.
\ No newline at end of file
diff --git a/docs/source/conf.py b/docs/source/conf.py
new file mode 100644
index 0000000000000000000000000000000000000000..b9033047f42dd078d6d83b59279678b5bbfa715f
--- /dev/null
+++ b/docs/source/conf.py
@@ -0,0 +1,107 @@
+# Configuration file for the Sphinx documentation builder.
+
+# -- Project information
+import datetime
+
+current_year = datetime.datetime.today().year
+
+project = "PeTrack"
+copyright = f"{current_year}, Forschungszentrum Jülich GmbH, IAS-7"
+
+import os
+import re
+dir_path = os.path.dirname(os.path.realpath(__file__))
+
+with open(f"{dir_path}/../../CMakeLists.txt") as file:
+    for line in file:
+        match = re.search("project\(petrack LANGUAGES CXX VERSION ([0-9]+\.[0-9]+\.[0-9]+)\)", line)
+        if match is not None:
+            version = match[1]
+            break
+    else:
+        raise RuntimeError("Version not found")
+
+#version = '0.1.0'
+release = version
+
+# -- General configuration
+
+extensions = [
+    'sphinx.ext.duration',
+    'sphinx.ext.doctest',
+    'sphinx.ext.intersphinx',
+    "sphinx_design",
+    "sphinx.ext.napoleon",
+    "sphinx.ext.mathjax",
+    "sphinx_favicon",
+    "notfound.extension",
+    "myst_parser",
+    "sphinx_tippy"
+]
+
+myst_enable_extensions = [
+    "colon_fence",
+    "html_image",
+    "attrs_inline",
+    "attrs_block",
+    "dollarmath"
+]
+
+myst_url_schemes = {
+    "http": None,
+    "https": None,
+    "wiki": "https://en.wikipedia.org/wiki/{{path}}#{{fragment}}",
+    "doi": "https://doi.org/{{path}}",
+}
+
+myst_heading_anchors = 7
+
+
+intersphinx_mapping = {
+    'python': ('https://docs.python.org/3/', None),
+    'sphinx': ('https://www.sphinx-doc.org/en/master/', None),
+}
+intersphinx_disabled_domains = ['std']
+
+templates_path = ['_templates']
+
+# -- Options for HTML output
+
+html_theme = 'sphinx_book_theme'
+html_static_path = ["_static"]
+
+html_logo = "_static/logo.png"
+html_favicon = "_static/favicon.svg"
+
+html_css_files = ["css/custom.css", "css/tippy.css"]
+html_context = {"default_mode": "light"}
+
+html_theme_options = {
+    "show_nav_level": 5,
+    "use_fullscreen_button": False,
+    "use_issues_button": False,
+    "use_download_button": False,
+    "article_header_end": ["breadcrumbs", "toggle-secondary-sidebar"],
+    "icon_links": [
+        {
+            "name": "GitLab",
+            "url": "https://jugit.fz-juelich.de/ped-dyn-emp/petrack",
+            "icon": "fa-brands fa-square-gitlab",
+        },
+        {
+            "name": "DOI",
+            "url": "https://zenodo.org/doi/10.5281/zenodo.5078176",
+            "icon": "https://zenodo.org/badge/DOI/10.5281/zenodo.5078176.svg",
+            "type": "url",
+        },
+    ],
+    "show_toc_level": 3,
+    "announcement": "🚧 This documentation is still under construction! In the meanwhile, please visit <a href='https://go.fzj.de/petrack-wiki'>the wiki</a> instead. 🚧"
+}
+
+html_sidebars = {
+    "**": ["navbar-logo", "icon-links", "search-field", "sbt-sidebar-nav.html"]
+}
+
+# -- Options for EPUB output
+epub_show_urls = 'footnote'
diff --git a/docs/source/contribute/contribute.md b/docs/source/contribute/contribute.md
new file mode 100644
index 0000000000000000000000000000000000000000..6c747a93c3f0e317cc56970ac7677bc1b4873e4f
--- /dev/null
+++ b/docs/source/contribute/contribute.md
@@ -0,0 +1,10 @@
+# Contribute
+
+There are many ways to contribute to PeTrack.
+
+## Contents
+
+:::{toctree}
+:maxdepth: 1
+documentation
+:::
\ No newline at end of file
diff --git a/docs/source/contribute/documentation.md b/docs/source/contribute/documentation.md
new file mode 100644
index 0000000000000000000000000000000000000000..72e5280d725f29d29c8f613c48766caeaf281991
--- /dev/null
+++ b/docs/source/contribute/documentation.md
@@ -0,0 +1,46 @@
+# Contributing to Documentation
+
+We document PeTrack using Markdown files which are part of our git repository.
+These are then processes by Sphinx into our documentation site. The website is
+automatically deployed, once the changes on the source files are part of the
+master branch. If you want to contribute to the documentation, some local setup
+is needed.
+
+## Environment Setup
+
+First of all, you need to have cloned the repository. (**TODO**: link to other
+document, explaining how to clone (and build) PeTrack). Note that you **do not
+need to build PeTrack**, you just need the repository for the documentation
+files. Then you can edit the markdown files in the `docs/source/` directory. Any
+texteditor can be used for this. If you do not have an preferred text editor, we
+recommend VSCode (note that VSCode has a MyST-Markdown extension).
+
+To be able to build the documentation locally to see how the resulting webpage
+looks, you furthermore need to install Python. Once you have a working Python
+installation, create a virtual environment with the command `python -m venv
+/path/to/new/virtual/environment`. This environment needs to be activated in the
+shell you'll use for building the documentation. You can activate the venv with
+the command `<venv>\Scripts\activate.bat` on Windows or `source
+<venv>/bin/activate` on Linux. Then we can install the needed dependencies for
+building the documentation with the by changing the directory in the shell to
+`docs` and running `pip install -r requirements.txt`. Now you can compile the
+documentation by running `make.bat html` on Windows, or `make html` on Linux or
+MacOS. For a smoother local developement experience, you can install
+`sphinx-build` via the command `pip install sphinx-build`. `sphinx-build` can be
+executed as `sphinx-build ./source ./build/_html`. This will open a webpage
+which is accessible at `http://127.0.0.1:8000` and which is automatically
+updated when you change a file.
+
+We also build the documentation as part of our CI. So if the local build does
+not work for some reason, you can still download the artifact of the
+`build-docs` job of our CI from GitLab to get the html files and view them in
+your browser.
+
+## Markdown
+
+We use [MyST Markdown](https://myst-parser.readthedocs.io/en/latest/index.html)
+for writing our documentation. There are several online documents explaining the
+syntax, see e.g. the [MyST Cheat
+Sheet](https://jupyterbook.org/en/stable/reference/cheatsheet.html) of the
+jupyterbook project. Of course, you can also look at the existing pages to check
+how the syntax for some part of the documentation looks like.
\ No newline at end of file
diff --git a/docs/source/correction/best-practices-correction.md b/docs/source/correction/best-practices-correction.md
new file mode 100644
index 0000000000000000000000000000000000000000..39a0ea75af61237736b1603658dda2a22a4c0238
--- /dev/null
+++ b/docs/source/correction/best-practices-correction.md
@@ -0,0 +1,3 @@
+# Best Practices for Correction
+
+- Sammlung an Tipps & Tricks fuer Korrektur, ggf. an ein paar oft vorkommenden Beispielen.
\ No newline at end of file
diff --git a/docs/source/correction/correction-tab.md b/docs/source/correction/correction-tab.md
new file mode 100644
index 0000000000000000000000000000000000000000..8ebb39ca3c7f002c8d0acc08cdea1fc6c772eb82
--- /dev/null
+++ b/docs/source/correction/correction-tab.md
@@ -0,0 +1,5 @@
+# Correction Tab
+
+- What is the correction tab?
+- What are the different tests?
+- How to use it
\ No newline at end of file
diff --git a/docs/source/correction/correction-workflow.md b/docs/source/correction/correction-workflow.md
new file mode 100644
index 0000000000000000000000000000000000000000..bf153a2a5aff81f83c009a888bee17a0bc0a2abd
--- /dev/null
+++ b/docs/source/correction/correction-workflow.md
@@ -0,0 +1,8 @@
+# Correction Workflow
+
+- What operations are there?
+  - split traj.
+  - delete traj.
+  - delete future & retrack
+  - select nr./show only
+- What visualization options are there and how can they help?
\ No newline at end of file
diff --git a/docs/source/correction/correction.md b/docs/source/correction/correction.md
new file mode 100644
index 0000000000000000000000000000000000000000..a8640d61246043fc463b9dae5698be33af503bf1
--- /dev/null
+++ b/docs/source/correction/correction.md
@@ -0,0 +1,13 @@
+# Correction
+
+- Why do we do correction?
+- How do we do correction?
+- When do we do it? (e.g. have you already tuned the parameters first?)
+
+## Contents
+:::{toctree}
+:maxdepth: 1
+correction-workflow
+correction-tab
+best-practices-correction
+:::
\ No newline at end of file
diff --git a/docs/source/getting_started.md b/docs/source/getting_started.md
new file mode 100644
index 0000000000000000000000000000000000000000..c1ed2eb2b71a7a74b778c3fedf62687e58148467
--- /dev/null
+++ b/docs/source/getting_started.md
@@ -0,0 +1,254 @@
+# Getting Started 
+
+## Experimental Setup
+
+### Prepare cameras
+
+- Charge batteries or use an external power supply
+- Ensure
+- Intrinsic calibration
+  - chess-board snapshots from different angles and chessboard object being located on different parts of the picture (left, right border, ...)
+  - snapshots must be from a video with identical settings (resolution, fov) as the videos taken in the experiment.
+  - auto focus (AF) set to manual
+
+### Setup cameras
+
+- Check the view and secure camera (must not move/slide, must not fall down on participants).
+- In a multi camera setup, the footage needs to be synchronized in time (clap for acoustic synchronization, visual synchronization also possible).
+- Find multiple points in the real work, that you link to your virtual world coordinate system.
+- In case the camera view is changed, the extrinsic calibration needs to be re-done.
+- The extrinsic Calibration is needed to map pixel coordinates to the virtual world coordinate system. To be able to calculate the object’s position in the real-world coordinate system, the object seen in the video frame needs a height-information. If you have the triple (height, pixelx , pixely), `PeTrack` will calculate the triple (x,y,z) of the object in the virtual world coordinate system as defined in the extrinsic calibration process. The calibration needs at least 4 points, which must not be within just one plane. It will not suffice to use markers on the floor.
+
+We have made good experiences with the practice to measure and mark points on the floor and use these points and a surveyor’s staff (measuring rod) to create known points in 3d space. the surveyor’s staff must have some means to find the orientation orthogonal to the ground plane (in other words: staff aligned with gravity). The surveyor’s staff can be seen below: ![staff_01](images/staff_02.png)
+
+Additional helpers to define the positions of the calibration points: ![helper_01](images/helper_02.png)
+
+**TODO: Make calibration manual into part of this docs**
+For additional help, check out our detailed intrinsic & extrinsic calibration manual Calibration_Manual.pdf
+
+### After the experiments
+
+- Save the raw video footage.
+- Extract the various runs in separate video files (mp4) (e.g., Adobe Premiere Pro CC).
+- While handling the video data in premiere, synchronize them using the audio track (clapping) or the video (unique movement/event) in the timeline. This will ensure, that trajectories from different cameras can be merged.
+
+## Using PeTrack
+
+The usage and some settings will be explained with the provided demo project ('demo' folder) , the folder contains all necessary files to set up a PeTrack project. <!--Make sure also to read our [best practices guide](usage/Best-Practices).-->
+
+### Calibration
+
+The first step to setup a PeTrack project is the calibration of the camera, which mainly consists of two parts [intrinsic](intrinsic_calib) and [extrinsic](extr_calib) calibration. Additionally some color correction and the addition of borders can be set up here.
+
+(intrinsic_calib)=
+#### Intrinsic calibration
+
+1. open PeTrack without any arguments, the program should automatically open in the calibration tab.
+
+![01](images/01.png)
+
+2. click on “files” and browse to the snapshots out of the video for intrinsic calibration (chessboard), select ALL of those snapshots (for multi-selection hold `⌃ Ctrl/⌘ Cmd` and sequentially click on the files). The snapshots for the demo are located in: `demo/00_files/calibration/intrinsic`.
+
+![02](images/03.png)
+
+3. click on “auto” to start intrinsic calibration
+
+![04](images/04.png)
+
+4. see how the parameters in the `intrinsic calibration` pane have changed
+
+![05](images/05a.png)
+
+5. check “apply” and save the project file under a name corresponding to the camera and the resolution/FOV settings and “\_intrinsic_calibration”.
+
+![05b](images/05b.png)
+
+This project can be reused for other videos using the same camera+settings. (Alternatively you can re-do the intrinsic calibration in all other projects using the same camera. Intrinsic calibration will invalidate all recognition/tracking data.)
+
+_`demo/01_calibration/01_intrinsic.pet` is the resulting PeTrack project files after these steps._
+
+(extr_calib)=
+#### Extrinsic Calibration
+
+To reuse the extrinsic calibration for multiple videos, taken from the same camera in the same view, `PeTrack` will store the data in a external file (\*.3dc). If this file is not created yet, a template needs to be prepared in the following format: first line only consists of the integer a “amount of points”, followed by a lines with the coordinates (in cm) of the virtual world coordinate system. A sample is seen below with 16 points:
+
+![extrinsic_01](images/extrinsic_02.png)
+
+1. Create an image with all the marked points, that you want to use. We therefore took snapshots out of the video with all the points and merged the pictures into one image. It is very important, that the pixel-coordinates from each point will remain the same in the original snapshot and the image, you copy it to.
+
+![00_all](images/00_all.jpg)
+
+2. Open `PeTrack`. Make sure, the intrinsic calibration is loaded or re-done and that `apply` is checked.
+
+![07](images/07.png)
+
+3. Open the image and mark the special points **in the order, they appear in the file** (\*.3dc). (The points can also be marked sequentially by playing a video, which shows these marker points.) Markers can be set with `⌃ Ctrl/⌘ Cmd` + a double left klick and deleted with `⌃ Ctrl/⌘ Cmd` + a double right click.
+
+![07b](images/07b.png)
+
+4. Load the points from the \*.3dc file by pressing load and browsing to the file. Make sure no additional spaces are at the end of each coordinate line in your \*.3dc document. `PeTrack` won’t be able to read these coordinates and show you an error message that the 2D points that you have selected in the picture don’t match the number of 3D points in you \*.3dc document!
+
+![07c](images/08.png)
+
+5. Click “fetch” and then “save” to make `PeTrack` complete the \*.3dc file. It will now hold the pixel coordinates of each point in the corresponding line. (see above)
+
+![09](images/09.png)
+
+6. You can verify the result with the buttons “show” and “error”. Additionally, you can have `PeTrack` draw the virtual world coordinate system by clicking on the “show” checkbox in the “coordinate system” section and adjust the settings in the 3D tab. Move the coordinate system around and verify plausibility.
+
+![10](images/10.png)
+
+_`demo/01_calibration/02_extrinsic.pet` is the resulting PeTrack project files after these steps._ As we want to extract the trajectory usually from videos, the can be added via double-clicking on the image or by `File/Open Sequence`.
+
+![10a](images/10a.png)
+
+_`demo/01_calibration/03_calibrated_with_video.pet` is the resulting PeTrack project files after these steps._
+
+### Recognition
+
+After the calibration is done, the next step is to set up the recognition. Switch to the tab “Recognition” and check “show”. Press (`⌃ Ctrl/⌘ Cmd` + `1`) to adjust view. (Alternatively, you can use the menu-bar, View > Fit in region of interest)
+
+#### Setting ROI (region of interest) for recognition
+
+Click on `show` in the `region of interest` pane. You will notice small green lines on the edge of the image. Only if the `fix` box is unchecked, it is possible to adjust the borders of this region. Mouse over any image-edge (top, bottom, left, right) and click and drag the green line to fit your needs. Notice, how the cursor changes from “hand” to “window-resize”, when you approach the current ROI edge. This is the area in which PeTrack will try to detect the pedestrians.
+
+![11aaa](images/11aaa.png)
+
+#### Setting the marker parameters
+
+The setup for the marker will only be shown exemplary for a multicolor-marker. For multicolor setups it is recommended to use different colors depending on the height of the participants. Each color will be later mapped to one height. In the demo the following color were used:
+
+| color  | height/cm |
+| ------ | --------- |
+| purple | 146       |
+| orange | 158       |
+| yellow | 168       |
+| green  | 179       |
+| blue   | 192       |
+
+1. Select the wanted marker, in most case the multicolor marker should be chosen, even if only one color hats are used.
+2. After selecting the marker type, click on `parameter` to set up the marker. ![11bb](images/11bb.png)
+3. Select the desired parameters. `open radius` and `close radius` should be deactivated when selecting colors, as the image mask does not accurately depict the selected color. To see which color range currently is detected, select `mask`.
+
+![12](images/12.png)
+
+4. In the `map` pane the different markers are maintained. For each group you have in your video, repeat the following steps:
+
+   4\.1 Clicking on `color range` opens a dialog where you can choose the range of colors for the currently selected group. ![11ccc](images/13.png)
+
+   4\.2 If you have the mask enabled and perform, you can verify the areas, which would be detected by the range. ![15a](images/15a.png)
+
+   4\.3 Make sure that most of the head are detected, and at the same time as few as possible pixels on the ground, walls, etc. To check if the wanted participants are detected you can also activate the recognition by checking the `perform` box. ![15bb](images/15bb.png)
+
+   4\.4 Enter the height, which should be used for the participants with that particular hat color. ![15cc](images/15cc.png)
+
+   4\.5 If you want to use an additional color, click on `add` and repeat the steps. ![15dd](images/15dd.png)
+5. After all groups have been added, and performing the recognition, all participants should get recognized (with deactivated mask).
+
+![16a](images/16a.png)
+
+_`demo/02_recognition/04_recognition.pet` is the resulting PeTrack project files after these steps._
+
+### Tracking
+
+The next step to complete setting up a PeTrack project, is to set up the tracking. This is important for the parts where the hat can not be detected, then the current position is determined by the optical flow.
+
+#### Setting ROI (region of interest) for tracking
+
+Similar to the recognition tab, also in the tracking tab a region of interest can be defined. It will be depicted by blue lines and can also be fixed, to be immutable. Make sure that the tracking ROI is at least as large as the recognition ROI. Otherwise, if recognition happens without tracking, every single recognition/point starts its own trajectory.
+
+![01_roi](images/01_roi.png)
+
+#### Running the tracking
+
+When the ROI is set up, you have two options to track the pedestrians in the video.
+
+1. `calculate all` (red rectangle): runs the tracking forward and backwards over the complete video.
+2. `online calculation` (green rectangle): interactively navigate through the video (play, pause, backwards)
+
+![02_calculate_all](images/02_calculate_all.png)
+
+During the tracking you can see the current state, it should look similar to: ![03_during_tracking](images/03_during_tracking.png)
+
+To see the trajectory line, you can fix how many frames before and after the current one should be included. ![04_all_tracked](images/04_all_tracked.png)
+
+#### Export the result
+
+When the tracking is completed make sure to export the resulting trajectories. Select the options which you want to have in your trajectory file. If you do not specify an extension, PeTrack will save both, the `trc` and `txt` trajectory files. In the `trc` file, the pixel values will be saved, and in the `txt` the real world coordinates are saved.
+
+![05_export](images/05_export.png)
+
+### Corrections
+
+After the tracking is completed you are almost done. Now the trajectories may need some corrections, as some unwanted persons/artifacts got tracked. Or the track point clipped to an edge or moved to a different person. To investigate a single trajectory or a group of trajectories, the trajectories can be filtered, as can be seen in the green rectangle.
+
+**Note:** At this point it is important to turn off the recognition to avoid getting extra persons.
+
+**Note:** Make sure to export the trajectories, again after you made some changes. Only this way you avoid data loss, as currently no undo function is available in PeTrack.
+
+![00_filter](images/00_filter.png)
+
+#### Run plausibility checks
+
+A starting point to find possible faulty pedestrians are the plausibility checks. You can run them if you click on test. They will report different possible errors and automatically
+
+![01_test](images/01_test.png)
+
+#### Remove unwanted trajectories
+
+The easiest correction might be to remove unwanted trajectories. As it happens in the test, there is such a trajectory. The conductor got tracked, but we do not want his trajectory. So right click on the current point of the trajectory and select `delete whole trajectory`.
+
+![02_remove_traj](images/02_remove_traj.png)
+
+#### Smooth shaky trajectories
+
+This is example is quite a nitpick. But the same effect might happen more exaggerated in real scenarios. As you can see here, the trajectory is not very smooth.
+
+![03a_shaky](images/03a_shaky.png)
+
+When you move through the trajectory frame wise you can move a track point by `⌃ Ctrl/⌘ Cmd`+`double left click`. If the track point does not move, you may have to add some intermediate steps as the movement was too large. After you smoothed out the movement, it may look like this.
+
+![03b_corrected](images/03b_corrected.png)
+
+It is also possible to drag a track point directly into the desired position by holding `⎇ Alt/⌥ Option` and holding the left mouse button.
+
+![move-trackpoint](images/move-trackpoint.gif)
+
+### Command-line options
+
+If the trajectories of multiple experiments with the same setup are to be exported with PeTrack, it might be easier to use the command line interface. After the setup for one experiment is done, it can be used as a template for the remaining experiments, where only the video file changes. Thus, enabling a automation of the exporting process.
+
+To reduce the manual input when projects are started automatically PeTrack supports some command-line options which are listed below:
+
+```
+petrack [-help|-?] [[-project] project.pet] 
+          [-sequence imagesequenceOrVideo]
+          [-autoSave|-autosave imgFldOrVideo|proj.pet|trackerFile]
+          [-autoTrack|-autotrack trackerFile]
+          [-autoReadMarkerID|-autoreadmarkerid markerIdFile]
+          [-autoReadHeight|-autoreadheight heightFile]
+          [-autoPlay|-autoplay trackerFile]
+          [-autoExportView|-autoexportview outputFile]
+-help|-?
+shows help information for command line options
+-project
+optional option to set project file; otherwise the argument without option flag is used as project file
+-sequence imagesequenceOrVideo
+loads image sequence or video; option overwrites SRC attribute in project file
+-autoSave|-autosave imgFldOrVideo|proj.pet|trackerFile
+if the argument ends with pet, a project file will be written to proj.pet at the end; if the argument ends with txt,dat or trav, the trajectories will be written in a format according to the suffix of trackerFile; otherwise imgFldOrVideo is the folder to store the image sequence or a name of a video file for the direct export; in all cases PeTrack ends after finishing the work
+-autoTrack|-autotrack trackerFile
+calculates automatically the trajectories of marked pedestrians and stores the result to trackerFile
+-autoReadMarkerID|-autoreadmarkerid markerFile
+automatically reads the txt-file including personID and markerID and applies the markerIDs to the corresponding person. If -autoTrack is not used, saving trackerFiles using -autoSaveTracker is recommended.
+-autoReadHeight|-autoreadheight heightFile
+automatically reads the trackerFile including markerID and individual height and applies the heights to the corresponding person
+-autoPlay|-autoplay trackerFile
+plays the video or image sequence and stores the trajectories to trackerFile
+-autoExportView|-autoexportview outputFile
+exports the view, e.g., the undistorted video or the video with trajectories, to outputFile
+Example:
+To generate trajectories from a single image sequence starting with frame000.jpgwith settings stored in the project file project.pet, export tracker file trackerFileand exit with saving the project to project.pet again:
+petrack.exe -project project.pet -sequence frame000.jpg
+          -autoTrack trackerFile -autoSave project.pet
+```
\ No newline at end of file
diff --git a/docs/source/images/00_all.jpg b/docs/source/images/00_all.jpg
new file mode 100644
index 0000000000000000000000000000000000000000..4b0843e2a909dc923223d64efbf8fcf2c4652ea2
Binary files /dev/null and b/docs/source/images/00_all.jpg differ
diff --git a/docs/source/images/00_filter.png b/docs/source/images/00_filter.png
new file mode 100644
index 0000000000000000000000000000000000000000..995d0f3828b46c6023cb7400c4147a1e3c0896f0
Binary files /dev/null and b/docs/source/images/00_filter.png differ
diff --git a/docs/source/images/01.png b/docs/source/images/01.png
new file mode 100644
index 0000000000000000000000000000000000000000..aa6b3acb30531d6a54a85e710459e1127267c22e
Binary files /dev/null and b/docs/source/images/01.png differ
diff --git a/docs/source/images/01_roi.png b/docs/source/images/01_roi.png
new file mode 100644
index 0000000000000000000000000000000000000000..4588edda7f167cb94fe5d69ad721af88ceec4c84
Binary files /dev/null and b/docs/source/images/01_roi.png differ
diff --git a/docs/source/images/01_test.png b/docs/source/images/01_test.png
new file mode 100644
index 0000000000000000000000000000000000000000..b4c6ea2027b2ac85c453739739993947f19d6c4b
Binary files /dev/null and b/docs/source/images/01_test.png differ
diff --git a/docs/source/images/02.png b/docs/source/images/02.png
new file mode 100644
index 0000000000000000000000000000000000000000..86fa6ec05bd6446d13e9d1b626565f3b7c67a695
Binary files /dev/null and b/docs/source/images/02.png differ
diff --git a/docs/source/images/02_calculate_all.png b/docs/source/images/02_calculate_all.png
new file mode 100644
index 0000000000000000000000000000000000000000..13383d4360f770a61a885b3172e6a41ddbac9e1f
Binary files /dev/null and b/docs/source/images/02_calculate_all.png differ
diff --git a/docs/source/images/02_remove_traj.png b/docs/source/images/02_remove_traj.png
new file mode 100644
index 0000000000000000000000000000000000000000..61e99ec03c19de24d081bb5a9f4ff610975f8877
Binary files /dev/null and b/docs/source/images/02_remove_traj.png differ
diff --git a/docs/source/images/03.png b/docs/source/images/03.png
new file mode 100644
index 0000000000000000000000000000000000000000..b193c440ea8306bb190c73bba38c634b3db31e28
Binary files /dev/null and b/docs/source/images/03.png differ
diff --git a/docs/source/images/03_during_tracking.png b/docs/source/images/03_during_tracking.png
new file mode 100644
index 0000000000000000000000000000000000000000..0ae24faf636505afbc5f26c14ae0aba4f93fe821
Binary files /dev/null and b/docs/source/images/03_during_tracking.png differ
diff --git a/docs/source/images/03a_shaky.png b/docs/source/images/03a_shaky.png
new file mode 100644
index 0000000000000000000000000000000000000000..54d7f74a37e26d28d5bf080e6eebacac8f76555c
Binary files /dev/null and b/docs/source/images/03a_shaky.png differ
diff --git a/docs/source/images/03b_corrected.png b/docs/source/images/03b_corrected.png
new file mode 100644
index 0000000000000000000000000000000000000000..e12e59bd8c04ac44b73a3514086009f3b286fecd
Binary files /dev/null and b/docs/source/images/03b_corrected.png differ
diff --git a/docs/source/images/04.png b/docs/source/images/04.png
new file mode 100644
index 0000000000000000000000000000000000000000..9b43847b527a8269d2546648c4d1f853a4175e16
Binary files /dev/null and b/docs/source/images/04.png differ
diff --git a/docs/source/images/04_all_tracked.png b/docs/source/images/04_all_tracked.png
new file mode 100644
index 0000000000000000000000000000000000000000..4fc2a392f1fd72a70a97c20a8f66362a4515118f
Binary files /dev/null and b/docs/source/images/04_all_tracked.png differ
diff --git a/docs/source/images/05.png b/docs/source/images/05.png
new file mode 100644
index 0000000000000000000000000000000000000000..af45fe93959b480f6f852379c64f659fd1fbb158
Binary files /dev/null and b/docs/source/images/05.png differ
diff --git a/docs/source/images/05_export.png b/docs/source/images/05_export.png
new file mode 100644
index 0000000000000000000000000000000000000000..cb83eec8a4205098ced66486d84ab5213202785b
Binary files /dev/null and b/docs/source/images/05_export.png differ
diff --git a/docs/source/images/05a.png b/docs/source/images/05a.png
new file mode 100644
index 0000000000000000000000000000000000000000..a22181538a6ac043aa88fb493365fd9fab51064e
Binary files /dev/null and b/docs/source/images/05a.png differ
diff --git a/docs/source/images/05b.png b/docs/source/images/05b.png
new file mode 100644
index 0000000000000000000000000000000000000000..fa841c9b5d5895f6d339b3c32b1968c9f1dd8d7e
Binary files /dev/null and b/docs/source/images/05b.png differ
diff --git a/docs/source/images/07.png b/docs/source/images/07.png
new file mode 100644
index 0000000000000000000000000000000000000000..2f5c63740c73db25db48124bd24c9bb038c93468
Binary files /dev/null and b/docs/source/images/07.png differ
diff --git a/docs/source/images/07b.png b/docs/source/images/07b.png
new file mode 100644
index 0000000000000000000000000000000000000000..bc715548a640ef7f6712a12a13fb2ac40865680b
Binary files /dev/null and b/docs/source/images/07b.png differ
diff --git a/docs/source/images/07c.png b/docs/source/images/07c.png
new file mode 100644
index 0000000000000000000000000000000000000000..49fc3810e2bb283de5fd075523ac75abe2df1ba8
Binary files /dev/null and b/docs/source/images/07c.png differ
diff --git a/docs/source/images/08.png b/docs/source/images/08.png
new file mode 100644
index 0000000000000000000000000000000000000000..0fb868c551fc4822d21f13cd40b263c1abbbe0e1
Binary files /dev/null and b/docs/source/images/08.png differ
diff --git a/docs/source/images/09.png b/docs/source/images/09.png
new file mode 100644
index 0000000000000000000000000000000000000000..c3ba696f07d32b0c85762e94cddc2c0361f189c0
Binary files /dev/null and b/docs/source/images/09.png differ
diff --git a/docs/source/images/10.png b/docs/source/images/10.png
new file mode 100644
index 0000000000000000000000000000000000000000..843ee8b54d64588551c9ead6b6ee9551e4e5dac1
Binary files /dev/null and b/docs/source/images/10.png differ
diff --git a/docs/source/images/10000000000000BC000002D6CD285256D1E15E3C.png b/docs/source/images/10000000000000BC000002D6CD285256D1E15E3C.png
new file mode 100644
index 0000000000000000000000000000000000000000..c5da232046db35c5027b0f591669949f0e3be7ee
Binary files /dev/null and b/docs/source/images/10000000000000BC000002D6CD285256D1E15E3C.png differ
diff --git a/docs/source/images/100000000000015E000000348CBD126EAB65B69D.png b/docs/source/images/100000000000015E000000348CBD126EAB65B69D.png
new file mode 100644
index 0000000000000000000000000000000000000000..4a2372abe5280eadb6b7e65ce86dd1b67fb11870
Binary files /dev/null and b/docs/source/images/100000000000015E000000348CBD126EAB65B69D.png differ
diff --git a/docs/source/images/100000000000015E0000004960E3F706922A0E61.png b/docs/source/images/100000000000015E0000004960E3F706922A0E61.png
new file mode 100644
index 0000000000000000000000000000000000000000..64b7f71f2b7d51fcb0fe67ee4b37fcc7bca08f7c
Binary files /dev/null and b/docs/source/images/100000000000015E0000004960E3F706922A0E61.png differ
diff --git a/docs/source/images/100000000000016400000111EC58D95EA3ECFDF6.png b/docs/source/images/100000000000016400000111EC58D95EA3ECFDF6.png
new file mode 100644
index 0000000000000000000000000000000000000000..52272e5649f667dafea092e1ff40aa963cae7540
Binary files /dev/null and b/docs/source/images/100000000000016400000111EC58D95EA3ECFDF6.png differ
diff --git a/docs/source/images/10000000000001BA00000098239BCD5EE664C7BC.png b/docs/source/images/10000000000001BA00000098239BCD5EE664C7BC.png
new file mode 100644
index 0000000000000000000000000000000000000000..6c519b880ed1c648696a7efa7915d87e0c8cf35f
Binary files /dev/null and b/docs/source/images/10000000000001BA00000098239BCD5EE664C7BC.png differ
diff --git a/docs/source/images/10000000000002A1000000C86C7F07A32AA12C71.png b/docs/source/images/10000000000002A1000000C86C7F07A32AA12C71.png
new file mode 100644
index 0000000000000000000000000000000000000000..5876c19535e90e985608ce6febe3633e48e2633f
Binary files /dev/null and b/docs/source/images/10000000000002A1000000C86C7F07A32AA12C71.png differ
diff --git a/docs/source/images/1000020100000162000003CE3DCBB6204350C632.png b/docs/source/images/1000020100000162000003CE3DCBB6204350C632.png
new file mode 100644
index 0000000000000000000000000000000000000000..ef00b0c1566c08e7b9c0d18071c4112dfb5f35a9
Binary files /dev/null and b/docs/source/images/1000020100000162000003CE3DCBB6204350C632.png differ
diff --git a/docs/source/images/10a.png b/docs/source/images/10a.png
new file mode 100644
index 0000000000000000000000000000000000000000..cf73d476f908f6931e789a7f9bcc08010a68e608
Binary files /dev/null and b/docs/source/images/10a.png differ
diff --git a/docs/source/images/11.png b/docs/source/images/11.png
new file mode 100644
index 0000000000000000000000000000000000000000..b57d9e7ee8893cf7899ff5fcda6d4796a86190f7
Binary files /dev/null and b/docs/source/images/11.png differ
diff --git a/docs/source/images/11a.png b/docs/source/images/11a.png
new file mode 100644
index 0000000000000000000000000000000000000000..300965c742f71a23f06e68077c6dbd6f80127664
Binary files /dev/null and b/docs/source/images/11a.png differ
diff --git a/docs/source/images/11aaa.png b/docs/source/images/11aaa.png
new file mode 100644
index 0000000000000000000000000000000000000000..2e2e5dc9dc4eb60af63db596d13b3e0507b6cdba
Binary files /dev/null and b/docs/source/images/11aaa.png differ
diff --git a/docs/source/images/11bb.png b/docs/source/images/11bb.png
new file mode 100644
index 0000000000000000000000000000000000000000..78fe9f88868a9e3e3405c5abcbd66d872a306aa8
Binary files /dev/null and b/docs/source/images/11bb.png differ
diff --git a/docs/source/images/11ccc.png b/docs/source/images/11ccc.png
new file mode 100644
index 0000000000000000000000000000000000000000..63682e6f3d855a3458adb8079ed4d6df8f9e9916
Binary files /dev/null and b/docs/source/images/11ccc.png differ
diff --git a/docs/source/images/12.png b/docs/source/images/12.png
new file mode 100644
index 0000000000000000000000000000000000000000..df39a45aeafd5ae2b5eea2240841fc03affea417
Binary files /dev/null and b/docs/source/images/12.png differ
diff --git a/docs/source/images/12a.png b/docs/source/images/12a.png
new file mode 100644
index 0000000000000000000000000000000000000000..e8881f2107e24ed2edc74dc23699908c1fe839f3
Binary files /dev/null and b/docs/source/images/12a.png differ
diff --git a/docs/source/images/12aa.png b/docs/source/images/12aa.png
new file mode 100644
index 0000000000000000000000000000000000000000..a63d01ef5e262a193832cc57f85bd6a6dd03285f
Binary files /dev/null and b/docs/source/images/12aa.png differ
diff --git a/docs/source/images/13.png b/docs/source/images/13.png
new file mode 100644
index 0000000000000000000000000000000000000000..0e030864fa88199e2c00731514956af58458e7bc
Binary files /dev/null and b/docs/source/images/13.png differ
diff --git a/docs/source/images/15a.png b/docs/source/images/15a.png
new file mode 100644
index 0000000000000000000000000000000000000000..c71e6927b1852b7579fc3cd35f446fb024147166
Binary files /dev/null and b/docs/source/images/15a.png differ
diff --git a/docs/source/images/15b.png b/docs/source/images/15b.png
new file mode 100644
index 0000000000000000000000000000000000000000..9a20b3c8a6b843bd3ed44429657eec5788d3d472
Binary files /dev/null and b/docs/source/images/15b.png differ
diff --git a/docs/source/images/15bb.png b/docs/source/images/15bb.png
new file mode 100644
index 0000000000000000000000000000000000000000..2206a1b4281e9dafa35da4968900900863e610cf
Binary files /dev/null and b/docs/source/images/15bb.png differ
diff --git a/docs/source/images/15cc.png b/docs/source/images/15cc.png
new file mode 100644
index 0000000000000000000000000000000000000000..fb825c652db470477dc80afd2fc062929d7dfbbd
Binary files /dev/null and b/docs/source/images/15cc.png differ
diff --git a/docs/source/images/15d.png b/docs/source/images/15d.png
new file mode 100644
index 0000000000000000000000000000000000000000..3716a90b261579e867724c7fddec59d70a748ce3
Binary files /dev/null and b/docs/source/images/15d.png differ
diff --git a/docs/source/images/15dd.png b/docs/source/images/15dd.png
new file mode 100644
index 0000000000000000000000000000000000000000..e5eba1b90a5ce69f4b4cbfb4ae163a0a209b0c41
Binary files /dev/null and b/docs/source/images/15dd.png differ
diff --git a/docs/source/images/15e.png b/docs/source/images/15e.png
new file mode 100644
index 0000000000000000000000000000000000000000..f63df5fb31f599fd6068eac0f66c5b4d642ccfbc
Binary files /dev/null and b/docs/source/images/15e.png differ
diff --git a/docs/source/images/16.png b/docs/source/images/16.png
new file mode 100644
index 0000000000000000000000000000000000000000..3225402e07d7190f76eb841410ea3a09f6c3dd46
Binary files /dev/null and b/docs/source/images/16.png differ
diff --git a/docs/source/images/16a.png b/docs/source/images/16a.png
new file mode 100644
index 0000000000000000000000000000000000000000..4c9d8364733f4802c680341251336566dd007a23
Binary files /dev/null and b/docs/source/images/16a.png differ
diff --git a/docs/source/images/example_parameters_recognition.png b/docs/source/images/example_parameters_recognition.png
new file mode 100644
index 0000000000000000000000000000000000000000..2903ff80d4f43d849be02e39025a7c21a5cf567a
Binary files /dev/null and b/docs/source/images/example_parameters_recognition.png differ
diff --git a/docs/source/images/example_parameters_tracking.png b/docs/source/images/example_parameters_tracking.png
new file mode 100644
index 0000000000000000000000000000000000000000..3bd12a15fad47dbe10777c69fc93c9e0e30746b2
Binary files /dev/null and b/docs/source/images/example_parameters_tracking.png differ
diff --git a/docs/source/images/extrinsic_01.png b/docs/source/images/extrinsic_01.png
new file mode 100644
index 0000000000000000000000000000000000000000..0bab74261f37d3ed1d28ac6758d7c45b00605a7c
Binary files /dev/null and b/docs/source/images/extrinsic_01.png differ
diff --git a/docs/source/images/extrinsic_02.png b/docs/source/images/extrinsic_02.png
new file mode 100644
index 0000000000000000000000000000000000000000..aa45ccb78f0ecf48b2b5623e93852b7e91a2d30c
Binary files /dev/null and b/docs/source/images/extrinsic_02.png differ
diff --git a/docs/source/images/extrinsic_03.png b/docs/source/images/extrinsic_03.png
new file mode 100644
index 0000000000000000000000000000000000000000..67f6a8bcf4c1a65393af2cf231f4677be0fb0863
Binary files /dev/null and b/docs/source/images/extrinsic_03.png differ
diff --git a/docs/source/images/extrinsic_04.png b/docs/source/images/extrinsic_04.png
new file mode 100644
index 0000000000000000000000000000000000000000..d94489d3fb5fc3d231123a707b101bc99f29d2b6
Binary files /dev/null and b/docs/source/images/extrinsic_04.png differ
diff --git a/docs/source/images/extrinsic_05.png b/docs/source/images/extrinsic_05.png
new file mode 100644
index 0000000000000000000000000000000000000000..5cc6abef72eb4e109022e7ccc871f24a37dcfaa1
Binary files /dev/null and b/docs/source/images/extrinsic_05.png differ
diff --git a/docs/source/images/grafik.png b/docs/source/images/grafik.png
new file mode 100644
index 0000000000000000000000000000000000000000..92e58aa60914ce52ad3b69bf05b68799c444e34e
Binary files /dev/null and b/docs/source/images/grafik.png differ
diff --git a/docs/source/images/helper_01.png b/docs/source/images/helper_01.png
new file mode 100644
index 0000000000000000000000000000000000000000..5876c19535e90e985608ce6febe3633e48e2633f
Binary files /dev/null and b/docs/source/images/helper_01.png differ
diff --git a/docs/source/images/helper_02.png b/docs/source/images/helper_02.png
new file mode 100644
index 0000000000000000000000000000000000000000..c5da232046db35c5027b0f591669949f0e3be7ee
Binary files /dev/null and b/docs/source/images/helper_02.png differ
diff --git a/docs/source/images/image.png b/docs/source/images/image.png
new file mode 100644
index 0000000000000000000000000000000000000000..5424eb9f6653f6d94be781690618094aa8527f71
Binary files /dev/null and b/docs/source/images/image.png differ
diff --git a/docs/source/images/intrinsic_01.png b/docs/source/images/intrinsic_01.png
new file mode 100644
index 0000000000000000000000000000000000000000..6c519b880ed1c648696a7efa7915d87e0c8cf35f
Binary files /dev/null and b/docs/source/images/intrinsic_01.png differ
diff --git a/docs/source/images/intrinsic_02.png b/docs/source/images/intrinsic_02.png
new file mode 100644
index 0000000000000000000000000000000000000000..52272e5649f667dafea092e1ff40aa963cae7540
Binary files /dev/null and b/docs/source/images/intrinsic_02.png differ
diff --git a/docs/source/images/intrinsic_03.png b/docs/source/images/intrinsic_03.png
new file mode 100644
index 0000000000000000000000000000000000000000..4a2372abe5280eadb6b7e65ce86dd1b67fb11870
Binary files /dev/null and b/docs/source/images/intrinsic_03.png differ
diff --git a/docs/source/images/intrinsic_04.png b/docs/source/images/intrinsic_04.png
new file mode 100644
index 0000000000000000000000000000000000000000..64b7f71f2b7d51fcb0fe67ee4b37fcc7bca08f7c
Binary files /dev/null and b/docs/source/images/intrinsic_04.png differ
diff --git a/docs/source/images/move-trackpoint.gif b/docs/source/images/move-trackpoint.gif
new file mode 100644
index 0000000000000000000000000000000000000000..0bac575fe6ce2e2d48d8956f119a5e095b376441
Binary files /dev/null and b/docs/source/images/move-trackpoint.gif differ
diff --git a/docs/source/images/recognition_01.png b/docs/source/images/recognition_01.png
new file mode 100644
index 0000000000000000000000000000000000000000..c2fca55acb6a06a02403bf11cf628bea73a841f9
Binary files /dev/null and b/docs/source/images/recognition_01.png differ
diff --git a/docs/source/images/roi_01.png b/docs/source/images/roi_01.png
new file mode 100644
index 0000000000000000000000000000000000000000..155bb0a47c82068d61998e4f0747be9e9256892d
Binary files /dev/null and b/docs/source/images/roi_01.png differ
diff --git a/docs/source/images/roi_02.png b/docs/source/images/roi_02.png
new file mode 100644
index 0000000000000000000000000000000000000000..6cb194a521417329e53be770de4cabf31fbb408f
Binary files /dev/null and b/docs/source/images/roi_02.png differ
diff --git a/docs/source/images/staff_01.png b/docs/source/images/staff_01.png
new file mode 100644
index 0000000000000000000000000000000000000000..97a06ba73a33f270f629e97a1b85bde9bf20aedc
Binary files /dev/null and b/docs/source/images/staff_01.png differ
diff --git a/docs/source/images/staff_02.png b/docs/source/images/staff_02.png
new file mode 100644
index 0000000000000000000000000000000000000000..ef00b0c1566c08e7b9c0d18071c4112dfb5f35a9
Binary files /dev/null and b/docs/source/images/staff_02.png differ
diff --git a/docs/source/index.md b/docs/source/index.md
new file mode 100644
index 0000000000000000000000000000000000000000..77c2c1f24b0041170206a5e84352407cf630df30
--- /dev/null
+++ b/docs/source/index.md
@@ -0,0 +1,32 @@
+# PeTrack
+For the understanding of the dynamics inside crowds reliable empirical data are needed enabling an increase of safety and comfort for pedestrians and the design of models reflecting the real dynamics. The existing database is small, sometimes inaccurate and highly contradictory. Manual procedures for collecting this data are very time-consuming and usually do not supply sufficient accuracy in space and time.
+
+For this reason we are developing the tool named `PeTrack` (**Pe**destrian **Track**ing) to automatically extract accurate pedestrian trajectories from video recordings. The joint trajectories of all pedestrians provide data like velocity, flow and density at any time and position. With such a tool extensive experimental series with a large number of persons can be analyzed. Individual codes enables personalized trajectories with static information of each participant (e.g. age, gender).
+
+The program has to deal with wide angle lenses and a high density of pedestrians. Lens distortion and perspective view are taken into account. The procedure includes calibration, recognition, tracking and height detection.
+
+Different kinds of markers (e.g. with height information, head direction, individual code) are implemented. With a stereo camera more accurate height measurements and also markerless tracking is possible.
+
+An executable of `PeTrack` is available [here](https://go.fzj.de/petrack-download).
+
+<!-- The brief [documentation](usage/Usage) of using `PeTrack` cannot answer all questions. Thus you may read also the information [workflow](usage/Workflow-for-performing-experiments-to-be-analyzed-with-PeTrack) and [contact the author](https://go.fzj.de/petrack-boltes) before setting up experiments and automatic extraction with `PeTrack`. -->
+
+<!--![Download Video](uploads/9a171c82e9bde1891c2a99eca38ded08/petrackAblaufArena.mp4)
+
+![Download Video](uploads/2c50611b2fdbfcc3e4a33c609b85dffa/petrackArenaResult.mp4)
+
+![Download Video](uploads/31c514747c6ad122b4d27b24a9ccbf67/petrackAblaufLarge.mp4)-->
+
+:::{toctree}
+:maxdepth: 1
+getting_started
+user_interface
+planning/planning
+calibration/calibration
+recognition/recognition
+tracking/tracking
+correction/correction
+misc/misc
+contribute/contribute
+section/MeinTest
+:::
diff --git a/docs/source/misc/FAQ.md b/docs/source/misc/FAQ.md
new file mode 100644
index 0000000000000000000000000000000000000000..e8d63d56ae6add9d77b61dad63add4eff372177d
--- /dev/null
+++ b/docs/source/misc/FAQ.md
@@ -0,0 +1,3 @@
+# FAQ
+
+Frequently Asked Questions
\ No newline at end of file
diff --git a/docs/source/misc/batch_processing.md b/docs/source/misc/batch_processing.md
new file mode 100644
index 0000000000000000000000000000000000000000..f6e563dc4306a3a37065c02991f866469478b72d
--- /dev/null
+++ b/docs/source/misc/batch_processing.md
@@ -0,0 +1,3 @@
+# Batch Processing
+
+How to use PeTrack via the CLI to "calculate all" for may videos starting from a project template.
\ No newline at end of file
diff --git a/docs/source/misc/citation.md b/docs/source/misc/citation.md
new file mode 100644
index 0000000000000000000000000000000000000000..595b0ded4490b295993ae906142b5756468131eb
--- /dev/null
+++ b/docs/source/misc/citation.md
@@ -0,0 +1,3 @@
+# How to cite
+
+How to cite PeTrack correctly.
\ No newline at end of file
diff --git a/docs/source/misc/combine.md b/docs/source/misc/combine.md
new file mode 100644
index 0000000000000000000000000000000000000000..6fba36acd00c7184289cc01974ea2636f6181377
--- /dev/null
+++ b/docs/source/misc/combine.md
@@ -0,0 +1,3 @@
+# Combine Trajectories From Different Videos
+
+Sth. about combining trajectories from different cameras. Combine-Script currently is not public, how do we want to deal with that?
\ No newline at end of file
diff --git a/docs/source/misc/misc.md b/docs/source/misc/misc.md
new file mode 100644
index 0000000000000000000000000000000000000000..a976adcee1e89e3d89d311bf492e1d6eb232460d
--- /dev/null
+++ b/docs/source/misc/misc.md
@@ -0,0 +1,13 @@
+# Misc
+
+Title page of misc topics, probably just a table of contents
+
+## Contents
+
+:::{toctree}
+:maxdepth: 1
+FAQ
+citation
+batch_processing
+combine
+:::
\ No newline at end of file
diff --git a/docs/source/planning/camera.md b/docs/source/planning/camera.md
new file mode 100644
index 0000000000000000000000000000000000000000..f731be2dd481ff88187dde2332d382fd8694f45b
--- /dev/null
+++ b/docs/source/planning/camera.md
@@ -0,0 +1,4 @@
+# Cameras
+
+- What camera to use for which UseCase
+- Thinking about shutter, lighting conditions, height of camera, resolution, ...
\ No newline at end of file
diff --git a/docs/source/planning/checklist.md b/docs/source/planning/checklist.md
new file mode 100644
index 0000000000000000000000000000000000000000..af7cbb6f9de2f0769c261e424666f88f62823bb0
--- /dev/null
+++ b/docs/source/planning/checklist.md
@@ -0,0 +1,3 @@
+# Checklist
+
+This is a final checklist in the planning section, being a nice reference for experimenters.
\ No newline at end of file
diff --git a/docs/source/planning/coordinates.md b/docs/source/planning/coordinates.md
new file mode 100644
index 0000000000000000000000000000000000000000..7b53f54dc6a2afec38b4e525b94b799acc51609b
--- /dev/null
+++ b/docs/source/planning/coordinates.md
@@ -0,0 +1,7 @@
+# Coordinate System
+
+- What coordinate system do I want?
+- Preparation for intrinsic and extrinsic calibration:
+  - Calibration pattern
+  - Stick or other object for extrinsic point marking
+  - Considerations on visibility, utility, ... of coord sys
\ No newline at end of file
diff --git a/docs/source/planning/goals.md b/docs/source/planning/goals.md
new file mode 100644
index 0000000000000000000000000000000000000000..eb5581ae1ddaec75a5a3284f477067e1f31222c8
--- /dev/null
+++ b/docs/source/planning/goals.md
@@ -0,0 +1,6 @@
+# Experiment Goals
+
+- What do I want to measure?
+- How exact do my measurements need to be?
+- What markers do measure what I want?
+- How much work is needed for the calibration to reach my desired precision?
diff --git a/docs/source/planning/planning.md b/docs/source/planning/planning.md
new file mode 100644
index 0000000000000000000000000000000000000000..fc4819294d47cda046d8dfa1198ce4fa4dd55bde
--- /dev/null
+++ b/docs/source/planning/planning.md
@@ -0,0 +1,12 @@
+# Planning of Experiments
+
+This is the title page explaining that experiments are complicated and some things need to be planned before using PeTrack and **before** doing the experiments.
+
+## Contents
+:::{toctree}
+:maxdepth: 1
+goals
+camera
+coordinates
+checklist
+:::
\ No newline at end of file
diff --git a/docs/source/recognition/aruco.md b/docs/source/recognition/aruco.md
new file mode 100644
index 0000000000000000000000000000000000000000..e25310fd0ce729dd2d8e4818a8ac1d640406c951
--- /dev/null
+++ b/docs/source/recognition/aruco.md
@@ -0,0 +1,3 @@
+# Aruco Marker
+
+Here are the docs on how to use the aruco marker and what its options are
\ No newline at end of file
diff --git a/docs/source/recognition/multicolor.md b/docs/source/recognition/multicolor.md
new file mode 100644
index 0000000000000000000000000000000000000000..de2478f3319454af687a8b452b4f91f42735af49
--- /dev/null
+++ b/docs/source/recognition/multicolor.md
@@ -0,0 +1,3 @@
+# Multicolor Marker
+
+Here are the docs on how to use the multicolor marker and what its options are
\ No newline at end of file
diff --git a/docs/source/recognition/others.md b/docs/source/recognition/others.md
new file mode 100644
index 0000000000000000000000000000000000000000..23359e5ff4075198c86ecbee84c2d41eb881b8f5
--- /dev/null
+++ b/docs/source/recognition/others.md
@@ -0,0 +1,12 @@
+# Other Markers
+
+TODO: Short list of other markers, with capabilities (table from Maik); what additional info they can give, thats it; no usage guide, since we don't actively use any of these
+
+| marker           | robustness | precision | high density | additional info | needed resolution | effort in creation |
+| ---------------- | ---------- | --------- | ------------ | --------------- | ----------------- | ------------------ |
+| casern           | ++         | ++        | o            | +               | o                 | o                  |
+| hermes           | o          | ++        | +            | -               | +                 | +                  |
+| japan            | +          | ++        | -            | o               | +                 | o                  |
+| color/multicolor | +          | o         | -            | o               | ++                | ++                 |
+| aruco            | TODO       |           |              |                 |                   |                    |
+
diff --git a/docs/source/recognition/recognition.md b/docs/source/recognition/recognition.md
new file mode 100644
index 0000000000000000000000000000000000000000..fbff520388167e5ea054d1aa20c55d48a01a1484
--- /dev/null
+++ b/docs/source/recognition/recognition.md
@@ -0,0 +1,12 @@
+# Recognition
+
+Hier wird einmal grob erklaert, was recognition eigentlich so ist. Die genaue Doku passiert pro Marker im folgenden:
+
+## Contents
+
+:::{toctree}
+:maxdepth: 1
+multicolor
+aruco
+others
+:::
\ No newline at end of file
diff --git a/docs/source/section/MeinTest.md b/docs/source/section/MeinTest.md
new file mode 100644
index 0000000000000000000000000000000000000000..6ea960e5c1bbe909de43c84b759f3ec0c634235f
--- /dev/null
+++ b/docs/source/section/MeinTest.md
@@ -0,0 +1,83 @@
+# This is a test
+
+I want to test some things.
+This is **strong** or *cursive* or _cursive_ or
+
+```
+Some
+unformatted
+text
+```
+
+(subheading-target)=
+## Subheading
+
+With some text asdfjnasöfhaöshf asjföds föijsa följsad kfjsdljflkdsajfjlks jfksa jlkds jösadj föjdsaf ölksj flkajs flksdj fölsaj fölksadj fölkjdsa fölkjdsa fölkdsa fölkadsj fölksaj 
+
+::::{figure-md}
+
+:::{image} ../_static/logo.png
+:name: abb
+:width: 50%
+:::
+
+This is my caption
+::::
+
+:::{note}
+:name: notiz
+This is a note.
+:::
+
+:::{warning}
+This is a warning
+:::
+
+:::{important}
+This is important!!!!
+:::
+
+:::{tip}
+This is a tip
+:::
+
+:::{math}
+:label: formel
+v = ta + (1-t)b, \qquad t \in [0;1]
+:::
+
+$$ 
+v + x^3 
+$$ (eqn:test)
+
+Lorem ipsum dolor sit amet, consetetur sadipscing elitr, sed diam nonumy eirmod tempor invidunt ut labore et dolore magna aliquyam erat, sed diam voluptua. At vero eos et accusam et justo duo dolores et ea rebum. Stet clita kasd gubergren, no sea takimata sanctus est Lorem ipsum dolor sit amet. Lorem ipsum dolor sit amet, consetetur sadipscing elitr, sed diam nonumy eirmod tempor invidunt ut labore et dolore magna aliquyam erat, sed diam voluptua. At vero eos et accusam et justo duo dolores et ea rebum. Stet clita kasd gubergren, no sea takimata sanctus est Lorem ipsum dolor sit amet.
+
+(absatz-target)=
+Lorem ipsum dolor sit amet, consetetur sadipscing elitr, sed diam nonumy eirmod tempor invidunt ut labore et dolore magna aliquyam erat, sed diam voluptua. At vero eos et accusam et justo duo dolores et ea rebum. Stet clita kasd gubergren, no sea takimata sanctus est Lorem ipsum dolor sit amet. Lorem ipsum dolor sit amet, consetetur sadipscing elitr, sed diam nonumy eirmod tempor invidunt ut labore et dolore magna aliquyam erat, sed diam voluptua. At vero eos et accusam et justo duo dolores et ea rebum. Stet clita kasd gubergren, no sea takimata sanctus est Lorem ipsum dolor sit amet. Lorem ipsum dolor sit amet, consetetur sadipscing elitr, sed diam nonumy eirmod tempor invidunt ut labore et dolore magna aliquyam erat, sed diam voluptua. At vero eos et accusam et justo duo dolores et ea rebum. Stet clita kasd gubergren, no sea takimata sanctus est Lorem ipsum dolor sit amet. 
+
+Duis autem vel eum iriure dolor in hendrerit in vulputate velit esse molestie consequat, vel illum dolore eu feugiat nulla facilisis at vero eros et accumsan et iusto odio dignissim qui blandit praesent luptatum zzril delenit augue duis dolore te feugait nulla facilisi. Lorem ipsum dolor sit amet, consectetuer adipiscing elit, sed diam nonummy nibh euismod tincidunt ut laoreet dolore magna aliquam erat volutpat. 
+
+Ut wisi enim ad minim veniam, quis nostrud exerci tation ullamcorper suscipit lobortis nisl ut aliquip ex ea commodo consequat. Duis autem vel eum iriure dolor in hendrerit in vulputate velit esse molestie consequat, vel illum dolore eu feugiat nulla facilisis at vero eros et accumsan et iusto odio dignissim qui blandit praesent luptatum zzril delenit augue duis dolore te feugait nulla facilisi. 
+
+Nam liber tempor cum soluta nobis eleifend option congue nihil imperdiet doming id quod mazim placerat facer possim assum. Lorem ipsum dolor sit amet, consectetuer adipiscing elit, sed diam nonummy nibh euismod tincidunt ut laoreet dolore magna aliquam erat volutpat. Ut wisi enim ad minim veniam, quis nostrud exerci tation ullamcorper suscipit lobortis nisl ut aliquip ex ea commodo consequat. 
+
+Duis autem vel eum iriure dolor in hendrerit in vulputate velit esse molestie consequat, vel illum dolore eu feugiat nulla facilisis. 
+
+Test fuer ein paar Referenzen, z.B. auf eine [Abbildung](#abb) oder eine [Notiz](#notiz). Dafuer muss `:name: NAME` mit angegeben werden. Fuer eine Formel sollte man `:label:` verwenden und kriegt eine Referenz der Form [](#formel), [](eqn:test). Fuer Ueberschriften (und Absaetze) kann man mit `(heading-target)=` einen Namen definieren. Dabei kommt diese Markierung **vor** dem Target. Die Referenz sieht so aus: [Ueberschrift](#subheading-target), [Absatz](#absatz-target). Links zu anderen Dokumenten (z.B. [](/getting_started.md), [](/getting_started.md#calibration)) gehen natuerlich auch.
+
+::::{grid} 2
+:::{grid-item-card}  Title 1
+:class-card: intro-card
+:link: ../index
+:link-type: doc
+:link-alt: To the user guide
+A link to the api documentation page.
+:::
+:::{grid-item-card}  Title 2
+Second card
+:::
+::::
+
+```{toctree}
+content.md
+```
\ No newline at end of file
diff --git a/docs/source/section/content.md b/docs/source/section/content.md
new file mode 100644
index 0000000000000000000000000000000000000000..2b4875a572ee3d66908f50322807523aa4af2b8a
--- /dev/null
+++ b/docs/source/section/content.md
@@ -0,0 +1,3 @@
+# Mein toller conent
+
+sadkjf skjda fkjds hfkjsad fkjds hfkjdsa hfjsa hflkjsa hflksah flkjs hflkjds hflkjdsa hflkjdsa hflkas hf
\ No newline at end of file
diff --git a/docs/source/tracking/export.md b/docs/source/tracking/export.md
new file mode 100644
index 0000000000000000000000000000000000000000..44f3ca666e71e890992288ede86d4e57d1912815
--- /dev/null
+++ b/docs/source/tracking/export.md
@@ -0,0 +1,3 @@
+# Export
+
+- Explaining different export options and what marker and/or camera (stereo) is needed to use them
\ No newline at end of file
diff --git a/docs/source/tracking/parameter-tuning.md b/docs/source/tracking/parameter-tuning.md
new file mode 100644
index 0000000000000000000000000000000000000000..954b24a48b2733e34e193261be1005a04a8c13c7
--- /dev/null
+++ b/docs/source/tracking/parameter-tuning.md
@@ -0,0 +1,4 @@
+# Parameter Tuning
+
+- How to tune tracking parameters (in tandem with recognition?)
+- Interactive usage vs. calculate all
\ No newline at end of file
diff --git a/docs/source/tracking/setting-up.md b/docs/source/tracking/setting-up.md
new file mode 100644
index 0000000000000000000000000000000000000000..757c2cc9fc01148c0b84407a0199346be61af142
--- /dev/null
+++ b/docs/source/tracking/setting-up.md
@@ -0,0 +1,5 @@
+# Set Up Tracking
+
+- Initial SetUp of Tracking
+- How to set ROI, ...
+- 
\ No newline at end of file
diff --git a/docs/source/tracking/tracking.md b/docs/source/tracking/tracking.md
new file mode 100644
index 0000000000000000000000000000000000000000..c6df0f56dfef57751ca7c8f6cedee78b9d285561
--- /dev/null
+++ b/docs/source/tracking/tracking.md
@@ -0,0 +1,12 @@
+# Tracking
+
+Here is the tracking docs.
+
+## Contents
+
+:::{toctree}
+:maxdepth: 1
+setting-up
+parameter-tuning
+export
+:::
\ No newline at end of file
diff --git a/docs/source/user_interface.md b/docs/source/user_interface.md
new file mode 100644
index 0000000000000000000000000000000000000000..86708777a7c1a521e9fb63118d90b13b0bdd2569
--- /dev/null
+++ b/docs/source/user_interface.md
@@ -0,0 +1,3 @@
+# User Interface
+
+Screenshot von PeTrack und einfache Erklaerung, was in welchem Bildbereich zu sehen ist (Video, Seitenleiste mit versch. Tabs, ...)
\ No newline at end of file