Add files via upload

docs/readthedocs/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    ?=
+SPHINXBUILD   ?= python3 -msphinx
+SOURCEDIR     = .
+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)

docs/readthedocs/_static/css/theme_override.css

@@ -0,0 +1,13 @@
+/* Suppress spacing after multi-line entries in tables
+ * Inspired by this issue: https://github.com/readthedocs/sphinx_rtd_theme/issues/117 */
+.wy-table-responsive table td div.line-block {
+    margin-bottom: 0;
+    font-size: 90%;
+}
+.wy-table-responsive table th div.line-block {
+    margin-bottom: 0;
+    font-size: 90%;
+}
+.wy-table-responsive table th p {
+    margin-bottom: 0;
+}

docs/readthedocs/_static/figures/cosPhiP.tex

@@ -0,0 +1,182 @@
+% \documentclass{article}
+\documentclass[border=0mm]{standalone}
+%\documentclass[border=0mm, convert={density=600, quality=90, outext=.png}]{standalone}
+% ===== Loading all packages =====
+% === input, languages, layout ===
+\usepackage[utf8]{inputenc}
+\usepackage[T1]{fontenc}
+\usepackage[ngerman]{babel}
+\usepackage{textcomp}
+\usepackage{url}
+\usepackage{printlen}
+\usepackage{lmodern}                % Latin Modern, bessere Fonts
+
+% === mathematics, numbers, units ===
+\usepackage{amsmath}
+\usepackage{amssymb}
+\usepackage{siunitx}
+\usepackage{calc}                   % enables the calculation of distances etc.
+
+% === figures, plots, drawing, ... ===
+\usepackage[cmyk]{xcolor}
+\usepackage{graphicx}
+\usepackage{tikz}
+\usepackage{pgfplots}
+\usepackage{pgfplotstable}
+
+% === other stuff ===
+\usepackage{multirow}               % Table entries reaching over more than one line
+\usepackage[
+    layout = inline,
+    final]{fixme}                  	% comments
+\usepackage{ifthen}
+
+% === setspace ===
+\linespread{1.15}
+
+% === tikz ===
+\usetikzlibrary{
+    fit,
+    positioning,
+    shapes,
+    calc,
+    pgfplots.groupplots,
+    plotmarks,
+    backgrounds,
+    matrix,
+    fadings,
+    external,
+    decorations.markings,
+    patterns,
+    arrows.meta,
+    intersections}
+
+% === xcolor ===
+% Color set "strong" of TU Dortmund university
+\definecolor{tuGreen}{cmyk}{0.57, 0, 1, 0}
+\definecolor{tuOrange}{cmyk}{0, 0.55, 1, 0}
+\definecolor{tuBlue}{cmyk}{1, 0, 0.36, 0}
+\definecolor{tuViolette}{cmyk}{0.25, 1, 0, 0}
+\definecolor{tuYellow}{cmyk}{0.05, 0.08, 1, 0}
+\definecolor{tuBrown}{cmyk}{0.05, 0.69, 1, 0}
+
+% === pgfplots ===
+% Definition of cycle lists
+\pgfplotscreateplotcyclelist{TUDefault}{%
+    {plain plot set = {none}{tuGreen}},%
+    {plain plot set = {none}{tuOrange}},%
+    {plain plot set = {none}{tuBlue}},%
+    {plain plot set = {none}{tuViolette}},%
+    {plain plot set = {none}{tuYellow}},%
+    {plain plot set = {none}{tuBrown}}%
+}
+
+\pgfplotsset{
+    compat = newest,
+    scale only axis,
+    width = 0.85\textwidth,
+    height = 0.25\textheight,
+    every axis legend/.append style = {nodes={right}},
+    xmajorgrids,
+    ymajorgrids,
+    legend style = {font = \tiny, at = {(0.5,1.025)}, anchor = south, legend columns = 6},
+    % Custom plot style (https://tex.stackexchange.com/questions/193589/pgfplots-how-can-i-define-one-cycle-list-for-all-graphs-or-the-least-amount-p/193596)
+    plain plot set/.style 2 args = {
+        #2,
+        mark = #1,
+        every mark/.append style = {fill = #2}
+    },
+    % Axis labels according to DIN 461 (based on https://tex.stackexchange.com/questions/391332/get-the-auto-generated-tick-distance-of-a-pgfplot-din-461/391430#391430)
+    % Argument 1: Axis description
+    % Argument 2: Axis unit
+    din xlabel/.style 2 args={
+        xticklabel style={
+            name=xlabel\ticknum,
+            append after command=\pgfextra{\xdef\lastxticknum{\ticknum}}
+        },
+        after end axis/.append code={
+            \pgfmathparse{int(\lastxticknum-1)}
+            \path (xlabel\lastxticknum.base) -- (xlabel\pgfmathresult.base) node (xAxUnit) [midway, anchor=base] {#2};
+            \node[anchor = east] (xAxDescr) at ($(xlabel\lastxticknum.base) + (-5mm,-3mm)$) {#1};
+            \draw[->] (xAxDescr.east) -- ($(xlabel\lastxticknum.base) + (0,-3mm)$);
+        }
+    },
+    din ylabel/.style 2 args={
+        yticklabel style={
+            name=ylabel\ticknum,
+            append after command=\pgfextra{\xdef\lastyticknum{\ticknum}}
+        },
+        after end axis/.append code={
+            \pgfmathparse{int(\lastyticknum-1)}
+            \path (ylabel\lastyticknum.base) -- (ylabel\pgfmathresult.base) node (yAxUnit) [midway, anchor=base] {#2};
+            \node[anchor = east, rotate = 90] (yAxDescr) at ($(ylabel\lastyticknum.west) + (-3mm,-5mm)$) {#1};
+            \draw[->] (yAxDescr.east) -- ($(ylabel\lastyticknum.west) + (-3mm,0)$);
+        }
+    },
+    din zlabel/.style 2 args={
+        zticklabel style={
+            name=zlabel\ticknum,
+            append after command=\pgfextra{\xdef\lastzticknum{\ticknum}}
+        },
+        after end axis/.append code={
+            \pgfmathparse{int(\lastzticknum-1)}
+            \path (zlabel\lastzticknum.base) -- (zlabel\pgfmathresult.base) node (zAxUnit) [midway, anchor=base] {#2};
+            \node[anchor = east, rotate = 90] (zAxDescr) at ($(zlabel\lastzticknum.west) + (-3mm,-5mm)$) {#1};
+            \draw[->] (zAxDescr.east) -- ($(zlabel\lastzticknum.west) + (-3mm,0)$);
+        }
+    }
+}
+
+\usepgfplotslibrary{groupplots}
+\pgfdeclarelayer{background}
+\pgfdeclarelayer{foreground}
+\pgfsetlayers{background,main,foreground}
+
+% === SIunitx ===
+\sisetup{
+    load-configurations = abbreviations,            % load units with abbreviations
+    range-phrase = \ldots,
+    list-final-separator = { \translate{und} },
+    list-pair-separator = { \translate{und} },
+    output-decimal-marker = {,},
+    group-minimum-digits = 3,
+    group-separator = {.},
+    exponent-product = \cdot,
+    per-mode = symbol-or-fraction
+}
+\DeclareSIUnit{\Wp}{Wp}
+\DeclareSIUnit{\kWp}{kWp}
+\DeclareSIUnit{\kWh}{kWh}
+\DeclareSIUnit{\GWh}{GWh}
+\DeclareSIUnit{\TWh}{TWh}
+\DeclareSIUnit{\pu}{p.u.}
+\DeclareSIUnit{\VA}{VA}
+\DeclareSIUnit{\VAr}{VAr}
+
+% Command for printing the complex j
+\newcommand{\cj}{\text{j}}
+
+\begin{document}
+	    \begin{tikzpicture}
+			\begin{axis}[
+		        width = 300pt,
+		        height = 150pt,
+				cycle list name = TUDefault,
+				xmin = -0.1, xmax = 1.1,
+				xtick = {0, 0.2, ..., 1.2},
+				ytick = {0.95, 0.975, 1.0},
+	            y tick label style={
+	                /pgf/number format/fixed,
+	                /pgf/number format/fixed zerofill,
+	                /pgf/number format/precision=2},
+	            din xlabel={Active power $p$}{\si{\pu}},
+	            din ylabel={Power factor $cos \varphi$}{--}
+			]
+				\addplot+[tuOrange, mark = *, mark options = {fill = tuOrange}] coordinates {
+				    (0,1)
+				    (0.9,1)
+				    (1,0.95)
+				};
+			\end{axis}
+	    \end{tikzpicture}
+\end{document}