From 34f94d6cea0a225a2af37839a3374f32b7b21fe7 Mon Sep 17 00:00:00 2001 From: Caleb Schilly Date: Thu, 24 Oct 2024 11:47:59 -0400 Subject: [PATCH 1/9] #6: initial commit with baseline docs from pressio --- LICENSE | 40 +- docs/Makefile | 5 + docs/build_requirements.txt | 7 + .../front_page_schematic/frontpageschem.pdf | Bin 0 -> 94135 bytes .../front_page_schematic/frontpageschem.svg | 866 ++++++++++++++++++ .../front_page_schematic/frontpageschem.tex | 359 ++++++++ docs/source/_static/frontpageschem.svg | 866 ++++++++++++++++++ docs/source/_static/hacks.css | 170 ++++ docs/source/_static/logo.png | Bin 0 -> 7521 bytes docs/source/components/expressions.rst | 15 + docs/source/components/expressions/diag.rst | 63 ++ docs/source/components/expressions/span.rst | 68 ++ .../source/components/expressions/subspan.rst | 71 ++ docs/source/components/mpl.rst | 114 +++ docs/source/components/ops.rst | 12 + docs/source/components/ops/clone.rst | 80 ++ docs/source/components/ops/fill.rst | 66 ++ docs/source/components/type_traits.rst | 130 +++ docs/source/concepts_note.rst | 78 ++ docs/source/conf.py | 134 +++ docs/source/index.rst | 199 ++++ docs/source/installation.rst | 142 +++ docs/source/keywords.rst | 83 ++ docs/source/license.rst | 51 ++ docs/source/mydefs.rst | 50 + 25 files changed, 3649 insertions(+), 20 deletions(-) create mode 100644 docs/Makefile create mode 100644 docs/build_requirements.txt create mode 100644 docs/source/_static/front_page_schematic/frontpageschem.pdf create mode 100644 docs/source/_static/front_page_schematic/frontpageschem.svg create mode 100644 docs/source/_static/front_page_schematic/frontpageschem.tex create mode 100644 docs/source/_static/frontpageschem.svg create mode 100644 docs/source/_static/hacks.css create mode 100644 docs/source/_static/logo.png create mode 100644 docs/source/components/expressions.rst create mode 100644 docs/source/components/expressions/diag.rst create mode 100644 docs/source/components/expressions/span.rst create mode 100644 docs/source/components/expressions/subspan.rst create mode 100644 docs/source/components/mpl.rst create mode 100644 docs/source/components/ops.rst create mode 100644 docs/source/components/ops/clone.rst create mode 100644 docs/source/components/ops/fill.rst create mode 100644 docs/source/components/type_traits.rst create mode 100644 docs/source/concepts_note.rst create mode 100644 docs/source/conf.py create mode 100644 docs/source/index.rst create mode 100644 docs/source/installation.rst create mode 100644 docs/source/keywords.rst create mode 100644 docs/source/license.rst create mode 100644 docs/source/mydefs.rst diff --git a/LICENSE b/LICENSE index 970d619..e33707e 100644 --- a/LICENSE +++ b/LICENSE @@ -5,37 +5,37 @@ // Copyright 2019 National Technology & Engineering Solutions of Sandia,LLC // (NTESS) // -// Under the terms of Contract DE-NA0003525 with NTESS, the +// Under the terms of Contract DE-NA0003525 with NTESS, the // U.S. Government retains certain rights in this software. // // Pressio is licensed under BSD-3-Clause terms of use: // // Redistribution and use in source and binary forms, with or without -// modification, are permitted provided that the following conditions +// modification, are permitted provided that the following conditions // are met: // -// 1. Redistributions of source code must retain the above copyright +// 1. Redistributions of source code must retain the above copyright // notice, this list of conditions and the following disclaimer. -// -// 2. Redistributions in binary form must reproduce the above copyright -// notice, this list of conditions and the following disclaimer in the +// +// 2. Redistributions in binary form must reproduce the above copyright +// notice, this list of conditions and the following disclaimer in the // documentation and/or other materials provided with the distribution. -// -// 3. Neither the name of the copyright holder nor the names of its -// contributors may be used to endorse or promote products derived +// +// 3. Neither the name of the copyright holder nor the names of its +// contributors may be used to endorse or promote products derived // from this software without specific prior written permission. // -// THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS -// "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT -// LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS -// FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE -// COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, -// INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES -// (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR -// SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) -// HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, -// STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING -// IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE +// THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS +// "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT +// LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS +// FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE +// COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, +// INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES +// (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR +// SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) +// HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, +// STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING +// IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE // POSSIBILITY OF SUCH DAMAGE. // // Questions? Contact Francesco Rizzi (fnrizzi@sandia.gov) diff --git a/docs/Makefile b/docs/Makefile new file mode 100644 index 0000000..b95c2f9 --- /dev/null +++ b/docs/Makefile @@ -0,0 +1,5 @@ +html: + sphinx-build -b html ./source/ ./generated_docs/ + +clean: + rm -rf ./generated_docs/ diff --git a/docs/build_requirements.txt b/docs/build_requirements.txt new file mode 100644 index 0000000..09de70f --- /dev/null +++ b/docs/build_requirements.txt @@ -0,0 +1,7 @@ +Sphinx==5.0.1 +furo==2022.6.4.1 +myst-parser==0.18.0 +sphinx-copybutton==0.5.0 +m2r2==0.3.2 +sphinx-design +attrs diff --git a/docs/source/_static/front_page_schematic/frontpageschem.pdf b/docs/source/_static/front_page_schematic/frontpageschem.pdf new file mode 100644 index 0000000000000000000000000000000000000000..90b2a0b1252b0e8cd52fc88a82733945c8fa8be4 GIT binary patch literal 94135 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%0D+4mA~sRR3sd#7`l72#fvUBIaG7FhS~+Ck*La# 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 ?8ID0G@pZ4;S!T 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πHIweZyo_CH0?I2kGg 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 Wv%BMWo;jG + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/docs/source/_static/front_page_schematic/frontpageschem.tex b/docs/source/_static/front_page_schematic/frontpageschem.tex new file mode 100644 index 0000000..c5f7710 --- /dev/null +++ b/docs/source/_static/front_page_schematic/frontpageschem.tex @@ -0,0 +1,359 @@ + +\documentclass{standalone} + +\usepackage{amsfonts} +\usepackage{graphicx} +\usepackage{epstopdf} +\usepackage{algorithmic} +\usepackage{listings} +\usepackage{fancyvrb} +\usepackage{booktabs} +\usepackage{multirow} +\usepackage{pgf} +\usepackage{tikz} +\usetikzlibrary{shapes, arrows, positioning,fit, automata, + arrows.meta, decorations.markings, calc} +\usepackage{tikzscale} +\usepackage{xcolor} +%\usepackage{tikz-uml} +\usepackage{mathtools} +\usetikzlibrary{decorations} +%\usetikzlibrary{decorations.text} + +\definecolor{colWhite}{HTML}{FFFFFF} + +% general naming macros +\newcommand{\code}[1]{{\ttfamily\color{black} #1}} +\newcommand{\pressio}{$\mathbf{Pressio}$} +\newcommand{\pressioFpy}{$\mathbf{pressio4py}$} +\newcommand{\modred}{$\mathbf{modred}$} +\newcommand{\pymor}{$\mathbf{pyMOR}$} +\newcommand{\pyrom}{$\mathbf{pyROM}$} +\newcommand{\librom}{$\mathbf{libROM}$} +% math macros general +\newcommand{\defeq}{\vcentcolon =} +\newcommand*{\difftime}[1]{\dot{#1}} +\newcommand{\tfinal}{T} +\newcommand{\RR}[1]{\mathbb{R}^{#1}} +\newcommand{\RRstar}[1]{\mathbb{R}_\star^{#1}} +\newcommand{\RRplus}{\mathbb{R}_{+}} +\newcommand{\dstate}{\boldsymbol{\xi}} +\newcommand{\drdstate}{\hat{\boldsymbol{\xi}}} +\newcommand{\range}{\text{Ran}} +\newcommand*{\pseudoInvSymb}{+} +\newcommand*{\pseudoInv}{^\pseudoInvSymb} + +\newcommand{\Boper}{\boldsymbol B} + +% FOM math macros +\newcommand{\fomDof}{N} +\newcommand{\state}{\boldsymbol y} +\newcommand{\aprxState}{\tilde{\state}} +\newcommand{\initState}{\state^{0}} +\newcommand{\stateRef}{\state_\text{ref}} +\newcommand{\velocity}{\boldsymbol f} +\newcommand{\dvelocity}{\boldsymbol v} +\newcommand{\dtime}{\tau} +\newcommand{\params}{\boldsymbol \mu} +\newcommand{\dparams}{\boldsymbol \nu} +\newcommand{\paramDomain}{\mathcal D} +\newcommand{\nparams}{n_{\params}} +\newcommand{\fomJac}{\partial\velocity/\partial \state} +%\newcommand{\aprxFomJac}{\partial\velocity/\partial \aprxState} +%\newcommand{\aprxFomJac}{\frac{\partial\velocity}{\partial \state}(\aprxState,t;\params)} +\newcommand{\fomJacVel}{ \boldsymbol J_{\velocity}} +\newcommand{\fomJacRes}{ \boldsymbol J_{R}} +\newcommand{\aprxFomJacFrac}{ \frac{\partial\velocity}{\partial \aprxState}} + +% ROM macros +\newcommand{\dofRom}{p} +\newcommand{\romState}{\hat{\state}} +\newcommand{\romToFomMapping}{\boldsymbol g} +\newcommand{\romBasis}{\boldsymbol{\Phi}} +\newcommand*{\tangentSpace}[1]{T_{#1}\manifold } +\newcommand{\manifold}{\mathcal M} +\newcommand{\gRomState}{\hat{\boldsymbol \xi}} +\newcommand{\jacOfRomFomMapping}{\boldsymbol{J}} +\newcommand{\gVelo}{\hat{\boldsymbol{v}}} +\newcommand{\initRomState}{\romState^{0}} +%\newcommand{\gaprxstate}{\tilde{\gstate}} + +\newcommand{\weightMat}{\boldsymbol{A}} +\newcommand{\weightMatDiag}{\boldsymbol{D}} +\newcommand{\identity}{\boldsymbol{I}} +\newcommand{\collocMat}{\boldsymbol{P}} +\newcommand{\phires}{{\boldsymbol \Phi}_r} +\newcommand{\gnatWMat}{(\collocMat \phires)^+ \collocMat} + +% Time stepping +\newcommand{\zero}{\boldsymbol{0}} +\newcommand{\res}{\boldsymbol{r}} +\newcommand{\timeStep}{\Delta t} +\newcommand{\nseq}{{N_t}} + + +\tikzstyle{block} = [draw, rectangle, minimum height=3em, minimum width=6em] + +\definecolor{appCol}{HTML}{FFFF00} +\definecolor{pressioCol}{HTML}{FFFFFF} + +\begin{document} + +\tikzset{ + ncbar angle/.initial=90, + ncbar/.style={ + to path=(\tikztostart) + -- ($(\tikztostart)!#1!\pgfkeysvalueof{/tikz/ncbar angle}:(\tikztotarget)$) + -- ($(\tikztotarget)!($(\tikztostart)!#1!\pgfkeysvalueof{/tikz/ncbar angle}:(\tikztotarget)$)!\pgfkeysvalueof{/tikz/ncbar angle}:(\tikztostart)$) + -- (\tikztotarget) + }, + ncbar/.default=0.5cm, +} +\tikzset{square left brace/.style={ncbar=0.3cm}} + + +\begin{tikzpicture}[auto, node distance=2cm] + + % application + \node [ + block, + draw=appCol, + text=appCol, + rounded corners, + node distance=3cm, + minimum width=0.6\textwidth, + minimum height=3cm + ](app) + { + \shortstack{ + \LARGE{Application Code}\\ + \vspace{0.3cm} + \Large{(owns mesh, physics, etc.)} + %\Large{$\dot{\state} = \velocity(\state,t;\params)$} + %% \Large{$\state(0;\params) = \initState(\params)$} + } + }; + + % adapter + \node [ + block, + draw=appCol, + text=appCol, + below=of app.south east, + anchor=north east, + node distance=9cm, + rounded corners, + minimum width=0.29\textwidth, + minimum height=3cm, + yshift=0.6cm, + xshift=-3.75cm + ] (adapter) + { + \shortstack{ + \Large{Contin.-time}\\ + \Large{Adapter} + } + }; + + % adapter2 + \node [ + block, + draw=appCol, + text=appCol, + below=of app.south east, + anchor=north east, + node distance=9cm, + rounded corners, + minimum width=0.29\textwidth, + minimum height=3cm, + xshift=0cm, + yshift=0.6cm + ] (adapter2) + { + \shortstack{ + \Large{Discrete-time}\\ + \Large{Adapter} + } + }; + + % MAIN + \node [ + block, + draw=appCol, + text=appCol, + right=of app, + anchor=north west, + node distance=8cm, + rounded corners, + minimum width=0.2\textwidth, + minimum height=12.45cm, + yshift=1.5cm, + xshift=-1.5cm + ] (main) + { + \hspace{0.2cm}\Large{\Large{int main()}}\hspace{0.2cm} + }; + + \node [ + block, + draw=pressioCol, + text=pressioCol, + below=of adapter, + rounded corners, + node distance=1.2cm, + minimum width=0.17\textwidth, + yshift=0.6cm, + xshift=-0.375cm + ](galerkin){GALERKIN}; + + \node [ + block, + draw=pressioCol, + text=pressioCol, + below=of adapter, + right=of galerkin, + rounded corners, + node distance=1.2cm, + minimum width=0.17\textwidth, + xshift=-1.75cm + ](lspg){LSPG}; + + \node [ + block, + draw=pressioCol, + text=pressioCol, + below=of adapter, + right=of lspg, + rounded corners, + node distance=1.2cm, + minimum width=0.17\textwidth, + xshift=-1.75cm + ](wls){WLS}; + + \node [ + text=pressioCol, + draw=black!50, + rounded corners, + fit={(galerkin) (lspg) (wls)}, + minimum width=0.6\textwidth + ](pressiorom) {}; + + % ode + \node [ + block, + draw=pressioCol, + text=pressioCol, + below=of adapter, + %node distance=9cm, + rounded corners, + minimum width=0.6\textwidth, + yshift=-0.75cm, + xshift=1.95cm + ] (ode){ODE}; + + % nonlinear solvers + \node [ + block, + draw=pressioCol, + text=pressioCol, + below=of ode, + node distance=9cm, rounded corners, + minimum width=0.6\textwidth, + yshift=1.82cm + ] (solvers){LINEAR/NONLINEAR SOLVERS}; + + % all other packages + \node [ + block, + draw=pressioCol, + text=pressioCol, + below=of main, + rounded corners, + minimum width=0.875\textwidth, + yshift=1.8cm, + xshift=-3.85cm + ] (basicpacks){MPL UTILS CONTAINERS OPS QR ...}; + + \node [left=of adapter, text=appCol, yshift=2cm, xshift=0.8cm](pApp) {\rotatebox{90}{\Large{Application}}}; + \node [left=of ode, text=pressioCol, yshift=-0.5cm, xshift=0.8cm](pPres) {\rotatebox{90}{\Large{\pressio}}}; + \node [left=of pressiorom, text=pressioCol, xshift=1.85cm](pRoms) {\rotatebox{90}{ROMs}}; + \node [left=of ode, text=pressioCol, yshift=-1.3cm,xshift=1.85cm](pPack) {\rotatebox{90}{Supporting Packages}}; + %% \draw [orange, thick] (basicpacks.south west) to [square left brace ] (ode.north west); + %% \draw [orange, thick] (pressiorom.south west) to [square left brace ] (pressiorom.north west); + + \draw [pressioCol, thick] + ([xshift=-0.7cm]basicpacks.south west) + to [square left brace ] ([xshift=-0.7cm]pressiorom.north west); + + %% % box around application + %% \node [fit=(main) (adapter) (app), + %% pin={[pin distance=0.1cm, yshift=2cm]left:\LARGE{\rotatebox{90}{Application Side}}}] (p5) {}; + + %% %% % box for optional part + %% %% \node [fit=(adapter), + %% %% pin={[pin distance=0.2cm]left:\Large{\rotatebox{90}{Optional}}}] (p5) {}; + + \tikzset{myptr/.style={decoration={markings,mark=at position 1 with + {\arrow[scale=1.3,>=stealth]{>}}},postaction={decorate}}} + + % rom -> adapter + \draw[red, line width=1.5pt, myptr] ([xshift=-0.4cm]pressiorom.north -| adapter) + -- node {\begin{tabular}{c} \large{$\aprxState,t$} \\ \large{[,$\Boper$]} \end{tabular}} + ([xshift=-0.4cm]adapter.south); + % adapter -> rom + \draw[green, line width=1.5pt, myptr]([xshift=-0.15cm]adapter.south) + -- node [right] {\large{$\velocity [,\fomJacVel \Boper]$}} + ([xshift=-0.15cm]pressiorom.north -| adapter); + % adapter -> app + \draw[appCol, text=appCol, line width=1.5pt, myptr]([xshift=-0.4cm]adapter.north) + -- node {\begin{tabular}{c} \large{$\aprxState,t$} \\ \large{[,$\Boper$]} \end{tabular}} + ([xshift=-2.26cm]app.south); + % app -> adapter + \draw[appCol, text=appCol, line width=1.5pt, myptr]([xshift=-2.01cm]app.south) + -- node [right] {\large{$\velocity [,\fomJacVel \Boper]$}} + ([xshift=-0.15cm]adapter.north); + + % rom -> adapter2 + \draw[red, line width=1.5pt, myptr] ([xshift=0.15cm]pressiorom.north -| adapter2) + -- node {\begin{tabular}{c} \large{$\aprxState_{n,n-1,...}$} \\ \large{$t,\Boper$} \end{tabular}} + ([xshift=0.15cm]adapter2.south); + % adapter2 -> rom + \draw[green, line width=1.5pt, myptr]([xshift=0.4cm]adapter2.south) + -- node [right] {\large{$R,\fomJacRes \Boper$}} + ([xshift=0.4cm]pressiorom.north -| adapter2); + % adapter2 -> app + \draw[appCol, text=appCol, line width=1.5pt, myptr]([xshift=0.15cm]adapter2.north) + -- node {\begin{tabular}{c} \large{$\aprxState_{n,n-1,...}$} \\ \large{$t,\Boper$} \end{tabular}} + ([xshift=2.03cm]app.south); + % app -> adapter2 + \draw[appCol, text=appCol, line width=1.5pt, myptr]([xshift=2.28cm]app.south) + -- node [right] {\large{$R,\fomJacRes \Boper$}} + ([xshift=0.4cm]adapter2.north); + + + \node [left=of app.west, yshift=1.65cm, xshift=1cm](p1){}; + \node [left=of adapter.west, yshift=-1.5cm, xshift=1cm](p2){}; + \node [right=of adapter2.east, yshift=-1.5cm, xshift=-1.8cm](p3){}; + \node [left=of main.south west, yshift=-0.1cm, xshift=1.95cm](p4){}; + \node [right=of main.south east, yshift=-0.1cm, xshift=-1.92cm](p5){}; + \node [right=of main.north east, yshift=0.15cm, xshift=-1.92cm](p6){}; + + \draw [thick, dashed, draw=appCol] (p1) -- (p2) -- (p3) -- (p4) -- (p5) -- (p6) -- (p1); + + + %% % arrows from main to others + %% %\draw[black, arrows={-Circle[black,fill=black]}, line width=2pt] + %% \draw[black, arrows={-o}, line width=2pt] + %% (main.north) -- ([xshift=-4.79cm]pressiorom.south); + + %% %\draw[black, arrows={-Circle[black,fill=black]}, line width=2pt] + %% \draw[black, arrows={-o}, line width=2pt] + %% ([yshift=2.55cm]main.east) -- (adapter.west); + + %% %\draw[black, arrows={-Circle[black,fill=black]}, line width=2pt] + %% \draw[black, arrows={-o}, line width=2pt ] + %% ([yshift=-2.45cm]main.east) -- (app.west); + +\end{tikzpicture} + +\end{document} diff --git a/docs/source/_static/frontpageschem.svg b/docs/source/_static/frontpageschem.svg new file mode 100644 index 0000000..e2e5685 --- /dev/null +++ b/docs/source/_static/frontpageschem.svg @@ -0,0 +1,866 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/docs/source/_static/hacks.css b/docs/source/_static/hacks.css new file mode 100644 index 0000000..0b12d62 --- /dev/null +++ b/docs/source/_static/hacks.css @@ -0,0 +1,170 @@ +/* + * CSS hacks and small modification for my Sphinx website + * :copyright: Copyright 2013-2016 Lilian Besson + * :license: GPLv3, see LICENSE for details. + */ + + +/* Colors and text decoration. + For example, :black:`text in black` or :blink:`text blinking` in rST. */ + +.black { + color: black; +} + +.gray { + color: gray; +} + +.grey { + color: gray; +} + +.silver { + color: silver; +} + +.white { + color: white; +} + +.maroon { + color: maroon; +} + +.red { + color: red; +} + +.magenta { + color: magenta; +} + +.fuchsia { + color: fuchsia; +} + +.pink { + color: pink; +} + +.orange { + color: orange; +} + +.yellow { + color: yellow; +} + +.lime { + color: lime; +} + +.green { + color: green; +} + +.olive { + color: olive; +} + +.teal { + color: teal; +} + +.cyan { + color: cyan; +} + +.aqua { + color: aqua; +} + +.blue { + color: blue; +} + +.navy { + color: navy; +} + +.purple { + color: purple; +} + +.under { + text-decoration: underline; +} + +.over { + text-decoration: overline; +} + +.blink { + text-decoration: blink; +} + +.line { + text-decoration: line-through; +} + +.strike { + text-decoration: line-through; +} + +.it { + font-style: italic; +} + +.ob { + font-style: oblique; +} + +.small { + font-size: small; +} + +.medium { + font-size: medium; +} + +.large { + font-size: large; +} + +.smallpar { + font-size: small; +} + +.packnameindexpage { + font-size: large; + color: orange; +} + +.summarylineindexpage { + font-size: large; + font-style: italic; + color: olive; +} + +.memberfunction { + font-size: large; + font-weight: bold; + color: olive; +} + +:root { + --icon--pied-piper: url('data:image/svg+xml;charset=utf-8,'); +} +.admonition.pied-piper { + border-color: rgb(43, 155, 70); +} +.admonition.pied-piper > .admonition-title { + background-color: rgba(43, 155, 70, 0.1); + border-color: rgb(43, 155, 70); +} +.admonition.pied-piper > .admonition-title::before { + background-color: rgb(43, 155, 70); + -webkit-mask-image: var(--icon--pied-piper); + mask-image: var(--icon--pied-piper); +} diff --git a/docs/source/_static/logo.png b/docs/source/_static/logo.png new file mode 100644 index 0000000000000000000000000000000000000000..cea1d228426650b091462060df4752906423392f GIT binary patch literal 7521 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 + +Public namespace: ``pressio`` + + +.. + .. toctree:: + :maxdepth: 1 + + expressions/span + expressions/subspan + expressions/diag diff --git a/docs/source/components/expressions/diag.rst b/docs/source/components/expressions/diag.rst new file mode 100644 index 0000000..601f50d --- /dev/null +++ b/docs/source/components/expressions/diag.rst @@ -0,0 +1,63 @@ +.. include:: ../../mydefs.rst + +``diagonal`` +============ + +Header: ```` + +API +--- + +.. code-block:: cpp + + namespace pressio { + + template + /*impl defined*/ diagonal(T & operand); + + } // end namespace pressio + +Parameters +---------- + +* ``operand``: the object whose diagonal we want to view + +Constraints +~~~~~~~~~~~ + +- ``T`` must be: + + - an Eigen dense matrix, ``pressio::is_dense_matrix_eigen::value == true`` + + - or a Kokkos rank-2 view, i.e. ``pressio::is_dense_matrix_kokkos::value == true`` + +Preconditions +~~~~~~~~~~~~~ + +- ``operand`` must be a square matrix + +Mandates +~~~~~~~~ + +:red:`finish` + + +Return value +~~~~~~~~~~~~ + +None + +Effects +~~~~~~~ + +Returns an expression object that represents the "diagonal" of ``operand``. +We refer to this as an expression because the ``diag`` function does not allocate +new memory or copy any data, but only creates an instance of a +class that "represents the diagonal". + +Postconditions +~~~~~~~~~~~~~~ + +The returned object is valid to use until the operand goes out of scope. + +:red:`finish` diff --git a/docs/source/components/expressions/span.rst b/docs/source/components/expressions/span.rst new file mode 100644 index 0000000..56cbb73 --- /dev/null +++ b/docs/source/components/expressions/span.rst @@ -0,0 +1,68 @@ +.. include:: ../../mydefs.rst + +``span`` +======== + +Header: ```` + +API +--- + +.. code-block:: cpp + + namespace pressio { + + template + /*impl defined*/ span(T & operand, + std::pair indexRange)); + + } // end namespace pressio + +Parameters +---------- + +* ``operand``: the object to construct a span of + +* ``indexRange``: a std::pair identifying an interval ``[a, b)`` where the second index is exclusive + +Constraints +~~~~~~~~~~~ + +- ``T`` must be: + + - an Eigen vector object: ``pressio::is_vector_eigen::value == true`` + + - or a Kokkos rank-1 view, i.e. ``pressio::is_vector_kokkos::value == true`` + + +Preconditions +~~~~~~~~~~~~~ + +:red:`finish` + +Mandates +~~~~~~~~ + +:red:`finish` + + +Return value +~~~~~~~~~~~~ + +None + +Effects +~~~~~~~ + +Returns an expression object that represents a target span of the ``operand``. +We refer to this as an expression because the span function does not allocate +new memory but only creates an instance of a class that "represents the span operation". + +Postconditions +~~~~~~~~~~~~~~ + +The returned span object remains valid to use until the operand goes out of scope. +If the operand goes out of scope but you still have a span object, the state of the span +object is undefined. + +:red:`finish` diff --git a/docs/source/components/expressions/subspan.rst b/docs/source/components/expressions/subspan.rst new file mode 100644 index 0000000..4ad9c0d --- /dev/null +++ b/docs/source/components/expressions/subspan.rst @@ -0,0 +1,71 @@ +.. include:: ../../mydefs.rst + +``subspan`` +=========== + +Header: ```` + +API +--- + +.. code-block:: cpp + + namespace pressio { + + template + /*impl defined*/ subspan(T & operand, + std::pair rowsRange, + std::pair colsRange)); + + } // end namespace pressio + +Parameters +---------- + +* ``operand``: the object to construct a subspan of + +* ``rowsRange``: identifies the rows interval to use (the second index is exclusive) + +* ``colsRange``: identifies the cols interval to use (the second index is exclusive) + +Constraints +~~~~~~~~~~~ + +- ``T`` must be: + + - an Eigen dense matrix, ``pressio::is_dense_matrix_eigen::value == true`` + + - or a Kokkos rank-2 view, i.e. ``pressio::is_dense_matrix_kokkos::value == true`` + +Preconditions +~~~~~~~~~~~~~ + +:red:`finish` + +Mandates +~~~~~~~~ + +:red:`finish` + + +Return value +~~~~~~~~~~~~ + +None + +Effects +~~~~~~~ + +Returns an expression object that represents a subspan of the ``operand``. +We refer to this as an expression because the subspan function does not allocate +new memory or copy data, but only creates an instance of a +class that "represents the subspan operation". + +Postconditions +~~~~~~~~~~~~~~ + +The returned object is valid to use until the operand goes out of scope. +If the operand goes out of scope but you still have a subspan object, +the state of the subspan object is undefined. + +:red:`finish` diff --git a/docs/source/components/mpl.rst b/docs/source/components/mpl.rst new file mode 100644 index 0000000..b8c8339 --- /dev/null +++ b/docs/source/components/mpl.rst @@ -0,0 +1,114 @@ +.. role:: raw-html-m2r(raw) + :format: html + +.. include:: ../mydefs.rst + + +``mpl`` +======= + +Header: ```` + +Public namespace: ``pressio::mpl`` + + +Scope +----- + +Provides metaprogramming functionalities needed to +support generic programming, which is a fundamental +building block of the pressio library. +If you are familiar with the ```` header from +the standard library, the ``pressio/mpl`` will look familiar too. +Some parts of ``pressio/mpl`` have been adapted from the `tinympl project `_. +The tinympl project appears to be no longer maintained. + +The following is a *partial* list only intended to provide a general idea of the supported features. + +To find out all supported cases, browse the `source `__. + + +.. + ``pressio::mpl::not_void`` + ~~~~~~~~~~~~~~~~~~~~~~~~~~ + + .. code-block:: cpp + + template struct not_void; + + * + Provides the static member constant ``value`` that is equal to true, if ``T`` is NOT of + the type ``void``\ , ``const void``\ , ``volatile void``\ , or ``const volatile void``. + Otherwise, value is true. + + * + Example:\ :raw-html-m2r:`
` + + .. code-block:: cpp + + namespace pmpl = pressio::mpl; + static_assert(pmpl::not_void::value, "" ); + + +``pressio::mpl::all_of`` +~~~~~~~~~~~~~~~~~~~~~~~~ + +.. code-block:: cpp + + template< template class F, class ... Args> struct all_of; + +* + Determines whether every element in the sequence satisfies the given predicate. + The predicate ``F`` must be such that ``F::value`` must be convertible to ``bool``. + Provides the static member constant ``value`` that is equal to true iff + all the elements in the sequence satisfy the predicate ``F``. + Otherwise, value is false. + +* + Example:\ :raw-html-m2r:`
` + + .. code-block:: cpp + + namespace pmpl = pressio::mpl; + static_assert(pmpl::all_of::value, "" ); + + +``pressio::mpl::any_of`` +~~~~~~~~~~~~~~~~~~~~~~~~ + +.. code-block:: cpp + + template< template class F, class ... Args> struct any_of; + +* Determines whether any element in the sequence satisfies the given predicate. + The predicate ``F`` must be such that ``F::value`` must be convertible to ``bool``. + Provides the static member constant ``value`` that is equal to true iff + at least one element in the sequence satisfies the predicate ``F``. + Otherwise, value is equal to false. + + +``pressio::mpl::none_of`` +~~~~~~~~~~~~~~~~~~~~~~~~~ + +.. code-block:: cpp + + template< template class F, class ... Args> struct none_of; + +* Determines whether none of the elements in the sequence satisfy the given predicate. + The predicate ``F`` must be such that ``F::value`` must be convertible to ``bool``. + Provides the static member constant ``value`` that is equal to true iff + none of the elements in the sequence satisfy the predicate ``F``. + Otherwise, value is equal to false. + + +``pressio::mpl::is_subscriptable_as`` +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +.. code-block:: cpp + + template struct is_subscriptable_as; + +* Provides the static member constant ``value`` that is equal to true if + ``T`` has subscript operator ``[]``\ , it can be indexed by an instance of ``IndexType``\ , + and the return type is not void. + Otherwise, value is equal to false. diff --git a/docs/source/components/ops.rst b/docs/source/components/ops.rst new file mode 100644 index 0000000..76c4b0d --- /dev/null +++ b/docs/source/components/ops.rst @@ -0,0 +1,12 @@ + +.. include:: ../mydefs.rst + +``ops`` +======= + +Header: ```` + +Public namespace: ``pressio::ops`` + + +:red:`finish` diff --git a/docs/source/components/ops/clone.rst b/docs/source/components/ops/clone.rst new file mode 100644 index 0000000..65da376 --- /dev/null +++ b/docs/source/components/ops/clone.rst @@ -0,0 +1,80 @@ +.. include:: ../../mydefs.rst + +.. role:: cpp(code) + :language: cpp + +``clone`` +========= + +Header: ```` + +API +--- + +.. code-block:: cpp + + namespace pressio { namespace ops{ + + template + T clone(const T & operand); + + }} // end namespace pressio::ops + +Parameters +---------- + +* ``operand``: the object to clone + +Constraints +~~~~~~~~~~~ + +- ``T`` must be: + + - an Eigen vector or matrix object: + ``pressio::is_vector_eigen::value || pressio::is_dense_matrix_eigen::value || + pressio::is_sparse_matrix_eigen::value`` + + - or a Kokkos rank-1 or rank-2 view: ``pressio::is_vector_kokkos::value || + pressio::is_dense_matrix_kokkos::value`` + + - or an epetra vector or multi-vector: ``pressio::is_vector_epetra::value || + pressio::is_multi_vector_epetra::value`` + + - or a tpetra vector or multi-vector: ``pressio::is_vector_tpetra::value || + pressio::is_multi_vector_tpetra::value`` + + - or a tpetra block vector or multi-vector: ``pressio::is_vector_tpetra_block::value || + pressio::is_multi_vector_tpetra_block::value`` + +Preconditions +~~~~~~~~~~~~~ + +None + +Return value, Effects, and Postconditions +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +- Creates and returns a new instance of :cpp:`T` by making a new allocation + and *copying* all values from :cpp:`operand` into it. So it is an exact + but independent clone of :cpp:`operand`. + +- This is a blocking operation, i.e. the kernel completes before returning. + +- This kernel has value semantics, even for types that, by default, + have view semantics like Kokkos, Tpetra or TpetraBlock. + This means the following: + let :cpp:`auto result = clone(operand)`, then any operation applied + to :cpp:`operand` *after* calling clone will NOT + have any impact on ``result``. + And any operation applied to ``result`` will not have any impact on ``operand``. + +Notes +~~~~~ + +- For types that have value semantics, for example ``Eigen::Matrix<...>``, + Epetra vector or MV, this kernel can be implemented by calling the copy constructor + and returning the copy + +- For Kokkos, Tpetra, or TpetraBlock data types, which by default have view semantics + (i.e. a copy is a shallow copy), the operation can be implemented by first making a new + object with extents identical to ``operand``, followed by a deep copy, and then return the result. diff --git a/docs/source/components/ops/fill.rst b/docs/source/components/ops/fill.rst new file mode 100644 index 0000000..749ebdb --- /dev/null +++ b/docs/source/components/ops/fill.rst @@ -0,0 +1,66 @@ +.. include:: ../../mydefs.rst + +``fill`` +======== + +Header: ```` + +API +--- + +.. code-block:: cpp + + namespace pressio { namespace ops{ + + template + void fill(T & operand, ScalarType const & value); + + }} // end namespace pressio::ops + +Parameters +---------- + +* ``operand``: the object to fill + +* ``value``: value to use to fill + +Constraints +~~~~~~~~~~~ + +- ``T`` must be: + + - an Eigen vector or matrix object, i.e. one of the following is + true ``pressio::is_vector_eigen::value``, ``pressio::is_dense_matrix_eigen::value``, + ``pressio::is_sparse_matrix_eigen::value`` or + + - a Kokkos rank-1 or rank-2 view, i.e. ``pressio::is_vector_kokkos::value``, ``pressio::is_dense_matrix_kokkos::value`` or + + - a Tpetra vector or multi-vector, i.e. ``pressio::is_vector_tpetra::value``, ``pressio::is_multi_vector_tpetra::value`` or + + - a Tpetra block vector or multi-vector, i.e. ``pressio::is_vector_tpetra_block::value``, ``pressio::is_multi_vector_tpetra_block::value`` or + + - a Epetra vector or multi-vector, i.e. ``pressio::is_vector_epetra::value``, ``pressio::is_multi_vector_epetra::value`` or + + - a pressio expression, i.e. ``pressio::diag``, ``pressio::span``, ``pressio::subspan``, based on Eigen or Kokkkos container + +- ``ScalarType`` must be convertible to ``pressio::Traits::scalar_type`` + +Preconditions +~~~~~~~~~~~~~ + +None + +Return value +~~~~~~~~~~~~ + +None + +Effects +~~~~~~~ + +Overwrites each element of ``operand`` with ``value``. + +Postconditions +~~~~~~~~~~~~~~ + +Each element of ``operand`` is equal to ``value``. diff --git a/docs/source/components/type_traits.rst b/docs/source/components/type_traits.rst new file mode 100644 index 0000000..9c29d49 --- /dev/null +++ b/docs/source/components/type_traits.rst @@ -0,0 +1,130 @@ +.. role:: raw-html-m2r(raw) + :format: html + +.. include:: ../mydefs.rst + +``type_traits`` +=============== + +Header: ```` + +Public namespace: ``pressio`` + + +Scope +----- + +Provides functionalities for type introspection and detection. +One of the main design features of pressio is that it supports arbitrary +types via generic programming and type introspection, but also +provides special support for some data types commonly used. + + +Traits class +------------ + +\todo: finish + +One of the most important things inside ``type_traits`` is the ``Traits`` class: + +.. code-block:: cpp + + namespace pressio{ + template struct Traits; + } + +To understand the purpose and usage of the traits pattern in C++ there are several resources online. +Quoting Bjarne Stroustrup: "Think of a trait as a small object whose main purpose +is to carry information used by another object or algorithm +to determine "policy" or "implementation details". +Pressio uses specializations of this class to gather *in a uniform way* +compile-time information enabling it to reason about types. +The key point here is that *different TPLs use a variety of naming conventions +for nested typedefs and related things*\ , so there is not easy way to access +similar information from types of various libraries. +This is what motivated us to implement this ``type_traits`` component. +We need a standard, uniform way to query types for compile-time information. +We currently have traits specialized for types of a few TPLs, like Trilinos, Kokkos, Eigen. +An example of one such specialization (in this case for Eigen) is: + +.. code-block:: cpp + + template + struct Traits< + T, std::enable_if_t::value> + > + { + using scalar_type = typename T::Scalar; + static constexpr int rank = 1; + }; + +This ``Traits`` class play a key role when users want to use arbitrary types (i.e. types +which are not known to presso) and to do so, users shoud specialize this class and make +these specialization visibile to pressio to provide information about their generic types. :raw-html-m2r:`
` + +For practical examples of how this class is used, see: + +:red:`finish` + +.. + * `Newton-Raphson solver `_ + * `ode explicit steppers `_ + * `ode implicit steppers `_ + + + +Type detection and identification +--------------------------------- + +We support several metafunctions for detecting +data types commonly used from existing TPLs. +The following list is partial, and more will be added as we continue the development. + +.. list-table:: + :widths: 45 55 + :header-rows: 1 + + * - Name + - Description + * - ``template`` :raw-html-m2r:`
` ``struct is_static_vector_eigen;`` + - Provides static member constant ``value`` equal to ``true`` if ``T`` is a static Eigen vector. :raw-html-m2r:`
` Requires: ``PRESSIO_ENABLE_TPL_EIGEN==On`` + * - ``template`` :raw-html-m2r:`
` ``struct is_dynamic_vector_eigen;`` + - Provides static member constant ``value`` equal to ``true`` if ``T`` is a dynamic Eigen vector. :raw-html-m2r:`
` Requires: ``PRESSIO_ENABLE_TPL_EIGEN==On`` + * - ``template`` :raw-html-m2r:`
` ``struct is_vector_eigen;`` + - Provides static member constant ``value`` equal to ``true`` if ``T`` is a static or dynamic Eigen vector. :raw-html-m2r:`
` Requires: ``PRESSIO_ENABLE_TPL_EIGEN==On`` + * - ``template`` :raw-html-m2r:`
` ``struct is_sparse_matrix_eigen;`` + - Provides static member constant ``value`` equal to ``true`` if ``T`` is a static or dynamic sparse Eigen matrix. :raw-html-m2r:`
` Requires: ``PRESSIO_ENABLE_TPL_EIGEN==On`` + * - ``template`` :raw-html-m2r:`
` ``struct is_static_dense_matrix_eigen;`` + - Provides static member constant ``value`` equal to ``true`` if ``T`` is a static dense Eigen matrix. :raw-html-m2r:`
` Requires: ``PRESSIO_ENABLE_TPL_EIGEN==On`` + * - ``template`` :raw-html-m2r:`
` ``struct is_dynamic_dense_matrix_eigen;`` + - Provides static member constant ``value`` equal to ``true`` if ``T`` is a dynamic dense Eigen matrix. :raw-html-m2r:`
` Requires: ``PRESSIO_ENABLE_TPL_EIGEN==On`` + * - ``template`` :raw-html-m2r:`
` ``struct is_dense_matrix_eigen;`` + - Provides static member constant ``value`` equal to ``true`` if ``T`` is a static or dynamic dense Eigen matrix. :raw-html-m2r:`
` Requires: ``PRESSIO_ENABLE_TPL_EIGEN==On`` + * - ``template`` :raw-html-m2r:`
` ``struct is_dense_vector_teuchos;`` + - Provides static member constant ``value`` equal to ``true`` if ``T`` is a dense Teuchos vector. :raw-html-m2r:`
` Requires: ``PRESSIO_ENABLE_TPL_TRILINOS==On`` + * - ``template`` :raw-html-m2r:`
` ``struct is_dense_matrix_teuchos;`` + - Provides static member constant ``value`` equal to ``true`` if ``T`` is a dense Teuchos matrix. :raw-html-m2r:`
` Requires: ``PRESSIO_ENABLE_TPL_TRILINOS==On`` + * - ``template`` :raw-html-m2r:`
` ``struct is_vector_epetra;`` + - Provides static member constant ``value`` equal to ``true`` if ``T`` is Epetra vector. :raw-html-m2r:`
` Requires: ``PRESSIO_ENABLE_TPL_TRILINOS==On`` + * - ``template`` :raw-html-m2r:`
` ``struct is_multi_vector_epetra;`` + - Provides static member constant ``value`` equal to ``true`` if ``T`` is an Epetra multi vector. :raw-html-m2r:`
` Requires: ``PRESSIO_ENABLE_TPL_TRILINOS==On`` + * - ``template`` :raw-html-m2r:`
` ``struct is_vector_tpetra;`` + - Provides static member constant ``value`` equal to ``true`` if ``T`` is a Tpetra vector. :raw-html-m2r:`
` Requires: ``PRESSIO_ENABLE_TPL_TRILINOS==On`` + * - ``template`` :raw-html-m2r:`
` ``struct is_multi_vector_tpetra;`` + - Provides static member constant ``value`` equal to ``true`` if ``T`` is a Tpetra multi vector. :raw-html-m2r:`
` Requires: ``PRESSIO_ENABLE_TPL_TRILINOS==On`` + * - ``template`` :raw-html-m2r:`
` ``struct is_vector_tpetra_block;`` + - Provides static member constant ``value`` equal to ``true`` if ``T`` is a Tpetra-block vector. :raw-html-m2r:`
` Requires: ``PRESSIO_ENABLE_TPL_TRILINOS==On`` + * - ``template`` :raw-html-m2r:`
` ``struct is_multi_vector_tpetra_block;`` + - Provides static member constant ``value`` equal to ``true`` if ``T`` is a Tpetra-block multi vector. :raw-html-m2r:`
` Requires: ``PRESSIO_ENABLE_TPL_TRILINOS==On`` + * - ``template`` :raw-html-m2r:`
` ``struct is_static_vector_kokkos;`` + - Provides static member constant ``value`` equal to ``true`` if ``T`` is a static Kokkos vector (rank-1 View). :raw-html-m2r:`
` Requires: ``PRESSIO_ENABLE_TPL_KOKKOS==On`` + * - ``template`` :raw-html-m2r:`
` ``struct is_dynamic_vector_kokkos;`` + - Provides static member constant ``value`` equal to ``true`` if ``T`` is a dynamic Kokkos vector (rank-1 View). :raw-html-m2r:`
` Requires: ``PRESSIO_ENABLE_TPL_KOKKOS==On`` + * - ``template`` :raw-html-m2r:`
` ``struct is_vector_kokkos;`` + - Provides static member constant ``value`` equal to ``true`` if ``T`` is a static or dynamic Kokkos vector (rank-1 View). :raw-html-m2r:`
` Requires: ``PRESSIO_ENABLE_TPL_KOKKOS==On`` + * - ``template`` :raw-html-m2r:`
` ``struct is_static_dense_matrix_kokkos;`` + - Provides static member constant ``value`` equal to ``true`` if ``T`` is a static dense Kokkos matrix (rank-2 View). :raw-html-m2r:`
` Requires: ``PRESSIO_ENABLE_TPL_KOKKOS==On`` + * - ``template`` :raw-html-m2r:`
` ``struct is_dynamic_dense_matrix_kokkos;`` + - Provides static member constant ``value`` equal to ``true`` if ``T`` is a dynamic dense Kokkos matrix (rank-2 View). :raw-html-m2r:`
` Requires: ``PRESSIO_ENABLE_TPL_KOKKOS==On`` + * - ``template`` :raw-html-m2r:`
` ``struct is_dense_matrix_kokkos;`` + - Provides static member constant ``value`` equal to ``true`` if ``T`` is a static or dynamic dense Kokkos matrix (rank-2 View). :raw-html-m2r:`
` Requires: ``PRESSIO_ENABLE_TPL_KOKKOS==On`` diff --git a/docs/source/concepts_note.rst b/docs/source/concepts_note.rst new file mode 100644 index 0000000..fcb174f --- /dev/null +++ b/docs/source/concepts_note.rst @@ -0,0 +1,78 @@ +.. role:: raw-html-m2r(raw) + :format: html + +.. include:: mydefs.rst + +pressio-ops concepts: more info +=========================== + +Concept-driven design has been and still is critical in +the development of pressio-ops. Here we describe some fundamental +notions that are at the core of our design approach. + + +``concept = syntactic constraints + semantics`` +----------------------------------------------- + +In pressio-ops, we follow the approach in "Design of Concept Libraries for C++" (2011) +in defining a concept to be a *meaningful combination of syntactic requirements + axioms/semantics*. +Pure syntax can be fully specified and checked by compilers supporting C++20. +On the contrary, axioms/semantics properties cannot be spelled out and statically checked. +Axioms are, in fact, invariants *assumed* to hold. In the C++ standard, axioms +and semantics are specified/listed as comments. Here, we adopt a different +approach to present axioms (similar to "Design of Concept Libraries for C++", 2011)), +that we believe benefits readability: axioms are explicitly listed using +the keyword "axiom". Note, however, that if you want to compile the concepts below +using a c++20 compiler, you have to comment out all axioms. + + + +- :red:`concepts are hard and it will take a few iterations to get meaninngful concepts done` + +- :red:`not all components have the same maturity, so this will be reflected in the corresponding concepts too` + +- :red:`the documentation of each concept follows the standard: we have syntax plus semantics` + + +"Satisfying" vs. "modeling" a concept +------------------------------------- + +`Quoting the C++ standard `__: "It is said +that a standard concept is satisfied if its syntactic requirements +are met, and is modeled if it is satisfied and its +semantic requirements (if any) are also met." + + + +.. + The layered design of concepts in pressio + ----------------------------------------- + + If you read the section above (hopefully you have!), you now know that, + by definition, we interpret concepts are a combination of constraints plus semantics. + Typically, designing concepts is a multi-step process. One good starting point + could be to specify the "syntactic" requirements. Then, one adds to this semantics + requirements and, if needed, revises the syntax, and so on. + This design process is useful because it allows one to create concepts in a + gradual/progressive fashion, as if one were adding one layer at a time. + In pressio, this is exactly what has happened. Some of our deepest concepts + originally started as just syntactic requirements, and then they were improved + by adding more layers. In the documentation, you will notice that some concept + are intentially presented to reflect this layered structure. + More specifically, you will notice that we have designed our concepts + such that they reflect the following layered structure: + + .. code:: none + + concepts = constraints + execution/language_axioms + math_axioms + + The execution axioms are meant to cover requirements related to the + code execution or other language-related details. + The math axioms instead are meant to cover the mathematical foundations. + Note that not all concepts have both execution and math axioms. + + .. warning:: + + As stated on the main doc page, until we can upgrade to C++20, + we cannot officially use them *stricto sensu*. + Concepts are thus currently enforced in the code via SFINAE. diff --git a/docs/source/conf.py b/docs/source/conf.py new file mode 100644 index 0000000..2f46f26 --- /dev/null +++ b/docs/source/conf.py @@ -0,0 +1,134 @@ +# Configuration file for the Sphinx documentation builder. +# +# This file only contains a selection of the most common options. For a full +# list see the documentation: +# https://www.sphinx-doc.org/en/master/usage/configuration.html + +# -- Path setup -------------------------------------------------------------- + +# If extensions (or modules to document with autodoc) are in another directory, +# add these directories to sys.path here. If the directory is relative to the +# documentation root, use os.path.abspath to make it absolute, like shown here. +# +import datetime +import os +import sys +sys.path.insert(0, os.path.abspath('.')) + + +# -- Project information ----------------------------------------------------- +# The master toctree document. +master_doc = "index" + +project = 'Pressio-Ops' +# copyright = f'{datetime.datetime.now().year}, 2021, National Technology & Engineering Solutions of Sandia, LLC (NTESS)' +copyright = u"2021, National Technology & Engineering Solutions of Sandia, LLC (NTESS)" +author = 'Francesco Rizzi' + +# The default replacements for |version| and |release|, also used in various +# other places throughout the built documents. +def get_version(): + local_version = '' + with open("../../version.txt") as version_file: + for line in version_file.read().strip().split("\n"): + local_version = local_version + line.split(" ")[1] + '.' + return local_version[:-1] + +# The full version, including alpha/beta/rc tags +release = get_version() + +# -- General configuration --------------------------------------------------- + +# Add any Sphinx extension module names here, as strings. They can be +# extensions coming with Sphinx (named 'sphinx.ext.*') or your custom +# ones. +extensions = [ + "myst_parser", \ + "sphinx.ext.autodoc", \ + "sphinx.ext.viewcode", \ + "sphinx.ext.intersphinx", \ + "sphinx_copybutton"] + +# Add any paths that contain templates here, relative to this directory. +templates_path = ['_templates'] + +# List of patterns, relative to source directory, that match files and +# directories to ignore when looking for source files. +# This pattern also affects html_static_path and html_extra_path. +exclude_patterns = [] + +# There are two options for replacing |today|: either, you set today to some +# non-false value, then it is used: +#today = '' +# Else, today_fmt is used as the format for a strftime call. +today_fmt = "%B %d, %Y" + +# -- Options for HTML output ------------------------------------------------- +# The name of the Pygments (syntax highlighting) style to use. +pygments_style = "tango" +pygments_dark_style = "monokai" +#from pygments.styles import get_all_styles +#styles = list(get_all_styles()) +#print(styles) + +# The theme to use for HTML and HTML Help pages. See the documentation for +# a list of builtin themes. +# + +html_title = project + "-"+release + +html_theme = 'furo' + +html_theme_options = { + "sidebar_hide_name": False, + "light_css_variables": { + "color-brand-primary": "#336790", # blue + "color-brand-content": "#336790" + }, + "dark_css_variables": { + "color-brand-primary": "#E5B62F", # yellow1 + "color-brand-content": "#E5B62F" + #"color-brand-primary": "#F4EB4D", # yellow2 + #"color-brand-content": "#F4EB4D" + #"color-brand-primary": "#F39C12", # orange + #"color-brand-content": "#F39C12", + #"color-brand-primary": "#00FF40", # lime + #"color-brand-content": "#00FF40" + #"color-brand-primary": "#6ed0f5", # cyan + #"color-brand-content": "#6ed0f5" + }, +} + +# Add any paths that contain custom static files (such as style sheets) here, +# relative to this directory. They are copied after the builtin static files, +# so a file named "default.css" will overwrite the builtin "default.css". +html_static_path = ['_static'] + +html_css_files = ['hacks.css'] + +source_suffix = { + '.rst': 'restructuredtext', + '.md': 'markdown', +} + +# If not '', a "Last updated on:" timestamp is inserted at every page bottom, +# using the given strftime format. +html_last_updated_fmt = "%b %d, %Y" + +# need to figure out why this does not work +# rst_prolog = """ +# .. include:: special.rst +# """ + +html_sidebars = { + "**": [ + "sidebar/scroll-start.html", + "sidebar/brand.html", + "sidebar/search.html", + "sidebar/navigation.html", + "sidebar/ethical-ads.html", + "sidebar/scroll-end.html", + ] +} + +html_logo = "_static/logo.png" diff --git a/docs/source/index.rst b/docs/source/index.rst new file mode 100644 index 0000000..8671b50 --- /dev/null +++ b/docs/source/index.rst @@ -0,0 +1,199 @@ +.. role:: raw-html-m2r(raw) + :format: html + +.. include:: mydefs.rst + +pressio-ops C++ library +=================== + +Documentation of the `C++ library `__, one element of the `Pressio ecosystem `_. + +This work was started with a focus on projection-based reduced-order models (ROMs), +which is a strongly **multidisciplinary** topic. +Working towards a production-level ROM capability inevitably means spanning +multiple fields ranging from, e.g., linear algebra, nonlinear solvers +and optimization, to time integration, distributed computing and HPC. +This constitutes a substantial challenge to tackle, whose complexity +increases if aiming to develop a **generic** library. + +To start such a project from the ground up, grow it and then being +able to maintain it, we believe **modularity, abstractions +and well-defined APIs** to be fundamental design principles to rely on. +This has been, and still is, at the core of our development effort, +and has lead to a highly *modular* design of pressio (see table below): +each component (level) of the stack covers a specific capability and depends, +via *well-defined public APIs*, on the ones below it. This has required (and still does) +a considerable development effort, since each component needs "attention" +and can easily be scoped into an independent, full-time project. + +So why doing all this rather than adopting a different, simpler approach, for example, +limiting and hiding as implementation some of the supporting functionalities? +Because we believe the current structure/design offers several major benefits +that would be hard---and in some cases impossible---to obtain otherwise: **flexibility, +extensibility, maintainability, and usability of each component on its own.** +One drawback is that at any point in time, the various components might +have different maturity levels, so reaching a comparable and solid maturity +across the stack might take some time---our current goal is to obtain +in version ``1.0.0`` a uniform maturity level *at least* across +the ``rom, ode and solvers`` components. Please keep this in mind while browsing +the documentation and the code. + +Notably, we have extracted the core operations from the ``Pressio/pressio`` repository +in order to increase modularity and allow users to build their code directly on top of +the ``pressio-ops`` if desired. + +However, it is still useful to consider ``pressio-ops`` within the context of ``pressio`` +to understand how the repositories fit together. + +The following components are included in ``Pressio/pressio`` and build off of the contents of ``pressio-ops``: + +.. list-table:: + :widths: 10 48 42 + :header-rows: 1 + :align: left + + * - + - Description + - Header(s) + + * - ``rom`` + - concepts :raw-html-m2r:`
` (linear) subspaces :raw-html-m2r:`
` Galerkin: steady :raw-html-m2r:`
` Galerkin: unsteady :raw-html-m2r:`
` LSPG: steady :raw-html-m2r:`
` LSPG: unsteady :raw-html-m2r:`
` :raw-html-m2r:`
` + - ```` :raw-html-m2r:`
` ```` :raw-html-m2r:`
` ```` :raw-html-m2r:`
` ```` :raw-html-m2r:`
` ```` :raw-html-m2r:`
` ```` :raw-html-m2r:`
` ```` :small:`includes all` + + * - ``ode`` + - concepts :raw-html-m2r:`
` explicit steppers :raw-html-m2r:`
` implicit steppers :raw-html-m2r:`
` ``advance_<*>`` fncs :raw-html-m2r:`
` :raw-html-m2r:`
` + - ```` :raw-html-m2r:`
` ```` :raw-html-m2r:`
` ```` :raw-html-m2r:`
` ```` :raw-html-m2r:`
` ```` :small:`includes all` + + * - ``solvers_nonlinear`` + - concepts :raw-html-m2r:`
` Newton method :raw-html-m2r:`
` Gauss-Newton :raw-html-m2r:`
` Lev.-Marq. :raw-html-m2r:`
` :raw-html-m2r:`
` + - ```` :raw-html-m2r:`
` ```` :raw-html-m2r:`
` ```` :raw-html-m2r:`
` ```` :raw-html-m2r:`
` ```` :small:`includes all` + + * - ``solvers_linear`` + - linear dense (on-node) solvers + - ```` + +The following components are included in ``Pressio/pressio-ops`` and can be used independently of the ``Pressio/pressio`` repository: + +.. list-table:: + :widths: 10 48 42 + :header-rows: 1 + :align: left + + * - + - Description + - Header(s) + + * - ``ops`` + - shared-memory/distributed linear algebra kernels specializations + - ```` + + * - ``expressions`` + - expressions templates, e.g.: span, diagonal, subspan + - ```` + + * - ``type_traits`` + - type traits and detection + - ```` + + * - ``utils`` + - logger, constants, etc + - ```` + + * - ``mpl`` + - metaprogramming functionalities + - ```` + + +Get Started +----------- + +* `Install pressio-ops `_: (currently) it is a header-only library, so should be trivial + + +Generic programming and concepts +-------------------------------- + +Arguably the main foundation of pressio-ops is the use of +generic programming--*or, more humbly, we can at least say that it is what we strive for*. +Since the early development stages, we have relied on concept-driven design. +Note, that, if you have used or use C++ templates, you *have* used +concepts knowingly or not. This is because when you write a function or class +template, you have some expectations of what a template needs to expose/do. +C++20 concepts are, in some sense, a way to *explicitly* formalize those expectations. + + +Until we can stably upgrade to C++20, we cannot by default use C++20 concepts, +so we currently guard the concepts in pressio inside a +preprocessor directive ``#ifdef PRESSIO_ENABLE_CXX20``. This can be enabled by +using a C++20 compliant compiler and setting ``-DCMAKE_CXX_STANDARD=20`` at configure time. +The behavior is as follows: + +- if ``PRESSIO_ENABLE_CXX20`` is *enabled*: concepts are compiled and + enforced *stricto sensu* on the pressio APIs as discussed by this documentation + +- if ``PRESSIO_ENABLE_CXX20`` is *disabled*: this is the default case because the + default pressio C++ standard is currently C++14. In this case, the "C++20 concepts" + are not compiled but the constraints they represent are still valid and implemented + differently such that their enforcement is done via a combination of SFINAE and static asserts. + +.. important:: + + Well-defined concepts are hard to design and it takes time. Concepts used in pressio are + still being developed. Some are more mature than others. The approach we adopt is to first + focus on the syntax, then then we will revise them with proper semantics. Keep this in mind + if some concepts seem incomplete. + +.. + Here, the term concept does not necessarily + refer to the C++ concepts feature introduced in C++20. + You can think of it more broadly as "what properties/syntax a type meets, + what you can do with it and, also, what a type should definitely satisfy". + The message we want to convey is that *"concepts" are a fundamental + design part of pressio*. In our documentation, we make the effort to + highlight the use of concepts + by dedicating to each component of the library a full section + to discuss and formalize how concepts are used in that component. + + +License and Citation +-------------------- + +The full license (BSD-3) is available `here `_. + +Sooner or later we will publish this... in the meantime, you can find on arXiv +an (outdated) preprint at: https://arxiv.org/abs/2003.07798 + +Questions? +---------- + +Find us on Slack: https://pressioteam.slack.com or +open an issue on `github `_. + + +.. toctree:: + :maxdepth: 1 + :hidden: + + installation + keywords + +.. toctree:: + :caption: API + :maxdepth: 1 + :hidden: + + ./components/ops + ./components/expressions + ./components/type_traits + ./components/utils + ./components/mpl + +.. toctree:: + :caption: Miscellanea + :maxdepth: 1 + :hidden: + + Tutorials + GitHub Repo + Open an issue/feature req. + license diff --git a/docs/source/installation.rst b/docs/source/installation.rst new file mode 100644 index 0000000..3b637a3 --- /dev/null +++ b/docs/source/installation.rst @@ -0,0 +1,142 @@ +.. role:: raw-html-m2r(raw) + :format: html + +Installation and Dependencies +============================= + +.. tip:: + + pressio-ops is header-only, so it does not need to be precompiled and linked to. + However, since we use preprocessor directives to conditionally + enable/disable code based on target third-party libraries, + one needs to account for this. See below for the details. + +.. warning:: + + To use pressio-ops, you need at least a C++17 compiler. + +Dependencies +------------ + +Some parts of ``pressio-ops`` contain code and implementations +that are specific to third-party libraries (TPLs). +An example is ``pressio/ops``\ , which contains kernels specializations +for widely-used HPC libraries (e.g. Trilinos, Kokkos). +The main reason for doing this is that we aim, where possible, +to alleviate the user from writing custom operations and allow ``pressio-ops`` to decide when and how to leverage +the native libraries' operations to obtain the best performance. +This should facilitate the integration and use of ``pressio-ops`` by existing applications. +This is a growing capability and we currently only +provide built-in support to some external HPC libraries (see below). +Obviously, these TPL-specific specializations need to be guarded with +preprecessor directives, and enabled only if one can access the TPLs. + +Enabling/disabling specific dependencies can be done via +the cmake variables `listed here `__. + + +Optional vs Required +^^^^^^^^^^^^^^^^^^^^ + +.. list-table:: + :header-rows: 1 + :widths: 10 50 40 + :align: left + + * - TPL Name + - Optional/Required + - Version Known to Work/run in CI + * - Eigen + - Required + - 3.3.7 + * - Trilinos + - Optional + - commit: ef73d14babf6e7556b0420add98cce257ccaa56b + * - MPI + - Optional + - -- + * - Kokkos + - Optional + - 3.1.0 + * - BLAS + - Optional + - -- + * - LAPACK + - Optional + - -- + * - GoogleTest + - Optional + - 1.10.0 + +Eigen is the only required dependency because it is the +default choice for instantiating the ROM data structures +and solving the (dense) ROM problem. + +In practice, what are the steps to get, install and use Pressio? +---------------------------------------------------------------- + +\todo: add description for using pressio without configuring, +so one has to define the options directly when configuring +their code or inside the code directly. + +1. Clone `pressio-ops `_ (defaults to the main branch), +or you can pick a `release version `_ + +2. Create a build and install subdirectories + +.. code-block:: bash + + cd + mkdir build && mkdir install + +3. Use cmake to configure by passing to the comand line the target list of cmake variables to define. + +For example, suppose we want to enable support for Trilinos and the debug prints. We would do: + +.. code-block:: bash + + export PRESSIO_SRC= + cd /build + + cmake -D CMAKE_INSTALL_PREFIX=../install \ + -D PRESSIO_ENABLE_TPL_TRILINOS=ON \ + -D PRESSIO_ENABLE_DEBUG_PRINT=ON \ + ${PRESSIO_SRC} + + make install # nothing is built, just headers copied to installation + +Note that this step does **not** build anything because ``pressio-ops`` is header-only, +but only processes the cmake arguments and copies the pressio headers to the +install prefix ``/install``. +If you want, inspect the file ``/install/pressio_ops_cmake_config.h`` +which contains the cmake variables configuration. + +We also remark that during the configuration step above pressio-ops +does not need to know where a target TPL exists in your system. +In the configuration step above, you are simply telling Pressio that you have +a certain TPL and want to enable the corresponding code in pressio. +The TPLs will be needed at linking stage when you build *your* code that *uses* pressio. + +4. When building your application to use pressio-ops, you just have to point to +the installation directory ``/install`` with the installed +pressio-ops headers, and you can access all pressio-ops functionalities like so: + +.. code-block:: cpp + + #include "pressio/what_you_need.hpp" + // ... + int main(){ + // do something + } + +.. warning:: + + The procedure above is advised because it enables ``pressio-ops`` + to properly process the cmake options and turn on/off based + on certain conditions (as explained above). + The alternative way to use pressio would be to just clone the repo, + point to the ``/include`` subdirectory + and use cmake variables directly when building your code. + However, this could have unexpected consequences since + you would be resposible to set the variables correctly but you would not + know exactly all the possible constraints. diff --git a/docs/source/keywords.rst b/docs/source/keywords.rst new file mode 100644 index 0000000..4c062af --- /dev/null +++ b/docs/source/keywords.rst @@ -0,0 +1,83 @@ +CMake Keywords +############## + +.. important:: + + All CMake keywords are prefixed with ``PRESSIO_`` which is case-sensitive. + + Recall that to set a keyword in CMake you used the syntax ``-Dkeyword_name``. + + +Third-party Libraries (TPLs) +============================ + +The following options control enabling TPLs: + +.. list-table:: + :widths: 30 60 10 + :header-rows: 1 + :align: left + + * - Variable + - Description + - Default + + * - ``PRESSIO_ENABLE_TPL_EIGEN`` + - self-explanatory + - ``ON`` + + * - ``PRESSIO_ENABLE_TPL_TRILINOS`` + - self-explanatory + - ``OFF`` + + * - ``PRESSIO_ENABLE_TPL_MPI`` + - self-explanatory + - ``OFF`` automatically ``ON`` if ``PRESSIO_ENABLE_TPL_TRILINOS=ON`` + + * - ``PRESSIO_ENABLE_TPL_KOKKOS`` + - self-explanatory + - ``OFF``\ ; automatically ``ON`` if ``PRESSIO_ENABLE_TPL_TRILINOS=ON`` + + * - ``PRESSIO_ENABLE_TEUCHOS_TIMERS`` + - self-explanatory + - ``OFF`` automatically ``ON`` if ``PRESSIO_ENABLE_TPL_TRILINOS=ON`` + + +Obviously, the choice of which TPLs to enable is related to +your application's dependency requirements. +For example, if you have an application that relies on +Trilinos data structures and want to use ``pressio``\ , +then it makes sense to enable the Trilinos dependency. +On the contrary, if you have an application that relies only on +Eigen data structures, then it makes sense to only leave only Eigen on +and disable the rest. + +Also, we note that some of the cmake variables listed above are connected +and cannot be turned on individualy. +For example, if we enable Trilinos then ``pressio`` automatically +enables also Kokkos, BLAS, LAPACK and MPI. + + +Other Options +============= + +.. list-table:: + :widths: 30 60 10 + :header-rows: 1 + :align: left + + * - Variable + - Description + - Default + + * - ``PRESSIO_ENABLE_DEBUG_PRINT`` + - to enable debugging print statements + - ``OFF`` + + * - ``PRESSIO_ENABLE_CXX17`` + - enables C++17 standard + - ``ON`` since min standard is 17 + + * - ``PRESSIO_ENABLE_CXX20`` + - enables C++20 standard + - ``OFF``; turned on if ``CMAKE_CXX_STANDARD`` is set to 20 diff --git a/docs/source/license.rst b/docs/source/license.rst new file mode 100644 index 0000000..881ae5b --- /dev/null +++ b/docs/source/license.rst @@ -0,0 +1,51 @@ +License +======= + +.. highlight:: none + +:: + + //@HEADER + // ************************************************************************ + // + // Pressio + // Copyright 2019 National Technology & Engineering Solutions of Sandia,LLC + // (NTESS) + // + // Under the terms of Contract DE-NA0003525 with NTESS, the + // U.S. Government retains certain rights in this software. + // + // Pressio is licensed under BSD-3-Clause terms of use: + // + // Redistribution and use in source and binary forms, with or without + // modification, are permitted provided that the following conditions + // are met: + // + // 1. Redistributions of source code must retain the above copyright + // notice, this list of conditions and the following disclaimer. + // + // 2. Redistributions in binary form must reproduce the above copyright + // notice, this list of conditions and the following disclaimer in the + // documentation and/or other materials provided with the distribution. + // + // 3. Neither the name of the copyright holder nor the names of its + // contributors may be used to endorse or promote products derived + // from this software without specific prior written permission. + // + // THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS + // "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT + // LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS + // FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE + // COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, + // INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES + // (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR + // SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) + // HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, + // STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING + // IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE + // POSSIBILITY OF SUCH DAMAGE. + // + // Questions? Contact Francesco Rizzi (fnrizzi@sandia.gov) + // + // ************************************************************************ + //@HEADER diff --git a/docs/source/mydefs.rst b/docs/source/mydefs.rst new file mode 100644 index 0000000..43eccbf --- /dev/null +++ b/docs/source/mydefs.rst @@ -0,0 +1,50 @@ +.. Color profiles for Sphinx. +.. Has to be used with hacks.css +.. (https://bitbucket.org/lbesson/web-sphinx/src/master/.static/hacks.css) + +.. role:: black +.. role:: gray +.. role:: grey +.. role:: silver +.. role:: white +.. role:: maroon +.. role:: red +.. role:: magenta +.. role:: fuchsia +.. role:: pink +.. role:: orange +.. role:: yellow +.. role:: lime +.. role:: green +.. role:: olive +.. role:: teal +.. role:: cyan +.. role:: aqua +.. role:: blue +.. role:: navy +.. role:: purple + +.. role:: under +.. role:: over +.. role:: blink +.. role:: line +.. role:: strike + +.. role:: it +.. role:: ob + +.. role:: small +.. role:: medium +.. role:: large + +.. role:: packnameindexpage +.. role:: summarylineindexpage + +.. role:: center +.. role:: left +.. role:: right + +.. role:: memberfunction + + +.. Adapted from (c) Lilian Besson, 2011-2016, https://bitbucket.org/lbesson/web-sphinx/ From ffb3742a6d92366d187abd9cf80a4cef9ca61e12 Mon Sep 17 00:00:00 2001 From: Caleb Schilly Date: Thu, 24 Oct 2024 12:12:40 -0400 Subject: [PATCH 2/9] #6: small fix to table --- docs/source/index.rst | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/docs/source/index.rst b/docs/source/index.rst index 8671b50..9b50a8a 100644 --- a/docs/source/index.rst +++ b/docs/source/index.rst @@ -47,6 +47,8 @@ to understand how the repositories fit together. The following components are included in ``Pressio/pressio`` and build off of the contents of ``pressio-ops``: +| + .. list-table:: :widths: 10 48 42 :header-rows: 1 @@ -74,6 +76,8 @@ The following components are included in ``Pressio/pressio`` and build off of th The following components are included in ``Pressio/pressio-ops`` and can be used independently of the ``Pressio/pressio`` repository: +| + .. list-table:: :widths: 10 48 42 :header-rows: 1 From cfb03815d445ace1d6db417d2c60f3487a21eccf Mon Sep 17 00:00:00 2001 From: Caleb Schilly Date: Fri, 25 Oct 2024 16:46:30 -0400 Subject: [PATCH 3/9] #6: begin adding documentation for ops --- .github/workflows/deploy-docs.yml | 40 + .gitignore | 1 + docs/generated_docs/.buildinfo | 4 + .../.doctrees/components/expressions.doctree | Bin 0 -> 4305 bytes .../components/expressions/diag.doctree | Bin 0 -> 6912 bytes .../components/expressions/span.doctree | Bin 0 -> 8861 bytes .../components/expressions/subspan.doctree | Bin 0 -> 8527 bytes .../.doctrees/components/mpl.doctree | Bin 0 -> 18352 bytes .../.doctrees/components/ops.doctree | Bin 0 -> 16772 bytes .../.doctrees/components/ops/abs.doctree | Bin 0 -> 9281 bytes .../components/ops/add_to_diagonal.doctree | Bin 0 -> 7992 bytes .../.doctrees/components/ops/clone.doctree | Bin 0 -> 13693 bytes .../components/ops/deep_copy.doctree | Bin 0 -> 10282 bytes .../.doctrees/components/ops/dot.doctree | Bin 0 -> 10270 bytes .../ops/elementwise_multiply.doctree | Bin 0 -> 10175 bytes .../.doctrees/components/ops/extent.doctree | Bin 0 -> 9532 bytes .../.doctrees/components/ops/fill.doctree | Bin 0 -> 10131 bytes .../ops/matrix_matrix_product.doctree | Bin 0 -> 14402 bytes .../ops/matrix_vector_product.doctree | Bin 0 -> 22090 bytes .../.doctrees/components/ops/min_max.doctree | Bin 0 -> 5383 bytes .../.doctrees/components/ops/norms.doctree | Bin 0 -> 6415 bytes .../.doctrees/components/ops/product.doctree | Bin 0 -> 21992 bytes .../.doctrees/components/type_traits.doctree | Bin 0 -> 52129 bytes .../.doctrees/concepts_note.doctree | Bin 0 -> 12810 bytes .../.doctrees/environment.pickle | Bin 0 -> 64279 bytes docs/generated_docs/.doctrees/index.doctree | Bin 0 -> 45045 bytes .../.doctrees/installation.doctree | Bin 0 -> 24670 bytes .../generated_docs/.doctrees/keywords.doctree | Bin 0 -> 15355 bytes docs/generated_docs/.doctrees/license.doctree | Bin 0 -> 6803 bytes docs/generated_docs/.doctrees/mydefs.doctree | Bin 0 -> 2943 bytes .../_sources/components/expressions.rst.txt | 19 + .../components/expressions/diag.rst.txt | 29 + .../components/expressions/span.rst.txt | 36 + .../components/expressions/subspan.rst.txt | 33 + .../_sources/components/mpl.rst.txt | 114 + .../_sources/components/ops.rst.txt | 96 + .../_sources/components/ops/abs.rst.txt | 44 + .../components/ops/add_to_diagonal.rst.txt | 34 + .../_sources/components/ops/clone.rst.txt | 66 + .../_sources/components/ops/deep_copy.rst.txt | 46 + .../_sources/components/ops/dot.rst.txt | 47 + .../ops/elementwise_multiply.rst.txt | 48 + .../_sources/components/ops/extent.rst.txt | 44 + .../_sources/components/ops/fill.rst.txt | 46 + .../ops/matrix_matrix_product.rst.txt | 88 + .../ops/matrix_vector_product.rst.txt | 112 + .../_sources/components/ops/min_max.rst.txt | 28 + .../_sources/components/ops/norms.rst.txt | 42 + .../_sources/components/ops/product.rst.txt | 112 + .../_sources/components/type_traits.rst.txt | 130 + .../_sources/concepts_note.rst.txt} | 0 docs/generated_docs/_sources/index.rst.txt | 202 + .../_sources/installation.rst.txt | 142 + docs/generated_docs/_sources/keywords.rst.txt | 83 + docs/generated_docs/_sources/license.rst.txt | 51 + docs/generated_docs/_sources/mydefs.rst.txt | 50 + .../_sphinx_javascript_frameworks_compat.js | 134 + docs/generated_docs/_static/basic.css | 932 ++ docs/generated_docs/_static/check-solid.svg | 4 + docs/generated_docs/_static/clipboard.min.js | 7 + docs/generated_docs/_static/copy-button.svg | 5 + docs/generated_docs/_static/copybutton.css | 93 + docs/generated_docs/_static/copybutton.js | 220 + .../_static/copybutton_funcs.js | 58 + docs/generated_docs/_static/debug.css | 69 + docs/generated_docs/_static/doctools.js | 264 + .../_static/documentation_options.js | 14 + docs/generated_docs/_static/file.png | Bin 0 -> 286 bytes .../front_page_schematic/frontpageschem.pdf | Bin 0 -> 94135 bytes .../front_page_schematic/frontpageschem.svg | 866 ++ .../front_page_schematic/frontpageschem.tex | 359 + .../generated_docs/_static/frontpageschem.svg | 866 ++ docs/generated_docs/_static/hacks.css | 170 + docs/generated_docs/_static/jquery-3.6.0.js | 10881 ++++++++++++++++ docs/generated_docs/_static/jquery.js | 2 + docs/generated_docs/_static/language_data.js | 199 + docs/generated_docs/_static/logo.png | Bin 0 -> 7521 bytes docs/generated_docs/_static/minus.png | Bin 0 -> 90 bytes docs/generated_docs/_static/plus.png | Bin 0 -> 90 bytes docs/generated_docs/_static/pygments.css | 258 + .../_static/scripts/furo-extensions.js | 0 docs/generated_docs/_static/scripts/furo.js | 3 + .../_static/scripts/furo.js.LICENSE.txt | 7 + .../_static/scripts/furo.js.map | 1 + docs/generated_docs/_static/searchtools.js | 531 + docs/generated_docs/_static/skeleton.css | 296 + .../_static/styles/furo-extensions.css | 2 + .../_static/styles/furo-extensions.css.map | 1 + docs/generated_docs/_static/styles/furo.css | 2 + .../_static/styles/furo.css.map | 1 + .../_static/underscore-1.13.1.js | 2042 +++ docs/generated_docs/_static/underscore.js | 6 + .../components/expressions.html | 311 + .../components/expressions/diag.html | 344 + .../components/expressions/span.html | 352 + .../components/expressions/subspan.html | 352 + docs/generated_docs/components/mpl.html | 394 + docs/generated_docs/components/ops.html | 421 + docs/generated_docs/components/ops/abs.html | 354 + .../components/ops/add_to_diagonal.html | 346 + docs/generated_docs/components/ops/clone.html | 372 + .../components/ops/deep_copy.html | 359 + docs/generated_docs/components/ops/dot.html | 360 + .../components/ops/elementwise_multiply.html | 359 + .../generated_docs/components/ops/extent.html | 354 + docs/generated_docs/components/ops/fill.html | 355 + .../components/ops/matrix_matrix_product.html | 402 + .../components/ops/matrix_vector_product.html | 429 + .../components/ops/min_max.html | 342 + docs/generated_docs/components/ops/norms.html | 360 + .../components/ops/product.html | 428 + .../components/type_traits.html | 450 + docs/generated_docs/concepts_note.html | 312 + docs/generated_docs/genindex.html | 283 + docs/generated_docs/index.html | 479 + docs/generated_docs/installation.html | 462 + docs/generated_docs/keywords.html | 408 + docs/generated_docs/license.html | 336 + docs/generated_docs/mydefs.html | 277 + docs/generated_docs/objects.inv | Bin 0 -> 600 bytes docs/generated_docs/search.html | 291 + docs/generated_docs/searchindex.js | 1 + docs/source/components/expressions.rst | 16 +- docs/source/components/expressions/diag.rst | 46 +- docs/source/components/expressions/span.rst | 50 +- .../source/components/expressions/subspan.rst | 54 +- docs/source/components/ops.rst | 86 +- docs/source/components/ops/abs.rst | 44 + .../source/components/ops/add_to_diagonal.rst | 34 + docs/source/components/ops/clone.rst | 54 +- docs/source/components/ops/deep_copy.rst | 46 + docs/source/components/ops/dot.rst | 47 + .../components/ops/elementwise_multiply.rst | 48 + docs/source/components/ops/extent.rst | 44 + docs/source/components/ops/fill.rst | 50 +- .../components/ops/matrix_matrix_product.rst | 88 + .../components/ops/matrix_vector_product.rst | 112 + docs/source/components/ops/min_max.rst | 28 + docs/source/components/ops/norms.rst | 42 + docs/source/components/ops/pow.rst | 47 + docs/source/conf.py | 12 +- docs/source/index.rst | 5 +- 142 files changed, 31115 insertions(+), 211 deletions(-) create mode 100644 .github/workflows/deploy-docs.yml create mode 100644 .gitignore create mode 100644 docs/generated_docs/.buildinfo create mode 100644 docs/generated_docs/.doctrees/components/expressions.doctree create mode 100644 docs/generated_docs/.doctrees/components/expressions/diag.doctree create mode 100644 docs/generated_docs/.doctrees/components/expressions/span.doctree create mode 100644 docs/generated_docs/.doctrees/components/expressions/subspan.doctree create mode 100644 docs/generated_docs/.doctrees/components/mpl.doctree create mode 100644 docs/generated_docs/.doctrees/components/ops.doctree create mode 100644 docs/generated_docs/.doctrees/components/ops/abs.doctree create mode 100644 docs/generated_docs/.doctrees/components/ops/add_to_diagonal.doctree create mode 100644 docs/generated_docs/.doctrees/components/ops/clone.doctree create mode 100644 docs/generated_docs/.doctrees/components/ops/deep_copy.doctree create mode 100644 docs/generated_docs/.doctrees/components/ops/dot.doctree create mode 100644 docs/generated_docs/.doctrees/components/ops/elementwise_multiply.doctree create mode 100644 docs/generated_docs/.doctrees/components/ops/extent.doctree create mode 100644 docs/generated_docs/.doctrees/components/ops/fill.doctree create mode 100644 docs/generated_docs/.doctrees/components/ops/matrix_matrix_product.doctree create mode 100644 docs/generated_docs/.doctrees/components/ops/matrix_vector_product.doctree create mode 100644 docs/generated_docs/.doctrees/components/ops/min_max.doctree create mode 100644 docs/generated_docs/.doctrees/components/ops/norms.doctree create mode 100644 docs/generated_docs/.doctrees/components/ops/product.doctree create mode 100644 docs/generated_docs/.doctrees/components/type_traits.doctree create mode 100644 docs/generated_docs/.doctrees/concepts_note.doctree create mode 100644 docs/generated_docs/.doctrees/environment.pickle create mode 100644 docs/generated_docs/.doctrees/index.doctree create mode 100644 docs/generated_docs/.doctrees/installation.doctree create mode 100644 docs/generated_docs/.doctrees/keywords.doctree create mode 100644 docs/generated_docs/.doctrees/license.doctree create mode 100644 docs/generated_docs/.doctrees/mydefs.doctree create mode 100644 docs/generated_docs/_sources/components/expressions.rst.txt create mode 100644 docs/generated_docs/_sources/components/expressions/diag.rst.txt create mode 100644 docs/generated_docs/_sources/components/expressions/span.rst.txt create mode 100644 docs/generated_docs/_sources/components/expressions/subspan.rst.txt create mode 100644 docs/generated_docs/_sources/components/mpl.rst.txt create mode 100644 docs/generated_docs/_sources/components/ops.rst.txt create mode 100644 docs/generated_docs/_sources/components/ops/abs.rst.txt create mode 100644 docs/generated_docs/_sources/components/ops/add_to_diagonal.rst.txt create mode 100644 docs/generated_docs/_sources/components/ops/clone.rst.txt create mode 100644 docs/generated_docs/_sources/components/ops/deep_copy.rst.txt create mode 100644 docs/generated_docs/_sources/components/ops/dot.rst.txt create mode 100644 docs/generated_docs/_sources/components/ops/elementwise_multiply.rst.txt create mode 100644 docs/generated_docs/_sources/components/ops/extent.rst.txt create mode 100644 docs/generated_docs/_sources/components/ops/fill.rst.txt create mode 100644 docs/generated_docs/_sources/components/ops/matrix_matrix_product.rst.txt create mode 100644 docs/generated_docs/_sources/components/ops/matrix_vector_product.rst.txt create mode 100644 docs/generated_docs/_sources/components/ops/min_max.rst.txt create mode 100644 docs/generated_docs/_sources/components/ops/norms.rst.txt create mode 100644 docs/generated_docs/_sources/components/ops/product.rst.txt create mode 100644 docs/generated_docs/_sources/components/type_traits.rst.txt rename docs/{source/concepts_note.rst => generated_docs/_sources/concepts_note.rst.txt} (100%) create mode 100644 docs/generated_docs/_sources/index.rst.txt create mode 100644 docs/generated_docs/_sources/installation.rst.txt create mode 100644 docs/generated_docs/_sources/keywords.rst.txt create mode 100644 docs/generated_docs/_sources/license.rst.txt create mode 100644 docs/generated_docs/_sources/mydefs.rst.txt create mode 100644 docs/generated_docs/_static/_sphinx_javascript_frameworks_compat.js create mode 100644 docs/generated_docs/_static/basic.css create mode 100644 docs/generated_docs/_static/check-solid.svg create mode 100644 docs/generated_docs/_static/clipboard.min.js create mode 100644 docs/generated_docs/_static/copy-button.svg create mode 100644 docs/generated_docs/_static/copybutton.css create mode 100644 docs/generated_docs/_static/copybutton.js create mode 100644 docs/generated_docs/_static/copybutton_funcs.js create mode 100644 docs/generated_docs/_static/debug.css create mode 100644 docs/generated_docs/_static/doctools.js create mode 100644 docs/generated_docs/_static/documentation_options.js create mode 100644 docs/generated_docs/_static/file.png create mode 100644 docs/generated_docs/_static/front_page_schematic/frontpageschem.pdf create mode 100644 docs/generated_docs/_static/front_page_schematic/frontpageschem.svg create mode 100644 docs/generated_docs/_static/front_page_schematic/frontpageschem.tex create mode 100644 docs/generated_docs/_static/frontpageschem.svg create mode 100644 docs/generated_docs/_static/hacks.css create mode 100644 docs/generated_docs/_static/jquery-3.6.0.js create mode 100644 docs/generated_docs/_static/jquery.js create mode 100644 docs/generated_docs/_static/language_data.js create mode 100644 docs/generated_docs/_static/logo.png create mode 100644 docs/generated_docs/_static/minus.png create mode 100644 docs/generated_docs/_static/plus.png create mode 100644 docs/generated_docs/_static/pygments.css create mode 100644 docs/generated_docs/_static/scripts/furo-extensions.js create mode 100644 docs/generated_docs/_static/scripts/furo.js create mode 100644 docs/generated_docs/_static/scripts/furo.js.LICENSE.txt create mode 100644 docs/generated_docs/_static/scripts/furo.js.map create mode 100644 docs/generated_docs/_static/searchtools.js create mode 100644 docs/generated_docs/_static/skeleton.css create mode 100644 docs/generated_docs/_static/styles/furo-extensions.css create mode 100644 docs/generated_docs/_static/styles/furo-extensions.css.map create mode 100644 docs/generated_docs/_static/styles/furo.css create mode 100644 docs/generated_docs/_static/styles/furo.css.map create mode 100644 docs/generated_docs/_static/underscore-1.13.1.js create mode 100644 docs/generated_docs/_static/underscore.js create mode 100644 docs/generated_docs/components/expressions.html create mode 100644 docs/generated_docs/components/expressions/diag.html create mode 100644 docs/generated_docs/components/expressions/span.html create mode 100644 docs/generated_docs/components/expressions/subspan.html create mode 100644 docs/generated_docs/components/mpl.html create mode 100644 docs/generated_docs/components/ops.html create mode 100644 docs/generated_docs/components/ops/abs.html create mode 100644 docs/generated_docs/components/ops/add_to_diagonal.html create mode 100644 docs/generated_docs/components/ops/clone.html create mode 100644 docs/generated_docs/components/ops/deep_copy.html create mode 100644 docs/generated_docs/components/ops/dot.html create mode 100644 docs/generated_docs/components/ops/elementwise_multiply.html create mode 100644 docs/generated_docs/components/ops/extent.html create mode 100644 docs/generated_docs/components/ops/fill.html create mode 100644 docs/generated_docs/components/ops/matrix_matrix_product.html create mode 100644 docs/generated_docs/components/ops/matrix_vector_product.html create mode 100644 docs/generated_docs/components/ops/min_max.html create mode 100644 docs/generated_docs/components/ops/norms.html create mode 100644 docs/generated_docs/components/ops/product.html create mode 100644 docs/generated_docs/components/type_traits.html create mode 100644 docs/generated_docs/concepts_note.html create mode 100644 docs/generated_docs/genindex.html create mode 100644 docs/generated_docs/index.html create mode 100644 docs/generated_docs/installation.html create mode 100644 docs/generated_docs/keywords.html create mode 100644 docs/generated_docs/license.html create mode 100644 docs/generated_docs/mydefs.html create mode 100644 docs/generated_docs/objects.inv create mode 100644 docs/generated_docs/search.html create mode 100644 docs/generated_docs/searchindex.js create mode 100644 docs/source/components/ops/abs.rst create mode 100644 docs/source/components/ops/add_to_diagonal.rst create mode 100644 docs/source/components/ops/deep_copy.rst create mode 100644 docs/source/components/ops/dot.rst create mode 100644 docs/source/components/ops/elementwise_multiply.rst create mode 100644 docs/source/components/ops/extent.rst create mode 100644 docs/source/components/ops/matrix_matrix_product.rst create mode 100644 docs/source/components/ops/matrix_vector_product.rst create mode 100644 docs/source/components/ops/min_max.rst create mode 100644 docs/source/components/ops/norms.rst create mode 100644 docs/source/components/ops/pow.rst diff --git a/.github/workflows/deploy-docs.yml b/.github/workflows/deploy-docs.yml new file mode 100644 index 0000000..816c82b --- /dev/null +++ b/.github/workflows/deploy-docs.yml @@ -0,0 +1,40 @@ +name: Deploy docs + +on: + push: + branches: [ main ] + +jobs: + build-and-deploy-docs: + runs-on: ubuntu-latest + env: + docs-directory: /home/runner/work/pressio/pressio-ops/docs + python-version: '3.10' + + steps: + - uses: actions/checkout@v3 + - name: Set up Python ${{ env.python-version }} + uses: actions/setup-python@v4 + with: + python-version: ${{ env.python-version }} + architecture: 'x64' + - name: Install Python dependencies + run: | + pip3 install -r ./docs/build_requirements.txt + - name: Build documentation + working-directory: ${{ env.docs-directory }} + run: | + make html + # .nojekyll file is needed for GitHub Pages to know it's getting a ready webpage + # and there is no need to generate anything + - name: Generate nojekyll file + working-directory: ${{ env.docs-directory }}/generated_docs + run: touch .nojekyll + # This action moves the content of `generated_docs` to the branch from where + # the site is published + - name: Deploy docs + uses: JamesIves/github-pages-deploy-action@v4 + with: + branch: website-deployment + folder: ${{ env.docs-directory }}/generated_docs + clean: true diff --git a/.gitignore b/.gitignore new file mode 100644 index 0000000..722d5e7 --- /dev/null +++ b/.gitignore @@ -0,0 +1 @@ +.vscode diff --git a/docs/generated_docs/.buildinfo b/docs/generated_docs/.buildinfo new file mode 100644 index 0000000..7b896ba --- /dev/null +++ b/docs/generated_docs/.buildinfo @@ -0,0 +1,4 @@ +# Sphinx build info version 1 +# This file hashes the configuration used when building these files. When it is not found, a full rebuild will be done. +config: 2c24ea7424d95996344878a5c2dcb9b7 +tags: 645f666f9bcd5a90fca523b33c5a78b7 diff --git a/docs/generated_docs/.doctrees/components/expressions.doctree b/docs/generated_docs/.doctrees/components/expressions.doctree new file mode 100644 index 0000000000000000000000000000000000000000..baa2f53aee0cb68046a838af2d4cad79be5263f7 GIT binary patch literal 4305 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 JuJxqb`Y)U+nA-pV literal 0 HcmV?d00001 diff --git a/docs/generated_docs/.doctrees/components/expressions/subspan.doctree b/docs/generated_docs/.doctrees/components/expressions/subspan.doctree new file mode 100644 index 0000000000000000000000000000000000000000..9cea2cb0d3328b0bb86403e6b68dc161e7b881eb GIT binary patch literal 8527 zcmd^F-EUk+6}RK~WBrwEN)kdE^@ftfw(Q*`6jYfsQfPrv7b^{JL_yKryZ6p|W_|bG z%bmIYpsE0&qFS1_T>1w<#XnIgQbiGOJOC2#&`16QqzVZMelz!DXSdn4liK2el{Vg) zIdkUBncq2Q=A8U&{8z7B9?>6pibs?MyEVu2g3u#8l~Z2mCLI!p^kKUA^Yoo`K~`dC zhlfe*l2nd>!llgjViKeeFgUO11@n0=XE5o8ou2u0Tz={0&<|rPio+K33Ab8kd_P+` zrIQa*T9GF=$gWy*DDAtcl1NTO4we@wo#jnOPCG)xteFUiuf!c=9*1ah()AtA(TU&V zfz!!;O?gSwZ8RNsD<&;XQ`znKt2}blHm9PPa1w8mG?A0S*;F%9I!({fFf z52DI60eP070(u_%rWc^ci}+r`_c?qog43&Xj9#M)baCxOk3ip9ph84^ zwO(&B(M;SeB5Gm0S@)ZS^DwCIkmgE;lRA&xddJ~{#Pu2%j$m%Rlzg!e{mA&0n|$$U zHhHpVlN)zDClXM1D-Ju>g1czF&V1$s);IMgm#v%EZ`@eHKVM(A4y}%2$H&9G-2S(p zX8T{o_A7Fd6IZY>D6N@}(+OpA3m6<1O!&kYk~574Pns}-pwTESbJAxxZ^t+2=mTxF zRj|*f(@fR{0Mf~DwoVtpOle}!xl zKaA>kVX>Trb!EBuyAnpc4nyVj+%DmkqA-Bl;B~T_69pK}HlXblmZ3mXkrg-?XESyp zYHV6wd6hUGiC3*g<5teVWL2Y4bURnu0wkL68H=O%}f;M01dra2wq_6hed}RyL0!ug<0s|U1Yp}c*)eEKg`JW z;uU=?b2$?2rXRXn=F$91yL9Ed5oGlFTW?QK3(|>vN03`O5?C9zr|U}$T^2kv9J9An zxANm(*s!izVFZ{5-tx3H=);A#x*9nwzNLS0_7h@@Wy@&Xw&HMy-*bXZ@;Ujqp`YC@{@8LHxI=3eL3ahh!STLv3|^rqEyaPwn=?_ zh3&+f>L#JU|3MD^nF5cdwa76iVyROE-J+StUNwEAu$i2Vg7FaBnR$h9H)fG`*tv)8 z>Fe6k$4_QU9~riEUfa@4Gx2>QY@gwxQe5@S;80N`He7$l82-VX(UFl2XA5^Y7FdX$ zjYe)YjmENtd(95?6XS63lPLadiwvP7JaM#Ergt%X}#A-CWiwpMOh+l=fiTdYQE!x(SrIgjP6ZFYff zmrgVJpQtn!qbg_3<&9ACi3u_zTH%&Zo_gVbCi5O+`ajI+2S=h$fXk|^eg;Mc$3X(k z^+2r`RL+eF)uDzr=x4(=(Svx}JIf$zA`~arLF~8Xd93#fO@H8>IaJbi>G~639J?N9^z`)g3 zyD;yC#f7lQ!kDk9OMvJbntnLnzk+UE(-|0eb{E{$n49;W$(HRcq=1Jz5(g z$?#JsGDnxe?{}Kt@O6QszEc~_|M7TI*H!)0H31@LP}nG+)!pZMU-yt_J6_CPNxC`D zE~_#P>X<%Xz5d6#C{(${E}Q-!Q5F)YP!=*O=iMY$RSr8ZFs#ejqDNO1*5wo@La+eI z3Rx|yFi3CXSsi$&lH6AhTHbxVzqKwacy8&0n-|dPxNxaZTnGIB@ z;d(<(Y;&eYi7V`F##si@Q?|#r)AR{8l1n*R7z7n^7MtNP0TiN8;s9!LGFz7!RpIZP z`h`VM%u_TtVa3hEka(l3i`9W_6mtPge8F7r^SbGPkxb$4Ic9;yNIwGIs*|1r%A}F&Kxi1ya96=-pLS z*oRc8Z38x{q^l~=XL@?GIx@P!tyMNAlnJ2(js8j1nf+d9{|6zk{cjbCAJGrnpQ_eB zRaBG}MJ4tkh>bd~rrW2F_BF|VLNBOJJ?}pKkUrFt=tqg1Gf!79H|H`{lZCtxA?r~_ zT+n6vGJ7&QmERE5919fy&i3=lM@Hl{T#Oqg zDi@r}8Dz?QoCNlOFf;jb-v1Dac{jZWb3tJahKE`{2SBm~OHb3&JyUk;GoE3A>nEPV k)TZ(ai&=cDAEGL_u#S&Nf0^RH8hFZu=H5m{_M}<+FFjoS%M*WbS~`Iw0WpGzXw3w9fp;{>6@lAJF% zp`G-kR1g8UI~E>Zi`^OHtNVBQXU1O44u z{`8kaKa7ni4m+OD5~G73Zx=U~)o|AwzK5zS0lHek~&jwbn__p9=QU6EVvbSQ^5p8O_J%2rkESly*6tjfI z+bqxcd}?h{kKC=hPr5U_W-1Zk*PN8ha`C0v+jBs$5hrQRPy1fL@_Q$e z^LNKJdIyaj6g2r8O*ibZrfvDGosj$S_nNP;ZRUqj^DS6v;)PAJSp2^hMoAL}nlwv$ zggc7D0PZ4bf?;8ouz&?2of;g8wHaHHt4$E5$1I1%>qe_}tE4Krx>0ny6wQje%ok)c zO$a->5Zsos`Afq|fztAUVKkCo)kzLFbt%`Ktj&h{18S7P2c(byIWr+&NMc(tdi|}e z?R&N%TqOBIl0qqj_4U4PkN_?mY^(A8fzG!kit~rk1GzK$FdCt6>4e4$;Dbp8a7Gir z&q@JEq)SsK=pEQ-Q7H8xqmVl152Yt`6sJ=-(Y{h$x`fD9yFU$wn!qj$S6GekuXSpH_<$i}M-p5Wqo~yE?pHOSGafY#cuA(E7;YH1bYh?a@I(8>hS8beQV)tLCVfPAP z(i!1a3C$JD z-DS)lTy-zte_mIjcaS%fd@l3PPw%1np=v-CCj$u=WXRG(6?e#6c0%6|cPNU8_;Qnc zwP*P^;qH^v2m^o5fSY7N5vNE16xtApM5MBO1HUX8d&($A@SIs`hDg+Rtrrg&O;exM ziuzzx7g#THt;9=o^{pumrB2S5ENjGGtPmUN$GR_2>nFR!f$(N`k8SR1(FAebIwo7U zrw?7XU)TtZju$van5Bk=xZ4-IZ6Q-$HQI5wlOPgOfG_ZKVGWcVmVpy^x{A4*Y0Mb% zLN91~f$e7wlW3fRJmRa_U(MB{@Sv^C{mRO?|DzDv8^_A3)DD^0_m|>9g@xhDAsv;Z z(LIl@{HJAJIjtn6^Xif?gvOn0j1bXes&YkB6}3t6@E?N%UaJjy2*ilrk8-|g>Dt#+ux5U1Tv2hy+G0p(cB;A+m^_ys@kQ8ZQ zvB>~D+-n1Q*D+--pJn;;$UcnL-pjM1>fNTZn2&+J;5 zJ6nIxSjS%4nw$3gwccmr_13L++`Qc)@eGri(ND#Uh+yp(Bv2Qt@-n*OUm+%w_PgSA zh1&I(>y{HDr(?I**9B{<#`WvQjh9O`|9GK)>=(LlV2D%i!=@+QNz(Jw7vO3}B*;%y z{RAS58Fu6*lG+66{yN4l)95GkTz`GN=%Kl?uTxX8Upe7^Quo);V}dQE?pGCMk%Pa8 zxz+gDa+}K(K1)XpuPU!q^*$dOlaJy z@>%S-1I_RA1>XubGiwuj+%s^@IbU+UP1na?Y61$=4mx4c-y$g$`$R86bEMFOuol~y z@3Yh-oTrIO?wlZfpgSfu4tv_|hj&5p6^7kJY-nHyW5;FWGY#zG#d`+x8SPB~F$yQ0 zz?)P0VI;85q(eI%e!@TBfy3`*fS=e~Pcm$Mi0FXpw>G5v z(^|mqWAN02bELr0YPG`F+?B)piZ427V%xqE*UbtJ<+H#k4F8ln9{NQ1oJMO zx7xLP`0B^9JucY_(bA62&wsSasyVwqCu7r`owg4%D|A{y(vx?zUVmBXH5`pn%8M=c zE{!8l>o z&rRkbw82I&T2oL~aylzun%4V2rf2mlg$JzSt14Z{1CA-*fgUM+c2v}kp!$7;<^lmWiC)J0?LZ^9O&8@?uD|Fo2<)*Ck$-? zezLO0z*sZLd^9}3FCCf+DI*Y>kw)>SDijBoh@a8(D(tdp55f5yz)#Pj$MKYS$%o?I z&k@A})Ym*1vvkM2ZcQJYF=;C4DaGZO!7(ZBo0>o%h!3G%G6obW z(Lh*uNSla;M#w)+0t^pkq_@GPm~Fh_9M2SV~ewtQ+$NI@PTdmAS6 z9dJ2j*Ht36Z>tHF>C$k6?7C>%^@uk1A~n25LrUYjIi=yoVzduB!fwo4_bRFBg{7i}G$qqavvY}e6ajQm|fY}XWJf!J{PauBiIecWyC za{dak9Uno3**=ds91~`Hq={q#%=Yf#NP^}p4=_x$#rvbSe|_W$P6H>(&4>Qp!^3wz z7WXkeGN`(J${uOs#y$kS9eKgWXtd_r-clauC?M`(rPuJ7A#+$7XA%%Mf}bOTxbE~k zP6FaaFgg~*{o?ej9Ua7tU~~cy_Z!o*`d|czJF-UiUD#tQ?{7~(r6WVQs_-X+a2Dd= z>)>(>gpd&KH8r8>Ash`U(Z~RVyI7(lvE@d~Hi+SdfTxil4lrjFh%1NW&xKzB%YO^1G{gg5Dth98Vy83FG8R#6t<&Z~mE+X~#3 zC$HpTh1YO6b9Vy=qSR@HL#Ci0-Q$u`K<=Nx?=b=YJ^^I)F|lh+VU% zkD9m9cmkz7Jv4UJCu0u}T5-%#J_$Oxq4oO2^lUwa%7H_bTO&V0W^=6;*?{Eg)Vq(g zemACPYvsg*R;3L$g3Yt7mS%jC+nTzjQF(cKrtgC3vA^`gc>->SM&RLs`6!$;XT;98I4Je)D^$ zc-^&p^>dalvt19eLN$7p$VRh#)?w{z6T>a-SaCoHAwZW|JzS}wX3=Iesr(y!$qS+^ zHF4T7q>{*-*Rr&;_R?D7;ro@rnCDg591;l1g@}Cd;)1jCd?zIC;E?AjyrzL)jF}zAj_I(7 z>Tv=a585DyIh?HOV49GK=a{g^j<=h;b9~9l($MT*;-@?(=VzU)7nw@&AXssMYJB1V z#}Yy2oVWt%1_>>H|5B8&%n41rU;(Ypv)w36n5p*^T4JNTz)QSBMbDXzmk1E9xSW>; z;imiyCX>JfaK;72?a&&`mnLJ17fjGAAD*Od7=%v5qYYM=s5w~jMVu8;KcS+_WL40d zU=xbydp$4B-#Gs~Uy4{{s&Xuv%o)1UMx~5N#=)PG^&GgIG@`xK4FmDwgq&ZZmVyDa zG$sC~_e!v6?b%Pi0C_IO9lJuFuJp-2C&|NDEmGMn7B@VWcElJk`z9S{X+mR>tiXz# z)XncL@T<_to~g`JO~5Q(ZL!bKCwnMg-8I$0UwTgkDqC}YCh4Jw%X~kBT_+IKMe)1% zX`)mZ<@e%E8CPu=b@MhBzOXk)S%?t5x3UPQjOnEy;@twJAJ~WXgtixSpaaq|Tp(8g zuU~2B^>8>DgIR?&(i=3ka_9`|KOC6w9$0W0D)#pIB^#}_OoqB6-^2?{sC-$ly00yUYA6F1?yO-(X zZ|LK%=)ck=PSj~l%|WJMFh|ISzW2bEYI2=y#xee!pw^+UKRr?2RCqeQC$|QwOCfdL6tYj9bGQMYV(lS aQLNm@zcl}Pj(6EOi-LhdVX~P literal 0 HcmV?d00001 diff --git a/docs/generated_docs/.doctrees/components/ops.doctree b/docs/generated_docs/.doctrees/components/ops.doctree new file mode 100644 index 0000000000000000000000000000000000000000..0fe0ca30966b89fefd3e6d2b1ca7c7296dcdcc34 GIT binary patch literal 16772 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 literal 0 HcmV?d00001 diff --git a/docs/generated_docs/.doctrees/components/ops/abs.doctree b/docs/generated_docs/.doctrees/components/ops/abs.doctree new file mode 100644 index 0000000000000000000000000000000000000000..75c2618e6c01b35e6d9390dd00d16c92542875c8 GIT binary patch literal 9281 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 C(JrX~ literal 0 HcmV?d00001 diff --git a/docs/generated_docs/.doctrees/components/ops/add_to_diagonal.doctree b/docs/generated_docs/.doctrees/components/ops/add_to_diagonal.doctree new file mode 100644 index 0000000000000000000000000000000000000000..2574beec81f32d657e805b7acb89c210342cfb08 GIT binary patch literal 7992 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 Qm^37pT6iCd^x2^MD+tR|y#N3J literal 0 HcmV?d00001 diff --git a/docs/generated_docs/.doctrees/components/ops/deep_copy.doctree b/docs/generated_docs/.doctrees/components/ops/deep_copy.doctree new file mode 100644 index 0000000000000000000000000000000000000000..2803c93f958398ee4ab3af996b39c1ed604f5126 GIT binary patch literal 10282 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 U&)&}Piq0XontLFM_Gzd2AKi|Z`~Uy| literal 0 HcmV?d00001 diff --git a/docs/generated_docs/.doctrees/components/ops/dot.doctree b/docs/generated_docs/.doctrees/components/ops/dot.doctree new file mode 100644 index 0000000000000000000000000000000000000000..39c3346b0b2304007ea12b5dae462f4c138c6751 GIT binary patch literal 10270 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 Q&N<{zbKgVfe9~_G2gQVo4FCWD literal 0 HcmV?d00001 diff --git a/docs/generated_docs/.doctrees/components/ops/elementwise_multiply.doctree b/docs/generated_docs/.doctrees/components/ops/elementwise_multiply.doctree new file mode 100644 index 0000000000000000000000000000000000000000..56e41e8c29bd8487b6f407f1ffc3261c9237ab8b GIT binary patch literal 10175 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 literal 0 HcmV?d00001 diff --git a/docs/generated_docs/.doctrees/components/ops/extent.doctree b/docs/generated_docs/.doctrees/components/ops/extent.doctree new file mode 100644 index 0000000000000000000000000000000000000000..a37e25e600fc6bd93114cb5c728c658676ed0829 GIT binary patch literal 9532 zcmdT~&5s;M6<>QjyF0TV_BgQ<WWMc>@>gnmOnd;e| z?xwqXKL`=w5R?^lbAvb`Ay6bF4%{O}ij)I45Fi1ET#)z=kht=D)m_~^WAE&Glt{ty z%uZLmdiCC`_f_xpJGGx*zdWP<$cDgF- zk+mBKNo2EB&H%#ZuIEI|Pv6Ak3c(B4i(5H@c{>=6tmifPg=YgVh>S1_dalP}qlbsr zvYk^t|7ObT^3)dFqdh0WzMB$7axS#6y-4{|+_hxG5+ZWDi2(UT?yT#?AWhEOo)yO! z#P6DK4YOYhP7;<6UCZ8%SWm&!_lDj^99qQYLKv}_MLR4_<+_ zPjgx_&Fn{exbFaAD~d%bPkFA-(i-q31M9NrWG3^FuKf0V&)jTuHXg-A#ux& z<4hjSqo6WLfSzj*0lyD?^9zvUMSL#d^B_JC;qx&6Qo=81g!3zWmOsK*`PCaIM+o}H zDi-hTWnsID#XpTP{ z zzp0G2Dd#faG^2DC>S$$Jw#lzH&vzb40w2%?VHc*`iqa2jtl8iEZ&&l2oO<@JrNH6#1+qVKT1 zt^JTa)rf_&u@SpJWTr4O1z5EMKNiN8am5I_16az7KGvzRVx8e${aT~(_S;6gZ7|=d zY@8Fbu>lISRQ@k$EgZ}HM>!T*L#ReTJdg{X<@Xb-kKj0KhhZvLxZCF*KEkx3K80RV zsNd!awW!ays)2IW3fo>Tg{*iAf-3Da{C*>!GI^`>>2G2twSm1+5%SD8p69}%B3gOtxe?&G+~kl?0# zBj_0xX`HZ-DMWBGS`RxN!}0>ZkLfsMw%c|1@U2&)s%!aNhjROlKLmg!|A#*R?{1%%ndx-4pf>0K}IykOV$ z`x}kMH3Lb{^KPH{#tu9lv=RS@7EJ1Sih4oFIDUwp{UbRTnkR*n>wb(0m>VSF-)i zRBS&4wtqA&+gA!MCc52m<}V*>nHIq@p-VyhawJdK*_KvuQ~I2Q%1WgC+2@Ejb)1ymUYtNwC1Cz>>?|w!Z1c7pMC;1( zNN!TW_UAEdlVc6)B?H=D#rTtJMg`F^$;vXG+sUHw3bucJ8f4|f#@&jD?yZO@)(My< z=S(4`e5yjxf2OAh<-BPUyvpX|!aZJ+^aup-u{y2Er&?wZhvSuV+1)dhC$6bm_FwYr zF{LS4CU*E@x>i?i4q0XHaPYzXCue2`7w|<3^+xyM>Y=X0BiH#wbPS5?cX_QJ8=i2z zrwRrAprU?$vCp4M$9f$^R}}k>fXx!P zn9wbaQxgDJGdqYPT&N6z5>+c>waADE&k?<X- z*QgdE9+<>NwsBp~xxQ*yl=Y3lw{sfcB$ui(sF3mc7#X7nu_{j~TI4JWaA?cmdmR!@ zS+!FEWgEOkXwDD5g+G(7!g3Cr5dwMcj#b?h4J!f|qNI`zI>099F+c)F?Mf|N#4`e; z=i07F-&51OR^;O+EfuI|F?4U{vO^||8@x=kWwp{Z&`5$;e)zE|6rdux+Yazpcf&m* zMs;(JS!XZlJ%5Pel~y%Q(&4Ux9E83wkx-sdLK!{$u`?!5H28W!K3UreC04oS5yp4a6<3`C67f*qr{<`9G32?5#Lm(oXyTaxe~MxN+i0#sTUMYLM~|S z3Ath?uzFvZdGl~nF6j|vew%V3W(UEOJWwQ<|T30@rGccmLo0gZrH5PXI#-^;J zq=QBcDmp119MrC)fEVDK_Ez; zmB||?t@Z$acx)0WY(L7^$NuWiw(5 zCcWbNVIoZC+W|R7xQ9ga)}L69UHpDvbkbx|6htPse8*!EX6@CB!XM2upoDJ-eH zG&VDaV(=$uyIjfemNe+q4~$NXEtY49hZut55Rs=^)62RL4~aYQXeZH#m-irs1d(Gp zjNCuAaiJWWat;Nn9@vCLT*pL$)pPe!J||bKLvUM zd4%w^8i92En2x_33S*Wyfr%D6pw7Uz1~D_ME0vbm!rXCVH&fBmrsKvGH^E3w<-9fs zF60uJiD3e0GNXM7t;xYm^$Gzs_0Q8UY=TBT!Qg}mn}Z`?#2X96BUH3WRt3%R`%pyB z9m4CseC83k60*>wPyk!BmB0`^L+CqbC*zR!>rOC+<5svYc;KtnIARY$Dgpp$>h2T0 zIl#j8%a1+|d9Fk~dkj5|l<2Q$^e|Rb#&FauYPn4G)E+SVHWx#$4UI*90V{F@Pj4*9 zOVG)oS(sFwDmgncn!O`}VPNYO50rY) z>m?YUr@`#^>fm=U^1=HQ*FNMQ48BZHtMv72`uY{V5?LpBNkh>3@YL!a=Ci$ijZX_G0I3t*Rl~ZZw;4mTph{aU_j85VK?v! zRZ^h$jtv&j^%0D9y{lSub_72>btEV>oEyiL&&Xrn)YGs0;g0L?#} zkKclr-%VeIA)zx5lf)Z5F;pkpu<$`6!;8hRI{ii0x4pz6ZR?ZAFtW(kzGL2~-Ue9R X#6OY#G{t*G4*AsF{ZOb+x~=~K7SoeE literal 0 HcmV?d00001 diff --git a/docs/generated_docs/.doctrees/components/ops/fill.doctree b/docs/generated_docs/.doctrees/components/ops/fill.doctree new file mode 100644 index 0000000000000000000000000000000000000000..bdc207b9e509709f7cb60e72378384347d2d8f4b GIT binary patch literal 10131 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 literal 0 HcmV?d00001 diff --git a/docs/generated_docs/.doctrees/components/ops/matrix_matrix_product.doctree b/docs/generated_docs/.doctrees/components/ops/matrix_matrix_product.doctree new file mode 100644 index 0000000000000000000000000000000000000000..beb0ea9568a6d43cc746ca4f814927d6a9499cc7 GIT binary patch literal 14402 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 literal 0 HcmV?d00001 diff --git a/docs/generated_docs/.doctrees/components/ops/matrix_vector_product.doctree b/docs/generated_docs/.doctrees/components/ops/matrix_vector_product.doctree new file mode 100644 index 0000000000000000000000000000000000000000..84350d01f7b212e3f17e35f40d66ed7f606fc317 GIT binary patch literal 22090 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 Hr%wAn=rT=u literal 0 HcmV?d00001 diff --git a/docs/generated_docs/.doctrees/components/ops/product.doctree b/docs/generated_docs/.doctrees/components/ops/product.doctree new file mode 100644 index 0000000000000000000000000000000000000000..52863f40cc064091ac9338bdc5d81e7dec197bd0 GIT binary patch literal 21992 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 literal 0 HcmV?d00001 diff --git a/docs/generated_docs/.doctrees/concepts_note.doctree b/docs/generated_docs/.doctrees/concepts_note.doctree new file mode 100644 index 0000000000000000000000000000000000000000..6f9eca5c12da5c1ee8211eb843a12c49a0d344bc GIT binary patch literal 12810 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 literal 0 HcmV?d00001 diff --git a/docs/generated_docs/.doctrees/installation.doctree b/docs/generated_docs/.doctrees/installation.doctree new file mode 100644 index 0000000000000000000000000000000000000000..16c45f13da1cc1e15c55211b8ea5761b0392a00c GIT binary patch literal 24670 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 literal 0 HcmV?d00001 diff --git a/docs/generated_docs/.doctrees/license.doctree b/docs/generated_docs/.doctrees/license.doctree new file mode 100644 index 0000000000000000000000000000000000000000..f781b87ad1004355975c2c8ff78a67bba90846b7 GIT binary patch literal 6803 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 + +Public namespace: ``pressio`` + +We refer to these as expressions because each function does not allocate +new memory but only creates an instance of a class that "represents" the given operation. + +In all cases, the returned expression remains valid until its operand goes out of scope. +If the operand goes out of scope, the state of the expression is undefined. + +.. toctree:: + :maxdepth: 1 + + expressions/span + expressions/subspan + expressions/diag diff --git a/docs/generated_docs/_sources/components/expressions/diag.rst.txt b/docs/generated_docs/_sources/components/expressions/diag.rst.txt new file mode 100644 index 0000000..0477c2f --- /dev/null +++ b/docs/generated_docs/_sources/components/expressions/diag.rst.txt @@ -0,0 +1,29 @@ +.. include:: ../../mydefs.rst + +``diagonal`` +============ + +Header: ```` + +API +--- + +.. code-block:: cpp + + namespace pressio { + + template + /*impl defined*/ diagonal(T & operand); + + } // end namespace pressio + +Description +----------- + +* Takes in an ``operand`` that is either: + + * a square Eigen dense matrix, ``pressio::is_dense_matrix_eigen::value == true`` + + * a square Kokkos rank-2 view, i.e. ``pressio::is_dense_matrix_kokkos::value == true`` + +* Returns an expression that represents that diagonal of ``operand`` diff --git a/docs/generated_docs/_sources/components/expressions/span.rst.txt b/docs/generated_docs/_sources/components/expressions/span.rst.txt new file mode 100644 index 0000000..7ba84c3 --- /dev/null +++ b/docs/generated_docs/_sources/components/expressions/span.rst.txt @@ -0,0 +1,36 @@ +.. include:: ../../mydefs.rst + +``span`` +======== + +Header: ```` + +API +--- + +.. code-block:: cpp + + namespace pressio { + + template + /*impl defined*/ span(T & operand, + std::pair indexRange); + + } // end namespace pressio + +Description +----------- + +* Takes in an ``operand`` and an ``indexRange`` + + * ``operand`` is either: + + * an Eigen vector object: ``pressio::is_vector_eigen::value == true`` + + * a Kokkos rank-1 view, i.e. ``pressio::is_vector_kokkos::value == true`` + + * ``indexRange`` is a std::pairidentifying an interval ``[a, b)`` where the second index is exclusive + + +* Returns an expression that represents the target span of the ``operand``. + diff --git a/docs/generated_docs/_sources/components/expressions/subspan.rst.txt b/docs/generated_docs/_sources/components/expressions/subspan.rst.txt new file mode 100644 index 0000000..a01c844 --- /dev/null +++ b/docs/generated_docs/_sources/components/expressions/subspan.rst.txt @@ -0,0 +1,33 @@ +.. include:: ../../mydefs.rst + +``subspan`` +=========== + +Header: ```` + +API +--- + +.. code-block:: cpp + + namespace pressio { + + template + /*impl defined*/ subspan(T & operand, + std::pair rowsRange, + std::pair colsRange); + + } // end namespace pressio + +Description +----------- + +* Takes in an ``operand``, as well as the ``rowsRange`` and ``colsRange`` intervals that will be used in each dimension + + * ``operand`` is either: + + * an Eigen dense matrix, ``pressio::is_dense_matrix_eigen::value == true`` + + * a Kokkos rank-2 view, i.e. ``pressio::is_dense_matrix_kokkos::value == true`` + +* Returns an expression object that represents a subspan of the ``operand``. diff --git a/docs/generated_docs/_sources/components/mpl.rst.txt b/docs/generated_docs/_sources/components/mpl.rst.txt new file mode 100644 index 0000000..b8c8339 --- /dev/null +++ b/docs/generated_docs/_sources/components/mpl.rst.txt @@ -0,0 +1,114 @@ +.. role:: raw-html-m2r(raw) + :format: html + +.. include:: ../mydefs.rst + + +``mpl`` +======= + +Header: ```` + +Public namespace: ``pressio::mpl`` + + +Scope +----- + +Provides metaprogramming functionalities needed to +support generic programming, which is a fundamental +building block of the pressio library. +If you are familiar with the ```` header from +the standard library, the ``pressio/mpl`` will look familiar too. +Some parts of ``pressio/mpl`` have been adapted from the `tinympl project `_. +The tinympl project appears to be no longer maintained. + +The following is a *partial* list only intended to provide a general idea of the supported features. + +To find out all supported cases, browse the `source `__. + + +.. + ``pressio::mpl::not_void`` + ~~~~~~~~~~~~~~~~~~~~~~~~~~ + + .. code-block:: cpp + + template struct not_void; + + * + Provides the static member constant ``value`` that is equal to true, if ``T`` is NOT of + the type ``void``\ , ``const void``\ , ``volatile void``\ , or ``const volatile void``. + Otherwise, value is true. + + * + Example:\ :raw-html-m2r:`
` + + .. code-block:: cpp + + namespace pmpl = pressio::mpl; + static_assert(pmpl::not_void::value, "" ); + + +``pressio::mpl::all_of`` +~~~~~~~~~~~~~~~~~~~~~~~~ + +.. code-block:: cpp + + template< template class F, class ... Args> struct all_of; + +* + Determines whether every element in the sequence satisfies the given predicate. + The predicate ``F`` must be such that ``F::value`` must be convertible to ``bool``. + Provides the static member constant ``value`` that is equal to true iff + all the elements in the sequence satisfy the predicate ``F``. + Otherwise, value is false. + +* + Example:\ :raw-html-m2r:`
` + + .. code-block:: cpp + + namespace pmpl = pressio::mpl; + static_assert(pmpl::all_of::value, "" ); + + +``pressio::mpl::any_of`` +~~~~~~~~~~~~~~~~~~~~~~~~ + +.. code-block:: cpp + + template< template class F, class ... Args> struct any_of; + +* Determines whether any element in the sequence satisfies the given predicate. + The predicate ``F`` must be such that ``F::value`` must be convertible to ``bool``. + Provides the static member constant ``value`` that is equal to true iff + at least one element in the sequence satisfies the predicate ``F``. + Otherwise, value is equal to false. + + +``pressio::mpl::none_of`` +~~~~~~~~~~~~~~~~~~~~~~~~~ + +.. code-block:: cpp + + template< template class F, class ... Args> struct none_of; + +* Determines whether none of the elements in the sequence satisfy the given predicate. + The predicate ``F`` must be such that ``F::value`` must be convertible to ``bool``. + Provides the static member constant ``value`` that is equal to true iff + none of the elements in the sequence satisfy the predicate ``F``. + Otherwise, value is equal to false. + + +``pressio::mpl::is_subscriptable_as`` +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +.. code-block:: cpp + + template struct is_subscriptable_as; + +* Provides the static member constant ``value`` that is equal to true if + ``T`` has subscript operator ``[]``\ , it can be indexed by an instance of ``IndexType``\ , + and the return type is not void. + Otherwise, value is equal to false. diff --git a/docs/generated_docs/_sources/components/ops.rst.txt b/docs/generated_docs/_sources/components/ops.rst.txt new file mode 100644 index 0000000..b105021 --- /dev/null +++ b/docs/generated_docs/_sources/components/ops.rst.txt @@ -0,0 +1,96 @@ + +.. include:: ../mydefs.rst + +``ops`` +======= + +Header: ```` + +Public namespace: ``pressio::ops`` + +Pressio operations are generalized to work on a variety of container types and backends. + +Types +----- + +The following table holds both the types supported throughout the ``ops`` directory and the +built-in booleans that confirm if a given type ``T`` is the expected type. + +All expressions are within the ``pressio`` namespace. + +.. list-table:: + :widths: 10 20 20 + :header-rows: 1 + :align: left + + * - Container Type + - Rank-1 Check + - Rank-2 Check + + * - Eigen + - ``is_vector_eigen::value`` + - ``is_sparse_matrix_eigen::value``, ``is_dense_matrix_eigen::value`` + + * - Kokkos + - ``is_vector_kokkos::value`` + - ``is_dense_matrix_kokkos::value``, ``is_sparse_matrix_kokkos::value`` + + * - Epetra + - ``is_vector_epetra::value`` + - ``is_multi_vector_epetra::value`` + + * - Tpetra + - ``is_vector_tpetra::value`` + - ``is_multi_vector_tpetra::value`` + + * - Tpetra Block + - ``is_vector_tpetra_block::value`` + - ``is_multi_vector_tpetra_block::value`` + + * - Teuchos + - ``is_dense_vector_teuchos::value`` + - ``is_dense_matrix_teuchos::value`` + +Additionally, because Pressio features expressions for containers built on Eigen, Kokkos, and Tpetra, you can check whether or not a container is native with: + +.. list-table:: + :widths: 10 20 20 + :header-rows: 1 + :align: left + + * - Container Type + - Native + - Pressio Expression + + * - Eigen + - ``is_native_container_eigen::value`` + - ``is_expression_acting_on_eigen::value`` + + * - Kokkos + - ``is_native_container_kokkos::value`` + - ``is_expression_acting_on_kokkos::value`` + + * - Tpetra + - + - ``is_expression_column_acting_on_tpetra::value`` + +Navigation +---------- + +Use the links below to view details about each operation. + +.. toctree:: + :maxdepth: 1 + + ops/abs + ops/add_to_diagonal + ops/clone + ops/deep_copy + ops/dot + ops/elementwise_multiply + ops/extent + ops/fill + ops/matrix_vector_product + ops/matrix_matrix_product + ops/min_max + ops/norms diff --git a/docs/generated_docs/_sources/components/ops/abs.rst.txt b/docs/generated_docs/_sources/components/ops/abs.rst.txt new file mode 100644 index 0000000..c7767ae --- /dev/null +++ b/docs/generated_docs/_sources/components/ops/abs.rst.txt @@ -0,0 +1,44 @@ +.. include:: ../../mydefs.rst + +``abs`` +======= + +Header: ```` + +API +--- + +.. code-block:: cpp + + namespace pressio { namespace ops{ + + template + void abs(T1 & x, const T2 & y); + + }} // end namespace pressio::ops + +Description +----------- + +* Computes the element-wise absolute value of each element + in the operand x and stores the result in y. + +* ``T1`` and ``T2`` must be one-dimensional containers with compatible scalar types: + + * an Eigen vector + + * a Kokkos rank-1 view + + * a Tpetra vector + + * a Tpetra block vector + + * a Epetra vector + + * a Pressio expression, i.e. ``pressio::diag``, ``pressio::span``, ``pressio::subspan``, based on Eigen or Kokkos container + +Notes +----- + +* See the :doc:`ops homepage <../ops>` for a table of booleans to use when checking that ``T1`` and ``T2`` have the correct types. + diff --git a/docs/generated_docs/_sources/components/ops/add_to_diagonal.rst.txt b/docs/generated_docs/_sources/components/ops/add_to_diagonal.rst.txt new file mode 100644 index 0000000..dbdfcb2 --- /dev/null +++ b/docs/generated_docs/_sources/components/ops/add_to_diagonal.rst.txt @@ -0,0 +1,34 @@ +.. include:: ../../mydefs.rst + +``add_to_diagonal`` +=================== + +Header: ```` + +API +--- + +.. code-block:: cpp + + namespace pressio { namespace ops{ + + template + void add_to_diagonal(T1 & operand, const ScalarType & value); + + }} // end namespace pressio::ops + +Description +----------- + +* Adds the specified scalar ``value`` to each diagonal element of ``operand`` + +* ``T`` must be a rank-2 Eigen matrix + +* ``ScalarType`` must be convertible to ``pressio::Traits::scalar_type`` + +Notes +----- + +* If the diagonal entries of ``operand`` are written, then all diagonal entries must already exist. + +* See the :doc:`ops homepage <../ops>` for a table of booleans to use when checking that ``T1`` has the correct type. diff --git a/docs/generated_docs/_sources/components/ops/clone.rst.txt b/docs/generated_docs/_sources/components/ops/clone.rst.txt new file mode 100644 index 0000000..5dcbd86 --- /dev/null +++ b/docs/generated_docs/_sources/components/ops/clone.rst.txt @@ -0,0 +1,66 @@ +.. include:: ../../mydefs.rst + +.. role:: cpp(code) + :language: cpp + +``clone`` +========= + +Header: ```` + +API +--- + +.. code-block:: cpp + + namespace pressio { namespace ops{ + + template + T clone(const T & operand); + + }} // end namespace pressio::ops + +Description +----------- + +* Creates and returns a new instance of :cpp:`T` by making a new allocation + and *copying* all values from :cpp:`operand` into it. + + * It is an exact but independent clone of :cpp:`operand`. + +* ``T`` must be: + + * an Eigen vector or matrix object + + * a Kokkos view + + * a Teuchos vector + + * or an Epetra vector or multi-vector + + * or a Tpetra vector or multi-vector + + * or a Tpetra block vector or multi-vector + +Notes +----- + +* This is a blocking operation, i.e. the kernel completes before returning. + +* This kernel has value semantics, even for types that, by default, + have view semantics like Kokkos, Tpetra or TpetraBlock. + This means the following: + let :cpp:`auto result = clone(operand)`, then any operation applied + to :cpp:`operand` *after* calling clone will NOT + have any impact on ``result``. + And any operation applied to ``result`` will not have any impact on ``operand``. + +* For types that have value semantics, for example ``Eigen::Matrix<...>``, + Epetra vector or MV, this kernel can be implemented by calling the copy constructor + and returning the copy + +* For Kokkos, Tpetra, or TpetraBlock data types, which by default have view semantics + (i.e. a copy is a shallow copy), the operation can be implemented by first making a new + object with extents identical to ``operand``, followed by a deep copy, and then return the result. + +* See the :doc:`ops homepage <../ops>` for a table of booleans to use when checking that ``T`` has the correct type. diff --git a/docs/generated_docs/_sources/components/ops/deep_copy.rst.txt b/docs/generated_docs/_sources/components/ops/deep_copy.rst.txt new file mode 100644 index 0000000..40481b8 --- /dev/null +++ b/docs/generated_docs/_sources/components/ops/deep_copy.rst.txt @@ -0,0 +1,46 @@ +.. include:: ../../mydefs.rst + +``deep_copy`` +============= + +Header: ```` + +API +--- + +.. code-block:: cpp + + namespace pressio { namespace ops{ + + template + void deep_copy(T2 & dest, const T1 & src); + + template + void deep_copy(T & dest, const T & src); + + }} // end namespace pressio::ops + +Description +----------- + +* Copies all elements from ``src`` into ``dst``, so that ``dst`` is fully independent of ``src``. + +* ``T1`` and ``T2`` must have the same rank, and must be: + + * Two Eigen-based containers (either a native Eigen container or a Pressio expression based on an Eigen container) + + * Two Kokkos-based containers (either a native Kokkos view or a Pressio expression based on a Kokkos container) + +* ``T`` must be: + + * a Tpetra vector or multi-vector + + * a Tpetra block vector or multi-vector + + * a Epetra vector or multi-vector + +Notes +----- + +* See the :doc:`ops homepage <../ops>` for a table of booleans to use when checking that ``T``, ``T1``, and ``T2`` have the correct types. + diff --git a/docs/generated_docs/_sources/components/ops/dot.rst.txt b/docs/generated_docs/_sources/components/ops/dot.rst.txt new file mode 100644 index 0000000..d6902c6 --- /dev/null +++ b/docs/generated_docs/_sources/components/ops/dot.rst.txt @@ -0,0 +1,47 @@ +.. include:: ../../mydefs.rst + +``dot`` +======= + +Header: ```` + +API +--- + +.. code-block:: cpp + + namespace pressio { namespace ops{ + + template + void dot(const T1 & vecA, const T2 & vecB, DotResult & result); + + template + scalar_type dot(const T1 & vecA, const T2 & vecB); + + }} // end namespace pressio::ops + +Description +----------- + +* Computes the dot product of two compatible vectors (``vecA`` and ``vecB``) + + * Stores the result in ``result`` if provided; otherwise, returns the result + +* ``T1`` and ``T2`` must be one-dimensional containers with compatible scalar types: + + * an Eigen vector + + * a Kokkos rank-1 view + + * a Tpetra vector + + * a Tpetra block vector + + * a Epetra vector + + * a pressio expression, i.e. ``pressio::diag``, ``pressio::span``, ``pressio::subspan``, based on Eigen or Kokkos container + +Notes +----- + +* See the :doc:`ops homepage <../ops>` for a table of booleans to use when checking that ``T1`` and ``T2`` have the correct types. diff --git a/docs/generated_docs/_sources/components/ops/elementwise_multiply.rst.txt b/docs/generated_docs/_sources/components/ops/elementwise_multiply.rst.txt new file mode 100644 index 0000000..7c35179 --- /dev/null +++ b/docs/generated_docs/_sources/components/ops/elementwise_multiply.rst.txt @@ -0,0 +1,48 @@ +.. include:: ../../mydefs.rst + +``elementwise_multiply`` +======================== + +Header: ```` + +API +--- + +.. code-block:: cpp + + namespace pressio { namespace ops{ + + template + void elementwise_multiply( + const alpha_t & alpha, + const T & x, + const T1 & z, + const beta_t & beta, + T2 & y + ); + + }} // end namespace pressio::ops + +Description +----------- + +* Computes ``y = beta * y + alpha * (x ⊙ z)``, where ``⊙`` denotes element-wise multiplication, and stores the result in y + +* ``T``, ``T1``, and ``T2`` must be one-dimensional containers with compatible scalar types: + + * an Eigen vector + + * a Kokkos rank-1 view + + * a Tpetra vector + + * a Tpetra block vector + + * a Epetra vector + + * a pressio expression, i.e. ``pressio::diag``, ``pressio::span``, ``pressio::subspan``, based on Eigen or Kokkos container + +Notes +----- + +* See the :doc:`ops homepage <../ops>` for a table of booleans to use when checking that ``T``, ``T1``, and ``T2`` have the correct types. diff --git a/docs/generated_docs/_sources/components/ops/extent.rst.txt b/docs/generated_docs/_sources/components/ops/extent.rst.txt new file mode 100644 index 0000000..3d65644 --- /dev/null +++ b/docs/generated_docs/_sources/components/ops/extent.rst.txt @@ -0,0 +1,44 @@ +.. include:: ../../mydefs.rst + +``extent`` +========== + +Header: ```` + +API +--- + +.. code-block:: cpp + + namespace pressio { namespace ops{ + + template + std::size_t extent(const T & objectIn, const IndexType i); + + }} // end namespace pressio::ops + +Description +----------- + +* Returns the size or dimension of a container ``objectIn`` along a specified axis ``i`` + +* ``T`` must be one of the following: + + * an Eigen vector or matrix object + + * a Kokkos view + + * a Teuchos vector + + * a Tpetra vector or multi-vector + + * a Tpetra block vector or multi-vector + + * a Epetra vector or multi-vector + + * a pressio expression, i.e. ``pressio::diag``, ``pressio::span``, ``pressio::subspan``, based on an Eigen, Tpetra Block, or Kokkos container + +Notes +----- + +* See the :doc:`ops homepage <../ops>` for a table of booleans to use when checking that ``T`` has the correct type. diff --git a/docs/generated_docs/_sources/components/ops/fill.rst.txt b/docs/generated_docs/_sources/components/ops/fill.rst.txt new file mode 100644 index 0000000..79a17a9 --- /dev/null +++ b/docs/generated_docs/_sources/components/ops/fill.rst.txt @@ -0,0 +1,46 @@ +.. include:: ../../mydefs.rst + +``fill`` +======== + +Header: ```` + +API +--- + +.. code-block:: cpp + + namespace pressio { namespace ops{ + + template + void fill(T & operand, ScalarType const & value); + + }} // end namespace pressio::ops + +Description +----------- + +* Overwrites each element of ``operand`` with ``value``. + +* ``T`` must be: + + * an Eigen vector or matrix object + + * a Kokkos rank-1 or rank-2 view + + * a Teuchos vector + + * a Tpetra vector or multi-vector + + * a Tpetra block vector or multi-vector + + * a Epetra vector or multi-vector + + * a pressio expression, i.e. ``pressio::diag``, ``pressio::span``, ``pressio::subspan``, based on an Eigen or Kokkos container + +* ``ScalarType`` must be convertible to ``pressio::Traits::scalar_type`` + +Notes +----- + +* See the :doc:`ops homepage <../ops>` for a table of booleans to use when checking that ``T1`` and ``T2`` have the correct types. diff --git a/docs/generated_docs/_sources/components/ops/matrix_matrix_product.rst.txt b/docs/generated_docs/_sources/components/ops/matrix_matrix_product.rst.txt new file mode 100644 index 0000000..b300c55 --- /dev/null +++ b/docs/generated_docs/_sources/components/ops/matrix_matrix_product.rst.txt @@ -0,0 +1,88 @@ +.. include:: ../../mydefs.rst + +``matrix-matrix product`` +========================= + +Header: ```` + +API +--- + +.. code-block:: cpp + + namespace pressio { namespace ops{ + + // op(A) = A^T and op(B) = B + template < + class A_type, class B_type, class C_type, + class alpha_t, class beta_t + > + void product(::pressio::transpose /*unused*/, + ::pressio::nontranspose /*unused*/, + const alpha_t & alpha, + const A_type & A, + const B_type & B, + const beta_t & beta, + C_type & C); + + // op(A) = A and op(B) = B + template < + class A_type, class B_type, class C_type, + class alpha_t, class beta_t + > + void product(::pressio::nontranspose /*unused*/, + ::pressio::nontranspose /*unused*/, + const alpha_t & alpha, + const A_type & A, + const B_type & B, + const beta_t & beta, + C_type & C); + + // A == B and op(A) = A^T + template + void product(::pressio::transpose /*unused*/, + ::pressio::nontranspose /*unused*/, + const alpha_t & alpha, + const A_type & A, + const beta_t & beta, + C_type & C); + + // Construct result + template + C_type product(::pressio::transpose modeA, + ::pressio::nontranspose modeB, + const alpha_t & alpha, + const A_type & A); + + }} // end namespace pressio::ops + +Description +----------- + +* Performs matrix-vector multiplication according to ``C = beta * C + alpha * op(A) * op(B)`` + + * ``op(X)`` indicates either ``X`` or ``X^T`` + +* ``alpha_t`` and ``beta_t`` are scalar types + +* ``A_type``, ``B_type``, and ``C_type`` are rank-2 containers + +Types +----- + +The matrix-matrix product works for the following matrix types: + +* Eigen (all containers are rank-2 Eigen matrices) + +* Epetra (``A`` and ``B`` are Epetra multi-vectors; ``C`` is a rank-2 Eigen matrix) + +* Kokkos (all containers are rank-2 Kokkos views) + +* Tpetra (``A`` and ``B`` are Tpetra multi-vectors; ``C`` is either a rank-2 Eigen matrix or a rank-2 Kokkos view) + +* Tpetra Block (``A`` and ``B`` are Tpetra Block multi-vectors; ``C`` is either a rank-2 Eigen matrix or a rank-2 Kokkos view) + +Notes +----- + +* See the :doc:`ops homepage <../ops>` for a table of booleans to use when checking that ``A``, ``B``, and ``C``` have the correct types. diff --git a/docs/generated_docs/_sources/components/ops/matrix_vector_product.rst.txt b/docs/generated_docs/_sources/components/ops/matrix_vector_product.rst.txt new file mode 100644 index 0000000..9e0a639 --- /dev/null +++ b/docs/generated_docs/_sources/components/ops/matrix_vector_product.rst.txt @@ -0,0 +1,112 @@ +.. include:: ../../mydefs.rst + +``matrix-vector product`` +========================= + +Header: ```` + +API +--- + +.. code-block:: cpp + + namespace pressio { namespace ops{ + + // op(A) = A + template < + class A_type, class x_type, class y_type, + class alpha_t, class beta_t + > + void product(::pressio::nontranspose /*unused*/, + const alpha_t & alpha, + const A_type & A, + const x_type & x, + const beta_t & beta, + y_type & y); + + // op(A) = A , construct result + template < + class y_type, class A_type, class x_type, class alpha_t + > + y_type product(::pressio::nontranspose mode, + const alpha_t & alpha, + const A_type & A, + const x_type & x); + + // op(A) = A^T + template < + class y_type, class A_type, class x_type, class alpha_t + > + void product(::pressio::transpose /*unused*/, + const alpha_t & alpha, + const A_type & A, + const x_type & x, + const beta_t & beta, + y_type & y); + + // op(A) = A^T , construct result + template + y_type product(::pressio::transpose mode, + const alpha_t & alpha, + const A_type & A, + const x_type & x); + + }} // end namespace pressio::ops + +Description +----------- + +* Performs matrix-vector multiplication according to ``y = beta * y + alpha * op(A) * x`` + * ``op(A)`` indicates either ``A`` or ``A^T`` + +* ``alpha_t`` and ``beta_t`` are scalar types + +* ``x_type`` and ``y_type`` are rank-1 containers + +* ``A_type`` is a rank-2 container + +* The following combinations of container types are supported for each ``A_type``: + + * Eigen + + * All container types are either Eigen containers or Pressio expressions of Eigen containers, + + * Epetra + + * ``A_type`` is an Epetra rank-2 container + * Either ``x_type`` or ``y_type`` is a rank-1 Epetra container + * The other non-Epetra container is a rank-1 Teuchos or Eigen container + + * Kokkos + + * All container types are either Kokkos views or Pressio expressions of Eigen views + + * Teuchos (does not support constructed results) + + * ``A_type`` is a rank-2 Teuchos container + * ``x_type`` and ``y_type`` are rank-1 Eigen containers + + * Tpetra + + * ``A_type`` is a rank-2 Tpetra container + + * ``x_type`` is a rank-1 Eigen, Kokkos, Teuchos, or Tpetra container + + * ``y_type`` is a rank-1 container. + If ``x_type`` is Tpetra, it may be either a Kokkos or Eigen container (or a Pressio expression of a Kokkos or Eigen container) + Otherwise, ``y_type`` is a Tpetra container or a Pressio column expression + + * Tpetra Block + + * ``A_type`` is a rank-2 Tpetra Block container + + * ``x_type`` is a rank-1 Eigen, Kokkos, Teuchos, or Tpetra Block container + + * ``y_type`` is a rank-1 container. + If ``x_type`` is a Tpetra Block vector, ``y_type`` may be either an Eigen vector or a rank-1 Kokkos view + Otherwise, ``y_type`` is a Tpetra Block vector or column expression + +Notes +----- + +* See the :doc:`ops homepage <../ops>` for a table of booleans to use when checking that ``A_type``, ``x_type``, and ``y_type``` have the correct types. diff --git a/docs/generated_docs/_sources/components/ops/min_max.rst.txt b/docs/generated_docs/_sources/components/ops/min_max.rst.txt new file mode 100644 index 0000000..cf1c715 --- /dev/null +++ b/docs/generated_docs/_sources/components/ops/min_max.rst.txt @@ -0,0 +1,28 @@ +.. include:: ../../mydefs.rst + +``min`` & ``max`` +================= + +Header: ```` + +API +--- + +.. code-block:: cpp + + namespace pressio { namespace ops{ + + template + scalar_type max(const T & obj); + + template + scalar_type min(const T & obj); + + }} // end namespace pressio::ops + +Description +----------- + +* Returns the maximum or minimum value of the given container + +* Works for all container types other than Teuchos arrays diff --git a/docs/generated_docs/_sources/components/ops/norms.rst.txt b/docs/generated_docs/_sources/components/ops/norms.rst.txt new file mode 100644 index 0000000..e94c2ce --- /dev/null +++ b/docs/generated_docs/_sources/components/ops/norms.rst.txt @@ -0,0 +1,42 @@ +.. include:: ../../mydefs.rst + +``norms`` +========= + +Header: ```` + +API +--- + +.. code-block:: cpp + + namespace pressio { namespace ops{ + + // L1 Norm + template + scalar_type norm1(const T & a); + + // L2 Norm + template + scalar_type norm2(const T & a); + + }} // end namespace pressio::ops + +Description +----------- + +* Returns the desired norm of the given container ``a`` + +* L1 norm is given by + +.. math:: + + \| a \|_1 = \sum_{i} |a_i| + +* L2 norm is given by: + +.. math:: + + \|\mathbf{a}\|_2 = \sqrt{\sum_{i=1}^{n} a_i^2} + +* ``a`` must be rank-1 diff --git a/docs/generated_docs/_sources/components/ops/product.rst.txt b/docs/generated_docs/_sources/components/ops/product.rst.txt new file mode 100644 index 0000000..cf94deb --- /dev/null +++ b/docs/generated_docs/_sources/components/ops/product.rst.txt @@ -0,0 +1,112 @@ +.. include:: ../../mydefs.rst + +``product`` +=========== + +Header: ```` + +API +--- + +.. code-block:: cpp + + namespace pressio { namespace ops{ + + // op(A) = A + template < + class A_type, class x_type, class y_type, + class alpha_t, class beta_t + > + void product(::pressio::nontranspose /*unused*/, + const alpha_t & alpha, + const A_type & A, + const x_type & x, + const beta_t & beta, + y_type & y); + + // op(A) = A , construct result + template < + class y_type, class A_type, class x_type, class alpha_t + > + y_type product(::pressio::nontranspose mode, + const alpha_t & alpha, + const A_type & A, + const x_type & x); + + // op(A) = A^T + template < + class y_type, class A_type, class x_type, class alpha_t + > + void product(::pressio::transpose /*unused*/, + const alpha_t & alpha, + const A_type & A, + const x_type & x, + const beta_t & beta, + y_type & y); + + // op(A) = A^T , construct result + template + y_type product(::pressio::transpose mode, + const alpha_t & alpha, + const A_type & A, + const x_type & x); + + }} // end namespace pressio::ops + +Description +----------- + +* Performs matrix-vector multiplication according to ``y = beta * y + alpha * op(A) * x`` + * ``op(A)`` indicates either ``A`` or ``A^T`` + +* ``alpha_t`` and ``beta_t`` are scalar types + +* ``x_type`` and ``y_type`` are rank-1 containers + +* ``A_type`` is a rank-2 container + +* The following combinations of container types are supported for each ``A_type``: + + * Eigen + + * All container types are either Eigen containers or Pressio expressions of Eigen containers, + + * Epetra + + * ``A_type`` is an Epetra rank-2 container + * Either ``x_type`` or ``y_type`` is a rank-1 Epetra container + * The other non-Epetra container is a rank-1 Teuchos or Eigen container + + * Kokkos + + * All container types are either Kokkos views or Pressio expressions of Eigen views + + * Teuchos (does not support constructed results) + + * ``A_type`` is a rank-2 Teuchos container + * ``x_type`` and ``y_type`` are rank-1 Eigen containers + + * Tpetra + + * ``A_type`` is a rank-2 Tpetra container + + * ``x_type`` is a rank-1 Eigen, Kokkos, Teuchos, or Tpetra container + + * ``y_type`` is a rank-1 container. + If ``x_type`` is Tpetra, it may be either a Kokkos or Eigen container (or a Pressio expression of a Kokkos or Eigen container) + Otherwise, ``y_type`` is a Tpetra container or a Pressio column expression + + * Tpetra Block + + * ``A_type`` is a rank-2 Tpetra Block container + + * ``x_type`` is a rank-1 Eigen, Kokkos, Teuchos, or Tpetra Block container + + * ``y_type`` is a rank-1 container. + If ``x_type`` is a Tpetra Block vector, ``y_type`` may be either an Eigen vector or a rank-1 Kokkos view + Otherwise, ``y_type`` is a Tpetra Block vector or column expression + +Notes +----- + +* See the :doc:`ops homepage <../ops>` for a table of booleans to use when checking that ``A_type``, ``x_type``, and ``y_type``` have the correct types. diff --git a/docs/generated_docs/_sources/components/type_traits.rst.txt b/docs/generated_docs/_sources/components/type_traits.rst.txt new file mode 100644 index 0000000..9c29d49 --- /dev/null +++ b/docs/generated_docs/_sources/components/type_traits.rst.txt @@ -0,0 +1,130 @@ +.. role:: raw-html-m2r(raw) + :format: html + +.. include:: ../mydefs.rst + +``type_traits`` +=============== + +Header: ```` + +Public namespace: ``pressio`` + + +Scope +----- + +Provides functionalities for type introspection and detection. +One of the main design features of pressio is that it supports arbitrary +types via generic programming and type introspection, but also +provides special support for some data types commonly used. + + +Traits class +------------ + +\todo: finish + +One of the most important things inside ``type_traits`` is the ``Traits`` class: + +.. code-block:: cpp + + namespace pressio{ + template struct Traits; + } + +To understand the purpose and usage of the traits pattern in C++ there are several resources online. +Quoting Bjarne Stroustrup: "Think of a trait as a small object whose main purpose +is to carry information used by another object or algorithm +to determine "policy" or "implementation details". +Pressio uses specializations of this class to gather *in a uniform way* +compile-time information enabling it to reason about types. +The key point here is that *different TPLs use a variety of naming conventions +for nested typedefs and related things*\ , so there is not easy way to access +similar information from types of various libraries. +This is what motivated us to implement this ``type_traits`` component. +We need a standard, uniform way to query types for compile-time information. +We currently have traits specialized for types of a few TPLs, like Trilinos, Kokkos, Eigen. +An example of one such specialization (in this case for Eigen) is: + +.. code-block:: cpp + + template + struct Traits< + T, std::enable_if_t::value> + > + { + using scalar_type = typename T::Scalar; + static constexpr int rank = 1; + }; + +This ``Traits`` class play a key role when users want to use arbitrary types (i.e. types +which are not known to presso) and to do so, users shoud specialize this class and make +these specialization visibile to pressio to provide information about their generic types. :raw-html-m2r:`
` + +For practical examples of how this class is used, see: + +:red:`finish` + +.. + * `Newton-Raphson solver `_ + * `ode explicit steppers `_ + * `ode implicit steppers `_ + + + +Type detection and identification +--------------------------------- + +We support several metafunctions for detecting +data types commonly used from existing TPLs. +The following list is partial, and more will be added as we continue the development. + +.. list-table:: + :widths: 45 55 + :header-rows: 1 + + * - Name + - Description + * - ``template`` :raw-html-m2r:`
` ``struct is_static_vector_eigen;`` + - Provides static member constant ``value`` equal to ``true`` if ``T`` is a static Eigen vector. :raw-html-m2r:`
` Requires: ``PRESSIO_ENABLE_TPL_EIGEN==On`` + * - ``template`` :raw-html-m2r:`
` ``struct is_dynamic_vector_eigen;`` + - Provides static member constant ``value`` equal to ``true`` if ``T`` is a dynamic Eigen vector. :raw-html-m2r:`
` Requires: ``PRESSIO_ENABLE_TPL_EIGEN==On`` + * - ``template`` :raw-html-m2r:`
` ``struct is_vector_eigen;`` + - Provides static member constant ``value`` equal to ``true`` if ``T`` is a static or dynamic Eigen vector. :raw-html-m2r:`
` Requires: ``PRESSIO_ENABLE_TPL_EIGEN==On`` + * - ``template`` :raw-html-m2r:`
` ``struct is_sparse_matrix_eigen;`` + - Provides static member constant ``value`` equal to ``true`` if ``T`` is a static or dynamic sparse Eigen matrix. :raw-html-m2r:`
` Requires: ``PRESSIO_ENABLE_TPL_EIGEN==On`` + * - ``template`` :raw-html-m2r:`
` ``struct is_static_dense_matrix_eigen;`` + - Provides static member constant ``value`` equal to ``true`` if ``T`` is a static dense Eigen matrix. :raw-html-m2r:`
` Requires: ``PRESSIO_ENABLE_TPL_EIGEN==On`` + * - ``template`` :raw-html-m2r:`
` ``struct is_dynamic_dense_matrix_eigen;`` + - Provides static member constant ``value`` equal to ``true`` if ``T`` is a dynamic dense Eigen matrix. :raw-html-m2r:`
` Requires: ``PRESSIO_ENABLE_TPL_EIGEN==On`` + * - ``template`` :raw-html-m2r:`
` ``struct is_dense_matrix_eigen;`` + - Provides static member constant ``value`` equal to ``true`` if ``T`` is a static or dynamic dense Eigen matrix. :raw-html-m2r:`
` Requires: ``PRESSIO_ENABLE_TPL_EIGEN==On`` + * - ``template`` :raw-html-m2r:`
` ``struct is_dense_vector_teuchos;`` + - Provides static member constant ``value`` equal to ``true`` if ``T`` is a dense Teuchos vector. :raw-html-m2r:`
` Requires: ``PRESSIO_ENABLE_TPL_TRILINOS==On`` + * - ``template`` :raw-html-m2r:`
` ``struct is_dense_matrix_teuchos;`` + - Provides static member constant ``value`` equal to ``true`` if ``T`` is a dense Teuchos matrix. :raw-html-m2r:`
` Requires: ``PRESSIO_ENABLE_TPL_TRILINOS==On`` + * - ``template`` :raw-html-m2r:`
` ``struct is_vector_epetra;`` + - Provides static member constant ``value`` equal to ``true`` if ``T`` is Epetra vector. :raw-html-m2r:`
` Requires: ``PRESSIO_ENABLE_TPL_TRILINOS==On`` + * - ``template`` :raw-html-m2r:`
` ``struct is_multi_vector_epetra;`` + - Provides static member constant ``value`` equal to ``true`` if ``T`` is an Epetra multi vector. :raw-html-m2r:`
` Requires: ``PRESSIO_ENABLE_TPL_TRILINOS==On`` + * - ``template`` :raw-html-m2r:`
` ``struct is_vector_tpetra;`` + - Provides static member constant ``value`` equal to ``true`` if ``T`` is a Tpetra vector. :raw-html-m2r:`
` Requires: ``PRESSIO_ENABLE_TPL_TRILINOS==On`` + * - ``template`` :raw-html-m2r:`
` ``struct is_multi_vector_tpetra;`` + - Provides static member constant ``value`` equal to ``true`` if ``T`` is a Tpetra multi vector. :raw-html-m2r:`
` Requires: ``PRESSIO_ENABLE_TPL_TRILINOS==On`` + * - ``template`` :raw-html-m2r:`
` ``struct is_vector_tpetra_block;`` + - Provides static member constant ``value`` equal to ``true`` if ``T`` is a Tpetra-block vector. :raw-html-m2r:`
` Requires: ``PRESSIO_ENABLE_TPL_TRILINOS==On`` + * - ``template`` :raw-html-m2r:`
` ``struct is_multi_vector_tpetra_block;`` + - Provides static member constant ``value`` equal to ``true`` if ``T`` is a Tpetra-block multi vector. :raw-html-m2r:`
` Requires: ``PRESSIO_ENABLE_TPL_TRILINOS==On`` + * - ``template`` :raw-html-m2r:`
` ``struct is_static_vector_kokkos;`` + - Provides static member constant ``value`` equal to ``true`` if ``T`` is a static Kokkos vector (rank-1 View). :raw-html-m2r:`
` Requires: ``PRESSIO_ENABLE_TPL_KOKKOS==On`` + * - ``template`` :raw-html-m2r:`
` ``struct is_dynamic_vector_kokkos;`` + - Provides static member constant ``value`` equal to ``true`` if ``T`` is a dynamic Kokkos vector (rank-1 View). :raw-html-m2r:`
` Requires: ``PRESSIO_ENABLE_TPL_KOKKOS==On`` + * - ``template`` :raw-html-m2r:`
` ``struct is_vector_kokkos;`` + - Provides static member constant ``value`` equal to ``true`` if ``T`` is a static or dynamic Kokkos vector (rank-1 View). :raw-html-m2r:`
` Requires: ``PRESSIO_ENABLE_TPL_KOKKOS==On`` + * - ``template`` :raw-html-m2r:`
` ``struct is_static_dense_matrix_kokkos;`` + - Provides static member constant ``value`` equal to ``true`` if ``T`` is a static dense Kokkos matrix (rank-2 View). :raw-html-m2r:`
` Requires: ``PRESSIO_ENABLE_TPL_KOKKOS==On`` + * - ``template`` :raw-html-m2r:`
` ``struct is_dynamic_dense_matrix_kokkos;`` + - Provides static member constant ``value`` equal to ``true`` if ``T`` is a dynamic dense Kokkos matrix (rank-2 View). :raw-html-m2r:`
` Requires: ``PRESSIO_ENABLE_TPL_KOKKOS==On`` + * - ``template`` :raw-html-m2r:`
` ``struct is_dense_matrix_kokkos;`` + - Provides static member constant ``value`` equal to ``true`` if ``T`` is a static or dynamic dense Kokkos matrix (rank-2 View). :raw-html-m2r:`
` Requires: ``PRESSIO_ENABLE_TPL_KOKKOS==On`` diff --git a/docs/source/concepts_note.rst b/docs/generated_docs/_sources/concepts_note.rst.txt similarity index 100% rename from docs/source/concepts_note.rst rename to docs/generated_docs/_sources/concepts_note.rst.txt diff --git a/docs/generated_docs/_sources/index.rst.txt b/docs/generated_docs/_sources/index.rst.txt new file mode 100644 index 0000000..b7de9aa --- /dev/null +++ b/docs/generated_docs/_sources/index.rst.txt @@ -0,0 +1,202 @@ +.. role:: raw-html-m2r(raw) + :format: html + +.. include:: mydefs.rst + +pressio-ops C++ library +======================= + +Documentation of the `C++ library `__, one element of the `Pressio ecosystem `_. + +This work was started with a focus on projection-based reduced-order models (ROMs), +which is a strongly **multidisciplinary** topic. +Working towards a production-level ROM capability inevitably means spanning +multiple fields ranging from, e.g., linear algebra, nonlinear solvers +and optimization, to time integration, distributed computing and HPC. +This constitutes a substantial challenge to tackle, whose complexity +increases if aiming to develop a **generic** library. + +To start such a project from the ground up, grow it and then being +able to maintain it, we believe **modularity, abstractions +and well-defined APIs** to be fundamental design principles to rely on. +This has been, and still is, at the core of our development effort, +and has lead to a highly *modular* design of pressio (see table below): +each component (level) of the stack covers a specific capability and depends, +via *well-defined public APIs*, on the ones below it. This has required (and still does) +a considerable development effort, since each component needs "attention" +and can easily be scoped into an independent, full-time project. + +So why doing all this rather than adopting a different, simpler approach, for example, +limiting and hiding as implementation some of the supporting functionalities? +Because we believe the current structure/design offers several major benefits +that would be hard---and in some cases impossible---to obtain otherwise: **flexibility, +extensibility, maintainability, and usability of each component on its own.** +One drawback is that at any point in time, the various components might +have different maturity levels, so reaching a comparable and solid maturity +across the stack might take some time---our current goal is to obtain +in version ``1.0.0`` a uniform maturity level *at least* across +the ``rom, ode and solvers`` components. Please keep this in mind while browsing +the documentation and the code. + +Notably, we have extracted the core operations from the ``Pressio/pressio`` repository +in order to increase modularity and allow users to build their code directly on top of +``pressio-ops`` if desired. + +However, it is still useful to consider ``pressio-ops`` within the context of ``pressio`` +to understand how the repositories fit together. + +The following components are included in ``Pressio/pressio`` and build off of the contents of ``pressio-ops``: + +| + +.. list-table:: + :widths: 10 48 42 + :header-rows: 1 + :align: left + + * - + - Description + - Header(s) + + * - ``rom`` + - concepts :raw-html-m2r:`
` (linear) subspaces :raw-html-m2r:`
` Galerkin: steady :raw-html-m2r:`
` Galerkin: unsteady :raw-html-m2r:`
` LSPG: steady :raw-html-m2r:`
` LSPG: unsteady :raw-html-m2r:`
` :raw-html-m2r:`
` + - ```` :raw-html-m2r:`
` ```` :raw-html-m2r:`
` ```` :raw-html-m2r:`
` ```` :raw-html-m2r:`
` ```` :raw-html-m2r:`
` ```` :raw-html-m2r:`
` ```` :small:`includes all` + + * - ``ode`` + - concepts :raw-html-m2r:`
` explicit steppers :raw-html-m2r:`
` implicit steppers :raw-html-m2r:`
` ``advance_<*>`` fncs :raw-html-m2r:`
` :raw-html-m2r:`
` + - ```` :raw-html-m2r:`
` ```` :raw-html-m2r:`
` ```` :raw-html-m2r:`
` ```` :raw-html-m2r:`
` ```` :small:`includes all` + + * - ``solvers_nonlinear`` + - concepts :raw-html-m2r:`
` Newton method :raw-html-m2r:`
` Gauss-Newton :raw-html-m2r:`
` Lev.-Marq. :raw-html-m2r:`
` :raw-html-m2r:`
` + - ```` :raw-html-m2r:`
` ```` :raw-html-m2r:`
` ```` :raw-html-m2r:`
` ```` :raw-html-m2r:`
` ```` :small:`includes all` + + * - ``solvers_linear`` + - linear dense (on-node) solvers + - ```` + +The following components are included in ``Pressio/pressio-ops`` and can be used independently of the ``Pressio/pressio`` repository: + +| + +.. list-table:: + :widths: 10 48 42 + :header-rows: 1 + :align: left + + * - + - Description + - Header(s) + + * - ``ops`` + - shared-memory/distributed linear algebra kernels specializations + - ```` + + * - ``expressions`` + - expressions templates, e.g.: span, diagonal, subspan + - ```` + + * - ``type_traits`` + - type traits and detection + - ```` + + * - ``utils`` + - logger, constants, etc + - ```` + + * - ``mpl`` + - metaprogramming functionalities + - ```` + + +Get Started +----------- + +* `Install pressio-ops `_: (currently) it is a header-only library, so should be trivial + + +Generic programming and concepts +-------------------------------- + +Arguably the main foundation of pressio-ops is the use of +generic programming--*or, more humbly, we can at least say that it is what we strive for*. +Since the early development stages, we have relied on concept-driven design. +Note, that, if you have used or use C++ templates, you *have* used +concepts knowingly or not. This is because when you write a function or class +template, you have some expectations of what a template needs to expose/do. +C++20 concepts are, in some sense, a way to *explicitly* formalize those expectations. + + +Until we can stably upgrade to C++20, we cannot by default use C++20 concepts, +so we currently guard the concepts in pressio inside a +preprocessor directive ``#ifdef PRESSIO_ENABLE_CXX20``. This can be enabled by +using a C++20 compliant compiler and setting ``-DCMAKE_CXX_STANDARD=20`` at configure time. +The behavior is as follows: + +- if ``PRESSIO_ENABLE_CXX20`` is *enabled*: concepts are compiled and + enforced *stricto sensu* on the pressio APIs as discussed by this documentation + +- if ``PRESSIO_ENABLE_CXX20`` is *disabled*: this is the default case because the + default pressio C++ standard is currently C++14. In this case, the "C++20 concepts" + are not compiled but the constraints they represent are still valid and implemented + differently such that their enforcement is done via a combination of SFINAE and static asserts. + +.. important:: + + Well-defined concepts are hard to design and it takes time. Concepts used in pressio are + still being developed. Some are more mature than others. The approach we adopt is to first + focus on the syntax, then then we will revise them with proper semantics. Keep this in mind + if some concepts seem incomplete. + +.. + Here, the term concept does not necessarily + refer to the C++ concepts feature introduced in C++20. + You can think of it more broadly as "what properties/syntax a type meets, + what you can do with it and, also, what a type should definitely satisfy". + The message we want to convey is that *"concepts" are a fundamental + design part of pressio*. In our documentation, we make the effort to + highlight the use of concepts + by dedicating to each component of the library a full section + to discuss and formalize how concepts are used in that component. + + +License and Citation +-------------------- + +The full license (BSD-3) is available `here `_. + +Sooner or later we will publish this... in the meantime, you can find on arXiv +an (outdated) preprint at: https://arxiv.org/abs/2003.07798 + +Questions? +---------- + +Find us on Slack: https://pressioteam.slack.com or +open an issue on `github `_. + + +.. toctree:: + :maxdepth: 1 + :hidden: + + installation + keywords + +.. toctree:: + :caption: API + :maxdepth: 1 + :hidden: + + ./components/ops + ./components/expressions + ./components/type_traits + ./components/mpl + +.. toctree:: + :caption: Miscellanea + :maxdepth: 1 + :hidden: + + Tutorials + GitHub Repo + Open an issue/feature req. + license diff --git a/docs/generated_docs/_sources/installation.rst.txt b/docs/generated_docs/_sources/installation.rst.txt new file mode 100644 index 0000000..3b637a3 --- /dev/null +++ b/docs/generated_docs/_sources/installation.rst.txt @@ -0,0 +1,142 @@ +.. role:: raw-html-m2r(raw) + :format: html + +Installation and Dependencies +============================= + +.. tip:: + + pressio-ops is header-only, so it does not need to be precompiled and linked to. + However, since we use preprocessor directives to conditionally + enable/disable code based on target third-party libraries, + one needs to account for this. See below for the details. + +.. warning:: + + To use pressio-ops, you need at least a C++17 compiler. + +Dependencies +------------ + +Some parts of ``pressio-ops`` contain code and implementations +that are specific to third-party libraries (TPLs). +An example is ``pressio/ops``\ , which contains kernels specializations +for widely-used HPC libraries (e.g. Trilinos, Kokkos). +The main reason for doing this is that we aim, where possible, +to alleviate the user from writing custom operations and allow ``pressio-ops`` to decide when and how to leverage +the native libraries' operations to obtain the best performance. +This should facilitate the integration and use of ``pressio-ops`` by existing applications. +This is a growing capability and we currently only +provide built-in support to some external HPC libraries (see below). +Obviously, these TPL-specific specializations need to be guarded with +preprecessor directives, and enabled only if one can access the TPLs. + +Enabling/disabling specific dependencies can be done via +the cmake variables `listed here `__. + + +Optional vs Required +^^^^^^^^^^^^^^^^^^^^ + +.. list-table:: + :header-rows: 1 + :widths: 10 50 40 + :align: left + + * - TPL Name + - Optional/Required + - Version Known to Work/run in CI + * - Eigen + - Required + - 3.3.7 + * - Trilinos + - Optional + - commit: ef73d14babf6e7556b0420add98cce257ccaa56b + * - MPI + - Optional + - -- + * - Kokkos + - Optional + - 3.1.0 + * - BLAS + - Optional + - -- + * - LAPACK + - Optional + - -- + * - GoogleTest + - Optional + - 1.10.0 + +Eigen is the only required dependency because it is the +default choice for instantiating the ROM data structures +and solving the (dense) ROM problem. + +In practice, what are the steps to get, install and use Pressio? +---------------------------------------------------------------- + +\todo: add description for using pressio without configuring, +so one has to define the options directly when configuring +their code or inside the code directly. + +1. Clone `pressio-ops `_ (defaults to the main branch), +or you can pick a `release version `_ + +2. Create a build and install subdirectories + +.. code-block:: bash + + cd + mkdir build && mkdir install + +3. Use cmake to configure by passing to the comand line the target list of cmake variables to define. + +For example, suppose we want to enable support for Trilinos and the debug prints. We would do: + +.. code-block:: bash + + export PRESSIO_SRC= + cd /build + + cmake -D CMAKE_INSTALL_PREFIX=../install \ + -D PRESSIO_ENABLE_TPL_TRILINOS=ON \ + -D PRESSIO_ENABLE_DEBUG_PRINT=ON \ + ${PRESSIO_SRC} + + make install # nothing is built, just headers copied to installation + +Note that this step does **not** build anything because ``pressio-ops`` is header-only, +but only processes the cmake arguments and copies the pressio headers to the +install prefix ``/install``. +If you want, inspect the file ``/install/pressio_ops_cmake_config.h`` +which contains the cmake variables configuration. + +We also remark that during the configuration step above pressio-ops +does not need to know where a target TPL exists in your system. +In the configuration step above, you are simply telling Pressio that you have +a certain TPL and want to enable the corresponding code in pressio. +The TPLs will be needed at linking stage when you build *your* code that *uses* pressio. + +4. When building your application to use pressio-ops, you just have to point to +the installation directory ``/install`` with the installed +pressio-ops headers, and you can access all pressio-ops functionalities like so: + +.. code-block:: cpp + + #include "pressio/what_you_need.hpp" + // ... + int main(){ + // do something + } + +.. warning:: + + The procedure above is advised because it enables ``pressio-ops`` + to properly process the cmake options and turn on/off based + on certain conditions (as explained above). + The alternative way to use pressio would be to just clone the repo, + point to the ``/include`` subdirectory + and use cmake variables directly when building your code. + However, this could have unexpected consequences since + you would be resposible to set the variables correctly but you would not + know exactly all the possible constraints. diff --git a/docs/generated_docs/_sources/keywords.rst.txt b/docs/generated_docs/_sources/keywords.rst.txt new file mode 100644 index 0000000..4c062af --- /dev/null +++ b/docs/generated_docs/_sources/keywords.rst.txt @@ -0,0 +1,83 @@ +CMake Keywords +############## + +.. important:: + + All CMake keywords are prefixed with ``PRESSIO_`` which is case-sensitive. + + Recall that to set a keyword in CMake you used the syntax ``-Dkeyword_name``. + + +Third-party Libraries (TPLs) +============================ + +The following options control enabling TPLs: + +.. list-table:: + :widths: 30 60 10 + :header-rows: 1 + :align: left + + * - Variable + - Description + - Default + + * - ``PRESSIO_ENABLE_TPL_EIGEN`` + - self-explanatory + - ``ON`` + + * - ``PRESSIO_ENABLE_TPL_TRILINOS`` + - self-explanatory + - ``OFF`` + + * - ``PRESSIO_ENABLE_TPL_MPI`` + - self-explanatory + - ``OFF`` automatically ``ON`` if ``PRESSIO_ENABLE_TPL_TRILINOS=ON`` + + * - ``PRESSIO_ENABLE_TPL_KOKKOS`` + - self-explanatory + - ``OFF``\ ; automatically ``ON`` if ``PRESSIO_ENABLE_TPL_TRILINOS=ON`` + + * - ``PRESSIO_ENABLE_TEUCHOS_TIMERS`` + - self-explanatory + - ``OFF`` automatically ``ON`` if ``PRESSIO_ENABLE_TPL_TRILINOS=ON`` + + +Obviously, the choice of which TPLs to enable is related to +your application's dependency requirements. +For example, if you have an application that relies on +Trilinos data structures and want to use ``pressio``\ , +then it makes sense to enable the Trilinos dependency. +On the contrary, if you have an application that relies only on +Eigen data structures, then it makes sense to only leave only Eigen on +and disable the rest. + +Also, we note that some of the cmake variables listed above are connected +and cannot be turned on individualy. +For example, if we enable Trilinos then ``pressio`` automatically +enables also Kokkos, BLAS, LAPACK and MPI. + + +Other Options +============= + +.. list-table:: + :widths: 30 60 10 + :header-rows: 1 + :align: left + + * - Variable + - Description + - Default + + * - ``PRESSIO_ENABLE_DEBUG_PRINT`` + - to enable debugging print statements + - ``OFF`` + + * - ``PRESSIO_ENABLE_CXX17`` + - enables C++17 standard + - ``ON`` since min standard is 17 + + * - ``PRESSIO_ENABLE_CXX20`` + - enables C++20 standard + - ``OFF``; turned on if ``CMAKE_CXX_STANDARD`` is set to 20 diff --git a/docs/generated_docs/_sources/license.rst.txt b/docs/generated_docs/_sources/license.rst.txt new file mode 100644 index 0000000..881ae5b --- /dev/null +++ b/docs/generated_docs/_sources/license.rst.txt @@ -0,0 +1,51 @@ +License +======= + +.. highlight:: none + +:: + + //@HEADER + // ************************************************************************ + // + // Pressio + // Copyright 2019 National Technology & Engineering Solutions of Sandia,LLC + // (NTESS) + // + // Under the terms of Contract DE-NA0003525 with NTESS, the + // U.S. Government retains certain rights in this software. + // + // Pressio is licensed under BSD-3-Clause terms of use: + // + // Redistribution and use in source and binary forms, with or without + // modification, are permitted provided that the following conditions + // are met: + // + // 1. Redistributions of source code must retain the above copyright + // notice, this list of conditions and the following disclaimer. + // + // 2. Redistributions in binary form must reproduce the above copyright + // notice, this list of conditions and the following disclaimer in the + // documentation and/or other materials provided with the distribution. + // + // 3. Neither the name of the copyright holder nor the names of its + // contributors may be used to endorse or promote products derived + // from this software without specific prior written permission. + // + // THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS + // "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT + // LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS + // FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE + // COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, + // INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES + // (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR + // SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) + // HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, + // STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING + // IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE + // POSSIBILITY OF SUCH DAMAGE. + // + // Questions? Contact Francesco Rizzi (fnrizzi@sandia.gov) + // + // ************************************************************************ + //@HEADER diff --git a/docs/generated_docs/_sources/mydefs.rst.txt b/docs/generated_docs/_sources/mydefs.rst.txt new file mode 100644 index 0000000..43eccbf --- /dev/null +++ b/docs/generated_docs/_sources/mydefs.rst.txt @@ -0,0 +1,50 @@ +.. Color profiles for Sphinx. +.. Has to be used with hacks.css +.. (https://bitbucket.org/lbesson/web-sphinx/src/master/.static/hacks.css) + +.. role:: black +.. role:: gray +.. role:: grey +.. role:: silver +.. role:: white +.. role:: maroon +.. role:: red +.. role:: magenta +.. role:: fuchsia +.. role:: pink +.. role:: orange +.. role:: yellow +.. role:: lime +.. role:: green +.. role:: olive +.. role:: teal +.. role:: cyan +.. role:: aqua +.. role:: blue +.. role:: navy +.. role:: purple + +.. role:: under +.. role:: over +.. role:: blink +.. role:: line +.. role:: strike + +.. role:: it +.. role:: ob + +.. role:: small +.. role:: medium +.. role:: large + +.. role:: packnameindexpage +.. role:: summarylineindexpage + +.. role:: center +.. role:: left +.. role:: right + +.. role:: memberfunction + + +.. Adapted from (c) Lilian Besson, 2011-2016, https://bitbucket.org/lbesson/web-sphinx/ diff --git a/docs/generated_docs/_static/_sphinx_javascript_frameworks_compat.js b/docs/generated_docs/_static/_sphinx_javascript_frameworks_compat.js new file mode 100644 index 0000000..8549469 --- /dev/null +++ b/docs/generated_docs/_static/_sphinx_javascript_frameworks_compat.js @@ -0,0 +1,134 @@ +/* + * _sphinx_javascript_frameworks_compat.js + * ~~~~~~~~~~ + * + * Compatability shim for jQuery and underscores.js. + * + * WILL BE REMOVED IN Sphinx 6.0 + * xref RemovedInSphinx60Warning + * + */ + +/** + * select a different prefix for underscore + */ +$u = _.noConflict(); + + +/** + * small helper function to urldecode strings + * + * See https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/decodeURIComponent#Decoding_query_parameters_from_a_URL + */ +jQuery.urldecode = function(x) { + if (!x) { + return x + } + return decodeURIComponent(x.replace(/\+/g, ' ')); +}; + +/** + * small helper function to urlencode strings + */ +jQuery.urlencode = encodeURIComponent; + +/** + * This function returns the parsed url parameters of the + * current request. Multiple values per key are supported, + * it will always return arrays of strings for the value parts. + */ +jQuery.getQueryParameters = function(s) { + if (typeof s === 'undefined') + s = document.location.search; + var parts = s.substr(s.indexOf('?') + 1).split('&'); + var result = {}; + for (var i = 0; i < parts.length; i++) { + var tmp = parts[i].split('=', 2); + var key = jQuery.urldecode(tmp[0]); + var value = jQuery.urldecode(tmp[1]); + if (key in result) + result[key].push(value); + else + result[key] = [value]; + } + return result; +}; + +/** + * highlight a given string on a jquery object by wrapping it in + * span elements with the given class name. + */ +jQuery.fn.highlightText = function(text, className) { + function highlight(node, addItems) { + if (node.nodeType === 3) { + var val = node.nodeValue; + var pos = val.toLowerCase().indexOf(text); + if (pos >= 0 && + !jQuery(node.parentNode).hasClass(className) && + !jQuery(node.parentNode).hasClass("nohighlight")) { + var span; + var isInSVG = jQuery(node).closest("body, svg, foreignObject").is("svg"); + if (isInSVG) { + span = document.createElementNS("http://www.w3.org/2000/svg", "tspan"); + } else { + span = document.createElement("span"); + span.className = className; + } + span.appendChild(document.createTextNode(val.substr(pos, text.length))); + node.parentNode.insertBefore(span, node.parentNode.insertBefore( + document.createTextNode(val.substr(pos + text.length)), + node.nextSibling)); + node.nodeValue = val.substr(0, pos); + if (isInSVG) { + var rect = document.createElementNS("http://www.w3.org/2000/svg", "rect"); + var bbox = node.parentElement.getBBox(); + rect.x.baseVal.value = bbox.x; + rect.y.baseVal.value = bbox.y; + rect.width.baseVal.value = bbox.width; + rect.height.baseVal.value = bbox.height; + rect.setAttribute('class', className); + addItems.push({ + "parent": node.parentNode, + "target": rect}); + } + } + } + else if (!jQuery(node).is("button, select, textarea")) { + jQuery.each(node.childNodes, function() { + highlight(this, addItems); + }); + } + } + var addItems = []; + var result = this.each(function() { + highlight(this, addItems); + }); + for (var i = 0; i < addItems.length; ++i) { + jQuery(addItems[i].parent).before(addItems[i].target); + } + return result; +}; + +/* + * backward compatibility for jQuery.browser + * This will be supported until firefox bug is fixed. + */ +if (!jQuery.browser) { + jQuery.uaMatch = function(ua) { + ua = ua.toLowerCase(); + + var match = /(chrome)[ \/]([\w.]+)/.exec(ua) || + /(webkit)[ \/]([\w.]+)/.exec(ua) || + /(opera)(?:.*version|)[ \/]([\w.]+)/.exec(ua) || + /(msie) ([\w.]+)/.exec(ua) || + ua.indexOf("compatible") < 0 && /(mozilla)(?:.*? rv:([\w.]+)|)/.exec(ua) || + []; + + return { + browser: match[ 1 ] || "", + version: match[ 2 ] || "0" + }; + }; + jQuery.browser = {}; + jQuery.browser[jQuery.uaMatch(navigator.userAgent).browser] = true; +} diff --git a/docs/generated_docs/_static/basic.css b/docs/generated_docs/_static/basic.css new file mode 100644 index 0000000..9039e02 --- /dev/null +++ b/docs/generated_docs/_static/basic.css @@ -0,0 +1,932 @@ +/* + * basic.css + * ~~~~~~~~~ + * + * Sphinx stylesheet -- basic theme. + * + * :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS. + * :license: BSD, see LICENSE for details. + * + */ + +/* -- main layout ----------------------------------------------------------- */ + +div.clearer { + clear: both; +} + +div.section::after { + display: block; + content: ''; + clear: left; +} + +/* -- relbar ---------------------------------------------------------------- */ + +div.related { + width: 100%; + font-size: 90%; +} + +div.related h3 { + display: none; +} + +div.related ul { + margin: 0; + padding: 0 0 0 10px; + list-style: none; +} + +div.related li { + display: inline; +} + +div.related li.right { + float: right; + margin-right: 5px; +} + +/* -- sidebar --------------------------------------------------------------- */ + +div.sphinxsidebarwrapper { + padding: 10px 5px 0 10px; +} + +div.sphinxsidebar { + float: left; + width: 230px; + margin-left: -100%; + font-size: 90%; + word-wrap: break-word; + overflow-wrap : break-word; +} + +div.sphinxsidebar ul { + list-style: none; +} + +div.sphinxsidebar ul ul, +div.sphinxsidebar ul.want-points { + margin-left: 20px; + list-style: square; +} + +div.sphinxsidebar ul ul { + margin-top: 0; + margin-bottom: 0; +} + +div.sphinxsidebar form { + margin-top: 10px; +} + +div.sphinxsidebar input { + border: 1px solid #98dbcc; + font-family: sans-serif; + font-size: 1em; +} + +div.sphinxsidebar #searchbox form.search { + overflow: hidden; +} + +div.sphinxsidebar #searchbox input[type="text"] { + float: left; + width: 80%; + padding: 0.25em; + box-sizing: border-box; +} + +div.sphinxsidebar #searchbox input[type="submit"] { + float: left; + width: 20%; + border-left: none; + padding: 0.25em; + box-sizing: border-box; +} + + +img { + border: 0; + max-width: 100%; +} + +/* -- search page ----------------------------------------------------------- */ + +ul.search { + margin: 10px 0 0 20px; + padding: 0; +} + +ul.search li { + padding: 5px 0 5px 20px; + background-image: url(file.png); + background-repeat: no-repeat; + background-position: 0 7px; +} + +ul.search li a { + font-weight: bold; +} + +ul.search li p.context { + color: #888; + margin: 2px 0 0 30px; + text-align: left; +} + +ul.keywordmatches li.goodmatch a { + font-weight: bold; +} + +/* -- index page ------------------------------------------------------------ */ + +table.contentstable { + width: 90%; + margin-left: auto; + margin-right: auto; +} + +table.contentstable p.biglink { + line-height: 150%; +} + +a.biglink { + font-size: 1.3em; +} + +span.linkdescr { + font-style: italic; + padding-top: 5px; + font-size: 90%; +} + +/* -- general index --------------------------------------------------------- */ + +table.indextable { + width: 100%; +} + +table.indextable td { + text-align: left; + vertical-align: top; +} + +table.indextable ul { + margin-top: 0; + margin-bottom: 0; + list-style-type: none; +} + +table.indextable > tbody > tr > td > ul { + padding-left: 0em; +} + +table.indextable tr.pcap { + height: 10px; +} + +table.indextable tr.cap { + margin-top: 10px; + background-color: #f2f2f2; +} + +img.toggler { + margin-right: 3px; + margin-top: 3px; + cursor: pointer; +} + +div.modindex-jumpbox { + border-top: 1px solid #ddd; + border-bottom: 1px solid #ddd; + margin: 1em 0 1em 0; + padding: 0.4em; +} + +div.genindex-jumpbox { + border-top: 1px solid #ddd; + border-bottom: 1px solid #ddd; + margin: 1em 0 1em 0; + padding: 0.4em; +} + +/* -- domain module index --------------------------------------------------- */ + +table.modindextable td { + padding: 2px; + border-collapse: collapse; +} + +/* -- general body styles --------------------------------------------------- */ + +div.body { + min-width: 360px; + max-width: 800px; +} + +div.body p, div.body dd, div.body li, div.body blockquote { + -moz-hyphens: auto; + -ms-hyphens: auto; + -webkit-hyphens: auto; + hyphens: auto; +} + +a.headerlink { + visibility: hidden; +} + +a.brackets:before, +span.brackets > a:before{ + content: "["; +} + +a.brackets:after, +span.brackets > a:after { + content: "]"; +} + +h1:hover > a.headerlink, +h2:hover > a.headerlink, +h3:hover > a.headerlink, +h4:hover > a.headerlink, +h5:hover > a.headerlink, +h6:hover > a.headerlink, +dt:hover > a.headerlink, +caption:hover > a.headerlink, +p.caption:hover > a.headerlink, +div.code-block-caption:hover > a.headerlink { + visibility: visible; +} + +div.body p.caption { + text-align: inherit; +} + +div.body td { + text-align: left; +} + +.first { + margin-top: 0 !important; +} + +p.rubric { + margin-top: 30px; + font-weight: bold; +} + +img.align-left, figure.align-left, .figure.align-left, object.align-left { + clear: left; + float: left; + margin-right: 1em; +} + +img.align-right, figure.align-right, .figure.align-right, object.align-right { + clear: right; + float: right; + margin-left: 1em; +} + +img.align-center, figure.align-center, .figure.align-center, object.align-center { + display: block; + margin-left: auto; + margin-right: auto; +} + +img.align-default, figure.align-default, .figure.align-default { + display: block; + margin-left: auto; + margin-right: auto; +} + +.align-left { + text-align: left; +} + +.align-center { + text-align: center; +} + +.align-default { + text-align: center; +} + +.align-right { + text-align: right; +} + +/* -- sidebars -------------------------------------------------------------- */ + +div.sidebar, +aside.sidebar { + margin: 0 0 0.5em 1em; + border: 1px solid #ddb; + padding: 7px; + background-color: #ffe; + width: 40%; + float: right; + clear: right; + overflow-x: auto; +} + +p.sidebar-title { + font-weight: bold; +} + +div.admonition, div.topic, aside.topic, blockquote { + clear: left; +} + +/* -- topics ---------------------------------------------------------------- */ + +div.topic, aside.topic { + border: 1px solid #ccc; + padding: 7px; + margin: 10px 0 10px 0; +} + +p.topic-title { + font-size: 1.1em; + font-weight: bold; + margin-top: 10px; +} + +/* -- admonitions ----------------------------------------------------------- */ + +div.admonition { + margin-top: 10px; + margin-bottom: 10px; + padding: 7px; +} + +div.admonition dt { + font-weight: bold; +} + +p.admonition-title { + margin: 0px 10px 5px 0px; + font-weight: bold; +} + +div.body p.centered { + text-align: center; + margin-top: 25px; +} + +/* -- content of sidebars/topics/admonitions -------------------------------- */ + +div.sidebar > :last-child, +aside.sidebar > :last-child, +div.topic > :last-child, +aside.topic > :last-child, +div.admonition > :last-child { + margin-bottom: 0; +} + +div.sidebar::after, +aside.sidebar::after, +div.topic::after, +aside.topic::after, +div.admonition::after, +blockquote::after { + display: block; + content: ''; + clear: both; +} + +/* -- tables ---------------------------------------------------------------- */ + +table.docutils { + margin-top: 10px; + margin-bottom: 10px; + border: 0; + border-collapse: collapse; +} + +table.align-center { + margin-left: auto; + margin-right: auto; +} + +table.align-default { + margin-left: auto; + margin-right: auto; +} + +table caption span.caption-number { + font-style: italic; +} + +table caption span.caption-text { +} + +table.docutils td, table.docutils th { + padding: 1px 8px 1px 5px; + border-top: 0; + border-left: 0; + border-right: 0; + border-bottom: 1px solid #aaa; +} + +th { + text-align: left; + padding-right: 5px; +} + +table.citation { + border-left: solid 1px gray; + margin-left: 1px; +} + +table.citation td { + border-bottom: none; +} + +th > :first-child, +td > :first-child { + margin-top: 0px; +} + +th > :last-child, +td > :last-child { + margin-bottom: 0px; +} + +/* -- figures --------------------------------------------------------------- */ + +div.figure, figure { + margin: 0.5em; + padding: 0.5em; +} + +div.figure p.caption, figcaption { + padding: 0.3em; +} + +div.figure p.caption span.caption-number, +figcaption span.caption-number { + font-style: italic; +} + +div.figure p.caption span.caption-text, +figcaption span.caption-text { +} + +/* -- field list styles ----------------------------------------------------- */ + +table.field-list td, table.field-list th { + border: 0 !important; +} + +.field-list ul { + margin: 0; + padding-left: 1em; +} + +.field-list p { + margin: 0; +} + +.field-name { + -moz-hyphens: manual; + -ms-hyphens: manual; + -webkit-hyphens: manual; + hyphens: manual; +} + +/* -- hlist styles ---------------------------------------------------------- */ + +table.hlist { + margin: 1em 0; +} + +table.hlist td { + vertical-align: top; +} + +/* -- object description styles --------------------------------------------- */ + +.sig { + font-family: 'Consolas', 'Menlo', 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', monospace; +} + +.sig-name, code.descname { + background-color: transparent; + font-weight: bold; +} + +.sig-name { + font-size: 1.1em; +} + +code.descname { + font-size: 1.2em; +} + +.sig-prename, code.descclassname { + background-color: transparent; +} + +.optional { + font-size: 1.3em; +} + +.sig-paren { + font-size: larger; +} + +.sig-param.n { + font-style: italic; +} + +/* C++ specific styling */ + +.sig-inline.c-texpr, +.sig-inline.cpp-texpr { + font-family: unset; +} + +.sig.c .k, .sig.c .kt, +.sig.cpp .k, .sig.cpp .kt { + color: #0033B3; +} + +.sig.c .m, +.sig.cpp .m { + color: #1750EB; +} + +.sig.c .s, .sig.c .sc, +.sig.cpp .s, .sig.cpp .sc { + color: #067D17; +} + + +/* -- other body styles ----------------------------------------------------- */ + +ol.arabic { + list-style: decimal; +} + +ol.loweralpha { + list-style: lower-alpha; +} + +ol.upperalpha { + list-style: upper-alpha; +} + +ol.lowerroman { + list-style: lower-roman; +} + +ol.upperroman { + list-style: upper-roman; +} + +:not(li) > ol > li:first-child > :first-child, +:not(li) > ul > li:first-child > :first-child { + margin-top: 0px; +} + +:not(li) > ol > li:last-child > :last-child, +:not(li) > ul > li:last-child > :last-child { + margin-bottom: 0px; +} + +ol.simple ol p, +ol.simple ul p, +ul.simple ol p, +ul.simple ul p { + margin-top: 0; +} + +ol.simple > li:not(:first-child) > p, +ul.simple > li:not(:first-child) > p { + margin-top: 0; +} + +ol.simple p, +ul.simple p { + margin-bottom: 0; +} + +/* Docutils 0.17 and older (footnotes & citations) */ +dl.footnote > dt, +dl.citation > dt { + float: left; + margin-right: 0.5em; +} + +dl.footnote > dd, +dl.citation > dd { + margin-bottom: 0em; +} + +dl.footnote > dd:after, +dl.citation > dd:after { + content: ""; + clear: both; +} + +/* Docutils 0.18+ (footnotes & citations) */ +aside.footnote > span, +div.citation > span { + float: left; +} +aside.footnote > span:last-of-type, +div.citation > span:last-of-type { + padding-right: 0.5em; +} +aside.footnote > p { + margin-left: 2em; +} +div.citation > p { + margin-left: 4em; +} +aside.footnote > p:last-of-type, +div.citation > p:last-of-type { + margin-bottom: 0em; +} +aside.footnote > p:last-of-type:after, +div.citation > p:last-of-type:after { + content: ""; + clear: both; +} + +/* Footnotes & citations ends */ + +dl.field-list { + display: grid; + grid-template-columns: fit-content(30%) auto; +} + +dl.field-list > dt { + font-weight: bold; + word-break: break-word; + padding-left: 0.5em; + padding-right: 5px; +} + +dl.field-list > dt:after { + content: ":"; +} + +dl.field-list > dd { + padding-left: 0.5em; + margin-top: 0em; + margin-left: 0em; + margin-bottom: 0em; +} + +dl { + margin-bottom: 15px; +} + +dd > :first-child { + margin-top: 0px; +} + +dd ul, dd table { + margin-bottom: 10px; +} + +dd { + margin-top: 3px; + margin-bottom: 10px; + margin-left: 30px; +} + +dl > dd:last-child, +dl > dd:last-child > :last-child { + margin-bottom: 0; +} + +dt:target, span.highlighted { + background-color: #fbe54e; +} + +rect.highlighted { + fill: #fbe54e; +} + +dl.glossary dt { + font-weight: bold; + font-size: 1.1em; +} + +.versionmodified { + font-style: italic; +} + +.system-message { + background-color: #fda; + padding: 5px; + border: 3px solid red; +} + +.footnote:target { + background-color: #ffa; +} + +.line-block { + display: block; + margin-top: 1em; + margin-bottom: 1em; +} + +.line-block .line-block { + margin-top: 0; + margin-bottom: 0; + margin-left: 1.5em; +} + +.guilabel, .menuselection { + font-family: sans-serif; +} + +.accelerator { + text-decoration: underline; +} + +.classifier { + font-style: oblique; +} + +.classifier:before { + font-style: normal; + margin: 0 0.5em; + content: ":"; + display: inline-block; +} + +abbr, acronym { + border-bottom: dotted 1px; + cursor: help; +} + +/* -- code displays --------------------------------------------------------- */ + +pre { + overflow: auto; + overflow-y: hidden; /* fixes display issues on Chrome browsers */ +} + +pre, div[class*="highlight-"] { + clear: both; +} + +span.pre { + -moz-hyphens: none; + -ms-hyphens: none; + -webkit-hyphens: none; + hyphens: none; + white-space: nowrap; +} + +div[class*="highlight-"] { + margin: 1em 0; +} + +td.linenos pre { + border: 0; + background-color: transparent; + color: #aaa; +} + +table.highlighttable { + display: block; +} + +table.highlighttable tbody { + display: block; +} + +table.highlighttable tr { + display: flex; +} + +table.highlighttable td { + margin: 0; + padding: 0; +} + +table.highlighttable td.linenos { + padding-right: 0.5em; +} + +table.highlighttable td.code { + flex: 1; + overflow: hidden; +} + +.highlight .hll { + display: block; +} + +div.highlight pre, +table.highlighttable pre { + margin: 0; +} + +div.code-block-caption + div { + margin-top: 0; +} + +div.code-block-caption { + margin-top: 1em; + padding: 2px 5px; + font-size: small; +} + +div.code-block-caption code { + background-color: transparent; +} + +table.highlighttable td.linenos, +span.linenos, +div.highlight span.gp { /* gp: Generic.Prompt */ + user-select: none; + -webkit-user-select: text; /* Safari fallback only */ + -webkit-user-select: none; /* Chrome/Safari */ + -moz-user-select: none; /* Firefox */ + -ms-user-select: none; /* IE10+ */ +} + +div.code-block-caption span.caption-number { + padding: 0.1em 0.3em; + font-style: italic; +} + +div.code-block-caption span.caption-text { +} + +div.literal-block-wrapper { + margin: 1em 0; +} + +code.xref, a code { + background-color: transparent; + font-weight: bold; +} + +h1 code, h2 code, h3 code, h4 code, h5 code, h6 code { + background-color: transparent; +} + +.viewcode-link { + float: right; +} + +.viewcode-back { + float: right; + font-family: sans-serif; +} + +div.viewcode-block:target { + margin: -1px -10px; + padding: 0 10px; +} + +/* -- math display ---------------------------------------------------------- */ + +img.math { + vertical-align: middle; +} + +div.body div.math p { + text-align: center; +} + +span.eqno { + float: right; +} + +span.eqno a.headerlink { + position: absolute; + z-index: 1; +} + +div.math:hover a.headerlink { + visibility: visible; +} + +/* -- printout stylesheet --------------------------------------------------- */ + +@media print { + div.document, + div.documentwrapper, + div.bodywrapper { + margin: 0 !important; + width: 100%; + } + + div.sphinxsidebar, + div.related, + div.footer, + #top-link { + display: none; + } +} \ No newline at end of file diff --git a/docs/generated_docs/_static/check-solid.svg b/docs/generated_docs/_static/check-solid.svg new file mode 100644 index 0000000..92fad4b --- /dev/null +++ b/docs/generated_docs/_static/check-solid.svg @@ -0,0 +1,4 @@ + + + + diff --git a/docs/generated_docs/_static/clipboard.min.js b/docs/generated_docs/_static/clipboard.min.js new file mode 100644 index 0000000..54b3c46 --- /dev/null +++ b/docs/generated_docs/_static/clipboard.min.js @@ -0,0 +1,7 @@ +/*! + * clipboard.js v2.0.8 + * https://clipboardjs.com/ + * + * Licensed MIT © Zeno Rocha + */ +!function(t,e){"object"==typeof exports&&"object"==typeof module?module.exports=e():"function"==typeof define&&define.amd?define([],e):"object"==typeof exports?exports.ClipboardJS=e():t.ClipboardJS=e()}(this,function(){return n={686:function(t,e,n){"use strict";n.d(e,{default:function(){return o}});var e=n(279),i=n.n(e),e=n(370),u=n.n(e),e=n(817),c=n.n(e);function a(t){try{return document.execCommand(t)}catch(t){return}}var f=function(t){t=c()(t);return a("cut"),t};var l=function(t){var e,n,o,r=1 + + + + diff --git a/docs/generated_docs/_static/copybutton.css b/docs/generated_docs/_static/copybutton.css new file mode 100644 index 0000000..40eafe5 --- /dev/null +++ b/docs/generated_docs/_static/copybutton.css @@ -0,0 +1,93 @@ +/* Copy buttons */ +button.copybtn { + position: absolute; + display: flex; + top: .3em; + right: .3em; + width: 1.7em; + height: 1.7em; + opacity: 0; + transition: opacity 0.3s, border .3s, background-color .3s; + user-select: none; + padding: 0; + border: none; + outline: none; + border-radius: 0.4em; + /* The colors that GitHub uses */ + border: #1b1f2426 1px solid; + background-color: #f6f8fa; + color: #57606a; +} + +button.copybtn.success { + border-color: #22863a; + color: #22863a; +} + +button.copybtn svg { + stroke: currentColor; + width: 1.5em; + height: 1.5em; + padding: 0.1em; +} + +div.highlight { + position: relative; +} + +.highlight:hover button.copybtn { + opacity: 1; +} + +.highlight button.copybtn:hover { + background-color: rgb(235, 235, 235); +} + +.highlight button.copybtn:active { + background-color: rgb(187, 187, 187); +} + +/** + * A minimal CSS-only tooltip copied from: + * https://codepen.io/mildrenben/pen/rVBrpK + * + * To use, write HTML like the following: + * + *

Short

+ */ + .o-tooltip--left { + position: relative; + } + + .o-tooltip--left:after { + opacity: 0; + visibility: hidden; + position: absolute; + content: attr(data-tooltip); + padding: .2em; + font-size: .8em; + left: -.2em; + background: grey; + color: white; + white-space: nowrap; + z-index: 2; + border-radius: 2px; + transform: translateX(-102%) translateY(0); + transition: opacity 0.2s cubic-bezier(0.64, 0.09, 0.08, 1), transform 0.2s cubic-bezier(0.64, 0.09, 0.08, 1); +} + +.o-tooltip--left:hover:after { + display: block; + opacity: 1; + visibility: visible; + transform: translateX(-100%) translateY(0); + transition: opacity 0.2s cubic-bezier(0.64, 0.09, 0.08, 1), transform 0.2s cubic-bezier(0.64, 0.09, 0.08, 1); + transition-delay: .5s; +} + +/* By default the copy button shouldn't show up when printing a page */ +@media print { + button.copybtn { + display: none; + } +} diff --git a/docs/generated_docs/_static/copybutton.js b/docs/generated_docs/_static/copybutton.js new file mode 100644 index 0000000..40ac331 --- /dev/null +++ b/docs/generated_docs/_static/copybutton.js @@ -0,0 +1,220 @@ +// Localization support +const messages = { + 'en': { + 'copy': 'Copy', + 'copy_to_clipboard': 'Copy to clipboard', + 'copy_success': 'Copied!', + 'copy_failure': 'Failed to copy', + }, + 'es' : { + 'copy': 'Copiar', + 'copy_to_clipboard': 'Copiar al portapapeles', + 'copy_success': '¡Copiado!', + 'copy_failure': 'Error al copiar', + }, + 'de' : { + 'copy': 'Kopieren', + 'copy_to_clipboard': 'In die Zwischenablage kopieren', + 'copy_success': 'Kopiert!', + 'copy_failure': 'Fehler beim Kopieren', + }, + 'fr' : { + 'copy': 'Copier', + 'copy_to_clipboard': 'Copié dans le presse-papier', + 'copy_success': 'Copié !', + 'copy_failure': 'Échec de la copie', + }, + 'ru': { + 'copy': 'Скопировать', + 'copy_to_clipboard': 'Скопировать в буфер', + 'copy_success': 'Скопировано!', + 'copy_failure': 'Не удалось скопировать', + }, + 'zh-CN': { + 'copy': '复制', + 'copy_to_clipboard': '复制到剪贴板', + 'copy_success': '复制成功!', + 'copy_failure': '复制失败', + }, + 'it' : { + 'copy': 'Copiare', + 'copy_to_clipboard': 'Copiato negli appunti', + 'copy_success': 'Copiato!', + 'copy_failure': 'Errore durante la copia', + } +} + +let locale = 'en' +if( document.documentElement.lang !== undefined + && messages[document.documentElement.lang] !== undefined ) { + locale = document.documentElement.lang +} + +let doc_url_root = DOCUMENTATION_OPTIONS.URL_ROOT; +if (doc_url_root == '#') { + doc_url_root = ''; +} + +/** + * SVG files for our copy buttons + */ +let iconCheck = ` + ${messages[locale]['copy_success']} + + +` + +// If the user specified their own SVG use that, otherwise use the default +let iconCopy = ``; +if (!iconCopy) { + iconCopy = ` + ${messages[locale]['copy_to_clipboard']} + + + +` +} + +/** + * Set up copy/paste for code blocks + */ + +const runWhenDOMLoaded = cb => { + if (document.readyState != 'loading') { + cb() + } else if (document.addEventListener) { + document.addEventListener('DOMContentLoaded', cb) + } else { + document.attachEvent('onreadystatechange', function() { + if (document.readyState == 'complete') cb() + }) + } +} + +const codeCellId = index => `codecell${index}` + +// Clears selected text since ClipboardJS will select the text when copying +const clearSelection = () => { + if (window.getSelection) { + window.getSelection().removeAllRanges() + } else if (document.selection) { + document.selection.empty() + } +} + +// Changes tooltip text for two seconds, then changes it back +const temporarilyChangeTooltip = (el, oldText, newText) => { + el.setAttribute('data-tooltip', newText) + el.classList.add('success') + setTimeout(() => el.setAttribute('data-tooltip', oldText), 2000) + setTimeout(() => el.classList.remove('success'), 2000) +} + +// Changes the copy button icon for two seconds, then changes it back +const temporarilyChangeIcon = (el) => { + el.innerHTML = iconCheck; + setTimeout(() => {el.innerHTML = iconCopy}, 2000) +} + +const addCopyButtonToCodeCells = () => { + // If ClipboardJS hasn't loaded, wait a bit and try again. This + // happens because we load ClipboardJS asynchronously. + if (window.ClipboardJS === undefined) { + setTimeout(addCopyButtonToCodeCells, 250) + return + } + + // Add copybuttons to all of our code cells + const codeCells = document.querySelectorAll('div.highlight pre') + codeCells.forEach((codeCell, index) => { + const id = codeCellId(index) + codeCell.setAttribute('id', id) + + const clipboardButton = id => + `` + codeCell.insertAdjacentHTML('afterend', clipboardButton(id)) + }) + +function escapeRegExp(string) { + return string.replace(/[.*+?^${}()|[\]\\]/g, '\\$&'); // $& means the whole matched string +} + +// Callback when a copy button is clicked. Will be passed the node that was clicked +// should then grab the text and replace pieces of text that shouldn't be used in output +function formatCopyText(textContent, copybuttonPromptText, isRegexp = false, onlyCopyPromptLines = true, removePrompts = true, copyEmptyLines = true, lineContinuationChar = "", hereDocDelim = "") { + + var regexp; + var match; + + // Do we check for line continuation characters and "HERE-documents"? + var useLineCont = !!lineContinuationChar + var useHereDoc = !!hereDocDelim + + // create regexp to capture prompt and remaining line + if (isRegexp) { + regexp = new RegExp('^(' + copybuttonPromptText + ')(.*)') + } else { + regexp = new RegExp('^(' + escapeRegExp(copybuttonPromptText) + ')(.*)') + } + + const outputLines = []; + var promptFound = false; + var gotLineCont = false; + var gotHereDoc = false; + const lineGotPrompt = []; + for (const line of textContent.split('\n')) { + match = line.match(regexp) + if (match || gotLineCont || gotHereDoc) { + promptFound = regexp.test(line) + lineGotPrompt.push(promptFound) + if (removePrompts && promptFound) { + outputLines.push(match[2]) + } else { + outputLines.push(line) + } + gotLineCont = line.endsWith(lineContinuationChar) & useLineCont + if (line.includes(hereDocDelim) & useHereDoc) + gotHereDoc = !gotHereDoc + } else if (!onlyCopyPromptLines) { + outputLines.push(line) + } else if (copyEmptyLines && line.trim() === '') { + outputLines.push(line) + } + } + + // If no lines with the prompt were found then just use original lines + if (lineGotPrompt.some(v => v === true)) { + textContent = outputLines.join('\n'); + } + + // Remove a trailing newline to avoid auto-running when pasting + if (textContent.endsWith("\n")) { + textContent = textContent.slice(0, -1) + } + return textContent +} + + +var copyTargetText = (trigger) => { + var target = document.querySelector(trigger.attributes['data-clipboard-target'].value); + return formatCopyText(target.innerText, '', false, true, true, true, '', '') +} + + // Initialize with a callback so we can modify the text before copy + const clipboard = new ClipboardJS('.copybtn', {text: copyTargetText}) + + // Update UI with error/success messages + clipboard.on('success', event => { + clearSelection() + temporarilyChangeTooltip(event.trigger, messages[locale]['copy'], messages[locale]['copy_success']) + temporarilyChangeIcon(event.trigger) + }) + + clipboard.on('error', event => { + temporarilyChangeTooltip(event.trigger, messages[locale]['copy'], messages[locale]['copy_failure']) + }) +} + +runWhenDOMLoaded(addCopyButtonToCodeCells) \ No newline at end of file diff --git a/docs/generated_docs/_static/copybutton_funcs.js b/docs/generated_docs/_static/copybutton_funcs.js new file mode 100644 index 0000000..b9168c5 --- /dev/null +++ b/docs/generated_docs/_static/copybutton_funcs.js @@ -0,0 +1,58 @@ +function escapeRegExp(string) { + return string.replace(/[.*+?^${}()|[\]\\]/g, '\\$&'); // $& means the whole matched string +} + +// Callback when a copy button is clicked. Will be passed the node that was clicked +// should then grab the text and replace pieces of text that shouldn't be used in output +export function formatCopyText(textContent, copybuttonPromptText, isRegexp = false, onlyCopyPromptLines = true, removePrompts = true, copyEmptyLines = true, lineContinuationChar = "", hereDocDelim = "") { + + var regexp; + var match; + + // Do we check for line continuation characters and "HERE-documents"? + var useLineCont = !!lineContinuationChar + var useHereDoc = !!hereDocDelim + + // create regexp to capture prompt and remaining line + if (isRegexp) { + regexp = new RegExp('^(' + copybuttonPromptText + ')(.*)') + } else { + regexp = new RegExp('^(' + escapeRegExp(copybuttonPromptText) + ')(.*)') + } + + const outputLines = []; + var promptFound = false; + var gotLineCont = false; + var gotHereDoc = false; + const lineGotPrompt = []; + for (const line of textContent.split('\n')) { + match = line.match(regexp) + if (match || gotLineCont || gotHereDoc) { + promptFound = regexp.test(line) + lineGotPrompt.push(promptFound) + if (removePrompts && promptFound) { + outputLines.push(match[2]) + } else { + outputLines.push(line) + } + gotLineCont = line.endsWith(lineContinuationChar) & useLineCont + if (line.includes(hereDocDelim) & useHereDoc) + gotHereDoc = !gotHereDoc + } else if (!onlyCopyPromptLines) { + outputLines.push(line) + } else if (copyEmptyLines && line.trim() === '') { + outputLines.push(line) + } + } + + // If no lines with the prompt were found then just use original lines + if (lineGotPrompt.some(v => v === true)) { + textContent = outputLines.join('\n'); + } + + // Remove a trailing newline to avoid auto-running when pasting + if (textContent.endsWith("\n")) { + textContent = textContent.slice(0, -1) + } + return textContent +} diff --git a/docs/generated_docs/_static/debug.css b/docs/generated_docs/_static/debug.css new file mode 100644 index 0000000..74d4aec --- /dev/null +++ b/docs/generated_docs/_static/debug.css @@ -0,0 +1,69 @@ +/* + This CSS file should be overridden by the theme authors. It's + meant for debugging and developing the skeleton that this theme provides. +*/ +body { + font-family: -apple-system, "Segoe UI", Roboto, Helvetica, Arial, sans-serif, + "Apple Color Emoji", "Segoe UI Emoji"; + background: lavender; +} +.sb-announcement { + background: rgb(131, 131, 131); +} +.sb-announcement__inner { + background: black; + color: white; +} +.sb-header { + background: lightskyblue; +} +.sb-header__inner { + background: royalblue; + color: white; +} +.sb-header-secondary { + background: lightcyan; +} +.sb-header-secondary__inner { + background: cornflowerblue; + color: white; +} +.sb-sidebar-primary { + background: lightgreen; +} +.sb-main { + background: blanchedalmond; +} +.sb-main__inner { + background: antiquewhite; +} +.sb-header-article { + background: lightsteelblue; +} +.sb-article-container { + background: snow; +} +.sb-article-main { + background: white; +} +.sb-footer-article { + background: lightpink; +} +.sb-sidebar-secondary { + background: lightgoldenrodyellow; +} +.sb-footer-content { + background: plum; +} +.sb-footer-content__inner { + background: palevioletred; +} +.sb-footer { + background: pink; +} +.sb-footer__inner { + background: salmon; +} +.sb-article { + background: white; +} diff --git a/docs/generated_docs/_static/doctools.js b/docs/generated_docs/_static/doctools.js new file mode 100644 index 0000000..c3db08d --- /dev/null +++ b/docs/generated_docs/_static/doctools.js @@ -0,0 +1,264 @@ +/* + * doctools.js + * ~~~~~~~~~~~ + * + * Base JavaScript utilities for all Sphinx HTML documentation. + * + * :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS. + * :license: BSD, see LICENSE for details. + * + */ +"use strict"; + +const _ready = (callback) => { + if (document.readyState !== "loading") { + callback(); + } else { + document.addEventListener("DOMContentLoaded", callback); + } +}; + +/** + * highlight a given string on a node by wrapping it in + * span elements with the given class name. + */ +const _highlight = (node, addItems, text, className) => { + if (node.nodeType === Node.TEXT_NODE) { + const val = node.nodeValue; + const parent = node.parentNode; + const pos = val.toLowerCase().indexOf(text); + if ( + pos >= 0 && + !parent.classList.contains(className) && + !parent.classList.contains("nohighlight") + ) { + let span; + + const closestNode = parent.closest("body, svg, foreignObject"); + const isInSVG = closestNode && closestNode.matches("svg"); + if (isInSVG) { + span = document.createElementNS("http://www.w3.org/2000/svg", "tspan"); + } else { + span = document.createElement("span"); + span.classList.add(className); + } + + span.appendChild(document.createTextNode(val.substr(pos, text.length))); + parent.insertBefore( + span, + parent.insertBefore( + document.createTextNode(val.substr(pos + text.length)), + node.nextSibling + ) + ); + node.nodeValue = val.substr(0, pos); + + if (isInSVG) { + const rect = document.createElementNS( + "http://www.w3.org/2000/svg", + "rect" + ); + const bbox = parent.getBBox(); + rect.x.baseVal.value = bbox.x; + rect.y.baseVal.value = bbox.y; + rect.width.baseVal.value = bbox.width; + rect.height.baseVal.value = bbox.height; + rect.setAttribute("class", className); + addItems.push({ parent: parent, target: rect }); + } + } + } else if (node.matches && !node.matches("button, select, textarea")) { + node.childNodes.forEach((el) => _highlight(el, addItems, text, className)); + } +}; +const _highlightText = (thisNode, text, className) => { + let addItems = []; + _highlight(thisNode, addItems, text, className); + addItems.forEach((obj) => + obj.parent.insertAdjacentElement("beforebegin", obj.target) + ); +}; + +/** + * Small JavaScript module for the documentation. + */ +const Documentation = { + init: () => { + Documentation.highlightSearchWords(); + Documentation.initDomainIndexTable(); + Documentation.initOnKeyListeners(); + }, + + /** + * i18n support + */ + TRANSLATIONS: {}, + PLURAL_EXPR: (n) => (n === 1 ? 0 : 1), + LOCALE: "unknown", + + // gettext and ngettext don't access this so that the functions + // can safely bound to a different name (_ = Documentation.gettext) + gettext: (string) => { + const translated = Documentation.TRANSLATIONS[string]; + switch (typeof translated) { + case "undefined": + return string; // no translation + case "string": + return translated; // translation exists + default: + return translated[0]; // (singular, plural) translation tuple exists + } + }, + + ngettext: (singular, plural, n) => { + const translated = Documentation.TRANSLATIONS[singular]; + if (typeof translated !== "undefined") + return translated[Documentation.PLURAL_EXPR(n)]; + return n === 1 ? singular : plural; + }, + + addTranslations: (catalog) => { + Object.assign(Documentation.TRANSLATIONS, catalog.messages); + Documentation.PLURAL_EXPR = new Function( + "n", + `return (${catalog.plural_expr})` + ); + Documentation.LOCALE = catalog.locale; + }, + + /** + * highlight the search words provided in the url in the text + */ + highlightSearchWords: () => { + const highlight = + new URLSearchParams(window.location.search).get("highlight") || ""; + const terms = highlight.toLowerCase().split(/\s+/).filter(x => x); + if (terms.length === 0) return; // nothing to do + + // There should never be more than one element matching "div.body" + const divBody = document.querySelectorAll("div.body"); + const body = divBody.length ? divBody[0] : document.querySelector("body"); + window.setTimeout(() => { + terms.forEach((term) => _highlightText(body, term, "highlighted")); + }, 10); + + const searchBox = document.getElementById("searchbox"); + if (searchBox === null) return; + searchBox.appendChild( + document + .createRange() + .createContextualFragment( + '

' + + '' + + Documentation.gettext("Hide Search Matches") + + "

" + ) + ); + }, + + /** + * helper function to hide the search marks again + */ + hideSearchWords: () => { + document + .querySelectorAll("#searchbox .highlight-link") + .forEach((el) => el.remove()); + document + .querySelectorAll("span.highlighted") + .forEach((el) => el.classList.remove("highlighted")); + const url = new URL(window.location); + url.searchParams.delete("highlight"); + window.history.replaceState({}, "", url); + }, + + /** + * helper function to focus on search bar + */ + focusSearchBar: () => { + document.querySelectorAll("input[name=q]")[0]?.focus(); + }, + + /** + * Initialise the domain index toggle buttons + */ + initDomainIndexTable: () => { + const toggler = (el) => { + const idNumber = el.id.substr(7); + const toggledRows = document.querySelectorAll(`tr.cg-${idNumber}`); + if (el.src.substr(-9) === "minus.png") { + el.src = `${el.src.substr(0, el.src.length - 9)}plus.png`; + toggledRows.forEach((el) => (el.style.display = "none")); + } else { + el.src = `${el.src.substr(0, el.src.length - 8)}minus.png`; + toggledRows.forEach((el) => (el.style.display = "")); + } + }; + + const togglerElements = document.querySelectorAll("img.toggler"); + togglerElements.forEach((el) => + el.addEventListener("click", (event) => toggler(event.currentTarget)) + ); + togglerElements.forEach((el) => (el.style.display = "")); + if (DOCUMENTATION_OPTIONS.COLLAPSE_INDEX) togglerElements.forEach(toggler); + }, + + initOnKeyListeners: () => { + // only install a listener if it is really needed + if ( + !DOCUMENTATION_OPTIONS.NAVIGATION_WITH_KEYS && + !DOCUMENTATION_OPTIONS.ENABLE_SEARCH_SHORTCUTS + ) + return; + + const blacklistedElements = new Set([ + "TEXTAREA", + "INPUT", + "SELECT", + "BUTTON", + ]); + document.addEventListener("keydown", (event) => { + if (blacklistedElements.has(document.activeElement.tagName)) return; // bail for input elements + if (event.altKey || event.ctrlKey || event.metaKey) return; // bail with special keys + + if (!event.shiftKey) { + switch (event.key) { + case "ArrowLeft": + if (!DOCUMENTATION_OPTIONS.NAVIGATION_WITH_KEYS) break; + + const prevLink = document.querySelector('link[rel="prev"]'); + if (prevLink && prevLink.href) { + window.location.href = prevLink.href; + event.preventDefault(); + } + break; + case "ArrowRight": + if (!DOCUMENTATION_OPTIONS.NAVIGATION_WITH_KEYS) break; + + const nextLink = document.querySelector('link[rel="next"]'); + if (nextLink && nextLink.href) { + window.location.href = nextLink.href; + event.preventDefault(); + } + break; + case "Escape": + if (!DOCUMENTATION_OPTIONS.ENABLE_SEARCH_SHORTCUTS) break; + Documentation.hideSearchWords(); + event.preventDefault(); + } + } + + // some keyboard layouts may need Shift to get / + switch (event.key) { + case "/": + if (!DOCUMENTATION_OPTIONS.ENABLE_SEARCH_SHORTCUTS) break; + Documentation.focusSearchBar(); + event.preventDefault(); + } + }); + }, +}; + +// quick alias for translations +const _ = Documentation.gettext; + +_ready(Documentation.init); diff --git a/docs/generated_docs/_static/documentation_options.js b/docs/generated_docs/_static/documentation_options.js new file mode 100644 index 0000000..ad10af6 --- /dev/null +++ b/docs/generated_docs/_static/documentation_options.js @@ -0,0 +1,14 @@ +var DOCUMENTATION_OPTIONS = { + URL_ROOT: document.getElementById("documentation_options").getAttribute('data-url_root'), + VERSION: '0.14.0', + LANGUAGE: 'en', + COLLAPSE_INDEX: false, + BUILDER: 'html', + FILE_SUFFIX: '.html', + LINK_SUFFIX: '.html', + HAS_SOURCE: true, + SOURCELINK_SUFFIX: '.txt', + NAVIGATION_WITH_KEYS: false, + SHOW_SEARCH_SUMMARY: true, + ENABLE_SEARCH_SHORTCUTS: false, +}; \ No newline at end of file diff --git a/docs/generated_docs/_static/file.png b/docs/generated_docs/_static/file.png new file mode 100644 index 0000000000000000000000000000000000000000..a858a410e4faa62ce324d814e4b816fff83a6fb3 GIT binary patch literal 286 zcmV+(0pb3MP)s`hMrGg#P~ix$^RISR_I47Y|r1 z_CyJOe}D1){SET-^Amu_i71Lt6eYfZjRyw@I6OQAIXXHDfiX^GbOlHe=Ae4>0m)d(f|Me07*qoM6N<$f}vM^LjV8( literal 0 HcmV?d00001 diff --git a/docs/generated_docs/_static/front_page_schematic/frontpageschem.pdf b/docs/generated_docs/_static/front_page_schematic/frontpageschem.pdf new file mode 100644 index 0000000000000000000000000000000000000000..90b2a0b1252b0e8cd52fc88a82733945c8fa8be4 GIT binary patch literal 94135 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%0D+4mA~sRR3sd#7`l72#fvUBIaG7FhS~+Ck*La# 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 ?8ID0G@pZ4;S!T zd8{nLrfLJJ47b}1=G05tb!f1M$_^ne#FNVjC%JKNysA=*E6-_!X3HptH&Pwry2~Un zqcLBU3dA~!WjU2!d4^ctG4X#E=ZhsJdo7X=+ngE1Ka|}&G?o)pe^>y%kr$E=HgP45 z1qYeF3I=7r;v@Q|(dZ?EcozwqHMMLeH3ztS$Y7V>#`n??#Uk3vV)iYJizYx;yb-*K zIHtd{vf)d|NT@MAQyB(6kvP9Cao?KZDWkI%T1ghyNc%w*_*9*Cz+iOkQh%V*tMrxx3nAewEv zLLCKh@u!%1k{>4DE&^SGz_CF35~H})`c&WYH{ zpYnaBO?=6fo0$g4#FRGH_S1PclZbk&s{z}1FTrkD8)I2UrUtrP4?iK*$pvy@wPvaQ z_8Dka*Vm`vRb^2^y=W5sjm%@*W4EU5L&g?RTu#yf={MCc3_CQ+>?shG`WY2s7E+UP zw=fB$k34Z0QZ*7QB4Kq(iNYkmWs615^%U*6nybi4x5W>_{?|d_#H9=W&2{Q;k3;#y zOrUrZKCVz)P3}e@d%eBRRX18rXIy854{6V@W;C{0hVSExMI)}i(7?9c^+dre zT$%or5*h4nRVVr|Mw)rbcd@n1RzVGt>3sz7WWI}%-cCE!#;rwUSr>S3;(&kN7>{rWEa3MlbLp;0B8(9Py z$tfBZqE>XU*F0Cqs!08GJd_|j++A0m){f(!M>7mc^ugdFP6}vd)7W_4R!_lLI<2%X-xHW~)O}P?U zA`{vnqVBzFGM6Nb)|~S6p>YQmemmOx{@1Ha`H)ui4hH+K#}0-Q8<;# zC$rU7TP%Z0cT*#gImpOJ12<7H3plJww$Fx8GuvPZJA#iCtFxmGd(}P2_g5z5rl{j^ zmb)kz7h=?i-_WuDn~<}q|-%7mR)j5i3`6LMUo#0^XpZrMv*A*s#D?NoD@Woos3ulSbSBC|4 zQ^|q!)^w!4iDzwAtv&*D+kpOP>4o^d%bR3>+2Qp{TgVys26al(ZHZxU+3jyQXFkR> zy~@`u)VmLSMlSk7`mAFI(Al@ovc}Snk1duJo|plG?etSbVs7M=4@tt0T>NyI3QUyV z69|x+k~%n#^J;b9FvK<2X$7bI1@HoJz@eQgvMSlUoio$fABJcF^>K!zpn@=f@f2V` z%%!L#;TTy?2t8N&qLrVVpI7}=)YIQx_MPh{d5x=7G1wCUcm3g3GNF_#zu0t#lC557 zafTm}%wMA*?Q^U4^S30(%hbMl%!>g&f0~Sy+c5TN#i8R6YNoRW$kL00|C^-)@tfr_aZ_c#ORqn&xUfiX$t|Iy7xAZ$K77A{p2W{DRv3WaPzs5c8X?S8FE)Bu| zP#6r}jBhskd1$HhAI%RP_A%!r>CN%P0PGu)n=J z`S%BlnBpAe`Sgu0b93hbvmg3vGeY=)W}=HYCg{1L(QBC&@g{?64xfEyYNvX`yGwW{ zbULd*=^Wd3YBz21CD9u3?NP7M5uYB5*YZ7dUmOXo{G#;KPnSdB-asu#?{=?ju|G9P9*#B!{l!=XliT!`yq=aD*x3YCLb0%UCw>5G#6E!n&Fg1hW=ZA4| zbv84ygYjICdjVI}-DnAfJ&<>79p2hvYqN2*qn&N*B;y1N?gU>c01oc_Uk~5&_DSBQ z&rk1p_j%>@QyiD;G?V#L5viKG2^w1?3$XNhP%gGsmgXzaK1^jbEf5BVJ2?ghJD9Yz z8;u3-ZonW^YPO&R1q~0W5JcZNg5lA=$>f7LN{y-401M&IZuprEE>$G{MgVcwAs_PLZ_*{96SZ6@*N1YkvHUuss{l-k4KQf^Sa;OTgJLBhHKhEE4!Lo@J9tt@U(*+2|+ zqELbDogu-8fY+~E{F+VR4%(aU5g5a_i-#SGua{@$M$k3SPofv(#b&pX)1Qjh zUK?X$_kX2PaRdw?5?l({z^6L$1OI^Aw;lV`xSH>j;a*!a!DDxz?SKZqowA>?)h7XX z!H4|40`N}ao^{ZD=%821|!p!eQN?Y@9;bzn>LBjb+%4YS<19Y`TGQ=^9+ zyC&!4CTGZODjlvI?e7J;pHa5&Y-U^PsBT*OtNnzhQPOjfT$ewKH8^~)sU1l;;zWeNQZcxbr)47?~` z{>0$jK(F^IgaOuiS+`-GKQVhCUEWP@2`0vdSI6!RU~c$xf5L8X=mQRZtnpMZB}QI4 zA8zLSZz_NGdKs*VX7Mef|1jEEj1$`Gp>8@GkV)?jx3N%jinSM~$xfU$@2;NTzXG!d zwJ`HJPTi@q8Wo_rd0mi9#f=h=#jGf)&|R(=+)+;{Y|n)6s8YCRBOi~{`;6Qthz2|( z^`kOZ#$0;$a(dc8_=ekpIHZ(Lx;yT@739V^-7M1`eK(eyTD?wO#*f>RW#H|*jFFn8 zikIjM?y;K1OAW)(W5=?PAmib`xATlYPFc2#_a=Ge?f{(VnUdV$$l4(uDOU%So%lulJq-mC*6h$3<_-JC$n3Q4k1)Xf@=z`|YFJ}ijlz8zfZ)6#XO5L_-u2gJ6= z@*M)LOzkE}eufe1%C#fXg8KD`I~k;UuOV?DTDg6jV8VPtq3Jd?&-k^^!xa{KhY)(F5uf zil^4v3NIkL!JVjjvYN;M`6mZj4FRmuKf);~&-Em<7Hr|#VZ9KV9QdjOzCHT!Q>03l zLd1lvV_X4q5=wo)NS2yeG?1KkYE-yHR?F{s&*x(lcAb5WmlmISJ{q^QKCSwZ$kww7fvyP)5qIx=Z0 z>_p(A(>rz#mL)$DEI7hZu%V^TgTccH+ChWrwqf5NP{8#()xL>WjX2=HZP{w1Usw$# z&wkU)rJi-lBp!y>fWl{E*1Z~oS)aeOAO4Fh=((hj=#+?{>Y(YfA9;u2ZN&lkPmiKW z<~aOIiRgS+XxId^ChgT7@5NQ&*cUa&gf3YvboVtMd>c_RIj^d_W5^cHnOF(>Gr7H2 z`U3MEZ`k^lJ(XF6kCI5q78{18=uc4}#|cVS6zF%da}H&PI{qI1_4#_uq9MFo(y1B` z^SdsUhz-wSqcYj~*@ygW6D*h)7fZg`-kf^=&Z@*~v|NyL!LJF5^ABARw)Nz9 zcIF_g8l2g40#`|YtnZTLqUA;1K@p*;5_MJqW{1t7nMA)SK&J0^M^~GXaeF25C@AYl z=kP{?xp}Dt)P5atW(=f&l9aQ5f>Wm=Z0T*SFYF%`WUMV*IbqRU#`_w~Q6h6Q zs^@SSFH}qZKYUeoo|y^;_ozMJ^V4QDyF1H}UukVbOEX{^5Mi{|Y0dsJ z)#~fowCz|tU3UT@#cLseR+wIT274s#uq;wEA7!Q=IU+(@@?bfZKpb_&iVV38mN4re zM@I3cTk?laC8wEEd^U*duwglu?dXxW z>0zs)y;)e_3E%A!Lwn*(y|-U;T7P{(ffW0mq+|1G4=dJ^Rg~vxqWyhZG=FuODH(*3 z!!yR809w(tW;%osw3T$jUPbO=+M8J*`Sf%EO(mln;T{h-0Ua9q`>K~OVCLbqF$k2t z@vpj*)1xP~f>SVXE2cT@3^imXATjx@iUJW)7yksh>05-Y>(mRmqG$NAPaPb1ekQIq>B*|5mPK{sWiaRyNwcbe-zvxQIZymxTk)#NbJ1KAitw5^2}AYIqGS>S zZm0HA45-YP-FuyF(J2wKIhNtF_iw*yfF_#|W@g_RzKI2} zNbQQIY9=^mvh2~XKX4_QVbzh7F-4-3;(JuztQF&*ZDS7YQ=6q#@sV>YqNh(8IXH&I(KUbT*k z$h~&%hqS-9e!3svq<#eg;h9D@2IvhUIzKkX2H3`W^!G%< z$Fml--VH=_f>v%$4dX;-9yrz?$kb8ccFKG1Tg4h;tDD6cKA)#Hpe&@>zK9iS3{%d& zWUYP#?7e7HVTU79{;PFuuPh$s&sbqY1KtB;^$Q0}Qrqo^W(WSNaLeGiZa$F>63Zwm zIO>JUI)5q2-|O>@98$e)I7|gv;^N@OM90U9rHtMGMxP)4O3oV0`qdqm0cnDOuAWmvtm;HRvk8l{+2xJ6|fJ*>$jCx zG!M?Ab-4>gAe+&#b}g4fGhJOoe?*2Y`CMco+kxk0{a{OOzjG!BJU#SQ9xdprDv|bt3m%*t^;eDpdtKu0_UFx+KieCpyYO)O~Bz6V~L7w`hJ+#(Z_Us!Lpz#O9Csu*XcI$FTc5h5NO1|cZsi{(9eF5P#9G~l3*2s%~yOu)(HYs;Tm2gijk&5bSIvcgY2bg z(_WRvKzNRpucx4!hy+jYB(;yOozqa*P#+K9f@_C6o$fctY-5Jq5DD6v5=~L$N~kKC*EJmLW5gf&l*P~Hla#Vj&TX?BN}x{ zCo0ZDS1gqCNsDZ5!n@qm#Kn}%uou&*UK40i;7(5K+qWJShBxQimcCB<|wP}&;2xFG1y7VNi^t&`hf&X zab(H@GYs9mF+O+3O6>*w!A|)oj)n_IdPBa`q@DLAQ5JMP=SY(YpJcQR3bF#3MU zD?y+a(>gUpP;d5XOrXSSOeQ%kBro~lYcA{9zHGTLVQGpso#ir_7JGlN=BAD)-N5|C z6egG7eqHdva+UB`iSH;Rkp6Ch`udP*u~6e@Q|gnfL%%MB&I6k?G{tleOB-^r<91 zsCGah=4@=BG1DHn^@RU#RAC1PIke|yqp4yw;3L=|`+`GkCQR3Q4rMDvq=!V}^>3 z0U3g7Ye`>rPPrQy01T<>o@sZ5&UMt*->e_Fx80;C^H4RsHy?F$!7ZnfhDWc2!*9p8 z<)gPE#+Zo{2t8jYdKG#g@&|I>$`QNG>IzU)LCecE?za$}kQO&Gs9+Ur4EvY)9qikh zvDyRZzN*5&GMzBoO|55CC*6|e8tlE2tH&G51q3a%xis2h_$|t-un6j@Fq*=#ss9g& zuqfx(f%-DJ!~Gxa zlBCcniqdYBa%ec^`s7o5=jT1|yn1SEEElh9W0(aW^Ye~AtU-bE=K(7$o?#L=clY1XOmdZQiZ6ORjS??h8!#*dm_8ozs-+a>AF+8{S-C zXa?{Wa0!4hcz-4#t+N=n3%)x%{r<@CnN+(Y_n*~j0V%VTzQ^;cZ&-H#9Lffu_~ zO`zij6s@{9Vnxa3HNts@E*RnWh1+t|$1?6yV#|-Lw38&^E@6Xml*s7De zV$(b%<}{mr%=Bbt=ARMznM=T{)#1X4w`P6wc{MTDFUR$Ve5_|;0#=Scsa-1Va$-d2 zNO&?_+7295(SMCsNXX|Izs^$UW3?SeIIU7~WrmHs4q1ti#x(*M&s0T*3Ozy<4)f)q zqWFlvL05ivQH-*1k^Bl&vO_j2S2DgnlimnaiMnN2DLmE(?LJ}b;H+N5OzV#$7DIhN zdM{1isp`*iH@#JY4a2#m%R|+`h`=Bj-k7VWZ%$rAr2^5z$|vAc|2G9S{EOgBo9La+ zeupzup#IEb*cnZ#JpQn3O0NvZHI`=-^vZfZg-yQJH|ZK?e}A|=EZ)lJp-#C(s6Gp+ zH+o#GeGH+CwC6VrVRBC0O!@`ZNU2^&BGb@G;bZJABgjV-Q`gffyv%TdBR9o z)bB6Z2;7pZ13gpM1{v#3!gb8%D4IQ}m%^FqjKrwl0kMoZ_$wFQE&4!@nI8ZaN4)Nu4HHOAjruPhb83{*0IC zKdiuK;>O@xcNRd{_tTO1D2@{lxJFL!hLA-A#1dC;0#7Tfv_4=Sh=rG%K(y1vH(=-r zg&kblK^=N<`<_tcpx3Z(N(_4W3twf?qItq!4jwCCVxDhEvJZL$Nl%9SG@kb&5GZo2 zlR5#!gkNQOTem{@*GdkEKS$Gs+yu!`geXY@;5}O(is(dzEBKMLSIkpSW%Ccrd9r}Q zfo+F@8~JT4xdDH%BKAoQW4mDY2GO-s+7I}2ElWm;vny7>sFDj?0qTriZzXh@Sfu*{ zZB?=S&JOtjaPq=6N9DEtbQ`GvbqKKEq+*6Q@+?AMTx~(XK=6 z>AZbh;_CJCc=UAZAm(-R3AY-p%s_R72Xd(>h>1+HvbX$mq$UXKS=89UUql@Fm=J@C z_(Q`9ng{#4D`_5)>yb*8vwhq%(`Oql&*@Tpq3>QNDJvRR@bbl2cv1#`SzqFR6G_I& z-awrzIJx;5gp`UZvYIQkn<70)DhI!$JA~!EL9oK-6G4QU``^xw{dqN1SUOAcnlkAJ z)Z5T{KkLJ_*~*mVh#)W=Mr=~np~KJn$HE^8LHjOKN(Q(V*KoG>K@ko(XCCWtG?Ft| zR_YGJG>5vKiqJ|rI5miv+oD8?B!;B!$FC97yr^UUz|`y9w}H;KKf2x{KtGOMq~}+t z{e@!Kec)ios<)%ML^BhJ$>P%xF}=VT{9v#8Sg1DQ|JGvHb9kd*cjDS3YdO0kuKjrc zjpmq4d~mQ?j@o9O;~QCVtd4$;iq_~d(pr&+;6ib5e4SWNtOuJ~T3vMwJv?De+tuDW zQUi{QSMUv042qE%D0^&8y;!=Xh@P4-w$AM`xDMg=50*$XO?I1dFaK#;)ex}MT4QIV zT0Rd7(JHDaECv$o=uh3cSuhTh7ZEgW!?-N$50L8f3dMu5K+ zGHikfbn!ZeU(+pu>kTcRaN1pn0~=-9pQ^D$|9wR%5vv-RE~y0RX5zshu>XmdkN534 z%q~D*Gr1L{BIR4uUBlL=Nx~KQt+cn1>u=qwxoVC9&Yk%Uj$0Ziy>MN2Ltj$b4{^8L zf9sTHpilT_oS(6V=+hcyNX%FzQ6+-H!>K>=iVV+?c#?>ik^P-k(6F}*?JlSZ;4Tmo z+tM!;R8nhY{FEP~{}GdkstO&e_9(_P2z7O!w=!4+>IJb-K&Us?>I%xA_ww>&FUi98 z)`;s-s#+1n{3%~OnZ9-*~|lGsqwMnuyoG42bf;Q;bLgZsZ1alR6=eS9)NG`5tvFr&}!JcC`s^+Sc1zNW&t;S2aMH9WP=a zJdUEnL-DTZ*~j7YYI)0u2K8CAd`}I036n5BXN~qk=KBXT-zBL2HLvqEi1zf$uATmq z{oV~KPfhc}1if3A52kV^&)q>L+9z}L>n`z0Z;g~4qN7~4P&mGRv0PQW|9+|IoY0q8 zIU+D^YAoX~=2_gJAQ%=6{vgwAw*VB1X=1?UIRXZ7%Ac^wJ#i~Xncs0pr->bH48r0u zADqUw-eS#WbB?}^EfrwQr|EUPd(DlLm<85tsn#eI`Us2~WVY``B^=ox@8?X+N(O#f@G*IO zy=6T0b;c5LqLc4W<}XJXpB6rdCC6w5e=2=B(dn~XEus(yH9$Xwt{L~R&(KwOp|Ynx zt?f^bIqx-S?ytCgOX~mjok^XMtPSc97dAeIS6QrfcK%j!o$GU3>vwsD+!NRGPYk?U zrbU)~@DbtJMToG$sS~}#_Pewt68uAn53z$$zH?QN+BQtDY_*$!{dSd{P{47kpg z%lByV?8Fg7gfC}fqy7#w!rC|~uQ{LqWhGZMwK1K=DqgPUj;kR6HECk|XF|w@zBTYt zbjULKGTm0n#KU0yz^$qkvkHHajT(Nl zVTr}?P@V%VXVqBoVJ?wae|%60uaK$wJI@#`j|TXjv ze_Zv0pJz_*mLpcOV`3s?p*c?sNx$X8s6Nfp5>Ul>LyqURotJE*D!42ca_d@|_Y=u2 zyzSBIQ9fxYU3SbA_BzM; zB@&_Pd5ui)twcdY-iR=uFq3BQ$sVIuIy!NaAp`BRLqVtW`us5C8jS6d6)g~N9>(t_oOEA{n?lH zX#KGGMEZ6hBj7};4cn^M<6kLNc}nA)JznWh)og<&^hf`k<9#dvT=Go`b?XG`IMt>C*TA`n^hU18oQ_Kx+zP9&Q!aVf^21Hhe zwgGWWUC%xUiJD2&J@J#rpLo(`3$S zFBpRZ5mx^)T8|_)oosOOfMJ@~o6V!i7LCnvV; zgdtjKXw5^!2b2Lq?uXO0&rIUx`G+l+*%i89M%wVO|P;{qwl+-g`5KTFZMu zRQC^}4}8hW*OtKOJ2MM#pR>=%JWCh9PPOwpHK``aNYN+vRW`5_-}%4zMXvMo7B8GF zrMha)H-h=U>R0%~qL#Zp!qlM<7v|yAI8(Yu`pQtO7(P!)XTbJ`7FSd`} z0|G$4&Sk-Ew)q(XWV`L8%$yLWg;S;|1CC*3m8km(#z!nZtMmF8ax+K|ln^P=K_>k) z6zFPrOlexMbsaoe7ivK}Gh21%Ai@oyH4Anv=zo}_1MG4I(+cdAb~%t5uDp{r_0Hpm zD*x-{*oBdETqQ+UBcQ)kg|>vA>MmD+QqmyeZXG+y2Q~9AzU-vRzTGu<5i|RA_6E@meS4}d7xh%%@~O6eoPfK87 zZz}2eeFh%zwVAli?>Tt@DQoAWc-Okx(7R|JY4K4q%U@Jc{h>b*c6jZC^`({!PCcSJ z+%h6|#;07M==T&yf?+wWcB2JckK860(*r>B(@k&RmfK?{GV=->{c+3;a}YO}`>Qbn z)L8v3NHg)iHqQ88HcH=Jt-Dz`{4Gc%{&!~yTJz|=il{7JGD0ZpMJk?4X@8dan$BJc z1Cvy_R;MiTtAGJ^BpMOL3}papN_#MfUB$%_@^4;#&JE%sGUrERB;q;WtZv-AAuO@( zu$O|YcK;aiThr7XTUu1TG9p~!@b2R~(uREa&I(C4tkvknS+{R|s<;(X0nNd%xZhH^ zBuAI>=RZ*S-FmsFeRCc#W_V&IgZsdLf_{I07xH*R1CD6w51joNnmV;-N<*Pd>20-6 z>y$W~|B+g*4I6z15VUgssSE+Ho>(7kgYP~+sERx;c+zyyTkxPg;UG0lC+kXZfjh1f zbA6Axq{S#Sb(P$t&pAVtwO9MNVg?ElkXK2<@3ybQv^;- zAHYPJ5{<>JudEB2D%6F+rrZQT*Vv%?I=rhEHdyI<>sKjxo z&Zsf{VexdD@Mi>-Zlb&U!$VHmD7YzvYp@(%ltF$Uc~=2*hFZJ4#Y* zve1`zn-?k@Nd_-IOU=&*us_<}U`WOE2KEY^ui4LTFBs>t#>gVOwfi9Q2A?_QdA?;5`*=k-Tp?3f87XYQwDF(A@qIFgj4*3e4>C$}WlK_cp$ag~ zqc|GLhE_80+0r~?8z9QsJy~a?jMufP(eB5ArYlcu@%knkZ5vke?%KkmuR++ctEuoN z*YbQ}4Td*jh_1@=fi}Vb^F2Fbk^t?TH*(6F1I&0dq)|S2R$K17d-|5N;O&ZG<6-Mb zJ6|^pqoJljh4y`QGbMeF%O0jj6y<&Jy9g7HKvO;vDcw5dc&E*MTOC0yM!gZj{6~M{~jF?M{V!S8kJ&;ebuXxs< zO#8UeHkME{0ZmxT(u|@zZR2rN=qYBzis`~oocIG~o1FBgGdR=mCU%phK_eJltg#b2 zo!isiYGzy%WUa(OnWma*;$u|H{lBdfb*LGHQ1K?Mi>#U$u{a5p(pLWC1iKZQR~eRl zIDfTc)!J>Op2HIydU*W7oEiAND2NsbLkQKlQbBT_c7K~ZC=iwJfxln=SYP*04jH&Kf~(y+;AcQ4099@ZZ;E!~1a%BpzFT4yQWz-t5^ z-y(!GICS`cG)yd}^~h&eL6l?iw89|^t(Tyo+B#`0R!f*RF?QB{mYr^N4y=M@a=E@4 zU7;O?nN7>iG_+G^zb-xa_+kbTA7V4A3zb!WHlr!sD^pheUFJsH59Kh0BQsH@zxZii z^!!jA)dxze@Ke#ZGMQR#8C!~~1lzEq^Iz>=q7N+taP?a=cc8;gcDc*%f*mh-!egy$ ztnzP8{+!Z3>q0YhkD0i~H%JKN@x>-&4wW|3A0Y>}G2OlyALp9@q=bN&CqoZ)k2 zM6kT9fbdP)?HNrXWsh5d@%PqSYY!0X{9!-tEieKh7Ur^I1<%Yr)pVJs@nVj6 z@ac;JlVtg6vgFtfJ7CduYuL(Ml2M!BUZ>mRPp*gX0_eil!#&A=RZ)cuPHGFtWAry$k-`Y9N-mT53oy#j; znM<1n3|c%m{OJvWQan3lrF*_#1A)@=v0c3$O8bx`N;ag$)q|1XyFU?B!P_Fnq)^Vp)CY%6A+)`@J@CaI*SfpP2+1%Zs=~`sG-*727KOY&>ckDZf8aI(M z&ty2#%+7q?Z4}{ErhUO2k*+hY6rGjU{9wgVgIV10verhi#EGRL1iW)q=U&Q{@NfAW z#pQx=Q+YkgAbvgrEmx}+u}XqYs&MBK8CcJt2`}8<4Zz33n46q}RLbtjRP^uFWd(cT z81}r2=WycGh{Pv3T_YN1Nmp_bv(^>QCHO=W-3o16|0BvI<7(JdAN0?^^eOSwpymU z;FMTbNThk=o!x|!s{S!L&K4*vEE8)*mHb13q8D@H>-twy_vX(`A`h19Q+V>r1UZ8P zmUqJ!^X9v%7ngslh?A3R_;*bk>OUi8dU}QemkFaOPr3Pt4n{AQ>P%x=3pV)bvG1wZ zIi-Ns82+~nv`JWqc||qCKo#3!$RG-u40p)~1Qq2znn(y?!=1Z|ZE);mq{$5o!a%`R zJBv6fM|DN=MA>5_n-}M1QlcnY+5I3fesbb0IV=6xJyylr7h@JRE>5=mZYh1Jl`QrdO~b3fKPn zjpbKEg27~HwJbQg%Q0h?*eD_kST~RLAZv8}m#2~XSDr=_3Z&v!{GpI}3$Eg%Px0Xi zTr2e3%_(dQke=pt1PWZ7Ss&)F=uZ7dHph5Fo!o9?&qf_dIo82}AxX$iMP6Du`u_4$ zLea&d=3NMl4+-&l|9=@kH-ER!h`g}OI9wanlTb7G)g1Z_#w<)N;kmRIL4DfE7W=F3P<5;zVy;1fgILd0Z z-f2Qx)OL1wfr7@>h}R@%hDo+c5nZ=`M683NQJs6PWH_WMtuAH?MLUpF_QR+?WOxs{ zoDst1L&F_WqzBL*FAlKF+uZbYl5$pHxJpyE1+nD1#BjVir}zn*vg#s#Tj8ajZi1`r z6e6HRnadI+raIkX>76MkR*iD9O?=nE&_=K?_nTH{h14RKabzy@XA{2DLIj znNP44h9=)U3OsrL({>6vA&%ipM=OToI3bedQOGwJGs!!pxp`i~n>9Ux6!#yXI`8E? z!}>ViB#p!`=&U<_X}w=+ zK0VSC6rxi!{d2E6l=7bmvHI7Wj#o=)Q{?=648o>hrt+SmD4d^Mq1svswUi@Wfj1i|bP4_VbPIyTJ37@!-_R&xp_Y!U z&PwwzsG7?&fUV-r%HCldoLg zR6i}t_l#VQ#@pdrfPBL;{BEm*9i=yopz+J#Qg6;-A;;AamH%$IQ^;cbEnUNSZ#`uT z_zBq$`P&H6JB-2v(RPM_Ymwd}nzr^_4-Bc%4iqjZ)JN2$g?+yrSJ(VYA}8l%bKqcg zQ2=P%iiq*m-F@{bpG9`n-D$*!gT&BYTmYTRo}ziP{i2S1rnFIsT0#?|vGu zT@<=0-Prc({UMRpCMWYmjlNmy(Inf+0g+>Vqn8X)uqG~BBWId97!DdaBHWrg$JmKG zUutwEMUB;d)~bOm1rHhFcOj}_v8>uPno>U?87XMvY`SSCAyZWm+VW0DK-d(5i7Rpp?Y-g zo*v#Z3AcvCs^>cnk^T}B`ILozt0;%x=gWTBjqV#*NCA|El}2y32w?jw$!7G)Ev#Bc z?TrRDZm{-=tSDRl4B*g-2a#Luc1gy+Un;3;=>N(04T=HDgqUnPs~XoBo3`%a-O`2V z7<@!i31z0o9qXRZ@}JN(BlGYbSpVGdnZVhOQYr(z?atK(VyHVjVm#$A$-URi`eYRk zMBx>$iBY^B0=9L^0mJ{#qe?*yYKsVQyr@FQjR|w(Y8L8r2$>zcaqqylQ_RzaxXk)E zHg~vpFKuiOY~n~B6wGi6r-t1Vd;}j?X8yN4fn=-EE4i+69bUfd>S~4vmue+aWiKBE zf?a*MkSm^a&JS`Fp=^pb=T!kG)o>x@2UVXq)#n|1UO0bT{Wy8>yVc~q1?4+X($q~K zl&W4D(E)L0(zkO^t ziCM8t>`YuUx-JKBD~ZHW)zZnKp_jzrqrtg^{ASI|N7kn`iJfFX;NekQ_Dsb)^O1FJ z&SO9&A_q_$-zY^?Onj)|E}AP0oUGz(m2i2}miLp>plpNpY{FP`6vQ)NRi(rG*KxuZ z?+zo2$2z|uusF4BNt@L!u-SM#Gf}D3S}Wpac;${ffw8CfA8v_9l;GLOJhvZVb?4X_ zaD^JvSM|}Z;EI4P17iXcTw*;Uj8&Z3sZ9fk_+8vsu3CB*#QKbKzA4-_ik# zjJh-yTw0fYa{-*LprxGqIINEGhel@2DJ&k${OktWw+r0G_FSFus-^g;1n1R}_^q?v zNN8J&o3$h{@zhmonDT}V_eYL8@MCl;W1Mtm2=XT@S?C}}au z%b(tkDA+_b)EdeaMa@#n?kkL527u<4lu>86a5=%PN=LYp;`y*L6RuZF^PoV?n_~zo z=(>UqR$K`?w${Qu$xi>_nsL`V{E=%spZ?Hv*%{(XsrXD4U)nt)N1(WfnMgx=mF?7G@?ZfmYmXf7nY z11488*SZemUIg+$7Yac;N7$~-XAqxsCqD7WMMYmmz^yhxf`MJoo>_`Gs$Lb-`; zb&w&>c1jVV^bG0*O%bII&B&!vli4A@n~;}S;dD|`!G&yk-q20evYg&LOy>?=luch8 zs9nhix6LzA1)gnk#DIIlwY%X5S-`uoXxalM+pC6*?<{pu#_n~IfxvSpB!=y2o--ys zxqgn{l<#8TMd9Zls2ZT{6ZkI`hWvqkAY-r7200!>S24977OU=-L-3Luc4-l5UFca zvv}}E@9@^+H{WK^HH+kn^m!m($Vs?LR&)ExH5^~qoSI?6Cm%-90K-)ukqUqC`}Bng zvbB8wesDd`kS8+)#WQaA;3-3fBcsrX4|{=2f0&;U)&=i4$&(zM@gtCWGOlIi$}>l8>|X+UX`3AF5jRw7fwz$7NT7sr<()=-7tLlydJ^+GpBk1JkLj; z(}}gV18xQ{iM*cml|R#t!_g4BtU|Ah^+450heijmZ2>1`(zgZ)A9xwDF53;;?`R=0 z@Ne=lTb{#rF1%9lV|>i%zW>TmgxJ-nx^$xoZ#8l5`7)z*bN&M^(dC1Fodi#K;w(hp zzVcT6wTo26{rn37uk9j2u9IFGV;;;z-wjw}zc1L(RKwaVn99UHPMOQ(NBXQ@`uN+2 z5b7I&T#}MZa#yOZ6W&_ii4H)ih+^W2MTZpS8x%qS9I;8JjUhh2cYB^H5Qi~hab zECP=wJekl~y=eO_>I*zyGnbliS~F|p87}DA1bt zc97u(r8-Q4SrxHuvoB^L|F1Ziyz$(+9cN%Q0VYbQZiRQwh-|aG_1~#R+?t1_P%=Ik zleB$H7IS_gjQ~c0l=R9{kcJ!L702m>e6!knyN}7SDO}PHeOn7lH?Ozi$9+9KlWZ_# zC#)a9Ku(-grNYi8vhJmp9=R;=yu=#`gD+>@;QF4`WAM5fYOQ~qrH4uV@*y^kkRhqL3Xr?YJSgryV z4KTTmKcnEve#XX}7kgeC8ztcH4KFaIUmSI}+E6hXf}Dn0FYv1W2*38Lk8I|_ZZn;T z$GYz!r(3i zBaJ8D7glAD3)x~f1RX;mnSPz)e$#SK;%tMpcq>-N(_-$P=-`b}SNopQ zr1L+!qkSB}Xpd%epdvyfNXD2%gP8sat|8K?pkL_k;6bwHzlbiYVNB>z* z5xlpp-g$*jcW%+jqFGvtD^vI=r@-!t5TO83KuZ;N7#s+slQTeo9?r`PPn#WbT;B}N zix+BYc?FvKsUFA@6YT26BpJAycchX_5LoI40SJ*DXqW=*00RUBSVy2>&mSb$KnMt{ zA-tAMAQiOW2rRV2Xil1&(|gFK)^;mz)5;M&9x*75PD9$AK%&CYH{C?_W`FAvv1TpfWTqZN}Gr+;x}8lnK)F|?nD zFfCv=1lYghMn_1&{7Kp81-y9UkG2n;(RsH2wsBMlvX#gEvE^fx4qMdFD+rab^2)JUh(xJn% zvk|yoVRARn08+iY+@}F@Z3Woo2la03$RHr6gdFHgKsm;~(NBV(FE^z!bK%=4c}1K7Jbe0AdduB=9SU2Pgs-=)lx)=)JoquATYl55-ygdt@M>zB!q>{~{7> zcy|Tn;R$kR73~TbxMN_8=%?@3?TdX7C=e*E4c!jNIii&g^)UZJ-YjA{|Ly$2uuTt$ zWH0$e0BG+vAHa{rKQXxgeX;i~|3>gSSy@?GTwpZ*L2(H1RZ^1E1JZZ1!w2HVV1Oc| zBm~+!1qb>1?T&(2d#R@i_${Fps?7lk@<;e|k^042JFNdS|FCAy0RGjLo<5gsK?GXl z$My$50@vdC2KnZv`HoNdmb|L(;rKuWGTHAg2>xH)6FYiqV-Rk!CiD|2QY|~4ahTUd|&gLI=EZ==| zOXl1VD#VhbW9tu~26970eBf|j2$~$`pt;sRK1lXs|RF!_@VP!PNkfPpw<4fUhHB$SIU{<|jNe%*cHxBsyZCk$9Tupb_J4EgUho*x95 zaMt>Pbb&kq-#y={8tw^HNLuj(;zF$pVC57PwQTSDkp2D^|YiS9lmxvqJP zel^!c%8scd3;`$4)@7~0UtM-WgMOzVqF_-`5GNYRTzPd1H5p^sGQr62yv|Bp>P4M? z*`CzdTuijZUm$$J_h@AVb^E%%!}CE_$P7P2&?0HE4O_yq%=zs=QNMjbK;(=c=w9xB zawIX-htaK!u0&*Mfjdr_RBm*EwAVOa@&@D? zSyq_a4=yhxPJ!{o_El18JQdXO(&|nBr`O#0$>DWKRqZ-xNXXLW@soT?Pl~e6ycNQ$RVe*G42}qu9!y@ZUg9dKW@$ ztVG57?MKyfDb)YoH!Au(Sn9~Yqa0K;tfdQ$EC6RRzs<%Kb2uxu_eV7#BW^GfOta0snwC$O14C}4=Pr;8TUGSxJ=p^-7W`dJ4yZR& z%xyE#C>}J~2`k1{x2u)d6or}{#@}V|b=xV20Jpqc9{8kygH3($s|3>50I`KY_XPzJ z!BsrzJ2jhDplgXvXiHQ6LQ;wv{a3NiPo5PBYqP)?5n+Z6A*HF1V|0 zA8Ji4e%q!+CBv{J2eLQX?DWHGTWo6yn|9pJ#gTyK`#R2(M5Cxd$D7*OHq}@#x5`=OWOYd8hEsfN9h|tZW-T6B3uY zZd}e^8mZjNZ&fLzlX&b+c!w#|*~1KlK>#SYzq>d!y-v$p4_& zEafbybEf4@3@r{ho%MojJx8|fAA}GqVUcBQ9GtJnW?E#&4&5zF@ML5ZM!(gw)^)+i zHp*9t;`QgqcHDVViqKo$M7^uThLmU{z*bo!GTn9})?i%^>bY~hu_ z-em*aO2iQt&$F89H$^^Soc~mNQx(F*+BxPgu@_@dj4h)UbUmerJ<(QT8GV%k#M_ok1&JF}-5!+=kQXTLg)aY6ZEde@N(u zdF2(A_%4ie-n!BvHt}ckXY)(PjPpn-XYFfLf(E5ffuS+;38{M^^XQWc#MEV?>c@VQ zQDjcN5;}@zlp2-)!=H%4x5W8=j0fG$ff0PC(KtO1W-gj!^}$7M6)YX!(#Y%QuTV_b zBV1}y`yeGt$OEqr&8OwnK$Gpt;}}-JL=L@EWedMeWmHrkdQI~0^2r7&v_Fbzsd$s79hRljwM8UFS(A6_PE}HGjd7%lJCHn`RO17ApdKliC z8*B(1voRV=Y^ao@9Z@}O`);$I9VkQ}y`p>+4m(XXBdHsX8-76>$8g>)yKf^&_%y@Q zDYj)Ca96rPTCFrX=SH_rNFWTn?Km?lf+S-fG=wqJv8wDEq41C(-OYuNo6928Q4O^K z8YcAx6}a8$lm8m*`5>1V)O+YWD=SfD588USgX|^xhP99dci`szF9@S{XVwSDw$asR zD)w-{aF3;4(VNGNboL{#qUR&fyB+rT>g)2eK*}|nifm%P<|<6?Z!!~zVEos*h&?)t zikPT)`^q{tk#s9YIo7~PC3Q2Zw*g&!kl#jwxAX=*oy^-(PQdsTd0I0_NMi2R-y|OhFB@-2FPg%oBm~Q=Q-J0M@E6z&8PtySp$Q6`U>?f+fdI8jvLwQen z^+B8y`sm`pna0=3p`x!0bgLOcnjt$|93z@pqUdOnRXdg$;iF;A!n@?6KDDmGQfz+n zD#)xy2GfjOuvD`Zqr4LAr>&$pW{T;er?SI-_0`7C;%z5;^CWA6hX3IFxy9M!PHA(K zd0j+8$GB#es<7kvb~}sil^Mu2w>uqd)~1CvYJB?)U^7to6$ms)`n8{xk}MPMt({0E zsBn_8qI=R9UDaIRsOc|p2>{S;0}N4qs@~q?<6rYB=9yKS`tPQObk@noK^c)F7`>Q% zL?8t<`w2Lk;|#z4yP2+)+(lHH-pI3MchJEnu`jq4-sQ>@W&Vg#)88q` zTA$K_N^emRNtC!8G|*9%tiNGftveCDSsvmDff!xO00Z(@Cn{@`ffb~TX0nRG|>qJq&qf&;!({G z!Xae6S$}gzX7y+7*m`8bRkUj_8soeqT;HbZiDCv^3EhyZ!)62A`ai&zoTvvWM^OAJ zSfKu)T6N;)@3WkWIP02WyX9OAhc?qSttbY@A-?B1VRrw)2;>@+W>st)11r94+K8A@ z5<8u90KP@HF59&$FeTv_S&`2*)>oTb)WIp-c2$5`rf_s7@-9hiqspHA;2zuz^(O9f z>WN*3c2OvUZ<&W+;cpRwE=R~-Hplyg3beI{Tv4w^-O74SUH)g$eX%B%l@%dAU>xY z#5n3d9sRkRb`s$Y?vF{p+dV zfR7&?nZwUH4eLk?AJzM|BH)(txwv|M6!%?!-B*4>UOeHcZ~+f&QIrB;aNH~GGxE`V zGN$}lVC3M+XN;q!b{epc7f1kRZMQ}|jYf+haBt>RXntgE3B@ZI#3_|*@E){8jhz#f zv`Rt7t*ARjpd#tS*i0qJ7^J-q?5=KIeAAdTD+dsye8^arj^+a9!9P0=M`z}NNqD%j zx$|Eh-I)Y6oX(IubLc+Qd6-{;fj7MLxE>&2OCGd!w`;tg|L(8;R3CTLzOknn70#0! zSr~I1p0}^DtXywbjNc)2y~^Q}0g4_q?{V_17d|5p=29;Q2fCwM5NYl$C(OSvt-pBi z_xImS%L7AxF4_Pj0K>5H4k;Dk4gRN}W~$ZGea=sPb&(J_abc(o{ZOLY<9CeYL}}DT zd!z1vEH&SpYf1jOV*iDN+WeEAz&R`XcgK1 z2sD*!iImAWK7y&f)(X;X#ZI`RZ>jg&pc{zhC|?YryquQ!DJm~-k7_@j6X|Wu2^ss1 z&!{9~_2;=~PFOuJru^|y%CNhcOR}Wf>PeE>wpM+bA<<#SdCH^8HsLGDFW&@kDXa1R z5#2o)T`vQ|p=|X95AxhiO{L5K{OGj8rc2!=w$^gyB%)#j z56*J0e#lq9?xFQ}bCmpa%N-?yv7V!IZ*9R{=kK&mtEi{2_EJLC^W_%lWsHNl;_jWM z@>U}4Ud~_$=Hi%``*+?R~Zd6$7gbrdjLtpO(;qwAuSu<3t`v_UI%m zn-1`#w~TaWxzUPi(gHcu(P1xXB1>1}Uexf97eK6yhe8VX*Vcl#X2Ou6$=`?$g(FN0 z!P~xO=u&m2EeEowQ{lg!?Q^{wwevKku9&T{UU@en>M=RPIHLg^FVr(YO+=nIk=*Yr zIj1c?V#-@i>d8v|raWQxZ}{>|73KPZxYE}B?2r>|XB~TRckaFSdE=9OhFZ@UV4}G$ zz~1gU>C7aM3U%9w#V_=dFPA#u(Z`LwB>KH%iG1ooGzJJp8n>=0u|?$q8}yjBg42GX zr0a{XmR~u$nq5@|8l^D>B9c|`9?zh^)Z&-VwvC4*`3@33tX<)w=*)#a*WWL75LCQ& zy{UhFgSxa81cWwk*eZin%S(7K)QAGt&V>Bd%ur(en?*{_RiwXPNFKUjeTl=qoy?9f z+LNOLUDq37`88oB&%{tVUu$1C@GufDm|1aYIJxT^QPBqMFbh zd|a7rvkZ;lXuk^vdYtYnui#@$(fyOf`KLS+>wuD#R@0+++d6%?G^nEvKoSUW!Kg*^~)ho!8@Db z`~c6FkNubFK(8>xuL!3ya=DZ7l+J=HN16yt9bVT*`pSMqckcc@4*g;;`dB_ zb`C}7zp&Sxi?SI_ubUZ4zVCIoW4p@KU!SpB4Qh*vjX3~Q{10S0crGqAr3&+60Wf%9yV6eEC0=?|yS$t&B2-Zex2h?Q^vd1Ti zdw)hOnBDF93?@(-KQe3NmtTP?wIJ8FgsGg_Qi+(8>DMN(jsza5Kh&f36t(LexcMzt z=4VvmhPum|+`6yCiB?`E+f^_)APqu^p`tzoX%t{uPk($!0K{V~FkaQ{SM~PRjJM}J z4c+Wte4r6S_)PLstY^tGN!lg_u#A)dZUSY;%yd?v1pj?DypL|kInjmA(+uiJ4Jnnl zbq|}6=h>#Aw*%&k{Z<{Jl_S~Cd7~w!z2&aGLK6Q#6;&Mu{XnRQRcmc!yC>XIF+4uM%S)%E_zB9v_?5K!$)1q@?)bE6zJjr(Jz^M zp%taJBfWumU3LgRiS{Dw8*=6>JqDL|aYt|5!N>9Dq>H-ftrY9s>*O1x4nqF7V%5#J zE5B`-izc6*Mgu=`ri&8c3T~`Z){u}Q!*%G+OV&e_#d<$ZJ+H!AMlbcHa4?_*e*%D$ zYmvF|kXH)unlYQ095rHRDj*ja3!A%OslT>6jb(XA=MV5YN2nA}vpB7!<1AwIM^B+uO-J0OJZj8C+gWRX{zRj#? zU`i9?maV>}i!$m#HbhNFj0V;Vt2|`i(*b3s$hYMQ4bI)YmqMrMgq3e*=$h?hBUM^- z&^&dQ#EPIrTG4G0g6f z*ZD7kyRU%iip_b175oPH(OCF!h#7kS?2Ls|SXp z^O5DN%a11NYVC%&FRiM&5-E4#<{mxB-CR3~{#5YrGEq)*$ruf=oAl18#F697Y7KXF z#~4*0v33MJ(eMbh4*V^vZbkb z)hA=LuaN8@`Z@`-i*zw>j!^7;n%50s$Q5=CXldciQN>X5^yHxMhp+$Fcc!&TObO)K!x%`^E8#0_+433L-yQYPa)R#RK?$*rey8BS^90s zSsR<;!70+dF$}MhE9G}SxkLV8mI|ZS;+Tg^(C_Q>py2#fIG^P z9)Wg*Df8lwt@VK>x#YYAv?}%U`U&7Q5>8paN6ciJl<45fQRcHHxe*8-PA<-!i8K+V zPLTjj0_r#<;EpA%3zT4N(* zW(>LYx(XRB&`J5?sv~^zbuf_&Rf=pSiI7%kMq$8fLnF8qPHST?YgcuKJ?F>p21%c| z$d4uSAL1(SzuMbJa7N3I5l*OO;hEN&FgEzKYay(ikh<@#y>NIL1K$`<>sT7!DeccI z*}5BJtB0Nxd9jni%>}9Ww&_F`JxINB6*z@FyQc!OYTTKaV(9G>#n4WJVBsNBZoV;d z9bhDWH;a%;`oZ9CEsJdYOq;jhrJ}hB?H_fl%qIiE$chyDdPi8)J_bV)y@bzuY3E%Fr}Cr$E-2j!Nypkz{%%C=(>gKgoP!Gl&AF2$Jy*>9`E>`|9Ec9Dft zbC*O*@SWIaIXS4&{u1I!Vg+yK`;Cn=M4fT$`G674Gi@XW4~QP9eqJYn$#7d~lI#X* zzuuxmlez6@hsFFgDm}aHJ%zYR#~*OaMBEwYyAe1MFqso1F??2#cz50*y_jWFLPPSt zF<5XMU*+}={NE8d=p!^aEv8)jCCL+r;GkUUaqwA~+G7?~xpJl)j`kiBn2t@bB{hrU z3y%ne_`Ye49AA&NIKpZC<`In!}>+A7s9$ESz)J>^B!pm%1h zxzK{dC6Ok!2qJ%lRI-Lm?&*>v&|#rS7p$3aKLSAsb^od>r?!~ zPk+8(H$z=+l^X?&bkR~GY>It|?SXg2Ch4ogf8Ic@L(93H$sXe-3fzrvWW887@rNyv zEqf%<3lwo_YF?_G^YkT8p>%~q!!dyer9tHbEPZ3CJg#af}F-jKf{xy)s6$ivPyq(4Ci1$C%woi*fUj?|5P@BwhX<9lJqpp5<*XHhrJQswaREzZIXa%Ef z{bb8TmsUY$XmvAkEoHv?Yjdck_ofP^i#-7({0ry3;4Q_zY$c(%*c+4wzl2~>4p1Yl zP1!&qSL7a^ZPr$4(#>A%l$*CFd*Kk1w1Y`=5Q6y+l@k)ShMp~duEU<}CA6i4<+u&; zceX-?Tg5ZoIHM>e*}pxj+ZD)8X-Kw+W{hHWOc>?~ab>$m4&xBJoG6d1zrn3#j5VN7 znn2ZEF}<8Q5OTn(ds}n0D)MZR{p;3#l>EradS|T|Ox)$m?y{Pd?Pdly)K>Ed>@dzM z-?9i-S@|&9M=)f3>Ww%$&OQ-Bt_jkz2~!bny)~*2bHq|`Jy=#as&z+3o8af@-+PYY zvtz6P{Ljd}hl&6;$NF%Og?RKb6kO&{#WJ-Ghw>Pe@*LkNcs4uhNEGrV8mNw^?Oyw& z<3s|hX_`Hn0Yj!%1kso-B@V^AoelO6x>=wZX+yu!o--*V_k~)MsQFnwtp0a4M+EDZ zKJ9=-`ph*pV!vjX%`KNKxhv=#W*v#WcPbjeV;ZLv2X!dtaWV^qy`+G?w(uytGT!9z z840R$-xP4XL#o4!CrZ;@XV$nS{WzRLx*vzDOey?t9m3cw&~rK0Jq8mjw@~N*$Jjab zhytvMwr%dVZQC|?+qP}nwr$(CZQHhcc5ZTV=ixleTUAmπHIweZyo_CH0?I2kGg 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 Wv%BMWo;jG + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/docs/generated_docs/_static/front_page_schematic/frontpageschem.tex b/docs/generated_docs/_static/front_page_schematic/frontpageschem.tex new file mode 100644 index 0000000..c5f7710 --- /dev/null +++ b/docs/generated_docs/_static/front_page_schematic/frontpageschem.tex @@ -0,0 +1,359 @@ + +\documentclass{standalone} + +\usepackage{amsfonts} +\usepackage{graphicx} +\usepackage{epstopdf} +\usepackage{algorithmic} +\usepackage{listings} +\usepackage{fancyvrb} +\usepackage{booktabs} +\usepackage{multirow} +\usepackage{pgf} +\usepackage{tikz} +\usetikzlibrary{shapes, arrows, positioning,fit, automata, + arrows.meta, decorations.markings, calc} +\usepackage{tikzscale} +\usepackage{xcolor} +%\usepackage{tikz-uml} +\usepackage{mathtools} +\usetikzlibrary{decorations} +%\usetikzlibrary{decorations.text} + +\definecolor{colWhite}{HTML}{FFFFFF} + +% general naming macros +\newcommand{\code}[1]{{\ttfamily\color{black} #1}} +\newcommand{\pressio}{$\mathbf{Pressio}$} +\newcommand{\pressioFpy}{$\mathbf{pressio4py}$} +\newcommand{\modred}{$\mathbf{modred}$} +\newcommand{\pymor}{$\mathbf{pyMOR}$} +\newcommand{\pyrom}{$\mathbf{pyROM}$} +\newcommand{\librom}{$\mathbf{libROM}$} +% math macros general +\newcommand{\defeq}{\vcentcolon =} +\newcommand*{\difftime}[1]{\dot{#1}} +\newcommand{\tfinal}{T} +\newcommand{\RR}[1]{\mathbb{R}^{#1}} +\newcommand{\RRstar}[1]{\mathbb{R}_\star^{#1}} +\newcommand{\RRplus}{\mathbb{R}_{+}} +\newcommand{\dstate}{\boldsymbol{\xi}} +\newcommand{\drdstate}{\hat{\boldsymbol{\xi}}} +\newcommand{\range}{\text{Ran}} +\newcommand*{\pseudoInvSymb}{+} +\newcommand*{\pseudoInv}{^\pseudoInvSymb} + +\newcommand{\Boper}{\boldsymbol B} + +% FOM math macros +\newcommand{\fomDof}{N} +\newcommand{\state}{\boldsymbol y} +\newcommand{\aprxState}{\tilde{\state}} +\newcommand{\initState}{\state^{0}} +\newcommand{\stateRef}{\state_\text{ref}} +\newcommand{\velocity}{\boldsymbol f} +\newcommand{\dvelocity}{\boldsymbol v} +\newcommand{\dtime}{\tau} +\newcommand{\params}{\boldsymbol \mu} +\newcommand{\dparams}{\boldsymbol \nu} +\newcommand{\paramDomain}{\mathcal D} +\newcommand{\nparams}{n_{\params}} +\newcommand{\fomJac}{\partial\velocity/\partial \state} +%\newcommand{\aprxFomJac}{\partial\velocity/\partial \aprxState} +%\newcommand{\aprxFomJac}{\frac{\partial\velocity}{\partial \state}(\aprxState,t;\params)} +\newcommand{\fomJacVel}{ \boldsymbol J_{\velocity}} +\newcommand{\fomJacRes}{ \boldsymbol J_{R}} +\newcommand{\aprxFomJacFrac}{ \frac{\partial\velocity}{\partial \aprxState}} + +% ROM macros +\newcommand{\dofRom}{p} +\newcommand{\romState}{\hat{\state}} +\newcommand{\romToFomMapping}{\boldsymbol g} +\newcommand{\romBasis}{\boldsymbol{\Phi}} +\newcommand*{\tangentSpace}[1]{T_{#1}\manifold } +\newcommand{\manifold}{\mathcal M} +\newcommand{\gRomState}{\hat{\boldsymbol \xi}} +\newcommand{\jacOfRomFomMapping}{\boldsymbol{J}} +\newcommand{\gVelo}{\hat{\boldsymbol{v}}} +\newcommand{\initRomState}{\romState^{0}} +%\newcommand{\gaprxstate}{\tilde{\gstate}} + +\newcommand{\weightMat}{\boldsymbol{A}} +\newcommand{\weightMatDiag}{\boldsymbol{D}} +\newcommand{\identity}{\boldsymbol{I}} +\newcommand{\collocMat}{\boldsymbol{P}} +\newcommand{\phires}{{\boldsymbol \Phi}_r} +\newcommand{\gnatWMat}{(\collocMat \phires)^+ \collocMat} + +% Time stepping +\newcommand{\zero}{\boldsymbol{0}} +\newcommand{\res}{\boldsymbol{r}} +\newcommand{\timeStep}{\Delta t} +\newcommand{\nseq}{{N_t}} + + +\tikzstyle{block} = [draw, rectangle, minimum height=3em, minimum width=6em] + +\definecolor{appCol}{HTML}{FFFF00} +\definecolor{pressioCol}{HTML}{FFFFFF} + +\begin{document} + +\tikzset{ + ncbar angle/.initial=90, + ncbar/.style={ + to path=(\tikztostart) + -- ($(\tikztostart)!#1!\pgfkeysvalueof{/tikz/ncbar angle}:(\tikztotarget)$) + -- ($(\tikztotarget)!($(\tikztostart)!#1!\pgfkeysvalueof{/tikz/ncbar angle}:(\tikztotarget)$)!\pgfkeysvalueof{/tikz/ncbar angle}:(\tikztostart)$) + -- (\tikztotarget) + }, + ncbar/.default=0.5cm, +} +\tikzset{square left brace/.style={ncbar=0.3cm}} + + +\begin{tikzpicture}[auto, node distance=2cm] + + % application + \node [ + block, + draw=appCol, + text=appCol, + rounded corners, + node distance=3cm, + minimum width=0.6\textwidth, + minimum height=3cm + ](app) + { + \shortstack{ + \LARGE{Application Code}\\ + \vspace{0.3cm} + \Large{(owns mesh, physics, etc.)} + %\Large{$\dot{\state} = \velocity(\state,t;\params)$} + %% \Large{$\state(0;\params) = \initState(\params)$} + } + }; + + % adapter + \node [ + block, + draw=appCol, + text=appCol, + below=of app.south east, + anchor=north east, + node distance=9cm, + rounded corners, + minimum width=0.29\textwidth, + minimum height=3cm, + yshift=0.6cm, + xshift=-3.75cm + ] (adapter) + { + \shortstack{ + \Large{Contin.-time}\\ + \Large{Adapter} + } + }; + + % adapter2 + \node [ + block, + draw=appCol, + text=appCol, + below=of app.south east, + anchor=north east, + node distance=9cm, + rounded corners, + minimum width=0.29\textwidth, + minimum height=3cm, + xshift=0cm, + yshift=0.6cm + ] (adapter2) + { + \shortstack{ + \Large{Discrete-time}\\ + \Large{Adapter} + } + }; + + % MAIN + \node [ + block, + draw=appCol, + text=appCol, + right=of app, + anchor=north west, + node distance=8cm, + rounded corners, + minimum width=0.2\textwidth, + minimum height=12.45cm, + yshift=1.5cm, + xshift=-1.5cm + ] (main) + { + \hspace{0.2cm}\Large{\Large{int main()}}\hspace{0.2cm} + }; + + \node [ + block, + draw=pressioCol, + text=pressioCol, + below=of adapter, + rounded corners, + node distance=1.2cm, + minimum width=0.17\textwidth, + yshift=0.6cm, + xshift=-0.375cm + ](galerkin){GALERKIN}; + + \node [ + block, + draw=pressioCol, + text=pressioCol, + below=of adapter, + right=of galerkin, + rounded corners, + node distance=1.2cm, + minimum width=0.17\textwidth, + xshift=-1.75cm + ](lspg){LSPG}; + + \node [ + block, + draw=pressioCol, + text=pressioCol, + below=of adapter, + right=of lspg, + rounded corners, + node distance=1.2cm, + minimum width=0.17\textwidth, + xshift=-1.75cm + ](wls){WLS}; + + \node [ + text=pressioCol, + draw=black!50, + rounded corners, + fit={(galerkin) (lspg) (wls)}, + minimum width=0.6\textwidth + ](pressiorom) {}; + + % ode + \node [ + block, + draw=pressioCol, + text=pressioCol, + below=of adapter, + %node distance=9cm, + rounded corners, + minimum width=0.6\textwidth, + yshift=-0.75cm, + xshift=1.95cm + ] (ode){ODE}; + + % nonlinear solvers + \node [ + block, + draw=pressioCol, + text=pressioCol, + below=of ode, + node distance=9cm, rounded corners, + minimum width=0.6\textwidth, + yshift=1.82cm + ] (solvers){LINEAR/NONLINEAR SOLVERS}; + + % all other packages + \node [ + block, + draw=pressioCol, + text=pressioCol, + below=of main, + rounded corners, + minimum width=0.875\textwidth, + yshift=1.8cm, + xshift=-3.85cm + ] (basicpacks){MPL UTILS CONTAINERS OPS QR ...}; + + \node [left=of adapter, text=appCol, yshift=2cm, xshift=0.8cm](pApp) {\rotatebox{90}{\Large{Application}}}; + \node [left=of ode, text=pressioCol, yshift=-0.5cm, xshift=0.8cm](pPres) {\rotatebox{90}{\Large{\pressio}}}; + \node [left=of pressiorom, text=pressioCol, xshift=1.85cm](pRoms) {\rotatebox{90}{ROMs}}; + \node [left=of ode, text=pressioCol, yshift=-1.3cm,xshift=1.85cm](pPack) {\rotatebox{90}{Supporting Packages}}; + %% \draw [orange, thick] (basicpacks.south west) to [square left brace ] (ode.north west); + %% \draw [orange, thick] (pressiorom.south west) to [square left brace ] (pressiorom.north west); + + \draw [pressioCol, thick] + ([xshift=-0.7cm]basicpacks.south west) + to [square left brace ] ([xshift=-0.7cm]pressiorom.north west); + + %% % box around application + %% \node [fit=(main) (adapter) (app), + %% pin={[pin distance=0.1cm, yshift=2cm]left:\LARGE{\rotatebox{90}{Application Side}}}] (p5) {}; + + %% %% % box for optional part + %% %% \node [fit=(adapter), + %% %% pin={[pin distance=0.2cm]left:\Large{\rotatebox{90}{Optional}}}] (p5) {}; + + \tikzset{myptr/.style={decoration={markings,mark=at position 1 with + {\arrow[scale=1.3,>=stealth]{>}}},postaction={decorate}}} + + % rom -> adapter + \draw[red, line width=1.5pt, myptr] ([xshift=-0.4cm]pressiorom.north -| adapter) + -- node {\begin{tabular}{c} \large{$\aprxState,t$} \\ \large{[,$\Boper$]} \end{tabular}} + ([xshift=-0.4cm]adapter.south); + % adapter -> rom + \draw[green, line width=1.5pt, myptr]([xshift=-0.15cm]adapter.south) + -- node [right] {\large{$\velocity [,\fomJacVel \Boper]$}} + ([xshift=-0.15cm]pressiorom.north -| adapter); + % adapter -> app + \draw[appCol, text=appCol, line width=1.5pt, myptr]([xshift=-0.4cm]adapter.north) + -- node {\begin{tabular}{c} \large{$\aprxState,t$} \\ \large{[,$\Boper$]} \end{tabular}} + ([xshift=-2.26cm]app.south); + % app -> adapter + \draw[appCol, text=appCol, line width=1.5pt, myptr]([xshift=-2.01cm]app.south) + -- node [right] {\large{$\velocity [,\fomJacVel \Boper]$}} + ([xshift=-0.15cm]adapter.north); + + % rom -> adapter2 + \draw[red, line width=1.5pt, myptr] ([xshift=0.15cm]pressiorom.north -| adapter2) + -- node {\begin{tabular}{c} \large{$\aprxState_{n,n-1,...}$} \\ \large{$t,\Boper$} \end{tabular}} + ([xshift=0.15cm]adapter2.south); + % adapter2 -> rom + \draw[green, line width=1.5pt, myptr]([xshift=0.4cm]adapter2.south) + -- node [right] {\large{$R,\fomJacRes \Boper$}} + ([xshift=0.4cm]pressiorom.north -| adapter2); + % adapter2 -> app + \draw[appCol, text=appCol, line width=1.5pt, myptr]([xshift=0.15cm]adapter2.north) + -- node {\begin{tabular}{c} \large{$\aprxState_{n,n-1,...}$} \\ \large{$t,\Boper$} \end{tabular}} + ([xshift=2.03cm]app.south); + % app -> adapter2 + \draw[appCol, text=appCol, line width=1.5pt, myptr]([xshift=2.28cm]app.south) + -- node [right] {\large{$R,\fomJacRes \Boper$}} + ([xshift=0.4cm]adapter2.north); + + + \node [left=of app.west, yshift=1.65cm, xshift=1cm](p1){}; + \node [left=of adapter.west, yshift=-1.5cm, xshift=1cm](p2){}; + \node [right=of adapter2.east, yshift=-1.5cm, xshift=-1.8cm](p3){}; + \node [left=of main.south west, yshift=-0.1cm, xshift=1.95cm](p4){}; + \node [right=of main.south east, yshift=-0.1cm, xshift=-1.92cm](p5){}; + \node [right=of main.north east, yshift=0.15cm, xshift=-1.92cm](p6){}; + + \draw [thick, dashed, draw=appCol] (p1) -- (p2) -- (p3) -- (p4) -- (p5) -- (p6) -- (p1); + + + %% % arrows from main to others + %% %\draw[black, arrows={-Circle[black,fill=black]}, line width=2pt] + %% \draw[black, arrows={-o}, line width=2pt] + %% (main.north) -- ([xshift=-4.79cm]pressiorom.south); + + %% %\draw[black, arrows={-Circle[black,fill=black]}, line width=2pt] + %% \draw[black, arrows={-o}, line width=2pt] + %% ([yshift=2.55cm]main.east) -- (adapter.west); + + %% %\draw[black, arrows={-Circle[black,fill=black]}, line width=2pt] + %% \draw[black, arrows={-o}, line width=2pt ] + %% ([yshift=-2.45cm]main.east) -- (app.west); + +\end{tikzpicture} + +\end{document} diff --git a/docs/generated_docs/_static/frontpageschem.svg b/docs/generated_docs/_static/frontpageschem.svg new file mode 100644 index 0000000..e2e5685 --- /dev/null +++ b/docs/generated_docs/_static/frontpageschem.svg @@ -0,0 +1,866 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/docs/generated_docs/_static/hacks.css b/docs/generated_docs/_static/hacks.css new file mode 100644 index 0000000..0b12d62 --- /dev/null +++ b/docs/generated_docs/_static/hacks.css @@ -0,0 +1,170 @@ +/* + * CSS hacks and small modification for my Sphinx website + * :copyright: Copyright 2013-2016 Lilian Besson + * :license: GPLv3, see LICENSE for details. + */ + + +/* Colors and text decoration. + For example, :black:`text in black` or :blink:`text blinking` in rST. */ + +.black { + color: black; +} + +.gray { + color: gray; +} + +.grey { + color: gray; +} + +.silver { + color: silver; +} + +.white { + color: white; +} + +.maroon { + color: maroon; +} + +.red { + color: red; +} + +.magenta { + color: magenta; +} + +.fuchsia { + color: fuchsia; +} + +.pink { + color: pink; +} + +.orange { + color: orange; +} + +.yellow { + color: yellow; +} + +.lime { + color: lime; +} + +.green { + color: green; +} + +.olive { + color: olive; +} + +.teal { + color: teal; +} + +.cyan { + color: cyan; +} + +.aqua { + color: aqua; +} + +.blue { + color: blue; +} + +.navy { + color: navy; +} + +.purple { + color: purple; +} + +.under { + text-decoration: underline; +} + +.over { + text-decoration: overline; +} + +.blink { + text-decoration: blink; +} + +.line { + text-decoration: line-through; +} + +.strike { + text-decoration: line-through; +} + +.it { + font-style: italic; +} + +.ob { + font-style: oblique; +} + +.small { + font-size: small; +} + +.medium { + font-size: medium; +} + +.large { + font-size: large; +} + +.smallpar { + font-size: small; +} + +.packnameindexpage { + font-size: large; + color: orange; +} + +.summarylineindexpage { + font-size: large; + font-style: italic; + color: olive; +} + +.memberfunction { + font-size: large; + font-weight: bold; + color: olive; +} + +:root { + --icon--pied-piper: url('data:image/svg+xml;charset=utf-8,'); +} +.admonition.pied-piper { + border-color: rgb(43, 155, 70); +} +.admonition.pied-piper > .admonition-title { + background-color: rgba(43, 155, 70, 0.1); + border-color: rgb(43, 155, 70); +} +.admonition.pied-piper > .admonition-title::before { + background-color: rgb(43, 155, 70); + -webkit-mask-image: var(--icon--pied-piper); + mask-image: var(--icon--pied-piper); +} diff --git a/docs/generated_docs/_static/jquery-3.6.0.js b/docs/generated_docs/_static/jquery-3.6.0.js new file mode 100644 index 0000000..fc6c299 --- /dev/null +++ b/docs/generated_docs/_static/jquery-3.6.0.js @@ -0,0 +1,10881 @@ +/*! + * jQuery JavaScript Library v3.6.0 + * https://jquery.com/ + * + * Includes Sizzle.js + * https://sizzlejs.com/ + * + * Copyright OpenJS Foundation and other contributors + * Released under the MIT license + * https://jquery.org/license + * + * Date: 2021-03-02T17:08Z + */ +( function( global, factory ) { + + "use strict"; + + if ( typeof module === "object" && typeof module.exports === "object" ) { + + // For CommonJS and CommonJS-like environments where a proper `window` + // is present, execute the factory and get jQuery. + // For environments that do not have a `window` with a `document` + // (such as Node.js), expose a factory as module.exports. + // This accentuates the need for the creation of a real `window`. + // e.g. var jQuery = require("jquery")(window); + // See ticket #14549 for more info. + module.exports = global.document ? + factory( global, true ) : + function( w ) { + if ( !w.document ) { + throw new Error( "jQuery requires a window with a document" ); + } + return factory( w ); + }; + } else { + factory( global ); + } + +// Pass this if window is not defined yet +} )( typeof window !== "undefined" ? window : this, function( window, noGlobal ) { + +// Edge <= 12 - 13+, Firefox <=18 - 45+, IE 10 - 11, Safari 5.1 - 9+, iOS 6 - 9.1 +// throw exceptions when non-strict code (e.g., ASP.NET 4.5) accesses strict mode +// arguments.callee.caller (trac-13335). But as of jQuery 3.0 (2016), strict mode should be common +// enough that all such attempts are guarded in a try block. +"use strict"; + +var arr = []; + +var getProto = Object.getPrototypeOf; + +var slice = arr.slice; + +var flat = arr.flat ? function( array ) { + return arr.flat.call( array ); +} : function( array ) { + return arr.concat.apply( [], array ); +}; + + +var push = arr.push; + +var indexOf = arr.indexOf; + +var class2type = {}; + +var toString = class2type.toString; + +var hasOwn = class2type.hasOwnProperty; + +var fnToString = hasOwn.toString; + +var ObjectFunctionString = fnToString.call( Object ); + +var support = {}; + +var isFunction = function isFunction( obj ) { + + // Support: Chrome <=57, Firefox <=52 + // In some browsers, typeof returns "function" for HTML elements + // (i.e., `typeof document.createElement( "object" ) === "function"`). + // We don't want to classify *any* DOM node as a function. + // Support: QtWeb <=3.8.5, WebKit <=534.34, wkhtmltopdf tool <=0.12.5 + // Plus for old WebKit, typeof returns "function" for HTML collections + // (e.g., `typeof document.getElementsByTagName("div") === "function"`). (gh-4756) + return typeof obj === "function" && typeof obj.nodeType !== "number" && + typeof obj.item !== "function"; + }; + + +var isWindow = function isWindow( obj ) { + return obj != null && obj === obj.window; + }; + + +var document = window.document; + + + + var preservedScriptAttributes = { + type: true, + src: true, + nonce: true, + noModule: true + }; + + function DOMEval( code, node, doc ) { + doc = doc || document; + + var i, val, + script = doc.createElement( "script" ); + + script.text = code; + if ( node ) { + for ( i in preservedScriptAttributes ) { + + // Support: Firefox 64+, Edge 18+ + // Some browsers don't support the "nonce" property on scripts. + // On the other hand, just using `getAttribute` is not enough as + // the `nonce` attribute is reset to an empty string whenever it + // becomes browsing-context connected. + // See https://github.com/whatwg/html/issues/2369 + // See https://html.spec.whatwg.org/#nonce-attributes + // The `node.getAttribute` check was added for the sake of + // `jQuery.globalEval` so that it can fake a nonce-containing node + // via an object. + val = node[ i ] || node.getAttribute && node.getAttribute( i ); + if ( val ) { + script.setAttribute( i, val ); + } + } + } + doc.head.appendChild( script ).parentNode.removeChild( script ); + } + + +function toType( obj ) { + if ( obj == null ) { + return obj + ""; + } + + // Support: Android <=2.3 only (functionish RegExp) + return typeof obj === "object" || typeof obj === "function" ? + class2type[ toString.call( obj ) ] || "object" : + typeof obj; +} +/* global Symbol */ +// Defining this global in .eslintrc.json would create a danger of using the global +// unguarded in another place, it seems safer to define global only for this module + + + +var + version = "3.6.0", + + // Define a local copy of jQuery + jQuery = function( selector, context ) { + + // The jQuery object is actually just the init constructor 'enhanced' + // Need init if jQuery is called (just allow error to be thrown if not included) + return new jQuery.fn.init( selector, context ); + }; + +jQuery.fn = jQuery.prototype = { + + // The current version of jQuery being used + jquery: version, + + constructor: jQuery, + + // The default length of a jQuery object is 0 + length: 0, + + toArray: function() { + return slice.call( this ); + }, + + // Get the Nth element in the matched element set OR + // Get the whole matched element set as a clean array + get: function( num ) { + + // Return all the elements in a clean array + if ( num == null ) { + return slice.call( this ); + } + + // Return just the one element from the set + return num < 0 ? this[ num + this.length ] : this[ num ]; + }, + + // Take an array of elements and push it onto the stack + // (returning the new matched element set) + pushStack: function( elems ) { + + // Build a new jQuery matched element set + var ret = jQuery.merge( this.constructor(), elems ); + + // Add the old object onto the stack (as a reference) + ret.prevObject = this; + + // Return the newly-formed element set + return ret; + }, + + // Execute a callback for every element in the matched set. + each: function( callback ) { + return jQuery.each( this, callback ); + }, + + map: function( callback ) { + return this.pushStack( jQuery.map( this, function( elem, i ) { + return callback.call( elem, i, elem ); + } ) ); + }, + + slice: function() { + return this.pushStack( slice.apply( this, arguments ) ); + }, + + first: function() { + return this.eq( 0 ); + }, + + last: function() { + return this.eq( -1 ); + }, + + even: function() { + return this.pushStack( jQuery.grep( this, function( _elem, i ) { + return ( i + 1 ) % 2; + } ) ); + }, + + odd: function() { + return this.pushStack( jQuery.grep( this, function( _elem, i ) { + return i % 2; + } ) ); + }, + + eq: function( i ) { + var len = this.length, + j = +i + ( i < 0 ? len : 0 ); + return this.pushStack( j >= 0 && j < len ? [ this[ j ] ] : [] ); + }, + + end: function() { + return this.prevObject || this.constructor(); + }, + + // For internal use only. + // Behaves like an Array's method, not like a jQuery method. + push: push, + sort: arr.sort, + splice: arr.splice +}; + +jQuery.extend = jQuery.fn.extend = function() { + var options, name, src, copy, copyIsArray, clone, + target = arguments[ 0 ] || {}, + i = 1, + length = arguments.length, + deep = false; + + // Handle a deep copy situation + if ( typeof target === "boolean" ) { + deep = target; + + // Skip the boolean and the target + target = arguments[ i ] || {}; + i++; + } + + // Handle case when target is a string or something (possible in deep copy) + if ( typeof target !== "object" && !isFunction( target ) ) { + target = {}; + } + + // Extend jQuery itself if only one argument is passed + if ( i === length ) { + target = this; + i--; + } + + for ( ; i < length; i++ ) { + + // Only deal with non-null/undefined values + if ( ( options = arguments[ i ] ) != null ) { + + // Extend the base object + for ( name in options ) { + copy = options[ name ]; + + // Prevent Object.prototype pollution + // Prevent never-ending loop + if ( name === "__proto__" || target === copy ) { + continue; + } + + // Recurse if we're merging plain objects or arrays + if ( deep && copy && ( jQuery.isPlainObject( copy ) || + ( copyIsArray = Array.isArray( copy ) ) ) ) { + src = target[ name ]; + + // Ensure proper type for the source value + if ( copyIsArray && !Array.isArray( src ) ) { + clone = []; + } else if ( !copyIsArray && !jQuery.isPlainObject( src ) ) { + clone = {}; + } else { + clone = src; + } + copyIsArray = false; + + // Never move original objects, clone them + target[ name ] = jQuery.extend( deep, clone, copy ); + + // Don't bring in undefined values + } else if ( copy !== undefined ) { + target[ name ] = copy; + } + } + } + } + + // Return the modified object + return target; +}; + +jQuery.extend( { + + // Unique for each copy of jQuery on the page + expando: "jQuery" + ( version + Math.random() ).replace( /\D/g, "" ), + + // Assume jQuery is ready without the ready module + isReady: true, + + error: function( msg ) { + throw new Error( msg ); + }, + + noop: function() {}, + + isPlainObject: function( obj ) { + var proto, Ctor; + + // Detect obvious negatives + // Use toString instead of jQuery.type to catch host objects + if ( !obj || toString.call( obj ) !== "[object Object]" ) { + return false; + } + + proto = getProto( obj ); + + // Objects with no prototype (e.g., `Object.create( null )`) are plain + if ( !proto ) { + return true; + } + + // Objects with prototype are plain iff they were constructed by a global Object function + Ctor = hasOwn.call( proto, "constructor" ) && proto.constructor; + return typeof Ctor === "function" && fnToString.call( Ctor ) === ObjectFunctionString; + }, + + isEmptyObject: function( obj ) { + var name; + + for ( name in obj ) { + return false; + } + return true; + }, + + // Evaluates a script in a provided context; falls back to the global one + // if not specified. + globalEval: function( code, options, doc ) { + DOMEval( code, { nonce: options && options.nonce }, doc ); + }, + + each: function( obj, callback ) { + var length, i = 0; + + if ( isArrayLike( obj ) ) { + length = obj.length; + for ( ; i < length; i++ ) { + if ( callback.call( obj[ i ], i, obj[ i ] ) === false ) { + break; + } + } + } else { + for ( i in obj ) { + if ( callback.call( obj[ i ], i, obj[ i ] ) === false ) { + break; + } + } + } + + return obj; + }, + + // results is for internal usage only + makeArray: function( arr, results ) { + var ret = results || []; + + if ( arr != null ) { + if ( isArrayLike( Object( arr ) ) ) { + jQuery.merge( ret, + typeof arr === "string" ? + [ arr ] : arr + ); + } else { + push.call( ret, arr ); + } + } + + return ret; + }, + + inArray: function( elem, arr, i ) { + return arr == null ? -1 : indexOf.call( arr, elem, i ); + }, + + // Support: Android <=4.0 only, PhantomJS 1 only + // push.apply(_, arraylike) throws on ancient WebKit + merge: function( first, second ) { + var len = +second.length, + j = 0, + i = first.length; + + for ( ; j < len; j++ ) { + first[ i++ ] = second[ j ]; + } + + first.length = i; + + return first; + }, + + grep: function( elems, callback, invert ) { + var callbackInverse, + matches = [], + i = 0, + length = elems.length, + callbackExpect = !invert; + + // Go through the array, only saving the items + // that pass the validator function + for ( ; i < length; i++ ) { + callbackInverse = !callback( elems[ i ], i ); + if ( callbackInverse !== callbackExpect ) { + matches.push( elems[ i ] ); + } + } + + return matches; + }, + + // arg is for internal usage only + map: function( elems, callback, arg ) { + var length, value, + i = 0, + ret = []; + + // Go through the array, translating each of the items to their new values + if ( isArrayLike( elems ) ) { + length = elems.length; + for ( ; i < length; i++ ) { + value = callback( elems[ i ], i, arg ); + + if ( value != null ) { + ret.push( value ); + } + } + + // Go through every key on the object, + } else { + for ( i in elems ) { + value = callback( elems[ i ], i, arg ); + + if ( value != null ) { + ret.push( value ); + } + } + } + + // Flatten any nested arrays + return flat( ret ); + }, + + // A global GUID counter for objects + guid: 1, + + // jQuery.support is not used in Core but other projects attach their + // properties to it so it needs to exist. + support: support +} ); + +if ( typeof Symbol === "function" ) { + jQuery.fn[ Symbol.iterator ] = arr[ Symbol.iterator ]; +} + +// Populate the class2type map +jQuery.each( "Boolean Number String Function Array Date RegExp Object Error Symbol".split( " " ), + function( _i, name ) { + class2type[ "[object " + name + "]" ] = name.toLowerCase(); + } ); + +function isArrayLike( obj ) { + + // Support: real iOS 8.2 only (not reproducible in simulator) + // `in` check used to prevent JIT error (gh-2145) + // hasOwn isn't used here due to false negatives + // regarding Nodelist length in IE + var length = !!obj && "length" in obj && obj.length, + type = toType( obj ); + + if ( isFunction( obj ) || isWindow( obj ) ) { + return false; + } + + return type === "array" || length === 0 || + typeof length === "number" && length > 0 && ( length - 1 ) in obj; +} +var Sizzle = +/*! + * Sizzle CSS Selector Engine v2.3.6 + * https://sizzlejs.com/ + * + * Copyright JS Foundation and other contributors + * Released under the MIT license + * https://js.foundation/ + * + * Date: 2021-02-16 + */ +( function( window ) { +var i, + support, + Expr, + getText, + isXML, + tokenize, + compile, + select, + outermostContext, + sortInput, + hasDuplicate, + + // Local document vars + setDocument, + document, + docElem, + documentIsHTML, + rbuggyQSA, + rbuggyMatches, + matches, + contains, + + // Instance-specific data + expando = "sizzle" + 1 * new Date(), + preferredDoc = window.document, + dirruns = 0, + done = 0, + classCache = createCache(), + tokenCache = createCache(), + compilerCache = createCache(), + nonnativeSelectorCache = createCache(), + sortOrder = function( a, b ) { + if ( a === b ) { + hasDuplicate = true; + } + return 0; + }, + + // Instance methods + hasOwn = ( {} ).hasOwnProperty, + arr = [], + pop = arr.pop, + pushNative = arr.push, + push = arr.push, + slice = arr.slice, + + // Use a stripped-down indexOf as it's faster than native + // https://jsperf.com/thor-indexof-vs-for/5 + indexOf = function( list, elem ) { + var i = 0, + len = list.length; + for ( ; i < len; i++ ) { + if ( list[ i ] === elem ) { + return i; + } + } + return -1; + }, + + booleans = "checked|selected|async|autofocus|autoplay|controls|defer|disabled|hidden|" + + "ismap|loop|multiple|open|readonly|required|scoped", + + // Regular expressions + + // http://www.w3.org/TR/css3-selectors/#whitespace + whitespace = "[\\x20\\t\\r\\n\\f]", + + // https://www.w3.org/TR/css-syntax-3/#ident-token-diagram + identifier = "(?:\\\\[\\da-fA-F]{1,6}" + whitespace + + "?|\\\\[^\\r\\n\\f]|[\\w-]|[^\0-\\x7f])+", + + // Attribute selectors: http://www.w3.org/TR/selectors/#attribute-selectors + attributes = "\\[" + whitespace + "*(" + identifier + ")(?:" + whitespace + + + // Operator (capture 2) + "*([*^$|!~]?=)" + whitespace + + + // "Attribute values must be CSS identifiers [capture 5] + // or strings [capture 3 or capture 4]" + "*(?:'((?:\\\\.|[^\\\\'])*)'|\"((?:\\\\.|[^\\\\\"])*)\"|(" + identifier + "))|)" + + whitespace + "*\\]", + + pseudos = ":(" + identifier + ")(?:\\((" + + + // To reduce the number of selectors needing tokenize in the preFilter, prefer arguments: + // 1. quoted (capture 3; capture 4 or capture 5) + "('((?:\\\\.|[^\\\\'])*)'|\"((?:\\\\.|[^\\\\\"])*)\")|" + + + // 2. simple (capture 6) + "((?:\\\\.|[^\\\\()[\\]]|" + attributes + ")*)|" + + + // 3. anything else (capture 2) + ".*" + + ")\\)|)", + + // Leading and non-escaped trailing whitespace, capturing some non-whitespace characters preceding the latter + rwhitespace = new RegExp( whitespace + "+", "g" ), + rtrim = new RegExp( "^" + whitespace + "+|((?:^|[^\\\\])(?:\\\\.)*)" + + whitespace + "+$", "g" ), + + rcomma = new RegExp( "^" + whitespace + "*," + whitespace + "*" ), + rcombinators = new RegExp( "^" + whitespace + "*([>+~]|" + whitespace + ")" + whitespace + + "*" ), + rdescend = new RegExp( whitespace + "|>" ), + + rpseudo = new RegExp( pseudos ), + ridentifier = new RegExp( "^" + identifier + "$" ), + + matchExpr = { + "ID": new RegExp( "^#(" + identifier + ")" ), + "CLASS": new RegExp( "^\\.(" + identifier + ")" ), + "TAG": new RegExp( "^(" + identifier + "|[*])" ), + "ATTR": new RegExp( "^" + attributes ), + "PSEUDO": new RegExp( "^" + pseudos ), + "CHILD": new RegExp( "^:(only|first|last|nth|nth-last)-(child|of-type)(?:\\(" + + whitespace + "*(even|odd|(([+-]|)(\\d*)n|)" + whitespace + "*(?:([+-]|)" + + whitespace + "*(\\d+)|))" + whitespace + "*\\)|)", "i" ), + "bool": new RegExp( "^(?:" + booleans + ")$", "i" ), + + // For use in libraries implementing .is() + // We use this for POS matching in `select` + "needsContext": new RegExp( "^" + whitespace + + "*[>+~]|:(even|odd|eq|gt|lt|nth|first|last)(?:\\(" + whitespace + + "*((?:-\\d)?\\d*)" + whitespace + "*\\)|)(?=[^-]|$)", "i" ) + }, + + rhtml = /HTML$/i, + rinputs = /^(?:input|select|textarea|button)$/i, + rheader = /^h\d$/i, + + rnative = /^[^{]+\{\s*\[native \w/, + + // Easily-parseable/retrievable ID or TAG or CLASS selectors + rquickExpr = /^(?:#([\w-]+)|(\w+)|\.([\w-]+))$/, + + rsibling = /[+~]/, + + // CSS escapes + // http://www.w3.org/TR/CSS21/syndata.html#escaped-characters + runescape = new RegExp( "\\\\[\\da-fA-F]{1,6}" + whitespace + "?|\\\\([^\\r\\n\\f])", "g" ), + funescape = function( escape, nonHex ) { + var high = "0x" + escape.slice( 1 ) - 0x10000; + + return nonHex ? + + // Strip the backslash prefix from a non-hex escape sequence + nonHex : + + // Replace a hexadecimal escape sequence with the encoded Unicode code point + // Support: IE <=11+ + // For values outside the Basic Multilingual Plane (BMP), manually construct a + // surrogate pair + high < 0 ? + String.fromCharCode( high + 0x10000 ) : + String.fromCharCode( high >> 10 | 0xD800, high & 0x3FF | 0xDC00 ); + }, + + // CSS string/identifier serialization + // https://drafts.csswg.org/cssom/#common-serializing-idioms + rcssescape = /([\0-\x1f\x7f]|^-?\d)|^-$|[^\0-\x1f\x7f-\uFFFF\w-]/g, + fcssescape = function( ch, asCodePoint ) { + if ( asCodePoint ) { + + // U+0000 NULL becomes U+FFFD REPLACEMENT CHARACTER + if ( ch === "\0" ) { + return "\uFFFD"; + } + + // Control characters and (dependent upon position) numbers get escaped as code points + return ch.slice( 0, -1 ) + "\\" + + ch.charCodeAt( ch.length - 1 ).toString( 16 ) + " "; + } + + // Other potentially-special ASCII characters get backslash-escaped + return "\\" + ch; + }, + + // Used for iframes + // See setDocument() + // Removing the function wrapper causes a "Permission Denied" + // error in IE + unloadHandler = function() { + setDocument(); + }, + + inDisabledFieldset = addCombinator( + function( elem ) { + return elem.disabled === true && elem.nodeName.toLowerCase() === "fieldset"; + }, + { dir: "parentNode", next: "legend" } + ); + +// Optimize for push.apply( _, NodeList ) +try { + push.apply( + ( arr = slice.call( preferredDoc.childNodes ) ), + preferredDoc.childNodes + ); + + // Support: Android<4.0 + // Detect silently failing push.apply + // eslint-disable-next-line no-unused-expressions + arr[ preferredDoc.childNodes.length ].nodeType; +} catch ( e ) { + push = { apply: arr.length ? + + // Leverage slice if possible + function( target, els ) { + pushNative.apply( target, slice.call( els ) ); + } : + + // Support: IE<9 + // Otherwise append directly + function( target, els ) { + var j = target.length, + i = 0; + + // Can't trust NodeList.length + while ( ( target[ j++ ] = els[ i++ ] ) ) {} + target.length = j - 1; + } + }; +} + +function Sizzle( selector, context, results, seed ) { + var m, i, elem, nid, match, groups, newSelector, + newContext = context && context.ownerDocument, + + // nodeType defaults to 9, since context defaults to document + nodeType = context ? context.nodeType : 9; + + results = results || []; + + // Return early from calls with invalid selector or context + if ( typeof selector !== "string" || !selector || + nodeType !== 1 && nodeType !== 9 && nodeType !== 11 ) { + + return results; + } + + // Try to shortcut find operations (as opposed to filters) in HTML documents + if ( !seed ) { + setDocument( context ); + context = context || document; + + if ( documentIsHTML ) { + + // If the selector is sufficiently simple, try using a "get*By*" DOM method + // (excepting DocumentFragment context, where the methods don't exist) + if ( nodeType !== 11 && ( match = rquickExpr.exec( selector ) ) ) { + + // ID selector + if ( ( m = match[ 1 ] ) ) { + + // Document context + if ( nodeType === 9 ) { + if ( ( elem = context.getElementById( m ) ) ) { + + // Support: IE, Opera, Webkit + // TODO: identify versions + // getElementById can match elements by name instead of ID + if ( elem.id === m ) { + results.push( elem ); + return results; + } + } else { + return results; + } + + // Element context + } else { + + // Support: IE, Opera, Webkit + // TODO: identify versions + // getElementById can match elements by name instead of ID + if ( newContext && ( elem = newContext.getElementById( m ) ) && + contains( context, elem ) && + elem.id === m ) { + + results.push( elem ); + return results; + } + } + + // Type selector + } else if ( match[ 2 ] ) { + push.apply( results, context.getElementsByTagName( selector ) ); + return results; + + // Class selector + } else if ( ( m = match[ 3 ] ) && support.getElementsByClassName && + context.getElementsByClassName ) { + + push.apply( results, context.getElementsByClassName( m ) ); + return results; + } + } + + // Take advantage of querySelectorAll + if ( support.qsa && + !nonnativeSelectorCache[ selector + " " ] && + ( !rbuggyQSA || !rbuggyQSA.test( selector ) ) && + + // Support: IE 8 only + // Exclude object elements + ( nodeType !== 1 || context.nodeName.toLowerCase() !== "object" ) ) { + + newSelector = selector; + newContext = context; + + // qSA considers elements outside a scoping root when evaluating child or + // descendant combinators, which is not what we want. + // In such cases, we work around the behavior by prefixing every selector in the + // list with an ID selector referencing the scope context. + // The technique has to be used as well when a leading combinator is used + // as such selectors are not recognized by querySelectorAll. + // Thanks to Andrew Dupont for this technique. + if ( nodeType === 1 && + ( rdescend.test( selector ) || rcombinators.test( selector ) ) ) { + + // Expand context for sibling selectors + newContext = rsibling.test( selector ) && testContext( context.parentNode ) || + context; + + // We can use :scope instead of the ID hack if the browser + // supports it & if we're not changing the context. + if ( newContext !== context || !support.scope ) { + + // Capture the context ID, setting it first if necessary + if ( ( nid = context.getAttribute( "id" ) ) ) { + nid = nid.replace( rcssescape, fcssescape ); + } else { + context.setAttribute( "id", ( nid = expando ) ); + } + } + + // Prefix every selector in the list + groups = tokenize( selector ); + i = groups.length; + while ( i-- ) { + groups[ i ] = ( nid ? "#" + nid : ":scope" ) + " " + + toSelector( groups[ i ] ); + } + newSelector = groups.join( "," ); + } + + try { + push.apply( results, + newContext.querySelectorAll( newSelector ) + ); + return results; + } catch ( qsaError ) { + nonnativeSelectorCache( selector, true ); + } finally { + if ( nid === expando ) { + context.removeAttribute( "id" ); + } + } + } + } + } + + // All others + return select( selector.replace( rtrim, "$1" ), context, results, seed ); +} + +/** + * Create key-value caches of limited size + * @returns {function(string, object)} Returns the Object data after storing it on itself with + * property name the (space-suffixed) string and (if the cache is larger than Expr.cacheLength) + * deleting the oldest entry + */ +function createCache() { + var keys = []; + + function cache( key, value ) { + + // Use (key + " ") to avoid collision with native prototype properties (see Issue #157) + if ( keys.push( key + " " ) > Expr.cacheLength ) { + + // Only keep the most recent entries + delete cache[ keys.shift() ]; + } + return ( cache[ key + " " ] = value ); + } + return cache; +} + +/** + * Mark a function for special use by Sizzle + * @param {Function} fn The function to mark + */ +function markFunction( fn ) { + fn[ expando ] = true; + return fn; +} + +/** + * Support testing using an element + * @param {Function} fn Passed the created element and returns a boolean result + */ +function assert( fn ) { + var el = document.createElement( "fieldset" ); + + try { + return !!fn( el ); + } catch ( e ) { + return false; + } finally { + + // Remove from its parent by default + if ( el.parentNode ) { + el.parentNode.removeChild( el ); + } + + // release memory in IE + el = null; + } +} + +/** + * Adds the same handler for all of the specified attrs + * @param {String} attrs Pipe-separated list of attributes + * @param {Function} handler The method that will be applied + */ +function addHandle( attrs, handler ) { + var arr = attrs.split( "|" ), + i = arr.length; + + while ( i-- ) { + Expr.attrHandle[ arr[ i ] ] = handler; + } +} + +/** + * Checks document order of two siblings + * @param {Element} a + * @param {Element} b + * @returns {Number} Returns less than 0 if a precedes b, greater than 0 if a follows b + */ +function siblingCheck( a, b ) { + var cur = b && a, + diff = cur && a.nodeType === 1 && b.nodeType === 1 && + a.sourceIndex - b.sourceIndex; + + // Use IE sourceIndex if available on both nodes + if ( diff ) { + return diff; + } + + // Check if b follows a + if ( cur ) { + while ( ( cur = cur.nextSibling ) ) { + if ( cur === b ) { + return -1; + } + } + } + + return a ? 1 : -1; +} + +/** + * Returns a function to use in pseudos for input types + * @param {String} type + */ +function createInputPseudo( type ) { + return function( elem ) { + var name = elem.nodeName.toLowerCase(); + return name === "input" && elem.type === type; + }; +} + +/** + * Returns a function to use in pseudos for buttons + * @param {String} type + */ +function createButtonPseudo( type ) { + return function( elem ) { + var name = elem.nodeName.toLowerCase(); + return ( name === "input" || name === "button" ) && elem.type === type; + }; +} + +/** + * Returns a function to use in pseudos for :enabled/:disabled + * @param {Boolean} disabled true for :disabled; false for :enabled + */ +function createDisabledPseudo( disabled ) { + + // Known :disabled false positives: fieldset[disabled] > legend:nth-of-type(n+2) :can-disable + return function( elem ) { + + // Only certain elements can match :enabled or :disabled + // https://html.spec.whatwg.org/multipage/scripting.html#selector-enabled + // https://html.spec.whatwg.org/multipage/scripting.html#selector-disabled + if ( "form" in elem ) { + + // Check for inherited disabledness on relevant non-disabled elements: + // * listed form-associated elements in a disabled fieldset + // https://html.spec.whatwg.org/multipage/forms.html#category-listed + // https://html.spec.whatwg.org/multipage/forms.html#concept-fe-disabled + // * option elements in a disabled optgroup + // https://html.spec.whatwg.org/multipage/forms.html#concept-option-disabled + // All such elements have a "form" property. + if ( elem.parentNode && elem.disabled === false ) { + + // Option elements defer to a parent optgroup if present + if ( "label" in elem ) { + if ( "label" in elem.parentNode ) { + return elem.parentNode.disabled === disabled; + } else { + return elem.disabled === disabled; + } + } + + // Support: IE 6 - 11 + // Use the isDisabled shortcut property to check for disabled fieldset ancestors + return elem.isDisabled === disabled || + + // Where there is no isDisabled, check manually + /* jshint -W018 */ + elem.isDisabled !== !disabled && + inDisabledFieldset( elem ) === disabled; + } + + return elem.disabled === disabled; + + // Try to winnow out elements that can't be disabled before trusting the disabled property. + // Some victims get caught in our net (label, legend, menu, track), but it shouldn't + // even exist on them, let alone have a boolean value. + } else if ( "label" in elem ) { + return elem.disabled === disabled; + } + + // Remaining elements are neither :enabled nor :disabled + return false; + }; +} + +/** + * Returns a function to use in pseudos for positionals + * @param {Function} fn + */ +function createPositionalPseudo( fn ) { + return markFunction( function( argument ) { + argument = +argument; + return markFunction( function( seed, matches ) { + var j, + matchIndexes = fn( [], seed.length, argument ), + i = matchIndexes.length; + + // Match elements found at the specified indexes + while ( i-- ) { + if ( seed[ ( j = matchIndexes[ i ] ) ] ) { + seed[ j ] = !( matches[ j ] = seed[ j ] ); + } + } + } ); + } ); +} + +/** + * Checks a node for validity as a Sizzle context + * @param {Element|Object=} context + * @returns {Element|Object|Boolean} The input node if acceptable, otherwise a falsy value + */ +function testContext( context ) { + return context && typeof context.getElementsByTagName !== "undefined" && context; +} + +// Expose support vars for convenience +support = Sizzle.support = {}; + +/** + * Detects XML nodes + * @param {Element|Object} elem An element or a document + * @returns {Boolean} True iff elem is a non-HTML XML node + */ +isXML = Sizzle.isXML = function( elem ) { + var namespace = elem && elem.namespaceURI, + docElem = elem && ( elem.ownerDocument || elem ).documentElement; + + // Support: IE <=8 + // Assume HTML when documentElement doesn't yet exist, such as inside loading iframes + // https://bugs.jquery.com/ticket/4833 + return !rhtml.test( namespace || docElem && docElem.nodeName || "HTML" ); +}; + +/** + * Sets document-related variables once based on the current document + * @param {Element|Object} [doc] An element or document object to use to set the document + * @returns {Object} Returns the current document + */ +setDocument = Sizzle.setDocument = function( node ) { + var hasCompare, subWindow, + doc = node ? node.ownerDocument || node : preferredDoc; + + // Return early if doc is invalid or already selected + // Support: IE 11+, Edge 17 - 18+ + // IE/Edge sometimes throw a "Permission denied" error when strict-comparing + // two documents; shallow comparisons work. + // eslint-disable-next-line eqeqeq + if ( doc == document || doc.nodeType !== 9 || !doc.documentElement ) { + return document; + } + + // Update global variables + document = doc; + docElem = document.documentElement; + documentIsHTML = !isXML( document ); + + // Support: IE 9 - 11+, Edge 12 - 18+ + // Accessing iframe documents after unload throws "permission denied" errors (jQuery #13936) + // Support: IE 11+, Edge 17 - 18+ + // IE/Edge sometimes throw a "Permission denied" error when strict-comparing + // two documents; shallow comparisons work. + // eslint-disable-next-line eqeqeq + if ( preferredDoc != document && + ( subWindow = document.defaultView ) && subWindow.top !== subWindow ) { + + // Support: IE 11, Edge + if ( subWindow.addEventListener ) { + subWindow.addEventListener( "unload", unloadHandler, false ); + + // Support: IE 9 - 10 only + } else if ( subWindow.attachEvent ) { + subWindow.attachEvent( "onunload", unloadHandler ); + } + } + + // Support: IE 8 - 11+, Edge 12 - 18+, Chrome <=16 - 25 only, Firefox <=3.6 - 31 only, + // Safari 4 - 5 only, Opera <=11.6 - 12.x only + // IE/Edge & older browsers don't support the :scope pseudo-class. + // Support: Safari 6.0 only + // Safari 6.0 supports :scope but it's an alias of :root there. + support.scope = assert( function( el ) { + docElem.appendChild( el ).appendChild( document.createElement( "div" ) ); + return typeof el.querySelectorAll !== "undefined" && + !el.querySelectorAll( ":scope fieldset div" ).length; + } ); + + /* Attributes + ---------------------------------------------------------------------- */ + + // Support: IE<8 + // Verify that getAttribute really returns attributes and not properties + // (excepting IE8 booleans) + support.attributes = assert( function( el ) { + el.className = "i"; + return !el.getAttribute( "className" ); + } ); + + /* getElement(s)By* + ---------------------------------------------------------------------- */ + + // Check if getElementsByTagName("*") returns only elements + support.getElementsByTagName = assert( function( el ) { + el.appendChild( document.createComment( "" ) ); + return !el.getElementsByTagName( "*" ).length; + } ); + + // Support: IE<9 + support.getElementsByClassName = rnative.test( document.getElementsByClassName ); + + // Support: IE<10 + // Check if getElementById returns elements by name + // The broken getElementById methods don't pick up programmatically-set names, + // so use a roundabout getElementsByName test + support.getById = assert( function( el ) { + docElem.appendChild( el ).id = expando; + return !document.getElementsByName || !document.getElementsByName( expando ).length; + } ); + + // ID filter and find + if ( support.getById ) { + Expr.filter[ "ID" ] = function( id ) { + var attrId = id.replace( runescape, funescape ); + return function( elem ) { + return elem.getAttribute( "id" ) === attrId; + }; + }; + Expr.find[ "ID" ] = function( id, context ) { + if ( typeof context.getElementById !== "undefined" && documentIsHTML ) { + var elem = context.getElementById( id ); + return elem ? [ elem ] : []; + } + }; + } else { + Expr.filter[ "ID" ] = function( id ) { + var attrId = id.replace( runescape, funescape ); + return function( elem ) { + var node = typeof elem.getAttributeNode !== "undefined" && + elem.getAttributeNode( "id" ); + return node && node.value === attrId; + }; + }; + + // Support: IE 6 - 7 only + // getElementById is not reliable as a find shortcut + Expr.find[ "ID" ] = function( id, context ) { + if ( typeof context.getElementById !== "undefined" && documentIsHTML ) { + var node, i, elems, + elem = context.getElementById( id ); + + if ( elem ) { + + // Verify the id attribute + node = elem.getAttributeNode( "id" ); + if ( node && node.value === id ) { + return [ elem ]; + } + + // Fall back on getElementsByName + elems = context.getElementsByName( id ); + i = 0; + while ( ( elem = elems[ i++ ] ) ) { + node = elem.getAttributeNode( "id" ); + if ( node && node.value === id ) { + return [ elem ]; + } + } + } + + return []; + } + }; + } + + // Tag + Expr.find[ "TAG" ] = support.getElementsByTagName ? + function( tag, context ) { + if ( typeof context.getElementsByTagName !== "undefined" ) { + return context.getElementsByTagName( tag ); + + // DocumentFragment nodes don't have gEBTN + } else if ( support.qsa ) { + return context.querySelectorAll( tag ); + } + } : + + function( tag, context ) { + var elem, + tmp = [], + i = 0, + + // By happy coincidence, a (broken) gEBTN appears on DocumentFragment nodes too + results = context.getElementsByTagName( tag ); + + // Filter out possible comments + if ( tag === "*" ) { + while ( ( elem = results[ i++ ] ) ) { + if ( elem.nodeType === 1 ) { + tmp.push( elem ); + } + } + + return tmp; + } + return results; + }; + + // Class + Expr.find[ "CLASS" ] = support.getElementsByClassName && function( className, context ) { + if ( typeof context.getElementsByClassName !== "undefined" && documentIsHTML ) { + return context.getElementsByClassName( className ); + } + }; + + /* QSA/matchesSelector + ---------------------------------------------------------------------- */ + + // QSA and matchesSelector support + + // matchesSelector(:active) reports false when true (IE9/Opera 11.5) + rbuggyMatches = []; + + // qSa(:focus) reports false when true (Chrome 21) + // We allow this because of a bug in IE8/9 that throws an error + // whenever `document.activeElement` is accessed on an iframe + // So, we allow :focus to pass through QSA all the time to avoid the IE error + // See https://bugs.jquery.com/ticket/13378 + rbuggyQSA = []; + + if ( ( support.qsa = rnative.test( document.querySelectorAll ) ) ) { + + // Build QSA regex + // Regex strategy adopted from Diego Perini + assert( function( el ) { + + var input; + + // Select is set to empty string on purpose + // This is to test IE's treatment of not explicitly + // setting a boolean content attribute, + // since its presence should be enough + // https://bugs.jquery.com/ticket/12359 + docElem.appendChild( el ).innerHTML = "" + + ""; + + // Support: IE8, Opera 11-12.16 + // Nothing should be selected when empty strings follow ^= or $= or *= + // The test attribute must be unknown in Opera but "safe" for WinRT + // https://msdn.microsoft.com/en-us/library/ie/hh465388.aspx#attribute_section + if ( el.querySelectorAll( "[msallowcapture^='']" ).length ) { + rbuggyQSA.push( "[*^$]=" + whitespace + "*(?:''|\"\")" ); + } + + // Support: IE8 + // Boolean attributes and "value" are not treated correctly + if ( !el.querySelectorAll( "[selected]" ).length ) { + rbuggyQSA.push( "\\[" + whitespace + "*(?:value|" + booleans + ")" ); + } + + // Support: Chrome<29, Android<4.4, Safari<7.0+, iOS<7.0+, PhantomJS<1.9.8+ + if ( !el.querySelectorAll( "[id~=" + expando + "-]" ).length ) { + rbuggyQSA.push( "~=" ); + } + + // Support: IE 11+, Edge 15 - 18+ + // IE 11/Edge don't find elements on a `[name='']` query in some cases. + // Adding a temporary attribute to the document before the selection works + // around the issue. + // Interestingly, IE 10 & older don't seem to have the issue. + input = document.createElement( "input" ); + input.setAttribute( "name", "" ); + el.appendChild( input ); + if ( !el.querySelectorAll( "[name='']" ).length ) { + rbuggyQSA.push( "\\[" + whitespace + "*name" + whitespace + "*=" + + whitespace + "*(?:''|\"\")" ); + } + + // Webkit/Opera - :checked should return selected option elements + // http://www.w3.org/TR/2011/REC-css3-selectors-20110929/#checked + // IE8 throws error here and will not see later tests + if ( !el.querySelectorAll( ":checked" ).length ) { + rbuggyQSA.push( ":checked" ); + } + + // Support: Safari 8+, iOS 8+ + // https://bugs.webkit.org/show_bug.cgi?id=136851 + // In-page `selector#id sibling-combinator selector` fails + if ( !el.querySelectorAll( "a#" + expando + "+*" ).length ) { + rbuggyQSA.push( ".#.+[+~]" ); + } + + // Support: Firefox <=3.6 - 5 only + // Old Firefox doesn't throw on a badly-escaped identifier. + el.querySelectorAll( "\\\f" ); + rbuggyQSA.push( "[\\r\\n\\f]" ); + } ); + + assert( function( el ) { + el.innerHTML = "" + + ""; + + // Support: Windows 8 Native Apps + // The type and name attributes are restricted during .innerHTML assignment + var input = document.createElement( "input" ); + input.setAttribute( "type", "hidden" ); + el.appendChild( input ).setAttribute( "name", "D" ); + + // Support: IE8 + // Enforce case-sensitivity of name attribute + if ( el.querySelectorAll( "[name=d]" ).length ) { + rbuggyQSA.push( "name" + whitespace + "*[*^$|!~]?=" ); + } + + // FF 3.5 - :enabled/:disabled and hidden elements (hidden elements are still enabled) + // IE8 throws error here and will not see later tests + if ( el.querySelectorAll( ":enabled" ).length !== 2 ) { + rbuggyQSA.push( ":enabled", ":disabled" ); + } + + // Support: IE9-11+ + // IE's :disabled selector does not pick up the children of disabled fieldsets + docElem.appendChild( el ).disabled = true; + if ( el.querySelectorAll( ":disabled" ).length !== 2 ) { + rbuggyQSA.push( ":enabled", ":disabled" ); + } + + // Support: Opera 10 - 11 only + // Opera 10-11 does not throw on post-comma invalid pseudos + el.querySelectorAll( "*,:x" ); + rbuggyQSA.push( ",.*:" ); + } ); + } + + if ( ( support.matchesSelector = rnative.test( ( matches = docElem.matches || + docElem.webkitMatchesSelector || + docElem.mozMatchesSelector || + docElem.oMatchesSelector || + docElem.msMatchesSelector ) ) ) ) { + + assert( function( el ) { + + // Check to see if it's possible to do matchesSelector + // on a disconnected node (IE 9) + support.disconnectedMatch = matches.call( el, "*" ); + + // This should fail with an exception + // Gecko does not error, returns false instead + matches.call( el, "[s!='']:x" ); + rbuggyMatches.push( "!=", pseudos ); + } ); + } + + rbuggyQSA = rbuggyQSA.length && new RegExp( rbuggyQSA.join( "|" ) ); + rbuggyMatches = rbuggyMatches.length && new RegExp( rbuggyMatches.join( "|" ) ); + + /* Contains + ---------------------------------------------------------------------- */ + hasCompare = rnative.test( docElem.compareDocumentPosition ); + + // Element contains another + // Purposefully self-exclusive + // As in, an element does not contain itself + contains = hasCompare || rnative.test( docElem.contains ) ? + function( a, b ) { + var adown = a.nodeType === 9 ? a.documentElement : a, + bup = b && b.parentNode; + return a === bup || !!( bup && bup.nodeType === 1 && ( + adown.contains ? + adown.contains( bup ) : + a.compareDocumentPosition && a.compareDocumentPosition( bup ) & 16 + ) ); + } : + function( a, b ) { + if ( b ) { + while ( ( b = b.parentNode ) ) { + if ( b === a ) { + return true; + } + } + } + return false; + }; + + /* Sorting + ---------------------------------------------------------------------- */ + + // Document order sorting + sortOrder = hasCompare ? + function( a, b ) { + + // Flag for duplicate removal + if ( a === b ) { + hasDuplicate = true; + return 0; + } + + // Sort on method existence if only one input has compareDocumentPosition + var compare = !a.compareDocumentPosition - !b.compareDocumentPosition; + if ( compare ) { + return compare; + } + + // Calculate position if both inputs belong to the same document + // Support: IE 11+, Edge 17 - 18+ + // IE/Edge sometimes throw a "Permission denied" error when strict-comparing + // two documents; shallow comparisons work. + // eslint-disable-next-line eqeqeq + compare = ( a.ownerDocument || a ) == ( b.ownerDocument || b ) ? + a.compareDocumentPosition( b ) : + + // Otherwise we know they are disconnected + 1; + + // Disconnected nodes + if ( compare & 1 || + ( !support.sortDetached && b.compareDocumentPosition( a ) === compare ) ) { + + // Choose the first element that is related to our preferred document + // Support: IE 11+, Edge 17 - 18+ + // IE/Edge sometimes throw a "Permission denied" error when strict-comparing + // two documents; shallow comparisons work. + // eslint-disable-next-line eqeqeq + if ( a == document || a.ownerDocument == preferredDoc && + contains( preferredDoc, a ) ) { + return -1; + } + + // Support: IE 11+, Edge 17 - 18+ + // IE/Edge sometimes throw a "Permission denied" error when strict-comparing + // two documents; shallow comparisons work. + // eslint-disable-next-line eqeqeq + if ( b == document || b.ownerDocument == preferredDoc && + contains( preferredDoc, b ) ) { + return 1; + } + + // Maintain original order + return sortInput ? + ( indexOf( sortInput, a ) - indexOf( sortInput, b ) ) : + 0; + } + + return compare & 4 ? -1 : 1; + } : + function( a, b ) { + + // Exit early if the nodes are identical + if ( a === b ) { + hasDuplicate = true; + return 0; + } + + var cur, + i = 0, + aup = a.parentNode, + bup = b.parentNode, + ap = [ a ], + bp = [ b ]; + + // Parentless nodes are either documents or disconnected + if ( !aup || !bup ) { + + // Support: IE 11+, Edge 17 - 18+ + // IE/Edge sometimes throw a "Permission denied" error when strict-comparing + // two documents; shallow comparisons work. + /* eslint-disable eqeqeq */ + return a == document ? -1 : + b == document ? 1 : + /* eslint-enable eqeqeq */ + aup ? -1 : + bup ? 1 : + sortInput ? + ( indexOf( sortInput, a ) - indexOf( sortInput, b ) ) : + 0; + + // If the nodes are siblings, we can do a quick check + } else if ( aup === bup ) { + return siblingCheck( a, b ); + } + + // Otherwise we need full lists of their ancestors for comparison + cur = a; + while ( ( cur = cur.parentNode ) ) { + ap.unshift( cur ); + } + cur = b; + while ( ( cur = cur.parentNode ) ) { + bp.unshift( cur ); + } + + // Walk down the tree looking for a discrepancy + while ( ap[ i ] === bp[ i ] ) { + i++; + } + + return i ? + + // Do a sibling check if the nodes have a common ancestor + siblingCheck( ap[ i ], bp[ i ] ) : + + // Otherwise nodes in our document sort first + // Support: IE 11+, Edge 17 - 18+ + // IE/Edge sometimes throw a "Permission denied" error when strict-comparing + // two documents; shallow comparisons work. + /* eslint-disable eqeqeq */ + ap[ i ] == preferredDoc ? -1 : + bp[ i ] == preferredDoc ? 1 : + /* eslint-enable eqeqeq */ + 0; + }; + + return document; +}; + +Sizzle.matches = function( expr, elements ) { + return Sizzle( expr, null, null, elements ); +}; + +Sizzle.matchesSelector = function( elem, expr ) { + setDocument( elem ); + + if ( support.matchesSelector && documentIsHTML && + !nonnativeSelectorCache[ expr + " " ] && + ( !rbuggyMatches || !rbuggyMatches.test( expr ) ) && + ( !rbuggyQSA || !rbuggyQSA.test( expr ) ) ) { + + try { + var ret = matches.call( elem, expr ); + + // IE 9's matchesSelector returns false on disconnected nodes + if ( ret || support.disconnectedMatch || + + // As well, disconnected nodes are said to be in a document + // fragment in IE 9 + elem.document && elem.document.nodeType !== 11 ) { + return ret; + } + } catch ( e ) { + nonnativeSelectorCache( expr, true ); + } + } + + return Sizzle( expr, document, null, [ elem ] ).length > 0; +}; + +Sizzle.contains = function( context, elem ) { + + // Set document vars if needed + // Support: IE 11+, Edge 17 - 18+ + // IE/Edge sometimes throw a "Permission denied" error when strict-comparing + // two documents; shallow comparisons work. + // eslint-disable-next-line eqeqeq + if ( ( context.ownerDocument || context ) != document ) { + setDocument( context ); + } + return contains( context, elem ); +}; + +Sizzle.attr = function( elem, name ) { + + // Set document vars if needed + // Support: IE 11+, Edge 17 - 18+ + // IE/Edge sometimes throw a "Permission denied" error when strict-comparing + // two documents; shallow comparisons work. + // eslint-disable-next-line eqeqeq + if ( ( elem.ownerDocument || elem ) != document ) { + setDocument( elem ); + } + + var fn = Expr.attrHandle[ name.toLowerCase() ], + + // Don't get fooled by Object.prototype properties (jQuery #13807) + val = fn && hasOwn.call( Expr.attrHandle, name.toLowerCase() ) ? + fn( elem, name, !documentIsHTML ) : + undefined; + + return val !== undefined ? + val : + support.attributes || !documentIsHTML ? + elem.getAttribute( name ) : + ( val = elem.getAttributeNode( name ) ) && val.specified ? + val.value : + null; +}; + +Sizzle.escape = function( sel ) { + return ( sel + "" ).replace( rcssescape, fcssescape ); +}; + +Sizzle.error = function( msg ) { + throw new Error( "Syntax error, unrecognized expression: " + msg ); +}; + +/** + * Document sorting and removing duplicates + * @param {ArrayLike} results + */ +Sizzle.uniqueSort = function( results ) { + var elem, + duplicates = [], + j = 0, + i = 0; + + // Unless we *know* we can detect duplicates, assume their presence + hasDuplicate = !support.detectDuplicates; + sortInput = !support.sortStable && results.slice( 0 ); + results.sort( sortOrder ); + + if ( hasDuplicate ) { + while ( ( elem = results[ i++ ] ) ) { + if ( elem === results[ i ] ) { + j = duplicates.push( i ); + } + } + while ( j-- ) { + results.splice( duplicates[ j ], 1 ); + } + } + + // Clear input after sorting to release objects + // See https://github.com/jquery/sizzle/pull/225 + sortInput = null; + + return results; +}; + +/** + * Utility function for retrieving the text value of an array of DOM nodes + * @param {Array|Element} elem + */ +getText = Sizzle.getText = function( elem ) { + var node, + ret = "", + i = 0, + nodeType = elem.nodeType; + + if ( !nodeType ) { + + // If no nodeType, this is expected to be an array + while ( ( node = elem[ i++ ] ) ) { + + // Do not traverse comment nodes + ret += getText( node ); + } + } else if ( nodeType === 1 || nodeType === 9 || nodeType === 11 ) { + + // Use textContent for elements + // innerText usage removed for consistency of new lines (jQuery #11153) + if ( typeof elem.textContent === "string" ) { + return elem.textContent; + } else { + + // Traverse its children + for ( elem = elem.firstChild; elem; elem = elem.nextSibling ) { + ret += getText( elem ); + } + } + } else if ( nodeType === 3 || nodeType === 4 ) { + return elem.nodeValue; + } + + // Do not include comment or processing instruction nodes + + return ret; +}; + +Expr = Sizzle.selectors = { + + // Can be adjusted by the user + cacheLength: 50, + + createPseudo: markFunction, + + match: matchExpr, + + attrHandle: {}, + + find: {}, + + relative: { + ">": { dir: "parentNode", first: true }, + " ": { dir: "parentNode" }, + "+": { dir: "previousSibling", first: true }, + "~": { dir: "previousSibling" } + }, + + preFilter: { + "ATTR": function( match ) { + match[ 1 ] = match[ 1 ].replace( runescape, funescape ); + + // Move the given value to match[3] whether quoted or unquoted + match[ 3 ] = ( match[ 3 ] || match[ 4 ] || + match[ 5 ] || "" ).replace( runescape, funescape ); + + if ( match[ 2 ] === "~=" ) { + match[ 3 ] = " " + match[ 3 ] + " "; + } + + return match.slice( 0, 4 ); + }, + + "CHILD": function( match ) { + + /* matches from matchExpr["CHILD"] + 1 type (only|nth|...) + 2 what (child|of-type) + 3 argument (even|odd|\d*|\d*n([+-]\d+)?|...) + 4 xn-component of xn+y argument ([+-]?\d*n|) + 5 sign of xn-component + 6 x of xn-component + 7 sign of y-component + 8 y of y-component + */ + match[ 1 ] = match[ 1 ].toLowerCase(); + + if ( match[ 1 ].slice( 0, 3 ) === "nth" ) { + + // nth-* requires argument + if ( !match[ 3 ] ) { + Sizzle.error( match[ 0 ] ); + } + + // numeric x and y parameters for Expr.filter.CHILD + // remember that false/true cast respectively to 0/1 + match[ 4 ] = +( match[ 4 ] ? + match[ 5 ] + ( match[ 6 ] || 1 ) : + 2 * ( match[ 3 ] === "even" || match[ 3 ] === "odd" ) ); + match[ 5 ] = +( ( match[ 7 ] + match[ 8 ] ) || match[ 3 ] === "odd" ); + + // other types prohibit arguments + } else if ( match[ 3 ] ) { + Sizzle.error( match[ 0 ] ); + } + + return match; + }, + + "PSEUDO": function( match ) { + var excess, + unquoted = !match[ 6 ] && match[ 2 ]; + + if ( matchExpr[ "CHILD" ].test( match[ 0 ] ) ) { + return null; + } + + // Accept quoted arguments as-is + if ( match[ 3 ] ) { + match[ 2 ] = match[ 4 ] || match[ 5 ] || ""; + + // Strip excess characters from unquoted arguments + } else if ( unquoted && rpseudo.test( unquoted ) && + + // Get excess from tokenize (recursively) + ( excess = tokenize( unquoted, true ) ) && + + // advance to the next closing parenthesis + ( excess = unquoted.indexOf( ")", unquoted.length - excess ) - unquoted.length ) ) { + + // excess is a negative index + match[ 0 ] = match[ 0 ].slice( 0, excess ); + match[ 2 ] = unquoted.slice( 0, excess ); + } + + // Return only captures needed by the pseudo filter method (type and argument) + return match.slice( 0, 3 ); + } + }, + + filter: { + + "TAG": function( nodeNameSelector ) { + var nodeName = nodeNameSelector.replace( runescape, funescape ).toLowerCase(); + return nodeNameSelector === "*" ? + function() { + return true; + } : + function( elem ) { + return elem.nodeName && elem.nodeName.toLowerCase() === nodeName; + }; + }, + + "CLASS": function( className ) { + var pattern = classCache[ className + " " ]; + + return pattern || + ( pattern = new RegExp( "(^|" + whitespace + + ")" + className + "(" + whitespace + "|$)" ) ) && classCache( + className, function( elem ) { + return pattern.test( + typeof elem.className === "string" && elem.className || + typeof elem.getAttribute !== "undefined" && + elem.getAttribute( "class" ) || + "" + ); + } ); + }, + + "ATTR": function( name, operator, check ) { + return function( elem ) { + var result = Sizzle.attr( elem, name ); + + if ( result == null ) { + return operator === "!="; + } + if ( !operator ) { + return true; + } + + result += ""; + + /* eslint-disable max-len */ + + return operator === "=" ? result === check : + operator === "!=" ? result !== check : + operator === "^=" ? check && result.indexOf( check ) === 0 : + operator === "*=" ? check && result.indexOf( check ) > -1 : + operator === "$=" ? check && result.slice( -check.length ) === check : + operator === "~=" ? ( " " + result.replace( rwhitespace, " " ) + " " ).indexOf( check ) > -1 : + operator === "|=" ? result === check || result.slice( 0, check.length + 1 ) === check + "-" : + false; + /* eslint-enable max-len */ + + }; + }, + + "CHILD": function( type, what, _argument, first, last ) { + var simple = type.slice( 0, 3 ) !== "nth", + forward = type.slice( -4 ) !== "last", + ofType = what === "of-type"; + + return first === 1 && last === 0 ? + + // Shortcut for :nth-*(n) + function( elem ) { + return !!elem.parentNode; + } : + + function( elem, _context, xml ) { + var cache, uniqueCache, outerCache, node, nodeIndex, start, + dir = simple !== forward ? "nextSibling" : "previousSibling", + parent = elem.parentNode, + name = ofType && elem.nodeName.toLowerCase(), + useCache = !xml && !ofType, + diff = false; + + if ( parent ) { + + // :(first|last|only)-(child|of-type) + if ( simple ) { + while ( dir ) { + node = elem; + while ( ( node = node[ dir ] ) ) { + if ( ofType ? + node.nodeName.toLowerCase() === name : + node.nodeType === 1 ) { + + return false; + } + } + + // Reverse direction for :only-* (if we haven't yet done so) + start = dir = type === "only" && !start && "nextSibling"; + } + return true; + } + + start = [ forward ? parent.firstChild : parent.lastChild ]; + + // non-xml :nth-child(...) stores cache data on `parent` + if ( forward && useCache ) { + + // Seek `elem` from a previously-cached index + + // ...in a gzip-friendly way + node = parent; + outerCache = node[ expando ] || ( node[ expando ] = {} ); + + // Support: IE <9 only + // Defend against cloned attroperties (jQuery gh-1709) + uniqueCache = outerCache[ node.uniqueID ] || + ( outerCache[ node.uniqueID ] = {} ); + + cache = uniqueCache[ type ] || []; + nodeIndex = cache[ 0 ] === dirruns && cache[ 1 ]; + diff = nodeIndex && cache[ 2 ]; + node = nodeIndex && parent.childNodes[ nodeIndex ]; + + while ( ( node = ++nodeIndex && node && node[ dir ] || + + // Fallback to seeking `elem` from the start + ( diff = nodeIndex = 0 ) || start.pop() ) ) { + + // When found, cache indexes on `parent` and break + if ( node.nodeType === 1 && ++diff && node === elem ) { + uniqueCache[ type ] = [ dirruns, nodeIndex, diff ]; + break; + } + } + + } else { + + // Use previously-cached element index if available + if ( useCache ) { + + // ...in a gzip-friendly way + node = elem; + outerCache = node[ expando ] || ( node[ expando ] = {} ); + + // Support: IE <9 only + // Defend against cloned attroperties (jQuery gh-1709) + uniqueCache = outerCache[ node.uniqueID ] || + ( outerCache[ node.uniqueID ] = {} ); + + cache = uniqueCache[ type ] || []; + nodeIndex = cache[ 0 ] === dirruns && cache[ 1 ]; + diff = nodeIndex; + } + + // xml :nth-child(...) + // or :nth-last-child(...) or :nth(-last)?-of-type(...) + if ( diff === false ) { + + // Use the same loop as above to seek `elem` from the start + while ( ( node = ++nodeIndex && node && node[ dir ] || + ( diff = nodeIndex = 0 ) || start.pop() ) ) { + + if ( ( ofType ? + node.nodeName.toLowerCase() === name : + node.nodeType === 1 ) && + ++diff ) { + + // Cache the index of each encountered element + if ( useCache ) { + outerCache = node[ expando ] || + ( node[ expando ] = {} ); + + // Support: IE <9 only + // Defend against cloned attroperties (jQuery gh-1709) + uniqueCache = outerCache[ node.uniqueID ] || + ( outerCache[ node.uniqueID ] = {} ); + + uniqueCache[ type ] = [ dirruns, diff ]; + } + + if ( node === elem ) { + break; + } + } + } + } + } + + // Incorporate the offset, then check against cycle size + diff -= last; + return diff === first || ( diff % first === 0 && diff / first >= 0 ); + } + }; + }, + + "PSEUDO": function( pseudo, argument ) { + + // pseudo-class names are case-insensitive + // http://www.w3.org/TR/selectors/#pseudo-classes + // Prioritize by case sensitivity in case custom pseudos are added with uppercase letters + // Remember that setFilters inherits from pseudos + var args, + fn = Expr.pseudos[ pseudo ] || Expr.setFilters[ pseudo.toLowerCase() ] || + Sizzle.error( "unsupported pseudo: " + pseudo ); + + // The user may use createPseudo to indicate that + // arguments are needed to create the filter function + // just as Sizzle does + if ( fn[ expando ] ) { + return fn( argument ); + } + + // But maintain support for old signatures + if ( fn.length > 1 ) { + args = [ pseudo, pseudo, "", argument ]; + return Expr.setFilters.hasOwnProperty( pseudo.toLowerCase() ) ? + markFunction( function( seed, matches ) { + var idx, + matched = fn( seed, argument ), + i = matched.length; + while ( i-- ) { + idx = indexOf( seed, matched[ i ] ); + seed[ idx ] = !( matches[ idx ] = matched[ i ] ); + } + } ) : + function( elem ) { + return fn( elem, 0, args ); + }; + } + + return fn; + } + }, + + pseudos: { + + // Potentially complex pseudos + "not": markFunction( function( selector ) { + + // Trim the selector passed to compile + // to avoid treating leading and trailing + // spaces as combinators + var input = [], + results = [], + matcher = compile( selector.replace( rtrim, "$1" ) ); + + return matcher[ expando ] ? + markFunction( function( seed, matches, _context, xml ) { + var elem, + unmatched = matcher( seed, null, xml, [] ), + i = seed.length; + + // Match elements unmatched by `matcher` + while ( i-- ) { + if ( ( elem = unmatched[ i ] ) ) { + seed[ i ] = !( matches[ i ] = elem ); + } + } + } ) : + function( elem, _context, xml ) { + input[ 0 ] = elem; + matcher( input, null, xml, results ); + + // Don't keep the element (issue #299) + input[ 0 ] = null; + return !results.pop(); + }; + } ), + + "has": markFunction( function( selector ) { + return function( elem ) { + return Sizzle( selector, elem ).length > 0; + }; + } ), + + "contains": markFunction( function( text ) { + text = text.replace( runescape, funescape ); + return function( elem ) { + return ( elem.textContent || getText( elem ) ).indexOf( text ) > -1; + }; + } ), + + // "Whether an element is represented by a :lang() selector + // is based solely on the element's language value + // being equal to the identifier C, + // or beginning with the identifier C immediately followed by "-". + // The matching of C against the element's language value is performed case-insensitively. + // The identifier C does not have to be a valid language name." + // http://www.w3.org/TR/selectors/#lang-pseudo + "lang": markFunction( function( lang ) { + + // lang value must be a valid identifier + if ( !ridentifier.test( lang || "" ) ) { + Sizzle.error( "unsupported lang: " + lang ); + } + lang = lang.replace( runescape, funescape ).toLowerCase(); + return function( elem ) { + var elemLang; + do { + if ( ( elemLang = documentIsHTML ? + elem.lang : + elem.getAttribute( "xml:lang" ) || elem.getAttribute( "lang" ) ) ) { + + elemLang = elemLang.toLowerCase(); + return elemLang === lang || elemLang.indexOf( lang + "-" ) === 0; + } + } while ( ( elem = elem.parentNode ) && elem.nodeType === 1 ); + return false; + }; + } ), + + // Miscellaneous + "target": function( elem ) { + var hash = window.location && window.location.hash; + return hash && hash.slice( 1 ) === elem.id; + }, + + "root": function( elem ) { + return elem === docElem; + }, + + "focus": function( elem ) { + return elem === document.activeElement && + ( !document.hasFocus || document.hasFocus() ) && + !!( elem.type || elem.href || ~elem.tabIndex ); + }, + + // Boolean properties + "enabled": createDisabledPseudo( false ), + "disabled": createDisabledPseudo( true ), + + "checked": function( elem ) { + + // In CSS3, :checked should return both checked and selected elements + // http://www.w3.org/TR/2011/REC-css3-selectors-20110929/#checked + var nodeName = elem.nodeName.toLowerCase(); + return ( nodeName === "input" && !!elem.checked ) || + ( nodeName === "option" && !!elem.selected ); + }, + + "selected": function( elem ) { + + // Accessing this property makes selected-by-default + // options in Safari work properly + if ( elem.parentNode ) { + // eslint-disable-next-line no-unused-expressions + elem.parentNode.selectedIndex; + } + + return elem.selected === true; + }, + + // Contents + "empty": function( elem ) { + + // http://www.w3.org/TR/selectors/#empty-pseudo + // :empty is negated by element (1) or content nodes (text: 3; cdata: 4; entity ref: 5), + // but not by others (comment: 8; processing instruction: 7; etc.) + // nodeType < 6 works because attributes (2) do not appear as children + for ( elem = elem.firstChild; elem; elem = elem.nextSibling ) { + if ( elem.nodeType < 6 ) { + return false; + } + } + return true; + }, + + "parent": function( elem ) { + return !Expr.pseudos[ "empty" ]( elem ); + }, + + // Element/input types + "header": function( elem ) { + return rheader.test( elem.nodeName ); + }, + + "input": function( elem ) { + return rinputs.test( elem.nodeName ); + }, + + "button": function( elem ) { + var name = elem.nodeName.toLowerCase(); + return name === "input" && elem.type === "button" || name === "button"; + }, + + "text": function( elem ) { + var attr; + return elem.nodeName.toLowerCase() === "input" && + elem.type === "text" && + + // Support: IE<8 + // New HTML5 attribute values (e.g., "search") appear with elem.type === "text" + ( ( attr = elem.getAttribute( "type" ) ) == null || + attr.toLowerCase() === "text" ); + }, + + // Position-in-collection + "first": createPositionalPseudo( function() { + return [ 0 ]; + } ), + + "last": createPositionalPseudo( function( _matchIndexes, length ) { + return [ length - 1 ]; + } ), + + "eq": createPositionalPseudo( function( _matchIndexes, length, argument ) { + return [ argument < 0 ? argument + length : argument ]; + } ), + + "even": createPositionalPseudo( function( matchIndexes, length ) { + var i = 0; + for ( ; i < length; i += 2 ) { + matchIndexes.push( i ); + } + return matchIndexes; + } ), + + "odd": createPositionalPseudo( function( matchIndexes, length ) { + var i = 1; + for ( ; i < length; i += 2 ) { + matchIndexes.push( i ); + } + return matchIndexes; + } ), + + "lt": createPositionalPseudo( function( matchIndexes, length, argument ) { + var i = argument < 0 ? + argument + length : + argument > length ? + length : + argument; + for ( ; --i >= 0; ) { + matchIndexes.push( i ); + } + return matchIndexes; + } ), + + "gt": createPositionalPseudo( function( matchIndexes, length, argument ) { + var i = argument < 0 ? argument + length : argument; + for ( ; ++i < length; ) { + matchIndexes.push( i ); + } + return matchIndexes; + } ) + } +}; + +Expr.pseudos[ "nth" ] = Expr.pseudos[ "eq" ]; + +// Add button/input type pseudos +for ( i in { radio: true, checkbox: true, file: true, password: true, image: true } ) { + Expr.pseudos[ i ] = createInputPseudo( i ); +} +for ( i in { submit: true, reset: true } ) { + Expr.pseudos[ i ] = createButtonPseudo( i ); +} + +// Easy API for creating new setFilters +function setFilters() {} +setFilters.prototype = Expr.filters = Expr.pseudos; +Expr.setFilters = new setFilters(); + +tokenize = Sizzle.tokenize = function( selector, parseOnly ) { + var matched, match, tokens, type, + soFar, groups, preFilters, + cached = tokenCache[ selector + " " ]; + + if ( cached ) { + return parseOnly ? 0 : cached.slice( 0 ); + } + + soFar = selector; + groups = []; + preFilters = Expr.preFilter; + + while ( soFar ) { + + // Comma and first run + if ( !matched || ( match = rcomma.exec( soFar ) ) ) { + if ( match ) { + + // Don't consume trailing commas as valid + soFar = soFar.slice( match[ 0 ].length ) || soFar; + } + groups.push( ( tokens = [] ) ); + } + + matched = false; + + // Combinators + if ( ( match = rcombinators.exec( soFar ) ) ) { + matched = match.shift(); + tokens.push( { + value: matched, + + // Cast descendant combinators to space + type: match[ 0 ].replace( rtrim, " " ) + } ); + soFar = soFar.slice( matched.length ); + } + + // Filters + for ( type in Expr.filter ) { + if ( ( match = matchExpr[ type ].exec( soFar ) ) && ( !preFilters[ type ] || + ( match = preFilters[ type ]( match ) ) ) ) { + matched = match.shift(); + tokens.push( { + value: matched, + type: type, + matches: match + } ); + soFar = soFar.slice( matched.length ); + } + } + + if ( !matched ) { + break; + } + } + + // Return the length of the invalid excess + // if we're just parsing + // Otherwise, throw an error or return tokens + return parseOnly ? + soFar.length : + soFar ? + Sizzle.error( selector ) : + + // Cache the tokens + tokenCache( selector, groups ).slice( 0 ); +}; + +function toSelector( tokens ) { + var i = 0, + len = tokens.length, + selector = ""; + for ( ; i < len; i++ ) { + selector += tokens[ i ].value; + } + return selector; +} + +function addCombinator( matcher, combinator, base ) { + var dir = combinator.dir, + skip = combinator.next, + key = skip || dir, + checkNonElements = base && key === "parentNode", + doneName = done++; + + return combinator.first ? + + // Check against closest ancestor/preceding element + function( elem, context, xml ) { + while ( ( elem = elem[ dir ] ) ) { + if ( elem.nodeType === 1 || checkNonElements ) { + return matcher( elem, context, xml ); + } + } + return false; + } : + + // Check against all ancestor/preceding elements + function( elem, context, xml ) { + var oldCache, uniqueCache, outerCache, + newCache = [ dirruns, doneName ]; + + // We can't set arbitrary data on XML nodes, so they don't benefit from combinator caching + if ( xml ) { + while ( ( elem = elem[ dir ] ) ) { + if ( elem.nodeType === 1 || checkNonElements ) { + if ( matcher( elem, context, xml ) ) { + return true; + } + } + } + } else { + while ( ( elem = elem[ dir ] ) ) { + if ( elem.nodeType === 1 || checkNonElements ) { + outerCache = elem[ expando ] || ( elem[ expando ] = {} ); + + // Support: IE <9 only + // Defend against cloned attroperties (jQuery gh-1709) + uniqueCache = outerCache[ elem.uniqueID ] || + ( outerCache[ elem.uniqueID ] = {} ); + + if ( skip && skip === elem.nodeName.toLowerCase() ) { + elem = elem[ dir ] || elem; + } else if ( ( oldCache = uniqueCache[ key ] ) && + oldCache[ 0 ] === dirruns && oldCache[ 1 ] === doneName ) { + + // Assign to newCache so results back-propagate to previous elements + return ( newCache[ 2 ] = oldCache[ 2 ] ); + } else { + + // Reuse newcache so results back-propagate to previous elements + uniqueCache[ key ] = newCache; + + // A match means we're done; a fail means we have to keep checking + if ( ( newCache[ 2 ] = matcher( elem, context, xml ) ) ) { + return true; + } + } + } + } + } + return false; + }; +} + +function elementMatcher( matchers ) { + return matchers.length > 1 ? + function( elem, context, xml ) { + var i = matchers.length; + while ( i-- ) { + if ( !matchers[ i ]( elem, context, xml ) ) { + return false; + } + } + return true; + } : + matchers[ 0 ]; +} + +function multipleContexts( selector, contexts, results ) { + var i = 0, + len = contexts.length; + for ( ; i < len; i++ ) { + Sizzle( selector, contexts[ i ], results ); + } + return results; +} + +function condense( unmatched, map, filter, context, xml ) { + var elem, + newUnmatched = [], + i = 0, + len = unmatched.length, + mapped = map != null; + + for ( ; i < len; i++ ) { + if ( ( elem = unmatched[ i ] ) ) { + if ( !filter || filter( elem, context, xml ) ) { + newUnmatched.push( elem ); + if ( mapped ) { + map.push( i ); + } + } + } + } + + return newUnmatched; +} + +function setMatcher( preFilter, selector, matcher, postFilter, postFinder, postSelector ) { + if ( postFilter && !postFilter[ expando ] ) { + postFilter = setMatcher( postFilter ); + } + if ( postFinder && !postFinder[ expando ] ) { + postFinder = setMatcher( postFinder, postSelector ); + } + return markFunction( function( seed, results, context, xml ) { + var temp, i, elem, + preMap = [], + postMap = [], + preexisting = results.length, + + // Get initial elements from seed or context + elems = seed || multipleContexts( + selector || "*", + context.nodeType ? [ context ] : context, + [] + ), + + // Prefilter to get matcher input, preserving a map for seed-results synchronization + matcherIn = preFilter && ( seed || !selector ) ? + condense( elems, preMap, preFilter, context, xml ) : + elems, + + matcherOut = matcher ? + + // If we have a postFinder, or filtered seed, or non-seed postFilter or preexisting results, + postFinder || ( seed ? preFilter : preexisting || postFilter ) ? + + // ...intermediate processing is necessary + [] : + + // ...otherwise use results directly + results : + matcherIn; + + // Find primary matches + if ( matcher ) { + matcher( matcherIn, matcherOut, context, xml ); + } + + // Apply postFilter + if ( postFilter ) { + temp = condense( matcherOut, postMap ); + postFilter( temp, [], context, xml ); + + // Un-match failing elements by moving them back to matcherIn + i = temp.length; + while ( i-- ) { + if ( ( elem = temp[ i ] ) ) { + matcherOut[ postMap[ i ] ] = !( matcherIn[ postMap[ i ] ] = elem ); + } + } + } + + if ( seed ) { + if ( postFinder || preFilter ) { + if ( postFinder ) { + + // Get the final matcherOut by condensing this intermediate into postFinder contexts + temp = []; + i = matcherOut.length; + while ( i-- ) { + if ( ( elem = matcherOut[ i ] ) ) { + + // Restore matcherIn since elem is not yet a final match + temp.push( ( matcherIn[ i ] = elem ) ); + } + } + postFinder( null, ( matcherOut = [] ), temp, xml ); + } + + // Move matched elements from seed to results to keep them synchronized + i = matcherOut.length; + while ( i-- ) { + if ( ( elem = matcherOut[ i ] ) && + ( temp = postFinder ? indexOf( seed, elem ) : preMap[ i ] ) > -1 ) { + + seed[ temp ] = !( results[ temp ] = elem ); + } + } + } + + // Add elements to results, through postFinder if defined + } else { + matcherOut = condense( + matcherOut === results ? + matcherOut.splice( preexisting, matcherOut.length ) : + matcherOut + ); + if ( postFinder ) { + postFinder( null, results, matcherOut, xml ); + } else { + push.apply( results, matcherOut ); + } + } + } ); +} + +function matcherFromTokens( tokens ) { + var checkContext, matcher, j, + len = tokens.length, + leadingRelative = Expr.relative[ tokens[ 0 ].type ], + implicitRelative = leadingRelative || Expr.relative[ " " ], + i = leadingRelative ? 1 : 0, + + // The foundational matcher ensures that elements are reachable from top-level context(s) + matchContext = addCombinator( function( elem ) { + return elem === checkContext; + }, implicitRelative, true ), + matchAnyContext = addCombinator( function( elem ) { + return indexOf( checkContext, elem ) > -1; + }, implicitRelative, true ), + matchers = [ function( elem, context, xml ) { + var ret = ( !leadingRelative && ( xml || context !== outermostContext ) ) || ( + ( checkContext = context ).nodeType ? + matchContext( elem, context, xml ) : + matchAnyContext( elem, context, xml ) ); + + // Avoid hanging onto element (issue #299) + checkContext = null; + return ret; + } ]; + + for ( ; i < len; i++ ) { + if ( ( matcher = Expr.relative[ tokens[ i ].type ] ) ) { + matchers = [ addCombinator( elementMatcher( matchers ), matcher ) ]; + } else { + matcher = Expr.filter[ tokens[ i ].type ].apply( null, tokens[ i ].matches ); + + // Return special upon seeing a positional matcher + if ( matcher[ expando ] ) { + + // Find the next relative operator (if any) for proper handling + j = ++i; + for ( ; j < len; j++ ) { + if ( Expr.relative[ tokens[ j ].type ] ) { + break; + } + } + return setMatcher( + i > 1 && elementMatcher( matchers ), + i > 1 && toSelector( + + // If the preceding token was a descendant combinator, insert an implicit any-element `*` + tokens + .slice( 0, i - 1 ) + .concat( { value: tokens[ i - 2 ].type === " " ? "*" : "" } ) + ).replace( rtrim, "$1" ), + matcher, + i < j && matcherFromTokens( tokens.slice( i, j ) ), + j < len && matcherFromTokens( ( tokens = tokens.slice( j ) ) ), + j < len && toSelector( tokens ) + ); + } + matchers.push( matcher ); + } + } + + return elementMatcher( matchers ); +} + +function matcherFromGroupMatchers( elementMatchers, setMatchers ) { + var bySet = setMatchers.length > 0, + byElement = elementMatchers.length > 0, + superMatcher = function( seed, context, xml, results, outermost ) { + var elem, j, matcher, + matchedCount = 0, + i = "0", + unmatched = seed && [], + setMatched = [], + contextBackup = outermostContext, + + // We must always have either seed elements or outermost context + elems = seed || byElement && Expr.find[ "TAG" ]( "*", outermost ), + + // Use integer dirruns iff this is the outermost matcher + dirrunsUnique = ( dirruns += contextBackup == null ? 1 : Math.random() || 0.1 ), + len = elems.length; + + if ( outermost ) { + + // Support: IE 11+, Edge 17 - 18+ + // IE/Edge sometimes throw a "Permission denied" error when strict-comparing + // two documents; shallow comparisons work. + // eslint-disable-next-line eqeqeq + outermostContext = context == document || context || outermost; + } + + // Add elements passing elementMatchers directly to results + // Support: IE<9, Safari + // Tolerate NodeList properties (IE: "length"; Safari: ) matching elements by id + for ( ; i !== len && ( elem = elems[ i ] ) != null; i++ ) { + if ( byElement && elem ) { + j = 0; + + // Support: IE 11+, Edge 17 - 18+ + // IE/Edge sometimes throw a "Permission denied" error when strict-comparing + // two documents; shallow comparisons work. + // eslint-disable-next-line eqeqeq + if ( !context && elem.ownerDocument != document ) { + setDocument( elem ); + xml = !documentIsHTML; + } + while ( ( matcher = elementMatchers[ j++ ] ) ) { + if ( matcher( elem, context || document, xml ) ) { + results.push( elem ); + break; + } + } + if ( outermost ) { + dirruns = dirrunsUnique; + } + } + + // Track unmatched elements for set filters + if ( bySet ) { + + // They will have gone through all possible matchers + if ( ( elem = !matcher && elem ) ) { + matchedCount--; + } + + // Lengthen the array for every element, matched or not + if ( seed ) { + unmatched.push( elem ); + } + } + } + + // `i` is now the count of elements visited above, and adding it to `matchedCount` + // makes the latter nonnegative. + matchedCount += i; + + // Apply set filters to unmatched elements + // NOTE: This can be skipped if there are no unmatched elements (i.e., `matchedCount` + // equals `i`), unless we didn't visit _any_ elements in the above loop because we have + // no element matchers and no seed. + // Incrementing an initially-string "0" `i` allows `i` to remain a string only in that + // case, which will result in a "00" `matchedCount` that differs from `i` but is also + // numerically zero. + if ( bySet && i !== matchedCount ) { + j = 0; + while ( ( matcher = setMatchers[ j++ ] ) ) { + matcher( unmatched, setMatched, context, xml ); + } + + if ( seed ) { + + // Reintegrate element matches to eliminate the need for sorting + if ( matchedCount > 0 ) { + while ( i-- ) { + if ( !( unmatched[ i ] || setMatched[ i ] ) ) { + setMatched[ i ] = pop.call( results ); + } + } + } + + // Discard index placeholder values to get only actual matches + setMatched = condense( setMatched ); + } + + // Add matches to results + push.apply( results, setMatched ); + + // Seedless set matches succeeding multiple successful matchers stipulate sorting + if ( outermost && !seed && setMatched.length > 0 && + ( matchedCount + setMatchers.length ) > 1 ) { + + Sizzle.uniqueSort( results ); + } + } + + // Override manipulation of globals by nested matchers + if ( outermost ) { + dirruns = dirrunsUnique; + outermostContext = contextBackup; + } + + return unmatched; + }; + + return bySet ? + markFunction( superMatcher ) : + superMatcher; +} + +compile = Sizzle.compile = function( selector, match /* Internal Use Only */ ) { + var i, + setMatchers = [], + elementMatchers = [], + cached = compilerCache[ selector + " " ]; + + if ( !cached ) { + + // Generate a function of recursive functions that can be used to check each element + if ( !match ) { + match = tokenize( selector ); + } + i = match.length; + while ( i-- ) { + cached = matcherFromTokens( match[ i ] ); + if ( cached[ expando ] ) { + setMatchers.push( cached ); + } else { + elementMatchers.push( cached ); + } + } + + // Cache the compiled function + cached = compilerCache( + selector, + matcherFromGroupMatchers( elementMatchers, setMatchers ) + ); + + // Save selector and tokenization + cached.selector = selector; + } + return cached; +}; + +/** + * A low-level selection function that works with Sizzle's compiled + * selector functions + * @param {String|Function} selector A selector or a pre-compiled + * selector function built with Sizzle.compile + * @param {Element} context + * @param {Array} [results] + * @param {Array} [seed] A set of elements to match against + */ +select = Sizzle.select = function( selector, context, results, seed ) { + var i, tokens, token, type, find, + compiled = typeof selector === "function" && selector, + match = !seed && tokenize( ( selector = compiled.selector || selector ) ); + + results = results || []; + + // Try to minimize operations if there is only one selector in the list and no seed + // (the latter of which guarantees us context) + if ( match.length === 1 ) { + + // Reduce context if the leading compound selector is an ID + tokens = match[ 0 ] = match[ 0 ].slice( 0 ); + if ( tokens.length > 2 && ( token = tokens[ 0 ] ).type === "ID" && + context.nodeType === 9 && documentIsHTML && Expr.relative[ tokens[ 1 ].type ] ) { + + context = ( Expr.find[ "ID" ]( token.matches[ 0 ] + .replace( runescape, funescape ), context ) || [] )[ 0 ]; + if ( !context ) { + return results; + + // Precompiled matchers will still verify ancestry, so step up a level + } else if ( compiled ) { + context = context.parentNode; + } + + selector = selector.slice( tokens.shift().value.length ); + } + + // Fetch a seed set for right-to-left matching + i = matchExpr[ "needsContext" ].test( selector ) ? 0 : tokens.length; + while ( i-- ) { + token = tokens[ i ]; + + // Abort if we hit a combinator + if ( Expr.relative[ ( type = token.type ) ] ) { + break; + } + if ( ( find = Expr.find[ type ] ) ) { + + // Search, expanding context for leading sibling combinators + if ( ( seed = find( + token.matches[ 0 ].replace( runescape, funescape ), + rsibling.test( tokens[ 0 ].type ) && testContext( context.parentNode ) || + context + ) ) ) { + + // If seed is empty or no tokens remain, we can return early + tokens.splice( i, 1 ); + selector = seed.length && toSelector( tokens ); + if ( !selector ) { + push.apply( results, seed ); + return results; + } + + break; + } + } + } + } + + // Compile and execute a filtering function if one is not provided + // Provide `match` to avoid retokenization if we modified the selector above + ( compiled || compile( selector, match ) )( + seed, + context, + !documentIsHTML, + results, + !context || rsibling.test( selector ) && testContext( context.parentNode ) || context + ); + return results; +}; + +// One-time assignments + +// Sort stability +support.sortStable = expando.split( "" ).sort( sortOrder ).join( "" ) === expando; + +// Support: Chrome 14-35+ +// Always assume duplicates if they aren't passed to the comparison function +support.detectDuplicates = !!hasDuplicate; + +// Initialize against the default document +setDocument(); + +// Support: Webkit<537.32 - Safari 6.0.3/Chrome 25 (fixed in Chrome 27) +// Detached nodes confoundingly follow *each other* +support.sortDetached = assert( function( el ) { + + // Should return 1, but returns 4 (following) + return el.compareDocumentPosition( document.createElement( "fieldset" ) ) & 1; +} ); + +// Support: IE<8 +// Prevent attribute/property "interpolation" +// https://msdn.microsoft.com/en-us/library/ms536429%28VS.85%29.aspx +if ( !assert( function( el ) { + el.innerHTML = ""; + return el.firstChild.getAttribute( "href" ) === "#"; +} ) ) { + addHandle( "type|href|height|width", function( elem, name, isXML ) { + if ( !isXML ) { + return elem.getAttribute( name, name.toLowerCase() === "type" ? 1 : 2 ); + } + } ); +} + +// Support: IE<9 +// Use defaultValue in place of getAttribute("value") +if ( !support.attributes || !assert( function( el ) { + el.innerHTML = ""; + el.firstChild.setAttribute( "value", "" ); + return el.firstChild.getAttribute( "value" ) === ""; +} ) ) { + addHandle( "value", function( elem, _name, isXML ) { + if ( !isXML && elem.nodeName.toLowerCase() === "input" ) { + return elem.defaultValue; + } + } ); +} + +// Support: IE<9 +// Use getAttributeNode to fetch booleans when getAttribute lies +if ( !assert( function( el ) { + return el.getAttribute( "disabled" ) == null; +} ) ) { + addHandle( booleans, function( elem, name, isXML ) { + var val; + if ( !isXML ) { + return elem[ name ] === true ? name.toLowerCase() : + ( val = elem.getAttributeNode( name ) ) && val.specified ? + val.value : + null; + } + } ); +} + +return Sizzle; + +} )( window ); + + + +jQuery.find = Sizzle; +jQuery.expr = Sizzle.selectors; + +// Deprecated +jQuery.expr[ ":" ] = jQuery.expr.pseudos; +jQuery.uniqueSort = jQuery.unique = Sizzle.uniqueSort; +jQuery.text = Sizzle.getText; +jQuery.isXMLDoc = Sizzle.isXML; +jQuery.contains = Sizzle.contains; +jQuery.escapeSelector = Sizzle.escape; + + + + +var dir = function( elem, dir, until ) { + var matched = [], + truncate = until !== undefined; + + while ( ( elem = elem[ dir ] ) && elem.nodeType !== 9 ) { + if ( elem.nodeType === 1 ) { + if ( truncate && jQuery( elem ).is( until ) ) { + break; + } + matched.push( elem ); + } + } + return matched; +}; + + +var siblings = function( n, elem ) { + var matched = []; + + for ( ; n; n = n.nextSibling ) { + if ( n.nodeType === 1 && n !== elem ) { + matched.push( n ); + } + } + + return matched; +}; + + +var rneedsContext = jQuery.expr.match.needsContext; + + + +function nodeName( elem, name ) { + + return elem.nodeName && elem.nodeName.toLowerCase() === name.toLowerCase(); + +} +var rsingleTag = ( /^<([a-z][^\/\0>:\x20\t\r\n\f]*)[\x20\t\r\n\f]*\/?>(?:<\/\1>|)$/i ); + + + +// Implement the identical functionality for filter and not +function winnow( elements, qualifier, not ) { + if ( isFunction( qualifier ) ) { + return jQuery.grep( elements, function( elem, i ) { + return !!qualifier.call( elem, i, elem ) !== not; + } ); + } + + // Single element + if ( qualifier.nodeType ) { + return jQuery.grep( elements, function( elem ) { + return ( elem === qualifier ) !== not; + } ); + } + + // Arraylike of elements (jQuery, arguments, Array) + if ( typeof qualifier !== "string" ) { + return jQuery.grep( elements, function( elem ) { + return ( indexOf.call( qualifier, elem ) > -1 ) !== not; + } ); + } + + // Filtered directly for both simple and complex selectors + return jQuery.filter( qualifier, elements, not ); +} + +jQuery.filter = function( expr, elems, not ) { + var elem = elems[ 0 ]; + + if ( not ) { + expr = ":not(" + expr + ")"; + } + + if ( elems.length === 1 && elem.nodeType === 1 ) { + return jQuery.find.matchesSelector( elem, expr ) ? [ elem ] : []; + } + + return jQuery.find.matches( expr, jQuery.grep( elems, function( elem ) { + return elem.nodeType === 1; + } ) ); +}; + +jQuery.fn.extend( { + find: function( selector ) { + var i, ret, + len = this.length, + self = this; + + if ( typeof selector !== "string" ) { + return this.pushStack( jQuery( selector ).filter( function() { + for ( i = 0; i < len; i++ ) { + if ( jQuery.contains( self[ i ], this ) ) { + return true; + } + } + } ) ); + } + + ret = this.pushStack( [] ); + + for ( i = 0; i < len; i++ ) { + jQuery.find( selector, self[ i ], ret ); + } + + return len > 1 ? jQuery.uniqueSort( ret ) : ret; + }, + filter: function( selector ) { + return this.pushStack( winnow( this, selector || [], false ) ); + }, + not: function( selector ) { + return this.pushStack( winnow( this, selector || [], true ) ); + }, + is: function( selector ) { + return !!winnow( + this, + + // If this is a positional/relative selector, check membership in the returned set + // so $("p:first").is("p:last") won't return true for a doc with two "p". + typeof selector === "string" && rneedsContext.test( selector ) ? + jQuery( selector ) : + selector || [], + false + ).length; + } +} ); + + +// Initialize a jQuery object + + +// A central reference to the root jQuery(document) +var rootjQuery, + + // A simple way to check for HTML strings + // Prioritize #id over to avoid XSS via location.hash (#9521) + // Strict HTML recognition (#11290: must start with <) + // Shortcut simple #id case for speed + rquickExpr = /^(?:\s*(<[\w\W]+>)[^>]*|#([\w-]+))$/, + + init = jQuery.fn.init = function( selector, context, root ) { + var match, elem; + + // HANDLE: $(""), $(null), $(undefined), $(false) + if ( !selector ) { + return this; + } + + // Method init() accepts an alternate rootjQuery + // so migrate can support jQuery.sub (gh-2101) + root = root || rootjQuery; + + // Handle HTML strings + if ( typeof selector === "string" ) { + if ( selector[ 0 ] === "<" && + selector[ selector.length - 1 ] === ">" && + selector.length >= 3 ) { + + // Assume that strings that start and end with <> are HTML and skip the regex check + match = [ null, selector, null ]; + + } else { + match = rquickExpr.exec( selector ); + } + + // Match html or make sure no context is specified for #id + if ( match && ( match[ 1 ] || !context ) ) { + + // HANDLE: $(html) -> $(array) + if ( match[ 1 ] ) { + context = context instanceof jQuery ? context[ 0 ] : context; + + // Option to run scripts is true for back-compat + // Intentionally let the error be thrown if parseHTML is not present + jQuery.merge( this, jQuery.parseHTML( + match[ 1 ], + context && context.nodeType ? context.ownerDocument || context : document, + true + ) ); + + // HANDLE: $(html, props) + if ( rsingleTag.test( match[ 1 ] ) && jQuery.isPlainObject( context ) ) { + for ( match in context ) { + + // Properties of context are called as methods if possible + if ( isFunction( this[ match ] ) ) { + this[ match ]( context[ match ] ); + + // ...and otherwise set as attributes + } else { + this.attr( match, context[ match ] ); + } + } + } + + return this; + + // HANDLE: $(#id) + } else { + elem = document.getElementById( match[ 2 ] ); + + if ( elem ) { + + // Inject the element directly into the jQuery object + this[ 0 ] = elem; + this.length = 1; + } + return this; + } + + // HANDLE: $(expr, $(...)) + } else if ( !context || context.jquery ) { + return ( context || root ).find( selector ); + + // HANDLE: $(expr, context) + // (which is just equivalent to: $(context).find(expr) + } else { + return this.constructor( context ).find( selector ); + } + + // HANDLE: $(DOMElement) + } else if ( selector.nodeType ) { + this[ 0 ] = selector; + this.length = 1; + return this; + + // HANDLE: $(function) + // Shortcut for document ready + } else if ( isFunction( selector ) ) { + return root.ready !== undefined ? + root.ready( selector ) : + + // Execute immediately if ready is not present + selector( jQuery ); + } + + return jQuery.makeArray( selector, this ); + }; + +// Give the init function the jQuery prototype for later instantiation +init.prototype = jQuery.fn; + +// Initialize central reference +rootjQuery = jQuery( document ); + + +var rparentsprev = /^(?:parents|prev(?:Until|All))/, + + // Methods guaranteed to produce a unique set when starting from a unique set + guaranteedUnique = { + children: true, + contents: true, + next: true, + prev: true + }; + +jQuery.fn.extend( { + has: function( target ) { + var targets = jQuery( target, this ), + l = targets.length; + + return this.filter( function() { + var i = 0; + for ( ; i < l; i++ ) { + if ( jQuery.contains( this, targets[ i ] ) ) { + return true; + } + } + } ); + }, + + closest: function( selectors, context ) { + var cur, + i = 0, + l = this.length, + matched = [], + targets = typeof selectors !== "string" && jQuery( selectors ); + + // Positional selectors never match, since there's no _selection_ context + if ( !rneedsContext.test( selectors ) ) { + for ( ; i < l; i++ ) { + for ( cur = this[ i ]; cur && cur !== context; cur = cur.parentNode ) { + + // Always skip document fragments + if ( cur.nodeType < 11 && ( targets ? + targets.index( cur ) > -1 : + + // Don't pass non-elements to Sizzle + cur.nodeType === 1 && + jQuery.find.matchesSelector( cur, selectors ) ) ) { + + matched.push( cur ); + break; + } + } + } + } + + return this.pushStack( matched.length > 1 ? jQuery.uniqueSort( matched ) : matched ); + }, + + // Determine the position of an element within the set + index: function( elem ) { + + // No argument, return index in parent + if ( !elem ) { + return ( this[ 0 ] && this[ 0 ].parentNode ) ? this.first().prevAll().length : -1; + } + + // Index in selector + if ( typeof elem === "string" ) { + return indexOf.call( jQuery( elem ), this[ 0 ] ); + } + + // Locate the position of the desired element + return indexOf.call( this, + + // If it receives a jQuery object, the first element is used + elem.jquery ? elem[ 0 ] : elem + ); + }, + + add: function( selector, context ) { + return this.pushStack( + jQuery.uniqueSort( + jQuery.merge( this.get(), jQuery( selector, context ) ) + ) + ); + }, + + addBack: function( selector ) { + return this.add( selector == null ? + this.prevObject : this.prevObject.filter( selector ) + ); + } +} ); + +function sibling( cur, dir ) { + while ( ( cur = cur[ dir ] ) && cur.nodeType !== 1 ) {} + return cur; +} + +jQuery.each( { + parent: function( elem ) { + var parent = elem.parentNode; + return parent && parent.nodeType !== 11 ? parent : null; + }, + parents: function( elem ) { + return dir( elem, "parentNode" ); + }, + parentsUntil: function( elem, _i, until ) { + return dir( elem, "parentNode", until ); + }, + next: function( elem ) { + return sibling( elem, "nextSibling" ); + }, + prev: function( elem ) { + return sibling( elem, "previousSibling" ); + }, + nextAll: function( elem ) { + return dir( elem, "nextSibling" ); + }, + prevAll: function( elem ) { + return dir( elem, "previousSibling" ); + }, + nextUntil: function( elem, _i, until ) { + return dir( elem, "nextSibling", until ); + }, + prevUntil: function( elem, _i, until ) { + return dir( elem, "previousSibling", until ); + }, + siblings: function( elem ) { + return siblings( ( elem.parentNode || {} ).firstChild, elem ); + }, + children: function( elem ) { + return siblings( elem.firstChild ); + }, + contents: function( elem ) { + if ( elem.contentDocument != null && + + // Support: IE 11+ + // elements with no `data` attribute has an object + // `contentDocument` with a `null` prototype. + getProto( elem.contentDocument ) ) { + + return elem.contentDocument; + } + + // Support: IE 9 - 11 only, iOS 7 only, Android Browser <=4.3 only + // Treat the template element as a regular one in browsers that + // don't support it. + if ( nodeName( elem, "template" ) ) { + elem = elem.content || elem; + } + + return jQuery.merge( [], elem.childNodes ); + } +}, function( name, fn ) { + jQuery.fn[ name ] = function( until, selector ) { + var matched = jQuery.map( this, fn, until ); + + if ( name.slice( -5 ) !== "Until" ) { + selector = until; + } + + if ( selector && typeof selector === "string" ) { + matched = jQuery.filter( selector, matched ); + } + + if ( this.length > 1 ) { + + // Remove duplicates + if ( !guaranteedUnique[ name ] ) { + jQuery.uniqueSort( matched ); + } + + // Reverse order for parents* and prev-derivatives + if ( rparentsprev.test( name ) ) { + matched.reverse(); + } + } + + return this.pushStack( matched ); + }; +} ); +var rnothtmlwhite = ( /[^\x20\t\r\n\f]+/g ); + + + +// Convert String-formatted options into Object-formatted ones +function createOptions( options ) { + var object = {}; + jQuery.each( options.match( rnothtmlwhite ) || [], function( _, flag ) { + object[ flag ] = true; + } ); + return object; +} + +/* + * Create a callback list using the following parameters: + * + * options: an optional list of space-separated options that will change how + * the callback list behaves or a more traditional option object + * + * By default a callback list will act like an event callback list and can be + * "fired" multiple times. + * + * Possible options: + * + * once: will ensure the callback list can only be fired once (like a Deferred) + * + * memory: will keep track of previous values and will call any callback added + * after the list has been fired right away with the latest "memorized" + * values (like a Deferred) + * + * unique: will ensure a callback can only be added once (no duplicate in the list) + * + * stopOnFalse: interrupt callings when a callback returns false + * + */ +jQuery.Callbacks = function( options ) { + + // Convert options from String-formatted to Object-formatted if needed + // (we check in cache first) + options = typeof options === "string" ? + createOptions( options ) : + jQuery.extend( {}, options ); + + var // Flag to know if list is currently firing + firing, + + // Last fire value for non-forgettable lists + memory, + + // Flag to know if list was already fired + fired, + + // Flag to prevent firing + locked, + + // Actual callback list + list = [], + + // Queue of execution data for repeatable lists + queue = [], + + // Index of currently firing callback (modified by add/remove as needed) + firingIndex = -1, + + // Fire callbacks + fire = function() { + + // Enforce single-firing + locked = locked || options.once; + + // Execute callbacks for all pending executions, + // respecting firingIndex overrides and runtime changes + fired = firing = true; + for ( ; queue.length; firingIndex = -1 ) { + memory = queue.shift(); + while ( ++firingIndex < list.length ) { + + // Run callback and check for early termination + if ( list[ firingIndex ].apply( memory[ 0 ], memory[ 1 ] ) === false && + options.stopOnFalse ) { + + // Jump to end and forget the data so .add doesn't re-fire + firingIndex = list.length; + memory = false; + } + } + } + + // Forget the data if we're done with it + if ( !options.memory ) { + memory = false; + } + + firing = false; + + // Clean up if we're done firing for good + if ( locked ) { + + // Keep an empty list if we have data for future add calls + if ( memory ) { + list = []; + + // Otherwise, this object is spent + } else { + list = ""; + } + } + }, + + // Actual Callbacks object + self = { + + // Add a callback or a collection of callbacks to the list + add: function() { + if ( list ) { + + // If we have memory from a past run, we should fire after adding + if ( memory && !firing ) { + firingIndex = list.length - 1; + queue.push( memory ); + } + + ( function add( args ) { + jQuery.each( args, function( _, arg ) { + if ( isFunction( arg ) ) { + if ( !options.unique || !self.has( arg ) ) { + list.push( arg ); + } + } else if ( arg && arg.length && toType( arg ) !== "string" ) { + + // Inspect recursively + add( arg ); + } + } ); + } )( arguments ); + + if ( memory && !firing ) { + fire(); + } + } + return this; + }, + + // Remove a callback from the list + remove: function() { + jQuery.each( arguments, function( _, arg ) { + var index; + while ( ( index = jQuery.inArray( arg, list, index ) ) > -1 ) { + list.splice( index, 1 ); + + // Handle firing indexes + if ( index <= firingIndex ) { + firingIndex--; + } + } + } ); + return this; + }, + + // Check if a given callback is in the list. + // If no argument is given, return whether or not list has callbacks attached. + has: function( fn ) { + return fn ? + jQuery.inArray( fn, list ) > -1 : + list.length > 0; + }, + + // Remove all callbacks from the list + empty: function() { + if ( list ) { + list = []; + } + return this; + }, + + // Disable .fire and .add + // Abort any current/pending executions + // Clear all callbacks and values + disable: function() { + locked = queue = []; + list = memory = ""; + return this; + }, + disabled: function() { + return !list; + }, + + // Disable .fire + // Also disable .add unless we have memory (since it would have no effect) + // Abort any pending executions + lock: function() { + locked = queue = []; + if ( !memory && !firing ) { + list = memory = ""; + } + return this; + }, + locked: function() { + return !!locked; + }, + + // Call all callbacks with the given context and arguments + fireWith: function( context, args ) { + if ( !locked ) { + args = args || []; + args = [ context, args.slice ? args.slice() : args ]; + queue.push( args ); + if ( !firing ) { + fire(); + } + } + return this; + }, + + // Call all the callbacks with the given arguments + fire: function() { + self.fireWith( this, arguments ); + return this; + }, + + // To know if the callbacks have already been called at least once + fired: function() { + return !!fired; + } + }; + + return self; +}; + + +function Identity( v ) { + return v; +} +function Thrower( ex ) { + throw ex; +} + +function adoptValue( value, resolve, reject, noValue ) { + var method; + + try { + + // Check for promise aspect first to privilege synchronous behavior + if ( value && isFunction( ( method = value.promise ) ) ) { + method.call( value ).done( resolve ).fail( reject ); + + // Other thenables + } else if ( value && isFunction( ( method = value.then ) ) ) { + method.call( value, resolve, reject ); + + // Other non-thenables + } else { + + // Control `resolve` arguments by letting Array#slice cast boolean `noValue` to integer: + // * false: [ value ].slice( 0 ) => resolve( value ) + // * true: [ value ].slice( 1 ) => resolve() + resolve.apply( undefined, [ value ].slice( noValue ) ); + } + + // For Promises/A+, convert exceptions into rejections + // Since jQuery.when doesn't unwrap thenables, we can skip the extra checks appearing in + // Deferred#then to conditionally suppress rejection. + } catch ( value ) { + + // Support: Android 4.0 only + // Strict mode functions invoked without .call/.apply get global-object context + reject.apply( undefined, [ value ] ); + } +} + +jQuery.extend( { + + Deferred: function( func ) { + var tuples = [ + + // action, add listener, callbacks, + // ... .then handlers, argument index, [final state] + [ "notify", "progress", jQuery.Callbacks( "memory" ), + jQuery.Callbacks( "memory" ), 2 ], + [ "resolve", "done", jQuery.Callbacks( "once memory" ), + jQuery.Callbacks( "once memory" ), 0, "resolved" ], + [ "reject", "fail", jQuery.Callbacks( "once memory" ), + jQuery.Callbacks( "once memory" ), 1, "rejected" ] + ], + state = "pending", + promise = { + state: function() { + return state; + }, + always: function() { + deferred.done( arguments ).fail( arguments ); + return this; + }, + "catch": function( fn ) { + return promise.then( null, fn ); + }, + + // Keep pipe for back-compat + pipe: function( /* fnDone, fnFail, fnProgress */ ) { + var fns = arguments; + + return jQuery.Deferred( function( newDefer ) { + jQuery.each( tuples, function( _i, tuple ) { + + // Map tuples (progress, done, fail) to arguments (done, fail, progress) + var fn = isFunction( fns[ tuple[ 4 ] ] ) && fns[ tuple[ 4 ] ]; + + // deferred.progress(function() { bind to newDefer or newDefer.notify }) + // deferred.done(function() { bind to newDefer or newDefer.resolve }) + // deferred.fail(function() { bind to newDefer or newDefer.reject }) + deferred[ tuple[ 1 ] ]( function() { + var returned = fn && fn.apply( this, arguments ); + if ( returned && isFunction( returned.promise ) ) { + returned.promise() + .progress( newDefer.notify ) + .done( newDefer.resolve ) + .fail( newDefer.reject ); + } else { + newDefer[ tuple[ 0 ] + "With" ]( + this, + fn ? [ returned ] : arguments + ); + } + } ); + } ); + fns = null; + } ).promise(); + }, + then: function( onFulfilled, onRejected, onProgress ) { + var maxDepth = 0; + function resolve( depth, deferred, handler, special ) { + return function() { + var that = this, + args = arguments, + mightThrow = function() { + var returned, then; + + // Support: Promises/A+ section 2.3.3.3.3 + // https://promisesaplus.com/#point-59 + // Ignore double-resolution attempts + if ( depth < maxDepth ) { + return; + } + + returned = handler.apply( that, args ); + + // Support: Promises/A+ section 2.3.1 + // https://promisesaplus.com/#point-48 + if ( returned === deferred.promise() ) { + throw new TypeError( "Thenable self-resolution" ); + } + + // Support: Promises/A+ sections 2.3.3.1, 3.5 + // https://promisesaplus.com/#point-54 + // https://promisesaplus.com/#point-75 + // Retrieve `then` only once + then = returned && + + // Support: Promises/A+ section 2.3.4 + // https://promisesaplus.com/#point-64 + // Only check objects and functions for thenability + ( typeof returned === "object" || + typeof returned === "function" ) && + returned.then; + + // Handle a returned thenable + if ( isFunction( then ) ) { + + // Special processors (notify) just wait for resolution + if ( special ) { + then.call( + returned, + resolve( maxDepth, deferred, Identity, special ), + resolve( maxDepth, deferred, Thrower, special ) + ); + + // Normal processors (resolve) also hook into progress + } else { + + // ...and disregard older resolution values + maxDepth++; + + then.call( + returned, + resolve( maxDepth, deferred, Identity, special ), + resolve( maxDepth, deferred, Thrower, special ), + resolve( maxDepth, deferred, Identity, + deferred.notifyWith ) + ); + } + + // Handle all other returned values + } else { + + // Only substitute handlers pass on context + // and multiple values (non-spec behavior) + if ( handler !== Identity ) { + that = undefined; + args = [ returned ]; + } + + // Process the value(s) + // Default process is resolve + ( special || deferred.resolveWith )( that, args ); + } + }, + + // Only normal processors (resolve) catch and reject exceptions + process = special ? + mightThrow : + function() { + try { + mightThrow(); + } catch ( e ) { + + if ( jQuery.Deferred.exceptionHook ) { + jQuery.Deferred.exceptionHook( e, + process.stackTrace ); + } + + // Support: Promises/A+ section 2.3.3.3.4.1 + // https://promisesaplus.com/#point-61 + // Ignore post-resolution exceptions + if ( depth + 1 >= maxDepth ) { + + // Only substitute handlers pass on context + // and multiple values (non-spec behavior) + if ( handler !== Thrower ) { + that = undefined; + args = [ e ]; + } + + deferred.rejectWith( that, args ); + } + } + }; + + // Support: Promises/A+ section 2.3.3.3.1 + // https://promisesaplus.com/#point-57 + // Re-resolve promises immediately to dodge false rejection from + // subsequent errors + if ( depth ) { + process(); + } else { + + // Call an optional hook to record the stack, in case of exception + // since it's otherwise lost when execution goes async + if ( jQuery.Deferred.getStackHook ) { + process.stackTrace = jQuery.Deferred.getStackHook(); + } + window.setTimeout( process ); + } + }; + } + + return jQuery.Deferred( function( newDefer ) { + + // progress_handlers.add( ... ) + tuples[ 0 ][ 3 ].add( + resolve( + 0, + newDefer, + isFunction( onProgress ) ? + onProgress : + Identity, + newDefer.notifyWith + ) + ); + + // fulfilled_handlers.add( ... ) + tuples[ 1 ][ 3 ].add( + resolve( + 0, + newDefer, + isFunction( onFulfilled ) ? + onFulfilled : + Identity + ) + ); + + // rejected_handlers.add( ... ) + tuples[ 2 ][ 3 ].add( + resolve( + 0, + newDefer, + isFunction( onRejected ) ? + onRejected : + Thrower + ) + ); + } ).promise(); + }, + + // Get a promise for this deferred + // If obj is provided, the promise aspect is added to the object + promise: function( obj ) { + return obj != null ? jQuery.extend( obj, promise ) : promise; + } + }, + deferred = {}; + + // Add list-specific methods + jQuery.each( tuples, function( i, tuple ) { + var list = tuple[ 2 ], + stateString = tuple[ 5 ]; + + // promise.progress = list.add + // promise.done = list.add + // promise.fail = list.add + promise[ tuple[ 1 ] ] = list.add; + + // Handle state + if ( stateString ) { + list.add( + function() { + + // state = "resolved" (i.e., fulfilled) + // state = "rejected" + state = stateString; + }, + + // rejected_callbacks.disable + // fulfilled_callbacks.disable + tuples[ 3 - i ][ 2 ].disable, + + // rejected_handlers.disable + // fulfilled_handlers.disable + tuples[ 3 - i ][ 3 ].disable, + + // progress_callbacks.lock + tuples[ 0 ][ 2 ].lock, + + // progress_handlers.lock + tuples[ 0 ][ 3 ].lock + ); + } + + // progress_handlers.fire + // fulfilled_handlers.fire + // rejected_handlers.fire + list.add( tuple[ 3 ].fire ); + + // deferred.notify = function() { deferred.notifyWith(...) } + // deferred.resolve = function() { deferred.resolveWith(...) } + // deferred.reject = function() { deferred.rejectWith(...) } + deferred[ tuple[ 0 ] ] = function() { + deferred[ tuple[ 0 ] + "With" ]( this === deferred ? undefined : this, arguments ); + return this; + }; + + // deferred.notifyWith = list.fireWith + // deferred.resolveWith = list.fireWith + // deferred.rejectWith = list.fireWith + deferred[ tuple[ 0 ] + "With" ] = list.fireWith; + } ); + + // Make the deferred a promise + promise.promise( deferred ); + + // Call given func if any + if ( func ) { + func.call( deferred, deferred ); + } + + // All done! + return deferred; + }, + + // Deferred helper + when: function( singleValue ) { + var + + // count of uncompleted subordinates + remaining = arguments.length, + + // count of unprocessed arguments + i = remaining, + + // subordinate fulfillment data + resolveContexts = Array( i ), + resolveValues = slice.call( arguments ), + + // the primary Deferred + primary = jQuery.Deferred(), + + // subordinate callback factory + updateFunc = function( i ) { + return function( value ) { + resolveContexts[ i ] = this; + resolveValues[ i ] = arguments.length > 1 ? slice.call( arguments ) : value; + if ( !( --remaining ) ) { + primary.resolveWith( resolveContexts, resolveValues ); + } + }; + }; + + // Single- and empty arguments are adopted like Promise.resolve + if ( remaining <= 1 ) { + adoptValue( singleValue, primary.done( updateFunc( i ) ).resolve, primary.reject, + !remaining ); + + // Use .then() to unwrap secondary thenables (cf. gh-3000) + if ( primary.state() === "pending" || + isFunction( resolveValues[ i ] && resolveValues[ i ].then ) ) { + + return primary.then(); + } + } + + // Multiple arguments are aggregated like Promise.all array elements + while ( i-- ) { + adoptValue( resolveValues[ i ], updateFunc( i ), primary.reject ); + } + + return primary.promise(); + } +} ); + + +// These usually indicate a programmer mistake during development, +// warn about them ASAP rather than swallowing them by default. +var rerrorNames = /^(Eval|Internal|Range|Reference|Syntax|Type|URI)Error$/; + +jQuery.Deferred.exceptionHook = function( error, stack ) { + + // Support: IE 8 - 9 only + // Console exists when dev tools are open, which can happen at any time + if ( window.console && window.console.warn && error && rerrorNames.test( error.name ) ) { + window.console.warn( "jQuery.Deferred exception: " + error.message, error.stack, stack ); + } +}; + + + + +jQuery.readyException = function( error ) { + window.setTimeout( function() { + throw error; + } ); +}; + + + + +// The deferred used on DOM ready +var readyList = jQuery.Deferred(); + +jQuery.fn.ready = function( fn ) { + + readyList + .then( fn ) + + // Wrap jQuery.readyException in a function so that the lookup + // happens at the time of error handling instead of callback + // registration. + .catch( function( error ) { + jQuery.readyException( error ); + } ); + + return this; +}; + +jQuery.extend( { + + // Is the DOM ready to be used? Set to true once it occurs. + isReady: false, + + // A counter to track how many items to wait for before + // the ready event fires. See #6781 + readyWait: 1, + + // Handle when the DOM is ready + ready: function( wait ) { + + // Abort if there are pending holds or we're already ready + if ( wait === true ? --jQuery.readyWait : jQuery.isReady ) { + return; + } + + // Remember that the DOM is ready + jQuery.isReady = true; + + // If a normal DOM Ready event fired, decrement, and wait if need be + if ( wait !== true && --jQuery.readyWait > 0 ) { + return; + } + + // If there are functions bound, to execute + readyList.resolveWith( document, [ jQuery ] ); + } +} ); + +jQuery.ready.then = readyList.then; + +// The ready event handler and self cleanup method +function completed() { + document.removeEventListener( "DOMContentLoaded", completed ); + window.removeEventListener( "load", completed ); + jQuery.ready(); +} + +// Catch cases where $(document).ready() is called +// after the browser event has already occurred. +// Support: IE <=9 - 10 only +// Older IE sometimes signals "interactive" too soon +if ( document.readyState === "complete" || + ( document.readyState !== "loading" && !document.documentElement.doScroll ) ) { + + // Handle it asynchronously to allow scripts the opportunity to delay ready + window.setTimeout( jQuery.ready ); + +} else { + + // Use the handy event callback + document.addEventListener( "DOMContentLoaded", completed ); + + // A fallback to window.onload, that will always work + window.addEventListener( "load", completed ); +} + + + + +// Multifunctional method to get and set values of a collection +// The value/s can optionally be executed if it's a function +var access = function( elems, fn, key, value, chainable, emptyGet, raw ) { + var i = 0, + len = elems.length, + bulk = key == null; + + // Sets many values + if ( toType( key ) === "object" ) { + chainable = true; + for ( i in key ) { + access( elems, fn, i, key[ i ], true, emptyGet, raw ); + } + + // Sets one value + } else if ( value !== undefined ) { + chainable = true; + + if ( !isFunction( value ) ) { + raw = true; + } + + if ( bulk ) { + + // Bulk operations run against the entire set + if ( raw ) { + fn.call( elems, value ); + fn = null; + + // ...except when executing function values + } else { + bulk = fn; + fn = function( elem, _key, value ) { + return bulk.call( jQuery( elem ), value ); + }; + } + } + + if ( fn ) { + for ( ; i < len; i++ ) { + fn( + elems[ i ], key, raw ? + value : + value.call( elems[ i ], i, fn( elems[ i ], key ) ) + ); + } + } + } + + if ( chainable ) { + return elems; + } + + // Gets + if ( bulk ) { + return fn.call( elems ); + } + + return len ? fn( elems[ 0 ], key ) : emptyGet; +}; + + +// Matches dashed string for camelizing +var rmsPrefix = /^-ms-/, + rdashAlpha = /-([a-z])/g; + +// Used by camelCase as callback to replace() +function fcamelCase( _all, letter ) { + return letter.toUpperCase(); +} + +// Convert dashed to camelCase; used by the css and data modules +// Support: IE <=9 - 11, Edge 12 - 15 +// Microsoft forgot to hump their vendor prefix (#9572) +function camelCase( string ) { + return string.replace( rmsPrefix, "ms-" ).replace( rdashAlpha, fcamelCase ); +} +var acceptData = function( owner ) { + + // Accepts only: + // - Node + // - Node.ELEMENT_NODE + // - Node.DOCUMENT_NODE + // - Object + // - Any + return owner.nodeType === 1 || owner.nodeType === 9 || !( +owner.nodeType ); +}; + + + + +function Data() { + this.expando = jQuery.expando + Data.uid++; +} + +Data.uid = 1; + +Data.prototype = { + + cache: function( owner ) { + + // Check if the owner object already has a cache + var value = owner[ this.expando ]; + + // If not, create one + if ( !value ) { + value = {}; + + // We can accept data for non-element nodes in modern browsers, + // but we should not, see #8335. + // Always return an empty object. + if ( acceptData( owner ) ) { + + // If it is a node unlikely to be stringify-ed or looped over + // use plain assignment + if ( owner.nodeType ) { + owner[ this.expando ] = value; + + // Otherwise secure it in a non-enumerable property + // configurable must be true to allow the property to be + // deleted when data is removed + } else { + Object.defineProperty( owner, this.expando, { + value: value, + configurable: true + } ); + } + } + } + + return value; + }, + set: function( owner, data, value ) { + var prop, + cache = this.cache( owner ); + + // Handle: [ owner, key, value ] args + // Always use camelCase key (gh-2257) + if ( typeof data === "string" ) { + cache[ camelCase( data ) ] = value; + + // Handle: [ owner, { properties } ] args + } else { + + // Copy the properties one-by-one to the cache object + for ( prop in data ) { + cache[ camelCase( prop ) ] = data[ prop ]; + } + } + return cache; + }, + get: function( owner, key ) { + return key === undefined ? + this.cache( owner ) : + + // Always use camelCase key (gh-2257) + owner[ this.expando ] && owner[ this.expando ][ camelCase( key ) ]; + }, + access: function( owner, key, value ) { + + // In cases where either: + // + // 1. No key was specified + // 2. A string key was specified, but no value provided + // + // Take the "read" path and allow the get method to determine + // which value to return, respectively either: + // + // 1. The entire cache object + // 2. The data stored at the key + // + if ( key === undefined || + ( ( key && typeof key === "string" ) && value === undefined ) ) { + + return this.get( owner, key ); + } + + // When the key is not a string, or both a key and value + // are specified, set or extend (existing objects) with either: + // + // 1. An object of properties + // 2. A key and value + // + this.set( owner, key, value ); + + // Since the "set" path can have two possible entry points + // return the expected data based on which path was taken[*] + return value !== undefined ? value : key; + }, + remove: function( owner, key ) { + var i, + cache = owner[ this.expando ]; + + if ( cache === undefined ) { + return; + } + + if ( key !== undefined ) { + + // Support array or space separated string of keys + if ( Array.isArray( key ) ) { + + // If key is an array of keys... + // We always set camelCase keys, so remove that. + key = key.map( camelCase ); + } else { + key = camelCase( key ); + + // If a key with the spaces exists, use it. + // Otherwise, create an array by matching non-whitespace + key = key in cache ? + [ key ] : + ( key.match( rnothtmlwhite ) || [] ); + } + + i = key.length; + + while ( i-- ) { + delete cache[ key[ i ] ]; + } + } + + // Remove the expando if there's no more data + if ( key === undefined || jQuery.isEmptyObject( cache ) ) { + + // Support: Chrome <=35 - 45 + // Webkit & Blink performance suffers when deleting properties + // from DOM nodes, so set to undefined instead + // https://bugs.chromium.org/p/chromium/issues/detail?id=378607 (bug restricted) + if ( owner.nodeType ) { + owner[ this.expando ] = undefined; + } else { + delete owner[ this.expando ]; + } + } + }, + hasData: function( owner ) { + var cache = owner[ this.expando ]; + return cache !== undefined && !jQuery.isEmptyObject( cache ); + } +}; +var dataPriv = new Data(); + +var dataUser = new Data(); + + + +// Implementation Summary +// +// 1. Enforce API surface and semantic compatibility with 1.9.x branch +// 2. Improve the module's maintainability by reducing the storage +// paths to a single mechanism. +// 3. Use the same single mechanism to support "private" and "user" data. +// 4. _Never_ expose "private" data to user code (TODO: Drop _data, _removeData) +// 5. Avoid exposing implementation details on user objects (eg. expando properties) +// 6. Provide a clear path for implementation upgrade to WeakMap in 2014 + +var rbrace = /^(?:\{[\w\W]*\}|\[[\w\W]*\])$/, + rmultiDash = /[A-Z]/g; + +function getData( data ) { + if ( data === "true" ) { + return true; + } + + if ( data === "false" ) { + return false; + } + + if ( data === "null" ) { + return null; + } + + // Only convert to a number if it doesn't change the string + if ( data === +data + "" ) { + return +data; + } + + if ( rbrace.test( data ) ) { + return JSON.parse( data ); + } + + return data; +} + +function dataAttr( elem, key, data ) { + var name; + + // If nothing was found internally, try to fetch any + // data from the HTML5 data-* attribute + if ( data === undefined && elem.nodeType === 1 ) { + name = "data-" + key.replace( rmultiDash, "-$&" ).toLowerCase(); + data = elem.getAttribute( name ); + + if ( typeof data === "string" ) { + try { + data = getData( data ); + } catch ( e ) {} + + // Make sure we set the data so it isn't changed later + dataUser.set( elem, key, data ); + } else { + data = undefined; + } + } + return data; +} + +jQuery.extend( { + hasData: function( elem ) { + return dataUser.hasData( elem ) || dataPriv.hasData( elem ); + }, + + data: function( elem, name, data ) { + return dataUser.access( elem, name, data ); + }, + + removeData: function( elem, name ) { + dataUser.remove( elem, name ); + }, + + // TODO: Now that all calls to _data and _removeData have been replaced + // with direct calls to dataPriv methods, these can be deprecated. + _data: function( elem, name, data ) { + return dataPriv.access( elem, name, data ); + }, + + _removeData: function( elem, name ) { + dataPriv.remove( elem, name ); + } +} ); + +jQuery.fn.extend( { + data: function( key, value ) { + var i, name, data, + elem = this[ 0 ], + attrs = elem && elem.attributes; + + // Gets all values + if ( key === undefined ) { + if ( this.length ) { + data = dataUser.get( elem ); + + if ( elem.nodeType === 1 && !dataPriv.get( elem, "hasDataAttrs" ) ) { + i = attrs.length; + while ( i-- ) { + + // Support: IE 11 only + // The attrs elements can be null (#14894) + if ( attrs[ i ] ) { + name = attrs[ i ].name; + if ( name.indexOf( "data-" ) === 0 ) { + name = camelCase( name.slice( 5 ) ); + dataAttr( elem, name, data[ name ] ); + } + } + } + dataPriv.set( elem, "hasDataAttrs", true ); + } + } + + return data; + } + + // Sets multiple values + if ( typeof key === "object" ) { + return this.each( function() { + dataUser.set( this, key ); + } ); + } + + return access( this, function( value ) { + var data; + + // The calling jQuery object (element matches) is not empty + // (and therefore has an element appears at this[ 0 ]) and the + // `value` parameter was not undefined. An empty jQuery object + // will result in `undefined` for elem = this[ 0 ] which will + // throw an exception if an attempt to read a data cache is made. + if ( elem && value === undefined ) { + + // Attempt to get data from the cache + // The key will always be camelCased in Data + data = dataUser.get( elem, key ); + if ( data !== undefined ) { + return data; + } + + // Attempt to "discover" the data in + // HTML5 custom data-* attrs + data = dataAttr( elem, key ); + if ( data !== undefined ) { + return data; + } + + // We tried really hard, but the data doesn't exist. + return; + } + + // Set the data... + this.each( function() { + + // We always store the camelCased key + dataUser.set( this, key, value ); + } ); + }, null, value, arguments.length > 1, null, true ); + }, + + removeData: function( key ) { + return this.each( function() { + dataUser.remove( this, key ); + } ); + } +} ); + + +jQuery.extend( { + queue: function( elem, type, data ) { + var queue; + + if ( elem ) { + type = ( type || "fx" ) + "queue"; + queue = dataPriv.get( elem, type ); + + // Speed up dequeue by getting out quickly if this is just a lookup + if ( data ) { + if ( !queue || Array.isArray( data ) ) { + queue = dataPriv.access( elem, type, jQuery.makeArray( data ) ); + } else { + queue.push( data ); + } + } + return queue || []; + } + }, + + dequeue: function( elem, type ) { + type = type || "fx"; + + var queue = jQuery.queue( elem, type ), + startLength = queue.length, + fn = queue.shift(), + hooks = jQuery._queueHooks( elem, type ), + next = function() { + jQuery.dequeue( elem, type ); + }; + + // If the fx queue is dequeued, always remove the progress sentinel + if ( fn === "inprogress" ) { + fn = queue.shift(); + startLength--; + } + + if ( fn ) { + + // Add a progress sentinel to prevent the fx queue from being + // automatically dequeued + if ( type === "fx" ) { + queue.unshift( "inprogress" ); + } + + // Clear up the last queue stop function + delete hooks.stop; + fn.call( elem, next, hooks ); + } + + if ( !startLength && hooks ) { + hooks.empty.fire(); + } + }, + + // Not public - generate a queueHooks object, or return the current one + _queueHooks: function( elem, type ) { + var key = type + "queueHooks"; + return dataPriv.get( elem, key ) || dataPriv.access( elem, key, { + empty: jQuery.Callbacks( "once memory" ).add( function() { + dataPriv.remove( elem, [ type + "queue", key ] ); + } ) + } ); + } +} ); + +jQuery.fn.extend( { + queue: function( type, data ) { + var setter = 2; + + if ( typeof type !== "string" ) { + data = type; + type = "fx"; + setter--; + } + + if ( arguments.length < setter ) { + return jQuery.queue( this[ 0 ], type ); + } + + return data === undefined ? + this : + this.each( function() { + var queue = jQuery.queue( this, type, data ); + + // Ensure a hooks for this queue + jQuery._queueHooks( this, type ); + + if ( type === "fx" && queue[ 0 ] !== "inprogress" ) { + jQuery.dequeue( this, type ); + } + } ); + }, + dequeue: function( type ) { + return this.each( function() { + jQuery.dequeue( this, type ); + } ); + }, + clearQueue: function( type ) { + return this.queue( type || "fx", [] ); + }, + + // Get a promise resolved when queues of a certain type + // are emptied (fx is the type by default) + promise: function( type, obj ) { + var tmp, + count = 1, + defer = jQuery.Deferred(), + elements = this, + i = this.length, + resolve = function() { + if ( !( --count ) ) { + defer.resolveWith( elements, [ elements ] ); + } + }; + + if ( typeof type !== "string" ) { + obj = type; + type = undefined; + } + type = type || "fx"; + + while ( i-- ) { + tmp = dataPriv.get( elements[ i ], type + "queueHooks" ); + if ( tmp && tmp.empty ) { + count++; + tmp.empty.add( resolve ); + } + } + resolve(); + return defer.promise( obj ); + } +} ); +var pnum = ( /[+-]?(?:\d*\.|)\d+(?:[eE][+-]?\d+|)/ ).source; + +var rcssNum = new RegExp( "^(?:([+-])=|)(" + pnum + ")([a-z%]*)$", "i" ); + + +var cssExpand = [ "Top", "Right", "Bottom", "Left" ]; + +var documentElement = document.documentElement; + + + + var isAttached = function( elem ) { + return jQuery.contains( elem.ownerDocument, elem ); + }, + composed = { composed: true }; + + // Support: IE 9 - 11+, Edge 12 - 18+, iOS 10.0 - 10.2 only + // Check attachment across shadow DOM boundaries when possible (gh-3504) + // Support: iOS 10.0-10.2 only + // Early iOS 10 versions support `attachShadow` but not `getRootNode`, + // leading to errors. We need to check for `getRootNode`. + if ( documentElement.getRootNode ) { + isAttached = function( elem ) { + return jQuery.contains( elem.ownerDocument, elem ) || + elem.getRootNode( composed ) === elem.ownerDocument; + }; + } +var isHiddenWithinTree = function( elem, el ) { + + // isHiddenWithinTree might be called from jQuery#filter function; + // in that case, element will be second argument + elem = el || elem; + + // Inline style trumps all + return elem.style.display === "none" || + elem.style.display === "" && + + // Otherwise, check computed style + // Support: Firefox <=43 - 45 + // Disconnected elements can have computed display: none, so first confirm that elem is + // in the document. + isAttached( elem ) && + + jQuery.css( elem, "display" ) === "none"; + }; + + + +function adjustCSS( elem, prop, valueParts, tween ) { + var adjusted, scale, + maxIterations = 20, + currentValue = tween ? + function() { + return tween.cur(); + } : + function() { + return jQuery.css( elem, prop, "" ); + }, + initial = currentValue(), + unit = valueParts && valueParts[ 3 ] || ( jQuery.cssNumber[ prop ] ? "" : "px" ), + + // Starting value computation is required for potential unit mismatches + initialInUnit = elem.nodeType && + ( jQuery.cssNumber[ prop ] || unit !== "px" && +initial ) && + rcssNum.exec( jQuery.css( elem, prop ) ); + + if ( initialInUnit && initialInUnit[ 3 ] !== unit ) { + + // Support: Firefox <=54 + // Halve the iteration target value to prevent interference from CSS upper bounds (gh-2144) + initial = initial / 2; + + // Trust units reported by jQuery.css + unit = unit || initialInUnit[ 3 ]; + + // Iteratively approximate from a nonzero starting point + initialInUnit = +initial || 1; + + while ( maxIterations-- ) { + + // Evaluate and update our best guess (doubling guesses that zero out). + // Finish if the scale equals or crosses 1 (making the old*new product non-positive). + jQuery.style( elem, prop, initialInUnit + unit ); + if ( ( 1 - scale ) * ( 1 - ( scale = currentValue() / initial || 0.5 ) ) <= 0 ) { + maxIterations = 0; + } + initialInUnit = initialInUnit / scale; + + } + + initialInUnit = initialInUnit * 2; + jQuery.style( elem, prop, initialInUnit + unit ); + + // Make sure we update the tween properties later on + valueParts = valueParts || []; + } + + if ( valueParts ) { + initialInUnit = +initialInUnit || +initial || 0; + + // Apply relative offset (+=/-=) if specified + adjusted = valueParts[ 1 ] ? + initialInUnit + ( valueParts[ 1 ] + 1 ) * valueParts[ 2 ] : + +valueParts[ 2 ]; + if ( tween ) { + tween.unit = unit; + tween.start = initialInUnit; + tween.end = adjusted; + } + } + return adjusted; +} + + +var defaultDisplayMap = {}; + +function getDefaultDisplay( elem ) { + var temp, + doc = elem.ownerDocument, + nodeName = elem.nodeName, + display = defaultDisplayMap[ nodeName ]; + + if ( display ) { + return display; + } + + temp = doc.body.appendChild( doc.createElement( nodeName ) ); + display = jQuery.css( temp, "display" ); + + temp.parentNode.removeChild( temp ); + + if ( display === "none" ) { + display = "block"; + } + defaultDisplayMap[ nodeName ] = display; + + return display; +} + +function showHide( elements, show ) { + var display, elem, + values = [], + index = 0, + length = elements.length; + + // Determine new display value for elements that need to change + for ( ; index < length; index++ ) { + elem = elements[ index ]; + if ( !elem.style ) { + continue; + } + + display = elem.style.display; + if ( show ) { + + // Since we force visibility upon cascade-hidden elements, an immediate (and slow) + // check is required in this first loop unless we have a nonempty display value (either + // inline or about-to-be-restored) + if ( display === "none" ) { + values[ index ] = dataPriv.get( elem, "display" ) || null; + if ( !values[ index ] ) { + elem.style.display = ""; + } + } + if ( elem.style.display === "" && isHiddenWithinTree( elem ) ) { + values[ index ] = getDefaultDisplay( elem ); + } + } else { + if ( display !== "none" ) { + values[ index ] = "none"; + + // Remember what we're overwriting + dataPriv.set( elem, "display", display ); + } + } + } + + // Set the display of the elements in a second loop to avoid constant reflow + for ( index = 0; index < length; index++ ) { + if ( values[ index ] != null ) { + elements[ index ].style.display = values[ index ]; + } + } + + return elements; +} + +jQuery.fn.extend( { + show: function() { + return showHide( this, true ); + }, + hide: function() { + return showHide( this ); + }, + toggle: function( state ) { + if ( typeof state === "boolean" ) { + return state ? this.show() : this.hide(); + } + + return this.each( function() { + if ( isHiddenWithinTree( this ) ) { + jQuery( this ).show(); + } else { + jQuery( this ).hide(); + } + } ); + } +} ); +var rcheckableType = ( /^(?:checkbox|radio)$/i ); + +var rtagName = ( /<([a-z][^\/\0>\x20\t\r\n\f]*)/i ); + +var rscriptType = ( /^$|^module$|\/(?:java|ecma)script/i ); + + + +( function() { + var fragment = document.createDocumentFragment(), + div = fragment.appendChild( document.createElement( "div" ) ), + input = document.createElement( "input" ); + + // Support: Android 4.0 - 4.3 only + // Check state lost if the name is set (#11217) + // Support: Windows Web Apps (WWA) + // `name` and `type` must use .setAttribute for WWA (#14901) + input.setAttribute( "type", "radio" ); + input.setAttribute( "checked", "checked" ); + input.setAttribute( "name", "t" ); + + div.appendChild( input ); + + // Support: Android <=4.1 only + // Older WebKit doesn't clone checked state correctly in fragments + support.checkClone = div.cloneNode( true ).cloneNode( true ).lastChild.checked; + + // Support: IE <=11 only + // Make sure textarea (and checkbox) defaultValue is properly cloned + div.innerHTML = ""; + support.noCloneChecked = !!div.cloneNode( true ).lastChild.defaultValue; + + // Support: IE <=9 only + // IE <=9 replaces "; + support.option = !!div.lastChild; +} )(); + + +// We have to close these tags to support XHTML (#13200) +var wrapMap = { + + // XHTML parsers do not magically insert elements in the + // same way that tag soup parsers do. So we cannot shorten + // this by omitting or other required elements. + thead: [ 1, "", "
" ], + col: [ 2, "", "
" ], + tr: [ 2, "", "
" ], + td: [ 3, "", "
" ], + + _default: [ 0, "", "" ] +}; + +wrapMap.tbody = wrapMap.tfoot = wrapMap.colgroup = wrapMap.caption = wrapMap.thead; +wrapMap.th = wrapMap.td; + +// Support: IE <=9 only +if ( !support.option ) { + wrapMap.optgroup = wrapMap.option = [ 1, "" ]; +} + + +function getAll( context, tag ) { + + // Support: IE <=9 - 11 only + // Use typeof to avoid zero-argument method invocation on host objects (#15151) + var ret; + + if ( typeof context.getElementsByTagName !== "undefined" ) { + ret = context.getElementsByTagName( tag || "*" ); + + } else if ( typeof context.querySelectorAll !== "undefined" ) { + ret = context.querySelectorAll( tag || "*" ); + + } else { + ret = []; + } + + if ( tag === undefined || tag && nodeName( context, tag ) ) { + return jQuery.merge( [ context ], ret ); + } + + return ret; +} + + +// Mark scripts as having already been evaluated +function setGlobalEval( elems, refElements ) { + var i = 0, + l = elems.length; + + for ( ; i < l; i++ ) { + dataPriv.set( + elems[ i ], + "globalEval", + !refElements || dataPriv.get( refElements[ i ], "globalEval" ) + ); + } +} + + +var rhtml = /<|&#?\w+;/; + +function buildFragment( elems, context, scripts, selection, ignored ) { + var elem, tmp, tag, wrap, attached, j, + fragment = context.createDocumentFragment(), + nodes = [], + i = 0, + l = elems.length; + + for ( ; i < l; i++ ) { + elem = elems[ i ]; + + if ( elem || elem === 0 ) { + + // Add nodes directly + if ( toType( elem ) === "object" ) { + + // Support: Android <=4.0 only, PhantomJS 1 only + // push.apply(_, arraylike) throws on ancient WebKit + jQuery.merge( nodes, elem.nodeType ? [ elem ] : elem ); + + // Convert non-html into a text node + } else if ( !rhtml.test( elem ) ) { + nodes.push( context.createTextNode( elem ) ); + + // Convert html into DOM nodes + } else { + tmp = tmp || fragment.appendChild( context.createElement( "div" ) ); + + // Deserialize a standard representation + tag = ( rtagName.exec( elem ) || [ "", "" ] )[ 1 ].toLowerCase(); + wrap = wrapMap[ tag ] || wrapMap._default; + tmp.innerHTML = wrap[ 1 ] + jQuery.htmlPrefilter( elem ) + wrap[ 2 ]; + + // Descend through wrappers to the right content + j = wrap[ 0 ]; + while ( j-- ) { + tmp = tmp.lastChild; + } + + // Support: Android <=4.0 only, PhantomJS 1 only + // push.apply(_, arraylike) throws on ancient WebKit + jQuery.merge( nodes, tmp.childNodes ); + + // Remember the top-level container + tmp = fragment.firstChild; + + // Ensure the created nodes are orphaned (#12392) + tmp.textContent = ""; + } + } + } + + // Remove wrapper from fragment + fragment.textContent = ""; + + i = 0; + while ( ( elem = nodes[ i++ ] ) ) { + + // Skip elements already in the context collection (trac-4087) + if ( selection && jQuery.inArray( elem, selection ) > -1 ) { + if ( ignored ) { + ignored.push( elem ); + } + continue; + } + + attached = isAttached( elem ); + + // Append to fragment + tmp = getAll( fragment.appendChild( elem ), "script" ); + + // Preserve script evaluation history + if ( attached ) { + setGlobalEval( tmp ); + } + + // Capture executables + if ( scripts ) { + j = 0; + while ( ( elem = tmp[ j++ ] ) ) { + if ( rscriptType.test( elem.type || "" ) ) { + scripts.push( elem ); + } + } + } + } + + return fragment; +} + + +var rtypenamespace = /^([^.]*)(?:\.(.+)|)/; + +function returnTrue() { + return true; +} + +function returnFalse() { + return false; +} + +// Support: IE <=9 - 11+ +// focus() and blur() are asynchronous, except when they are no-op. +// So expect focus to be synchronous when the element is already active, +// and blur to be synchronous when the element is not already active. +// (focus and blur are always synchronous in other supported browsers, +// this just defines when we can count on it). +function expectSync( elem, type ) { + return ( elem === safeActiveElement() ) === ( type === "focus" ); +} + +// Support: IE <=9 only +// Accessing document.activeElement can throw unexpectedly +// https://bugs.jquery.com/ticket/13393 +function safeActiveElement() { + try { + return document.activeElement; + } catch ( err ) { } +} + +function on( elem, types, selector, data, fn, one ) { + var origFn, type; + + // Types can be a map of types/handlers + if ( typeof types === "object" ) { + + // ( types-Object, selector, data ) + if ( typeof selector !== "string" ) { + + // ( types-Object, data ) + data = data || selector; + selector = undefined; + } + for ( type in types ) { + on( elem, type, selector, data, types[ type ], one ); + } + return elem; + } + + if ( data == null && fn == null ) { + + // ( types, fn ) + fn = selector; + data = selector = undefined; + } else if ( fn == null ) { + if ( typeof selector === "string" ) { + + // ( types, selector, fn ) + fn = data; + data = undefined; + } else { + + // ( types, data, fn ) + fn = data; + data = selector; + selector = undefined; + } + } + if ( fn === false ) { + fn = returnFalse; + } else if ( !fn ) { + return elem; + } + + if ( one === 1 ) { + origFn = fn; + fn = function( event ) { + + // Can use an empty set, since event contains the info + jQuery().off( event ); + return origFn.apply( this, arguments ); + }; + + // Use same guid so caller can remove using origFn + fn.guid = origFn.guid || ( origFn.guid = jQuery.guid++ ); + } + return elem.each( function() { + jQuery.event.add( this, types, fn, data, selector ); + } ); +} + +/* + * Helper functions for managing events -- not part of the public interface. + * Props to Dean Edwards' addEvent library for many of the ideas. + */ +jQuery.event = { + + global: {}, + + add: function( elem, types, handler, data, selector ) { + + var handleObjIn, eventHandle, tmp, + events, t, handleObj, + special, handlers, type, namespaces, origType, + elemData = dataPriv.get( elem ); + + // Only attach events to objects that accept data + if ( !acceptData( elem ) ) { + return; + } + + // Caller can pass in an object of custom data in lieu of the handler + if ( handler.handler ) { + handleObjIn = handler; + handler = handleObjIn.handler; + selector = handleObjIn.selector; + } + + // Ensure that invalid selectors throw exceptions at attach time + // Evaluate against documentElement in case elem is a non-element node (e.g., document) + if ( selector ) { + jQuery.find.matchesSelector( documentElement, selector ); + } + + // Make sure that the handler has a unique ID, used to find/remove it later + if ( !handler.guid ) { + handler.guid = jQuery.guid++; + } + + // Init the element's event structure and main handler, if this is the first + if ( !( events = elemData.events ) ) { + events = elemData.events = Object.create( null ); + } + if ( !( eventHandle = elemData.handle ) ) { + eventHandle = elemData.handle = function( e ) { + + // Discard the second event of a jQuery.event.trigger() and + // when an event is called after a page has unloaded + return typeof jQuery !== "undefined" && jQuery.event.triggered !== e.type ? + jQuery.event.dispatch.apply( elem, arguments ) : undefined; + }; + } + + // Handle multiple events separated by a space + types = ( types || "" ).match( rnothtmlwhite ) || [ "" ]; + t = types.length; + while ( t-- ) { + tmp = rtypenamespace.exec( types[ t ] ) || []; + type = origType = tmp[ 1 ]; + namespaces = ( tmp[ 2 ] || "" ).split( "." ).sort(); + + // There *must* be a type, no attaching namespace-only handlers + if ( !type ) { + continue; + } + + // If event changes its type, use the special event handlers for the changed type + special = jQuery.event.special[ type ] || {}; + + // If selector defined, determine special event api type, otherwise given type + type = ( selector ? special.delegateType : special.bindType ) || type; + + // Update special based on newly reset type + special = jQuery.event.special[ type ] || {}; + + // handleObj is passed to all event handlers + handleObj = jQuery.extend( { + type: type, + origType: origType, + data: data, + handler: handler, + guid: handler.guid, + selector: selector, + needsContext: selector && jQuery.expr.match.needsContext.test( selector ), + namespace: namespaces.join( "." ) + }, handleObjIn ); + + // Init the event handler queue if we're the first + if ( !( handlers = events[ type ] ) ) { + handlers = events[ type ] = []; + handlers.delegateCount = 0; + + // Only use addEventListener if the special events handler returns false + if ( !special.setup || + special.setup.call( elem, data, namespaces, eventHandle ) === false ) { + + if ( elem.addEventListener ) { + elem.addEventListener( type, eventHandle ); + } + } + } + + if ( special.add ) { + special.add.call( elem, handleObj ); + + if ( !handleObj.handler.guid ) { + handleObj.handler.guid = handler.guid; + } + } + + // Add to the element's handler list, delegates in front + if ( selector ) { + handlers.splice( handlers.delegateCount++, 0, handleObj ); + } else { + handlers.push( handleObj ); + } + + // Keep track of which events have ever been used, for event optimization + jQuery.event.global[ type ] = true; + } + + }, + + // Detach an event or set of events from an element + remove: function( elem, types, handler, selector, mappedTypes ) { + + var j, origCount, tmp, + events, t, handleObj, + special, handlers, type, namespaces, origType, + elemData = dataPriv.hasData( elem ) && dataPriv.get( elem ); + + if ( !elemData || !( events = elemData.events ) ) { + return; + } + + // Once for each type.namespace in types; type may be omitted + types = ( types || "" ).match( rnothtmlwhite ) || [ "" ]; + t = types.length; + while ( t-- ) { + tmp = rtypenamespace.exec( types[ t ] ) || []; + type = origType = tmp[ 1 ]; + namespaces = ( tmp[ 2 ] || "" ).split( "." ).sort(); + + // Unbind all events (on this namespace, if provided) for the element + if ( !type ) { + for ( type in events ) { + jQuery.event.remove( elem, type + types[ t ], handler, selector, true ); + } + continue; + } + + special = jQuery.event.special[ type ] || {}; + type = ( selector ? special.delegateType : special.bindType ) || type; + handlers = events[ type ] || []; + tmp = tmp[ 2 ] && + new RegExp( "(^|\\.)" + namespaces.join( "\\.(?:.*\\.|)" ) + "(\\.|$)" ); + + // Remove matching events + origCount = j = handlers.length; + while ( j-- ) { + handleObj = handlers[ j ]; + + if ( ( mappedTypes || origType === handleObj.origType ) && + ( !handler || handler.guid === handleObj.guid ) && + ( !tmp || tmp.test( handleObj.namespace ) ) && + ( !selector || selector === handleObj.selector || + selector === "**" && handleObj.selector ) ) { + handlers.splice( j, 1 ); + + if ( handleObj.selector ) { + handlers.delegateCount--; + } + if ( special.remove ) { + special.remove.call( elem, handleObj ); + } + } + } + + // Remove generic event handler if we removed something and no more handlers exist + // (avoids potential for endless recursion during removal of special event handlers) + if ( origCount && !handlers.length ) { + if ( !special.teardown || + special.teardown.call( elem, namespaces, elemData.handle ) === false ) { + + jQuery.removeEvent( elem, type, elemData.handle ); + } + + delete events[ type ]; + } + } + + // Remove data and the expando if it's no longer used + if ( jQuery.isEmptyObject( events ) ) { + dataPriv.remove( elem, "handle events" ); + } + }, + + dispatch: function( nativeEvent ) { + + var i, j, ret, matched, handleObj, handlerQueue, + args = new Array( arguments.length ), + + // Make a writable jQuery.Event from the native event object + event = jQuery.event.fix( nativeEvent ), + + handlers = ( + dataPriv.get( this, "events" ) || Object.create( null ) + )[ event.type ] || [], + special = jQuery.event.special[ event.type ] || {}; + + // Use the fix-ed jQuery.Event rather than the (read-only) native event + args[ 0 ] = event; + + for ( i = 1; i < arguments.length; i++ ) { + args[ i ] = arguments[ i ]; + } + + event.delegateTarget = this; + + // Call the preDispatch hook for the mapped type, and let it bail if desired + if ( special.preDispatch && special.preDispatch.call( this, event ) === false ) { + return; + } + + // Determine handlers + handlerQueue = jQuery.event.handlers.call( this, event, handlers ); + + // Run delegates first; they may want to stop propagation beneath us + i = 0; + while ( ( matched = handlerQueue[ i++ ] ) && !event.isPropagationStopped() ) { + event.currentTarget = matched.elem; + + j = 0; + while ( ( handleObj = matched.handlers[ j++ ] ) && + !event.isImmediatePropagationStopped() ) { + + // If the event is namespaced, then each handler is only invoked if it is + // specially universal or its namespaces are a superset of the event's. + if ( !event.rnamespace || handleObj.namespace === false || + event.rnamespace.test( handleObj.namespace ) ) { + + event.handleObj = handleObj; + event.data = handleObj.data; + + ret = ( ( jQuery.event.special[ handleObj.origType ] || {} ).handle || + handleObj.handler ).apply( matched.elem, args ); + + if ( ret !== undefined ) { + if ( ( event.result = ret ) === false ) { + event.preventDefault(); + event.stopPropagation(); + } + } + } + } + } + + // Call the postDispatch hook for the mapped type + if ( special.postDispatch ) { + special.postDispatch.call( this, event ); + } + + return event.result; + }, + + handlers: function( event, handlers ) { + var i, handleObj, sel, matchedHandlers, matchedSelectors, + handlerQueue = [], + delegateCount = handlers.delegateCount, + cur = event.target; + + // Find delegate handlers + if ( delegateCount && + + // Support: IE <=9 + // Black-hole SVG instance trees (trac-13180) + cur.nodeType && + + // Support: Firefox <=42 + // Suppress spec-violating clicks indicating a non-primary pointer button (trac-3861) + // https://www.w3.org/TR/DOM-Level-3-Events/#event-type-click + // Support: IE 11 only + // ...but not arrow key "clicks" of radio inputs, which can have `button` -1 (gh-2343) + !( event.type === "click" && event.button >= 1 ) ) { + + for ( ; cur !== this; cur = cur.parentNode || this ) { + + // Don't check non-elements (#13208) + // Don't process clicks on disabled elements (#6911, #8165, #11382, #11764) + if ( cur.nodeType === 1 && !( event.type === "click" && cur.disabled === true ) ) { + matchedHandlers = []; + matchedSelectors = {}; + for ( i = 0; i < delegateCount; i++ ) { + handleObj = handlers[ i ]; + + // Don't conflict with Object.prototype properties (#13203) + sel = handleObj.selector + " "; + + if ( matchedSelectors[ sel ] === undefined ) { + matchedSelectors[ sel ] = handleObj.needsContext ? + jQuery( sel, this ).index( cur ) > -1 : + jQuery.find( sel, this, null, [ cur ] ).length; + } + if ( matchedSelectors[ sel ] ) { + matchedHandlers.push( handleObj ); + } + } + if ( matchedHandlers.length ) { + handlerQueue.push( { elem: cur, handlers: matchedHandlers } ); + } + } + } + } + + // Add the remaining (directly-bound) handlers + cur = this; + if ( delegateCount < handlers.length ) { + handlerQueue.push( { elem: cur, handlers: handlers.slice( delegateCount ) } ); + } + + return handlerQueue; + }, + + addProp: function( name, hook ) { + Object.defineProperty( jQuery.Event.prototype, name, { + enumerable: true, + configurable: true, + + get: isFunction( hook ) ? + function() { + if ( this.originalEvent ) { + return hook( this.originalEvent ); + } + } : + function() { + if ( this.originalEvent ) { + return this.originalEvent[ name ]; + } + }, + + set: function( value ) { + Object.defineProperty( this, name, { + enumerable: true, + configurable: true, + writable: true, + value: value + } ); + } + } ); + }, + + fix: function( originalEvent ) { + return originalEvent[ jQuery.expando ] ? + originalEvent : + new jQuery.Event( originalEvent ); + }, + + special: { + load: { + + // Prevent triggered image.load events from bubbling to window.load + noBubble: true + }, + click: { + + // Utilize native event to ensure correct state for checkable inputs + setup: function( data ) { + + // For mutual compressibility with _default, replace `this` access with a local var. + // `|| data` is dead code meant only to preserve the variable through minification. + var el = this || data; + + // Claim the first handler + if ( rcheckableType.test( el.type ) && + el.click && nodeName( el, "input" ) ) { + + // dataPriv.set( el, "click", ... ) + leverageNative( el, "click", returnTrue ); + } + + // Return false to allow normal processing in the caller + return false; + }, + trigger: function( data ) { + + // For mutual compressibility with _default, replace `this` access with a local var. + // `|| data` is dead code meant only to preserve the variable through minification. + var el = this || data; + + // Force setup before triggering a click + if ( rcheckableType.test( el.type ) && + el.click && nodeName( el, "input" ) ) { + + leverageNative( el, "click" ); + } + + // Return non-false to allow normal event-path propagation + return true; + }, + + // For cross-browser consistency, suppress native .click() on links + // Also prevent it if we're currently inside a leveraged native-event stack + _default: function( event ) { + var target = event.target; + return rcheckableType.test( target.type ) && + target.click && nodeName( target, "input" ) && + dataPriv.get( target, "click" ) || + nodeName( target, "a" ); + } + }, + + beforeunload: { + postDispatch: function( event ) { + + // Support: Firefox 20+ + // Firefox doesn't alert if the returnValue field is not set. + if ( event.result !== undefined && event.originalEvent ) { + event.originalEvent.returnValue = event.result; + } + } + } + } +}; + +// Ensure the presence of an event listener that handles manually-triggered +// synthetic events by interrupting progress until reinvoked in response to +// *native* events that it fires directly, ensuring that state changes have +// already occurred before other listeners are invoked. +function leverageNative( el, type, expectSync ) { + + // Missing expectSync indicates a trigger call, which must force setup through jQuery.event.add + if ( !expectSync ) { + if ( dataPriv.get( el, type ) === undefined ) { + jQuery.event.add( el, type, returnTrue ); + } + return; + } + + // Register the controller as a special universal handler for all event namespaces + dataPriv.set( el, type, false ); + jQuery.event.add( el, type, { + namespace: false, + handler: function( event ) { + var notAsync, result, + saved = dataPriv.get( this, type ); + + if ( ( event.isTrigger & 1 ) && this[ type ] ) { + + // Interrupt processing of the outer synthetic .trigger()ed event + // Saved data should be false in such cases, but might be a leftover capture object + // from an async native handler (gh-4350) + if ( !saved.length ) { + + // Store arguments for use when handling the inner native event + // There will always be at least one argument (an event object), so this array + // will not be confused with a leftover capture object. + saved = slice.call( arguments ); + dataPriv.set( this, type, saved ); + + // Trigger the native event and capture its result + // Support: IE <=9 - 11+ + // focus() and blur() are asynchronous + notAsync = expectSync( this, type ); + this[ type ](); + result = dataPriv.get( this, type ); + if ( saved !== result || notAsync ) { + dataPriv.set( this, type, false ); + } else { + result = {}; + } + if ( saved !== result ) { + + // Cancel the outer synthetic event + event.stopImmediatePropagation(); + event.preventDefault(); + + // Support: Chrome 86+ + // In Chrome, if an element having a focusout handler is blurred by + // clicking outside of it, it invokes the handler synchronously. If + // that handler calls `.remove()` on the element, the data is cleared, + // leaving `result` undefined. We need to guard against this. + return result && result.value; + } + + // If this is an inner synthetic event for an event with a bubbling surrogate + // (focus or blur), assume that the surrogate already propagated from triggering the + // native event and prevent that from happening again here. + // This technically gets the ordering wrong w.r.t. to `.trigger()` (in which the + // bubbling surrogate propagates *after* the non-bubbling base), but that seems + // less bad than duplication. + } else if ( ( jQuery.event.special[ type ] || {} ).delegateType ) { + event.stopPropagation(); + } + + // If this is a native event triggered above, everything is now in order + // Fire an inner synthetic event with the original arguments + } else if ( saved.length ) { + + // ...and capture the result + dataPriv.set( this, type, { + value: jQuery.event.trigger( + + // Support: IE <=9 - 11+ + // Extend with the prototype to reset the above stopImmediatePropagation() + jQuery.extend( saved[ 0 ], jQuery.Event.prototype ), + saved.slice( 1 ), + this + ) + } ); + + // Abort handling of the native event + event.stopImmediatePropagation(); + } + } + } ); +} + +jQuery.removeEvent = function( elem, type, handle ) { + + // This "if" is needed for plain objects + if ( elem.removeEventListener ) { + elem.removeEventListener( type, handle ); + } +}; + +jQuery.Event = function( src, props ) { + + // Allow instantiation without the 'new' keyword + if ( !( this instanceof jQuery.Event ) ) { + return new jQuery.Event( src, props ); + } + + // Event object + if ( src && src.type ) { + this.originalEvent = src; + this.type = src.type; + + // Events bubbling up the document may have been marked as prevented + // by a handler lower down the tree; reflect the correct value. + this.isDefaultPrevented = src.defaultPrevented || + src.defaultPrevented === undefined && + + // Support: Android <=2.3 only + src.returnValue === false ? + returnTrue : + returnFalse; + + // Create target properties + // Support: Safari <=6 - 7 only + // Target should not be a text node (#504, #13143) + this.target = ( src.target && src.target.nodeType === 3 ) ? + src.target.parentNode : + src.target; + + this.currentTarget = src.currentTarget; + this.relatedTarget = src.relatedTarget; + + // Event type + } else { + this.type = src; + } + + // Put explicitly provided properties onto the event object + if ( props ) { + jQuery.extend( this, props ); + } + + // Create a timestamp if incoming event doesn't have one + this.timeStamp = src && src.timeStamp || Date.now(); + + // Mark it as fixed + this[ jQuery.expando ] = true; +}; + +// jQuery.Event is based on DOM3 Events as specified by the ECMAScript Language Binding +// https://www.w3.org/TR/2003/WD-DOM-Level-3-Events-20030331/ecma-script-binding.html +jQuery.Event.prototype = { + constructor: jQuery.Event, + isDefaultPrevented: returnFalse, + isPropagationStopped: returnFalse, + isImmediatePropagationStopped: returnFalse, + isSimulated: false, + + preventDefault: function() { + var e = this.originalEvent; + + this.isDefaultPrevented = returnTrue; + + if ( e && !this.isSimulated ) { + e.preventDefault(); + } + }, + stopPropagation: function() { + var e = this.originalEvent; + + this.isPropagationStopped = returnTrue; + + if ( e && !this.isSimulated ) { + e.stopPropagation(); + } + }, + stopImmediatePropagation: function() { + var e = this.originalEvent; + + this.isImmediatePropagationStopped = returnTrue; + + if ( e && !this.isSimulated ) { + e.stopImmediatePropagation(); + } + + this.stopPropagation(); + } +}; + +// Includes all common event props including KeyEvent and MouseEvent specific props +jQuery.each( { + altKey: true, + bubbles: true, + cancelable: true, + changedTouches: true, + ctrlKey: true, + detail: true, + eventPhase: true, + metaKey: true, + pageX: true, + pageY: true, + shiftKey: true, + view: true, + "char": true, + code: true, + charCode: true, + key: true, + keyCode: true, + button: true, + buttons: true, + clientX: true, + clientY: true, + offsetX: true, + offsetY: true, + pointerId: true, + pointerType: true, + screenX: true, + screenY: true, + targetTouches: true, + toElement: true, + touches: true, + which: true +}, jQuery.event.addProp ); + +jQuery.each( { focus: "focusin", blur: "focusout" }, function( type, delegateType ) { + jQuery.event.special[ type ] = { + + // Utilize native event if possible so blur/focus sequence is correct + setup: function() { + + // Claim the first handler + // dataPriv.set( this, "focus", ... ) + // dataPriv.set( this, "blur", ... ) + leverageNative( this, type, expectSync ); + + // Return false to allow normal processing in the caller + return false; + }, + trigger: function() { + + // Force setup before trigger + leverageNative( this, type ); + + // Return non-false to allow normal event-path propagation + return true; + }, + + // Suppress native focus or blur as it's already being fired + // in leverageNative. + _default: function() { + return true; + }, + + delegateType: delegateType + }; +} ); + +// Create mouseenter/leave events using mouseover/out and event-time checks +// so that event delegation works in jQuery. +// Do the same for pointerenter/pointerleave and pointerover/pointerout +// +// Support: Safari 7 only +// Safari sends mouseenter too often; see: +// https://bugs.chromium.org/p/chromium/issues/detail?id=470258 +// for the description of the bug (it existed in older Chrome versions as well). +jQuery.each( { + mouseenter: "mouseover", + mouseleave: "mouseout", + pointerenter: "pointerover", + pointerleave: "pointerout" +}, function( orig, fix ) { + jQuery.event.special[ orig ] = { + delegateType: fix, + bindType: fix, + + handle: function( event ) { + var ret, + target = this, + related = event.relatedTarget, + handleObj = event.handleObj; + + // For mouseenter/leave call the handler if related is outside the target. + // NB: No relatedTarget if the mouse left/entered the browser window + if ( !related || ( related !== target && !jQuery.contains( target, related ) ) ) { + event.type = handleObj.origType; + ret = handleObj.handler.apply( this, arguments ); + event.type = fix; + } + return ret; + } + }; +} ); + +jQuery.fn.extend( { + + on: function( types, selector, data, fn ) { + return on( this, types, selector, data, fn ); + }, + one: function( types, selector, data, fn ) { + return on( this, types, selector, data, fn, 1 ); + }, + off: function( types, selector, fn ) { + var handleObj, type; + if ( types && types.preventDefault && types.handleObj ) { + + // ( event ) dispatched jQuery.Event + handleObj = types.handleObj; + jQuery( types.delegateTarget ).off( + handleObj.namespace ? + handleObj.origType + "." + handleObj.namespace : + handleObj.origType, + handleObj.selector, + handleObj.handler + ); + return this; + } + if ( typeof types === "object" ) { + + // ( types-object [, selector] ) + for ( type in types ) { + this.off( type, selector, types[ type ] ); + } + return this; + } + if ( selector === false || typeof selector === "function" ) { + + // ( types [, fn] ) + fn = selector; + selector = undefined; + } + if ( fn === false ) { + fn = returnFalse; + } + return this.each( function() { + jQuery.event.remove( this, types, fn, selector ); + } ); + } +} ); + + +var + + // Support: IE <=10 - 11, Edge 12 - 13 only + // In IE/Edge using regex groups here causes severe slowdowns. + // See https://connect.microsoft.com/IE/feedback/details/1736512/ + rnoInnerhtml = /\s*$/g; + +// Prefer a tbody over its parent table for containing new rows +function manipulationTarget( elem, content ) { + if ( nodeName( elem, "table" ) && + nodeName( content.nodeType !== 11 ? content : content.firstChild, "tr" ) ) { + + return jQuery( elem ).children( "tbody" )[ 0 ] || elem; + } + + return elem; +} + +// Replace/restore the type attribute of script elements for safe DOM manipulation +function disableScript( elem ) { + elem.type = ( elem.getAttribute( "type" ) !== null ) + "/" + elem.type; + return elem; +} +function restoreScript( elem ) { + if ( ( elem.type || "" ).slice( 0, 5 ) === "true/" ) { + elem.type = elem.type.slice( 5 ); + } else { + elem.removeAttribute( "type" ); + } + + return elem; +} + +function cloneCopyEvent( src, dest ) { + var i, l, type, pdataOld, udataOld, udataCur, events; + + if ( dest.nodeType !== 1 ) { + return; + } + + // 1. Copy private data: events, handlers, etc. + if ( dataPriv.hasData( src ) ) { + pdataOld = dataPriv.get( src ); + events = pdataOld.events; + + if ( events ) { + dataPriv.remove( dest, "handle events" ); + + for ( type in events ) { + for ( i = 0, l = events[ type ].length; i < l; i++ ) { + jQuery.event.add( dest, type, events[ type ][ i ] ); + } + } + } + } + + // 2. Copy user data + if ( dataUser.hasData( src ) ) { + udataOld = dataUser.access( src ); + udataCur = jQuery.extend( {}, udataOld ); + + dataUser.set( dest, udataCur ); + } +} + +// Fix IE bugs, see support tests +function fixInput( src, dest ) { + var nodeName = dest.nodeName.toLowerCase(); + + // Fails to persist the checked state of a cloned checkbox or radio button. + if ( nodeName === "input" && rcheckableType.test( src.type ) ) { + dest.checked = src.checked; + + // Fails to return the selected option to the default selected state when cloning options + } else if ( nodeName === "input" || nodeName === "textarea" ) { + dest.defaultValue = src.defaultValue; + } +} + +function domManip( collection, args, callback, ignored ) { + + // Flatten any nested arrays + args = flat( args ); + + var fragment, first, scripts, hasScripts, node, doc, + i = 0, + l = collection.length, + iNoClone = l - 1, + value = args[ 0 ], + valueIsFunction = isFunction( value ); + + // We can't cloneNode fragments that contain checked, in WebKit + if ( valueIsFunction || + ( l > 1 && typeof value === "string" && + !support.checkClone && rchecked.test( value ) ) ) { + return collection.each( function( index ) { + var self = collection.eq( index ); + if ( valueIsFunction ) { + args[ 0 ] = value.call( this, index, self.html() ); + } + domManip( self, args, callback, ignored ); + } ); + } + + if ( l ) { + fragment = buildFragment( args, collection[ 0 ].ownerDocument, false, collection, ignored ); + first = fragment.firstChild; + + if ( fragment.childNodes.length === 1 ) { + fragment = first; + } + + // Require either new content or an interest in ignored elements to invoke the callback + if ( first || ignored ) { + scripts = jQuery.map( getAll( fragment, "script" ), disableScript ); + hasScripts = scripts.length; + + // Use the original fragment for the last item + // instead of the first because it can end up + // being emptied incorrectly in certain situations (#8070). + for ( ; i < l; i++ ) { + node = fragment; + + if ( i !== iNoClone ) { + node = jQuery.clone( node, true, true ); + + // Keep references to cloned scripts for later restoration + if ( hasScripts ) { + + // Support: Android <=4.0 only, PhantomJS 1 only + // push.apply(_, arraylike) throws on ancient WebKit + jQuery.merge( scripts, getAll( node, "script" ) ); + } + } + + callback.call( collection[ i ], node, i ); + } + + if ( hasScripts ) { + doc = scripts[ scripts.length - 1 ].ownerDocument; + + // Reenable scripts + jQuery.map( scripts, restoreScript ); + + // Evaluate executable scripts on first document insertion + for ( i = 0; i < hasScripts; i++ ) { + node = scripts[ i ]; + if ( rscriptType.test( node.type || "" ) && + !dataPriv.access( node, "globalEval" ) && + jQuery.contains( doc, node ) ) { + + if ( node.src && ( node.type || "" ).toLowerCase() !== "module" ) { + + // Optional AJAX dependency, but won't run scripts if not present + if ( jQuery._evalUrl && !node.noModule ) { + jQuery._evalUrl( node.src, { + nonce: node.nonce || node.getAttribute( "nonce" ) + }, doc ); + } + } else { + DOMEval( node.textContent.replace( rcleanScript, "" ), node, doc ); + } + } + } + } + } + } + + return collection; +} + +function remove( elem, selector, keepData ) { + var node, + nodes = selector ? jQuery.filter( selector, elem ) : elem, + i = 0; + + for ( ; ( node = nodes[ i ] ) != null; i++ ) { + if ( !keepData && node.nodeType === 1 ) { + jQuery.cleanData( getAll( node ) ); + } + + if ( node.parentNode ) { + if ( keepData && isAttached( node ) ) { + setGlobalEval( getAll( node, "script" ) ); + } + node.parentNode.removeChild( node ); + } + } + + return elem; +} + +jQuery.extend( { + htmlPrefilter: function( html ) { + return html; + }, + + clone: function( elem, dataAndEvents, deepDataAndEvents ) { + var i, l, srcElements, destElements, + clone = elem.cloneNode( true ), + inPage = isAttached( elem ); + + // Fix IE cloning issues + if ( !support.noCloneChecked && ( elem.nodeType === 1 || elem.nodeType === 11 ) && + !jQuery.isXMLDoc( elem ) ) { + + // We eschew Sizzle here for performance reasons: https://jsperf.com/getall-vs-sizzle/2 + destElements = getAll( clone ); + srcElements = getAll( elem ); + + for ( i = 0, l = srcElements.length; i < l; i++ ) { + fixInput( srcElements[ i ], destElements[ i ] ); + } + } + + // Copy the events from the original to the clone + if ( dataAndEvents ) { + if ( deepDataAndEvents ) { + srcElements = srcElements || getAll( elem ); + destElements = destElements || getAll( clone ); + + for ( i = 0, l = srcElements.length; i < l; i++ ) { + cloneCopyEvent( srcElements[ i ], destElements[ i ] ); + } + } else { + cloneCopyEvent( elem, clone ); + } + } + + // Preserve script evaluation history + destElements = getAll( clone, "script" ); + if ( destElements.length > 0 ) { + setGlobalEval( destElements, !inPage && getAll( elem, "script" ) ); + } + + // Return the cloned set + return clone; + }, + + cleanData: function( elems ) { + var data, elem, type, + special = jQuery.event.special, + i = 0; + + for ( ; ( elem = elems[ i ] ) !== undefined; i++ ) { + if ( acceptData( elem ) ) { + if ( ( data = elem[ dataPriv.expando ] ) ) { + if ( data.events ) { + for ( type in data.events ) { + if ( special[ type ] ) { + jQuery.event.remove( elem, type ); + + // This is a shortcut to avoid jQuery.event.remove's overhead + } else { + jQuery.removeEvent( elem, type, data.handle ); + } + } + } + + // Support: Chrome <=35 - 45+ + // Assign undefined instead of using delete, see Data#remove + elem[ dataPriv.expando ] = undefined; + } + if ( elem[ dataUser.expando ] ) { + + // Support: Chrome <=35 - 45+ + // Assign undefined instead of using delete, see Data#remove + elem[ dataUser.expando ] = undefined; + } + } + } + } +} ); + +jQuery.fn.extend( { + detach: function( selector ) { + return remove( this, selector, true ); + }, + + remove: function( selector ) { + return remove( this, selector ); + }, + + text: function( value ) { + return access( this, function( value ) { + return value === undefined ? + jQuery.text( this ) : + this.empty().each( function() { + if ( this.nodeType === 1 || this.nodeType === 11 || this.nodeType === 9 ) { + this.textContent = value; + } + } ); + }, null, value, arguments.length ); + }, + + append: function() { + return domManip( this, arguments, function( elem ) { + if ( this.nodeType === 1 || this.nodeType === 11 || this.nodeType === 9 ) { + var target = manipulationTarget( this, elem ); + target.appendChild( elem ); + } + } ); + }, + + prepend: function() { + return domManip( this, arguments, function( elem ) { + if ( this.nodeType === 1 || this.nodeType === 11 || this.nodeType === 9 ) { + var target = manipulationTarget( this, elem ); + target.insertBefore( elem, target.firstChild ); + } + } ); + }, + + before: function() { + return domManip( this, arguments, function( elem ) { + if ( this.parentNode ) { + this.parentNode.insertBefore( elem, this ); + } + } ); + }, + + after: function() { + return domManip( this, arguments, function( elem ) { + if ( this.parentNode ) { + this.parentNode.insertBefore( elem, this.nextSibling ); + } + } ); + }, + + empty: function() { + var elem, + i = 0; + + for ( ; ( elem = this[ i ] ) != null; i++ ) { + if ( elem.nodeType === 1 ) { + + // Prevent memory leaks + jQuery.cleanData( getAll( elem, false ) ); + + // Remove any remaining nodes + elem.textContent = ""; + } + } + + return this; + }, + + clone: function( dataAndEvents, deepDataAndEvents ) { + dataAndEvents = dataAndEvents == null ? false : dataAndEvents; + deepDataAndEvents = deepDataAndEvents == null ? dataAndEvents : deepDataAndEvents; + + return this.map( function() { + return jQuery.clone( this, dataAndEvents, deepDataAndEvents ); + } ); + }, + + html: function( value ) { + return access( this, function( value ) { + var elem = this[ 0 ] || {}, + i = 0, + l = this.length; + + if ( value === undefined && elem.nodeType === 1 ) { + return elem.innerHTML; + } + + // See if we can take a shortcut and just use innerHTML + if ( typeof value === "string" && !rnoInnerhtml.test( value ) && + !wrapMap[ ( rtagName.exec( value ) || [ "", "" ] )[ 1 ].toLowerCase() ] ) { + + value = jQuery.htmlPrefilter( value ); + + try { + for ( ; i < l; i++ ) { + elem = this[ i ] || {}; + + // Remove element nodes and prevent memory leaks + if ( elem.nodeType === 1 ) { + jQuery.cleanData( getAll( elem, false ) ); + elem.innerHTML = value; + } + } + + elem = 0; + + // If using innerHTML throws an exception, use the fallback method + } catch ( e ) {} + } + + if ( elem ) { + this.empty().append( value ); + } + }, null, value, arguments.length ); + }, + + replaceWith: function() { + var ignored = []; + + // Make the changes, replacing each non-ignored context element with the new content + return domManip( this, arguments, function( elem ) { + var parent = this.parentNode; + + if ( jQuery.inArray( this, ignored ) < 0 ) { + jQuery.cleanData( getAll( this ) ); + if ( parent ) { + parent.replaceChild( elem, this ); + } + } + + // Force callback invocation + }, ignored ); + } +} ); + +jQuery.each( { + appendTo: "append", + prependTo: "prepend", + insertBefore: "before", + insertAfter: "after", + replaceAll: "replaceWith" +}, function( name, original ) { + jQuery.fn[ name ] = function( selector ) { + var elems, + ret = [], + insert = jQuery( selector ), + last = insert.length - 1, + i = 0; + + for ( ; i <= last; i++ ) { + elems = i === last ? this : this.clone( true ); + jQuery( insert[ i ] )[ original ]( elems ); + + // Support: Android <=4.0 only, PhantomJS 1 only + // .get() because push.apply(_, arraylike) throws on ancient WebKit + push.apply( ret, elems.get() ); + } + + return this.pushStack( ret ); + }; +} ); +var rnumnonpx = new RegExp( "^(" + pnum + ")(?!px)[a-z%]+$", "i" ); + +var getStyles = function( elem ) { + + // Support: IE <=11 only, Firefox <=30 (#15098, #14150) + // IE throws on elements created in popups + // FF meanwhile throws on frame elements through "defaultView.getComputedStyle" + var view = elem.ownerDocument.defaultView; + + if ( !view || !view.opener ) { + view = window; + } + + return view.getComputedStyle( elem ); + }; + +var swap = function( elem, options, callback ) { + var ret, name, + old = {}; + + // Remember the old values, and insert the new ones + for ( name in options ) { + old[ name ] = elem.style[ name ]; + elem.style[ name ] = options[ name ]; + } + + ret = callback.call( elem ); + + // Revert the old values + for ( name in options ) { + elem.style[ name ] = old[ name ]; + } + + return ret; +}; + + +var rboxStyle = new RegExp( cssExpand.join( "|" ), "i" ); + + + +( function() { + + // Executing both pixelPosition & boxSizingReliable tests require only one layout + // so they're executed at the same time to save the second computation. + function computeStyleTests() { + + // This is a singleton, we need to execute it only once + if ( !div ) { + return; + } + + container.style.cssText = "position:absolute;left:-11111px;width:60px;" + + "margin-top:1px;padding:0;border:0"; + div.style.cssText = + "position:relative;display:block;box-sizing:border-box;overflow:scroll;" + + "margin:auto;border:1px;padding:1px;" + + "width:60%;top:1%"; + documentElement.appendChild( container ).appendChild( div ); + + var divStyle = window.getComputedStyle( div ); + pixelPositionVal = divStyle.top !== "1%"; + + // Support: Android 4.0 - 4.3 only, Firefox <=3 - 44 + reliableMarginLeftVal = roundPixelMeasures( divStyle.marginLeft ) === 12; + + // Support: Android 4.0 - 4.3 only, Safari <=9.1 - 10.1, iOS <=7.0 - 9.3 + // Some styles come back with percentage values, even though they shouldn't + div.style.right = "60%"; + pixelBoxStylesVal = roundPixelMeasures( divStyle.right ) === 36; + + // Support: IE 9 - 11 only + // Detect misreporting of content dimensions for box-sizing:border-box elements + boxSizingReliableVal = roundPixelMeasures( divStyle.width ) === 36; + + // Support: IE 9 only + // Detect overflow:scroll screwiness (gh-3699) + // Support: Chrome <=64 + // Don't get tricked when zoom affects offsetWidth (gh-4029) + div.style.position = "absolute"; + scrollboxSizeVal = roundPixelMeasures( div.offsetWidth / 3 ) === 12; + + documentElement.removeChild( container ); + + // Nullify the div so it wouldn't be stored in the memory and + // it will also be a sign that checks already performed + div = null; + } + + function roundPixelMeasures( measure ) { + return Math.round( parseFloat( measure ) ); + } + + var pixelPositionVal, boxSizingReliableVal, scrollboxSizeVal, pixelBoxStylesVal, + reliableTrDimensionsVal, reliableMarginLeftVal, + container = document.createElement( "div" ), + div = document.createElement( "div" ); + + // Finish early in limited (non-browser) environments + if ( !div.style ) { + return; + } + + // Support: IE <=9 - 11 only + // Style of cloned element affects source element cloned (#8908) + div.style.backgroundClip = "content-box"; + div.cloneNode( true ).style.backgroundClip = ""; + support.clearCloneStyle = div.style.backgroundClip === "content-box"; + + jQuery.extend( support, { + boxSizingReliable: function() { + computeStyleTests(); + return boxSizingReliableVal; + }, + pixelBoxStyles: function() { + computeStyleTests(); + return pixelBoxStylesVal; + }, + pixelPosition: function() { + computeStyleTests(); + return pixelPositionVal; + }, + reliableMarginLeft: function() { + computeStyleTests(); + return reliableMarginLeftVal; + }, + scrollboxSize: function() { + computeStyleTests(); + return scrollboxSizeVal; + }, + + // Support: IE 9 - 11+, Edge 15 - 18+ + // IE/Edge misreport `getComputedStyle` of table rows with width/height + // set in CSS while `offset*` properties report correct values. + // Behavior in IE 9 is more subtle than in newer versions & it passes + // some versions of this test; make sure not to make it pass there! + // + // Support: Firefox 70+ + // Only Firefox includes border widths + // in computed dimensions. (gh-4529) + reliableTrDimensions: function() { + var table, tr, trChild, trStyle; + if ( reliableTrDimensionsVal == null ) { + table = document.createElement( "table" ); + tr = document.createElement( "tr" ); + trChild = document.createElement( "div" ); + + table.style.cssText = "position:absolute;left:-11111px;border-collapse:separate"; + tr.style.cssText = "border:1px solid"; + + // Support: Chrome 86+ + // Height set through cssText does not get applied. + // Computed height then comes back as 0. + tr.style.height = "1px"; + trChild.style.height = "9px"; + + // Support: Android 8 Chrome 86+ + // In our bodyBackground.html iframe, + // display for all div elements is set to "inline", + // which causes a problem only in Android 8 Chrome 86. + // Ensuring the div is display: block + // gets around this issue. + trChild.style.display = "block"; + + documentElement + .appendChild( table ) + .appendChild( tr ) + .appendChild( trChild ); + + trStyle = window.getComputedStyle( tr ); + reliableTrDimensionsVal = ( parseInt( trStyle.height, 10 ) + + parseInt( trStyle.borderTopWidth, 10 ) + + parseInt( trStyle.borderBottomWidth, 10 ) ) === tr.offsetHeight; + + documentElement.removeChild( table ); + } + return reliableTrDimensionsVal; + } + } ); +} )(); + + +function curCSS( elem, name, computed ) { + var width, minWidth, maxWidth, ret, + + // Support: Firefox 51+ + // Retrieving style before computed somehow + // fixes an issue with getting wrong values + // on detached elements + style = elem.style; + + computed = computed || getStyles( elem ); + + // getPropertyValue is needed for: + // .css('filter') (IE 9 only, #12537) + // .css('--customProperty) (#3144) + if ( computed ) { + ret = computed.getPropertyValue( name ) || computed[ name ]; + + if ( ret === "" && !isAttached( elem ) ) { + ret = jQuery.style( elem, name ); + } + + // A tribute to the "awesome hack by Dean Edwards" + // Android Browser returns percentage for some values, + // but width seems to be reliably pixels. + // This is against the CSSOM draft spec: + // https://drafts.csswg.org/cssom/#resolved-values + if ( !support.pixelBoxStyles() && rnumnonpx.test( ret ) && rboxStyle.test( name ) ) { + + // Remember the original values + width = style.width; + minWidth = style.minWidth; + maxWidth = style.maxWidth; + + // Put in the new values to get a computed value out + style.minWidth = style.maxWidth = style.width = ret; + ret = computed.width; + + // Revert the changed values + style.width = width; + style.minWidth = minWidth; + style.maxWidth = maxWidth; + } + } + + return ret !== undefined ? + + // Support: IE <=9 - 11 only + // IE returns zIndex value as an integer. + ret + "" : + ret; +} + + +function addGetHookIf( conditionFn, hookFn ) { + + // Define the hook, we'll check on the first run if it's really needed. + return { + get: function() { + if ( conditionFn() ) { + + // Hook not needed (or it's not possible to use it due + // to missing dependency), remove it. + delete this.get; + return; + } + + // Hook needed; redefine it so that the support test is not executed again. + return ( this.get = hookFn ).apply( this, arguments ); + } + }; +} + + +var cssPrefixes = [ "Webkit", "Moz", "ms" ], + emptyStyle = document.createElement( "div" ).style, + vendorProps = {}; + +// Return a vendor-prefixed property or undefined +function vendorPropName( name ) { + + // Check for vendor prefixed names + var capName = name[ 0 ].toUpperCase() + name.slice( 1 ), + i = cssPrefixes.length; + + while ( i-- ) { + name = cssPrefixes[ i ] + capName; + if ( name in emptyStyle ) { + return name; + } + } +} + +// Return a potentially-mapped jQuery.cssProps or vendor prefixed property +function finalPropName( name ) { + var final = jQuery.cssProps[ name ] || vendorProps[ name ]; + + if ( final ) { + return final; + } + if ( name in emptyStyle ) { + return name; + } + return vendorProps[ name ] = vendorPropName( name ) || name; +} + + +var + + // Swappable if display is none or starts with table + // except "table", "table-cell", or "table-caption" + // See here for display values: https://developer.mozilla.org/en-US/docs/CSS/display + rdisplayswap = /^(none|table(?!-c[ea]).+)/, + rcustomProp = /^--/, + cssShow = { position: "absolute", visibility: "hidden", display: "block" }, + cssNormalTransform = { + letterSpacing: "0", + fontWeight: "400" + }; + +function setPositiveNumber( _elem, value, subtract ) { + + // Any relative (+/-) values have already been + // normalized at this point + var matches = rcssNum.exec( value ); + return matches ? + + // Guard against undefined "subtract", e.g., when used as in cssHooks + Math.max( 0, matches[ 2 ] - ( subtract || 0 ) ) + ( matches[ 3 ] || "px" ) : + value; +} + +function boxModelAdjustment( elem, dimension, box, isBorderBox, styles, computedVal ) { + var i = dimension === "width" ? 1 : 0, + extra = 0, + delta = 0; + + // Adjustment may not be necessary + if ( box === ( isBorderBox ? "border" : "content" ) ) { + return 0; + } + + for ( ; i < 4; i += 2 ) { + + // Both box models exclude margin + if ( box === "margin" ) { + delta += jQuery.css( elem, box + cssExpand[ i ], true, styles ); + } + + // If we get here with a content-box, we're seeking "padding" or "border" or "margin" + if ( !isBorderBox ) { + + // Add padding + delta += jQuery.css( elem, "padding" + cssExpand[ i ], true, styles ); + + // For "border" or "margin", add border + if ( box !== "padding" ) { + delta += jQuery.css( elem, "border" + cssExpand[ i ] + "Width", true, styles ); + + // But still keep track of it otherwise + } else { + extra += jQuery.css( elem, "border" + cssExpand[ i ] + "Width", true, styles ); + } + + // If we get here with a border-box (content + padding + border), we're seeking "content" or + // "padding" or "margin" + } else { + + // For "content", subtract padding + if ( box === "content" ) { + delta -= jQuery.css( elem, "padding" + cssExpand[ i ], true, styles ); + } + + // For "content" or "padding", subtract border + if ( box !== "margin" ) { + delta -= jQuery.css( elem, "border" + cssExpand[ i ] + "Width", true, styles ); + } + } + } + + // Account for positive content-box scroll gutter when requested by providing computedVal + if ( !isBorderBox && computedVal >= 0 ) { + + // offsetWidth/offsetHeight is a rounded sum of content, padding, scroll gutter, and border + // Assuming integer scroll gutter, subtract the rest and round down + delta += Math.max( 0, Math.ceil( + elem[ "offset" + dimension[ 0 ].toUpperCase() + dimension.slice( 1 ) ] - + computedVal - + delta - + extra - + 0.5 + + // If offsetWidth/offsetHeight is unknown, then we can't determine content-box scroll gutter + // Use an explicit zero to avoid NaN (gh-3964) + ) ) || 0; + } + + return delta; +} + +function getWidthOrHeight( elem, dimension, extra ) { + + // Start with computed style + var styles = getStyles( elem ), + + // To avoid forcing a reflow, only fetch boxSizing if we need it (gh-4322). + // Fake content-box until we know it's needed to know the true value. + boxSizingNeeded = !support.boxSizingReliable() || extra, + isBorderBox = boxSizingNeeded && + jQuery.css( elem, "boxSizing", false, styles ) === "border-box", + valueIsBorderBox = isBorderBox, + + val = curCSS( elem, dimension, styles ), + offsetProp = "offset" + dimension[ 0 ].toUpperCase() + dimension.slice( 1 ); + + // Support: Firefox <=54 + // Return a confounding non-pixel value or feign ignorance, as appropriate. + if ( rnumnonpx.test( val ) ) { + if ( !extra ) { + return val; + } + val = "auto"; + } + + + // Support: IE 9 - 11 only + // Use offsetWidth/offsetHeight for when box sizing is unreliable. + // In those cases, the computed value can be trusted to be border-box. + if ( ( !support.boxSizingReliable() && isBorderBox || + + // Support: IE 10 - 11+, Edge 15 - 18+ + // IE/Edge misreport `getComputedStyle` of table rows with width/height + // set in CSS while `offset*` properties report correct values. + // Interestingly, in some cases IE 9 doesn't suffer from this issue. + !support.reliableTrDimensions() && nodeName( elem, "tr" ) || + + // Fall back to offsetWidth/offsetHeight when value is "auto" + // This happens for inline elements with no explicit setting (gh-3571) + val === "auto" || + + // Support: Android <=4.1 - 4.3 only + // Also use offsetWidth/offsetHeight for misreported inline dimensions (gh-3602) + !parseFloat( val ) && jQuery.css( elem, "display", false, styles ) === "inline" ) && + + // Make sure the element is visible & connected + elem.getClientRects().length ) { + + isBorderBox = jQuery.css( elem, "boxSizing", false, styles ) === "border-box"; + + // Where available, offsetWidth/offsetHeight approximate border box dimensions. + // Where not available (e.g., SVG), assume unreliable box-sizing and interpret the + // retrieved value as a content box dimension. + valueIsBorderBox = offsetProp in elem; + if ( valueIsBorderBox ) { + val = elem[ offsetProp ]; + } + } + + // Normalize "" and auto + val = parseFloat( val ) || 0; + + // Adjust for the element's box model + return ( val + + boxModelAdjustment( + elem, + dimension, + extra || ( isBorderBox ? "border" : "content" ), + valueIsBorderBox, + styles, + + // Provide the current computed size to request scroll gutter calculation (gh-3589) + val + ) + ) + "px"; +} + +jQuery.extend( { + + // Add in style property hooks for overriding the default + // behavior of getting and setting a style property + cssHooks: { + opacity: { + get: function( elem, computed ) { + if ( computed ) { + + // We should always get a number back from opacity + var ret = curCSS( elem, "opacity" ); + return ret === "" ? "1" : ret; + } + } + } + }, + + // Don't automatically add "px" to these possibly-unitless properties + cssNumber: { + "animationIterationCount": true, + "columnCount": true, + "fillOpacity": true, + "flexGrow": true, + "flexShrink": true, + "fontWeight": true, + "gridArea": true, + "gridColumn": true, + "gridColumnEnd": true, + "gridColumnStart": true, + "gridRow": true, + "gridRowEnd": true, + "gridRowStart": true, + "lineHeight": true, + "opacity": true, + "order": true, + "orphans": true, + "widows": true, + "zIndex": true, + "zoom": true + }, + + // Add in properties whose names you wish to fix before + // setting or getting the value + cssProps: {}, + + // Get and set the style property on a DOM Node + style: function( elem, name, value, extra ) { + + // Don't set styles on text and comment nodes + if ( !elem || elem.nodeType === 3 || elem.nodeType === 8 || !elem.style ) { + return; + } + + // Make sure that we're working with the right name + var ret, type, hooks, + origName = camelCase( name ), + isCustomProp = rcustomProp.test( name ), + style = elem.style; + + // Make sure that we're working with the right name. We don't + // want to query the value if it is a CSS custom property + // since they are user-defined. + if ( !isCustomProp ) { + name = finalPropName( origName ); + } + + // Gets hook for the prefixed version, then unprefixed version + hooks = jQuery.cssHooks[ name ] || jQuery.cssHooks[ origName ]; + + // Check if we're setting a value + if ( value !== undefined ) { + type = typeof value; + + // Convert "+=" or "-=" to relative numbers (#7345) + if ( type === "string" && ( ret = rcssNum.exec( value ) ) && ret[ 1 ] ) { + value = adjustCSS( elem, name, ret ); + + // Fixes bug #9237 + type = "number"; + } + + // Make sure that null and NaN values aren't set (#7116) + if ( value == null || value !== value ) { + return; + } + + // If a number was passed in, add the unit (except for certain CSS properties) + // The isCustomProp check can be removed in jQuery 4.0 when we only auto-append + // "px" to a few hardcoded values. + if ( type === "number" && !isCustomProp ) { + value += ret && ret[ 3 ] || ( jQuery.cssNumber[ origName ] ? "" : "px" ); + } + + // background-* props affect original clone's values + if ( !support.clearCloneStyle && value === "" && name.indexOf( "background" ) === 0 ) { + style[ name ] = "inherit"; + } + + // If a hook was provided, use that value, otherwise just set the specified value + if ( !hooks || !( "set" in hooks ) || + ( value = hooks.set( elem, value, extra ) ) !== undefined ) { + + if ( isCustomProp ) { + style.setProperty( name, value ); + } else { + style[ name ] = value; + } + } + + } else { + + // If a hook was provided get the non-computed value from there + if ( hooks && "get" in hooks && + ( ret = hooks.get( elem, false, extra ) ) !== undefined ) { + + return ret; + } + + // Otherwise just get the value from the style object + return style[ name ]; + } + }, + + css: function( elem, name, extra, styles ) { + var val, num, hooks, + origName = camelCase( name ), + isCustomProp = rcustomProp.test( name ); + + // Make sure that we're working with the right name. We don't + // want to modify the value if it is a CSS custom property + // since they are user-defined. + if ( !isCustomProp ) { + name = finalPropName( origName ); + } + + // Try prefixed name followed by the unprefixed name + hooks = jQuery.cssHooks[ name ] || jQuery.cssHooks[ origName ]; + + // If a hook was provided get the computed value from there + if ( hooks && "get" in hooks ) { + val = hooks.get( elem, true, extra ); + } + + // Otherwise, if a way to get the computed value exists, use that + if ( val === undefined ) { + val = curCSS( elem, name, styles ); + } + + // Convert "normal" to computed value + if ( val === "normal" && name in cssNormalTransform ) { + val = cssNormalTransform[ name ]; + } + + // Make numeric if forced or a qualifier was provided and val looks numeric + if ( extra === "" || extra ) { + num = parseFloat( val ); + return extra === true || isFinite( num ) ? num || 0 : val; + } + + return val; + } +} ); + +jQuery.each( [ "height", "width" ], function( _i, dimension ) { + jQuery.cssHooks[ dimension ] = { + get: function( elem, computed, extra ) { + if ( computed ) { + + // Certain elements can have dimension info if we invisibly show them + // but it must have a current display style that would benefit + return rdisplayswap.test( jQuery.css( elem, "display" ) ) && + + // Support: Safari 8+ + // Table columns in Safari have non-zero offsetWidth & zero + // getBoundingClientRect().width unless display is changed. + // Support: IE <=11 only + // Running getBoundingClientRect on a disconnected node + // in IE throws an error. + ( !elem.getClientRects().length || !elem.getBoundingClientRect().width ) ? + swap( elem, cssShow, function() { + return getWidthOrHeight( elem, dimension, extra ); + } ) : + getWidthOrHeight( elem, dimension, extra ); + } + }, + + set: function( elem, value, extra ) { + var matches, + styles = getStyles( elem ), + + // Only read styles.position if the test has a chance to fail + // to avoid forcing a reflow. + scrollboxSizeBuggy = !support.scrollboxSize() && + styles.position === "absolute", + + // To avoid forcing a reflow, only fetch boxSizing if we need it (gh-3991) + boxSizingNeeded = scrollboxSizeBuggy || extra, + isBorderBox = boxSizingNeeded && + jQuery.css( elem, "boxSizing", false, styles ) === "border-box", + subtract = extra ? + boxModelAdjustment( + elem, + dimension, + extra, + isBorderBox, + styles + ) : + 0; + + // Account for unreliable border-box dimensions by comparing offset* to computed and + // faking a content-box to get border and padding (gh-3699) + if ( isBorderBox && scrollboxSizeBuggy ) { + subtract -= Math.ceil( + elem[ "offset" + dimension[ 0 ].toUpperCase() + dimension.slice( 1 ) ] - + parseFloat( styles[ dimension ] ) - + boxModelAdjustment( elem, dimension, "border", false, styles ) - + 0.5 + ); + } + + // Convert to pixels if value adjustment is needed + if ( subtract && ( matches = rcssNum.exec( value ) ) && + ( matches[ 3 ] || "px" ) !== "px" ) { + + elem.style[ dimension ] = value; + value = jQuery.css( elem, dimension ); + } + + return setPositiveNumber( elem, value, subtract ); + } + }; +} ); + +jQuery.cssHooks.marginLeft = addGetHookIf( support.reliableMarginLeft, + function( elem, computed ) { + if ( computed ) { + return ( parseFloat( curCSS( elem, "marginLeft" ) ) || + elem.getBoundingClientRect().left - + swap( elem, { marginLeft: 0 }, function() { + return elem.getBoundingClientRect().left; + } ) + ) + "px"; + } + } +); + +// These hooks are used by animate to expand properties +jQuery.each( { + margin: "", + padding: "", + border: "Width" +}, function( prefix, suffix ) { + jQuery.cssHooks[ prefix + suffix ] = { + expand: function( value ) { + var i = 0, + expanded = {}, + + // Assumes a single number if not a string + parts = typeof value === "string" ? value.split( " " ) : [ value ]; + + for ( ; i < 4; i++ ) { + expanded[ prefix + cssExpand[ i ] + suffix ] = + parts[ i ] || parts[ i - 2 ] || parts[ 0 ]; + } + + return expanded; + } + }; + + if ( prefix !== "margin" ) { + jQuery.cssHooks[ prefix + suffix ].set = setPositiveNumber; + } +} ); + +jQuery.fn.extend( { + css: function( name, value ) { + return access( this, function( elem, name, value ) { + var styles, len, + map = {}, + i = 0; + + if ( Array.isArray( name ) ) { + styles = getStyles( elem ); + len = name.length; + + for ( ; i < len; i++ ) { + map[ name[ i ] ] = jQuery.css( elem, name[ i ], false, styles ); + } + + return map; + } + + return value !== undefined ? + jQuery.style( elem, name, value ) : + jQuery.css( elem, name ); + }, name, value, arguments.length > 1 ); + } +} ); + + +function Tween( elem, options, prop, end, easing ) { + return new Tween.prototype.init( elem, options, prop, end, easing ); +} +jQuery.Tween = Tween; + +Tween.prototype = { + constructor: Tween, + init: function( elem, options, prop, end, easing, unit ) { + this.elem = elem; + this.prop = prop; + this.easing = easing || jQuery.easing._default; + this.options = options; + this.start = this.now = this.cur(); + this.end = end; + this.unit = unit || ( jQuery.cssNumber[ prop ] ? "" : "px" ); + }, + cur: function() { + var hooks = Tween.propHooks[ this.prop ]; + + return hooks && hooks.get ? + hooks.get( this ) : + Tween.propHooks._default.get( this ); + }, + run: function( percent ) { + var eased, + hooks = Tween.propHooks[ this.prop ]; + + if ( this.options.duration ) { + this.pos = eased = jQuery.easing[ this.easing ]( + percent, this.options.duration * percent, 0, 1, this.options.duration + ); + } else { + this.pos = eased = percent; + } + this.now = ( this.end - this.start ) * eased + this.start; + + if ( this.options.step ) { + this.options.step.call( this.elem, this.now, this ); + } + + if ( hooks && hooks.set ) { + hooks.set( this ); + } else { + Tween.propHooks._default.set( this ); + } + return this; + } +}; + +Tween.prototype.init.prototype = Tween.prototype; + +Tween.propHooks = { + _default: { + get: function( tween ) { + var result; + + // Use a property on the element directly when it is not a DOM element, + // or when there is no matching style property that exists. + if ( tween.elem.nodeType !== 1 || + tween.elem[ tween.prop ] != null && tween.elem.style[ tween.prop ] == null ) { + return tween.elem[ tween.prop ]; + } + + // Passing an empty string as a 3rd parameter to .css will automatically + // attempt a parseFloat and fallback to a string if the parse fails. + // Simple values such as "10px" are parsed to Float; + // complex values such as "rotate(1rad)" are returned as-is. + result = jQuery.css( tween.elem, tween.prop, "" ); + + // Empty strings, null, undefined and "auto" are converted to 0. + return !result || result === "auto" ? 0 : result; + }, + set: function( tween ) { + + // Use step hook for back compat. + // Use cssHook if its there. + // Use .style if available and use plain properties where available. + if ( jQuery.fx.step[ tween.prop ] ) { + jQuery.fx.step[ tween.prop ]( tween ); + } else if ( tween.elem.nodeType === 1 && ( + jQuery.cssHooks[ tween.prop ] || + tween.elem.style[ finalPropName( tween.prop ) ] != null ) ) { + jQuery.style( tween.elem, tween.prop, tween.now + tween.unit ); + } else { + tween.elem[ tween.prop ] = tween.now; + } + } + } +}; + +// Support: IE <=9 only +// Panic based approach to setting things on disconnected nodes +Tween.propHooks.scrollTop = Tween.propHooks.scrollLeft = { + set: function( tween ) { + if ( tween.elem.nodeType && tween.elem.parentNode ) { + tween.elem[ tween.prop ] = tween.now; + } + } +}; + +jQuery.easing = { + linear: function( p ) { + return p; + }, + swing: function( p ) { + return 0.5 - Math.cos( p * Math.PI ) / 2; + }, + _default: "swing" +}; + +jQuery.fx = Tween.prototype.init; + +// Back compat <1.8 extension point +jQuery.fx.step = {}; + + + + +var + fxNow, inProgress, + rfxtypes = /^(?:toggle|show|hide)$/, + rrun = /queueHooks$/; + +function schedule() { + if ( inProgress ) { + if ( document.hidden === false && window.requestAnimationFrame ) { + window.requestAnimationFrame( schedule ); + } else { + window.setTimeout( schedule, jQuery.fx.interval ); + } + + jQuery.fx.tick(); + } +} + +// Animations created synchronously will run synchronously +function createFxNow() { + window.setTimeout( function() { + fxNow = undefined; + } ); + return ( fxNow = Date.now() ); +} + +// Generate parameters to create a standard animation +function genFx( type, includeWidth ) { + var which, + i = 0, + attrs = { height: type }; + + // If we include width, step value is 1 to do all cssExpand values, + // otherwise step value is 2 to skip over Left and Right + includeWidth = includeWidth ? 1 : 0; + for ( ; i < 4; i += 2 - includeWidth ) { + which = cssExpand[ i ]; + attrs[ "margin" + which ] = attrs[ "padding" + which ] = type; + } + + if ( includeWidth ) { + attrs.opacity = attrs.width = type; + } + + return attrs; +} + +function createTween( value, prop, animation ) { + var tween, + collection = ( Animation.tweeners[ prop ] || [] ).concat( Animation.tweeners[ "*" ] ), + index = 0, + length = collection.length; + for ( ; index < length; index++ ) { + if ( ( tween = collection[ index ].call( animation, prop, value ) ) ) { + + // We're done with this property + return tween; + } + } +} + +function defaultPrefilter( elem, props, opts ) { + var prop, value, toggle, hooks, oldfire, propTween, restoreDisplay, display, + isBox = "width" in props || "height" in props, + anim = this, + orig = {}, + style = elem.style, + hidden = elem.nodeType && isHiddenWithinTree( elem ), + dataShow = dataPriv.get( elem, "fxshow" ); + + // Queue-skipping animations hijack the fx hooks + if ( !opts.queue ) { + hooks = jQuery._queueHooks( elem, "fx" ); + if ( hooks.unqueued == null ) { + hooks.unqueued = 0; + oldfire = hooks.empty.fire; + hooks.empty.fire = function() { + if ( !hooks.unqueued ) { + oldfire(); + } + }; + } + hooks.unqueued++; + + anim.always( function() { + + // Ensure the complete handler is called before this completes + anim.always( function() { + hooks.unqueued--; + if ( !jQuery.queue( elem, "fx" ).length ) { + hooks.empty.fire(); + } + } ); + } ); + } + + // Detect show/hide animations + for ( prop in props ) { + value = props[ prop ]; + if ( rfxtypes.test( value ) ) { + delete props[ prop ]; + toggle = toggle || value === "toggle"; + if ( value === ( hidden ? "hide" : "show" ) ) { + + // Pretend to be hidden if this is a "show" and + // there is still data from a stopped show/hide + if ( value === "show" && dataShow && dataShow[ prop ] !== undefined ) { + hidden = true; + + // Ignore all other no-op show/hide data + } else { + continue; + } + } + orig[ prop ] = dataShow && dataShow[ prop ] || jQuery.style( elem, prop ); + } + } + + // Bail out if this is a no-op like .hide().hide() + propTween = !jQuery.isEmptyObject( props ); + if ( !propTween && jQuery.isEmptyObject( orig ) ) { + return; + } + + // Restrict "overflow" and "display" styles during box animations + if ( isBox && elem.nodeType === 1 ) { + + // Support: IE <=9 - 11, Edge 12 - 15 + // Record all 3 overflow attributes because IE does not infer the shorthand + // from identically-valued overflowX and overflowY and Edge just mirrors + // the overflowX value there. + opts.overflow = [ style.overflow, style.overflowX, style.overflowY ]; + + // Identify a display type, preferring old show/hide data over the CSS cascade + restoreDisplay = dataShow && dataShow.display; + if ( restoreDisplay == null ) { + restoreDisplay = dataPriv.get( elem, "display" ); + } + display = jQuery.css( elem, "display" ); + if ( display === "none" ) { + if ( restoreDisplay ) { + display = restoreDisplay; + } else { + + // Get nonempty value(s) by temporarily forcing visibility + showHide( [ elem ], true ); + restoreDisplay = elem.style.display || restoreDisplay; + display = jQuery.css( elem, "display" ); + showHide( [ elem ] ); + } + } + + // Animate inline elements as inline-block + if ( display === "inline" || display === "inline-block" && restoreDisplay != null ) { + if ( jQuery.css( elem, "float" ) === "none" ) { + + // Restore the original display value at the end of pure show/hide animations + if ( !propTween ) { + anim.done( function() { + style.display = restoreDisplay; + } ); + if ( restoreDisplay == null ) { + display = style.display; + restoreDisplay = display === "none" ? "" : display; + } + } + style.display = "inline-block"; + } + } + } + + if ( opts.overflow ) { + style.overflow = "hidden"; + anim.always( function() { + style.overflow = opts.overflow[ 0 ]; + style.overflowX = opts.overflow[ 1 ]; + style.overflowY = opts.overflow[ 2 ]; + } ); + } + + // Implement show/hide animations + propTween = false; + for ( prop in orig ) { + + // General show/hide setup for this element animation + if ( !propTween ) { + if ( dataShow ) { + if ( "hidden" in dataShow ) { + hidden = dataShow.hidden; + } + } else { + dataShow = dataPriv.access( elem, "fxshow", { display: restoreDisplay } ); + } + + // Store hidden/visible for toggle so `.stop().toggle()` "reverses" + if ( toggle ) { + dataShow.hidden = !hidden; + } + + // Show elements before animating them + if ( hidden ) { + showHide( [ elem ], true ); + } + + /* eslint-disable no-loop-func */ + + anim.done( function() { + + /* eslint-enable no-loop-func */ + + // The final step of a "hide" animation is actually hiding the element + if ( !hidden ) { + showHide( [ elem ] ); + } + dataPriv.remove( elem, "fxshow" ); + for ( prop in orig ) { + jQuery.style( elem, prop, orig[ prop ] ); + } + } ); + } + + // Per-property setup + propTween = createTween( hidden ? dataShow[ prop ] : 0, prop, anim ); + if ( !( prop in dataShow ) ) { + dataShow[ prop ] = propTween.start; + if ( hidden ) { + propTween.end = propTween.start; + propTween.start = 0; + } + } + } +} + +function propFilter( props, specialEasing ) { + var index, name, easing, value, hooks; + + // camelCase, specialEasing and expand cssHook pass + for ( index in props ) { + name = camelCase( index ); + easing = specialEasing[ name ]; + value = props[ index ]; + if ( Array.isArray( value ) ) { + easing = value[ 1 ]; + value = props[ index ] = value[ 0 ]; + } + + if ( index !== name ) { + props[ name ] = value; + delete props[ index ]; + } + + hooks = jQuery.cssHooks[ name ]; + if ( hooks && "expand" in hooks ) { + value = hooks.expand( value ); + delete props[ name ]; + + // Not quite $.extend, this won't overwrite existing keys. + // Reusing 'index' because we have the correct "name" + for ( index in value ) { + if ( !( index in props ) ) { + props[ index ] = value[ index ]; + specialEasing[ index ] = easing; + } + } + } else { + specialEasing[ name ] = easing; + } + } +} + +function Animation( elem, properties, options ) { + var result, + stopped, + index = 0, + length = Animation.prefilters.length, + deferred = jQuery.Deferred().always( function() { + + // Don't match elem in the :animated selector + delete tick.elem; + } ), + tick = function() { + if ( stopped ) { + return false; + } + var currentTime = fxNow || createFxNow(), + remaining = Math.max( 0, animation.startTime + animation.duration - currentTime ), + + // Support: Android 2.3 only + // Archaic crash bug won't allow us to use `1 - ( 0.5 || 0 )` (#12497) + temp = remaining / animation.duration || 0, + percent = 1 - temp, + index = 0, + length = animation.tweens.length; + + for ( ; index < length; index++ ) { + animation.tweens[ index ].run( percent ); + } + + deferred.notifyWith( elem, [ animation, percent, remaining ] ); + + // If there's more to do, yield + if ( percent < 1 && length ) { + return remaining; + } + + // If this was an empty animation, synthesize a final progress notification + if ( !length ) { + deferred.notifyWith( elem, [ animation, 1, 0 ] ); + } + + // Resolve the animation and report its conclusion + deferred.resolveWith( elem, [ animation ] ); + return false; + }, + animation = deferred.promise( { + elem: elem, + props: jQuery.extend( {}, properties ), + opts: jQuery.extend( true, { + specialEasing: {}, + easing: jQuery.easing._default + }, options ), + originalProperties: properties, + originalOptions: options, + startTime: fxNow || createFxNow(), + duration: options.duration, + tweens: [], + createTween: function( prop, end ) { + var tween = jQuery.Tween( elem, animation.opts, prop, end, + animation.opts.specialEasing[ prop ] || animation.opts.easing ); + animation.tweens.push( tween ); + return tween; + }, + stop: function( gotoEnd ) { + var index = 0, + + // If we are going to the end, we want to run all the tweens + // otherwise we skip this part + length = gotoEnd ? animation.tweens.length : 0; + if ( stopped ) { + return this; + } + stopped = true; + for ( ; index < length; index++ ) { + animation.tweens[ index ].run( 1 ); + } + + // Resolve when we played the last frame; otherwise, reject + if ( gotoEnd ) { + deferred.notifyWith( elem, [ animation, 1, 0 ] ); + deferred.resolveWith( elem, [ animation, gotoEnd ] ); + } else { + deferred.rejectWith( elem, [ animation, gotoEnd ] ); + } + return this; + } + } ), + props = animation.props; + + propFilter( props, animation.opts.specialEasing ); + + for ( ; index < length; index++ ) { + result = Animation.prefilters[ index ].call( animation, elem, props, animation.opts ); + if ( result ) { + if ( isFunction( result.stop ) ) { + jQuery._queueHooks( animation.elem, animation.opts.queue ).stop = + result.stop.bind( result ); + } + return result; + } + } + + jQuery.map( props, createTween, animation ); + + if ( isFunction( animation.opts.start ) ) { + animation.opts.start.call( elem, animation ); + } + + // Attach callbacks from options + animation + .progress( animation.opts.progress ) + .done( animation.opts.done, animation.opts.complete ) + .fail( animation.opts.fail ) + .always( animation.opts.always ); + + jQuery.fx.timer( + jQuery.extend( tick, { + elem: elem, + anim: animation, + queue: animation.opts.queue + } ) + ); + + return animation; +} + +jQuery.Animation = jQuery.extend( Animation, { + + tweeners: { + "*": [ function( prop, value ) { + var tween = this.createTween( prop, value ); + adjustCSS( tween.elem, prop, rcssNum.exec( value ), tween ); + return tween; + } ] + }, + + tweener: function( props, callback ) { + if ( isFunction( props ) ) { + callback = props; + props = [ "*" ]; + } else { + props = props.match( rnothtmlwhite ); + } + + var prop, + index = 0, + length = props.length; + + for ( ; index < length; index++ ) { + prop = props[ index ]; + Animation.tweeners[ prop ] = Animation.tweeners[ prop ] || []; + Animation.tweeners[ prop ].unshift( callback ); + } + }, + + prefilters: [ defaultPrefilter ], + + prefilter: function( callback, prepend ) { + if ( prepend ) { + Animation.prefilters.unshift( callback ); + } else { + Animation.prefilters.push( callback ); + } + } +} ); + +jQuery.speed = function( speed, easing, fn ) { + var opt = speed && typeof speed === "object" ? jQuery.extend( {}, speed ) : { + complete: fn || !fn && easing || + isFunction( speed ) && speed, + duration: speed, + easing: fn && easing || easing && !isFunction( easing ) && easing + }; + + // Go to the end state if fx are off + if ( jQuery.fx.off ) { + opt.duration = 0; + + } else { + if ( typeof opt.duration !== "number" ) { + if ( opt.duration in jQuery.fx.speeds ) { + opt.duration = jQuery.fx.speeds[ opt.duration ]; + + } else { + opt.duration = jQuery.fx.speeds._default; + } + } + } + + // Normalize opt.queue - true/undefined/null -> "fx" + if ( opt.queue == null || opt.queue === true ) { + opt.queue = "fx"; + } + + // Queueing + opt.old = opt.complete; + + opt.complete = function() { + if ( isFunction( opt.old ) ) { + opt.old.call( this ); + } + + if ( opt.queue ) { + jQuery.dequeue( this, opt.queue ); + } + }; + + return opt; +}; + +jQuery.fn.extend( { + fadeTo: function( speed, to, easing, callback ) { + + // Show any hidden elements after setting opacity to 0 + return this.filter( isHiddenWithinTree ).css( "opacity", 0 ).show() + + // Animate to the value specified + .end().animate( { opacity: to }, speed, easing, callback ); + }, + animate: function( prop, speed, easing, callback ) { + var empty = jQuery.isEmptyObject( prop ), + optall = jQuery.speed( speed, easing, callback ), + doAnimation = function() { + + // Operate on a copy of prop so per-property easing won't be lost + var anim = Animation( this, jQuery.extend( {}, prop ), optall ); + + // Empty animations, or finishing resolves immediately + if ( empty || dataPriv.get( this, "finish" ) ) { + anim.stop( true ); + } + }; + + doAnimation.finish = doAnimation; + + return empty || optall.queue === false ? + this.each( doAnimation ) : + this.queue( optall.queue, doAnimation ); + }, + stop: function( type, clearQueue, gotoEnd ) { + var stopQueue = function( hooks ) { + var stop = hooks.stop; + delete hooks.stop; + stop( gotoEnd ); + }; + + if ( typeof type !== "string" ) { + gotoEnd = clearQueue; + clearQueue = type; + type = undefined; + } + if ( clearQueue ) { + this.queue( type || "fx", [] ); + } + + return this.each( function() { + var dequeue = true, + index = type != null && type + "queueHooks", + timers = jQuery.timers, + data = dataPriv.get( this ); + + if ( index ) { + if ( data[ index ] && data[ index ].stop ) { + stopQueue( data[ index ] ); + } + } else { + for ( index in data ) { + if ( data[ index ] && data[ index ].stop && rrun.test( index ) ) { + stopQueue( data[ index ] ); + } + } + } + + for ( index = timers.length; index--; ) { + if ( timers[ index ].elem === this && + ( type == null || timers[ index ].queue === type ) ) { + + timers[ index ].anim.stop( gotoEnd ); + dequeue = false; + timers.splice( index, 1 ); + } + } + + // Start the next in the queue if the last step wasn't forced. + // Timers currently will call their complete callbacks, which + // will dequeue but only if they were gotoEnd. + if ( dequeue || !gotoEnd ) { + jQuery.dequeue( this, type ); + } + } ); + }, + finish: function( type ) { + if ( type !== false ) { + type = type || "fx"; + } + return this.each( function() { + var index, + data = dataPriv.get( this ), + queue = data[ type + "queue" ], + hooks = data[ type + "queueHooks" ], + timers = jQuery.timers, + length = queue ? queue.length : 0; + + // Enable finishing flag on private data + data.finish = true; + + // Empty the queue first + jQuery.queue( this, type, [] ); + + if ( hooks && hooks.stop ) { + hooks.stop.call( this, true ); + } + + // Look for any active animations, and finish them + for ( index = timers.length; index--; ) { + if ( timers[ index ].elem === this && timers[ index ].queue === type ) { + timers[ index ].anim.stop( true ); + timers.splice( index, 1 ); + } + } + + // Look for any animations in the old queue and finish them + for ( index = 0; index < length; index++ ) { + if ( queue[ index ] && queue[ index ].finish ) { + queue[ index ].finish.call( this ); + } + } + + // Turn off finishing flag + delete data.finish; + } ); + } +} ); + +jQuery.each( [ "toggle", "show", "hide" ], function( _i, name ) { + var cssFn = jQuery.fn[ name ]; + jQuery.fn[ name ] = function( speed, easing, callback ) { + return speed == null || typeof speed === "boolean" ? + cssFn.apply( this, arguments ) : + this.animate( genFx( name, true ), speed, easing, callback ); + }; +} ); + +// Generate shortcuts for custom animations +jQuery.each( { + slideDown: genFx( "show" ), + slideUp: genFx( "hide" ), + slideToggle: genFx( "toggle" ), + fadeIn: { opacity: "show" }, + fadeOut: { opacity: "hide" }, + fadeToggle: { opacity: "toggle" } +}, function( name, props ) { + jQuery.fn[ name ] = function( speed, easing, callback ) { + return this.animate( props, speed, easing, callback ); + }; +} ); + +jQuery.timers = []; +jQuery.fx.tick = function() { + var timer, + i = 0, + timers = jQuery.timers; + + fxNow = Date.now(); + + for ( ; i < timers.length; i++ ) { + timer = timers[ i ]; + + // Run the timer and safely remove it when done (allowing for external removal) + if ( !timer() && timers[ i ] === timer ) { + timers.splice( i--, 1 ); + } + } + + if ( !timers.length ) { + jQuery.fx.stop(); + } + fxNow = undefined; +}; + +jQuery.fx.timer = function( timer ) { + jQuery.timers.push( timer ); + jQuery.fx.start(); +}; + +jQuery.fx.interval = 13; +jQuery.fx.start = function() { + if ( inProgress ) { + return; + } + + inProgress = true; + schedule(); +}; + +jQuery.fx.stop = function() { + inProgress = null; +}; + +jQuery.fx.speeds = { + slow: 600, + fast: 200, + + // Default speed + _default: 400 +}; + + +// Based off of the plugin by Clint Helfers, with permission. +// https://web.archive.org/web/20100324014747/http://blindsignals.com/index.php/2009/07/jquery-delay/ +jQuery.fn.delay = function( time, type ) { + time = jQuery.fx ? jQuery.fx.speeds[ time ] || time : time; + type = type || "fx"; + + return this.queue( type, function( next, hooks ) { + var timeout = window.setTimeout( next, time ); + hooks.stop = function() { + window.clearTimeout( timeout ); + }; + } ); +}; + + +( function() { + var input = document.createElement( "input" ), + select = document.createElement( "select" ), + opt = select.appendChild( document.createElement( "option" ) ); + + input.type = "checkbox"; + + // Support: Android <=4.3 only + // Default value for a checkbox should be "on" + support.checkOn = input.value !== ""; + + // Support: IE <=11 only + // Must access selectedIndex to make default options select + support.optSelected = opt.selected; + + // Support: IE <=11 only + // An input loses its value after becoming a radio + input = document.createElement( "input" ); + input.value = "t"; + input.type = "radio"; + support.radioValue = input.value === "t"; +} )(); + + +var boolHook, + attrHandle = jQuery.expr.attrHandle; + +jQuery.fn.extend( { + attr: function( name, value ) { + return access( this, jQuery.attr, name, value, arguments.length > 1 ); + }, + + removeAttr: function( name ) { + return this.each( function() { + jQuery.removeAttr( this, name ); + } ); + } +} ); + +jQuery.extend( { + attr: function( elem, name, value ) { + var ret, hooks, + nType = elem.nodeType; + + // Don't get/set attributes on text, comment and attribute nodes + if ( nType === 3 || nType === 8 || nType === 2 ) { + return; + } + + // Fallback to prop when attributes are not supported + if ( typeof elem.getAttribute === "undefined" ) { + return jQuery.prop( elem, name, value ); + } + + // Attribute hooks are determined by the lowercase version + // Grab necessary hook if one is defined + if ( nType !== 1 || !jQuery.isXMLDoc( elem ) ) { + hooks = jQuery.attrHooks[ name.toLowerCase() ] || + ( jQuery.expr.match.bool.test( name ) ? boolHook : undefined ); + } + + if ( value !== undefined ) { + if ( value === null ) { + jQuery.removeAttr( elem, name ); + return; + } + + if ( hooks && "set" in hooks && + ( ret = hooks.set( elem, value, name ) ) !== undefined ) { + return ret; + } + + elem.setAttribute( name, value + "" ); + return value; + } + + if ( hooks && "get" in hooks && ( ret = hooks.get( elem, name ) ) !== null ) { + return ret; + } + + ret = jQuery.find.attr( elem, name ); + + // Non-existent attributes return null, we normalize to undefined + return ret == null ? undefined : ret; + }, + + attrHooks: { + type: { + set: function( elem, value ) { + if ( !support.radioValue && value === "radio" && + nodeName( elem, "input" ) ) { + var val = elem.value; + elem.setAttribute( "type", value ); + if ( val ) { + elem.value = val; + } + return value; + } + } + } + }, + + removeAttr: function( elem, value ) { + var name, + i = 0, + + // Attribute names can contain non-HTML whitespace characters + // https://html.spec.whatwg.org/multipage/syntax.html#attributes-2 + attrNames = value && value.match( rnothtmlwhite ); + + if ( attrNames && elem.nodeType === 1 ) { + while ( ( name = attrNames[ i++ ] ) ) { + elem.removeAttribute( name ); + } + } + } +} ); + +// Hooks for boolean attributes +boolHook = { + set: function( elem, value, name ) { + if ( value === false ) { + + // Remove boolean attributes when set to false + jQuery.removeAttr( elem, name ); + } else { + elem.setAttribute( name, name ); + } + return name; + } +}; + +jQuery.each( jQuery.expr.match.bool.source.match( /\w+/g ), function( _i, name ) { + var getter = attrHandle[ name ] || jQuery.find.attr; + + attrHandle[ name ] = function( elem, name, isXML ) { + var ret, handle, + lowercaseName = name.toLowerCase(); + + if ( !isXML ) { + + // Avoid an infinite loop by temporarily removing this function from the getter + handle = attrHandle[ lowercaseName ]; + attrHandle[ lowercaseName ] = ret; + ret = getter( elem, name, isXML ) != null ? + lowercaseName : + null; + attrHandle[ lowercaseName ] = handle; + } + return ret; + }; +} ); + + + + +var rfocusable = /^(?:input|select|textarea|button)$/i, + rclickable = /^(?:a|area)$/i; + +jQuery.fn.extend( { + prop: function( name, value ) { + return access( this, jQuery.prop, name, value, arguments.length > 1 ); + }, + + removeProp: function( name ) { + return this.each( function() { + delete this[ jQuery.propFix[ name ] || name ]; + } ); + } +} ); + +jQuery.extend( { + prop: function( elem, name, value ) { + var ret, hooks, + nType = elem.nodeType; + + // Don't get/set properties on text, comment and attribute nodes + if ( nType === 3 || nType === 8 || nType === 2 ) { + return; + } + + if ( nType !== 1 || !jQuery.isXMLDoc( elem ) ) { + + // Fix name and attach hooks + name = jQuery.propFix[ name ] || name; + hooks = jQuery.propHooks[ name ]; + } + + if ( value !== undefined ) { + if ( hooks && "set" in hooks && + ( ret = hooks.set( elem, value, name ) ) !== undefined ) { + return ret; + } + + return ( elem[ name ] = value ); + } + + if ( hooks && "get" in hooks && ( ret = hooks.get( elem, name ) ) !== null ) { + return ret; + } + + return elem[ name ]; + }, + + propHooks: { + tabIndex: { + get: function( elem ) { + + // Support: IE <=9 - 11 only + // elem.tabIndex doesn't always return the + // correct value when it hasn't been explicitly set + // https://web.archive.org/web/20141116233347/http://fluidproject.org/blog/2008/01/09/getting-setting-and-removing-tabindex-values-with-javascript/ + // Use proper attribute retrieval(#12072) + var tabindex = jQuery.find.attr( elem, "tabindex" ); + + if ( tabindex ) { + return parseInt( tabindex, 10 ); + } + + if ( + rfocusable.test( elem.nodeName ) || + rclickable.test( elem.nodeName ) && + elem.href + ) { + return 0; + } + + return -1; + } + } + }, + + propFix: { + "for": "htmlFor", + "class": "className" + } +} ); + +// Support: IE <=11 only +// Accessing the selectedIndex property +// forces the browser to respect setting selected +// on the option +// The getter ensures a default option is selected +// when in an optgroup +// eslint rule "no-unused-expressions" is disabled for this code +// since it considers such accessions noop +if ( !support.optSelected ) { + jQuery.propHooks.selected = { + get: function( elem ) { + + /* eslint no-unused-expressions: "off" */ + + var parent = elem.parentNode; + if ( parent && parent.parentNode ) { + parent.parentNode.selectedIndex; + } + return null; + }, + set: function( elem ) { + + /* eslint no-unused-expressions: "off" */ + + var parent = elem.parentNode; + if ( parent ) { + parent.selectedIndex; + + if ( parent.parentNode ) { + parent.parentNode.selectedIndex; + } + } + } + }; +} + +jQuery.each( [ + "tabIndex", + "readOnly", + "maxLength", + "cellSpacing", + "cellPadding", + "rowSpan", + "colSpan", + "useMap", + "frameBorder", + "contentEditable" +], function() { + jQuery.propFix[ this.toLowerCase() ] = this; +} ); + + + + + // Strip and collapse whitespace according to HTML spec + // https://infra.spec.whatwg.org/#strip-and-collapse-ascii-whitespace + function stripAndCollapse( value ) { + var tokens = value.match( rnothtmlwhite ) || []; + return tokens.join( " " ); + } + + +function getClass( elem ) { + return elem.getAttribute && elem.getAttribute( "class" ) || ""; +} + +function classesToArray( value ) { + if ( Array.isArray( value ) ) { + return value; + } + if ( typeof value === "string" ) { + return value.match( rnothtmlwhite ) || []; + } + return []; +} + +jQuery.fn.extend( { + addClass: function( value ) { + var classes, elem, cur, curValue, clazz, j, finalValue, + i = 0; + + if ( isFunction( value ) ) { + return this.each( function( j ) { + jQuery( this ).addClass( value.call( this, j, getClass( this ) ) ); + } ); + } + + classes = classesToArray( value ); + + if ( classes.length ) { + while ( ( elem = this[ i++ ] ) ) { + curValue = getClass( elem ); + cur = elem.nodeType === 1 && ( " " + stripAndCollapse( curValue ) + " " ); + + if ( cur ) { + j = 0; + while ( ( clazz = classes[ j++ ] ) ) { + if ( cur.indexOf( " " + clazz + " " ) < 0 ) { + cur += clazz + " "; + } + } + + // Only assign if different to avoid unneeded rendering. + finalValue = stripAndCollapse( cur ); + if ( curValue !== finalValue ) { + elem.setAttribute( "class", finalValue ); + } + } + } + } + + return this; + }, + + removeClass: function( value ) { + var classes, elem, cur, curValue, clazz, j, finalValue, + i = 0; + + if ( isFunction( value ) ) { + return this.each( function( j ) { + jQuery( this ).removeClass( value.call( this, j, getClass( this ) ) ); + } ); + } + + if ( !arguments.length ) { + return this.attr( "class", "" ); + } + + classes = classesToArray( value ); + + if ( classes.length ) { + while ( ( elem = this[ i++ ] ) ) { + curValue = getClass( elem ); + + // This expression is here for better compressibility (see addClass) + cur = elem.nodeType === 1 && ( " " + stripAndCollapse( curValue ) + " " ); + + if ( cur ) { + j = 0; + while ( ( clazz = classes[ j++ ] ) ) { + + // Remove *all* instances + while ( cur.indexOf( " " + clazz + " " ) > -1 ) { + cur = cur.replace( " " + clazz + " ", " " ); + } + } + + // Only assign if different to avoid unneeded rendering. + finalValue = stripAndCollapse( cur ); + if ( curValue !== finalValue ) { + elem.setAttribute( "class", finalValue ); + } + } + } + } + + return this; + }, + + toggleClass: function( value, stateVal ) { + var type = typeof value, + isValidValue = type === "string" || Array.isArray( value ); + + if ( typeof stateVal === "boolean" && isValidValue ) { + return stateVal ? this.addClass( value ) : this.removeClass( value ); + } + + if ( isFunction( value ) ) { + return this.each( function( i ) { + jQuery( this ).toggleClass( + value.call( this, i, getClass( this ), stateVal ), + stateVal + ); + } ); + } + + return this.each( function() { + var className, i, self, classNames; + + if ( isValidValue ) { + + // Toggle individual class names + i = 0; + self = jQuery( this ); + classNames = classesToArray( value ); + + while ( ( className = classNames[ i++ ] ) ) { + + // Check each className given, space separated list + if ( self.hasClass( className ) ) { + self.removeClass( className ); + } else { + self.addClass( className ); + } + } + + // Toggle whole class name + } else if ( value === undefined || type === "boolean" ) { + className = getClass( this ); + if ( className ) { + + // Store className if set + dataPriv.set( this, "__className__", className ); + } + + // If the element has a class name or if we're passed `false`, + // then remove the whole classname (if there was one, the above saved it). + // Otherwise bring back whatever was previously saved (if anything), + // falling back to the empty string if nothing was stored. + if ( this.setAttribute ) { + this.setAttribute( "class", + className || value === false ? + "" : + dataPriv.get( this, "__className__" ) || "" + ); + } + } + } ); + }, + + hasClass: function( selector ) { + var className, elem, + i = 0; + + className = " " + selector + " "; + while ( ( elem = this[ i++ ] ) ) { + if ( elem.nodeType === 1 && + ( " " + stripAndCollapse( getClass( elem ) ) + " " ).indexOf( className ) > -1 ) { + return true; + } + } + + return false; + } +} ); + + + + +var rreturn = /\r/g; + +jQuery.fn.extend( { + val: function( value ) { + var hooks, ret, valueIsFunction, + elem = this[ 0 ]; + + if ( !arguments.length ) { + if ( elem ) { + hooks = jQuery.valHooks[ elem.type ] || + jQuery.valHooks[ elem.nodeName.toLowerCase() ]; + + if ( hooks && + "get" in hooks && + ( ret = hooks.get( elem, "value" ) ) !== undefined + ) { + return ret; + } + + ret = elem.value; + + // Handle most common string cases + if ( typeof ret === "string" ) { + return ret.replace( rreturn, "" ); + } + + // Handle cases where value is null/undef or number + return ret == null ? "" : ret; + } + + return; + } + + valueIsFunction = isFunction( value ); + + return this.each( function( i ) { + var val; + + if ( this.nodeType !== 1 ) { + return; + } + + if ( valueIsFunction ) { + val = value.call( this, i, jQuery( this ).val() ); + } else { + val = value; + } + + // Treat null/undefined as ""; convert numbers to string + if ( val == null ) { + val = ""; + + } else if ( typeof val === "number" ) { + val += ""; + + } else if ( Array.isArray( val ) ) { + val = jQuery.map( val, function( value ) { + return value == null ? "" : value + ""; + } ); + } + + hooks = jQuery.valHooks[ this.type ] || jQuery.valHooks[ this.nodeName.toLowerCase() ]; + + // If set returns undefined, fall back to normal setting + if ( !hooks || !( "set" in hooks ) || hooks.set( this, val, "value" ) === undefined ) { + this.value = val; + } + } ); + } +} ); + +jQuery.extend( { + valHooks: { + option: { + get: function( elem ) { + + var val = jQuery.find.attr( elem, "value" ); + return val != null ? + val : + + // Support: IE <=10 - 11 only + // option.text throws exceptions (#14686, #14858) + // Strip and collapse whitespace + // https://html.spec.whatwg.org/#strip-and-collapse-whitespace + stripAndCollapse( jQuery.text( elem ) ); + } + }, + select: { + get: function( elem ) { + var value, option, i, + options = elem.options, + index = elem.selectedIndex, + one = elem.type === "select-one", + values = one ? null : [], + max = one ? index + 1 : options.length; + + if ( index < 0 ) { + i = max; + + } else { + i = one ? index : 0; + } + + // Loop through all the selected options + for ( ; i < max; i++ ) { + option = options[ i ]; + + // Support: IE <=9 only + // IE8-9 doesn't update selected after form reset (#2551) + if ( ( option.selected || i === index ) && + + // Don't return options that are disabled or in a disabled optgroup + !option.disabled && + ( !option.parentNode.disabled || + !nodeName( option.parentNode, "optgroup" ) ) ) { + + // Get the specific value for the option + value = jQuery( option ).val(); + + // We don't need an array for one selects + if ( one ) { + return value; + } + + // Multi-Selects return an array + values.push( value ); + } + } + + return values; + }, + + set: function( elem, value ) { + var optionSet, option, + options = elem.options, + values = jQuery.makeArray( value ), + i = options.length; + + while ( i-- ) { + option = options[ i ]; + + /* eslint-disable no-cond-assign */ + + if ( option.selected = + jQuery.inArray( jQuery.valHooks.option.get( option ), values ) > -1 + ) { + optionSet = true; + } + + /* eslint-enable no-cond-assign */ + } + + // Force browsers to behave consistently when non-matching value is set + if ( !optionSet ) { + elem.selectedIndex = -1; + } + return values; + } + } + } +} ); + +// Radios and checkboxes getter/setter +jQuery.each( [ "radio", "checkbox" ], function() { + jQuery.valHooks[ this ] = { + set: function( elem, value ) { + if ( Array.isArray( value ) ) { + return ( elem.checked = jQuery.inArray( jQuery( elem ).val(), value ) > -1 ); + } + } + }; + if ( !support.checkOn ) { + jQuery.valHooks[ this ].get = function( elem ) { + return elem.getAttribute( "value" ) === null ? "on" : elem.value; + }; + } +} ); + + + + +// Return jQuery for attributes-only inclusion + + +support.focusin = "onfocusin" in window; + + +var rfocusMorph = /^(?:focusinfocus|focusoutblur)$/, + stopPropagationCallback = function( e ) { + e.stopPropagation(); + }; + +jQuery.extend( jQuery.event, { + + trigger: function( event, data, elem, onlyHandlers ) { + + var i, cur, tmp, bubbleType, ontype, handle, special, lastElement, + eventPath = [ elem || document ], + type = hasOwn.call( event, "type" ) ? event.type : event, + namespaces = hasOwn.call( event, "namespace" ) ? event.namespace.split( "." ) : []; + + cur = lastElement = tmp = elem = elem || document; + + // Don't do events on text and comment nodes + if ( elem.nodeType === 3 || elem.nodeType === 8 ) { + return; + } + + // focus/blur morphs to focusin/out; ensure we're not firing them right now + if ( rfocusMorph.test( type + jQuery.event.triggered ) ) { + return; + } + + if ( type.indexOf( "." ) > -1 ) { + + // Namespaced trigger; create a regexp to match event type in handle() + namespaces = type.split( "." ); + type = namespaces.shift(); + namespaces.sort(); + } + ontype = type.indexOf( ":" ) < 0 && "on" + type; + + // Caller can pass in a jQuery.Event object, Object, or just an event type string + event = event[ jQuery.expando ] ? + event : + new jQuery.Event( type, typeof event === "object" && event ); + + // Trigger bitmask: & 1 for native handlers; & 2 for jQuery (always true) + event.isTrigger = onlyHandlers ? 2 : 3; + event.namespace = namespaces.join( "." ); + event.rnamespace = event.namespace ? + new RegExp( "(^|\\.)" + namespaces.join( "\\.(?:.*\\.|)" ) + "(\\.|$)" ) : + null; + + // Clean up the event in case it is being reused + event.result = undefined; + if ( !event.target ) { + event.target = elem; + } + + // Clone any incoming data and prepend the event, creating the handler arg list + data = data == null ? + [ event ] : + jQuery.makeArray( data, [ event ] ); + + // Allow special events to draw outside the lines + special = jQuery.event.special[ type ] || {}; + if ( !onlyHandlers && special.trigger && special.trigger.apply( elem, data ) === false ) { + return; + } + + // Determine event propagation path in advance, per W3C events spec (#9951) + // Bubble up to document, then to window; watch for a global ownerDocument var (#9724) + if ( !onlyHandlers && !special.noBubble && !isWindow( elem ) ) { + + bubbleType = special.delegateType || type; + if ( !rfocusMorph.test( bubbleType + type ) ) { + cur = cur.parentNode; + } + for ( ; cur; cur = cur.parentNode ) { + eventPath.push( cur ); + tmp = cur; + } + + // Only add window if we got to document (e.g., not plain obj or detached DOM) + if ( tmp === ( elem.ownerDocument || document ) ) { + eventPath.push( tmp.defaultView || tmp.parentWindow || window ); + } + } + + // Fire handlers on the event path + i = 0; + while ( ( cur = eventPath[ i++ ] ) && !event.isPropagationStopped() ) { + lastElement = cur; + event.type = i > 1 ? + bubbleType : + special.bindType || type; + + // jQuery handler + handle = ( dataPriv.get( cur, "events" ) || Object.create( null ) )[ event.type ] && + dataPriv.get( cur, "handle" ); + if ( handle ) { + handle.apply( cur, data ); + } + + // Native handler + handle = ontype && cur[ ontype ]; + if ( handle && handle.apply && acceptData( cur ) ) { + event.result = handle.apply( cur, data ); + if ( event.result === false ) { + event.preventDefault(); + } + } + } + event.type = type; + + // If nobody prevented the default action, do it now + if ( !onlyHandlers && !event.isDefaultPrevented() ) { + + if ( ( !special._default || + special._default.apply( eventPath.pop(), data ) === false ) && + acceptData( elem ) ) { + + // Call a native DOM method on the target with the same name as the event. + // Don't do default actions on window, that's where global variables be (#6170) + if ( ontype && isFunction( elem[ type ] ) && !isWindow( elem ) ) { + + // Don't re-trigger an onFOO event when we call its FOO() method + tmp = elem[ ontype ]; + + if ( tmp ) { + elem[ ontype ] = null; + } + + // Prevent re-triggering of the same event, since we already bubbled it above + jQuery.event.triggered = type; + + if ( event.isPropagationStopped() ) { + lastElement.addEventListener( type, stopPropagationCallback ); + } + + elem[ type ](); + + if ( event.isPropagationStopped() ) { + lastElement.removeEventListener( type, stopPropagationCallback ); + } + + jQuery.event.triggered = undefined; + + if ( tmp ) { + elem[ ontype ] = tmp; + } + } + } + } + + return event.result; + }, + + // Piggyback on a donor event to simulate a different one + // Used only for `focus(in | out)` events + simulate: function( type, elem, event ) { + var e = jQuery.extend( + new jQuery.Event(), + event, + { + type: type, + isSimulated: true + } + ); + + jQuery.event.trigger( e, null, elem ); + } + +} ); + +jQuery.fn.extend( { + + trigger: function( type, data ) { + return this.each( function() { + jQuery.event.trigger( type, data, this ); + } ); + }, + triggerHandler: function( type, data ) { + var elem = this[ 0 ]; + if ( elem ) { + return jQuery.event.trigger( type, data, elem, true ); + } + } +} ); + + +// Support: Firefox <=44 +// Firefox doesn't have focus(in | out) events +// Related ticket - https://bugzilla.mozilla.org/show_bug.cgi?id=687787 +// +// Support: Chrome <=48 - 49, Safari <=9.0 - 9.1 +// focus(in | out) events fire after focus & blur events, +// which is spec violation - http://www.w3.org/TR/DOM-Level-3-Events/#events-focusevent-event-order +// Related ticket - https://bugs.chromium.org/p/chromium/issues/detail?id=449857 +if ( !support.focusin ) { + jQuery.each( { focus: "focusin", blur: "focusout" }, function( orig, fix ) { + + // Attach a single capturing handler on the document while someone wants focusin/focusout + var handler = function( event ) { + jQuery.event.simulate( fix, event.target, jQuery.event.fix( event ) ); + }; + + jQuery.event.special[ fix ] = { + setup: function() { + + // Handle: regular nodes (via `this.ownerDocument`), window + // (via `this.document`) & document (via `this`). + var doc = this.ownerDocument || this.document || this, + attaches = dataPriv.access( doc, fix ); + + if ( !attaches ) { + doc.addEventListener( orig, handler, true ); + } + dataPriv.access( doc, fix, ( attaches || 0 ) + 1 ); + }, + teardown: function() { + var doc = this.ownerDocument || this.document || this, + attaches = dataPriv.access( doc, fix ) - 1; + + if ( !attaches ) { + doc.removeEventListener( orig, handler, true ); + dataPriv.remove( doc, fix ); + + } else { + dataPriv.access( doc, fix, attaches ); + } + } + }; + } ); +} +var location = window.location; + +var nonce = { guid: Date.now() }; + +var rquery = ( /\?/ ); + + + +// Cross-browser xml parsing +jQuery.parseXML = function( data ) { + var xml, parserErrorElem; + if ( !data || typeof data !== "string" ) { + return null; + } + + // Support: IE 9 - 11 only + // IE throws on parseFromString with invalid input. + try { + xml = ( new window.DOMParser() ).parseFromString( data, "text/xml" ); + } catch ( e ) {} + + parserErrorElem = xml && xml.getElementsByTagName( "parsererror" )[ 0 ]; + if ( !xml || parserErrorElem ) { + jQuery.error( "Invalid XML: " + ( + parserErrorElem ? + jQuery.map( parserErrorElem.childNodes, function( el ) { + return el.textContent; + } ).join( "\n" ) : + data + ) ); + } + return xml; +}; + + +var + rbracket = /\[\]$/, + rCRLF = /\r?\n/g, + rsubmitterTypes = /^(?:submit|button|image|reset|file)$/i, + rsubmittable = /^(?:input|select|textarea|keygen)/i; + +function buildParams( prefix, obj, traditional, add ) { + var name; + + if ( Array.isArray( obj ) ) { + + // Serialize array item. + jQuery.each( obj, function( i, v ) { + if ( traditional || rbracket.test( prefix ) ) { + + // Treat each array item as a scalar. + add( prefix, v ); + + } else { + + // Item is non-scalar (array or object), encode its numeric index. + buildParams( + prefix + "[" + ( typeof v === "object" && v != null ? i : "" ) + "]", + v, + traditional, + add + ); + } + } ); + + } else if ( !traditional && toType( obj ) === "object" ) { + + // Serialize object item. + for ( name in obj ) { + buildParams( prefix + "[" + name + "]", obj[ name ], traditional, add ); + } + + } else { + + // Serialize scalar item. + add( prefix, obj ); + } +} + +// Serialize an array of form elements or a set of +// key/values into a query string +jQuery.param = function( a, traditional ) { + var prefix, + s = [], + add = function( key, valueOrFunction ) { + + // If value is a function, invoke it and use its return value + var value = isFunction( valueOrFunction ) ? + valueOrFunction() : + valueOrFunction; + + s[ s.length ] = encodeURIComponent( key ) + "=" + + encodeURIComponent( value == null ? "" : value ); + }; + + if ( a == null ) { + return ""; + } + + // If an array was passed in, assume that it is an array of form elements. + if ( Array.isArray( a ) || ( a.jquery && !jQuery.isPlainObject( a ) ) ) { + + // Serialize the form elements + jQuery.each( a, function() { + add( this.name, this.value ); + } ); + + } else { + + // If traditional, encode the "old" way (the way 1.3.2 or older + // did it), otherwise encode params recursively. + for ( prefix in a ) { + buildParams( prefix, a[ prefix ], traditional, add ); + } + } + + // Return the resulting serialization + return s.join( "&" ); +}; + +jQuery.fn.extend( { + serialize: function() { + return jQuery.param( this.serializeArray() ); + }, + serializeArray: function() { + return this.map( function() { + + // Can add propHook for "elements" to filter or add form elements + var elements = jQuery.prop( this, "elements" ); + return elements ? jQuery.makeArray( elements ) : this; + } ).filter( function() { + var type = this.type; + + // Use .is( ":disabled" ) so that fieldset[disabled] works + return this.name && !jQuery( this ).is( ":disabled" ) && + rsubmittable.test( this.nodeName ) && !rsubmitterTypes.test( type ) && + ( this.checked || !rcheckableType.test( type ) ); + } ).map( function( _i, elem ) { + var val = jQuery( this ).val(); + + if ( val == null ) { + return null; + } + + if ( Array.isArray( val ) ) { + return jQuery.map( val, function( val ) { + return { name: elem.name, value: val.replace( rCRLF, "\r\n" ) }; + } ); + } + + return { name: elem.name, value: val.replace( rCRLF, "\r\n" ) }; + } ).get(); + } +} ); + + +var + r20 = /%20/g, + rhash = /#.*$/, + rantiCache = /([?&])_=[^&]*/, + rheaders = /^(.*?):[ \t]*([^\r\n]*)$/mg, + + // #7653, #8125, #8152: local protocol detection + rlocalProtocol = /^(?:about|app|app-storage|.+-extension|file|res|widget):$/, + rnoContent = /^(?:GET|HEAD)$/, + rprotocol = /^\/\//, + + /* Prefilters + * 1) They are useful to introduce custom dataTypes (see ajax/jsonp.js for an example) + * 2) These are called: + * - BEFORE asking for a transport + * - AFTER param serialization (s.data is a string if s.processData is true) + * 3) key is the dataType + * 4) the catchall symbol "*" can be used + * 5) execution will start with transport dataType and THEN continue down to "*" if needed + */ + prefilters = {}, + + /* Transports bindings + * 1) key is the dataType + * 2) the catchall symbol "*" can be used + * 3) selection will start with transport dataType and THEN go to "*" if needed + */ + transports = {}, + + // Avoid comment-prolog char sequence (#10098); must appease lint and evade compression + allTypes = "*/".concat( "*" ), + + // Anchor tag for parsing the document origin + originAnchor = document.createElement( "a" ); + +originAnchor.href = location.href; + +// Base "constructor" for jQuery.ajaxPrefilter and jQuery.ajaxTransport +function addToPrefiltersOrTransports( structure ) { + + // dataTypeExpression is optional and defaults to "*" + return function( dataTypeExpression, func ) { + + if ( typeof dataTypeExpression !== "string" ) { + func = dataTypeExpression; + dataTypeExpression = "*"; + } + + var dataType, + i = 0, + dataTypes = dataTypeExpression.toLowerCase().match( rnothtmlwhite ) || []; + + if ( isFunction( func ) ) { + + // For each dataType in the dataTypeExpression + while ( ( dataType = dataTypes[ i++ ] ) ) { + + // Prepend if requested + if ( dataType[ 0 ] === "+" ) { + dataType = dataType.slice( 1 ) || "*"; + ( structure[ dataType ] = structure[ dataType ] || [] ).unshift( func ); + + // Otherwise append + } else { + ( structure[ dataType ] = structure[ dataType ] || [] ).push( func ); + } + } + } + }; +} + +// Base inspection function for prefilters and transports +function inspectPrefiltersOrTransports( structure, options, originalOptions, jqXHR ) { + + var inspected = {}, + seekingTransport = ( structure === transports ); + + function inspect( dataType ) { + var selected; + inspected[ dataType ] = true; + jQuery.each( structure[ dataType ] || [], function( _, prefilterOrFactory ) { + var dataTypeOrTransport = prefilterOrFactory( options, originalOptions, jqXHR ); + if ( typeof dataTypeOrTransport === "string" && + !seekingTransport && !inspected[ dataTypeOrTransport ] ) { + + options.dataTypes.unshift( dataTypeOrTransport ); + inspect( dataTypeOrTransport ); + return false; + } else if ( seekingTransport ) { + return !( selected = dataTypeOrTransport ); + } + } ); + return selected; + } + + return inspect( options.dataTypes[ 0 ] ) || !inspected[ "*" ] && inspect( "*" ); +} + +// A special extend for ajax options +// that takes "flat" options (not to be deep extended) +// Fixes #9887 +function ajaxExtend( target, src ) { + var key, deep, + flatOptions = jQuery.ajaxSettings.flatOptions || {}; + + for ( key in src ) { + if ( src[ key ] !== undefined ) { + ( flatOptions[ key ] ? target : ( deep || ( deep = {} ) ) )[ key ] = src[ key ]; + } + } + if ( deep ) { + jQuery.extend( true, target, deep ); + } + + return target; +} + +/* Handles responses to an ajax request: + * - finds the right dataType (mediates between content-type and expected dataType) + * - returns the corresponding response + */ +function ajaxHandleResponses( s, jqXHR, responses ) { + + var ct, type, finalDataType, firstDataType, + contents = s.contents, + dataTypes = s.dataTypes; + + // Remove auto dataType and get content-type in the process + while ( dataTypes[ 0 ] === "*" ) { + dataTypes.shift(); + if ( ct === undefined ) { + ct = s.mimeType || jqXHR.getResponseHeader( "Content-Type" ); + } + } + + // Check if we're dealing with a known content-type + if ( ct ) { + for ( type in contents ) { + if ( contents[ type ] && contents[ type ].test( ct ) ) { + dataTypes.unshift( type ); + break; + } + } + } + + // Check to see if we have a response for the expected dataType + if ( dataTypes[ 0 ] in responses ) { + finalDataType = dataTypes[ 0 ]; + } else { + + // Try convertible dataTypes + for ( type in responses ) { + if ( !dataTypes[ 0 ] || s.converters[ type + " " + dataTypes[ 0 ] ] ) { + finalDataType = type; + break; + } + if ( !firstDataType ) { + firstDataType = type; + } + } + + // Or just use first one + finalDataType = finalDataType || firstDataType; + } + + // If we found a dataType + // We add the dataType to the list if needed + // and return the corresponding response + if ( finalDataType ) { + if ( finalDataType !== dataTypes[ 0 ] ) { + dataTypes.unshift( finalDataType ); + } + return responses[ finalDataType ]; + } +} + +/* Chain conversions given the request and the original response + * Also sets the responseXXX fields on the jqXHR instance + */ +function ajaxConvert( s, response, jqXHR, isSuccess ) { + var conv2, current, conv, tmp, prev, + converters = {}, + + // Work with a copy of dataTypes in case we need to modify it for conversion + dataTypes = s.dataTypes.slice(); + + // Create converters map with lowercased keys + if ( dataTypes[ 1 ] ) { + for ( conv in s.converters ) { + converters[ conv.toLowerCase() ] = s.converters[ conv ]; + } + } + + current = dataTypes.shift(); + + // Convert to each sequential dataType + while ( current ) { + + if ( s.responseFields[ current ] ) { + jqXHR[ s.responseFields[ current ] ] = response; + } + + // Apply the dataFilter if provided + if ( !prev && isSuccess && s.dataFilter ) { + response = s.dataFilter( response, s.dataType ); + } + + prev = current; + current = dataTypes.shift(); + + if ( current ) { + + // There's only work to do if current dataType is non-auto + if ( current === "*" ) { + + current = prev; + + // Convert response if prev dataType is non-auto and differs from current + } else if ( prev !== "*" && prev !== current ) { + + // Seek a direct converter + conv = converters[ prev + " " + current ] || converters[ "* " + current ]; + + // If none found, seek a pair + if ( !conv ) { + for ( conv2 in converters ) { + + // If conv2 outputs current + tmp = conv2.split( " " ); + if ( tmp[ 1 ] === current ) { + + // If prev can be converted to accepted input + conv = converters[ prev + " " + tmp[ 0 ] ] || + converters[ "* " + tmp[ 0 ] ]; + if ( conv ) { + + // Condense equivalence converters + if ( conv === true ) { + conv = converters[ conv2 ]; + + // Otherwise, insert the intermediate dataType + } else if ( converters[ conv2 ] !== true ) { + current = tmp[ 0 ]; + dataTypes.unshift( tmp[ 1 ] ); + } + break; + } + } + } + } + + // Apply converter (if not an equivalence) + if ( conv !== true ) { + + // Unless errors are allowed to bubble, catch and return them + if ( conv && s.throws ) { + response = conv( response ); + } else { + try { + response = conv( response ); + } catch ( e ) { + return { + state: "parsererror", + error: conv ? e : "No conversion from " + prev + " to " + current + }; + } + } + } + } + } + } + + return { state: "success", data: response }; +} + +jQuery.extend( { + + // Counter for holding the number of active queries + active: 0, + + // Last-Modified header cache for next request + lastModified: {}, + etag: {}, + + ajaxSettings: { + url: location.href, + type: "GET", + isLocal: rlocalProtocol.test( location.protocol ), + global: true, + processData: true, + async: true, + contentType: "application/x-www-form-urlencoded; charset=UTF-8", + + /* + timeout: 0, + data: null, + dataType: null, + username: null, + password: null, + cache: null, + throws: false, + traditional: false, + headers: {}, + */ + + accepts: { + "*": allTypes, + text: "text/plain", + html: "text/html", + xml: "application/xml, text/xml", + json: "application/json, text/javascript" + }, + + contents: { + xml: /\bxml\b/, + html: /\bhtml/, + json: /\bjson\b/ + }, + + responseFields: { + xml: "responseXML", + text: "responseText", + json: "responseJSON" + }, + + // Data converters + // Keys separate source (or catchall "*") and destination types with a single space + converters: { + + // Convert anything to text + "* text": String, + + // Text to html (true = no transformation) + "text html": true, + + // Evaluate text as a json expression + "text json": JSON.parse, + + // Parse text as xml + "text xml": jQuery.parseXML + }, + + // For options that shouldn't be deep extended: + // you can add your own custom options here if + // and when you create one that shouldn't be + // deep extended (see ajaxExtend) + flatOptions: { + url: true, + context: true + } + }, + + // Creates a full fledged settings object into target + // with both ajaxSettings and settings fields. + // If target is omitted, writes into ajaxSettings. + ajaxSetup: function( target, settings ) { + return settings ? + + // Building a settings object + ajaxExtend( ajaxExtend( target, jQuery.ajaxSettings ), settings ) : + + // Extending ajaxSettings + ajaxExtend( jQuery.ajaxSettings, target ); + }, + + ajaxPrefilter: addToPrefiltersOrTransports( prefilters ), + ajaxTransport: addToPrefiltersOrTransports( transports ), + + // Main method + ajax: function( url, options ) { + + // If url is an object, simulate pre-1.5 signature + if ( typeof url === "object" ) { + options = url; + url = undefined; + } + + // Force options to be an object + options = options || {}; + + var transport, + + // URL without anti-cache param + cacheURL, + + // Response headers + responseHeadersString, + responseHeaders, + + // timeout handle + timeoutTimer, + + // Url cleanup var + urlAnchor, + + // Request state (becomes false upon send and true upon completion) + completed, + + // To know if global events are to be dispatched + fireGlobals, + + // Loop variable + i, + + // uncached part of the url + uncached, + + // Create the final options object + s = jQuery.ajaxSetup( {}, options ), + + // Callbacks context + callbackContext = s.context || s, + + // Context for global events is callbackContext if it is a DOM node or jQuery collection + globalEventContext = s.context && + ( callbackContext.nodeType || callbackContext.jquery ) ? + jQuery( callbackContext ) : + jQuery.event, + + // Deferreds + deferred = jQuery.Deferred(), + completeDeferred = jQuery.Callbacks( "once memory" ), + + // Status-dependent callbacks + statusCode = s.statusCode || {}, + + // Headers (they are sent all at once) + requestHeaders = {}, + requestHeadersNames = {}, + + // Default abort message + strAbort = "canceled", + + // Fake xhr + jqXHR = { + readyState: 0, + + // Builds headers hashtable if needed + getResponseHeader: function( key ) { + var match; + if ( completed ) { + if ( !responseHeaders ) { + responseHeaders = {}; + while ( ( match = rheaders.exec( responseHeadersString ) ) ) { + responseHeaders[ match[ 1 ].toLowerCase() + " " ] = + ( responseHeaders[ match[ 1 ].toLowerCase() + " " ] || [] ) + .concat( match[ 2 ] ); + } + } + match = responseHeaders[ key.toLowerCase() + " " ]; + } + return match == null ? null : match.join( ", " ); + }, + + // Raw string + getAllResponseHeaders: function() { + return completed ? responseHeadersString : null; + }, + + // Caches the header + setRequestHeader: function( name, value ) { + if ( completed == null ) { + name = requestHeadersNames[ name.toLowerCase() ] = + requestHeadersNames[ name.toLowerCase() ] || name; + requestHeaders[ name ] = value; + } + return this; + }, + + // Overrides response content-type header + overrideMimeType: function( type ) { + if ( completed == null ) { + s.mimeType = type; + } + return this; + }, + + // Status-dependent callbacks + statusCode: function( map ) { + var code; + if ( map ) { + if ( completed ) { + + // Execute the appropriate callbacks + jqXHR.always( map[ jqXHR.status ] ); + } else { + + // Lazy-add the new callbacks in a way that preserves old ones + for ( code in map ) { + statusCode[ code ] = [ statusCode[ code ], map[ code ] ]; + } + } + } + return this; + }, + + // Cancel the request + abort: function( statusText ) { + var finalText = statusText || strAbort; + if ( transport ) { + transport.abort( finalText ); + } + done( 0, finalText ); + return this; + } + }; + + // Attach deferreds + deferred.promise( jqXHR ); + + // Add protocol if not provided (prefilters might expect it) + // Handle falsy url in the settings object (#10093: consistency with old signature) + // We also use the url parameter if available + s.url = ( ( url || s.url || location.href ) + "" ) + .replace( rprotocol, location.protocol + "//" ); + + // Alias method option to type as per ticket #12004 + s.type = options.method || options.type || s.method || s.type; + + // Extract dataTypes list + s.dataTypes = ( s.dataType || "*" ).toLowerCase().match( rnothtmlwhite ) || [ "" ]; + + // A cross-domain request is in order when the origin doesn't match the current origin. + if ( s.crossDomain == null ) { + urlAnchor = document.createElement( "a" ); + + // Support: IE <=8 - 11, Edge 12 - 15 + // IE throws exception on accessing the href property if url is malformed, + // e.g. http://example.com:80x/ + try { + urlAnchor.href = s.url; + + // Support: IE <=8 - 11 only + // Anchor's host property isn't correctly set when s.url is relative + urlAnchor.href = urlAnchor.href; + s.crossDomain = originAnchor.protocol + "//" + originAnchor.host !== + urlAnchor.protocol + "//" + urlAnchor.host; + } catch ( e ) { + + // If there is an error parsing the URL, assume it is crossDomain, + // it can be rejected by the transport if it is invalid + s.crossDomain = true; + } + } + + // Convert data if not already a string + if ( s.data && s.processData && typeof s.data !== "string" ) { + s.data = jQuery.param( s.data, s.traditional ); + } + + // Apply prefilters + inspectPrefiltersOrTransports( prefilters, s, options, jqXHR ); + + // If request was aborted inside a prefilter, stop there + if ( completed ) { + return jqXHR; + } + + // We can fire global events as of now if asked to + // Don't fire events if jQuery.event is undefined in an AMD-usage scenario (#15118) + fireGlobals = jQuery.event && s.global; + + // Watch for a new set of requests + if ( fireGlobals && jQuery.active++ === 0 ) { + jQuery.event.trigger( "ajaxStart" ); + } + + // Uppercase the type + s.type = s.type.toUpperCase(); + + // Determine if request has content + s.hasContent = !rnoContent.test( s.type ); + + // Save the URL in case we're toying with the If-Modified-Since + // and/or If-None-Match header later on + // Remove hash to simplify url manipulation + cacheURL = s.url.replace( rhash, "" ); + + // More options handling for requests with no content + if ( !s.hasContent ) { + + // Remember the hash so we can put it back + uncached = s.url.slice( cacheURL.length ); + + // If data is available and should be processed, append data to url + if ( s.data && ( s.processData || typeof s.data === "string" ) ) { + cacheURL += ( rquery.test( cacheURL ) ? "&" : "?" ) + s.data; + + // #9682: remove data so that it's not used in an eventual retry + delete s.data; + } + + // Add or update anti-cache param if needed + if ( s.cache === false ) { + cacheURL = cacheURL.replace( rantiCache, "$1" ); + uncached = ( rquery.test( cacheURL ) ? "&" : "?" ) + "_=" + ( nonce.guid++ ) + + uncached; + } + + // Put hash and anti-cache on the URL that will be requested (gh-1732) + s.url = cacheURL + uncached; + + // Change '%20' to '+' if this is encoded form body content (gh-2658) + } else if ( s.data && s.processData && + ( s.contentType || "" ).indexOf( "application/x-www-form-urlencoded" ) === 0 ) { + s.data = s.data.replace( r20, "+" ); + } + + // Set the If-Modified-Since and/or If-None-Match header, if in ifModified mode. + if ( s.ifModified ) { + if ( jQuery.lastModified[ cacheURL ] ) { + jqXHR.setRequestHeader( "If-Modified-Since", jQuery.lastModified[ cacheURL ] ); + } + if ( jQuery.etag[ cacheURL ] ) { + jqXHR.setRequestHeader( "If-None-Match", jQuery.etag[ cacheURL ] ); + } + } + + // Set the correct header, if data is being sent + if ( s.data && s.hasContent && s.contentType !== false || options.contentType ) { + jqXHR.setRequestHeader( "Content-Type", s.contentType ); + } + + // Set the Accepts header for the server, depending on the dataType + jqXHR.setRequestHeader( + "Accept", + s.dataTypes[ 0 ] && s.accepts[ s.dataTypes[ 0 ] ] ? + s.accepts[ s.dataTypes[ 0 ] ] + + ( s.dataTypes[ 0 ] !== "*" ? ", " + allTypes + "; q=0.01" : "" ) : + s.accepts[ "*" ] + ); + + // Check for headers option + for ( i in s.headers ) { + jqXHR.setRequestHeader( i, s.headers[ i ] ); + } + + // Allow custom headers/mimetypes and early abort + if ( s.beforeSend && + ( s.beforeSend.call( callbackContext, jqXHR, s ) === false || completed ) ) { + + // Abort if not done already and return + return jqXHR.abort(); + } + + // Aborting is no longer a cancellation + strAbort = "abort"; + + // Install callbacks on deferreds + completeDeferred.add( s.complete ); + jqXHR.done( s.success ); + jqXHR.fail( s.error ); + + // Get transport + transport = inspectPrefiltersOrTransports( transports, s, options, jqXHR ); + + // If no transport, we auto-abort + if ( !transport ) { + done( -1, "No Transport" ); + } else { + jqXHR.readyState = 1; + + // Send global event + if ( fireGlobals ) { + globalEventContext.trigger( "ajaxSend", [ jqXHR, s ] ); + } + + // If request was aborted inside ajaxSend, stop there + if ( completed ) { + return jqXHR; + } + + // Timeout + if ( s.async && s.timeout > 0 ) { + timeoutTimer = window.setTimeout( function() { + jqXHR.abort( "timeout" ); + }, s.timeout ); + } + + try { + completed = false; + transport.send( requestHeaders, done ); + } catch ( e ) { + + // Rethrow post-completion exceptions + if ( completed ) { + throw e; + } + + // Propagate others as results + done( -1, e ); + } + } + + // Callback for when everything is done + function done( status, nativeStatusText, responses, headers ) { + var isSuccess, success, error, response, modified, + statusText = nativeStatusText; + + // Ignore repeat invocations + if ( completed ) { + return; + } + + completed = true; + + // Clear timeout if it exists + if ( timeoutTimer ) { + window.clearTimeout( timeoutTimer ); + } + + // Dereference transport for early garbage collection + // (no matter how long the jqXHR object will be used) + transport = undefined; + + // Cache response headers + responseHeadersString = headers || ""; + + // Set readyState + jqXHR.readyState = status > 0 ? 4 : 0; + + // Determine if successful + isSuccess = status >= 200 && status < 300 || status === 304; + + // Get response data + if ( responses ) { + response = ajaxHandleResponses( s, jqXHR, responses ); + } + + // Use a noop converter for missing script but not if jsonp + if ( !isSuccess && + jQuery.inArray( "script", s.dataTypes ) > -1 && + jQuery.inArray( "json", s.dataTypes ) < 0 ) { + s.converters[ "text script" ] = function() {}; + } + + // Convert no matter what (that way responseXXX fields are always set) + response = ajaxConvert( s, response, jqXHR, isSuccess ); + + // If successful, handle type chaining + if ( isSuccess ) { + + // Set the If-Modified-Since and/or If-None-Match header, if in ifModified mode. + if ( s.ifModified ) { + modified = jqXHR.getResponseHeader( "Last-Modified" ); + if ( modified ) { + jQuery.lastModified[ cacheURL ] = modified; + } + modified = jqXHR.getResponseHeader( "etag" ); + if ( modified ) { + jQuery.etag[ cacheURL ] = modified; + } + } + + // if no content + if ( status === 204 || s.type === "HEAD" ) { + statusText = "nocontent"; + + // if not modified + } else if ( status === 304 ) { + statusText = "notmodified"; + + // If we have data, let's convert it + } else { + statusText = response.state; + success = response.data; + error = response.error; + isSuccess = !error; + } + } else { + + // Extract error from statusText and normalize for non-aborts + error = statusText; + if ( status || !statusText ) { + statusText = "error"; + if ( status < 0 ) { + status = 0; + } + } + } + + // Set data for the fake xhr object + jqXHR.status = status; + jqXHR.statusText = ( nativeStatusText || statusText ) + ""; + + // Success/Error + if ( isSuccess ) { + deferred.resolveWith( callbackContext, [ success, statusText, jqXHR ] ); + } else { + deferred.rejectWith( callbackContext, [ jqXHR, statusText, error ] ); + } + + // Status-dependent callbacks + jqXHR.statusCode( statusCode ); + statusCode = undefined; + + if ( fireGlobals ) { + globalEventContext.trigger( isSuccess ? "ajaxSuccess" : "ajaxError", + [ jqXHR, s, isSuccess ? success : error ] ); + } + + // Complete + completeDeferred.fireWith( callbackContext, [ jqXHR, statusText ] ); + + if ( fireGlobals ) { + globalEventContext.trigger( "ajaxComplete", [ jqXHR, s ] ); + + // Handle the global AJAX counter + if ( !( --jQuery.active ) ) { + jQuery.event.trigger( "ajaxStop" ); + } + } + } + + return jqXHR; + }, + + getJSON: function( url, data, callback ) { + return jQuery.get( url, data, callback, "json" ); + }, + + getScript: function( url, callback ) { + return jQuery.get( url, undefined, callback, "script" ); + } +} ); + +jQuery.each( [ "get", "post" ], function( _i, method ) { + jQuery[ method ] = function( url, data, callback, type ) { + + // Shift arguments if data argument was omitted + if ( isFunction( data ) ) { + type = type || callback; + callback = data; + data = undefined; + } + + // The url can be an options object (which then must have .url) + return jQuery.ajax( jQuery.extend( { + url: url, + type: method, + dataType: type, + data: data, + success: callback + }, jQuery.isPlainObject( url ) && url ) ); + }; +} ); + +jQuery.ajaxPrefilter( function( s ) { + var i; + for ( i in s.headers ) { + if ( i.toLowerCase() === "content-type" ) { + s.contentType = s.headers[ i ] || ""; + } + } +} ); + + +jQuery._evalUrl = function( url, options, doc ) { + return jQuery.ajax( { + url: url, + + // Make this explicit, since user can override this through ajaxSetup (#11264) + type: "GET", + dataType: "script", + cache: true, + async: false, + global: false, + + // Only evaluate the response if it is successful (gh-4126) + // dataFilter is not invoked for failure responses, so using it instead + // of the default converter is kludgy but it works. + converters: { + "text script": function() {} + }, + dataFilter: function( response ) { + jQuery.globalEval( response, options, doc ); + } + } ); +}; + + +jQuery.fn.extend( { + wrapAll: function( html ) { + var wrap; + + if ( this[ 0 ] ) { + if ( isFunction( html ) ) { + html = html.call( this[ 0 ] ); + } + + // The elements to wrap the target around + wrap = jQuery( html, this[ 0 ].ownerDocument ).eq( 0 ).clone( true ); + + if ( this[ 0 ].parentNode ) { + wrap.insertBefore( this[ 0 ] ); + } + + wrap.map( function() { + var elem = this; + + while ( elem.firstElementChild ) { + elem = elem.firstElementChild; + } + + return elem; + } ).append( this ); + } + + return this; + }, + + wrapInner: function( html ) { + if ( isFunction( html ) ) { + return this.each( function( i ) { + jQuery( this ).wrapInner( html.call( this, i ) ); + } ); + } + + return this.each( function() { + var self = jQuery( this ), + contents = self.contents(); + + if ( contents.length ) { + contents.wrapAll( html ); + + } else { + self.append( html ); + } + } ); + }, + + wrap: function( html ) { + var htmlIsFunction = isFunction( html ); + + return this.each( function( i ) { + jQuery( this ).wrapAll( htmlIsFunction ? html.call( this, i ) : html ); + } ); + }, + + unwrap: function( selector ) { + this.parent( selector ).not( "body" ).each( function() { + jQuery( this ).replaceWith( this.childNodes ); + } ); + return this; + } +} ); + + +jQuery.expr.pseudos.hidden = function( elem ) { + return !jQuery.expr.pseudos.visible( elem ); +}; +jQuery.expr.pseudos.visible = function( elem ) { + return !!( elem.offsetWidth || elem.offsetHeight || elem.getClientRects().length ); +}; + + + + +jQuery.ajaxSettings.xhr = function() { + try { + return new window.XMLHttpRequest(); + } catch ( e ) {} +}; + +var xhrSuccessStatus = { + + // File protocol always yields status code 0, assume 200 + 0: 200, + + // Support: IE <=9 only + // #1450: sometimes IE returns 1223 when it should be 204 + 1223: 204 + }, + xhrSupported = jQuery.ajaxSettings.xhr(); + +support.cors = !!xhrSupported && ( "withCredentials" in xhrSupported ); +support.ajax = xhrSupported = !!xhrSupported; + +jQuery.ajaxTransport( function( options ) { + var callback, errorCallback; + + // Cross domain only allowed if supported through XMLHttpRequest + if ( support.cors || xhrSupported && !options.crossDomain ) { + return { + send: function( headers, complete ) { + var i, + xhr = options.xhr(); + + xhr.open( + options.type, + options.url, + options.async, + options.username, + options.password + ); + + // Apply custom fields if provided + if ( options.xhrFields ) { + for ( i in options.xhrFields ) { + xhr[ i ] = options.xhrFields[ i ]; + } + } + + // Override mime type if needed + if ( options.mimeType && xhr.overrideMimeType ) { + xhr.overrideMimeType( options.mimeType ); + } + + // X-Requested-With header + // For cross-domain requests, seeing as conditions for a preflight are + // akin to a jigsaw puzzle, we simply never set it to be sure. + // (it can always be set on a per-request basis or even using ajaxSetup) + // For same-domain requests, won't change header if already provided. + if ( !options.crossDomain && !headers[ "X-Requested-With" ] ) { + headers[ "X-Requested-With" ] = "XMLHttpRequest"; + } + + // Set headers + for ( i in headers ) { + xhr.setRequestHeader( i, headers[ i ] ); + } + + // Callback + callback = function( type ) { + return function() { + if ( callback ) { + callback = errorCallback = xhr.onload = + xhr.onerror = xhr.onabort = xhr.ontimeout = + xhr.onreadystatechange = null; + + if ( type === "abort" ) { + xhr.abort(); + } else if ( type === "error" ) { + + // Support: IE <=9 only + // On a manual native abort, IE9 throws + // errors on any property access that is not readyState + if ( typeof xhr.status !== "number" ) { + complete( 0, "error" ); + } else { + complete( + + // File: protocol always yields status 0; see #8605, #14207 + xhr.status, + xhr.statusText + ); + } + } else { + complete( + xhrSuccessStatus[ xhr.status ] || xhr.status, + xhr.statusText, + + // Support: IE <=9 only + // IE9 has no XHR2 but throws on binary (trac-11426) + // For XHR2 non-text, let the caller handle it (gh-2498) + ( xhr.responseType || "text" ) !== "text" || + typeof xhr.responseText !== "string" ? + { binary: xhr.response } : + { text: xhr.responseText }, + xhr.getAllResponseHeaders() + ); + } + } + }; + }; + + // Listen to events + xhr.onload = callback(); + errorCallback = xhr.onerror = xhr.ontimeout = callback( "error" ); + + // Support: IE 9 only + // Use onreadystatechange to replace onabort + // to handle uncaught aborts + if ( xhr.onabort !== undefined ) { + xhr.onabort = errorCallback; + } else { + xhr.onreadystatechange = function() { + + // Check readyState before timeout as it changes + if ( xhr.readyState === 4 ) { + + // Allow onerror to be called first, + // but that will not handle a native abort + // Also, save errorCallback to a variable + // as xhr.onerror cannot be accessed + window.setTimeout( function() { + if ( callback ) { + errorCallback(); + } + } ); + } + }; + } + + // Create the abort callback + callback = callback( "abort" ); + + try { + + // Do send the request (this may raise an exception) + xhr.send( options.hasContent && options.data || null ); + } catch ( e ) { + + // #14683: Only rethrow if this hasn't been notified as an error yet + if ( callback ) { + throw e; + } + } + }, + + abort: function() { + if ( callback ) { + callback(); + } + } + }; + } +} ); + + + + +// Prevent auto-execution of scripts when no explicit dataType was provided (See gh-2432) +jQuery.ajaxPrefilter( function( s ) { + if ( s.crossDomain ) { + s.contents.script = false; + } +} ); + +// Install script dataType +jQuery.ajaxSetup( { + accepts: { + script: "text/javascript, application/javascript, " + + "application/ecmascript, application/x-ecmascript" + }, + contents: { + script: /\b(?:java|ecma)script\b/ + }, + converters: { + "text script": function( text ) { + jQuery.globalEval( text ); + return text; + } + } +} ); + +// Handle cache's special case and crossDomain +jQuery.ajaxPrefilter( "script", function( s ) { + if ( s.cache === undefined ) { + s.cache = false; + } + if ( s.crossDomain ) { + s.type = "GET"; + } +} ); + +// Bind script tag hack transport +jQuery.ajaxTransport( "script", function( s ) { + + // This transport only deals with cross domain or forced-by-attrs requests + if ( s.crossDomain || s.scriptAttrs ) { + var script, callback; + return { + send: function( _, complete ) { + script = jQuery( " + + + + + Contents + + + + + + Menu + + + + + + + + Expand + + + + + + Light mode + + + + + + + + + + + + + + Dark mode + + + + + + + Auto light/dark mode + + + + + + + + + + + + + + + + + + + +
+
+
+ +
+
+
Pressio-Ops-0.14.0
 +
+
+
+ +
+ +
+
+ +
+
+
+ + + + + Back to top + +
+
+ +
+ +
+
+
+

expressions#

+

Defined in header: <pressio/expressions.hpp>

+

Public namespace: pressio

+

We refer to these as expressions because each function does not allocate +new memory but only creates an instance of a class that “represents” the given operation.

+

In all cases, the returned expression remains valid until its operand goes out of scope. +If the operand goes out of scope, the state of the expression is undefined.

+
+ +
+
+ +
+
+ +
+ +
+
+ + + + + + + + + \ No newline at end of file diff --git a/docs/generated_docs/components/expressions/diag.html b/docs/generated_docs/components/expressions/diag.html new file mode 100644 index 0000000..e0b72ae --- /dev/null +++ b/docs/generated_docs/components/expressions/diag.html @@ -0,0 +1,344 @@ + + + + + + + + + diagonal - Pressio-Ops-0.14.0 + + + + + + + + + + + + + + + + + + Contents + + + + + + Menu + + + + + + + + Expand + + + + + + Light mode + + + + + + + + + + + + + + Dark mode + + + + + + + Auto light/dark mode + + + + + + + + + + + + + + + + + + + +
+
+
+ +
+
+
Pressio-Ops-0.14.0
 +
+
+
+ +
+ +
+
+ +
+
+
+ + + + + Back to top + +
+
+ +
+ +
+
+
+

diagonal#

+

Header: <pressio/expressions.hpp>

+
+

API#

+
namespace pressio {
+
+template<class T>
+/*impl defined*/ diagonal(T & operand);
+
+} // end namespace pressio
+
+
+
+
+

Description#

+
    +

  • Takes in an operand that is either:

    +
    +
      +

    • a square Eigen dense matrix, pressio::is_dense_matrix_eigen<T>::value == true

      • +

    • a square Kokkos rank-2 view, i.e. pressio::is_dense_matrix_kokkos<T>::value == true

      • +
    +
    +
    • +

  • Returns an expression that represents that diagonal of operand

    • +
+
+
+ +
+
+ +
+ +
+
+ + + + + + + + + \ No newline at end of file diff --git a/docs/generated_docs/components/expressions/span.html b/docs/generated_docs/components/expressions/span.html new file mode 100644 index 0000000..cbe4da5 --- /dev/null +++ b/docs/generated_docs/components/expressions/span.html @@ -0,0 +1,352 @@ + + + + + + + + + span - Pressio-Ops-0.14.0 + + + + + + + + + + + + + + + + + + Contents + + + + + + Menu + + + + + + + + Expand + + + + + + Light mode + + + + + + + + + + + + + + Dark mode + + + + + + + Auto light/dark mode + + + + + + + + + + + + + + + + + + + +
+
+
+ +
+
+
Pressio-Ops-0.14.0
 +
+
+
+ +
+ +
+
+ +
+
+
+ + + + + Back to top + +
+
+ +
+ +
+
+
+

span#

+

Header: <pressio/expressions.hpp>

+
+

API#

+
namespace pressio {
+
+template<class T>
+/*impl defined*/ span(T & operand,
+                      std::pair<std::size_t, std::size_t> indexRange);
+
+} // end namespace pressio
+
+
+
+
+

Description#

+
    +

  • Takes in an operand and an indexRange

    +
    +
      +

    • operand is either:

      +
      +
        +

      • an Eigen vector object: pressio::is_vector_eigen<T>::value == true

        • +

      • a Kokkos rank-1 view, i.e. pressio::is_vector_kokkos<T>::value == true

        • +
      +
      +
      • +

    • indexRange is a std::pairidentifying an interval [a, b) where the second index is exclusive

      • +
    +
    +
    • +

  • Returns an expression that represents the target span of the operand.

    • +
+
+
+ +
+
+ +
+ +
+
+ + + + + + + + + \ No newline at end of file diff --git a/docs/generated_docs/components/expressions/subspan.html b/docs/generated_docs/components/expressions/subspan.html new file mode 100644 index 0000000..4c91bb7 --- /dev/null +++ b/docs/generated_docs/components/expressions/subspan.html @@ -0,0 +1,352 @@ + + + + + + + + + subspan - Pressio-Ops-0.14.0 + + + + + + + + + + + + + + + + + + Contents + + + + + + Menu + + + + + + + + Expand + + + + + + Light mode + + + + + + + + + + + + + + Dark mode + + + + + + + Auto light/dark mode + + + + + + + + + + + + + + + + + + + +
+
+
+ +
+
+
Pressio-Ops-0.14.0
 +
+
+
+ +
+ +
+
+ +
+
+
+ + + + + Back to top + +
+
+ +
+ +
+
+
+

subspan#

+

Header: <pressio/expressions.hpp>

+
+

API#

+
namespace pressio {
+
+template<class T>
+/*impl defined*/ subspan(T & operand,
+                         std::pair<std::size_t, std::size_t> rowsRange,
+                         std::pair<std::size_t, std::size_t> colsRange);
+
+} // end namespace pressio
+
+
+
+
+

Description#

+
    +

  • Takes in an operand, as well as the rowsRange and colsRange intervals that will be used in each dimension

    +
    +
      +

    • operand is either:

      +
      +
        +

      • an Eigen dense matrix, pressio::is_dense_matrix_eigen<T>::value == true

        • +

      • a Kokkos rank-2 view, i.e. pressio::is_dense_matrix_kokkos<T>::value == true

        • +
      +
      +
      • +
    +
    +
    • +

  • Returns an expression object that represents a subspan of the operand.

    • +
+
+
+ +
+
+ +
+ +
+
+ + + + + + + + + \ No newline at end of file diff --git a/docs/generated_docs/components/mpl.html b/docs/generated_docs/components/mpl.html new file mode 100644 index 0000000..6ef1490 --- /dev/null +++ b/docs/generated_docs/components/mpl.html @@ -0,0 +1,394 @@ + + + + + + + + + mpl - Pressio-Ops-0.14.0 + + + + + + + + + + + + + + + + + + Contents + + + + + + Menu + + + + + + + + Expand + + + + + + Light mode + + + + + + + + + + + + + + Dark mode + + + + + + + Auto light/dark mode + + + + + + + + + + + + + + + + + + + +
+
+
+ +
+
+
Pressio-Ops-0.14.0
 +
+
+
+ +
+ +
+
+ +
+
+
+ + + + + Back to top + +
+
+ +
+ +
+
+
+

mpl#

+

Header: <pressio/mpl.hpp>

+

Public namespace: pressio::mpl

+
+

Scope#

+

Provides metaprogramming functionalities needed to +support generic programming, which is a fundamental +building block of the pressio library. +If you are familiar with the <type_traits> header from +the standard library, the pressio/mpl will look familiar too. +Some parts of pressio/mpl have been adapted from the tinympl project. +The tinympl project appears to be no longer maintained.

+

The following is a partial list only intended to provide a general idea of the supported features.

+

To find out all supported cases, browse the source.

+
+

pressio::mpl::all_of#

+
template< template<class ... T> class F, class ... Args> struct all_of;
+
+
+
    +

  • Determines whether every element in the sequence satisfies the given predicate. +The predicate F must be such that F<T>::value must be convertible to bool. +Provides the static member constant value that is equal to true iff +all the elements in the sequence satisfy the predicate F. +Otherwise, value is false.

    • +

  • Example:

    +
    namespace pmpl = pressio::mpl;
+static_assert(pmpl::all_of<std::is_floating_point, double, float>::value, "" );
+
    +
    +
    • +
+
+
+

pressio::mpl::any_of#

+
template< template<class ... T> class F, class ... Args> struct any_of;
+
+
+
    +

  • Determines whether any element in the sequence satisfies the given predicate. +The predicate F must be such that F<T>::value must be convertible to bool. +Provides the static member constant value that is equal to true iff +at least one element in the sequence satisfies the predicate F. +Otherwise, value is equal to false.

    • +
+
+
+

pressio::mpl::none_of#

+
template< template<class ... T> class F, class ... Args> struct none_of;
+
+
+
    +

  • Determines whether none of the elements in the sequence satisfy the given predicate. +The predicate F must be such that F<T>::value must be convertible to bool. +Provides the static member constant value that is equal to true iff +none of the elements in the sequence satisfy the predicate F. +Otherwise, value is equal to false.

    • +
+
+
+

pressio::mpl::is_subscriptable_as#

+
template<class T, class IndexType> struct is_subscriptable_as;
+
+
+
    +

  • Provides the static member constant value that is equal to true if +T has subscript operator [], it can be indexed by an instance of IndexType, +and the return type is not void. +Otherwise, value is equal to false.

    • +
+
+
+
+ +
+
+ +
+ +
+
+ + + + + + + + + \ No newline at end of file diff --git a/docs/generated_docs/components/ops.html b/docs/generated_docs/components/ops.html new file mode 100644 index 0000000..ed2dc9f --- /dev/null +++ b/docs/generated_docs/components/ops.html @@ -0,0 +1,421 @@ + + + + + + + + + ops - Pressio-Ops-0.14.0 + + + + + + + + + + + + + + + + + + Contents + + + + + + Menu + + + + + + + + Expand + + + + + + Light mode + + + + + + + + + + + + + + Dark mode + + + + + + + Auto light/dark mode + + + + + + + + + + + + + + + + + + + +
+
+
+ +
+
+
Pressio-Ops-0.14.0
 +
+
+
+ +
+ +
+
+ +
+
+
+ + + + + Back to top + +
+
+ +
+ +
+
+
+

ops#

+

Header: <pressio/ops.hpp>

+

Public namespace: pressio::ops

+

Pressio operations are generalized to work on a variety of container types and backends.

+
+

Types#

+

The following table holds both the types supported throughout the ops directory and the +built-in booleans that confirm if a given type T is the expected type.

+

All expressions are within the pressio namespace.

+
+ +++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

Container Type

Rank-1 Check

Rank-2 Check

Eigen

is_vector_eigen<T>::value

is_sparse_matrix_eigen<T>::value, is_dense_matrix_eigen<T>::value

Kokkos

is_vector_kokkos<T>::value

is_dense_matrix_kokkos<T>::value, is_sparse_matrix_kokkos<T>::value

Epetra

is_vector_epetra<T>::value

is_multi_vector_epetra<T>::value

Tpetra

is_vector_tpetra<T>::value

is_multi_vector_tpetra<T>::value

Tpetra Block

is_vector_tpetra_block<T>::value

is_multi_vector_tpetra_block<T>::value

Teuchos

is_dense_vector_teuchos<T>::value

is_dense_matrix_teuchos<T>::value

+
+

Additionally, because Pressio features expressions for containers built on Eigen, Kokkos, and Tpetra, you can check whether or not a container is native with:

+
+ +++++ + + + + + + + + + + + + + + + + + + + + +

Container Type

Native

Pressio Expression

Eigen

is_native_container_eigen<T>::value

is_expression_acting_on_eigen<T>::value

Kokkos

is_native_container_kokkos<T>::value

is_expression_acting_on_kokkos<T>::value

Tpetra

is_expression_column_acting_on_tpetra<T>::value

+
+
+ +
+ +
+
+ +
+ +
+
+ + + + + + + + + \ No newline at end of file diff --git a/docs/generated_docs/components/ops/abs.html b/docs/generated_docs/components/ops/abs.html new file mode 100644 index 0000000..95362d6 --- /dev/null +++ b/docs/generated_docs/components/ops/abs.html @@ -0,0 +1,354 @@ + + + + + + + + + abs - Pressio-Ops-0.14.0 + + + + + + + + + + + + + + + + + + Contents + + + + + + Menu + + + + + + + + Expand + + + + + + Light mode + + + + + + + + + + + + + + Dark mode + + + + + + + Auto light/dark mode + + + + + + + + + + + + + + + + + + + +
+
+
+ +
+
+
Pressio-Ops-0.14.0
 +
+
+
+ +
+ +
+
+ +
+
+
+ + + + + Back to top + +
+
+ +
+ +
+
+
+

abs#

+

Header: <pressio/ops.hpp>

+
+

API#

+
namespace pressio { namespace ops{
+
+template<class T1, class T2>
+void abs(T1 & x, const T2 & y);
+
+}} // end namespace pressio::ops
+
+
+
+
+

Description#

+
    +

  • Computes the element-wise absolute value of each element +in the operand x and stores the result in y.

    • +

  • T1 and T2 must be one-dimensional containers with compatible scalar types:

    +
      +

    • an Eigen vector

      • +

    • a Kokkos rank-1 view

      • +

    • a Tpetra vector

      • +

    • a Tpetra block vector

      • +

    • a Epetra vector

      • +

    • a Pressio expression, i.e. pressio::diag, pressio::span, pressio::subspan, based on Eigen or Kokkos container

      • +
    +
    • +
+
+
+

Notes#

+
    +

  • See the ops homepage for a table of booleans to use when checking that T1 and T2 have the correct types.

    • +
+
+
+ +
+
+ +
+ +
+
+ + + + + + + + + \ No newline at end of file diff --git a/docs/generated_docs/components/ops/add_to_diagonal.html b/docs/generated_docs/components/ops/add_to_diagonal.html new file mode 100644 index 0000000..4413812 --- /dev/null +++ b/docs/generated_docs/components/ops/add_to_diagonal.html @@ -0,0 +1,346 @@ + + + + + + + + + add_to_diagonal - Pressio-Ops-0.14.0 + + + + + + + + + + + + + + + + + + Contents + + + + + + Menu + + + + + + + + Expand + + + + + + Light mode + + + + + + + + + + + + + + Dark mode + + + + + + + Auto light/dark mode + + + + + + + + + + + + + + + + + + + +
+
+
+ +
+
+
Pressio-Ops-0.14.0
 +
+
+
+ +
+ +
+
+ +
+
+
+ + + + + Back to top + +
+
+ +
+ +
+
+
+

add_to_diagonal#

+

Header: <pressio/ops.hpp>

+
+

API#

+
namespace pressio { namespace ops{
+
+template<class T1, class ScalarType>
+void add_to_diagonal(T1 & operand, const ScalarType & value);
+
+}} // end namespace pressio::ops
+
+
+
+
+

Description#

+
    +

  • Adds the specified scalar value to each diagonal element of operand

    • +

  • T must be a rank-2 Eigen matrix

    • +

  • ScalarType must be convertible to pressio::Traits<T>::scalar_type

    • +
+
+
+

Notes#

+
    +

  • If the diagonal entries of operand are written, then all diagonal entries must already exist.

    • +

  • See the ops homepage for a table of booleans to use when checking that T1 has the correct type.

    • +
+
+
+ +
+
+ +
+ +
+
+ + + + + + + + + \ No newline at end of file diff --git a/docs/generated_docs/components/ops/clone.html b/docs/generated_docs/components/ops/clone.html new file mode 100644 index 0000000..3250b4e --- /dev/null +++ b/docs/generated_docs/components/ops/clone.html @@ -0,0 +1,372 @@ + + + + + + + + + clone - Pressio-Ops-0.14.0 + + + + + + + + + + + + + + + + + + Contents + + + + + + Menu + + + + + + + + Expand + + + + + + Light mode + + + + + + + + + + + + + + Dark mode + + + + + + + Auto light/dark mode + + + + + + + + + + + + + + + + + + + +
+
+
+ +
+
+
Pressio-Ops-0.14.0
 +
+
+
+ +
+ +
+
+ +
+
+
+ + + + + Back to top + +
+
+ +
+ +
+
+
+

clone#

+

Header: <pressio/ops.hpp>

+
+

API#

+
namespace pressio { namespace ops{
+
+template<class T>
+T clone(const T & operand);
+
+}} // end namespace pressio::ops
+
+
+
+
+

Description#

+
    +

  • Creates and returns a new instance of T by making a new allocation +and copying all values from operand into it.

    +
      +

    • It is an exact but independent clone of operand.

      • +
    +
    • +

  • T must be:

    +
      +

    • an Eigen vector or matrix object

      • +

    • a Kokkos view

      • +

    • a Teuchos vector

      • +

    • or an Epetra vector or multi-vector

      • +

    • or a Tpetra vector or multi-vector

      • +

    • or a Tpetra block vector or multi-vector

      • +
    +
    • +
+
+
+

Notes#

+
    +

  • This is a blocking operation, i.e. the kernel completes before returning.

    • +

  • This kernel has value semantics, even for types that, by default, +have view semantics like Kokkos, Tpetra or TpetraBlock. +This means the following: +let auto result = clone(operand), then any operation applied +to operand after calling clone will NOT +have any impact on result. +And any operation applied to result will not have any impact on operand.

    • +

  • For types that have value semantics, for example Eigen::Matrix<...>, +Epetra vector or MV, this kernel can be implemented by calling the copy constructor +and returning the copy

    • +

  • For Kokkos, Tpetra, or TpetraBlock data types, which by default have view semantics +(i.e. a copy is a shallow copy), the operation can be implemented by first making a new +object with extents identical to operand, followed by a deep copy, and then return the result.

    • +

  • See the ops homepage for a table of booleans to use when checking that T has the correct type.

    • +
+
+
+ +
+
+ +
+ +
+
+ + + + + + + + + \ No newline at end of file diff --git a/docs/generated_docs/components/ops/deep_copy.html b/docs/generated_docs/components/ops/deep_copy.html new file mode 100644 index 0000000..e5f2c1e --- /dev/null +++ b/docs/generated_docs/components/ops/deep_copy.html @@ -0,0 +1,359 @@ + + + + + + + + + deep_copy - Pressio-Ops-0.14.0 + + + + + + + + + + + + + + + + + + Contents + + + + + + Menu + + + + + + + + Expand + + + + + + Light mode + + + + + + + + + + + + + + Dark mode + + + + + + + Auto light/dark mode + + + + + + + + + + + + + + + + + + + +
+
+
+ +
+
+
Pressio-Ops-0.14.0
 +
+
+
+ +
+ +
+
+ +
+
+
+ + + + + Back to top + +
+
+ +
+ +
+
+
+

deep_copy#

+

Header: <pressio/ops.hpp>

+
+

API#

+
namespace pressio { namespace ops{
+
+template<typename T1, typename T2>
+void deep_copy(T2 & dest, const T1 & src);
+
+template<typename T>
+void deep_copy(T & dest, const T & src);
+
+}} // end namespace pressio::ops
+
+
+
+
+

Description#

+
    +

  • Copies all elements from src into dst, so that dst is fully independent of src.

    • +

  • T1 and T2 must have the same rank, and must be:

    +
      +

    • Two Eigen-based containers (either a native Eigen container or a Pressio expression based on an Eigen container)

      • +

    • Two Kokkos-based containers (either a native Kokkos view or a Pressio expression based on a Kokkos container)

      • +
    +
    • +

  • T must be:

    +
      +

    • a Tpetra vector or multi-vector

      • +

    • a Tpetra block vector or multi-vector

      • +

    • a Epetra vector or multi-vector

      • +
    +
    • +
+
+
+

Notes#

+
    +

  • See the ops homepage for a table of booleans to use when checking that T, T1, and T2 have the correct types.

    • +
+
+
+ +
+
+ +
+ +
+
+ + + + + + + + + \ No newline at end of file diff --git a/docs/generated_docs/components/ops/dot.html b/docs/generated_docs/components/ops/dot.html new file mode 100644 index 0000000..325b6be --- /dev/null +++ b/docs/generated_docs/components/ops/dot.html @@ -0,0 +1,360 @@ + + + + + + + + + dot - Pressio-Ops-0.14.0 + + + + + + + + + + + + + + + + + + Contents + + + + + + Menu + + + + + + + + Expand + + + + + + Light mode + + + + + + + + + + + + + + Dark mode + + + + + + + Auto light/dark mode + + + + + + + + + + + + + + + + + + + +
+
+
+ +
+
+
Pressio-Ops-0.14.0
 +
+
+
+ +
+ +
+
+ +
+
+
+ + + + + Back to top + +
+
+ +
+ +
+
+
+

dot#

+

Header: <pressio/ops.hpp>

+
+

API#

+
namespace pressio { namespace ops{
+
+template<typename T1, typename T2, typename DotResult>
+void dot(const T1 & vecA, const T2 & vecB, DotResult & result);
+
+template<typename T1, typename T2>
+scalar_type dot(const T1 & vecA, const T2 & vecB);
+
+}} // end namespace pressio::ops
+
+
+
+
+

Description#

+
    +

  • Computes the dot product of two compatible vectors (vecA and vecB)

    +
      +

    • Stores the result in result if provided; otherwise, returns the result

      • +
    +
    • +

  • T1 and T2 must be one-dimensional containers with compatible scalar types:

    +
      +

    • an Eigen vector

      • +

    • a Kokkos rank-1 view

      • +

    • a Tpetra vector

      • +

    • a Tpetra block vector

      • +

    • a Epetra vector

      • +

    • a pressio expression, i.e. pressio::diag, pressio::span, pressio::subspan, based on Eigen or Kokkos container

      • +
    +
    • +
+
+
+

Notes#

+
    +

  • See the ops homepage for a table of booleans to use when checking that T1 and T2 have the correct types.

    • +
+
+
+ +
+
+ +
+ +
+
+ + + + + + + + + \ No newline at end of file diff --git a/docs/generated_docs/components/ops/elementwise_multiply.html b/docs/generated_docs/components/ops/elementwise_multiply.html new file mode 100644 index 0000000..312a627 --- /dev/null +++ b/docs/generated_docs/components/ops/elementwise_multiply.html @@ -0,0 +1,359 @@ + + + + + + + + + elementwise_multiply - Pressio-Ops-0.14.0 + + + + + + + + + + + + + + + + + + Contents + + + + + + Menu + + + + + + + + Expand + + + + + + Light mode + + + + + + + + + + + + + + Dark mode + + + + + + + Auto light/dark mode + + + + + + + + + + + + + + + + + + + +
+
+
+ +
+
+
Pressio-Ops-0.14.0
 +
+
+
+ +
+ +
+
+ +
+
+
+ + + + + Back to top + +
+
+ +
+ +
+
+
+

elementwise_multiply#

+

Header: <pressio/ops.hpp>

+
+

API#

+
namespace pressio { namespace ops{
+
+template <class T, class T1, class T2, class alpha_t, class beta_t>
+void elementwise_multiply(
+    const alpha_t & alpha,
+    const T & x,
+    const T1 & z,
+    const beta_t & beta,
+    T2 & y
+);
+
+}} // end namespace pressio::ops
+
+
+
+
+

Description#

+
    +

  • Computes y = beta * y + alpha * (x ⊙ z), where ⊙ denotes element-wise multiplication, and stores the result in y

    • +

  • T, T1, and T2 must be one-dimensional containers with compatible scalar types:

    +
      +

    • an Eigen vector

      • +

    • a Kokkos rank-1 view

      • +

    • a Tpetra vector

      • +

    • a Tpetra block vector

      • +

    • a Epetra vector

      • +

    • a pressio expression, i.e. pressio::diag, pressio::span, pressio::subspan, based on Eigen or Kokkos container

      • +
    +
    • +
+
+
+

Notes#

+
    +

  • See the ops homepage for a table of booleans to use when checking that T, T1, and T2 have the correct types.

    • +
+
+
+ +
+
+ +
+ +
+
+ + + + + + + + + \ No newline at end of file diff --git a/docs/generated_docs/components/ops/extent.html b/docs/generated_docs/components/ops/extent.html new file mode 100644 index 0000000..849104d --- /dev/null +++ b/docs/generated_docs/components/ops/extent.html @@ -0,0 +1,354 @@ + + + + + + + + + extent - Pressio-Ops-0.14.0 + + + + + + + + + + + + + + + + + + Contents + + + + + + Menu + + + + + + + + Expand + + + + + + Light mode + + + + + + + + + + + + + + Dark mode + + + + + + + Auto light/dark mode + + + + + + + + + + + + + + + + + + + +
+
+
+ +
+
+
Pressio-Ops-0.14.0
 +
+
+
+ +
+ +
+
+ +
+
+
+ + + + + Back to top + +
+
+ +
+ +
+
+
+

extent#

+

Header: <pressio/ops.hpp>

+
+

API#

+
namespace pressio { namespace ops{
+
+template<class T, class IndexType>
+std::size_t extent(const T & objectIn, const IndexType i);
+
+}} // end namespace pressio::ops
+
+
+
+
+

Description#

+
    +

  • Returns the size or dimension of a container objectIn along a specified axis i

    • +

  • T must be one of the following:

    +
      +

    • an Eigen vector or matrix object

      • +

    • a Kokkos view

      • +

    • a Teuchos vector

      • +

    • a Tpetra vector or multi-vector

      • +

    • a Tpetra block vector or multi-vector

      • +

    • a Epetra vector or multi-vector

      • +

    • a pressio expression, i.e. pressio::diag, pressio::span, pressio::subspan, based on an Eigen, Tpetra Block, or Kokkos container

      • +
    +
    • +
+
+
+

Notes#

+
    +

  • See the ops homepage for a table of booleans to use when checking that T has the correct type.

    • +
+
+
+ +
+
+ +
+ +
+
+ + + + + + + + + \ No newline at end of file diff --git a/docs/generated_docs/components/ops/fill.html b/docs/generated_docs/components/ops/fill.html new file mode 100644 index 0000000..20c11b3 --- /dev/null +++ b/docs/generated_docs/components/ops/fill.html @@ -0,0 +1,355 @@ + + + + + + + + + fill - Pressio-Ops-0.14.0 + + + + + + + + + + + + + + + + + + Contents + + + + + + Menu + + + + + + + + Expand + + + + + + Light mode + + + + + + + + + + + + + + Dark mode + + + + + + + Auto light/dark mode + + + + + + + + + + + + + + + + + + + +
+
+
+ +
+
+
Pressio-Ops-0.14.0
 +
+
+
+ +
+ +
+
+ +
+
+
+ + + + + Back to top + +
+
+ +
+ +
+
+
+

fill#

+

Header: <pressio/ops.hpp>

+
+

API#

+
namespace pressio { namespace ops{
+
+template<class T, class ScalarType>
+void fill(T & operand, ScalarType const & value);
+
+}} // end namespace pressio::ops
+
+
+
+
+

Description#

+
    +

  • Overwrites each element of operand with value.

    • +

  • T must be:

    +
      +

    • an Eigen vector or matrix object

      • +

    • a Kokkos rank-1 or rank-2 view

      • +

    • a Teuchos vector

      • +

    • a Tpetra vector or multi-vector

      • +

    • a Tpetra block vector or multi-vector

      • +

    • a Epetra vector or multi-vector

      • +

    • a pressio expression, i.e. pressio::diag, pressio::span, pressio::subspan, based on an Eigen or Kokkos container

      • +
    +
    • +

  • ScalarType must be convertible to pressio::Traits<T>::scalar_type

    • +
+
+
+

Notes#

+
    +

  • See the ops homepage for a table of booleans to use when checking that T1 and T2 have the correct types.

    • +
+
+
+ +
+
+ +
+ +
+
+ + + + + + + + + \ No newline at end of file diff --git a/docs/generated_docs/components/ops/matrix_matrix_product.html b/docs/generated_docs/components/ops/matrix_matrix_product.html new file mode 100644 index 0000000..92ea116 --- /dev/null +++ b/docs/generated_docs/components/ops/matrix_matrix_product.html @@ -0,0 +1,402 @@ + + + + + + + + + matrix-matrix product - Pressio-Ops-0.14.0 + + + + + + + + + + + + + + + + + + Contents + + + + + + Menu + + + + + + + + Expand + + + + + + Light mode + + + + + + + + + + + + + + Dark mode + + + + + + + Auto light/dark mode + + + + + + + + + + + + + + + + + + + +
+
+
+ +
+
+
Pressio-Ops-0.14.0
 +
+
+
+ +
+ +
+
+ +
+
+
+ + + + + Back to top + +
+
+ +
+ +
+
+
+

matrix-matrix product#

+

Header: <pressio/ops.hpp>

+
+

API#

+
namespace pressio { namespace ops{
+
+// op(A) = A^T and op(B) = B
+template <
+  class A_type, class B_type, class C_type,
+  class alpha_t, class beta_t
+>
+void product(::pressio::transpose /*unused*/,
+      ::pressio::nontranspose /*unused*/,
+      const alpha_t & alpha,
+      const A_type & A,
+      const B_type & B,
+      const beta_t & beta,
+      C_type & C);
+
+// op(A) = A and op(B) = B
+template <
+  class A_type, class B_type, class C_type,
+  class alpha_t, class beta_t
+>
+void product(::pressio::nontranspose /*unused*/,
+      ::pressio::nontranspose /*unused*/,
+      const alpha_t & alpha,
+      const A_type & A,
+      const B_type & B,
+      const beta_t & beta,
+      C_type & C);
+
+// A == B and op(A) = A^T
+template <class A_type, class C_type, class alpha_t, class beta_t>
+void product(::pressio::transpose /*unused*/,
+      ::pressio::nontranspose /*unused*/,
+      const alpha_t & alpha,
+      const A_type & A,
+      const beta_t & beta,
+      C_type & C);
+
+// Construct result
+template <class C_type, class A_type, class alpha_t>
+C_type product(::pressio::transpose modeA,
+      ::pressio::nontranspose modeB,
+      const alpha_t & alpha,
+      const A_type & A);
+
+}} // end namespace pressio::ops
+
+
+
+
+

Description#

+
    +

  • Performs matrix-vector multiplication according to C = beta * C + alpha * op(A) * op(B)

    +
      +

    • op(X) indicates either X or X^T

      • +
    +
    • +

  • alpha_t and beta_t are scalar types

    • +

  • A_type, B_type, and C_type are rank-2 containers

    • +
+
+
+

Types#

+

The matrix-matrix product works for the following matrix types:

+
    +

  • Eigen (all containers are rank-2 Eigen matrices)

    • +

  • Epetra (A and B are Epetra multi-vectors; C is a rank-2 Eigen matrix)

    • +

  • Kokkos (all containers are rank-2 Kokkos views)

    • +

  • Tpetra (A and B are Tpetra multi-vectors; C is either a rank-2 Eigen matrix or a rank-2 Kokkos view)

    • +

  • Tpetra Block (A and B are Tpetra Block multi-vectors; C is either a rank-2 Eigen matrix or a rank-2 Kokkos view)

    • +
+
+
+

Notes#

+
    +

  • See the ops homepage for a table of booleans to use when checking that A, B, and C` have the correct types.

    • +
+
+
+ +
+
+ +
+ +
+
+ + + + + + + + + \ No newline at end of file diff --git a/docs/generated_docs/components/ops/matrix_vector_product.html b/docs/generated_docs/components/ops/matrix_vector_product.html new file mode 100644 index 0000000..6cf87ed --- /dev/null +++ b/docs/generated_docs/components/ops/matrix_vector_product.html @@ -0,0 +1,429 @@ + + + + + + + + + matrix-vector product - Pressio-Ops-0.14.0 + + + + + + + + + + + + + + + + + + Contents + + + + + + Menu + + + + + + + + Expand + + + + + + Light mode + + + + + + + + + + + + + + Dark mode + + + + + + + Auto light/dark mode + + + + + + + + + + + + + + + + + + + +
+
+
+ +
+
+
Pressio-Ops-0.14.0
 +
+
+
+ +
+ +
+
+ +
+
+
+ + + + + Back to top + +
+
+ +
+ +
+
+
+

matrix-vector product#

+

Header: <pressio/ops.hpp>

+
+

API#

+
namespace pressio { namespace ops{
+
+// op(A) = A
+template <
+  class A_type, class x_type, class y_type,
+  class alpha_t, class beta_t
+>
+void product(::pressio::nontranspose /*unused*/,
+      const alpha_t & alpha,
+      const A_type & A,
+      const x_type & x,
+      const beta_t & beta,
+      y_type & y);
+
+// op(A) = A , construct result
+template <
+  class y_type, class A_type, class x_type, class alpha_t
+>
+y_type product(::pressio::nontranspose mode,
+      const alpha_t & alpha,
+      const A_type & A,
+      const x_type & x);
+
+// op(A) = A^T
+template <
+  class y_type, class A_type, class x_type, class alpha_t
+>
+void product(::pressio::transpose /*unused*/,
+      const alpha_t & alpha,
+      const A_type & A,
+      const x_type & x,
+      const beta_t & beta,
+      y_type & y);
+
+// op(A) = A^T , construct result
+template <class y_type, class A_type, class x_type, class alpha_t>
+y_type product(::pressio::transpose mode,
+      const alpha_t & alpha,
+      const A_type & A,
+      const x_type & x);
+
+}} // end namespace pressio::ops
+
+
+
+
+

Description#

+
    +

  • Performs matrix-vector multiplication according to y = beta * y + alpha * op(A) * x +* op(A) indicates either A or A^T

    • +

  • alpha_t and beta_t are scalar types

    • +

  • x_type and y_type are rank-1 containers

    • +

  • A_type is a rank-2 container

    • +

  • The following combinations of container types are supported for each A_type:

    +
      +

    • Eigen

      +
        +

      • All container types are either Eigen containers or Pressio expressions of Eigen containers,

        • +
      +
      • +

    • Epetra

      +
        +

      • A_type is an Epetra rank-2 container

        • +

      • Either x_type or y_type is a rank-1 Epetra container

        • +

      • The other non-Epetra container is a rank-1 Teuchos or Eigen container

        • +
      +
      • +

    • Kokkos

      +
        +

      • All container types are either Kokkos views or Pressio expressions of Eigen views

        • +
      +
      • +

    • Teuchos (does not support constructed results)

      +
        +

      • A_type is a rank-2 Teuchos container

        • +

      • x_type and y_type are rank-1 Eigen containers

        • +
      +
      • +

    • Tpetra

      +
        +

      • A_type is a rank-2 Tpetra container

        • +

      • x_type is a rank-1 Eigen, Kokkos, Teuchos, or Tpetra container

        • +

      • y_type is a rank-1 container. +If x_type is Tpetra, it may be either a Kokkos or Eigen container (or a Pressio expression of a Kokkos or Eigen container) +Otherwise, y_type is a Tpetra container or a Pressio column expression

        • +
      +
      • +

    • Tpetra Block

      +
        +

      • A_type is a rank-2 Tpetra Block container

        • +

      • x_type is a rank-1 Eigen, Kokkos, Teuchos, or Tpetra Block container

        • +

      • y_type is a rank-1 container. +If x_type is a Tpetra Block vector, y_type may be either an Eigen vector or a rank-1 Kokkos view +Otherwise, y_type is a Tpetra Block vector or column expression

        • +
      +
      • +
    +
    • +
+
+
+

Notes#

+
    +

  • See the ops homepage for a table of booleans to use when checking that A_type, x_type, and y_type` have the correct types.

    • +
+
+
+ +
+
+ +
+ +
+
+ + + + + + + + + \ No newline at end of file diff --git a/docs/generated_docs/components/ops/min_max.html b/docs/generated_docs/components/ops/min_max.html new file mode 100644 index 0000000..d05d6c6 --- /dev/null +++ b/docs/generated_docs/components/ops/min_max.html @@ -0,0 +1,342 @@ + + + + + + + + + min & max - Pressio-Ops-0.14.0 + + + + + + + + + + + + + + + + + + Contents + + + + + + Menu + + + + + + + + Expand + + + + + + Light mode + + + + + + + + + + + + + + Dark mode + + + + + + + Auto light/dark mode + + + + + + + + + + + + + + + + + + + +
+
+
+ +
+
+
Pressio-Ops-0.14.0
 +
+
+
+ +
+ +
+
+ +
+
+
+ + + + + Back to top + +
+
+ +
+ +
+
+
+

min & max#

+

Header: <pressio/ops.hpp>

+
+

API#

+
namespace pressio { namespace ops{
+
+template <typename T>
+scalar_type max(const T & obj);
+
+template<typename T>
+scalar_type min(const T & obj);
+
+}} // end namespace pressio::ops
+
+
+
+
+

Description#

+
    +

  • Returns the maximum or minimum value of the given container

    • +

  • Works for all container types other than Teuchos arrays

    • +
+
+
+ +
+
+ +
+ +
+
+ + + + + + + + + \ No newline at end of file diff --git a/docs/generated_docs/components/ops/norms.html b/docs/generated_docs/components/ops/norms.html new file mode 100644 index 0000000..9c0bc70 --- /dev/null +++ b/docs/generated_docs/components/ops/norms.html @@ -0,0 +1,360 @@ + + + + + + + + + norms - Pressio-Ops-0.14.0 + + + + + + + + + + + + + + + + + + Contents + + + + + + Menu + + + + + + + + Expand + + + + + + Light mode + + + + + + + + + + + + + + Dark mode + + + + + + + Auto light/dark mode + + + + + + + + + + + + + + + + + + + +
+
+
+ +
+
+
Pressio-Ops-0.14.0
 +
+
+
+ +
+ +
+
+ +
+
+
+ + + + + Back to top + +
+
+ +
+ +
+
+
+

norms#

+

Header: <pressio/ops.hpp>

+
+

API#

+
namespace pressio { namespace ops{
+
+// L1 Norm
+template <typename T>
+scalar_type norm1(const T & a);
+
+// L2 Norm
+template <typename T>
+scalar_type norm2(const T & a);
+
+}} // end namespace pressio::ops
+
+
+
+
+

Description#

+
    +

  • Returns the desired norm of the given container a

    • +

  • L1 norm is given by

    • +
+
+
+\[\| a \|_1 = \sum_{i} |a_i|\]
+
+
    +

  • L2 norm is given by:

    • +
+
+
+\[\|\mathbf{a}\|_2 = \sqrt{\sum_{i=1}^{n} a_i^2}\]
+
+
    +

  • a must be rank-1

    • +
+
+
+ +
+
+ +
+ +
+
+ + + + + + + + + + \ No newline at end of file diff --git a/docs/generated_docs/components/ops/product.html b/docs/generated_docs/components/ops/product.html new file mode 100644 index 0000000..4063048 --- /dev/null +++ b/docs/generated_docs/components/ops/product.html @@ -0,0 +1,428 @@ + + + + + + + + + product - Pressio-Ops-0.14.0 + + + + + + + + + + + + + + + + + + Contents + + + + + + Menu + + + + + + + + Expand + + + + + + Light mode + + + + + + + + + + + + + + Dark mode + + + + + + + Auto light/dark mode + + + + + + + + + + + + + + + + + + + +
+
+
+ +
+
+
Pressio-Ops-0.14.0
 +
+
+
+ +
+ +
+
+ +
+
+
+ + + + + Back to top + +
+
+ +
+ +
+
+
+

product#

+

Header: <pressio/ops.hpp>

+
+

API#

+
namespace pressio { namespace ops{
+
+// op(A) = A
+template <
+  class A_type, class x_type, class y_type,
+  class alpha_t, class beta_t
+>
+void product(::pressio::nontranspose /*unused*/,
+      const alpha_t & alpha,
+      const A_type & A,
+      const x_type & x,
+      const beta_t & beta,
+      y_type & y);
+
+// op(A) = A , construct result
+template <
+  class y_type, class A_type, class x_type, class alpha_t
+>
+y_type product(::pressio::nontranspose mode,
+      const alpha_t & alpha,
+      const A_type & A,
+      const x_type & x);
+
+// op(A) = A^T
+template <
+  class y_type, class A_type, class x_type, class alpha_t
+>
+void product(::pressio::transpose /*unused*/,
+      const alpha_t & alpha,
+      const A_type & A,
+      const x_type & x,
+      const beta_t & beta,
+      y_type & y);
+
+// op(A) = A^T , construct result
+template <class y_type, class A_type, class x_type, class alpha_t>
+y_type product(::pressio::transpose mode,
+      const alpha_t & alpha,
+      const A_type & A,
+      const x_type & x);
+
+}} // end namespace pressio::ops
+
+
+
+
+

Description#

+
    +

  • Performs matrix-vector multiplication according to y = beta * y + alpha * op(A) * x +* op(A) indicates either A or A^T

    • +

  • alpha_t and beta_t are scalar types

    • +

  • x_type and y_type are rank-1 containers

    • +

  • A_type is a rank-2 container

    • +

  • The following combinations of container types are supported for each A_type:

    +
      +

    • Eigen

      +
        +

      • All container types are either Eigen containers or Pressio expressions of Eigen containers,

        • +
      +
      • +

    • Epetra

      +
        +

      • A_type is an Epetra rank-2 container

        • +

      • Either x_type or y_type is a rank-1 Epetra container

        • +

      • The other non-Epetra container is a rank-1 Teuchos or Eigen container

        • +
      +
      • +

    • Kokkos

      +
        +

      • All container types are either Kokkos views or Pressio expressions of Eigen views

        • +
      +
      • +

    • Teuchos (does not support constructed results)

      +
        +

      • A_type is a rank-2 Teuchos container

        • +

      • x_type and y_type are rank-1 Eigen containers

        • +
      +
      • +

    • Tpetra

      +
        +

      • A_type is a rank-2 Tpetra container

        • +

      • x_type is a rank-1 Eigen, Kokkos, Teuchos, or Tpetra container

        • +

      • y_type is a rank-1 container. +If x_type is Tpetra, it may be either a Kokkos or Eigen container (or a Pressio expression of a Kokkos or Eigen container) +Otherwise, y_type is a Tpetra container or a Pressio column expression

        • +
      +
      • +

    • Tpetra Block

      +
        +

      • A_type is a rank-2 Tpetra Block container

        • +

      • x_type is a rank-1 Eigen, Kokkos, Teuchos, or Tpetra Block container

        • +

      • y_type is a rank-1 container. +If x_type is a Tpetra Block vector, y_type may be either an Eigen vector or a rank-1 Kokkos view +Otherwise, y_type is a Tpetra Block vector or column expression

        • +
      +
      • +
    +
    • +
+
+
+

Notes#

+
    +

  • See the ops homepage for a table of booleans to use when checking that A_type, x_type, and y_type` have the correct types.

    • +
+
+
+ +
+
+ +
+ +
+
+ + + + + + + + + \ No newline at end of file diff --git a/docs/generated_docs/components/type_traits.html b/docs/generated_docs/components/type_traits.html new file mode 100644 index 0000000..8f889a4 --- /dev/null +++ b/docs/generated_docs/components/type_traits.html @@ -0,0 +1,450 @@ + + + + + + + + + type_traits - Pressio-Ops-0.14.0 + + + + + + + + + + + + + + + + + + Contents + + + + + + Menu + + + + + + + + Expand + + + + + + Light mode + + + + + + + + + + + + + + Dark mode + + + + + + + Auto light/dark mode + + + + + + + + + + + + + + + + + + + +
+
+
+ +
+
+
Pressio-Ops-0.14.0
 +
+
+
+ +
+ +
+
+ +
+
+
+ + + + + Back to top + +
+
+ +
+ +
+
+
+

type_traits#

+

Header: <pressio/type_traits.hpp>

+

Public namespace: pressio

+
+

Scope#

+

Provides functionalities for type introspection and detection. +One of the main design features of pressio is that it supports arbitrary +types via generic programming and type introspection, but also +provides special support for some data types commonly used.

+
+
+

Traits class#

+

todo: finish

+

One of the most important things inside type_traits is the Traits class:

+
namespace pressio{
+template<class T, class = void> struct Traits;
+}
+
+
+

To understand the purpose and usage of the traits pattern in C++ there are several resources online. +Quoting Bjarne Stroustrup: “Think of a trait as a small object whose main purpose +is to carry information used by another object or algorithm +to determine “policy” or “implementation details”. +Pressio uses specializations of this class to gather in a uniform way +compile-time information enabling it to reason about types. +The key point here is that different TPLs use a variety of naming conventions +for nested typedefs and related things, so there is not easy way to access +similar information from types of various libraries. +This is what motivated us to implement this type_traits component. +We need a standard, uniform way to query types for compile-time information. +We currently have traits specialized for types of a few TPLs, like Trilinos, Kokkos, Eigen. +An example of one such specialization (in this case for Eigen) is:

+
template <typename T>
+struct Traits<
+  T, std::enable_if_t<is_dynamic_vector_eigen<T>::value>
+  >
+{
+  using scalar_type   = typename T::Scalar;
+  static constexpr int rank = 1;
+};
+
+
+

This Traits class play a key role when users want to use arbitrary types (i.e. types +which are not known to presso) and to do so, users shoud specialize this class and make +these specialization visibile to pressio to provide information about their generic types.

+

For practical examples of how this class is used, see:

+

finish

+
+
+

Type detection and identification#

+

We support several metafunctions for detecting +data types commonly used from existing TPLs. +The following list is partial, and more will be added as we continue the development.

+
+ ++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

Name

Description

template<class T>
struct is_static_vector_eigen;

Provides static member constant value equal to true if T is a static Eigen vector.
Requires: PRESSIO_ENABLE_TPL_EIGEN==On

template<class T>
struct is_dynamic_vector_eigen;

Provides static member constant value equal to true if T is a dynamic Eigen vector.
Requires: PRESSIO_ENABLE_TPL_EIGEN==On

template<class T>
struct is_vector_eigen;

Provides static member constant value equal to true if T is a static or dynamic Eigen vector.
Requires: PRESSIO_ENABLE_TPL_EIGEN==On

template<class T>
struct is_sparse_matrix_eigen;

Provides static member constant value equal to true if T is a static or dynamic sparse Eigen matrix.
Requires: PRESSIO_ENABLE_TPL_EIGEN==On

template<class T>
struct is_static_dense_matrix_eigen;

Provides static member constant value equal to true if T is a static dense Eigen matrix.
Requires: PRESSIO_ENABLE_TPL_EIGEN==On

template<class T>
struct is_dynamic_dense_matrix_eigen;

Provides static member constant value equal to true if T is a dynamic dense Eigen matrix.
Requires: PRESSIO_ENABLE_TPL_EIGEN==On

template<class T>
struct is_dense_matrix_eigen;

Provides static member constant value equal to true if T is a static or dynamic dense Eigen matrix.
Requires: PRESSIO_ENABLE_TPL_EIGEN==On

template<class T>
struct is_dense_vector_teuchos;

Provides static member constant value equal to true if T is a dense Teuchos vector.
Requires: PRESSIO_ENABLE_TPL_TRILINOS==On

template<class T>
struct is_dense_matrix_teuchos;

Provides static member constant value equal to true if T is a dense Teuchos matrix.
Requires: PRESSIO_ENABLE_TPL_TRILINOS==On

template<class T>
struct is_vector_epetra;

Provides static member constant value equal to true if T is Epetra vector.
Requires: PRESSIO_ENABLE_TPL_TRILINOS==On

template<class T>
struct is_multi_vector_epetra;

Provides static member constant value equal to true if T is an Epetra multi vector.
Requires: PRESSIO_ENABLE_TPL_TRILINOS==On

template<class T>
struct is_vector_tpetra;

Provides static member constant value equal to true if T is a Tpetra vector.
Requires: PRESSIO_ENABLE_TPL_TRILINOS==On

template<class T>
struct is_multi_vector_tpetra;

Provides static member constant value equal to true if T is a Tpetra multi vector.
Requires: PRESSIO_ENABLE_TPL_TRILINOS==On

template<class T>
struct is_vector_tpetra_block;

Provides static member constant value equal to true if T is a Tpetra-block vector.
Requires: PRESSIO_ENABLE_TPL_TRILINOS==On

template<class T>
struct is_multi_vector_tpetra_block;

Provides static member constant value equal to true if T is a Tpetra-block multi vector.
Requires: PRESSIO_ENABLE_TPL_TRILINOS==On

template<class T>
struct is_static_vector_kokkos;

Provides static member constant value equal to true if T is a static Kokkos vector (rank-1 View).
Requires: PRESSIO_ENABLE_TPL_KOKKOS==On

template<class T>
struct is_dynamic_vector_kokkos;

Provides static member constant value equal to true if T is a dynamic Kokkos vector (rank-1 View).
Requires: PRESSIO_ENABLE_TPL_KOKKOS==On

template<class T>
struct is_vector_kokkos;

Provides static member constant value equal to true if T is a static or dynamic Kokkos vector (rank-1 View).
Requires: PRESSIO_ENABLE_TPL_KOKKOS==On

template<class T>
struct is_static_dense_matrix_kokkos;

Provides static member constant value equal to true if T is a static dense Kokkos matrix (rank-2 View).
Requires: PRESSIO_ENABLE_TPL_KOKKOS==On

template<class T>
struct is_dynamic_dense_matrix_kokkos;

Provides static member constant value equal to true if T is a dynamic dense Kokkos matrix (rank-2 View).
Requires: PRESSIO_ENABLE_TPL_KOKKOS==On

template<class T>
struct is_dense_matrix_kokkos;

Provides static member constant value equal to true if T is a static or dynamic dense Kokkos matrix (rank-2 View).
Requires: PRESSIO_ENABLE_TPL_KOKKOS==On

+
+
+
+ +
+
+ +
+ +
+
+ + + + + + + + + \ No newline at end of file diff --git a/docs/generated_docs/concepts_note.html b/docs/generated_docs/concepts_note.html new file mode 100644 index 0000000..bec80de --- /dev/null +++ b/docs/generated_docs/concepts_note.html @@ -0,0 +1,312 @@ + + + + + + + + + pressio-ops concepts: more info - Pressio-Ops-is + + + + + + + + + + + + + + + + + + Contents + + + + + + Menu + + + + + + + + Expand + + + + + + Light mode + + + + + + + + + + + + + + Dark mode + + + + + + + Auto light/dark mode + + + + + + + + + + + + + + + + + + + +
+
+
+ +
+
+
Pressio-Ops-is
 +
+
+
+ +
+ +
+
+ +
+
+
+ + + + + Back to top + +
+
+ +
+ +
+
+
+

pressio-ops concepts: more info#

+

Concept-driven design has been and still is critical in +the development of pressio-ops. Here we describe some fundamental +notions that are at the core of our design approach.

+
+

concept = syntactic constraints + semantics#

+

In pressio-ops, we follow the approach in “Design of Concept Libraries for C++” (2011) +in defining a concept to be a meaningful combination of syntactic requirements + axioms/semantics. +Pure syntax can be fully specified and checked by compilers supporting C++20. +On the contrary, axioms/semantics properties cannot be spelled out and statically checked. +Axioms are, in fact, invariants assumed to hold. In the C++ standard, axioms +and semantics are specified/listed as comments. Here, we adopt a different +approach to present axioms (similar to “Design of Concept Libraries for C++”, 2011)), +that we believe benefits readability: axioms are explicitly listed using +the keyword “axiom”. Note, however, that if you want to compile the concepts below +using a c++20 compiler, you have to comment out all axioms.

+
    +

  • concepts are hard and it will take a few iterations to get meaninngful concepts done

    • +

  • not all components have the same maturity, so this will be reflected in the corresponding concepts too

    • +

  • the documentation of each concept follows the standard: we have syntax plus semantics

    • +
+
+
+

“Satisfying” vs. “modeling” a concept#

+

Quoting the C++ standard: “It is said +that a standard concept is satisfied if its syntactic requirements +are met, and is modeled if it is satisfied and its +semantic requirements (if any) are also met.”

+
+
+ +
+
+
+ +
+ + +
+
+
+
+ Copyright © 2021, National Technology & Engineering Solutions of Sandia, LLC (NTESS) +
+ Made with Sphinx and @pradyunsg's + + Furo +
+ Last updated on Oct 25, 2024
+
+
+
+ +
+
+
+ +
+
+ +
+
+ + + + + + + + + \ No newline at end of file diff --git a/docs/generated_docs/genindex.html b/docs/generated_docs/genindex.html new file mode 100644 index 0000000..4fe36f7 --- /dev/null +++ b/docs/generated_docs/genindex.html @@ -0,0 +1,283 @@ + + + + + + + Index - Pressio-Ops-0.14.0 + + + + + + + + + + + + + + + + + + Contents + + + + + + Menu + + + + + + + + Expand + + + + + + Light mode + + + + + + + + + + + + + + Dark mode + + + + + + + Auto light/dark mode + + + + + + + + + + + + + + + + + + + +
+
+
+ +
+
+
Pressio-Ops-0.14.0
 +
+
+
+ +
+ +
+
+ +
+
+
+ + + + + Back to top + +
+
+ +
+ +
+
+ +
+

Index

+
+
+ +
+
+
+ +
+ + +
+
+
+
+ Copyright © 2021, National Technology & Engineering Solutions of Sandia, LLC (NTESS) +
+ Made with Sphinx and @pradyunsg's + + Furo +
+ Last updated on Oct 25, 2024
+
+
+
+ +
+
+
+ +
+
+ +
+
+ + + + + + + + + \ No newline at end of file diff --git a/docs/generated_docs/index.html b/docs/generated_docs/index.html new file mode 100644 index 0000000..3cb0d70 --- /dev/null +++ b/docs/generated_docs/index.html @@ -0,0 +1,479 @@ + + + + + + + + + Pressio-Ops-0.14.0 + + + + + + + + + + + + + + + + + + Contents + + + + + + Menu + + + + + + + + Expand + + + + + + Light mode + + + + + + + + + + + + + + Dark mode + + + + + + + Auto light/dark mode + + + + + + + + + + + + + + + + + + + +
+
+
+ +
+
+
Pressio-Ops-0.14.0
 +
+
+
+ +
+ +
+
+ +
+
+
+ + + + + Back to top + +
+
+ +
+ +
+
+
+

pressio-ops C++ library#

+

Documentation of the C++ library, one element of the Pressio ecosystem.

+

This work was started with a focus on projection-based reduced-order models (ROMs), +which is a strongly multidisciplinary topic. +Working towards a production-level ROM capability inevitably means spanning +multiple fields ranging from, e.g., linear algebra, nonlinear solvers +and optimization, to time integration, distributed computing and HPC. +This constitutes a substantial challenge to tackle, whose complexity +increases if aiming to develop a generic library.

+

To start such a project from the ground up, grow it and then being +able to maintain it, we believe modularity, abstractions +and well-defined APIs to be fundamental design principles to rely on. +This has been, and still is, at the core of our development effort, +and has lead to a highly modular design of pressio (see table below): +each component (level) of the stack covers a specific capability and depends, +via well-defined public APIs, on the ones below it. This has required (and still does) +a considerable development effort, since each component needs “attention” +and can easily be scoped into an independent, full-time project.

+

So why doing all this rather than adopting a different, simpler approach, for example, +limiting and hiding as implementation some of the supporting functionalities? +Because we believe the current structure/design offers several major benefits +that would be hard—and in some cases impossible—to obtain otherwise: flexibility, +extensibility, maintainability, and usability of each component on its own. +One drawback is that at any point in time, the various components might +have different maturity levels, so reaching a comparable and solid maturity +across the stack might take some time—our current goal is to obtain +in version 1.0.0 a uniform maturity level at least across +the rom, ode and solvers components. Please keep this in mind while browsing +the documentation and the code.

+

Notably, we have extracted the core operations from the Pressio/pressio repository +in order to increase modularity and allow users to build their code directly on top of +pressio-ops if desired.

+

However, it is still useful to consider pressio-ops within the context of pressio +to understand how the repositories fit together.

+

The following components are included in Pressio/pressio and build off of the contents of pressio-ops:

+
+

+
+
+ +++++ + + + + + + + + + + + + + + + + + + + + + + + + +

Description

Header(s)

rom

concepts
(linear) subspaces
Galerkin: steady
Galerkin: unsteady
LSPG: steady
LSPG: unsteady

<pressio/rom_concepts.hpp>
<pressio/rom_subspaces.hpp>
<pressio/rom_galerkin_steady.hpp>
<pressio/rom_galerkin_unsteady.hpp>
<pressio/rom_lspg_steady.hpp>
<pressio/rom_lspg_unsteady.hpp>
<pressio/rom.hpp> includes all

ode

concepts
explicit steppers
implicit steppers
advance_<*> fncs

<pressio/ode_concepts.hpp>
<pressio/ode_steppers_explicit.hpp>
<pressio/ode_steppers_implicit.hpp>
<pressio/ode_advancers.hpp>
<pressio/ode.hpp> includes all

solvers_nonlinear

concepts
Newton method
Gauss-Newton
Lev.-Marq.

<pressio/solvers_nonlinear_concepts.hpp>
<pressio/solvers_nonlinear_newton.hpp>
<pressio/solvers_nonlinear_gaussnewton.hpp>
<pressio/solvers_nonlinear_levmarq.hpp>
<pressio/solvers_nonlinear.hpp> includes all

solvers_linear

linear dense (on-node) solvers

<pressio/solvers_linear.hpp>

+
+

The following components are included in Pressio/pressio-ops and can be used independently of the Pressio/pressio repository:

+
+

+
+
+ +++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

Description

Header(s)

ops

shared-memory/distributed linear algebra kernels specializations

<pressio/ops.hpp>

expressions

expressions templates, e.g.: span, diagonal, subspan

<pressio/expressions.hpp>

type_traits

type traits and detection

<pressio/type_traits.hpp>

utils

logger, constants, etc

<pressio/utils.hpp>

mpl

metaprogramming functionalities

<pressio/mpl.hpp>

+
+
+

Get Started#

+ +
+
+

Generic programming and concepts#

+

Arguably the main foundation of pressio-ops is the use of +generic programming–or, more humbly, we can at least say that it is what we strive for. +Since the early development stages, we have relied on concept-driven design. +Note, that, if you have used or use C++ templates, you have used +concepts knowingly or not. This is because when you write a function or class +template, you have some expectations of what a template needs to expose/do. +C++20 concepts are, in some sense, a way to explicitly formalize those expectations.

+

Until we can stably upgrade to C++20, we cannot by default use C++20 concepts, +so we currently guard the concepts in pressio inside a +preprocessor directive #ifdef PRESSIO_ENABLE_CXX20. This can be enabled by +using a C++20 compliant compiler and setting -DCMAKE_CXX_STANDARD=20 at configure time. +The behavior is as follows:

+
    +

  • if PRESSIO_ENABLE_CXX20 is enabled: concepts are compiled and +enforced stricto sensu on the pressio APIs as discussed by this documentation

    • +

  • if PRESSIO_ENABLE_CXX20 is disabled: this is the default case because the +default pressio C++ standard is currently C++14. In this case, the “C++20 concepts” +are not compiled but the constraints they represent are still valid and implemented +differently such that their enforcement is done via a combination of SFINAE and static asserts.

    • +
+
+

Important

+

Well-defined concepts are hard to design and it takes time. Concepts used in pressio are +still being developed. Some are more mature than others. The approach we adopt is to first +focus on the syntax, then then we will revise them with proper semantics. Keep this in mind +if some concepts seem incomplete.

+
+
+
+

License and Citation#

+

The full license (BSD-3) is available here.

+

Sooner or later we will publish this… in the meantime, you can find on arXiv +an (outdated) preprint at: https://arxiv.org/abs/2003.07798

+
+
+

Questions?#

+

Find us on Slack: https://pressioteam.slack.com or +open an issue on github.

+
+
+
+
+
+
+
+
+ +
+
+ +
+ +
+
+ + + + + + + + + \ No newline at end of file diff --git a/docs/generated_docs/installation.html b/docs/generated_docs/installation.html new file mode 100644 index 0000000..df0fbe9 --- /dev/null +++ b/docs/generated_docs/installation.html @@ -0,0 +1,462 @@ + + + + + + + + + Installation and Dependencies - Pressio-Ops-0.14.0 + + + + + + + + + + + + + + + + + + Contents + + + + + + Menu + + + + + + + + Expand + + + + + + Light mode + + + + + + + + + + + + + + Dark mode + + + + + + + Auto light/dark mode + + + + + + + + + + + + + + + + + + + +
+
+
+ +
+
+
Pressio-Ops-0.14.0
 +
+
+
+ +
+ +
+
+ +
+
+
+ + + + + Back to top + +
+
+ +
+ +
+
+
+

Installation and Dependencies#

+
+

Tip

+

pressio-ops is header-only, so it does not need to be precompiled and linked to. +However, since we use preprocessor directives to conditionally +enable/disable code based on target third-party libraries, +one needs to account for this. See below for the details.

+
+
+

Warning

+

To use pressio-ops, you need at least a C++17 compiler.

+
+
+

Dependencies#

+

Some parts of pressio-ops contain code and implementations +that are specific to third-party libraries (TPLs). +An example is pressio/ops, which contains kernels specializations +for widely-used HPC libraries (e.g. Trilinos, Kokkos). +The main reason for doing this is that we aim, where possible, +to alleviate the user from writing custom operations and allow pressio-ops to decide when and how to leverage +the native libraries’ operations to obtain the best performance. +This should facilitate the integration and use of pressio-ops by existing applications. +This is a growing capability and we currently only +provide built-in support to some external HPC libraries (see below). +Obviously, these TPL-specific specializations need to be guarded with +preprecessor directives, and enabled only if one can access the TPLs.

+

Enabling/disabling specific dependencies can be done via +the cmake variables listed here.

+
+

Optional vs Required#

+
+ +++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

TPL Name

Optional/Required

Version Known to Work/run in CI

Eigen

Required

3.3.7

Trilinos

Optional

commit: ef73d14babf6e7556b0420add98cce257ccaa56b

MPI

Optional

–

Kokkos

Optional

3.1.0

BLAS

Optional

–

LAPACK

Optional

–

GoogleTest

Optional

1.10.0

+
+

Eigen is the only required dependency because it is the +default choice for instantiating the ROM data structures +and solving the (dense) ROM problem.

+
+
+
+

In practice, what are the steps to get, install and use Pressio?#

+

todo: add description for using pressio without configuring, +so one has to define the options directly when configuring +their code or inside the code directly.

+

1. Clone pressio-ops (defaults to the main branch), +or you can pick a release version

+
    +

  1. Create a build and install subdirectories

    2. +
+
cd <where-you-cloned-pressio-ops>
+mkdir build && mkdir install
+
+
+
    +

  1. Use cmake to configure by passing to the comand line the target list of cmake variables to define.

    2. +
+

For example, suppose we want to enable support for Trilinos and the debug prints. We would do:

+
export PRESSIO_SRC=<where-you-cloned-pressio>
+cd <where-you-cloned-pressio-ops>/build
+
+cmake -D CMAKE_INSTALL_PREFIX=../install \
+      -D PRESSIO_ENABLE_TPL_TRILINOS=ON \
+      -D PRESSIO_ENABLE_DEBUG_PRINT=ON \
+      ${PRESSIO_SRC}
+
+make install # nothing is built, just headers copied to installation
+
+
+

Note that this step does not build anything because pressio-ops is header-only, +but only processes the cmake arguments and copies the pressio headers to the +install prefix <where-you-cloned-pressio-ops>/install. +If you want, inspect the file <where-you-cloned-pressio-ops>/install/pressio_ops_cmake_config.h +which contains the cmake variables configuration.

+

We also remark that during the configuration step above pressio-ops +does not need to know where a target TPL exists in your system. +In the configuration step above, you are simply telling Pressio that you have +a certain TPL and want to enable the corresponding code in pressio. +The TPLs will be needed at linking stage when you build your code that uses pressio.

+

4. When building your application to use pressio-ops, you just have to point to +the installation directory <where-you-cloned-pressio-ops>/install with the installed +pressio-ops headers, and you can access all pressio-ops functionalities like so:

+
#include "pressio/what_you_need.hpp"
+// ...
+int main(){
+ // do something
+}
+
+
+
+

Warning

+

The procedure above is advised because it enables pressio-ops +to properly process the cmake options and turn on/off based +on certain conditions (as explained above). +The alternative way to use pressio would be to just clone the repo, +point to the <where-you-cloned-pressio-ops>/include subdirectory +and use cmake variables directly when building your code. +However, this could have unexpected consequences since +you would be resposible to set the variables correctly but you would not +know exactly all the possible constraints.

+
+
+
+ +
+
+ +
+ +
+
+ + + + + + + + + \ No newline at end of file diff --git a/docs/generated_docs/keywords.html b/docs/generated_docs/keywords.html new file mode 100644 index 0000000..6e08f51 --- /dev/null +++ b/docs/generated_docs/keywords.html @@ -0,0 +1,408 @@ + + + + + + + + + CMake Keywords - Pressio-Ops-0.14.0 + + + + + + + + + + + + + + + + + + Contents + + + + + + Menu + + + + + + + + Expand + + + + + + Light mode + + + + + + + + + + + + + + Dark mode + + + + + + + Auto light/dark mode + + + + + + + + + + + + + + + + + + + +
+
+
+ +
+
+
Pressio-Ops-0.14.0
 +
+
+
+ +
+ +
+
+ +
+
+
+ + + + + Back to top + +
+
+ +
+ +
+
+
+

CMake Keywords#

+
+

Important

+

All CMake keywords are prefixed with PRESSIO_ which is case-sensitive.

+

Recall that to set a keyword in CMake you used the syntax -Dkeyword_name.

+
+
+

Third-party Libraries (TPLs)#

+

The following options control enabling TPLs:

+
+ +++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

Variable

Description

Default

PRESSIO_ENABLE_TPL_EIGEN

self-explanatory

ON

PRESSIO_ENABLE_TPL_TRILINOS

self-explanatory

OFF

PRESSIO_ENABLE_TPL_MPI

self-explanatory

OFF automatically ON if PRESSIO_ENABLE_TPL_TRILINOS=ON

PRESSIO_ENABLE_TPL_KOKKOS

self-explanatory

OFF; automatically ON if PRESSIO_ENABLE_TPL_TRILINOS=ON

PRESSIO_ENABLE_TEUCHOS_TIMERS

self-explanatory

OFF automatically ON if PRESSIO_ENABLE_TPL_TRILINOS=ON

+
+

Obviously, the choice of which TPLs to enable is related to +your application’s dependency requirements. +For example, if you have an application that relies on +Trilinos data structures and want to use pressio, +then it makes sense to enable the Trilinos dependency. +On the contrary, if you have an application that relies only on +Eigen data structures, then it makes sense to only leave only Eigen on +and disable the rest.

+

Also, we note that some of the cmake variables listed above are connected +and cannot be turned on individualy. +For example, if we enable Trilinos then pressio automatically +enables also Kokkos, BLAS, LAPACK and MPI.

+
+
+

Other Options#

+
+ +++++ + + + + + + + + + + + + + + + + + + + + +

Variable

Description

Default

PRESSIO_ENABLE_DEBUG_PRINT

to enable debugging print statements

OFF

PRESSIO_ENABLE_CXX17

enables C++17 standard

ON since min standard is 17

PRESSIO_ENABLE_CXX20

enables C++20 standard

OFF; turned on if CMAKE_CXX_STANDARD is set to 20

+
+
+
+ +
+
+ +
+ +
+
+ + + + + + + + + \ No newline at end of file diff --git a/docs/generated_docs/license.html b/docs/generated_docs/license.html new file mode 100644 index 0000000..2159987 --- /dev/null +++ b/docs/generated_docs/license.html @@ -0,0 +1,336 @@ + + + + + + + + + License - Pressio-Ops-0.14.0 + + + + + + + + + + + + + + + + + + Contents + + + + + + Menu + + + + + + + + Expand + + + + + + Light mode + + + + + + + + + + + + + + Dark mode + + + + + + + Auto light/dark mode + + + + + + + + + + + + + + + + + + + +
+
+
+ +
+
+
Pressio-Ops-0.14.0
 +
+
+
+ +
+ +
+
+ +
+
+
+ + + + + Back to top + +
+
+ +
+ +
+
+
+

License#

+
//@HEADER
+// ************************************************************************
+//
+//                              Pressio
+// Copyright 2019 National Technology & Engineering Solutions of Sandia,LLC
+//                              (NTESS)
+//
+// Under the terms of Contract DE-NA0003525 with NTESS, the
+// U.S. Government retains certain rights in this software.
+//
+// Pressio is licensed under BSD-3-Clause terms of use:
+//
+// Redistribution and use in source and binary forms, with or without
+// modification, are permitted provided that the following conditions
+// are met:
+//
+// 1. Redistributions of source code must retain the above copyright
+// notice, this list of conditions and the following disclaimer.
+//
+// 2. Redistributions in binary form must reproduce the above copyright
+// notice, this list of conditions and the following disclaimer in the
+// documentation and/or other materials provided with the distribution.
+//
+// 3. Neither the name of the copyright holder nor the names of its
+// contributors may be used to endorse or promote products derived
+// from this software without specific prior written permission.
+//
+// THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+// "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
+// LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
+// FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE
+// COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,
+// INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
+// (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
+// SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
+// HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
+// STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING
+// IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
+// POSSIBILITY OF SUCH DAMAGE.
+//
+// Questions? Contact Francesco Rizzi (fnrizzi@sandia.gov)
+//
+// ************************************************************************
+//@HEADER
+
+
+
+ +
+
+ +
+ +
+
+ + + + + + + + + \ No newline at end of file diff --git a/docs/generated_docs/mydefs.html b/docs/generated_docs/mydefs.html new file mode 100644 index 0000000..619e26b --- /dev/null +++ b/docs/generated_docs/mydefs.html @@ -0,0 +1,277 @@ + + + + + + + + + <no title> - Pressio-Ops-0.14.0 + + + + + + + + + + + + + + + + + + Contents + + + + + + Menu + + + + + + + + Expand + + + + + + Light mode + + + + + + + + + + + + + + Dark mode + + + + + + + Auto light/dark mode + + + + + + + + + + + + + + + + + + + +
+
+
+ +
+
+
Pressio-Ops-0.14.0
 +
+
+
+ +
+ +
+
+ +
+
+
+ + + + + Back to top + +
+
+ +
+ +
+
+ +
+
+
+ +
+ + +
+
+
+
+ Copyright © 2021, National Technology & Engineering Solutions of Sandia, LLC (NTESS) +
+ Made with Sphinx and @pradyunsg's + + Furo +
+ Last updated on Oct 25, 2024
+
+
+
+ +
+
+
+ +
+
+ +
+
+ + + + + + + + + \ No newline at end of file diff --git a/docs/generated_docs/objects.inv b/docs/generated_docs/objects.inv new file mode 100644 index 0000000000000000000000000000000000000000..44bdaeeba930f13feb2fe8cf8d1743935fbff39d GIT binary patch literal 600 zcmV-e0;l~WAX9K?X>NERX>N99Zgg*Qc_4OWa&u{KZXhxWBOp+6Z)#;@bUGkVa%FRK zX>To0aB~VHAXa5^b7^mGIv@%oAXI2&AaZ4GVQFq;WpW^IW*~HEX>%ZEX>4U6X>%ZB zZ*6dLWpi_7WFU2OX>MmAdTeQ8E(&dWp8HUaP8?^is8vBJ~GY zEKGJ$_!7)E_P;N9aAUkS*^`Hv_kD&BgK)+>3l`%M1|J|sAPAWkJ$lNi|;YP*R0lDOft3 z-`nR@Ax8>Ujw3%cT)9fl6x=wa?9uh}{O90;s=f?)) zzoz^t^YDh{utjlL{0`Sn&|uQwO-1OmYNP>^WMS4acB{zI=Re@+w->+0>U`d&(W?!%AtV-(L{u!u|bfebtXjyZw|+lO0+e zNKu%|vQLRTtU1;N)4Ft1ofuQN^yBEE$G{ct5f%z!EE3%rtg;el4Vs@oXZM^X{m&eB z@3PWjp(wA|A-_0}4-ZVMQ{Z7to`_s)j_HM~t?&7{$3n@iWIw<|YG8$e*uBE|=7OwN zIOoX!_{3j<{VKUmD*-lE&qYa*{5K6c0`md?dBjUvchx2W58_fADMy|^RDb4Y=>7ra{KL2%V + + + + + + Search - Pressio-Ops-0.14.0 + + + + + + + + + + + + + + + + + Contents + + + + + + Menu + + + + + + + + Expand + + + + + + Light mode + + + + + + + + + + + + + + Dark mode + + + + + + + Auto light/dark mode + + + + + + + + + + + + + + + + + + + +
+
+
+ +
+
+
Pressio-Ops-0.14.0
 +
+
+
+ +
+ +
+
+ +
+
+
+ + + + + Back to top + +
+
+ +
+ +
+
+ + + +
+ +
+
+
+ +
+ + +
+
+
+
+ Copyright © 2021, National Technology & Engineering Solutions of Sandia, LLC (NTESS) +
+ Made with Sphinx and @pradyunsg's + + Furo +
+ Last updated on Oct 25, 2024
+
+
+
+ +
+
+
+ +
+
+ +
+
+ + + + + + + + + + + + \ No newline at end of file diff --git a/docs/generated_docs/searchindex.js b/docs/generated_docs/searchindex.js new file mode 100644 index 0000000..02befe9 --- /dev/null +++ b/docs/generated_docs/searchindex.js @@ -0,0 +1 @@ +Search.setIndex({"docnames": ["components/expressions", "components/expressions/diag", "components/expressions/span", "components/expressions/subspan", "components/mpl", "components/ops", "components/ops/abs", "components/ops/add_to_diagonal", "components/ops/clone", "components/ops/deep_copy", "components/ops/dot", "components/ops/elementwise_multiply", "components/ops/extent", "components/ops/fill", "components/ops/matrix_matrix_product", "components/ops/matrix_vector_product", "components/ops/min_max", "components/ops/norms", "components/type_traits", "index", "installation", "keywords", "license", "mydefs"], "filenames": ["components/expressions.rst", "components/expressions/diag.rst", "components/expressions/span.rst", "components/expressions/subspan.rst", "components/mpl.rst", "components/ops.rst", "components/ops/abs.rst", "components/ops/add_to_diagonal.rst", "components/ops/clone.rst", "components/ops/deep_copy.rst", "components/ops/dot.rst", "components/ops/elementwise_multiply.rst", "components/ops/extent.rst", "components/ops/fill.rst", "components/ops/matrix_matrix_product.rst", "components/ops/matrix_vector_product.rst", "components/ops/min_max.rst", "components/ops/norms.rst", "components/type_traits.rst", "index.rst", "installation.rst", "keywords.rst", "license.rst", "mydefs.rst"], "titles": ["expressions", "diagonal", "span", "subspan", "mpl", "ops", "abs", "add_to_diagonal", "clone", "deep_copy", "dot", "elementwise_multiply", "extent", "fill", "matrix-matrix product", "matrix-vector product", "min & max", "norms", "type_traits", "pressio-ops C++ library", "Installation and Dependencies", "CMake Keywords", "License", "<no title>"], "terms": {"defin": [0, 1, 2, 3, 19, 20], "header": [0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 22], "pressio": [0, 1, 2, 3, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 21, 22], "hpp": [0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20], "public": [0, 4, 5, 18, 19], "namespac": [0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18], "we": [0, 18, 19, 20, 21], "refer": 0, "becaus": [0, 5, 19, 20], "each": [0, 3, 5, 6, 7, 13, 15, 19], "function": [0, 4, 18, 19, 20], "doe": [0, 15, 19, 20], "alloc": [0, 8], "new": [0, 8], "memori": [0, 19], "onli": [0, 4, 19, 20, 21], "creat": [0, 8, 20], "an": [0, 1, 2, 3, 4, 6, 8, 9, 10, 11, 12, 13, 15, 18, 19, 20, 21], "instanc": [0, 4, 8], "class": [0, 1, 2, 3, 4, 6, 7, 8, 11, 12, 13, 14, 15, 19], "repres": [0, 1, 2, 3, 19], "given": [0, 4, 5, 16, 17], "oper": [0, 4, 5, 8, 19, 20], "In": [0, 19], "all": [0, 4, 5, 7, 8, 9, 14, 15, 16, 19, 20, 21], "case": [0, 4, 18, 19, 21], "return": [0, 1, 2, 3, 4, 8, 10, 12, 16, 17], "remain": 0, "valid": [0, 19], "until": [0, 19], "its": [0, 19, 22], "operand": [0, 1, 2, 3, 6, 7, 8, 13], "goe": 0, "out": [0, 4, 22], "scope": [0, 19], "If": [0, 4, 7, 15, 20], "state": 0, "undefin": 0, "express": [1, 2, 3, 5, 6, 9, 10, 11, 12, 13, 15, 19, 22], "templat": [1, 2, 3, 4, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19], "t": [1, 2, 3, 4, 5, 7, 8, 9, 11, 12, 13, 14, 15, 16, 17, 18], "impl": [1, 2, 3], "end": [1, 2, 3, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17], "take": [1, 2, 3, 19], "either": [1, 2, 3, 9, 14, 15], "squar": 1, "eigen": [1, 2, 3, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 18, 20, 21], "dens": [1, 3, 18, 19, 20], "matrix": [1, 3, 5, 7, 8, 12, 13, 18], "is_dense_matrix_eigen": [1, 3, 5, 18], "valu": [1, 2, 3, 4, 5, 6, 7, 8, 13, 16, 18], "true": [1, 2, 3, 4, 18], "kokko": [1, 2, 3, 5, 6, 8, 9, 10, 11, 12, 13, 14, 15, 18, 20, 21], "rank": [1, 2, 3, 5, 6, 7, 9, 10, 11, 13, 14, 15, 17, 18], "2": [1, 3, 5, 7, 13, 14, 15, 17, 18, 22], "view": [1, 2, 3, 5, 6, 8, 9, 10, 11, 12, 13, 14, 15, 18], "i": [1, 2, 3, 6, 8, 10, 11, 12, 13, 17, 18], "e": [1, 2, 3, 6, 8, 10, 11, 12, 13, 18, 19, 20], "is_dense_matrix_kokko": [1, 3, 5, 18], "std": [2, 3, 4, 12, 18], "pair": [2, 3], "size_t": [2, 3, 12], "indexrang": 2, "vector": [2, 5, 6, 8, 9, 10, 11, 12, 13, 14, 18], "object": [2, 3, 8, 12, 13, 18], "is_vector_eigen": [2, 5, 18], "1": [2, 5, 6, 10, 11, 13, 15, 17, 18, 19, 20, 22], "is_vector_kokko": [2, 5, 18], "pairidentifi": 2, "interv": [2, 3], "b": [2, 14], "where": [2, 11, 20], "second": 2, "index": [2, 4], "exclus": 2, "target": [2, 20], "rowsrang": 3, "colsrang": 3, "well": [3, 19], "us": [3, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 18, 19, 21, 22], "dimens": [3, 12], "provid": [4, 10, 18, 20, 22], "metaprogram": [4, 19], "need": [4, 18, 19, 20], "support": [4, 5, 15, 18, 19, 20], "gener": [4, 5, 18], "program": [4, 18], "which": [4, 8, 18, 19, 20, 21], "fundament": [4, 19], "build": [4, 19, 20], "block": [4, 5, 6, 8, 9, 10, 11, 12, 13, 14, 15, 18], "librari": [4, 18, 20], "you": [4, 5, 19, 20, 21], "ar": [4, 5, 7, 14, 15, 18, 19, 21, 22], "familiar": 4, "type_trait": [4, 19], "from": [4, 8, 9, 18, 19, 20, 22], "standard": [4, 18, 19, 21], "look": 4, "too": 4, "some": [4, 18, 19, 20, 21], "part": [4, 20], "have": [4, 6, 8, 9, 10, 11, 13, 14, 15, 18, 19, 20, 21], "been": [4, 19], "adapt": 4, "tinympl": 4, "project": [4, 19], "The": [4, 5, 14, 15, 18, 19, 20, 21], "appear": 4, "longer": 4, "maintain": [4, 19], "follow": [4, 5, 8, 12, 14, 15, 18, 19, 21, 22], "partial": [4, 18], "list": [4, 18, 20, 21, 22], "intend": 4, "idea": 4, "featur": [4, 5, 18], "To": [4, 18, 19, 20], "find": [4, 19], "brows": [4, 19], "sourc": [4, 22], "f": 4, "arg": 4, "struct": [4, 18], "determin": [4, 18], "whether": [4, 5, 22], "everi": 4, "element": [4, 6, 7, 9, 11, 13, 19], "sequenc": 4, "satisfi": 4, "predic": 4, "must": [4, 6, 7, 8, 9, 10, 11, 12, 13, 17, 22], "convert": [4, 7, 13], "bool": 4, "static": [4, 18, 19], "member": [4, 18], "constant": [4, 18, 19], "equal": [4, 18], "iff": 4, "otherwis": [4, 10, 15, 19, 22], "fals": 4, "exampl": [4, 8, 18, 19, 20, 21], "pmpl": 4, "static_assert": 4, "is_floating_point": 4, "doubl": 4, "float": 4, "ani": [4, 8, 19, 22], "least": [4, 19, 20], "one": [4, 6, 10, 11, 12, 18, 19, 20], "none": 4, "indextyp": [4, 12], "ha": [4, 7, 8, 12, 19, 20], "subscript": 4, "can": [4, 5, 8, 19, 20], "type": [4, 6, 7, 8, 9, 10, 11, 12, 13, 15, 16, 19], "void": [4, 6, 7, 9, 10, 11, 13, 14, 15, 18], "op": [6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 20], "t1": [6, 7, 9, 10, 11, 13], "t2": [6, 9, 10, 11, 13], "x": [6, 11, 14, 15], "const": [6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17], "y": [6, 11, 15], "comput": [6, 10, 11, 19], "wise": [6, 11], "absolut": 6, "store": [6, 10, 11], "result": [6, 8, 10, 11, 14, 15], "dimension": [6, 10, 11], "contain": [5, 6, 9, 10, 11, 12, 13, 14, 15, 16, 17, 20], "compat": [6, 10, 11], "scalar": [6, 7, 10, 11, 14, 15, 18], "tpetra": [5, 6, 8, 9, 10, 11, 12, 13, 14, 15, 18], "is_vector_tpetra": [5, 18], "is_vector_tpetra_block": [5, 18], "epetra": [5, 6, 8, 9, 10, 11, 12, 13, 14, 15, 18], "is_vector_epetra": [5, 18], "diag": [6, 10, 11, 12, 13], "span": [0, 6, 10, 11, 12, 13, 19], "subspan": [0, 6, 10, 11, 12, 13, 19], "base": [6, 9, 10, 11, 12, 13, 19, 20], "kokkko": [], "scalartyp": [7, 13], "add": [7, 20], "specifi": [7, 12], "diagon": [0, 7, 19], "is_sparse_matrix_eigen": [5, 18], "trait": [7, 13, 19], "scalar_typ": [7, 10, 13, 16, 17, 18], "entri": 7, "written": [7, 22], "alreadi": 7, "exist": [7, 18, 20], "make": [8, 18, 20, 21], "copi": [8, 9, 20], "It": 8, "exact": 8, "independ": [8, 9, 19], "teucho": [5, 8, 12, 13, 15, 16, 18], "is_dense_vector_teucho": [5, 18], "multi": [8, 9, 12, 13, 14, 18], "is_multi_vector_epetra": [5, 18], "is_multi_vector_tpetra": [5, 18], "is_multi_vector_tpetra_block": [5, 18], "thi": [8, 18, 19, 20, 22], "kernel": [8, 19, 20], "complet": 8, "befor": 8, "semant": [8, 19], "even": [8, 22], "default": [8, 19, 20, 21], "like": [8, 18, 20], "tpetrablock": 8, "mean": [8, 19], "let": 8, "auto": 8, "appli": 8, "after": 8, "call": 8, "NOT": [8, 22], "impact": 8, "And": 8, "For": [8, 18, 20, 21], "mv": 8, "implement": [8, 18, 19, 20], "constructor": 8, "data": [8, 18, 20, 21, 22], "shallow": 8, "first": [8, 19], "extent": [5, 8], "ident": 8, "deep": 8, "typenam": [9, 10, 16, 17, 18], "dest": 9, "src": 9, "dst": 9, "so": [9, 18, 19, 20], "fulli": 9, "same": 9, "two": [9, 10], "nativ": [5, 9, 20], "is_native_container_eigen": 5, "is_native_container_kokko": 5, "dotresult": 10, "veca": 10, "vecb": 10, "product": [5, 10, 19, 22], "alpha_t": [11, 14, 15], "beta_t": [11, 14, 15], "alpha": [11, 14, 15], "z": 11, "beta": [11, 14, 15], "denot": 11, "multipl": [11, 14, 15, 19], "objectin": 12, "size": 12, "along": 12, "axi": 12, "overwrit": 13, "A": [14, 15, 22], "a_typ": [14, 15], "x_type": 15, "y_type": 15, "nontranspos": [14, 15], "unus": [14, 15], "construct": [14, 15], "mode": 15, "transpos": [14, 15], "perform": [14, 15, 20], "accord": [14, 15], "indic": [14, 15], "combin": [15, 19], "is_expression_acting_on_eigen": 5, "other": [15, 16, 19, 22], "non": 15, "is_expression_acting_on_kokko": 5, "is_dense_matrix_teucho": [5, 18], "is_expression_column_acting_on_tpetra": 5, "mai": [15, 22], "column": 15, "introspect": 18, "One": [18, 19], "main": [18, 19, 20], "design": [18, 19], "arbitrari": 18, "via": [18, 19, 20], "also": [18, 20, 21], "special": [18, 19, 20, 22], "commonli": 18, "todo": [18, 20], "finish": 18, "most": 18, "import": 18, "thing": 18, "insid": [18, 19, 20], "understand": [18, 19], "purpos": [18, 22], "usag": 18, "pattern": 18, "c": [14, 18, 20, 21], "sever": [18, 19], "resourc": 18, "onlin": 18, "quot": 18, "bjarn": 18, "stroustrup": 18, "think": 18, "small": 18, "whose": [18, 19], "carri": 18, "inform": 18, "anoth": 18, "algorithm": 18, "polici": 18, "detail": [5, 18, 20], "gather": 18, "uniform": [18, 19], "wai": [18, 19, 20, 22], "compil": [18, 19, 20], "time": [18, 19], "enabl": [18, 19, 20, 21], "reason": [18, 20], "about": [5, 18], "kei": 18, "point": [18, 19, 20], "here": [18, 19, 20], "differ": [18, 19], "tpl": [18, 20], "varieti": [5, 18], "name": [18, 20, 22], "convent": 18, "nest": 18, "typedef": 18, "relat": [18, 21], "easi": 18, "access": [18, 20], "similar": 18, "variou": [18, 19], "what": [18, 19], "motiv": 18, "compon": [18, 19], "queri": 18, "current": [18, 19, 20], "few": 18, "trilino": [18, 20, 21], "enable_if_t": 18, "is_dynamic_vector_eigen": 18, "constexpr": 18, "int": [18, 20], "plai": 18, "role": 18, "when": [6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 18, 19, 20], "user": [18, 19, 20], "want": [18, 20, 21], "known": [18, 20], "presso": 18, "do": [18, 19, 20], "shoud": 18, "visibil": 18, "practic": 18, "how": [18, 19, 20], "see": [6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 18, 19, 20], "metafunct": 18, "more": [18, 19], "ad": 18, "continu": 18, "develop": [18, 19], "descript": [18, 19, 20, 21], "is_static_vector_eigen": 18, "requir": [18, 19, 21], "pressio_enable_tpl_eigen": [18, 21], "On": [18, 21], "dynam": 18, "spars": 18, "is_static_dense_matrix_eigen": 18, "is_dynamic_dense_matrix_eigen": 18, "pressio_enable_tpl_trilino": [18, 20, 21], "is_static_vector_kokko": 18, "pressio_enable_tpl_kokko": [18, 21], "is_dynamic_vector_kokko": 18, "is_static_dense_matrix_kokko": 18, "is_dynamic_dense_matrix_kokko": 18, "driven": 19, "still": 19, "critic": [], "describ": [], "notion": [], "core": 19, "our": 19, "approach": 19, "2011": [], "meaning": [], "axiom": [], "pure": [], "syntax": [19, 21], "check": [5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15], "20": [19, 21], "contrari": 21, "properti": [], "cannot": [19, 21], "spell": [], "fact": [], "invari": [], "assum": [], "hold": 5, "comment": [], "adopt": 19, "present": [], "believ": 19, "benefit": 19, "readabl": [], "explicitli": 19, "keyword": [], "note": [19, 20, 21], "howev": [19, 20, 22], "below": [5, 19, 20], "hard": 19, "iter": [], "get": [], "meaninng": [], "done": [19, 20], "matur": 19, "reflect": [], "correspond": 20, "document": [19, 22], "plu": [], "said": [], "met": 22, "ecosystem": 19, "work": [5, 14, 16, 19, 20], "wa": 19, "focu": 19, "reduc": 19, "order": 19, "model": 19, "rom": [19, 20], "strongli": 19, "multidisciplinari": 19, "topic": 19, "toward": 19, "level": 19, "capabl": [19, 20], "inevit": 19, "field": 19, "rang": 19, "g": [19, 20], "linear": 19, "algebra": 19, "nonlinear": 19, "solver": 19, "optim": 19, "integr": [19, 20], "distribut": [19, 22], "hpc": [19, 20], "constitut": 19, "substanti": 19, "challeng": 19, "tackl": 19, "complex": 19, "increas": 19, "aim": [19, 20], "ground": 19, "up": 19, "grow": [19, 20], "being": 19, "abl": 19, "modular": 19, "abstract": 19, "api": 19, "principl": 19, "reli": [19, 21], "effort": 19, "lead": 19, "highli": 19, "tabl": [5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 19], "stack": 19, "cover": 19, "specif": [19, 20, 22], "depend": [19, 21], "ones": 19, "consider": 19, "sinc": [19, 20, 21], "attent": 19, "easili": 19, "full": 19, "why": 19, "rather": 19, "than": [16, 19], "simpler": 19, "limit": [19, 22], "hide": 19, "structur": [19, 20, 21], "offer": 19, "major": 19, "would": [19, 20], "imposs": 19, "obtain": [19, 20], "flexibl": 19, "extens": 19, "usabl": 19, "own": 19, "drawback": 19, "might": 19, "reach": 19, "compar": 19, "solid": 19, "across": 19, "goal": 19, "version": [19, 20], "0": [19, 20], "od": 19, "pleas": 19, "keep": 19, "mind": 19, "while": 19, "code": [19, 20, 22], "notabl": 19, "extract": 19, "repositori": 19, "allow": [19, 20], "directli": [19, 20], "top": 19, "desir": [17, 19], "consid": 19, "within": [5, 19], "context": 19, "fit": [19, 22], "togeth": 19, "includ": [19, 20, 22], "off": [19, 20, 21], "content": 19, "s": [19, 21, 22], "share": 19, "detect": 19, "util": 19, "logger": 19, "etc": 19, "mpl": 19, "instal": 19, "should": [19, 20], "trivial": 19, "arguabl": 19, "foundat": 19, "humbl": 19, "sai": 19, "strive": 19, "earli": 19, "stage": [19, 20], "knowingli": 19, "write": [19, 20], "expect": [5, 19], "expos": 19, "sens": [19, 21], "formal": 19, "those": 19, "stabli": 19, "upgrad": 19, "guard": [19, 20], "preprocessor": [19, 20], "direct": [19, 20, 22], "ifdef": 19, "pressio_enable_cxx20": [19, 21], "compliant": 19, "set": [19, 20, 21], "dcmake_cxx_standard": 19, "configur": [19, 20], "behavior": 19, "enforc": 19, "stricto": 19, "sensu": 19, "discuss": 19, "disabl": [19, 20, 21], "14": 19, "constraint": [19, 20], "thei": 19, "sfina": 19, "assert": 19, "revis": 19, "them": 19, "proper": 19, "seem": 19, "incomplet": 19, "bsd": [19, 22], "3": [19, 20, 22], "avail": 19, "sooner": 19, "later": 19, "publish": 19, "meantim": 19, "arxiv": 19, "outdat": 19, "preprint": 19, "http": 19, "org": 19, "ab": [5, 19], "2003": 19, "07798": 19, "slack": 19, "pressioteam": 19, "com": 19, "open": 19, "issu": 19, "github": 19, "precompil": 20, "link": [5, 20], "condition": 20, "third": 20, "parti": 20, "account": 20, "17": [20, 21], "wide": 20, "possibl": [20, 22], "allevi": 20, "custom": 20, "decid": 20, "leverag": 20, "best": 20, "facilit": 20, "applic": [20, 21], "built": [5, 20], "extern": 20, "obvious": [20, 21], "preprecessor": 20, "cmake": 20, "variabl": [20, 21], "run": 20, "ci": 20, "7": 20, "commit": 20, "ef73d14babf6e7556b0420add98cce257ccaa56b": 20, "mpi": [20, 21], "bla": [20, 21], "lapack": [20, 21], "googletest": 20, "10": 20, "choic": [20, 21], "instanti": 20, "solv": 20, "problem": 20, "without": [20, 22], "clone": [5, 20], "branch": 20, "pick": 20, "releas": 20, "subdirectori": 20, "cd": 20, "mkdir": 20, "pass": 20, "comand": 20, "line": 20, "suppos": 20, "debug": [20, 21], "print": [20, 21], "export": 20, "pressio_src": 20, "d": 20, "cmake_install_prefix": 20, "ON": [20, 21, 22], "pressio_enable_debug_print": [20, 21], "noth": 20, "just": 20, "anyth": 20, "process": 20, "argument": 20, "prefix": [20, 21], "inspect": 20, "file": 20, "pressio_ops_cmake_config": 20, "h": 20, "remark": 20, "dure": 20, "abov": [20, 21, 22], "know": 20, "your": [20, 21], "system": 20, "simpli": 20, "tell": 20, "certain": [20, 22], "4": 20, "directori": [5, 20], "what_you_ne": 20, "someth": 20, "procedur": 20, "advis": [20, 22], "properli": 20, "turn": [20, 21], "condit": [20, 22], "explain": 20, "altern": 20, "repo": 20, "could": 20, "unexpect": 20, "consequ": 20, "respos": 20, "correctli": 20, "exactli": 20, "pressio_": 21, "sensit": 21, "recal": 21, "dkeyword_nam": 21, "control": 21, "self": 21, "explanatori": 21, "pressio_enable_tpl_mpi": 21, "automat": 21, "pressio_enable_teuchos_tim": 21, "leav": 21, "rest": 21, "connect": 21, "individuali": 21, "statement": 21, "pressio_enable_cxx17": 21, "min": [5, 21], "cmake_cxx_standard": 21, "copyright": 22, "2019": 22, "nation": 22, "technolog": 22, "engin": 22, "solut": 22, "sandia": 22, "llc": 22, "ntess": 22, "under": 22, "term": 22, "contract": 22, "de": 22, "na0003525": 22, "u": 22, "govern": 22, "retain": 22, "right": 22, "softwar": 22, "claus": 22, "redistribut": 22, "binari": 22, "form": 22, "modif": 22, "permit": 22, "notic": 22, "disclaim": 22, "reproduc": 22, "materi": 22, "neither": 22, "holder": 22, "nor": 22, "contributor": 22, "endors": 22, "promot": 22, "deriv": 22, "prior": 22, "permiss": 22, "IS": 22, "BY": 22, "THE": 22, "AND": 22, "AS": 22, "OR": 22, "impli": 22, "warranti": 22, "BUT": 22, "TO": 22, "OF": 22, "merchant": 22, "FOR": 22, "particular": 22, "IN": 22, "NO": 22, "event": 22, "shall": 22, "BE": 22, "liabl": 22, "indirect": 22, "incident": 22, "exemplari": 22, "consequenti": 22, "damag": 22, "procur": 22, "substitut": 22, "good": 22, "servic": 22, "loss": 22, "profit": 22, "busi": 22, "interrupt": 22, "caus": 22, "theori": 22, "liabil": 22, "strict": 22, "tort": 22, "neglig": 22, "aris": 22, "IF": 22, "SUCH": 22, "question": 22, "contact": 22, "francesco": 22, "rizzi": 22, "fnrizzi": 22, "gov": 22, "subspac": 19, "galerkin": 19, "steadi": 19, "unsteadi": 19, "lspg": 19, "rom_concept": 19, "rom_subspac": 19, "rom_galerkin_steadi": 19, "rom_galerkin_unsteadi": 19, "rom_lspg_steadi": 19, "rom_lspg_unsteadi": 19, "explicit": 19, "stepper": 19, "implicit": 19, "advance_": 19, "fnc": 19, "ode_concept": 19, "ode_steppers_explicit": 19, "ode_steppers_implicit": 19, "ode_advanc": 19, "solvers_nonlinear": 19, "newton": 19, "method": 19, "gauss": 19, "lev": 19, "marq": 19, "solvers_nonlinear_concept": 19, "solvers_nonlinear_newton": 19, "solvers_nonlinear_gaussnewton": 19, "solvers_nonlinear_levmarq": 19, "solvers_linear": 19, "node": 19, "add_to_diagon": 5, "deep_copi": 5, "dot": 5, "elementwise_multipli": 5, "fill": 5, "backend": 5, "both": 5, "throughout": 5, "confirm": 5, "is_matrix_eigen": [], "is_sparse_matrix_kokko": 5, "addition": 5, "checker": [], "navig": [], "boolean": [5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15], "homepag": [6, 7, 8, 9, 10, 11, 12, 13, 14, 15], "correct": [6, 7, 8, 9, 10, 11, 12, 13, 14, 15], "b_type": 14, "c_type": 14, "modea": 14, "modeb": 14, "matric": 14, "max": 5, "obj": 16, "maximum": 16, "minimum": 16, "arrai": 16, "l1": 17, "_1": 17, "sum_": 17, "a_i": 17, "norm": 5, "norm1": 17, "l2": 17, "norm2": 17, "mathbf": 17, "_2": 17, "sqrt": 17, "n": 17}, "objects": {}, "objtypes": {}, "objnames": {}, "titleterms": {"express": 0, "diagon": 1, "api": [1, 2, 3, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17], "descript": [1, 2, 3, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17], "span": 2, "subspan": 3, "mpl": 4, "scope": [4, 18], "pressio": [4, 19, 20], "all_of": 4, "any_of": 4, "none_of": 4, "is_subscriptable_a": 4, "op": [5, 19], "ab": 6, "add_to_diagon": 7, "note": [6, 7, 8, 9, 10, 11, 12, 13, 14, 15], "clone": 8, "deep_copi": 9, "dot": 10, "elementwise_multipli": 11, "extent": 12, "fill": 13, "product": [14, 15], "type_trait": 18, "trait": 18, "class": 18, "type": [5, 14, 18], "detect": 18, "identif": 18, "concept": 19, "more": [], "info": [], "syntact": [], "constraint": [], "semant": [], "satisfi": [], "vs": 20, "model": [], "c": 19, "librari": [19, 21], "get": [19, 20], "start": 19, "gener": 19, "program": 19, "licens": [19, 22], "citat": 19, "question": 19, "instal": 20, "depend": 20, "option": [20, 21], "requir": 20, "In": 20, "practic": 20, "what": 20, "ar": 20, "step": 20, "us": 20, "cmake": 21, "keyword": 21, "third": 21, "parti": 21, "tpl": 21, "other": 21, "navig": 5, "matrix": [14, 15], "vector": 15, "min": 16, "max": 16, "norm": 17}, "envversion": {"sphinx.domains.c": 2, "sphinx.domains.changeset": 1, "sphinx.domains.citation": 1, "sphinx.domains.cpp": 6, "sphinx.domains.index": 1, "sphinx.domains.javascript": 2, "sphinx.domains.math": 2, "sphinx.domains.python": 3, "sphinx.domains.rst": 2, "sphinx.domains.std": 2, "sphinx.ext.viewcode": 1, "sphinx.ext.intersphinx": 1, "sphinx": 56}}) \ No newline at end of file diff --git a/docs/source/components/expressions.rst b/docs/source/components/expressions.rst index d8a62ed..4a298f3 100644 --- a/docs/source/components/expressions.rst +++ b/docs/source/components/expressions.rst @@ -5,11 +5,15 @@ Defined in header: ```` Public namespace: ``pressio`` +We refer to these as expressions because each function does not allocate +new memory but only creates an instance of a class that "represents" the given operation. -.. - .. toctree:: - :maxdepth: 1 +In all cases, the returned expression remains valid until its operand goes out of scope. +If the operand goes out of scope, the state of the expression is undefined. - expressions/span - expressions/subspan - expressions/diag +.. toctree:: + :maxdepth: 1 + + expressions/span + expressions/subspan + expressions/diag diff --git a/docs/source/components/expressions/diag.rst b/docs/source/components/expressions/diag.rst index 601f50d..0477c2f 100644 --- a/docs/source/components/expressions/diag.rst +++ b/docs/source/components/expressions/diag.rst @@ -17,47 +17,13 @@ API } // end namespace pressio -Parameters ----------- +Description +----------- -* ``operand``: the object whose diagonal we want to view +* Takes in an ``operand`` that is either: -Constraints -~~~~~~~~~~~ + * a square Eigen dense matrix, ``pressio::is_dense_matrix_eigen::value == true`` -- ``T`` must be: + * a square Kokkos rank-2 view, i.e. ``pressio::is_dense_matrix_kokkos::value == true`` - - an Eigen dense matrix, ``pressio::is_dense_matrix_eigen::value == true`` - - - or a Kokkos rank-2 view, i.e. ``pressio::is_dense_matrix_kokkos::value == true`` - -Preconditions -~~~~~~~~~~~~~ - -- ``operand`` must be a square matrix - -Mandates -~~~~~~~~ - -:red:`finish` - - -Return value -~~~~~~~~~~~~ - -None - -Effects -~~~~~~~ - -Returns an expression object that represents the "diagonal" of ``operand``. -We refer to this as an expression because the ``diag`` function does not allocate -new memory or copy any data, but only creates an instance of a -class that "represents the diagonal". - -Postconditions -~~~~~~~~~~~~~~ - -The returned object is valid to use until the operand goes out of scope. - -:red:`finish` +* Returns an expression that represents that diagonal of ``operand`` diff --git a/docs/source/components/expressions/span.rst b/docs/source/components/expressions/span.rst index 56cbb73..7ba84c3 100644 --- a/docs/source/components/expressions/span.rst +++ b/docs/source/components/expressions/span.rst @@ -14,55 +14,23 @@ API template /*impl defined*/ span(T & operand, - std::pair indexRange)); + std::pair indexRange); } // end namespace pressio -Parameters ----------- +Description +----------- -* ``operand``: the object to construct a span of +* Takes in an ``operand`` and an ``indexRange`` -* ``indexRange``: a std::pair identifying an interval ``[a, b)`` where the second index is exclusive + * ``operand`` is either: -Constraints -~~~~~~~~~~~ + * an Eigen vector object: ``pressio::is_vector_eigen::value == true`` -- ``T`` must be: + * a Kokkos rank-1 view, i.e. ``pressio::is_vector_kokkos::value == true`` - - an Eigen vector object: ``pressio::is_vector_eigen::value == true`` + * ``indexRange`` is a std::pairidentifying an interval ``[a, b)`` where the second index is exclusive - - or a Kokkos rank-1 view, i.e. ``pressio::is_vector_kokkos::value == true`` +* Returns an expression that represents the target span of the ``operand``. -Preconditions -~~~~~~~~~~~~~ - -:red:`finish` - -Mandates -~~~~~~~~ - -:red:`finish` - - -Return value -~~~~~~~~~~~~ - -None - -Effects -~~~~~~~ - -Returns an expression object that represents a target span of the ``operand``. -We refer to this as an expression because the span function does not allocate -new memory but only creates an instance of a class that "represents the span operation". - -Postconditions -~~~~~~~~~~~~~~ - -The returned span object remains valid to use until the operand goes out of scope. -If the operand goes out of scope but you still have a span object, the state of the span -object is undefined. - -:red:`finish` diff --git a/docs/source/components/expressions/subspan.rst b/docs/source/components/expressions/subspan.rst index 4ad9c0d..a01c844 100644 --- a/docs/source/components/expressions/subspan.rst +++ b/docs/source/components/expressions/subspan.rst @@ -15,57 +15,19 @@ API template /*impl defined*/ subspan(T & operand, std::pair rowsRange, - std::pair colsRange)); + std::pair colsRange); } // end namespace pressio -Parameters ----------- +Description +----------- -* ``operand``: the object to construct a subspan of +* Takes in an ``operand``, as well as the ``rowsRange`` and ``colsRange`` intervals that will be used in each dimension -* ``rowsRange``: identifies the rows interval to use (the second index is exclusive) + * ``operand`` is either: -* ``colsRange``: identifies the cols interval to use (the second index is exclusive) + * an Eigen dense matrix, ``pressio::is_dense_matrix_eigen::value == true`` -Constraints -~~~~~~~~~~~ + * a Kokkos rank-2 view, i.e. ``pressio::is_dense_matrix_kokkos::value == true`` -- ``T`` must be: - - - an Eigen dense matrix, ``pressio::is_dense_matrix_eigen::value == true`` - - - or a Kokkos rank-2 view, i.e. ``pressio::is_dense_matrix_kokkos::value == true`` - -Preconditions -~~~~~~~~~~~~~ - -:red:`finish` - -Mandates -~~~~~~~~ - -:red:`finish` - - -Return value -~~~~~~~~~~~~ - -None - -Effects -~~~~~~~ - -Returns an expression object that represents a subspan of the ``operand``. -We refer to this as an expression because the subspan function does not allocate -new memory or copy data, but only creates an instance of a -class that "represents the subspan operation". - -Postconditions -~~~~~~~~~~~~~~ - -The returned object is valid to use until the operand goes out of scope. -If the operand goes out of scope but you still have a subspan object, -the state of the subspan object is undefined. - -:red:`finish` +* Returns an expression object that represents a subspan of the ``operand``. diff --git a/docs/source/components/ops.rst b/docs/source/components/ops.rst index 76c4b0d..b105021 100644 --- a/docs/source/components/ops.rst +++ b/docs/source/components/ops.rst @@ -8,5 +8,89 @@ Header: ```` Public namespace: ``pressio::ops`` +Pressio operations are generalized to work on a variety of container types and backends. -:red:`finish` +Types +----- + +The following table holds both the types supported throughout the ``ops`` directory and the +built-in booleans that confirm if a given type ``T`` is the expected type. + +All expressions are within the ``pressio`` namespace. + +.. list-table:: + :widths: 10 20 20 + :header-rows: 1 + :align: left + + * - Container Type + - Rank-1 Check + - Rank-2 Check + + * - Eigen + - ``is_vector_eigen::value`` + - ``is_sparse_matrix_eigen::value``, ``is_dense_matrix_eigen::value`` + + * - Kokkos + - ``is_vector_kokkos::value`` + - ``is_dense_matrix_kokkos::value``, ``is_sparse_matrix_kokkos::value`` + + * - Epetra + - ``is_vector_epetra::value`` + - ``is_multi_vector_epetra::value`` + + * - Tpetra + - ``is_vector_tpetra::value`` + - ``is_multi_vector_tpetra::value`` + + * - Tpetra Block + - ``is_vector_tpetra_block::value`` + - ``is_multi_vector_tpetra_block::value`` + + * - Teuchos + - ``is_dense_vector_teuchos::value`` + - ``is_dense_matrix_teuchos::value`` + +Additionally, because Pressio features expressions for containers built on Eigen, Kokkos, and Tpetra, you can check whether or not a container is native with: + +.. list-table:: + :widths: 10 20 20 + :header-rows: 1 + :align: left + + * - Container Type + - Native + - Pressio Expression + + * - Eigen + - ``is_native_container_eigen::value`` + - ``is_expression_acting_on_eigen::value`` + + * - Kokkos + - ``is_native_container_kokkos::value`` + - ``is_expression_acting_on_kokkos::value`` + + * - Tpetra + - + - ``is_expression_column_acting_on_tpetra::value`` + +Navigation +---------- + +Use the links below to view details about each operation. + +.. toctree:: + :maxdepth: 1 + + ops/abs + ops/add_to_diagonal + ops/clone + ops/deep_copy + ops/dot + ops/elementwise_multiply + ops/extent + ops/fill + ops/matrix_vector_product + ops/matrix_matrix_product + ops/min_max + ops/norms diff --git a/docs/source/components/ops/abs.rst b/docs/source/components/ops/abs.rst new file mode 100644 index 0000000..c7767ae --- /dev/null +++ b/docs/source/components/ops/abs.rst @@ -0,0 +1,44 @@ +.. include:: ../../mydefs.rst + +``abs`` +======= + +Header: ```` + +API +--- + +.. code-block:: cpp + + namespace pressio { namespace ops{ + + template + void abs(T1 & x, const T2 & y); + + }} // end namespace pressio::ops + +Description +----------- + +* Computes the element-wise absolute value of each element + in the operand x and stores the result in y. + +* ``T1`` and ``T2`` must be one-dimensional containers with compatible scalar types: + + * an Eigen vector + + * a Kokkos rank-1 view + + * a Tpetra vector + + * a Tpetra block vector + + * a Epetra vector + + * a Pressio expression, i.e. ``pressio::diag``, ``pressio::span``, ``pressio::subspan``, based on Eigen or Kokkos container + +Notes +----- + +* See the :doc:`ops homepage <../ops>` for a table of booleans to use when checking that ``T1`` and ``T2`` have the correct types. + diff --git a/docs/source/components/ops/add_to_diagonal.rst b/docs/source/components/ops/add_to_diagonal.rst new file mode 100644 index 0000000..dbdfcb2 --- /dev/null +++ b/docs/source/components/ops/add_to_diagonal.rst @@ -0,0 +1,34 @@ +.. include:: ../../mydefs.rst + +``add_to_diagonal`` +=================== + +Header: ```` + +API +--- + +.. code-block:: cpp + + namespace pressio { namespace ops{ + + template + void add_to_diagonal(T1 & operand, const ScalarType & value); + + }} // end namespace pressio::ops + +Description +----------- + +* Adds the specified scalar ``value`` to each diagonal element of ``operand`` + +* ``T`` must be a rank-2 Eigen matrix + +* ``ScalarType`` must be convertible to ``pressio::Traits::scalar_type`` + +Notes +----- + +* If the diagonal entries of ``operand`` are written, then all diagonal entries must already exist. + +* See the :doc:`ops homepage <../ops>` for a table of booleans to use when checking that ``T1`` has the correct type. diff --git a/docs/source/components/ops/clone.rst b/docs/source/components/ops/clone.rst index 65da376..5dcbd86 100644 --- a/docs/source/components/ops/clone.rst +++ b/docs/source/components/ops/clone.rst @@ -20,47 +20,34 @@ API }} // end namespace pressio::ops -Parameters ----------- +Description +----------- -* ``operand``: the object to clone +* Creates and returns a new instance of :cpp:`T` by making a new allocation + and *copying* all values from :cpp:`operand` into it. -Constraints -~~~~~~~~~~~ + * It is an exact but independent clone of :cpp:`operand`. -- ``T`` must be: +* ``T`` must be: - - an Eigen vector or matrix object: - ``pressio::is_vector_eigen::value || pressio::is_dense_matrix_eigen::value || - pressio::is_sparse_matrix_eigen::value`` + * an Eigen vector or matrix object - - or a Kokkos rank-1 or rank-2 view: ``pressio::is_vector_kokkos::value || - pressio::is_dense_matrix_kokkos::value`` + * a Kokkos view - - or an epetra vector or multi-vector: ``pressio::is_vector_epetra::value || - pressio::is_multi_vector_epetra::value`` + * a Teuchos vector - - or a tpetra vector or multi-vector: ``pressio::is_vector_tpetra::value || - pressio::is_multi_vector_tpetra::value`` + * or an Epetra vector or multi-vector - - or a tpetra block vector or multi-vector: ``pressio::is_vector_tpetra_block::value || - pressio::is_multi_vector_tpetra_block::value`` + * or a Tpetra vector or multi-vector -Preconditions -~~~~~~~~~~~~~ + * or a Tpetra block vector or multi-vector -None - -Return value, Effects, and Postconditions -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -- Creates and returns a new instance of :cpp:`T` by making a new allocation - and *copying* all values from :cpp:`operand` into it. So it is an exact - but independent clone of :cpp:`operand`. +Notes +----- -- This is a blocking operation, i.e. the kernel completes before returning. +* This is a blocking operation, i.e. the kernel completes before returning. -- This kernel has value semantics, even for types that, by default, +* This kernel has value semantics, even for types that, by default, have view semantics like Kokkos, Tpetra or TpetraBlock. This means the following: let :cpp:`auto result = clone(operand)`, then any operation applied @@ -68,13 +55,12 @@ Return value, Effects, and Postconditions have any impact on ``result``. And any operation applied to ``result`` will not have any impact on ``operand``. -Notes -~~~~~ - -- For types that have value semantics, for example ``Eigen::Matrix<...>``, +* For types that have value semantics, for example ``Eigen::Matrix<...>``, Epetra vector or MV, this kernel can be implemented by calling the copy constructor and returning the copy -- For Kokkos, Tpetra, or TpetraBlock data types, which by default have view semantics +* For Kokkos, Tpetra, or TpetraBlock data types, which by default have view semantics (i.e. a copy is a shallow copy), the operation can be implemented by first making a new object with extents identical to ``operand``, followed by a deep copy, and then return the result. + +* See the :doc:`ops homepage <../ops>` for a table of booleans to use when checking that ``T`` has the correct type. diff --git a/docs/source/components/ops/deep_copy.rst b/docs/source/components/ops/deep_copy.rst new file mode 100644 index 0000000..40481b8 --- /dev/null +++ b/docs/source/components/ops/deep_copy.rst @@ -0,0 +1,46 @@ +.. include:: ../../mydefs.rst + +``deep_copy`` +============= + +Header: ```` + +API +--- + +.. code-block:: cpp + + namespace pressio { namespace ops{ + + template + void deep_copy(T2 & dest, const T1 & src); + + template + void deep_copy(T & dest, const T & src); + + }} // end namespace pressio::ops + +Description +----------- + +* Copies all elements from ``src`` into ``dst``, so that ``dst`` is fully independent of ``src``. + +* ``T1`` and ``T2`` must have the same rank, and must be: + + * Two Eigen-based containers (either a native Eigen container or a Pressio expression based on an Eigen container) + + * Two Kokkos-based containers (either a native Kokkos view or a Pressio expression based on a Kokkos container) + +* ``T`` must be: + + * a Tpetra vector or multi-vector + + * a Tpetra block vector or multi-vector + + * a Epetra vector or multi-vector + +Notes +----- + +* See the :doc:`ops homepage <../ops>` for a table of booleans to use when checking that ``T``, ``T1``, and ``T2`` have the correct types. + diff --git a/docs/source/components/ops/dot.rst b/docs/source/components/ops/dot.rst new file mode 100644 index 0000000..d6902c6 --- /dev/null +++ b/docs/source/components/ops/dot.rst @@ -0,0 +1,47 @@ +.. include:: ../../mydefs.rst + +``dot`` +======= + +Header: ```` + +API +--- + +.. code-block:: cpp + + namespace pressio { namespace ops{ + + template + void dot(const T1 & vecA, const T2 & vecB, DotResult & result); + + template + scalar_type dot(const T1 & vecA, const T2 & vecB); + + }} // end namespace pressio::ops + +Description +----------- + +* Computes the dot product of two compatible vectors (``vecA`` and ``vecB``) + + * Stores the result in ``result`` if provided; otherwise, returns the result + +* ``T1`` and ``T2`` must be one-dimensional containers with compatible scalar types: + + * an Eigen vector + + * a Kokkos rank-1 view + + * a Tpetra vector + + * a Tpetra block vector + + * a Epetra vector + + * a pressio expression, i.e. ``pressio::diag``, ``pressio::span``, ``pressio::subspan``, based on Eigen or Kokkos container + +Notes +----- + +* See the :doc:`ops homepage <../ops>` for a table of booleans to use when checking that ``T1`` and ``T2`` have the correct types. diff --git a/docs/source/components/ops/elementwise_multiply.rst b/docs/source/components/ops/elementwise_multiply.rst new file mode 100644 index 0000000..7c35179 --- /dev/null +++ b/docs/source/components/ops/elementwise_multiply.rst @@ -0,0 +1,48 @@ +.. include:: ../../mydefs.rst + +``elementwise_multiply`` +======================== + +Header: ```` + +API +--- + +.. code-block:: cpp + + namespace pressio { namespace ops{ + + template + void elementwise_multiply( + const alpha_t & alpha, + const T & x, + const T1 & z, + const beta_t & beta, + T2 & y + ); + + }} // end namespace pressio::ops + +Description +----------- + +* Computes ``y = beta * y + alpha * (x ⊙ z)``, where ``⊙`` denotes element-wise multiplication, and stores the result in y + +* ``T``, ``T1``, and ``T2`` must be one-dimensional containers with compatible scalar types: + + * an Eigen vector + + * a Kokkos rank-1 view + + * a Tpetra vector + + * a Tpetra block vector + + * a Epetra vector + + * a pressio expression, i.e. ``pressio::diag``, ``pressio::span``, ``pressio::subspan``, based on Eigen or Kokkos container + +Notes +----- + +* See the :doc:`ops homepage <../ops>` for a table of booleans to use when checking that ``T``, ``T1``, and ``T2`` have the correct types. diff --git a/docs/source/components/ops/extent.rst b/docs/source/components/ops/extent.rst new file mode 100644 index 0000000..3d65644 --- /dev/null +++ b/docs/source/components/ops/extent.rst @@ -0,0 +1,44 @@ +.. include:: ../../mydefs.rst + +``extent`` +========== + +Header: ```` + +API +--- + +.. code-block:: cpp + + namespace pressio { namespace ops{ + + template + std::size_t extent(const T & objectIn, const IndexType i); + + }} // end namespace pressio::ops + +Description +----------- + +* Returns the size or dimension of a container ``objectIn`` along a specified axis ``i`` + +* ``T`` must be one of the following: + + * an Eigen vector or matrix object + + * a Kokkos view + + * a Teuchos vector + + * a Tpetra vector or multi-vector + + * a Tpetra block vector or multi-vector + + * a Epetra vector or multi-vector + + * a pressio expression, i.e. ``pressio::diag``, ``pressio::span``, ``pressio::subspan``, based on an Eigen, Tpetra Block, or Kokkos container + +Notes +----- + +* See the :doc:`ops homepage <../ops>` for a table of booleans to use when checking that ``T`` has the correct type. diff --git a/docs/source/components/ops/fill.rst b/docs/source/components/ops/fill.rst index 749ebdb..79a17a9 100644 --- a/docs/source/components/ops/fill.rst +++ b/docs/source/components/ops/fill.rst @@ -17,50 +17,30 @@ API }} // end namespace pressio::ops -Parameters ----------- +Description +----------- -* ``operand``: the object to fill +* Overwrites each element of ``operand`` with ``value``. -* ``value``: value to use to fill +* ``T`` must be: -Constraints -~~~~~~~~~~~ + * an Eigen vector or matrix object -- ``T`` must be: + * a Kokkos rank-1 or rank-2 view - - an Eigen vector or matrix object, i.e. one of the following is - true ``pressio::is_vector_eigen::value``, ``pressio::is_dense_matrix_eigen::value``, - ``pressio::is_sparse_matrix_eigen::value`` or + * a Teuchos vector - - a Kokkos rank-1 or rank-2 view, i.e. ``pressio::is_vector_kokkos::value``, ``pressio::is_dense_matrix_kokkos::value`` or + * a Tpetra vector or multi-vector - - a Tpetra vector or multi-vector, i.e. ``pressio::is_vector_tpetra::value``, ``pressio::is_multi_vector_tpetra::value`` or + * a Tpetra block vector or multi-vector - - a Tpetra block vector or multi-vector, i.e. ``pressio::is_vector_tpetra_block::value``, ``pressio::is_multi_vector_tpetra_block::value`` or + * a Epetra vector or multi-vector - - a Epetra vector or multi-vector, i.e. ``pressio::is_vector_epetra::value``, ``pressio::is_multi_vector_epetra::value`` or + * a pressio expression, i.e. ``pressio::diag``, ``pressio::span``, ``pressio::subspan``, based on an Eigen or Kokkos container - - a pressio expression, i.e. ``pressio::diag``, ``pressio::span``, ``pressio::subspan``, based on Eigen or Kokkkos container +* ``ScalarType`` must be convertible to ``pressio::Traits::scalar_type`` -- ``ScalarType`` must be convertible to ``pressio::Traits::scalar_type`` +Notes +----- -Preconditions -~~~~~~~~~~~~~ - -None - -Return value -~~~~~~~~~~~~ - -None - -Effects -~~~~~~~ - -Overwrites each element of ``operand`` with ``value``. - -Postconditions -~~~~~~~~~~~~~~ - -Each element of ``operand`` is equal to ``value``. +* See the :doc:`ops homepage <../ops>` for a table of booleans to use when checking that ``T1`` and ``T2`` have the correct types. diff --git a/docs/source/components/ops/matrix_matrix_product.rst b/docs/source/components/ops/matrix_matrix_product.rst new file mode 100644 index 0000000..b300c55 --- /dev/null +++ b/docs/source/components/ops/matrix_matrix_product.rst @@ -0,0 +1,88 @@ +.. include:: ../../mydefs.rst + +``matrix-matrix product`` +========================= + +Header: ```` + +API +--- + +.. code-block:: cpp + + namespace pressio { namespace ops{ + + // op(A) = A^T and op(B) = B + template < + class A_type, class B_type, class C_type, + class alpha_t, class beta_t + > + void product(::pressio::transpose /*unused*/, + ::pressio::nontranspose /*unused*/, + const alpha_t & alpha, + const A_type & A, + const B_type & B, + const beta_t & beta, + C_type & C); + + // op(A) = A and op(B) = B + template < + class A_type, class B_type, class C_type, + class alpha_t, class beta_t + > + void product(::pressio::nontranspose /*unused*/, + ::pressio::nontranspose /*unused*/, + const alpha_t & alpha, + const A_type & A, + const B_type & B, + const beta_t & beta, + C_type & C); + + // A == B and op(A) = A^T + template + void product(::pressio::transpose /*unused*/, + ::pressio::nontranspose /*unused*/, + const alpha_t & alpha, + const A_type & A, + const beta_t & beta, + C_type & C); + + // Construct result + template + C_type product(::pressio::transpose modeA, + ::pressio::nontranspose modeB, + const alpha_t & alpha, + const A_type & A); + + }} // end namespace pressio::ops + +Description +----------- + +* Performs matrix-vector multiplication according to ``C = beta * C + alpha * op(A) * op(B)`` + + * ``op(X)`` indicates either ``X`` or ``X^T`` + +* ``alpha_t`` and ``beta_t`` are scalar types + +* ``A_type``, ``B_type``, and ``C_type`` are rank-2 containers + +Types +----- + +The matrix-matrix product works for the following matrix types: + +* Eigen (all containers are rank-2 Eigen matrices) + +* Epetra (``A`` and ``B`` are Epetra multi-vectors; ``C`` is a rank-2 Eigen matrix) + +* Kokkos (all containers are rank-2 Kokkos views) + +* Tpetra (``A`` and ``B`` are Tpetra multi-vectors; ``C`` is either a rank-2 Eigen matrix or a rank-2 Kokkos view) + +* Tpetra Block (``A`` and ``B`` are Tpetra Block multi-vectors; ``C`` is either a rank-2 Eigen matrix or a rank-2 Kokkos view) + +Notes +----- + +* See the :doc:`ops homepage <../ops>` for a table of booleans to use when checking that ``A``, ``B``, and ``C``` have the correct types. diff --git a/docs/source/components/ops/matrix_vector_product.rst b/docs/source/components/ops/matrix_vector_product.rst new file mode 100644 index 0000000..9e0a639 --- /dev/null +++ b/docs/source/components/ops/matrix_vector_product.rst @@ -0,0 +1,112 @@ +.. include:: ../../mydefs.rst + +``matrix-vector product`` +========================= + +Header: ```` + +API +--- + +.. code-block:: cpp + + namespace pressio { namespace ops{ + + // op(A) = A + template < + class A_type, class x_type, class y_type, + class alpha_t, class beta_t + > + void product(::pressio::nontranspose /*unused*/, + const alpha_t & alpha, + const A_type & A, + const x_type & x, + const beta_t & beta, + y_type & y); + + // op(A) = A , construct result + template < + class y_type, class A_type, class x_type, class alpha_t + > + y_type product(::pressio::nontranspose mode, + const alpha_t & alpha, + const A_type & A, + const x_type & x); + + // op(A) = A^T + template < + class y_type, class A_type, class x_type, class alpha_t + > + void product(::pressio::transpose /*unused*/, + const alpha_t & alpha, + const A_type & A, + const x_type & x, + const beta_t & beta, + y_type & y); + + // op(A) = A^T , construct result + template + y_type product(::pressio::transpose mode, + const alpha_t & alpha, + const A_type & A, + const x_type & x); + + }} // end namespace pressio::ops + +Description +----------- + +* Performs matrix-vector multiplication according to ``y = beta * y + alpha * op(A) * x`` + * ``op(A)`` indicates either ``A`` or ``A^T`` + +* ``alpha_t`` and ``beta_t`` are scalar types + +* ``x_type`` and ``y_type`` are rank-1 containers + +* ``A_type`` is a rank-2 container + +* The following combinations of container types are supported for each ``A_type``: + + * Eigen + + * All container types are either Eigen containers or Pressio expressions of Eigen containers, + + * Epetra + + * ``A_type`` is an Epetra rank-2 container + * Either ``x_type`` or ``y_type`` is a rank-1 Epetra container + * The other non-Epetra container is a rank-1 Teuchos or Eigen container + + * Kokkos + + * All container types are either Kokkos views or Pressio expressions of Eigen views + + * Teuchos (does not support constructed results) + + * ``A_type`` is a rank-2 Teuchos container + * ``x_type`` and ``y_type`` are rank-1 Eigen containers + + * Tpetra + + * ``A_type`` is a rank-2 Tpetra container + + * ``x_type`` is a rank-1 Eigen, Kokkos, Teuchos, or Tpetra container + + * ``y_type`` is a rank-1 container. + If ``x_type`` is Tpetra, it may be either a Kokkos or Eigen container (or a Pressio expression of a Kokkos or Eigen container) + Otherwise, ``y_type`` is a Tpetra container or a Pressio column expression + + * Tpetra Block + + * ``A_type`` is a rank-2 Tpetra Block container + + * ``x_type`` is a rank-1 Eigen, Kokkos, Teuchos, or Tpetra Block container + + * ``y_type`` is a rank-1 container. + If ``x_type`` is a Tpetra Block vector, ``y_type`` may be either an Eigen vector or a rank-1 Kokkos view + Otherwise, ``y_type`` is a Tpetra Block vector or column expression + +Notes +----- + +* See the :doc:`ops homepage <../ops>` for a table of booleans to use when checking that ``A_type``, ``x_type``, and ``y_type``` have the correct types. diff --git a/docs/source/components/ops/min_max.rst b/docs/source/components/ops/min_max.rst new file mode 100644 index 0000000..cf1c715 --- /dev/null +++ b/docs/source/components/ops/min_max.rst @@ -0,0 +1,28 @@ +.. include:: ../../mydefs.rst + +``min`` & ``max`` +================= + +Header: ```` + +API +--- + +.. code-block:: cpp + + namespace pressio { namespace ops{ + + template + scalar_type max(const T & obj); + + template + scalar_type min(const T & obj); + + }} // end namespace pressio::ops + +Description +----------- + +* Returns the maximum or minimum value of the given container + +* Works for all container types other than Teuchos arrays diff --git a/docs/source/components/ops/norms.rst b/docs/source/components/ops/norms.rst new file mode 100644 index 0000000..a0b1728 --- /dev/null +++ b/docs/source/components/ops/norms.rst @@ -0,0 +1,42 @@ +.. include:: ../../mydefs.rst + +``norms`` +========= + +Header: ```` + +API +--- + +.. code-block:: cpp + + namespace pressio { namespace ops{ + + // L1 Norm + template + scalar_type norm1(const T & a); + + // L2 Norm + template + scalar_type norm2(const T & a); + + }} // end namespace pressio::ops + +Description +----------- + +* Returns the desired norm of the given container ``a`` + +* L1 norm is given by + +.. math:: + + \| a \|_1 = \sum_{i} |a_i| + +* L2 norm is given by: + +.. math:: + + \|\mathbf{a}\|_2 = \sqrt{\sum_{i=1}^{n} a_i^2} + +* ``a`` must be rank-1 container of any type diff --git a/docs/source/components/ops/pow.rst b/docs/source/components/ops/pow.rst new file mode 100644 index 0000000..d6dde4e --- /dev/null +++ b/docs/source/components/ops/pow.rst @@ -0,0 +1,47 @@ +.. include:: ../../mydefs.rst + +``pow`` +======= + +Header: ```` + +API +--- + +.. code-block:: cpp + + namespace pressio { namespace ops{ + + // x^exponent + template + void pow(T & x, const scalar_type & exponent); + + // y = x^exponent + template + void pow(T1 & y, const T2 & x, const scalar_type & exponent); + + // y = |x|^exponent (exponent > 0) + template + abs_pow(T1 & y, + const T2 & x, + const typename ::pressio::Traits::scalar_type & exponent + ); + + // y = |x|^exponent (exponent < 0) + template + abs_pow(T1 & y, + const T2 & x, + const typename ::pressio::Traits::scalar_type & exponent, + const typename ::pressio::Traits::scalar_type & eps + ); + + }} // end namespace pressio::ops + +Description +----------- + +* Raises each element of a rank-1 container ``x`` to the specified power ``exponent`` + +* Stores the result in ``y`` if provided; otherwise, acts in place on ``x`` + +* ``x`` may be any type of rank-1 container other than a Teuchos vector diff --git a/docs/source/conf.py b/docs/source/conf.py index 2f46f26..2ae09bc 100644 --- a/docs/source/conf.py +++ b/docs/source/conf.py @@ -28,11 +28,13 @@ # The default replacements for |version| and |release|, also used in various # other places throughout the built documents. def get_version(): - local_version = '' - with open("../../version.txt") as version_file: - for line in version_file.read().strip().split("\n"): - local_version = local_version + line.split(" ")[1] + '.' - return local_version[:-1] + version_splits = [] + with open("../../include/pressio/ops_macros.hpp") as version_file: + for line in version_file: + splits = line.strip().split() + if len(splits) == 3 and "VERSION" in splits[1]: + version_splits.append(splits[2]) + return ".".join(version_splits) # The full version, including alpha/beta/rc tags release = get_version() diff --git a/docs/source/index.rst b/docs/source/index.rst index 9b50a8a..b7de9aa 100644 --- a/docs/source/index.rst +++ b/docs/source/index.rst @@ -4,7 +4,7 @@ .. include:: mydefs.rst pressio-ops C++ library -=================== +======================= Documentation of the `C++ library `__, one element of the `Pressio ecosystem `_. @@ -40,7 +40,7 @@ the documentation and the code. Notably, we have extracted the core operations from the ``Pressio/pressio`` repository in order to increase modularity and allow users to build their code directly on top of -the ``pressio-ops`` if desired. +``pressio-ops`` if desired. However, it is still useful to consider ``pressio-ops`` within the context of ``pressio`` to understand how the repositories fit together. @@ -189,7 +189,6 @@ open an issue on `github `_. ./components/ops ./components/expressions ./components/type_traits - ./components/utils ./components/mpl .. toctree:: From 4db7e539124746f715cbac05918692343f0f5c56 Mon Sep 17 00:00:00 2001 From: Caleb Schilly Date: Fri, 25 Oct 2024 16:53:01 -0400 Subject: [PATCH 4/9] #6: add pow to ops tree --- .../.doctrees/components/ops.doctree | Bin 16772 -> 16801 bytes .../.doctrees/components/ops/norms.doctree | Bin 6415 -> 6459 bytes .../.doctrees/components/ops/pow.doctree | Bin 0 -> 7208 bytes .../.doctrees/environment.pickle | Bin 64279 -> 66122 bytes .../_sources/components/ops.rst.txt | 1 + .../_sources/components/ops/norms.rst.txt | 2 +- .../_sources/components/ops/pow.rst.txt | 47 +++ docs/generated_docs/components/ops.html | 2 + docs/generated_docs/components/ops/norms.html | 2 +- docs/generated_docs/components/ops/pow.html | 343 ++++++++++++++++++ docs/generated_docs/genindex.html | 1 + docs/generated_docs/index.html | 1 + docs/generated_docs/objects.inv | Bin 600 -> 609 bytes docs/generated_docs/search.html | 1 + docs/generated_docs/searchindex.js | 2 +- docs/source/components/ops.rst | 1 + 16 files changed, 400 insertions(+), 3 deletions(-) create mode 100644 docs/generated_docs/.doctrees/components/ops/pow.doctree create mode 100644 docs/generated_docs/_sources/components/ops/pow.rst.txt create mode 100644 docs/generated_docs/components/ops/pow.html diff --git a/docs/generated_docs/.doctrees/components/ops.doctree b/docs/generated_docs/.doctrees/components/ops.doctree index 0fe0ca30966b89fefd3e6d2b1ca7c7296dcdcc34..8d3de585fe2c3ca680c3810a614b0c2540bfdff2 100644 GIT binary patch delta 133 zcmZo^W?b0J$kM<%b=pQ2K8wl1=0eN``Q?-OErOV`;$XoEX|MviGvKt2m|ZR N*qddtnc1O{5diC#C6fRE delta 122 zcmZ43%-GV*$kM<%wQ?g1pT%S?3;)e^78%TpNt>TrKVc5FWn*B-vH}qoS%Jhk5Mc`9 z8UcyY9?rbP+|-iFg4E(EwNo^*K&m^zDm%fdI!iMoLE<0-GQz;RGxlZ~ZB}q-WCQ?) C6C(it diff --git a/docs/generated_docs/.doctrees/components/ops/norms.doctree b/docs/generated_docs/.doctrees/components/ops/norms.doctree index a40338c17c6023119245d11bf4de8fabe80a9df8..af5948213aff97c047903761e6c1d09d5485f04e 100644 GIT binary patch delta 105 zcmeA-+HJ(rz&h1nBTEFowpKzyVnTvKZfS9eLQ<+iQDR=UuAxG5eqKppW?pKMLVlV; aVqT>}No7ImBTEFos7OLWVnTvKZfS9eLQ<+iQDR=UuHoc%{we`}G{Md40wSCM DQU4OO diff --git a/docs/generated_docs/.doctrees/components/ops/pow.doctree b/docs/generated_docs/.doctrees/components/ops/pow.doctree new file mode 100644 index 0000000000000000000000000000000000000000..ef4d820f19857ba881724446bf0ef7a2eb49a6ce GIT binary patch literal 7208 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 literal 0 HcmV?d00001 diff --git a/docs/generated_docs/.doctrees/environment.pickle b/docs/generated_docs/.doctrees/environment.pickle index 41c799ec0ee6b35c54c5eb498ed70b7707f66a65..0c26c8635aaf52bb6ad7044ce0e029cc9a989662 100644 GIT binary patch literal 66122 zcmc(I4U`<$Ri=JN(u_tUX(U;;aJ>cRckc<2@cuV9;mDh=^Pe9HsQdA!-0j}KsE^>Az@hvtbrw9ewGtXID!1|a}ok1 zoCLyt_ug0as;aBi-8D0k&QaIY`?>G_y?gJw?^V?^8{ap)X6+jK7w+^MmhE1cGTrlb z({t;l8??jiZ)(}K>OF~~_qGqdv;A~?B3y4Y8ts{Ixaw7crfF8~W;;ANZFzNbx?Dqh)LSwoj03JyK4HNFx=>yL5oQ=F9fCw++DwY z29%G~7yY2zFq*yznq$6Q2&Rly-~s)1I36(*h39Q^q2g76$(}^1?FMF3?%UxG`J-I% z8jG{7An@F_84lMCA8m*$K*n~f=7n~+snPTtvjWkKD27fx&;YBpP}inCZ=vSiTV8$3 z&4)@eMgWwJTIsY|v0Sg_%`cX2DBa`E+pcLgZFj!(uvcqQ8^7eul^!SUv7*Nx^Pc(MQ1 zTVMOSH-H7HdMFwcCum!*YlSJ6f%9J0t1`5ML$Y z<3zX#T%eM6Xyi>&VCTY^dr8 zSXG0n^1KO09%xq0rdd5|LwPad9>PT0FxB+Q$iN~5%~mC7p+3N5YlrKn>Q#&Z?w+f9 z3vRm=?q-B)m=fhyqsrz&Y0PY_F{8pcktbuh?#3H=%3i62JndJSz-kh_Yz9-*oF=ez zm}a4>!ttokH;rb+Ql(c!rLJ+_p6B_cYW7AoW? zze?AWSw%Cj8ftsYo}c0(Of9H5IDVS0Tr^BJYjU>cRnDRRN!t&|WT1a59FJ!vE47-Q zo9dqHoikt>hRz$cmP{Dy71lN3dgx?(=DD_2vi4bz&;R%rlykVLI_|xCSNOyXH7rv>XN7Bu1+1gY>;eA}Vh zXlu;Ct?R7o1%|>~_Xu9A{G(4PWtHHsAt~sLy+XG73fkNNv zP}4Hnk&QwsYP}ywQn0XNgxd>XCDB8)aq3{IusytUSFt%dnHsuN+&bnc{(7eW? z8hb0eZ52L@qpSAJ3@PPmBUDs@J~abBqH?%}aHg; zJ{&;scngXcb9!f@tZcA;!(BXn)Ku)=m8@6c2DyTXa7(0%Yyj3d27K1$S&DCAVc1Ko z2lruw*aewlZo*ME!LtZ-*cw>Zh@7}IGEK+t-pn!dns5V^(=-oPWmntQzln|r-W7_R+Xs_H^Jry8MGCv7 z8HW=}!x&z}qxq!b46d-wSdYnw!m}uDOf^!n3A~EZ-}M4i*ha+&-_-;auAvMOYy%Sc zP;z{jf-)jGOuI?%!=HPTC{VH1dHN*>jAYlx~9=cF3yT$Z5yd7)%G z!^GmE(zH4LBp$LXq=ur!rj76)@pe?RgZnHX&Vr>Qdkv>HjDXyJ0*#HD3}{VTuT}<= zqXJgCD01Wq>t^c~`C}5H44XU^Wdc^9Lg}bRf@g8+VsNcTtVgBSRvusu(GRf2G$l~h z-PU3G!?0%MkMFbYl=frX9(Jy2q!D_+IwegXv>uYC65zotfmT|!pgjo$ewOhaXGmgR ziLW*mBM@$)jyzh!MDPPqoP$tyiOHRcrnm~n#wpA~kOTYJXqLTMUQO{5P=E=_2|#L) zU5tP(FEb0mwfhx<+qga{^(3DgH9Ju1uq5M%0BG4(Rx8!iK&)L-LG(nV?%`2%c^qwT zm>Z`n}AVh;@DunfnkX~gfWcLa_6b;BY=v(JSk!ld@ z85)QSR28C1yhH-xWT5vDbXoqwL3{NEG!v==%)_fYt88C9Tm#FseTiz%tu1m`8Nr~L z2~`QNOf+hmbyzIbf+~{(P`ff#vcY0G>U%??FO^{c*iE;^Azry+8BMq%vbwGCnnY6= zVuYMt1rD}m*RlBG7P}HH*zA=3^9bt@S0^fbtgb6$3c?*#`}|ZKEtL?uAd`@2DFHu6 zd+oQq08bRfeI=M0qhUT|&fjyPF@Yr(Y{mW2x!deROziq5|w7nQp50lz#ynD z%pCqOg3^K!wHmU zAV{l|qK1jPbW)>Bi81$(vZWi7meJ^uk{yAL0n)YC9x9Pm9rY?lNvF7ogvwGy zt^%VFMt8*bES)=~9y~nil@`nrhwUUQ`+n^Td%$Mo`>$4gc7$n8FTF$ zW60nm;Y?TpjeYy_P);_!SMcVxNg86@Doqm$dqqJh@Jdi$N(w;d$r>mrQ-BRkX3QD9 zJy)8DBoXPi=(v)NYc7=3EI9Dk#DUUHx#C3efrArMHy%82kikA(G9gkmUwXhx%`}o| zR#y&oKo_dPc|TB^NX#U?c;t+ho=|?wYeB)4lIhBMFGvW0H854F8J?(<5lL3Zy+D*P zF(#?Rgl-beB9bv8#VMcs*u;TH-2(@coMs&Z6oNX%Hxr_U!bxHt2}zng^;9W|xZEmK zlR&9gntXvdMa!=V8cIW_wkeXP8ZF=HPJ{tY2CHZ`rGe=D<|K`pog{gJ*I}P7AXYJT4&wM;;x?bwbBy zP!WscX*K0zGi2g?>CU@K_yMZq22%4T;bJg*l3Z~-+m(4HGg_nj5Qi@CsEDa;j6Pq2 zc_S>yU>fH=yIP`ch{7pToqL$S|S=~tH4tNXd$w!Gg})uv!xMR4OFf?8utLRn*v7F6KF1|S?mSLj+wt}Pz1!}y~R{=LA5390Bq@Xa4$0drT z^Z+Gnq8R%X92HXnmGh?@M!H_Kk>R`oTW%7J%fK)s7J^yq@X)|2`N5E1Q>L{a3e}&hZe$L>7*DvMm})t!-)NYu%$0NNqiOux$$Zap$TH&tNQa7G>R|k5HpCQKJ|T z+zO?Ilt7}sw@@sdQ+{i&b5Q6dSyF{zD1GvdB=bvVXJP}`#&R`^QVi8-bATzRXob1QEMd9N0-2|?RnogWs! zye**;mQsQ(UuY>Wy;WZEYN>!pMCzPyts@nUm2s_AcU8Jlp-D|HVBsERF|U;Nf!CoR~aZw>{A%%6o8y!T=(xK!Yf|q1wZwa7>=b z>0V8?Mk=BdSW?{FInjpqAYiAkk7hT)&v<}s8V;osp()(;N?qJEAIFwWP_|5i^Pvi} z9my8(x>!k{Sj&AAHGy3>Vb=kZCS;;w!E2tQBu_+NX-A0{>XBY!=g^(6nUWWYwj!e>*A7e(+nw_$DIn`9HEC1W zA^*G2*}4vgGG6rn{5q&MONqQ81?7lOI7^qQV_iZ)myL#1YFp&UKUnj6(zp9oVuHUJP1oWu!s}ZZUiT+ptiO z0Q=dh(^#c!SIao3z&TmyedGgn(ylzbbza@}N*O~T*?G=fgz{HqUttqclJl-X1o2LF176;(s%_3TcB8k%HM~(X9^Xa{5iQI(r!oBq z-(9-8YM!T*BZU~@M$?_dbc>tq)y>p!(dJON_GaB|n{Fl<^cX;5oO833n5^PJMA}Y8 z$6Mk)+ch-w;T^-cE&-1gy0Dh%`YUu_*%^&2@=^@qO5FtKOAxL!>*X3^5%>?yp9K4S z_;OKt>zNox0!P_$$BtE8Ii^QY$9cA&(xFP}UPw>#?rPnbB5TqT%uw3D!lcy*B_t6y zlfBwA8rB{Si>b$YLL%z1>6YJ|p0(X+%f{KLn(mTdSPWPC?1=kB6}neR4}=(*_Z?s$ zaP$cq904ot zN-B!WA4f<-vqmGKHV#w;9~a=m0IJ7URUr{lxY5P-&G~3emaI#JNdj^gpQIDhLuY+p zscP_}V$?>ta(=F!D&51S*o>tu9AagBFi-gbu8(-_FJhaF_xahJUBQ*Gg}jFIxj%^_ z8ge_=W1^I0-_xfqpgy*Few)&8MtOYo(vwjZ6*qmU%(vkMV#dpTL+A^Z@JER_E zUJ+_%35M1V98Cj!)g8M=$zweYOUt77(BSX#^?7aJicgeU9eY)a(R7>Q(c6}cM3!m3^v zAoW!b8|Ji6OEFf&b)iB|nIYEW1$We0BoZx+IfzGS5WX4_#x1-qZ+h5#@SloWz>vrH zPpRAof(JwKVh1fl84B+x(bw(Qf*qH{xug+DjAI)Z~?Wq(L}vn%AuZCtHnP@frizdz zw~Rx@s0z1ed<2i{A`o#SC{4UKUY3y**q%EEI1Li(YralMNlvk4OWt zlZ?A3YNyT**@&x}SivjpxGJi)U1UhHyok9FE6|lu6SBN!6Z?pYmGSX`vFOaNVh!e` zSmn4pGGKIEL`6oWxN;6h6tSTyY(;b&~G6`$2 zoZiveN#S=*va_^ znN*1c>9plKgxmw^=S<>c^)_{IAYNl_I;B=y@k#OMWV*G54()}T!4Ww{_X0e|D=DV; zT!K4|tvGSdF3#J+W;W=AQL+IYgQrysY(I`)&(p~Vocl~bKm*?IjX_cmipOv|1**;A z3;cb$$8@Cz1ll2Zmg>h26E+6yNR=ZCw*1G-)M!pIVcI9T3lV>1o* zLehZY&I~AH7HDJ{g_Twv#Yv81LDmlUW;$2t$RTMUV)9H?!&_+60fLwpNuiTa)0|4w zcJIcD@*-3@KL1K5B(^KfR6)j6rF~*uxHns9;ruHMQ$TuuMYhtW=~g0*fJm*FN$3R=7(ovM4&j1ec>jI1jQjRgTRBoSDEeT!k8JWw;sqp&b$O9~0p= zvgowj$7JQR>+7%v3`gZ~M$O~!3rlv2Qjl;aPmDAJJ(Pf>cHr|8<{4U@!=Vubhh zn)5K2&xczZP#X%RdHEIMxQrz1QH)(gKABGm-)VZ>0WA|*k(qF7bFPx;dqdP0r{AIY zSQ?wnDccO@7yvBLGzEJEiTb4=ZL?jRbkLhF)(?l<&_SZk3*;t=X_V1|jY^m9i1J)G zkTNG*A4@obX5hdv=WXFv!acmkz~n=Q0=k89C_1l#{PE;z%;?B9+z6itx7LTfP8)}# z(LN63i^Ff$GvQVSS&mMHw!+O6&x0BfWzr@kXWH?@fA*W-{^Pse_koMgRMqS&&vb3Z zGgF$q@lAK7Y(BQ{^XJMx*v-YM2ETe+zOR$&=WqIaheHt0$@SlPZsS+F`JRm5qW0fA zIXd+7-P&h-6}A8OUw->fzmyVw(zUA=Uwv~2hAz7-)c@9+@BaG-zTLr2@<*!nufOG7 zvwqDQx?8*DLwCQg72RxaxuuWimNs)s{oK+Zx3ra8dOo*wA-D8GZYe2Ohf=^Kt5YV`w(}%fIPbtu zT8pBvP-~DbiL^(TM4F>ZBCXLSk;dqfNOZa+5}PiGM5aq3ap{ssRJtS*lP-xwq)Q_4 z=#oe@x+D^dE{Q~+=tGn7G#%1F6gw!PJO!bI z8`QKX>4Zb<`q_^<2GvrKKv__Kiq2%hB5dRq^!%PY1iYnbEXZMGT1;)GM}86exL7GV zUm*ZkQ6SlgB~8@B`8z5eJ9{=U&CZ@}JAaSjsMChiSf-FE8c8&Q6`~=-A$gdo?fe6J z__IbhoYA0R-hS&Fiw2woDqy$@EVnj9MZIlBIPdQJ12* zxw15S%cPmyXm^^~;#`r~aVj0T=_VXdz@yXHw@!-k*`j1Ai$S4Y4?M29FOlxy!{JAh zv27BY_bw9~3Nd?Nv+cbVP zY+O;9jsx6sWZD>r#=Te}$T7{-o>84f&&d$_8nbrv zzW{tL36p*f10|XCG2zE2`7Fv&I?owk>r9YdCsd1qbQ|#dHS2Bv151?rpd&k2c? zd+aKX4jN(Icxxg{B@P7A9($6`e@@f6dK34XOh_URhI`7?4N0a>E*s=B#Fq}8q;zZl zOh9mk{g*5Y*3+I$k^$owE2)y->k}_$GdgyveX4;oJ!&J{-k zF3l#wF?A9I3sJS5u!9cG(374>>Kk~YL&NIQS&-QhA8P2;n zFn<)xNKHueBtro?;L<&%-z8!Gc7RJw$e!S6(@YMAI{CGSaXrW!93Fn7Eqw^m6c>zBry_52S zdfn7o>@nd56?B>k`$O|J4@Wt}A-qNuyX*LCRKbc1Hp?+^9E>@!CL9)*WmHn&f{KILyhtJzQC$@>ip8$=6sjb2_Whau_ql1sWH^~yF zL?GQ)5G&`WxuaO}u3CIQ8s(|?g!6Eh8s}}@Dzf%xFPZVA{mI|0`!wLKpz--6zzrtF zeB(n$KCr*ak7}ljkJH2mBAbs7JeFvTvlxT;D1+!~W+t3&5-K1d3EB^zx-S)}d>W9(&+(_&JhW-G*t~Ur;@N>t zcCW|4gH4DIC0$b#M3&uy8$>o^A~BgN1wd#lK2lU~lrg0fUtQ;FS6x~OV>+ERrkw`@ z4iBthO3?Yo9_|`g==pYmc-G61-ZAi49Xk4Y2GLbGm%xzD4b1;O8P?5^R+i7TvqeGZ zIdw)DztVoHt07%lH8%G!q|X-RmG<`UDheXY?gCbjOqdu_nJNW9Xe@3kN{BL~oJ+VY zQR%U)A!*+p&XX9s3izG)z~^|Ga(9(b${Tlz@`aXD@2*9PW)pA73}OTWB) zu6?N}2tBR7D2%^kwsb4rn7R_Ne}`U%J#6U~47|*sbf_qZEV~OBLTyWBsuTdBvG{mV zy-~K5v$2=OmY&Jl(vCxo#|Kuhi`vnn1Is+$ED+0j+0nxTkJVvE?_v;L?dXaw74fxv1YQUEVW?#P=uq$N&h~Qim_|m`#bf~}=i-Ne6DsX*P z1@OTIdM<^(Uczr*GW@JR*q2s^oE|CF*t2Ctjl(#=4Hi)Ms~V-0YS{i{iV>4|vtNg& z*gh~a9cnUK6hu}{3WVl5x|cAd00@mmrKrAZEF_Fv78Z9b2Me6{;&UFCWsMPJ*BD(N zCaSLNj4}q+!2B6Stn0Pbcx>RYIws5`45I5=V?`t8ZflLDfhEu<%et>Mo?SlY-c=NY zp5)I6^H(}=v-LE;QwSf7q4y;xkI?=6s&RUBzr4t3QU>j??LS+TTRIE=;i4c`o#FdV z<6U2P-Ee@n!Qf~MKUXKO*_^}6=J>QrQVPGnYErm%KRq%z8Dla@pWMx0(jl6cit<&9 z=C_N2$cmP@`+BT&)9|1nW4?JM+Io4U4H#>% zc(TJItz{6G&?Ai;H-pl{^mSt#GfU3X8&->PNOR-M2J%H^jM*_G_b;D|rJ^A8T)0LA zvC`hDbeuk3Z&&E?44hxB`0wwQPuSp^?eO?#~SR!s)`AOl7O-z1L_VS^bX(jk~* zMY*a?<&mNwR$VZ=)Z@@Bj3d!Y?~)UuwraxIy8I{89Sda#AK-R<3i*}CMbKBz7Ui(Yw>FRMQwS^XjXyi7lTf}d_u z3)j;L){Zmh%Ml$PL645JJ72)y%3j67bbf=-qL%`l`1mChMY!cOUe4LH@qNv9cvJKa zOqFPy!i&AF*6ft+O{6er?oS^}?z6=~ME0-l#id z6JGTI-jD~!fzNyTEpvJfAEl&^P~rX1<-AZeK7w6mzT^MZtE`Pm66!uzgO_AOed1sk+(Kj)Oi@4}+3xL95&epE) z96GgHtP4kR+CA|S&yK+I{^c|B%@=3nO71;#w7Ba5evk?u)I9IQT0h>xSGCd$*v6`{ zbN7Bv4L*6^pQI0=@!%b7tuLRgPEior*31_Lp)H;WcUcziIAgKmYH;^`E|$`GA`~yP zI)qP$;~U_3cQ=2L)erE>Z2HD2vJLq1w!Hd_mv{6%R^`UiON|c#$yG64;a&S}7fWqH zbdvC#1fG-l0uB-(z;hBGV5O{xLX#JQKoec?VsP8*T%P6eWbPz(yTEa((H%>BV0B_9rW(fkaX-_xVRf*``(K4;VxN_gUb`5u5#2 zoVM&{brO$%2aBbX{2D>Lmbx@?`qWAPU@C3!t<~aWc=i53BQYuOG6WKnK?5s}4kz%B z%jfbpih|Hnx4QMqfI zc%mo>Ewp=!f>1)^_l0y7TK_LtP{vF_-`PM10_WzVy8yr}c}jE*ex zeU$Ic2%tB({8cQmELY{ij<<3Az`#R_bi%H0GS#g{x?AM*S|jF()!teDc~KbWMs{(lRyEW!2P zEehf#bX5682C?Go-Z+DA;if~IZ(*d>Vf4^`mq$~ESF`vZi}FV+_BV=x$g)_+BfT|D z*{Gbiy@+)h9G0Wed8#NySB~c+Ql>X$uY{diISXcqryQ4m=c z7w|dcFeJ(lYg7P)#^Q#egebSgFT3w%4!g!bE3pn+ORs`VzMZVg+w%Vu6t1AddU;@m z<=bCkTrY?9`GLpka9F?3ATH;+>)!_Ef1eEN=CHoAe6D@FCgAf6hxNA1^kS5Rbq__fY4YpixQ$-RReant2tcNwbgXiRrUT<)pcWo z#-A7UUHbrTu&6TM6cZ17`L0(EJXVMAx|%_B71kxl3*I*{|NCTEH{W$^`CL0v6oj5* zcMIb$neVEt8k>9gF1skNv|*hq3S!mSo#VS+ST#m>^<806{%9626$O!HaRJApeV16H z0w6RNdy5jHd>4P|<+3cZj%9sU-sc8?XJGBRsJHs9fw`4$e2Htlywz_EJXVLd`YeOE zoZjl|1M|O6hIR8+f46+DeXS@6J*&PfjK5^wYUlPrgR*|v+{0UqVc@~Sw+Das%1t)`2D$g;SAtI^&{tWg0F8jDXCotny9@z=;Mi?=$H^;Vr9 zjcp99TNm|J^?`++Zxe`Ty?m83@K_yYV4gu-PG9xDf%)Gj!@BvZA6Y)vUMLDe!t zf608+$5)NbJ$%(ii}Fev(vK7cvFhy3@l}7mYK-pctNyeoe>96d0Bi_ko8qLU;f^+BOP(}`$2B!-2}Yj3#sD(my9EOgUh$Q#I#&z z)p_=P`@lnr&+2~meUu?yP8W9Pz*6axjcFHl2*b$9q}vNJ(YZAS@w$Q_I?ukph9PxL zn6LQRK?CC@PaLh7(&nFi*Ia+BAj=Y5f21gg|A3An`&D9hjwkz%tH$VzC(|r`XHouW z#ePRo5Lp&$H`H6hl#R+c`!3dLa9EB;XSgUuKf@j6!_Sw+rTs|OrR}a8_-^lo$@6%D zsMn-7<5gRgAoVcsXMl8adjA+;;491Tm&*s_@Eb?>VP0==`L>z9 zp53R5`;~!*?B(JHH)G&rK-hb>sL7|fzOg8X4d^JcUnO?uxVWiRV|2#FX%^p9 zls}rq6GcH}S*+bszk&{PT%1^^!C^TXonJ0ERh%3iwbMpV4yiW3* zeB|Q9)8)E2C!=*A6L0njxqMPCpOVY3@kPzD&*G-j#m#5bp*OgEYe7ux)5TQ>9nTxmL<6Ui$y{F0y>K9SBc#l=>`4iCz$_q)fhd*FX4~hgQHpea#8+h#r}Lz z5UbDP&WFUmyNWDMJtVGK{4YiMqgnjVML}d)tUZ74NvzyJP81;yU~pKDM(44j6uoks z!d~b6rHUdZoa}2)evdqRGK^S{*TtvS#jgX7gBi?=1`V$flKD+r>q|G3Qe#o2Kih%i z7dw$OE~Gl%yBbIiq7(TpnFN~~**JPe-OLQpkIMI}%L%_QB|N>1F-(16{`bkSZZV9r ze6GzG1)(Q?RTzKCHd9|*H8$t2&$W`irzo$q+5f?!AhPTpWLhdyM0QrkP5$I{y-+LBBb$RQhCN+P?lJhLL&l z^@2=vz8Zu0yMiD(*N9(ZNSAJnxM$a(bD&>t=bBl~^>GZGOoR5GEo$;XGvXW`%R%vf10+WD--sb;Dao#jOtk#TB%+4-72) ze8nY}*~pY$Li44`$RyOF>YNLnE!n;teag8md~}vi-OQo$`!_6vbgofSB=d* z4C;>-<&`$5?V=#E>@Hvg$%2VZmZ?$zgvR1nQ9_g*z2>sn(L)_}l)iqHd<*Eype<=f zZ{^6;xlJywlgk_AatB|OG5R_Y)p0)U^BGq42A6LZh-LY9^sPWbB>VdVkEKw5CNLI|ECgPnO{u!}RT{INhr`_wD6#?w^W+I2kklAB6ecY-y3bK2DAe&lu3I@?tPo19MPwPFV{#G5&z4W*0 zcH-k&4bL^*z@LT%nKowSgIKT3mRGCgz$;g6W8QNO`Zn53xGU49QUf5a*_)}Unr5S1 z@fwRvs^;vPAbVY=LiU8q za{8$poqi&+y0lask}Z=Tnj_{RPh7@F!WfY(b0n=m@U!Go0G#*Pu?go0l*74)evZ@6 zee`pJe(tBA2k7TP`gxds-a&Yn*cZAYu1X_{r*t<+l81g&R4^AC}7 zyoY{Xz>mq4QF;7bPABK9kNjCclkuRo%bu*Qa67D(>64vpnzJptR%L+@axW;syvSJU zJ3?3A5xR6of_ag@C#vs=0DVW_uhe(+AxnKnU$oSB^zB1^M?}&cG5(l)fWl zrSHgU={quC`i|_Fz9WOC@5r+0J2G+lj%=O2BcrG9$oj>1t#EX{=FNhytO9=fg?6|@ zbi*XCrb~ybUfsY4O^v`H)`x2=d>LtaUQqTI>$6_1?YtJWheHp`-Fw^WOS0cZ=}frQ zw`Xhkxb)#!@4N|HAKkyntij69gd6QDd8(Okq-s`bMpI&$nQ&9ptGGrTUHHqLGvS!+ zKV&A`EQMRj6$?7iG~M=@b~su#T+cnCOIowxCU4fkXiQ-wUEMx#4u<{Xu@!u6F#gFrgJ1YSFDz;MnlX+7N#&e)zcYb+QBzhT+#g{hiXF={5vLiu#laDC_{K2LqB>0MZCzZZ<( zj@IE=xn?}ESPoPJ6E)$G^oL9U+H4{)4maNCR?Q3Tp#9FavkU#4-So4Eey+gJbBOh3 zpKIf5vR+ki0p^R7@txIjcB0utrf<0QeinMEJM>p2pbz<`(X3c)=Xw-&13B_AH!7Vn z=FMDuZ%9B)A(=%v96z-fSe{!-A^9Av#4uSYEdu7dV*azxa17wQl2ODR;i?eE-66W0 zRCSS-gc}2sw&!4gTH%mg2j=+P@Q9LPE3hGe?Z@Cn$tJwTwI4rfoD zWjIn_^aCnD)X@&F;5&RR%{QA-WH-xLISRP`tnQ%u`n; zPvC5y567ix)oYQAY!`q{kiV_ffWBbu3g`|*@_aa^{w%}y`#v%McYzmt*bW=2)D$%? vR}6@Tv}$*<)OOD!bnu#FB*UwdHKglR44bImQ9f^*3oJTV7UeAP0q*|~zzF-B literal 64279 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 + +API +--- + +.. code-block:: cpp + + namespace pressio { namespace ops{ + + // x^exponent + template + void pow(T & x, const scalar_type & exponent); + + // y = x^exponent + template + void pow(T1 & y, const T2 & x, const scalar_type & exponent); + + // y = |x|^exponent (exponent > 0) + template + abs_pow(T1 & y, + const T2 & x, + const typename ::pressio::Traits::scalar_type & exponent + ); + + // y = |x|^exponent (exponent < 0) + template + abs_pow(T1 & y, + const T2 & x, + const typename ::pressio::Traits::scalar_type & exponent, + const typename ::pressio::Traits::scalar_type & eps + ); + + }} // end namespace pressio::ops + +Description +----------- + +* Raises each element of a rank-1 container ``x`` to the specified power ``exponent`` + +* Stores the result in ``y`` if provided; otherwise, acts in place on ``x`` + +* ``x`` may be any type of rank-1 container other than a Teuchos vector diff --git a/docs/generated_docs/components/ops.html b/docs/generated_docs/components/ops.html index ed2dc9f..5d75fc1 100644 --- a/docs/generated_docs/components/ops.html +++ b/docs/generated_docs/components/ops.html @@ -184,6 +184,7 @@
  • matrix-matrix product
  • min & max
  • norms
    • +
  • pow
  • expressions diff --git a/docs/generated_docs/components/ops/norms.html b/docs/generated_docs/components/ops/norms.html index 9c0bc70..dc9d86b 100644 --- a/docs/generated_docs/components/ops/norms.html +++ b/docs/generated_docs/components/ops/norms.html @@ -270,7 +270,7 @@

    Description -

  • a must be rank-1

    • +

  • a must be rank-1 container of any type

    • diff --git a/docs/generated_docs/components/ops/pow.html b/docs/generated_docs/components/ops/pow.html new file mode 100644 index 0000000..8520245 --- /dev/null +++ b/docs/generated_docs/components/ops/pow.html @@ -0,0 +1,343 @@ + + + + + + + + + pow - Pressio-Ops-0.14.0 + + + + + + + + + + + + + + + + + + Contents + + + + + + Menu + + + + + + + + Expand + + + + + + Light mode + + + + + + + + + + + + + + Dark mode + + + + + + + Auto light/dark mode + + + + + + + + + + + + + + + + + + + +
    +
    +
    + +
    +
    +
    Pressio-Ops-0.14.0
     +
    +
    +
    + +
    + +
    +
    + +
    +
    +
    + + + + + Back to top + +
    +
    + +
    + +
    +
    +
    +

    pow#

    +

    Header: <pressio/ops.hpp>

    +
    +

    API#

    +
    namespace pressio { namespace ops{
+
+// x^exponent
+template <typename T>
+void pow(T & x, const scalar_type & exponent);
+
+// y = x^exponent
+template<typename T1, typename T2>
+void pow(T1 & y, const T2 & x, const scalar_type & exponent);
+
+// y = |x|^exponent (exponent > 0)
+template <class T1, class T2>
+abs_pow(T1 & y,
+      const T2 & x,
+      const typename ::pressio::Traits<T1>::scalar_type & exponent
+);
+
+// y = |x|^exponent (exponent < 0)
+template <class T1, class T2>
+abs_pow(T1 & y,
+      const T2 & x,
+      const typename ::pressio::Traits<T1>::scalar_type & exponent,
+      const typename ::pressio::Traits<T1>::scalar_type & eps
+);
+
+}} // end namespace pressio::ops
+
    +
    +
    +
    +

    Description#

    +
      +

    • Raises each element of a rank-1 container x to the specified power exponent

      • +

    • Stores the result in y if provided; otherwise, acts in place on x

      • +

    • x may be any type of rank-1 container other than a Teuchos vector

      • +
    +
    +
    + +
    +
    +
    + +
    + + +
    +
    +
    +
    + Copyright © 2021, National Technology & Engineering Solutions of Sandia, LLC (NTESS) +
    + Made with Sphinx and @pradyunsg's + + Furo +
    + Last updated on Oct 25, 2024
    +
    +
    +
    + +
    +
    +
    + +
    +
    + +
    +
    + + + + + + + + + \ No newline at end of file diff --git a/docs/generated_docs/genindex.html b/docs/generated_docs/genindex.html index 4fe36f7..023d08b 100644 --- a/docs/generated_docs/genindex.html +++ b/docs/generated_docs/genindex.html @@ -182,6 +182,7 @@
  • matrix-matrix product
  • min & max
  • norms
    • +
  • pow

  • expressions
      diff --git a/docs/generated_docs/index.html b/docs/generated_docs/index.html index 3cb0d70..e3a3c05 100644 --- a/docs/generated_docs/index.html +++ b/docs/generated_docs/index.html @@ -184,6 +184,7 @@
    • matrix-matrix product
    • min & max
    • norms
      • +
    • pow
  • expressions
      diff --git a/docs/generated_docs/objects.inv b/docs/generated_docs/objects.inv index 44bdaeeba930f13feb2fe8cf8d1743935fbff39d..8d40d796c9d259a384375f38752fdec3ccafbff5 100644 GIT binary patch delta 496 zcmVvN{tO+cj{3WemyPr&~Dt?@>(`=S#)^&TS`0;z( zC?jTytl@eK7#ue@0F#V>DcXdc54ZA2nUOS@Q#+?OD6vAW7=O$i)@|)`tdJuH3&)-x zDy~!|XAG{KQnqN@X@6^!QkjWma!D6D4l2yCPNXqh`XzvCg>^%P@n4fq$~3%US*%ek zX1~Ry6Et*ja8Uu;?yONcU7OIFJl~9!%2l%-V_d_Jg6XQIc!_vZy7nVend~WAnmdkO z^= zvA(Nay0K1-FO5PaEoj5pX(Q}1cy=Mv{%o5EJj4~2v^_m|*C-;;k{ht&z zU$Wd{rpWK#F1=Mx_xDVzgXeyTo`76yj`3|QtzY@6$7xK-jby*UL2O`zg3!FfaIsz% zE1YuVe|q8Xz@Bri(Mo^`#Y2-*B>zi;rn7Qo`EJ-v1(LtSgQFpDL^nuyE2csjl0F#A mP@#s$W`_BO|2p6)uDfUxfO~N&jg%wLKdQg-BQ&4oDcLM8;`_q@ delta 487 zcmVdWp8HUaP8?^is8vBJ~GYEKGJ$_!7)E_P;N9 zaAUkS*^`Hv_kD&BgK)+>3l`%M1|J|sAPAWkJ$lNi|;YP*R0lDSucxoZs8$R3S$SR*oY- zHC(w$&J^4@rR>r5^ZvFdwXzWFbn75P d#7kOt)g}TD;!+zaN1i`af97ZC{sHCu!?@mm`+@)f diff --git a/docs/generated_docs/search.html b/docs/generated_docs/search.html index 1720e93..2d1c1ce 100644 --- a/docs/generated_docs/search.html +++ b/docs/generated_docs/search.html @@ -181,6 +181,7 @@
    • matrix-matrix product
    • min & max
    • norms
      • +
    • pow
  • expressions
      diff --git a/docs/generated_docs/searchindex.js b/docs/generated_docs/searchindex.js index 02befe9..510ab2b 100644 --- a/docs/generated_docs/searchindex.js +++ b/docs/generated_docs/searchindex.js @@ -1 +1 @@ -Search.setIndex({"docnames": ["components/expressions", "components/expressions/diag", "components/expressions/span", "components/expressions/subspan", "components/mpl", "components/ops", "components/ops/abs", "components/ops/add_to_diagonal", "components/ops/clone", "components/ops/deep_copy", "components/ops/dot", "components/ops/elementwise_multiply", "components/ops/extent", "components/ops/fill", "components/ops/matrix_matrix_product", "components/ops/matrix_vector_product", "components/ops/min_max", "components/ops/norms", "components/type_traits", "index", "installation", "keywords", "license", "mydefs"], "filenames": ["components/expressions.rst", "components/expressions/diag.rst", "components/expressions/span.rst", "components/expressions/subspan.rst", "components/mpl.rst", "components/ops.rst", "components/ops/abs.rst", "components/ops/add_to_diagonal.rst", "components/ops/clone.rst", "components/ops/deep_copy.rst", "components/ops/dot.rst", "components/ops/elementwise_multiply.rst", "components/ops/extent.rst", "components/ops/fill.rst", "components/ops/matrix_matrix_product.rst", "components/ops/matrix_vector_product.rst", "components/ops/min_max.rst", "components/ops/norms.rst", "components/type_traits.rst", "index.rst", "installation.rst", "keywords.rst", "license.rst", "mydefs.rst"], "titles": ["expressions", "diagonal", "span", "subspan", "mpl", "ops", "abs", "add_to_diagonal", "clone", "deep_copy", "dot", "elementwise_multiply", "extent", "fill", "matrix-matrix product", "matrix-vector product", "min & max", "norms", "type_traits", "pressio-ops C++ library", "Installation and Dependencies", "CMake Keywords", "License", "<no title>"], "terms": {"defin": [0, 1, 2, 3, 19, 20], "header": [0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 22], "pressio": [0, 1, 2, 3, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 21, 22], "hpp": [0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20], "public": [0, 4, 5, 18, 19], "namespac": [0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18], "we": [0, 18, 19, 20, 21], "refer": 0, "becaus": [0, 5, 19, 20], "each": [0, 3, 5, 6, 7, 13, 15, 19], "function": [0, 4, 18, 19, 20], "doe": [0, 15, 19, 20], "alloc": [0, 8], "new": [0, 8], "memori": [0, 19], "onli": [0, 4, 19, 20, 21], "creat": [0, 8, 20], "an": [0, 1, 2, 3, 4, 6, 8, 9, 10, 11, 12, 13, 15, 18, 19, 20, 21], "instanc": [0, 4, 8], "class": [0, 1, 2, 3, 4, 6, 7, 8, 11, 12, 13, 14, 15, 19], "repres": [0, 1, 2, 3, 19], "given": [0, 4, 5, 16, 17], "oper": [0, 4, 5, 8, 19, 20], "In": [0, 19], "all": [0, 4, 5, 7, 8, 9, 14, 15, 16, 19, 20, 21], "case": [0, 4, 18, 19, 21], "return": [0, 1, 2, 3, 4, 8, 10, 12, 16, 17], "remain": 0, "valid": [0, 19], "until": [0, 19], "its": [0, 19, 22], "operand": [0, 1, 2, 3, 6, 7, 8, 13], "goe": 0, "out": [0, 4, 22], "scope": [0, 19], "If": [0, 4, 7, 15, 20], "state": 0, "undefin": 0, "express": [1, 2, 3, 5, 6, 9, 10, 11, 12, 13, 15, 19, 22], "templat": [1, 2, 3, 4, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19], "t": [1, 2, 3, 4, 5, 7, 8, 9, 11, 12, 13, 14, 15, 16, 17, 18], "impl": [1, 2, 3], "end": [1, 2, 3, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17], "take": [1, 2, 3, 19], "either": [1, 2, 3, 9, 14, 15], "squar": 1, "eigen": [1, 2, 3, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 18, 20, 21], "dens": [1, 3, 18, 19, 20], "matrix": [1, 3, 5, 7, 8, 12, 13, 18], "is_dense_matrix_eigen": [1, 3, 5, 18], "valu": [1, 2, 3, 4, 5, 6, 7, 8, 13, 16, 18], "true": [1, 2, 3, 4, 18], "kokko": [1, 2, 3, 5, 6, 8, 9, 10, 11, 12, 13, 14, 15, 18, 20, 21], "rank": [1, 2, 3, 5, 6, 7, 9, 10, 11, 13, 14, 15, 17, 18], "2": [1, 3, 5, 7, 13, 14, 15, 17, 18, 22], "view": [1, 2, 3, 5, 6, 8, 9, 10, 11, 12, 13, 14, 15, 18], "i": [1, 2, 3, 6, 8, 10, 11, 12, 13, 17, 18], "e": [1, 2, 3, 6, 8, 10, 11, 12, 13, 18, 19, 20], "is_dense_matrix_kokko": [1, 3, 5, 18], "std": [2, 3, 4, 12, 18], "pair": [2, 3], "size_t": [2, 3, 12], "indexrang": 2, "vector": [2, 5, 6, 8, 9, 10, 11, 12, 13, 14, 18], "object": [2, 3, 8, 12, 13, 18], "is_vector_eigen": [2, 5, 18], "1": [2, 5, 6, 10, 11, 13, 15, 17, 18, 19, 20, 22], "is_vector_kokko": [2, 5, 18], "pairidentifi": 2, "interv": [2, 3], "b": [2, 14], "where": [2, 11, 20], "second": 2, "index": [2, 4], "exclus": 2, "target": [2, 20], "rowsrang": 3, "colsrang": 3, "well": [3, 19], "us": [3, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 18, 19, 21, 22], "dimens": [3, 12], "provid": [4, 10, 18, 20, 22], "metaprogram": [4, 19], "need": [4, 18, 19, 20], "support": [4, 5, 15, 18, 19, 20], "gener": [4, 5, 18], "program": [4, 18], "which": [4, 8, 18, 19, 20, 21], "fundament": [4, 19], "build": [4, 19, 20], "block": [4, 5, 6, 8, 9, 10, 11, 12, 13, 14, 15, 18], "librari": [4, 18, 20], "you": [4, 5, 19, 20, 21], "ar": [4, 5, 7, 14, 15, 18, 19, 21, 22], "familiar": 4, "type_trait": [4, 19], "from": [4, 8, 9, 18, 19, 20, 22], "standard": [4, 18, 19, 21], "look": 4, "too": 4, "some": [4, 18, 19, 20, 21], "part": [4, 20], "have": [4, 6, 8, 9, 10, 11, 13, 14, 15, 18, 19, 20, 21], "been": [4, 19], "adapt": 4, "tinympl": 4, "project": [4, 19], "The": [4, 5, 14, 15, 18, 19, 20, 21], "appear": 4, "longer": 4, "maintain": [4, 19], "follow": [4, 5, 8, 12, 14, 15, 18, 19, 21, 22], "partial": [4, 18], "list": [4, 18, 20, 21, 22], "intend": 4, "idea": 4, "featur": [4, 5, 18], "To": [4, 18, 19, 20], "find": [4, 19], "brows": [4, 19], "sourc": [4, 22], "f": 4, "arg": 4, "struct": [4, 18], "determin": [4, 18], "whether": [4, 5, 22], "everi": 4, "element": [4, 6, 7, 9, 11, 13, 19], "sequenc": 4, "satisfi": 4, "predic": 4, "must": [4, 6, 7, 8, 9, 10, 11, 12, 13, 17, 22], "convert": [4, 7, 13], "bool": 4, "static": [4, 18, 19], "member": [4, 18], "constant": [4, 18, 19], "equal": [4, 18], "iff": 4, "otherwis": [4, 10, 15, 19, 22], "fals": 4, "exampl": [4, 8, 18, 19, 20, 21], "pmpl": 4, "static_assert": 4, "is_floating_point": 4, "doubl": 4, "float": 4, "ani": [4, 8, 19, 22], "least": [4, 19, 20], "one": [4, 6, 10, 11, 12, 18, 19, 20], "none": 4, "indextyp": [4, 12], "ha": [4, 7, 8, 12, 19, 20], "subscript": 4, "can": [4, 5, 8, 19, 20], "type": [4, 6, 7, 8, 9, 10, 11, 12, 13, 15, 16, 19], "void": [4, 6, 7, 9, 10, 11, 13, 14, 15, 18], "op": [6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 20], "t1": [6, 7, 9, 10, 11, 13], "t2": [6, 9, 10, 11, 13], "x": [6, 11, 14, 15], "const": [6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17], "y": [6, 11, 15], "comput": [6, 10, 11, 19], "wise": [6, 11], "absolut": 6, "store": [6, 10, 11], "result": [6, 8, 10, 11, 14, 15], "dimension": [6, 10, 11], "contain": [5, 6, 9, 10, 11, 12, 13, 14, 15, 16, 17, 20], "compat": [6, 10, 11], "scalar": [6, 7, 10, 11, 14, 15, 18], "tpetra": [5, 6, 8, 9, 10, 11, 12, 13, 14, 15, 18], "is_vector_tpetra": [5, 18], "is_vector_tpetra_block": [5, 18], "epetra": [5, 6, 8, 9, 10, 11, 12, 13, 14, 15, 18], "is_vector_epetra": [5, 18], "diag": [6, 10, 11, 12, 13], "span": [0, 6, 10, 11, 12, 13, 19], "subspan": [0, 6, 10, 11, 12, 13, 19], "base": [6, 9, 10, 11, 12, 13, 19, 20], "kokkko": [], "scalartyp": [7, 13], "add": [7, 20], "specifi": [7, 12], "diagon": [0, 7, 19], "is_sparse_matrix_eigen": [5, 18], "trait": [7, 13, 19], "scalar_typ": [7, 10, 13, 16, 17, 18], "entri": 7, "written": [7, 22], "alreadi": 7, "exist": [7, 18, 20], "make": [8, 18, 20, 21], "copi": [8, 9, 20], "It": 8, "exact": 8, "independ": [8, 9, 19], "teucho": [5, 8, 12, 13, 15, 16, 18], "is_dense_vector_teucho": [5, 18], "multi": [8, 9, 12, 13, 14, 18], "is_multi_vector_epetra": [5, 18], "is_multi_vector_tpetra": [5, 18], "is_multi_vector_tpetra_block": [5, 18], "thi": [8, 18, 19, 20, 22], "kernel": [8, 19, 20], "complet": 8, "befor": 8, "semant": [8, 19], "even": [8, 22], "default": [8, 19, 20, 21], "like": [8, 18, 20], "tpetrablock": 8, "mean": [8, 19], "let": 8, "auto": 8, "appli": 8, "after": 8, "call": 8, "NOT": [8, 22], "impact": 8, "And": 8, "For": [8, 18, 20, 21], "mv": 8, "implement": [8, 18, 19, 20], "constructor": 8, "data": [8, 18, 20, 21, 22], "shallow": 8, "first": [8, 19], "extent": [5, 8], "ident": 8, "deep": 8, "typenam": [9, 10, 16, 17, 18], "dest": 9, "src": 9, "dst": 9, "so": [9, 18, 19, 20], "fulli": 9, "same": 9, "two": [9, 10], "nativ": [5, 9, 20], "is_native_container_eigen": 5, "is_native_container_kokko": 5, "dotresult": 10, "veca": 10, "vecb": 10, "product": [5, 10, 19, 22], "alpha_t": [11, 14, 15], "beta_t": [11, 14, 15], "alpha": [11, 14, 15], "z": 11, "beta": [11, 14, 15], "denot": 11, "multipl": [11, 14, 15, 19], "objectin": 12, "size": 12, "along": 12, "axi": 12, "overwrit": 13, "A": [14, 15, 22], "a_typ": [14, 15], "x_type": 15, "y_type": 15, "nontranspos": [14, 15], "unus": [14, 15], "construct": [14, 15], "mode": 15, "transpos": [14, 15], "perform": [14, 15, 20], "accord": [14, 15], "indic": [14, 15], "combin": [15, 19], "is_expression_acting_on_eigen": 5, "other": [15, 16, 19, 22], "non": 15, "is_expression_acting_on_kokko": 5, "is_dense_matrix_teucho": [5, 18], "is_expression_column_acting_on_tpetra": 5, "mai": [15, 22], "column": 15, "introspect": 18, "One": [18, 19], "main": [18, 19, 20], "design": [18, 19], "arbitrari": 18, "via": [18, 19, 20], "also": [18, 20, 21], "special": [18, 19, 20, 22], "commonli": 18, "todo": [18, 20], "finish": 18, "most": 18, "import": 18, "thing": 18, "insid": [18, 19, 20], "understand": [18, 19], "purpos": [18, 22], "usag": 18, "pattern": 18, "c": [14, 18, 20, 21], "sever": [18, 19], "resourc": 18, "onlin": 18, "quot": 18, "bjarn": 18, "stroustrup": 18, "think": 18, "small": 18, "whose": [18, 19], "carri": 18, "inform": 18, "anoth": 18, "algorithm": 18, "polici": 18, "detail": [5, 18, 20], "gather": 18, "uniform": [18, 19], "wai": [18, 19, 20, 22], "compil": [18, 19, 20], "time": [18, 19], "enabl": [18, 19, 20, 21], "reason": [18, 20], "about": [5, 18], "kei": 18, "point": [18, 19, 20], "here": [18, 19, 20], "differ": [18, 19], "tpl": [18, 20], "varieti": [5, 18], "name": [18, 20, 22], "convent": 18, "nest": 18, "typedef": 18, "relat": [18, 21], "easi": 18, "access": [18, 20], "similar": 18, "variou": [18, 19], "what": [18, 19], "motiv": 18, "compon": [18, 19], "queri": 18, "current": [18, 19, 20], "few": 18, "trilino": [18, 20, 21], "enable_if_t": 18, "is_dynamic_vector_eigen": 18, "constexpr": 18, "int": [18, 20], "plai": 18, "role": 18, "when": [6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 18, 19, 20], "user": [18, 19, 20], "want": [18, 20, 21], "known": [18, 20], "presso": 18, "do": [18, 19, 20], "shoud": 18, "visibil": 18, "practic": 18, "how": [18, 19, 20], "see": [6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 18, 19, 20], "metafunct": 18, "more": [18, 19], "ad": 18, "continu": 18, "develop": [18, 19], "descript": [18, 19, 20, 21], "is_static_vector_eigen": 18, "requir": [18, 19, 21], "pressio_enable_tpl_eigen": [18, 21], "On": [18, 21], "dynam": 18, "spars": 18, "is_static_dense_matrix_eigen": 18, "is_dynamic_dense_matrix_eigen": 18, "pressio_enable_tpl_trilino": [18, 20, 21], "is_static_vector_kokko": 18, "pressio_enable_tpl_kokko": [18, 21], "is_dynamic_vector_kokko": 18, "is_static_dense_matrix_kokko": 18, "is_dynamic_dense_matrix_kokko": 18, "driven": 19, "still": 19, "critic": [], "describ": [], "notion": [], "core": 19, "our": 19, "approach": 19, "2011": [], "meaning": [], "axiom": [], "pure": [], "syntax": [19, 21], "check": [5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15], "20": [19, 21], "contrari": 21, "properti": [], "cannot": [19, 21], "spell": [], "fact": [], "invari": [], "assum": [], "hold": 5, "comment": [], "adopt": 19, "present": [], "believ": 19, "benefit": 19, "readabl": [], "explicitli": 19, "keyword": [], "note": [19, 20, 21], "howev": [19, 20, 22], "below": [5, 19, 20], "hard": 19, "iter": [], "get": [], "meaninng": [], "done": [19, 20], "matur": 19, "reflect": [], "correspond": 20, "document": [19, 22], "plu": [], "said": [], "met": 22, "ecosystem": 19, "work": [5, 14, 16, 19, 20], "wa": 19, "focu": 19, "reduc": 19, "order": 19, "model": 19, "rom": [19, 20], "strongli": 19, "multidisciplinari": 19, "topic": 19, "toward": 19, "level": 19, "capabl": [19, 20], "inevit": 19, "field": 19, "rang": 19, "g": [19, 20], "linear": 19, "algebra": 19, "nonlinear": 19, "solver": 19, "optim": 19, "integr": [19, 20], "distribut": [19, 22], "hpc": [19, 20], "constitut": 19, "substanti": 19, "challeng": 19, "tackl": 19, "complex": 19, "increas": 19, "aim": [19, 20], "ground": 19, "up": 19, "grow": [19, 20], "being": 19, "abl": 19, "modular": 19, "abstract": 19, "api": 19, "principl": 19, "reli": [19, 21], "effort": 19, "lead": 19, "highli": 19, "tabl": [5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 19], "stack": 19, "cover": 19, "specif": [19, 20, 22], "depend": [19, 21], "ones": 19, "consider": 19, "sinc": [19, 20, 21], "attent": 19, "easili": 19, "full": 19, "why": 19, "rather": 19, "than": [16, 19], "simpler": 19, "limit": [19, 22], "hide": 19, "structur": [19, 20, 21], "offer": 19, "major": 19, "would": [19, 20], "imposs": 19, "obtain": [19, 20], "flexibl": 19, "extens": 19, "usabl": 19, "own": 19, "drawback": 19, "might": 19, "reach": 19, "compar": 19, "solid": 19, "across": 19, "goal": 19, "version": [19, 20], "0": [19, 20], "od": 19, "pleas": 19, "keep": 19, "mind": 19, "while": 19, "code": [19, 20, 22], "notabl": 19, "extract": 19, "repositori": 19, "allow": [19, 20], "directli": [19, 20], "top": 19, "desir": [17, 19], "consid": 19, "within": [5, 19], "context": 19, "fit": [19, 22], "togeth": 19, "includ": [19, 20, 22], "off": [19, 20, 21], "content": 19, "s": [19, 21, 22], "share": 19, "detect": 19, "util": 19, "logger": 19, "etc": 19, "mpl": 19, "instal": 19, "should": [19, 20], "trivial": 19, "arguabl": 19, "foundat": 19, "humbl": 19, "sai": 19, "strive": 19, "earli": 19, "stage": [19, 20], "knowingli": 19, "write": [19, 20], "expect": [5, 19], "expos": 19, "sens": [19, 21], "formal": 19, "those": 19, "stabli": 19, "upgrad": 19, "guard": [19, 20], "preprocessor": [19, 20], "direct": [19, 20, 22], "ifdef": 19, "pressio_enable_cxx20": [19, 21], "compliant": 19, "set": [19, 20, 21], "dcmake_cxx_standard": 19, "configur": [19, 20], "behavior": 19, "enforc": 19, "stricto": 19, "sensu": 19, "discuss": 19, "disabl": [19, 20, 21], "14": 19, "constraint": [19, 20], "thei": 19, "sfina": 19, "assert": 19, "revis": 19, "them": 19, "proper": 19, "seem": 19, "incomplet": 19, "bsd": [19, 22], "3": [19, 20, 22], "avail": 19, "sooner": 19, "later": 19, "publish": 19, "meantim": 19, "arxiv": 19, "outdat": 19, "preprint": 19, "http": 19, "org": 19, "ab": [5, 19], "2003": 19, "07798": 19, "slack": 19, "pressioteam": 19, "com": 19, "open": 19, "issu": 19, "github": 19, "precompil": 20, "link": [5, 20], "condition": 20, "third": 20, "parti": 20, "account": 20, "17": [20, 21], "wide": 20, "possibl": [20, 22], "allevi": 20, "custom": 20, "decid": 20, "leverag": 20, "best": 20, "facilit": 20, "applic": [20, 21], "built": [5, 20], "extern": 20, "obvious": [20, 21], "preprecessor": 20, "cmake": 20, "variabl": [20, 21], "run": 20, "ci": 20, "7": 20, "commit": 20, "ef73d14babf6e7556b0420add98cce257ccaa56b": 20, "mpi": [20, 21], "bla": [20, 21], "lapack": [20, 21], "googletest": 20, "10": 20, "choic": [20, 21], "instanti": 20, "solv": 20, "problem": 20, "without": [20, 22], "clone": [5, 20], "branch": 20, "pick": 20, "releas": 20, "subdirectori": 20, "cd": 20, "mkdir": 20, "pass": 20, "comand": 20, "line": 20, "suppos": 20, "debug": [20, 21], "print": [20, 21], "export": 20, "pressio_src": 20, "d": 20, "cmake_install_prefix": 20, "ON": [20, 21, 22], "pressio_enable_debug_print": [20, 21], "noth": 20, "just": 20, "anyth": 20, "process": 20, "argument": 20, "prefix": [20, 21], "inspect": 20, "file": 20, "pressio_ops_cmake_config": 20, "h": 20, "remark": 20, "dure": 20, "abov": [20, 21, 22], "know": 20, "your": [20, 21], "system": 20, "simpli": 20, "tell": 20, "certain": [20, 22], "4": 20, "directori": [5, 20], "what_you_ne": 20, "someth": 20, "procedur": 20, "advis": [20, 22], "properli": 20, "turn": [20, 21], "condit": [20, 22], "explain": 20, "altern": 20, "repo": 20, "could": 20, "unexpect": 20, "consequ": 20, "respos": 20, "correctli": 20, "exactli": 20, "pressio_": 21, "sensit": 21, "recal": 21, "dkeyword_nam": 21, "control": 21, "self": 21, "explanatori": 21, "pressio_enable_tpl_mpi": 21, "automat": 21, "pressio_enable_teuchos_tim": 21, "leav": 21, "rest": 21, "connect": 21, "individuali": 21, "statement": 21, "pressio_enable_cxx17": 21, "min": [5, 21], "cmake_cxx_standard": 21, "copyright": 22, "2019": 22, "nation": 22, "technolog": 22, "engin": 22, "solut": 22, "sandia": 22, "llc": 22, "ntess": 22, "under": 22, "term": 22, "contract": 22, "de": 22, "na0003525": 22, "u": 22, "govern": 22, "retain": 22, "right": 22, "softwar": 22, "claus": 22, "redistribut": 22, "binari": 22, "form": 22, "modif": 22, "permit": 22, "notic": 22, "disclaim": 22, "reproduc": 22, "materi": 22, "neither": 22, "holder": 22, "nor": 22, "contributor": 22, "endors": 22, "promot": 22, "deriv": 22, "prior": 22, "permiss": 22, "IS": 22, "BY": 22, "THE": 22, "AND": 22, "AS": 22, "OR": 22, "impli": 22, "warranti": 22, "BUT": 22, "TO": 22, "OF": 22, "merchant": 22, "FOR": 22, "particular": 22, "IN": 22, "NO": 22, "event": 22, "shall": 22, "BE": 22, "liabl": 22, "indirect": 22, "incident": 22, "exemplari": 22, "consequenti": 22, "damag": 22, "procur": 22, "substitut": 22, "good": 22, "servic": 22, "loss": 22, "profit": 22, "busi": 22, "interrupt": 22, "caus": 22, "theori": 22, "liabil": 22, "strict": 22, "tort": 22, "neglig": 22, "aris": 22, "IF": 22, "SUCH": 22, "question": 22, "contact": 22, "francesco": 22, "rizzi": 22, "fnrizzi": 22, "gov": 22, "subspac": 19, "galerkin": 19, "steadi": 19, "unsteadi": 19, "lspg": 19, "rom_concept": 19, "rom_subspac": 19, "rom_galerkin_steadi": 19, "rom_galerkin_unsteadi": 19, "rom_lspg_steadi": 19, "rom_lspg_unsteadi": 19, "explicit": 19, "stepper": 19, "implicit": 19, "advance_": 19, "fnc": 19, "ode_concept": 19, "ode_steppers_explicit": 19, "ode_steppers_implicit": 19, "ode_advanc": 19, "solvers_nonlinear": 19, "newton": 19, "method": 19, "gauss": 19, "lev": 19, "marq": 19, "solvers_nonlinear_concept": 19, "solvers_nonlinear_newton": 19, "solvers_nonlinear_gaussnewton": 19, "solvers_nonlinear_levmarq": 19, "solvers_linear": 19, "node": 19, "add_to_diagon": 5, "deep_copi": 5, "dot": 5, "elementwise_multipli": 5, "fill": 5, "backend": 5, "both": 5, "throughout": 5, "confirm": 5, "is_matrix_eigen": [], "is_sparse_matrix_kokko": 5, "addition": 5, "checker": [], "navig": [], "boolean": [5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15], "homepag": [6, 7, 8, 9, 10, 11, 12, 13, 14, 15], "correct": [6, 7, 8, 9, 10, 11, 12, 13, 14, 15], "b_type": 14, "c_type": 14, "modea": 14, "modeb": 14, "matric": 14, "max": 5, "obj": 16, "maximum": 16, "minimum": 16, "arrai": 16, "l1": 17, "_1": 17, "sum_": 17, "a_i": 17, "norm": 5, "norm1": 17, "l2": 17, "norm2": 17, "mathbf": 17, "_2": 17, "sqrt": 17, "n": 17}, "objects": {}, "objtypes": {}, "objnames": {}, "titleterms": {"express": 0, "diagon": 1, "api": [1, 2, 3, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17], "descript": [1, 2, 3, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17], "span": 2, "subspan": 3, "mpl": 4, "scope": [4, 18], "pressio": [4, 19, 20], "all_of": 4, "any_of": 4, "none_of": 4, "is_subscriptable_a": 4, "op": [5, 19], "ab": 6, "add_to_diagon": 7, "note": [6, 7, 8, 9, 10, 11, 12, 13, 14, 15], "clone": 8, "deep_copi": 9, "dot": 10, "elementwise_multipli": 11, "extent": 12, "fill": 13, "product": [14, 15], "type_trait": 18, "trait": 18, "class": 18, "type": [5, 14, 18], "detect": 18, "identif": 18, "concept": 19, "more": [], "info": [], "syntact": [], "constraint": [], "semant": [], "satisfi": [], "vs": 20, "model": [], "c": 19, "librari": [19, 21], "get": [19, 20], "start": 19, "gener": 19, "program": 19, "licens": [19, 22], "citat": 19, "question": 19, "instal": 20, "depend": 20, "option": [20, 21], "requir": 20, "In": 20, "practic": 20, "what": 20, "ar": 20, "step": 20, "us": 20, "cmake": 21, "keyword": 21, "third": 21, "parti": 21, "tpl": 21, "other": 21, "navig": 5, "matrix": [14, 15], "vector": 15, "min": 16, "max": 16, "norm": 17}, "envversion": {"sphinx.domains.c": 2, "sphinx.domains.changeset": 1, "sphinx.domains.citation": 1, "sphinx.domains.cpp": 6, "sphinx.domains.index": 1, "sphinx.domains.javascript": 2, "sphinx.domains.math": 2, "sphinx.domains.python": 3, "sphinx.domains.rst": 2, "sphinx.domains.std": 2, "sphinx.ext.viewcode": 1, "sphinx.ext.intersphinx": 1, "sphinx": 56}}) \ No newline at end of file +Search.setIndex({"docnames": ["components/expressions", "components/expressions/diag", "components/expressions/span", "components/expressions/subspan", "components/mpl", "components/ops", "components/ops/abs", "components/ops/add_to_diagonal", "components/ops/clone", "components/ops/deep_copy", "components/ops/dot", "components/ops/elementwise_multiply", "components/ops/extent", "components/ops/fill", "components/ops/matrix_matrix_product", "components/ops/matrix_vector_product", "components/ops/min_max", "components/ops/norms", "components/ops/pow", "components/type_traits", "index", "installation", "keywords", "license", "mydefs"], "filenames": ["components/expressions.rst", "components/expressions/diag.rst", "components/expressions/span.rst", "components/expressions/subspan.rst", "components/mpl.rst", "components/ops.rst", "components/ops/abs.rst", "components/ops/add_to_diagonal.rst", "components/ops/clone.rst", "components/ops/deep_copy.rst", "components/ops/dot.rst", "components/ops/elementwise_multiply.rst", "components/ops/extent.rst", "components/ops/fill.rst", "components/ops/matrix_matrix_product.rst", "components/ops/matrix_vector_product.rst", "components/ops/min_max.rst", "components/ops/norms.rst", "components/ops/pow.rst", "components/type_traits.rst", "index.rst", "installation.rst", "keywords.rst", "license.rst", "mydefs.rst"], "titles": ["expressions", "diagonal", "span", "subspan", "mpl", "ops", "abs", "add_to_diagonal", "clone", "deep_copy", "dot", "elementwise_multiply", "extent", "fill", "matrix-matrix product", "matrix-vector product", "min & max", "norms", "pow", "type_traits", "pressio-ops C++ library", "Installation and Dependencies", "CMake Keywords", "License", "<no title>"], "terms": {"defin": [0, 1, 2, 3, 20, 21], "header": [0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 23], "pressio": [0, 1, 2, 3, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 22, 23], "hpp": [0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21], "public": [0, 4, 5, 19, 20], "namespac": [0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19], "we": [0, 19, 20, 21, 22], "refer": 0, "becaus": [0, 5, 20, 21], "each": [0, 3, 5, 6, 7, 13, 15, 18, 20], "function": [0, 4, 19, 20, 21], "doe": [0, 15, 20, 21], "alloc": [0, 8], "new": [0, 8], "memori": [0, 20], "onli": [0, 4, 20, 21, 22], "creat": [0, 8, 21], "an": [0, 1, 2, 3, 4, 6, 8, 9, 10, 11, 12, 13, 15, 19, 20, 21, 22], "instanc": [0, 4, 8], "class": [0, 1, 2, 3, 4, 6, 7, 8, 11, 12, 13, 14, 15, 18, 20], "repres": [0, 1, 2, 3, 20], "given": [0, 4, 5, 16, 17], "oper": [0, 4, 5, 8, 20, 21], "In": [0, 20], "all": [0, 4, 5, 7, 8, 9, 14, 15, 16, 20, 21, 22], "case": [0, 4, 19, 20, 22], "return": [0, 1, 2, 3, 4, 8, 10, 12, 16, 17], "remain": 0, "valid": [0, 20], "until": [0, 20], "its": [0, 20, 23], "operand": [0, 1, 2, 3, 6, 7, 8, 13], "goe": 0, "out": [0, 4, 23], "scope": [0, 20], "If": [0, 4, 7, 15, 21], "state": 0, "undefin": 0, "express": [1, 2, 3, 5, 6, 9, 10, 11, 12, 13, 15, 20, 23], "templat": [1, 2, 3, 4, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20], "t": [1, 2, 3, 4, 5, 7, 8, 9, 11, 12, 13, 14, 15, 16, 17, 18, 19], "impl": [1, 2, 3], "end": [1, 2, 3, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18], "take": [1, 2, 3, 20], "either": [1, 2, 3, 9, 14, 15], "squar": 1, "eigen": [1, 2, 3, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 19, 21, 22], "dens": [1, 3, 19, 20, 21], "matrix": [1, 3, 5, 7, 8, 12, 13, 19], "is_dense_matrix_eigen": [1, 3, 5, 19], "valu": [1, 2, 3, 4, 5, 6, 7, 8, 13, 16, 19], "true": [1, 2, 3, 4, 19], "kokko": [1, 2, 3, 5, 6, 8, 9, 10, 11, 12, 13, 14, 15, 19, 21, 22], "rank": [1, 2, 3, 5, 6, 7, 9, 10, 11, 13, 14, 15, 17, 18, 19], "2": [1, 3, 5, 7, 13, 14, 15, 17, 19, 23], "view": [1, 2, 3, 5, 6, 8, 9, 10, 11, 12, 13, 14, 15, 19], "i": [1, 2, 3, 6, 8, 10, 11, 12, 13, 17, 19], "e": [1, 2, 3, 6, 8, 10, 11, 12, 13, 19, 20, 21], "is_dense_matrix_kokko": [1, 3, 5, 19], "std": [2, 3, 4, 12, 19], "pair": [2, 3], "size_t": [2, 3, 12], "indexrang": 2, "vector": [2, 5, 6, 8, 9, 10, 11, 12, 13, 14, 18, 19], "object": [2, 3, 8, 12, 13, 19], "is_vector_eigen": [2, 5, 19], "1": [2, 5, 6, 10, 11, 13, 15, 17, 18, 19, 20, 21, 23], "is_vector_kokko": [2, 5, 19], "pairidentifi": 2, "interv": [2, 3], "b": [2, 14], "where": [2, 11, 21], "second": 2, "index": [2, 4], "exclus": 2, "target": [2, 21], "rowsrang": 3, "colsrang": 3, "well": [3, 20], "us": [3, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 19, 20, 22, 23], "dimens": [3, 12], "provid": [4, 10, 18, 19, 21, 23], "metaprogram": [4, 20], "need": [4, 19, 20, 21], "support": [4, 5, 15, 19, 20, 21], "gener": [4, 5, 19], "program": [4, 19], "which": [4, 8, 19, 20, 21, 22], "fundament": [4, 20], "build": [4, 20, 21], "block": [4, 5, 6, 8, 9, 10, 11, 12, 13, 14, 15, 19], "librari": [4, 19, 21], "you": [4, 5, 20, 21, 22], "ar": [4, 5, 7, 14, 15, 19, 20, 22, 23], "familiar": 4, "type_trait": [4, 20], "from": [4, 8, 9, 19, 20, 21, 23], "standard": [4, 19, 20, 22], "look": 4, "too": 4, "some": [4, 19, 20, 21, 22], "part": [4, 21], "have": [4, 6, 8, 9, 10, 11, 13, 14, 15, 19, 20, 21, 22], "been": [4, 20], "adapt": 4, "tinympl": 4, "project": [4, 20], "The": [4, 5, 14, 15, 19, 20, 21, 22], "appear": 4, "longer": 4, "maintain": [4, 20], "follow": [4, 5, 8, 12, 14, 15, 19, 20, 22, 23], "partial": [4, 19], "list": [4, 19, 21, 22, 23], "intend": 4, "idea": 4, "featur": [4, 5, 19], "To": [4, 19, 20, 21], "find": [4, 20], "brows": [4, 20], "sourc": [4, 23], "f": 4, "arg": 4, "struct": [4, 19], "determin": [4, 19], "whether": [4, 5, 23], "everi": 4, "element": [4, 6, 7, 9, 11, 13, 18, 20], "sequenc": 4, "satisfi": 4, "predic": 4, "must": [4, 6, 7, 8, 9, 10, 11, 12, 13, 17, 23], "convert": [4, 7, 13], "bool": 4, "static": [4, 19, 20], "member": [4, 19], "constant": [4, 19, 20], "equal": [4, 19], "iff": 4, "otherwis": [4, 10, 15, 18, 20, 23], "fals": 4, "exampl": [4, 8, 19, 20, 21, 22], "pmpl": 4, "static_assert": 4, "is_floating_point": 4, "doubl": 4, "float": 4, "ani": [4, 8, 17, 18, 20, 23], "least": [4, 20, 21], "one": [4, 6, 10, 11, 12, 19, 20, 21], "none": 4, "indextyp": [4, 12], "ha": [4, 7, 8, 12, 20, 21], "subscript": 4, "can": [4, 5, 8, 20, 21], "type": [4, 6, 7, 8, 9, 10, 11, 12, 13, 15, 16, 17, 18, 20], "void": [4, 6, 7, 9, 10, 11, 13, 14, 15, 18, 19], "op": [6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 21], "t1": [6, 7, 9, 10, 11, 13, 18], "t2": [6, 9, 10, 11, 13, 18], "x": [6, 11, 14, 15, 18], "const": [6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18], "y": [6, 11, 15, 18], "comput": [6, 10, 11, 20], "wise": [6, 11], "absolut": 6, "store": [6, 10, 11, 18], "result": [6, 8, 10, 11, 14, 15, 18], "dimension": [6, 10, 11], "contain": [5, 6, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 21], "compat": [6, 10, 11], "scalar": [6, 7, 10, 11, 14, 15, 19], "tpetra": [5, 6, 8, 9, 10, 11, 12, 13, 14, 15, 19], "is_vector_tpetra": [5, 19], "is_vector_tpetra_block": [5, 19], "epetra": [5, 6, 8, 9, 10, 11, 12, 13, 14, 15, 19], "is_vector_epetra": [5, 19], "diag": [6, 10, 11, 12, 13], "span": [0, 6, 10, 11, 12, 13, 20], "subspan": [0, 6, 10, 11, 12, 13, 20], "base": [6, 9, 10, 11, 12, 13, 20, 21], "kokkko": [], "scalartyp": [7, 13], "add": [7, 21], "specifi": [7, 12, 18], "diagon": [0, 7, 20], "is_sparse_matrix_eigen": [5, 19], "trait": [7, 13, 18, 20], "scalar_typ": [7, 10, 13, 16, 17, 18, 19], "entri": 7, "written": [7, 23], "alreadi": 7, "exist": [7, 19, 21], "make": [8, 19, 21, 22], "copi": [8, 9, 21], "It": 8, "exact": 8, "independ": [8, 9, 20], "teucho": [5, 8, 12, 13, 15, 16, 18, 19], "is_dense_vector_teucho": [5, 19], "multi": [8, 9, 12, 13, 14, 19], "is_multi_vector_epetra": [5, 19], "is_multi_vector_tpetra": [5, 19], "is_multi_vector_tpetra_block": [5, 19], "thi": [8, 19, 20, 21, 23], "kernel": [8, 20, 21], "complet": 8, "befor": 8, "semant": [8, 20], "even": [8, 23], "default": [8, 20, 21, 22], "like": [8, 19, 21], "tpetrablock": 8, "mean": [8, 20], "let": 8, "auto": 8, "appli": 8, "after": 8, "call": 8, "NOT": [8, 23], "impact": 8, "And": 8, "For": [8, 19, 21, 22], "mv": 8, "implement": [8, 19, 20, 21], "constructor": 8, "data": [8, 19, 21, 22, 23], "shallow": 8, "first": [8, 20], "extent": [5, 8], "ident": 8, "deep": 8, "typenam": [9, 10, 16, 17, 18, 19], "dest": 9, "src": 9, "dst": 9, "so": [9, 19, 20, 21], "fulli": 9, "same": 9, "two": [9, 10], "nativ": [5, 9, 21], "is_native_container_eigen": 5, "is_native_container_kokko": 5, "dotresult": 10, "veca": 10, "vecb": 10, "product": [5, 10, 20, 23], "alpha_t": [11, 14, 15], "beta_t": [11, 14, 15], "alpha": [11, 14, 15], "z": 11, "beta": [11, 14, 15], "denot": 11, "multipl": [11, 14, 15, 20], "objectin": 12, "size": 12, "along": 12, "axi": 12, "overwrit": 13, "A": [14, 15, 23], "a_typ": [14, 15], "x_type": 15, "y_type": 15, "nontranspos": [14, 15], "unus": [14, 15], "construct": [14, 15], "mode": 15, "transpos": [14, 15], "perform": [14, 15, 21], "accord": [14, 15], "indic": [14, 15], "combin": [15, 20], "is_expression_acting_on_eigen": 5, "other": [15, 16, 18, 20, 23], "non": 15, "is_expression_acting_on_kokko": 5, "is_dense_matrix_teucho": [5, 19], "is_expression_column_acting_on_tpetra": 5, "mai": [15, 18, 23], "column": 15, "introspect": 19, "One": [19, 20], "main": [19, 20, 21], "design": [19, 20], "arbitrari": 19, "via": [19, 20, 21], "also": [19, 21, 22], "special": [19, 20, 21, 23], "commonli": 19, "todo": [19, 21], "finish": 19, "most": 19, "import": 19, "thing": 19, "insid": [19, 20, 21], "understand": [19, 20], "purpos": [19, 23], "usag": 19, "pattern": 19, "c": [14, 19, 21, 22], "sever": [19, 20], "resourc": 19, "onlin": 19, "quot": 19, "bjarn": 19, "stroustrup": 19, "think": 19, "small": 19, "whose": [19, 20], "carri": 19, "inform": 19, "anoth": 19, "algorithm": 19, "polici": 19, "detail": [5, 19, 21], "gather": 19, "uniform": [19, 20], "wai": [19, 20, 21, 23], "compil": [19, 20, 21], "time": [19, 20], "enabl": [19, 20, 21, 22], "reason": [19, 21], "about": [5, 19], "kei": 19, "point": [19, 20, 21], "here": [19, 20, 21], "differ": [19, 20], "tpl": [19, 21], "varieti": [5, 19], "name": [19, 21, 23], "convent": 19, "nest": 19, "typedef": 19, "relat": [19, 22], "easi": 19, "access": [19, 21], "similar": 19, "variou": [19, 20], "what": [19, 20], "motiv": 19, "compon": [19, 20], "queri": 19, "current": [19, 20, 21], "few": 19, "trilino": [19, 21, 22], "enable_if_t": 19, "is_dynamic_vector_eigen": 19, "constexpr": 19, "int": [19, 21], "plai": 19, "role": 19, "when": [6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 19, 20, 21], "user": [19, 20, 21], "want": [19, 21, 22], "known": [19, 21], "presso": 19, "do": [19, 20, 21], "shoud": 19, "visibil": 19, "practic": 19, "how": [19, 20, 21], "see": [6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 19, 20, 21], "metafunct": 19, "more": [19, 20], "ad": 19, "continu": 19, "develop": [19, 20], "descript": [19, 20, 21, 22], "is_static_vector_eigen": 19, "requir": [19, 20, 22], "pressio_enable_tpl_eigen": [19, 22], "On": [19, 22], "dynam": 19, "spars": 19, "is_static_dense_matrix_eigen": 19, "is_dynamic_dense_matrix_eigen": 19, "pressio_enable_tpl_trilino": [19, 21, 22], "is_static_vector_kokko": 19, "pressio_enable_tpl_kokko": [19, 22], "is_dynamic_vector_kokko": 19, "is_static_dense_matrix_kokko": 19, "is_dynamic_dense_matrix_kokko": 19, "driven": 20, "still": 20, "critic": [], "describ": [], "notion": [], "core": 20, "our": 20, "approach": 20, "2011": [], "meaning": [], "axiom": [], "pure": [], "syntax": [20, 22], "check": [5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15], "20": [20, 22], "contrari": 22, "properti": [], "cannot": [20, 22], "spell": [], "fact": [], "invari": [], "assum": [], "hold": 5, "comment": [], "adopt": 20, "present": [], "believ": 20, "benefit": 20, "readabl": [], "explicitli": 20, "keyword": [], "note": [20, 21, 22], "howev": [20, 21, 23], "below": [5, 20, 21], "hard": 20, "iter": [], "get": [], "meaninng": [], "done": [20, 21], "matur": 20, "reflect": [], "correspond": 21, "document": [20, 23], "plu": [], "said": [], "met": 23, "ecosystem": 20, "work": [5, 14, 16, 20, 21], "wa": 20, "focu": 20, "reduc": 20, "order": 20, "model": 20, "rom": [20, 21], "strongli": 20, "multidisciplinari": 20, "topic": 20, "toward": 20, "level": 20, "capabl": [20, 21], "inevit": 20, "field": 20, "rang": 20, "g": [20, 21], "linear": 20, "algebra": 20, "nonlinear": 20, "solver": 20, "optim": 20, "integr": [20, 21], "distribut": [20, 23], "hpc": [20, 21], "constitut": 20, "substanti": 20, "challeng": 20, "tackl": 20, "complex": 20, "increas": 20, "aim": [20, 21], "ground": 20, "up": 20, "grow": [20, 21], "being": 20, "abl": 20, "modular": 20, "abstract": 20, "api": 20, "principl": 20, "reli": [20, 22], "effort": 20, "lead": 20, "highli": 20, "tabl": [5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 20], "stack": 20, "cover": 20, "specif": [20, 21, 23], "depend": [20, 22], "ones": 20, "consider": 20, "sinc": [20, 21, 22], "attent": 20, "easili": 20, "full": 20, "why": 20, "rather": 20, "than": [16, 18, 20], "simpler": 20, "limit": [20, 23], "hide": 20, "structur": [20, 21, 22], "offer": 20, "major": 20, "would": [20, 21], "imposs": 20, "obtain": [20, 21], "flexibl": 20, "extens": 20, "usabl": 20, "own": 20, "drawback": 20, "might": 20, "reach": 20, "compar": 20, "solid": 20, "across": 20, "goal": 20, "version": [20, 21], "0": [18, 20, 21], "od": 20, "pleas": 20, "keep": 20, "mind": 20, "while": 20, "code": [20, 21, 23], "notabl": 20, "extract": 20, "repositori": 20, "allow": [20, 21], "directli": [20, 21], "top": 20, "desir": [17, 20], "consid": 20, "within": [5, 20], "context": 20, "fit": [20, 23], "togeth": 20, "includ": [20, 21, 23], "off": [20, 21, 22], "content": 20, "s": [20, 22, 23], "share": 20, "detect": 20, "util": 20, "logger": 20, "etc": 20, "mpl": 20, "instal": 20, "should": [20, 21], "trivial": 20, "arguabl": 20, "foundat": 20, "humbl": 20, "sai": 20, "strive": 20, "earli": 20, "stage": [20, 21], "knowingli": 20, "write": [20, 21], "expect": [5, 20], "expos": 20, "sens": [20, 22], "formal": 20, "those": 20, "stabli": 20, "upgrad": 20, "guard": [20, 21], "preprocessor": [20, 21], "direct": [20, 21, 23], "ifdef": 20, "pressio_enable_cxx20": [20, 22], "compliant": 20, "set": [20, 21, 22], "dcmake_cxx_standard": 20, "configur": [20, 21], "behavior": 20, "enforc": 20, "stricto": 20, "sensu": 20, "discuss": 20, "disabl": [20, 21, 22], "14": 20, "constraint": [20, 21], "thei": 20, "sfina": 20, "assert": 20, "revis": 20, "them": 20, "proper": 20, "seem": 20, "incomplet": 20, "bsd": [20, 23], "3": [20, 21, 23], "avail": 20, "sooner": 20, "later": 20, "publish": 20, "meantim": 20, "arxiv": 20, "outdat": 20, "preprint": 20, "http": 20, "org": 20, "ab": [5, 20], "2003": 20, "07798": 20, "slack": 20, "pressioteam": 20, "com": 20, "open": 20, "issu": 20, "github": 20, "precompil": 21, "link": [5, 21], "condition": 21, "third": 21, "parti": 21, "account": 21, "17": [21, 22], "wide": 21, "possibl": [21, 23], "allevi": 21, "custom": 21, "decid": 21, "leverag": 21, "best": 21, "facilit": 21, "applic": [21, 22], "built": [5, 21], "extern": 21, "obvious": [21, 22], "preprecessor": 21, "cmake": 21, "variabl": [21, 22], "run": 21, "ci": 21, "7": 21, "commit": 21, "ef73d14babf6e7556b0420add98cce257ccaa56b": 21, "mpi": [21, 22], "bla": [21, 22], "lapack": [21, 22], "googletest": 21, "10": 21, "choic": [21, 22], "instanti": 21, "solv": 21, "problem": 21, "without": [21, 23], "clone": [5, 21], "branch": 21, "pick": 21, "releas": 21, "subdirectori": 21, "cd": 21, "mkdir": 21, "pass": 21, "comand": 21, "line": 21, "suppos": 21, "debug": [21, 22], "print": [21, 22], "export": 21, "pressio_src": 21, "d": 21, "cmake_install_prefix": 21, "ON": [21, 22, 23], "pressio_enable_debug_print": [21, 22], "noth": 21, "just": 21, "anyth": 21, "process": 21, "argument": 21, "prefix": [21, 22], "inspect": 21, "file": 21, "pressio_ops_cmake_config": 21, "h": 21, "remark": 21, "dure": 21, "abov": [21, 22, 23], "know": 21, "your": [21, 22], "system": 21, "simpli": 21, "tell": 21, "certain": [21, 23], "4": 21, "directori": [5, 21], "what_you_ne": 21, "someth": 21, "procedur": 21, "advis": [21, 23], "properli": 21, "turn": [21, 22], "condit": [21, 23], "explain": 21, "altern": 21, "repo": 21, "could": 21, "unexpect": 21, "consequ": 21, "respos": 21, "correctli": 21, "exactli": 21, "pressio_": 22, "sensit": 22, "recal": 22, "dkeyword_nam": 22, "control": 22, "self": 22, "explanatori": 22, "pressio_enable_tpl_mpi": 22, "automat": 22, "pressio_enable_teuchos_tim": 22, "leav": 22, "rest": 22, "connect": 22, "individuali": 22, "statement": 22, "pressio_enable_cxx17": 22, "min": [5, 22], "cmake_cxx_standard": 22, "copyright": 23, "2019": 23, "nation": 23, "technolog": 23, "engin": 23, "solut": 23, "sandia": 23, "llc": 23, "ntess": 23, "under": 23, "term": 23, "contract": 23, "de": 23, "na0003525": 23, "u": 23, "govern": 23, "retain": 23, "right": 23, "softwar": 23, "claus": 23, "redistribut": 23, "binari": 23, "form": 23, "modif": 23, "permit": 23, "notic": 23, "disclaim": 23, "reproduc": 23, "materi": 23, "neither": 23, "holder": 23, "nor": 23, "contributor": 23, "endors": 23, "promot": 23, "deriv": 23, "prior": 23, "permiss": 23, "IS": 23, "BY": 23, "THE": 23, "AND": 23, "AS": 23, "OR": 23, "impli": 23, "warranti": 23, "BUT": 23, "TO": 23, "OF": 23, "merchant": 23, "FOR": 23, "particular": 23, "IN": 23, "NO": 23, "event": 23, "shall": 23, "BE": 23, "liabl": 23, "indirect": 23, "incident": 23, "exemplari": 23, "consequenti": 23, "damag": 23, "procur": 23, "substitut": 23, "good": 23, "servic": 23, "loss": 23, "profit": 23, "busi": 23, "interrupt": 23, "caus": 23, "theori": 23, "liabil": 23, "strict": 23, "tort": 23, "neglig": 23, "aris": 23, "IF": 23, "SUCH": 23, "question": 23, "contact": 23, "francesco": 23, "rizzi": 23, "fnrizzi": 23, "gov": 23, "subspac": 20, "galerkin": 20, "steadi": 20, "unsteadi": 20, "lspg": 20, "rom_concept": 20, "rom_subspac": 20, "rom_galerkin_steadi": 20, "rom_galerkin_unsteadi": 20, "rom_lspg_steadi": 20, "rom_lspg_unsteadi": 20, "explicit": 20, "stepper": 20, "implicit": 20, "advance_": 20, "fnc": 20, "ode_concept": 20, "ode_steppers_explicit": 20, "ode_steppers_implicit": 20, "ode_advanc": 20, "solvers_nonlinear": 20, "newton": 20, "method": 20, "gauss": 20, "lev": 20, "marq": 20, "solvers_nonlinear_concept": 20, "solvers_nonlinear_newton": 20, "solvers_nonlinear_gaussnewton": 20, "solvers_nonlinear_levmarq": 20, "solvers_linear": 20, "node": 20, "add_to_diagon": 5, "deep_copi": 5, "dot": 5, "elementwise_multipli": 5, "fill": 5, "backend": 5, "both": 5, "throughout": 5, "confirm": 5, "is_matrix_eigen": [], "is_sparse_matrix_kokko": 5, "addition": 5, "checker": [], "navig": [], "boolean": [5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15], "homepag": [6, 7, 8, 9, 10, 11, 12, 13, 14, 15], "correct": [6, 7, 8, 9, 10, 11, 12, 13, 14, 15], "b_type": 14, "c_type": 14, "modea": 14, "modeb": 14, "matric": 14, "max": 5, "obj": 16, "maximum": 16, "minimum": 16, "arrai": 16, "l1": 17, "_1": 17, "sum_": 17, "a_i": 17, "norm": 5, "norm1": 17, "l2": 17, "norm2": 17, "mathbf": 17, "_2": 17, "sqrt": 17, "n": 17, "expon": 18, "abs_pow": 18, "ep": 18, "rais": 18, "power": 18, "act": 18, "place": 18, "pow": 5}, "objects": {}, "objtypes": {}, "objnames": {}, "titleterms": {"express": 0, "diagon": 1, "api": [1, 2, 3, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18], "descript": [1, 2, 3, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18], "span": 2, "subspan": 3, "mpl": 4, "scope": [4, 19], "pressio": [4, 20, 21], "all_of": 4, "any_of": 4, "none_of": 4, "is_subscriptable_a": 4, "op": [5, 20], "ab": 6, "add_to_diagon": 7, "note": [6, 7, 8, 9, 10, 11, 12, 13, 14, 15], "clone": 8, "deep_copi": 9, "dot": 10, "elementwise_multipli": 11, "extent": 12, "fill": 13, "product": [14, 15], "type_trait": 19, "trait": 19, "class": 19, "type": [5, 14, 19], "detect": 19, "identif": 19, "concept": 20, "more": [], "info": [], "syntact": [], "constraint": [], "semant": [], "satisfi": [], "vs": 21, "model": [], "c": 20, "librari": [20, 22], "get": [20, 21], "start": 20, "gener": 20, "program": 20, "licens": [20, 23], "citat": 20, "question": 20, "instal": 21, "depend": 21, "option": [21, 22], "requir": 21, "In": 21, "practic": 21, "what": 21, "ar": 21, "step": 21, "us": 21, "cmake": 22, "keyword": 22, "third": 22, "parti": 22, "tpl": 22, "other": 22, "navig": 5, "matrix": [14, 15], "vector": 15, "min": 16, "max": 16, "norm": 17, "pow": 18}, "envversion": {"sphinx.domains.c": 2, "sphinx.domains.changeset": 1, "sphinx.domains.citation": 1, "sphinx.domains.cpp": 6, "sphinx.domains.index": 1, "sphinx.domains.javascript": 2, "sphinx.domains.math": 2, "sphinx.domains.python": 3, "sphinx.domains.rst": 2, "sphinx.domains.std": 2, "sphinx.ext.viewcode": 1, "sphinx.ext.intersphinx": 1, "sphinx": 56}}) \ No newline at end of file diff --git a/docs/source/components/ops.rst b/docs/source/components/ops.rst index b105021..eaebc9e 100644 --- a/docs/source/components/ops.rst +++ b/docs/source/components/ops.rst @@ -94,3 +94,4 @@ Use the links below to view details about each operation. ops/matrix_matrix_product ops/min_max ops/norms + ops/pow From 80c8dcde91a8732830b3fc7dab87c7fbfaac37c4 Mon Sep 17 00:00:00 2001 From: Caleb Schilly Date: Mon, 28 Oct 2024 09:42:09 -0400 Subject: [PATCH 5/9] #6: remove generated docs from GH --- docs/generated_docs/.buildinfo | 4 - .../.doctrees/components/expressions.doctree | Bin 4305 -> 0 bytes .../components/expressions/diag.doctree | Bin 6912 -> 0 bytes .../components/expressions/span.doctree | Bin 8861 -> 0 bytes .../components/expressions/subspan.doctree | Bin 8527 -> 0 bytes .../.doctrees/components/mpl.doctree | Bin 18352 -> 0 bytes .../.doctrees/components/ops.doctree | Bin 16801 -> 0 bytes .../.doctrees/components/ops/abs.doctree | Bin 9281 -> 0 bytes .../components/ops/add_to_diagonal.doctree | Bin 7992 -> 0 bytes .../.doctrees/components/ops/clone.doctree | Bin 13693 -> 0 bytes .../components/ops/deep_copy.doctree | Bin 10282 -> 0 bytes .../.doctrees/components/ops/dot.doctree | Bin 10270 -> 0 bytes .../ops/elementwise_multiply.doctree | Bin 10175 -> 0 bytes .../.doctrees/components/ops/extent.doctree | Bin 9532 -> 0 bytes .../.doctrees/components/ops/fill.doctree | Bin 10131 -> 0 bytes .../ops/matrix_matrix_product.doctree | Bin 14402 -> 0 bytes .../ops/matrix_vector_product.doctree | Bin 22090 -> 0 bytes .../.doctrees/components/ops/min_max.doctree | Bin 5383 -> 0 bytes .../.doctrees/components/ops/norms.doctree | Bin 6459 -> 0 bytes .../.doctrees/components/ops/pow.doctree | Bin 7208 -> 0 bytes .../.doctrees/components/ops/product.doctree | Bin 21992 -> 0 bytes .../.doctrees/components/type_traits.doctree | Bin 52129 -> 0 bytes .../.doctrees/concepts_note.doctree | Bin 12810 -> 0 bytes .../.doctrees/environment.pickle | Bin 66122 -> 0 bytes docs/generated_docs/.doctrees/index.doctree | Bin 45045 -> 0 bytes .../.doctrees/installation.doctree | Bin 24670 -> 0 bytes .../generated_docs/.doctrees/keywords.doctree | Bin 15355 -> 0 bytes docs/generated_docs/.doctrees/license.doctree | Bin 6803 -> 0 bytes docs/generated_docs/.doctrees/mydefs.doctree | Bin 2943 -> 0 bytes .../_sources/components/expressions.rst.txt | 19 - .../components/expressions/diag.rst.txt | 29 - .../components/expressions/span.rst.txt | 36 - .../components/expressions/subspan.rst.txt | 33 - .../_sources/components/mpl.rst.txt | 114 - .../_sources/components/ops.rst.txt | 97 - .../_sources/components/ops/abs.rst.txt | 44 - .../components/ops/add_to_diagonal.rst.txt | 34 - .../_sources/components/ops/clone.rst.txt | 66 - .../_sources/components/ops/deep_copy.rst.txt | 46 - .../_sources/components/ops/dot.rst.txt | 47 - .../ops/elementwise_multiply.rst.txt | 48 - .../_sources/components/ops/extent.rst.txt | 44 - .../_sources/components/ops/fill.rst.txt | 46 - .../ops/matrix_matrix_product.rst.txt | 88 - .../ops/matrix_vector_product.rst.txt | 112 - .../_sources/components/ops/min_max.rst.txt | 28 - .../_sources/components/ops/norms.rst.txt | 42 - .../_sources/components/ops/pow.rst.txt | 47 - .../_sources/components/ops/product.rst.txt | 112 - .../_sources/components/type_traits.rst.txt | 130 - .../_sources/concepts_note.rst.txt | 78 - docs/generated_docs/_sources/index.rst.txt | 202 - .../_sources/installation.rst.txt | 142 - docs/generated_docs/_sources/keywords.rst.txt | 83 - docs/generated_docs/_sources/license.rst.txt | 51 - docs/generated_docs/_sources/mydefs.rst.txt | 50 - .../_sphinx_javascript_frameworks_compat.js | 134 - docs/generated_docs/_static/basic.css | 932 -- docs/generated_docs/_static/check-solid.svg | 4 - docs/generated_docs/_static/clipboard.min.js | 7 - docs/generated_docs/_static/copy-button.svg | 5 - docs/generated_docs/_static/copybutton.css | 93 - docs/generated_docs/_static/copybutton.js | 220 - .../_static/copybutton_funcs.js | 58 - docs/generated_docs/_static/debug.css | 69 - docs/generated_docs/_static/doctools.js | 264 - .../_static/documentation_options.js | 14 - docs/generated_docs/_static/file.png | Bin 286 -> 0 bytes .../front_page_schematic/frontpageschem.pdf | Bin 94135 -> 0 bytes .../front_page_schematic/frontpageschem.svg | 866 -- .../front_page_schematic/frontpageschem.tex | 359 - .../generated_docs/_static/frontpageschem.svg | 866 -- docs/generated_docs/_static/hacks.css | 170 - docs/generated_docs/_static/jquery-3.6.0.js | 10881 ---------------- docs/generated_docs/_static/jquery.js | 2 - docs/generated_docs/_static/language_data.js | 199 - docs/generated_docs/_static/logo.png | Bin 7521 -> 0 bytes docs/generated_docs/_static/minus.png | Bin 90 -> 0 bytes docs/generated_docs/_static/plus.png | Bin 90 -> 0 bytes docs/generated_docs/_static/pygments.css | 258 - .../_static/scripts/furo-extensions.js | 0 docs/generated_docs/_static/scripts/furo.js | 3 - .../_static/scripts/furo.js.LICENSE.txt | 7 - .../_static/scripts/furo.js.map | 1 - docs/generated_docs/_static/searchtools.js | 531 - docs/generated_docs/_static/skeleton.css | 296 - .../_static/styles/furo-extensions.css | 2 - .../_static/styles/furo-extensions.css.map | 1 - docs/generated_docs/_static/styles/furo.css | 2 - .../_static/styles/furo.css.map | 1 - .../_static/underscore-1.13.1.js | 2042 --- docs/generated_docs/_static/underscore.js | 6 - .../components/expressions.html | 311 - .../components/expressions/diag.html | 344 - .../components/expressions/span.html | 352 - .../components/expressions/subspan.html | 352 - docs/generated_docs/components/mpl.html | 394 - docs/generated_docs/components/ops.html | 423 - docs/generated_docs/components/ops/abs.html | 354 - .../components/ops/add_to_diagonal.html | 346 - docs/generated_docs/components/ops/clone.html | 372 - .../components/ops/deep_copy.html | 359 - docs/generated_docs/components/ops/dot.html | 360 - .../components/ops/elementwise_multiply.html | 359 - .../generated_docs/components/ops/extent.html | 354 - docs/generated_docs/components/ops/fill.html | 355 - .../components/ops/matrix_matrix_product.html | 402 - .../components/ops/matrix_vector_product.html | 429 - .../components/ops/min_max.html | 342 - docs/generated_docs/components/ops/norms.html | 360 - docs/generated_docs/components/ops/pow.html | 343 - .../components/ops/product.html | 428 - .../components/type_traits.html | 450 - docs/generated_docs/concepts_note.html | 312 - docs/generated_docs/genindex.html | 284 - docs/generated_docs/index.html | 480 - docs/generated_docs/installation.html | 462 - docs/generated_docs/keywords.html | 408 - docs/generated_docs/license.html | 336 - docs/generated_docs/mydefs.html | 277 - docs/generated_docs/objects.inv | Bin 609 -> 0 bytes docs/generated_docs/search.html | 292 - docs/generated_docs/searchindex.js | 1 - 123 files changed, 30806 deletions(-) delete mode 100644 docs/generated_docs/.buildinfo delete mode 100644 docs/generated_docs/.doctrees/components/expressions.doctree delete mode 100644 docs/generated_docs/.doctrees/components/expressions/diag.doctree delete mode 100644 docs/generated_docs/.doctrees/components/expressions/span.doctree delete mode 100644 docs/generated_docs/.doctrees/components/expressions/subspan.doctree delete mode 100644 docs/generated_docs/.doctrees/components/mpl.doctree delete mode 100644 docs/generated_docs/.doctrees/components/ops.doctree delete mode 100644 docs/generated_docs/.doctrees/components/ops/abs.doctree delete mode 100644 docs/generated_docs/.doctrees/components/ops/add_to_diagonal.doctree delete mode 100644 docs/generated_docs/.doctrees/components/ops/clone.doctree delete mode 100644 docs/generated_docs/.doctrees/components/ops/deep_copy.doctree delete mode 100644 docs/generated_docs/.doctrees/components/ops/dot.doctree delete mode 100644 docs/generated_docs/.doctrees/components/ops/elementwise_multiply.doctree delete mode 100644 docs/generated_docs/.doctrees/components/ops/extent.doctree delete mode 100644 docs/generated_docs/.doctrees/components/ops/fill.doctree delete mode 100644 docs/generated_docs/.doctrees/components/ops/matrix_matrix_product.doctree delete mode 100644 docs/generated_docs/.doctrees/components/ops/matrix_vector_product.doctree delete mode 100644 docs/generated_docs/.doctrees/components/ops/min_max.doctree delete mode 100644 docs/generated_docs/.doctrees/components/ops/norms.doctree delete mode 100644 docs/generated_docs/.doctrees/components/ops/pow.doctree delete mode 100644 docs/generated_docs/.doctrees/components/ops/product.doctree delete mode 100644 docs/generated_docs/.doctrees/components/type_traits.doctree delete mode 100644 docs/generated_docs/.doctrees/concepts_note.doctree delete mode 100644 docs/generated_docs/.doctrees/environment.pickle delete mode 100644 docs/generated_docs/.doctrees/index.doctree delete mode 100644 docs/generated_docs/.doctrees/installation.doctree delete mode 100644 docs/generated_docs/.doctrees/keywords.doctree delete mode 100644 docs/generated_docs/.doctrees/license.doctree delete mode 100644 docs/generated_docs/.doctrees/mydefs.doctree delete mode 100644 docs/generated_docs/_sources/components/expressions.rst.txt delete mode 100644 docs/generated_docs/_sources/components/expressions/diag.rst.txt delete mode 100644 docs/generated_docs/_sources/components/expressions/span.rst.txt delete mode 100644 docs/generated_docs/_sources/components/expressions/subspan.rst.txt delete mode 100644 docs/generated_docs/_sources/components/mpl.rst.txt delete mode 100644 docs/generated_docs/_sources/components/ops.rst.txt delete mode 100644 docs/generated_docs/_sources/components/ops/abs.rst.txt delete mode 100644 docs/generated_docs/_sources/components/ops/add_to_diagonal.rst.txt delete mode 100644 docs/generated_docs/_sources/components/ops/clone.rst.txt delete mode 100644 docs/generated_docs/_sources/components/ops/deep_copy.rst.txt delete mode 100644 docs/generated_docs/_sources/components/ops/dot.rst.txt delete mode 100644 docs/generated_docs/_sources/components/ops/elementwise_multiply.rst.txt delete mode 100644 docs/generated_docs/_sources/components/ops/extent.rst.txt delete mode 100644 docs/generated_docs/_sources/components/ops/fill.rst.txt delete mode 100644 docs/generated_docs/_sources/components/ops/matrix_matrix_product.rst.txt delete mode 100644 docs/generated_docs/_sources/components/ops/matrix_vector_product.rst.txt delete mode 100644 docs/generated_docs/_sources/components/ops/min_max.rst.txt delete mode 100644 docs/generated_docs/_sources/components/ops/norms.rst.txt delete mode 100644 docs/generated_docs/_sources/components/ops/pow.rst.txt delete mode 100644 docs/generated_docs/_sources/components/ops/product.rst.txt delete mode 100644 docs/generated_docs/_sources/components/type_traits.rst.txt delete mode 100644 docs/generated_docs/_sources/concepts_note.rst.txt delete mode 100644 docs/generated_docs/_sources/index.rst.txt delete mode 100644 docs/generated_docs/_sources/installation.rst.txt delete mode 100644 docs/generated_docs/_sources/keywords.rst.txt delete mode 100644 docs/generated_docs/_sources/license.rst.txt delete mode 100644 docs/generated_docs/_sources/mydefs.rst.txt delete mode 100644 docs/generated_docs/_static/_sphinx_javascript_frameworks_compat.js delete mode 100644 docs/generated_docs/_static/basic.css delete mode 100644 docs/generated_docs/_static/check-solid.svg delete mode 100644 docs/generated_docs/_static/clipboard.min.js delete mode 100644 docs/generated_docs/_static/copy-button.svg delete mode 100644 docs/generated_docs/_static/copybutton.css delete mode 100644 docs/generated_docs/_static/copybutton.js delete mode 100644 docs/generated_docs/_static/copybutton_funcs.js delete mode 100644 docs/generated_docs/_static/debug.css delete mode 100644 docs/generated_docs/_static/doctools.js delete mode 100644 docs/generated_docs/_static/documentation_options.js delete mode 100644 docs/generated_docs/_static/file.png delete mode 100644 docs/generated_docs/_static/front_page_schematic/frontpageschem.pdf delete mode 100644 docs/generated_docs/_static/front_page_schematic/frontpageschem.svg delete mode 100644 docs/generated_docs/_static/front_page_schematic/frontpageschem.tex delete mode 100644 docs/generated_docs/_static/frontpageschem.svg delete mode 100644 docs/generated_docs/_static/hacks.css delete mode 100644 docs/generated_docs/_static/jquery-3.6.0.js delete mode 100644 docs/generated_docs/_static/jquery.js delete mode 100644 docs/generated_docs/_static/language_data.js delete mode 100644 docs/generated_docs/_static/logo.png delete mode 100644 docs/generated_docs/_static/minus.png delete mode 100644 docs/generated_docs/_static/plus.png delete mode 100644 docs/generated_docs/_static/pygments.css delete mode 100644 docs/generated_docs/_static/scripts/furo-extensions.js delete mode 100644 docs/generated_docs/_static/scripts/furo.js delete mode 100644 docs/generated_docs/_static/scripts/furo.js.LICENSE.txt delete mode 100644 docs/generated_docs/_static/scripts/furo.js.map delete mode 100644 docs/generated_docs/_static/searchtools.js delete mode 100644 docs/generated_docs/_static/skeleton.css delete mode 100644 docs/generated_docs/_static/styles/furo-extensions.css delete mode 100644 docs/generated_docs/_static/styles/furo-extensions.css.map delete mode 100644 docs/generated_docs/_static/styles/furo.css delete mode 100644 docs/generated_docs/_static/styles/furo.css.map delete mode 100644 docs/generated_docs/_static/underscore-1.13.1.js delete mode 100644 docs/generated_docs/_static/underscore.js delete mode 100644 docs/generated_docs/components/expressions.html delete mode 100644 docs/generated_docs/components/expressions/diag.html delete mode 100644 docs/generated_docs/components/expressions/span.html delete mode 100644 docs/generated_docs/components/expressions/subspan.html delete mode 100644 docs/generated_docs/components/mpl.html delete mode 100644 docs/generated_docs/components/ops.html delete mode 100644 docs/generated_docs/components/ops/abs.html delete mode 100644 docs/generated_docs/components/ops/add_to_diagonal.html delete mode 100644 docs/generated_docs/components/ops/clone.html delete mode 100644 docs/generated_docs/components/ops/deep_copy.html delete mode 100644 docs/generated_docs/components/ops/dot.html delete mode 100644 docs/generated_docs/components/ops/elementwise_multiply.html delete mode 100644 docs/generated_docs/components/ops/extent.html delete mode 100644 docs/generated_docs/components/ops/fill.html delete mode 100644 docs/generated_docs/components/ops/matrix_matrix_product.html delete mode 100644 docs/generated_docs/components/ops/matrix_vector_product.html delete mode 100644 docs/generated_docs/components/ops/min_max.html delete mode 100644 docs/generated_docs/components/ops/norms.html delete mode 100644 docs/generated_docs/components/ops/pow.html delete mode 100644 docs/generated_docs/components/ops/product.html delete mode 100644 docs/generated_docs/components/type_traits.html delete mode 100644 docs/generated_docs/concepts_note.html delete mode 100644 docs/generated_docs/genindex.html delete mode 100644 docs/generated_docs/index.html delete mode 100644 docs/generated_docs/installation.html delete mode 100644 docs/generated_docs/keywords.html delete mode 100644 docs/generated_docs/license.html delete mode 100644 docs/generated_docs/mydefs.html delete mode 100644 docs/generated_docs/objects.inv delete mode 100644 docs/generated_docs/search.html delete mode 100644 docs/generated_docs/searchindex.js diff --git a/docs/generated_docs/.buildinfo b/docs/generated_docs/.buildinfo deleted file mode 100644 index 7b896ba..0000000 --- a/docs/generated_docs/.buildinfo +++ /dev/null @@ -1,4 +0,0 @@ -# Sphinx build info version 1 -# This file hashes the configuration used when building these files. When it is not found, a full rebuild will be done. -config: 2c24ea7424d95996344878a5c2dcb9b7 -tags: 645f666f9bcd5a90fca523b33c5a78b7 diff --git a/docs/generated_docs/.doctrees/components/expressions.doctree b/docs/generated_docs/.doctrees/components/expressions.doctree deleted file mode 100644 index baa2f53aee0cb68046a838af2d4cad79be5263f7..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 4305 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 JuJxqb`Y)U+nA-pV diff --git a/docs/generated_docs/.doctrees/components/expressions/subspan.doctree b/docs/generated_docs/.doctrees/components/expressions/subspan.doctree deleted file mode 100644 index 9cea2cb0d3328b0bb86403e6b68dc161e7b881eb..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 8527 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 aQLNm@zcl}Pj(6EOi-LhdVX~P diff --git a/docs/generated_docs/.doctrees/components/ops.doctree b/docs/generated_docs/.doctrees/components/ops.doctree deleted file mode 100644 index 8d3de585fe2c3ca680c3810a614b0c2540bfdff2..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 16801 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 C(JrX~ diff --git a/docs/generated_docs/.doctrees/components/ops/add_to_diagonal.doctree b/docs/generated_docs/.doctrees/components/ops/add_to_diagonal.doctree deleted file mode 100644 index 2574beec81f32d657e805b7acb89c210342cfb08..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 7992 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 Qm^37pT6iCd^x2^MD+tR|y#N3J diff --git a/docs/generated_docs/.doctrees/components/ops/deep_copy.doctree b/docs/generated_docs/.doctrees/components/ops/deep_copy.doctree deleted file mode 100644 index 2803c93f958398ee4ab3af996b39c1ed604f5126..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 10282 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 U&)&}Piq0XontLFM_Gzd2AKi|Z`~Uy| diff --git a/docs/generated_docs/.doctrees/components/ops/dot.doctree b/docs/generated_docs/.doctrees/components/ops/dot.doctree deleted file mode 100644 index 39c3346b0b2304007ea12b5dae462f4c138c6751..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 10270 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 Q&N<{zbKgVfe9~_G2gQVo4FCWD diff --git a/docs/generated_docs/.doctrees/components/ops/elementwise_multiply.doctree b/docs/generated_docs/.doctrees/components/ops/elementwise_multiply.doctree deleted file mode 100644 index 56e41e8c29bd8487b6f407f1ffc3261c9237ab8b..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 10175 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 diff --git a/docs/generated_docs/.doctrees/components/ops/extent.doctree b/docs/generated_docs/.doctrees/components/ops/extent.doctree deleted file mode 100644 index a37e25e600fc6bd93114cb5c728c658676ed0829..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 9532 zcmdT~&5s;M6<>QjyF0TV_BgQ<WWMc>@>gnmOnd;e| z?xwqXKL`=w5R?^lbAvb`Ay6bF4%{O}ij)I45Fi1ET#)z=kht=D)m_~^WAE&Glt{ty z%uZLmdiCC`_f_xpJGGx*zdWP<$cDgF- zk+mBKNo2EB&H%#ZuIEI|Pv6Ak3c(B4i(5H@c{>=6tmifPg=YgVh>S1_dalP}qlbsr zvYk^t|7ObT^3)dFqdh0WzMB$7axS#6y-4{|+_hxG5+ZWDi2(UT?yT#?AWhEOo)yO! z#P6DK4YOYhP7;<6UCZ8%SWm&!_lDj^99qQYLKv}_MLR4_<+_ zPjgx_&Fn{exbFaAD~d%bPkFA-(i-q31M9NrWG3^FuKf0V&)jTuHXg-A#ux& z<4hjSqo6WLfSzj*0lyD?^9zvUMSL#d^B_JC;qx&6Qo=81g!3zWmOsK*`PCaIM+o}H zDi-hTWnsID#XpTP{ z zzp0G2Dd#faG^2DC>S$$Jw#lzH&vzb40w2%?VHc*`iqa2jtl8iEZ&&l2oO<@JrNH6#1+qVKT1 zt^JTa)rf_&u@SpJWTr4O1z5EMKNiN8am5I_16az7KGvzRVx8e${aT~(_S;6gZ7|=d zY@8Fbu>lISRQ@k$EgZ}HM>!T*L#ReTJdg{X<@Xb-kKj0KhhZvLxZCF*KEkx3K80RV zsNd!awW!ays)2IW3fo>Tg{*iAf-3Da{C*>!GI^`>>2G2twSm1+5%SD8p69}%B3gOtxe?&G+~kl?0# zBj_0xX`HZ-DMWBGS`RxN!}0>ZkLfsMw%c|1@U2&)s%!aNhjROlKLmg!|A#*R?{1%%ndx-4pf>0K}IykOV$ z`x}kMH3Lb{^KPH{#tu9lv=RS@7EJ1Sih4oFIDUwp{UbRTnkR*n>wb(0m>VSF-)i zRBS&4wtqA&+gA!MCc52m<}V*>nHIq@p-VyhawJdK*_KvuQ~I2Q%1WgC+2@Ejb)1ymUYtNwC1Cz>>?|w!Z1c7pMC;1( zNN!TW_UAEdlVc6)B?H=D#rTtJMg`F^$;vXG+sUHw3bucJ8f4|f#@&jD?yZO@)(My< z=S(4`e5yjxf2OAh<-BPUyvpX|!aZJ+^aup-u{y2Er&?wZhvSuV+1)dhC$6bm_FwYr zF{LS4CU*E@x>i?i4q0XHaPYzXCue2`7w|<3^+xyM>Y=X0BiH#wbPS5?cX_QJ8=i2z zrwRrAprU?$vCp4M$9f$^R}}k>fXx!P zn9wbaQxgDJGdqYPT&N6z5>+c>waADE&k?<X- z*QgdE9+<>NwsBp~xxQ*yl=Y3lw{sfcB$ui(sF3mc7#X7nu_{j~TI4JWaA?cmdmR!@ zS+!FEWgEOkXwDD5g+G(7!g3Cr5dwMcj#b?h4J!f|qNI`zI>099F+c)F?Mf|N#4`e; z=i07F-&51OR^;O+EfuI|F?4U{vO^||8@x=kWwp{Z&`5$;e)zE|6rdux+Yazpcf&m* zMs;(JS!XZlJ%5Pel~y%Q(&4Ux9E83wkx-sdLK!{$u`?!5H28W!K3UreC04oS5yp4a6<3`C67f*qr{<`9G32?5#Lm(oXyTaxe~MxN+i0#sTUMYLM~|S z3Ath?uzFvZdGl~nF6j|vew%V3W(UEOJWwQ<|T30@rGccmLo0gZrH5PXI#-^;J zq=QBcDmp119MrC)fEVDK_Ez; zmB||?t@Z$acx)0WY(L7^$NuWiw(5 zCcWbNVIoZC+W|R7xQ9ga)}L69UHpDvbkbx|6htPse8*!EX6@CB!XM2upoDJ-eH zG&VDaV(=$uyIjfemNe+q4~$NXEtY49hZut55Rs=^)62RL4~aYQXeZH#m-irs1d(Gp zjNCuAaiJWWat;Nn9@vCLT*pL$)pPe!J||bKLvUM zd4%w^8i92En2x_33S*Wyfr%D6pw7Uz1~D_ME0vbm!rXCVH&fBmrsKvGH^E3w<-9fs zF60uJiD3e0GNXM7t;xYm^$Gzs_0Q8UY=TBT!Qg}mn}Z`?#2X96BUH3WRt3%R`%pyB z9m4CseC83k60*>wPyk!BmB0`^L+CqbC*zR!>rOC+<5svYc;KtnIARY$Dgpp$>h2T0 zIl#j8%a1+|d9Fk~dkj5|l<2Q$^e|Rb#&FauYPn4G)E+SVHWx#$4UI*90V{F@Pj4*9 zOVG)oS(sFwDmgncn!O`}VPNYO50rY) z>m?YUr@`#^>fm=U^1=HQ*FNMQ48BZHtMv72`uY{V5?LpBNkh>3@YL!a=Ci$ijZX_G0I3t*Rl~ZZw;4mTph{aU_j85VK?v! zRZ^h$jtv&j^%0D9y{lSub_72>btEV>oEyiL&&Xrn)YGs0;g0L?#} zkKclr-%VeIA)zx5lf)Z5F;pkpu<$`6!;8hRI{ii0x4pz6ZR?ZAFtW(kzGL2~-Ue9R X#6OY#G{t*G4*AsF{ZOb+x~=~K7SoeE diff --git a/docs/generated_docs/.doctrees/components/ops/fill.doctree b/docs/generated_docs/.doctrees/components/ops/fill.doctree deleted file mode 100644 index bdc207b9e509709f7cb60e72378384347d2d8f4b..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 10131 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 diff --git a/docs/generated_docs/.doctrees/components/ops/matrix_matrix_product.doctree b/docs/generated_docs/.doctrees/components/ops/matrix_matrix_product.doctree deleted file mode 100644 index beb0ea9568a6d43cc746ca4f814927d6a9499cc7..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 14402 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 diff --git a/docs/generated_docs/.doctrees/components/ops/matrix_vector_product.doctree b/docs/generated_docs/.doctrees/components/ops/matrix_vector_product.doctree deleted file mode 100644 index 84350d01f7b212e3f17e35f40d66ed7f606fc317..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 22090 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 diff --git a/docs/generated_docs/.doctrees/components/ops/product.doctree b/docs/generated_docs/.doctrees/components/ops/product.doctree deleted file mode 100644 index 52863f40cc064091ac9338bdc5d81e7dec197bd0..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 21992 zcmeHPZ;Tz+RbP9(yWU-UljkOGTE{R^o8;Nq-4`cK z%-eZ0)A{4wRb@dX(#FzANO&5FO8tVM5<8lrhTAKQ zH|OF{zTn!fuX(<^W!Wsyws7;Bz?_&1ZztwreB=h(Bb=3e-%W_3c;3^2K1|GGL0gZP z^f2_Tb`*kqB6rs61RyP5Fl;>t(1`0fNAHQNqn*ghZ`!)CuBY##M| z7BK%NOQLuo)VFCwVlJ5{&DnUdnTZH@^HMT3anb1QcK~qR55goqVp|SNt{#fo=CTkb zgmL<1JY%$zkJH|yq^tA`5&{aoD)Loe89G}>0!j*J}^uDkwr!)~)6aGl03 zYp)4AX#~E}=;=Yo{Kk3^>Y-&cGRn_L(hm$?#^m{Fm^@No^2TOI_du5ikDk0IB6#`!d6Rq=7McO-@2{zGvDT3TZjG>je!s zYS2ji5@E@69fXabL61_xxu3!#$XFKRMFbXo+t)o)VHU2)^bYekv{vgv3Y|c#o1S+u z6;s`;#Ybf~MHsuPFw9mK10Ea>3Xp1jXcUmYq=Fpo`cl5TQJW2o57a3_Ob8)?c`0W| z;&n-=w3T0!4e{*e^()fs`E{=O_s6GZTS)@<9Zv7@Nq&67uFW_Z-5 z@Qitct62MrmbXD6Us+meG&I+%Z=TVf*EW|z*7IyVWZH!#P2-b+w%H8#J+_+O?G^6! z#a-4{w>?vDhO%>;g}7U~xOCICIy9A$m(({lQerkX9M=hb-3dH5U|QpB z&1m=ynRBIJC=IH}y_R2Of#F*oPw3MOywH~CVt+PSF7|4xF@9n0CK zg>b92k9>`C811aKuRS4BBV3DA?yR=gYAu~bH-6u0X_nI=K-frNSUWQxk2cW^G`M)@ z26~HG;bxY#zWZZA7N?4q3Qtc#jrxd2uH6uK7<9; z;#ufSfiaBe#Z0e~vN^72W$1rRgZ@OnnJ6HKQ8UL)Nm6oXGau4jJTx;i4IxL!FmpKO zFw_gF@k->gFy(w$_tZ4#$6NY+7GdabN3FwufKGoS_@^Zs7Wd{4Gyhs`wbI1^{7^@- z)@q5x3Elck3$SF@eT^1hL7#IzF~MLioVsH3*s;hkOUW&yEsFG>pHzC?=P-iX@f>GJ zfkjVLLr|z$%K4VW%nLy%<3C>-KhmLcT55gLRN$8B8c+Eb&6C|{IIq=oROVBUL|^#XD=~X!RND*b(*nZJ;qBfId5b@>KPI0wU^Y`FF^j6#Pw!ZOA@FhEgccdMyHS0&@Cq*{S0w=~ISMyd)Y!?q4= zns#Li2A0*-0D#fLE*O)RFoaCVTg`Lhf`SS7lLC4z^LoI&kKp-m< z)AvdfQ!zP}_A-3d{6T4abtXV*31Q@k@}Z3iI>wtIUj)3r6!5+;7Z>s!RKD6^+#1Ly z?&U<)X9aT{trT5)muPjwagLJ-PG(V}K^gCt##ggTIv|XEjw@~E@dv7;i=@cx zC?iEQD5U(#^rW0tlD_`sj)J2suIhjzqu?uGdz-UeEuMkaaQOg(g)%kqZ0WAoZ&Div z1TBwL-=0XBQqb2R=--$~(8CqjeH4JYj}bJyUXpVSIkt#}!$(s8fpg85 zKTaj|S0VJj<3b-DL4G)*-(bTg3_`6_81@~xFEZ{HOJA~;ZFi(wMcEDn&&%XIG|Bc# zpFgZmMx?ZcNr&aCo}DeG4%MoYF$^!VyZ$TGO321q^O2A6e zRVHyfqxc1|{Tyeznxxz)hQl2kGRf?Orw$)EEEjll2MbZT{X0Aw_HF)BS7{){q;-<5 zUxJcZ`OuBuANjWL0dD%Hj+Vv2cwPuUbF%a{4@F;{$gpK7!q?c{Tioi(+0j_hyR2_P zUQYGn`MOxqezs4Y&6+8@g}5?$LH*5%Sf;r0zF-w+Y^ur0#Y!X8cvI~LXy2tM6@)@kgADYH}$S_o?sSM#rijailuvIHjy|{`Dt_`9TgLXQ|8~`nG-krDT!S z7Df*7PtqYy6&xZn_w^;%lahZ>f7RxTDbi?{{qNHF2`Icp6pE?o|LSe4V$5U9V6>K& zaOy~v;RG^xMrcV$A%6)w;x%st?c+^3WGVl^Ev1^)JZ24tJ2-!&NloMm!$%IyA6r@e zC|_fb$|Cz-JKsevIS`h#f?-}Y;6s9Y_xf5f<8la1Eoq9E*T>YMG9(on^QrRuL?$mY z9Ro)38H~ijx#DHZdUYOHR*xVxPb1eR8a^m4k4`4PFcJIYZLbKnYw@QP3(9ia5>JYM z(>OJ@RC|*YGy}#f9OG#JzAPxqQ_3q-r++0j`o7?M`Jf;V(%R^`YPTfIYT1z10wJ4P zd{NQbIO%0c5{g0z(aQ#OcklWYPpl9ioahPKRJc!43&Q5wW=nw)fA4F z;Rn-Gc&Yrc;F#Z{DgK}YiMwUw`_nVBUdTvA9IN;Uu7c?CrYZ}T_zjRd&Q~-dvJHnj zI2EPIP-Gp$M;24j;r#|1CAyfQ{|+P zaj`^3QCao)2&W~U4Z;peBjN8Fq@FOfS`aL`dx5~5?4HNJD#wlI!5IOFPY$lDlAvl7 z_2}WePtv^taPa~f=l~c_)bf$bxW^aHI1_4x$$R|quI@Xyq@f{B*)o(+nirNp-_CWP zCE`T25)VX@C$IMRa`{oNxzPC$e~Pr7?@%jOi#$X z@Q?ANf-`q=&P}TX;WMqYMS<|{^yEA=)I0O=RF>B8m`fpAuAsF+9*S3t2+`3An`xc1YwOBuP%K{CKojW_YT}p2w-^ShX z&^4M=vW=bs-5luh_mlXG<{q6$M;W$w1qWv=ubEb;3jp$z zXkj*^nsq^wim^3i;W%JS2c(tcz`W1s7**4zs#D3;!|{@-+u7}0Tw{9{WQEdbQ6M|b z#d96jj<$hrg(4iy41mk@9$FT063Sr26awFh<#$mUh_j>{qnka!1i|1fis_+yxBarVF2VKhqujRoVl7SCfRdkbtrB37q~Gh|!V zUSiJ2D|!^V&Acf-Y{96GccPxx%nT2L3+;WsMpj~M{+AM!sbmYu!M=;*X&pUr66D=rE)$*Ubw z{lSxT1th2`Nc9h(VS?6y%9l}GF}sC{*2t@1InFi=(YAV+8(+Eq@p#2!UXvzF_@coD zh9tv-y@Pggj`$&2v<}U|y0;&iuEVSNCGmsQlM{fRO<5I-iX1X;?a?Pc19`6aTSf^y zwdCL*li=a3DC_`LGk@J;;TFdMw{MtX&u+kCk*dLqI-!|dJsO{eP4=3Zdu9wYMV-al z@%_O*&IIo@v+5dDG|?r~KNj?KINFyZ9x308KgRFHZ4+mpPy>#aZ9Hw5DB5N~@xtFA zWiCRD-ibVv@}LTpywF`52X4c9T*GpPtA}J1$aLY2RL*fHfz9;V ztOFO`2MH!amU26O&_J)9CPThsH&IQKPD6se_u^VwfDguMZ;7yWJDz3E%>*atzx#f#LRpVg;=nta4<^Sifs=i9vF?a2HDJ>qcQ zFu!Bo;Xup}I0QcDMe%V}@0^h1NcFgrkgbUpa&OsBaICh7esCbzNw4kNnJMwE50o0S z-irl@ixMjzbfN$sk=hSwYIv{=D}6E(FCq9CZbYFaiI;I&%!ZDj4NO1_FQn~vAgFhf zSK&ygAPAR4vC#mgBM@dWsL;HeHFNDRTaIBz9kRAL>(}rTCSOZX R1GPgzHH|+s*GKL3{{_%xJk3&bHLCS&L8&hgzPDJ1CPSapmOM^4Uee1s$<-J9KgcQbpl zGn<*&`+$Z73KW--3S;K|cs-3ssv^0af`>TZ9y#B|-urH6Rr#H3b2cLi_)} zH#7U*+ui@p&hFJgG>Yxpx9|Pm@BjIGAG3Rpj=cW^|G0(!7wrk^mhG<3n3am_RanrB zwpYAzqsH8@`B-!6t<8sZ9WKZ?#BM1?F2KifU&Yy zQ^s2((JPO6j^`V7-&?XB78pzL;*6NNX^lPDw8o=t3v3TRjiHM@nx(U;VO>1XR zGNXbShQ3{Dga9AmZnY}`K#Ru8ju`~d2tSXwW=;IGz0#<+UX;x8iqDpKpYipYGZ)lN zRC9aXX94q9S+fz1h2}DjXj%npueCKAFQz7fSEGq#Cd3c3wT%i0obiLO8EtcHmo-nG z*C<&#gfYPw`%ajF5qd_68I6Edj5Ry73=4n+Gvy!<_L%6^OIQN%90U_s7lYo`C1A%( z;mi8pYtouJdA%rXYY{?Ewjq(Z$XFPv- z)+wvnlea1p3hArAodwkCNLIB^QoX%z6ms zUh=(~Fh>y5~aq2xcYVJYOL*#<O((vDxhxgX_v8)>JkTiaMqH&Tv_a_a}$eFTN2X;Unn@C=@^5D<2qr(t?N_6KY z-y@s)-t*7fvgNezt=hoT#!|!Od2K>s+A*VII2*Pb`d&~MS#Owb#i+1QyqYPTa+%>R z8KK3DnrXZ6R$wo?#u78b2BZtV7n|3xfuk%lH0;m_8uhy8hk;@GKoGv^ZxnEhlHusYqm;CjMy zoej>GGqIij-x|1fn31yJbJ^o8N$H6s-sFskMgktsX0n)QHN>k5tO^TBZp76ALzT#p zoeP{$489~wQblcSWz4s-Yl0c`O(|nuA!kgq>w(a#cyq>*?b?BrOuK7~(%PE$``PDB zEcnV~er4X%a-MksBoR=KADV6mIRyz4K$ZrO#!xCT#8b8vNr%nCT#JjsU~?Qga>`^@ z$x>kaL{>|xuARBQE1$n8i|Jiue*zW(4opJ8{*hutRHbbq^H5JV3@0OSast z*d-eWUM9JFJlYj6ii#!2E3e2ag<~llCiV2qg^<H8Z1 z1PoJyU61FAty^gWzX>*wfVtFc8Vt2U29lfw~6^rHumybU6S8!C|;d z7Q&#H30vp`GlkP))r#T+BW6eYO}rPUXQ&@R95^6-+2nH{1Phs9T^r#UYv#tm0z4WsVCV#457PgVm5EB4Y7 zxB=Q1PTv_IOqhAq^lcVyplu=WQFz&NSD_OaDk$J)-(|381g}H2!`(4=xz8{iFch#P z9(=$!WCUL9Wtb1_Y5=$m)CZB8#>=_QP*JWCdL^01a>>Hz$#l>JQug0+GJod-MrRV0fK|jgrFfe$FJ8NbaykafgQ*+b76bpC#-RSUJ@kn zw`t-@GOxZ4d+)6xCQj-1ZdPrP5b6e~9*5b}4c8ktu?i*jyKmD9ouuZy13BVdTV5g+ zQ_@IxT<+y&wc3wu@C2z9p+DtS7pk5c{%Y0ibZyIRAup4&EpM-EE#9h=a>o5dvUoKP zBOBrB)>t@FP?oHR3kEJ~gRn9;#}^r_XfGAR!*)=tY~Zq>TwH}Umgg54lGNdaBXe`B zrqf_YVBnF$o8j+9fNO^Uj`d8xh!YtGERS0=&dr_S@7)Z2#pyFHG+<@1UdIJNX!s_O z#4X14uzbEb$>d*3?CE;_ZQzDp>-FkQ(CKXTweYuCrdQ|S$F`;U4K44s4)E^X4_*24 zsI~iw*O#zcf#oe<3HlzaB-Sj(m%To$qxe=9Rt32HOAdwNh03Ho!)C0Pm*4VcFHl*H02w&XcX4butkKsKMbPe2Cn+2C{b*YZvn0nPRv%7p}#oeQqGue zybYG2b>DW^o$hQbbJ1Vnl z&S#amMR87-UOJ81d{-~|vHA_1R2;OA#;1BMMBgG2K}@iU>MT6F_!k_sxB4vn)9VH* zIrKXw>Cn2?{pdksah|P(o;!UvTpZ!9I`AAgs4xz@{CGmV3W}~jgQ0O`u~>j1aO)1v ztHaR%p0tOoUdJkU7@CX8t77uLJ`T4a)VSpRWL!dtzYI`Q2K*6trWXTZgyH49d=z|A zIn>@M&XlIb0d(tZJ8l=H6rzJT;>NRO;)r|y0xnq6%N9;0& zo1pK>o7!Y>Wh}T)ZwH0!?aA!j(qsez!ry2glAbh2+vfR`I)Wm^iy&Ty$Qv!%1$uL4_@- z*e)tN(3{ie6BZK;(M28QC%ie)Hn+59`~WJQ*-?04@jh-!Sd5)#NOG`MmQ(#RAix&D z{uZ(y*MzCjQ2lEV-Ff+1{X2Loetb+`yduH0pv7K-pBL~4epAJtw-aadhB!*;vRyUq23a=TB;mt2r|&*~=FAuI4>_0mcZU?Yga%T)Weac!oy({^kmi~q71Sz$6rI^B3~Kug9?hhm z)e1w3PI&n&m)bw0p6bYW85p(Gq3)0=^-SNsI0YkkrBEmpTZcxeOcSO$GDily5n`ep zcigB@>J>7jQuc>h6MfL9FZc#0z$xTB34&Id})j#OP zRVfLz_#zuC5b#ND2)isa;Zs@f7JgJ~o3#9POR%1}x_rVN3 zPH@#4Ly8`hR&UQstMVP`km>Y-Z7L1+E)hFnL_3{g>(J=*fF?`@l_T;Wgji_D9XBd; zdZ|pOo$L-YdU1&>S1O#3AW{NOPa<{lgVBkUfI$%HTk-?A zTG^g<4G}4mbch2{>U&7!ISR{fLMEoJ?n0@$22$t^ol>7971Zj36sXzi4r+S}X2?jX zqVABQ2c^{fXTNX*6|f@Q%KP@Zc=~9_%=*uLyW%U{v_LS*MipC!#;o7bgsFurM*`q+ zYCG<@QDIi~?60mVncfZm05t(dm|eLD22Z z`2kFKquY*=BIT8ibRgEfi&P*-(OHDNOg-L(b#)D-2pl@=E|Lmr)k2EbY*h%g-3c>f zWL;5(NYR6`E?hsg-Fo(O;|fo}Y%cfyZr=`hCpWOpz1TW5?tNSnrdG8aX<$NNwBwE& z74DssceU}gcXua%6|QV;al3by>cvx}Zk;kf04KvV`&zA!C{*&elsq$su-mhz;NsIGZhVv2JOTg*Lz0cjbzzP|Q-b_Uz1)Rwbq%Db8#>?aBNf!Df)u0Ksts!U6&};7;WW8w zwIM|h%D1o2%eTobU-w!+DfwxD2c2&3+at$dMEfx^whoPO@6&{-?#z(~Wr&P++;O8q zxKlFW_VxlW?o}lD14Uck@ zgXK(0 z>E4x_bT@lB+3yf$dTWlQ~+3wYZsi1PiKZA&9#~n8+WV>G>+pg9JlHDhf zYm5j)gTv4?bvj_Ws^R6_xerkB++J1lAsg9l#n!QbPi&XD2(CoZ6 zS`E=oPR02MnkC@$q}j#%V04-#U=TFx=Lc{|+1g6CxSaw;$|@b`K!p2t5`T_@vjkb0 zI=lKaG^ICR4OAgN&YaLrbOP}^fLLq@_CHHZ{FDBX?`E_)(mY!M7TD!H_R= zKi{`6KFe*ZA1Gt%&?xs=O_*BGa%8|V#6&ypxKW{8^{HdR{$K$4spC#Pr2_FhsZpnp z7jVhAOlcR@`y1{S)l!<=WKa87yemz+PY#cEMeSS=;XBx8c^2-z={R%}q`Eigkyeig-r z6n&2QHGWiTbNKZwef#1~+_pNuV(ZZO^*x#}wTk7)0~=zZ9e3Q=i(fn2zZ1V|J*AL; zlGLbE$P2h+T&Dbr>aB6NsFu>?Cj1)muIGqf2YNcHL+QaUg6ikvvY*pDA(guf{Q6~W zG-+>Mx^O;%UkNxp`SrQ{V03;ZU=aNJ!~6g`@@ofkQ? zs%szx+$Qns#JF0Evj%ClVuLz=mIpN{S1mTA=t24QMBW4A*1I%est0ocg4?q=J@#LEoW`Ce6&HD*;k$W-BeI^P6CXj2lx?T1e4@5@+rY@zfelXs6%bv>EjIv%X#NV{Te~Uy7|m zqt8M?6{gm%9BEL4kZ8vpH!Ae0e29lIKj<%gh^JFWsYdK0_30Gv0xTJnDV3sf|Cv4B z|ATj>sdRX!zHU-Fxrxp>r_O1fkZN59PQ6tdt;S_1KjM4@rxI{_a_T~UFgm9aFbGav z$`3&7O1s2{lsG!Dfyi~8#G9k4xR7|MgS(Kcu7MPAn?$bfCe`d7q}hrM>UG+}D_%8>vb1VcOSxKW|iPP)tZ>(D6l?V2#vk2%udAqa_f+;O8qq1|_;s`-hXY1~n&5g#P==@jn*EE$w3 zouYCp+$pM^G`UHZ4I0ugL-|8I&otqH>emDXN_`xk9=Q|mPU z72)Un%=aP95mKqkK&>0vXwux=jW{1ctpuE&)cWrHV03CFU=Y;$M1BAYwQ8XurHzhj zAZmSzgqx$LgphWrf4fktu7MP9n?$W&Al1}Lf)u0KN)77l!VDRYd_}1tMGs1?xxb!C zxu+Amp-my!ANK8#A8-Tf$G_M*G=lwwCQPklIg+6PfzggTZd3?%Qhq3@rxU;m($_O} z?=Dr1iCwCpRNXpdfB;U0X-c-J=)Z9Xk#ZBV{T}a1lkLZcy^oD6s=8&#^%>S7Jp4PO zxkD;}87TKgZ8T|gUe0hnf^rEsJt_A@elR-a5-KaHS&lqdgP3T?9XBeR3nAZn%9pY~7(n_2 zYsa2anfNNHQKyg>aLKq#nHJUiD0ho$DNSy|v>)MJX{LQ@cuX6Aal}a;zVW`+nDk9| zW%_#K9-FOA<@`3{lc!Fe9O%=m|E_sODt#FU_rJ8!r0qH3;(P?*5^#DF?#OO6|M~!< z6D|RRAl!@d130LBZv+`9QcCGC2V&kS5`B(}vkobly1NVW>KaJl2j5-O;S;NE0S`rJ zAK6c`*I`mctyDeMOf1z<8XQ{qJhi`+4) ztu(nw)IY$x(!@K&-vp3+9U@s#yZrjb9={g0trGS7LD!FKevxWl2I~EkHk!0PuVpwN zLA?Z=p49t={9ttIC14QL`}O<);;(GV7AaC%=|Be}-{(pEIqJ@vAT3jecOhS011SJE zfqZ{Xs;HFfndTv>+GU{Inl_sB1Fv2W--OMo~rJ4?TAmV+J)Femk`7KD*)b(A6SJyxa#Z4gI&yXr=B}59{Y^4eH zEx`;KiC2^+QuLt2oBMYH#3z{i>*kW*f2Wecke*QfZr>jHHn%Wvk@5@huytrG{DLM- zt#COq;bDl3cHD8J!opMX*0;A8zzovw1R(lLMPuXw)l{l>osvL6CnGiGXH@lD+(o3^ zgrC33yVCsp>7nzp_!`BSn#DKy#AnbqoZB<#1DbE7a+rac4{D=H5AgDa^AXHU!0E}% zhx3EcnVEn=F!OwV0M{wZoFQ7I^wPl&#L0`K4mm2(TOd7Cr+49GT>~iyH-VD_QpHZ? zNZ`*_j!@srVTO#HEXolndQeWjC+}uBIo;fRQhuUumwbquSSMv{9U3V=r3q7uTaHwC z1VW=7cigCu@j=9ex33_fG2}BrDat11Kdff-88ugEkDM) z(zN`U;n8w(;+Ub*=6W1!-~;OKXwH#JVg_FRzBZb40q13$kKknjPETI`d44cDFB32b zUfwaGR)s#SalPQ>KEg#xFdgkc#JrDGB1biP6cRM`dKY5WHISlk6NvdbQbnzBNKu=u zAfdkB=21@iUoA+a=s}4&_vd&!752r&rZx6pb4a`7`}=mqJussEtQuQ~M#zpPO!Z@q z6nHCyL_6-dQ6XgIbG(H4frzDVnCjF~st=El`gDqS0hSEPlz>sWGu$bvoiw>gyr1S> zX#)P@@CZ15DoZ+p%s|Bk|L@!o^5dGbq*9oHkpEB{O}d1aHk^+jWCBi4LjFvCFghU< zFbG2aa()0um5p+q@R1TwM?VljKSwH+qdL6}5;%>5E(EP>AVuXS5cH2o6}7@5MRB%* zh5CL7X2`g676pqGtr9fd^>@w(rrKMbf`1yN?p>p8WzPwkC(mzKS5>bOW3J?5)Rd0) zK)*G+5?aCZvc1aOrm5MddO(ccivL_~ZMCkMx2ERhxugBzMx9MpSjftu?YYyYTbZ_@ zPKNf9T{f`^q+a@96D5nzM%vkc&PH43%c1lB2b%!iTCnz7_lSwD(3(1VmooJZJ~e#v zvmFM~B)qwpHf!RxO5(<3aS2E(9uSQNUc)c5rWGQT^P=75hVO%7#khSw+L^RCw#%CH z(e{9aq3tdQ&1jBS!Wzc=|(fBfRnQw-k z597xxX2^hbYIS(ALrhZy*(>m}5Wj5r4!qhGdgWrtEU)0ZL6Z|?bm5Zcg{~Je>7A43 zMY{rUjoYXd*OxrM)`XVbun)KE#j;ncfj$AqyHvC=hw+x;njKojvSS7T;Dzbp0cpcd zpVd7-EIMqJIS^@4!7`on3gp4@O3)<**s; z@fx8jWrRy>@1B6g)%_t}!Y-n2%e-DV^7imj&T zd>bNaSEW&_7t^Q%!}10j0?v0$r~&iQ9^L}hbpv#NtEnEaM#U?x*D#(gVC!`+U`2T( zkCJj&T(tvR#OI!3#SYApgNno`$C7NY!e}Qb6F~fntcR$HyA_vg2b6>S--|!NBmwiW zGJuCsS_NFb!#CH`mk^>8m{Jfq?lJ_TW7q7kdDjKkM7!&(UIe2sNW?NX*iLLInSdQL zBYK4uhV@`>b{3k0nfgX(dG3toFV8lki?AmL06mK#tATq$aL0CNpT6q4SA#uw`%7g_ zJhrsNU!91DOf@lNSC~Izvv7&e0XaWwg*68z8xPGAWD(TX=E?2RK8VR$F-^}@fnrd{ z2ss;F5Nx=ixn8vFWy^s-5Wm|T4?}-vP%|OX9%?{d2Vkg|@z>&I(ecV=Y}$Qg%LF{& zc#&^lWo|+kz0#<|6uSXkXop~bQ3uXK^mt|4U4j@$3d4n1DuPBy>u1+6cpc9a*|?3D zB#4<>iB%wlHvodgSO}9`REAzFMOHIyr)X9xKI0YSUC{(eMwbW7SrRqvY_yfRt4*Mj zXuBvUkiQU$wp+0wIl^LS`pXQ;69mo#fP&Bpp`?P03R?=GfJPT8t*%)E3qdnTTS{My zVhUAw`xrKgpC_v`kmS{C;Vuc35KycL;&x60N#`Y`VuSPVE{gGpEv>0*LdiE^u ze3o}S+psRdx44{ptgl&5aUs?>xr8dxW+U1q`<(;XRkk5|P!j+rS}?tnenMlpMf3wZ zK%CS{o|A?W@A`7BG3`CBNE}aQ<%2F%PMMrr1M0pl7NX#fBK diff --git a/docs/generated_docs/.doctrees/concepts_note.doctree b/docs/generated_docs/.doctrees/concepts_note.doctree deleted file mode 100644 index 6f9eca5c12da5c1ee8211eb843a12c49a0d344bc..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 12810 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 diff --git a/docs/generated_docs/.doctrees/index.doctree b/docs/generated_docs/.doctrees/index.doctree deleted file mode 100644 index 329c668f7891e59008c44f186d32641414b0d1b1..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 45045 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 diff --git a/docs/generated_docs/.doctrees/installation.doctree b/docs/generated_docs/.doctrees/installation.doctree deleted file mode 100644 index 16c45f13da1cc1e15c55211b8ea5761b0392a00c..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 24670 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 diff --git a/docs/generated_docs/.doctrees/license.doctree b/docs/generated_docs/.doctrees/license.doctree deleted file mode 100644 index f781b87ad1004355975c2c8ff78a67bba90846b7..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 6803 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 - -Public namespace: ``pressio`` - -We refer to these as expressions because each function does not allocate -new memory but only creates an instance of a class that "represents" the given operation. - -In all cases, the returned expression remains valid until its operand goes out of scope. -If the operand goes out of scope, the state of the expression is undefined. - -.. toctree:: - :maxdepth: 1 - - expressions/span - expressions/subspan - expressions/diag diff --git a/docs/generated_docs/_sources/components/expressions/diag.rst.txt b/docs/generated_docs/_sources/components/expressions/diag.rst.txt deleted file mode 100644 index 0477c2f..0000000 --- a/docs/generated_docs/_sources/components/expressions/diag.rst.txt +++ /dev/null @@ -1,29 +0,0 @@ -.. include:: ../../mydefs.rst - -``diagonal`` -============ - -Header: ```` - -API ---- - -.. code-block:: cpp - - namespace pressio { - - template - /*impl defined*/ diagonal(T & operand); - - } // end namespace pressio - -Description ------------ - -* Takes in an ``operand`` that is either: - - * a square Eigen dense matrix, ``pressio::is_dense_matrix_eigen::value == true`` - - * a square Kokkos rank-2 view, i.e. ``pressio::is_dense_matrix_kokkos::value == true`` - -* Returns an expression that represents that diagonal of ``operand`` diff --git a/docs/generated_docs/_sources/components/expressions/span.rst.txt b/docs/generated_docs/_sources/components/expressions/span.rst.txt deleted file mode 100644 index 7ba84c3..0000000 --- a/docs/generated_docs/_sources/components/expressions/span.rst.txt +++ /dev/null @@ -1,36 +0,0 @@ -.. include:: ../../mydefs.rst - -``span`` -======== - -Header: ```` - -API ---- - -.. code-block:: cpp - - namespace pressio { - - template - /*impl defined*/ span(T & operand, - std::pair indexRange); - - } // end namespace pressio - -Description ------------ - -* Takes in an ``operand`` and an ``indexRange`` - - * ``operand`` is either: - - * an Eigen vector object: ``pressio::is_vector_eigen::value == true`` - - * a Kokkos rank-1 view, i.e. ``pressio::is_vector_kokkos::value == true`` - - * ``indexRange`` is a std::pairidentifying an interval ``[a, b)`` where the second index is exclusive - - -* Returns an expression that represents the target span of the ``operand``. - diff --git a/docs/generated_docs/_sources/components/expressions/subspan.rst.txt b/docs/generated_docs/_sources/components/expressions/subspan.rst.txt deleted file mode 100644 index a01c844..0000000 --- a/docs/generated_docs/_sources/components/expressions/subspan.rst.txt +++ /dev/null @@ -1,33 +0,0 @@ -.. include:: ../../mydefs.rst - -``subspan`` -=========== - -Header: ```` - -API ---- - -.. code-block:: cpp - - namespace pressio { - - template - /*impl defined*/ subspan(T & operand, - std::pair rowsRange, - std::pair colsRange); - - } // end namespace pressio - -Description ------------ - -* Takes in an ``operand``, as well as the ``rowsRange`` and ``colsRange`` intervals that will be used in each dimension - - * ``operand`` is either: - - * an Eigen dense matrix, ``pressio::is_dense_matrix_eigen::value == true`` - - * a Kokkos rank-2 view, i.e. ``pressio::is_dense_matrix_kokkos::value == true`` - -* Returns an expression object that represents a subspan of the ``operand``. diff --git a/docs/generated_docs/_sources/components/mpl.rst.txt b/docs/generated_docs/_sources/components/mpl.rst.txt deleted file mode 100644 index b8c8339..0000000 --- a/docs/generated_docs/_sources/components/mpl.rst.txt +++ /dev/null @@ -1,114 +0,0 @@ -.. role:: raw-html-m2r(raw) - :format: html - -.. include:: ../mydefs.rst - - -``mpl`` -======= - -Header: ```` - -Public namespace: ``pressio::mpl`` - - -Scope ------ - -Provides metaprogramming functionalities needed to -support generic programming, which is a fundamental -building block of the pressio library. -If you are familiar with the ```` header from -the standard library, the ``pressio/mpl`` will look familiar too. -Some parts of ``pressio/mpl`` have been adapted from the `tinympl project `_. -The tinympl project appears to be no longer maintained. - -The following is a *partial* list only intended to provide a general idea of the supported features. - -To find out all supported cases, browse the `source `__. - - -.. - ``pressio::mpl::not_void`` - ~~~~~~~~~~~~~~~~~~~~~~~~~~ - - .. code-block:: cpp - - template struct not_void; - - * - Provides the static member constant ``value`` that is equal to true, if ``T`` is NOT of - the type ``void``\ , ``const void``\ , ``volatile void``\ , or ``const volatile void``. - Otherwise, value is true. - - * - Example:\ :raw-html-m2r:`
      ` - - .. code-block:: cpp - - namespace pmpl = pressio::mpl; - static_assert(pmpl::not_void::value, "" ); - - -``pressio::mpl::all_of`` -~~~~~~~~~~~~~~~~~~~~~~~~ - -.. code-block:: cpp - - template< template class F, class ... Args> struct all_of; - -* - Determines whether every element in the sequence satisfies the given predicate. - The predicate ``F`` must be such that ``F::value`` must be convertible to ``bool``. - Provides the static member constant ``value`` that is equal to true iff - all the elements in the sequence satisfy the predicate ``F``. - Otherwise, value is false. - -* - Example:\ :raw-html-m2r:`
      ` - - .. code-block:: cpp - - namespace pmpl = pressio::mpl; - static_assert(pmpl::all_of::value, "" ); - - -``pressio::mpl::any_of`` -~~~~~~~~~~~~~~~~~~~~~~~~ - -.. code-block:: cpp - - template< template class F, class ... Args> struct any_of; - -* Determines whether any element in the sequence satisfies the given predicate. - The predicate ``F`` must be such that ``F::value`` must be convertible to ``bool``. - Provides the static member constant ``value`` that is equal to true iff - at least one element in the sequence satisfies the predicate ``F``. - Otherwise, value is equal to false. - - -``pressio::mpl::none_of`` -~~~~~~~~~~~~~~~~~~~~~~~~~ - -.. code-block:: cpp - - template< template class F, class ... Args> struct none_of; - -* Determines whether none of the elements in the sequence satisfy the given predicate. - The predicate ``F`` must be such that ``F::value`` must be convertible to ``bool``. - Provides the static member constant ``value`` that is equal to true iff - none of the elements in the sequence satisfy the predicate ``F``. - Otherwise, value is equal to false. - - -``pressio::mpl::is_subscriptable_as`` -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -.. code-block:: cpp - - template struct is_subscriptable_as; - -* Provides the static member constant ``value`` that is equal to true if - ``T`` has subscript operator ``[]``\ , it can be indexed by an instance of ``IndexType``\ , - and the return type is not void. - Otherwise, value is equal to false. diff --git a/docs/generated_docs/_sources/components/ops.rst.txt b/docs/generated_docs/_sources/components/ops.rst.txt deleted file mode 100644 index eaebc9e..0000000 --- a/docs/generated_docs/_sources/components/ops.rst.txt +++ /dev/null @@ -1,97 +0,0 @@ - -.. include:: ../mydefs.rst - -``ops`` -======= - -Header: ```` - -Public namespace: ``pressio::ops`` - -Pressio operations are generalized to work on a variety of container types and backends. - -Types ------ - -The following table holds both the types supported throughout the ``ops`` directory and the -built-in booleans that confirm if a given type ``T`` is the expected type. - -All expressions are within the ``pressio`` namespace. - -.. list-table:: - :widths: 10 20 20 - :header-rows: 1 - :align: left - - * - Container Type - - Rank-1 Check - - Rank-2 Check - - * - Eigen - - ``is_vector_eigen::value`` - - ``is_sparse_matrix_eigen::value``, ``is_dense_matrix_eigen::value`` - - * - Kokkos - - ``is_vector_kokkos::value`` - - ``is_dense_matrix_kokkos::value``, ``is_sparse_matrix_kokkos::value`` - - * - Epetra - - ``is_vector_epetra::value`` - - ``is_multi_vector_epetra::value`` - - * - Tpetra - - ``is_vector_tpetra::value`` - - ``is_multi_vector_tpetra::value`` - - * - Tpetra Block - - ``is_vector_tpetra_block::value`` - - ``is_multi_vector_tpetra_block::value`` - - * - Teuchos - - ``is_dense_vector_teuchos::value`` - - ``is_dense_matrix_teuchos::value`` - -Additionally, because Pressio features expressions for containers built on Eigen, Kokkos, and Tpetra, you can check whether or not a container is native with: - -.. list-table:: - :widths: 10 20 20 - :header-rows: 1 - :align: left - - * - Container Type - - Native - - Pressio Expression - - * - Eigen - - ``is_native_container_eigen::value`` - - ``is_expression_acting_on_eigen::value`` - - * - Kokkos - - ``is_native_container_kokkos::value`` - - ``is_expression_acting_on_kokkos::value`` - - * - Tpetra - - - - ``is_expression_column_acting_on_tpetra::value`` - -Navigation ----------- - -Use the links below to view details about each operation. - -.. toctree:: - :maxdepth: 1 - - ops/abs - ops/add_to_diagonal - ops/clone - ops/deep_copy - ops/dot - ops/elementwise_multiply - ops/extent - ops/fill - ops/matrix_vector_product - ops/matrix_matrix_product - ops/min_max - ops/norms - ops/pow diff --git a/docs/generated_docs/_sources/components/ops/abs.rst.txt b/docs/generated_docs/_sources/components/ops/abs.rst.txt deleted file mode 100644 index c7767ae..0000000 --- a/docs/generated_docs/_sources/components/ops/abs.rst.txt +++ /dev/null @@ -1,44 +0,0 @@ -.. include:: ../../mydefs.rst - -``abs`` -======= - -Header: ```` - -API ---- - -.. code-block:: cpp - - namespace pressio { namespace ops{ - - template - void abs(T1 & x, const T2 & y); - - }} // end namespace pressio::ops - -Description ------------ - -* Computes the element-wise absolute value of each element - in the operand x and stores the result in y. - -* ``T1`` and ``T2`` must be one-dimensional containers with compatible scalar types: - - * an Eigen vector - - * a Kokkos rank-1 view - - * a Tpetra vector - - * a Tpetra block vector - - * a Epetra vector - - * a Pressio expression, i.e. ``pressio::diag``, ``pressio::span``, ``pressio::subspan``, based on Eigen or Kokkos container - -Notes ------ - -* See the :doc:`ops homepage <../ops>` for a table of booleans to use when checking that ``T1`` and ``T2`` have the correct types. - diff --git a/docs/generated_docs/_sources/components/ops/add_to_diagonal.rst.txt b/docs/generated_docs/_sources/components/ops/add_to_diagonal.rst.txt deleted file mode 100644 index dbdfcb2..0000000 --- a/docs/generated_docs/_sources/components/ops/add_to_diagonal.rst.txt +++ /dev/null @@ -1,34 +0,0 @@ -.. include:: ../../mydefs.rst - -``add_to_diagonal`` -=================== - -Header: ```` - -API ---- - -.. code-block:: cpp - - namespace pressio { namespace ops{ - - template - void add_to_diagonal(T1 & operand, const ScalarType & value); - - }} // end namespace pressio::ops - -Description ------------ - -* Adds the specified scalar ``value`` to each diagonal element of ``operand`` - -* ``T`` must be a rank-2 Eigen matrix - -* ``ScalarType`` must be convertible to ``pressio::Traits::scalar_type`` - -Notes ------ - -* If the diagonal entries of ``operand`` are written, then all diagonal entries must already exist. - -* See the :doc:`ops homepage <../ops>` for a table of booleans to use when checking that ``T1`` has the correct type. diff --git a/docs/generated_docs/_sources/components/ops/clone.rst.txt b/docs/generated_docs/_sources/components/ops/clone.rst.txt deleted file mode 100644 index 5dcbd86..0000000 --- a/docs/generated_docs/_sources/components/ops/clone.rst.txt +++ /dev/null @@ -1,66 +0,0 @@ -.. include:: ../../mydefs.rst - -.. role:: cpp(code) - :language: cpp - -``clone`` -========= - -Header: ```` - -API ---- - -.. code-block:: cpp - - namespace pressio { namespace ops{ - - template - T clone(const T & operand); - - }} // end namespace pressio::ops - -Description ------------ - -* Creates and returns a new instance of :cpp:`T` by making a new allocation - and *copying* all values from :cpp:`operand` into it. - - * It is an exact but independent clone of :cpp:`operand`. - -* ``T`` must be: - - * an Eigen vector or matrix object - - * a Kokkos view - - * a Teuchos vector - - * or an Epetra vector or multi-vector - - * or a Tpetra vector or multi-vector - - * or a Tpetra block vector or multi-vector - -Notes ------ - -* This is a blocking operation, i.e. the kernel completes before returning. - -* This kernel has value semantics, even for types that, by default, - have view semantics like Kokkos, Tpetra or TpetraBlock. - This means the following: - let :cpp:`auto result = clone(operand)`, then any operation applied - to :cpp:`operand` *after* calling clone will NOT - have any impact on ``result``. - And any operation applied to ``result`` will not have any impact on ``operand``. - -* For types that have value semantics, for example ``Eigen::Matrix<...>``, - Epetra vector or MV, this kernel can be implemented by calling the copy constructor - and returning the copy - -* For Kokkos, Tpetra, or TpetraBlock data types, which by default have view semantics - (i.e. a copy is a shallow copy), the operation can be implemented by first making a new - object with extents identical to ``operand``, followed by a deep copy, and then return the result. - -* See the :doc:`ops homepage <../ops>` for a table of booleans to use when checking that ``T`` has the correct type. diff --git a/docs/generated_docs/_sources/components/ops/deep_copy.rst.txt b/docs/generated_docs/_sources/components/ops/deep_copy.rst.txt deleted file mode 100644 index 40481b8..0000000 --- a/docs/generated_docs/_sources/components/ops/deep_copy.rst.txt +++ /dev/null @@ -1,46 +0,0 @@ -.. include:: ../../mydefs.rst - -``deep_copy`` -============= - -Header: ```` - -API ---- - -.. code-block:: cpp - - namespace pressio { namespace ops{ - - template - void deep_copy(T2 & dest, const T1 & src); - - template - void deep_copy(T & dest, const T & src); - - }} // end namespace pressio::ops - -Description ------------ - -* Copies all elements from ``src`` into ``dst``, so that ``dst`` is fully independent of ``src``. - -* ``T1`` and ``T2`` must have the same rank, and must be: - - * Two Eigen-based containers (either a native Eigen container or a Pressio expression based on an Eigen container) - - * Two Kokkos-based containers (either a native Kokkos view or a Pressio expression based on a Kokkos container) - -* ``T`` must be: - - * a Tpetra vector or multi-vector - - * a Tpetra block vector or multi-vector - - * a Epetra vector or multi-vector - -Notes ------ - -* See the :doc:`ops homepage <../ops>` for a table of booleans to use when checking that ``T``, ``T1``, and ``T2`` have the correct types. - diff --git a/docs/generated_docs/_sources/components/ops/dot.rst.txt b/docs/generated_docs/_sources/components/ops/dot.rst.txt deleted file mode 100644 index d6902c6..0000000 --- a/docs/generated_docs/_sources/components/ops/dot.rst.txt +++ /dev/null @@ -1,47 +0,0 @@ -.. include:: ../../mydefs.rst - -``dot`` -======= - -Header: ```` - -API ---- - -.. code-block:: cpp - - namespace pressio { namespace ops{ - - template - void dot(const T1 & vecA, const T2 & vecB, DotResult & result); - - template - scalar_type dot(const T1 & vecA, const T2 & vecB); - - }} // end namespace pressio::ops - -Description ------------ - -* Computes the dot product of two compatible vectors (``vecA`` and ``vecB``) - - * Stores the result in ``result`` if provided; otherwise, returns the result - -* ``T1`` and ``T2`` must be one-dimensional containers with compatible scalar types: - - * an Eigen vector - - * a Kokkos rank-1 view - - * a Tpetra vector - - * a Tpetra block vector - - * a Epetra vector - - * a pressio expression, i.e. ``pressio::diag``, ``pressio::span``, ``pressio::subspan``, based on Eigen or Kokkos container - -Notes ------ - -* See the :doc:`ops homepage <../ops>` for a table of booleans to use when checking that ``T1`` and ``T2`` have the correct types. diff --git a/docs/generated_docs/_sources/components/ops/elementwise_multiply.rst.txt b/docs/generated_docs/_sources/components/ops/elementwise_multiply.rst.txt deleted file mode 100644 index 7c35179..0000000 --- a/docs/generated_docs/_sources/components/ops/elementwise_multiply.rst.txt +++ /dev/null @@ -1,48 +0,0 @@ -.. include:: ../../mydefs.rst - -``elementwise_multiply`` -======================== - -Header: ```` - -API ---- - -.. code-block:: cpp - - namespace pressio { namespace ops{ - - template - void elementwise_multiply( - const alpha_t & alpha, - const T & x, - const T1 & z, - const beta_t & beta, - T2 & y - ); - - }} // end namespace pressio::ops - -Description ------------ - -* Computes ``y = beta * y + alpha * (x ⊙ z)``, where ``⊙`` denotes element-wise multiplication, and stores the result in y - -* ``T``, ``T1``, and ``T2`` must be one-dimensional containers with compatible scalar types: - - * an Eigen vector - - * a Kokkos rank-1 view - - * a Tpetra vector - - * a Tpetra block vector - - * a Epetra vector - - * a pressio expression, i.e. ``pressio::diag``, ``pressio::span``, ``pressio::subspan``, based on Eigen or Kokkos container - -Notes ------ - -* See the :doc:`ops homepage <../ops>` for a table of booleans to use when checking that ``T``, ``T1``, and ``T2`` have the correct types. diff --git a/docs/generated_docs/_sources/components/ops/extent.rst.txt b/docs/generated_docs/_sources/components/ops/extent.rst.txt deleted file mode 100644 index 3d65644..0000000 --- a/docs/generated_docs/_sources/components/ops/extent.rst.txt +++ /dev/null @@ -1,44 +0,0 @@ -.. include:: ../../mydefs.rst - -``extent`` -========== - -Header: ```` - -API ---- - -.. code-block:: cpp - - namespace pressio { namespace ops{ - - template - std::size_t extent(const T & objectIn, const IndexType i); - - }} // end namespace pressio::ops - -Description ------------ - -* Returns the size or dimension of a container ``objectIn`` along a specified axis ``i`` - -* ``T`` must be one of the following: - - * an Eigen vector or matrix object - - * a Kokkos view - - * a Teuchos vector - - * a Tpetra vector or multi-vector - - * a Tpetra block vector or multi-vector - - * a Epetra vector or multi-vector - - * a pressio expression, i.e. ``pressio::diag``, ``pressio::span``, ``pressio::subspan``, based on an Eigen, Tpetra Block, or Kokkos container - -Notes ------ - -* See the :doc:`ops homepage <../ops>` for a table of booleans to use when checking that ``T`` has the correct type. diff --git a/docs/generated_docs/_sources/components/ops/fill.rst.txt b/docs/generated_docs/_sources/components/ops/fill.rst.txt deleted file mode 100644 index 79a17a9..0000000 --- a/docs/generated_docs/_sources/components/ops/fill.rst.txt +++ /dev/null @@ -1,46 +0,0 @@ -.. include:: ../../mydefs.rst - -``fill`` -======== - -Header: ```` - -API ---- - -.. code-block:: cpp - - namespace pressio { namespace ops{ - - template - void fill(T & operand, ScalarType const & value); - - }} // end namespace pressio::ops - -Description ------------ - -* Overwrites each element of ``operand`` with ``value``. - -* ``T`` must be: - - * an Eigen vector or matrix object - - * a Kokkos rank-1 or rank-2 view - - * a Teuchos vector - - * a Tpetra vector or multi-vector - - * a Tpetra block vector or multi-vector - - * a Epetra vector or multi-vector - - * a pressio expression, i.e. ``pressio::diag``, ``pressio::span``, ``pressio::subspan``, based on an Eigen or Kokkos container - -* ``ScalarType`` must be convertible to ``pressio::Traits::scalar_type`` - -Notes ------ - -* See the :doc:`ops homepage <../ops>` for a table of booleans to use when checking that ``T1`` and ``T2`` have the correct types. diff --git a/docs/generated_docs/_sources/components/ops/matrix_matrix_product.rst.txt b/docs/generated_docs/_sources/components/ops/matrix_matrix_product.rst.txt deleted file mode 100644 index b300c55..0000000 --- a/docs/generated_docs/_sources/components/ops/matrix_matrix_product.rst.txt +++ /dev/null @@ -1,88 +0,0 @@ -.. include:: ../../mydefs.rst - -``matrix-matrix product`` -========================= - -Header: ```` - -API ---- - -.. code-block:: cpp - - namespace pressio { namespace ops{ - - // op(A) = A^T and op(B) = B - template < - class A_type, class B_type, class C_type, - class alpha_t, class beta_t - > - void product(::pressio::transpose /*unused*/, - ::pressio::nontranspose /*unused*/, - const alpha_t & alpha, - const A_type & A, - const B_type & B, - const beta_t & beta, - C_type & C); - - // op(A) = A and op(B) = B - template < - class A_type, class B_type, class C_type, - class alpha_t, class beta_t - > - void product(::pressio::nontranspose /*unused*/, - ::pressio::nontranspose /*unused*/, - const alpha_t & alpha, - const A_type & A, - const B_type & B, - const beta_t & beta, - C_type & C); - - // A == B and op(A) = A^T - template - void product(::pressio::transpose /*unused*/, - ::pressio::nontranspose /*unused*/, - const alpha_t & alpha, - const A_type & A, - const beta_t & beta, - C_type & C); - - // Construct result - template - C_type product(::pressio::transpose modeA, - ::pressio::nontranspose modeB, - const alpha_t & alpha, - const A_type & A); - - }} // end namespace pressio::ops - -Description ------------ - -* Performs matrix-vector multiplication according to ``C = beta * C + alpha * op(A) * op(B)`` - - * ``op(X)`` indicates either ``X`` or ``X^T`` - -* ``alpha_t`` and ``beta_t`` are scalar types - -* ``A_type``, ``B_type``, and ``C_type`` are rank-2 containers - -Types ------ - -The matrix-matrix product works for the following matrix types: - -* Eigen (all containers are rank-2 Eigen matrices) - -* Epetra (``A`` and ``B`` are Epetra multi-vectors; ``C`` is a rank-2 Eigen matrix) - -* Kokkos (all containers are rank-2 Kokkos views) - -* Tpetra (``A`` and ``B`` are Tpetra multi-vectors; ``C`` is either a rank-2 Eigen matrix or a rank-2 Kokkos view) - -* Tpetra Block (``A`` and ``B`` are Tpetra Block multi-vectors; ``C`` is either a rank-2 Eigen matrix or a rank-2 Kokkos view) - -Notes ------ - -* See the :doc:`ops homepage <../ops>` for a table of booleans to use when checking that ``A``, ``B``, and ``C``` have the correct types. diff --git a/docs/generated_docs/_sources/components/ops/matrix_vector_product.rst.txt b/docs/generated_docs/_sources/components/ops/matrix_vector_product.rst.txt deleted file mode 100644 index 9e0a639..0000000 --- a/docs/generated_docs/_sources/components/ops/matrix_vector_product.rst.txt +++ /dev/null @@ -1,112 +0,0 @@ -.. include:: ../../mydefs.rst - -``matrix-vector product`` -========================= - -Header: ```` - -API ---- - -.. code-block:: cpp - - namespace pressio { namespace ops{ - - // op(A) = A - template < - class A_type, class x_type, class y_type, - class alpha_t, class beta_t - > - void product(::pressio::nontranspose /*unused*/, - const alpha_t & alpha, - const A_type & A, - const x_type & x, - const beta_t & beta, - y_type & y); - - // op(A) = A , construct result - template < - class y_type, class A_type, class x_type, class alpha_t - > - y_type product(::pressio::nontranspose mode, - const alpha_t & alpha, - const A_type & A, - const x_type & x); - - // op(A) = A^T - template < - class y_type, class A_type, class x_type, class alpha_t - > - void product(::pressio::transpose /*unused*/, - const alpha_t & alpha, - const A_type & A, - const x_type & x, - const beta_t & beta, - y_type & y); - - // op(A) = A^T , construct result - template - y_type product(::pressio::transpose mode, - const alpha_t & alpha, - const A_type & A, - const x_type & x); - - }} // end namespace pressio::ops - -Description ------------ - -* Performs matrix-vector multiplication according to ``y = beta * y + alpha * op(A) * x`` - * ``op(A)`` indicates either ``A`` or ``A^T`` - -* ``alpha_t`` and ``beta_t`` are scalar types - -* ``x_type`` and ``y_type`` are rank-1 containers - -* ``A_type`` is a rank-2 container - -* The following combinations of container types are supported for each ``A_type``: - - * Eigen - - * All container types are either Eigen containers or Pressio expressions of Eigen containers, - - * Epetra - - * ``A_type`` is an Epetra rank-2 container - * Either ``x_type`` or ``y_type`` is a rank-1 Epetra container - * The other non-Epetra container is a rank-1 Teuchos or Eigen container - - * Kokkos - - * All container types are either Kokkos views or Pressio expressions of Eigen views - - * Teuchos (does not support constructed results) - - * ``A_type`` is a rank-2 Teuchos container - * ``x_type`` and ``y_type`` are rank-1 Eigen containers - - * Tpetra - - * ``A_type`` is a rank-2 Tpetra container - - * ``x_type`` is a rank-1 Eigen, Kokkos, Teuchos, or Tpetra container - - * ``y_type`` is a rank-1 container. - If ``x_type`` is Tpetra, it may be either a Kokkos or Eigen container (or a Pressio expression of a Kokkos or Eigen container) - Otherwise, ``y_type`` is a Tpetra container or a Pressio column expression - - * Tpetra Block - - * ``A_type`` is a rank-2 Tpetra Block container - - * ``x_type`` is a rank-1 Eigen, Kokkos, Teuchos, or Tpetra Block container - - * ``y_type`` is a rank-1 container. - If ``x_type`` is a Tpetra Block vector, ``y_type`` may be either an Eigen vector or a rank-1 Kokkos view - Otherwise, ``y_type`` is a Tpetra Block vector or column expression - -Notes ------ - -* See the :doc:`ops homepage <../ops>` for a table of booleans to use when checking that ``A_type``, ``x_type``, and ``y_type``` have the correct types. diff --git a/docs/generated_docs/_sources/components/ops/min_max.rst.txt b/docs/generated_docs/_sources/components/ops/min_max.rst.txt deleted file mode 100644 index cf1c715..0000000 --- a/docs/generated_docs/_sources/components/ops/min_max.rst.txt +++ /dev/null @@ -1,28 +0,0 @@ -.. include:: ../../mydefs.rst - -``min`` & ``max`` -================= - -Header: ```` - -API ---- - -.. code-block:: cpp - - namespace pressio { namespace ops{ - - template - scalar_type max(const T & obj); - - template - scalar_type min(const T & obj); - - }} // end namespace pressio::ops - -Description ------------ - -* Returns the maximum or minimum value of the given container - -* Works for all container types other than Teuchos arrays diff --git a/docs/generated_docs/_sources/components/ops/norms.rst.txt b/docs/generated_docs/_sources/components/ops/norms.rst.txt deleted file mode 100644 index a0b1728..0000000 --- a/docs/generated_docs/_sources/components/ops/norms.rst.txt +++ /dev/null @@ -1,42 +0,0 @@ -.. include:: ../../mydefs.rst - -``norms`` -========= - -Header: ```` - -API ---- - -.. code-block:: cpp - - namespace pressio { namespace ops{ - - // L1 Norm - template - scalar_type norm1(const T & a); - - // L2 Norm - template - scalar_type norm2(const T & a); - - }} // end namespace pressio::ops - -Description ------------ - -* Returns the desired norm of the given container ``a`` - -* L1 norm is given by - -.. math:: - - \| a \|_1 = \sum_{i} |a_i| - -* L2 norm is given by: - -.. math:: - - \|\mathbf{a}\|_2 = \sqrt{\sum_{i=1}^{n} a_i^2} - -* ``a`` must be rank-1 container of any type diff --git a/docs/generated_docs/_sources/components/ops/pow.rst.txt b/docs/generated_docs/_sources/components/ops/pow.rst.txt deleted file mode 100644 index d6dde4e..0000000 --- a/docs/generated_docs/_sources/components/ops/pow.rst.txt +++ /dev/null @@ -1,47 +0,0 @@ -.. include:: ../../mydefs.rst - -``pow`` -======= - -Header: ```` - -API ---- - -.. code-block:: cpp - - namespace pressio { namespace ops{ - - // x^exponent - template - void pow(T & x, const scalar_type & exponent); - - // y = x^exponent - template - void pow(T1 & y, const T2 & x, const scalar_type & exponent); - - // y = |x|^exponent (exponent > 0) - template - abs_pow(T1 & y, - const T2 & x, - const typename ::pressio::Traits::scalar_type & exponent - ); - - // y = |x|^exponent (exponent < 0) - template - abs_pow(T1 & y, - const T2 & x, - const typename ::pressio::Traits::scalar_type & exponent, - const typename ::pressio::Traits::scalar_type & eps - ); - - }} // end namespace pressio::ops - -Description ------------ - -* Raises each element of a rank-1 container ``x`` to the specified power ``exponent`` - -* Stores the result in ``y`` if provided; otherwise, acts in place on ``x`` - -* ``x`` may be any type of rank-1 container other than a Teuchos vector diff --git a/docs/generated_docs/_sources/components/ops/product.rst.txt b/docs/generated_docs/_sources/components/ops/product.rst.txt deleted file mode 100644 index cf94deb..0000000 --- a/docs/generated_docs/_sources/components/ops/product.rst.txt +++ /dev/null @@ -1,112 +0,0 @@ -.. include:: ../../mydefs.rst - -``product`` -=========== - -Header: ```` - -API ---- - -.. code-block:: cpp - - namespace pressio { namespace ops{ - - // op(A) = A - template < - class A_type, class x_type, class y_type, - class alpha_t, class beta_t - > - void product(::pressio::nontranspose /*unused*/, - const alpha_t & alpha, - const A_type & A, - const x_type & x, - const beta_t & beta, - y_type & y); - - // op(A) = A , construct result - template < - class y_type, class A_type, class x_type, class alpha_t - > - y_type product(::pressio::nontranspose mode, - const alpha_t & alpha, - const A_type & A, - const x_type & x); - - // op(A) = A^T - template < - class y_type, class A_type, class x_type, class alpha_t - > - void product(::pressio::transpose /*unused*/, - const alpha_t & alpha, - const A_type & A, - const x_type & x, - const beta_t & beta, - y_type & y); - - // op(A) = A^T , construct result - template - y_type product(::pressio::transpose mode, - const alpha_t & alpha, - const A_type & A, - const x_type & x); - - }} // end namespace pressio::ops - -Description ------------ - -* Performs matrix-vector multiplication according to ``y = beta * y + alpha * op(A) * x`` - * ``op(A)`` indicates either ``A`` or ``A^T`` - -* ``alpha_t`` and ``beta_t`` are scalar types - -* ``x_type`` and ``y_type`` are rank-1 containers - -* ``A_type`` is a rank-2 container - -* The following combinations of container types are supported for each ``A_type``: - - * Eigen - - * All container types are either Eigen containers or Pressio expressions of Eigen containers, - - * Epetra - - * ``A_type`` is an Epetra rank-2 container - * Either ``x_type`` or ``y_type`` is a rank-1 Epetra container - * The other non-Epetra container is a rank-1 Teuchos or Eigen container - - * Kokkos - - * All container types are either Kokkos views or Pressio expressions of Eigen views - - * Teuchos (does not support constructed results) - - * ``A_type`` is a rank-2 Teuchos container - * ``x_type`` and ``y_type`` are rank-1 Eigen containers - - * Tpetra - - * ``A_type`` is a rank-2 Tpetra container - - * ``x_type`` is a rank-1 Eigen, Kokkos, Teuchos, or Tpetra container - - * ``y_type`` is a rank-1 container. - If ``x_type`` is Tpetra, it may be either a Kokkos or Eigen container (or a Pressio expression of a Kokkos or Eigen container) - Otherwise, ``y_type`` is a Tpetra container or a Pressio column expression - - * Tpetra Block - - * ``A_type`` is a rank-2 Tpetra Block container - - * ``x_type`` is a rank-1 Eigen, Kokkos, Teuchos, or Tpetra Block container - - * ``y_type`` is a rank-1 container. - If ``x_type`` is a Tpetra Block vector, ``y_type`` may be either an Eigen vector or a rank-1 Kokkos view - Otherwise, ``y_type`` is a Tpetra Block vector or column expression - -Notes ------ - -* See the :doc:`ops homepage <../ops>` for a table of booleans to use when checking that ``A_type``, ``x_type``, and ``y_type``` have the correct types. diff --git a/docs/generated_docs/_sources/components/type_traits.rst.txt b/docs/generated_docs/_sources/components/type_traits.rst.txt deleted file mode 100644 index 9c29d49..0000000 --- a/docs/generated_docs/_sources/components/type_traits.rst.txt +++ /dev/null @@ -1,130 +0,0 @@ -.. role:: raw-html-m2r(raw) - :format: html - -.. include:: ../mydefs.rst - -``type_traits`` -=============== - -Header: ```` - -Public namespace: ``pressio`` - - -Scope ------ - -Provides functionalities for type introspection and detection. -One of the main design features of pressio is that it supports arbitrary -types via generic programming and type introspection, but also -provides special support for some data types commonly used. - - -Traits class ------------- - -\todo: finish - -One of the most important things inside ``type_traits`` is the ``Traits`` class: - -.. code-block:: cpp - - namespace pressio{ - template struct Traits; - } - -To understand the purpose and usage of the traits pattern in C++ there are several resources online. -Quoting Bjarne Stroustrup: "Think of a trait as a small object whose main purpose -is to carry information used by another object or algorithm -to determine "policy" or "implementation details". -Pressio uses specializations of this class to gather *in a uniform way* -compile-time information enabling it to reason about types. -The key point here is that *different TPLs use a variety of naming conventions -for nested typedefs and related things*\ , so there is not easy way to access -similar information from types of various libraries. -This is what motivated us to implement this ``type_traits`` component. -We need a standard, uniform way to query types for compile-time information. -We currently have traits specialized for types of a few TPLs, like Trilinos, Kokkos, Eigen. -An example of one such specialization (in this case for Eigen) is: - -.. code-block:: cpp - - template - struct Traits< - T, std::enable_if_t::value> - > - { - using scalar_type = typename T::Scalar; - static constexpr int rank = 1; - }; - -This ``Traits`` class play a key role when users want to use arbitrary types (i.e. types -which are not known to presso) and to do so, users shoud specialize this class and make -these specialization visibile to pressio to provide information about their generic types. :raw-html-m2r:`
      ` - -For practical examples of how this class is used, see: - -:red:`finish` - -.. - * `Newton-Raphson solver `_ - * `ode explicit steppers `_ - * `ode implicit steppers `_ - - - -Type detection and identification ---------------------------------- - -We support several metafunctions for detecting -data types commonly used from existing TPLs. -The following list is partial, and more will be added as we continue the development. - -.. list-table:: - :widths: 45 55 - :header-rows: 1 - - * - Name - - Description - * - ``template`` :raw-html-m2r:`
      ` ``struct is_static_vector_eigen;`` - - Provides static member constant ``value`` equal to ``true`` if ``T`` is a static Eigen vector. :raw-html-m2r:`
      ` Requires: ``PRESSIO_ENABLE_TPL_EIGEN==On`` - * - ``template`` :raw-html-m2r:`
      ` ``struct is_dynamic_vector_eigen;`` - - Provides static member constant ``value`` equal to ``true`` if ``T`` is a dynamic Eigen vector. :raw-html-m2r:`
      ` Requires: ``PRESSIO_ENABLE_TPL_EIGEN==On`` - * - ``template`` :raw-html-m2r:`
      ` ``struct is_vector_eigen;`` - - Provides static member constant ``value`` equal to ``true`` if ``T`` is a static or dynamic Eigen vector. :raw-html-m2r:`
      ` Requires: ``PRESSIO_ENABLE_TPL_EIGEN==On`` - * - ``template`` :raw-html-m2r:`
      ` ``struct is_sparse_matrix_eigen;`` - - Provides static member constant ``value`` equal to ``true`` if ``T`` is a static or dynamic sparse Eigen matrix. :raw-html-m2r:`
      ` Requires: ``PRESSIO_ENABLE_TPL_EIGEN==On`` - * - ``template`` :raw-html-m2r:`
      ` ``struct is_static_dense_matrix_eigen;`` - - Provides static member constant ``value`` equal to ``true`` if ``T`` is a static dense Eigen matrix. :raw-html-m2r:`
      ` Requires: ``PRESSIO_ENABLE_TPL_EIGEN==On`` - * - ``template`` :raw-html-m2r:`
      ` ``struct is_dynamic_dense_matrix_eigen;`` - - Provides static member constant ``value`` equal to ``true`` if ``T`` is a dynamic dense Eigen matrix. :raw-html-m2r:`
      ` Requires: ``PRESSIO_ENABLE_TPL_EIGEN==On`` - * - ``template`` :raw-html-m2r:`
      ` ``struct is_dense_matrix_eigen;`` - - Provides static member constant ``value`` equal to ``true`` if ``T`` is a static or dynamic dense Eigen matrix. :raw-html-m2r:`
      ` Requires: ``PRESSIO_ENABLE_TPL_EIGEN==On`` - * - ``template`` :raw-html-m2r:`
      ` ``struct is_dense_vector_teuchos;`` - - Provides static member constant ``value`` equal to ``true`` if ``T`` is a dense Teuchos vector. :raw-html-m2r:`
      ` Requires: ``PRESSIO_ENABLE_TPL_TRILINOS==On`` - * - ``template`` :raw-html-m2r:`
      ` ``struct is_dense_matrix_teuchos;`` - - Provides static member constant ``value`` equal to ``true`` if ``T`` is a dense Teuchos matrix. :raw-html-m2r:`
      ` Requires: ``PRESSIO_ENABLE_TPL_TRILINOS==On`` - * - ``template`` :raw-html-m2r:`
      ` ``struct is_vector_epetra;`` - - Provides static member constant ``value`` equal to ``true`` if ``T`` is Epetra vector. :raw-html-m2r:`
      ` Requires: ``PRESSIO_ENABLE_TPL_TRILINOS==On`` - * - ``template`` :raw-html-m2r:`
      ` ``struct is_multi_vector_epetra;`` - - Provides static member constant ``value`` equal to ``true`` if ``T`` is an Epetra multi vector. :raw-html-m2r:`
      ` Requires: ``PRESSIO_ENABLE_TPL_TRILINOS==On`` - * - ``template`` :raw-html-m2r:`
      ` ``struct is_vector_tpetra;`` - - Provides static member constant ``value`` equal to ``true`` if ``T`` is a Tpetra vector. :raw-html-m2r:`
      ` Requires: ``PRESSIO_ENABLE_TPL_TRILINOS==On`` - * - ``template`` :raw-html-m2r:`
      ` ``struct is_multi_vector_tpetra;`` - - Provides static member constant ``value`` equal to ``true`` if ``T`` is a Tpetra multi vector. :raw-html-m2r:`
      ` Requires: ``PRESSIO_ENABLE_TPL_TRILINOS==On`` - * - ``template`` :raw-html-m2r:`
      ` ``struct is_vector_tpetra_block;`` - - Provides static member constant ``value`` equal to ``true`` if ``T`` is a Tpetra-block vector. :raw-html-m2r:`
      ` Requires: ``PRESSIO_ENABLE_TPL_TRILINOS==On`` - * - ``template`` :raw-html-m2r:`
      ` ``struct is_multi_vector_tpetra_block;`` - - Provides static member constant ``value`` equal to ``true`` if ``T`` is a Tpetra-block multi vector. :raw-html-m2r:`
      ` Requires: ``PRESSIO_ENABLE_TPL_TRILINOS==On`` - * - ``template`` :raw-html-m2r:`
      ` ``struct is_static_vector_kokkos;`` - - Provides static member constant ``value`` equal to ``true`` if ``T`` is a static Kokkos vector (rank-1 View). :raw-html-m2r:`
      ` Requires: ``PRESSIO_ENABLE_TPL_KOKKOS==On`` - * - ``template`` :raw-html-m2r:`
      ` ``struct is_dynamic_vector_kokkos;`` - - Provides static member constant ``value`` equal to ``true`` if ``T`` is a dynamic Kokkos vector (rank-1 View). :raw-html-m2r:`
      ` Requires: ``PRESSIO_ENABLE_TPL_KOKKOS==On`` - * - ``template`` :raw-html-m2r:`
      ` ``struct is_vector_kokkos;`` - - Provides static member constant ``value`` equal to ``true`` if ``T`` is a static or dynamic Kokkos vector (rank-1 View). :raw-html-m2r:`
      ` Requires: ``PRESSIO_ENABLE_TPL_KOKKOS==On`` - * - ``template`` :raw-html-m2r:`
      ` ``struct is_static_dense_matrix_kokkos;`` - - Provides static member constant ``value`` equal to ``true`` if ``T`` is a static dense Kokkos matrix (rank-2 View). :raw-html-m2r:`
      ` Requires: ``PRESSIO_ENABLE_TPL_KOKKOS==On`` - * - ``template`` :raw-html-m2r:`
      ` ``struct is_dynamic_dense_matrix_kokkos;`` - - Provides static member constant ``value`` equal to ``true`` if ``T`` is a dynamic dense Kokkos matrix (rank-2 View). :raw-html-m2r:`
      ` Requires: ``PRESSIO_ENABLE_TPL_KOKKOS==On`` - * - ``template`` :raw-html-m2r:`
      ` ``struct is_dense_matrix_kokkos;`` - - Provides static member constant ``value`` equal to ``true`` if ``T`` is a static or dynamic dense Kokkos matrix (rank-2 View). :raw-html-m2r:`
      ` Requires: ``PRESSIO_ENABLE_TPL_KOKKOS==On`` diff --git a/docs/generated_docs/_sources/concepts_note.rst.txt b/docs/generated_docs/_sources/concepts_note.rst.txt deleted file mode 100644 index fcb174f..0000000 --- a/docs/generated_docs/_sources/concepts_note.rst.txt +++ /dev/null @@ -1,78 +0,0 @@ -.. role:: raw-html-m2r(raw) - :format: html - -.. include:: mydefs.rst - -pressio-ops concepts: more info -=========================== - -Concept-driven design has been and still is critical in -the development of pressio-ops. Here we describe some fundamental -notions that are at the core of our design approach. - - -``concept = syntactic constraints + semantics`` ------------------------------------------------ - -In pressio-ops, we follow the approach in "Design of Concept Libraries for C++" (2011) -in defining a concept to be a *meaningful combination of syntactic requirements + axioms/semantics*. -Pure syntax can be fully specified and checked by compilers supporting C++20. -On the contrary, axioms/semantics properties cannot be spelled out and statically checked. -Axioms are, in fact, invariants *assumed* to hold. In the C++ standard, axioms -and semantics are specified/listed as comments. Here, we adopt a different -approach to present axioms (similar to "Design of Concept Libraries for C++", 2011)), -that we believe benefits readability: axioms are explicitly listed using -the keyword "axiom". Note, however, that if you want to compile the concepts below -using a c++20 compiler, you have to comment out all axioms. - - - -- :red:`concepts are hard and it will take a few iterations to get meaninngful concepts done` - -- :red:`not all components have the same maturity, so this will be reflected in the corresponding concepts too` - -- :red:`the documentation of each concept follows the standard: we have syntax plus semantics` - - -"Satisfying" vs. "modeling" a concept -------------------------------------- - -`Quoting the C++ standard `__: "It is said -that a standard concept is satisfied if its syntactic requirements -are met, and is modeled if it is satisfied and its -semantic requirements (if any) are also met." - - - -.. - The layered design of concepts in pressio - ----------------------------------------- - - If you read the section above (hopefully you have!), you now know that, - by definition, we interpret concepts are a combination of constraints plus semantics. - Typically, designing concepts is a multi-step process. One good starting point - could be to specify the "syntactic" requirements. Then, one adds to this semantics - requirements and, if needed, revises the syntax, and so on. - This design process is useful because it allows one to create concepts in a - gradual/progressive fashion, as if one were adding one layer at a time. - In pressio, this is exactly what has happened. Some of our deepest concepts - originally started as just syntactic requirements, and then they were improved - by adding more layers. In the documentation, you will notice that some concept - are intentially presented to reflect this layered structure. - More specifically, you will notice that we have designed our concepts - such that they reflect the following layered structure: - - .. code:: none - - concepts = constraints + execution/language_axioms + math_axioms - - The execution axioms are meant to cover requirements related to the - code execution or other language-related details. - The math axioms instead are meant to cover the mathematical foundations. - Note that not all concepts have both execution and math axioms. - - .. warning:: - - As stated on the main doc page, until we can upgrade to C++20, - we cannot officially use them *stricto sensu*. - Concepts are thus currently enforced in the code via SFINAE. diff --git a/docs/generated_docs/_sources/index.rst.txt b/docs/generated_docs/_sources/index.rst.txt deleted file mode 100644 index b7de9aa..0000000 --- a/docs/generated_docs/_sources/index.rst.txt +++ /dev/null @@ -1,202 +0,0 @@ -.. role:: raw-html-m2r(raw) - :format: html - -.. include:: mydefs.rst - -pressio-ops C++ library -======================= - -Documentation of the `C++ library `__, one element of the `Pressio ecosystem `_. - -This work was started with a focus on projection-based reduced-order models (ROMs), -which is a strongly **multidisciplinary** topic. -Working towards a production-level ROM capability inevitably means spanning -multiple fields ranging from, e.g., linear algebra, nonlinear solvers -and optimization, to time integration, distributed computing and HPC. -This constitutes a substantial challenge to tackle, whose complexity -increases if aiming to develop a **generic** library. - -To start such a project from the ground up, grow it and then being -able to maintain it, we believe **modularity, abstractions -and well-defined APIs** to be fundamental design principles to rely on. -This has been, and still is, at the core of our development effort, -and has lead to a highly *modular* design of pressio (see table below): -each component (level) of the stack covers a specific capability and depends, -via *well-defined public APIs*, on the ones below it. This has required (and still does) -a considerable development effort, since each component needs "attention" -and can easily be scoped into an independent, full-time project. - -So why doing all this rather than adopting a different, simpler approach, for example, -limiting and hiding as implementation some of the supporting functionalities? -Because we believe the current structure/design offers several major benefits -that would be hard---and in some cases impossible---to obtain otherwise: **flexibility, -extensibility, maintainability, and usability of each component on its own.** -One drawback is that at any point in time, the various components might -have different maturity levels, so reaching a comparable and solid maturity -across the stack might take some time---our current goal is to obtain -in version ``1.0.0`` a uniform maturity level *at least* across -the ``rom, ode and solvers`` components. Please keep this in mind while browsing -the documentation and the code. - -Notably, we have extracted the core operations from the ``Pressio/pressio`` repository -in order to increase modularity and allow users to build their code directly on top of -``pressio-ops`` if desired. - -However, it is still useful to consider ``pressio-ops`` within the context of ``pressio`` -to understand how the repositories fit together. - -The following components are included in ``Pressio/pressio`` and build off of the contents of ``pressio-ops``: - -| - -.. list-table:: - :widths: 10 48 42 - :header-rows: 1 - :align: left - - * - - - Description - - Header(s) - - * - ``rom`` - - concepts :raw-html-m2r:`
      ` (linear) subspaces :raw-html-m2r:`
      ` Galerkin: steady :raw-html-m2r:`
      ` Galerkin: unsteady :raw-html-m2r:`
      ` LSPG: steady :raw-html-m2r:`
      ` LSPG: unsteady :raw-html-m2r:`
      ` :raw-html-m2r:`
      ` - - ```` :raw-html-m2r:`
      ` ```` :raw-html-m2r:`
      ` ```` :raw-html-m2r:`
      ` ```` :raw-html-m2r:`
      ` ```` :raw-html-m2r:`
      ` ```` :raw-html-m2r:`
      ` ```` :small:`includes all` - - * - ``ode`` - - concepts :raw-html-m2r:`
      ` explicit steppers :raw-html-m2r:`
      ` implicit steppers :raw-html-m2r:`
      ` ``advance_<*>`` fncs :raw-html-m2r:`
      ` :raw-html-m2r:`
      ` - - ```` :raw-html-m2r:`
      ` ```` :raw-html-m2r:`
      ` ```` :raw-html-m2r:`
      ` ```` :raw-html-m2r:`
      ` ```` :small:`includes all` - - * - ``solvers_nonlinear`` - - concepts :raw-html-m2r:`
      ` Newton method :raw-html-m2r:`
      ` Gauss-Newton :raw-html-m2r:`
      ` Lev.-Marq. :raw-html-m2r:`
      ` :raw-html-m2r:`
      ` - - ```` :raw-html-m2r:`
      ` ```` :raw-html-m2r:`
      ` ```` :raw-html-m2r:`
      ` ```` :raw-html-m2r:`
      ` ```` :small:`includes all` - - * - ``solvers_linear`` - - linear dense (on-node) solvers - - ```` - -The following components are included in ``Pressio/pressio-ops`` and can be used independently of the ``Pressio/pressio`` repository: - -| - -.. list-table:: - :widths: 10 48 42 - :header-rows: 1 - :align: left - - * - - - Description - - Header(s) - - * - ``ops`` - - shared-memory/distributed linear algebra kernels specializations - - ```` - - * - ``expressions`` - - expressions templates, e.g.: span, diagonal, subspan - - ```` - - * - ``type_traits`` - - type traits and detection - - ```` - - * - ``utils`` - - logger, constants, etc - - ```` - - * - ``mpl`` - - metaprogramming functionalities - - ```` - - -Get Started ------------ - -* `Install pressio-ops `_: (currently) it is a header-only library, so should be trivial - - -Generic programming and concepts --------------------------------- - -Arguably the main foundation of pressio-ops is the use of -generic programming--*or, more humbly, we can at least say that it is what we strive for*. -Since the early development stages, we have relied on concept-driven design. -Note, that, if you have used or use C++ templates, you *have* used -concepts knowingly or not. This is because when you write a function or class -template, you have some expectations of what a template needs to expose/do. -C++20 concepts are, in some sense, a way to *explicitly* formalize those expectations. - - -Until we can stably upgrade to C++20, we cannot by default use C++20 concepts, -so we currently guard the concepts in pressio inside a -preprocessor directive ``#ifdef PRESSIO_ENABLE_CXX20``. This can be enabled by -using a C++20 compliant compiler and setting ``-DCMAKE_CXX_STANDARD=20`` at configure time. -The behavior is as follows: - -- if ``PRESSIO_ENABLE_CXX20`` is *enabled*: concepts are compiled and - enforced *stricto sensu* on the pressio APIs as discussed by this documentation - -- if ``PRESSIO_ENABLE_CXX20`` is *disabled*: this is the default case because the - default pressio C++ standard is currently C++14. In this case, the "C++20 concepts" - are not compiled but the constraints they represent are still valid and implemented - differently such that their enforcement is done via a combination of SFINAE and static asserts. - -.. important:: - - Well-defined concepts are hard to design and it takes time. Concepts used in pressio are - still being developed. Some are more mature than others. The approach we adopt is to first - focus on the syntax, then then we will revise them with proper semantics. Keep this in mind - if some concepts seem incomplete. - -.. - Here, the term concept does not necessarily - refer to the C++ concepts feature introduced in C++20. - You can think of it more broadly as "what properties/syntax a type meets, - what you can do with it and, also, what a type should definitely satisfy". - The message we want to convey is that *"concepts" are a fundamental - design part of pressio*. In our documentation, we make the effort to - highlight the use of concepts - by dedicating to each component of the library a full section - to discuss and formalize how concepts are used in that component. - - -License and Citation --------------------- - -The full license (BSD-3) is available `here `_. - -Sooner or later we will publish this... in the meantime, you can find on arXiv -an (outdated) preprint at: https://arxiv.org/abs/2003.07798 - -Questions? ----------- - -Find us on Slack: https://pressioteam.slack.com or -open an issue on `github `_. - - -.. toctree:: - :maxdepth: 1 - :hidden: - - installation - keywords - -.. toctree:: - :caption: API - :maxdepth: 1 - :hidden: - - ./components/ops - ./components/expressions - ./components/type_traits - ./components/mpl - -.. toctree:: - :caption: Miscellanea - :maxdepth: 1 - :hidden: - - Tutorials - GitHub Repo - Open an issue/feature req. - license diff --git a/docs/generated_docs/_sources/installation.rst.txt b/docs/generated_docs/_sources/installation.rst.txt deleted file mode 100644 index 3b637a3..0000000 --- a/docs/generated_docs/_sources/installation.rst.txt +++ /dev/null @@ -1,142 +0,0 @@ -.. role:: raw-html-m2r(raw) - :format: html - -Installation and Dependencies -============================= - -.. tip:: - - pressio-ops is header-only, so it does not need to be precompiled and linked to. - However, since we use preprocessor directives to conditionally - enable/disable code based on target third-party libraries, - one needs to account for this. See below for the details. - -.. warning:: - - To use pressio-ops, you need at least a C++17 compiler. - -Dependencies ------------- - -Some parts of ``pressio-ops`` contain code and implementations -that are specific to third-party libraries (TPLs). -An example is ``pressio/ops``\ , which contains kernels specializations -for widely-used HPC libraries (e.g. Trilinos, Kokkos). -The main reason for doing this is that we aim, where possible, -to alleviate the user from writing custom operations and allow ``pressio-ops`` to decide when and how to leverage -the native libraries' operations to obtain the best performance. -This should facilitate the integration and use of ``pressio-ops`` by existing applications. -This is a growing capability and we currently only -provide built-in support to some external HPC libraries (see below). -Obviously, these TPL-specific specializations need to be guarded with -preprecessor directives, and enabled only if one can access the TPLs. - -Enabling/disabling specific dependencies can be done via -the cmake variables `listed here `__. - - -Optional vs Required -^^^^^^^^^^^^^^^^^^^^ - -.. list-table:: - :header-rows: 1 - :widths: 10 50 40 - :align: left - - * - TPL Name - - Optional/Required - - Version Known to Work/run in CI - * - Eigen - - Required - - 3.3.7 - * - Trilinos - - Optional - - commit: ef73d14babf6e7556b0420add98cce257ccaa56b - * - MPI - - Optional - - -- - * - Kokkos - - Optional - - 3.1.0 - * - BLAS - - Optional - - -- - * - LAPACK - - Optional - - -- - * - GoogleTest - - Optional - - 1.10.0 - -Eigen is the only required dependency because it is the -default choice for instantiating the ROM data structures -and solving the (dense) ROM problem. - -In practice, what are the steps to get, install and use Pressio? ----------------------------------------------------------------- - -\todo: add description for using pressio without configuring, -so one has to define the options directly when configuring -their code or inside the code directly. - -1. Clone `pressio-ops `_ (defaults to the main branch), -or you can pick a `release version `_ - -2. Create a build and install subdirectories - -.. code-block:: bash - - cd - mkdir build && mkdir install - -3. Use cmake to configure by passing to the comand line the target list of cmake variables to define. - -For example, suppose we want to enable support for Trilinos and the debug prints. We would do: - -.. code-block:: bash - - export PRESSIO_SRC= - cd /build - - cmake -D CMAKE_INSTALL_PREFIX=../install \ - -D PRESSIO_ENABLE_TPL_TRILINOS=ON \ - -D PRESSIO_ENABLE_DEBUG_PRINT=ON \ - ${PRESSIO_SRC} - - make install # nothing is built, just headers copied to installation - -Note that this step does **not** build anything because ``pressio-ops`` is header-only, -but only processes the cmake arguments and copies the pressio headers to the -install prefix ``/install``. -If you want, inspect the file ``/install/pressio_ops_cmake_config.h`` -which contains the cmake variables configuration. - -We also remark that during the configuration step above pressio-ops -does not need to know where a target TPL exists in your system. -In the configuration step above, you are simply telling Pressio that you have -a certain TPL and want to enable the corresponding code in pressio. -The TPLs will be needed at linking stage when you build *your* code that *uses* pressio. - -4. When building your application to use pressio-ops, you just have to point to -the installation directory ``/install`` with the installed -pressio-ops headers, and you can access all pressio-ops functionalities like so: - -.. code-block:: cpp - - #include "pressio/what_you_need.hpp" - // ... - int main(){ - // do something - } - -.. warning:: - - The procedure above is advised because it enables ``pressio-ops`` - to properly process the cmake options and turn on/off based - on certain conditions (as explained above). - The alternative way to use pressio would be to just clone the repo, - point to the ``/include`` subdirectory - and use cmake variables directly when building your code. - However, this could have unexpected consequences since - you would be resposible to set the variables correctly but you would not - know exactly all the possible constraints. diff --git a/docs/generated_docs/_sources/keywords.rst.txt b/docs/generated_docs/_sources/keywords.rst.txt deleted file mode 100644 index 4c062af..0000000 --- a/docs/generated_docs/_sources/keywords.rst.txt +++ /dev/null @@ -1,83 +0,0 @@ -CMake Keywords -############## - -.. important:: - - All CMake keywords are prefixed with ``PRESSIO_`` which is case-sensitive. - - Recall that to set a keyword in CMake you used the syntax ``-Dkeyword_name``. - - -Third-party Libraries (TPLs) -============================ - -The following options control enabling TPLs: - -.. list-table:: - :widths: 30 60 10 - :header-rows: 1 - :align: left - - * - Variable - - Description - - Default - - * - ``PRESSIO_ENABLE_TPL_EIGEN`` - - self-explanatory - - ``ON`` - - * - ``PRESSIO_ENABLE_TPL_TRILINOS`` - - self-explanatory - - ``OFF`` - - * - ``PRESSIO_ENABLE_TPL_MPI`` - - self-explanatory - - ``OFF`` automatically ``ON`` if ``PRESSIO_ENABLE_TPL_TRILINOS=ON`` - - * - ``PRESSIO_ENABLE_TPL_KOKKOS`` - - self-explanatory - - ``OFF``\ ; automatically ``ON`` if ``PRESSIO_ENABLE_TPL_TRILINOS=ON`` - - * - ``PRESSIO_ENABLE_TEUCHOS_TIMERS`` - - self-explanatory - - ``OFF`` automatically ``ON`` if ``PRESSIO_ENABLE_TPL_TRILINOS=ON`` - - -Obviously, the choice of which TPLs to enable is related to -your application's dependency requirements. -For example, if you have an application that relies on -Trilinos data structures and want to use ``pressio``\ , -then it makes sense to enable the Trilinos dependency. -On the contrary, if you have an application that relies only on -Eigen data structures, then it makes sense to only leave only Eigen on -and disable the rest. - -Also, we note that some of the cmake variables listed above are connected -and cannot be turned on individualy. -For example, if we enable Trilinos then ``pressio`` automatically -enables also Kokkos, BLAS, LAPACK and MPI. - - -Other Options -============= - -.. list-table:: - :widths: 30 60 10 - :header-rows: 1 - :align: left - - * - Variable - - Description - - Default - - * - ``PRESSIO_ENABLE_DEBUG_PRINT`` - - to enable debugging print statements - - ``OFF`` - - * - ``PRESSIO_ENABLE_CXX17`` - - enables C++17 standard - - ``ON`` since min standard is 17 - - * - ``PRESSIO_ENABLE_CXX20`` - - enables C++20 standard - - ``OFF``; turned on if ``CMAKE_CXX_STANDARD`` is set to 20 diff --git a/docs/generated_docs/_sources/license.rst.txt b/docs/generated_docs/_sources/license.rst.txt deleted file mode 100644 index 881ae5b..0000000 --- a/docs/generated_docs/_sources/license.rst.txt +++ /dev/null @@ -1,51 +0,0 @@ -License -======= - -.. highlight:: none - -:: - - //@HEADER - // ************************************************************************ - // - // Pressio - // Copyright 2019 National Technology & Engineering Solutions of Sandia,LLC - // (NTESS) - // - // Under the terms of Contract DE-NA0003525 with NTESS, the - // U.S. Government retains certain rights in this software. - // - // Pressio is licensed under BSD-3-Clause terms of use: - // - // Redistribution and use in source and binary forms, with or without - // modification, are permitted provided that the following conditions - // are met: - // - // 1. Redistributions of source code must retain the above copyright - // notice, this list of conditions and the following disclaimer. - // - // 2. Redistributions in binary form must reproduce the above copyright - // notice, this list of conditions and the following disclaimer in the - // documentation and/or other materials provided with the distribution. - // - // 3. Neither the name of the copyright holder nor the names of its - // contributors may be used to endorse or promote products derived - // from this software without specific prior written permission. - // - // THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS - // "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT - // LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS - // FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE - // COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, - // INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES - // (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR - // SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) - // HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, - // STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING - // IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE - // POSSIBILITY OF SUCH DAMAGE. - // - // Questions? Contact Francesco Rizzi (fnrizzi@sandia.gov) - // - // ************************************************************************ - //@HEADER diff --git a/docs/generated_docs/_sources/mydefs.rst.txt b/docs/generated_docs/_sources/mydefs.rst.txt deleted file mode 100644 index 43eccbf..0000000 --- a/docs/generated_docs/_sources/mydefs.rst.txt +++ /dev/null @@ -1,50 +0,0 @@ -.. Color profiles for Sphinx. -.. Has to be used with hacks.css -.. (https://bitbucket.org/lbesson/web-sphinx/src/master/.static/hacks.css) - -.. role:: black -.. role:: gray -.. role:: grey -.. role:: silver -.. role:: white -.. role:: maroon -.. role:: red -.. role:: magenta -.. role:: fuchsia -.. role:: pink -.. role:: orange -.. role:: yellow -.. role:: lime -.. role:: green -.. role:: olive -.. role:: teal -.. role:: cyan -.. role:: aqua -.. role:: blue -.. role:: navy -.. role:: purple - -.. role:: under -.. role:: over -.. role:: blink -.. role:: line -.. role:: strike - -.. role:: it -.. role:: ob - -.. role:: small -.. role:: medium -.. role:: large - -.. role:: packnameindexpage -.. role:: summarylineindexpage - -.. role:: center -.. role:: left -.. role:: right - -.. role:: memberfunction - - -.. Adapted from (c) Lilian Besson, 2011-2016, https://bitbucket.org/lbesson/web-sphinx/ diff --git a/docs/generated_docs/_static/_sphinx_javascript_frameworks_compat.js b/docs/generated_docs/_static/_sphinx_javascript_frameworks_compat.js deleted file mode 100644 index 8549469..0000000 --- a/docs/generated_docs/_static/_sphinx_javascript_frameworks_compat.js +++ /dev/null @@ -1,134 +0,0 @@ -/* - * _sphinx_javascript_frameworks_compat.js - * ~~~~~~~~~~ - * - * Compatability shim for jQuery and underscores.js. - * - * WILL BE REMOVED IN Sphinx 6.0 - * xref RemovedInSphinx60Warning - * - */ - -/** - * select a different prefix for underscore - */ -$u = _.noConflict(); - - -/** - * small helper function to urldecode strings - * - * See https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/decodeURIComponent#Decoding_query_parameters_from_a_URL - */ -jQuery.urldecode = function(x) { - if (!x) { - return x - } - return decodeURIComponent(x.replace(/\+/g, ' ')); -}; - -/** - * small helper function to urlencode strings - */ -jQuery.urlencode = encodeURIComponent; - -/** - * This function returns the parsed url parameters of the - * current request. Multiple values per key are supported, - * it will always return arrays of strings for the value parts. - */ -jQuery.getQueryParameters = function(s) { - if (typeof s === 'undefined') - s = document.location.search; - var parts = s.substr(s.indexOf('?') + 1).split('&'); - var result = {}; - for (var i = 0; i < parts.length; i++) { - var tmp = parts[i].split('=', 2); - var key = jQuery.urldecode(tmp[0]); - var value = jQuery.urldecode(tmp[1]); - if (key in result) - result[key].push(value); - else - result[key] = [value]; - } - return result; -}; - -/** - * highlight a given string on a jquery object by wrapping it in - * span elements with the given class name. - */ -jQuery.fn.highlightText = function(text, className) { - function highlight(node, addItems) { - if (node.nodeType === 3) { - var val = node.nodeValue; - var pos = val.toLowerCase().indexOf(text); - if (pos >= 0 && - !jQuery(node.parentNode).hasClass(className) && - !jQuery(node.parentNode).hasClass("nohighlight")) { - var span; - var isInSVG = jQuery(node).closest("body, svg, foreignObject").is("svg"); - if (isInSVG) { - span = document.createElementNS("http://www.w3.org/2000/svg", "tspan"); - } else { - span = document.createElement("span"); - span.className = className; - } - span.appendChild(document.createTextNode(val.substr(pos, text.length))); - node.parentNode.insertBefore(span, node.parentNode.insertBefore( - document.createTextNode(val.substr(pos + text.length)), - node.nextSibling)); - node.nodeValue = val.substr(0, pos); - if (isInSVG) { - var rect = document.createElementNS("http://www.w3.org/2000/svg", "rect"); - var bbox = node.parentElement.getBBox(); - rect.x.baseVal.value = bbox.x; - rect.y.baseVal.value = bbox.y; - rect.width.baseVal.value = bbox.width; - rect.height.baseVal.value = bbox.height; - rect.setAttribute('class', className); - addItems.push({ - "parent": node.parentNode, - "target": rect}); - } - } - } - else if (!jQuery(node).is("button, select, textarea")) { - jQuery.each(node.childNodes, function() { - highlight(this, addItems); - }); - } - } - var addItems = []; - var result = this.each(function() { - highlight(this, addItems); - }); - for (var i = 0; i < addItems.length; ++i) { - jQuery(addItems[i].parent).before(addItems[i].target); - } - return result; -}; - -/* - * backward compatibility for jQuery.browser - * This will be supported until firefox bug is fixed. - */ -if (!jQuery.browser) { - jQuery.uaMatch = function(ua) { - ua = ua.toLowerCase(); - - var match = /(chrome)[ \/]([\w.]+)/.exec(ua) || - /(webkit)[ \/]([\w.]+)/.exec(ua) || - /(opera)(?:.*version|)[ \/]([\w.]+)/.exec(ua) || - /(msie) ([\w.]+)/.exec(ua) || - ua.indexOf("compatible") < 0 && /(mozilla)(?:.*? rv:([\w.]+)|)/.exec(ua) || - []; - - return { - browser: match[ 1 ] || "", - version: match[ 2 ] || "0" - }; - }; - jQuery.browser = {}; - jQuery.browser[jQuery.uaMatch(navigator.userAgent).browser] = true; -} diff --git a/docs/generated_docs/_static/basic.css b/docs/generated_docs/_static/basic.css deleted file mode 100644 index 9039e02..0000000 --- a/docs/generated_docs/_static/basic.css +++ /dev/null @@ -1,932 +0,0 @@ -/* - * basic.css - * ~~~~~~~~~ - * - * Sphinx stylesheet -- basic theme. - * - * :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS. - * :license: BSD, see LICENSE for details. - * - */ - -/* -- main layout ----------------------------------------------------------- */ - -div.clearer { - clear: both; -} - -div.section::after { - display: block; - content: ''; - clear: left; -} - -/* -- relbar ---------------------------------------------------------------- */ - -div.related { - width: 100%; - font-size: 90%; -} - -div.related h3 { - display: none; -} - -div.related ul { - margin: 0; - padding: 0 0 0 10px; - list-style: none; -} - -div.related li { - display: inline; -} - -div.related li.right { - float: right; - margin-right: 5px; -} - -/* -- sidebar --------------------------------------------------------------- */ - -div.sphinxsidebarwrapper { - padding: 10px 5px 0 10px; -} - -div.sphinxsidebar { - float: left; - width: 230px; - margin-left: -100%; - font-size: 90%; - word-wrap: break-word; - overflow-wrap : break-word; -} - -div.sphinxsidebar ul { - list-style: none; -} - -div.sphinxsidebar ul ul, -div.sphinxsidebar ul.want-points { - margin-left: 20px; - list-style: square; -} - -div.sphinxsidebar ul ul { - margin-top: 0; - margin-bottom: 0; -} - -div.sphinxsidebar form { - margin-top: 10px; -} - -div.sphinxsidebar input { - border: 1px solid #98dbcc; - font-family: sans-serif; - font-size: 1em; -} - -div.sphinxsidebar #searchbox form.search { - overflow: hidden; -} - -div.sphinxsidebar #searchbox input[type="text"] { - float: left; - width: 80%; - padding: 0.25em; - box-sizing: border-box; -} - -div.sphinxsidebar #searchbox input[type="submit"] { - float: left; - width: 20%; - border-left: none; - padding: 0.25em; - box-sizing: border-box; -} - - -img { - border: 0; - max-width: 100%; -} - -/* -- search page ----------------------------------------------------------- */ - -ul.search { - margin: 10px 0 0 20px; - padding: 0; -} - -ul.search li { - padding: 5px 0 5px 20px; - background-image: url(file.png); - background-repeat: no-repeat; - background-position: 0 7px; -} - -ul.search li a { - font-weight: bold; -} - -ul.search li p.context { - color: #888; - margin: 2px 0 0 30px; - text-align: left; -} - -ul.keywordmatches li.goodmatch a { - font-weight: bold; -} - -/* -- index page ------------------------------------------------------------ */ - -table.contentstable { - width: 90%; - margin-left: auto; - margin-right: auto; -} - -table.contentstable p.biglink { - line-height: 150%; -} - -a.biglink { - font-size: 1.3em; -} - -span.linkdescr { - font-style: italic; - padding-top: 5px; - font-size: 90%; -} - -/* -- general index --------------------------------------------------------- */ - -table.indextable { - width: 100%; -} - -table.indextable td { - text-align: left; - vertical-align: top; -} - -table.indextable ul { - margin-top: 0; - margin-bottom: 0; - list-style-type: none; -} - -table.indextable > tbody > tr > td > ul { - padding-left: 0em; -} - -table.indextable tr.pcap { - height: 10px; -} - -table.indextable tr.cap { - margin-top: 10px; - background-color: #f2f2f2; -} - -img.toggler { - margin-right: 3px; - margin-top: 3px; - cursor: pointer; -} - -div.modindex-jumpbox { - border-top: 1px solid #ddd; - border-bottom: 1px solid #ddd; - margin: 1em 0 1em 0; - padding: 0.4em; -} - -div.genindex-jumpbox { - border-top: 1px solid #ddd; - border-bottom: 1px solid #ddd; - margin: 1em 0 1em 0; - padding: 0.4em; -} - -/* -- domain module index --------------------------------------------------- */ - -table.modindextable td { - padding: 2px; - border-collapse: collapse; -} - -/* -- general body styles --------------------------------------------------- */ - -div.body { - min-width: 360px; - max-width: 800px; -} - -div.body p, div.body dd, div.body li, div.body blockquote { - -moz-hyphens: auto; - -ms-hyphens: auto; - -webkit-hyphens: auto; - hyphens: auto; -} - -a.headerlink { - visibility: hidden; -} - -a.brackets:before, -span.brackets > a:before{ - content: "["; -} - -a.brackets:after, -span.brackets > a:after { - content: "]"; -} - -h1:hover > a.headerlink, -h2:hover > a.headerlink, -h3:hover > a.headerlink, -h4:hover > a.headerlink, -h5:hover > a.headerlink, -h6:hover > a.headerlink, -dt:hover > a.headerlink, -caption:hover > a.headerlink, -p.caption:hover > a.headerlink, -div.code-block-caption:hover > a.headerlink { - visibility: visible; -} - -div.body p.caption { - text-align: inherit; -} - -div.body td { - text-align: left; -} - -.first { - margin-top: 0 !important; -} - -p.rubric { - margin-top: 30px; - font-weight: bold; -} - -img.align-left, figure.align-left, .figure.align-left, object.align-left { - clear: left; - float: left; - margin-right: 1em; -} - -img.align-right, figure.align-right, .figure.align-right, object.align-right { - clear: right; - float: right; - margin-left: 1em; -} - -img.align-center, figure.align-center, .figure.align-center, object.align-center { - display: block; - margin-left: auto; - margin-right: auto; -} - -img.align-default, figure.align-default, .figure.align-default { - display: block; - margin-left: auto; - margin-right: auto; -} - -.align-left { - text-align: left; -} - -.align-center { - text-align: center; -} - -.align-default { - text-align: center; -} - -.align-right { - text-align: right; -} - -/* -- sidebars -------------------------------------------------------------- */ - -div.sidebar, -aside.sidebar { - margin: 0 0 0.5em 1em; - border: 1px solid #ddb; - padding: 7px; - background-color: #ffe; - width: 40%; - float: right; - clear: right; - overflow-x: auto; -} - -p.sidebar-title { - font-weight: bold; -} - -div.admonition, div.topic, aside.topic, blockquote { - clear: left; -} - -/* -- topics ---------------------------------------------------------------- */ - -div.topic, aside.topic { - border: 1px solid #ccc; - padding: 7px; - margin: 10px 0 10px 0; -} - -p.topic-title { - font-size: 1.1em; - font-weight: bold; - margin-top: 10px; -} - -/* -- admonitions ----------------------------------------------------------- */ - -div.admonition { - margin-top: 10px; - margin-bottom: 10px; - padding: 7px; -} - -div.admonition dt { - font-weight: bold; -} - -p.admonition-title { - margin: 0px 10px 5px 0px; - font-weight: bold; -} - -div.body p.centered { - text-align: center; - margin-top: 25px; -} - -/* -- content of sidebars/topics/admonitions -------------------------------- */ - -div.sidebar > :last-child, -aside.sidebar > :last-child, -div.topic > :last-child, -aside.topic > :last-child, -div.admonition > :last-child { - margin-bottom: 0; -} - -div.sidebar::after, -aside.sidebar::after, -div.topic::after, -aside.topic::after, -div.admonition::after, -blockquote::after { - display: block; - content: ''; - clear: both; -} - -/* -- tables ---------------------------------------------------------------- */ - -table.docutils { - margin-top: 10px; - margin-bottom: 10px; - border: 0; - border-collapse: collapse; -} - -table.align-center { - margin-left: auto; - margin-right: auto; -} - -table.align-default { - margin-left: auto; - margin-right: auto; -} - -table caption span.caption-number { - font-style: italic; -} - -table caption span.caption-text { -} - -table.docutils td, table.docutils th { - padding: 1px 8px 1px 5px; - border-top: 0; - border-left: 0; - border-right: 0; - border-bottom: 1px solid #aaa; -} - -th { - text-align: left; - padding-right: 5px; -} - -table.citation { - border-left: solid 1px gray; - margin-left: 1px; -} - -table.citation td { - border-bottom: none; -} - -th > :first-child, -td > :first-child { - margin-top: 0px; -} - -th > :last-child, -td > :last-child { - margin-bottom: 0px; -} - -/* -- figures --------------------------------------------------------------- */ - -div.figure, figure { - margin: 0.5em; - padding: 0.5em; -} - -div.figure p.caption, figcaption { - padding: 0.3em; -} - -div.figure p.caption span.caption-number, -figcaption span.caption-number { - font-style: italic; -} - -div.figure p.caption span.caption-text, -figcaption span.caption-text { -} - -/* -- field list styles ----------------------------------------------------- */ - -table.field-list td, table.field-list th { - border: 0 !important; -} - -.field-list ul { - margin: 0; - padding-left: 1em; -} - -.field-list p { - margin: 0; -} - -.field-name { - -moz-hyphens: manual; - -ms-hyphens: manual; - -webkit-hyphens: manual; - hyphens: manual; -} - -/* -- hlist styles ---------------------------------------------------------- */ - -table.hlist { - margin: 1em 0; -} - -table.hlist td { - vertical-align: top; -} - -/* -- object description styles --------------------------------------------- */ - -.sig { - font-family: 'Consolas', 'Menlo', 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', monospace; -} - -.sig-name, code.descname { - background-color: transparent; - font-weight: bold; -} - -.sig-name { - font-size: 1.1em; -} - -code.descname { - font-size: 1.2em; -} - -.sig-prename, code.descclassname { - background-color: transparent; -} - -.optional { - font-size: 1.3em; -} - -.sig-paren { - font-size: larger; -} - -.sig-param.n { - font-style: italic; -} - -/* C++ specific styling */ - -.sig-inline.c-texpr, -.sig-inline.cpp-texpr { - font-family: unset; -} - -.sig.c .k, .sig.c .kt, -.sig.cpp .k, .sig.cpp .kt { - color: #0033B3; -} - -.sig.c .m, -.sig.cpp .m { - color: #1750EB; -} - -.sig.c .s, .sig.c .sc, -.sig.cpp .s, .sig.cpp .sc { - color: #067D17; -} - - -/* -- other body styles ----------------------------------------------------- */ - -ol.arabic { - list-style: decimal; -} - -ol.loweralpha { - list-style: lower-alpha; -} - -ol.upperalpha { - list-style: upper-alpha; -} - -ol.lowerroman { - list-style: lower-roman; -} - -ol.upperroman { - list-style: upper-roman; -} - -:not(li) > ol > li:first-child > :first-child, -:not(li) > ul > li:first-child > :first-child { - margin-top: 0px; -} - -:not(li) > ol > li:last-child > :last-child, -:not(li) > ul > li:last-child > :last-child { - margin-bottom: 0px; -} - -ol.simple ol p, -ol.simple ul p, -ul.simple ol p, -ul.simple ul p { - margin-top: 0; -} - -ol.simple > li:not(:first-child) > p, -ul.simple > li:not(:first-child) > p { - margin-top: 0; -} - -ol.simple p, -ul.simple p { - margin-bottom: 0; -} - -/* Docutils 0.17 and older (footnotes & citations) */ -dl.footnote > dt, -dl.citation > dt { - float: left; - margin-right: 0.5em; -} - -dl.footnote > dd, -dl.citation > dd { - margin-bottom: 0em; -} - -dl.footnote > dd:after, -dl.citation > dd:after { - content: ""; - clear: both; -} - -/* Docutils 0.18+ (footnotes & citations) */ -aside.footnote > span, -div.citation > span { - float: left; -} -aside.footnote > span:last-of-type, -div.citation > span:last-of-type { - padding-right: 0.5em; -} -aside.footnote > p { - margin-left: 2em; -} -div.citation > p { - margin-left: 4em; -} -aside.footnote > p:last-of-type, -div.citation > p:last-of-type { - margin-bottom: 0em; -} -aside.footnote > p:last-of-type:after, -div.citation > p:last-of-type:after { - content: ""; - clear: both; -} - -/* Footnotes & citations ends */ - -dl.field-list { - display: grid; - grid-template-columns: fit-content(30%) auto; -} - -dl.field-list > dt { - font-weight: bold; - word-break: break-word; - padding-left: 0.5em; - padding-right: 5px; -} - -dl.field-list > dt:after { - content: ":"; -} - -dl.field-list > dd { - padding-left: 0.5em; - margin-top: 0em; - margin-left: 0em; - margin-bottom: 0em; -} - -dl { - margin-bottom: 15px; -} - -dd > :first-child { - margin-top: 0px; -} - -dd ul, dd table { - margin-bottom: 10px; -} - -dd { - margin-top: 3px; - margin-bottom: 10px; - margin-left: 30px; -} - -dl > dd:last-child, -dl > dd:last-child > :last-child { - margin-bottom: 0; -} - -dt:target, span.highlighted { - background-color: #fbe54e; -} - -rect.highlighted { - fill: #fbe54e; -} - -dl.glossary dt { - font-weight: bold; - font-size: 1.1em; -} - -.versionmodified { - font-style: italic; -} - -.system-message { - background-color: #fda; - padding: 5px; - border: 3px solid red; -} - -.footnote:target { - background-color: #ffa; -} - -.line-block { - display: block; - margin-top: 1em; - margin-bottom: 1em; -} - -.line-block .line-block { - margin-top: 0; - margin-bottom: 0; - margin-left: 1.5em; -} - -.guilabel, .menuselection { - font-family: sans-serif; -} - -.accelerator { - text-decoration: underline; -} - -.classifier { - font-style: oblique; -} - -.classifier:before { - font-style: normal; - margin: 0 0.5em; - content: ":"; - display: inline-block; -} - -abbr, acronym { - border-bottom: dotted 1px; - cursor: help; -} - -/* -- code displays --------------------------------------------------------- */ - -pre { - overflow: auto; - overflow-y: hidden; /* fixes display issues on Chrome browsers */ -} - -pre, div[class*="highlight-"] { - clear: both; -} - -span.pre { - -moz-hyphens: none; - -ms-hyphens: none; - -webkit-hyphens: none; - hyphens: none; - white-space: nowrap; -} - -div[class*="highlight-"] { - margin: 1em 0; -} - -td.linenos pre { - border: 0; - background-color: transparent; - color: #aaa; -} - -table.highlighttable { - display: block; -} - -table.highlighttable tbody { - display: block; -} - -table.highlighttable tr { - display: flex; -} - -table.highlighttable td { - margin: 0; - padding: 0; -} - -table.highlighttable td.linenos { - padding-right: 0.5em; -} - -table.highlighttable td.code { - flex: 1; - overflow: hidden; -} - -.highlight .hll { - display: block; -} - -div.highlight pre, -table.highlighttable pre { - margin: 0; -} - -div.code-block-caption + div { - margin-top: 0; -} - -div.code-block-caption { - margin-top: 1em; - padding: 2px 5px; - font-size: small; -} - -div.code-block-caption code { - background-color: transparent; -} - -table.highlighttable td.linenos, -span.linenos, -div.highlight span.gp { /* gp: Generic.Prompt */ - user-select: none; - -webkit-user-select: text; /* Safari fallback only */ - -webkit-user-select: none; /* Chrome/Safari */ - -moz-user-select: none; /* Firefox */ - -ms-user-select: none; /* IE10+ */ -} - -div.code-block-caption span.caption-number { - padding: 0.1em 0.3em; - font-style: italic; -} - -div.code-block-caption span.caption-text { -} - -div.literal-block-wrapper { - margin: 1em 0; -} - -code.xref, a code { - background-color: transparent; - font-weight: bold; -} - -h1 code, h2 code, h3 code, h4 code, h5 code, h6 code { - background-color: transparent; -} - -.viewcode-link { - float: right; -} - -.viewcode-back { - float: right; - font-family: sans-serif; -} - -div.viewcode-block:target { - margin: -1px -10px; - padding: 0 10px; -} - -/* -- math display ---------------------------------------------------------- */ - -img.math { - vertical-align: middle; -} - -div.body div.math p { - text-align: center; -} - -span.eqno { - float: right; -} - -span.eqno a.headerlink { - position: absolute; - z-index: 1; -} - -div.math:hover a.headerlink { - visibility: visible; -} - -/* -- printout stylesheet --------------------------------------------------- */ - -@media print { - div.document, - div.documentwrapper, - div.bodywrapper { - margin: 0 !important; - width: 100%; - } - - div.sphinxsidebar, - div.related, - div.footer, - #top-link { - display: none; - } -} \ No newline at end of file diff --git a/docs/generated_docs/_static/check-solid.svg b/docs/generated_docs/_static/check-solid.svg deleted file mode 100644 index 92fad4b..0000000 --- a/docs/generated_docs/_static/check-solid.svg +++ /dev/null @@ -1,4 +0,0 @@ - - - - diff --git a/docs/generated_docs/_static/clipboard.min.js b/docs/generated_docs/_static/clipboard.min.js deleted file mode 100644 index 54b3c46..0000000 --- a/docs/generated_docs/_static/clipboard.min.js +++ /dev/null @@ -1,7 +0,0 @@ -/*! - * clipboard.js v2.0.8 - * https://clipboardjs.com/ - * - * Licensed MIT © Zeno Rocha - */ -!function(t,e){"object"==typeof exports&&"object"==typeof module?module.exports=e():"function"==typeof define&&define.amd?define([],e):"object"==typeof exports?exports.ClipboardJS=e():t.ClipboardJS=e()}(this,function(){return n={686:function(t,e,n){"use strict";n.d(e,{default:function(){return o}});var e=n(279),i=n.n(e),e=n(370),u=n.n(e),e=n(817),c=n.n(e);function a(t){try{return document.execCommand(t)}catch(t){return}}var f=function(t){t=c()(t);return a("cut"),t};var l=function(t){var e,n,o,r=1 - - - - diff --git a/docs/generated_docs/_static/copybutton.css b/docs/generated_docs/_static/copybutton.css deleted file mode 100644 index 40eafe5..0000000 --- a/docs/generated_docs/_static/copybutton.css +++ /dev/null @@ -1,93 +0,0 @@ -/* Copy buttons */ -button.copybtn { - position: absolute; - display: flex; - top: .3em; - right: .3em; - width: 1.7em; - height: 1.7em; - opacity: 0; - transition: opacity 0.3s, border .3s, background-color .3s; - user-select: none; - padding: 0; - border: none; - outline: none; - border-radius: 0.4em; - /* The colors that GitHub uses */ - border: #1b1f2426 1px solid; - background-color: #f6f8fa; - color: #57606a; -} - -button.copybtn.success { - border-color: #22863a; - color: #22863a; -} - -button.copybtn svg { - stroke: currentColor; - width: 1.5em; - height: 1.5em; - padding: 0.1em; -} - -div.highlight { - position: relative; -} - -.highlight:hover button.copybtn { - opacity: 1; -} - -.highlight button.copybtn:hover { - background-color: rgb(235, 235, 235); -} - -.highlight button.copybtn:active { - background-color: rgb(187, 187, 187); -} - -/** - * A minimal CSS-only tooltip copied from: - * https://codepen.io/mildrenben/pen/rVBrpK - * - * To use, write HTML like the following: - * - *

      Short

      - */ - .o-tooltip--left { - position: relative; - } - - .o-tooltip--left:after { - opacity: 0; - visibility: hidden; - position: absolute; - content: attr(data-tooltip); - padding: .2em; - font-size: .8em; - left: -.2em; - background: grey; - color: white; - white-space: nowrap; - z-index: 2; - border-radius: 2px; - transform: translateX(-102%) translateY(0); - transition: opacity 0.2s cubic-bezier(0.64, 0.09, 0.08, 1), transform 0.2s cubic-bezier(0.64, 0.09, 0.08, 1); -} - -.o-tooltip--left:hover:after { - display: block; - opacity: 1; - visibility: visible; - transform: translateX(-100%) translateY(0); - transition: opacity 0.2s cubic-bezier(0.64, 0.09, 0.08, 1), transform 0.2s cubic-bezier(0.64, 0.09, 0.08, 1); - transition-delay: .5s; -} - -/* By default the copy button shouldn't show up when printing a page */ -@media print { - button.copybtn { - display: none; - } -} diff --git a/docs/generated_docs/_static/copybutton.js b/docs/generated_docs/_static/copybutton.js deleted file mode 100644 index 40ac331..0000000 --- a/docs/generated_docs/_static/copybutton.js +++ /dev/null @@ -1,220 +0,0 @@ -// Localization support -const messages = { - 'en': { - 'copy': 'Copy', - 'copy_to_clipboard': 'Copy to clipboard', - 'copy_success': 'Copied!', - 'copy_failure': 'Failed to copy', - }, - 'es' : { - 'copy': 'Copiar', - 'copy_to_clipboard': 'Copiar al portapapeles', - 'copy_success': '¡Copiado!', - 'copy_failure': 'Error al copiar', - }, - 'de' : { - 'copy': 'Kopieren', - 'copy_to_clipboard': 'In die Zwischenablage kopieren', - 'copy_success': 'Kopiert!', - 'copy_failure': 'Fehler beim Kopieren', - }, - 'fr' : { - 'copy': 'Copier', - 'copy_to_clipboard': 'Copié dans le presse-papier', - 'copy_success': 'Copié !', - 'copy_failure': 'Échec de la copie', - }, - 'ru': { - 'copy': 'Скопировать', - 'copy_to_clipboard': 'Скопировать в буфер', - 'copy_success': 'Скопировано!', - 'copy_failure': 'Не удалось скопировать', - }, - 'zh-CN': { - 'copy': '复制', - 'copy_to_clipboard': '复制到剪贴板', - 'copy_success': '复制成功!', - 'copy_failure': '复制失败', - }, - 'it' : { - 'copy': 'Copiare', - 'copy_to_clipboard': 'Copiato negli appunti', - 'copy_success': 'Copiato!', - 'copy_failure': 'Errore durante la copia', - } -} - -let locale = 'en' -if( document.documentElement.lang !== undefined - && messages[document.documentElement.lang] !== undefined ) { - locale = document.documentElement.lang -} - -let doc_url_root = DOCUMENTATION_OPTIONS.URL_ROOT; -if (doc_url_root == '#') { - doc_url_root = ''; -} - -/** - * SVG files for our copy buttons - */ -let iconCheck = ` - ${messages[locale]['copy_success']} - - -` - -// If the user specified their own SVG use that, otherwise use the default -let iconCopy = ``; -if (!iconCopy) { - iconCopy = ` - ${messages[locale]['copy_to_clipboard']} - - - -` -} - -/** - * Set up copy/paste for code blocks - */ - -const runWhenDOMLoaded = cb => { - if (document.readyState != 'loading') { - cb() - } else if (document.addEventListener) { - document.addEventListener('DOMContentLoaded', cb) - } else { - document.attachEvent('onreadystatechange', function() { - if (document.readyState == 'complete') cb() - }) - } -} - -const codeCellId = index => `codecell${index}` - -// Clears selected text since ClipboardJS will select the text when copying -const clearSelection = () => { - if (window.getSelection) { - window.getSelection().removeAllRanges() - } else if (document.selection) { - document.selection.empty() - } -} - -// Changes tooltip text for two seconds, then changes it back -const temporarilyChangeTooltip = (el, oldText, newText) => { - el.setAttribute('data-tooltip', newText) - el.classList.add('success') - setTimeout(() => el.setAttribute('data-tooltip', oldText), 2000) - setTimeout(() => el.classList.remove('success'), 2000) -} - -// Changes the copy button icon for two seconds, then changes it back -const temporarilyChangeIcon = (el) => { - el.innerHTML = iconCheck; - setTimeout(() => {el.innerHTML = iconCopy}, 2000) -} - -const addCopyButtonToCodeCells = () => { - // If ClipboardJS hasn't loaded, wait a bit and try again. This - // happens because we load ClipboardJS asynchronously. - if (window.ClipboardJS === undefined) { - setTimeout(addCopyButtonToCodeCells, 250) - return - } - - // Add copybuttons to all of our code cells - const codeCells = document.querySelectorAll('div.highlight pre') - codeCells.forEach((codeCell, index) => { - const id = codeCellId(index) - codeCell.setAttribute('id', id) - - const clipboardButton = id => - `` - codeCell.insertAdjacentHTML('afterend', clipboardButton(id)) - }) - -function escapeRegExp(string) { - return string.replace(/[.*+?^${}()|[\]\\]/g, '\\$&'); // $& means the whole matched string -} - -// Callback when a copy button is clicked. Will be passed the node that was clicked -// should then grab the text and replace pieces of text that shouldn't be used in output -function formatCopyText(textContent, copybuttonPromptText, isRegexp = false, onlyCopyPromptLines = true, removePrompts = true, copyEmptyLines = true, lineContinuationChar = "", hereDocDelim = "") { - - var regexp; - var match; - - // Do we check for line continuation characters and "HERE-documents"? - var useLineCont = !!lineContinuationChar - var useHereDoc = !!hereDocDelim - - // create regexp to capture prompt and remaining line - if (isRegexp) { - regexp = new RegExp('^(' + copybuttonPromptText + ')(.*)') - } else { - regexp = new RegExp('^(' + escapeRegExp(copybuttonPromptText) + ')(.*)') - } - - const outputLines = []; - var promptFound = false; - var gotLineCont = false; - var gotHereDoc = false; - const lineGotPrompt = []; - for (const line of textContent.split('\n')) { - match = line.match(regexp) - if (match || gotLineCont || gotHereDoc) { - promptFound = regexp.test(line) - lineGotPrompt.push(promptFound) - if (removePrompts && promptFound) { - outputLines.push(match[2]) - } else { - outputLines.push(line) - } - gotLineCont = line.endsWith(lineContinuationChar) & useLineCont - if (line.includes(hereDocDelim) & useHereDoc) - gotHereDoc = !gotHereDoc - } else if (!onlyCopyPromptLines) { - outputLines.push(line) - } else if (copyEmptyLines && line.trim() === '') { - outputLines.push(line) - } - } - - // If no lines with the prompt were found then just use original lines - if (lineGotPrompt.some(v => v === true)) { - textContent = outputLines.join('\n'); - } - - // Remove a trailing newline to avoid auto-running when pasting - if (textContent.endsWith("\n")) { - textContent = textContent.slice(0, -1) - } - return textContent -} - - -var copyTargetText = (trigger) => { - var target = document.querySelector(trigger.attributes['data-clipboard-target'].value); - return formatCopyText(target.innerText, '', false, true, true, true, '', '') -} - - // Initialize with a callback so we can modify the text before copy - const clipboard = new ClipboardJS('.copybtn', {text: copyTargetText}) - - // Update UI with error/success messages - clipboard.on('success', event => { - clearSelection() - temporarilyChangeTooltip(event.trigger, messages[locale]['copy'], messages[locale]['copy_success']) - temporarilyChangeIcon(event.trigger) - }) - - clipboard.on('error', event => { - temporarilyChangeTooltip(event.trigger, messages[locale]['copy'], messages[locale]['copy_failure']) - }) -} - -runWhenDOMLoaded(addCopyButtonToCodeCells) \ No newline at end of file diff --git a/docs/generated_docs/_static/copybutton_funcs.js b/docs/generated_docs/_static/copybutton_funcs.js deleted file mode 100644 index b9168c5..0000000 --- a/docs/generated_docs/_static/copybutton_funcs.js +++ /dev/null @@ -1,58 +0,0 @@ -function escapeRegExp(string) { - return string.replace(/[.*+?^${}()|[\]\\]/g, '\\$&'); // $& means the whole matched string -} - -// Callback when a copy button is clicked. Will be passed the node that was clicked -// should then grab the text and replace pieces of text that shouldn't be used in output -export function formatCopyText(textContent, copybuttonPromptText, isRegexp = false, onlyCopyPromptLines = true, removePrompts = true, copyEmptyLines = true, lineContinuationChar = "", hereDocDelim = "") { - - var regexp; - var match; - - // Do we check for line continuation characters and "HERE-documents"? - var useLineCont = !!lineContinuationChar - var useHereDoc = !!hereDocDelim - - // create regexp to capture prompt and remaining line - if (isRegexp) { - regexp = new RegExp('^(' + copybuttonPromptText + ')(.*)') - } else { - regexp = new RegExp('^(' + escapeRegExp(copybuttonPromptText) + ')(.*)') - } - - const outputLines = []; - var promptFound = false; - var gotLineCont = false; - var gotHereDoc = false; - const lineGotPrompt = []; - for (const line of textContent.split('\n')) { - match = line.match(regexp) - if (match || gotLineCont || gotHereDoc) { - promptFound = regexp.test(line) - lineGotPrompt.push(promptFound) - if (removePrompts && promptFound) { - outputLines.push(match[2]) - } else { - outputLines.push(line) - } - gotLineCont = line.endsWith(lineContinuationChar) & useLineCont - if (line.includes(hereDocDelim) & useHereDoc) - gotHereDoc = !gotHereDoc - } else if (!onlyCopyPromptLines) { - outputLines.push(line) - } else if (copyEmptyLines && line.trim() === '') { - outputLines.push(line) - } - } - - // If no lines with the prompt were found then just use original lines - if (lineGotPrompt.some(v => v === true)) { - textContent = outputLines.join('\n'); - } - - // Remove a trailing newline to avoid auto-running when pasting - if (textContent.endsWith("\n")) { - textContent = textContent.slice(0, -1) - } - return textContent -} diff --git a/docs/generated_docs/_static/debug.css b/docs/generated_docs/_static/debug.css deleted file mode 100644 index 74d4aec..0000000 --- a/docs/generated_docs/_static/debug.css +++ /dev/null @@ -1,69 +0,0 @@ -/* - This CSS file should be overridden by the theme authors. It's - meant for debugging and developing the skeleton that this theme provides. -*/ -body { - font-family: -apple-system, "Segoe UI", Roboto, Helvetica, Arial, sans-serif, - "Apple Color Emoji", "Segoe UI Emoji"; - background: lavender; -} -.sb-announcement { - background: rgb(131, 131, 131); -} -.sb-announcement__inner { - background: black; - color: white; -} -.sb-header { - background: lightskyblue; -} -.sb-header__inner { - background: royalblue; - color: white; -} -.sb-header-secondary { - background: lightcyan; -} -.sb-header-secondary__inner { - background: cornflowerblue; - color: white; -} -.sb-sidebar-primary { - background: lightgreen; -} -.sb-main { - background: blanchedalmond; -} -.sb-main__inner { - background: antiquewhite; -} -.sb-header-article { - background: lightsteelblue; -} -.sb-article-container { - background: snow; -} -.sb-article-main { - background: white; -} -.sb-footer-article { - background: lightpink; -} -.sb-sidebar-secondary { - background: lightgoldenrodyellow; -} -.sb-footer-content { - background: plum; -} -.sb-footer-content__inner { - background: palevioletred; -} -.sb-footer { - background: pink; -} -.sb-footer__inner { - background: salmon; -} -.sb-article { - background: white; -} diff --git a/docs/generated_docs/_static/doctools.js b/docs/generated_docs/_static/doctools.js deleted file mode 100644 index c3db08d..0000000 --- a/docs/generated_docs/_static/doctools.js +++ /dev/null @@ -1,264 +0,0 @@ -/* - * doctools.js - * ~~~~~~~~~~~ - * - * Base JavaScript utilities for all Sphinx HTML documentation. - * - * :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS. - * :license: BSD, see LICENSE for details. - * - */ -"use strict"; - -const _ready = (callback) => { - if (document.readyState !== "loading") { - callback(); - } else { - document.addEventListener("DOMContentLoaded", callback); - } -}; - -/** - * highlight a given string on a node by wrapping it in - * span elements with the given class name. - */ -const _highlight = (node, addItems, text, className) => { - if (node.nodeType === Node.TEXT_NODE) { - const val = node.nodeValue; - const parent = node.parentNode; - const pos = val.toLowerCase().indexOf(text); - if ( - pos >= 0 && - !parent.classList.contains(className) && - !parent.classList.contains("nohighlight") - ) { - let span; - - const closestNode = parent.closest("body, svg, foreignObject"); - const isInSVG = closestNode && closestNode.matches("svg"); - if (isInSVG) { - span = document.createElementNS("http://www.w3.org/2000/svg", "tspan"); - } else { - span = document.createElement("span"); - span.classList.add(className); - } - - span.appendChild(document.createTextNode(val.substr(pos, text.length))); - parent.insertBefore( - span, - parent.insertBefore( - document.createTextNode(val.substr(pos + text.length)), - node.nextSibling - ) - ); - node.nodeValue = val.substr(0, pos); - - if (isInSVG) { - const rect = document.createElementNS( - "http://www.w3.org/2000/svg", - "rect" - ); - const bbox = parent.getBBox(); - rect.x.baseVal.value = bbox.x; - rect.y.baseVal.value = bbox.y; - rect.width.baseVal.value = bbox.width; - rect.height.baseVal.value = bbox.height; - rect.setAttribute("class", className); - addItems.push({ parent: parent, target: rect }); - } - } - } else if (node.matches && !node.matches("button, select, textarea")) { - node.childNodes.forEach((el) => _highlight(el, addItems, text, className)); - } -}; -const _highlightText = (thisNode, text, className) => { - let addItems = []; - _highlight(thisNode, addItems, text, className); - addItems.forEach((obj) => - obj.parent.insertAdjacentElement("beforebegin", obj.target) - ); -}; - -/** - * Small JavaScript module for the documentation. - */ -const Documentation = { - init: () => { - Documentation.highlightSearchWords(); - Documentation.initDomainIndexTable(); - Documentation.initOnKeyListeners(); - }, - - /** - * i18n support - */ - TRANSLATIONS: {}, - PLURAL_EXPR: (n) => (n === 1 ? 0 : 1), - LOCALE: "unknown", - - // gettext and ngettext don't access this so that the functions - // can safely bound to a different name (_ = Documentation.gettext) - gettext: (string) => { - const translated = Documentation.TRANSLATIONS[string]; - switch (typeof translated) { - case "undefined": - return string; // no translation - case "string": - return translated; // translation exists - default: - return translated[0]; // (singular, plural) translation tuple exists - } - }, - - ngettext: (singular, plural, n) => { - const translated = Documentation.TRANSLATIONS[singular]; - if (typeof translated !== "undefined") - return translated[Documentation.PLURAL_EXPR(n)]; - return n === 1 ? singular : plural; - }, - - addTranslations: (catalog) => { - Object.assign(Documentation.TRANSLATIONS, catalog.messages); - Documentation.PLURAL_EXPR = new Function( - "n", - `return (${catalog.plural_expr})` - ); - Documentation.LOCALE = catalog.locale; - }, - - /** - * highlight the search words provided in the url in the text - */ - highlightSearchWords: () => { - const highlight = - new URLSearchParams(window.location.search).get("highlight") || ""; - const terms = highlight.toLowerCase().split(/\s+/).filter(x => x); - if (terms.length === 0) return; // nothing to do - - // There should never be more than one element matching "div.body" - const divBody = document.querySelectorAll("div.body"); - const body = divBody.length ? divBody[0] : document.querySelector("body"); - window.setTimeout(() => { - terms.forEach((term) => _highlightText(body, term, "highlighted")); - }, 10); - - const searchBox = document.getElementById("searchbox"); - if (searchBox === null) return; - searchBox.appendChild( - document - .createRange() - .createContextualFragment( - '

      ' + - '' + - Documentation.gettext("Hide Search Matches") + - "

      " - ) - ); - }, - - /** - * helper function to hide the search marks again - */ - hideSearchWords: () => { - document - .querySelectorAll("#searchbox .highlight-link") - .forEach((el) => el.remove()); - document - .querySelectorAll("span.highlighted") - .forEach((el) => el.classList.remove("highlighted")); - const url = new URL(window.location); - url.searchParams.delete("highlight"); - window.history.replaceState({}, "", url); - }, - - /** - * helper function to focus on search bar - */ - focusSearchBar: () => { - document.querySelectorAll("input[name=q]")[0]?.focus(); - }, - - /** - * Initialise the domain index toggle buttons - */ - initDomainIndexTable: () => { - const toggler = (el) => { - const idNumber = el.id.substr(7); - const toggledRows = document.querySelectorAll(`tr.cg-${idNumber}`); - if (el.src.substr(-9) === "minus.png") { - el.src = `${el.src.substr(0, el.src.length - 9)}plus.png`; - toggledRows.forEach((el) => (el.style.display = "none")); - } else { - el.src = `${el.src.substr(0, el.src.length - 8)}minus.png`; - toggledRows.forEach((el) => (el.style.display = "")); - } - }; - - const togglerElements = document.querySelectorAll("img.toggler"); - togglerElements.forEach((el) => - el.addEventListener("click", (event) => toggler(event.currentTarget)) - ); - togglerElements.forEach((el) => (el.style.display = "")); - if (DOCUMENTATION_OPTIONS.COLLAPSE_INDEX) togglerElements.forEach(toggler); - }, - - initOnKeyListeners: () => { - // only install a listener if it is really needed - if ( - !DOCUMENTATION_OPTIONS.NAVIGATION_WITH_KEYS && - !DOCUMENTATION_OPTIONS.ENABLE_SEARCH_SHORTCUTS - ) - return; - - const blacklistedElements = new Set([ - "TEXTAREA", - "INPUT", - "SELECT", - "BUTTON", - ]); - document.addEventListener("keydown", (event) => { - if (blacklistedElements.has(document.activeElement.tagName)) return; // bail for input elements - if (event.altKey || event.ctrlKey || event.metaKey) return; // bail with special keys - - if (!event.shiftKey) { - switch (event.key) { - case "ArrowLeft": - if (!DOCUMENTATION_OPTIONS.NAVIGATION_WITH_KEYS) break; - - const prevLink = document.querySelector('link[rel="prev"]'); - if (prevLink && prevLink.href) { - window.location.href = prevLink.href; - event.preventDefault(); - } - break; - case "ArrowRight": - if (!DOCUMENTATION_OPTIONS.NAVIGATION_WITH_KEYS) break; - - const nextLink = document.querySelector('link[rel="next"]'); - if (nextLink && nextLink.href) { - window.location.href = nextLink.href; - event.preventDefault(); - } - break; - case "Escape": - if (!DOCUMENTATION_OPTIONS.ENABLE_SEARCH_SHORTCUTS) break; - Documentation.hideSearchWords(); - event.preventDefault(); - } - } - - // some keyboard layouts may need Shift to get / - switch (event.key) { - case "/": - if (!DOCUMENTATION_OPTIONS.ENABLE_SEARCH_SHORTCUTS) break; - Documentation.focusSearchBar(); - event.preventDefault(); - } - }); - }, -}; - -// quick alias for translations -const _ = Documentation.gettext; - -_ready(Documentation.init); diff --git a/docs/generated_docs/_static/documentation_options.js b/docs/generated_docs/_static/documentation_options.js deleted file mode 100644 index ad10af6..0000000 --- a/docs/generated_docs/_static/documentation_options.js +++ /dev/null @@ -1,14 +0,0 @@ -var DOCUMENTATION_OPTIONS = { - URL_ROOT: document.getElementById("documentation_options").getAttribute('data-url_root'), - VERSION: '0.14.0', - LANGUAGE: 'en', - COLLAPSE_INDEX: false, - BUILDER: 'html', - FILE_SUFFIX: '.html', - LINK_SUFFIX: '.html', - HAS_SOURCE: true, - SOURCELINK_SUFFIX: '.txt', - NAVIGATION_WITH_KEYS: false, - SHOW_SEARCH_SUMMARY: true, - ENABLE_SEARCH_SHORTCUTS: false, -}; \ No newline at end of file diff --git a/docs/generated_docs/_static/file.png b/docs/generated_docs/_static/file.png deleted file mode 100644 index a858a410e4faa62ce324d814e4b816fff83a6fb3..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 286 zcmV+(0pb3MP)s`hMrGg#P~ix$^RISR_I47Y|r1 z_CyJOe}D1){SET-^Amu_i71Lt6eYfZjRyw@I6OQAIXXHDfiX^GbOlHe=Ae4>0m)d(f|Me07*qoM6N<$f}vM^LjV8( diff --git a/docs/generated_docs/_static/front_page_schematic/frontpageschem.pdf b/docs/generated_docs/_static/front_page_schematic/frontpageschem.pdf deleted file mode 100644 index 90b2a0b1252b0e8cd52fc88a82733945c8fa8be4..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 94135 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%0D+4mA~sRR3sd#7`l72#fvUBIaG7FhS~+Ck*La# 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 ?8ID0G@pZ4;S!T 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πHIweZyo_CH0?I2kGg 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 Wv%BMWo;jG - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - diff --git a/docs/generated_docs/_static/front_page_schematic/frontpageschem.tex b/docs/generated_docs/_static/front_page_schematic/frontpageschem.tex deleted file mode 100644 index c5f7710..0000000 --- a/docs/generated_docs/_static/front_page_schematic/frontpageschem.tex +++ /dev/null @@ -1,359 +0,0 @@ - -\documentclass{standalone} - -\usepackage{amsfonts} -\usepackage{graphicx} -\usepackage{epstopdf} -\usepackage{algorithmic} -\usepackage{listings} -\usepackage{fancyvrb} -\usepackage{booktabs} -\usepackage{multirow} -\usepackage{pgf} -\usepackage{tikz} -\usetikzlibrary{shapes, arrows, positioning,fit, automata, - arrows.meta, decorations.markings, calc} -\usepackage{tikzscale} -\usepackage{xcolor} -%\usepackage{tikz-uml} -\usepackage{mathtools} -\usetikzlibrary{decorations} -%\usetikzlibrary{decorations.text} - -\definecolor{colWhite}{HTML}{FFFFFF} - -% general naming macros -\newcommand{\code}[1]{{\ttfamily\color{black} #1}} -\newcommand{\pressio}{$\mathbf{Pressio}$} -\newcommand{\pressioFpy}{$\mathbf{pressio4py}$} -\newcommand{\modred}{$\mathbf{modred}$} -\newcommand{\pymor}{$\mathbf{pyMOR}$} -\newcommand{\pyrom}{$\mathbf{pyROM}$} -\newcommand{\librom}{$\mathbf{libROM}$} -% math macros general -\newcommand{\defeq}{\vcentcolon =} -\newcommand*{\difftime}[1]{\dot{#1}} -\newcommand{\tfinal}{T} -\newcommand{\RR}[1]{\mathbb{R}^{#1}} -\newcommand{\RRstar}[1]{\mathbb{R}_\star^{#1}} -\newcommand{\RRplus}{\mathbb{R}_{+}} -\newcommand{\dstate}{\boldsymbol{\xi}} -\newcommand{\drdstate}{\hat{\boldsymbol{\xi}}} -\newcommand{\range}{\text{Ran}} -\newcommand*{\pseudoInvSymb}{+} -\newcommand*{\pseudoInv}{^\pseudoInvSymb} - -\newcommand{\Boper}{\boldsymbol B} - -% FOM math macros -\newcommand{\fomDof}{N} -\newcommand{\state}{\boldsymbol y} -\newcommand{\aprxState}{\tilde{\state}} -\newcommand{\initState}{\state^{0}} -\newcommand{\stateRef}{\state_\text{ref}} -\newcommand{\velocity}{\boldsymbol f} -\newcommand{\dvelocity}{\boldsymbol v} -\newcommand{\dtime}{\tau} -\newcommand{\params}{\boldsymbol \mu} -\newcommand{\dparams}{\boldsymbol \nu} -\newcommand{\paramDomain}{\mathcal D} -\newcommand{\nparams}{n_{\params}} -\newcommand{\fomJac}{\partial\velocity/\partial \state} -%\newcommand{\aprxFomJac}{\partial\velocity/\partial \aprxState} -%\newcommand{\aprxFomJac}{\frac{\partial\velocity}{\partial \state}(\aprxState,t;\params)} -\newcommand{\fomJacVel}{ \boldsymbol J_{\velocity}} -\newcommand{\fomJacRes}{ \boldsymbol J_{R}} -\newcommand{\aprxFomJacFrac}{ \frac{\partial\velocity}{\partial \aprxState}} - -% ROM macros -\newcommand{\dofRom}{p} -\newcommand{\romState}{\hat{\state}} -\newcommand{\romToFomMapping}{\boldsymbol g} -\newcommand{\romBasis}{\boldsymbol{\Phi}} -\newcommand*{\tangentSpace}[1]{T_{#1}\manifold } -\newcommand{\manifold}{\mathcal M} -\newcommand{\gRomState}{\hat{\boldsymbol \xi}} -\newcommand{\jacOfRomFomMapping}{\boldsymbol{J}} -\newcommand{\gVelo}{\hat{\boldsymbol{v}}} -\newcommand{\initRomState}{\romState^{0}} -%\newcommand{\gaprxstate}{\tilde{\gstate}} - -\newcommand{\weightMat}{\boldsymbol{A}} -\newcommand{\weightMatDiag}{\boldsymbol{D}} -\newcommand{\identity}{\boldsymbol{I}} -\newcommand{\collocMat}{\boldsymbol{P}} -\newcommand{\phires}{{\boldsymbol \Phi}_r} -\newcommand{\gnatWMat}{(\collocMat \phires)^+ \collocMat} - -% Time stepping -\newcommand{\zero}{\boldsymbol{0}} -\newcommand{\res}{\boldsymbol{r}} -\newcommand{\timeStep}{\Delta t} -\newcommand{\nseq}{{N_t}} - - -\tikzstyle{block} = [draw, rectangle, minimum height=3em, minimum width=6em] - -\definecolor{appCol}{HTML}{FFFF00} -\definecolor{pressioCol}{HTML}{FFFFFF} - -\begin{document} - -\tikzset{ - ncbar angle/.initial=90, - ncbar/.style={ - to path=(\tikztostart) - -- ($(\tikztostart)!#1!\pgfkeysvalueof{/tikz/ncbar angle}:(\tikztotarget)$) - -- ($(\tikztotarget)!($(\tikztostart)!#1!\pgfkeysvalueof{/tikz/ncbar angle}:(\tikztotarget)$)!\pgfkeysvalueof{/tikz/ncbar angle}:(\tikztostart)$) - -- (\tikztotarget) - }, - ncbar/.default=0.5cm, -} -\tikzset{square left brace/.style={ncbar=0.3cm}} - - -\begin{tikzpicture}[auto, node distance=2cm] - - % application - \node [ - block, - draw=appCol, - text=appCol, - rounded corners, - node distance=3cm, - minimum width=0.6\textwidth, - minimum height=3cm - ](app) - { - \shortstack{ - \LARGE{Application Code}\\ - \vspace{0.3cm} - \Large{(owns mesh, physics, etc.)} - %\Large{$\dot{\state} = \velocity(\state,t;\params)$} - %% \Large{$\state(0;\params) = \initState(\params)$} - } - }; - - % adapter - \node [ - block, - draw=appCol, - text=appCol, - below=of app.south east, - anchor=north east, - node distance=9cm, - rounded corners, - minimum width=0.29\textwidth, - minimum height=3cm, - yshift=0.6cm, - xshift=-3.75cm - ] (adapter) - { - \shortstack{ - \Large{Contin.-time}\\ - \Large{Adapter} - } - }; - - % adapter2 - \node [ - block, - draw=appCol, - text=appCol, - below=of app.south east, - anchor=north east, - node distance=9cm, - rounded corners, - minimum width=0.29\textwidth, - minimum height=3cm, - xshift=0cm, - yshift=0.6cm - ] (adapter2) - { - \shortstack{ - \Large{Discrete-time}\\ - \Large{Adapter} - } - }; - - % MAIN - \node [ - block, - draw=appCol, - text=appCol, - right=of app, - anchor=north west, - node distance=8cm, - rounded corners, - minimum width=0.2\textwidth, - minimum height=12.45cm, - yshift=1.5cm, - xshift=-1.5cm - ] (main) - { - \hspace{0.2cm}\Large{\Large{int main()}}\hspace{0.2cm} - }; - - \node [ - block, - draw=pressioCol, - text=pressioCol, - below=of adapter, - rounded corners, - node distance=1.2cm, - minimum width=0.17\textwidth, - yshift=0.6cm, - xshift=-0.375cm - ](galerkin){GALERKIN}; - - \node [ - block, - draw=pressioCol, - text=pressioCol, - below=of adapter, - right=of galerkin, - rounded corners, - node distance=1.2cm, - minimum width=0.17\textwidth, - xshift=-1.75cm - ](lspg){LSPG}; - - \node [ - block, - draw=pressioCol, - text=pressioCol, - below=of adapter, - right=of lspg, - rounded corners, - node distance=1.2cm, - minimum width=0.17\textwidth, - xshift=-1.75cm - ](wls){WLS}; - - \node [ - text=pressioCol, - draw=black!50, - rounded corners, - fit={(galerkin) (lspg) (wls)}, - minimum width=0.6\textwidth - ](pressiorom) {}; - - % ode - \node [ - block, - draw=pressioCol, - text=pressioCol, - below=of adapter, - %node distance=9cm, - rounded corners, - minimum width=0.6\textwidth, - yshift=-0.75cm, - xshift=1.95cm - ] (ode){ODE}; - - % nonlinear solvers - \node [ - block, - draw=pressioCol, - text=pressioCol, - below=of ode, - node distance=9cm, rounded corners, - minimum width=0.6\textwidth, - yshift=1.82cm - ] (solvers){LINEAR/NONLINEAR SOLVERS}; - - % all other packages - \node [ - block, - draw=pressioCol, - text=pressioCol, - below=of main, - rounded corners, - minimum width=0.875\textwidth, - yshift=1.8cm, - xshift=-3.85cm - ] (basicpacks){MPL UTILS CONTAINERS OPS QR ...}; - - \node [left=of adapter, text=appCol, yshift=2cm, xshift=0.8cm](pApp) {\rotatebox{90}{\Large{Application}}}; - \node [left=of ode, text=pressioCol, yshift=-0.5cm, xshift=0.8cm](pPres) {\rotatebox{90}{\Large{\pressio}}}; - \node [left=of pressiorom, text=pressioCol, xshift=1.85cm](pRoms) {\rotatebox{90}{ROMs}}; - \node [left=of ode, text=pressioCol, yshift=-1.3cm,xshift=1.85cm](pPack) {\rotatebox{90}{Supporting Packages}}; - %% \draw [orange, thick] (basicpacks.south west) to [square left brace ] (ode.north west); - %% \draw [orange, thick] (pressiorom.south west) to [square left brace ] (pressiorom.north west); - - \draw [pressioCol, thick] - ([xshift=-0.7cm]basicpacks.south west) - to [square left brace ] ([xshift=-0.7cm]pressiorom.north west); - - %% % box around application - %% \node [fit=(main) (adapter) (app), - %% pin={[pin distance=0.1cm, yshift=2cm]left:\LARGE{\rotatebox{90}{Application Side}}}] (p5) {}; - - %% %% % box for optional part - %% %% \node [fit=(adapter), - %% %% pin={[pin distance=0.2cm]left:\Large{\rotatebox{90}{Optional}}}] (p5) {}; - - \tikzset{myptr/.style={decoration={markings,mark=at position 1 with - {\arrow[scale=1.3,>=stealth]{>}}},postaction={decorate}}} - - % rom -> adapter - \draw[red, line width=1.5pt, myptr] ([xshift=-0.4cm]pressiorom.north -| adapter) - -- node {\begin{tabular}{c} \large{$\aprxState,t$} \\ \large{[,$\Boper$]} \end{tabular}} - ([xshift=-0.4cm]adapter.south); - % adapter -> rom - \draw[green, line width=1.5pt, myptr]([xshift=-0.15cm]adapter.south) - -- node [right] {\large{$\velocity [,\fomJacVel \Boper]$}} - ([xshift=-0.15cm]pressiorom.north -| adapter); - % adapter -> app - \draw[appCol, text=appCol, line width=1.5pt, myptr]([xshift=-0.4cm]adapter.north) - -- node {\begin{tabular}{c} \large{$\aprxState,t$} \\ \large{[,$\Boper$]} \end{tabular}} - ([xshift=-2.26cm]app.south); - % app -> adapter - \draw[appCol, text=appCol, line width=1.5pt, myptr]([xshift=-2.01cm]app.south) - -- node [right] {\large{$\velocity [,\fomJacVel \Boper]$}} - ([xshift=-0.15cm]adapter.north); - - % rom -> adapter2 - \draw[red, line width=1.5pt, myptr] ([xshift=0.15cm]pressiorom.north -| adapter2) - -- node {\begin{tabular}{c} \large{$\aprxState_{n,n-1,...}$} \\ \large{$t,\Boper$} \end{tabular}} - ([xshift=0.15cm]adapter2.south); - % adapter2 -> rom - \draw[green, line width=1.5pt, myptr]([xshift=0.4cm]adapter2.south) - -- node [right] {\large{$R,\fomJacRes \Boper$}} - ([xshift=0.4cm]pressiorom.north -| adapter2); - % adapter2 -> app - \draw[appCol, text=appCol, line width=1.5pt, myptr]([xshift=0.15cm]adapter2.north) - -- node {\begin{tabular}{c} \large{$\aprxState_{n,n-1,...}$} \\ \large{$t,\Boper$} \end{tabular}} - ([xshift=2.03cm]app.south); - % app -> adapter2 - \draw[appCol, text=appCol, line width=1.5pt, myptr]([xshift=2.28cm]app.south) - -- node [right] {\large{$R,\fomJacRes \Boper$}} - ([xshift=0.4cm]adapter2.north); - - - \node [left=of app.west, yshift=1.65cm, xshift=1cm](p1){}; - \node [left=of adapter.west, yshift=-1.5cm, xshift=1cm](p2){}; - \node [right=of adapter2.east, yshift=-1.5cm, xshift=-1.8cm](p3){}; - \node [left=of main.south west, yshift=-0.1cm, xshift=1.95cm](p4){}; - \node [right=of main.south east, yshift=-0.1cm, xshift=-1.92cm](p5){}; - \node [right=of main.north east, yshift=0.15cm, xshift=-1.92cm](p6){}; - - \draw [thick, dashed, draw=appCol] (p1) -- (p2) -- (p3) -- (p4) -- (p5) -- (p6) -- (p1); - - - %% % arrows from main to others - %% %\draw[black, arrows={-Circle[black,fill=black]}, line width=2pt] - %% \draw[black, arrows={-o}, line width=2pt] - %% (main.north) -- ([xshift=-4.79cm]pressiorom.south); - - %% %\draw[black, arrows={-Circle[black,fill=black]}, line width=2pt] - %% \draw[black, arrows={-o}, line width=2pt] - %% ([yshift=2.55cm]main.east) -- (adapter.west); - - %% %\draw[black, arrows={-Circle[black,fill=black]}, line width=2pt] - %% \draw[black, arrows={-o}, line width=2pt ] - %% ([yshift=-2.45cm]main.east) -- (app.west); - -\end{tikzpicture} - -\end{document} diff --git a/docs/generated_docs/_static/frontpageschem.svg b/docs/generated_docs/_static/frontpageschem.svg deleted file mode 100644 index e2e5685..0000000 --- a/docs/generated_docs/_static/frontpageschem.svg +++ /dev/null @@ -1,866 +0,0 @@ - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - diff --git a/docs/generated_docs/_static/hacks.css b/docs/generated_docs/_static/hacks.css deleted file mode 100644 index 0b12d62..0000000 --- a/docs/generated_docs/_static/hacks.css +++ /dev/null @@ -1,170 +0,0 @@ -/* - * CSS hacks and small modification for my Sphinx website - * :copyright: Copyright 2013-2016 Lilian Besson - * :license: GPLv3, see LICENSE for details. - */ - - -/* Colors and text decoration. - For example, :black:`text in black` or :blink:`text blinking` in rST. */ - -.black { - color: black; -} - -.gray { - color: gray; -} - -.grey { - color: gray; -} - -.silver { - color: silver; -} - -.white { - color: white; -} - -.maroon { - color: maroon; -} - -.red { - color: red; -} - -.magenta { - color: magenta; -} - -.fuchsia { - color: fuchsia; -} - -.pink { - color: pink; -} - -.orange { - color: orange; -} - -.yellow { - color: yellow; -} - -.lime { - color: lime; -} - -.green { - color: green; -} - -.olive { - color: olive; -} - -.teal { - color: teal; -} - -.cyan { - color: cyan; -} - -.aqua { - color: aqua; -} - -.blue { - color: blue; -} - -.navy { - color: navy; -} - -.purple { - color: purple; -} - -.under { - text-decoration: underline; -} - -.over { - text-decoration: overline; -} - -.blink { - text-decoration: blink; -} - -.line { - text-decoration: line-through; -} - -.strike { - text-decoration: line-through; -} - -.it { - font-style: italic; -} - -.ob { - font-style: oblique; -} - -.small { - font-size: small; -} - -.medium { - font-size: medium; -} - -.large { - font-size: large; -} - -.smallpar { - font-size: small; -} - -.packnameindexpage { - font-size: large; - color: orange; -} - -.summarylineindexpage { - font-size: large; - font-style: italic; - color: olive; -} - -.memberfunction { - font-size: large; - font-weight: bold; - color: olive; -} - -:root { - --icon--pied-piper: url('data:image/svg+xml;charset=utf-8,'); -} -.admonition.pied-piper { - border-color: rgb(43, 155, 70); -} -.admonition.pied-piper > .admonition-title { - background-color: rgba(43, 155, 70, 0.1); - border-color: rgb(43, 155, 70); -} -.admonition.pied-piper > .admonition-title::before { - background-color: rgb(43, 155, 70); - -webkit-mask-image: var(--icon--pied-piper); - mask-image: var(--icon--pied-piper); -} diff --git a/docs/generated_docs/_static/jquery-3.6.0.js b/docs/generated_docs/_static/jquery-3.6.0.js deleted file mode 100644 index fc6c299..0000000 --- a/docs/generated_docs/_static/jquery-3.6.0.js +++ /dev/null @@ -1,10881 +0,0 @@ -/*! - * jQuery JavaScript Library v3.6.0 - * https://jquery.com/ - * - * Includes Sizzle.js - * https://sizzlejs.com/ - * - * Copyright OpenJS Foundation and other contributors - * Released under the MIT license - * https://jquery.org/license - * - * Date: 2021-03-02T17:08Z - */ -( function( global, factory ) { - - "use strict"; - - if ( typeof module === "object" && typeof module.exports === "object" ) { - - // For CommonJS and CommonJS-like environments where a proper `window` - // is present, execute the factory and get jQuery. - // For environments that do not have a `window` with a `document` - // (such as Node.js), expose a factory as module.exports. - // This accentuates the need for the creation of a real `window`. - // e.g. var jQuery = require("jquery")(window); - // See ticket #14549 for more info. - module.exports = global.document ? - factory( global, true ) : - function( w ) { - if ( !w.document ) { - throw new Error( "jQuery requires a window with a document" ); - } - return factory( w ); - }; - } else { - factory( global ); - } - -// Pass this if window is not defined yet -} )( typeof window !== "undefined" ? window : this, function( window, noGlobal ) { - -// Edge <= 12 - 13+, Firefox <=18 - 45+, IE 10 - 11, Safari 5.1 - 9+, iOS 6 - 9.1 -// throw exceptions when non-strict code (e.g., ASP.NET 4.5) accesses strict mode -// arguments.callee.caller (trac-13335). But as of jQuery 3.0 (2016), strict mode should be common -// enough that all such attempts are guarded in a try block. -"use strict"; - -var arr = []; - -var getProto = Object.getPrototypeOf; - -var slice = arr.slice; - -var flat = arr.flat ? function( array ) { - return arr.flat.call( array ); -} : function( array ) { - return arr.concat.apply( [], array ); -}; - - -var push = arr.push; - -var indexOf = arr.indexOf; - -var class2type = {}; - -var toString = class2type.toString; - -var hasOwn = class2type.hasOwnProperty; - -var fnToString = hasOwn.toString; - -var ObjectFunctionString = fnToString.call( Object ); - -var support = {}; - -var isFunction = function isFunction( obj ) { - - // Support: Chrome <=57, Firefox <=52 - // In some browsers, typeof returns "function" for HTML elements - // (i.e., `typeof document.createElement( "object" ) === "function"`). - // We don't want to classify *any* DOM node as a function. - // Support: QtWeb <=3.8.5, WebKit <=534.34, wkhtmltopdf tool <=0.12.5 - // Plus for old WebKit, typeof returns "function" for HTML collections - // (e.g., `typeof document.getElementsByTagName("div") === "function"`). (gh-4756) - return typeof obj === "function" && typeof obj.nodeType !== "number" && - typeof obj.item !== "function"; - }; - - -var isWindow = function isWindow( obj ) { - return obj != null && obj === obj.window; - }; - - -var document = window.document; - - - - var preservedScriptAttributes = { - type: true, - src: true, - nonce: true, - noModule: true - }; - - function DOMEval( code, node, doc ) { - doc = doc || document; - - var i, val, - script = doc.createElement( "script" ); - - script.text = code; - if ( node ) { - for ( i in preservedScriptAttributes ) { - - // Support: Firefox 64+, Edge 18+ - // Some browsers don't support the "nonce" property on scripts. - // On the other hand, just using `getAttribute` is not enough as - // the `nonce` attribute is reset to an empty string whenever it - // becomes browsing-context connected. - // See https://github.com/whatwg/html/issues/2369 - // See https://html.spec.whatwg.org/#nonce-attributes - // The `node.getAttribute` check was added for the sake of - // `jQuery.globalEval` so that it can fake a nonce-containing node - // via an object. - val = node[ i ] || node.getAttribute && node.getAttribute( i ); - if ( val ) { - script.setAttribute( i, val ); - } - } - } - doc.head.appendChild( script ).parentNode.removeChild( script ); - } - - -function toType( obj ) { - if ( obj == null ) { - return obj + ""; - } - - // Support: Android <=2.3 only (functionish RegExp) - return typeof obj === "object" || typeof obj === "function" ? - class2type[ toString.call( obj ) ] || "object" : - typeof obj; -} -/* global Symbol */ -// Defining this global in .eslintrc.json would create a danger of using the global -// unguarded in another place, it seems safer to define global only for this module - - - -var - version = "3.6.0", - - // Define a local copy of jQuery - jQuery = function( selector, context ) { - - // The jQuery object is actually just the init constructor 'enhanced' - // Need init if jQuery is called (just allow error to be thrown if not included) - return new jQuery.fn.init( selector, context ); - }; - -jQuery.fn = jQuery.prototype = { - - // The current version of jQuery being used - jquery: version, - - constructor: jQuery, - - // The default length of a jQuery object is 0 - length: 0, - - toArray: function() { - return slice.call( this ); - }, - - // Get the Nth element in the matched element set OR - // Get the whole matched element set as a clean array - get: function( num ) { - - // Return all the elements in a clean array - if ( num == null ) { - return slice.call( this ); - } - - // Return just the one element from the set - return num < 0 ? this[ num + this.length ] : this[ num ]; - }, - - // Take an array of elements and push it onto the stack - // (returning the new matched element set) - pushStack: function( elems ) { - - // Build a new jQuery matched element set - var ret = jQuery.merge( this.constructor(), elems ); - - // Add the old object onto the stack (as a reference) - ret.prevObject = this; - - // Return the newly-formed element set - return ret; - }, - - // Execute a callback for every element in the matched set. - each: function( callback ) { - return jQuery.each( this, callback ); - }, - - map: function( callback ) { - return this.pushStack( jQuery.map( this, function( elem, i ) { - return callback.call( elem, i, elem ); - } ) ); - }, - - slice: function() { - return this.pushStack( slice.apply( this, arguments ) ); - }, - - first: function() { - return this.eq( 0 ); - }, - - last: function() { - return this.eq( -1 ); - }, - - even: function() { - return this.pushStack( jQuery.grep( this, function( _elem, i ) { - return ( i + 1 ) % 2; - } ) ); - }, - - odd: function() { - return this.pushStack( jQuery.grep( this, function( _elem, i ) { - return i % 2; - } ) ); - }, - - eq: function( i ) { - var len = this.length, - j = +i + ( i < 0 ? len : 0 ); - return this.pushStack( j >= 0 && j < len ? [ this[ j ] ] : [] ); - }, - - end: function() { - return this.prevObject || this.constructor(); - }, - - // For internal use only. - // Behaves like an Array's method, not like a jQuery method. - push: push, - sort: arr.sort, - splice: arr.splice -}; - -jQuery.extend = jQuery.fn.extend = function() { - var options, name, src, copy, copyIsArray, clone, - target = arguments[ 0 ] || {}, - i = 1, - length = arguments.length, - deep = false; - - // Handle a deep copy situation - if ( typeof target === "boolean" ) { - deep = target; - - // Skip the boolean and the target - target = arguments[ i ] || {}; - i++; - } - - // Handle case when target is a string or something (possible in deep copy) - if ( typeof target !== "object" && !isFunction( target ) ) { - target = {}; - } - - // Extend jQuery itself if only one argument is passed - if ( i === length ) { - target = this; - i--; - } - - for ( ; i < length; i++ ) { - - // Only deal with non-null/undefined values - if ( ( options = arguments[ i ] ) != null ) { - - // Extend the base object - for ( name in options ) { - copy = options[ name ]; - - // Prevent Object.prototype pollution - // Prevent never-ending loop - if ( name === "__proto__" || target === copy ) { - continue; - } - - // Recurse if we're merging plain objects or arrays - if ( deep && copy && ( jQuery.isPlainObject( copy ) || - ( copyIsArray = Array.isArray( copy ) ) ) ) { - src = target[ name ]; - - // Ensure proper type for the source value - if ( copyIsArray && !Array.isArray( src ) ) { - clone = []; - } else if ( !copyIsArray && !jQuery.isPlainObject( src ) ) { - clone = {}; - } else { - clone = src; - } - copyIsArray = false; - - // Never move original objects, clone them - target[ name ] = jQuery.extend( deep, clone, copy ); - - // Don't bring in undefined values - } else if ( copy !== undefined ) { - target[ name ] = copy; - } - } - } - } - - // Return the modified object - return target; -}; - -jQuery.extend( { - - // Unique for each copy of jQuery on the page - expando: "jQuery" + ( version + Math.random() ).replace( /\D/g, "" ), - - // Assume jQuery is ready without the ready module - isReady: true, - - error: function( msg ) { - throw new Error( msg ); - }, - - noop: function() {}, - - isPlainObject: function( obj ) { - var proto, Ctor; - - // Detect obvious negatives - // Use toString instead of jQuery.type to catch host objects - if ( !obj || toString.call( obj ) !== "[object Object]" ) { - return false; - } - - proto = getProto( obj ); - - // Objects with no prototype (e.g., `Object.create( null )`) are plain - if ( !proto ) { - return true; - } - - // Objects with prototype are plain iff they were constructed by a global Object function - Ctor = hasOwn.call( proto, "constructor" ) && proto.constructor; - return typeof Ctor === "function" && fnToString.call( Ctor ) === ObjectFunctionString; - }, - - isEmptyObject: function( obj ) { - var name; - - for ( name in obj ) { - return false; - } - return true; - }, - - // Evaluates a script in a provided context; falls back to the global one - // if not specified. - globalEval: function( code, options, doc ) { - DOMEval( code, { nonce: options && options.nonce }, doc ); - }, - - each: function( obj, callback ) { - var length, i = 0; - - if ( isArrayLike( obj ) ) { - length = obj.length; - for ( ; i < length; i++ ) { - if ( callback.call( obj[ i ], i, obj[ i ] ) === false ) { - break; - } - } - } else { - for ( i in obj ) { - if ( callback.call( obj[ i ], i, obj[ i ] ) === false ) { - break; - } - } - } - - return obj; - }, - - // results is for internal usage only - makeArray: function( arr, results ) { - var ret = results || []; - - if ( arr != null ) { - if ( isArrayLike( Object( arr ) ) ) { - jQuery.merge( ret, - typeof arr === "string" ? - [ arr ] : arr - ); - } else { - push.call( ret, arr ); - } - } - - return ret; - }, - - inArray: function( elem, arr, i ) { - return arr == null ? -1 : indexOf.call( arr, elem, i ); - }, - - // Support: Android <=4.0 only, PhantomJS 1 only - // push.apply(_, arraylike) throws on ancient WebKit - merge: function( first, second ) { - var len = +second.length, - j = 0, - i = first.length; - - for ( ; j < len; j++ ) { - first[ i++ ] = second[ j ]; - } - - first.length = i; - - return first; - }, - - grep: function( elems, callback, invert ) { - var callbackInverse, - matches = [], - i = 0, - length = elems.length, - callbackExpect = !invert; - - // Go through the array, only saving the items - // that pass the validator function - for ( ; i < length; i++ ) { - callbackInverse = !callback( elems[ i ], i ); - if ( callbackInverse !== callbackExpect ) { - matches.push( elems[ i ] ); - } - } - - return matches; - }, - - // arg is for internal usage only - map: function( elems, callback, arg ) { - var length, value, - i = 0, - ret = []; - - // Go through the array, translating each of the items to their new values - if ( isArrayLike( elems ) ) { - length = elems.length; - for ( ; i < length; i++ ) { - value = callback( elems[ i ], i, arg ); - - if ( value != null ) { - ret.push( value ); - } - } - - // Go through every key on the object, - } else { - for ( i in elems ) { - value = callback( elems[ i ], i, arg ); - - if ( value != null ) { - ret.push( value ); - } - } - } - - // Flatten any nested arrays - return flat( ret ); - }, - - // A global GUID counter for objects - guid: 1, - - // jQuery.support is not used in Core but other projects attach their - // properties to it so it needs to exist. - support: support -} ); - -if ( typeof Symbol === "function" ) { - jQuery.fn[ Symbol.iterator ] = arr[ Symbol.iterator ]; -} - -// Populate the class2type map -jQuery.each( "Boolean Number String Function Array Date RegExp Object Error Symbol".split( " " ), - function( _i, name ) { - class2type[ "[object " + name + "]" ] = name.toLowerCase(); - } ); - -function isArrayLike( obj ) { - - // Support: real iOS 8.2 only (not reproducible in simulator) - // `in` check used to prevent JIT error (gh-2145) - // hasOwn isn't used here due to false negatives - // regarding Nodelist length in IE - var length = !!obj && "length" in obj && obj.length, - type = toType( obj ); - - if ( isFunction( obj ) || isWindow( obj ) ) { - return false; - } - - return type === "array" || length === 0 || - typeof length === "number" && length > 0 && ( length - 1 ) in obj; -} -var Sizzle = -/*! - * Sizzle CSS Selector Engine v2.3.6 - * https://sizzlejs.com/ - * - * Copyright JS Foundation and other contributors - * Released under the MIT license - * https://js.foundation/ - * - * Date: 2021-02-16 - */ -( function( window ) { -var i, - support, - Expr, - getText, - isXML, - tokenize, - compile, - select, - outermostContext, - sortInput, - hasDuplicate, - - // Local document vars - setDocument, - document, - docElem, - documentIsHTML, - rbuggyQSA, - rbuggyMatches, - matches, - contains, - - // Instance-specific data - expando = "sizzle" + 1 * new Date(), - preferredDoc = window.document, - dirruns = 0, - done = 0, - classCache = createCache(), - tokenCache = createCache(), - compilerCache = createCache(), - nonnativeSelectorCache = createCache(), - sortOrder = function( a, b ) { - if ( a === b ) { - hasDuplicate = true; - } - return 0; - }, - - // Instance methods - hasOwn = ( {} ).hasOwnProperty, - arr = [], - pop = arr.pop, - pushNative = arr.push, - push = arr.push, - slice = arr.slice, - - // Use a stripped-down indexOf as it's faster than native - // https://jsperf.com/thor-indexof-vs-for/5 - indexOf = function( list, elem ) { - var i = 0, - len = list.length; - for ( ; i < len; i++ ) { - if ( list[ i ] === elem ) { - return i; - } - } - return -1; - }, - - booleans = "checked|selected|async|autofocus|autoplay|controls|defer|disabled|hidden|" + - "ismap|loop|multiple|open|readonly|required|scoped", - - // Regular expressions - - // http://www.w3.org/TR/css3-selectors/#whitespace - whitespace = "[\\x20\\t\\r\\n\\f]", - - // https://www.w3.org/TR/css-syntax-3/#ident-token-diagram - identifier = "(?:\\\\[\\da-fA-F]{1,6}" + whitespace + - "?|\\\\[^\\r\\n\\f]|[\\w-]|[^\0-\\x7f])+", - - // Attribute selectors: http://www.w3.org/TR/selectors/#attribute-selectors - attributes = "\\[" + whitespace + "*(" + identifier + ")(?:" + whitespace + - - // Operator (capture 2) - "*([*^$|!~]?=)" + whitespace + - - // "Attribute values must be CSS identifiers [capture 5] - // or strings [capture 3 or capture 4]" - "*(?:'((?:\\\\.|[^\\\\'])*)'|\"((?:\\\\.|[^\\\\\"])*)\"|(" + identifier + "))|)" + - whitespace + "*\\]", - - pseudos = ":(" + identifier + ")(?:\\((" + - - // To reduce the number of selectors needing tokenize in the preFilter, prefer arguments: - // 1. quoted (capture 3; capture 4 or capture 5) - "('((?:\\\\.|[^\\\\'])*)'|\"((?:\\\\.|[^\\\\\"])*)\")|" + - - // 2. simple (capture 6) - "((?:\\\\.|[^\\\\()[\\]]|" + attributes + ")*)|" + - - // 3. anything else (capture 2) - ".*" + - ")\\)|)", - - // Leading and non-escaped trailing whitespace, capturing some non-whitespace characters preceding the latter - rwhitespace = new RegExp( whitespace + "+", "g" ), - rtrim = new RegExp( "^" + whitespace + "+|((?:^|[^\\\\])(?:\\\\.)*)" + - whitespace + "+$", "g" ), - - rcomma = new RegExp( "^" + whitespace + "*," + whitespace + "*" ), - rcombinators = new RegExp( "^" + whitespace + "*([>+~]|" + whitespace + ")" + whitespace + - "*" ), - rdescend = new RegExp( whitespace + "|>" ), - - rpseudo = new RegExp( pseudos ), - ridentifier = new RegExp( "^" + identifier + "$" ), - - matchExpr = { - "ID": new RegExp( "^#(" + identifier + ")" ), - "CLASS": new RegExp( "^\\.(" + identifier + ")" ), - "TAG": new RegExp( "^(" + identifier + "|[*])" ), - "ATTR": new RegExp( "^" + attributes ), - "PSEUDO": new RegExp( "^" + pseudos ), - "CHILD": new RegExp( "^:(only|first|last|nth|nth-last)-(child|of-type)(?:\\(" + - whitespace + "*(even|odd|(([+-]|)(\\d*)n|)" + whitespace + "*(?:([+-]|)" + - whitespace + "*(\\d+)|))" + whitespace + "*\\)|)", "i" ), - "bool": new RegExp( "^(?:" + booleans + ")$", "i" ), - - // For use in libraries implementing .is() - // We use this for POS matching in `select` - "needsContext": new RegExp( "^" + whitespace + - "*[>+~]|:(even|odd|eq|gt|lt|nth|first|last)(?:\\(" + whitespace + - "*((?:-\\d)?\\d*)" + whitespace + "*\\)|)(?=[^-]|$)", "i" ) - }, - - rhtml = /HTML$/i, - rinputs = /^(?:input|select|textarea|button)$/i, - rheader = /^h\d$/i, - - rnative = /^[^{]+\{\s*\[native \w/, - - // Easily-parseable/retrievable ID or TAG or CLASS selectors - rquickExpr = /^(?:#([\w-]+)|(\w+)|\.([\w-]+))$/, - - rsibling = /[+~]/, - - // CSS escapes - // http://www.w3.org/TR/CSS21/syndata.html#escaped-characters - runescape = new RegExp( "\\\\[\\da-fA-F]{1,6}" + whitespace + "?|\\\\([^\\r\\n\\f])", "g" ), - funescape = function( escape, nonHex ) { - var high = "0x" + escape.slice( 1 ) - 0x10000; - - return nonHex ? - - // Strip the backslash prefix from a non-hex escape sequence - nonHex : - - // Replace a hexadecimal escape sequence with the encoded Unicode code point - // Support: IE <=11+ - // For values outside the Basic Multilingual Plane (BMP), manually construct a - // surrogate pair - high < 0 ? - String.fromCharCode( high + 0x10000 ) : - String.fromCharCode( high >> 10 | 0xD800, high & 0x3FF | 0xDC00 ); - }, - - // CSS string/identifier serialization - // https://drafts.csswg.org/cssom/#common-serializing-idioms - rcssescape = /([\0-\x1f\x7f]|^-?\d)|^-$|[^\0-\x1f\x7f-\uFFFF\w-]/g, - fcssescape = function( ch, asCodePoint ) { - if ( asCodePoint ) { - - // U+0000 NULL becomes U+FFFD REPLACEMENT CHARACTER - if ( ch === "\0" ) { - return "\uFFFD"; - } - - // Control characters and (dependent upon position) numbers get escaped as code points - return ch.slice( 0, -1 ) + "\\" + - ch.charCodeAt( ch.length - 1 ).toString( 16 ) + " "; - } - - // Other potentially-special ASCII characters get backslash-escaped - return "\\" + ch; - }, - - // Used for iframes - // See setDocument() - // Removing the function wrapper causes a "Permission Denied" - // error in IE - unloadHandler = function() { - setDocument(); - }, - - inDisabledFieldset = addCombinator( - function( elem ) { - return elem.disabled === true && elem.nodeName.toLowerCase() === "fieldset"; - }, - { dir: "parentNode", next: "legend" } - ); - -// Optimize for push.apply( _, NodeList ) -try { - push.apply( - ( arr = slice.call( preferredDoc.childNodes ) ), - preferredDoc.childNodes - ); - - // Support: Android<4.0 - // Detect silently failing push.apply - // eslint-disable-next-line no-unused-expressions - arr[ preferredDoc.childNodes.length ].nodeType; -} catch ( e ) { - push = { apply: arr.length ? - - // Leverage slice if possible - function( target, els ) { - pushNative.apply( target, slice.call( els ) ); - } : - - // Support: IE<9 - // Otherwise append directly - function( target, els ) { - var j = target.length, - i = 0; - - // Can't trust NodeList.length - while ( ( target[ j++ ] = els[ i++ ] ) ) {} - target.length = j - 1; - } - }; -} - -function Sizzle( selector, context, results, seed ) { - var m, i, elem, nid, match, groups, newSelector, - newContext = context && context.ownerDocument, - - // nodeType defaults to 9, since context defaults to document - nodeType = context ? context.nodeType : 9; - - results = results || []; - - // Return early from calls with invalid selector or context - if ( typeof selector !== "string" || !selector || - nodeType !== 1 && nodeType !== 9 && nodeType !== 11 ) { - - return results; - } - - // Try to shortcut find operations (as opposed to filters) in HTML documents - if ( !seed ) { - setDocument( context ); - context = context || document; - - if ( documentIsHTML ) { - - // If the selector is sufficiently simple, try using a "get*By*" DOM method - // (excepting DocumentFragment context, where the methods don't exist) - if ( nodeType !== 11 && ( match = rquickExpr.exec( selector ) ) ) { - - // ID selector - if ( ( m = match[ 1 ] ) ) { - - // Document context - if ( nodeType === 9 ) { - if ( ( elem = context.getElementById( m ) ) ) { - - // Support: IE, Opera, Webkit - // TODO: identify versions - // getElementById can match elements by name instead of ID - if ( elem.id === m ) { - results.push( elem ); - return results; - } - } else { - return results; - } - - // Element context - } else { - - // Support: IE, Opera, Webkit - // TODO: identify versions - // getElementById can match elements by name instead of ID - if ( newContext && ( elem = newContext.getElementById( m ) ) && - contains( context, elem ) && - elem.id === m ) { - - results.push( elem ); - return results; - } - } - - // Type selector - } else if ( match[ 2 ] ) { - push.apply( results, context.getElementsByTagName( selector ) ); - return results; - - // Class selector - } else if ( ( m = match[ 3 ] ) && support.getElementsByClassName && - context.getElementsByClassName ) { - - push.apply( results, context.getElementsByClassName( m ) ); - return results; - } - } - - // Take advantage of querySelectorAll - if ( support.qsa && - !nonnativeSelectorCache[ selector + " " ] && - ( !rbuggyQSA || !rbuggyQSA.test( selector ) ) && - - // Support: IE 8 only - // Exclude object elements - ( nodeType !== 1 || context.nodeName.toLowerCase() !== "object" ) ) { - - newSelector = selector; - newContext = context; - - // qSA considers elements outside a scoping root when evaluating child or - // descendant combinators, which is not what we want. - // In such cases, we work around the behavior by prefixing every selector in the - // list with an ID selector referencing the scope context. - // The technique has to be used as well when a leading combinator is used - // as such selectors are not recognized by querySelectorAll. - // Thanks to Andrew Dupont for this technique. - if ( nodeType === 1 && - ( rdescend.test( selector ) || rcombinators.test( selector ) ) ) { - - // Expand context for sibling selectors - newContext = rsibling.test( selector ) && testContext( context.parentNode ) || - context; - - // We can use :scope instead of the ID hack if the browser - // supports it & if we're not changing the context. - if ( newContext !== context || !support.scope ) { - - // Capture the context ID, setting it first if necessary - if ( ( nid = context.getAttribute( "id" ) ) ) { - nid = nid.replace( rcssescape, fcssescape ); - } else { - context.setAttribute( "id", ( nid = expando ) ); - } - } - - // Prefix every selector in the list - groups = tokenize( selector ); - i = groups.length; - while ( i-- ) { - groups[ i ] = ( nid ? "#" + nid : ":scope" ) + " " + - toSelector( groups[ i ] ); - } - newSelector = groups.join( "," ); - } - - try { - push.apply( results, - newContext.querySelectorAll( newSelector ) - ); - return results; - } catch ( qsaError ) { - nonnativeSelectorCache( selector, true ); - } finally { - if ( nid === expando ) { - context.removeAttribute( "id" ); - } - } - } - } - } - - // All others - return select( selector.replace( rtrim, "$1" ), context, results, seed ); -} - -/** - * Create key-value caches of limited size - * @returns {function(string, object)} Returns the Object data after storing it on itself with - * property name the (space-suffixed) string and (if the cache is larger than Expr.cacheLength) - * deleting the oldest entry - */ -function createCache() { - var keys = []; - - function cache( key, value ) { - - // Use (key + " ") to avoid collision with native prototype properties (see Issue #157) - if ( keys.push( key + " " ) > Expr.cacheLength ) { - - // Only keep the most recent entries - delete cache[ keys.shift() ]; - } - return ( cache[ key + " " ] = value ); - } - return cache; -} - -/** - * Mark a function for special use by Sizzle - * @param {Function} fn The function to mark - */ -function markFunction( fn ) { - fn[ expando ] = true; - return fn; -} - -/** - * Support testing using an element - * @param {Function} fn Passed the created element and returns a boolean result - */ -function assert( fn ) { - var el = document.createElement( "fieldset" ); - - try { - return !!fn( el ); - } catch ( e ) { - return false; - } finally { - - // Remove from its parent by default - if ( el.parentNode ) { - el.parentNode.removeChild( el ); - } - - // release memory in IE - el = null; - } -} - -/** - * Adds the same handler for all of the specified attrs - * @param {String} attrs Pipe-separated list of attributes - * @param {Function} handler The method that will be applied - */ -function addHandle( attrs, handler ) { - var arr = attrs.split( "|" ), - i = arr.length; - - while ( i-- ) { - Expr.attrHandle[ arr[ i ] ] = handler; - } -} - -/** - * Checks document order of two siblings - * @param {Element} a - * @param {Element} b - * @returns {Number} Returns less than 0 if a precedes b, greater than 0 if a follows b - */ -function siblingCheck( a, b ) { - var cur = b && a, - diff = cur && a.nodeType === 1 && b.nodeType === 1 && - a.sourceIndex - b.sourceIndex; - - // Use IE sourceIndex if available on both nodes - if ( diff ) { - return diff; - } - - // Check if b follows a - if ( cur ) { - while ( ( cur = cur.nextSibling ) ) { - if ( cur === b ) { - return -1; - } - } - } - - return a ? 1 : -1; -} - -/** - * Returns a function to use in pseudos for input types - * @param {String} type - */ -function createInputPseudo( type ) { - return function( elem ) { - var name = elem.nodeName.toLowerCase(); - return name === "input" && elem.type === type; - }; -} - -/** - * Returns a function to use in pseudos for buttons - * @param {String} type - */ -function createButtonPseudo( type ) { - return function( elem ) { - var name = elem.nodeName.toLowerCase(); - return ( name === "input" || name === "button" ) && elem.type === type; - }; -} - -/** - * Returns a function to use in pseudos for :enabled/:disabled - * @param {Boolean} disabled true for :disabled; false for :enabled - */ -function createDisabledPseudo( disabled ) { - - // Known :disabled false positives: fieldset[disabled] > legend:nth-of-type(n+2) :can-disable - return function( elem ) { - - // Only certain elements can match :enabled or :disabled - // https://html.spec.whatwg.org/multipage/scripting.html#selector-enabled - // https://html.spec.whatwg.org/multipage/scripting.html#selector-disabled - if ( "form" in elem ) { - - // Check for inherited disabledness on relevant non-disabled elements: - // * listed form-associated elements in a disabled fieldset - // https://html.spec.whatwg.org/multipage/forms.html#category-listed - // https://html.spec.whatwg.org/multipage/forms.html#concept-fe-disabled - // * option elements in a disabled optgroup - // https://html.spec.whatwg.org/multipage/forms.html#concept-option-disabled - // All such elements have a "form" property. - if ( elem.parentNode && elem.disabled === false ) { - - // Option elements defer to a parent optgroup if present - if ( "label" in elem ) { - if ( "label" in elem.parentNode ) { - return elem.parentNode.disabled === disabled; - } else { - return elem.disabled === disabled; - } - } - - // Support: IE 6 - 11 - // Use the isDisabled shortcut property to check for disabled fieldset ancestors - return elem.isDisabled === disabled || - - // Where there is no isDisabled, check manually - /* jshint -W018 */ - elem.isDisabled !== !disabled && - inDisabledFieldset( elem ) === disabled; - } - - return elem.disabled === disabled; - - // Try to winnow out elements that can't be disabled before trusting the disabled property. - // Some victims get caught in our net (label, legend, menu, track), but it shouldn't - // even exist on them, let alone have a boolean value. - } else if ( "label" in elem ) { - return elem.disabled === disabled; - } - - // Remaining elements are neither :enabled nor :disabled - return false; - }; -} - -/** - * Returns a function to use in pseudos for positionals - * @param {Function} fn - */ -function createPositionalPseudo( fn ) { - return markFunction( function( argument ) { - argument = +argument; - return markFunction( function( seed, matches ) { - var j, - matchIndexes = fn( [], seed.length, argument ), - i = matchIndexes.length; - - // Match elements found at the specified indexes - while ( i-- ) { - if ( seed[ ( j = matchIndexes[ i ] ) ] ) { - seed[ j ] = !( matches[ j ] = seed[ j ] ); - } - } - } ); - } ); -} - -/** - * Checks a node for validity as a Sizzle context - * @param {Element|Object=} context - * @returns {Element|Object|Boolean} The input node if acceptable, otherwise a falsy value - */ -function testContext( context ) { - return context && typeof context.getElementsByTagName !== "undefined" && context; -} - -// Expose support vars for convenience -support = Sizzle.support = {}; - -/** - * Detects XML nodes - * @param {Element|Object} elem An element or a document - * @returns {Boolean} True iff elem is a non-HTML XML node - */ -isXML = Sizzle.isXML = function( elem ) { - var namespace = elem && elem.namespaceURI, - docElem = elem && ( elem.ownerDocument || elem ).documentElement; - - // Support: IE <=8 - // Assume HTML when documentElement doesn't yet exist, such as inside loading iframes - // https://bugs.jquery.com/ticket/4833 - return !rhtml.test( namespace || docElem && docElem.nodeName || "HTML" ); -}; - -/** - * Sets document-related variables once based on the current document - * @param {Element|Object} [doc] An element or document object to use to set the document - * @returns {Object} Returns the current document - */ -setDocument = Sizzle.setDocument = function( node ) { - var hasCompare, subWindow, - doc = node ? node.ownerDocument || node : preferredDoc; - - // Return early if doc is invalid or already selected - // Support: IE 11+, Edge 17 - 18+ - // IE/Edge sometimes throw a "Permission denied" error when strict-comparing - // two documents; shallow comparisons work. - // eslint-disable-next-line eqeqeq - if ( doc == document || doc.nodeType !== 9 || !doc.documentElement ) { - return document; - } - - // Update global variables - document = doc; - docElem = document.documentElement; - documentIsHTML = !isXML( document ); - - // Support: IE 9 - 11+, Edge 12 - 18+ - // Accessing iframe documents after unload throws "permission denied" errors (jQuery #13936) - // Support: IE 11+, Edge 17 - 18+ - // IE/Edge sometimes throw a "Permission denied" error when strict-comparing - // two documents; shallow comparisons work. - // eslint-disable-next-line eqeqeq - if ( preferredDoc != document && - ( subWindow = document.defaultView ) && subWindow.top !== subWindow ) { - - // Support: IE 11, Edge - if ( subWindow.addEventListener ) { - subWindow.addEventListener( "unload", unloadHandler, false ); - - // Support: IE 9 - 10 only - } else if ( subWindow.attachEvent ) { - subWindow.attachEvent( "onunload", unloadHandler ); - } - } - - // Support: IE 8 - 11+, Edge 12 - 18+, Chrome <=16 - 25 only, Firefox <=3.6 - 31 only, - // Safari 4 - 5 only, Opera <=11.6 - 12.x only - // IE/Edge & older browsers don't support the :scope pseudo-class. - // Support: Safari 6.0 only - // Safari 6.0 supports :scope but it's an alias of :root there. - support.scope = assert( function( el ) { - docElem.appendChild( el ).appendChild( document.createElement( "div" ) ); - return typeof el.querySelectorAll !== "undefined" && - !el.querySelectorAll( ":scope fieldset div" ).length; - } ); - - /* Attributes - ---------------------------------------------------------------------- */ - - // Support: IE<8 - // Verify that getAttribute really returns attributes and not properties - // (excepting IE8 booleans) - support.attributes = assert( function( el ) { - el.className = "i"; - return !el.getAttribute( "className" ); - } ); - - /* getElement(s)By* - ---------------------------------------------------------------------- */ - - // Check if getElementsByTagName("*") returns only elements - support.getElementsByTagName = assert( function( el ) { - el.appendChild( document.createComment( "" ) ); - return !el.getElementsByTagName( "*" ).length; - } ); - - // Support: IE<9 - support.getElementsByClassName = rnative.test( document.getElementsByClassName ); - - // Support: IE<10 - // Check if getElementById returns elements by name - // The broken getElementById methods don't pick up programmatically-set names, - // so use a roundabout getElementsByName test - support.getById = assert( function( el ) { - docElem.appendChild( el ).id = expando; - return !document.getElementsByName || !document.getElementsByName( expando ).length; - } ); - - // ID filter and find - if ( support.getById ) { - Expr.filter[ "ID" ] = function( id ) { - var attrId = id.replace( runescape, funescape ); - return function( elem ) { - return elem.getAttribute( "id" ) === attrId; - }; - }; - Expr.find[ "ID" ] = function( id, context ) { - if ( typeof context.getElementById !== "undefined" && documentIsHTML ) { - var elem = context.getElementById( id ); - return elem ? [ elem ] : []; - } - }; - } else { - Expr.filter[ "ID" ] = function( id ) { - var attrId = id.replace( runescape, funescape ); - return function( elem ) { - var node = typeof elem.getAttributeNode !== "undefined" && - elem.getAttributeNode( "id" ); - return node && node.value === attrId; - }; - }; - - // Support: IE 6 - 7 only - // getElementById is not reliable as a find shortcut - Expr.find[ "ID" ] = function( id, context ) { - if ( typeof context.getElementById !== "undefined" && documentIsHTML ) { - var node, i, elems, - elem = context.getElementById( id ); - - if ( elem ) { - - // Verify the id attribute - node = elem.getAttributeNode( "id" ); - if ( node && node.value === id ) { - return [ elem ]; - } - - // Fall back on getElementsByName - elems = context.getElementsByName( id ); - i = 0; - while ( ( elem = elems[ i++ ] ) ) { - node = elem.getAttributeNode( "id" ); - if ( node && node.value === id ) { - return [ elem ]; - } - } - } - - return []; - } - }; - } - - // Tag - Expr.find[ "TAG" ] = support.getElementsByTagName ? - function( tag, context ) { - if ( typeof context.getElementsByTagName !== "undefined" ) { - return context.getElementsByTagName( tag ); - - // DocumentFragment nodes don't have gEBTN - } else if ( support.qsa ) { - return context.querySelectorAll( tag ); - } - } : - - function( tag, context ) { - var elem, - tmp = [], - i = 0, - - // By happy coincidence, a (broken) gEBTN appears on DocumentFragment nodes too - results = context.getElementsByTagName( tag ); - - // Filter out possible comments - if ( tag === "*" ) { - while ( ( elem = results[ i++ ] ) ) { - if ( elem.nodeType === 1 ) { - tmp.push( elem ); - } - } - - return tmp; - } - return results; - }; - - // Class - Expr.find[ "CLASS" ] = support.getElementsByClassName && function( className, context ) { - if ( typeof context.getElementsByClassName !== "undefined" && documentIsHTML ) { - return context.getElementsByClassName( className ); - } - }; - - /* QSA/matchesSelector - ---------------------------------------------------------------------- */ - - // QSA and matchesSelector support - - // matchesSelector(:active) reports false when true (IE9/Opera 11.5) - rbuggyMatches = []; - - // qSa(:focus) reports false when true (Chrome 21) - // We allow this because of a bug in IE8/9 that throws an error - // whenever `document.activeElement` is accessed on an iframe - // So, we allow :focus to pass through QSA all the time to avoid the IE error - // See https://bugs.jquery.com/ticket/13378 - rbuggyQSA = []; - - if ( ( support.qsa = rnative.test( document.querySelectorAll ) ) ) { - - // Build QSA regex - // Regex strategy adopted from Diego Perini - assert( function( el ) { - - var input; - - // Select is set to empty string on purpose - // This is to test IE's treatment of not explicitly - // setting a boolean content attribute, - // since its presence should be enough - // https://bugs.jquery.com/ticket/12359 - docElem.appendChild( el ).innerHTML = "" + - ""; - - // Support: IE8, Opera 11-12.16 - // Nothing should be selected when empty strings follow ^= or $= or *= - // The test attribute must be unknown in Opera but "safe" for WinRT - // https://msdn.microsoft.com/en-us/library/ie/hh465388.aspx#attribute_section - if ( el.querySelectorAll( "[msallowcapture^='']" ).length ) { - rbuggyQSA.push( "[*^$]=" + whitespace + "*(?:''|\"\")" ); - } - - // Support: IE8 - // Boolean attributes and "value" are not treated correctly - if ( !el.querySelectorAll( "[selected]" ).length ) { - rbuggyQSA.push( "\\[" + whitespace + "*(?:value|" + booleans + ")" ); - } - - // Support: Chrome<29, Android<4.4, Safari<7.0+, iOS<7.0+, PhantomJS<1.9.8+ - if ( !el.querySelectorAll( "[id~=" + expando + "-]" ).length ) { - rbuggyQSA.push( "~=" ); - } - - // Support: IE 11+, Edge 15 - 18+ - // IE 11/Edge don't find elements on a `[name='']` query in some cases. - // Adding a temporary attribute to the document before the selection works - // around the issue. - // Interestingly, IE 10 & older don't seem to have the issue. - input = document.createElement( "input" ); - input.setAttribute( "name", "" ); - el.appendChild( input ); - if ( !el.querySelectorAll( "[name='']" ).length ) { - rbuggyQSA.push( "\\[" + whitespace + "*name" + whitespace + "*=" + - whitespace + "*(?:''|\"\")" ); - } - - // Webkit/Opera - :checked should return selected option elements - // http://www.w3.org/TR/2011/REC-css3-selectors-20110929/#checked - // IE8 throws error here and will not see later tests - if ( !el.querySelectorAll( ":checked" ).length ) { - rbuggyQSA.push( ":checked" ); - } - - // Support: Safari 8+, iOS 8+ - // https://bugs.webkit.org/show_bug.cgi?id=136851 - // In-page `selector#id sibling-combinator selector` fails - if ( !el.querySelectorAll( "a#" + expando + "+*" ).length ) { - rbuggyQSA.push( ".#.+[+~]" ); - } - - // Support: Firefox <=3.6 - 5 only - // Old Firefox doesn't throw on a badly-escaped identifier. - el.querySelectorAll( "\\\f" ); - rbuggyQSA.push( "[\\r\\n\\f]" ); - } ); - - assert( function( el ) { - el.innerHTML = "" + - ""; - - // Support: Windows 8 Native Apps - // The type and name attributes are restricted during .innerHTML assignment - var input = document.createElement( "input" ); - input.setAttribute( "type", "hidden" ); - el.appendChild( input ).setAttribute( "name", "D" ); - - // Support: IE8 - // Enforce case-sensitivity of name attribute - if ( el.querySelectorAll( "[name=d]" ).length ) { - rbuggyQSA.push( "name" + whitespace + "*[*^$|!~]?=" ); - } - - // FF 3.5 - :enabled/:disabled and hidden elements (hidden elements are still enabled) - // IE8 throws error here and will not see later tests - if ( el.querySelectorAll( ":enabled" ).length !== 2 ) { - rbuggyQSA.push( ":enabled", ":disabled" ); - } - - // Support: IE9-11+ - // IE's :disabled selector does not pick up the children of disabled fieldsets - docElem.appendChild( el ).disabled = true; - if ( el.querySelectorAll( ":disabled" ).length !== 2 ) { - rbuggyQSA.push( ":enabled", ":disabled" ); - } - - // Support: Opera 10 - 11 only - // Opera 10-11 does not throw on post-comma invalid pseudos - el.querySelectorAll( "*,:x" ); - rbuggyQSA.push( ",.*:" ); - } ); - } - - if ( ( support.matchesSelector = rnative.test( ( matches = docElem.matches || - docElem.webkitMatchesSelector || - docElem.mozMatchesSelector || - docElem.oMatchesSelector || - docElem.msMatchesSelector ) ) ) ) { - - assert( function( el ) { - - // Check to see if it's possible to do matchesSelector - // on a disconnected node (IE 9) - support.disconnectedMatch = matches.call( el, "*" ); - - // This should fail with an exception - // Gecko does not error, returns false instead - matches.call( el, "[s!='']:x" ); - rbuggyMatches.push( "!=", pseudos ); - } ); - } - - rbuggyQSA = rbuggyQSA.length && new RegExp( rbuggyQSA.join( "|" ) ); - rbuggyMatches = rbuggyMatches.length && new RegExp( rbuggyMatches.join( "|" ) ); - - /* Contains - ---------------------------------------------------------------------- */ - hasCompare = rnative.test( docElem.compareDocumentPosition ); - - // Element contains another - // Purposefully self-exclusive - // As in, an element does not contain itself - contains = hasCompare || rnative.test( docElem.contains ) ? - function( a, b ) { - var adown = a.nodeType === 9 ? a.documentElement : a, - bup = b && b.parentNode; - return a === bup || !!( bup && bup.nodeType === 1 && ( - adown.contains ? - adown.contains( bup ) : - a.compareDocumentPosition && a.compareDocumentPosition( bup ) & 16 - ) ); - } : - function( a, b ) { - if ( b ) { - while ( ( b = b.parentNode ) ) { - if ( b === a ) { - return true; - } - } - } - return false; - }; - - /* Sorting - ---------------------------------------------------------------------- */ - - // Document order sorting - sortOrder = hasCompare ? - function( a, b ) { - - // Flag for duplicate removal - if ( a === b ) { - hasDuplicate = true; - return 0; - } - - // Sort on method existence if only one input has compareDocumentPosition - var compare = !a.compareDocumentPosition - !b.compareDocumentPosition; - if ( compare ) { - return compare; - } - - // Calculate position if both inputs belong to the same document - // Support: IE 11+, Edge 17 - 18+ - // IE/Edge sometimes throw a "Permission denied" error when strict-comparing - // two documents; shallow comparisons work. - // eslint-disable-next-line eqeqeq - compare = ( a.ownerDocument || a ) == ( b.ownerDocument || b ) ? - a.compareDocumentPosition( b ) : - - // Otherwise we know they are disconnected - 1; - - // Disconnected nodes - if ( compare & 1 || - ( !support.sortDetached && b.compareDocumentPosition( a ) === compare ) ) { - - // Choose the first element that is related to our preferred document - // Support: IE 11+, Edge 17 - 18+ - // IE/Edge sometimes throw a "Permission denied" error when strict-comparing - // two documents; shallow comparisons work. - // eslint-disable-next-line eqeqeq - if ( a == document || a.ownerDocument == preferredDoc && - contains( preferredDoc, a ) ) { - return -1; - } - - // Support: IE 11+, Edge 17 - 18+ - // IE/Edge sometimes throw a "Permission denied" error when strict-comparing - // two documents; shallow comparisons work. - // eslint-disable-next-line eqeqeq - if ( b == document || b.ownerDocument == preferredDoc && - contains( preferredDoc, b ) ) { - return 1; - } - - // Maintain original order - return sortInput ? - ( indexOf( sortInput, a ) - indexOf( sortInput, b ) ) : - 0; - } - - return compare & 4 ? -1 : 1; - } : - function( a, b ) { - - // Exit early if the nodes are identical - if ( a === b ) { - hasDuplicate = true; - return 0; - } - - var cur, - i = 0, - aup = a.parentNode, - bup = b.parentNode, - ap = [ a ], - bp = [ b ]; - - // Parentless nodes are either documents or disconnected - if ( !aup || !bup ) { - - // Support: IE 11+, Edge 17 - 18+ - // IE/Edge sometimes throw a "Permission denied" error when strict-comparing - // two documents; shallow comparisons work. - /* eslint-disable eqeqeq */ - return a == document ? -1 : - b == document ? 1 : - /* eslint-enable eqeqeq */ - aup ? -1 : - bup ? 1 : - sortInput ? - ( indexOf( sortInput, a ) - indexOf( sortInput, b ) ) : - 0; - - // If the nodes are siblings, we can do a quick check - } else if ( aup === bup ) { - return siblingCheck( a, b ); - } - - // Otherwise we need full lists of their ancestors for comparison - cur = a; - while ( ( cur = cur.parentNode ) ) { - ap.unshift( cur ); - } - cur = b; - while ( ( cur = cur.parentNode ) ) { - bp.unshift( cur ); - } - - // Walk down the tree looking for a discrepancy - while ( ap[ i ] === bp[ i ] ) { - i++; - } - - return i ? - - // Do a sibling check if the nodes have a common ancestor - siblingCheck( ap[ i ], bp[ i ] ) : - - // Otherwise nodes in our document sort first - // Support: IE 11+, Edge 17 - 18+ - // IE/Edge sometimes throw a "Permission denied" error when strict-comparing - // two documents; shallow comparisons work. - /* eslint-disable eqeqeq */ - ap[ i ] == preferredDoc ? -1 : - bp[ i ] == preferredDoc ? 1 : - /* eslint-enable eqeqeq */ - 0; - }; - - return document; -}; - -Sizzle.matches = function( expr, elements ) { - return Sizzle( expr, null, null, elements ); -}; - -Sizzle.matchesSelector = function( elem, expr ) { - setDocument( elem ); - - if ( support.matchesSelector && documentIsHTML && - !nonnativeSelectorCache[ expr + " " ] && - ( !rbuggyMatches || !rbuggyMatches.test( expr ) ) && - ( !rbuggyQSA || !rbuggyQSA.test( expr ) ) ) { - - try { - var ret = matches.call( elem, expr ); - - // IE 9's matchesSelector returns false on disconnected nodes - if ( ret || support.disconnectedMatch || - - // As well, disconnected nodes are said to be in a document - // fragment in IE 9 - elem.document && elem.document.nodeType !== 11 ) { - return ret; - } - } catch ( e ) { - nonnativeSelectorCache( expr, true ); - } - } - - return Sizzle( expr, document, null, [ elem ] ).length > 0; -}; - -Sizzle.contains = function( context, elem ) { - - // Set document vars if needed - // Support: IE 11+, Edge 17 - 18+ - // IE/Edge sometimes throw a "Permission denied" error when strict-comparing - // two documents; shallow comparisons work. - // eslint-disable-next-line eqeqeq - if ( ( context.ownerDocument || context ) != document ) { - setDocument( context ); - } - return contains( context, elem ); -}; - -Sizzle.attr = function( elem, name ) { - - // Set document vars if needed - // Support: IE 11+, Edge 17 - 18+ - // IE/Edge sometimes throw a "Permission denied" error when strict-comparing - // two documents; shallow comparisons work. - // eslint-disable-next-line eqeqeq - if ( ( elem.ownerDocument || elem ) != document ) { - setDocument( elem ); - } - - var fn = Expr.attrHandle[ name.toLowerCase() ], - - // Don't get fooled by Object.prototype properties (jQuery #13807) - val = fn && hasOwn.call( Expr.attrHandle, name.toLowerCase() ) ? - fn( elem, name, !documentIsHTML ) : - undefined; - - return val !== undefined ? - val : - support.attributes || !documentIsHTML ? - elem.getAttribute( name ) : - ( val = elem.getAttributeNode( name ) ) && val.specified ? - val.value : - null; -}; - -Sizzle.escape = function( sel ) { - return ( sel + "" ).replace( rcssescape, fcssescape ); -}; - -Sizzle.error = function( msg ) { - throw new Error( "Syntax error, unrecognized expression: " + msg ); -}; - -/** - * Document sorting and removing duplicates - * @param {ArrayLike} results - */ -Sizzle.uniqueSort = function( results ) { - var elem, - duplicates = [], - j = 0, - i = 0; - - // Unless we *know* we can detect duplicates, assume their presence - hasDuplicate = !support.detectDuplicates; - sortInput = !support.sortStable && results.slice( 0 ); - results.sort( sortOrder ); - - if ( hasDuplicate ) { - while ( ( elem = results[ i++ ] ) ) { - if ( elem === results[ i ] ) { - j = duplicates.push( i ); - } - } - while ( j-- ) { - results.splice( duplicates[ j ], 1 ); - } - } - - // Clear input after sorting to release objects - // See https://github.com/jquery/sizzle/pull/225 - sortInput = null; - - return results; -}; - -/** - * Utility function for retrieving the text value of an array of DOM nodes - * @param {Array|Element} elem - */ -getText = Sizzle.getText = function( elem ) { - var node, - ret = "", - i = 0, - nodeType = elem.nodeType; - - if ( !nodeType ) { - - // If no nodeType, this is expected to be an array - while ( ( node = elem[ i++ ] ) ) { - - // Do not traverse comment nodes - ret += getText( node ); - } - } else if ( nodeType === 1 || nodeType === 9 || nodeType === 11 ) { - - // Use textContent for elements - // innerText usage removed for consistency of new lines (jQuery #11153) - if ( typeof elem.textContent === "string" ) { - return elem.textContent; - } else { - - // Traverse its children - for ( elem = elem.firstChild; elem; elem = elem.nextSibling ) { - ret += getText( elem ); - } - } - } else if ( nodeType === 3 || nodeType === 4 ) { - return elem.nodeValue; - } - - // Do not include comment or processing instruction nodes - - return ret; -}; - -Expr = Sizzle.selectors = { - - // Can be adjusted by the user - cacheLength: 50, - - createPseudo: markFunction, - - match: matchExpr, - - attrHandle: {}, - - find: {}, - - relative: { - ">": { dir: "parentNode", first: true }, - " ": { dir: "parentNode" }, - "+": { dir: "previousSibling", first: true }, - "~": { dir: "previousSibling" } - }, - - preFilter: { - "ATTR": function( match ) { - match[ 1 ] = match[ 1 ].replace( runescape, funescape ); - - // Move the given value to match[3] whether quoted or unquoted - match[ 3 ] = ( match[ 3 ] || match[ 4 ] || - match[ 5 ] || "" ).replace( runescape, funescape ); - - if ( match[ 2 ] === "~=" ) { - match[ 3 ] = " " + match[ 3 ] + " "; - } - - return match.slice( 0, 4 ); - }, - - "CHILD": function( match ) { - - /* matches from matchExpr["CHILD"] - 1 type (only|nth|...) - 2 what (child|of-type) - 3 argument (even|odd|\d*|\d*n([+-]\d+)?|...) - 4 xn-component of xn+y argument ([+-]?\d*n|) - 5 sign of xn-component - 6 x of xn-component - 7 sign of y-component - 8 y of y-component - */ - match[ 1 ] = match[ 1 ].toLowerCase(); - - if ( match[ 1 ].slice( 0, 3 ) === "nth" ) { - - // nth-* requires argument - if ( !match[ 3 ] ) { - Sizzle.error( match[ 0 ] ); - } - - // numeric x and y parameters for Expr.filter.CHILD - // remember that false/true cast respectively to 0/1 - match[ 4 ] = +( match[ 4 ] ? - match[ 5 ] + ( match[ 6 ] || 1 ) : - 2 * ( match[ 3 ] === "even" || match[ 3 ] === "odd" ) ); - match[ 5 ] = +( ( match[ 7 ] + match[ 8 ] ) || match[ 3 ] === "odd" ); - - // other types prohibit arguments - } else if ( match[ 3 ] ) { - Sizzle.error( match[ 0 ] ); - } - - return match; - }, - - "PSEUDO": function( match ) { - var excess, - unquoted = !match[ 6 ] && match[ 2 ]; - - if ( matchExpr[ "CHILD" ].test( match[ 0 ] ) ) { - return null; - } - - // Accept quoted arguments as-is - if ( match[ 3 ] ) { - match[ 2 ] = match[ 4 ] || match[ 5 ] || ""; - - // Strip excess characters from unquoted arguments - } else if ( unquoted && rpseudo.test( unquoted ) && - - // Get excess from tokenize (recursively) - ( excess = tokenize( unquoted, true ) ) && - - // advance to the next closing parenthesis - ( excess = unquoted.indexOf( ")", unquoted.length - excess ) - unquoted.length ) ) { - - // excess is a negative index - match[ 0 ] = match[ 0 ].slice( 0, excess ); - match[ 2 ] = unquoted.slice( 0, excess ); - } - - // Return only captures needed by the pseudo filter method (type and argument) - return match.slice( 0, 3 ); - } - }, - - filter: { - - "TAG": function( nodeNameSelector ) { - var nodeName = nodeNameSelector.replace( runescape, funescape ).toLowerCase(); - return nodeNameSelector === "*" ? - function() { - return true; - } : - function( elem ) { - return elem.nodeName && elem.nodeName.toLowerCase() === nodeName; - }; - }, - - "CLASS": function( className ) { - var pattern = classCache[ className + " " ]; - - return pattern || - ( pattern = new RegExp( "(^|" + whitespace + - ")" + className + "(" + whitespace + "|$)" ) ) && classCache( - className, function( elem ) { - return pattern.test( - typeof elem.className === "string" && elem.className || - typeof elem.getAttribute !== "undefined" && - elem.getAttribute( "class" ) || - "" - ); - } ); - }, - - "ATTR": function( name, operator, check ) { - return function( elem ) { - var result = Sizzle.attr( elem, name ); - - if ( result == null ) { - return operator === "!="; - } - if ( !operator ) { - return true; - } - - result += ""; - - /* eslint-disable max-len */ - - return operator === "=" ? result === check : - operator === "!=" ? result !== check : - operator === "^=" ? check && result.indexOf( check ) === 0 : - operator === "*=" ? check && result.indexOf( check ) > -1 : - operator === "$=" ? check && result.slice( -check.length ) === check : - operator === "~=" ? ( " " + result.replace( rwhitespace, " " ) + " " ).indexOf( check ) > -1 : - operator === "|=" ? result === check || result.slice( 0, check.length + 1 ) === check + "-" : - false; - /* eslint-enable max-len */ - - }; - }, - - "CHILD": function( type, what, _argument, first, last ) { - var simple = type.slice( 0, 3 ) !== "nth", - forward = type.slice( -4 ) !== "last", - ofType = what === "of-type"; - - return first === 1 && last === 0 ? - - // Shortcut for :nth-*(n) - function( elem ) { - return !!elem.parentNode; - } : - - function( elem, _context, xml ) { - var cache, uniqueCache, outerCache, node, nodeIndex, start, - dir = simple !== forward ? "nextSibling" : "previousSibling", - parent = elem.parentNode, - name = ofType && elem.nodeName.toLowerCase(), - useCache = !xml && !ofType, - diff = false; - - if ( parent ) { - - // :(first|last|only)-(child|of-type) - if ( simple ) { - while ( dir ) { - node = elem; - while ( ( node = node[ dir ] ) ) { - if ( ofType ? - node.nodeName.toLowerCase() === name : - node.nodeType === 1 ) { - - return false; - } - } - - // Reverse direction for :only-* (if we haven't yet done so) - start = dir = type === "only" && !start && "nextSibling"; - } - return true; - } - - start = [ forward ? parent.firstChild : parent.lastChild ]; - - // non-xml :nth-child(...) stores cache data on `parent` - if ( forward && useCache ) { - - // Seek `elem` from a previously-cached index - - // ...in a gzip-friendly way - node = parent; - outerCache = node[ expando ] || ( node[ expando ] = {} ); - - // Support: IE <9 only - // Defend against cloned attroperties (jQuery gh-1709) - uniqueCache = outerCache[ node.uniqueID ] || - ( outerCache[ node.uniqueID ] = {} ); - - cache = uniqueCache[ type ] || []; - nodeIndex = cache[ 0 ] === dirruns && cache[ 1 ]; - diff = nodeIndex && cache[ 2 ]; - node = nodeIndex && parent.childNodes[ nodeIndex ]; - - while ( ( node = ++nodeIndex && node && node[ dir ] || - - // Fallback to seeking `elem` from the start - ( diff = nodeIndex = 0 ) || start.pop() ) ) { - - // When found, cache indexes on `parent` and break - if ( node.nodeType === 1 && ++diff && node === elem ) { - uniqueCache[ type ] = [ dirruns, nodeIndex, diff ]; - break; - } - } - - } else { - - // Use previously-cached element index if available - if ( useCache ) { - - // ...in a gzip-friendly way - node = elem; - outerCache = node[ expando ] || ( node[ expando ] = {} ); - - // Support: IE <9 only - // Defend against cloned attroperties (jQuery gh-1709) - uniqueCache = outerCache[ node.uniqueID ] || - ( outerCache[ node.uniqueID ] = {} ); - - cache = uniqueCache[ type ] || []; - nodeIndex = cache[ 0 ] === dirruns && cache[ 1 ]; - diff = nodeIndex; - } - - // xml :nth-child(...) - // or :nth-last-child(...) or :nth(-last)?-of-type(...) - if ( diff === false ) { - - // Use the same loop as above to seek `elem` from the start - while ( ( node = ++nodeIndex && node && node[ dir ] || - ( diff = nodeIndex = 0 ) || start.pop() ) ) { - - if ( ( ofType ? - node.nodeName.toLowerCase() === name : - node.nodeType === 1 ) && - ++diff ) { - - // Cache the index of each encountered element - if ( useCache ) { - outerCache = node[ expando ] || - ( node[ expando ] = {} ); - - // Support: IE <9 only - // Defend against cloned attroperties (jQuery gh-1709) - uniqueCache = outerCache[ node.uniqueID ] || - ( outerCache[ node.uniqueID ] = {} ); - - uniqueCache[ type ] = [ dirruns, diff ]; - } - - if ( node === elem ) { - break; - } - } - } - } - } - - // Incorporate the offset, then check against cycle size - diff -= last; - return diff === first || ( diff % first === 0 && diff / first >= 0 ); - } - }; - }, - - "PSEUDO": function( pseudo, argument ) { - - // pseudo-class names are case-insensitive - // http://www.w3.org/TR/selectors/#pseudo-classes - // Prioritize by case sensitivity in case custom pseudos are added with uppercase letters - // Remember that setFilters inherits from pseudos - var args, - fn = Expr.pseudos[ pseudo ] || Expr.setFilters[ pseudo.toLowerCase() ] || - Sizzle.error( "unsupported pseudo: " + pseudo ); - - // The user may use createPseudo to indicate that - // arguments are needed to create the filter function - // just as Sizzle does - if ( fn[ expando ] ) { - return fn( argument ); - } - - // But maintain support for old signatures - if ( fn.length > 1 ) { - args = [ pseudo, pseudo, "", argument ]; - return Expr.setFilters.hasOwnProperty( pseudo.toLowerCase() ) ? - markFunction( function( seed, matches ) { - var idx, - matched = fn( seed, argument ), - i = matched.length; - while ( i-- ) { - idx = indexOf( seed, matched[ i ] ); - seed[ idx ] = !( matches[ idx ] = matched[ i ] ); - } - } ) : - function( elem ) { - return fn( elem, 0, args ); - }; - } - - return fn; - } - }, - - pseudos: { - - // Potentially complex pseudos - "not": markFunction( function( selector ) { - - // Trim the selector passed to compile - // to avoid treating leading and trailing - // spaces as combinators - var input = [], - results = [], - matcher = compile( selector.replace( rtrim, "$1" ) ); - - return matcher[ expando ] ? - markFunction( function( seed, matches, _context, xml ) { - var elem, - unmatched = matcher( seed, null, xml, [] ), - i = seed.length; - - // Match elements unmatched by `matcher` - while ( i-- ) { - if ( ( elem = unmatched[ i ] ) ) { - seed[ i ] = !( matches[ i ] = elem ); - } - } - } ) : - function( elem, _context, xml ) { - input[ 0 ] = elem; - matcher( input, null, xml, results ); - - // Don't keep the element (issue #299) - input[ 0 ] = null; - return !results.pop(); - }; - } ), - - "has": markFunction( function( selector ) { - return function( elem ) { - return Sizzle( selector, elem ).length > 0; - }; - } ), - - "contains": markFunction( function( text ) { - text = text.replace( runescape, funescape ); - return function( elem ) { - return ( elem.textContent || getText( elem ) ).indexOf( text ) > -1; - }; - } ), - - // "Whether an element is represented by a :lang() selector - // is based solely on the element's language value - // being equal to the identifier C, - // or beginning with the identifier C immediately followed by "-". - // The matching of C against the element's language value is performed case-insensitively. - // The identifier C does not have to be a valid language name." - // http://www.w3.org/TR/selectors/#lang-pseudo - "lang": markFunction( function( lang ) { - - // lang value must be a valid identifier - if ( !ridentifier.test( lang || "" ) ) { - Sizzle.error( "unsupported lang: " + lang ); - } - lang = lang.replace( runescape, funescape ).toLowerCase(); - return function( elem ) { - var elemLang; - do { - if ( ( elemLang = documentIsHTML ? - elem.lang : - elem.getAttribute( "xml:lang" ) || elem.getAttribute( "lang" ) ) ) { - - elemLang = elemLang.toLowerCase(); - return elemLang === lang || elemLang.indexOf( lang + "-" ) === 0; - } - } while ( ( elem = elem.parentNode ) && elem.nodeType === 1 ); - return false; - }; - } ), - - // Miscellaneous - "target": function( elem ) { - var hash = window.location && window.location.hash; - return hash && hash.slice( 1 ) === elem.id; - }, - - "root": function( elem ) { - return elem === docElem; - }, - - "focus": function( elem ) { - return elem === document.activeElement && - ( !document.hasFocus || document.hasFocus() ) && - !!( elem.type || elem.href || ~elem.tabIndex ); - }, - - // Boolean properties - "enabled": createDisabledPseudo( false ), - "disabled": createDisabledPseudo( true ), - - "checked": function( elem ) { - - // In CSS3, :checked should return both checked and selected elements - // http://www.w3.org/TR/2011/REC-css3-selectors-20110929/#checked - var nodeName = elem.nodeName.toLowerCase(); - return ( nodeName === "input" && !!elem.checked ) || - ( nodeName === "option" && !!elem.selected ); - }, - - "selected": function( elem ) { - - // Accessing this property makes selected-by-default - // options in Safari work properly - if ( elem.parentNode ) { - // eslint-disable-next-line no-unused-expressions - elem.parentNode.selectedIndex; - } - - return elem.selected === true; - }, - - // Contents - "empty": function( elem ) { - - // http://www.w3.org/TR/selectors/#empty-pseudo - // :empty is negated by element (1) or content nodes (text: 3; cdata: 4; entity ref: 5), - // but not by others (comment: 8; processing instruction: 7; etc.) - // nodeType < 6 works because attributes (2) do not appear as children - for ( elem = elem.firstChild; elem; elem = elem.nextSibling ) { - if ( elem.nodeType < 6 ) { - return false; - } - } - return true; - }, - - "parent": function( elem ) { - return !Expr.pseudos[ "empty" ]( elem ); - }, - - // Element/input types - "header": function( elem ) { - return rheader.test( elem.nodeName ); - }, - - "input": function( elem ) { - return rinputs.test( elem.nodeName ); - }, - - "button": function( elem ) { - var name = elem.nodeName.toLowerCase(); - return name === "input" && elem.type === "button" || name === "button"; - }, - - "text": function( elem ) { - var attr; - return elem.nodeName.toLowerCase() === "input" && - elem.type === "text" && - - // Support: IE<8 - // New HTML5 attribute values (e.g., "search") appear with elem.type === "text" - ( ( attr = elem.getAttribute( "type" ) ) == null || - attr.toLowerCase() === "text" ); - }, - - // Position-in-collection - "first": createPositionalPseudo( function() { - return [ 0 ]; - } ), - - "last": createPositionalPseudo( function( _matchIndexes, length ) { - return [ length - 1 ]; - } ), - - "eq": createPositionalPseudo( function( _matchIndexes, length, argument ) { - return [ argument < 0 ? argument + length : argument ]; - } ), - - "even": createPositionalPseudo( function( matchIndexes, length ) { - var i = 0; - for ( ; i < length; i += 2 ) { - matchIndexes.push( i ); - } - return matchIndexes; - } ), - - "odd": createPositionalPseudo( function( matchIndexes, length ) { - var i = 1; - for ( ; i < length; i += 2 ) { - matchIndexes.push( i ); - } - return matchIndexes; - } ), - - "lt": createPositionalPseudo( function( matchIndexes, length, argument ) { - var i = argument < 0 ? - argument + length : - argument > length ? - length : - argument; - for ( ; --i >= 0; ) { - matchIndexes.push( i ); - } - return matchIndexes; - } ), - - "gt": createPositionalPseudo( function( matchIndexes, length, argument ) { - var i = argument < 0 ? argument + length : argument; - for ( ; ++i < length; ) { - matchIndexes.push( i ); - } - return matchIndexes; - } ) - } -}; - -Expr.pseudos[ "nth" ] = Expr.pseudos[ "eq" ]; - -// Add button/input type pseudos -for ( i in { radio: true, checkbox: true, file: true, password: true, image: true } ) { - Expr.pseudos[ i ] = createInputPseudo( i ); -} -for ( i in { submit: true, reset: true } ) { - Expr.pseudos[ i ] = createButtonPseudo( i ); -} - -// Easy API for creating new setFilters -function setFilters() {} -setFilters.prototype = Expr.filters = Expr.pseudos; -Expr.setFilters = new setFilters(); - -tokenize = Sizzle.tokenize = function( selector, parseOnly ) { - var matched, match, tokens, type, - soFar, groups, preFilters, - cached = tokenCache[ selector + " " ]; - - if ( cached ) { - return parseOnly ? 0 : cached.slice( 0 ); - } - - soFar = selector; - groups = []; - preFilters = Expr.preFilter; - - while ( soFar ) { - - // Comma and first run - if ( !matched || ( match = rcomma.exec( soFar ) ) ) { - if ( match ) { - - // Don't consume trailing commas as valid - soFar = soFar.slice( match[ 0 ].length ) || soFar; - } - groups.push( ( tokens = [] ) ); - } - - matched = false; - - // Combinators - if ( ( match = rcombinators.exec( soFar ) ) ) { - matched = match.shift(); - tokens.push( { - value: matched, - - // Cast descendant combinators to space - type: match[ 0 ].replace( rtrim, " " ) - } ); - soFar = soFar.slice( matched.length ); - } - - // Filters - for ( type in Expr.filter ) { - if ( ( match = matchExpr[ type ].exec( soFar ) ) && ( !preFilters[ type ] || - ( match = preFilters[ type ]( match ) ) ) ) { - matched = match.shift(); - tokens.push( { - value: matched, - type: type, - matches: match - } ); - soFar = soFar.slice( matched.length ); - } - } - - if ( !matched ) { - break; - } - } - - // Return the length of the invalid excess - // if we're just parsing - // Otherwise, throw an error or return tokens - return parseOnly ? - soFar.length : - soFar ? - Sizzle.error( selector ) : - - // Cache the tokens - tokenCache( selector, groups ).slice( 0 ); -}; - -function toSelector( tokens ) { - var i = 0, - len = tokens.length, - selector = ""; - for ( ; i < len; i++ ) { - selector += tokens[ i ].value; - } - return selector; -} - -function addCombinator( matcher, combinator, base ) { - var dir = combinator.dir, - skip = combinator.next, - key = skip || dir, - checkNonElements = base && key === "parentNode", - doneName = done++; - - return combinator.first ? - - // Check against closest ancestor/preceding element - function( elem, context, xml ) { - while ( ( elem = elem[ dir ] ) ) { - if ( elem.nodeType === 1 || checkNonElements ) { - return matcher( elem, context, xml ); - } - } - return false; - } : - - // Check against all ancestor/preceding elements - function( elem, context, xml ) { - var oldCache, uniqueCache, outerCache, - newCache = [ dirruns, doneName ]; - - // We can't set arbitrary data on XML nodes, so they don't benefit from combinator caching - if ( xml ) { - while ( ( elem = elem[ dir ] ) ) { - if ( elem.nodeType === 1 || checkNonElements ) { - if ( matcher( elem, context, xml ) ) { - return true; - } - } - } - } else { - while ( ( elem = elem[ dir ] ) ) { - if ( elem.nodeType === 1 || checkNonElements ) { - outerCache = elem[ expando ] || ( elem[ expando ] = {} ); - - // Support: IE <9 only - // Defend against cloned attroperties (jQuery gh-1709) - uniqueCache = outerCache[ elem.uniqueID ] || - ( outerCache[ elem.uniqueID ] = {} ); - - if ( skip && skip === elem.nodeName.toLowerCase() ) { - elem = elem[ dir ] || elem; - } else if ( ( oldCache = uniqueCache[ key ] ) && - oldCache[ 0 ] === dirruns && oldCache[ 1 ] === doneName ) { - - // Assign to newCache so results back-propagate to previous elements - return ( newCache[ 2 ] = oldCache[ 2 ] ); - } else { - - // Reuse newcache so results back-propagate to previous elements - uniqueCache[ key ] = newCache; - - // A match means we're done; a fail means we have to keep checking - if ( ( newCache[ 2 ] = matcher( elem, context, xml ) ) ) { - return true; - } - } - } - } - } - return false; - }; -} - -function elementMatcher( matchers ) { - return matchers.length > 1 ? - function( elem, context, xml ) { - var i = matchers.length; - while ( i-- ) { - if ( !matchers[ i ]( elem, context, xml ) ) { - return false; - } - } - return true; - } : - matchers[ 0 ]; -} - -function multipleContexts( selector, contexts, results ) { - var i = 0, - len = contexts.length; - for ( ; i < len; i++ ) { - Sizzle( selector, contexts[ i ], results ); - } - return results; -} - -function condense( unmatched, map, filter, context, xml ) { - var elem, - newUnmatched = [], - i = 0, - len = unmatched.length, - mapped = map != null; - - for ( ; i < len; i++ ) { - if ( ( elem = unmatched[ i ] ) ) { - if ( !filter || filter( elem, context, xml ) ) { - newUnmatched.push( elem ); - if ( mapped ) { - map.push( i ); - } - } - } - } - - return newUnmatched; -} - -function setMatcher( preFilter, selector, matcher, postFilter, postFinder, postSelector ) { - if ( postFilter && !postFilter[ expando ] ) { - postFilter = setMatcher( postFilter ); - } - if ( postFinder && !postFinder[ expando ] ) { - postFinder = setMatcher( postFinder, postSelector ); - } - return markFunction( function( seed, results, context, xml ) { - var temp, i, elem, - preMap = [], - postMap = [], - preexisting = results.length, - - // Get initial elements from seed or context - elems = seed || multipleContexts( - selector || "*", - context.nodeType ? [ context ] : context, - [] - ), - - // Prefilter to get matcher input, preserving a map for seed-results synchronization - matcherIn = preFilter && ( seed || !selector ) ? - condense( elems, preMap, preFilter, context, xml ) : - elems, - - matcherOut = matcher ? - - // If we have a postFinder, or filtered seed, or non-seed postFilter or preexisting results, - postFinder || ( seed ? preFilter : preexisting || postFilter ) ? - - // ...intermediate processing is necessary - [] : - - // ...otherwise use results directly - results : - matcherIn; - - // Find primary matches - if ( matcher ) { - matcher( matcherIn, matcherOut, context, xml ); - } - - // Apply postFilter - if ( postFilter ) { - temp = condense( matcherOut, postMap ); - postFilter( temp, [], context, xml ); - - // Un-match failing elements by moving them back to matcherIn - i = temp.length; - while ( i-- ) { - if ( ( elem = temp[ i ] ) ) { - matcherOut[ postMap[ i ] ] = !( matcherIn[ postMap[ i ] ] = elem ); - } - } - } - - if ( seed ) { - if ( postFinder || preFilter ) { - if ( postFinder ) { - - // Get the final matcherOut by condensing this intermediate into postFinder contexts - temp = []; - i = matcherOut.length; - while ( i-- ) { - if ( ( elem = matcherOut[ i ] ) ) { - - // Restore matcherIn since elem is not yet a final match - temp.push( ( matcherIn[ i ] = elem ) ); - } - } - postFinder( null, ( matcherOut = [] ), temp, xml ); - } - - // Move matched elements from seed to results to keep them synchronized - i = matcherOut.length; - while ( i-- ) { - if ( ( elem = matcherOut[ i ] ) && - ( temp = postFinder ? indexOf( seed, elem ) : preMap[ i ] ) > -1 ) { - - seed[ temp ] = !( results[ temp ] = elem ); - } - } - } - - // Add elements to results, through postFinder if defined - } else { - matcherOut = condense( - matcherOut === results ? - matcherOut.splice( preexisting, matcherOut.length ) : - matcherOut - ); - if ( postFinder ) { - postFinder( null, results, matcherOut, xml ); - } else { - push.apply( results, matcherOut ); - } - } - } ); -} - -function matcherFromTokens( tokens ) { - var checkContext, matcher, j, - len = tokens.length, - leadingRelative = Expr.relative[ tokens[ 0 ].type ], - implicitRelative = leadingRelative || Expr.relative[ " " ], - i = leadingRelative ? 1 : 0, - - // The foundational matcher ensures that elements are reachable from top-level context(s) - matchContext = addCombinator( function( elem ) { - return elem === checkContext; - }, implicitRelative, true ), - matchAnyContext = addCombinator( function( elem ) { - return indexOf( checkContext, elem ) > -1; - }, implicitRelative, true ), - matchers = [ function( elem, context, xml ) { - var ret = ( !leadingRelative && ( xml || context !== outermostContext ) ) || ( - ( checkContext = context ).nodeType ? - matchContext( elem, context, xml ) : - matchAnyContext( elem, context, xml ) ); - - // Avoid hanging onto element (issue #299) - checkContext = null; - return ret; - } ]; - - for ( ; i < len; i++ ) { - if ( ( matcher = Expr.relative[ tokens[ i ].type ] ) ) { - matchers = [ addCombinator( elementMatcher( matchers ), matcher ) ]; - } else { - matcher = Expr.filter[ tokens[ i ].type ].apply( null, tokens[ i ].matches ); - - // Return special upon seeing a positional matcher - if ( matcher[ expando ] ) { - - // Find the next relative operator (if any) for proper handling - j = ++i; - for ( ; j < len; j++ ) { - if ( Expr.relative[ tokens[ j ].type ] ) { - break; - } - } - return setMatcher( - i > 1 && elementMatcher( matchers ), - i > 1 && toSelector( - - // If the preceding token was a descendant combinator, insert an implicit any-element `*` - tokens - .slice( 0, i - 1 ) - .concat( { value: tokens[ i - 2 ].type === " " ? "*" : "" } ) - ).replace( rtrim, "$1" ), - matcher, - i < j && matcherFromTokens( tokens.slice( i, j ) ), - j < len && matcherFromTokens( ( tokens = tokens.slice( j ) ) ), - j < len && toSelector( tokens ) - ); - } - matchers.push( matcher ); - } - } - - return elementMatcher( matchers ); -} - -function matcherFromGroupMatchers( elementMatchers, setMatchers ) { - var bySet = setMatchers.length > 0, - byElement = elementMatchers.length > 0, - superMatcher = function( seed, context, xml, results, outermost ) { - var elem, j, matcher, - matchedCount = 0, - i = "0", - unmatched = seed && [], - setMatched = [], - contextBackup = outermostContext, - - // We must always have either seed elements or outermost context - elems = seed || byElement && Expr.find[ "TAG" ]( "*", outermost ), - - // Use integer dirruns iff this is the outermost matcher - dirrunsUnique = ( dirruns += contextBackup == null ? 1 : Math.random() || 0.1 ), - len = elems.length; - - if ( outermost ) { - - // Support: IE 11+, Edge 17 - 18+ - // IE/Edge sometimes throw a "Permission denied" error when strict-comparing - // two documents; shallow comparisons work. - // eslint-disable-next-line eqeqeq - outermostContext = context == document || context || outermost; - } - - // Add elements passing elementMatchers directly to results - // Support: IE<9, Safari - // Tolerate NodeList properties (IE: "length"; Safari: ) matching elements by id - for ( ; i !== len && ( elem = elems[ i ] ) != null; i++ ) { - if ( byElement && elem ) { - j = 0; - - // Support: IE 11+, Edge 17 - 18+ - // IE/Edge sometimes throw a "Permission denied" error when strict-comparing - // two documents; shallow comparisons work. - // eslint-disable-next-line eqeqeq - if ( !context && elem.ownerDocument != document ) { - setDocument( elem ); - xml = !documentIsHTML; - } - while ( ( matcher = elementMatchers[ j++ ] ) ) { - if ( matcher( elem, context || document, xml ) ) { - results.push( elem ); - break; - } - } - if ( outermost ) { - dirruns = dirrunsUnique; - } - } - - // Track unmatched elements for set filters - if ( bySet ) { - - // They will have gone through all possible matchers - if ( ( elem = !matcher && elem ) ) { - matchedCount--; - } - - // Lengthen the array for every element, matched or not - if ( seed ) { - unmatched.push( elem ); - } - } - } - - // `i` is now the count of elements visited above, and adding it to `matchedCount` - // makes the latter nonnegative. - matchedCount += i; - - // Apply set filters to unmatched elements - // NOTE: This can be skipped if there are no unmatched elements (i.e., `matchedCount` - // equals `i`), unless we didn't visit _any_ elements in the above loop because we have - // no element matchers and no seed. - // Incrementing an initially-string "0" `i` allows `i` to remain a string only in that - // case, which will result in a "00" `matchedCount` that differs from `i` but is also - // numerically zero. - if ( bySet && i !== matchedCount ) { - j = 0; - while ( ( matcher = setMatchers[ j++ ] ) ) { - matcher( unmatched, setMatched, context, xml ); - } - - if ( seed ) { - - // Reintegrate element matches to eliminate the need for sorting - if ( matchedCount > 0 ) { - while ( i-- ) { - if ( !( unmatched[ i ] || setMatched[ i ] ) ) { - setMatched[ i ] = pop.call( results ); - } - } - } - - // Discard index placeholder values to get only actual matches - setMatched = condense( setMatched ); - } - - // Add matches to results - push.apply( results, setMatched ); - - // Seedless set matches succeeding multiple successful matchers stipulate sorting - if ( outermost && !seed && setMatched.length > 0 && - ( matchedCount + setMatchers.length ) > 1 ) { - - Sizzle.uniqueSort( results ); - } - } - - // Override manipulation of globals by nested matchers - if ( outermost ) { - dirruns = dirrunsUnique; - outermostContext = contextBackup; - } - - return unmatched; - }; - - return bySet ? - markFunction( superMatcher ) : - superMatcher; -} - -compile = Sizzle.compile = function( selector, match /* Internal Use Only */ ) { - var i, - setMatchers = [], - elementMatchers = [], - cached = compilerCache[ selector + " " ]; - - if ( !cached ) { - - // Generate a function of recursive functions that can be used to check each element - if ( !match ) { - match = tokenize( selector ); - } - i = match.length; - while ( i-- ) { - cached = matcherFromTokens( match[ i ] ); - if ( cached[ expando ] ) { - setMatchers.push( cached ); - } else { - elementMatchers.push( cached ); - } - } - - // Cache the compiled function - cached = compilerCache( - selector, - matcherFromGroupMatchers( elementMatchers, setMatchers ) - ); - - // Save selector and tokenization - cached.selector = selector; - } - return cached; -}; - -/** - * A low-level selection function that works with Sizzle's compiled - * selector functions - * @param {String|Function} selector A selector or a pre-compiled - * selector function built with Sizzle.compile - * @param {Element} context - * @param {Array} [results] - * @param {Array} [seed] A set of elements to match against - */ -select = Sizzle.select = function( selector, context, results, seed ) { - var i, tokens, token, type, find, - compiled = typeof selector === "function" && selector, - match = !seed && tokenize( ( selector = compiled.selector || selector ) ); - - results = results || []; - - // Try to minimize operations if there is only one selector in the list and no seed - // (the latter of which guarantees us context) - if ( match.length === 1 ) { - - // Reduce context if the leading compound selector is an ID - tokens = match[ 0 ] = match[ 0 ].slice( 0 ); - if ( tokens.length > 2 && ( token = tokens[ 0 ] ).type === "ID" && - context.nodeType === 9 && documentIsHTML && Expr.relative[ tokens[ 1 ].type ] ) { - - context = ( Expr.find[ "ID" ]( token.matches[ 0 ] - .replace( runescape, funescape ), context ) || [] )[ 0 ]; - if ( !context ) { - return results; - - // Precompiled matchers will still verify ancestry, so step up a level - } else if ( compiled ) { - context = context.parentNode; - } - - selector = selector.slice( tokens.shift().value.length ); - } - - // Fetch a seed set for right-to-left matching - i = matchExpr[ "needsContext" ].test( selector ) ? 0 : tokens.length; - while ( i-- ) { - token = tokens[ i ]; - - // Abort if we hit a combinator - if ( Expr.relative[ ( type = token.type ) ] ) { - break; - } - if ( ( find = Expr.find[ type ] ) ) { - - // Search, expanding context for leading sibling combinators - if ( ( seed = find( - token.matches[ 0 ].replace( runescape, funescape ), - rsibling.test( tokens[ 0 ].type ) && testContext( context.parentNode ) || - context - ) ) ) { - - // If seed is empty or no tokens remain, we can return early - tokens.splice( i, 1 ); - selector = seed.length && toSelector( tokens ); - if ( !selector ) { - push.apply( results, seed ); - return results; - } - - break; - } - } - } - } - - // Compile and execute a filtering function if one is not provided - // Provide `match` to avoid retokenization if we modified the selector above - ( compiled || compile( selector, match ) )( - seed, - context, - !documentIsHTML, - results, - !context || rsibling.test( selector ) && testContext( context.parentNode ) || context - ); - return results; -}; - -// One-time assignments - -// Sort stability -support.sortStable = expando.split( "" ).sort( sortOrder ).join( "" ) === expando; - -// Support: Chrome 14-35+ -// Always assume duplicates if they aren't passed to the comparison function -support.detectDuplicates = !!hasDuplicate; - -// Initialize against the default document -setDocument(); - -// Support: Webkit<537.32 - Safari 6.0.3/Chrome 25 (fixed in Chrome 27) -// Detached nodes confoundingly follow *each other* -support.sortDetached = assert( function( el ) { - - // Should return 1, but returns 4 (following) - return el.compareDocumentPosition( document.createElement( "fieldset" ) ) & 1; -} ); - -// Support: IE<8 -// Prevent attribute/property "interpolation" -// https://msdn.microsoft.com/en-us/library/ms536429%28VS.85%29.aspx -if ( !assert( function( el ) { - el.innerHTML = ""; - return el.firstChild.getAttribute( "href" ) === "#"; -} ) ) { - addHandle( "type|href|height|width", function( elem, name, isXML ) { - if ( !isXML ) { - return elem.getAttribute( name, name.toLowerCase() === "type" ? 1 : 2 ); - } - } ); -} - -// Support: IE<9 -// Use defaultValue in place of getAttribute("value") -if ( !support.attributes || !assert( function( el ) { - el.innerHTML = ""; - el.firstChild.setAttribute( "value", "" ); - return el.firstChild.getAttribute( "value" ) === ""; -} ) ) { - addHandle( "value", function( elem, _name, isXML ) { - if ( !isXML && elem.nodeName.toLowerCase() === "input" ) { - return elem.defaultValue; - } - } ); -} - -// Support: IE<9 -// Use getAttributeNode to fetch booleans when getAttribute lies -if ( !assert( function( el ) { - return el.getAttribute( "disabled" ) == null; -} ) ) { - addHandle( booleans, function( elem, name, isXML ) { - var val; - if ( !isXML ) { - return elem[ name ] === true ? name.toLowerCase() : - ( val = elem.getAttributeNode( name ) ) && val.specified ? - val.value : - null; - } - } ); -} - -return Sizzle; - -} )( window ); - - - -jQuery.find = Sizzle; -jQuery.expr = Sizzle.selectors; - -// Deprecated -jQuery.expr[ ":" ] = jQuery.expr.pseudos; -jQuery.uniqueSort = jQuery.unique = Sizzle.uniqueSort; -jQuery.text = Sizzle.getText; -jQuery.isXMLDoc = Sizzle.isXML; -jQuery.contains = Sizzle.contains; -jQuery.escapeSelector = Sizzle.escape; - - - - -var dir = function( elem, dir, until ) { - var matched = [], - truncate = until !== undefined; - - while ( ( elem = elem[ dir ] ) && elem.nodeType !== 9 ) { - if ( elem.nodeType === 1 ) { - if ( truncate && jQuery( elem ).is( until ) ) { - break; - } - matched.push( elem ); - } - } - return matched; -}; - - -var siblings = function( n, elem ) { - var matched = []; - - for ( ; n; n = n.nextSibling ) { - if ( n.nodeType === 1 && n !== elem ) { - matched.push( n ); - } - } - - return matched; -}; - - -var rneedsContext = jQuery.expr.match.needsContext; - - - -function nodeName( elem, name ) { - - return elem.nodeName && elem.nodeName.toLowerCase() === name.toLowerCase(); - -} -var rsingleTag = ( /^<([a-z][^\/\0>:\x20\t\r\n\f]*)[\x20\t\r\n\f]*\/?>(?:<\/\1>|)$/i ); - - - -// Implement the identical functionality for filter and not -function winnow( elements, qualifier, not ) { - if ( isFunction( qualifier ) ) { - return jQuery.grep( elements, function( elem, i ) { - return !!qualifier.call( elem, i, elem ) !== not; - } ); - } - - // Single element - if ( qualifier.nodeType ) { - return jQuery.grep( elements, function( elem ) { - return ( elem === qualifier ) !== not; - } ); - } - - // Arraylike of elements (jQuery, arguments, Array) - if ( typeof qualifier !== "string" ) { - return jQuery.grep( elements, function( elem ) { - return ( indexOf.call( qualifier, elem ) > -1 ) !== not; - } ); - } - - // Filtered directly for both simple and complex selectors - return jQuery.filter( qualifier, elements, not ); -} - -jQuery.filter = function( expr, elems, not ) { - var elem = elems[ 0 ]; - - if ( not ) { - expr = ":not(" + expr + ")"; - } - - if ( elems.length === 1 && elem.nodeType === 1 ) { - return jQuery.find.matchesSelector( elem, expr ) ? [ elem ] : []; - } - - return jQuery.find.matches( expr, jQuery.grep( elems, function( elem ) { - return elem.nodeType === 1; - } ) ); -}; - -jQuery.fn.extend( { - find: function( selector ) { - var i, ret, - len = this.length, - self = this; - - if ( typeof selector !== "string" ) { - return this.pushStack( jQuery( selector ).filter( function() { - for ( i = 0; i < len; i++ ) { - if ( jQuery.contains( self[ i ], this ) ) { - return true; - } - } - } ) ); - } - - ret = this.pushStack( [] ); - - for ( i = 0; i < len; i++ ) { - jQuery.find( selector, self[ i ], ret ); - } - - return len > 1 ? jQuery.uniqueSort( ret ) : ret; - }, - filter: function( selector ) { - return this.pushStack( winnow( this, selector || [], false ) ); - }, - not: function( selector ) { - return this.pushStack( winnow( this, selector || [], true ) ); - }, - is: function( selector ) { - return !!winnow( - this, - - // If this is a positional/relative selector, check membership in the returned set - // so $("p:first").is("p:last") won't return true for a doc with two "p". - typeof selector === "string" && rneedsContext.test( selector ) ? - jQuery( selector ) : - selector || [], - false - ).length; - } -} ); - - -// Initialize a jQuery object - - -// A central reference to the root jQuery(document) -var rootjQuery, - - // A simple way to check for HTML strings - // Prioritize #id over to avoid XSS via location.hash (#9521) - // Strict HTML recognition (#11290: must start with <) - // Shortcut simple #id case for speed - rquickExpr = /^(?:\s*(<[\w\W]+>)[^>]*|#([\w-]+))$/, - - init = jQuery.fn.init = function( selector, context, root ) { - var match, elem; - - // HANDLE: $(""), $(null), $(undefined), $(false) - if ( !selector ) { - return this; - } - - // Method init() accepts an alternate rootjQuery - // so migrate can support jQuery.sub (gh-2101) - root = root || rootjQuery; - - // Handle HTML strings - if ( typeof selector === "string" ) { - if ( selector[ 0 ] === "<" && - selector[ selector.length - 1 ] === ">" && - selector.length >= 3 ) { - - // Assume that strings that start and end with <> are HTML and skip the regex check - match = [ null, selector, null ]; - - } else { - match = rquickExpr.exec( selector ); - } - - // Match html or make sure no context is specified for #id - if ( match && ( match[ 1 ] || !context ) ) { - - // HANDLE: $(html) -> $(array) - if ( match[ 1 ] ) { - context = context instanceof jQuery ? context[ 0 ] : context; - - // Option to run scripts is true for back-compat - // Intentionally let the error be thrown if parseHTML is not present - jQuery.merge( this, jQuery.parseHTML( - match[ 1 ], - context && context.nodeType ? context.ownerDocument || context : document, - true - ) ); - - // HANDLE: $(html, props) - if ( rsingleTag.test( match[ 1 ] ) && jQuery.isPlainObject( context ) ) { - for ( match in context ) { - - // Properties of context are called as methods if possible - if ( isFunction( this[ match ] ) ) { - this[ match ]( context[ match ] ); - - // ...and otherwise set as attributes - } else { - this.attr( match, context[ match ] ); - } - } - } - - return this; - - // HANDLE: $(#id) - } else { - elem = document.getElementById( match[ 2 ] ); - - if ( elem ) { - - // Inject the element directly into the jQuery object - this[ 0 ] = elem; - this.length = 1; - } - return this; - } - - // HANDLE: $(expr, $(...)) - } else if ( !context || context.jquery ) { - return ( context || root ).find( selector ); - - // HANDLE: $(expr, context) - // (which is just equivalent to: $(context).find(expr) - } else { - return this.constructor( context ).find( selector ); - } - - // HANDLE: $(DOMElement) - } else if ( selector.nodeType ) { - this[ 0 ] = selector; - this.length = 1; - return this; - - // HANDLE: $(function) - // Shortcut for document ready - } else if ( isFunction( selector ) ) { - return root.ready !== undefined ? - root.ready( selector ) : - - // Execute immediately if ready is not present - selector( jQuery ); - } - - return jQuery.makeArray( selector, this ); - }; - -// Give the init function the jQuery prototype for later instantiation -init.prototype = jQuery.fn; - -// Initialize central reference -rootjQuery = jQuery( document ); - - -var rparentsprev = /^(?:parents|prev(?:Until|All))/, - - // Methods guaranteed to produce a unique set when starting from a unique set - guaranteedUnique = { - children: true, - contents: true, - next: true, - prev: true - }; - -jQuery.fn.extend( { - has: function( target ) { - var targets = jQuery( target, this ), - l = targets.length; - - return this.filter( function() { - var i = 0; - for ( ; i < l; i++ ) { - if ( jQuery.contains( this, targets[ i ] ) ) { - return true; - } - } - } ); - }, - - closest: function( selectors, context ) { - var cur, - i = 0, - l = this.length, - matched = [], - targets = typeof selectors !== "string" && jQuery( selectors ); - - // Positional selectors never match, since there's no _selection_ context - if ( !rneedsContext.test( selectors ) ) { - for ( ; i < l; i++ ) { - for ( cur = this[ i ]; cur && cur !== context; cur = cur.parentNode ) { - - // Always skip document fragments - if ( cur.nodeType < 11 && ( targets ? - targets.index( cur ) > -1 : - - // Don't pass non-elements to Sizzle - cur.nodeType === 1 && - jQuery.find.matchesSelector( cur, selectors ) ) ) { - - matched.push( cur ); - break; - } - } - } - } - - return this.pushStack( matched.length > 1 ? jQuery.uniqueSort( matched ) : matched ); - }, - - // Determine the position of an element within the set - index: function( elem ) { - - // No argument, return index in parent - if ( !elem ) { - return ( this[ 0 ] && this[ 0 ].parentNode ) ? this.first().prevAll().length : -1; - } - - // Index in selector - if ( typeof elem === "string" ) { - return indexOf.call( jQuery( elem ), this[ 0 ] ); - } - - // Locate the position of the desired element - return indexOf.call( this, - - // If it receives a jQuery object, the first element is used - elem.jquery ? elem[ 0 ] : elem - ); - }, - - add: function( selector, context ) { - return this.pushStack( - jQuery.uniqueSort( - jQuery.merge( this.get(), jQuery( selector, context ) ) - ) - ); - }, - - addBack: function( selector ) { - return this.add( selector == null ? - this.prevObject : this.prevObject.filter( selector ) - ); - } -} ); - -function sibling( cur, dir ) { - while ( ( cur = cur[ dir ] ) && cur.nodeType !== 1 ) {} - return cur; -} - -jQuery.each( { - parent: function( elem ) { - var parent = elem.parentNode; - return parent && parent.nodeType !== 11 ? parent : null; - }, - parents: function( elem ) { - return dir( elem, "parentNode" ); - }, - parentsUntil: function( elem, _i, until ) { - return dir( elem, "parentNode", until ); - }, - next: function( elem ) { - return sibling( elem, "nextSibling" ); - }, - prev: function( elem ) { - return sibling( elem, "previousSibling" ); - }, - nextAll: function( elem ) { - return dir( elem, "nextSibling" ); - }, - prevAll: function( elem ) { - return dir( elem, "previousSibling" ); - }, - nextUntil: function( elem, _i, until ) { - return dir( elem, "nextSibling", until ); - }, - prevUntil: function( elem, _i, until ) { - return dir( elem, "previousSibling", until ); - }, - siblings: function( elem ) { - return siblings( ( elem.parentNode || {} ).firstChild, elem ); - }, - children: function( elem ) { - return siblings( elem.firstChild ); - }, - contents: function( elem ) { - if ( elem.contentDocument != null && - - // Support: IE 11+ - // elements with no `data` attribute has an object - // `contentDocument` with a `null` prototype. - getProto( elem.contentDocument ) ) { - - return elem.contentDocument; - } - - // Support: IE 9 - 11 only, iOS 7 only, Android Browser <=4.3 only - // Treat the template element as a regular one in browsers that - // don't support it. - if ( nodeName( elem, "template" ) ) { - elem = elem.content || elem; - } - - return jQuery.merge( [], elem.childNodes ); - } -}, function( name, fn ) { - jQuery.fn[ name ] = function( until, selector ) { - var matched = jQuery.map( this, fn, until ); - - if ( name.slice( -5 ) !== "Until" ) { - selector = until; - } - - if ( selector && typeof selector === "string" ) { - matched = jQuery.filter( selector, matched ); - } - - if ( this.length > 1 ) { - - // Remove duplicates - if ( !guaranteedUnique[ name ] ) { - jQuery.uniqueSort( matched ); - } - - // Reverse order for parents* and prev-derivatives - if ( rparentsprev.test( name ) ) { - matched.reverse(); - } - } - - return this.pushStack( matched ); - }; -} ); -var rnothtmlwhite = ( /[^\x20\t\r\n\f]+/g ); - - - -// Convert String-formatted options into Object-formatted ones -function createOptions( options ) { - var object = {}; - jQuery.each( options.match( rnothtmlwhite ) || [], function( _, flag ) { - object[ flag ] = true; - } ); - return object; -} - -/* - * Create a callback list using the following parameters: - * - * options: an optional list of space-separated options that will change how - * the callback list behaves or a more traditional option object - * - * By default a callback list will act like an event callback list and can be - * "fired" multiple times. - * - * Possible options: - * - * once: will ensure the callback list can only be fired once (like a Deferred) - * - * memory: will keep track of previous values and will call any callback added - * after the list has been fired right away with the latest "memorized" - * values (like a Deferred) - * - * unique: will ensure a callback can only be added once (no duplicate in the list) - * - * stopOnFalse: interrupt callings when a callback returns false - * - */ -jQuery.Callbacks = function( options ) { - - // Convert options from String-formatted to Object-formatted if needed - // (we check in cache first) - options = typeof options === "string" ? - createOptions( options ) : - jQuery.extend( {}, options ); - - var // Flag to know if list is currently firing - firing, - - // Last fire value for non-forgettable lists - memory, - - // Flag to know if list was already fired - fired, - - // Flag to prevent firing - locked, - - // Actual callback list - list = [], - - // Queue of execution data for repeatable lists - queue = [], - - // Index of currently firing callback (modified by add/remove as needed) - firingIndex = -1, - - // Fire callbacks - fire = function() { - - // Enforce single-firing - locked = locked || options.once; - - // Execute callbacks for all pending executions, - // respecting firingIndex overrides and runtime changes - fired = firing = true; - for ( ; queue.length; firingIndex = -1 ) { - memory = queue.shift(); - while ( ++firingIndex < list.length ) { - - // Run callback and check for early termination - if ( list[ firingIndex ].apply( memory[ 0 ], memory[ 1 ] ) === false && - options.stopOnFalse ) { - - // Jump to end and forget the data so .add doesn't re-fire - firingIndex = list.length; - memory = false; - } - } - } - - // Forget the data if we're done with it - if ( !options.memory ) { - memory = false; - } - - firing = false; - - // Clean up if we're done firing for good - if ( locked ) { - - // Keep an empty list if we have data for future add calls - if ( memory ) { - list = []; - - // Otherwise, this object is spent - } else { - list = ""; - } - } - }, - - // Actual Callbacks object - self = { - - // Add a callback or a collection of callbacks to the list - add: function() { - if ( list ) { - - // If we have memory from a past run, we should fire after adding - if ( memory && !firing ) { - firingIndex = list.length - 1; - queue.push( memory ); - } - - ( function add( args ) { - jQuery.each( args, function( _, arg ) { - if ( isFunction( arg ) ) { - if ( !options.unique || !self.has( arg ) ) { - list.push( arg ); - } - } else if ( arg && arg.length && toType( arg ) !== "string" ) { - - // Inspect recursively - add( arg ); - } - } ); - } )( arguments ); - - if ( memory && !firing ) { - fire(); - } - } - return this; - }, - - // Remove a callback from the list - remove: function() { - jQuery.each( arguments, function( _, arg ) { - var index; - while ( ( index = jQuery.inArray( arg, list, index ) ) > -1 ) { - list.splice( index, 1 ); - - // Handle firing indexes - if ( index <= firingIndex ) { - firingIndex--; - } - } - } ); - return this; - }, - - // Check if a given callback is in the list. - // If no argument is given, return whether or not list has callbacks attached. - has: function( fn ) { - return fn ? - jQuery.inArray( fn, list ) > -1 : - list.length > 0; - }, - - // Remove all callbacks from the list - empty: function() { - if ( list ) { - list = []; - } - return this; - }, - - // Disable .fire and .add - // Abort any current/pending executions - // Clear all callbacks and values - disable: function() { - locked = queue = []; - list = memory = ""; - return this; - }, - disabled: function() { - return !list; - }, - - // Disable .fire - // Also disable .add unless we have memory (since it would have no effect) - // Abort any pending executions - lock: function() { - locked = queue = []; - if ( !memory && !firing ) { - list = memory = ""; - } - return this; - }, - locked: function() { - return !!locked; - }, - - // Call all callbacks with the given context and arguments - fireWith: function( context, args ) { - if ( !locked ) { - args = args || []; - args = [ context, args.slice ? args.slice() : args ]; - queue.push( args ); - if ( !firing ) { - fire(); - } - } - return this; - }, - - // Call all the callbacks with the given arguments - fire: function() { - self.fireWith( this, arguments ); - return this; - }, - - // To know if the callbacks have already been called at least once - fired: function() { - return !!fired; - } - }; - - return self; -}; - - -function Identity( v ) { - return v; -} -function Thrower( ex ) { - throw ex; -} - -function adoptValue( value, resolve, reject, noValue ) { - var method; - - try { - - // Check for promise aspect first to privilege synchronous behavior - if ( value && isFunction( ( method = value.promise ) ) ) { - method.call( value ).done( resolve ).fail( reject ); - - // Other thenables - } else if ( value && isFunction( ( method = value.then ) ) ) { - method.call( value, resolve, reject ); - - // Other non-thenables - } else { - - // Control `resolve` arguments by letting Array#slice cast boolean `noValue` to integer: - // * false: [ value ].slice( 0 ) => resolve( value ) - // * true: [ value ].slice( 1 ) => resolve() - resolve.apply( undefined, [ value ].slice( noValue ) ); - } - - // For Promises/A+, convert exceptions into rejections - // Since jQuery.when doesn't unwrap thenables, we can skip the extra checks appearing in - // Deferred#then to conditionally suppress rejection. - } catch ( value ) { - - // Support: Android 4.0 only - // Strict mode functions invoked without .call/.apply get global-object context - reject.apply( undefined, [ value ] ); - } -} - -jQuery.extend( { - - Deferred: function( func ) { - var tuples = [ - - // action, add listener, callbacks, - // ... .then handlers, argument index, [final state] - [ "notify", "progress", jQuery.Callbacks( "memory" ), - jQuery.Callbacks( "memory" ), 2 ], - [ "resolve", "done", jQuery.Callbacks( "once memory" ), - jQuery.Callbacks( "once memory" ), 0, "resolved" ], - [ "reject", "fail", jQuery.Callbacks( "once memory" ), - jQuery.Callbacks( "once memory" ), 1, "rejected" ] - ], - state = "pending", - promise = { - state: function() { - return state; - }, - always: function() { - deferred.done( arguments ).fail( arguments ); - return this; - }, - "catch": function( fn ) { - return promise.then( null, fn ); - }, - - // Keep pipe for back-compat - pipe: function( /* fnDone, fnFail, fnProgress */ ) { - var fns = arguments; - - return jQuery.Deferred( function( newDefer ) { - jQuery.each( tuples, function( _i, tuple ) { - - // Map tuples (progress, done, fail) to arguments (done, fail, progress) - var fn = isFunction( fns[ tuple[ 4 ] ] ) && fns[ tuple[ 4 ] ]; - - // deferred.progress(function() { bind to newDefer or newDefer.notify }) - // deferred.done(function() { bind to newDefer or newDefer.resolve }) - // deferred.fail(function() { bind to newDefer or newDefer.reject }) - deferred[ tuple[ 1 ] ]( function() { - var returned = fn && fn.apply( this, arguments ); - if ( returned && isFunction( returned.promise ) ) { - returned.promise() - .progress( newDefer.notify ) - .done( newDefer.resolve ) - .fail( newDefer.reject ); - } else { - newDefer[ tuple[ 0 ] + "With" ]( - this, - fn ? [ returned ] : arguments - ); - } - } ); - } ); - fns = null; - } ).promise(); - }, - then: function( onFulfilled, onRejected, onProgress ) { - var maxDepth = 0; - function resolve( depth, deferred, handler, special ) { - return function() { - var that = this, - args = arguments, - mightThrow = function() { - var returned, then; - - // Support: Promises/A+ section 2.3.3.3.3 - // https://promisesaplus.com/#point-59 - // Ignore double-resolution attempts - if ( depth < maxDepth ) { - return; - } - - returned = handler.apply( that, args ); - - // Support: Promises/A+ section 2.3.1 - // https://promisesaplus.com/#point-48 - if ( returned === deferred.promise() ) { - throw new TypeError( "Thenable self-resolution" ); - } - - // Support: Promises/A+ sections 2.3.3.1, 3.5 - // https://promisesaplus.com/#point-54 - // https://promisesaplus.com/#point-75 - // Retrieve `then` only once - then = returned && - - // Support: Promises/A+ section 2.3.4 - // https://promisesaplus.com/#point-64 - // Only check objects and functions for thenability - ( typeof returned === "object" || - typeof returned === "function" ) && - returned.then; - - // Handle a returned thenable - if ( isFunction( then ) ) { - - // Special processors (notify) just wait for resolution - if ( special ) { - then.call( - returned, - resolve( maxDepth, deferred, Identity, special ), - resolve( maxDepth, deferred, Thrower, special ) - ); - - // Normal processors (resolve) also hook into progress - } else { - - // ...and disregard older resolution values - maxDepth++; - - then.call( - returned, - resolve( maxDepth, deferred, Identity, special ), - resolve( maxDepth, deferred, Thrower, special ), - resolve( maxDepth, deferred, Identity, - deferred.notifyWith ) - ); - } - - // Handle all other returned values - } else { - - // Only substitute handlers pass on context - // and multiple values (non-spec behavior) - if ( handler !== Identity ) { - that = undefined; - args = [ returned ]; - } - - // Process the value(s) - // Default process is resolve - ( special || deferred.resolveWith )( that, args ); - } - }, - - // Only normal processors (resolve) catch and reject exceptions - process = special ? - mightThrow : - function() { - try { - mightThrow(); - } catch ( e ) { - - if ( jQuery.Deferred.exceptionHook ) { - jQuery.Deferred.exceptionHook( e, - process.stackTrace ); - } - - // Support: Promises/A+ section 2.3.3.3.4.1 - // https://promisesaplus.com/#point-61 - // Ignore post-resolution exceptions - if ( depth + 1 >= maxDepth ) { - - // Only substitute handlers pass on context - // and multiple values (non-spec behavior) - if ( handler !== Thrower ) { - that = undefined; - args = [ e ]; - } - - deferred.rejectWith( that, args ); - } - } - }; - - // Support: Promises/A+ section 2.3.3.3.1 - // https://promisesaplus.com/#point-57 - // Re-resolve promises immediately to dodge false rejection from - // subsequent errors - if ( depth ) { - process(); - } else { - - // Call an optional hook to record the stack, in case of exception - // since it's otherwise lost when execution goes async - if ( jQuery.Deferred.getStackHook ) { - process.stackTrace = jQuery.Deferred.getStackHook(); - } - window.setTimeout( process ); - } - }; - } - - return jQuery.Deferred( function( newDefer ) { - - // progress_handlers.add( ... ) - tuples[ 0 ][ 3 ].add( - resolve( - 0, - newDefer, - isFunction( onProgress ) ? - onProgress : - Identity, - newDefer.notifyWith - ) - ); - - // fulfilled_handlers.add( ... ) - tuples[ 1 ][ 3 ].add( - resolve( - 0, - newDefer, - isFunction( onFulfilled ) ? - onFulfilled : - Identity - ) - ); - - // rejected_handlers.add( ... ) - tuples[ 2 ][ 3 ].add( - resolve( - 0, - newDefer, - isFunction( onRejected ) ? - onRejected : - Thrower - ) - ); - } ).promise(); - }, - - // Get a promise for this deferred - // If obj is provided, the promise aspect is added to the object - promise: function( obj ) { - return obj != null ? jQuery.extend( obj, promise ) : promise; - } - }, - deferred = {}; - - // Add list-specific methods - jQuery.each( tuples, function( i, tuple ) { - var list = tuple[ 2 ], - stateString = tuple[ 5 ]; - - // promise.progress = list.add - // promise.done = list.add - // promise.fail = list.add - promise[ tuple[ 1 ] ] = list.add; - - // Handle state - if ( stateString ) { - list.add( - function() { - - // state = "resolved" (i.e., fulfilled) - // state = "rejected" - state = stateString; - }, - - // rejected_callbacks.disable - // fulfilled_callbacks.disable - tuples[ 3 - i ][ 2 ].disable, - - // rejected_handlers.disable - // fulfilled_handlers.disable - tuples[ 3 - i ][ 3 ].disable, - - // progress_callbacks.lock - tuples[ 0 ][ 2 ].lock, - - // progress_handlers.lock - tuples[ 0 ][ 3 ].lock - ); - } - - // progress_handlers.fire - // fulfilled_handlers.fire - // rejected_handlers.fire - list.add( tuple[ 3 ].fire ); - - // deferred.notify = function() { deferred.notifyWith(...) } - // deferred.resolve = function() { deferred.resolveWith(...) } - // deferred.reject = function() { deferred.rejectWith(...) } - deferred[ tuple[ 0 ] ] = function() { - deferred[ tuple[ 0 ] + "With" ]( this === deferred ? undefined : this, arguments ); - return this; - }; - - // deferred.notifyWith = list.fireWith - // deferred.resolveWith = list.fireWith - // deferred.rejectWith = list.fireWith - deferred[ tuple[ 0 ] + "With" ] = list.fireWith; - } ); - - // Make the deferred a promise - promise.promise( deferred ); - - // Call given func if any - if ( func ) { - func.call( deferred, deferred ); - } - - // All done! - return deferred; - }, - - // Deferred helper - when: function( singleValue ) { - var - - // count of uncompleted subordinates - remaining = arguments.length, - - // count of unprocessed arguments - i = remaining, - - // subordinate fulfillment data - resolveContexts = Array( i ), - resolveValues = slice.call( arguments ), - - // the primary Deferred - primary = jQuery.Deferred(), - - // subordinate callback factory - updateFunc = function( i ) { - return function( value ) { - resolveContexts[ i ] = this; - resolveValues[ i ] = arguments.length > 1 ? slice.call( arguments ) : value; - if ( !( --remaining ) ) { - primary.resolveWith( resolveContexts, resolveValues ); - } - }; - }; - - // Single- and empty arguments are adopted like Promise.resolve - if ( remaining <= 1 ) { - adoptValue( singleValue, primary.done( updateFunc( i ) ).resolve, primary.reject, - !remaining ); - - // Use .then() to unwrap secondary thenables (cf. gh-3000) - if ( primary.state() === "pending" || - isFunction( resolveValues[ i ] && resolveValues[ i ].then ) ) { - - return primary.then(); - } - } - - // Multiple arguments are aggregated like Promise.all array elements - while ( i-- ) { - adoptValue( resolveValues[ i ], updateFunc( i ), primary.reject ); - } - - return primary.promise(); - } -} ); - - -// These usually indicate a programmer mistake during development, -// warn about them ASAP rather than swallowing them by default. -var rerrorNames = /^(Eval|Internal|Range|Reference|Syntax|Type|URI)Error$/; - -jQuery.Deferred.exceptionHook = function( error, stack ) { - - // Support: IE 8 - 9 only - // Console exists when dev tools are open, which can happen at any time - if ( window.console && window.console.warn && error && rerrorNames.test( error.name ) ) { - window.console.warn( "jQuery.Deferred exception: " + error.message, error.stack, stack ); - } -}; - - - - -jQuery.readyException = function( error ) { - window.setTimeout( function() { - throw error; - } ); -}; - - - - -// The deferred used on DOM ready -var readyList = jQuery.Deferred(); - -jQuery.fn.ready = function( fn ) { - - readyList - .then( fn ) - - // Wrap jQuery.readyException in a function so that the lookup - // happens at the time of error handling instead of callback - // registration. - .catch( function( error ) { - jQuery.readyException( error ); - } ); - - return this; -}; - -jQuery.extend( { - - // Is the DOM ready to be used? Set to true once it occurs. - isReady: false, - - // A counter to track how many items to wait for before - // the ready event fires. See #6781 - readyWait: 1, - - // Handle when the DOM is ready - ready: function( wait ) { - - // Abort if there are pending holds or we're already ready - if ( wait === true ? --jQuery.readyWait : jQuery.isReady ) { - return; - } - - // Remember that the DOM is ready - jQuery.isReady = true; - - // If a normal DOM Ready event fired, decrement, and wait if need be - if ( wait !== true && --jQuery.readyWait > 0 ) { - return; - } - - // If there are functions bound, to execute - readyList.resolveWith( document, [ jQuery ] ); - } -} ); - -jQuery.ready.then = readyList.then; - -// The ready event handler and self cleanup method -function completed() { - document.removeEventListener( "DOMContentLoaded", completed ); - window.removeEventListener( "load", completed ); - jQuery.ready(); -} - -// Catch cases where $(document).ready() is called -// after the browser event has already occurred. -// Support: IE <=9 - 10 only -// Older IE sometimes signals "interactive" too soon -if ( document.readyState === "complete" || - ( document.readyState !== "loading" && !document.documentElement.doScroll ) ) { - - // Handle it asynchronously to allow scripts the opportunity to delay ready - window.setTimeout( jQuery.ready ); - -} else { - - // Use the handy event callback - document.addEventListener( "DOMContentLoaded", completed ); - - // A fallback to window.onload, that will always work - window.addEventListener( "load", completed ); -} - - - - -// Multifunctional method to get and set values of a collection -// The value/s can optionally be executed if it's a function -var access = function( elems, fn, key, value, chainable, emptyGet, raw ) { - var i = 0, - len = elems.length, - bulk = key == null; - - // Sets many values - if ( toType( key ) === "object" ) { - chainable = true; - for ( i in key ) { - access( elems, fn, i, key[ i ], true, emptyGet, raw ); - } - - // Sets one value - } else if ( value !== undefined ) { - chainable = true; - - if ( !isFunction( value ) ) { - raw = true; - } - - if ( bulk ) { - - // Bulk operations run against the entire set - if ( raw ) { - fn.call( elems, value ); - fn = null; - - // ...except when executing function values - } else { - bulk = fn; - fn = function( elem, _key, value ) { - return bulk.call( jQuery( elem ), value ); - }; - } - } - - if ( fn ) { - for ( ; i < len; i++ ) { - fn( - elems[ i ], key, raw ? - value : - value.call( elems[ i ], i, fn( elems[ i ], key ) ) - ); - } - } - } - - if ( chainable ) { - return elems; - } - - // Gets - if ( bulk ) { - return fn.call( elems ); - } - - return len ? fn( elems[ 0 ], key ) : emptyGet; -}; - - -// Matches dashed string for camelizing -var rmsPrefix = /^-ms-/, - rdashAlpha = /-([a-z])/g; - -// Used by camelCase as callback to replace() -function fcamelCase( _all, letter ) { - return letter.toUpperCase(); -} - -// Convert dashed to camelCase; used by the css and data modules -// Support: IE <=9 - 11, Edge 12 - 15 -// Microsoft forgot to hump their vendor prefix (#9572) -function camelCase( string ) { - return string.replace( rmsPrefix, "ms-" ).replace( rdashAlpha, fcamelCase ); -} -var acceptData = function( owner ) { - - // Accepts only: - // - Node - // - Node.ELEMENT_NODE - // - Node.DOCUMENT_NODE - // - Object - // - Any - return owner.nodeType === 1 || owner.nodeType === 9 || !( +owner.nodeType ); -}; - - - - -function Data() { - this.expando = jQuery.expando + Data.uid++; -} - -Data.uid = 1; - -Data.prototype = { - - cache: function( owner ) { - - // Check if the owner object already has a cache - var value = owner[ this.expando ]; - - // If not, create one - if ( !value ) { - value = {}; - - // We can accept data for non-element nodes in modern browsers, - // but we should not, see #8335. - // Always return an empty object. - if ( acceptData( owner ) ) { - - // If it is a node unlikely to be stringify-ed or looped over - // use plain assignment - if ( owner.nodeType ) { - owner[ this.expando ] = value; - - // Otherwise secure it in a non-enumerable property - // configurable must be true to allow the property to be - // deleted when data is removed - } else { - Object.defineProperty( owner, this.expando, { - value: value, - configurable: true - } ); - } - } - } - - return value; - }, - set: function( owner, data, value ) { - var prop, - cache = this.cache( owner ); - - // Handle: [ owner, key, value ] args - // Always use camelCase key (gh-2257) - if ( typeof data === "string" ) { - cache[ camelCase( data ) ] = value; - - // Handle: [ owner, { properties } ] args - } else { - - // Copy the properties one-by-one to the cache object - for ( prop in data ) { - cache[ camelCase( prop ) ] = data[ prop ]; - } - } - return cache; - }, - get: function( owner, key ) { - return key === undefined ? - this.cache( owner ) : - - // Always use camelCase key (gh-2257) - owner[ this.expando ] && owner[ this.expando ][ camelCase( key ) ]; - }, - access: function( owner, key, value ) { - - // In cases where either: - // - // 1. No key was specified - // 2. A string key was specified, but no value provided - // - // Take the "read" path and allow the get method to determine - // which value to return, respectively either: - // - // 1. The entire cache object - // 2. The data stored at the key - // - if ( key === undefined || - ( ( key && typeof key === "string" ) && value === undefined ) ) { - - return this.get( owner, key ); - } - - // When the key is not a string, or both a key and value - // are specified, set or extend (existing objects) with either: - // - // 1. An object of properties - // 2. A key and value - // - this.set( owner, key, value ); - - // Since the "set" path can have two possible entry points - // return the expected data based on which path was taken[*] - return value !== undefined ? value : key; - }, - remove: function( owner, key ) { - var i, - cache = owner[ this.expando ]; - - if ( cache === undefined ) { - return; - } - - if ( key !== undefined ) { - - // Support array or space separated string of keys - if ( Array.isArray( key ) ) { - - // If key is an array of keys... - // We always set camelCase keys, so remove that. - key = key.map( camelCase ); - } else { - key = camelCase( key ); - - // If a key with the spaces exists, use it. - // Otherwise, create an array by matching non-whitespace - key = key in cache ? - [ key ] : - ( key.match( rnothtmlwhite ) || [] ); - } - - i = key.length; - - while ( i-- ) { - delete cache[ key[ i ] ]; - } - } - - // Remove the expando if there's no more data - if ( key === undefined || jQuery.isEmptyObject( cache ) ) { - - // Support: Chrome <=35 - 45 - // Webkit & Blink performance suffers when deleting properties - // from DOM nodes, so set to undefined instead - // https://bugs.chromium.org/p/chromium/issues/detail?id=378607 (bug restricted) - if ( owner.nodeType ) { - owner[ this.expando ] = undefined; - } else { - delete owner[ this.expando ]; - } - } - }, - hasData: function( owner ) { - var cache = owner[ this.expando ]; - return cache !== undefined && !jQuery.isEmptyObject( cache ); - } -}; -var dataPriv = new Data(); - -var dataUser = new Data(); - - - -// Implementation Summary -// -// 1. Enforce API surface and semantic compatibility with 1.9.x branch -// 2. Improve the module's maintainability by reducing the storage -// paths to a single mechanism. -// 3. Use the same single mechanism to support "private" and "user" data. -// 4. _Never_ expose "private" data to user code (TODO: Drop _data, _removeData) -// 5. Avoid exposing implementation details on user objects (eg. expando properties) -// 6. Provide a clear path for implementation upgrade to WeakMap in 2014 - -var rbrace = /^(?:\{[\w\W]*\}|\[[\w\W]*\])$/, - rmultiDash = /[A-Z]/g; - -function getData( data ) { - if ( data === "true" ) { - return true; - } - - if ( data === "false" ) { - return false; - } - - if ( data === "null" ) { - return null; - } - - // Only convert to a number if it doesn't change the string - if ( data === +data + "" ) { - return +data; - } - - if ( rbrace.test( data ) ) { - return JSON.parse( data ); - } - - return data; -} - -function dataAttr( elem, key, data ) { - var name; - - // If nothing was found internally, try to fetch any - // data from the HTML5 data-* attribute - if ( data === undefined && elem.nodeType === 1 ) { - name = "data-" + key.replace( rmultiDash, "-$&" ).toLowerCase(); - data = elem.getAttribute( name ); - - if ( typeof data === "string" ) { - try { - data = getData( data ); - } catch ( e ) {} - - // Make sure we set the data so it isn't changed later - dataUser.set( elem, key, data ); - } else { - data = undefined; - } - } - return data; -} - -jQuery.extend( { - hasData: function( elem ) { - return dataUser.hasData( elem ) || dataPriv.hasData( elem ); - }, - - data: function( elem, name, data ) { - return dataUser.access( elem, name, data ); - }, - - removeData: function( elem, name ) { - dataUser.remove( elem, name ); - }, - - // TODO: Now that all calls to _data and _removeData have been replaced - // with direct calls to dataPriv methods, these can be deprecated. - _data: function( elem, name, data ) { - return dataPriv.access( elem, name, data ); - }, - - _removeData: function( elem, name ) { - dataPriv.remove( elem, name ); - } -} ); - -jQuery.fn.extend( { - data: function( key, value ) { - var i, name, data, - elem = this[ 0 ], - attrs = elem && elem.attributes; - - // Gets all values - if ( key === undefined ) { - if ( this.length ) { - data = dataUser.get( elem ); - - if ( elem.nodeType === 1 && !dataPriv.get( elem, "hasDataAttrs" ) ) { - i = attrs.length; - while ( i-- ) { - - // Support: IE 11 only - // The attrs elements can be null (#14894) - if ( attrs[ i ] ) { - name = attrs[ i ].name; - if ( name.indexOf( "data-" ) === 0 ) { - name = camelCase( name.slice( 5 ) ); - dataAttr( elem, name, data[ name ] ); - } - } - } - dataPriv.set( elem, "hasDataAttrs", true ); - } - } - - return data; - } - - // Sets multiple values - if ( typeof key === "object" ) { - return this.each( function() { - dataUser.set( this, key ); - } ); - } - - return access( this, function( value ) { - var data; - - // The calling jQuery object (element matches) is not empty - // (and therefore has an element appears at this[ 0 ]) and the - // `value` parameter was not undefined. An empty jQuery object - // will result in `undefined` for elem = this[ 0 ] which will - // throw an exception if an attempt to read a data cache is made. - if ( elem && value === undefined ) { - - // Attempt to get data from the cache - // The key will always be camelCased in Data - data = dataUser.get( elem, key ); - if ( data !== undefined ) { - return data; - } - - // Attempt to "discover" the data in - // HTML5 custom data-* attrs - data = dataAttr( elem, key ); - if ( data !== undefined ) { - return data; - } - - // We tried really hard, but the data doesn't exist. - return; - } - - // Set the data... - this.each( function() { - - // We always store the camelCased key - dataUser.set( this, key, value ); - } ); - }, null, value, arguments.length > 1, null, true ); - }, - - removeData: function( key ) { - return this.each( function() { - dataUser.remove( this, key ); - } ); - } -} ); - - -jQuery.extend( { - queue: function( elem, type, data ) { - var queue; - - if ( elem ) { - type = ( type || "fx" ) + "queue"; - queue = dataPriv.get( elem, type ); - - // Speed up dequeue by getting out quickly if this is just a lookup - if ( data ) { - if ( !queue || Array.isArray( data ) ) { - queue = dataPriv.access( elem, type, jQuery.makeArray( data ) ); - } else { - queue.push( data ); - } - } - return queue || []; - } - }, - - dequeue: function( elem, type ) { - type = type || "fx"; - - var queue = jQuery.queue( elem, type ), - startLength = queue.length, - fn = queue.shift(), - hooks = jQuery._queueHooks( elem, type ), - next = function() { - jQuery.dequeue( elem, type ); - }; - - // If the fx queue is dequeued, always remove the progress sentinel - if ( fn === "inprogress" ) { - fn = queue.shift(); - startLength--; - } - - if ( fn ) { - - // Add a progress sentinel to prevent the fx queue from being - // automatically dequeued - if ( type === "fx" ) { - queue.unshift( "inprogress" ); - } - - // Clear up the last queue stop function - delete hooks.stop; - fn.call( elem, next, hooks ); - } - - if ( !startLength && hooks ) { - hooks.empty.fire(); - } - }, - - // Not public - generate a queueHooks object, or return the current one - _queueHooks: function( elem, type ) { - var key = type + "queueHooks"; - return dataPriv.get( elem, key ) || dataPriv.access( elem, key, { - empty: jQuery.Callbacks( "once memory" ).add( function() { - dataPriv.remove( elem, [ type + "queue", key ] ); - } ) - } ); - } -} ); - -jQuery.fn.extend( { - queue: function( type, data ) { - var setter = 2; - - if ( typeof type !== "string" ) { - data = type; - type = "fx"; - setter--; - } - - if ( arguments.length < setter ) { - return jQuery.queue( this[ 0 ], type ); - } - - return data === undefined ? - this : - this.each( function() { - var queue = jQuery.queue( this, type, data ); - - // Ensure a hooks for this queue - jQuery._queueHooks( this, type ); - - if ( type === "fx" && queue[ 0 ] !== "inprogress" ) { - jQuery.dequeue( this, type ); - } - } ); - }, - dequeue: function( type ) { - return this.each( function() { - jQuery.dequeue( this, type ); - } ); - }, - clearQueue: function( type ) { - return this.queue( type || "fx", [] ); - }, - - // Get a promise resolved when queues of a certain type - // are emptied (fx is the type by default) - promise: function( type, obj ) { - var tmp, - count = 1, - defer = jQuery.Deferred(), - elements = this, - i = this.length, - resolve = function() { - if ( !( --count ) ) { - defer.resolveWith( elements, [ elements ] ); - } - }; - - if ( typeof type !== "string" ) { - obj = type; - type = undefined; - } - type = type || "fx"; - - while ( i-- ) { - tmp = dataPriv.get( elements[ i ], type + "queueHooks" ); - if ( tmp && tmp.empty ) { - count++; - tmp.empty.add( resolve ); - } - } - resolve(); - return defer.promise( obj ); - } -} ); -var pnum = ( /[+-]?(?:\d*\.|)\d+(?:[eE][+-]?\d+|)/ ).source; - -var rcssNum = new RegExp( "^(?:([+-])=|)(" + pnum + ")([a-z%]*)$", "i" ); - - -var cssExpand = [ "Top", "Right", "Bottom", "Left" ]; - -var documentElement = document.documentElement; - - - - var isAttached = function( elem ) { - return jQuery.contains( elem.ownerDocument, elem ); - }, - composed = { composed: true }; - - // Support: IE 9 - 11+, Edge 12 - 18+, iOS 10.0 - 10.2 only - // Check attachment across shadow DOM boundaries when possible (gh-3504) - // Support: iOS 10.0-10.2 only - // Early iOS 10 versions support `attachShadow` but not `getRootNode`, - // leading to errors. We need to check for `getRootNode`. - if ( documentElement.getRootNode ) { - isAttached = function( elem ) { - return jQuery.contains( elem.ownerDocument, elem ) || - elem.getRootNode( composed ) === elem.ownerDocument; - }; - } -var isHiddenWithinTree = function( elem, el ) { - - // isHiddenWithinTree might be called from jQuery#filter function; - // in that case, element will be second argument - elem = el || elem; - - // Inline style trumps all - return elem.style.display === "none" || - elem.style.display === "" && - - // Otherwise, check computed style - // Support: Firefox <=43 - 45 - // Disconnected elements can have computed display: none, so first confirm that elem is - // in the document. - isAttached( elem ) && - - jQuery.css( elem, "display" ) === "none"; - }; - - - -function adjustCSS( elem, prop, valueParts, tween ) { - var adjusted, scale, - maxIterations = 20, - currentValue = tween ? - function() { - return tween.cur(); - } : - function() { - return jQuery.css( elem, prop, "" ); - }, - initial = currentValue(), - unit = valueParts && valueParts[ 3 ] || ( jQuery.cssNumber[ prop ] ? "" : "px" ), - - // Starting value computation is required for potential unit mismatches - initialInUnit = elem.nodeType && - ( jQuery.cssNumber[ prop ] || unit !== "px" && +initial ) && - rcssNum.exec( jQuery.css( elem, prop ) ); - - if ( initialInUnit && initialInUnit[ 3 ] !== unit ) { - - // Support: Firefox <=54 - // Halve the iteration target value to prevent interference from CSS upper bounds (gh-2144) - initial = initial / 2; - - // Trust units reported by jQuery.css - unit = unit || initialInUnit[ 3 ]; - - // Iteratively approximate from a nonzero starting point - initialInUnit = +initial || 1; - - while ( maxIterations-- ) { - - // Evaluate and update our best guess (doubling guesses that zero out). - // Finish if the scale equals or crosses 1 (making the old*new product non-positive). - jQuery.style( elem, prop, initialInUnit + unit ); - if ( ( 1 - scale ) * ( 1 - ( scale = currentValue() / initial || 0.5 ) ) <= 0 ) { - maxIterations = 0; - } - initialInUnit = initialInUnit / scale; - - } - - initialInUnit = initialInUnit * 2; - jQuery.style( elem, prop, initialInUnit + unit ); - - // Make sure we update the tween properties later on - valueParts = valueParts || []; - } - - if ( valueParts ) { - initialInUnit = +initialInUnit || +initial || 0; - - // Apply relative offset (+=/-=) if specified - adjusted = valueParts[ 1 ] ? - initialInUnit + ( valueParts[ 1 ] + 1 ) * valueParts[ 2 ] : - +valueParts[ 2 ]; - if ( tween ) { - tween.unit = unit; - tween.start = initialInUnit; - tween.end = adjusted; - } - } - return adjusted; -} - - -var defaultDisplayMap = {}; - -function getDefaultDisplay( elem ) { - var temp, - doc = elem.ownerDocument, - nodeName = elem.nodeName, - display = defaultDisplayMap[ nodeName ]; - - if ( display ) { - return display; - } - - temp = doc.body.appendChild( doc.createElement( nodeName ) ); - display = jQuery.css( temp, "display" ); - - temp.parentNode.removeChild( temp ); - - if ( display === "none" ) { - display = "block"; - } - defaultDisplayMap[ nodeName ] = display; - - return display; -} - -function showHide( elements, show ) { - var display, elem, - values = [], - index = 0, - length = elements.length; - - // Determine new display value for elements that need to change - for ( ; index < length; index++ ) { - elem = elements[ index ]; - if ( !elem.style ) { - continue; - } - - display = elem.style.display; - if ( show ) { - - // Since we force visibility upon cascade-hidden elements, an immediate (and slow) - // check is required in this first loop unless we have a nonempty display value (either - // inline or about-to-be-restored) - if ( display === "none" ) { - values[ index ] = dataPriv.get( elem, "display" ) || null; - if ( !values[ index ] ) { - elem.style.display = ""; - } - } - if ( elem.style.display === "" && isHiddenWithinTree( elem ) ) { - values[ index ] = getDefaultDisplay( elem ); - } - } else { - if ( display !== "none" ) { - values[ index ] = "none"; - - // Remember what we're overwriting - dataPriv.set( elem, "display", display ); - } - } - } - - // Set the display of the elements in a second loop to avoid constant reflow - for ( index = 0; index < length; index++ ) { - if ( values[ index ] != null ) { - elements[ index ].style.display = values[ index ]; - } - } - - return elements; -} - -jQuery.fn.extend( { - show: function() { - return showHide( this, true ); - }, - hide: function() { - return showHide( this ); - }, - toggle: function( state ) { - if ( typeof state === "boolean" ) { - return state ? this.show() : this.hide(); - } - - return this.each( function() { - if ( isHiddenWithinTree( this ) ) { - jQuery( this ).show(); - } else { - jQuery( this ).hide(); - } - } ); - } -} ); -var rcheckableType = ( /^(?:checkbox|radio)$/i ); - -var rtagName = ( /<([a-z][^\/\0>\x20\t\r\n\f]*)/i ); - -var rscriptType = ( /^$|^module$|\/(?:java|ecma)script/i ); - - - -( function() { - var fragment = document.createDocumentFragment(), - div = fragment.appendChild( document.createElement( "div" ) ), - input = document.createElement( "input" ); - - // Support: Android 4.0 - 4.3 only - // Check state lost if the name is set (#11217) - // Support: Windows Web Apps (WWA) - // `name` and `type` must use .setAttribute for WWA (#14901) - input.setAttribute( "type", "radio" ); - input.setAttribute( "checked", "checked" ); - input.setAttribute( "name", "t" ); - - div.appendChild( input ); - - // Support: Android <=4.1 only - // Older WebKit doesn't clone checked state correctly in fragments - support.checkClone = div.cloneNode( true ).cloneNode( true ).lastChild.checked; - - // Support: IE <=11 only - // Make sure textarea (and checkbox) defaultValue is properly cloned - div.innerHTML = ""; - support.noCloneChecked = !!div.cloneNode( true ).lastChild.defaultValue; - - // Support: IE <=9 only - // IE <=9 replaces "; - support.option = !!div.lastChild; -} )(); - - -// We have to close these tags to support XHTML (#13200) -var wrapMap = { - - // XHTML parsers do not magically insert elements in the - // same way that tag soup parsers do. So we cannot shorten - // this by omitting or other required elements. - thead: [ 1, "", "
      " ], - col: [ 2, "", "
      " ], - tr: [ 2, "", "
      " ], - td: [ 3, "", "
      " ], - - _default: [ 0, "", "" ] -}; - -wrapMap.tbody = wrapMap.tfoot = wrapMap.colgroup = wrapMap.caption = wrapMap.thead; -wrapMap.th = wrapMap.td; - -// Support: IE <=9 only -if ( !support.option ) { - wrapMap.optgroup = wrapMap.option = [ 1, "" ]; -} - - -function getAll( context, tag ) { - - // Support: IE <=9 - 11 only - // Use typeof to avoid zero-argument method invocation on host objects (#15151) - var ret; - - if ( typeof context.getElementsByTagName !== "undefined" ) { - ret = context.getElementsByTagName( tag || "*" ); - - } else if ( typeof context.querySelectorAll !== "undefined" ) { - ret = context.querySelectorAll( tag || "*" ); - - } else { - ret = []; - } - - if ( tag === undefined || tag && nodeName( context, tag ) ) { - return jQuery.merge( [ context ], ret ); - } - - return ret; -} - - -// Mark scripts as having already been evaluated -function setGlobalEval( elems, refElements ) { - var i = 0, - l = elems.length; - - for ( ; i < l; i++ ) { - dataPriv.set( - elems[ i ], - "globalEval", - !refElements || dataPriv.get( refElements[ i ], "globalEval" ) - ); - } -} - - -var rhtml = /<|&#?\w+;/; - -function buildFragment( elems, context, scripts, selection, ignored ) { - var elem, tmp, tag, wrap, attached, j, - fragment = context.createDocumentFragment(), - nodes = [], - i = 0, - l = elems.length; - - for ( ; i < l; i++ ) { - elem = elems[ i ]; - - if ( elem || elem === 0 ) { - - // Add nodes directly - if ( toType( elem ) === "object" ) { - - // Support: Android <=4.0 only, PhantomJS 1 only - // push.apply(_, arraylike) throws on ancient WebKit - jQuery.merge( nodes, elem.nodeType ? [ elem ] : elem ); - - // Convert non-html into a text node - } else if ( !rhtml.test( elem ) ) { - nodes.push( context.createTextNode( elem ) ); - - // Convert html into DOM nodes - } else { - tmp = tmp || fragment.appendChild( context.createElement( "div" ) ); - - // Deserialize a standard representation - tag = ( rtagName.exec( elem ) || [ "", "" ] )[ 1 ].toLowerCase(); - wrap = wrapMap[ tag ] || wrapMap._default; - tmp.innerHTML = wrap[ 1 ] + jQuery.htmlPrefilter( elem ) + wrap[ 2 ]; - - // Descend through wrappers to the right content - j = wrap[ 0 ]; - while ( j-- ) { - tmp = tmp.lastChild; - } - - // Support: Android <=4.0 only, PhantomJS 1 only - // push.apply(_, arraylike) throws on ancient WebKit - jQuery.merge( nodes, tmp.childNodes ); - - // Remember the top-level container - tmp = fragment.firstChild; - - // Ensure the created nodes are orphaned (#12392) - tmp.textContent = ""; - } - } - } - - // Remove wrapper from fragment - fragment.textContent = ""; - - i = 0; - while ( ( elem = nodes[ i++ ] ) ) { - - // Skip elements already in the context collection (trac-4087) - if ( selection && jQuery.inArray( elem, selection ) > -1 ) { - if ( ignored ) { - ignored.push( elem ); - } - continue; - } - - attached = isAttached( elem ); - - // Append to fragment - tmp = getAll( fragment.appendChild( elem ), "script" ); - - // Preserve script evaluation history - if ( attached ) { - setGlobalEval( tmp ); - } - - // Capture executables - if ( scripts ) { - j = 0; - while ( ( elem = tmp[ j++ ] ) ) { - if ( rscriptType.test( elem.type || "" ) ) { - scripts.push( elem ); - } - } - } - } - - return fragment; -} - - -var rtypenamespace = /^([^.]*)(?:\.(.+)|)/; - -function returnTrue() { - return true; -} - -function returnFalse() { - return false; -} - -// Support: IE <=9 - 11+ -// focus() and blur() are asynchronous, except when they are no-op. -// So expect focus to be synchronous when the element is already active, -// and blur to be synchronous when the element is not already active. -// (focus and blur are always synchronous in other supported browsers, -// this just defines when we can count on it). -function expectSync( elem, type ) { - return ( elem === safeActiveElement() ) === ( type === "focus" ); -} - -// Support: IE <=9 only -// Accessing document.activeElement can throw unexpectedly -// https://bugs.jquery.com/ticket/13393 -function safeActiveElement() { - try { - return document.activeElement; - } catch ( err ) { } -} - -function on( elem, types, selector, data, fn, one ) { - var origFn, type; - - // Types can be a map of types/handlers - if ( typeof types === "object" ) { - - // ( types-Object, selector, data ) - if ( typeof selector !== "string" ) { - - // ( types-Object, data ) - data = data || selector; - selector = undefined; - } - for ( type in types ) { - on( elem, type, selector, data, types[ type ], one ); - } - return elem; - } - - if ( data == null && fn == null ) { - - // ( types, fn ) - fn = selector; - data = selector = undefined; - } else if ( fn == null ) { - if ( typeof selector === "string" ) { - - // ( types, selector, fn ) - fn = data; - data = undefined; - } else { - - // ( types, data, fn ) - fn = data; - data = selector; - selector = undefined; - } - } - if ( fn === false ) { - fn = returnFalse; - } else if ( !fn ) { - return elem; - } - - if ( one === 1 ) { - origFn = fn; - fn = function( event ) { - - // Can use an empty set, since event contains the info - jQuery().off( event ); - return origFn.apply( this, arguments ); - }; - - // Use same guid so caller can remove using origFn - fn.guid = origFn.guid || ( origFn.guid = jQuery.guid++ ); - } - return elem.each( function() { - jQuery.event.add( this, types, fn, data, selector ); - } ); -} - -/* - * Helper functions for managing events -- not part of the public interface. - * Props to Dean Edwards' addEvent library for many of the ideas. - */ -jQuery.event = { - - global: {}, - - add: function( elem, types, handler, data, selector ) { - - var handleObjIn, eventHandle, tmp, - events, t, handleObj, - special, handlers, type, namespaces, origType, - elemData = dataPriv.get( elem ); - - // Only attach events to objects that accept data - if ( !acceptData( elem ) ) { - return; - } - - // Caller can pass in an object of custom data in lieu of the handler - if ( handler.handler ) { - handleObjIn = handler; - handler = handleObjIn.handler; - selector = handleObjIn.selector; - } - - // Ensure that invalid selectors throw exceptions at attach time - // Evaluate against documentElement in case elem is a non-element node (e.g., document) - if ( selector ) { - jQuery.find.matchesSelector( documentElement, selector ); - } - - // Make sure that the handler has a unique ID, used to find/remove it later - if ( !handler.guid ) { - handler.guid = jQuery.guid++; - } - - // Init the element's event structure and main handler, if this is the first - if ( !( events = elemData.events ) ) { - events = elemData.events = Object.create( null ); - } - if ( !( eventHandle = elemData.handle ) ) { - eventHandle = elemData.handle = function( e ) { - - // Discard the second event of a jQuery.event.trigger() and - // when an event is called after a page has unloaded - return typeof jQuery !== "undefined" && jQuery.event.triggered !== e.type ? - jQuery.event.dispatch.apply( elem, arguments ) : undefined; - }; - } - - // Handle multiple events separated by a space - types = ( types || "" ).match( rnothtmlwhite ) || [ "" ]; - t = types.length; - while ( t-- ) { - tmp = rtypenamespace.exec( types[ t ] ) || []; - type = origType = tmp[ 1 ]; - namespaces = ( tmp[ 2 ] || "" ).split( "." ).sort(); - - // There *must* be a type, no attaching namespace-only handlers - if ( !type ) { - continue; - } - - // If event changes its type, use the special event handlers for the changed type - special = jQuery.event.special[ type ] || {}; - - // If selector defined, determine special event api type, otherwise given type - type = ( selector ? special.delegateType : special.bindType ) || type; - - // Update special based on newly reset type - special = jQuery.event.special[ type ] || {}; - - // handleObj is passed to all event handlers - handleObj = jQuery.extend( { - type: type, - origType: origType, - data: data, - handler: handler, - guid: handler.guid, - selector: selector, - needsContext: selector && jQuery.expr.match.needsContext.test( selector ), - namespace: namespaces.join( "." ) - }, handleObjIn ); - - // Init the event handler queue if we're the first - if ( !( handlers = events[ type ] ) ) { - handlers = events[ type ] = []; - handlers.delegateCount = 0; - - // Only use addEventListener if the special events handler returns false - if ( !special.setup || - special.setup.call( elem, data, namespaces, eventHandle ) === false ) { - - if ( elem.addEventListener ) { - elem.addEventListener( type, eventHandle ); - } - } - } - - if ( special.add ) { - special.add.call( elem, handleObj ); - - if ( !handleObj.handler.guid ) { - handleObj.handler.guid = handler.guid; - } - } - - // Add to the element's handler list, delegates in front - if ( selector ) { - handlers.splice( handlers.delegateCount++, 0, handleObj ); - } else { - handlers.push( handleObj ); - } - - // Keep track of which events have ever been used, for event optimization - jQuery.event.global[ type ] = true; - } - - }, - - // Detach an event or set of events from an element - remove: function( elem, types, handler, selector, mappedTypes ) { - - var j, origCount, tmp, - events, t, handleObj, - special, handlers, type, namespaces, origType, - elemData = dataPriv.hasData( elem ) && dataPriv.get( elem ); - - if ( !elemData || !( events = elemData.events ) ) { - return; - } - - // Once for each type.namespace in types; type may be omitted - types = ( types || "" ).match( rnothtmlwhite ) || [ "" ]; - t = types.length; - while ( t-- ) { - tmp = rtypenamespace.exec( types[ t ] ) || []; - type = origType = tmp[ 1 ]; - namespaces = ( tmp[ 2 ] || "" ).split( "." ).sort(); - - // Unbind all events (on this namespace, if provided) for the element - if ( !type ) { - for ( type in events ) { - jQuery.event.remove( elem, type + types[ t ], handler, selector, true ); - } - continue; - } - - special = jQuery.event.special[ type ] || {}; - type = ( selector ? special.delegateType : special.bindType ) || type; - handlers = events[ type ] || []; - tmp = tmp[ 2 ] && - new RegExp( "(^|\\.)" + namespaces.join( "\\.(?:.*\\.|)" ) + "(\\.|$)" ); - - // Remove matching events - origCount = j = handlers.length; - while ( j-- ) { - handleObj = handlers[ j ]; - - if ( ( mappedTypes || origType === handleObj.origType ) && - ( !handler || handler.guid === handleObj.guid ) && - ( !tmp || tmp.test( handleObj.namespace ) ) && - ( !selector || selector === handleObj.selector || - selector === "**" && handleObj.selector ) ) { - handlers.splice( j, 1 ); - - if ( handleObj.selector ) { - handlers.delegateCount--; - } - if ( special.remove ) { - special.remove.call( elem, handleObj ); - } - } - } - - // Remove generic event handler if we removed something and no more handlers exist - // (avoids potential for endless recursion during removal of special event handlers) - if ( origCount && !handlers.length ) { - if ( !special.teardown || - special.teardown.call( elem, namespaces, elemData.handle ) === false ) { - - jQuery.removeEvent( elem, type, elemData.handle ); - } - - delete events[ type ]; - } - } - - // Remove data and the expando if it's no longer used - if ( jQuery.isEmptyObject( events ) ) { - dataPriv.remove( elem, "handle events" ); - } - }, - - dispatch: function( nativeEvent ) { - - var i, j, ret, matched, handleObj, handlerQueue, - args = new Array( arguments.length ), - - // Make a writable jQuery.Event from the native event object - event = jQuery.event.fix( nativeEvent ), - - handlers = ( - dataPriv.get( this, "events" ) || Object.create( null ) - )[ event.type ] || [], - special = jQuery.event.special[ event.type ] || {}; - - // Use the fix-ed jQuery.Event rather than the (read-only) native event - args[ 0 ] = event; - - for ( i = 1; i < arguments.length; i++ ) { - args[ i ] = arguments[ i ]; - } - - event.delegateTarget = this; - - // Call the preDispatch hook for the mapped type, and let it bail if desired - if ( special.preDispatch && special.preDispatch.call( this, event ) === false ) { - return; - } - - // Determine handlers - handlerQueue = jQuery.event.handlers.call( this, event, handlers ); - - // Run delegates first; they may want to stop propagation beneath us - i = 0; - while ( ( matched = handlerQueue[ i++ ] ) && !event.isPropagationStopped() ) { - event.currentTarget = matched.elem; - - j = 0; - while ( ( handleObj = matched.handlers[ j++ ] ) && - !event.isImmediatePropagationStopped() ) { - - // If the event is namespaced, then each handler is only invoked if it is - // specially universal or its namespaces are a superset of the event's. - if ( !event.rnamespace || handleObj.namespace === false || - event.rnamespace.test( handleObj.namespace ) ) { - - event.handleObj = handleObj; - event.data = handleObj.data; - - ret = ( ( jQuery.event.special[ handleObj.origType ] || {} ).handle || - handleObj.handler ).apply( matched.elem, args ); - - if ( ret !== undefined ) { - if ( ( event.result = ret ) === false ) { - event.preventDefault(); - event.stopPropagation(); - } - } - } - } - } - - // Call the postDispatch hook for the mapped type - if ( special.postDispatch ) { - special.postDispatch.call( this, event ); - } - - return event.result; - }, - - handlers: function( event, handlers ) { - var i, handleObj, sel, matchedHandlers, matchedSelectors, - handlerQueue = [], - delegateCount = handlers.delegateCount, - cur = event.target; - - // Find delegate handlers - if ( delegateCount && - - // Support: IE <=9 - // Black-hole SVG instance trees (trac-13180) - cur.nodeType && - - // Support: Firefox <=42 - // Suppress spec-violating clicks indicating a non-primary pointer button (trac-3861) - // https://www.w3.org/TR/DOM-Level-3-Events/#event-type-click - // Support: IE 11 only - // ...but not arrow key "clicks" of radio inputs, which can have `button` -1 (gh-2343) - !( event.type === "click" && event.button >= 1 ) ) { - - for ( ; cur !== this; cur = cur.parentNode || this ) { - - // Don't check non-elements (#13208) - // Don't process clicks on disabled elements (#6911, #8165, #11382, #11764) - if ( cur.nodeType === 1 && !( event.type === "click" && cur.disabled === true ) ) { - matchedHandlers = []; - matchedSelectors = {}; - for ( i = 0; i < delegateCount; i++ ) { - handleObj = handlers[ i ]; - - // Don't conflict with Object.prototype properties (#13203) - sel = handleObj.selector + " "; - - if ( matchedSelectors[ sel ] === undefined ) { - matchedSelectors[ sel ] = handleObj.needsContext ? - jQuery( sel, this ).index( cur ) > -1 : - jQuery.find( sel, this, null, [ cur ] ).length; - } - if ( matchedSelectors[ sel ] ) { - matchedHandlers.push( handleObj ); - } - } - if ( matchedHandlers.length ) { - handlerQueue.push( { elem: cur, handlers: matchedHandlers } ); - } - } - } - } - - // Add the remaining (directly-bound) handlers - cur = this; - if ( delegateCount < handlers.length ) { - handlerQueue.push( { elem: cur, handlers: handlers.slice( delegateCount ) } ); - } - - return handlerQueue; - }, - - addProp: function( name, hook ) { - Object.defineProperty( jQuery.Event.prototype, name, { - enumerable: true, - configurable: true, - - get: isFunction( hook ) ? - function() { - if ( this.originalEvent ) { - return hook( this.originalEvent ); - } - } : - function() { - if ( this.originalEvent ) { - return this.originalEvent[ name ]; - } - }, - - set: function( value ) { - Object.defineProperty( this, name, { - enumerable: true, - configurable: true, - writable: true, - value: value - } ); - } - } ); - }, - - fix: function( originalEvent ) { - return originalEvent[ jQuery.expando ] ? - originalEvent : - new jQuery.Event( originalEvent ); - }, - - special: { - load: { - - // Prevent triggered image.load events from bubbling to window.load - noBubble: true - }, - click: { - - // Utilize native event to ensure correct state for checkable inputs - setup: function( data ) { - - // For mutual compressibility with _default, replace `this` access with a local var. - // `|| data` is dead code meant only to preserve the variable through minification. - var el = this || data; - - // Claim the first handler - if ( rcheckableType.test( el.type ) && - el.click && nodeName( el, "input" ) ) { - - // dataPriv.set( el, "click", ... ) - leverageNative( el, "click", returnTrue ); - } - - // Return false to allow normal processing in the caller - return false; - }, - trigger: function( data ) { - - // For mutual compressibility with _default, replace `this` access with a local var. - // `|| data` is dead code meant only to preserve the variable through minification. - var el = this || data; - - // Force setup before triggering a click - if ( rcheckableType.test( el.type ) && - el.click && nodeName( el, "input" ) ) { - - leverageNative( el, "click" ); - } - - // Return non-false to allow normal event-path propagation - return true; - }, - - // For cross-browser consistency, suppress native .click() on links - // Also prevent it if we're currently inside a leveraged native-event stack - _default: function( event ) { - var target = event.target; - return rcheckableType.test( target.type ) && - target.click && nodeName( target, "input" ) && - dataPriv.get( target, "click" ) || - nodeName( target, "a" ); - } - }, - - beforeunload: { - postDispatch: function( event ) { - - // Support: Firefox 20+ - // Firefox doesn't alert if the returnValue field is not set. - if ( event.result !== undefined && event.originalEvent ) { - event.originalEvent.returnValue = event.result; - } - } - } - } -}; - -// Ensure the presence of an event listener that handles manually-triggered -// synthetic events by interrupting progress until reinvoked in response to -// *native* events that it fires directly, ensuring that state changes have -// already occurred before other listeners are invoked. -function leverageNative( el, type, expectSync ) { - - // Missing expectSync indicates a trigger call, which must force setup through jQuery.event.add - if ( !expectSync ) { - if ( dataPriv.get( el, type ) === undefined ) { - jQuery.event.add( el, type, returnTrue ); - } - return; - } - - // Register the controller as a special universal handler for all event namespaces - dataPriv.set( el, type, false ); - jQuery.event.add( el, type, { - namespace: false, - handler: function( event ) { - var notAsync, result, - saved = dataPriv.get( this, type ); - - if ( ( event.isTrigger & 1 ) && this[ type ] ) { - - // Interrupt processing of the outer synthetic .trigger()ed event - // Saved data should be false in such cases, but might be a leftover capture object - // from an async native handler (gh-4350) - if ( !saved.length ) { - - // Store arguments for use when handling the inner native event - // There will always be at least one argument (an event object), so this array - // will not be confused with a leftover capture object. - saved = slice.call( arguments ); - dataPriv.set( this, type, saved ); - - // Trigger the native event and capture its result - // Support: IE <=9 - 11+ - // focus() and blur() are asynchronous - notAsync = expectSync( this, type ); - this[ type ](); - result = dataPriv.get( this, type ); - if ( saved !== result || notAsync ) { - dataPriv.set( this, type, false ); - } else { - result = {}; - } - if ( saved !== result ) { - - // Cancel the outer synthetic event - event.stopImmediatePropagation(); - event.preventDefault(); - - // Support: Chrome 86+ - // In Chrome, if an element having a focusout handler is blurred by - // clicking outside of it, it invokes the handler synchronously. If - // that handler calls `.remove()` on the element, the data is cleared, - // leaving `result` undefined. We need to guard against this. - return result && result.value; - } - - // If this is an inner synthetic event for an event with a bubbling surrogate - // (focus or blur), assume that the surrogate already propagated from triggering the - // native event and prevent that from happening again here. - // This technically gets the ordering wrong w.r.t. to `.trigger()` (in which the - // bubbling surrogate propagates *after* the non-bubbling base), but that seems - // less bad than duplication. - } else if ( ( jQuery.event.special[ type ] || {} ).delegateType ) { - event.stopPropagation(); - } - - // If this is a native event triggered above, everything is now in order - // Fire an inner synthetic event with the original arguments - } else if ( saved.length ) { - - // ...and capture the result - dataPriv.set( this, type, { - value: jQuery.event.trigger( - - // Support: IE <=9 - 11+ - // Extend with the prototype to reset the above stopImmediatePropagation() - jQuery.extend( saved[ 0 ], jQuery.Event.prototype ), - saved.slice( 1 ), - this - ) - } ); - - // Abort handling of the native event - event.stopImmediatePropagation(); - } - } - } ); -} - -jQuery.removeEvent = function( elem, type, handle ) { - - // This "if" is needed for plain objects - if ( elem.removeEventListener ) { - elem.removeEventListener( type, handle ); - } -}; - -jQuery.Event = function( src, props ) { - - // Allow instantiation without the 'new' keyword - if ( !( this instanceof jQuery.Event ) ) { - return new jQuery.Event( src, props ); - } - - // Event object - if ( src && src.type ) { - this.originalEvent = src; - this.type = src.type; - - // Events bubbling up the document may have been marked as prevented - // by a handler lower down the tree; reflect the correct value. - this.isDefaultPrevented = src.defaultPrevented || - src.defaultPrevented === undefined && - - // Support: Android <=2.3 only - src.returnValue === false ? - returnTrue : - returnFalse; - - // Create target properties - // Support: Safari <=6 - 7 only - // Target should not be a text node (#504, #13143) - this.target = ( src.target && src.target.nodeType === 3 ) ? - src.target.parentNode : - src.target; - - this.currentTarget = src.currentTarget; - this.relatedTarget = src.relatedTarget; - - // Event type - } else { - this.type = src; - } - - // Put explicitly provided properties onto the event object - if ( props ) { - jQuery.extend( this, props ); - } - - // Create a timestamp if incoming event doesn't have one - this.timeStamp = src && src.timeStamp || Date.now(); - - // Mark it as fixed - this[ jQuery.expando ] = true; -}; - -// jQuery.Event is based on DOM3 Events as specified by the ECMAScript Language Binding -// https://www.w3.org/TR/2003/WD-DOM-Level-3-Events-20030331/ecma-script-binding.html -jQuery.Event.prototype = { - constructor: jQuery.Event, - isDefaultPrevented: returnFalse, - isPropagationStopped: returnFalse, - isImmediatePropagationStopped: returnFalse, - isSimulated: false, - - preventDefault: function() { - var e = this.originalEvent; - - this.isDefaultPrevented = returnTrue; - - if ( e && !this.isSimulated ) { - e.preventDefault(); - } - }, - stopPropagation: function() { - var e = this.originalEvent; - - this.isPropagationStopped = returnTrue; - - if ( e && !this.isSimulated ) { - e.stopPropagation(); - } - }, - stopImmediatePropagation: function() { - var e = this.originalEvent; - - this.isImmediatePropagationStopped = returnTrue; - - if ( e && !this.isSimulated ) { - e.stopImmediatePropagation(); - } - - this.stopPropagation(); - } -}; - -// Includes all common event props including KeyEvent and MouseEvent specific props -jQuery.each( { - altKey: true, - bubbles: true, - cancelable: true, - changedTouches: true, - ctrlKey: true, - detail: true, - eventPhase: true, - metaKey: true, - pageX: true, - pageY: true, - shiftKey: true, - view: true, - "char": true, - code: true, - charCode: true, - key: true, - keyCode: true, - button: true, - buttons: true, - clientX: true, - clientY: true, - offsetX: true, - offsetY: true, - pointerId: true, - pointerType: true, - screenX: true, - screenY: true, - targetTouches: true, - toElement: true, - touches: true, - which: true -}, jQuery.event.addProp ); - -jQuery.each( { focus: "focusin", blur: "focusout" }, function( type, delegateType ) { - jQuery.event.special[ type ] = { - - // Utilize native event if possible so blur/focus sequence is correct - setup: function() { - - // Claim the first handler - // dataPriv.set( this, "focus", ... ) - // dataPriv.set( this, "blur", ... ) - leverageNative( this, type, expectSync ); - - // Return false to allow normal processing in the caller - return false; - }, - trigger: function() { - - // Force setup before trigger - leverageNative( this, type ); - - // Return non-false to allow normal event-path propagation - return true; - }, - - // Suppress native focus or blur as it's already being fired - // in leverageNative. - _default: function() { - return true; - }, - - delegateType: delegateType - }; -} ); - -// Create mouseenter/leave events using mouseover/out and event-time checks -// so that event delegation works in jQuery. -// Do the same for pointerenter/pointerleave and pointerover/pointerout -// -// Support: Safari 7 only -// Safari sends mouseenter too often; see: -// https://bugs.chromium.org/p/chromium/issues/detail?id=470258 -// for the description of the bug (it existed in older Chrome versions as well). -jQuery.each( { - mouseenter: "mouseover", - mouseleave: "mouseout", - pointerenter: "pointerover", - pointerleave: "pointerout" -}, function( orig, fix ) { - jQuery.event.special[ orig ] = { - delegateType: fix, - bindType: fix, - - handle: function( event ) { - var ret, - target = this, - related = event.relatedTarget, - handleObj = event.handleObj; - - // For mouseenter/leave call the handler if related is outside the target. - // NB: No relatedTarget if the mouse left/entered the browser window - if ( !related || ( related !== target && !jQuery.contains( target, related ) ) ) { - event.type = handleObj.origType; - ret = handleObj.handler.apply( this, arguments ); - event.type = fix; - } - return ret; - } - }; -} ); - -jQuery.fn.extend( { - - on: function( types, selector, data, fn ) { - return on( this, types, selector, data, fn ); - }, - one: function( types, selector, data, fn ) { - return on( this, types, selector, data, fn, 1 ); - }, - off: function( types, selector, fn ) { - var handleObj, type; - if ( types && types.preventDefault && types.handleObj ) { - - // ( event ) dispatched jQuery.Event - handleObj = types.handleObj; - jQuery( types.delegateTarget ).off( - handleObj.namespace ? - handleObj.origType + "." + handleObj.namespace : - handleObj.origType, - handleObj.selector, - handleObj.handler - ); - return this; - } - if ( typeof types === "object" ) { - - // ( types-object [, selector] ) - for ( type in types ) { - this.off( type, selector, types[ type ] ); - } - return this; - } - if ( selector === false || typeof selector === "function" ) { - - // ( types [, fn] ) - fn = selector; - selector = undefined; - } - if ( fn === false ) { - fn = returnFalse; - } - return this.each( function() { - jQuery.event.remove( this, types, fn, selector ); - } ); - } -} ); - - -var - - // Support: IE <=10 - 11, Edge 12 - 13 only - // In IE/Edge using regex groups here causes severe slowdowns. - // See https://connect.microsoft.com/IE/feedback/details/1736512/ - rnoInnerhtml = /\s*$/g; - -// Prefer a tbody over its parent table for containing new rows -function manipulationTarget( elem, content ) { - if ( nodeName( elem, "table" ) && - nodeName( content.nodeType !== 11 ? content : content.firstChild, "tr" ) ) { - - return jQuery( elem ).children( "tbody" )[ 0 ] || elem; - } - - return elem; -} - -// Replace/restore the type attribute of script elements for safe DOM manipulation -function disableScript( elem ) { - elem.type = ( elem.getAttribute( "type" ) !== null ) + "/" + elem.type; - return elem; -} -function restoreScript( elem ) { - if ( ( elem.type || "" ).slice( 0, 5 ) === "true/" ) { - elem.type = elem.type.slice( 5 ); - } else { - elem.removeAttribute( "type" ); - } - - return elem; -} - -function cloneCopyEvent( src, dest ) { - var i, l, type, pdataOld, udataOld, udataCur, events; - - if ( dest.nodeType !== 1 ) { - return; - } - - // 1. Copy private data: events, handlers, etc. - if ( dataPriv.hasData( src ) ) { - pdataOld = dataPriv.get( src ); - events = pdataOld.events; - - if ( events ) { - dataPriv.remove( dest, "handle events" ); - - for ( type in events ) { - for ( i = 0, l = events[ type ].length; i < l; i++ ) { - jQuery.event.add( dest, type, events[ type ][ i ] ); - } - } - } - } - - // 2. Copy user data - if ( dataUser.hasData( src ) ) { - udataOld = dataUser.access( src ); - udataCur = jQuery.extend( {}, udataOld ); - - dataUser.set( dest, udataCur ); - } -} - -// Fix IE bugs, see support tests -function fixInput( src, dest ) { - var nodeName = dest.nodeName.toLowerCase(); - - // Fails to persist the checked state of a cloned checkbox or radio button. - if ( nodeName === "input" && rcheckableType.test( src.type ) ) { - dest.checked = src.checked; - - // Fails to return the selected option to the default selected state when cloning options - } else if ( nodeName === "input" || nodeName === "textarea" ) { - dest.defaultValue = src.defaultValue; - } -} - -function domManip( collection, args, callback, ignored ) { - - // Flatten any nested arrays - args = flat( args ); - - var fragment, first, scripts, hasScripts, node, doc, - i = 0, - l = collection.length, - iNoClone = l - 1, - value = args[ 0 ], - valueIsFunction = isFunction( value ); - - // We can't cloneNode fragments that contain checked, in WebKit - if ( valueIsFunction || - ( l > 1 && typeof value === "string" && - !support.checkClone && rchecked.test( value ) ) ) { - return collection.each( function( index ) { - var self = collection.eq( index ); - if ( valueIsFunction ) { - args[ 0 ] = value.call( this, index, self.html() ); - } - domManip( self, args, callback, ignored ); - } ); - } - - if ( l ) { - fragment = buildFragment( args, collection[ 0 ].ownerDocument, false, collection, ignored ); - first = fragment.firstChild; - - if ( fragment.childNodes.length === 1 ) { - fragment = first; - } - - // Require either new content or an interest in ignored elements to invoke the callback - if ( first || ignored ) { - scripts = jQuery.map( getAll( fragment, "script" ), disableScript ); - hasScripts = scripts.length; - - // Use the original fragment for the last item - // instead of the first because it can end up - // being emptied incorrectly in certain situations (#8070). - for ( ; i < l; i++ ) { - node = fragment; - - if ( i !== iNoClone ) { - node = jQuery.clone( node, true, true ); - - // Keep references to cloned scripts for later restoration - if ( hasScripts ) { - - // Support: Android <=4.0 only, PhantomJS 1 only - // push.apply(_, arraylike) throws on ancient WebKit - jQuery.merge( scripts, getAll( node, "script" ) ); - } - } - - callback.call( collection[ i ], node, i ); - } - - if ( hasScripts ) { - doc = scripts[ scripts.length - 1 ].ownerDocument; - - // Reenable scripts - jQuery.map( scripts, restoreScript ); - - // Evaluate executable scripts on first document insertion - for ( i = 0; i < hasScripts; i++ ) { - node = scripts[ i ]; - if ( rscriptType.test( node.type || "" ) && - !dataPriv.access( node, "globalEval" ) && - jQuery.contains( doc, node ) ) { - - if ( node.src && ( node.type || "" ).toLowerCase() !== "module" ) { - - // Optional AJAX dependency, but won't run scripts if not present - if ( jQuery._evalUrl && !node.noModule ) { - jQuery._evalUrl( node.src, { - nonce: node.nonce || node.getAttribute( "nonce" ) - }, doc ); - } - } else { - DOMEval( node.textContent.replace( rcleanScript, "" ), node, doc ); - } - } - } - } - } - } - - return collection; -} - -function remove( elem, selector, keepData ) { - var node, - nodes = selector ? jQuery.filter( selector, elem ) : elem, - i = 0; - - for ( ; ( node = nodes[ i ] ) != null; i++ ) { - if ( !keepData && node.nodeType === 1 ) { - jQuery.cleanData( getAll( node ) ); - } - - if ( node.parentNode ) { - if ( keepData && isAttached( node ) ) { - setGlobalEval( getAll( node, "script" ) ); - } - node.parentNode.removeChild( node ); - } - } - - return elem; -} - -jQuery.extend( { - htmlPrefilter: function( html ) { - return html; - }, - - clone: function( elem, dataAndEvents, deepDataAndEvents ) { - var i, l, srcElements, destElements, - clone = elem.cloneNode( true ), - inPage = isAttached( elem ); - - // Fix IE cloning issues - if ( !support.noCloneChecked && ( elem.nodeType === 1 || elem.nodeType === 11 ) && - !jQuery.isXMLDoc( elem ) ) { - - // We eschew Sizzle here for performance reasons: https://jsperf.com/getall-vs-sizzle/2 - destElements = getAll( clone ); - srcElements = getAll( elem ); - - for ( i = 0, l = srcElements.length; i < l; i++ ) { - fixInput( srcElements[ i ], destElements[ i ] ); - } - } - - // Copy the events from the original to the clone - if ( dataAndEvents ) { - if ( deepDataAndEvents ) { - srcElements = srcElements || getAll( elem ); - destElements = destElements || getAll( clone ); - - for ( i = 0, l = srcElements.length; i < l; i++ ) { - cloneCopyEvent( srcElements[ i ], destElements[ i ] ); - } - } else { - cloneCopyEvent( elem, clone ); - } - } - - // Preserve script evaluation history - destElements = getAll( clone, "script" ); - if ( destElements.length > 0 ) { - setGlobalEval( destElements, !inPage && getAll( elem, "script" ) ); - } - - // Return the cloned set - return clone; - }, - - cleanData: function( elems ) { - var data, elem, type, - special = jQuery.event.special, - i = 0; - - for ( ; ( elem = elems[ i ] ) !== undefined; i++ ) { - if ( acceptData( elem ) ) { - if ( ( data = elem[ dataPriv.expando ] ) ) { - if ( data.events ) { - for ( type in data.events ) { - if ( special[ type ] ) { - jQuery.event.remove( elem, type ); - - // This is a shortcut to avoid jQuery.event.remove's overhead - } else { - jQuery.removeEvent( elem, type, data.handle ); - } - } - } - - // Support: Chrome <=35 - 45+ - // Assign undefined instead of using delete, see Data#remove - elem[ dataPriv.expando ] = undefined; - } - if ( elem[ dataUser.expando ] ) { - - // Support: Chrome <=35 - 45+ - // Assign undefined instead of using delete, see Data#remove - elem[ dataUser.expando ] = undefined; - } - } - } - } -} ); - -jQuery.fn.extend( { - detach: function( selector ) { - return remove( this, selector, true ); - }, - - remove: function( selector ) { - return remove( this, selector ); - }, - - text: function( value ) { - return access( this, function( value ) { - return value === undefined ? - jQuery.text( this ) : - this.empty().each( function() { - if ( this.nodeType === 1 || this.nodeType === 11 || this.nodeType === 9 ) { - this.textContent = value; - } - } ); - }, null, value, arguments.length ); - }, - - append: function() { - return domManip( this, arguments, function( elem ) { - if ( this.nodeType === 1 || this.nodeType === 11 || this.nodeType === 9 ) { - var target = manipulationTarget( this, elem ); - target.appendChild( elem ); - } - } ); - }, - - prepend: function() { - return domManip( this, arguments, function( elem ) { - if ( this.nodeType === 1 || this.nodeType === 11 || this.nodeType === 9 ) { - var target = manipulationTarget( this, elem ); - target.insertBefore( elem, target.firstChild ); - } - } ); - }, - - before: function() { - return domManip( this, arguments, function( elem ) { - if ( this.parentNode ) { - this.parentNode.insertBefore( elem, this ); - } - } ); - }, - - after: function() { - return domManip( this, arguments, function( elem ) { - if ( this.parentNode ) { - this.parentNode.insertBefore( elem, this.nextSibling ); - } - } ); - }, - - empty: function() { - var elem, - i = 0; - - for ( ; ( elem = this[ i ] ) != null; i++ ) { - if ( elem.nodeType === 1 ) { - - // Prevent memory leaks - jQuery.cleanData( getAll( elem, false ) ); - - // Remove any remaining nodes - elem.textContent = ""; - } - } - - return this; - }, - - clone: function( dataAndEvents, deepDataAndEvents ) { - dataAndEvents = dataAndEvents == null ? false : dataAndEvents; - deepDataAndEvents = deepDataAndEvents == null ? dataAndEvents : deepDataAndEvents; - - return this.map( function() { - return jQuery.clone( this, dataAndEvents, deepDataAndEvents ); - } ); - }, - - html: function( value ) { - return access( this, function( value ) { - var elem = this[ 0 ] || {}, - i = 0, - l = this.length; - - if ( value === undefined && elem.nodeType === 1 ) { - return elem.innerHTML; - } - - // See if we can take a shortcut and just use innerHTML - if ( typeof value === "string" && !rnoInnerhtml.test( value ) && - !wrapMap[ ( rtagName.exec( value ) || [ "", "" ] )[ 1 ].toLowerCase() ] ) { - - value = jQuery.htmlPrefilter( value ); - - try { - for ( ; i < l; i++ ) { - elem = this[ i ] || {}; - - // Remove element nodes and prevent memory leaks - if ( elem.nodeType === 1 ) { - jQuery.cleanData( getAll( elem, false ) ); - elem.innerHTML = value; - } - } - - elem = 0; - - // If using innerHTML throws an exception, use the fallback method - } catch ( e ) {} - } - - if ( elem ) { - this.empty().append( value ); - } - }, null, value, arguments.length ); - }, - - replaceWith: function() { - var ignored = []; - - // Make the changes, replacing each non-ignored context element with the new content - return domManip( this, arguments, function( elem ) { - var parent = this.parentNode; - - if ( jQuery.inArray( this, ignored ) < 0 ) { - jQuery.cleanData( getAll( this ) ); - if ( parent ) { - parent.replaceChild( elem, this ); - } - } - - // Force callback invocation - }, ignored ); - } -} ); - -jQuery.each( { - appendTo: "append", - prependTo: "prepend", - insertBefore: "before", - insertAfter: "after", - replaceAll: "replaceWith" -}, function( name, original ) { - jQuery.fn[ name ] = function( selector ) { - var elems, - ret = [], - insert = jQuery( selector ), - last = insert.length - 1, - i = 0; - - for ( ; i <= last; i++ ) { - elems = i === last ? this : this.clone( true ); - jQuery( insert[ i ] )[ original ]( elems ); - - // Support: Android <=4.0 only, PhantomJS 1 only - // .get() because push.apply(_, arraylike) throws on ancient WebKit - push.apply( ret, elems.get() ); - } - - return this.pushStack( ret ); - }; -} ); -var rnumnonpx = new RegExp( "^(" + pnum + ")(?!px)[a-z%]+$", "i" ); - -var getStyles = function( elem ) { - - // Support: IE <=11 only, Firefox <=30 (#15098, #14150) - // IE throws on elements created in popups - // FF meanwhile throws on frame elements through "defaultView.getComputedStyle" - var view = elem.ownerDocument.defaultView; - - if ( !view || !view.opener ) { - view = window; - } - - return view.getComputedStyle( elem ); - }; - -var swap = function( elem, options, callback ) { - var ret, name, - old = {}; - - // Remember the old values, and insert the new ones - for ( name in options ) { - old[ name ] = elem.style[ name ]; - elem.style[ name ] = options[ name ]; - } - - ret = callback.call( elem ); - - // Revert the old values - for ( name in options ) { - elem.style[ name ] = old[ name ]; - } - - return ret; -}; - - -var rboxStyle = new RegExp( cssExpand.join( "|" ), "i" ); - - - -( function() { - - // Executing both pixelPosition & boxSizingReliable tests require only one layout - // so they're executed at the same time to save the second computation. - function computeStyleTests() { - - // This is a singleton, we need to execute it only once - if ( !div ) { - return; - } - - container.style.cssText = "position:absolute;left:-11111px;width:60px;" + - "margin-top:1px;padding:0;border:0"; - div.style.cssText = - "position:relative;display:block;box-sizing:border-box;overflow:scroll;" + - "margin:auto;border:1px;padding:1px;" + - "width:60%;top:1%"; - documentElement.appendChild( container ).appendChild( div ); - - var divStyle = window.getComputedStyle( div ); - pixelPositionVal = divStyle.top !== "1%"; - - // Support: Android 4.0 - 4.3 only, Firefox <=3 - 44 - reliableMarginLeftVal = roundPixelMeasures( divStyle.marginLeft ) === 12; - - // Support: Android 4.0 - 4.3 only, Safari <=9.1 - 10.1, iOS <=7.0 - 9.3 - // Some styles come back with percentage values, even though they shouldn't - div.style.right = "60%"; - pixelBoxStylesVal = roundPixelMeasures( divStyle.right ) === 36; - - // Support: IE 9 - 11 only - // Detect misreporting of content dimensions for box-sizing:border-box elements - boxSizingReliableVal = roundPixelMeasures( divStyle.width ) === 36; - - // Support: IE 9 only - // Detect overflow:scroll screwiness (gh-3699) - // Support: Chrome <=64 - // Don't get tricked when zoom affects offsetWidth (gh-4029) - div.style.position = "absolute"; - scrollboxSizeVal = roundPixelMeasures( div.offsetWidth / 3 ) === 12; - - documentElement.removeChild( container ); - - // Nullify the div so it wouldn't be stored in the memory and - // it will also be a sign that checks already performed - div = null; - } - - function roundPixelMeasures( measure ) { - return Math.round( parseFloat( measure ) ); - } - - var pixelPositionVal, boxSizingReliableVal, scrollboxSizeVal, pixelBoxStylesVal, - reliableTrDimensionsVal, reliableMarginLeftVal, - container = document.createElement( "div" ), - div = document.createElement( "div" ); - - // Finish early in limited (non-browser) environments - if ( !div.style ) { - return; - } - - // Support: IE <=9 - 11 only - // Style of cloned element affects source element cloned (#8908) - div.style.backgroundClip = "content-box"; - div.cloneNode( true ).style.backgroundClip = ""; - support.clearCloneStyle = div.style.backgroundClip === "content-box"; - - jQuery.extend( support, { - boxSizingReliable: function() { - computeStyleTests(); - return boxSizingReliableVal; - }, - pixelBoxStyles: function() { - computeStyleTests(); - return pixelBoxStylesVal; - }, - pixelPosition: function() { - computeStyleTests(); - return pixelPositionVal; - }, - reliableMarginLeft: function() { - computeStyleTests(); - return reliableMarginLeftVal; - }, - scrollboxSize: function() { - computeStyleTests(); - return scrollboxSizeVal; - }, - - // Support: IE 9 - 11+, Edge 15 - 18+ - // IE/Edge misreport `getComputedStyle` of table rows with width/height - // set in CSS while `offset*` properties report correct values. - // Behavior in IE 9 is more subtle than in newer versions & it passes - // some versions of this test; make sure not to make it pass there! - // - // Support: Firefox 70+ - // Only Firefox includes border widths - // in computed dimensions. (gh-4529) - reliableTrDimensions: function() { - var table, tr, trChild, trStyle; - if ( reliableTrDimensionsVal == null ) { - table = document.createElement( "table" ); - tr = document.createElement( "tr" ); - trChild = document.createElement( "div" ); - - table.style.cssText = "position:absolute;left:-11111px;border-collapse:separate"; - tr.style.cssText = "border:1px solid"; - - // Support: Chrome 86+ - // Height set through cssText does not get applied. - // Computed height then comes back as 0. - tr.style.height = "1px"; - trChild.style.height = "9px"; - - // Support: Android 8 Chrome 86+ - // In our bodyBackground.html iframe, - // display for all div elements is set to "inline", - // which causes a problem only in Android 8 Chrome 86. - // Ensuring the div is display: block - // gets around this issue. - trChild.style.display = "block"; - - documentElement - .appendChild( table ) - .appendChild( tr ) - .appendChild( trChild ); - - trStyle = window.getComputedStyle( tr ); - reliableTrDimensionsVal = ( parseInt( trStyle.height, 10 ) + - parseInt( trStyle.borderTopWidth, 10 ) + - parseInt( trStyle.borderBottomWidth, 10 ) ) === tr.offsetHeight; - - documentElement.removeChild( table ); - } - return reliableTrDimensionsVal; - } - } ); -} )(); - - -function curCSS( elem, name, computed ) { - var width, minWidth, maxWidth, ret, - - // Support: Firefox 51+ - // Retrieving style before computed somehow - // fixes an issue with getting wrong values - // on detached elements - style = elem.style; - - computed = computed || getStyles( elem ); - - // getPropertyValue is needed for: - // .css('filter') (IE 9 only, #12537) - // .css('--customProperty) (#3144) - if ( computed ) { - ret = computed.getPropertyValue( name ) || computed[ name ]; - - if ( ret === "" && !isAttached( elem ) ) { - ret = jQuery.style( elem, name ); - } - - // A tribute to the "awesome hack by Dean Edwards" - // Android Browser returns percentage for some values, - // but width seems to be reliably pixels. - // This is against the CSSOM draft spec: - // https://drafts.csswg.org/cssom/#resolved-values - if ( !support.pixelBoxStyles() && rnumnonpx.test( ret ) && rboxStyle.test( name ) ) { - - // Remember the original values - width = style.width; - minWidth = style.minWidth; - maxWidth = style.maxWidth; - - // Put in the new values to get a computed value out - style.minWidth = style.maxWidth = style.width = ret; - ret = computed.width; - - // Revert the changed values - style.width = width; - style.minWidth = minWidth; - style.maxWidth = maxWidth; - } - } - - return ret !== undefined ? - - // Support: IE <=9 - 11 only - // IE returns zIndex value as an integer. - ret + "" : - ret; -} - - -function addGetHookIf( conditionFn, hookFn ) { - - // Define the hook, we'll check on the first run if it's really needed. - return { - get: function() { - if ( conditionFn() ) { - - // Hook not needed (or it's not possible to use it due - // to missing dependency), remove it. - delete this.get; - return; - } - - // Hook needed; redefine it so that the support test is not executed again. - return ( this.get = hookFn ).apply( this, arguments ); - } - }; -} - - -var cssPrefixes = [ "Webkit", "Moz", "ms" ], - emptyStyle = document.createElement( "div" ).style, - vendorProps = {}; - -// Return a vendor-prefixed property or undefined -function vendorPropName( name ) { - - // Check for vendor prefixed names - var capName = name[ 0 ].toUpperCase() + name.slice( 1 ), - i = cssPrefixes.length; - - while ( i-- ) { - name = cssPrefixes[ i ] + capName; - if ( name in emptyStyle ) { - return name; - } - } -} - -// Return a potentially-mapped jQuery.cssProps or vendor prefixed property -function finalPropName( name ) { - var final = jQuery.cssProps[ name ] || vendorProps[ name ]; - - if ( final ) { - return final; - } - if ( name in emptyStyle ) { - return name; - } - return vendorProps[ name ] = vendorPropName( name ) || name; -} - - -var - - // Swappable if display is none or starts with table - // except "table", "table-cell", or "table-caption" - // See here for display values: https://developer.mozilla.org/en-US/docs/CSS/display - rdisplayswap = /^(none|table(?!-c[ea]).+)/, - rcustomProp = /^--/, - cssShow = { position: "absolute", visibility: "hidden", display: "block" }, - cssNormalTransform = { - letterSpacing: "0", - fontWeight: "400" - }; - -function setPositiveNumber( _elem, value, subtract ) { - - // Any relative (+/-) values have already been - // normalized at this point - var matches = rcssNum.exec( value ); - return matches ? - - // Guard against undefined "subtract", e.g., when used as in cssHooks - Math.max( 0, matches[ 2 ] - ( subtract || 0 ) ) + ( matches[ 3 ] || "px" ) : - value; -} - -function boxModelAdjustment( elem, dimension, box, isBorderBox, styles, computedVal ) { - var i = dimension === "width" ? 1 : 0, - extra = 0, - delta = 0; - - // Adjustment may not be necessary - if ( box === ( isBorderBox ? "border" : "content" ) ) { - return 0; - } - - for ( ; i < 4; i += 2 ) { - - // Both box models exclude margin - if ( box === "margin" ) { - delta += jQuery.css( elem, box + cssExpand[ i ], true, styles ); - } - - // If we get here with a content-box, we're seeking "padding" or "border" or "margin" - if ( !isBorderBox ) { - - // Add padding - delta += jQuery.css( elem, "padding" + cssExpand[ i ], true, styles ); - - // For "border" or "margin", add border - if ( box !== "padding" ) { - delta += jQuery.css( elem, "border" + cssExpand[ i ] + "Width", true, styles ); - - // But still keep track of it otherwise - } else { - extra += jQuery.css( elem, "border" + cssExpand[ i ] + "Width", true, styles ); - } - - // If we get here with a border-box (content + padding + border), we're seeking "content" or - // "padding" or "margin" - } else { - - // For "content", subtract padding - if ( box === "content" ) { - delta -= jQuery.css( elem, "padding" + cssExpand[ i ], true, styles ); - } - - // For "content" or "padding", subtract border - if ( box !== "margin" ) { - delta -= jQuery.css( elem, "border" + cssExpand[ i ] + "Width", true, styles ); - } - } - } - - // Account for positive content-box scroll gutter when requested by providing computedVal - if ( !isBorderBox && computedVal >= 0 ) { - - // offsetWidth/offsetHeight is a rounded sum of content, padding, scroll gutter, and border - // Assuming integer scroll gutter, subtract the rest and round down - delta += Math.max( 0, Math.ceil( - elem[ "offset" + dimension[ 0 ].toUpperCase() + dimension.slice( 1 ) ] - - computedVal - - delta - - extra - - 0.5 - - // If offsetWidth/offsetHeight is unknown, then we can't determine content-box scroll gutter - // Use an explicit zero to avoid NaN (gh-3964) - ) ) || 0; - } - - return delta; -} - -function getWidthOrHeight( elem, dimension, extra ) { - - // Start with computed style - var styles = getStyles( elem ), - - // To avoid forcing a reflow, only fetch boxSizing if we need it (gh-4322). - // Fake content-box until we know it's needed to know the true value. - boxSizingNeeded = !support.boxSizingReliable() || extra, - isBorderBox = boxSizingNeeded && - jQuery.css( elem, "boxSizing", false, styles ) === "border-box", - valueIsBorderBox = isBorderBox, - - val = curCSS( elem, dimension, styles ), - offsetProp = "offset" + dimension[ 0 ].toUpperCase() + dimension.slice( 1 ); - - // Support: Firefox <=54 - // Return a confounding non-pixel value or feign ignorance, as appropriate. - if ( rnumnonpx.test( val ) ) { - if ( !extra ) { - return val; - } - val = "auto"; - } - - - // Support: IE 9 - 11 only - // Use offsetWidth/offsetHeight for when box sizing is unreliable. - // In those cases, the computed value can be trusted to be border-box. - if ( ( !support.boxSizingReliable() && isBorderBox || - - // Support: IE 10 - 11+, Edge 15 - 18+ - // IE/Edge misreport `getComputedStyle` of table rows with width/height - // set in CSS while `offset*` properties report correct values. - // Interestingly, in some cases IE 9 doesn't suffer from this issue. - !support.reliableTrDimensions() && nodeName( elem, "tr" ) || - - // Fall back to offsetWidth/offsetHeight when value is "auto" - // This happens for inline elements with no explicit setting (gh-3571) - val === "auto" || - - // Support: Android <=4.1 - 4.3 only - // Also use offsetWidth/offsetHeight for misreported inline dimensions (gh-3602) - !parseFloat( val ) && jQuery.css( elem, "display", false, styles ) === "inline" ) && - - // Make sure the element is visible & connected - elem.getClientRects().length ) { - - isBorderBox = jQuery.css( elem, "boxSizing", false, styles ) === "border-box"; - - // Where available, offsetWidth/offsetHeight approximate border box dimensions. - // Where not available (e.g., SVG), assume unreliable box-sizing and interpret the - // retrieved value as a content box dimension. - valueIsBorderBox = offsetProp in elem; - if ( valueIsBorderBox ) { - val = elem[ offsetProp ]; - } - } - - // Normalize "" and auto - val = parseFloat( val ) || 0; - - // Adjust for the element's box model - return ( val + - boxModelAdjustment( - elem, - dimension, - extra || ( isBorderBox ? "border" : "content" ), - valueIsBorderBox, - styles, - - // Provide the current computed size to request scroll gutter calculation (gh-3589) - val - ) - ) + "px"; -} - -jQuery.extend( { - - // Add in style property hooks for overriding the default - // behavior of getting and setting a style property - cssHooks: { - opacity: { - get: function( elem, computed ) { - if ( computed ) { - - // We should always get a number back from opacity - var ret = curCSS( elem, "opacity" ); - return ret === "" ? "1" : ret; - } - } - } - }, - - // Don't automatically add "px" to these possibly-unitless properties - cssNumber: { - "animationIterationCount": true, - "columnCount": true, - "fillOpacity": true, - "flexGrow": true, - "flexShrink": true, - "fontWeight": true, - "gridArea": true, - "gridColumn": true, - "gridColumnEnd": true, - "gridColumnStart": true, - "gridRow": true, - "gridRowEnd": true, - "gridRowStart": true, - "lineHeight": true, - "opacity": true, - "order": true, - "orphans": true, - "widows": true, - "zIndex": true, - "zoom": true - }, - - // Add in properties whose names you wish to fix before - // setting or getting the value - cssProps: {}, - - // Get and set the style property on a DOM Node - style: function( elem, name, value, extra ) { - - // Don't set styles on text and comment nodes - if ( !elem || elem.nodeType === 3 || elem.nodeType === 8 || !elem.style ) { - return; - } - - // Make sure that we're working with the right name - var ret, type, hooks, - origName = camelCase( name ), - isCustomProp = rcustomProp.test( name ), - style = elem.style; - - // Make sure that we're working with the right name. We don't - // want to query the value if it is a CSS custom property - // since they are user-defined. - if ( !isCustomProp ) { - name = finalPropName( origName ); - } - - // Gets hook for the prefixed version, then unprefixed version - hooks = jQuery.cssHooks[ name ] || jQuery.cssHooks[ origName ]; - - // Check if we're setting a value - if ( value !== undefined ) { - type = typeof value; - - // Convert "+=" or "-=" to relative numbers (#7345) - if ( type === "string" && ( ret = rcssNum.exec( value ) ) && ret[ 1 ] ) { - value = adjustCSS( elem, name, ret ); - - // Fixes bug #9237 - type = "number"; - } - - // Make sure that null and NaN values aren't set (#7116) - if ( value == null || value !== value ) { - return; - } - - // If a number was passed in, add the unit (except for certain CSS properties) - // The isCustomProp check can be removed in jQuery 4.0 when we only auto-append - // "px" to a few hardcoded values. - if ( type === "number" && !isCustomProp ) { - value += ret && ret[ 3 ] || ( jQuery.cssNumber[ origName ] ? "" : "px" ); - } - - // background-* props affect original clone's values - if ( !support.clearCloneStyle && value === "" && name.indexOf( "background" ) === 0 ) { - style[ name ] = "inherit"; - } - - // If a hook was provided, use that value, otherwise just set the specified value - if ( !hooks || !( "set" in hooks ) || - ( value = hooks.set( elem, value, extra ) ) !== undefined ) { - - if ( isCustomProp ) { - style.setProperty( name, value ); - } else { - style[ name ] = value; - } - } - - } else { - - // If a hook was provided get the non-computed value from there - if ( hooks && "get" in hooks && - ( ret = hooks.get( elem, false, extra ) ) !== undefined ) { - - return ret; - } - - // Otherwise just get the value from the style object - return style[ name ]; - } - }, - - css: function( elem, name, extra, styles ) { - var val, num, hooks, - origName = camelCase( name ), - isCustomProp = rcustomProp.test( name ); - - // Make sure that we're working with the right name. We don't - // want to modify the value if it is a CSS custom property - // since they are user-defined. - if ( !isCustomProp ) { - name = finalPropName( origName ); - } - - // Try prefixed name followed by the unprefixed name - hooks = jQuery.cssHooks[ name ] || jQuery.cssHooks[ origName ]; - - // If a hook was provided get the computed value from there - if ( hooks && "get" in hooks ) { - val = hooks.get( elem, true, extra ); - } - - // Otherwise, if a way to get the computed value exists, use that - if ( val === undefined ) { - val = curCSS( elem, name, styles ); - } - - // Convert "normal" to computed value - if ( val === "normal" && name in cssNormalTransform ) { - val = cssNormalTransform[ name ]; - } - - // Make numeric if forced or a qualifier was provided and val looks numeric - if ( extra === "" || extra ) { - num = parseFloat( val ); - return extra === true || isFinite( num ) ? num || 0 : val; - } - - return val; - } -} ); - -jQuery.each( [ "height", "width" ], function( _i, dimension ) { - jQuery.cssHooks[ dimension ] = { - get: function( elem, computed, extra ) { - if ( computed ) { - - // Certain elements can have dimension info if we invisibly show them - // but it must have a current display style that would benefit - return rdisplayswap.test( jQuery.css( elem, "display" ) ) && - - // Support: Safari 8+ - // Table columns in Safari have non-zero offsetWidth & zero - // getBoundingClientRect().width unless display is changed. - // Support: IE <=11 only - // Running getBoundingClientRect on a disconnected node - // in IE throws an error. - ( !elem.getClientRects().length || !elem.getBoundingClientRect().width ) ? - swap( elem, cssShow, function() { - return getWidthOrHeight( elem, dimension, extra ); - } ) : - getWidthOrHeight( elem, dimension, extra ); - } - }, - - set: function( elem, value, extra ) { - var matches, - styles = getStyles( elem ), - - // Only read styles.position if the test has a chance to fail - // to avoid forcing a reflow. - scrollboxSizeBuggy = !support.scrollboxSize() && - styles.position === "absolute", - - // To avoid forcing a reflow, only fetch boxSizing if we need it (gh-3991) - boxSizingNeeded = scrollboxSizeBuggy || extra, - isBorderBox = boxSizingNeeded && - jQuery.css( elem, "boxSizing", false, styles ) === "border-box", - subtract = extra ? - boxModelAdjustment( - elem, - dimension, - extra, - isBorderBox, - styles - ) : - 0; - - // Account for unreliable border-box dimensions by comparing offset* to computed and - // faking a content-box to get border and padding (gh-3699) - if ( isBorderBox && scrollboxSizeBuggy ) { - subtract -= Math.ceil( - elem[ "offset" + dimension[ 0 ].toUpperCase() + dimension.slice( 1 ) ] - - parseFloat( styles[ dimension ] ) - - boxModelAdjustment( elem, dimension, "border", false, styles ) - - 0.5 - ); - } - - // Convert to pixels if value adjustment is needed - if ( subtract && ( matches = rcssNum.exec( value ) ) && - ( matches[ 3 ] || "px" ) !== "px" ) { - - elem.style[ dimension ] = value; - value = jQuery.css( elem, dimension ); - } - - return setPositiveNumber( elem, value, subtract ); - } - }; -} ); - -jQuery.cssHooks.marginLeft = addGetHookIf( support.reliableMarginLeft, - function( elem, computed ) { - if ( computed ) { - return ( parseFloat( curCSS( elem, "marginLeft" ) ) || - elem.getBoundingClientRect().left - - swap( elem, { marginLeft: 0 }, function() { - return elem.getBoundingClientRect().left; - } ) - ) + "px"; - } - } -); - -// These hooks are used by animate to expand properties -jQuery.each( { - margin: "", - padding: "", - border: "Width" -}, function( prefix, suffix ) { - jQuery.cssHooks[ prefix + suffix ] = { - expand: function( value ) { - var i = 0, - expanded = {}, - - // Assumes a single number if not a string - parts = typeof value === "string" ? value.split( " " ) : [ value ]; - - for ( ; i < 4; i++ ) { - expanded[ prefix + cssExpand[ i ] + suffix ] = - parts[ i ] || parts[ i - 2 ] || parts[ 0 ]; - } - - return expanded; - } - }; - - if ( prefix !== "margin" ) { - jQuery.cssHooks[ prefix + suffix ].set = setPositiveNumber; - } -} ); - -jQuery.fn.extend( { - css: function( name, value ) { - return access( this, function( elem, name, value ) { - var styles, len, - map = {}, - i = 0; - - if ( Array.isArray( name ) ) { - styles = getStyles( elem ); - len = name.length; - - for ( ; i < len; i++ ) { - map[ name[ i ] ] = jQuery.css( elem, name[ i ], false, styles ); - } - - return map; - } - - return value !== undefined ? - jQuery.style( elem, name, value ) : - jQuery.css( elem, name ); - }, name, value, arguments.length > 1 ); - } -} ); - - -function Tween( elem, options, prop, end, easing ) { - return new Tween.prototype.init( elem, options, prop, end, easing ); -} -jQuery.Tween = Tween; - -Tween.prototype = { - constructor: Tween, - init: function( elem, options, prop, end, easing, unit ) { - this.elem = elem; - this.prop = prop; - this.easing = easing || jQuery.easing._default; - this.options = options; - this.start = this.now = this.cur(); - this.end = end; - this.unit = unit || ( jQuery.cssNumber[ prop ] ? "" : "px" ); - }, - cur: function() { - var hooks = Tween.propHooks[ this.prop ]; - - return hooks && hooks.get ? - hooks.get( this ) : - Tween.propHooks._default.get( this ); - }, - run: function( percent ) { - var eased, - hooks = Tween.propHooks[ this.prop ]; - - if ( this.options.duration ) { - this.pos = eased = jQuery.easing[ this.easing ]( - percent, this.options.duration * percent, 0, 1, this.options.duration - ); - } else { - this.pos = eased = percent; - } - this.now = ( this.end - this.start ) * eased + this.start; - - if ( this.options.step ) { - this.options.step.call( this.elem, this.now, this ); - } - - if ( hooks && hooks.set ) { - hooks.set( this ); - } else { - Tween.propHooks._default.set( this ); - } - return this; - } -}; - -Tween.prototype.init.prototype = Tween.prototype; - -Tween.propHooks = { - _default: { - get: function( tween ) { - var result; - - // Use a property on the element directly when it is not a DOM element, - // or when there is no matching style property that exists. - if ( tween.elem.nodeType !== 1 || - tween.elem[ tween.prop ] != null && tween.elem.style[ tween.prop ] == null ) { - return tween.elem[ tween.prop ]; - } - - // Passing an empty string as a 3rd parameter to .css will automatically - // attempt a parseFloat and fallback to a string if the parse fails. - // Simple values such as "10px" are parsed to Float; - // complex values such as "rotate(1rad)" are returned as-is. - result = jQuery.css( tween.elem, tween.prop, "" ); - - // Empty strings, null, undefined and "auto" are converted to 0. - return !result || result === "auto" ? 0 : result; - }, - set: function( tween ) { - - // Use step hook for back compat. - // Use cssHook if its there. - // Use .style if available and use plain properties where available. - if ( jQuery.fx.step[ tween.prop ] ) { - jQuery.fx.step[ tween.prop ]( tween ); - } else if ( tween.elem.nodeType === 1 && ( - jQuery.cssHooks[ tween.prop ] || - tween.elem.style[ finalPropName( tween.prop ) ] != null ) ) { - jQuery.style( tween.elem, tween.prop, tween.now + tween.unit ); - } else { - tween.elem[ tween.prop ] = tween.now; - } - } - } -}; - -// Support: IE <=9 only -// Panic based approach to setting things on disconnected nodes -Tween.propHooks.scrollTop = Tween.propHooks.scrollLeft = { - set: function( tween ) { - if ( tween.elem.nodeType && tween.elem.parentNode ) { - tween.elem[ tween.prop ] = tween.now; - } - } -}; - -jQuery.easing = { - linear: function( p ) { - return p; - }, - swing: function( p ) { - return 0.5 - Math.cos( p * Math.PI ) / 2; - }, - _default: "swing" -}; - -jQuery.fx = Tween.prototype.init; - -// Back compat <1.8 extension point -jQuery.fx.step = {}; - - - - -var - fxNow, inProgress, - rfxtypes = /^(?:toggle|show|hide)$/, - rrun = /queueHooks$/; - -function schedule() { - if ( inProgress ) { - if ( document.hidden === false && window.requestAnimationFrame ) { - window.requestAnimationFrame( schedule ); - } else { - window.setTimeout( schedule, jQuery.fx.interval ); - } - - jQuery.fx.tick(); - } -} - -// Animations created synchronously will run synchronously -function createFxNow() { - window.setTimeout( function() { - fxNow = undefined; - } ); - return ( fxNow = Date.now() ); -} - -// Generate parameters to create a standard animation -function genFx( type, includeWidth ) { - var which, - i = 0, - attrs = { height: type }; - - // If we include width, step value is 1 to do all cssExpand values, - // otherwise step value is 2 to skip over Left and Right - includeWidth = includeWidth ? 1 : 0; - for ( ; i < 4; i += 2 - includeWidth ) { - which = cssExpand[ i ]; - attrs[ "margin" + which ] = attrs[ "padding" + which ] = type; - } - - if ( includeWidth ) { - attrs.opacity = attrs.width = type; - } - - return attrs; -} - -function createTween( value, prop, animation ) { - var tween, - collection = ( Animation.tweeners[ prop ] || [] ).concat( Animation.tweeners[ "*" ] ), - index = 0, - length = collection.length; - for ( ; index < length; index++ ) { - if ( ( tween = collection[ index ].call( animation, prop, value ) ) ) { - - // We're done with this property - return tween; - } - } -} - -function defaultPrefilter( elem, props, opts ) { - var prop, value, toggle, hooks, oldfire, propTween, restoreDisplay, display, - isBox = "width" in props || "height" in props, - anim = this, - orig = {}, - style = elem.style, - hidden = elem.nodeType && isHiddenWithinTree( elem ), - dataShow = dataPriv.get( elem, "fxshow" ); - - // Queue-skipping animations hijack the fx hooks - if ( !opts.queue ) { - hooks = jQuery._queueHooks( elem, "fx" ); - if ( hooks.unqueued == null ) { - hooks.unqueued = 0; - oldfire = hooks.empty.fire; - hooks.empty.fire = function() { - if ( !hooks.unqueued ) { - oldfire(); - } - }; - } - hooks.unqueued++; - - anim.always( function() { - - // Ensure the complete handler is called before this completes - anim.always( function() { - hooks.unqueued--; - if ( !jQuery.queue( elem, "fx" ).length ) { - hooks.empty.fire(); - } - } ); - } ); - } - - // Detect show/hide animations - for ( prop in props ) { - value = props[ prop ]; - if ( rfxtypes.test( value ) ) { - delete props[ prop ]; - toggle = toggle || value === "toggle"; - if ( value === ( hidden ? "hide" : "show" ) ) { - - // Pretend to be hidden if this is a "show" and - // there is still data from a stopped show/hide - if ( value === "show" && dataShow && dataShow[ prop ] !== undefined ) { - hidden = true; - - // Ignore all other no-op show/hide data - } else { - continue; - } - } - orig[ prop ] = dataShow && dataShow[ prop ] || jQuery.style( elem, prop ); - } - } - - // Bail out if this is a no-op like .hide().hide() - propTween = !jQuery.isEmptyObject( props ); - if ( !propTween && jQuery.isEmptyObject( orig ) ) { - return; - } - - // Restrict "overflow" and "display" styles during box animations - if ( isBox && elem.nodeType === 1 ) { - - // Support: IE <=9 - 11, Edge 12 - 15 - // Record all 3 overflow attributes because IE does not infer the shorthand - // from identically-valued overflowX and overflowY and Edge just mirrors - // the overflowX value there. - opts.overflow = [ style.overflow, style.overflowX, style.overflowY ]; - - // Identify a display type, preferring old show/hide data over the CSS cascade - restoreDisplay = dataShow && dataShow.display; - if ( restoreDisplay == null ) { - restoreDisplay = dataPriv.get( elem, "display" ); - } - display = jQuery.css( elem, "display" ); - if ( display === "none" ) { - if ( restoreDisplay ) { - display = restoreDisplay; - } else { - - // Get nonempty value(s) by temporarily forcing visibility - showHide( [ elem ], true ); - restoreDisplay = elem.style.display || restoreDisplay; - display = jQuery.css( elem, "display" ); - showHide( [ elem ] ); - } - } - - // Animate inline elements as inline-block - if ( display === "inline" || display === "inline-block" && restoreDisplay != null ) { - if ( jQuery.css( elem, "float" ) === "none" ) { - - // Restore the original display value at the end of pure show/hide animations - if ( !propTween ) { - anim.done( function() { - style.display = restoreDisplay; - } ); - if ( restoreDisplay == null ) { - display = style.display; - restoreDisplay = display === "none" ? "" : display; - } - } - style.display = "inline-block"; - } - } - } - - if ( opts.overflow ) { - style.overflow = "hidden"; - anim.always( function() { - style.overflow = opts.overflow[ 0 ]; - style.overflowX = opts.overflow[ 1 ]; - style.overflowY = opts.overflow[ 2 ]; - } ); - } - - // Implement show/hide animations - propTween = false; - for ( prop in orig ) { - - // General show/hide setup for this element animation - if ( !propTween ) { - if ( dataShow ) { - if ( "hidden" in dataShow ) { - hidden = dataShow.hidden; - } - } else { - dataShow = dataPriv.access( elem, "fxshow", { display: restoreDisplay } ); - } - - // Store hidden/visible for toggle so `.stop().toggle()` "reverses" - if ( toggle ) { - dataShow.hidden = !hidden; - } - - // Show elements before animating them - if ( hidden ) { - showHide( [ elem ], true ); - } - - /* eslint-disable no-loop-func */ - - anim.done( function() { - - /* eslint-enable no-loop-func */ - - // The final step of a "hide" animation is actually hiding the element - if ( !hidden ) { - showHide( [ elem ] ); - } - dataPriv.remove( elem, "fxshow" ); - for ( prop in orig ) { - jQuery.style( elem, prop, orig[ prop ] ); - } - } ); - } - - // Per-property setup - propTween = createTween( hidden ? dataShow[ prop ] : 0, prop, anim ); - if ( !( prop in dataShow ) ) { - dataShow[ prop ] = propTween.start; - if ( hidden ) { - propTween.end = propTween.start; - propTween.start = 0; - } - } - } -} - -function propFilter( props, specialEasing ) { - var index, name, easing, value, hooks; - - // camelCase, specialEasing and expand cssHook pass - for ( index in props ) { - name = camelCase( index ); - easing = specialEasing[ name ]; - value = props[ index ]; - if ( Array.isArray( value ) ) { - easing = value[ 1 ]; - value = props[ index ] = value[ 0 ]; - } - - if ( index !== name ) { - props[ name ] = value; - delete props[ index ]; - } - - hooks = jQuery.cssHooks[ name ]; - if ( hooks && "expand" in hooks ) { - value = hooks.expand( value ); - delete props[ name ]; - - // Not quite $.extend, this won't overwrite existing keys. - // Reusing 'index' because we have the correct "name" - for ( index in value ) { - if ( !( index in props ) ) { - props[ index ] = value[ index ]; - specialEasing[ index ] = easing; - } - } - } else { - specialEasing[ name ] = easing; - } - } -} - -function Animation( elem, properties, options ) { - var result, - stopped, - index = 0, - length = Animation.prefilters.length, - deferred = jQuery.Deferred().always( function() { - - // Don't match elem in the :animated selector - delete tick.elem; - } ), - tick = function() { - if ( stopped ) { - return false; - } - var currentTime = fxNow || createFxNow(), - remaining = Math.max( 0, animation.startTime + animation.duration - currentTime ), - - // Support: Android 2.3 only - // Archaic crash bug won't allow us to use `1 - ( 0.5 || 0 )` (#12497) - temp = remaining / animation.duration || 0, - percent = 1 - temp, - index = 0, - length = animation.tweens.length; - - for ( ; index < length; index++ ) { - animation.tweens[ index ].run( percent ); - } - - deferred.notifyWith( elem, [ animation, percent, remaining ] ); - - // If there's more to do, yield - if ( percent < 1 && length ) { - return remaining; - } - - // If this was an empty animation, synthesize a final progress notification - if ( !length ) { - deferred.notifyWith( elem, [ animation, 1, 0 ] ); - } - - // Resolve the animation and report its conclusion - deferred.resolveWith( elem, [ animation ] ); - return false; - }, - animation = deferred.promise( { - elem: elem, - props: jQuery.extend( {}, properties ), - opts: jQuery.extend( true, { - specialEasing: {}, - easing: jQuery.easing._default - }, options ), - originalProperties: properties, - originalOptions: options, - startTime: fxNow || createFxNow(), - duration: options.duration, - tweens: [], - createTween: function( prop, end ) { - var tween = jQuery.Tween( elem, animation.opts, prop, end, - animation.opts.specialEasing[ prop ] || animation.opts.easing ); - animation.tweens.push( tween ); - return tween; - }, - stop: function( gotoEnd ) { - var index = 0, - - // If we are going to the end, we want to run all the tweens - // otherwise we skip this part - length = gotoEnd ? animation.tweens.length : 0; - if ( stopped ) { - return this; - } - stopped = true; - for ( ; index < length; index++ ) { - animation.tweens[ index ].run( 1 ); - } - - // Resolve when we played the last frame; otherwise, reject - if ( gotoEnd ) { - deferred.notifyWith( elem, [ animation, 1, 0 ] ); - deferred.resolveWith( elem, [ animation, gotoEnd ] ); - } else { - deferred.rejectWith( elem, [ animation, gotoEnd ] ); - } - return this; - } - } ), - props = animation.props; - - propFilter( props, animation.opts.specialEasing ); - - for ( ; index < length; index++ ) { - result = Animation.prefilters[ index ].call( animation, elem, props, animation.opts ); - if ( result ) { - if ( isFunction( result.stop ) ) { - jQuery._queueHooks( animation.elem, animation.opts.queue ).stop = - result.stop.bind( result ); - } - return result; - } - } - - jQuery.map( props, createTween, animation ); - - if ( isFunction( animation.opts.start ) ) { - animation.opts.start.call( elem, animation ); - } - - // Attach callbacks from options - animation - .progress( animation.opts.progress ) - .done( animation.opts.done, animation.opts.complete ) - .fail( animation.opts.fail ) - .always( animation.opts.always ); - - jQuery.fx.timer( - jQuery.extend( tick, { - elem: elem, - anim: animation, - queue: animation.opts.queue - } ) - ); - - return animation; -} - -jQuery.Animation = jQuery.extend( Animation, { - - tweeners: { - "*": [ function( prop, value ) { - var tween = this.createTween( prop, value ); - adjustCSS( tween.elem, prop, rcssNum.exec( value ), tween ); - return tween; - } ] - }, - - tweener: function( props, callback ) { - if ( isFunction( props ) ) { - callback = props; - props = [ "*" ]; - } else { - props = props.match( rnothtmlwhite ); - } - - var prop, - index = 0, - length = props.length; - - for ( ; index < length; index++ ) { - prop = props[ index ]; - Animation.tweeners[ prop ] = Animation.tweeners[ prop ] || []; - Animation.tweeners[ prop ].unshift( callback ); - } - }, - - prefilters: [ defaultPrefilter ], - - prefilter: function( callback, prepend ) { - if ( prepend ) { - Animation.prefilters.unshift( callback ); - } else { - Animation.prefilters.push( callback ); - } - } -} ); - -jQuery.speed = function( speed, easing, fn ) { - var opt = speed && typeof speed === "object" ? jQuery.extend( {}, speed ) : { - complete: fn || !fn && easing || - isFunction( speed ) && speed, - duration: speed, - easing: fn && easing || easing && !isFunction( easing ) && easing - }; - - // Go to the end state if fx are off - if ( jQuery.fx.off ) { - opt.duration = 0; - - } else { - if ( typeof opt.duration !== "number" ) { - if ( opt.duration in jQuery.fx.speeds ) { - opt.duration = jQuery.fx.speeds[ opt.duration ]; - - } else { - opt.duration = jQuery.fx.speeds._default; - } - } - } - - // Normalize opt.queue - true/undefined/null -> "fx" - if ( opt.queue == null || opt.queue === true ) { - opt.queue = "fx"; - } - - // Queueing - opt.old = opt.complete; - - opt.complete = function() { - if ( isFunction( opt.old ) ) { - opt.old.call( this ); - } - - if ( opt.queue ) { - jQuery.dequeue( this, opt.queue ); - } - }; - - return opt; -}; - -jQuery.fn.extend( { - fadeTo: function( speed, to, easing, callback ) { - - // Show any hidden elements after setting opacity to 0 - return this.filter( isHiddenWithinTree ).css( "opacity", 0 ).show() - - // Animate to the value specified - .end().animate( { opacity: to }, speed, easing, callback ); - }, - animate: function( prop, speed, easing, callback ) { - var empty = jQuery.isEmptyObject( prop ), - optall = jQuery.speed( speed, easing, callback ), - doAnimation = function() { - - // Operate on a copy of prop so per-property easing won't be lost - var anim = Animation( this, jQuery.extend( {}, prop ), optall ); - - // Empty animations, or finishing resolves immediately - if ( empty || dataPriv.get( this, "finish" ) ) { - anim.stop( true ); - } - }; - - doAnimation.finish = doAnimation; - - return empty || optall.queue === false ? - this.each( doAnimation ) : - this.queue( optall.queue, doAnimation ); - }, - stop: function( type, clearQueue, gotoEnd ) { - var stopQueue = function( hooks ) { - var stop = hooks.stop; - delete hooks.stop; - stop( gotoEnd ); - }; - - if ( typeof type !== "string" ) { - gotoEnd = clearQueue; - clearQueue = type; - type = undefined; - } - if ( clearQueue ) { - this.queue( type || "fx", [] ); - } - - return this.each( function() { - var dequeue = true, - index = type != null && type + "queueHooks", - timers = jQuery.timers, - data = dataPriv.get( this ); - - if ( index ) { - if ( data[ index ] && data[ index ].stop ) { - stopQueue( data[ index ] ); - } - } else { - for ( index in data ) { - if ( data[ index ] && data[ index ].stop && rrun.test( index ) ) { - stopQueue( data[ index ] ); - } - } - } - - for ( index = timers.length; index--; ) { - if ( timers[ index ].elem === this && - ( type == null || timers[ index ].queue === type ) ) { - - timers[ index ].anim.stop( gotoEnd ); - dequeue = false; - timers.splice( index, 1 ); - } - } - - // Start the next in the queue if the last step wasn't forced. - // Timers currently will call their complete callbacks, which - // will dequeue but only if they were gotoEnd. - if ( dequeue || !gotoEnd ) { - jQuery.dequeue( this, type ); - } - } ); - }, - finish: function( type ) { - if ( type !== false ) { - type = type || "fx"; - } - return this.each( function() { - var index, - data = dataPriv.get( this ), - queue = data[ type + "queue" ], - hooks = data[ type + "queueHooks" ], - timers = jQuery.timers, - length = queue ? queue.length : 0; - - // Enable finishing flag on private data - data.finish = true; - - // Empty the queue first - jQuery.queue( this, type, [] ); - - if ( hooks && hooks.stop ) { - hooks.stop.call( this, true ); - } - - // Look for any active animations, and finish them - for ( index = timers.length; index--; ) { - if ( timers[ index ].elem === this && timers[ index ].queue === type ) { - timers[ index ].anim.stop( true ); - timers.splice( index, 1 ); - } - } - - // Look for any animations in the old queue and finish them - for ( index = 0; index < length; index++ ) { - if ( queue[ index ] && queue[ index ].finish ) { - queue[ index ].finish.call( this ); - } - } - - // Turn off finishing flag - delete data.finish; - } ); - } -} ); - -jQuery.each( [ "toggle", "show", "hide" ], function( _i, name ) { - var cssFn = jQuery.fn[ name ]; - jQuery.fn[ name ] = function( speed, easing, callback ) { - return speed == null || typeof speed === "boolean" ? - cssFn.apply( this, arguments ) : - this.animate( genFx( name, true ), speed, easing, callback ); - }; -} ); - -// Generate shortcuts for custom animations -jQuery.each( { - slideDown: genFx( "show" ), - slideUp: genFx( "hide" ), - slideToggle: genFx( "toggle" ), - fadeIn: { opacity: "show" }, - fadeOut: { opacity: "hide" }, - fadeToggle: { opacity: "toggle" } -}, function( name, props ) { - jQuery.fn[ name ] = function( speed, easing, callback ) { - return this.animate( props, speed, easing, callback ); - }; -} ); - -jQuery.timers = []; -jQuery.fx.tick = function() { - var timer, - i = 0, - timers = jQuery.timers; - - fxNow = Date.now(); - - for ( ; i < timers.length; i++ ) { - timer = timers[ i ]; - - // Run the timer and safely remove it when done (allowing for external removal) - if ( !timer() && timers[ i ] === timer ) { - timers.splice( i--, 1 ); - } - } - - if ( !timers.length ) { - jQuery.fx.stop(); - } - fxNow = undefined; -}; - -jQuery.fx.timer = function( timer ) { - jQuery.timers.push( timer ); - jQuery.fx.start(); -}; - -jQuery.fx.interval = 13; -jQuery.fx.start = function() { - if ( inProgress ) { - return; - } - - inProgress = true; - schedule(); -}; - -jQuery.fx.stop = function() { - inProgress = null; -}; - -jQuery.fx.speeds = { - slow: 600, - fast: 200, - - // Default speed - _default: 400 -}; - - -// Based off of the plugin by Clint Helfers, with permission. -// https://web.archive.org/web/20100324014747/http://blindsignals.com/index.php/2009/07/jquery-delay/ -jQuery.fn.delay = function( time, type ) { - time = jQuery.fx ? jQuery.fx.speeds[ time ] || time : time; - type = type || "fx"; - - return this.queue( type, function( next, hooks ) { - var timeout = window.setTimeout( next, time ); - hooks.stop = function() { - window.clearTimeout( timeout ); - }; - } ); -}; - - -( function() { - var input = document.createElement( "input" ), - select = document.createElement( "select" ), - opt = select.appendChild( document.createElement( "option" ) ); - - input.type = "checkbox"; - - // Support: Android <=4.3 only - // Default value for a checkbox should be "on" - support.checkOn = input.value !== ""; - - // Support: IE <=11 only - // Must access selectedIndex to make default options select - support.optSelected = opt.selected; - - // Support: IE <=11 only - // An input loses its value after becoming a radio - input = document.createElement( "input" ); - input.value = "t"; - input.type = "radio"; - support.radioValue = input.value === "t"; -} )(); - - -var boolHook, - attrHandle = jQuery.expr.attrHandle; - -jQuery.fn.extend( { - attr: function( name, value ) { - return access( this, jQuery.attr, name, value, arguments.length > 1 ); - }, - - removeAttr: function( name ) { - return this.each( function() { - jQuery.removeAttr( this, name ); - } ); - } -} ); - -jQuery.extend( { - attr: function( elem, name, value ) { - var ret, hooks, - nType = elem.nodeType; - - // Don't get/set attributes on text, comment and attribute nodes - if ( nType === 3 || nType === 8 || nType === 2 ) { - return; - } - - // Fallback to prop when attributes are not supported - if ( typeof elem.getAttribute === "undefined" ) { - return jQuery.prop( elem, name, value ); - } - - // Attribute hooks are determined by the lowercase version - // Grab necessary hook if one is defined - if ( nType !== 1 || !jQuery.isXMLDoc( elem ) ) { - hooks = jQuery.attrHooks[ name.toLowerCase() ] || - ( jQuery.expr.match.bool.test( name ) ? boolHook : undefined ); - } - - if ( value !== undefined ) { - if ( value === null ) { - jQuery.removeAttr( elem, name ); - return; - } - - if ( hooks && "set" in hooks && - ( ret = hooks.set( elem, value, name ) ) !== undefined ) { - return ret; - } - - elem.setAttribute( name, value + "" ); - return value; - } - - if ( hooks && "get" in hooks && ( ret = hooks.get( elem, name ) ) !== null ) { - return ret; - } - - ret = jQuery.find.attr( elem, name ); - - // Non-existent attributes return null, we normalize to undefined - return ret == null ? undefined : ret; - }, - - attrHooks: { - type: { - set: function( elem, value ) { - if ( !support.radioValue && value === "radio" && - nodeName( elem, "input" ) ) { - var val = elem.value; - elem.setAttribute( "type", value ); - if ( val ) { - elem.value = val; - } - return value; - } - } - } - }, - - removeAttr: function( elem, value ) { - var name, - i = 0, - - // Attribute names can contain non-HTML whitespace characters - // https://html.spec.whatwg.org/multipage/syntax.html#attributes-2 - attrNames = value && value.match( rnothtmlwhite ); - - if ( attrNames && elem.nodeType === 1 ) { - while ( ( name = attrNames[ i++ ] ) ) { - elem.removeAttribute( name ); - } - } - } -} ); - -// Hooks for boolean attributes -boolHook = { - set: function( elem, value, name ) { - if ( value === false ) { - - // Remove boolean attributes when set to false - jQuery.removeAttr( elem, name ); - } else { - elem.setAttribute( name, name ); - } - return name; - } -}; - -jQuery.each( jQuery.expr.match.bool.source.match( /\w+/g ), function( _i, name ) { - var getter = attrHandle[ name ] || jQuery.find.attr; - - attrHandle[ name ] = function( elem, name, isXML ) { - var ret, handle, - lowercaseName = name.toLowerCase(); - - if ( !isXML ) { - - // Avoid an infinite loop by temporarily removing this function from the getter - handle = attrHandle[ lowercaseName ]; - attrHandle[ lowercaseName ] = ret; - ret = getter( elem, name, isXML ) != null ? - lowercaseName : - null; - attrHandle[ lowercaseName ] = handle; - } - return ret; - }; -} ); - - - - -var rfocusable = /^(?:input|select|textarea|button)$/i, - rclickable = /^(?:a|area)$/i; - -jQuery.fn.extend( { - prop: function( name, value ) { - return access( this, jQuery.prop, name, value, arguments.length > 1 ); - }, - - removeProp: function( name ) { - return this.each( function() { - delete this[ jQuery.propFix[ name ] || name ]; - } ); - } -} ); - -jQuery.extend( { - prop: function( elem, name, value ) { - var ret, hooks, - nType = elem.nodeType; - - // Don't get/set properties on text, comment and attribute nodes - if ( nType === 3 || nType === 8 || nType === 2 ) { - return; - } - - if ( nType !== 1 || !jQuery.isXMLDoc( elem ) ) { - - // Fix name and attach hooks - name = jQuery.propFix[ name ] || name; - hooks = jQuery.propHooks[ name ]; - } - - if ( value !== undefined ) { - if ( hooks && "set" in hooks && - ( ret = hooks.set( elem, value, name ) ) !== undefined ) { - return ret; - } - - return ( elem[ name ] = value ); - } - - if ( hooks && "get" in hooks && ( ret = hooks.get( elem, name ) ) !== null ) { - return ret; - } - - return elem[ name ]; - }, - - propHooks: { - tabIndex: { - get: function( elem ) { - - // Support: IE <=9 - 11 only - // elem.tabIndex doesn't always return the - // correct value when it hasn't been explicitly set - // https://web.archive.org/web/20141116233347/http://fluidproject.org/blog/2008/01/09/getting-setting-and-removing-tabindex-values-with-javascript/ - // Use proper attribute retrieval(#12072) - var tabindex = jQuery.find.attr( elem, "tabindex" ); - - if ( tabindex ) { - return parseInt( tabindex, 10 ); - } - - if ( - rfocusable.test( elem.nodeName ) || - rclickable.test( elem.nodeName ) && - elem.href - ) { - return 0; - } - - return -1; - } - } - }, - - propFix: { - "for": "htmlFor", - "class": "className" - } -} ); - -// Support: IE <=11 only -// Accessing the selectedIndex property -// forces the browser to respect setting selected -// on the option -// The getter ensures a default option is selected -// when in an optgroup -// eslint rule "no-unused-expressions" is disabled for this code -// since it considers such accessions noop -if ( !support.optSelected ) { - jQuery.propHooks.selected = { - get: function( elem ) { - - /* eslint no-unused-expressions: "off" */ - - var parent = elem.parentNode; - if ( parent && parent.parentNode ) { - parent.parentNode.selectedIndex; - } - return null; - }, - set: function( elem ) { - - /* eslint no-unused-expressions: "off" */ - - var parent = elem.parentNode; - if ( parent ) { - parent.selectedIndex; - - if ( parent.parentNode ) { - parent.parentNode.selectedIndex; - } - } - } - }; -} - -jQuery.each( [ - "tabIndex", - "readOnly", - "maxLength", - "cellSpacing", - "cellPadding", - "rowSpan", - "colSpan", - "useMap", - "frameBorder", - "contentEditable" -], function() { - jQuery.propFix[ this.toLowerCase() ] = this; -} ); - - - - - // Strip and collapse whitespace according to HTML spec - // https://infra.spec.whatwg.org/#strip-and-collapse-ascii-whitespace - function stripAndCollapse( value ) { - var tokens = value.match( rnothtmlwhite ) || []; - return tokens.join( " " ); - } - - -function getClass( elem ) { - return elem.getAttribute && elem.getAttribute( "class" ) || ""; -} - -function classesToArray( value ) { - if ( Array.isArray( value ) ) { - return value; - } - if ( typeof value === "string" ) { - return value.match( rnothtmlwhite ) || []; - } - return []; -} - -jQuery.fn.extend( { - addClass: function( value ) { - var classes, elem, cur, curValue, clazz, j, finalValue, - i = 0; - - if ( isFunction( value ) ) { - return this.each( function( j ) { - jQuery( this ).addClass( value.call( this, j, getClass( this ) ) ); - } ); - } - - classes = classesToArray( value ); - - if ( classes.length ) { - while ( ( elem = this[ i++ ] ) ) { - curValue = getClass( elem ); - cur = elem.nodeType === 1 && ( " " + stripAndCollapse( curValue ) + " " ); - - if ( cur ) { - j = 0; - while ( ( clazz = classes[ j++ ] ) ) { - if ( cur.indexOf( " " + clazz + " " ) < 0 ) { - cur += clazz + " "; - } - } - - // Only assign if different to avoid unneeded rendering. - finalValue = stripAndCollapse( cur ); - if ( curValue !== finalValue ) { - elem.setAttribute( "class", finalValue ); - } - } - } - } - - return this; - }, - - removeClass: function( value ) { - var classes, elem, cur, curValue, clazz, j, finalValue, - i = 0; - - if ( isFunction( value ) ) { - return this.each( function( j ) { - jQuery( this ).removeClass( value.call( this, j, getClass( this ) ) ); - } ); - } - - if ( !arguments.length ) { - return this.attr( "class", "" ); - } - - classes = classesToArray( value ); - - if ( classes.length ) { - while ( ( elem = this[ i++ ] ) ) { - curValue = getClass( elem ); - - // This expression is here for better compressibility (see addClass) - cur = elem.nodeType === 1 && ( " " + stripAndCollapse( curValue ) + " " ); - - if ( cur ) { - j = 0; - while ( ( clazz = classes[ j++ ] ) ) { - - // Remove *all* instances - while ( cur.indexOf( " " + clazz + " " ) > -1 ) { - cur = cur.replace( " " + clazz + " ", " " ); - } - } - - // Only assign if different to avoid unneeded rendering. - finalValue = stripAndCollapse( cur ); - if ( curValue !== finalValue ) { - elem.setAttribute( "class", finalValue ); - } - } - } - } - - return this; - }, - - toggleClass: function( value, stateVal ) { - var type = typeof value, - isValidValue = type === "string" || Array.isArray( value ); - - if ( typeof stateVal === "boolean" && isValidValue ) { - return stateVal ? this.addClass( value ) : this.removeClass( value ); - } - - if ( isFunction( value ) ) { - return this.each( function( i ) { - jQuery( this ).toggleClass( - value.call( this, i, getClass( this ), stateVal ), - stateVal - ); - } ); - } - - return this.each( function() { - var className, i, self, classNames; - - if ( isValidValue ) { - - // Toggle individual class names - i = 0; - self = jQuery( this ); - classNames = classesToArray( value ); - - while ( ( className = classNames[ i++ ] ) ) { - - // Check each className given, space separated list - if ( self.hasClass( className ) ) { - self.removeClass( className ); - } else { - self.addClass( className ); - } - } - - // Toggle whole class name - } else if ( value === undefined || type === "boolean" ) { - className = getClass( this ); - if ( className ) { - - // Store className if set - dataPriv.set( this, "__className__", className ); - } - - // If the element has a class name or if we're passed `false`, - // then remove the whole classname (if there was one, the above saved it). - // Otherwise bring back whatever was previously saved (if anything), - // falling back to the empty string if nothing was stored. - if ( this.setAttribute ) { - this.setAttribute( "class", - className || value === false ? - "" : - dataPriv.get( this, "__className__" ) || "" - ); - } - } - } ); - }, - - hasClass: function( selector ) { - var className, elem, - i = 0; - - className = " " + selector + " "; - while ( ( elem = this[ i++ ] ) ) { - if ( elem.nodeType === 1 && - ( " " + stripAndCollapse( getClass( elem ) ) + " " ).indexOf( className ) > -1 ) { - return true; - } - } - - return false; - } -} ); - - - - -var rreturn = /\r/g; - -jQuery.fn.extend( { - val: function( value ) { - var hooks, ret, valueIsFunction, - elem = this[ 0 ]; - - if ( !arguments.length ) { - if ( elem ) { - hooks = jQuery.valHooks[ elem.type ] || - jQuery.valHooks[ elem.nodeName.toLowerCase() ]; - - if ( hooks && - "get" in hooks && - ( ret = hooks.get( elem, "value" ) ) !== undefined - ) { - return ret; - } - - ret = elem.value; - - // Handle most common string cases - if ( typeof ret === "string" ) { - return ret.replace( rreturn, "" ); - } - - // Handle cases where value is null/undef or number - return ret == null ? "" : ret; - } - - return; - } - - valueIsFunction = isFunction( value ); - - return this.each( function( i ) { - var val; - - if ( this.nodeType !== 1 ) { - return; - } - - if ( valueIsFunction ) { - val = value.call( this, i, jQuery( this ).val() ); - } else { - val = value; - } - - // Treat null/undefined as ""; convert numbers to string - if ( val == null ) { - val = ""; - - } else if ( typeof val === "number" ) { - val += ""; - - } else if ( Array.isArray( val ) ) { - val = jQuery.map( val, function( value ) { - return value == null ? "" : value + ""; - } ); - } - - hooks = jQuery.valHooks[ this.type ] || jQuery.valHooks[ this.nodeName.toLowerCase() ]; - - // If set returns undefined, fall back to normal setting - if ( !hooks || !( "set" in hooks ) || hooks.set( this, val, "value" ) === undefined ) { - this.value = val; - } - } ); - } -} ); - -jQuery.extend( { - valHooks: { - option: { - get: function( elem ) { - - var val = jQuery.find.attr( elem, "value" ); - return val != null ? - val : - - // Support: IE <=10 - 11 only - // option.text throws exceptions (#14686, #14858) - // Strip and collapse whitespace - // https://html.spec.whatwg.org/#strip-and-collapse-whitespace - stripAndCollapse( jQuery.text( elem ) ); - } - }, - select: { - get: function( elem ) { - var value, option, i, - options = elem.options, - index = elem.selectedIndex, - one = elem.type === "select-one", - values = one ? null : [], - max = one ? index + 1 : options.length; - - if ( index < 0 ) { - i = max; - - } else { - i = one ? index : 0; - } - - // Loop through all the selected options - for ( ; i < max; i++ ) { - option = options[ i ]; - - // Support: IE <=9 only - // IE8-9 doesn't update selected after form reset (#2551) - if ( ( option.selected || i === index ) && - - // Don't return options that are disabled or in a disabled optgroup - !option.disabled && - ( !option.parentNode.disabled || - !nodeName( option.parentNode, "optgroup" ) ) ) { - - // Get the specific value for the option - value = jQuery( option ).val(); - - // We don't need an array for one selects - if ( one ) { - return value; - } - - // Multi-Selects return an array - values.push( value ); - } - } - - return values; - }, - - set: function( elem, value ) { - var optionSet, option, - options = elem.options, - values = jQuery.makeArray( value ), - i = options.length; - - while ( i-- ) { - option = options[ i ]; - - /* eslint-disable no-cond-assign */ - - if ( option.selected = - jQuery.inArray( jQuery.valHooks.option.get( option ), values ) > -1 - ) { - optionSet = true; - } - - /* eslint-enable no-cond-assign */ - } - - // Force browsers to behave consistently when non-matching value is set - if ( !optionSet ) { - elem.selectedIndex = -1; - } - return values; - } - } - } -} ); - -// Radios and checkboxes getter/setter -jQuery.each( [ "radio", "checkbox" ], function() { - jQuery.valHooks[ this ] = { - set: function( elem, value ) { - if ( Array.isArray( value ) ) { - return ( elem.checked = jQuery.inArray( jQuery( elem ).val(), value ) > -1 ); - } - } - }; - if ( !support.checkOn ) { - jQuery.valHooks[ this ].get = function( elem ) { - return elem.getAttribute( "value" ) === null ? "on" : elem.value; - }; - } -} ); - - - - -// Return jQuery for attributes-only inclusion - - -support.focusin = "onfocusin" in window; - - -var rfocusMorph = /^(?:focusinfocus|focusoutblur)$/, - stopPropagationCallback = function( e ) { - e.stopPropagation(); - }; - -jQuery.extend( jQuery.event, { - - trigger: function( event, data, elem, onlyHandlers ) { - - var i, cur, tmp, bubbleType, ontype, handle, special, lastElement, - eventPath = [ elem || document ], - type = hasOwn.call( event, "type" ) ? event.type : event, - namespaces = hasOwn.call( event, "namespace" ) ? event.namespace.split( "." ) : []; - - cur = lastElement = tmp = elem = elem || document; - - // Don't do events on text and comment nodes - if ( elem.nodeType === 3 || elem.nodeType === 8 ) { - return; - } - - // focus/blur morphs to focusin/out; ensure we're not firing them right now - if ( rfocusMorph.test( type + jQuery.event.triggered ) ) { - return; - } - - if ( type.indexOf( "." ) > -1 ) { - - // Namespaced trigger; create a regexp to match event type in handle() - namespaces = type.split( "." ); - type = namespaces.shift(); - namespaces.sort(); - } - ontype = type.indexOf( ":" ) < 0 && "on" + type; - - // Caller can pass in a jQuery.Event object, Object, or just an event type string - event = event[ jQuery.expando ] ? - event : - new jQuery.Event( type, typeof event === "object" && event ); - - // Trigger bitmask: & 1 for native handlers; & 2 for jQuery (always true) - event.isTrigger = onlyHandlers ? 2 : 3; - event.namespace = namespaces.join( "." ); - event.rnamespace = event.namespace ? - new RegExp( "(^|\\.)" + namespaces.join( "\\.(?:.*\\.|)" ) + "(\\.|$)" ) : - null; - - // Clean up the event in case it is being reused - event.result = undefined; - if ( !event.target ) { - event.target = elem; - } - - // Clone any incoming data and prepend the event, creating the handler arg list - data = data == null ? - [ event ] : - jQuery.makeArray( data, [ event ] ); - - // Allow special events to draw outside the lines - special = jQuery.event.special[ type ] || {}; - if ( !onlyHandlers && special.trigger && special.trigger.apply( elem, data ) === false ) { - return; - } - - // Determine event propagation path in advance, per W3C events spec (#9951) - // Bubble up to document, then to window; watch for a global ownerDocument var (#9724) - if ( !onlyHandlers && !special.noBubble && !isWindow( elem ) ) { - - bubbleType = special.delegateType || type; - if ( !rfocusMorph.test( bubbleType + type ) ) { - cur = cur.parentNode; - } - for ( ; cur; cur = cur.parentNode ) { - eventPath.push( cur ); - tmp = cur; - } - - // Only add window if we got to document (e.g., not plain obj or detached DOM) - if ( tmp === ( elem.ownerDocument || document ) ) { - eventPath.push( tmp.defaultView || tmp.parentWindow || window ); - } - } - - // Fire handlers on the event path - i = 0; - while ( ( cur = eventPath[ i++ ] ) && !event.isPropagationStopped() ) { - lastElement = cur; - event.type = i > 1 ? - bubbleType : - special.bindType || type; - - // jQuery handler - handle = ( dataPriv.get( cur, "events" ) || Object.create( null ) )[ event.type ] && - dataPriv.get( cur, "handle" ); - if ( handle ) { - handle.apply( cur, data ); - } - - // Native handler - handle = ontype && cur[ ontype ]; - if ( handle && handle.apply && acceptData( cur ) ) { - event.result = handle.apply( cur, data ); - if ( event.result === false ) { - event.preventDefault(); - } - } - } - event.type = type; - - // If nobody prevented the default action, do it now - if ( !onlyHandlers && !event.isDefaultPrevented() ) { - - if ( ( !special._default || - special._default.apply( eventPath.pop(), data ) === false ) && - acceptData( elem ) ) { - - // Call a native DOM method on the target with the same name as the event. - // Don't do default actions on window, that's where global variables be (#6170) - if ( ontype && isFunction( elem[ type ] ) && !isWindow( elem ) ) { - - // Don't re-trigger an onFOO event when we call its FOO() method - tmp = elem[ ontype ]; - - if ( tmp ) { - elem[ ontype ] = null; - } - - // Prevent re-triggering of the same event, since we already bubbled it above - jQuery.event.triggered = type; - - if ( event.isPropagationStopped() ) { - lastElement.addEventListener( type, stopPropagationCallback ); - } - - elem[ type ](); - - if ( event.isPropagationStopped() ) { - lastElement.removeEventListener( type, stopPropagationCallback ); - } - - jQuery.event.triggered = undefined; - - if ( tmp ) { - elem[ ontype ] = tmp; - } - } - } - } - - return event.result; - }, - - // Piggyback on a donor event to simulate a different one - // Used only for `focus(in | out)` events - simulate: function( type, elem, event ) { - var e = jQuery.extend( - new jQuery.Event(), - event, - { - type: type, - isSimulated: true - } - ); - - jQuery.event.trigger( e, null, elem ); - } - -} ); - -jQuery.fn.extend( { - - trigger: function( type, data ) { - return this.each( function() { - jQuery.event.trigger( type, data, this ); - } ); - }, - triggerHandler: function( type, data ) { - var elem = this[ 0 ]; - if ( elem ) { - return jQuery.event.trigger( type, data, elem, true ); - } - } -} ); - - -// Support: Firefox <=44 -// Firefox doesn't have focus(in | out) events -// Related ticket - https://bugzilla.mozilla.org/show_bug.cgi?id=687787 -// -// Support: Chrome <=48 - 49, Safari <=9.0 - 9.1 -// focus(in | out) events fire after focus & blur events, -// which is spec violation - http://www.w3.org/TR/DOM-Level-3-Events/#events-focusevent-event-order -// Related ticket - https://bugs.chromium.org/p/chromium/issues/detail?id=449857 -if ( !support.focusin ) { - jQuery.each( { focus: "focusin", blur: "focusout" }, function( orig, fix ) { - - // Attach a single capturing handler on the document while someone wants focusin/focusout - var handler = function( event ) { - jQuery.event.simulate( fix, event.target, jQuery.event.fix( event ) ); - }; - - jQuery.event.special[ fix ] = { - setup: function() { - - // Handle: regular nodes (via `this.ownerDocument`), window - // (via `this.document`) & document (via `this`). - var doc = this.ownerDocument || this.document || this, - attaches = dataPriv.access( doc, fix ); - - if ( !attaches ) { - doc.addEventListener( orig, handler, true ); - } - dataPriv.access( doc, fix, ( attaches || 0 ) + 1 ); - }, - teardown: function() { - var doc = this.ownerDocument || this.document || this, - attaches = dataPriv.access( doc, fix ) - 1; - - if ( !attaches ) { - doc.removeEventListener( orig, handler, true ); - dataPriv.remove( doc, fix ); - - } else { - dataPriv.access( doc, fix, attaches ); - } - } - }; - } ); -} -var location = window.location; - -var nonce = { guid: Date.now() }; - -var rquery = ( /\?/ ); - - - -// Cross-browser xml parsing -jQuery.parseXML = function( data ) { - var xml, parserErrorElem; - if ( !data || typeof data !== "string" ) { - return null; - } - - // Support: IE 9 - 11 only - // IE throws on parseFromString with invalid input. - try { - xml = ( new window.DOMParser() ).parseFromString( data, "text/xml" ); - } catch ( e ) {} - - parserErrorElem = xml && xml.getElementsByTagName( "parsererror" )[ 0 ]; - if ( !xml || parserErrorElem ) { - jQuery.error( "Invalid XML: " + ( - parserErrorElem ? - jQuery.map( parserErrorElem.childNodes, function( el ) { - return el.textContent; - } ).join( "\n" ) : - data - ) ); - } - return xml; -}; - - -var - rbracket = /\[\]$/, - rCRLF = /\r?\n/g, - rsubmitterTypes = /^(?:submit|button|image|reset|file)$/i, - rsubmittable = /^(?:input|select|textarea|keygen)/i; - -function buildParams( prefix, obj, traditional, add ) { - var name; - - if ( Array.isArray( obj ) ) { - - // Serialize array item. - jQuery.each( obj, function( i, v ) { - if ( traditional || rbracket.test( prefix ) ) { - - // Treat each array item as a scalar. - add( prefix, v ); - - } else { - - // Item is non-scalar (array or object), encode its numeric index. - buildParams( - prefix + "[" + ( typeof v === "object" && v != null ? i : "" ) + "]", - v, - traditional, - add - ); - } - } ); - - } else if ( !traditional && toType( obj ) === "object" ) { - - // Serialize object item. - for ( name in obj ) { - buildParams( prefix + "[" + name + "]", obj[ name ], traditional, add ); - } - - } else { - - // Serialize scalar item. - add( prefix, obj ); - } -} - -// Serialize an array of form elements or a set of -// key/values into a query string -jQuery.param = function( a, traditional ) { - var prefix, - s = [], - add = function( key, valueOrFunction ) { - - // If value is a function, invoke it and use its return value - var value = isFunction( valueOrFunction ) ? - valueOrFunction() : - valueOrFunction; - - s[ s.length ] = encodeURIComponent( key ) + "=" + - encodeURIComponent( value == null ? "" : value ); - }; - - if ( a == null ) { - return ""; - } - - // If an array was passed in, assume that it is an array of form elements. - if ( Array.isArray( a ) || ( a.jquery && !jQuery.isPlainObject( a ) ) ) { - - // Serialize the form elements - jQuery.each( a, function() { - add( this.name, this.value ); - } ); - - } else { - - // If traditional, encode the "old" way (the way 1.3.2 or older - // did it), otherwise encode params recursively. - for ( prefix in a ) { - buildParams( prefix, a[ prefix ], traditional, add ); - } - } - - // Return the resulting serialization - return s.join( "&" ); -}; - -jQuery.fn.extend( { - serialize: function() { - return jQuery.param( this.serializeArray() ); - }, - serializeArray: function() { - return this.map( function() { - - // Can add propHook for "elements" to filter or add form elements - var elements = jQuery.prop( this, "elements" ); - return elements ? jQuery.makeArray( elements ) : this; - } ).filter( function() { - var type = this.type; - - // Use .is( ":disabled" ) so that fieldset[disabled] works - return this.name && !jQuery( this ).is( ":disabled" ) && - rsubmittable.test( this.nodeName ) && !rsubmitterTypes.test( type ) && - ( this.checked || !rcheckableType.test( type ) ); - } ).map( function( _i, elem ) { - var val = jQuery( this ).val(); - - if ( val == null ) { - return null; - } - - if ( Array.isArray( val ) ) { - return jQuery.map( val, function( val ) { - return { name: elem.name, value: val.replace( rCRLF, "\r\n" ) }; - } ); - } - - return { name: elem.name, value: val.replace( rCRLF, "\r\n" ) }; - } ).get(); - } -} ); - - -var - r20 = /%20/g, - rhash = /#.*$/, - rantiCache = /([?&])_=[^&]*/, - rheaders = /^(.*?):[ \t]*([^\r\n]*)$/mg, - - // #7653, #8125, #8152: local protocol detection - rlocalProtocol = /^(?:about|app|app-storage|.+-extension|file|res|widget):$/, - rnoContent = /^(?:GET|HEAD)$/, - rprotocol = /^\/\//, - - /* Prefilters - * 1) They are useful to introduce custom dataTypes (see ajax/jsonp.js for an example) - * 2) These are called: - * - BEFORE asking for a transport - * - AFTER param serialization (s.data is a string if s.processData is true) - * 3) key is the dataType - * 4) the catchall symbol "*" can be used - * 5) execution will start with transport dataType and THEN continue down to "*" if needed - */ - prefilters = {}, - - /* Transports bindings - * 1) key is the dataType - * 2) the catchall symbol "*" can be used - * 3) selection will start with transport dataType and THEN go to "*" if needed - */ - transports = {}, - - // Avoid comment-prolog char sequence (#10098); must appease lint and evade compression - allTypes = "*/".concat( "*" ), - - // Anchor tag for parsing the document origin - originAnchor = document.createElement( "a" ); - -originAnchor.href = location.href; - -// Base "constructor" for jQuery.ajaxPrefilter and jQuery.ajaxTransport -function addToPrefiltersOrTransports( structure ) { - - // dataTypeExpression is optional and defaults to "*" - return function( dataTypeExpression, func ) { - - if ( typeof dataTypeExpression !== "string" ) { - func = dataTypeExpression; - dataTypeExpression = "*"; - } - - var dataType, - i = 0, - dataTypes = dataTypeExpression.toLowerCase().match( rnothtmlwhite ) || []; - - if ( isFunction( func ) ) { - - // For each dataType in the dataTypeExpression - while ( ( dataType = dataTypes[ i++ ] ) ) { - - // Prepend if requested - if ( dataType[ 0 ] === "+" ) { - dataType = dataType.slice( 1 ) || "*"; - ( structure[ dataType ] = structure[ dataType ] || [] ).unshift( func ); - - // Otherwise append - } else { - ( structure[ dataType ] = structure[ dataType ] || [] ).push( func ); - } - } - } - }; -} - -// Base inspection function for prefilters and transports -function inspectPrefiltersOrTransports( structure, options, originalOptions, jqXHR ) { - - var inspected = {}, - seekingTransport = ( structure === transports ); - - function inspect( dataType ) { - var selected; - inspected[ dataType ] = true; - jQuery.each( structure[ dataType ] || [], function( _, prefilterOrFactory ) { - var dataTypeOrTransport = prefilterOrFactory( options, originalOptions, jqXHR ); - if ( typeof dataTypeOrTransport === "string" && - !seekingTransport && !inspected[ dataTypeOrTransport ] ) { - - options.dataTypes.unshift( dataTypeOrTransport ); - inspect( dataTypeOrTransport ); - return false; - } else if ( seekingTransport ) { - return !( selected = dataTypeOrTransport ); - } - } ); - return selected; - } - - return inspect( options.dataTypes[ 0 ] ) || !inspected[ "*" ] && inspect( "*" ); -} - -// A special extend for ajax options -// that takes "flat" options (not to be deep extended) -// Fixes #9887 -function ajaxExtend( target, src ) { - var key, deep, - flatOptions = jQuery.ajaxSettings.flatOptions || {}; - - for ( key in src ) { - if ( src[ key ] !== undefined ) { - ( flatOptions[ key ] ? target : ( deep || ( deep = {} ) ) )[ key ] = src[ key ]; - } - } - if ( deep ) { - jQuery.extend( true, target, deep ); - } - - return target; -} - -/* Handles responses to an ajax request: - * - finds the right dataType (mediates between content-type and expected dataType) - * - returns the corresponding response - */ -function ajaxHandleResponses( s, jqXHR, responses ) { - - var ct, type, finalDataType, firstDataType, - contents = s.contents, - dataTypes = s.dataTypes; - - // Remove auto dataType and get content-type in the process - while ( dataTypes[ 0 ] === "*" ) { - dataTypes.shift(); - if ( ct === undefined ) { - ct = s.mimeType || jqXHR.getResponseHeader( "Content-Type" ); - } - } - - // Check if we're dealing with a known content-type - if ( ct ) { - for ( type in contents ) { - if ( contents[ type ] && contents[ type ].test( ct ) ) { - dataTypes.unshift( type ); - break; - } - } - } - - // Check to see if we have a response for the expected dataType - if ( dataTypes[ 0 ] in responses ) { - finalDataType = dataTypes[ 0 ]; - } else { - - // Try convertible dataTypes - for ( type in responses ) { - if ( !dataTypes[ 0 ] || s.converters[ type + " " + dataTypes[ 0 ] ] ) { - finalDataType = type; - break; - } - if ( !firstDataType ) { - firstDataType = type; - } - } - - // Or just use first one - finalDataType = finalDataType || firstDataType; - } - - // If we found a dataType - // We add the dataType to the list if needed - // and return the corresponding response - if ( finalDataType ) { - if ( finalDataType !== dataTypes[ 0 ] ) { - dataTypes.unshift( finalDataType ); - } - return responses[ finalDataType ]; - } -} - -/* Chain conversions given the request and the original response - * Also sets the responseXXX fields on the jqXHR instance - */ -function ajaxConvert( s, response, jqXHR, isSuccess ) { - var conv2, current, conv, tmp, prev, - converters = {}, - - // Work with a copy of dataTypes in case we need to modify it for conversion - dataTypes = s.dataTypes.slice(); - - // Create converters map with lowercased keys - if ( dataTypes[ 1 ] ) { - for ( conv in s.converters ) { - converters[ conv.toLowerCase() ] = s.converters[ conv ]; - } - } - - current = dataTypes.shift(); - - // Convert to each sequential dataType - while ( current ) { - - if ( s.responseFields[ current ] ) { - jqXHR[ s.responseFields[ current ] ] = response; - } - - // Apply the dataFilter if provided - if ( !prev && isSuccess && s.dataFilter ) { - response = s.dataFilter( response, s.dataType ); - } - - prev = current; - current = dataTypes.shift(); - - if ( current ) { - - // There's only work to do if current dataType is non-auto - if ( current === "*" ) { - - current = prev; - - // Convert response if prev dataType is non-auto and differs from current - } else if ( prev !== "*" && prev !== current ) { - - // Seek a direct converter - conv = converters[ prev + " " + current ] || converters[ "* " + current ]; - - // If none found, seek a pair - if ( !conv ) { - for ( conv2 in converters ) { - - // If conv2 outputs current - tmp = conv2.split( " " ); - if ( tmp[ 1 ] === current ) { - - // If prev can be converted to accepted input - conv = converters[ prev + " " + tmp[ 0 ] ] || - converters[ "* " + tmp[ 0 ] ]; - if ( conv ) { - - // Condense equivalence converters - if ( conv === true ) { - conv = converters[ conv2 ]; - - // Otherwise, insert the intermediate dataType - } else if ( converters[ conv2 ] !== true ) { - current = tmp[ 0 ]; - dataTypes.unshift( tmp[ 1 ] ); - } - break; - } - } - } - } - - // Apply converter (if not an equivalence) - if ( conv !== true ) { - - // Unless errors are allowed to bubble, catch and return them - if ( conv && s.throws ) { - response = conv( response ); - } else { - try { - response = conv( response ); - } catch ( e ) { - return { - state: "parsererror", - error: conv ? e : "No conversion from " + prev + " to " + current - }; - } - } - } - } - } - } - - return { state: "success", data: response }; -} - -jQuery.extend( { - - // Counter for holding the number of active queries - active: 0, - - // Last-Modified header cache for next request - lastModified: {}, - etag: {}, - - ajaxSettings: { - url: location.href, - type: "GET", - isLocal: rlocalProtocol.test( location.protocol ), - global: true, - processData: true, - async: true, - contentType: "application/x-www-form-urlencoded; charset=UTF-8", - - /* - timeout: 0, - data: null, - dataType: null, - username: null, - password: null, - cache: null, - throws: false, - traditional: false, - headers: {}, - */ - - accepts: { - "*": allTypes, - text: "text/plain", - html: "text/html", - xml: "application/xml, text/xml", - json: "application/json, text/javascript" - }, - - contents: { - xml: /\bxml\b/, - html: /\bhtml/, - json: /\bjson\b/ - }, - - responseFields: { - xml: "responseXML", - text: "responseText", - json: "responseJSON" - }, - - // Data converters - // Keys separate source (or catchall "*") and destination types with a single space - converters: { - - // Convert anything to text - "* text": String, - - // Text to html (true = no transformation) - "text html": true, - - // Evaluate text as a json expression - "text json": JSON.parse, - - // Parse text as xml - "text xml": jQuery.parseXML - }, - - // For options that shouldn't be deep extended: - // you can add your own custom options here if - // and when you create one that shouldn't be - // deep extended (see ajaxExtend) - flatOptions: { - url: true, - context: true - } - }, - - // Creates a full fledged settings object into target - // with both ajaxSettings and settings fields. - // If target is omitted, writes into ajaxSettings. - ajaxSetup: function( target, settings ) { - return settings ? - - // Building a settings object - ajaxExtend( ajaxExtend( target, jQuery.ajaxSettings ), settings ) : - - // Extending ajaxSettings - ajaxExtend( jQuery.ajaxSettings, target ); - }, - - ajaxPrefilter: addToPrefiltersOrTransports( prefilters ), - ajaxTransport: addToPrefiltersOrTransports( transports ), - - // Main method - ajax: function( url, options ) { - - // If url is an object, simulate pre-1.5 signature - if ( typeof url === "object" ) { - options = url; - url = undefined; - } - - // Force options to be an object - options = options || {}; - - var transport, - - // URL without anti-cache param - cacheURL, - - // Response headers - responseHeadersString, - responseHeaders, - - // timeout handle - timeoutTimer, - - // Url cleanup var - urlAnchor, - - // Request state (becomes false upon send and true upon completion) - completed, - - // To know if global events are to be dispatched - fireGlobals, - - // Loop variable - i, - - // uncached part of the url - uncached, - - // Create the final options object - s = jQuery.ajaxSetup( {}, options ), - - // Callbacks context - callbackContext = s.context || s, - - // Context for global events is callbackContext if it is a DOM node or jQuery collection - globalEventContext = s.context && - ( callbackContext.nodeType || callbackContext.jquery ) ? - jQuery( callbackContext ) : - jQuery.event, - - // Deferreds - deferred = jQuery.Deferred(), - completeDeferred = jQuery.Callbacks( "once memory" ), - - // Status-dependent callbacks - statusCode = s.statusCode || {}, - - // Headers (they are sent all at once) - requestHeaders = {}, - requestHeadersNames = {}, - - // Default abort message - strAbort = "canceled", - - // Fake xhr - jqXHR = { - readyState: 0, - - // Builds headers hashtable if needed - getResponseHeader: function( key ) { - var match; - if ( completed ) { - if ( !responseHeaders ) { - responseHeaders = {}; - while ( ( match = rheaders.exec( responseHeadersString ) ) ) { - responseHeaders[ match[ 1 ].toLowerCase() + " " ] = - ( responseHeaders[ match[ 1 ].toLowerCase() + " " ] || [] ) - .concat( match[ 2 ] ); - } - } - match = responseHeaders[ key.toLowerCase() + " " ]; - } - return match == null ? null : match.join( ", " ); - }, - - // Raw string - getAllResponseHeaders: function() { - return completed ? responseHeadersString : null; - }, - - // Caches the header - setRequestHeader: function( name, value ) { - if ( completed == null ) { - name = requestHeadersNames[ name.toLowerCase() ] = - requestHeadersNames[ name.toLowerCase() ] || name; - requestHeaders[ name ] = value; - } - return this; - }, - - // Overrides response content-type header - overrideMimeType: function( type ) { - if ( completed == null ) { - s.mimeType = type; - } - return this; - }, - - // Status-dependent callbacks - statusCode: function( map ) { - var code; - if ( map ) { - if ( completed ) { - - // Execute the appropriate callbacks - jqXHR.always( map[ jqXHR.status ] ); - } else { - - // Lazy-add the new callbacks in a way that preserves old ones - for ( code in map ) { - statusCode[ code ] = [ statusCode[ code ], map[ code ] ]; - } - } - } - return this; - }, - - // Cancel the request - abort: function( statusText ) { - var finalText = statusText || strAbort; - if ( transport ) { - transport.abort( finalText ); - } - done( 0, finalText ); - return this; - } - }; - - // Attach deferreds - deferred.promise( jqXHR ); - - // Add protocol if not provided (prefilters might expect it) - // Handle falsy url in the settings object (#10093: consistency with old signature) - // We also use the url parameter if available - s.url = ( ( url || s.url || location.href ) + "" ) - .replace( rprotocol, location.protocol + "//" ); - - // Alias method option to type as per ticket #12004 - s.type = options.method || options.type || s.method || s.type; - - // Extract dataTypes list - s.dataTypes = ( s.dataType || "*" ).toLowerCase().match( rnothtmlwhite ) || [ "" ]; - - // A cross-domain request is in order when the origin doesn't match the current origin. - if ( s.crossDomain == null ) { - urlAnchor = document.createElement( "a" ); - - // Support: IE <=8 - 11, Edge 12 - 15 - // IE throws exception on accessing the href property if url is malformed, - // e.g. http://example.com:80x/ - try { - urlAnchor.href = s.url; - - // Support: IE <=8 - 11 only - // Anchor's host property isn't correctly set when s.url is relative - urlAnchor.href = urlAnchor.href; - s.crossDomain = originAnchor.protocol + "//" + originAnchor.host !== - urlAnchor.protocol + "//" + urlAnchor.host; - } catch ( e ) { - - // If there is an error parsing the URL, assume it is crossDomain, - // it can be rejected by the transport if it is invalid - s.crossDomain = true; - } - } - - // Convert data if not already a string - if ( s.data && s.processData && typeof s.data !== "string" ) { - s.data = jQuery.param( s.data, s.traditional ); - } - - // Apply prefilters - inspectPrefiltersOrTransports( prefilters, s, options, jqXHR ); - - // If request was aborted inside a prefilter, stop there - if ( completed ) { - return jqXHR; - } - - // We can fire global events as of now if asked to - // Don't fire events if jQuery.event is undefined in an AMD-usage scenario (#15118) - fireGlobals = jQuery.event && s.global; - - // Watch for a new set of requests - if ( fireGlobals && jQuery.active++ === 0 ) { - jQuery.event.trigger( "ajaxStart" ); - } - - // Uppercase the type - s.type = s.type.toUpperCase(); - - // Determine if request has content - s.hasContent = !rnoContent.test( s.type ); - - // Save the URL in case we're toying with the If-Modified-Since - // and/or If-None-Match header later on - // Remove hash to simplify url manipulation - cacheURL = s.url.replace( rhash, "" ); - - // More options handling for requests with no content - if ( !s.hasContent ) { - - // Remember the hash so we can put it back - uncached = s.url.slice( cacheURL.length ); - - // If data is available and should be processed, append data to url - if ( s.data && ( s.processData || typeof s.data === "string" ) ) { - cacheURL += ( rquery.test( cacheURL ) ? "&" : "?" ) + s.data; - - // #9682: remove data so that it's not used in an eventual retry - delete s.data; - } - - // Add or update anti-cache param if needed - if ( s.cache === false ) { - cacheURL = cacheURL.replace( rantiCache, "$1" ); - uncached = ( rquery.test( cacheURL ) ? "&" : "?" ) + "_=" + ( nonce.guid++ ) + - uncached; - } - - // Put hash and anti-cache on the URL that will be requested (gh-1732) - s.url = cacheURL + uncached; - - // Change '%20' to '+' if this is encoded form body content (gh-2658) - } else if ( s.data && s.processData && - ( s.contentType || "" ).indexOf( "application/x-www-form-urlencoded" ) === 0 ) { - s.data = s.data.replace( r20, "+" ); - } - - // Set the If-Modified-Since and/or If-None-Match header, if in ifModified mode. - if ( s.ifModified ) { - if ( jQuery.lastModified[ cacheURL ] ) { - jqXHR.setRequestHeader( "If-Modified-Since", jQuery.lastModified[ cacheURL ] ); - } - if ( jQuery.etag[ cacheURL ] ) { - jqXHR.setRequestHeader( "If-None-Match", jQuery.etag[ cacheURL ] ); - } - } - - // Set the correct header, if data is being sent - if ( s.data && s.hasContent && s.contentType !== false || options.contentType ) { - jqXHR.setRequestHeader( "Content-Type", s.contentType ); - } - - // Set the Accepts header for the server, depending on the dataType - jqXHR.setRequestHeader( - "Accept", - s.dataTypes[ 0 ] && s.accepts[ s.dataTypes[ 0 ] ] ? - s.accepts[ s.dataTypes[ 0 ] ] + - ( s.dataTypes[ 0 ] !== "*" ? ", " + allTypes + "; q=0.01" : "" ) : - s.accepts[ "*" ] - ); - - // Check for headers option - for ( i in s.headers ) { - jqXHR.setRequestHeader( i, s.headers[ i ] ); - } - - // Allow custom headers/mimetypes and early abort - if ( s.beforeSend && - ( s.beforeSend.call( callbackContext, jqXHR, s ) === false || completed ) ) { - - // Abort if not done already and return - return jqXHR.abort(); - } - - // Aborting is no longer a cancellation - strAbort = "abort"; - - // Install callbacks on deferreds - completeDeferred.add( s.complete ); - jqXHR.done( s.success ); - jqXHR.fail( s.error ); - - // Get transport - transport = inspectPrefiltersOrTransports( transports, s, options, jqXHR ); - - // If no transport, we auto-abort - if ( !transport ) { - done( -1, "No Transport" ); - } else { - jqXHR.readyState = 1; - - // Send global event - if ( fireGlobals ) { - globalEventContext.trigger( "ajaxSend", [ jqXHR, s ] ); - } - - // If request was aborted inside ajaxSend, stop there - if ( completed ) { - return jqXHR; - } - - // Timeout - if ( s.async && s.timeout > 0 ) { - timeoutTimer = window.setTimeout( function() { - jqXHR.abort( "timeout" ); - }, s.timeout ); - } - - try { - completed = false; - transport.send( requestHeaders, done ); - } catch ( e ) { - - // Rethrow post-completion exceptions - if ( completed ) { - throw e; - } - - // Propagate others as results - done( -1, e ); - } - } - - // Callback for when everything is done - function done( status, nativeStatusText, responses, headers ) { - var isSuccess, success, error, response, modified, - statusText = nativeStatusText; - - // Ignore repeat invocations - if ( completed ) { - return; - } - - completed = true; - - // Clear timeout if it exists - if ( timeoutTimer ) { - window.clearTimeout( timeoutTimer ); - } - - // Dereference transport for early garbage collection - // (no matter how long the jqXHR object will be used) - transport = undefined; - - // Cache response headers - responseHeadersString = headers || ""; - - // Set readyState - jqXHR.readyState = status > 0 ? 4 : 0; - - // Determine if successful - isSuccess = status >= 200 && status < 300 || status === 304; - - // Get response data - if ( responses ) { - response = ajaxHandleResponses( s, jqXHR, responses ); - } - - // Use a noop converter for missing script but not if jsonp - if ( !isSuccess && - jQuery.inArray( "script", s.dataTypes ) > -1 && - jQuery.inArray( "json", s.dataTypes ) < 0 ) { - s.converters[ "text script" ] = function() {}; - } - - // Convert no matter what (that way responseXXX fields are always set) - response = ajaxConvert( s, response, jqXHR, isSuccess ); - - // If successful, handle type chaining - if ( isSuccess ) { - - // Set the If-Modified-Since and/or If-None-Match header, if in ifModified mode. - if ( s.ifModified ) { - modified = jqXHR.getResponseHeader( "Last-Modified" ); - if ( modified ) { - jQuery.lastModified[ cacheURL ] = modified; - } - modified = jqXHR.getResponseHeader( "etag" ); - if ( modified ) { - jQuery.etag[ cacheURL ] = modified; - } - } - - // if no content - if ( status === 204 || s.type === "HEAD" ) { - statusText = "nocontent"; - - // if not modified - } else if ( status === 304 ) { - statusText = "notmodified"; - - // If we have data, let's convert it - } else { - statusText = response.state; - success = response.data; - error = response.error; - isSuccess = !error; - } - } else { - - // Extract error from statusText and normalize for non-aborts - error = statusText; - if ( status || !statusText ) { - statusText = "error"; - if ( status < 0 ) { - status = 0; - } - } - } - - // Set data for the fake xhr object - jqXHR.status = status; - jqXHR.statusText = ( nativeStatusText || statusText ) + ""; - - // Success/Error - if ( isSuccess ) { - deferred.resolveWith( callbackContext, [ success, statusText, jqXHR ] ); - } else { - deferred.rejectWith( callbackContext, [ jqXHR, statusText, error ] ); - } - - // Status-dependent callbacks - jqXHR.statusCode( statusCode ); - statusCode = undefined; - - if ( fireGlobals ) { - globalEventContext.trigger( isSuccess ? "ajaxSuccess" : "ajaxError", - [ jqXHR, s, isSuccess ? success : error ] ); - } - - // Complete - completeDeferred.fireWith( callbackContext, [ jqXHR, statusText ] ); - - if ( fireGlobals ) { - globalEventContext.trigger( "ajaxComplete", [ jqXHR, s ] ); - - // Handle the global AJAX counter - if ( !( --jQuery.active ) ) { - jQuery.event.trigger( "ajaxStop" ); - } - } - } - - return jqXHR; - }, - - getJSON: function( url, data, callback ) { - return jQuery.get( url, data, callback, "json" ); - }, - - getScript: function( url, callback ) { - return jQuery.get( url, undefined, callback, "script" ); - } -} ); - -jQuery.each( [ "get", "post" ], function( _i, method ) { - jQuery[ method ] = function( url, data, callback, type ) { - - // Shift arguments if data argument was omitted - if ( isFunction( data ) ) { - type = type || callback; - callback = data; - data = undefined; - } - - // The url can be an options object (which then must have .url) - return jQuery.ajax( jQuery.extend( { - url: url, - type: method, - dataType: type, - data: data, - success: callback - }, jQuery.isPlainObject( url ) && url ) ); - }; -} ); - -jQuery.ajaxPrefilter( function( s ) { - var i; - for ( i in s.headers ) { - if ( i.toLowerCase() === "content-type" ) { - s.contentType = s.headers[ i ] || ""; - } - } -} ); - - -jQuery._evalUrl = function( url, options, doc ) { - return jQuery.ajax( { - url: url, - - // Make this explicit, since user can override this through ajaxSetup (#11264) - type: "GET", - dataType: "script", - cache: true, - async: false, - global: false, - - // Only evaluate the response if it is successful (gh-4126) - // dataFilter is not invoked for failure responses, so using it instead - // of the default converter is kludgy but it works. - converters: { - "text script": function() {} - }, - dataFilter: function( response ) { - jQuery.globalEval( response, options, doc ); - } - } ); -}; - - -jQuery.fn.extend( { - wrapAll: function( html ) { - var wrap; - - if ( this[ 0 ] ) { - if ( isFunction( html ) ) { - html = html.call( this[ 0 ] ); - } - - // The elements to wrap the target around - wrap = jQuery( html, this[ 0 ].ownerDocument ).eq( 0 ).clone( true ); - - if ( this[ 0 ].parentNode ) { - wrap.insertBefore( this[ 0 ] ); - } - - wrap.map( function() { - var elem = this; - - while ( elem.firstElementChild ) { - elem = elem.firstElementChild; - } - - return elem; - } ).append( this ); - } - - return this; - }, - - wrapInner: function( html ) { - if ( isFunction( html ) ) { - return this.each( function( i ) { - jQuery( this ).wrapInner( html.call( this, i ) ); - } ); - } - - return this.each( function() { - var self = jQuery( this ), - contents = self.contents(); - - if ( contents.length ) { - contents.wrapAll( html ); - - } else { - self.append( html ); - } - } ); - }, - - wrap: function( html ) { - var htmlIsFunction = isFunction( html ); - - return this.each( function( i ) { - jQuery( this ).wrapAll( htmlIsFunction ? html.call( this, i ) : html ); - } ); - }, - - unwrap: function( selector ) { - this.parent( selector ).not( "body" ).each( function() { - jQuery( this ).replaceWith( this.childNodes ); - } ); - return this; - } -} ); - - -jQuery.expr.pseudos.hidden = function( elem ) { - return !jQuery.expr.pseudos.visible( elem ); -}; -jQuery.expr.pseudos.visible = function( elem ) { - return !!( elem.offsetWidth || elem.offsetHeight || elem.getClientRects().length ); -}; - - - - -jQuery.ajaxSettings.xhr = function() { - try { - return new window.XMLHttpRequest(); - } catch ( e ) {} -}; - -var xhrSuccessStatus = { - - // File protocol always yields status code 0, assume 200 - 0: 200, - - // Support: IE <=9 only - // #1450: sometimes IE returns 1223 when it should be 204 - 1223: 204 - }, - xhrSupported = jQuery.ajaxSettings.xhr(); - -support.cors = !!xhrSupported && ( "withCredentials" in xhrSupported ); -support.ajax = xhrSupported = !!xhrSupported; - -jQuery.ajaxTransport( function( options ) { - var callback, errorCallback; - - // Cross domain only allowed if supported through XMLHttpRequest - if ( support.cors || xhrSupported && !options.crossDomain ) { - return { - send: function( headers, complete ) { - var i, - xhr = options.xhr(); - - xhr.open( - options.type, - options.url, - options.async, - options.username, - options.password - ); - - // Apply custom fields if provided - if ( options.xhrFields ) { - for ( i in options.xhrFields ) { - xhr[ i ] = options.xhrFields[ i ]; - } - } - - // Override mime type if needed - if ( options.mimeType && xhr.overrideMimeType ) { - xhr.overrideMimeType( options.mimeType ); - } - - // X-Requested-With header - // For cross-domain requests, seeing as conditions for a preflight are - // akin to a jigsaw puzzle, we simply never set it to be sure. - // (it can always be set on a per-request basis or even using ajaxSetup) - // For same-domain requests, won't change header if already provided. - if ( !options.crossDomain && !headers[ "X-Requested-With" ] ) { - headers[ "X-Requested-With" ] = "XMLHttpRequest"; - } - - // Set headers - for ( i in headers ) { - xhr.setRequestHeader( i, headers[ i ] ); - } - - // Callback - callback = function( type ) { - return function() { - if ( callback ) { - callback = errorCallback = xhr.onload = - xhr.onerror = xhr.onabort = xhr.ontimeout = - xhr.onreadystatechange = null; - - if ( type === "abort" ) { - xhr.abort(); - } else if ( type === "error" ) { - - // Support: IE <=9 only - // On a manual native abort, IE9 throws - // errors on any property access that is not readyState - if ( typeof xhr.status !== "number" ) { - complete( 0, "error" ); - } else { - complete( - - // File: protocol always yields status 0; see #8605, #14207 - xhr.status, - xhr.statusText - ); - } - } else { - complete( - xhrSuccessStatus[ xhr.status ] || xhr.status, - xhr.statusText, - - // Support: IE <=9 only - // IE9 has no XHR2 but throws on binary (trac-11426) - // For XHR2 non-text, let the caller handle it (gh-2498) - ( xhr.responseType || "text" ) !== "text" || - typeof xhr.responseText !== "string" ? - { binary: xhr.response } : - { text: xhr.responseText }, - xhr.getAllResponseHeaders() - ); - } - } - }; - }; - - // Listen to events - xhr.onload = callback(); - errorCallback = xhr.onerror = xhr.ontimeout = callback( "error" ); - - // Support: IE 9 only - // Use onreadystatechange to replace onabort - // to handle uncaught aborts - if ( xhr.onabort !== undefined ) { - xhr.onabort = errorCallback; - } else { - xhr.onreadystatechange = function() { - - // Check readyState before timeout as it changes - if ( xhr.readyState === 4 ) { - - // Allow onerror to be called first, - // but that will not handle a native abort - // Also, save errorCallback to a variable - // as xhr.onerror cannot be accessed - window.setTimeout( function() { - if ( callback ) { - errorCallback(); - } - } ); - } - }; - } - - // Create the abort callback - callback = callback( "abort" ); - - try { - - // Do send the request (this may raise an exception) - xhr.send( options.hasContent && options.data || null ); - } catch ( e ) { - - // #14683: Only rethrow if this hasn't been notified as an error yet - if ( callback ) { - throw e; - } - } - }, - - abort: function() { - if ( callback ) { - callback(); - } - } - }; - } -} ); - - - - -// Prevent auto-execution of scripts when no explicit dataType was provided (See gh-2432) -jQuery.ajaxPrefilter( function( s ) { - if ( s.crossDomain ) { - s.contents.script = false; - } -} ); - -// Install script dataType -jQuery.ajaxSetup( { - accepts: { - script: "text/javascript, application/javascript, " + - "application/ecmascript, application/x-ecmascript" - }, - contents: { - script: /\b(?:java|ecma)script\b/ - }, - converters: { - "text script": function( text ) { - jQuery.globalEval( text ); - return text; - } - } -} ); - -// Handle cache's special case and crossDomain -jQuery.ajaxPrefilter( "script", function( s ) { - if ( s.cache === undefined ) { - s.cache = false; - } - if ( s.crossDomain ) { - s.type = "GET"; - } -} ); - -// Bind script tag hack transport -jQuery.ajaxTransport( "script", function( s ) { - - // This transport only deals with cross domain or forced-by-attrs requests - if ( s.crossDomain || s.scriptAttrs ) { - var script, callback; - return { - send: function( _, complete ) { - script = jQuery( " - - - - - Contents - - - - - - Menu - - - - - - - - Expand - - - - - - Light mode - - - - - - - - - - - - - - Dark mode - - - - - - - Auto light/dark mode - - - - - - - - - - - - - - - - - - - -
      -
      -
      - -
      -
      -
      Pressio-Ops-0.14.0
       -
      -
      -
      - -
      - -
      -
      - -
      -
      -
      - - - - - Back to top - -
      -
      - -
      - -
      -
      -
      -

      expressions#

      -

      Defined in header: <pressio/expressions.hpp>

      -

      Public namespace: pressio

      -

      We refer to these as expressions because each function does not allocate -new memory but only creates an instance of a class that “represents” the given operation.

      -

      In all cases, the returned expression remains valid until its operand goes out of scope. -If the operand goes out of scope, the state of the expression is undefined.

      -
      - -
      -
      - -
      -
      - -
      - -
      -
      - - - - - - - - - \ No newline at end of file diff --git a/docs/generated_docs/components/expressions/diag.html b/docs/generated_docs/components/expressions/diag.html deleted file mode 100644 index e0b72ae..0000000 --- a/docs/generated_docs/components/expressions/diag.html +++ /dev/null @@ -1,344 +0,0 @@ - - - - - - - - - diagonal - Pressio-Ops-0.14.0 - - - - - - - - - - - - - - - - - - Contents - - - - - - Menu - - - - - - - - Expand - - - - - - Light mode - - - - - - - - - - - - - - Dark mode - - - - - - - Auto light/dark mode - - - - - - - - - - - - - - - - - - - -
      -
      -
      - -
      -
      -
      Pressio-Ops-0.14.0
       -
      -
      -
      - -
      - -
      -
      - -
      -
      -
      - - - - - Back to top - -
      -
      - -
      - -
      -
      -
      -

      diagonal#

      -

      Header: <pressio/expressions.hpp>

      -
      -

      API#

      -
      namespace pressio {
-
-template<class T>
-/*impl defined*/ diagonal(T & operand);
-
-} // end namespace pressio
-
      -
      -
      -
      -

      Description#

      -
        -

      • Takes in an operand that is either:

        -
        -
          -

        • a square Eigen dense matrix, pressio::is_dense_matrix_eigen<T>::value == true

          • -

        • a square Kokkos rank-2 view, i.e. pressio::is_dense_matrix_kokkos<T>::value == true

          • -
        -
        -
        • -

      • Returns an expression that represents that diagonal of operand

        • -
      -
      -
      - -
      -
      - -
      - -
      -
      - - - - - - - - - \ No newline at end of file diff --git a/docs/generated_docs/components/expressions/span.html b/docs/generated_docs/components/expressions/span.html deleted file mode 100644 index cbe4da5..0000000 --- a/docs/generated_docs/components/expressions/span.html +++ /dev/null @@ -1,352 +0,0 @@ - - - - - - - - - span - Pressio-Ops-0.14.0 - - - - - - - - - - - - - - - - - - Contents - - - - - - Menu - - - - - - - - Expand - - - - - - Light mode - - - - - - - - - - - - - - Dark mode - - - - - - - Auto light/dark mode - - - - - - - - - - - - - - - - - - - -
      -
      -
      - -
      -
      -
      Pressio-Ops-0.14.0
       -
      -
      -
      - -
      - -
      -
      - -
      -
      -
      - - - - - Back to top - -
      -
      - -
      - -
      -
      -
      -

      span#

      -

      Header: <pressio/expressions.hpp>

      -
      -

      API#

      -
      namespace pressio {
-
-template<class T>
-/*impl defined*/ span(T & operand,
-                      std::pair<std::size_t, std::size_t> indexRange);
-
-} // end namespace pressio
-
      -
      -
      -
      -

      Description#

      -
        -

      • Takes in an operand and an indexRange

        -
        -
          -

        • operand is either:

          -
          -
            -

          • an Eigen vector object: pressio::is_vector_eigen<T>::value == true

            • -

          • a Kokkos rank-1 view, i.e. pressio::is_vector_kokkos<T>::value == true

            • -
          -
          -
          • -

        • indexRange is a std::pairidentifying an interval [a, b) where the second index is exclusive

          • -
        -
        -
        • -

      • Returns an expression that represents the target span of the operand.

        • -
      -
      -
      - -
      -
      - -
      - -
      -
      - - - - - - - - - \ No newline at end of file diff --git a/docs/generated_docs/components/expressions/subspan.html b/docs/generated_docs/components/expressions/subspan.html deleted file mode 100644 index 4c91bb7..0000000 --- a/docs/generated_docs/components/expressions/subspan.html +++ /dev/null @@ -1,352 +0,0 @@ - - - - - - - - - subspan - Pressio-Ops-0.14.0 - - - - - - - - - - - - - - - - - - Contents - - - - - - Menu - - - - - - - - Expand - - - - - - Light mode - - - - - - - - - - - - - - Dark mode - - - - - - - Auto light/dark mode - - - - - - - - - - - - - - - - - - - -
      -
      -
      - -
      -
      -
      Pressio-Ops-0.14.0
       -
      -
      -
      - -
      - -
      -
      - -
      -
      -
      - - - - - Back to top - -
      -
      - -
      - -
      -
      -
      -

      subspan#

      -

      Header: <pressio/expressions.hpp>

      -
      -

      API#

      -
      namespace pressio {
-
-template<class T>
-/*impl defined*/ subspan(T & operand,
-                         std::pair<std::size_t, std::size_t> rowsRange,
-                         std::pair<std::size_t, std::size_t> colsRange);
-
-} // end namespace pressio
-
      -
      -
      -
      -

      Description#

      -
        -

      • Takes in an operand, as well as the rowsRange and colsRange intervals that will be used in each dimension

        -
        -
          -

        • operand is either:

          -
          -
            -

          • an Eigen dense matrix, pressio::is_dense_matrix_eigen<T>::value == true

            • -

          • a Kokkos rank-2 view, i.e. pressio::is_dense_matrix_kokkos<T>::value == true

            • -
          -
          -
          • -
        -
        -
        • -

      • Returns an expression object that represents a subspan of the operand.

        • -
      -
      -
      - -
      -
      - -
      - -
      -
      - - - - - - - - - \ No newline at end of file diff --git a/docs/generated_docs/components/mpl.html b/docs/generated_docs/components/mpl.html deleted file mode 100644 index 6ef1490..0000000 --- a/docs/generated_docs/components/mpl.html +++ /dev/null @@ -1,394 +0,0 @@ - - - - - - - - - mpl - Pressio-Ops-0.14.0 - - - - - - - - - - - - - - - - - - Contents - - - - - - Menu - - - - - - - - Expand - - - - - - Light mode - - - - - - - - - - - - - - Dark mode - - - - - - - Auto light/dark mode - - - - - - - - - - - - - - - - - - - -
      -
      -
      - -
      -
      -
      Pressio-Ops-0.14.0
       -
      -
      -
      - -
      - -
      -
      - -
      -
      -
      - - - - - Back to top - -
      -
      - -
      - -
      -
      -
      -

      mpl#

      -

      Header: <pressio/mpl.hpp>

      -

      Public namespace: pressio::mpl

      -
      -

      Scope#

      -

      Provides metaprogramming functionalities needed to -support generic programming, which is a fundamental -building block of the pressio library. -If you are familiar with the <type_traits> header from -the standard library, the pressio/mpl will look familiar too. -Some parts of pressio/mpl have been adapted from the tinympl project. -The tinympl project appears to be no longer maintained.

      -

      The following is a partial list only intended to provide a general idea of the supported features.

      -

      To find out all supported cases, browse the source.

      -
      -

      pressio::mpl::all_of#

      -
      template< template<class ... T> class F, class ... Args> struct all_of;
-
      -
      -
        -

      • Determines whether every element in the sequence satisfies the given predicate. -The predicate F must be such that F<T>::value must be convertible to bool. -Provides the static member constant value that is equal to true iff -all the elements in the sequence satisfy the predicate F. -Otherwise, value is false.

        • -

      • Example:

        -
        namespace pmpl = pressio::mpl;
-static_assert(pmpl::all_of<std::is_floating_point, double, float>::value, "" );
-
        -
        -
        • -
      -
      -
      -

      pressio::mpl::any_of#

      -
      template< template<class ... T> class F, class ... Args> struct any_of;
-
      -
      -
        -

      • Determines whether any element in the sequence satisfies the given predicate. -The predicate F must be such that F<T>::value must be convertible to bool. -Provides the static member constant value that is equal to true iff -at least one element in the sequence satisfies the predicate F. -Otherwise, value is equal to false.

        • -
      -
      -
      -

      pressio::mpl::none_of#

      -
      template< template<class ... T> class F, class ... Args> struct none_of;
-
      -
      -
        -

      • Determines whether none of the elements in the sequence satisfy the given predicate. -The predicate F must be such that F<T>::value must be convertible to bool. -Provides the static member constant value that is equal to true iff -none of the elements in the sequence satisfy the predicate F. -Otherwise, value is equal to false.

        • -
      -
      -
      -

      pressio::mpl::is_subscriptable_as#

      -
      template<class T, class IndexType> struct is_subscriptable_as;
-
      -
      -
        -

      • Provides the static member constant value that is equal to true if -T has subscript operator [], it can be indexed by an instance of IndexType, -and the return type is not void. -Otherwise, value is equal to false.

        • -
      -
      -
      -
      - -
      -
      - -
      - -
      -
      - - - - - - - - - \ No newline at end of file diff --git a/docs/generated_docs/components/ops.html b/docs/generated_docs/components/ops.html deleted file mode 100644 index 5d75fc1..0000000 --- a/docs/generated_docs/components/ops.html +++ /dev/null @@ -1,423 +0,0 @@ - - - - - - - - - ops - Pressio-Ops-0.14.0 - - - - - - - - - - - - - - - - - - Contents - - - - - - Menu - - - - - - - - Expand - - - - - - Light mode - - - - - - - - - - - - - - Dark mode - - - - - - - Auto light/dark mode - - - - - - - - - - - - - - - - - - - -
      -
      -
      - -
      -
      -
      Pressio-Ops-0.14.0
       -
      -
      -
      - -
      - -
      -
      - -
      -
      -
      - - - - - Back to top - -
      -
      - -
      - -
      -
      -
      -

      ops#

      -

      Header: <pressio/ops.hpp>

      -

      Public namespace: pressio::ops

      -

      Pressio operations are generalized to work on a variety of container types and backends.

      -
      -

      Types#

      -

      The following table holds both the types supported throughout the ops directory and the -built-in booleans that confirm if a given type T is the expected type.

      -

      All expressions are within the pressio namespace.

      -
      - ----- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -

      Container Type

      Rank-1 Check

      Rank-2 Check

      Eigen

      is_vector_eigen<T>::value

      is_sparse_matrix_eigen<T>::value, is_dense_matrix_eigen<T>::value

      Kokkos

      is_vector_kokkos<T>::value

      is_dense_matrix_kokkos<T>::value, is_sparse_matrix_kokkos<T>::value

      Epetra

      is_vector_epetra<T>::value

      is_multi_vector_epetra<T>::value

      Tpetra

      is_vector_tpetra<T>::value

      is_multi_vector_tpetra<T>::value

      Tpetra Block

      is_vector_tpetra_block<T>::value

      is_multi_vector_tpetra_block<T>::value

      Teuchos

      is_dense_vector_teuchos<T>::value

      is_dense_matrix_teuchos<T>::value

      -
      -

      Additionally, because Pressio features expressions for containers built on Eigen, Kokkos, and Tpetra, you can check whether or not a container is native with:

      -
      - ----- - - - - - - - - - - - - - - - - - - - - -

      Container Type

      Native

      Pressio Expression

      Eigen

      is_native_container_eigen<T>::value

      is_expression_acting_on_eigen<T>::value

      Kokkos

      is_native_container_kokkos<T>::value

      is_expression_acting_on_kokkos<T>::value

      Tpetra

      is_expression_column_acting_on_tpetra<T>::value

      -
      -
      - -
      - -
      -
      - -
      - -
      -
      - - - - - - - - - \ No newline at end of file diff --git a/docs/generated_docs/components/ops/abs.html b/docs/generated_docs/components/ops/abs.html deleted file mode 100644 index 95362d6..0000000 --- a/docs/generated_docs/components/ops/abs.html +++ /dev/null @@ -1,354 +0,0 @@ - - - - - - - - - abs - Pressio-Ops-0.14.0 - - - - - - - - - - - - - - - - - - Contents - - - - - - Menu - - - - - - - - Expand - - - - - - Light mode - - - - - - - - - - - - - - Dark mode - - - - - - - Auto light/dark mode - - - - - - - - - - - - - - - - - - - -
      -
      -
      - -
      -
      -
      Pressio-Ops-0.14.0
       -
      -
      -
      - -
      - -
      -
      - -
      -
      -
      - - - - - Back to top - -
      -
      - -
      - -
      -
      -
      -

      abs#

      -

      Header: <pressio/ops.hpp>

      -
      -

      API#

      -
      namespace pressio { namespace ops{
-
-template<class T1, class T2>
-void abs(T1 & x, const T2 & y);
-
-}} // end namespace pressio::ops
-
      -
      -
      -
      -

      Description#

      -
        -

      • Computes the element-wise absolute value of each element -in the operand x and stores the result in y.

        • -

      • T1 and T2 must be one-dimensional containers with compatible scalar types:

        -
          -

        • an Eigen vector

          • -

        • a Kokkos rank-1 view

          • -

        • a Tpetra vector

          • -

        • a Tpetra block vector

          • -

        • a Epetra vector

          • -

        • a Pressio expression, i.e. pressio::diag, pressio::span, pressio::subspan, based on Eigen or Kokkos container

          • -
        -
        • -
      -
      -
      -

      Notes#

      -
        -

      • See the ops homepage for a table of booleans to use when checking that T1 and T2 have the correct types.

        • -
      -
      -
      - -
      -
      - -
      - -
      -
      - - - - - - - - - \ No newline at end of file diff --git a/docs/generated_docs/components/ops/add_to_diagonal.html b/docs/generated_docs/components/ops/add_to_diagonal.html deleted file mode 100644 index 4413812..0000000 --- a/docs/generated_docs/components/ops/add_to_diagonal.html +++ /dev/null @@ -1,346 +0,0 @@ - - - - - - - - - add_to_diagonal - Pressio-Ops-0.14.0 - - - - - - - - - - - - - - - - - - Contents - - - - - - Menu - - - - - - - - Expand - - - - - - Light mode - - - - - - - - - - - - - - Dark mode - - - - - - - Auto light/dark mode - - - - - - - - - - - - - - - - - - - -
      -
      -
      - -
      -
      -
      Pressio-Ops-0.14.0
       -
      -
      -
      - -
      - -
      -
      - -
      -
      -
      - - - - - Back to top - -
      -
      - -
      - -
      -
      -
      -

      add_to_diagonal#

      -

      Header: <pressio/ops.hpp>

      -
      -

      API#

      -
      namespace pressio { namespace ops{
-
-template<class T1, class ScalarType>
-void add_to_diagonal(T1 & operand, const ScalarType & value);
-
-}} // end namespace pressio::ops
-
      -
      -
      -
      -

      Description#

      -
        -

      • Adds the specified scalar value to each diagonal element of operand

        • -

      • T must be a rank-2 Eigen matrix

        • -

      • ScalarType must be convertible to pressio::Traits<T>::scalar_type

        • -
      -
      -
      -

      Notes#

      -
        -

      • If the diagonal entries of operand are written, then all diagonal entries must already exist.

        • -

      • See the ops homepage for a table of booleans to use when checking that T1 has the correct type.

        • -
      -
      -
      - -
      -
      - -
      - -
      -
      - - - - - - - - - \ No newline at end of file diff --git a/docs/generated_docs/components/ops/clone.html b/docs/generated_docs/components/ops/clone.html deleted file mode 100644 index 3250b4e..0000000 --- a/docs/generated_docs/components/ops/clone.html +++ /dev/null @@ -1,372 +0,0 @@ - - - - - - - - - clone - Pressio-Ops-0.14.0 - - - - - - - - - - - - - - - - - - Contents - - - - - - Menu - - - - - - - - Expand - - - - - - Light mode - - - - - - - - - - - - - - Dark mode - - - - - - - Auto light/dark mode - - - - - - - - - - - - - - - - - - - -
      -
      -
      - -
      -
      -
      Pressio-Ops-0.14.0
       -
      -
      -
      - -
      - -
      -
      - -
      -
      -
      - - - - - Back to top - -
      -
      - -
      - -
      -
      -
      -

      clone#

      -

      Header: <pressio/ops.hpp>

      -
      -

      API#

      -
      namespace pressio { namespace ops{
-
-template<class T>
-T clone(const T & operand);
-
-}} // end namespace pressio::ops
-
      -
      -
      -
      -

      Description#

      -
        -

      • Creates and returns a new instance of T by making a new allocation -and copying all values from operand into it.

        -
          -

        • It is an exact but independent clone of operand.

          • -
        -
        • -

      • T must be:

        -
          -

        • an Eigen vector or matrix object

          • -

        • a Kokkos view

          • -

        • a Teuchos vector

          • -

        • or an Epetra vector or multi-vector

          • -

        • or a Tpetra vector or multi-vector

          • -

        • or a Tpetra block vector or multi-vector

          • -
        -
        • -
      -
      -
      -

      Notes#

      -
        -

      • This is a blocking operation, i.e. the kernel completes before returning.

        • -

      • This kernel has value semantics, even for types that, by default, -have view semantics like Kokkos, Tpetra or TpetraBlock. -This means the following: -let auto result = clone(operand), then any operation applied -to operand after calling clone will NOT -have any impact on result. -And any operation applied to result will not have any impact on operand.

        • -

      • For types that have value semantics, for example Eigen::Matrix<...>, -Epetra vector or MV, this kernel can be implemented by calling the copy constructor -and returning the copy

        • -

      • For Kokkos, Tpetra, or TpetraBlock data types, which by default have view semantics -(i.e. a copy is a shallow copy), the operation can be implemented by first making a new -object with extents identical to operand, followed by a deep copy, and then return the result.

        • -

      • See the ops homepage for a table of booleans to use when checking that T has the correct type.

        • -
      -
      -
      - -
      -
      - -
      - -
      -
      - - - - - - - - - \ No newline at end of file diff --git a/docs/generated_docs/components/ops/deep_copy.html b/docs/generated_docs/components/ops/deep_copy.html deleted file mode 100644 index e5f2c1e..0000000 --- a/docs/generated_docs/components/ops/deep_copy.html +++ /dev/null @@ -1,359 +0,0 @@ - - - - - - - - - deep_copy - Pressio-Ops-0.14.0 - - - - - - - - - - - - - - - - - - Contents - - - - - - Menu - - - - - - - - Expand - - - - - - Light mode - - - - - - - - - - - - - - Dark mode - - - - - - - Auto light/dark mode - - - - - - - - - - - - - - - - - - - -
      -
      -
      - -
      -
      -
      Pressio-Ops-0.14.0
       -
      -
      -
      - -
      - -
      -
      - -
      -
      -
      - - - - - Back to top - -
      -
      - -
      - -
      -
      -
      -

      deep_copy#

      -

      Header: <pressio/ops.hpp>

      -
      -

      API#

      -
      namespace pressio { namespace ops{
-
-template<typename T1, typename T2>
-void deep_copy(T2 & dest, const T1 & src);
-
-template<typename T>
-void deep_copy(T & dest, const T & src);
-
-}} // end namespace pressio::ops
-
      -
      -
      -
      -

      Description#

      -
        -

      • Copies all elements from src into dst, so that dst is fully independent of src.

        • -

      • T1 and T2 must have the same rank, and must be:

        -
          -

        • Two Eigen-based containers (either a native Eigen container or a Pressio expression based on an Eigen container)

          • -

        • Two Kokkos-based containers (either a native Kokkos view or a Pressio expression based on a Kokkos container)

          • -
        -
        • -

      • T must be:

        -
          -

        • a Tpetra vector or multi-vector

          • -

        • a Tpetra block vector or multi-vector

          • -

        • a Epetra vector or multi-vector

          • -
        -
        • -
      -
      -
      -

      Notes#

      -
        -

      • See the ops homepage for a table of booleans to use when checking that T, T1, and T2 have the correct types.

        • -
      -
      -
      - -
      -
      - -
      - -
      -
      - - - - - - - - - \ No newline at end of file diff --git a/docs/generated_docs/components/ops/dot.html b/docs/generated_docs/components/ops/dot.html deleted file mode 100644 index 325b6be..0000000 --- a/docs/generated_docs/components/ops/dot.html +++ /dev/null @@ -1,360 +0,0 @@ - - - - - - - - - dot - Pressio-Ops-0.14.0 - - - - - - - - - - - - - - - - - - Contents - - - - - - Menu - - - - - - - - Expand - - - - - - Light mode - - - - - - - - - - - - - - Dark mode - - - - - - - Auto light/dark mode - - - - - - - - - - - - - - - - - - - -
      -
      -
      - -
      -
      -
      Pressio-Ops-0.14.0
       -
      -
      -
      - -
      - -
      -
      - -
      -
      -
      - - - - - Back to top - -
      -
      - -
      - -
      -
      -
      -

      dot#

      -

      Header: <pressio/ops.hpp>

      -
      -

      API#

      -
      namespace pressio { namespace ops{
-
-template<typename T1, typename T2, typename DotResult>
-void dot(const T1 & vecA, const T2 & vecB, DotResult & result);
-
-template<typename T1, typename T2>
-scalar_type dot(const T1 & vecA, const T2 & vecB);
-
-}} // end namespace pressio::ops
-
      -
      -
      -
      -

      Description#

      -
        -

      • Computes the dot product of two compatible vectors (vecA and vecB)

        -
          -

        • Stores the result in result if provided; otherwise, returns the result

          • -
        -
        • -

      • T1 and T2 must be one-dimensional containers with compatible scalar types:

        -
          -

        • an Eigen vector

          • -

        • a Kokkos rank-1 view

          • -

        • a Tpetra vector

          • -

        • a Tpetra block vector

          • -

        • a Epetra vector

          • -

        • a pressio expression, i.e. pressio::diag, pressio::span, pressio::subspan, based on Eigen or Kokkos container

          • -
        -
        • -
      -
      -
      -

      Notes#

      -
        -

      • See the ops homepage for a table of booleans to use when checking that T1 and T2 have the correct types.

        • -
      -
      -
      - -
      -
      - -
      - -
      -
      - - - - - - - - - \ No newline at end of file diff --git a/docs/generated_docs/components/ops/elementwise_multiply.html b/docs/generated_docs/components/ops/elementwise_multiply.html deleted file mode 100644 index 312a627..0000000 --- a/docs/generated_docs/components/ops/elementwise_multiply.html +++ /dev/null @@ -1,359 +0,0 @@ - - - - - - - - - elementwise_multiply - Pressio-Ops-0.14.0 - - - - - - - - - - - - - - - - - - Contents - - - - - - Menu - - - - - - - - Expand - - - - - - Light mode - - - - - - - - - - - - - - Dark mode - - - - - - - Auto light/dark mode - - - - - - - - - - - - - - - - - - - -
      -
      -
      - -
      -
      -
      Pressio-Ops-0.14.0
       -
      -
      -
      - -
      - -
      -
      - -
      -
      -
      - - - - - Back to top - -
      -
      - -
      - -
      -
      -
      -

      elementwise_multiply#

      -

      Header: <pressio/ops.hpp>

      -
      -

      API#

      -
      namespace pressio { namespace ops{
-
-template <class T, class T1, class T2, class alpha_t, class beta_t>
-void elementwise_multiply(
-    const alpha_t & alpha,
-    const T & x,
-    const T1 & z,
-    const beta_t & beta,
-    T2 & y
-);
-
-}} // end namespace pressio::ops
-
      -
      -
      -
      -

      Description#

      -
        -

      • Computes y = beta * y + alpha * (x ⊙ z), where ⊙ denotes element-wise multiplication, and stores the result in y

        • -

      • T, T1, and T2 must be one-dimensional containers with compatible scalar types:

        -
          -

        • an Eigen vector

          • -

        • a Kokkos rank-1 view

          • -

        • a Tpetra vector

          • -

        • a Tpetra block vector

          • -

        • a Epetra vector

          • -

        • a pressio expression, i.e. pressio::diag, pressio::span, pressio::subspan, based on Eigen or Kokkos container

          • -
        -
        • -
      -
      -
      -

      Notes#

      -
        -

      • See the ops homepage for a table of booleans to use when checking that T, T1, and T2 have the correct types.

        • -
      -
      -
      - -
      -
      - -
      - -
      -
      - - - - - - - - - \ No newline at end of file diff --git a/docs/generated_docs/components/ops/extent.html b/docs/generated_docs/components/ops/extent.html deleted file mode 100644 index 849104d..0000000 --- a/docs/generated_docs/components/ops/extent.html +++ /dev/null @@ -1,354 +0,0 @@ - - - - - - - - - extent - Pressio-Ops-0.14.0 - - - - - - - - - - - - - - - - - - Contents - - - - - - Menu - - - - - - - - Expand - - - - - - Light mode - - - - - - - - - - - - - - Dark mode - - - - - - - Auto light/dark mode - - - - - - - - - - - - - - - - - - - -
      -
      -
      - -
      -
      -
      Pressio-Ops-0.14.0
       -
      -
      -
      - -
      - -
      -
      - -
      -
      -
      - - - - - Back to top - -
      -
      - -
      - -
      -
      -
      -

      extent#

      -

      Header: <pressio/ops.hpp>

      -
      -

      API#

      -
      namespace pressio { namespace ops{
-
-template<class T, class IndexType>
-std::size_t extent(const T & objectIn, const IndexType i);
-
-}} // end namespace pressio::ops
-
      -
      -
      -
      -

      Description#

      -
        -

      • Returns the size or dimension of a container objectIn along a specified axis i

        • -

      • T must be one of the following:

        -
          -

        • an Eigen vector or matrix object

          • -

        • a Kokkos view

          • -

        • a Teuchos vector

          • -

        • a Tpetra vector or multi-vector

          • -

        • a Tpetra block vector or multi-vector

          • -

        • a Epetra vector or multi-vector

          • -

        • a pressio expression, i.e. pressio::diag, pressio::span, pressio::subspan, based on an Eigen, Tpetra Block, or Kokkos container

          • -
        -
        • -
      -
      -
      -

      Notes#

      -
        -

      • See the ops homepage for a table of booleans to use when checking that T has the correct type.

        • -
      -
      -
      - -
      -
      - -
      - -
      -
      - - - - - - - - - \ No newline at end of file diff --git a/docs/generated_docs/components/ops/fill.html b/docs/generated_docs/components/ops/fill.html deleted file mode 100644 index 20c11b3..0000000 --- a/docs/generated_docs/components/ops/fill.html +++ /dev/null @@ -1,355 +0,0 @@ - - - - - - - - - fill - Pressio-Ops-0.14.0 - - - - - - - - - - - - - - - - - - Contents - - - - - - Menu - - - - - - - - Expand - - - - - - Light mode - - - - - - - - - - - - - - Dark mode - - - - - - - Auto light/dark mode - - - - - - - - - - - - - - - - - - - -
      -
      -
      - -
      -
      -
      Pressio-Ops-0.14.0
       -
      -
      -
      - -
      - -
      -
      - -
      -
      -
      - - - - - Back to top - -
      -
      - -
      - -
      -
      -
      -

      fill#

      -

      Header: <pressio/ops.hpp>

      -
      -

      API#

      -
      namespace pressio { namespace ops{
-
-template<class T, class ScalarType>
-void fill(T & operand, ScalarType const & value);
-
-}} // end namespace pressio::ops
-
      -
      -
      -
      -

      Description#

      -
        -

      • Overwrites each element of operand with value.

        • -

      • T must be:

        -
          -

        • an Eigen vector or matrix object

          • -

        • a Kokkos rank-1 or rank-2 view

          • -

        • a Teuchos vector

          • -

        • a Tpetra vector or multi-vector

          • -

        • a Tpetra block vector or multi-vector

          • -

        • a Epetra vector or multi-vector

          • -

        • a pressio expression, i.e. pressio::diag, pressio::span, pressio::subspan, based on an Eigen or Kokkos container

          • -
        -
        • -

      • ScalarType must be convertible to pressio::Traits<T>::scalar_type

        • -
      -
      -
      -

      Notes#

      -
        -

      • See the ops homepage for a table of booleans to use when checking that T1 and T2 have the correct types.

        • -
      -
      -
      - -
      -
      - -
      - -
      -
      - - - - - - - - - \ No newline at end of file diff --git a/docs/generated_docs/components/ops/matrix_matrix_product.html b/docs/generated_docs/components/ops/matrix_matrix_product.html deleted file mode 100644 index 92ea116..0000000 --- a/docs/generated_docs/components/ops/matrix_matrix_product.html +++ /dev/null @@ -1,402 +0,0 @@ - - - - - - - - - matrix-matrix product - Pressio-Ops-0.14.0 - - - - - - - - - - - - - - - - - - Contents - - - - - - Menu - - - - - - - - Expand - - - - - - Light mode - - - - - - - - - - - - - - Dark mode - - - - - - - Auto light/dark mode - - - - - - - - - - - - - - - - - - - -
      -
      -
      - -
      -
      -
      Pressio-Ops-0.14.0
       -
      -
      -
      - -
      - -
      -
      - -
      -
      -
      - - - - - Back to top - -
      -
      - -
      - -
      -
      -
      -

      matrix-matrix product#

      -

      Header: <pressio/ops.hpp>

      -
      -

      API#

      -
      namespace pressio { namespace ops{
-
-// op(A) = A^T and op(B) = B
-template <
-  class A_type, class B_type, class C_type,
-  class alpha_t, class beta_t
->
-void product(::pressio::transpose /*unused*/,
-      ::pressio::nontranspose /*unused*/,
-      const alpha_t & alpha,
-      const A_type & A,
-      const B_type & B,
-      const beta_t & beta,
-      C_type & C);
-
-// op(A) = A and op(B) = B
-template <
-  class A_type, class B_type, class C_type,
-  class alpha_t, class beta_t
->
-void product(::pressio::nontranspose /*unused*/,
-      ::pressio::nontranspose /*unused*/,
-      const alpha_t & alpha,
-      const A_type & A,
-      const B_type & B,
-      const beta_t & beta,
-      C_type & C);
-
-// A == B and op(A) = A^T
-template <class A_type, class C_type, class alpha_t, class beta_t>
-void product(::pressio::transpose /*unused*/,
-      ::pressio::nontranspose /*unused*/,
-      const alpha_t & alpha,
-      const A_type & A,
-      const beta_t & beta,
-      C_type & C);
-
-// Construct result
-template <class C_type, class A_type, class alpha_t>
-C_type product(::pressio::transpose modeA,
-      ::pressio::nontranspose modeB,
-      const alpha_t & alpha,
-      const A_type & A);
-
-}} // end namespace pressio::ops
-
      -
      -
      -
      -

      Description#

      -
        -

      • Performs matrix-vector multiplication according to C = beta * C + alpha * op(A) * op(B)

        -
          -

        • op(X) indicates either X or X^T

          • -
        -
        • -

      • alpha_t and beta_t are scalar types

        • -

      • A_type, B_type, and C_type are rank-2 containers

        • -
      -
      -
      -

      Types#

      -

      The matrix-matrix product works for the following matrix types:

      -
        -

      • Eigen (all containers are rank-2 Eigen matrices)

        • -

      • Epetra (A and B are Epetra multi-vectors; C is a rank-2 Eigen matrix)

        • -

      • Kokkos (all containers are rank-2 Kokkos views)

        • -

      • Tpetra (A and B are Tpetra multi-vectors; C is either a rank-2 Eigen matrix or a rank-2 Kokkos view)

        • -

      • Tpetra Block (A and B are Tpetra Block multi-vectors; C is either a rank-2 Eigen matrix or a rank-2 Kokkos view)

        • -
      -
      -
      -

      Notes#

      -
        -

      • See the ops homepage for a table of booleans to use when checking that A, B, and C` have the correct types.

        • -
      -
      -
      - -
      -
      - -
      - -
      -
      - - - - - - - - - \ No newline at end of file diff --git a/docs/generated_docs/components/ops/matrix_vector_product.html b/docs/generated_docs/components/ops/matrix_vector_product.html deleted file mode 100644 index 6cf87ed..0000000 --- a/docs/generated_docs/components/ops/matrix_vector_product.html +++ /dev/null @@ -1,429 +0,0 @@ - - - - - - - - - matrix-vector product - Pressio-Ops-0.14.0 - - - - - - - - - - - - - - - - - - Contents - - - - - - Menu - - - - - - - - Expand - - - - - - Light mode - - - - - - - - - - - - - - Dark mode - - - - - - - Auto light/dark mode - - - - - - - - - - - - - - - - - - - -
      -
      -
      - -
      -
      -
      Pressio-Ops-0.14.0
       -
      -
      -
      - -
      - -
      -
      - -
      -
      -
      - - - - - Back to top - -
      -
      - -
      - -
      -
      -
      -

      matrix-vector product#

      -

      Header: <pressio/ops.hpp>

      -
      -

      API#

      -
      namespace pressio { namespace ops{
-
-// op(A) = A
-template <
-  class A_type, class x_type, class y_type,
-  class alpha_t, class beta_t
->
-void product(::pressio::nontranspose /*unused*/,
-      const alpha_t & alpha,
-      const A_type & A,
-      const x_type & x,
-      const beta_t & beta,
-      y_type & y);
-
-// op(A) = A , construct result
-template <
-  class y_type, class A_type, class x_type, class alpha_t
->
-y_type product(::pressio::nontranspose mode,
-      const alpha_t & alpha,
-      const A_type & A,
-      const x_type & x);
-
-// op(A) = A^T
-template <
-  class y_type, class A_type, class x_type, class alpha_t
->
-void product(::pressio::transpose /*unused*/,
-      const alpha_t & alpha,
-      const A_type & A,
-      const x_type & x,
-      const beta_t & beta,
-      y_type & y);
-
-// op(A) = A^T , construct result
-template <class y_type, class A_type, class x_type, class alpha_t>
-y_type product(::pressio::transpose mode,
-      const alpha_t & alpha,
-      const A_type & A,
-      const x_type & x);
-
-}} // end namespace pressio::ops
-
      -
      -
      -
      -

      Description#

      -
        -

      • Performs matrix-vector multiplication according to y = beta * y + alpha * op(A) * x -* op(A) indicates either A or A^T

        • -

      • alpha_t and beta_t are scalar types

        • -

      • x_type and y_type are rank-1 containers

        • -

      • A_type is a rank-2 container

        • -

      • The following combinations of container types are supported for each A_type:

        -
          -

        • Eigen

          -
            -

          • All container types are either Eigen containers or Pressio expressions of Eigen containers,

            • -
          -
          • -

        • Epetra

          -
            -

          • A_type is an Epetra rank-2 container

            • -

          • Either x_type or y_type is a rank-1 Epetra container

            • -

          • The other non-Epetra container is a rank-1 Teuchos or Eigen container

            • -
          -
          • -

        • Kokkos

          -
            -

          • All container types are either Kokkos views or Pressio expressions of Eigen views

            • -
          -
          • -

        • Teuchos (does not support constructed results)

          -
            -

          • A_type is a rank-2 Teuchos container

            • -

          • x_type and y_type are rank-1 Eigen containers

            • -
          -
          • -

        • Tpetra

          -
            -

          • A_type is a rank-2 Tpetra container

            • -

          • x_type is a rank-1 Eigen, Kokkos, Teuchos, or Tpetra container

            • -

          • y_type is a rank-1 container. -If x_type is Tpetra, it may be either a Kokkos or Eigen container (or a Pressio expression of a Kokkos or Eigen container) -Otherwise, y_type is a Tpetra container or a Pressio column expression

            • -
          -
          • -

        • Tpetra Block

          -
            -

          • A_type is a rank-2 Tpetra Block container

            • -

          • x_type is a rank-1 Eigen, Kokkos, Teuchos, or Tpetra Block container

            • -

          • y_type is a rank-1 container. -If x_type is a Tpetra Block vector, y_type may be either an Eigen vector or a rank-1 Kokkos view -Otherwise, y_type is a Tpetra Block vector or column expression

            • -
          -
          • -
        -
        • -
      -
      -
      -

      Notes#

      -
        -

      • See the ops homepage for a table of booleans to use when checking that A_type, x_type, and y_type` have the correct types.

        • -
      -
      -
      - -
      -
      - -
      - -
      -
      - - - - - - - - - \ No newline at end of file diff --git a/docs/generated_docs/components/ops/min_max.html b/docs/generated_docs/components/ops/min_max.html deleted file mode 100644 index d05d6c6..0000000 --- a/docs/generated_docs/components/ops/min_max.html +++ /dev/null @@ -1,342 +0,0 @@ - - - - - - - - - min & max - Pressio-Ops-0.14.0 - - - - - - - - - - - - - - - - - - Contents - - - - - - Menu - - - - - - - - Expand - - - - - - Light mode - - - - - - - - - - - - - - Dark mode - - - - - - - Auto light/dark mode - - - - - - - - - - - - - - - - - - - -
      -
      -
      - -
      -
      -
      Pressio-Ops-0.14.0
       -
      -
      -
      - -
      - -
      -
      - -
      -
      -
      - - - - - Back to top - -
      -
      - -
      - -
      -
      -
      -

      min & max#

      -

      Header: <pressio/ops.hpp>

      -
      -

      API#

      -
      namespace pressio { namespace ops{
-
-template <typename T>
-scalar_type max(const T & obj);
-
-template<typename T>
-scalar_type min(const T & obj);
-
-}} // end namespace pressio::ops
-
      -
      -
      -
      -

      Description#

      -
        -

      • Returns the maximum or minimum value of the given container

        • -

      • Works for all container types other than Teuchos arrays

        • -
      -
      -
      - -
      -
      - -
      - -
      -
      - - - - - - - - - \ No newline at end of file diff --git a/docs/generated_docs/components/ops/norms.html b/docs/generated_docs/components/ops/norms.html deleted file mode 100644 index dc9d86b..0000000 --- a/docs/generated_docs/components/ops/norms.html +++ /dev/null @@ -1,360 +0,0 @@ - - - - - - - - - norms - Pressio-Ops-0.14.0 - - - - - - - - - - - - - - - - - - Contents - - - - - - Menu - - - - - - - - Expand - - - - - - Light mode - - - - - - - - - - - - - - Dark mode - - - - - - - Auto light/dark mode - - - - - - - - - - - - - - - - - - - -
      -
      -
      - -
      -
      -
      Pressio-Ops-0.14.0
       -
      -
      -
      - -
      - -
      -
      - -
      -
      -
      - - - - - Back to top - -
      -
      - -
      - -
      -
      -
      -

      norms#

      -

      Header: <pressio/ops.hpp>

      -
      -

      API#

      -
      namespace pressio { namespace ops{
-
-// L1 Norm
-template <typename T>
-scalar_type norm1(const T & a);
-
-// L2 Norm
-template <typename T>
-scalar_type norm2(const T & a);
-
-}} // end namespace pressio::ops
-
      -
      -
      -
      -

      Description#

      -
        -

      • Returns the desired norm of the given container a

        • -

      • L1 norm is given by

        • -
      -
      -
      -\[\| a \|_1 = \sum_{i} |a_i|\]
      -
      -
        -

      • L2 norm is given by:

        • -
      -
      -
      -\[\|\mathbf{a}\|_2 = \sqrt{\sum_{i=1}^{n} a_i^2}\]
      -
      -
        -

      • a must be rank-1 container of any type

        • -
      -
      -
      - -
      -
      - -
      - -
      -
      - - - - - - - - - - \ No newline at end of file diff --git a/docs/generated_docs/components/ops/pow.html b/docs/generated_docs/components/ops/pow.html deleted file mode 100644 index 8520245..0000000 --- a/docs/generated_docs/components/ops/pow.html +++ /dev/null @@ -1,343 +0,0 @@ - - - - - - - - - pow - Pressio-Ops-0.14.0 - - - - - - - - - - - - - - - - - - Contents - - - - - - Menu - - - - - - - - Expand - - - - - - Light mode - - - - - - - - - - - - - - Dark mode - - - - - - - Auto light/dark mode - - - - - - - - - - - - - - - - - - - -
      -
      -
      - -
      -
      -
      Pressio-Ops-0.14.0
       -
      -
      -
      - -
      - -
      -
      - -
      -
      -
      - - - - - Back to top - -
      -
      - -
      - -
      -
      -
      -

      pow#

      -

      Header: <pressio/ops.hpp>

      -
      -

      API#

      -
      namespace pressio { namespace ops{
-
-// x^exponent
-template <typename T>
-void pow(T & x, const scalar_type & exponent);
-
-// y = x^exponent
-template<typename T1, typename T2>
-void pow(T1 & y, const T2 & x, const scalar_type & exponent);
-
-// y = |x|^exponent (exponent > 0)
-template <class T1, class T2>
-abs_pow(T1 & y,
-      const T2 & x,
-      const typename ::pressio::Traits<T1>::scalar_type & exponent
-);
-
-// y = |x|^exponent (exponent < 0)
-template <class T1, class T2>
-abs_pow(T1 & y,
-      const T2 & x,
-      const typename ::pressio::Traits<T1>::scalar_type & exponent,
-      const typename ::pressio::Traits<T1>::scalar_type & eps
-);
-
-}} // end namespace pressio::ops
-
      -
      -
      -
      -

      Description#

      -
        -

      • Raises each element of a rank-1 container x to the specified power exponent

        • -

      • Stores the result in y if provided; otherwise, acts in place on x

        • -

      • x may be any type of rank-1 container other than a Teuchos vector

        • -
      -
      -
      - -
      -
      -
      - -
      - - -
      -
      -
      -
      - Copyright © 2021, National Technology & Engineering Solutions of Sandia, LLC (NTESS) -
      - Made with Sphinx and @pradyunsg's - - Furo -
      - Last updated on Oct 25, 2024
      -
      -
      -
      - -
      -
      -
      - -
      -
      - -
      -
      - - - - - - - - - \ No newline at end of file diff --git a/docs/generated_docs/components/ops/product.html b/docs/generated_docs/components/ops/product.html deleted file mode 100644 index 4063048..0000000 --- a/docs/generated_docs/components/ops/product.html +++ /dev/null @@ -1,428 +0,0 @@ - - - - - - - - - product - Pressio-Ops-0.14.0 - - - - - - - - - - - - - - - - - - Contents - - - - - - Menu - - - - - - - - Expand - - - - - - Light mode - - - - - - - - - - - - - - Dark mode - - - - - - - Auto light/dark mode - - - - - - - - - - - - - - - - - - - -
      -
      -
      - -
      -
      -
      Pressio-Ops-0.14.0
       -
      -
      -
      - -
      - -
      -
      - -
      -
      -
      - - - - - Back to top - -
      -
      - -
      - -
      -
      -
      -

      product#

      -

      Header: <pressio/ops.hpp>

      -
      -

      API#

      -
      namespace pressio { namespace ops{
-
-// op(A) = A
-template <
-  class A_type, class x_type, class y_type,
-  class alpha_t, class beta_t
->
-void product(::pressio::nontranspose /*unused*/,
-      const alpha_t & alpha,
-      const A_type & A,
-      const x_type & x,
-      const beta_t & beta,
-      y_type & y);
-
-// op(A) = A , construct result
-template <
-  class y_type, class A_type, class x_type, class alpha_t
->
-y_type product(::pressio::nontranspose mode,
-      const alpha_t & alpha,
-      const A_type & A,
-      const x_type & x);
-
-// op(A) = A^T
-template <
-  class y_type, class A_type, class x_type, class alpha_t
->
-void product(::pressio::transpose /*unused*/,
-      const alpha_t & alpha,
-      const A_type & A,
-      const x_type & x,
-      const beta_t & beta,
-      y_type & y);
-
-// op(A) = A^T , construct result
-template <class y_type, class A_type, class x_type, class alpha_t>
-y_type product(::pressio::transpose mode,
-      const alpha_t & alpha,
-      const A_type & A,
-      const x_type & x);
-
-}} // end namespace pressio::ops
-
      -
      -
      -
      -

      Description#

      -
        -

      • Performs matrix-vector multiplication according to y = beta * y + alpha * op(A) * x -* op(A) indicates either A or A^T

        • -

      • alpha_t and beta_t are scalar types

        • -

      • x_type and y_type are rank-1 containers

        • -

      • A_type is a rank-2 container

        • -

      • The following combinations of container types are supported for each A_type:

        -
          -

        • Eigen

          -
            -

          • All container types are either Eigen containers or Pressio expressions of Eigen containers,

            • -
          -
          • -

        • Epetra

          -
            -

          • A_type is an Epetra rank-2 container

            • -

          • Either x_type or y_type is a rank-1 Epetra container

            • -

          • The other non-Epetra container is a rank-1 Teuchos or Eigen container

            • -
          -
          • -

        • Kokkos

          -
            -

          • All container types are either Kokkos views or Pressio expressions of Eigen views

            • -
          -
          • -

        • Teuchos (does not support constructed results)

          -
            -

          • A_type is a rank-2 Teuchos container

            • -

          • x_type and y_type are rank-1 Eigen containers

            • -
          -
          • -

        • Tpetra

          -
            -

          • A_type is a rank-2 Tpetra container

            • -

          • x_type is a rank-1 Eigen, Kokkos, Teuchos, or Tpetra container

            • -

          • y_type is a rank-1 container. -If x_type is Tpetra, it may be either a Kokkos or Eigen container (or a Pressio expression of a Kokkos or Eigen container) -Otherwise, y_type is a Tpetra container or a Pressio column expression

            • -
          -
          • -

        • Tpetra Block

          -
            -

          • A_type is a rank-2 Tpetra Block container

            • -

          • x_type is a rank-1 Eigen, Kokkos, Teuchos, or Tpetra Block container

            • -

          • y_type is a rank-1 container. -If x_type is a Tpetra Block vector, y_type may be either an Eigen vector or a rank-1 Kokkos view -Otherwise, y_type is a Tpetra Block vector or column expression

            • -
          -
          • -
        -
        • -
      -
      -
      -

      Notes#

      -
        -

      • See the ops homepage for a table of booleans to use when checking that A_type, x_type, and y_type` have the correct types.

        • -
      -
      -
      - -
      -
      - -
      - -
      -
      - - - - - - - - - \ No newline at end of file diff --git a/docs/generated_docs/components/type_traits.html b/docs/generated_docs/components/type_traits.html deleted file mode 100644 index 8f889a4..0000000 --- a/docs/generated_docs/components/type_traits.html +++ /dev/null @@ -1,450 +0,0 @@ - - - - - - - - - type_traits - Pressio-Ops-0.14.0 - - - - - - - - - - - - - - - - - - Contents - - - - - - Menu - - - - - - - - Expand - - - - - - Light mode - - - - - - - - - - - - - - Dark mode - - - - - - - Auto light/dark mode - - - - - - - - - - - - - - - - - - - -
      -
      -
      - -
      -
      -
      Pressio-Ops-0.14.0
       -
      -
      -
      - -
      - -
      -
      - -
      -
      -
      - - - - - Back to top - -
      -
      - -
      - -
      -
      -
      -

      type_traits#

      -

      Header: <pressio/type_traits.hpp>

      -

      Public namespace: pressio

      -
      -

      Scope#

      -

      Provides functionalities for type introspection and detection. -One of the main design features of pressio is that it supports arbitrary -types via generic programming and type introspection, but also -provides special support for some data types commonly used.

      -
      -
      -

      Traits class#

      -

      todo: finish

      -

      One of the most important things inside type_traits is the Traits class:

      -
      namespace pressio{
-template<class T, class = void> struct Traits;
-}
-
      -
      -

      To understand the purpose and usage of the traits pattern in C++ there are several resources online. -Quoting Bjarne Stroustrup: “Think of a trait as a small object whose main purpose -is to carry information used by another object or algorithm -to determine “policy” or “implementation details”. -Pressio uses specializations of this class to gather in a uniform way -compile-time information enabling it to reason about types. -The key point here is that different TPLs use a variety of naming conventions -for nested typedefs and related things, so there is not easy way to access -similar information from types of various libraries. -This is what motivated us to implement this type_traits component. -We need a standard, uniform way to query types for compile-time information. -We currently have traits specialized for types of a few TPLs, like Trilinos, Kokkos, Eigen. -An example of one such specialization (in this case for Eigen) is:

      -
      template <typename T>
-struct Traits<
-  T, std::enable_if_t<is_dynamic_vector_eigen<T>::value>
-  >
-{
-  using scalar_type   = typename T::Scalar;
-  static constexpr int rank = 1;
-};
-
      -
      -

      This Traits class play a key role when users want to use arbitrary types (i.e. types -which are not known to presso) and to do so, users shoud specialize this class and make -these specialization visibile to pressio to provide information about their generic types.

      -

      For practical examples of how this class is used, see:

      -

      finish

      -
      -
      -

      Type detection and identification#

      -

      We support several metafunctions for detecting -data types commonly used from existing TPLs. -The following list is partial, and more will be added as we continue the development.

      -
      - ---- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -

      Name

      Description

      template<class T>
      struct is_static_vector_eigen;

      Provides static member constant value equal to true if T is a static Eigen vector.
      Requires: PRESSIO_ENABLE_TPL_EIGEN==On

      template<class T>
      struct is_dynamic_vector_eigen;

      Provides static member constant value equal to true if T is a dynamic Eigen vector.
      Requires: PRESSIO_ENABLE_TPL_EIGEN==On

      template<class T>
      struct is_vector_eigen;

      Provides static member constant value equal to true if T is a static or dynamic Eigen vector.
      Requires: PRESSIO_ENABLE_TPL_EIGEN==On

      template<class T>
      struct is_sparse_matrix_eigen;

      Provides static member constant value equal to true if T is a static or dynamic sparse Eigen matrix.
      Requires: PRESSIO_ENABLE_TPL_EIGEN==On

      template<class T>
      struct is_static_dense_matrix_eigen;

      Provides static member constant value equal to true if T is a static dense Eigen matrix.
      Requires: PRESSIO_ENABLE_TPL_EIGEN==On

      template<class T>
      struct is_dynamic_dense_matrix_eigen;

      Provides static member constant value equal to true if T is a dynamic dense Eigen matrix.
      Requires: PRESSIO_ENABLE_TPL_EIGEN==On

      template<class T>
      struct is_dense_matrix_eigen;

      Provides static member constant value equal to true if T is a static or dynamic dense Eigen matrix.
      Requires: PRESSIO_ENABLE_TPL_EIGEN==On

      template<class T>
      struct is_dense_vector_teuchos;

      Provides static member constant value equal to true if T is a dense Teuchos vector.
      Requires: PRESSIO_ENABLE_TPL_TRILINOS==On

      template<class T>
      struct is_dense_matrix_teuchos;

      Provides static member constant value equal to true if T is a dense Teuchos matrix.
      Requires: PRESSIO_ENABLE_TPL_TRILINOS==On

      template<class T>
      struct is_vector_epetra;

      Provides static member constant value equal to true if T is Epetra vector.
      Requires: PRESSIO_ENABLE_TPL_TRILINOS==On

      template<class T>
      struct is_multi_vector_epetra;

      Provides static member constant value equal to true if T is an Epetra multi vector.
      Requires: PRESSIO_ENABLE_TPL_TRILINOS==On

      template<class T>
      struct is_vector_tpetra;

      Provides static member constant value equal to true if T is a Tpetra vector.
      Requires: PRESSIO_ENABLE_TPL_TRILINOS==On

      template<class T>
      struct is_multi_vector_tpetra;

      Provides static member constant value equal to true if T is a Tpetra multi vector.
      Requires: PRESSIO_ENABLE_TPL_TRILINOS==On

      template<class T>
      struct is_vector_tpetra_block;

      Provides static member constant value equal to true if T is a Tpetra-block vector.
      Requires: PRESSIO_ENABLE_TPL_TRILINOS==On

      template<class T>
      struct is_multi_vector_tpetra_block;

      Provides static member constant value equal to true if T is a Tpetra-block multi vector.
      Requires: PRESSIO_ENABLE_TPL_TRILINOS==On

      template<class T>
      struct is_static_vector_kokkos;

      Provides static member constant value equal to true if T is a static Kokkos vector (rank-1 View).
      Requires: PRESSIO_ENABLE_TPL_KOKKOS==On

      template<class T>
      struct is_dynamic_vector_kokkos;

      Provides static member constant value equal to true if T is a dynamic Kokkos vector (rank-1 View).
      Requires: PRESSIO_ENABLE_TPL_KOKKOS==On

      template<class T>
      struct is_vector_kokkos;

      Provides static member constant value equal to true if T is a static or dynamic Kokkos vector (rank-1 View).
      Requires: PRESSIO_ENABLE_TPL_KOKKOS==On

      template<class T>
      struct is_static_dense_matrix_kokkos;

      Provides static member constant value equal to true if T is a static dense Kokkos matrix (rank-2 View).
      Requires: PRESSIO_ENABLE_TPL_KOKKOS==On

      template<class T>
      struct is_dynamic_dense_matrix_kokkos;

      Provides static member constant value equal to true if T is a dynamic dense Kokkos matrix (rank-2 View).
      Requires: PRESSIO_ENABLE_TPL_KOKKOS==On

      template<class T>
      struct is_dense_matrix_kokkos;

      Provides static member constant value equal to true if T is a static or dynamic dense Kokkos matrix (rank-2 View).
      Requires: PRESSIO_ENABLE_TPL_KOKKOS==On

      -
      -
      -
      - -
      -
      - -
      - -
      -
      - - - - - - - - - \ No newline at end of file diff --git a/docs/generated_docs/concepts_note.html b/docs/generated_docs/concepts_note.html deleted file mode 100644 index bec80de..0000000 --- a/docs/generated_docs/concepts_note.html +++ /dev/null @@ -1,312 +0,0 @@ - - - - - - - - - pressio-ops concepts: more info - Pressio-Ops-is - - - - - - - - - - - - - - - - - - Contents - - - - - - Menu - - - - - - - - Expand - - - - - - Light mode - - - - - - - - - - - - - - Dark mode - - - - - - - Auto light/dark mode - - - - - - - - - - - - - - - - - - - -
      -
      -
      - -
      -
      -
      Pressio-Ops-is
       -
      -
      -
      - -
      - -
      -
      - -
      -
      -
      - - - - - Back to top - -
      -
      - -
      - -
      -
      -
      -

      pressio-ops concepts: more info#

      -

      Concept-driven design has been and still is critical in -the development of pressio-ops. Here we describe some fundamental -notions that are at the core of our design approach.

      -
      -

      concept = syntactic constraints + semantics#

      -

      In pressio-ops, we follow the approach in “Design of Concept Libraries for C++” (2011) -in defining a concept to be a meaningful combination of syntactic requirements + axioms/semantics. -Pure syntax can be fully specified and checked by compilers supporting C++20. -On the contrary, axioms/semantics properties cannot be spelled out and statically checked. -Axioms are, in fact, invariants assumed to hold. In the C++ standard, axioms -and semantics are specified/listed as comments. Here, we adopt a different -approach to present axioms (similar to “Design of Concept Libraries for C++”, 2011)), -that we believe benefits readability: axioms are explicitly listed using -the keyword “axiom”. Note, however, that if you want to compile the concepts below -using a c++20 compiler, you have to comment out all axioms.

      -
        -

      • concepts are hard and it will take a few iterations to get meaninngful concepts done

        • -

      • not all components have the same maturity, so this will be reflected in the corresponding concepts too

        • -

      • the documentation of each concept follows the standard: we have syntax plus semantics

        • -
      -
      -
      -

      “Satisfying” vs. “modeling” a concept#

      -

      Quoting the C++ standard: “It is said -that a standard concept is satisfied if its syntactic requirements -are met, and is modeled if it is satisfied and its -semantic requirements (if any) are also met.”

      -
      -
      - -
      -
      -
      - -
      - - -
      -
      -
      -
      - Copyright © 2021, National Technology & Engineering Solutions of Sandia, LLC (NTESS) -
      - Made with Sphinx and @pradyunsg's - - Furo -
      - Last updated on Oct 25, 2024
      -
      -
      -
      - -
      -
      -
      - -
      -
      - -
      -
      - - - - - - - - - \ No newline at end of file diff --git a/docs/generated_docs/genindex.html b/docs/generated_docs/genindex.html deleted file mode 100644 index 023d08b..0000000 --- a/docs/generated_docs/genindex.html +++ /dev/null @@ -1,284 +0,0 @@ - - - - - - - Index - Pressio-Ops-0.14.0 - - - - - - - - - - - - - - - - - - Contents - - - - - - Menu - - - - - - - - Expand - - - - - - Light mode - - - - - - - - - - - - - - Dark mode - - - - - - - Auto light/dark mode - - - - - - - - - - - - - - - - - - - -
      -
      -
      - -
      -
      -
      Pressio-Ops-0.14.0
       -
      -
      -
      - -
      - -
      -
      - -
      -
      -
      - - - - - Back to top - -
      -
      - -
      - -
      -
      - -
      -

      Index

      -
      -
      - -
      -
      -
      - -
      - - -
      -
      -
      -
      - Copyright © 2021, National Technology & Engineering Solutions of Sandia, LLC (NTESS) -
      - Made with Sphinx and @pradyunsg's - - Furo -
      - Last updated on Oct 25, 2024
      -
      -
      -
      - -
      -
      -
      - -
      -
      - -
      -
      - - - - - - - - - \ No newline at end of file diff --git a/docs/generated_docs/index.html b/docs/generated_docs/index.html deleted file mode 100644 index e3a3c05..0000000 --- a/docs/generated_docs/index.html +++ /dev/null @@ -1,480 +0,0 @@ - - - - - - - - - Pressio-Ops-0.14.0 - - - - - - - - - - - - - - - - - - Contents - - - - - - Menu - - - - - - - - Expand - - - - - - Light mode - - - - - - - - - - - - - - Dark mode - - - - - - - Auto light/dark mode - - - - - - - - - - - - - - - - - - - -
      -
      -
      - -
      -
      -
      Pressio-Ops-0.14.0
       -
      -
      -
      - -
      - -
      -
      - -
      -
      -
      - - - - - Back to top - -
      -
      - -
      - -
      -
      -
      -

      pressio-ops C++ library#

      -

      Documentation of the C++ library, one element of the Pressio ecosystem.

      -

      This work was started with a focus on projection-based reduced-order models (ROMs), -which is a strongly multidisciplinary topic. -Working towards a production-level ROM capability inevitably means spanning -multiple fields ranging from, e.g., linear algebra, nonlinear solvers -and optimization, to time integration, distributed computing and HPC. -This constitutes a substantial challenge to tackle, whose complexity -increases if aiming to develop a generic library.

      -

      To start such a project from the ground up, grow it and then being -able to maintain it, we believe modularity, abstractions -and well-defined APIs to be fundamental design principles to rely on. -This has been, and still is, at the core of our development effort, -and has lead to a highly modular design of pressio (see table below): -each component (level) of the stack covers a specific capability and depends, -via well-defined public APIs, on the ones below it. This has required (and still does) -a considerable development effort, since each component needs “attention” -and can easily be scoped into an independent, full-time project.

      -

      So why doing all this rather than adopting a different, simpler approach, for example, -limiting and hiding as implementation some of the supporting functionalities? -Because we believe the current structure/design offers several major benefits -that would be hard—and in some cases impossible—to obtain otherwise: flexibility, -extensibility, maintainability, and usability of each component on its own. -One drawback is that at any point in time, the various components might -have different maturity levels, so reaching a comparable and solid maturity -across the stack might take some time—our current goal is to obtain -in version 1.0.0 a uniform maturity level at least across -the rom, ode and solvers components. Please keep this in mind while browsing -the documentation and the code.

      -

      Notably, we have extracted the core operations from the Pressio/pressio repository -in order to increase modularity and allow users to build their code directly on top of -pressio-ops if desired.

      -

      However, it is still useful to consider pressio-ops within the context of pressio -to understand how the repositories fit together.

      -

      The following components are included in Pressio/pressio and build off of the contents of pressio-ops:

      -
      -

      -
      -
      - ----- - - - - - - - - - - - - - - - - - - - - - - - - -

      Description

      Header(s)

      rom

      concepts
      (linear) subspaces
      Galerkin: steady
      Galerkin: unsteady
      LSPG: steady
      LSPG: unsteady

      <pressio/rom_concepts.hpp>
      <pressio/rom_subspaces.hpp>
      <pressio/rom_galerkin_steady.hpp>
      <pressio/rom_galerkin_unsteady.hpp>
      <pressio/rom_lspg_steady.hpp>
      <pressio/rom_lspg_unsteady.hpp>
      <pressio/rom.hpp> includes all

      ode

      concepts
      explicit steppers
      implicit steppers
      advance_<*> fncs

      <pressio/ode_concepts.hpp>
      <pressio/ode_steppers_explicit.hpp>
      <pressio/ode_steppers_implicit.hpp>
      <pressio/ode_advancers.hpp>
      <pressio/ode.hpp> includes all

      solvers_nonlinear

      concepts
      Newton method
      Gauss-Newton
      Lev.-Marq.

      <pressio/solvers_nonlinear_concepts.hpp>
      <pressio/solvers_nonlinear_newton.hpp>
      <pressio/solvers_nonlinear_gaussnewton.hpp>
      <pressio/solvers_nonlinear_levmarq.hpp>
      <pressio/solvers_nonlinear.hpp> includes all

      solvers_linear

      linear dense (on-node) solvers

      <pressio/solvers_linear.hpp>

      -
      -

      The following components are included in Pressio/pressio-ops and can be used independently of the Pressio/pressio repository:

      -
      -

      -
      -
      - ----- - - - - - - - - - - - - - - - - - - - - - - - - - - - - -

      Description

      Header(s)

      ops

      shared-memory/distributed linear algebra kernels specializations

      <pressio/ops.hpp>

      expressions

      expressions templates, e.g.: span, diagonal, subspan

      <pressio/expressions.hpp>

      type_traits

      type traits and detection

      <pressio/type_traits.hpp>

      utils

      logger, constants, etc

      <pressio/utils.hpp>

      mpl

      metaprogramming functionalities

      <pressio/mpl.hpp>

      -
      -
      -

      Get Started#

      - -
      -
      -

      Generic programming and concepts#

      -

      Arguably the main foundation of pressio-ops is the use of -generic programming–or, more humbly, we can at least say that it is what we strive for. -Since the early development stages, we have relied on concept-driven design. -Note, that, if you have used or use C++ templates, you have used -concepts knowingly or not. This is because when you write a function or class -template, you have some expectations of what a template needs to expose/do. -C++20 concepts are, in some sense, a way to explicitly formalize those expectations.

      -

      Until we can stably upgrade to C++20, we cannot by default use C++20 concepts, -so we currently guard the concepts in pressio inside a -preprocessor directive #ifdef PRESSIO_ENABLE_CXX20. This can be enabled by -using a C++20 compliant compiler and setting -DCMAKE_CXX_STANDARD=20 at configure time. -The behavior is as follows:

      -
        -

      • if PRESSIO_ENABLE_CXX20 is enabled: concepts are compiled and -enforced stricto sensu on the pressio APIs as discussed by this documentation

        • -

      • if PRESSIO_ENABLE_CXX20 is disabled: this is the default case because the -default pressio C++ standard is currently C++14. In this case, the “C++20 concepts” -are not compiled but the constraints they represent are still valid and implemented -differently such that their enforcement is done via a combination of SFINAE and static asserts.

        • -
      -
      -

      Important

      -

      Well-defined concepts are hard to design and it takes time. Concepts used in pressio are -still being developed. Some are more mature than others. The approach we adopt is to first -focus on the syntax, then then we will revise them with proper semantics. Keep this in mind -if some concepts seem incomplete.

      -
      -
      -
      -

      License and Citation#

      -

      The full license (BSD-3) is available here.

      -

      Sooner or later we will publish this… in the meantime, you can find on arXiv -an (outdated) preprint at: https://arxiv.org/abs/2003.07798

      -
      -
      -

      Questions?#

      -

      Find us on Slack: https://pressioteam.slack.com or -open an issue on github.

      -
      -
      -
      -
      -
      -
      -
      -
      - -
      -
      - -
      - -
      -
      - - - - - - - - - \ No newline at end of file diff --git a/docs/generated_docs/installation.html b/docs/generated_docs/installation.html deleted file mode 100644 index df0fbe9..0000000 --- a/docs/generated_docs/installation.html +++ /dev/null @@ -1,462 +0,0 @@ - - - - - - - - - Installation and Dependencies - Pressio-Ops-0.14.0 - - - - - - - - - - - - - - - - - - Contents - - - - - - Menu - - - - - - - - Expand - - - - - - Light mode - - - - - - - - - - - - - - Dark mode - - - - - - - Auto light/dark mode - - - - - - - - - - - - - - - - - - - -
      -
      -
      - -
      -
      -
      Pressio-Ops-0.14.0
       -
      -
      -
      - -
      - -
      -
      - -
      -
      -
      - - - - - Back to top - -
      -
      - -
      - -
      -
      -
      -

      Installation and Dependencies#

      -
      -

      Tip

      -

      pressio-ops is header-only, so it does not need to be precompiled and linked to. -However, since we use preprocessor directives to conditionally -enable/disable code based on target third-party libraries, -one needs to account for this. See below for the details.

      -
      -
      -

      Warning

      -

      To use pressio-ops, you need at least a C++17 compiler.

      -
      -
      -

      Dependencies#

      -

      Some parts of pressio-ops contain code and implementations -that are specific to third-party libraries (TPLs). -An example is pressio/ops, which contains kernels specializations -for widely-used HPC libraries (e.g. Trilinos, Kokkos). -The main reason for doing this is that we aim, where possible, -to alleviate the user from writing custom operations and allow pressio-ops to decide when and how to leverage -the native libraries’ operations to obtain the best performance. -This should facilitate the integration and use of pressio-ops by existing applications. -This is a growing capability and we currently only -provide built-in support to some external HPC libraries (see below). -Obviously, these TPL-specific specializations need to be guarded with -preprecessor directives, and enabled only if one can access the TPLs.

      -

      Enabling/disabling specific dependencies can be done via -the cmake variables listed here.

      -
      -

      Optional vs Required#

      -
      - ----- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -

      TPL Name

      Optional/Required

      Version Known to Work/run in CI

      Eigen

      Required

      3.3.7

      Trilinos

      Optional

      commit: ef73d14babf6e7556b0420add98cce257ccaa56b

      MPI

      Optional

      –

      Kokkos

      Optional

      3.1.0

      BLAS

      Optional

      –

      LAPACK

      Optional

      –

      GoogleTest

      Optional

      1.10.0

      -
      -

      Eigen is the only required dependency because it is the -default choice for instantiating the ROM data structures -and solving the (dense) ROM problem.

      -
      -
      -
      -

      In practice, what are the steps to get, install and use Pressio?#

      -

      todo: add description for using pressio without configuring, -so one has to define the options directly when configuring -their code or inside the code directly.

      -

      1. Clone pressio-ops (defaults to the main branch), -or you can pick a release version

      -
        -

      1. Create a build and install subdirectories

        2. -
      -
      cd <where-you-cloned-pressio-ops>
-mkdir build && mkdir install
-
      -
      -
        -

      1. Use cmake to configure by passing to the comand line the target list of cmake variables to define.

        2. -
      -

      For example, suppose we want to enable support for Trilinos and the debug prints. We would do:

      -
      export PRESSIO_SRC=<where-you-cloned-pressio>
-cd <where-you-cloned-pressio-ops>/build
-
-cmake -D CMAKE_INSTALL_PREFIX=../install \
-      -D PRESSIO_ENABLE_TPL_TRILINOS=ON \
-      -D PRESSIO_ENABLE_DEBUG_PRINT=ON \
-      ${PRESSIO_SRC}
-
-make install # nothing is built, just headers copied to installation
-
      -
      -

      Note that this step does not build anything because pressio-ops is header-only, -but only processes the cmake arguments and copies the pressio headers to the -install prefix <where-you-cloned-pressio-ops>/install. -If you want, inspect the file <where-you-cloned-pressio-ops>/install/pressio_ops_cmake_config.h -which contains the cmake variables configuration.

      -

      We also remark that during the configuration step above pressio-ops -does not need to know where a target TPL exists in your system. -In the configuration step above, you are simply telling Pressio that you have -a certain TPL and want to enable the corresponding code in pressio. -The TPLs will be needed at linking stage when you build your code that uses pressio.

      -

      4. When building your application to use pressio-ops, you just have to point to -the installation directory <where-you-cloned-pressio-ops>/install with the installed -pressio-ops headers, and you can access all pressio-ops functionalities like so:

      -
      #include "pressio/what_you_need.hpp"
-// ...
-int main(){
- // do something
-}
-
      -
      -
      -

      Warning

      -

      The procedure above is advised because it enables pressio-ops -to properly process the cmake options and turn on/off based -on certain conditions (as explained above). -The alternative way to use pressio would be to just clone the repo, -point to the <where-you-cloned-pressio-ops>/include subdirectory -and use cmake variables directly when building your code. -However, this could have unexpected consequences since -you would be resposible to set the variables correctly but you would not -know exactly all the possible constraints.

      -
      -
      -
      - -
      -
      - -
      - -
      -
      - - - - - - - - - \ No newline at end of file diff --git a/docs/generated_docs/keywords.html b/docs/generated_docs/keywords.html deleted file mode 100644 index 6e08f51..0000000 --- a/docs/generated_docs/keywords.html +++ /dev/null @@ -1,408 +0,0 @@ - - - - - - - - - CMake Keywords - Pressio-Ops-0.14.0 - - - - - - - - - - - - - - - - - - Contents - - - - - - Menu - - - - - - - - Expand - - - - - - Light mode - - - - - - - - - - - - - - Dark mode - - - - - - - Auto light/dark mode - - - - - - - - - - - - - - - - - - - -
      -
      -
      - -
      -
      -
      Pressio-Ops-0.14.0
       -
      -
      -
      - -
      - -
      -
      - -
      -
      -
      - - - - - Back to top - -
      -
      - -
      - -
      -
      -
      -

      CMake Keywords#

      -
      -

      Important

      -

      All CMake keywords are prefixed with PRESSIO_ which is case-sensitive.

      -

      Recall that to set a keyword in CMake you used the syntax -Dkeyword_name.

      -
      -
      -

      Third-party Libraries (TPLs)#

      -

      The following options control enabling TPLs:

      -
      - ----- - - - - - - - - - - - - - - - - - - - - - - - - - - - - -

      Variable

      Description

      Default

      PRESSIO_ENABLE_TPL_EIGEN

      self-explanatory

      ON

      PRESSIO_ENABLE_TPL_TRILINOS

      self-explanatory

      OFF

      PRESSIO_ENABLE_TPL_MPI

      self-explanatory

      OFF automatically ON if PRESSIO_ENABLE_TPL_TRILINOS=ON

      PRESSIO_ENABLE_TPL_KOKKOS

      self-explanatory

      OFF; automatically ON if PRESSIO_ENABLE_TPL_TRILINOS=ON

      PRESSIO_ENABLE_TEUCHOS_TIMERS

      self-explanatory

      OFF automatically ON if PRESSIO_ENABLE_TPL_TRILINOS=ON

      -
      -

      Obviously, the choice of which TPLs to enable is related to -your application’s dependency requirements. -For example, if you have an application that relies on -Trilinos data structures and want to use pressio, -then it makes sense to enable the Trilinos dependency. -On the contrary, if you have an application that relies only on -Eigen data structures, then it makes sense to only leave only Eigen on -and disable the rest.

      -

      Also, we note that some of the cmake variables listed above are connected -and cannot be turned on individualy. -For example, if we enable Trilinos then pressio automatically -enables also Kokkos, BLAS, LAPACK and MPI.

      -
      -
      -

      Other Options#

      -
      - ----- - - - - - - - - - - - - - - - - - - - - -

      Variable

      Description

      Default

      PRESSIO_ENABLE_DEBUG_PRINT

      to enable debugging print statements

      OFF

      PRESSIO_ENABLE_CXX17

      enables C++17 standard

      ON since min standard is 17

      PRESSIO_ENABLE_CXX20

      enables C++20 standard

      OFF; turned on if CMAKE_CXX_STANDARD is set to 20

      -
      -
      -
      - -
      -
      - -
      - -
      -
      - - - - - - - - - \ No newline at end of file diff --git a/docs/generated_docs/license.html b/docs/generated_docs/license.html deleted file mode 100644 index 2159987..0000000 --- a/docs/generated_docs/license.html +++ /dev/null @@ -1,336 +0,0 @@ - - - - - - - - - License - Pressio-Ops-0.14.0 - - - - - - - - - - - - - - - - - - Contents - - - - - - Menu - - - - - - - - Expand - - - - - - Light mode - - - - - - - - - - - - - - Dark mode - - - - - - - Auto light/dark mode - - - - - - - - - - - - - - - - - - - -
      -
      -
      - -
      -
      -
      Pressio-Ops-0.14.0
       -
      -
      -
      - -
      - -
      -
      - -
      -
      -
      - - - - - Back to top - -
      -
      - -
      - -
      -
      -
      -

      License#

      -
      //@HEADER
-// ************************************************************************
-//
-//                              Pressio
-// Copyright 2019 National Technology & Engineering Solutions of Sandia,LLC
-//                              (NTESS)
-//
-// Under the terms of Contract DE-NA0003525 with NTESS, the
-// U.S. Government retains certain rights in this software.
-//
-// Pressio is licensed under BSD-3-Clause terms of use:
-//
-// Redistribution and use in source and binary forms, with or without
-// modification, are permitted provided that the following conditions
-// are met:
-//
-// 1. Redistributions of source code must retain the above copyright
-// notice, this list of conditions and the following disclaimer.
-//
-// 2. Redistributions in binary form must reproduce the above copyright
-// notice, this list of conditions and the following disclaimer in the
-// documentation and/or other materials provided with the distribution.
-//
-// 3. Neither the name of the copyright holder nor the names of its
-// contributors may be used to endorse or promote products derived
-// from this software without specific prior written permission.
-//
-// THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
-// "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
-// LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
-// FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE
-// COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,
-// INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
-// (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
-// SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
-// HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
-// STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING
-// IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
-// POSSIBILITY OF SUCH DAMAGE.
-//
-// Questions? Contact Francesco Rizzi (fnrizzi@sandia.gov)
-//
-// ************************************************************************
-//@HEADER
-
      -
      -
      - -
      -
      - -
      - -
      -
      - - - - - - - - - \ No newline at end of file diff --git a/docs/generated_docs/mydefs.html b/docs/generated_docs/mydefs.html deleted file mode 100644 index 619e26b..0000000 --- a/docs/generated_docs/mydefs.html +++ /dev/null @@ -1,277 +0,0 @@ - - - - - - - - - <no title> - Pressio-Ops-0.14.0 - - - - - - - - - - - - - - - - - - Contents - - - - - - Menu - - - - - - - - Expand - - - - - - Light mode - - - - - - - - - - - - - - Dark mode - - - - - - - Auto light/dark mode - - - - - - - - - - - - - - - - - - - -
      -
      -
      - -
      -
      -
      Pressio-Ops-0.14.0
       -
      -
      -
      - -
      - -
      -
      - -
      -
      -
      - - - - - Back to top - -
      -
      - -
      - -
      -
      - -
      -
      -
      - -
      - - -
      -
      -
      -
      - Copyright © 2021, National Technology & Engineering Solutions of Sandia, LLC (NTESS) -
      - Made with Sphinx and @pradyunsg's - - Furo -
      - Last updated on Oct 25, 2024
      -
      -
      -
      - -
      -
      -
      - -
      -
      - -
      -
      - - - - - - - - - \ No newline at end of file diff --git a/docs/generated_docs/objects.inv b/docs/generated_docs/objects.inv deleted file mode 100644 index 8d40d796c9d259a384375f38752fdec3ccafbff5..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 609 zcmV-n0-pUNAX9K?X>NERX>N99Zgg*Qc_4OWa&u{KZXhxWBOp+6Z)#;@bUGkVa%FRK zX>To0aB~VHAXa5^b7^mGIv@%oAXI2&AaZ4GVQFq;WpW^IW*~HEX>%ZEX>4U6X>%ZB zZ*6dLWpi_7WFU2OX>MmAdTeQ8E(&vN{tO+cj{3WemyPr&~Dt?@> z(`=S#)^&TS`0;z(C?jTytl@eK7#ue@0F#V>DcXdc54ZA2nUOS@Q#+?OD6vAW7|b2k zZS8ZckRt{Q$DSW5u2dyw46d9~wrJaFe`}OdnTcg`Nf$Z}D$KD?q%mCjC4g&%bwh>m zUz1PDG`wP2tWhjxzs02!G<0!rQ32ZStWh~#o6wp(-;9;YRkI#rT*Hro>8ho8iFi}G z_9Ii7>?vBBJC0uUZT>iK3B^N`QzZXOgQl}`W%+K{O$Cy_#Dk+DZ$vjp vcq^tt8InF2%TS?)$7Y84hW|R?DXzO{6M%bhDvgvQ&p)ca@*^~# - - - - - - Search - Pressio-Ops-0.14.0 - - - - - - - - - - - - - - - - - Contents - - - - - - Menu - - - - - - - - Expand - - - - - - Light mode - - - - - - - - - - - - - - Dark mode - - - - - - - Auto light/dark mode - - - - - - - - - - - - - - - - - - - -
      -
      -
      - -
      -
      -
      Pressio-Ops-0.14.0
       -
      -
      -
      - -
      - -
      -
      - -
      -
      -
      - - - - - Back to top - -
      -
      - -
      - -
      -
      - - - -
      - -
      -
      -
      - -
      - - -
      -
      -
      -
      - Copyright © 2021, National Technology & Engineering Solutions of Sandia, LLC (NTESS) -
      - Made with Sphinx and @pradyunsg's - - Furo -
      - Last updated on Oct 25, 2024
      -
      -
      -
      - -
      -
      -
      - -
      -
      - -
      -
      - - - - - - - - - - - - \ No newline at end of file diff --git a/docs/generated_docs/searchindex.js b/docs/generated_docs/searchindex.js deleted file mode 100644 index 510ab2b..0000000 --- a/docs/generated_docs/searchindex.js +++ /dev/null @@ -1 +0,0 @@ -Search.setIndex({"docnames": ["components/expressions", "components/expressions/diag", "components/expressions/span", "components/expressions/subspan", "components/mpl", "components/ops", "components/ops/abs", "components/ops/add_to_diagonal", "components/ops/clone", "components/ops/deep_copy", "components/ops/dot", "components/ops/elementwise_multiply", "components/ops/extent", "components/ops/fill", "components/ops/matrix_matrix_product", "components/ops/matrix_vector_product", "components/ops/min_max", "components/ops/norms", "components/ops/pow", "components/type_traits", "index", "installation", "keywords", "license", "mydefs"], "filenames": ["components/expressions.rst", "components/expressions/diag.rst", "components/expressions/span.rst", "components/expressions/subspan.rst", "components/mpl.rst", "components/ops.rst", "components/ops/abs.rst", "components/ops/add_to_diagonal.rst", "components/ops/clone.rst", "components/ops/deep_copy.rst", "components/ops/dot.rst", "components/ops/elementwise_multiply.rst", "components/ops/extent.rst", "components/ops/fill.rst", "components/ops/matrix_matrix_product.rst", "components/ops/matrix_vector_product.rst", "components/ops/min_max.rst", "components/ops/norms.rst", "components/ops/pow.rst", "components/type_traits.rst", "index.rst", "installation.rst", "keywords.rst", "license.rst", "mydefs.rst"], "titles": ["expressions", "diagonal", "span", "subspan", "mpl", "ops", "abs", "add_to_diagonal", "clone", "deep_copy", "dot", "elementwise_multiply", "extent", "fill", "matrix-matrix product", "matrix-vector product", "min & max", "norms", "pow", "type_traits", "pressio-ops C++ library", "Installation and Dependencies", "CMake Keywords", "License", "<no title>"], "terms": {"defin": [0, 1, 2, 3, 20, 21], "header": [0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 23], "pressio": [0, 1, 2, 3, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 22, 23], "hpp": [0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21], "public": [0, 4, 5, 19, 20], "namespac": [0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19], "we": [0, 19, 20, 21, 22], "refer": 0, "becaus": [0, 5, 20, 21], "each": [0, 3, 5, 6, 7, 13, 15, 18, 20], "function": [0, 4, 19, 20, 21], "doe": [0, 15, 20, 21], "alloc": [0, 8], "new": [0, 8], "memori": [0, 20], "onli": [0, 4, 20, 21, 22], "creat": [0, 8, 21], "an": [0, 1, 2, 3, 4, 6, 8, 9, 10, 11, 12, 13, 15, 19, 20, 21, 22], "instanc": [0, 4, 8], "class": [0, 1, 2, 3, 4, 6, 7, 8, 11, 12, 13, 14, 15, 18, 20], "repres": [0, 1, 2, 3, 20], "given": [0, 4, 5, 16, 17], "oper": [0, 4, 5, 8, 20, 21], "In": [0, 20], "all": [0, 4, 5, 7, 8, 9, 14, 15, 16, 20, 21, 22], "case": [0, 4, 19, 20, 22], "return": [0, 1, 2, 3, 4, 8, 10, 12, 16, 17], "remain": 0, "valid": [0, 20], "until": [0, 20], "its": [0, 20, 23], "operand": [0, 1, 2, 3, 6, 7, 8, 13], "goe": 0, "out": [0, 4, 23], "scope": [0, 20], "If": [0, 4, 7, 15, 21], "state": 0, "undefin": 0, "express": [1, 2, 3, 5, 6, 9, 10, 11, 12, 13, 15, 20, 23], "templat": [1, 2, 3, 4, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20], "t": [1, 2, 3, 4, 5, 7, 8, 9, 11, 12, 13, 14, 15, 16, 17, 18, 19], "impl": [1, 2, 3], "end": [1, 2, 3, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18], "take": [1, 2, 3, 20], "either": [1, 2, 3, 9, 14, 15], "squar": 1, "eigen": [1, 2, 3, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 19, 21, 22], "dens": [1, 3, 19, 20, 21], "matrix": [1, 3, 5, 7, 8, 12, 13, 19], "is_dense_matrix_eigen": [1, 3, 5, 19], "valu": [1, 2, 3, 4, 5, 6, 7, 8, 13, 16, 19], "true": [1, 2, 3, 4, 19], "kokko": [1, 2, 3, 5, 6, 8, 9, 10, 11, 12, 13, 14, 15, 19, 21, 22], "rank": [1, 2, 3, 5, 6, 7, 9, 10, 11, 13, 14, 15, 17, 18, 19], "2": [1, 3, 5, 7, 13, 14, 15, 17, 19, 23], "view": [1, 2, 3, 5, 6, 8, 9, 10, 11, 12, 13, 14, 15, 19], "i": [1, 2, 3, 6, 8, 10, 11, 12, 13, 17, 19], "e": [1, 2, 3, 6, 8, 10, 11, 12, 13, 19, 20, 21], "is_dense_matrix_kokko": [1, 3, 5, 19], "std": [2, 3, 4, 12, 19], "pair": [2, 3], "size_t": [2, 3, 12], "indexrang": 2, "vector": [2, 5, 6, 8, 9, 10, 11, 12, 13, 14, 18, 19], "object": [2, 3, 8, 12, 13, 19], "is_vector_eigen": [2, 5, 19], "1": [2, 5, 6, 10, 11, 13, 15, 17, 18, 19, 20, 21, 23], "is_vector_kokko": [2, 5, 19], "pairidentifi": 2, "interv": [2, 3], "b": [2, 14], "where": [2, 11, 21], "second": 2, "index": [2, 4], "exclus": 2, "target": [2, 21], "rowsrang": 3, "colsrang": 3, "well": [3, 20], "us": [3, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 19, 20, 22, 23], "dimens": [3, 12], "provid": [4, 10, 18, 19, 21, 23], "metaprogram": [4, 20], "need": [4, 19, 20, 21], "support": [4, 5, 15, 19, 20, 21], "gener": [4, 5, 19], "program": [4, 19], "which": [4, 8, 19, 20, 21, 22], "fundament": [4, 20], "build": [4, 20, 21], "block": [4, 5, 6, 8, 9, 10, 11, 12, 13, 14, 15, 19], "librari": [4, 19, 21], "you": [4, 5, 20, 21, 22], "ar": [4, 5, 7, 14, 15, 19, 20, 22, 23], "familiar": 4, "type_trait": [4, 20], "from": [4, 8, 9, 19, 20, 21, 23], "standard": [4, 19, 20, 22], "look": 4, "too": 4, "some": [4, 19, 20, 21, 22], "part": [4, 21], "have": [4, 6, 8, 9, 10, 11, 13, 14, 15, 19, 20, 21, 22], "been": [4, 20], "adapt": 4, "tinympl": 4, "project": [4, 20], "The": [4, 5, 14, 15, 19, 20, 21, 22], "appear": 4, "longer": 4, "maintain": [4, 20], "follow": [4, 5, 8, 12, 14, 15, 19, 20, 22, 23], "partial": [4, 19], "list": [4, 19, 21, 22, 23], "intend": 4, "idea": 4, "featur": [4, 5, 19], "To": [4, 19, 20, 21], "find": [4, 20], "brows": [4, 20], "sourc": [4, 23], "f": 4, "arg": 4, "struct": [4, 19], "determin": [4, 19], "whether": [4, 5, 23], "everi": 4, "element": [4, 6, 7, 9, 11, 13, 18, 20], "sequenc": 4, "satisfi": 4, "predic": 4, "must": [4, 6, 7, 8, 9, 10, 11, 12, 13, 17, 23], "convert": [4, 7, 13], "bool": 4, "static": [4, 19, 20], "member": [4, 19], "constant": [4, 19, 20], "equal": [4, 19], "iff": 4, "otherwis": [4, 10, 15, 18, 20, 23], "fals": 4, "exampl": [4, 8, 19, 20, 21, 22], "pmpl": 4, "static_assert": 4, "is_floating_point": 4, "doubl": 4, "float": 4, "ani": [4, 8, 17, 18, 20, 23], "least": [4, 20, 21], "one": [4, 6, 10, 11, 12, 19, 20, 21], "none": 4, "indextyp": [4, 12], "ha": [4, 7, 8, 12, 20, 21], "subscript": 4, "can": [4, 5, 8, 20, 21], "type": [4, 6, 7, 8, 9, 10, 11, 12, 13, 15, 16, 17, 18, 20], "void": [4, 6, 7, 9, 10, 11, 13, 14, 15, 18, 19], "op": [6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 21], "t1": [6, 7, 9, 10, 11, 13, 18], "t2": [6, 9, 10, 11, 13, 18], "x": [6, 11, 14, 15, 18], "const": [6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18], "y": [6, 11, 15, 18], "comput": [6, 10, 11, 20], "wise": [6, 11], "absolut": 6, "store": [6, 10, 11, 18], "result": [6, 8, 10, 11, 14, 15, 18], "dimension": [6, 10, 11], "contain": [5, 6, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 21], "compat": [6, 10, 11], "scalar": [6, 7, 10, 11, 14, 15, 19], "tpetra": [5, 6, 8, 9, 10, 11, 12, 13, 14, 15, 19], "is_vector_tpetra": [5, 19], "is_vector_tpetra_block": [5, 19], "epetra": [5, 6, 8, 9, 10, 11, 12, 13, 14, 15, 19], "is_vector_epetra": [5, 19], "diag": [6, 10, 11, 12, 13], "span": [0, 6, 10, 11, 12, 13, 20], "subspan": [0, 6, 10, 11, 12, 13, 20], "base": [6, 9, 10, 11, 12, 13, 20, 21], "kokkko": [], "scalartyp": [7, 13], "add": [7, 21], "specifi": [7, 12, 18], "diagon": [0, 7, 20], "is_sparse_matrix_eigen": [5, 19], "trait": [7, 13, 18, 20], "scalar_typ": [7, 10, 13, 16, 17, 18, 19], "entri": 7, "written": [7, 23], "alreadi": 7, "exist": [7, 19, 21], "make": [8, 19, 21, 22], "copi": [8, 9, 21], "It": 8, "exact": 8, "independ": [8, 9, 20], "teucho": [5, 8, 12, 13, 15, 16, 18, 19], "is_dense_vector_teucho": [5, 19], "multi": [8, 9, 12, 13, 14, 19], "is_multi_vector_epetra": [5, 19], "is_multi_vector_tpetra": [5, 19], "is_multi_vector_tpetra_block": [5, 19], "thi": [8, 19, 20, 21, 23], "kernel": [8, 20, 21], "complet": 8, "befor": 8, "semant": [8, 20], "even": [8, 23], "default": [8, 20, 21, 22], "like": [8, 19, 21], "tpetrablock": 8, "mean": [8, 20], "let": 8, "auto": 8, "appli": 8, "after": 8, "call": 8, "NOT": [8, 23], "impact": 8, "And": 8, "For": [8, 19, 21, 22], "mv": 8, "implement": [8, 19, 20, 21], "constructor": 8, "data": [8, 19, 21, 22, 23], "shallow": 8, "first": [8, 20], "extent": [5, 8], "ident": 8, "deep": 8, "typenam": [9, 10, 16, 17, 18, 19], "dest": 9, "src": 9, "dst": 9, "so": [9, 19, 20, 21], "fulli": 9, "same": 9, "two": [9, 10], "nativ": [5, 9, 21], "is_native_container_eigen": 5, "is_native_container_kokko": 5, "dotresult": 10, "veca": 10, "vecb": 10, "product": [5, 10, 20, 23], "alpha_t": [11, 14, 15], "beta_t": [11, 14, 15], "alpha": [11, 14, 15], "z": 11, "beta": [11, 14, 15], "denot": 11, "multipl": [11, 14, 15, 20], "objectin": 12, "size": 12, "along": 12, "axi": 12, "overwrit": 13, "A": [14, 15, 23], "a_typ": [14, 15], "x_type": 15, "y_type": 15, "nontranspos": [14, 15], "unus": [14, 15], "construct": [14, 15], "mode": 15, "transpos": [14, 15], "perform": [14, 15, 21], "accord": [14, 15], "indic": [14, 15], "combin": [15, 20], "is_expression_acting_on_eigen": 5, "other": [15, 16, 18, 20, 23], "non": 15, "is_expression_acting_on_kokko": 5, "is_dense_matrix_teucho": [5, 19], "is_expression_column_acting_on_tpetra": 5, "mai": [15, 18, 23], "column": 15, "introspect": 19, "One": [19, 20], "main": [19, 20, 21], "design": [19, 20], "arbitrari": 19, "via": [19, 20, 21], "also": [19, 21, 22], "special": [19, 20, 21, 23], "commonli": 19, "todo": [19, 21], "finish": 19, "most": 19, "import": 19, "thing": 19, "insid": [19, 20, 21], "understand": [19, 20], "purpos": [19, 23], "usag": 19, "pattern": 19, "c": [14, 19, 21, 22], "sever": [19, 20], "resourc": 19, "onlin": 19, "quot": 19, "bjarn": 19, "stroustrup": 19, "think": 19, "small": 19, "whose": [19, 20], "carri": 19, "inform": 19, "anoth": 19, "algorithm": 19, "polici": 19, "detail": [5, 19, 21], "gather": 19, "uniform": [19, 20], "wai": [19, 20, 21, 23], "compil": [19, 20, 21], "time": [19, 20], "enabl": [19, 20, 21, 22], "reason": [19, 21], "about": [5, 19], "kei": 19, "point": [19, 20, 21], "here": [19, 20, 21], "differ": [19, 20], "tpl": [19, 21], "varieti": [5, 19], "name": [19, 21, 23], "convent": 19, "nest": 19, "typedef": 19, "relat": [19, 22], "easi": 19, "access": [19, 21], "similar": 19, "variou": [19, 20], "what": [19, 20], "motiv": 19, "compon": [19, 20], "queri": 19, "current": [19, 20, 21], "few": 19, "trilino": [19, 21, 22], "enable_if_t": 19, "is_dynamic_vector_eigen": 19, "constexpr": 19, "int": [19, 21], "plai": 19, "role": 19, "when": [6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 19, 20, 21], "user": [19, 20, 21], "want": [19, 21, 22], "known": [19, 21], "presso": 19, "do": [19, 20, 21], "shoud": 19, "visibil": 19, "practic": 19, "how": [19, 20, 21], "see": [6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 19, 20, 21], "metafunct": 19, "more": [19, 20], "ad": 19, "continu": 19, "develop": [19, 20], "descript": [19, 20, 21, 22], "is_static_vector_eigen": 19, "requir": [19, 20, 22], "pressio_enable_tpl_eigen": [19, 22], "On": [19, 22], "dynam": 19, "spars": 19, "is_static_dense_matrix_eigen": 19, "is_dynamic_dense_matrix_eigen": 19, "pressio_enable_tpl_trilino": [19, 21, 22], "is_static_vector_kokko": 19, "pressio_enable_tpl_kokko": [19, 22], "is_dynamic_vector_kokko": 19, "is_static_dense_matrix_kokko": 19, "is_dynamic_dense_matrix_kokko": 19, "driven": 20, "still": 20, "critic": [], "describ": [], "notion": [], "core": 20, "our": 20, "approach": 20, "2011": [], "meaning": [], "axiom": [], "pure": [], "syntax": [20, 22], "check": [5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15], "20": [20, 22], "contrari": 22, "properti": [], "cannot": [20, 22], "spell": [], "fact": [], "invari": [], "assum": [], "hold": 5, "comment": [], "adopt": 20, "present": [], "believ": 20, "benefit": 20, "readabl": [], "explicitli": 20, "keyword": [], "note": [20, 21, 22], "howev": [20, 21, 23], "below": [5, 20, 21], "hard": 20, "iter": [], "get": [], "meaninng": [], "done": [20, 21], "matur": 20, "reflect": [], "correspond": 21, "document": [20, 23], "plu": [], "said": [], "met": 23, "ecosystem": 20, "work": [5, 14, 16, 20, 21], "wa": 20, "focu": 20, "reduc": 20, "order": 20, "model": 20, "rom": [20, 21], "strongli": 20, "multidisciplinari": 20, "topic": 20, "toward": 20, "level": 20, "capabl": [20, 21], "inevit": 20, "field": 20, "rang": 20, "g": [20, 21], "linear": 20, "algebra": 20, "nonlinear": 20, "solver": 20, "optim": 20, "integr": [20, 21], "distribut": [20, 23], "hpc": [20, 21], "constitut": 20, "substanti": 20, "challeng": 20, "tackl": 20, "complex": 20, "increas": 20, "aim": [20, 21], "ground": 20, "up": 20, "grow": [20, 21], "being": 20, "abl": 20, "modular": 20, "abstract": 20, "api": 20, "principl": 20, "reli": [20, 22], "effort": 20, "lead": 20, "highli": 20, "tabl": [5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 20], "stack": 20, "cover": 20, "specif": [20, 21, 23], "depend": [20, 22], "ones": 20, "consider": 20, "sinc": [20, 21, 22], "attent": 20, "easili": 20, "full": 20, "why": 20, "rather": 20, "than": [16, 18, 20], "simpler": 20, "limit": [20, 23], "hide": 20, "structur": [20, 21, 22], "offer": 20, "major": 20, "would": [20, 21], "imposs": 20, "obtain": [20, 21], "flexibl": 20, "extens": 20, "usabl": 20, "own": 20, "drawback": 20, "might": 20, "reach": 20, "compar": 20, "solid": 20, "across": 20, "goal": 20, "version": [20, 21], "0": [18, 20, 21], "od": 20, "pleas": 20, "keep": 20, "mind": 20, "while": 20, "code": [20, 21, 23], "notabl": 20, "extract": 20, "repositori": 20, "allow": [20, 21], "directli": [20, 21], "top": 20, "desir": [17, 20], "consid": 20, "within": [5, 20], "context": 20, "fit": [20, 23], "togeth": 20, "includ": [20, 21, 23], "off": [20, 21, 22], "content": 20, "s": [20, 22, 23], "share": 20, "detect": 20, "util": 20, "logger": 20, "etc": 20, "mpl": 20, "instal": 20, "should": [20, 21], "trivial": 20, "arguabl": 20, "foundat": 20, "humbl": 20, "sai": 20, "strive": 20, "earli": 20, "stage": [20, 21], "knowingli": 20, "write": [20, 21], "expect": [5, 20], "expos": 20, "sens": [20, 22], "formal": 20, "those": 20, "stabli": 20, "upgrad": 20, "guard": [20, 21], "preprocessor": [20, 21], "direct": [20, 21, 23], "ifdef": 20, "pressio_enable_cxx20": [20, 22], "compliant": 20, "set": [20, 21, 22], "dcmake_cxx_standard": 20, "configur": [20, 21], "behavior": 20, "enforc": 20, "stricto": 20, "sensu": 20, "discuss": 20, "disabl": [20, 21, 22], "14": 20, "constraint": [20, 21], "thei": 20, "sfina": 20, "assert": 20, "revis": 20, "them": 20, "proper": 20, "seem": 20, "incomplet": 20, "bsd": [20, 23], "3": [20, 21, 23], "avail": 20, "sooner": 20, "later": 20, "publish": 20, "meantim": 20, "arxiv": 20, "outdat": 20, "preprint": 20, "http": 20, "org": 20, "ab": [5, 20], "2003": 20, "07798": 20, "slack": 20, "pressioteam": 20, "com": 20, "open": 20, "issu": 20, "github": 20, "precompil": 21, "link": [5, 21], "condition": 21, "third": 21, "parti": 21, "account": 21, "17": [21, 22], "wide": 21, "possibl": [21, 23], "allevi": 21, "custom": 21, "decid": 21, "leverag": 21, "best": 21, "facilit": 21, "applic": [21, 22], "built": [5, 21], "extern": 21, "obvious": [21, 22], "preprecessor": 21, "cmake": 21, "variabl": [21, 22], "run": 21, "ci": 21, "7": 21, "commit": 21, "ef73d14babf6e7556b0420add98cce257ccaa56b": 21, "mpi": [21, 22], "bla": [21, 22], "lapack": [21, 22], "googletest": 21, "10": 21, "choic": [21, 22], "instanti": 21, "solv": 21, "problem": 21, "without": [21, 23], "clone": [5, 21], "branch": 21, "pick": 21, "releas": 21, "subdirectori": 21, "cd": 21, "mkdir": 21, "pass": 21, "comand": 21, "line": 21, "suppos": 21, "debug": [21, 22], "print": [21, 22], "export": 21, "pressio_src": 21, "d": 21, "cmake_install_prefix": 21, "ON": [21, 22, 23], "pressio_enable_debug_print": [21, 22], "noth": 21, "just": 21, "anyth": 21, "process": 21, "argument": 21, "prefix": [21, 22], "inspect": 21, "file": 21, "pressio_ops_cmake_config": 21, "h": 21, "remark": 21, "dure": 21, "abov": [21, 22, 23], "know": 21, "your": [21, 22], "system": 21, "simpli": 21, "tell": 21, "certain": [21, 23], "4": 21, "directori": [5, 21], "what_you_ne": 21, "someth": 21, "procedur": 21, "advis": [21, 23], "properli": 21, "turn": [21, 22], "condit": [21, 23], "explain": 21, "altern": 21, "repo": 21, "could": 21, "unexpect": 21, "consequ": 21, "respos": 21, "correctli": 21, "exactli": 21, "pressio_": 22, "sensit": 22, "recal": 22, "dkeyword_nam": 22, "control": 22, "self": 22, "explanatori": 22, "pressio_enable_tpl_mpi": 22, "automat": 22, "pressio_enable_teuchos_tim": 22, "leav": 22, "rest": 22, "connect": 22, "individuali": 22, "statement": 22, "pressio_enable_cxx17": 22, "min": [5, 22], "cmake_cxx_standard": 22, "copyright": 23, "2019": 23, "nation": 23, "technolog": 23, "engin": 23, "solut": 23, "sandia": 23, "llc": 23, "ntess": 23, "under": 23, "term": 23, "contract": 23, "de": 23, "na0003525": 23, "u": 23, "govern": 23, "retain": 23, "right": 23, "softwar": 23, "claus": 23, "redistribut": 23, "binari": 23, "form": 23, "modif": 23, "permit": 23, "notic": 23, "disclaim": 23, "reproduc": 23, "materi": 23, "neither": 23, "holder": 23, "nor": 23, "contributor": 23, "endors": 23, "promot": 23, "deriv": 23, "prior": 23, "permiss": 23, "IS": 23, "BY": 23, "THE": 23, "AND": 23, "AS": 23, "OR": 23, "impli": 23, "warranti": 23, "BUT": 23, "TO": 23, "OF": 23, "merchant": 23, "FOR": 23, "particular": 23, "IN": 23, "NO": 23, "event": 23, "shall": 23, "BE": 23, "liabl": 23, "indirect": 23, "incident": 23, "exemplari": 23, "consequenti": 23, "damag": 23, "procur": 23, "substitut": 23, "good": 23, "servic": 23, "loss": 23, "profit": 23, "busi": 23, "interrupt": 23, "caus": 23, "theori": 23, "liabil": 23, "strict": 23, "tort": 23, "neglig": 23, "aris": 23, "IF": 23, "SUCH": 23, "question": 23, "contact": 23, "francesco": 23, "rizzi": 23, "fnrizzi": 23, "gov": 23, "subspac": 20, "galerkin": 20, "steadi": 20, "unsteadi": 20, "lspg": 20, "rom_concept": 20, "rom_subspac": 20, "rom_galerkin_steadi": 20, "rom_galerkin_unsteadi": 20, "rom_lspg_steadi": 20, "rom_lspg_unsteadi": 20, "explicit": 20, "stepper": 20, "implicit": 20, "advance_": 20, "fnc": 20, "ode_concept": 20, "ode_steppers_explicit": 20, "ode_steppers_implicit": 20, "ode_advanc": 20, "solvers_nonlinear": 20, "newton": 20, "method": 20, "gauss": 20, "lev": 20, "marq": 20, "solvers_nonlinear_concept": 20, "solvers_nonlinear_newton": 20, "solvers_nonlinear_gaussnewton": 20, "solvers_nonlinear_levmarq": 20, "solvers_linear": 20, "node": 20, "add_to_diagon": 5, "deep_copi": 5, "dot": 5, "elementwise_multipli": 5, "fill": 5, "backend": 5, "both": 5, "throughout": 5, "confirm": 5, "is_matrix_eigen": [], "is_sparse_matrix_kokko": 5, "addition": 5, "checker": [], "navig": [], "boolean": [5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15], "homepag": [6, 7, 8, 9, 10, 11, 12, 13, 14, 15], "correct": [6, 7, 8, 9, 10, 11, 12, 13, 14, 15], "b_type": 14, "c_type": 14, "modea": 14, "modeb": 14, "matric": 14, "max": 5, "obj": 16, "maximum": 16, "minimum": 16, "arrai": 16, "l1": 17, "_1": 17, "sum_": 17, "a_i": 17, "norm": 5, "norm1": 17, "l2": 17, "norm2": 17, "mathbf": 17, "_2": 17, "sqrt": 17, "n": 17, "expon": 18, "abs_pow": 18, "ep": 18, "rais": 18, "power": 18, "act": 18, "place": 18, "pow": 5}, "objects": {}, "objtypes": {}, "objnames": {}, "titleterms": {"express": 0, "diagon": 1, "api": [1, 2, 3, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18], "descript": [1, 2, 3, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18], "span": 2, "subspan": 3, "mpl": 4, "scope": [4, 19], "pressio": [4, 20, 21], "all_of": 4, "any_of": 4, "none_of": 4, "is_subscriptable_a": 4, "op": [5, 20], "ab": 6, "add_to_diagon": 7, "note": [6, 7, 8, 9, 10, 11, 12, 13, 14, 15], "clone": 8, "deep_copi": 9, "dot": 10, "elementwise_multipli": 11, "extent": 12, "fill": 13, "product": [14, 15], "type_trait": 19, "trait": 19, "class": 19, "type": [5, 14, 19], "detect": 19, "identif": 19, "concept": 20, "more": [], "info": [], "syntact": [], "constraint": [], "semant": [], "satisfi": [], "vs": 21, "model": [], "c": 20, "librari": [20, 22], "get": [20, 21], "start": 20, "gener": 20, "program": 20, "licens": [20, 23], "citat": 20, "question": 20, "instal": 21, "depend": 21, "option": [21, 22], "requir": 21, "In": 21, "practic": 21, "what": 21, "ar": 21, "step": 21, "us": 21, "cmake": 22, "keyword": 22, "third": 22, "parti": 22, "tpl": 22, "other": 22, "navig": 5, "matrix": [14, 15], "vector": 15, "min": 16, "max": 16, "norm": 17, "pow": 18}, "envversion": {"sphinx.domains.c": 2, "sphinx.domains.changeset": 1, "sphinx.domains.citation": 1, "sphinx.domains.cpp": 6, "sphinx.domains.index": 1, "sphinx.domains.javascript": 2, "sphinx.domains.math": 2, "sphinx.domains.python": 3, "sphinx.domains.rst": 2, "sphinx.domains.std": 2, "sphinx.ext.viewcode": 1, "sphinx.ext.intersphinx": 1, "sphinx": 56}}) \ No newline at end of file From 185eed033c7cd6ef4a3940fe02ec44c6f54b778a Mon Sep 17 00:00:00 2001 From: Caleb Schilly Date: Mon, 28 Oct 2024 10:56:28 -0400 Subject: [PATCH 6/9] #6: add documentation for remaining ops --- .gitignore | 1 + docs/source/components/ops.rst | 8 +- .../components/ops/matrix_matrix_product.rst | 4 +- .../components/ops/matrix_vector_product.rst | 4 +- docs/source/components/ops/resize.rst | 36 +++++++++ docs/source/components/ops/scale.rst | 42 ++++++++++ docs/source/components/ops/set_zero.rst | 42 ++++++++++ docs/source/components/ops/update.rst | 81 +++++++++++++++++++ 8 files changed, 212 insertions(+), 6 deletions(-) create mode 100644 docs/source/components/ops/resize.rst create mode 100644 docs/source/components/ops/scale.rst create mode 100644 docs/source/components/ops/set_zero.rst create mode 100644 docs/source/components/ops/update.rst diff --git a/.gitignore b/.gitignore index 722d5e7..c729ac5 100644 --- a/.gitignore +++ b/.gitignore @@ -1 +1,2 @@ .vscode +generated_docs diff --git a/docs/source/components/ops.rst b/docs/source/components/ops.rst index eaebc9e..11ba7bd 100644 --- a/docs/source/components/ops.rst +++ b/docs/source/components/ops.rst @@ -90,8 +90,12 @@ Use the links below to view details about each operation. ops/elementwise_multiply ops/extent ops/fill - ops/matrix_vector_product - ops/matrix_matrix_product ops/min_max ops/norms ops/pow + ops/matrix_matrix_product + ops/matrix_vector_product + ops/resize + ops/scale + ops/set_zero + ops/update diff --git a/docs/source/components/ops/matrix_matrix_product.rst b/docs/source/components/ops/matrix_matrix_product.rst index b300c55..96b7dcd 100644 --- a/docs/source/components/ops/matrix_matrix_product.rst +++ b/docs/source/components/ops/matrix_matrix_product.rst @@ -1,7 +1,7 @@ .. include:: ../../mydefs.rst -``matrix-matrix product`` -========================= +``product`` (matrix-matrix) +=========================== Header: ```` diff --git a/docs/source/components/ops/matrix_vector_product.rst b/docs/source/components/ops/matrix_vector_product.rst index 9e0a639..af8e344 100644 --- a/docs/source/components/ops/matrix_vector_product.rst +++ b/docs/source/components/ops/matrix_vector_product.rst @@ -1,7 +1,7 @@ .. include:: ../../mydefs.rst -``matrix-vector product`` -========================= +``product`` (matrix-vector) +=========================== Header: ```` diff --git a/docs/source/components/ops/resize.rst b/docs/source/components/ops/resize.rst new file mode 100644 index 0000000..f0a824f --- /dev/null +++ b/docs/source/components/ops/resize.rst @@ -0,0 +1,36 @@ +.. include:: ../../mydefs.rst + +``resize`` +========== + +Header: ```` + +API +--- + +.. code-block:: cpp + + namespace pressio { namespace ops{ + + // T is rank-1 + template + void resize(T & o, ::pressio::ops::impl::ordinal_t newSize); + + // T is rank-2 + template + void resize(T & o, + const ::pressio::ops::impl::ordinal_t newRows, + const ::pressio::ops::impl::ordinal_t newCols); + + }} // end namespace pressio::ops + +Description +----------- + +* Resizes ``o`` to the specified dimensions + +* ``o`` may be either of the following types: + + * A dynamic Eigen container + + * A dynamic Kokkos view diff --git a/docs/source/components/ops/scale.rst b/docs/source/components/ops/scale.rst new file mode 100644 index 0000000..9cf787a --- /dev/null +++ b/docs/source/components/ops/scale.rst @@ -0,0 +1,42 @@ +.. include:: ../../mydefs.rst + +``scale`` +========= + +Header: ```` + +API +--- + +.. code-block:: cpp + + namespace pressio { namespace ops{ + + template + void scale(T & o, const ScalarType & value); + + }} // end namespace pressio::ops + +Description +----------- + +* Multiplies every entry in ``o`` by ``value`` + +* ``o`` may be a rank-1 or rank-2 container of the following types: + + * Eigen (or a Pressio expression acting on an Eigen container) + + * Epetra + + * Kokkos (or a Pressio expression acting on a Kokkos container) + + * Teuchos + + * Tpetra (or a Pressio expression acting on a Tpetra container) + + * Tpetra Block (or a Pressio expression acting on a Tpetra Block container) + +Notes +----- + +* See the :doc:`ops homepage <../ops>` for a table of booleans to use when checking for the correct types. diff --git a/docs/source/components/ops/set_zero.rst b/docs/source/components/ops/set_zero.rst new file mode 100644 index 0000000..50ab31d --- /dev/null +++ b/docs/source/components/ops/set_zero.rst @@ -0,0 +1,42 @@ +.. include:: ../../mydefs.rst + +``set_zero`` +============ + +Header: ```` + +API +--- + +.. code-block:: cpp + + namespace pressio { namespace ops{ + + template + void set_zero(T & o); + + }} // end namespace pressio::ops + +Description +----------- + +* Sets every entry in ``o`` to zero + +* ``o`` may be a container of the following types: + + * Eigen (or a Pressio expression acting on an Eigen container) + + * Epetra (rank-1 only) + + * Kokkos (or a Pressio expression acting on a Kokkos container) + + * Teuchos (rank-1 only) + + * Tpetra (or a Pressio expression acting on a Tpetra container) + + * Tpetra Block (or a Pressio expression acting on a Tpetra Block container) + +Notes +----- + +* See the :doc:`ops homepage <../ops>` for a table of booleans to use when checking for the correct types. diff --git a/docs/source/components/ops/update.rst b/docs/source/components/ops/update.rst new file mode 100644 index 0000000..957b56d --- /dev/null +++ b/docs/source/components/ops/update.rst @@ -0,0 +1,81 @@ +.. include:: ../../mydefs.rst + +``update`` +========== + +Header: ```` + +API +--- + +.. code-block:: cpp + + namespace pressio { namespace ops{ + + // V = a * V + b * V1 + template + void update(T & v, const a_Type & a, + const T1 & v1, const b_Type & b); + + // V = a * V + b * V1 + c * V2 + template< + class T, class T1, class T2, + class a_Type, class b_Type, class c_Type + > + void update(T & v, const a_Type &a, + const T1 & v1, const b_Type &b, + const T2 & v2, const c_Type &c); + + // V = a * V + b * V1 + c * V2 + d * V3 + template< + class T, class T1, class T2, class T3, + class a_Type, class b_Type, class c_Type, class d_Type + > + void update(T & v, const a_Type &a, + const T1 & v1, const b_Type &b, + const T2 & v2, const c_Type &c, + const T3 & v3, const d_Type &d); + + // V = a * V + b * V1 + c * V2 + d * V3 + e * V4 + template< + class T, class T1, class T2, class T3, class T4, + class a_Type, class b_Type, class c_Type, class d_Type, class e_Type + > + void update(T & v, const a_Type &a, + const T1 & v1, const b_Type &b, + const T2 & v2, const c_Type &c, + const T3 & v3, const d_Type &d, + const T4 & v4, const e_Type &e); + + // Rank-2 overload (Eigen and Kokkos only) + // MV = a * MV + b * MV1 + template + void update(T & mv, const alpha_t &a, + const T1 & mv1, const beta_t &b) + + }} // end namespace pressio::ops + + +Description +----------- + +* Performs a combined scaling and addition on vector ``v`` using the given scalars (``a``, ``b``, ... , ``e``) and auxiliary vectors (``v1``, ... , ``v4``) + +* Stores the result in ``v`` + +* All vectors should have the same size and the same type. They may be: + + * Rank-1 or Rank-2 (see specific overload) Eigen containers or Pressio expressions of Eigen containers + + * Rank-1 Epetra containers + + * Rank-1 or Rank-2 (see specific overload) Kokkos containers or Pressio expressions of Kokkos containers + + * Rank-1 Tpetra containers or Pressio column expressions acting on Tpetra + + * Rank-1 Tpetra Block containers or Pressio column expressions acting on Tpetra Block + +Notes +----- + +* See the :doc:`ops homepage <../ops>` for a table of booleans to use when checking for the correct types. From e41901f347931829cd56363893928a14e7afbd6f Mon Sep 17 00:00:00 2001 From: Francesco Rizzi Date: Tue, 29 Oct 2024 14:07:14 +0100 Subject: [PATCH 7/9] update --- docs/source/conf.py | 2 +- docs/source/index.rst | 159 +++++++++-------------------------- docs/source/installation.rst | 119 ++++++++++---------------- docs/source/keywords.rst | 83 ------------------ 4 files changed, 88 insertions(+), 275 deletions(-) delete mode 100644 docs/source/keywords.rst diff --git a/docs/source/conf.py b/docs/source/conf.py index 2ae09bc..3af5bb6 100644 --- a/docs/source/conf.py +++ b/docs/source/conf.py @@ -20,7 +20,7 @@ # The master toctree document. master_doc = "index" -project = 'Pressio-Ops' +project = 'pressio-ops' # copyright = f'{datetime.datetime.now().year}, 2021, National Technology & Engineering Solutions of Sandia, LLC (NTESS)' copyright = u"2021, National Technology & Engineering Solutions of Sandia, LLC (NTESS)" author = 'Francesco Rizzi' diff --git a/docs/source/index.rst b/docs/source/index.rst index b7de9aa..6998707 100644 --- a/docs/source/index.rst +++ b/docs/source/index.rst @@ -6,75 +6,48 @@ pressio-ops C++ library ======================= -Documentation of the `C++ library `__, one element of the `Pressio ecosystem `_. - -This work was started with a focus on projection-based reduced-order models (ROMs), -which is a strongly **multidisciplinary** topic. -Working towards a production-level ROM capability inevitably means spanning -multiple fields ranging from, e.g., linear algebra, nonlinear solvers -and optimization, to time integration, distributed computing and HPC. -This constitutes a substantial challenge to tackle, whose complexity -increases if aiming to develop a **generic** library. - -To start such a project from the ground up, grow it and then being -able to maintain it, we believe **modularity, abstractions -and well-defined APIs** to be fundamental design principles to rely on. -This has been, and still is, at the core of our development effort, -and has lead to a highly *modular* design of pressio (see table below): -each component (level) of the stack covers a specific capability and depends, -via *well-defined public APIs*, on the ones below it. This has required (and still does) -a considerable development effort, since each component needs "attention" -and can easily be scoped into an independent, full-time project. - -So why doing all this rather than adopting a different, simpler approach, for example, -limiting and hiding as implementation some of the supporting functionalities? -Because we believe the current structure/design offers several major benefits -that would be hard---and in some cases impossible---to obtain otherwise: **flexibility, -extensibility, maintainability, and usability of each component on its own.** -One drawback is that at any point in time, the various components might -have different maturity levels, so reaching a comparable and solid maturity -across the stack might take some time---our current goal is to obtain -in version ``1.0.0`` a uniform maturity level *at least* across -the ``rom, ode and solvers`` components. Please keep this in mind while browsing -the documentation and the code. - -Notably, we have extracted the core operations from the ``Pressio/pressio`` repository -in order to increase modularity and allow users to build their code directly on top of -``pressio-ops`` if desired. - -However, it is still useful to consider ``pressio-ops`` within the context of ``pressio`` -to understand how the repositories fit together. - -The following components are included in ``Pressio/pressio`` and build off of the contents of ``pressio-ops``: +This library aims to provide a unified free-function-based interface +to facilitate usability and interoperability of widely-used linear algebra software libraries. -| - -.. list-table:: - :widths: 10 48 42 - :header-rows: 1 - :align: left - - * - - - Description - - Header(s) - - * - ``rom`` - - concepts :raw-html-m2r:`
      ` (linear) subspaces :raw-html-m2r:`
      ` Galerkin: steady :raw-html-m2r:`
      ` Galerkin: unsteady :raw-html-m2r:`
      ` LSPG: steady :raw-html-m2r:`
      ` LSPG: unsteady :raw-html-m2r:`
      ` :raw-html-m2r:`
      ` - - ```` :raw-html-m2r:`
      ` ```` :raw-html-m2r:`
      ` ```` :raw-html-m2r:`
      ` ```` :raw-html-m2r:`
      ` ```` :raw-html-m2r:`
      ` ```` :raw-html-m2r:`
      ` ```` :small:`includes all` - - * - ``ode`` - - concepts :raw-html-m2r:`
      ` explicit steppers :raw-html-m2r:`
      ` implicit steppers :raw-html-m2r:`
      ` ``advance_<*>`` fncs :raw-html-m2r:`
      ` :raw-html-m2r:`
      ` - - ```` :raw-html-m2r:`
      ` ```` :raw-html-m2r:`
      ` ```` :raw-html-m2r:`
      ` ```` :raw-html-m2r:`
      ` ```` :small:`includes all` - - * - ``solvers_nonlinear`` - - concepts :raw-html-m2r:`
      ` Newton method :raw-html-m2r:`
      ` Gauss-Newton :raw-html-m2r:`
      ` Lev.-Marq. :raw-html-m2r:`
      ` :raw-html-m2r:`
      ` - - ```` :raw-html-m2r:`
      ` ```` :raw-html-m2r:`
      ` ```` :raw-html-m2r:`
      ` ```` :raw-html-m2r:`
      ` ```` :small:`includes all` - - * - ``solvers_linear`` - - linear dense (on-node) solvers - - ```` +Motivation +---------- -The following components are included in ``Pressio/pressio-ops`` and can be used independently of the ``Pressio/pressio`` repository: +Linear algebra underpins many applications fundamental to science and industry. +Currently, there are multiple open-source libraries offering shared- and distributed-memory +linear algebra data structures (vectors, matrices, etc.) and/or kernel operations to manipulate them. +For example, Trilinos, PETSc, Kokkos/Kokkos-kernels, Eigen, Blitz++, Armadillo, mlpack, BLAS/LAPACK. +These libraries serve as foundations to many applications. +Compound this mutiplicity of efforts by the lack of interest and/or resources +to improve their usability and inteoperabability, and the result is a plethora +of linear algebra libraries that shared some key aspects: + +- **diverse API**: every library has its own custom API for doing, after all, the same set of operations. + This poses a major limitation to existing software stacks relying on them because it inhibits an easy transition to a different choice. + What would happen if one of these fundamental libraries were discontinued? + It would lead to *many* applications having to be refactored, a huge investment of resouces and development hours. + Also, this constitutes a problem for any new application that will being developed, since one would need to choose one library from the start + and stick to it, or reimplemnet support for multiple backends from scratch every time. + +- **hard-to-use API**: some of these libraries adopted an API that closely adheres to the BLAS standard, thus making them harder + to use for a generic user. It is well-known and accepted that the BLAS standard defines + an API is hard to read and use: one reason is that its API defines functions accepting several arguments, + with adjacent parameters that can be invoked by the same arguments in either order with different meaning. + This makes them hard to be used correctly---this was also a key motivation of the standardization effort that led to the C++26 stdBLAS feature. + +- **hard to extend/customize**: in some cases, e.g. Trilinos, the design is such that operations to manipulate data + are methods of the data structures classes themselves rather than free fucntions. In C++, such design precludes + the flexibility of doing user-level overloading or specialization of these "operations". + +- **minimal or non-existent interoperability**: the intoperability between some of these libraries is minimal or even non-existent. + Several factors contributed to this, inlcuding that some of the libraries were intended for heterogenous hardware, while some only work for CPUs; some only operate on a single node while others support distributed memory. This makes it really hard to couple different applications, exchange data, and operated on-line on different data structures. + +What pressio-ops offers +----------------------- + +This library tries to address some of issues above by providing a unified free-function-based interface +to facilitate usability and interoperability of widely-used linear algebra software libraries. +The supported capabilities are shown in the table below. +Each component (level) of the stack depends on the ones below it. | @@ -99,10 +72,6 @@ The following components are included in ``Pressio/pressio-ops`` and can be used - type traits and detection - ```` - * - ``utils`` - - logger, constants, etc - - ```` - * - ``mpl`` - metaprogramming functionalities - ```` @@ -111,52 +80,7 @@ The following components are included in ``Pressio/pressio-ops`` and can be used Get Started ----------- -* `Install pressio-ops `_: (currently) it is a header-only library, so should be trivial - - -Generic programming and concepts --------------------------------- - -Arguably the main foundation of pressio-ops is the use of -generic programming--*or, more humbly, we can at least say that it is what we strive for*. -Since the early development stages, we have relied on concept-driven design. -Note, that, if you have used or use C++ templates, you *have* used -concepts knowingly or not. This is because when you write a function or class -template, you have some expectations of what a template needs to expose/do. -C++20 concepts are, in some sense, a way to *explicitly* formalize those expectations. - - -Until we can stably upgrade to C++20, we cannot by default use C++20 concepts, -so we currently guard the concepts in pressio inside a -preprocessor directive ``#ifdef PRESSIO_ENABLE_CXX20``. This can be enabled by -using a C++20 compliant compiler and setting ``-DCMAKE_CXX_STANDARD=20`` at configure time. -The behavior is as follows: - -- if ``PRESSIO_ENABLE_CXX20`` is *enabled*: concepts are compiled and - enforced *stricto sensu* on the pressio APIs as discussed by this documentation - -- if ``PRESSIO_ENABLE_CXX20`` is *disabled*: this is the default case because the - default pressio C++ standard is currently C++14. In this case, the "C++20 concepts" - are not compiled but the constraints they represent are still valid and implemented - differently such that their enforcement is done via a combination of SFINAE and static asserts. - -.. important:: - - Well-defined concepts are hard to design and it takes time. Concepts used in pressio are - still being developed. Some are more mature than others. The approach we adopt is to first - focus on the syntax, then then we will revise them with proper semantics. Keep this in mind - if some concepts seem incomplete. - -.. - Here, the term concept does not necessarily - refer to the C++ concepts feature introduced in C++20. - You can think of it more broadly as "what properties/syntax a type meets, - what you can do with it and, also, what a type should definitely satisfy". - The message we want to convey is that *"concepts" are a fundamental - design part of pressio*. In our documentation, we make the effort to - highlight the use of concepts - by dedicating to each component of the library a full section - to discuss and formalize how concepts are used in that component. +* `Install `_: (currently) header-only, should be trivial License and Citation @@ -179,7 +103,6 @@ open an issue on `github `_. :hidden: installation - keywords .. toctree:: :caption: API diff --git a/docs/source/installation.rst b/docs/source/installation.rst index 3b637a3..b24a3ee 100644 --- a/docs/source/installation.rst +++ b/docs/source/installation.rst @@ -4,6 +4,9 @@ Installation and Dependencies ============================= +Installation +------------ + .. tip:: pressio-ops is header-only, so it does not need to be precompiled and linked to. @@ -18,25 +21,8 @@ Installation and Dependencies Dependencies ------------ -Some parts of ``pressio-ops`` contain code and implementations -that are specific to third-party libraries (TPLs). -An example is ``pressio/ops``\ , which contains kernels specializations -for widely-used HPC libraries (e.g. Trilinos, Kokkos). -The main reason for doing this is that we aim, where possible, -to alleviate the user from writing custom operations and allow ``pressio-ops`` to decide when and how to leverage -the native libraries' operations to obtain the best performance. -This should facilitate the integration and use of ``pressio-ops`` by existing applications. -This is a growing capability and we currently only -provide built-in support to some external HPC libraries (see below). -Obviously, these TPL-specific specializations need to be guarded with -preprecessor directives, and enabled only if one can access the TPLs. - -Enabling/disabling specific dependencies can be done via -the cmake variables `listed here `__. - - -Optional vs Required -^^^^^^^^^^^^^^^^^^^^ +Some parts contain code that are specific to third-party libraries (TPLs). +Currently, the list of TPLs supported is shown below: .. list-table:: :header-rows: 1 @@ -70,73 +56,60 @@ Optional vs Required Eigen is the only required dependency because it is the default choice for instantiating the ROM data structures -and solving the (dense) ROM problem. - -In practice, what are the steps to get, install and use Pressio? ----------------------------------------------------------------- +and solving the (dense) ROM problem used in `pressio `_. -\todo: add description for using pressio without configuring, -so one has to define the options directly when configuring -their code or inside the code directly. +CMake Keywords +~~~~~~~~~~~~~~ -1. Clone `pressio-ops `_ (defaults to the main branch), -or you can pick a `release version `_ +Enabling/disabling specific dependencies can be done via the following cmake variables: -2. Create a build and install subdirectories - -.. code-block:: bash - - cd - mkdir build && mkdir install +.. list-table:: + :widths: 30 60 10 + :header-rows: 1 + :align: left -3. Use cmake to configure by passing to the comand line the target list of cmake variables to define. + * - Variable + - Description + - Default -For example, suppose we want to enable support for Trilinos and the debug prints. We would do: + * - ``PRESSIO_ENABLE_TPL_EIGEN`` + - self-explanatory + - ``ON`` -.. code-block:: bash + * - ``PRESSIO_ENABLE_TPL_TRILINOS`` + - self-explanatory + - ``OFF`` - export PRESSIO_SRC= - cd /build + * - ``PRESSIO_ENABLE_TPL_MPI`` + - self-explanatory + - ``OFF`` but automatically ``ON`` if ``PRESSIO_ENABLE_TPL_TRILINOS=ON`` - cmake -D CMAKE_INSTALL_PREFIX=../install \ - -D PRESSIO_ENABLE_TPL_TRILINOS=ON \ - -D PRESSIO_ENABLE_DEBUG_PRINT=ON \ - ${PRESSIO_SRC} + * - ``PRESSIO_ENABLE_TPL_KOKKOS`` + - self-explanatory + - ``OFF`` but automatically ``ON`` if ``PRESSIO_ENABLE_TPL_TRILINOS=ON`` - make install # nothing is built, just headers copied to installation + * - ``PRESSIO_ENABLE_TEUCHOS_TIMERS`` + - self-explanatory + - ``OFF`` but automatically ``ON`` if ``PRESSIO_ENABLE_TPL_TRILINOS=ON`` -Note that this step does **not** build anything because ``pressio-ops`` is header-only, -but only processes the cmake arguments and copies the pressio headers to the -install prefix ``/install``. -If you want, inspect the file ``/install/pressio_ops_cmake_config.h`` -which contains the cmake variables configuration. -We also remark that during the configuration step above pressio-ops -does not need to know where a target TPL exists in your system. -In the configuration step above, you are simply telling Pressio that you have -a certain TPL and want to enable the corresponding code in pressio. -The TPLs will be needed at linking stage when you build *your* code that *uses* pressio. +Obviously, the choice of which TPLs to enable is related to +your application's dependency requirements. +For example, if you have an application that relies on +Trilinos data structures and want to use ``pressio``\ , +then it makes sense to enable the Trilinos dependency. +On the contrary, if you have an application that relies only on +Eigen data structures, then it makes sense to only leave only Eigen on +and disable the rest. -4. When building your application to use pressio-ops, you just have to point to -the installation directory ``/install`` with the installed -pressio-ops headers, and you can access all pressio-ops functionalities like so: +Also, we note that some of the cmake variables listed above are connected +and cannot be turned on individualy. +For example, if we enable Trilinos then ``pressio`` automatically +enables also Kokkos, BLAS, LAPACK and MPI. -.. code-block:: cpp - #include "pressio/what_you_need.hpp" - // ... - int main(){ - // do something - } +.. important:: -.. warning:: + All CMake keywords are prefixed with ``PRESSIO_`` which is case-sensitive. - The procedure above is advised because it enables ``pressio-ops`` - to properly process the cmake options and turn on/off based - on certain conditions (as explained above). - The alternative way to use pressio would be to just clone the repo, - point to the ``/include`` subdirectory - and use cmake variables directly when building your code. - However, this could have unexpected consequences since - you would be resposible to set the variables correctly but you would not - know exactly all the possible constraints. + Recall that to set a keyword in CMake you used the syntax ``-Dkeyword_name``. diff --git a/docs/source/keywords.rst b/docs/source/keywords.rst deleted file mode 100644 index 4c062af..0000000 --- a/docs/source/keywords.rst +++ /dev/null @@ -1,83 +0,0 @@ -CMake Keywords -############## - -.. important:: - - All CMake keywords are prefixed with ``PRESSIO_`` which is case-sensitive. - - Recall that to set a keyword in CMake you used the syntax ``-Dkeyword_name``. - - -Third-party Libraries (TPLs) -============================ - -The following options control enabling TPLs: - -.. list-table:: - :widths: 30 60 10 - :header-rows: 1 - :align: left - - * - Variable - - Description - - Default - - * - ``PRESSIO_ENABLE_TPL_EIGEN`` - - self-explanatory - - ``ON`` - - * - ``PRESSIO_ENABLE_TPL_TRILINOS`` - - self-explanatory - - ``OFF`` - - * - ``PRESSIO_ENABLE_TPL_MPI`` - - self-explanatory - - ``OFF`` automatically ``ON`` if ``PRESSIO_ENABLE_TPL_TRILINOS=ON`` - - * - ``PRESSIO_ENABLE_TPL_KOKKOS`` - - self-explanatory - - ``OFF``\ ; automatically ``ON`` if ``PRESSIO_ENABLE_TPL_TRILINOS=ON`` - - * - ``PRESSIO_ENABLE_TEUCHOS_TIMERS`` - - self-explanatory - - ``OFF`` automatically ``ON`` if ``PRESSIO_ENABLE_TPL_TRILINOS=ON`` - - -Obviously, the choice of which TPLs to enable is related to -your application's dependency requirements. -For example, if you have an application that relies on -Trilinos data structures and want to use ``pressio``\ , -then it makes sense to enable the Trilinos dependency. -On the contrary, if you have an application that relies only on -Eigen data structures, then it makes sense to only leave only Eigen on -and disable the rest. - -Also, we note that some of the cmake variables listed above are connected -and cannot be turned on individualy. -For example, if we enable Trilinos then ``pressio`` automatically -enables also Kokkos, BLAS, LAPACK and MPI. - - -Other Options -============= - -.. list-table:: - :widths: 30 60 10 - :header-rows: 1 - :align: left - - * - Variable - - Description - - Default - - * - ``PRESSIO_ENABLE_DEBUG_PRINT`` - - to enable debugging print statements - - ``OFF`` - - * - ``PRESSIO_ENABLE_CXX17`` - - enables C++17 standard - - ``ON`` since min standard is 17 - - * - ``PRESSIO_ENABLE_CXX20`` - - enables C++20 standard - - ``OFF``; turned on if ``CMAKE_CXX_STANDARD`` is set to 20 From d263b6a088cea90c9629e762ff56481ff953555e Mon Sep 17 00:00:00 2001 From: Francesco Rizzi Date: Tue, 29 Oct 2024 14:09:31 +0100 Subject: [PATCH 8/9] update [skip ci] --- docs/source/index.rst | 5 ++--- 1 file changed, 2 insertions(+), 3 deletions(-) diff --git a/docs/source/index.rst b/docs/source/index.rst index 6998707..5698002 100644 --- a/docs/source/index.rst +++ b/docs/source/index.rst @@ -119,7 +119,6 @@ open an issue on `github `_. :maxdepth: 1 :hidden: - Tutorials - GitHub Repo - Open an issue/feature req. + GitHub Repo + Open an issue/feature req. license From 9a641e8b1133bd918ac7274132c90fb093da3d27 Mon Sep 17 00:00:00 2001 From: Caleb Schilly Date: Tue, 29 Oct 2024 10:28:24 -0400 Subject: [PATCH 9/9] #6: add documentation for expressions --- docs/source/components/expressions.rst | 2 ++ docs/source/components/expressions/column.rst | 31 +++++++++++++++++++ docs/source/components/expressions/diag.rst | 4 +-- .../components/expressions/is_expression.rst | 31 +++++++++++++++++++ docs/source/components/expressions/span.rst | 8 ++--- .../source/components/expressions/subspan.rst | 6 ++-- 6 files changed, 73 insertions(+), 9 deletions(-) create mode 100644 docs/source/components/expressions/column.rst create mode 100644 docs/source/components/expressions/is_expression.rst diff --git a/docs/source/components/expressions.rst b/docs/source/components/expressions.rst index 4a298f3..93ed848 100644 --- a/docs/source/components/expressions.rst +++ b/docs/source/components/expressions.rst @@ -17,3 +17,5 @@ If the operand goes out of scope, the state of the expression is undefined. expressions/span expressions/subspan expressions/diag + expressions/column + expressions/is_expression diff --git a/docs/source/components/expressions/column.rst b/docs/source/components/expressions/column.rst new file mode 100644 index 0000000..bd58edb --- /dev/null +++ b/docs/source/components/expressions/column.rst @@ -0,0 +1,31 @@ +.. include:: ../../mydefs.rst + +``column`` +========== + +Header: ```` + +API +--- + +.. code-block:: cpp + + namespace pressio { + + template + /*impl defined*/ column(T & operand, IndexType colIndex); + + } // end namespace pressio + +Description +----------- + +* Takes in an ``operand``, as well as the index of the specified column ``colIndex`` + + * ``operand`` is either: + + * an Eigen dense matrix + + * a Tpetra or Tpetra Block multivector + +* Returns an expression object that represents the specified column from the ``operand``. diff --git a/docs/source/components/expressions/diag.rst b/docs/source/components/expressions/diag.rst index 0477c2f..eae0e39 100644 --- a/docs/source/components/expressions/diag.rst +++ b/docs/source/components/expressions/diag.rst @@ -22,8 +22,8 @@ Description * Takes in an ``operand`` that is either: - * a square Eigen dense matrix, ``pressio::is_dense_matrix_eigen::value == true`` + * a square Eigen dense matrix, ``pressio::is_dense_matrix_eigen::value == true`` - * a square Kokkos rank-2 view, i.e. ``pressio::is_dense_matrix_kokkos::value == true`` + * a square Kokkos rank-2 view, i.e. ``pressio::is_dense_matrix_kokkos::value == true`` * Returns an expression that represents that diagonal of ``operand`` diff --git a/docs/source/components/expressions/is_expression.rst b/docs/source/components/expressions/is_expression.rst new file mode 100644 index 0000000..7753a71 --- /dev/null +++ b/docs/source/components/expressions/is_expression.rst @@ -0,0 +1,31 @@ +.. include:: ../../mydefs.rst + +``is_expression`` +================= + +Header: ```` + +API +--- + +.. code-block:: cpp + + namespace pressio { + + // For a given type T + bool eigen = is_expression_acting_on_eigen::value; + + bool kokkos = is_expression_acting_on_kokkos::value; + + bool tpetra = is_expression_acting_on_tpetra::value; + bool tpetra = is_expression_column_acting_on_tpetra::value; + + bool tpetra_block = is_expression_acting_on_tpetra_block::value; + bool tpetra_block = is_expression_column_acting_on_tpetra_block::value; + + } // end namespace pressio + +Description +----------- + +* Returns a boolean to indicate if the given type ``T`` is the specified expression type diff --git a/docs/source/components/expressions/span.rst b/docs/source/components/expressions/span.rst index 7ba84c3..713f4ef 100644 --- a/docs/source/components/expressions/span.rst +++ b/docs/source/components/expressions/span.rst @@ -23,13 +23,13 @@ Description * Takes in an ``operand`` and an ``indexRange`` - * ``operand`` is either: + * ``operand`` is either: - * an Eigen vector object: ``pressio::is_vector_eigen::value == true`` + * an Eigen vector object: ``pressio::is_vector_eigen::value == true`` - * a Kokkos rank-1 view, i.e. ``pressio::is_vector_kokkos::value == true`` + * a Kokkos rank-1 view, i.e. ``pressio::is_vector_kokkos::value == true`` - * ``indexRange`` is a std::pairidentifying an interval ``[a, b)`` where the second index is exclusive + * ``indexRange`` is a std::pairidentifying an interval ``[a, b)`` where the second index is exclusive * Returns an expression that represents the target span of the ``operand``. diff --git a/docs/source/components/expressions/subspan.rst b/docs/source/components/expressions/subspan.rst index a01c844..d80a077 100644 --- a/docs/source/components/expressions/subspan.rst +++ b/docs/source/components/expressions/subspan.rst @@ -24,10 +24,10 @@ Description * Takes in an ``operand``, as well as the ``rowsRange`` and ``colsRange`` intervals that will be used in each dimension - * ``operand`` is either: + * ``operand`` is either: - * an Eigen dense matrix, ``pressio::is_dense_matrix_eigen::value == true`` + * an Eigen dense matrix, ``pressio::is_dense_matrix_eigen::value == true`` - * a Kokkos rank-2 view, i.e. ``pressio::is_dense_matrix_kokkos::value == true`` + * a Kokkos rank-2 view, i.e. ``pressio::is_dense_matrix_kokkos::value == true`` * Returns an expression object that represents a subspan of the ``operand``.