diff --git a/docs/Makefile b/docs/Makefile deleted file mode 100755 index d0c3cbf..0000000 --- a/docs/Makefile +++ /dev/null @@ -1,20 +0,0 @@ -# Minimal makefile for Sphinx documentation -# - -# You can set these variables from the command line, and also -# from the environment for the first two. -SPHINXOPTS ?= -SPHINXBUILD ?= sphinx-build -SOURCEDIR = source -BUILDDIR = build - -# Put it first so that "make" without argument is like "make help". -help: - @$(SPHINXBUILD) -M help "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O) - -.PHONY: help Makefile - -# Catch-all target: route all unknown targets to Sphinx using the new -# "make mode" option. $(O) is meant as a shortcut for $(SPHINXOPTS). -%: Makefile - @$(SPHINXBUILD) -M $@ "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O) diff --git a/docs/build/doctrees/environment.pickle b/docs/build/doctrees/environment.pickle deleted file mode 100755 index 7e285ce..0000000 Binary files a/docs/build/doctrees/environment.pickle and /dev/null differ diff --git a/docs/build/doctrees/index.doctree b/docs/build/doctrees/index.doctree deleted file mode 100755 index 9a157e5..0000000 Binary files a/docs/build/doctrees/index.doctree and /dev/null differ diff --git a/docs/build/doctrees/modules.doctree b/docs/build/doctrees/modules.doctree deleted file mode 100755 index 109c459..0000000 Binary files a/docs/build/doctrees/modules.doctree and /dev/null differ diff --git a/docs/build/doctrees/stixdcpy.doctree b/docs/build/doctrees/stixdcpy.doctree deleted file mode 100755 index 06cc54b..0000000 Binary files a/docs/build/doctrees/stixdcpy.doctree and /dev/null differ diff --git a/docs/build/html/.buildinfo b/docs/build/html/.buildinfo deleted file mode 100755 index 490f5bb..0000000 --- a/docs/build/html/.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: 152a61ac7f0bfd22839bd3529f82a2ad -tags: 645f666f9bcd5a90fca523b33c5a78b7 diff --git a/docs/build/html/_sources/index.rst.txt b/docs/build/html/_sources/index.rst.txt deleted file mode 100755 index f1c3472..0000000 --- a/docs/build/html/_sources/index.rst.txt +++ /dev/null @@ -1,24 +0,0 @@ -.. stixdcpy documentation master file, created by - sphinx-quickstart on Tue Sep 7 13:51:38 2021. - You can adapt this file completely to your liking, but it should at least - contain the root `toctree` directive. - -Welcome to stixdcpy's documentation! -==================================== - -.. toctree:: - :maxdepth: 2 - :caption: Contents: - - modules - - - - - -Indices and tables -================== - -* :ref:`genindex` -* :ref:`modindex` -* :ref:`search` diff --git a/docs/build/html/_sources/modules.rst.txt b/docs/build/html/_sources/modules.rst.txt deleted file mode 100755 index 9d3c49b..0000000 --- a/docs/build/html/_sources/modules.rst.txt +++ /dev/null @@ -1,7 +0,0 @@ -stixdcpy -======== - -.. toctree:: - :maxdepth: 4 - - stixdcpy diff --git a/docs/build/html/_sources/stixdcpy.rst.txt b/docs/build/html/_sources/stixdcpy.rst.txt deleted file mode 100755 index f6d07bb..0000000 --- a/docs/build/html/_sources/stixdcpy.rst.txt +++ /dev/null @@ -1,85 +0,0 @@ -stixdcpy package -================ - -Submodules ----------- - -stixdcpy.ancillarydata module ------------------------------ - -.. automodule:: stixdcpy.ancillarydata - :members: - :undoc-members: - :show-inheritance: - -stixdcpy.energylut module -------------------------- - -.. automodule:: stixdcpy.energylut - :members: - :undoc-members: - :show-inheritance: - -stixdcpy.housekeeping module ----------------------------- - -.. automodule:: stixdcpy.housekeeping - :members: - :undoc-members: - :show-inheritance: - -stixdcpy.io module ------------------- - -.. automodule:: stixdcpy.io - :members: - :undoc-members: - :show-inheritance: - -stixdcpy.net module -------------------- - -.. automodule:: stixdcpy.net - :members: - :undoc-members: - :show-inheritance: - -stixdcpy.quicklook module -------------------------- - -.. automodule:: stixdcpy.quicklook - :members: - :undoc-members: - :show-inheritance: - -stixdcpy.sci\_l1\_corrections module ------------------------------------- - -.. automodule:: stixdcpy.sci_l1_corrections - :members: - :undoc-members: - :show-inheritance: - -stixdcpy.sciencedata module ---------------------------- - -.. automodule:: stixdcpy.sciencedata - :members: - :undoc-members: - :show-inheritance: - -stixdcpy.time module --------------------- - -.. automodule:: stixdcpy.time - :members: - :undoc-members: - :show-inheritance: - -Module contents ---------------- - -.. automodule:: stixdcpy - :members: - :undoc-members: - :show-inheritance: diff --git a/docs/build/html/_static/alabaster.css b/docs/build/html/_static/alabaster.css deleted file mode 100755 index 0eddaeb..0000000 --- a/docs/build/html/_static/alabaster.css +++ /dev/null @@ -1,701 +0,0 @@ -@import url("basic.css"); - -/* -- page layout ----------------------------------------------------------- */ - -body { - font-family: Georgia, serif; - font-size: 17px; - background-color: #fff; - color: #000; - margin: 0; - padding: 0; -} - - -div.document { - width: 940px; - margin: 30px auto 0 auto; -} - -div.documentwrapper { - float: left; - width: 100%; -} - -div.bodywrapper { - margin: 0 0 0 220px; -} - -div.sphinxsidebar { - width: 220px; - font-size: 14px; - line-height: 1.5; -} - -hr { - border: 1px solid #B1B4B6; -} - -div.body { - background-color: #fff; - color: #3E4349; - padding: 0 30px 0 30px; -} - -div.body > .section { - text-align: left; -} - -div.footer { - width: 940px; - margin: 20px auto 30px auto; - font-size: 14px; - color: #888; - text-align: right; -} - -div.footer a { - color: #888; -} - -p.caption { - font-family: inherit; - font-size: inherit; -} - - -div.relations { - display: none; -} - - -div.sphinxsidebar a { - color: #444; - text-decoration: none; - border-bottom: 1px dotted #999; -} - -div.sphinxsidebar a:hover { - border-bottom: 1px solid #999; -} - -div.sphinxsidebarwrapper { - padding: 18px 10px; -} - -div.sphinxsidebarwrapper p.logo { - padding: 0; - margin: -10px 0 0 0px; - text-align: center; -} - -div.sphinxsidebarwrapper h1.logo { - margin-top: -10px; - text-align: center; - margin-bottom: 5px; - text-align: left; -} - -div.sphinxsidebarwrapper h1.logo-name { - margin-top: 0px; -} - -div.sphinxsidebarwrapper p.blurb { - margin-top: 0; - font-style: normal; -} - -div.sphinxsidebar h3, -div.sphinxsidebar h4 { - font-family: Georgia, serif; - color: #444; - font-size: 24px; - font-weight: normal; - margin: 0 0 5px 0; - padding: 0; -} - -div.sphinxsidebar h4 { - font-size: 20px; -} - -div.sphinxsidebar h3 a { - color: #444; -} - -div.sphinxsidebar p.logo a, -div.sphinxsidebar h3 a, -div.sphinxsidebar p.logo a:hover, -div.sphinxsidebar h3 a:hover { - border: none; -} - -div.sphinxsidebar p { - color: #555; - margin: 10px 0; -} - -div.sphinxsidebar ul { - margin: 10px 0; - padding: 0; - color: #000; -} - -div.sphinxsidebar ul li.toctree-l1 > a { - font-size: 120%; -} - -div.sphinxsidebar ul li.toctree-l2 > a { - font-size: 110%; -} - -div.sphinxsidebar input { - border: 1px solid #CCC; - font-family: Georgia, serif; - font-size: 1em; -} - -div.sphinxsidebar hr { - border: none; - height: 1px; - color: #AAA; - background: #AAA; - - text-align: left; - margin-left: 0; - width: 50%; -} - -div.sphinxsidebar .badge { - border-bottom: none; -} - -div.sphinxsidebar .badge:hover { - border-bottom: none; -} - -/* To address an issue with donation coming after search */ -div.sphinxsidebar h3.donation { - margin-top: 10px; -} - -/* -- body styles ----------------------------------------------------------- */ - -a { - color: #004B6B; - text-decoration: underline; -} - -a:hover { - color: #6D4100; - text-decoration: underline; -} - -div.body h1, -div.body h2, -div.body h3, -div.body h4, -div.body h5, -div.body h6 { - font-family: Georgia, serif; - font-weight: normal; - margin: 30px 0px 10px 0px; - padding: 0; -} - -div.body h1 { margin-top: 0; padding-top: 0; font-size: 240%; } -div.body h2 { font-size: 180%; } -div.body h3 { font-size: 150%; } -div.body h4 { font-size: 130%; } -div.body h5 { font-size: 100%; } -div.body h6 { font-size: 100%; } - -a.headerlink { - color: #DDD; - padding: 0 4px; - text-decoration: none; -} - -a.headerlink:hover { - color: #444; - background: #EAEAEA; -} - -div.body p, div.body dd, div.body li { - line-height: 1.4em; -} - -div.admonition { - margin: 20px 0px; - padding: 10px 30px; - background-color: #EEE; - border: 1px solid #CCC; -} - -div.admonition tt.xref, div.admonition code.xref, div.admonition a tt { - background-color: #FBFBFB; - border-bottom: 1px solid #fafafa; -} - -div.admonition p.admonition-title { - font-family: Georgia, serif; - font-weight: normal; - font-size: 24px; - margin: 0 0 10px 0; - padding: 0; - line-height: 1; -} - -div.admonition p.last { - margin-bottom: 0; -} - -div.highlight { - background-color: #fff; -} - -dt:target, .highlight { - background: #FAF3E8; -} - -div.warning { - background-color: #FCC; - border: 1px solid #FAA; -} - -div.danger { - background-color: #FCC; - border: 1px solid #FAA; - -moz-box-shadow: 2px 2px 4px #D52C2C; - -webkit-box-shadow: 2px 2px 4px #D52C2C; - box-shadow: 2px 2px 4px #D52C2C; -} - -div.error { - background-color: #FCC; - border: 1px solid #FAA; - -moz-box-shadow: 2px 2px 4px #D52C2C; - -webkit-box-shadow: 2px 2px 4px #D52C2C; - box-shadow: 2px 2px 4px #D52C2C; -} - -div.caution { - background-color: #FCC; - border: 1px solid #FAA; -} - -div.attention { - background-color: #FCC; - border: 1px solid #FAA; -} - -div.important { - background-color: #EEE; - border: 1px solid #CCC; -} - -div.note { - background-color: #EEE; - border: 1px solid #CCC; -} - -div.tip { - background-color: #EEE; - border: 1px solid #CCC; -} - -div.hint { - background-color: #EEE; - border: 1px solid #CCC; -} - -div.seealso { - background-color: #EEE; - border: 1px solid #CCC; -} - -div.topic { - background-color: #EEE; -} - -p.admonition-title { - display: inline; -} - -p.admonition-title:after { - content: ":"; -} - -pre, tt, code { - font-family: 'Consolas', 'Menlo', 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', monospace; - font-size: 0.9em; -} - -.hll { - background-color: #FFC; - margin: 0 -12px; - padding: 0 12px; - display: block; -} - -img.screenshot { -} - -tt.descname, tt.descclassname, code.descname, code.descclassname { - font-size: 0.95em; -} - -tt.descname, code.descname { - padding-right: 0.08em; -} - -img.screenshot { - -moz-box-shadow: 2px 2px 4px #EEE; - -webkit-box-shadow: 2px 2px 4px #EEE; - box-shadow: 2px 2px 4px #EEE; -} - -table.docutils { - border: 1px solid #888; - -moz-box-shadow: 2px 2px 4px #EEE; - -webkit-box-shadow: 2px 2px 4px #EEE; - box-shadow: 2px 2px 4px #EEE; -} - -table.docutils td, table.docutils th { - border: 1px solid #888; - padding: 0.25em 0.7em; -} - -table.field-list, table.footnote { - border: none; - -moz-box-shadow: none; - -webkit-box-shadow: none; - box-shadow: none; -} - -table.footnote { - margin: 15px 0; - width: 100%; - border: 1px solid #EEE; - background: #FDFDFD; - font-size: 0.9em; -} - -table.footnote + table.footnote { - margin-top: -15px; - border-top: none; -} - -table.field-list th { - padding: 0 0.8em 0 0; -} - -table.field-list td { - padding: 0; -} - -table.field-list p { - margin-bottom: 0.8em; -} - -/* Cloned from - * https://github.com/sphinx-doc/sphinx/commit/ef60dbfce09286b20b7385333d63a60321784e68 - */ -.field-name { - -moz-hyphens: manual; - -ms-hyphens: manual; - -webkit-hyphens: manual; - hyphens: manual; -} - -table.footnote td.label { - width: .1px; - padding: 0.3em 0 0.3em 0.5em; -} - -table.footnote td { - padding: 0.3em 0.5em; -} - -dl { - margin: 0; - padding: 0; -} - -dl dd { - margin-left: 30px; -} - -blockquote { - margin: 0 0 0 30px; - padding: 0; -} - -ul, ol { - /* Matches the 30px from the narrow-screen "li > ul" selector below */ - margin: 10px 0 10px 30px; - padding: 0; -} - -pre { - background: #EEE; - padding: 7px 30px; - margin: 15px 0px; - line-height: 1.3em; -} - -div.viewcode-block:target { - background: #ffd; -} - -dl pre, blockquote pre, li pre { - margin-left: 0; - padding-left: 30px; -} - -tt, code { - background-color: #ecf0f3; - color: #222; - /* padding: 1px 2px; */ -} - -tt.xref, code.xref, a tt { - background-color: #FBFBFB; - border-bottom: 1px solid #fff; -} - -a.reference { - text-decoration: none; - border-bottom: 1px dotted #004B6B; -} - -/* Don't put an underline on images */ -a.image-reference, a.image-reference:hover { - border-bottom: none; -} - -a.reference:hover { - border-bottom: 1px solid #6D4100; -} - -a.footnote-reference { - text-decoration: none; - font-size: 0.7em; - vertical-align: top; - border-bottom: 1px dotted #004B6B; -} - -a.footnote-reference:hover { - border-bottom: 1px solid #6D4100; -} - -a:hover tt, a:hover code { - background: #EEE; -} - - -@media screen and (max-width: 870px) { - - div.sphinxsidebar { - display: none; - } - - div.document { - width: 100%; - - } - - div.documentwrapper { - margin-left: 0; - margin-top: 0; - margin-right: 0; - margin-bottom: 0; - } - - div.bodywrapper { - margin-top: 0; - margin-right: 0; - margin-bottom: 0; - margin-left: 0; - } - - ul { - margin-left: 0; - } - - li > ul { - /* Matches the 30px from the "ul, ol" selector above */ - margin-left: 30px; - } - - .document { - width: auto; - } - - .footer { - width: auto; - } - - .bodywrapper { - margin: 0; - } - - .footer { - width: auto; - } - - .github { - display: none; - } - - - -} - - - -@media screen and (max-width: 875px) { - - body { - margin: 0; - padding: 20px 30px; - } - - div.documentwrapper { - float: none; - background: #fff; - } - - div.sphinxsidebar { - display: block; - float: none; - width: 102.5%; - margin: 50px -30px -20px -30px; - padding: 10px 20px; - background: #333; - color: #FFF; - } - - div.sphinxsidebar h3, div.sphinxsidebar h4, div.sphinxsidebar p, - div.sphinxsidebar h3 a { - color: #fff; - } - - div.sphinxsidebar a { - color: #AAA; - } - - div.sphinxsidebar p.logo { - display: none; - } - - div.document { - width: 100%; - margin: 0; - } - - div.footer { - display: none; - } - - div.bodywrapper { - margin: 0; - } - - div.body { - min-height: 0; - padding: 0; - } - - .rtd_doc_footer { - display: none; - } - - .document { - width: auto; - } - - .footer { - width: auto; - } - - .footer { - width: auto; - } - - .github { - display: none; - } -} - - -/* misc. */ - -.revsys-inline { - display: none!important; -} - -/* Make nested-list/multi-paragraph items look better in Releases changelog - * pages. Without this, docutils' magical list fuckery causes inconsistent - * formatting between different release sub-lists. - */ -div#changelog > div.section > ul > li > p:only-child { - margin-bottom: 0; -} - -/* Hide fugly table cell borders in ..bibliography:: directive output */ -table.docutils.citation, table.docutils.citation td, table.docutils.citation th { - border: none; - /* Below needed in some edge cases; if not applied, bottom shadows appear */ - -moz-box-shadow: none; - -webkit-box-shadow: none; - box-shadow: none; -} - - -/* relbar */ - -.related { - line-height: 30px; - width: 100%; - font-size: 0.9rem; -} - -.related.top { - border-bottom: 1px solid #EEE; - margin-bottom: 20px; -} - -.related.bottom { - border-top: 1px solid #EEE; -} - -.related ul { - padding: 0; - margin: 0; - list-style: none; -} - -.related li { - display: inline; -} - -nav#rellinks { - float: right; -} - -nav#rellinks li+li:before { - content: "|"; -} - -nav#breadcrumbs li+li:before { - content: "\00BB"; -} - -/* Hide certain items when printing */ -@media print { - div.related { - display: none; - } -} \ No newline at end of file diff --git a/docs/build/html/_static/basic.css b/docs/build/html/_static/basic.css deleted file mode 100755 index 912859b..0000000 --- a/docs/build/html/_static/basic.css +++ /dev/null @@ -1,904 +0,0 @@ -/* - * basic.css - * ~~~~~~~~~ - * - * Sphinx stylesheet -- basic theme. - * - * :copyright: Copyright 2007-2021 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: 450px; - 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, blockquote { - clear: left; -} - -/* -- topics ---------------------------------------------------------------- */ - -div.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, -div.admonition > :last-child { - margin-bottom: 0; -} - -div.sidebar::after, -aside.sidebar::after, -div.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; -} - -table.footnote td, table.footnote th { - border: 0 !important; -} - -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; -} - -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; -} - -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.5em; - content: ":"; -} - -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; -} - -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/build/html/_static/custom.css b/docs/build/html/_static/custom.css deleted file mode 100755 index 2a924f1..0000000 --- a/docs/build/html/_static/custom.css +++ /dev/null @@ -1 +0,0 @@ -/* This file intentionally left blank. */ diff --git a/docs/build/html/_static/doctools.js b/docs/build/html/_static/doctools.js deleted file mode 100755 index 8cbf1b1..0000000 --- a/docs/build/html/_static/doctools.js +++ /dev/null @@ -1,323 +0,0 @@ -/* - * doctools.js - * ~~~~~~~~~~~ - * - * Sphinx JavaScript utilities for all documentation. - * - * :copyright: Copyright 2007-2021 by the Sphinx team, see AUTHORS. - * :license: BSD, see LICENSE for details. - * - */ - -/** - * select a different prefix for underscore - */ -$u = _.noConflict(); - -/** - * make the code below compatible with browsers without - * an installed firebug like debugger -if (!window.console || !console.firebug) { - var names = ["log", "debug", "info", "warn", "error", "assert", "dir", - "dirxml", "group", "groupEnd", "time", "timeEnd", "count", "trace", - "profile", "profileEnd"]; - window.console = {}; - for (var i = 0; i < names.length; ++i) - window.console[names[i]] = function() {}; -} - */ - -/** - * 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; -} - -/** - * Small JavaScript module for the documentation. - */ -var Documentation = { - - init : function() { - this.fixFirefoxAnchorBug(); - this.highlightSearchWords(); - this.initIndexTable(); - if (DOCUMENTATION_OPTIONS.NAVIGATION_WITH_KEYS) { - this.initOnKeyListeners(); - } - }, - - /** - * i18n support - */ - TRANSLATIONS : {}, - PLURAL_EXPR : function(n) { return 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 : function(string) { - var translated = Documentation.TRANSLATIONS[string]; - if (typeof translated === 'undefined') - return string; - return (typeof translated === 'string') ? translated : translated[0]; - }, - - ngettext : function(singular, plural, n) { - var translated = Documentation.TRANSLATIONS[singular]; - if (typeof translated === 'undefined') - return (n == 1) ? singular : plural; - return translated[Documentation.PLURALEXPR(n)]; - }, - - addTranslations : function(catalog) { - for (var key in catalog.messages) - this.TRANSLATIONS[key] = catalog.messages[key]; - this.PLURAL_EXPR = new Function('n', 'return +(' + catalog.plural_expr + ')'); - this.LOCALE = catalog.locale; - }, - - /** - * add context elements like header anchor links - */ - addContextElements : function() { - $('div[id] > :header:first').each(function() { - $('\u00B6'). - attr('href', '#' + this.id). - attr('title', _('Permalink to this headline')). - appendTo(this); - }); - $('dt[id]').each(function() { - $('\u00B6'). - attr('href', '#' + this.id). - attr('title', _('Permalink to this definition')). - appendTo(this); - }); - }, - - /** - * workaround a firefox stupidity - * see: https://bugzilla.mozilla.org/show_bug.cgi?id=645075 - */ - fixFirefoxAnchorBug : function() { - if (document.location.hash && $.browser.mozilla) - window.setTimeout(function() { - document.location.href += ''; - }, 10); - }, - - /** - * highlight the search words provided in the url in the text - */ - highlightSearchWords : function() { - var params = $.getQueryParameters(); - var terms = (params.highlight) ? params.highlight[0].split(/\s+/) : []; - if (terms.length) { - var body = $('div.body'); - if (!body.length) { - body = $('body'); - } - window.setTimeout(function() { - $.each(terms, function() { - body.highlightText(this.toLowerCase(), 'highlighted'); - }); - }, 10); - $('') - .appendTo($('#searchbox')); - } - }, - - /** - * init the domain index toggle buttons - */ - initIndexTable : function() { - var togglers = $('img.toggler').click(function() { - var src = $(this).attr('src'); - var idnum = $(this).attr('id').substr(7); - $('tr.cg-' + idnum).toggle(); - if (src.substr(-9) === 'minus.png') - $(this).attr('src', src.substr(0, src.length-9) + 'plus.png'); - else - $(this).attr('src', src.substr(0, src.length-8) + 'minus.png'); - }).css('display', ''); - if (DOCUMENTATION_OPTIONS.COLLAPSE_INDEX) { - togglers.click(); - } - }, - - /** - * helper function to hide the search marks again - */ - hideSearchWords : function() { - $('#searchbox .highlight-link').fadeOut(300); - $('span.highlighted').removeClass('highlighted'); - }, - - /** - * make the url absolute - */ - makeURL : function(relativeURL) { - return DOCUMENTATION_OPTIONS.URL_ROOT + '/' + relativeURL; - }, - - /** - * get the current relative url - */ - getCurrentURL : function() { - var path = document.location.pathname; - var parts = path.split(/\//); - $.each(DOCUMENTATION_OPTIONS.URL_ROOT.split(/\//), function() { - if (this === '..') - parts.pop(); - }); - var url = parts.join('/'); - return path.substring(url.lastIndexOf('/') + 1, path.length - 1); - }, - - initOnKeyListeners: function() { - $(document).keydown(function(event) { - var activeElementType = document.activeElement.tagName; - // don't navigate when in search box, textarea, dropdown or button - if (activeElementType !== 'TEXTAREA' && activeElementType !== 'INPUT' && activeElementType !== 'SELECT' - && activeElementType !== 'BUTTON' && !event.altKey && !event.ctrlKey && !event.metaKey - && !event.shiftKey) { - switch (event.keyCode) { - case 37: // left - var prevHref = $('link[rel="prev"]').prop('href'); - if (prevHref) { - window.location.href = prevHref; - return false; - } - break; - case 39: // right - var nextHref = $('link[rel="next"]').prop('href'); - if (nextHref) { - window.location.href = nextHref; - return false; - } - break; - } - } - }); - } -}; - -// quick alias for translations -_ = Documentation.gettext; - -$(document).ready(function() { - Documentation.init(); -}); diff --git a/docs/build/html/_static/documentation_options.js b/docs/build/html/_static/documentation_options.js deleted file mode 100755 index 07966ec..0000000 --- a/docs/build/html/_static/documentation_options.js +++ /dev/null @@ -1,12 +0,0 @@ -var DOCUMENTATION_OPTIONS = { - URL_ROOT: document.getElementById("documentation_options").getAttribute('data-url_root'), - VERSION: '1.0', - LANGUAGE: 'None', - COLLAPSE_INDEX: false, - BUILDER: 'html', - FILE_SUFFIX: '.html', - LINK_SUFFIX: '.html', - HAS_SOURCE: true, - SOURCELINK_SUFFIX: '.txt', - NAVIGATION_WITH_KEYS: false -}; \ No newline at end of file diff --git a/docs/build/html/_static/file.png b/docs/build/html/_static/file.png deleted file mode 100755 index a858a41..0000000 Binary files a/docs/build/html/_static/file.png and /dev/null differ diff --git a/docs/build/html/_static/jquery-3.5.1.js b/docs/build/html/_static/jquery-3.5.1.js deleted file mode 100755 index 5093733..0000000 --- a/docs/build/html/_static/jquery-3.5.1.js +++ /dev/null @@ -1,10872 +0,0 @@ -/*! - * jQuery JavaScript Library v3.5.1 - * https://jquery.com/ - * - * Includes Sizzle.js - * https://sizzlejs.com/ - * - * Copyright JS Foundation and other contributors - * Released under the MIT license - * https://jquery.org/license - * - * Date: 2020-05-04T22:49Z - */ -( 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. - return typeof obj === "function" && typeof obj.nodeType !== "number"; - }; - - -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.5.1", - - // 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.5 - * https://sizzlejs.com/ - * - * Copyright JS Foundation and other contributors - * Released under the MIT license - * https://js.foundation/ - * - * Date: 2020-03-14 - */ -( 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.namespaceURI, - docElem = ( 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 master Deferred - master = 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 ) ) { - master.resolveWith( resolveContexts, resolveValues ); - } - }; - }; - - // Single- and empty arguments are adopted like Promise.resolve - if ( remaining <= 1 ) { - adoptValue( singleValue, master.done( updateFunc( i ) ).resolve, master.reject, - !remaining ); - - // Use .then() to unwrap secondary thenables (cf. gh-3000) - if ( master.state() === "pending" || - isFunction( resolveValues[ i ] && resolveValues[ i ].then ) ) { - - return master.then(); - } - } - - // Multiple arguments are aggregated like Promise.all array elements - while ( i-- ) { - adoptValue( resolveValues[ i ], updateFunc( i ), master.reject ); - } - - return master.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 - rkeyEvent = /^key/, - rmouseEvent = /^(?:mouse|pointer|contextmenu|drag|drop)|click/, - 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(); - return 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: function( event ) { - var button = event.button; - - // Add which for key events - if ( event.which == null && rkeyEvent.test( event.type ) ) { - return event.charCode != null ? event.charCode : event.keyCode; - } - - // Add which for click: 1 === left; 2 === middle; 3 === right - if ( !event.which && button !== undefined && rmouseEvent.test( event.type ) ) { - if ( button & 1 ) { - return 1; - } - - if ( button & 2 ) { - return 3; - } - - if ( button & 4 ) { - return 2; - } - - return 0; - } - - return event.which; - } -}, 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; - }, - - 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! - 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"; - tr.style.height = "1px"; - trChild.style.height = "9px"; - - documentElement - .appendChild( table ) - .appendChild( tr ) - .appendChild( trChild ); - - trStyle = window.getComputedStyle( tr ); - reliableTrDimensionsVal = parseInt( trStyle.height ) > 3; - - 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; - 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 ) { - xml = undefined; - } - - if ( !xml || xml.getElementsByTagName( "parsererror" ).length ) { - jQuery.error( "Invalid XML: " + 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 - if ( !isSuccess && jQuery.inArray( "script", s.dataTypes ) > -1 ) { - 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( " - - - - - - - - - - - - - - -
-
-
- - -
- - -

Index

- -
- D - | E - | F - | G - | H - | I - | J - | L - | M - | N - | P - | Q - | R - | S - | U - | W - -
-

D

- - -
- -

E

- - -
- -

F

- - - -
- -

G

- - - -
- -

H

- - -
- -

I

- - - -
- -

J

- - -
- -

L

- - - -
- -

M

- - -
- -

N

- - -
- -

P

- - - -
- -

Q

- - - -
- -

R

- - -
- -

S

- - - -
    -
  • - stixdcpy.net - -
  • -
  • - stixdcpy.quicklook - -
  • -
  • - stixdcpy.sci_l1_corrections - -
  • -
  • - stixdcpy.time - -
  • -
- -

U

- - - -
- -

W

- - -
- - - -
- -
-
- -
-
- - - - - - - \ No newline at end of file diff --git a/docs/build/html/index.html b/docs/build/html/index.html deleted file mode 100755 index 1c06a3e..0000000 --- a/docs/build/html/index.html +++ /dev/null @@ -1,124 +0,0 @@ - - - - - - - - - Welcome to stixdcpy’s documentation! — stixdcpy 1.0 documentation - - - - - - - - - - - - - - - - - - -
-
-
- - -
- -
-

Welcome to stixdcpy’s documentation!

-
-

Contents:

- -
-
-
-

Indices and tables

- -
- - -
- -
-
- -
-
- - - - - - - \ No newline at end of file diff --git a/docs/build/html/modules.html b/docs/build/html/modules.html deleted file mode 100755 index c83477d..0000000 --- a/docs/build/html/modules.html +++ /dev/null @@ -1,130 +0,0 @@ - - - - - - - - - stixdcpy — stixdcpy 1.0 documentation - - - - - - - - - - - - - - - - - - - -
- - -
-
- - - - - - - \ No newline at end of file diff --git a/docs/build/html/objects.inv b/docs/build/html/objects.inv deleted file mode 100755 index f85bbcb..0000000 Binary files a/docs/build/html/objects.inv and /dev/null differ diff --git a/docs/build/html/py-modindex.html b/docs/build/html/py-modindex.html deleted file mode 100755 index 8e71854..0000000 --- a/docs/build/html/py-modindex.html +++ /dev/null @@ -1,154 +0,0 @@ - - - - - - - - Python Module Index — stixdcpy 1.0 documentation - - - - - - - - - - - - - - - - - - - - -
-
-
- - -
- - -

Python Module Index

- -
- s -
- - - - - - - - - - - - - - - - - - - - - - - - - - - - -
 
- s
- stixdcpy -
    - stixdcpy.energylut -
    - stixdcpy.housekeeping -
    - stixdcpy.io -
    - stixdcpy.net -
    - stixdcpy.quicklook -
    - stixdcpy.sci_l1_corrections -
    - stixdcpy.time -
- - -
- -
-
- -
-
- - - - - - - \ No newline at end of file diff --git a/docs/build/html/search.html b/docs/build/html/search.html deleted file mode 100755 index 164311d..0000000 --- a/docs/build/html/search.html +++ /dev/null @@ -1,122 +0,0 @@ - - - - - - - - Search — stixdcpy 1.0 documentation - - - - - - - - - - - - - - - - - - - - - - - -
-
-
- - -
- -

Search

- -
- -

- Please activate JavaScript to enable the search - functionality. -

-
- - -

- Searching for multiple words only shows matches that contain - all words. -

- - -
- - - -
- - - -
- -
- - -
- -
-
- -
-
- - - - - - - \ No newline at end of file diff --git a/docs/build/html/searchindex.js b/docs/build/html/searchindex.js deleted file mode 100755 index 58cc91d..0000000 --- a/docs/build/html/searchindex.js +++ /dev/null @@ -1 +0,0 @@ -Search.setIndex({docnames:["index","modules","stixdcpy"],envversion:{"sphinx.domains.c":2,"sphinx.domains.changeset":1,"sphinx.domains.citation":1,"sphinx.domains.cpp":4,"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:56},filenames:["index.rst","modules.rst","stixdcpy.rst"],objects:{"":{stixdcpy:[2,0,0,"-"]},"stixdcpy.energylut":{EnergyLUT:[2,1,1,""]},"stixdcpy.energylut.EnergyLUT":{from_file:[2,2,1,""],get_calibration_data:[2,2,1,""],get_data:[2,2,1,""],get_onboard_elut:[2,2,1,""],get_pixel_true_ebins:[2,2,1,""],get_true_energy_bin_edges:[2,2,1,""],info:[2,2,1,""],request:[2,2,1,""]},"stixdcpy.housekeeping":{Housekeeping:[2,1,1,""]},"stixdcpy.housekeeping.Housekeeping":{fetch:[2,2,1,""],from_fits:[2,2,1,""],get_data:[2,2,1,""],peek:[2,2,1,""]},"stixdcpy.io":{IO:[2,1,1,""]},"stixdcpy.io.IO":{load:[2,2,1,""],save:[2,2,1,""]},"stixdcpy.net":{FitsProduct:[2,1,1,""],FitsProductQueryResult:[2,1,1,""],JSONRequest:[2,1,1,""]},"stixdcpy.net.FitsProduct":{fetch:[2,2,1,""],fetch_bulk_science_by_request_id:[2,2,1,""],fetch_continuous_data:[2,2,1,""],get_fits:[2,2,1,""],query:[2,2,1,""],wget:[2,2,1,""]},"stixdcpy.net.FitsProductQueryResult":{fetch:[2,2,1,""],get_fits_ids:[2,2,1,""]},"stixdcpy.net.JSONRequest":{fetch_empheris:[2,2,1,""],fetch_light_curves:[2,2,1,""],fetch_onboard_and_true_eluts:[2,2,1,""],fetch_science_data:[2,2,1,""],post:[2,2,1,""]},"stixdcpy.quicklook":{LightCurves:[2,1,1,""],QuickLook:[2,1,1,""]},"stixdcpy.quicklook.LightCurves":{fetch:[2,2,1,""],get_data:[2,2,1,""],peek:[2,2,1,""]},"stixdcpy.sci_l1_corrections":{live_time_correction:[2,3,1,""]},"stixdcpy.time":{datetime2unix:[2,3,1,""],format_datetime:[2,3,1,""],get_now:[2,3,1,""],now:[2,3,1,""],unix2datetime:[2,3,1,""],unix2utc:[2,3,1,""],utc2datetime:[2,3,1,""],utc2unix:[2,3,1,""]},stixdcpy:{energylut:[2,0,0,"-"],housekeeping:[2,0,0,"-"],io:[2,0,0,"-"],net:[2,0,0,"-"],quicklook:[2,0,0,"-"],sci_l1_corrections:[2,0,0,"-"],time:[2,0,0,"-"]}},objnames:{"0":["py","module","Python module"],"1":["py","class","Python class"],"2":["py","method","Python method"],"3":["py","function","Python function"]},objtypes:{"0":"py:module","1":"py:class","2":"py:method","3":"py:function"},terms:{"1":2,"2021":2,"class":2,"default":2,"do":2,"int":2,"return":2,"static":2,"super":[],"true":2,"var":2,A:2,If:2,It:2,The:2,__init__:[],_id:2,abov:2,alreadi:[],ancillarydata:1,api:2,asp:2,aspect:2,astropi:2,author:2,ax:2,bar:2,base:2,begin_utc:2,bkg:2,bool:2,bsd:[],cal:2,calibr:2,can:2,center:2,ch:2,classmethod:2,condit:2,content:1,correct:2,curv:2,data:2,data_typ:2,date:2,datetim:2,datetime2unix:2,dd:2,def:[],desc:2,descript:2,displai:2,doe:[],download:2,download_if_not_exist:[],dt:2,dtype:2,end_unix:[],end_utc:2,energi:2,energylut:1,entry_id:[],ephemeri:[],exist:[],f:[],fail:2,fals:2,fetch:2,fetch_bulk_science_by_request_id:2,fetch_continuous_data:2,fetch_empheri:2,fetch_light_curv:2,fetch_onboard_and_true_elut:2,fetch_science_data:2,ffl:2,fhnw:2,file:2,filenam:2,fit:2,fits_id:2,fits_typ:2,fitsproduct:2,fitsproductqueryresult:2,fitsrequest:[],flag:2,form:2,format:2,format_datetim:2,found:2,from:2,from_fil:2,from_fit:2,get:[],get_calibration_data:2,get_data:2,get_fit:2,get_fits_id:2,get_now:2,get_onboard_elut:2,get_pixel_true_ebin:2,get_true_energy_bin_edg:2,hkmax:2,hkmin:2,host:[],housekeep:1,hualin:2,id:[],index:0,info:2,input:[],io:1,json:2,jsonrequest:2,l0:2,l1:2,l1data:2,l2:2,l3:2,lc:2,legend_loc:2,light:2,lightcurv:2,link:2,list:[],live_time_correct:2,load:2,look:2,ltc:2,mm:2,mmthh:2,modul:[0,1],net:1,none:2,now:2,object:2,obs_begin:[],obs_end:[],option:2,packag:[0,1],packet:2,page:0,param:2,paramet:2,peek:2,pixel:2,plot:2,post:2,preprocess:[],product:2,product_typ:2,progress:2,progress_bar:2,provid:2,pub023:2,qlspec:2,queri:2,query_result:2,quick:2,quicklook:1,rais:[],receiv:2,request:2,request_id:2,resp:2,result:2,retriev:2,right:2,same:2,satistifi:2,save:2,sci_l1_correct:1,sciencedata:1,scil1:[],script:2,search:0,self:[],sep:2,server:2,shown:2,some:2,spec:2,ss:2,st:[],start:2,start_unix:[],start_utc:2,step:2,stix:2,stop:2,stop_utc:2,str:2,submodul:1,success:2,temporari:2,thi:2,time:1,timestamp:2,tool:2,ts:2,type:2,typeerror:[],unix2datetim:2,unix2utc:2,unix:2,unix_timestamp:2,upper:2,url:2,utc2datetim:2,utc2unix:2,utc:2,valu:2,view:[],wa:[],wget:2,which:2,xiao:2,yyyddmmhhmmss:2,yyyi:2},titles:["Welcome to stixdcpy\u2019s documentation!","stixdcpy","stixdcpy package"],titleterms:{ancillarydata:2,content:[0,2],document:0,energylut:2,housekeep:2,indic:0,io:2,modul:2,net:2,packag:2,quicklook:2,s:0,sci_l1_correct:2,sciencedata:2,stixdcpi:[0,1,2],submodul:2,tabl:0,time:2,welcom:0}}) \ No newline at end of file diff --git a/docs/build/html/stixdcpy.html b/docs/build/html/stixdcpy.html deleted file mode 100755 index f26dd4c..0000000 --- a/docs/build/html/stixdcpy.html +++ /dev/null @@ -1,441 +0,0 @@ - - - - - - - - - stixdcpy package — stixdcpy 1.0 documentation - - - - - - - - - - - - - - - - - - -
-
-
- - -
- -
-

stixdcpy package

-
-

Submodules

-
-
-

stixdcpy.ancillarydata module

-
-
-

stixdcpy.energylut module

-

This script provides APIs to retrieve energy calibration data from STIX data center ,and some tools to display the data -Author: Hualin Xiao (hualin.xiao@fhnw.ch) -Date: Sep. 1, 2021

-
-
-class stixdcpy.energylut.EnergyLUT
-

Bases: stixdcpy.io.IO

-
-
-classmethod from_file(filename)
-
- -
-
-get_calibration_data()
-
- -
-
-get_data()
-
- -
-
-get_onboard_elut()
-
- -
-
-get_pixel_true_ebins(pixel)
-
- -
-
-get_true_energy_bin_edges()
-
- -
-
-info()
-
- -
-
-classmethod request(utc)
-
- -
- -
-
-

stixdcpy.housekeeping module

-

This module provides APIs to retrieve Housekeeping data from STIX data center ,and some tools to display the data -Author: Hualin Xiao (hualin.xiao@fhnw.ch) -Date: Sep. 1, 2021

-
-
-class stixdcpy.housekeeping.Housekeeping(filename)
-

Bases: stixdcpy.io.IO

-
-
-classmethod fetch(start_utc: str, end_utc: str)
-
- -
-
-classmethod from_fits(filename)
-
- -
-
-get_data()
-
- -
-
-peek(ax=None, legend_loc='upper right')
-
- -
- -
-
-

stixdcpy.io module

-
-
-class stixdcpy.io.IO
-

Bases: object

-

Base object

-
-
-load(filename)
-
- -
-
-save(data, filename)
-
- -
- -
-
-

stixdcpy.net module

-

This module provides APIs to retrieve data from STIX data center -Author: Hualin Xiao (hualin.xiao@fhnw.ch) -Date: Sep. 1, 2021

-
-
-class stixdcpy.net.FitsProduct
-

Bases: object

-

Request FITS format data from STIX data center

-
-
-static fetch(query_results)
-
- -
-
-static fetch_bulk_science_by_request_id(request_id)
-
- -
-
-static fetch_continuous_data(start_utc, end_utc, data_type)
-
- -
-
-static get_fits(fits_id, progress_bar=True)
-

Query data from pub023 and download FITS file from the server. -A fits file will be received for the packets which satistify the query condition. -If no data is found on pub023, a json object will be received

-
-
Parameters
-
    -
  • start_utc (str) – start UTC in formats yyyy-dd-mmTHH:MM:SS, yyyddmmHHMMSS, or datetime

  • -
  • stop_utc ([type]) – stop UTC formats the same as above

  • -
  • fits_type (str, optional) – data product type It can be ‘l0’, ‘l1’, ‘l2’, ‘l3’, ‘spec’, ‘qlspec’, ‘asp’, ‘aspect’, ‘lc’, ‘bkg’,

  • -
-
-
-

‘var’, ‘ffl’, ‘cal’, ‘hkmin’ or ‘hkmax’. Defaults to ‘lc’.

-
-
Returns
-

astropy fits object if the request is successful; None if it is failed or no result returns

-
-
-
- -
-
-static query(start_utc, stop_utc, product_type='lc')
-
- -
-
-static wget(url: str, desc: str, progress_bar=True)
-
-
Download a file from the link and save the file to a temporary file.

Downloading progress will be shown in a progress bar

-
-
-
-
Parameters
-
    -
  • url (str) – URL

  • -
  • desc (str) – description to be shown on the progress bar

  • -
-
-
Returns
-

temporary filename

-
-
-
- -
- -
-
-class stixdcpy.net.FitsProductQueryResult(resp)
-

Bases: object

-
-
-fetch()
-
- -
-
-get_fits_ids()
-
- -
- -
-
-class stixdcpy.net.JSONRequest
-

Bases: object

-

Request json format data from STIX data center

-
-
-static fetch_empheris(start_utc: str, end_utc: str, steps=1)
-
- -
-
-static fetch_light_curves(begin_utc: str, end_utc: str, ltc: bool)
-
- -
-
-fetch_onboard_and_true_eluts()
-
- -
-
-static fetch_science_data(_id: int)
-
- -
-
-static post(url, form)
-
- -
- -
-
-

stixdcpy.quicklook module

-

This module provides APIs to retrieve Quick-look data from STIX data center ,and some tools to display the data -Author: Hualin Xiao (hualin.xiao@fhnw.ch) -Date: Sep. 1, 2021

-
-
-class stixdcpy.quicklook.LightCurves(data)
-

Bases: stixdcpy.quicklook.QuickLook

-
-
-classmethod fetch(start_utc: str, end_utc: str, ltc=False)
-
- -
-
-get_data()
-
- -
-
-peek(ax=None, legend_loc='upper right')
-

Plot light curves -:param ltc: light time correction flag. The default value is False. Do light time correction if ltc=True

-
- -
- -
-
-class stixdcpy.quicklook.QuickLook
-

Bases: stixdcpy.io.IO

-
- -
-
-

stixdcpy.sci_l1_corrections module

-

This module provides APIs to retrieve data from STIX data center -Author: Hualin Xiao (hualin.xiao@fhnw.ch) -Date: Sep. 1, 2021

-
-
-stixdcpy.sci_l1_corrections.live_time_correction(l1data)
-
- -
-
-

stixdcpy.sciencedata module

-
-
-

stixdcpy.time module

-
-
-stixdcpy.time.datetime2unix(timestamp)
-
- -
-
-stixdcpy.time.format_datetime(dt)
-
- -
-
-stixdcpy.time.get_now(dtype='unix')
-
- -
-
-stixdcpy.time.now()
-
- -
-
-stixdcpy.time.unix2datetime(unix_timestamp)
-
- -
-
-stixdcpy.time.unix2utc(ts)
-
- -
-
-stixdcpy.time.utc2datetime(utc)
-
- -
-
-stixdcpy.time.utc2unix(utc)
-
- -
-
-

Module contents

-
-
- - -
- -
-
- -
-
- - - - - - - \ No newline at end of file diff --git a/docs/make.bat b/docs/make.bat deleted file mode 100755 index 6247f7e..0000000 --- a/docs/make.bat +++ /dev/null @@ -1,35 +0,0 @@ -@ECHO OFF - -pushd %~dp0 - -REM Command file for Sphinx documentation - -if "%SPHINXBUILD%" == "" ( - set SPHINXBUILD=sphinx-build -) -set SOURCEDIR=source -set BUILDDIR=build - -if "%1" == "" goto help - -%SPHINXBUILD% >NUL 2>NUL -if errorlevel 9009 ( - echo. - echo.The 'sphinx-build' command was not found. Make sure you have Sphinx - echo.installed, then set the SPHINXBUILD environment variable to point - echo.to the full path of the 'sphinx-build' executable. Alternatively you - echo.may add the Sphinx directory to PATH. - echo. - echo.If you don't have Sphinx installed, grab it from - echo.http://sphinx-doc.org/ - exit /b 1 -) - -%SPHINXBUILD% -M %1 %SOURCEDIR% %BUILDDIR% %SPHINXOPTS% %O% -goto end - -:help -%SPHINXBUILD% -M help %SOURCEDIR% %BUILDDIR% %SPHINXOPTS% %O% - -:end -popd diff --git a/docs/source/conf.py b/docs/source/conf.py deleted file mode 100755 index ad620b2..0000000 --- a/docs/source/conf.py +++ /dev/null @@ -1,56 +0,0 @@ -# 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 os -import sys -sys.path.insert(0, os.path.abspath('../../stixdcpy')) -#sys.path.insert(0, os.path.abspath('../stixdcpy')) - -# -- Project information ----------------------------------------------------- - -project = 'stixdcpy' -copyright = '2021, Hualin Xiao' -author = 'Hualin Xiao' - -# The full version, including alpha/beta/rc tags -release = '1.0' - - -# -- 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 = [ -#] -extensions = ['sphinx.ext.autodoc', 'sphinx.ext.napoleon'] - -# 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 = [] - - -# -- Options for HTML output ------------------------------------------------- - -# The theme to use for HTML and HTML Help pages. See the documentation for -# a list of builtin themes. -# -html_theme = 'alabaster' - -# 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'] diff --git a/docs/source/index.rst b/docs/source/index.rst deleted file mode 100755 index f1c3472..0000000 --- a/docs/source/index.rst +++ /dev/null @@ -1,24 +0,0 @@ -.. stixdcpy documentation master file, created by - sphinx-quickstart on Tue Sep 7 13:51:38 2021. - You can adapt this file completely to your liking, but it should at least - contain the root `toctree` directive. - -Welcome to stixdcpy's documentation! -==================================== - -.. toctree:: - :maxdepth: 2 - :caption: Contents: - - modules - - - - - -Indices and tables -================== - -* :ref:`genindex` -* :ref:`modindex` -* :ref:`search` diff --git a/docs/source/modules.rst b/docs/source/modules.rst deleted file mode 100755 index 9d3c49b..0000000 --- a/docs/source/modules.rst +++ /dev/null @@ -1,7 +0,0 @@ -stixdcpy -======== - -.. toctree:: - :maxdepth: 4 - - stixdcpy diff --git a/docs/source/stixdcpy.rst b/docs/source/stixdcpy.rst deleted file mode 100755 index f6d07bb..0000000 --- a/docs/source/stixdcpy.rst +++ /dev/null @@ -1,85 +0,0 @@ -stixdcpy package -================ - -Submodules ----------- - -stixdcpy.ancillarydata module ------------------------------ - -.. automodule:: stixdcpy.ancillarydata - :members: - :undoc-members: - :show-inheritance: - -stixdcpy.energylut module -------------------------- - -.. automodule:: stixdcpy.energylut - :members: - :undoc-members: - :show-inheritance: - -stixdcpy.housekeeping module ----------------------------- - -.. automodule:: stixdcpy.housekeeping - :members: - :undoc-members: - :show-inheritance: - -stixdcpy.io module ------------------- - -.. automodule:: stixdcpy.io - :members: - :undoc-members: - :show-inheritance: - -stixdcpy.net module -------------------- - -.. automodule:: stixdcpy.net - :members: - :undoc-members: - :show-inheritance: - -stixdcpy.quicklook module -------------------------- - -.. automodule:: stixdcpy.quicklook - :members: - :undoc-members: - :show-inheritance: - -stixdcpy.sci\_l1\_corrections module ------------------------------------- - -.. automodule:: stixdcpy.sci_l1_corrections - :members: - :undoc-members: - :show-inheritance: - -stixdcpy.sciencedata module ---------------------------- - -.. automodule:: stixdcpy.sciencedata - :members: - :undoc-members: - :show-inheritance: - -stixdcpy.time module --------------------- - -.. automodule:: stixdcpy.time - :members: - :undoc-members: - :show-inheritance: - -Module contents ---------------- - -.. automodule:: stixdcpy - :members: - :undoc-members: - :show-inheritance: diff --git a/docs/stixdcpy/ancillary.html b/docs/stixdcpy/ancillary.html new file mode 100644 index 0000000..5cb5085 --- /dev/null +++ b/docs/stixdcpy/ancillary.html @@ -0,0 +1,693 @@ + + + + + + +stixdcpy.ancillary API documentation + + + + + + + + + + + +
+
+
+

Module stixdcpy.ancillary

+
+
+

This module provides APIs to retrieve Quick-look data from STIX data center +,and some tools to display the data +Author: Hualin Xiao (hualin.xiao@fhnw.ch) +Date: Sep. 1, 2021

+
+ +Expand source code + +
#!/usr/bin/python
+"""
+    This module provides APIs to retrieve Quick-look data from STIX data center  ,and some tools to display the data
+    Author: Hualin Xiao (hualin.xiao@fhnw.ch)
+    Date: Sep. 1, 2021
+
+"""
+import numpy as np
+import pandas as pd
+from matplotlib import patches
+from matplotlib import pyplot as plt
+
+from stixdcpy import io as sio
+from stixdcpy.logger import logger
+from stixdcpy.net import JSONRequest as jreq
+
+
+class Ephemeris(sio.IO):
+    def __init__(self, start_utc, end_utc, data):
+        self.start_utc = start_utc
+        self.end_utc = end_utc
+        self.data = data
+
+    @classmethod
+    def from_sdc(cls, start_utc: str, end_utc=None, steps=1):
+        """
+        Fetch ephemeris from STIX data center
+        Args:
+            start_utc: str
+            Start UTC
+            end_utc: str
+            End UTC
+            steps:
+            Number of data steps
+        Returns:
+            ephemeris: object
+
+        """
+        if end_utc is None:
+            end_utc = start_utc
+        orbit= jreq.request_ephemeris(start_utc, end_utc, steps)
+        att=jreq.request_attitude(start_utc, end_utc, steps)
+        data={'orbit':orbit,'attitude':att}
+        return cls(start_utc, end_utc, data)
+
+    @classmethod
+    def from_npy(cls, filename):
+        """
+        Load ephemeris data from a npz file
+        Args:
+            filename: str
+            npz filename
+        """
+        with np.load(filename, allow_picke=True) as data:
+            item = data.item()
+            _data = item['data']
+            start, end = item['start'], item['end']
+            cls(start, end, _data)
+
+    def save_npy(cls, filename):
+        """
+        Save ephemeris data as npy format
+        Args:
+            filename: str
+            npy filename
+        """
+        _data = {
+            'data': self.data,
+            'start': self.start_utc,
+            'end': self.end_utc
+        }
+        np.save(filename, _data)
+
+    def to_pandas(self):
+        """convert ephemeris data to pandas data frame
+
+        Returns:
+            df: pandas data frame
+
+
+        """
+        return pd.DataFrame(self.data)
+
+    def __getattr__(self, name):
+        if name == 'data':
+            return self.data
+
+    def get_data(self):
+        return self.data
+
+    def peek(self, ax=None):
+        if not self.data:
+            logger.error(f'Data not loaded. ')
+            return None
+        if not ax:
+            _, ax = plt.subplots()
+        data = self.data['orbit']
+        if not data or 'error' in data:
+            logger.error(f'Data not available. ')
+            return None
+        sun = patches.Circle((0.0, 0.0), 0.25, alpha=0.8, fc='yellow')
+        plt.text(0, 0, 'Sun')
+        ax.add_patch(sun)
+        earth = patches.Circle((-1, 0), 0.12, alpha=0.8, fc='green')
+        ax.add_patch(earth)
+        ax.text(-1, 0, 'Earth')
+        ax.plot(data['x'], data['y'])
+        ax.plot(data['x'][-1], data['y'][-1], 'x')
+        ax.text(data['x'][-1], data['y'][-1], 'SOLO')
+        ax.set_xlabel('X (au)')
+        ax.set_ylabel('Y (au)')
+        ax.set_xlim(-2, 2)
+        ax.set_ylim(-2, 2)
+        ax.set_aspect('equal')
+        ax.grid()
+        plt.title(f'SOLO Location at {self.start_utc}')
+        return ax
+class STIXPointing(Ephemeris):
+    def __init__(self, utc,  data):
+        self.utc= utc
+        self.data = data
+    @classmethod
+    def from_sdc(cls, utc):
+        """
+        Fetch ephemeris from STIX data center
+        Args:
+            start_utc: str
+            Start UTC
+            end_utc: str
+            End UTC
+            steps:
+            Number of data steps
+        Returns:
+            ephemeris: object
+
+        """
+        data= jreq.request_pointing(utc)
+        return cls(utc, data)
+    def peek(self, ax=None):
+        if not self.data:
+            logger.error(f'Data not loaded. ')
+            return None
+        if not ax:
+            _, ax = plt.subplots()
+        data = self.data
+        if not data or 'error' in data:
+            logger.error(f'Data not available. ')
+            return None
+        ax.plot(data['fov']['x'], data['fov']['y'],'--', label='STIX FOV',color='black')
+        ax.plot([data['sun_center'][0]], [data['sun_center'][1]], marker='+', label='Sun Center')
+        ax.plot(data['limb']['x'], data['limb']['y'],label='Solar limb',color='red')
+        center=[round(x,1) for x in data["sun_center"]]
+        ax.set_title(f'Solar center: {center}  arcsec \n {data["time"]} UT ')
+        nsew_coords=np.array(data['nsew'])
+        ax.plot(nsew_coords[0:2:,0], nsew_coords[0:2,1])
+        ax.plot(nsew_coords[2::,0], nsew_coords[2:,1])
+        ax.text(nsew_coords[0,0], nsew_coords[0,1],'N')
+        ax.text(nsew_coords[2,0], nsew_coords[2,1],'E')
+        ax.set_aspect('equal')
+        ax.legend(loc='upper right')
+        ax.set_xlim(-5400, 5400)
+        ax.grid(True)
+        ax.set_xlabel('STIX X (arcsec)')
+        ax.set_ylabel('STIX Y (arcsec)')
+        return ax
+        
+    
+
+
+
+
+
+
+
+
+
+

Classes

+
+
+class Ephemeris +(start_utc, end_utc, data) +
+
+

Base object

+
+ +Expand source code + +
class Ephemeris(sio.IO):
+    def __init__(self, start_utc, end_utc, data):
+        self.start_utc = start_utc
+        self.end_utc = end_utc
+        self.data = data
+
+    @classmethod
+    def from_sdc(cls, start_utc: str, end_utc=None, steps=1):
+        """
+        Fetch ephemeris from STIX data center
+        Args:
+            start_utc: str
+            Start UTC
+            end_utc: str
+            End UTC
+            steps:
+            Number of data steps
+        Returns:
+            ephemeris: object
+
+        """
+        if end_utc is None:
+            end_utc = start_utc
+        orbit= jreq.request_ephemeris(start_utc, end_utc, steps)
+        att=jreq.request_attitude(start_utc, end_utc, steps)
+        data={'orbit':orbit,'attitude':att}
+        return cls(start_utc, end_utc, data)
+
+    @classmethod
+    def from_npy(cls, filename):
+        """
+        Load ephemeris data from a npz file
+        Args:
+            filename: str
+            npz filename
+        """
+        with np.load(filename, allow_picke=True) as data:
+            item = data.item()
+            _data = item['data']
+            start, end = item['start'], item['end']
+            cls(start, end, _data)
+
+    def save_npy(cls, filename):
+        """
+        Save ephemeris data as npy format
+        Args:
+            filename: str
+            npy filename
+        """
+        _data = {
+            'data': self.data,
+            'start': self.start_utc,
+            'end': self.end_utc
+        }
+        np.save(filename, _data)
+
+    def to_pandas(self):
+        """convert ephemeris data to pandas data frame
+
+        Returns:
+            df: pandas data frame
+
+
+        """
+        return pd.DataFrame(self.data)
+
+    def __getattr__(self, name):
+        if name == 'data':
+            return self.data
+
+    def get_data(self):
+        return self.data
+
+    def peek(self, ax=None):
+        if not self.data:
+            logger.error(f'Data not loaded. ')
+            return None
+        if not ax:
+            _, ax = plt.subplots()
+        data = self.data['orbit']
+        if not data or 'error' in data:
+            logger.error(f'Data not available. ')
+            return None
+        sun = patches.Circle((0.0, 0.0), 0.25, alpha=0.8, fc='yellow')
+        plt.text(0, 0, 'Sun')
+        ax.add_patch(sun)
+        earth = patches.Circle((-1, 0), 0.12, alpha=0.8, fc='green')
+        ax.add_patch(earth)
+        ax.text(-1, 0, 'Earth')
+        ax.plot(data['x'], data['y'])
+        ax.plot(data['x'][-1], data['y'][-1], 'x')
+        ax.text(data['x'][-1], data['y'][-1], 'SOLO')
+        ax.set_xlabel('X (au)')
+        ax.set_ylabel('Y (au)')
+        ax.set_xlim(-2, 2)
+        ax.set_ylim(-2, 2)
+        ax.set_aspect('equal')
+        ax.grid()
+        plt.title(f'SOLO Location at {self.start_utc}')
+        return ax
+
+

Ancestors

+ +

Subclasses

+ +

Static methods

+
+
+def from_npy(filename) +
+
+

Load ephemeris data from a npz file

+

Args

+
+
filename
+
str
+
+

npz filename

+
+ +Expand source code + +
@classmethod
+def from_npy(cls, filename):
+    """
+    Load ephemeris data from a npz file
+    Args:
+        filename: str
+        npz filename
+    """
+    with np.load(filename, allow_picke=True) as data:
+        item = data.item()
+        _data = item['data']
+        start, end = item['start'], item['end']
+        cls(start, end, _data)
+
+
+
+def from_sdc(start_utc: str, end_utc=None, steps=1) +
+
+

Fetch ephemeris from STIX data center

+

Args

+
+
start_utc
+
str
+
Start UTC
+
end_utc
+
str
+
+

End UTC +steps: +Number of data steps

+

Returns

+
+
ephemeris
+
object
+
+
+ +Expand source code + +
@classmethod
+def from_sdc(cls, start_utc: str, end_utc=None, steps=1):
+    """
+    Fetch ephemeris from STIX data center
+    Args:
+        start_utc: str
+        Start UTC
+        end_utc: str
+        End UTC
+        steps:
+        Number of data steps
+    Returns:
+        ephemeris: object
+
+    """
+    if end_utc is None:
+        end_utc = start_utc
+    orbit= jreq.request_ephemeris(start_utc, end_utc, steps)
+    att=jreq.request_attitude(start_utc, end_utc, steps)
+    data={'orbit':orbit,'attitude':att}
+    return cls(start_utc, end_utc, data)
+
+
+
+

Methods

+
+
+def get_data(self) +
+
+
+
+ +Expand source code + +
def get_data(self):
+    return self.data
+
+
+
+def peek(self, ax=None) +
+
+
+
+ +Expand source code + +
def peek(self, ax=None):
+    if not self.data:
+        logger.error(f'Data not loaded. ')
+        return None
+    if not ax:
+        _, ax = plt.subplots()
+    data = self.data['orbit']
+    if not data or 'error' in data:
+        logger.error(f'Data not available. ')
+        return None
+    sun = patches.Circle((0.0, 0.0), 0.25, alpha=0.8, fc='yellow')
+    plt.text(0, 0, 'Sun')
+    ax.add_patch(sun)
+    earth = patches.Circle((-1, 0), 0.12, alpha=0.8, fc='green')
+    ax.add_patch(earth)
+    ax.text(-1, 0, 'Earth')
+    ax.plot(data['x'], data['y'])
+    ax.plot(data['x'][-1], data['y'][-1], 'x')
+    ax.text(data['x'][-1], data['y'][-1], 'SOLO')
+    ax.set_xlabel('X (au)')
+    ax.set_ylabel('Y (au)')
+    ax.set_xlim(-2, 2)
+    ax.set_ylim(-2, 2)
+    ax.set_aspect('equal')
+    ax.grid()
+    plt.title(f'SOLO Location at {self.start_utc}')
+    return ax
+
+
+
+def save_npy(cls, filename) +
+
+

Save ephemeris data as npy format

+

Args

+
+
filename
+
str
+
+

npy filename

+
+ +Expand source code + +
def save_npy(cls, filename):
+    """
+    Save ephemeris data as npy format
+    Args:
+        filename: str
+        npy filename
+    """
+    _data = {
+        'data': self.data,
+        'start': self.start_utc,
+        'end': self.end_utc
+    }
+    np.save(filename, _data)
+
+
+
+def to_pandas(self) +
+
+

convert ephemeris data to pandas data frame

+

Returns

+
+
df
+
pandas data frame
+
+
+ +Expand source code + +
def to_pandas(self):
+    """convert ephemeris data to pandas data frame
+
+    Returns:
+        df: pandas data frame
+
+
+    """
+    return pd.DataFrame(self.data)
+
+
+
+

Inherited members

+ +
+
+class STIXPointing +(utc, data) +
+
+

Base object

+
+ +Expand source code + +
class STIXPointing(Ephemeris):
+    def __init__(self, utc,  data):
+        self.utc= utc
+        self.data = data
+    @classmethod
+    def from_sdc(cls, utc):
+        """
+        Fetch ephemeris from STIX data center
+        Args:
+            start_utc: str
+            Start UTC
+            end_utc: str
+            End UTC
+            steps:
+            Number of data steps
+        Returns:
+            ephemeris: object
+
+        """
+        data= jreq.request_pointing(utc)
+        return cls(utc, data)
+    def peek(self, ax=None):
+        if not self.data:
+            logger.error(f'Data not loaded. ')
+            return None
+        if not ax:
+            _, ax = plt.subplots()
+        data = self.data
+        if not data or 'error' in data:
+            logger.error(f'Data not available. ')
+            return None
+        ax.plot(data['fov']['x'], data['fov']['y'],'--', label='STIX FOV',color='black')
+        ax.plot([data['sun_center'][0]], [data['sun_center'][1]], marker='+', label='Sun Center')
+        ax.plot(data['limb']['x'], data['limb']['y'],label='Solar limb',color='red')
+        center=[round(x,1) for x in data["sun_center"]]
+        ax.set_title(f'Solar center: {center}  arcsec \n {data["time"]} UT ')
+        nsew_coords=np.array(data['nsew'])
+        ax.plot(nsew_coords[0:2:,0], nsew_coords[0:2,1])
+        ax.plot(nsew_coords[2::,0], nsew_coords[2:,1])
+        ax.text(nsew_coords[0,0], nsew_coords[0,1],'N')
+        ax.text(nsew_coords[2,0], nsew_coords[2,1],'E')
+        ax.set_aspect('equal')
+        ax.legend(loc='upper right')
+        ax.set_xlim(-5400, 5400)
+        ax.grid(True)
+        ax.set_xlabel('STIX X (arcsec)')
+        ax.set_ylabel('STIX Y (arcsec)')
+        return ax
+
+

Ancestors

+ +

Methods

+
+
+def peek(self, ax=None) +
+
+
+
+ +Expand source code + +
def peek(self, ax=None):
+    if not self.data:
+        logger.error(f'Data not loaded. ')
+        return None
+    if not ax:
+        _, ax = plt.subplots()
+    data = self.data
+    if not data or 'error' in data:
+        logger.error(f'Data not available. ')
+        return None
+    ax.plot(data['fov']['x'], data['fov']['y'],'--', label='STIX FOV',color='black')
+    ax.plot([data['sun_center'][0]], [data['sun_center'][1]], marker='+', label='Sun Center')
+    ax.plot(data['limb']['x'], data['limb']['y'],label='Solar limb',color='red')
+    center=[round(x,1) for x in data["sun_center"]]
+    ax.set_title(f'Solar center: {center}  arcsec \n {data["time"]} UT ')
+    nsew_coords=np.array(data['nsew'])
+    ax.plot(nsew_coords[0:2:,0], nsew_coords[0:2,1])
+    ax.plot(nsew_coords[2::,0], nsew_coords[2:,1])
+    ax.text(nsew_coords[0,0], nsew_coords[0,1],'N')
+    ax.text(nsew_coords[2,0], nsew_coords[2,1],'E')
+    ax.set_aspect('equal')
+    ax.legend(loc='upper right')
+    ax.set_xlim(-5400, 5400)
+    ax.grid(True)
+    ax.set_xlabel('STIX X (arcsec)')
+    ax.set_ylabel('STIX Y (arcsec)')
+    return ax
+
+
+
+

Inherited members

+ +
+
+
+
+ +
+ + + \ No newline at end of file diff --git a/docs/stixdcpy/cfl.html b/docs/stixdcpy/cfl.html new file mode 100644 index 0000000..33edcc3 --- /dev/null +++ b/docs/stixdcpy/cfl.html @@ -0,0 +1,53 @@ + + + + + + +stixdcpy.cfl API documentation + + + + + + + + + + + +
+
+
+

Module stixdcpy.cfl

+
+
+
+
+
+
+
+
+
+
+
+
+ +
+ + + \ No newline at end of file diff --git a/docs/stixdcpy/correction.html b/docs/stixdcpy/correction.html new file mode 100644 index 0000000..04583cd --- /dev/null +++ b/docs/stixdcpy/correction.html @@ -0,0 +1,645 @@ + + + + + + +stixdcpy.correction API documentation + + + + + + + + + + + +
+
+
+

Module stixdcpy.correction

+
+
+

This module provides algorithms to correct detector effects +Author: Hualin Xiao (hualin.xiao@fhnw.ch) +Date: Sep. 1, 2021

+
+ +Expand source code + +
#!/usr/bin/python
+"""
+    This module provides algorithms to correct detector effects
+    Author: Hualin Xiao (hualin.xiao@fhnw.ch)
+    Date: Sep. 1, 2021
+
+"""
+import numpy as np
+from matplotlib import pyplot as plt
+
+from stixdcpy import instrument as inst
+from stixdcpy import science
+from stixdcpy import time as sdt
+from stixdcpy.logger import logger
+
+DETECTOR_GROUPS = [[1, 2], [6, 7], [5, 11], [12, 13], [14, 15], [10, 16],
+                   [8, 9], [3, 4], [31, 32], [26, 27], [22, 28], [20, 21],
+                   [18, 19], [17, 23], [24, 25], [29, 30]]
+DET_SIBLINGS = {
+    0: 1,
+    1: 0,
+    5: 6,
+    6: 5,
+    4: 10,
+    10: 4,
+    11: 12,
+    12: 11,
+    13: 14,
+    14: 13,
+    9: 15,
+    15: 9,
+    7: 8,
+    8: 7,
+    2: 3,
+    3: 2,
+    30: 31,
+    31: 30,
+    25: 26,
+    26: 25,
+    21: 27,
+    27: 21,
+    19: 20,
+    20: 19,
+    17: 18,
+    18: 17,
+    16: 22,
+    22: 16,
+    23: 24,
+    24: 23,
+    28: 29,
+    29: 28
+}
+
+# detector sibling index
+
+
+class BackgroundSubtraction(object):
+    def __init__(self, l1sig: science.ScienceL1, l1bkg: science.ScienceL1):
+        """
+                   do background subtraction
+                Arguments
+                l1sig: a L1product instance containing the signal
+                l1bkg: a L1Product instance containing the background
+
+                """
+        self.l1sig = l1sig
+        self.l1bkg = l1bkg
+
+        dmask = self.l1bkg.energy_bin_mask - self.l1sig.energy_bin_mask
+        if np.any(dmask < 0):
+            logger.error(
+                'Background subtraction failed due to the background energy range does not cover the signal energy range  '
+            )
+            return
+
+        #mean_pixel_rate_clip = self.l1bkg.mean_pixel_rate_spectra * self.l1sig.inverse_energy_bin_mask
+
+        self.pixel_bkg_counts = np.array([
+            int_time * self.l1bkg.mean_pixel_rate_spectra
+            for int_time in self.l1sig.timedel
+        ])
+        # set counts beyond the signal energy range to 0
+        self.subtracted_counts = (self.l1sig.counts - self.pixel_bkg_counts
+                                  ) * self.l1sig.inverse_energy_bin_mask
+
+        # Dead time correction needs to be included in the future
+        self.subtracted_counts_err = np.sqrt(
+            self.l1sig.counts + np.array([int_time * self.l1bkg.mean_pixel_rate_spectra_err ** 2 for int_time in self.l1sig.timedel])) * \
+            self.l1sig.inverse_energy_bin_mask
+        self.bkg_subtracted_spectrogram = np.sum(self.subtracted_counts,
+                                                 axis=(1, 2))
+
+    def peek(self):
+        fig, axs = plt.subplots(2, 2)
+        self.l1sig.peek(axs[0, 0])
+        self.l1bkg.peek(axs[0, 1])
+        X, Y = np.meshgrid(self.l1sig.time,
+                           np.arange(self.l1sig.min_ebin, self.l1sig.max_ebin))
+        im = axs[1, 0].pcolormesh(
+            X, Y,
+            np.transpose(
+                self.bkg_subtracted_spectrogram[:, self.l1sig.min_ebin:self.
+                                                l1sig.max_ebin]))
+        axs[1, 0].set_yticks(self.l1sig.energies['channel']
+                             [self.l1sig.min_ebin:self.l1sig.max_ebin:2])
+        axs[1, 0].set_yticklabels(
+            self.l1sig.energy_bin_names[self.l1sig.min_ebin:self.l1sig.
+                                        max_ebin:2])
+        fig = plt.gcf()
+        cbar = fig.colorbar(im, ax=axs[1, 0])
+        cbar.set_label('Counts')
+        axs[1, 0].set_title('Bkg sub. counts')
+        axs[1, 0].set_ylabel('Energy range(keV')
+        axs[1, 0].set_xlabel(f"Seconds since {self.l1sig.T0}s ")
+        axs[1, 1].plot(np.sum(self.l1sig.spectrogram, axis=0),
+                       drawstyle='steps-mid',
+                       label='Before subtraction')
+        axs[1, 1].plot(np.sum(self.bkg_subtracted_spectrogram, axis=0),
+                       drawstyle="steps-mid",
+                       label='After subtraction')
+        axs[1, 1].plot(np.sum(self.pixel_bkg_counts, axis=(0, 1, 2)),
+                       drawstyle="steps-mid",
+                       label='background')
+        axs[1, 1].legend()
+
+    def get_background_subtracted_spectrum(self, start_utc=None, end_utc=None):
+        """
+        Get signal background subtracted spectrum
+
+        """
+        start_unix = sdt.utc2unix(start_utc)
+        end_unix = sdt.utc2unix(end_utc)
+        start_time = start_unix - self.l1sig.T0_unix
+        end_time = end_unix - self.l1sig.T0_unix
+        start_i_tbin = np.argmax(
+            self.l1sig.time - 0.5 * self.l1sig.timedel >= start_time) if (
+                0 <= start_time <= self.l1sig.duration) else 0
+
+        end_i_tbin = np.argmin(
+            self.l1sig.time + 0.5 * self.l1sig.timedel <= end_time) if (
+                start_time <= end_time <= self.l1sig.duration) else len(
+                    self.l1sig.time)
+        time_span = self.l1sig.time[end_i_tbin] - self.l1sig.time[
+            start_i_tbin] + 0.5 * self.l1sig.timedel[
+                start_i_tbin] + 0.5 * self.l1sig.timedel[end_i_tbin]
+
+        bkg_sub_spectra = np.sum(
+            self.subtracted_counts[start_i_tbin:end_i_tbin, :, :, :],
+            axis=(0, 1, 2)) / time_span,
+        bkg_sub_spectra_err = np.sqrt(
+            np.sum(self.subtracted_counts_err[start_i_tbin:end_i_tbin, :, :, :]
+                   ** 2,
+                   axis=(0, 1, 2))) / time_span
+        return bkg_sub_spectra, bkg_sub_spectra_err
+
+
+class LiveTimeCorrection(object):
+    pass
+    """
+    #counts is np.array   time_bins, detector, pixel, energy bins
+    trigger_rates=l1data['triggers'][1:,:]/l1data['timedel'][:-1,None]
+    # delta time is off by 1 time bin due a bug in the
+    out=np.copy(trigger_rates)
+    tau=11e-6
+    live_time=1 - tau*trig
+    photo_in=trig/(live_time)
+        """
+
+    @classmethod
+    def L1_live_time_correction(cls, triggers, counts_arr, time_bins):
+        """ Live time correction
+        Args
+            triggers: ndarray
+                triggers in the spectrogram
+            counts_arr:ndarray
+                counts in the spectrogram
+            time_bins: ndarray
+                time_bins in the spectrogram
+        Returns
+        live_time_ratio: ndarray
+            live time ratio of detectors
+        count_rate:
+            corrected count rate
+        photons_in:
+            rate of photons illuminating the detector group
+
+        """
+
+        fpga_tau=10.1e-6
+        asic_tau=2.63e-6
+        trig_tau = fpga_tau+asic_tau
+
+        time_bins = time_bins[:, None]
+        photons_in = triggers/(time_bins-trig_tau*triggers)
+        #photon rate calculated using triggers 
+
+        correction_factors= np.zeros((time_bins.size, 32))
+        time_bins = time_bins[:, :, None, None]
+
+        time_bins = time_bins[:, :, None, None]
+        count_rates = counts_arr/time_bins
+        # print(counts_arr.shape)
+        for det in range(32):
+            trig_idx=inst.detector_id_to_trigger_index[det]
+            nin=photons_in[:,trig_idx]
+            cor_factor=0.94
+            live_ratio[:,det]=np.exp(- cor_factor*nin*asic_tau*1e-6)/(1+ nin*trig_tau)
+
+        return correction_factors, corrected_rates , count_rates,photons_in
+
+
+
+class TransmissionCorrection(object):
+    pass
+
+
+
+
+
+
+
+
+
+

Classes

+
+
+class BackgroundSubtraction +(l1sig: ScienceL1, l1bkg: ScienceL1) +
+
+

do background subtraction +Arguments +l1sig: a L1product instance containing the signal +l1bkg: a L1Product instance containing the background

+
+ +Expand source code + +
class BackgroundSubtraction(object):
+    def __init__(self, l1sig: science.ScienceL1, l1bkg: science.ScienceL1):
+        """
+                   do background subtraction
+                Arguments
+                l1sig: a L1product instance containing the signal
+                l1bkg: a L1Product instance containing the background
+
+                """
+        self.l1sig = l1sig
+        self.l1bkg = l1bkg
+
+        dmask = self.l1bkg.energy_bin_mask - self.l1sig.energy_bin_mask
+        if np.any(dmask < 0):
+            logger.error(
+                'Background subtraction failed due to the background energy range does not cover the signal energy range  '
+            )
+            return
+
+        #mean_pixel_rate_clip = self.l1bkg.mean_pixel_rate_spectra * self.l1sig.inverse_energy_bin_mask
+
+        self.pixel_bkg_counts = np.array([
+            int_time * self.l1bkg.mean_pixel_rate_spectra
+            for int_time in self.l1sig.timedel
+        ])
+        # set counts beyond the signal energy range to 0
+        self.subtracted_counts = (self.l1sig.counts - self.pixel_bkg_counts
+                                  ) * self.l1sig.inverse_energy_bin_mask
+
+        # Dead time correction needs to be included in the future
+        self.subtracted_counts_err = np.sqrt(
+            self.l1sig.counts + np.array([int_time * self.l1bkg.mean_pixel_rate_spectra_err ** 2 for int_time in self.l1sig.timedel])) * \
+            self.l1sig.inverse_energy_bin_mask
+        self.bkg_subtracted_spectrogram = np.sum(self.subtracted_counts,
+                                                 axis=(1, 2))
+
+    def peek(self):
+        fig, axs = plt.subplots(2, 2)
+        self.l1sig.peek(axs[0, 0])
+        self.l1bkg.peek(axs[0, 1])
+        X, Y = np.meshgrid(self.l1sig.time,
+                           np.arange(self.l1sig.min_ebin, self.l1sig.max_ebin))
+        im = axs[1, 0].pcolormesh(
+            X, Y,
+            np.transpose(
+                self.bkg_subtracted_spectrogram[:, self.l1sig.min_ebin:self.
+                                                l1sig.max_ebin]))
+        axs[1, 0].set_yticks(self.l1sig.energies['channel']
+                             [self.l1sig.min_ebin:self.l1sig.max_ebin:2])
+        axs[1, 0].set_yticklabels(
+            self.l1sig.energy_bin_names[self.l1sig.min_ebin:self.l1sig.
+                                        max_ebin:2])
+        fig = plt.gcf()
+        cbar = fig.colorbar(im, ax=axs[1, 0])
+        cbar.set_label('Counts')
+        axs[1, 0].set_title('Bkg sub. counts')
+        axs[1, 0].set_ylabel('Energy range(keV')
+        axs[1, 0].set_xlabel(f"Seconds since {self.l1sig.T0}s ")
+        axs[1, 1].plot(np.sum(self.l1sig.spectrogram, axis=0),
+                       drawstyle='steps-mid',
+                       label='Before subtraction')
+        axs[1, 1].plot(np.sum(self.bkg_subtracted_spectrogram, axis=0),
+                       drawstyle="steps-mid",
+                       label='After subtraction')
+        axs[1, 1].plot(np.sum(self.pixel_bkg_counts, axis=(0, 1, 2)),
+                       drawstyle="steps-mid",
+                       label='background')
+        axs[1, 1].legend()
+
+    def get_background_subtracted_spectrum(self, start_utc=None, end_utc=None):
+        """
+        Get signal background subtracted spectrum
+
+        """
+        start_unix = sdt.utc2unix(start_utc)
+        end_unix = sdt.utc2unix(end_utc)
+        start_time = start_unix - self.l1sig.T0_unix
+        end_time = end_unix - self.l1sig.T0_unix
+        start_i_tbin = np.argmax(
+            self.l1sig.time - 0.5 * self.l1sig.timedel >= start_time) if (
+                0 <= start_time <= self.l1sig.duration) else 0
+
+        end_i_tbin = np.argmin(
+            self.l1sig.time + 0.5 * self.l1sig.timedel <= end_time) if (
+                start_time <= end_time <= self.l1sig.duration) else len(
+                    self.l1sig.time)
+        time_span = self.l1sig.time[end_i_tbin] - self.l1sig.time[
+            start_i_tbin] + 0.5 * self.l1sig.timedel[
+                start_i_tbin] + 0.5 * self.l1sig.timedel[end_i_tbin]
+
+        bkg_sub_spectra = np.sum(
+            self.subtracted_counts[start_i_tbin:end_i_tbin, :, :, :],
+            axis=(0, 1, 2)) / time_span,
+        bkg_sub_spectra_err = np.sqrt(
+            np.sum(self.subtracted_counts_err[start_i_tbin:end_i_tbin, :, :, :]
+                   ** 2,
+                   axis=(0, 1, 2))) / time_span
+        return bkg_sub_spectra, bkg_sub_spectra_err
+
+

Methods

+
+
+def get_background_subtracted_spectrum(self, start_utc=None, end_utc=None) +
+
+

Get signal background subtracted spectrum

+
+ +Expand source code + +
def get_background_subtracted_spectrum(self, start_utc=None, end_utc=None):
+    """
+    Get signal background subtracted spectrum
+
+    """
+    start_unix = sdt.utc2unix(start_utc)
+    end_unix = sdt.utc2unix(end_utc)
+    start_time = start_unix - self.l1sig.T0_unix
+    end_time = end_unix - self.l1sig.T0_unix
+    start_i_tbin = np.argmax(
+        self.l1sig.time - 0.5 * self.l1sig.timedel >= start_time) if (
+            0 <= start_time <= self.l1sig.duration) else 0
+
+    end_i_tbin = np.argmin(
+        self.l1sig.time + 0.5 * self.l1sig.timedel <= end_time) if (
+            start_time <= end_time <= self.l1sig.duration) else len(
+                self.l1sig.time)
+    time_span = self.l1sig.time[end_i_tbin] - self.l1sig.time[
+        start_i_tbin] + 0.5 * self.l1sig.timedel[
+            start_i_tbin] + 0.5 * self.l1sig.timedel[end_i_tbin]
+
+    bkg_sub_spectra = np.sum(
+        self.subtracted_counts[start_i_tbin:end_i_tbin, :, :, :],
+        axis=(0, 1, 2)) / time_span,
+    bkg_sub_spectra_err = np.sqrt(
+        np.sum(self.subtracted_counts_err[start_i_tbin:end_i_tbin, :, :, :]
+               ** 2,
+               axis=(0, 1, 2))) / time_span
+    return bkg_sub_spectra, bkg_sub_spectra_err
+
+
+
+def peek(self) +
+
+
+
+ +Expand source code + +
def peek(self):
+    fig, axs = plt.subplots(2, 2)
+    self.l1sig.peek(axs[0, 0])
+    self.l1bkg.peek(axs[0, 1])
+    X, Y = np.meshgrid(self.l1sig.time,
+                       np.arange(self.l1sig.min_ebin, self.l1sig.max_ebin))
+    im = axs[1, 0].pcolormesh(
+        X, Y,
+        np.transpose(
+            self.bkg_subtracted_spectrogram[:, self.l1sig.min_ebin:self.
+                                            l1sig.max_ebin]))
+    axs[1, 0].set_yticks(self.l1sig.energies['channel']
+                         [self.l1sig.min_ebin:self.l1sig.max_ebin:2])
+    axs[1, 0].set_yticklabels(
+        self.l1sig.energy_bin_names[self.l1sig.min_ebin:self.l1sig.
+                                    max_ebin:2])
+    fig = plt.gcf()
+    cbar = fig.colorbar(im, ax=axs[1, 0])
+    cbar.set_label('Counts')
+    axs[1, 0].set_title('Bkg sub. counts')
+    axs[1, 0].set_ylabel('Energy range(keV')
+    axs[1, 0].set_xlabel(f"Seconds since {self.l1sig.T0}s ")
+    axs[1, 1].plot(np.sum(self.l1sig.spectrogram, axis=0),
+                   drawstyle='steps-mid',
+                   label='Before subtraction')
+    axs[1, 1].plot(np.sum(self.bkg_subtracted_spectrogram, axis=0),
+                   drawstyle="steps-mid",
+                   label='After subtraction')
+    axs[1, 1].plot(np.sum(self.pixel_bkg_counts, axis=(0, 1, 2)),
+                   drawstyle="steps-mid",
+                   label='background')
+    axs[1, 1].legend()
+
+
+
+
+
+class LiveTimeCorrection +
+
+
+
+ +Expand source code + +
class LiveTimeCorrection(object):
+    pass
+    """
+    #counts is np.array   time_bins, detector, pixel, energy bins
+    trigger_rates=l1data['triggers'][1:,:]/l1data['timedel'][:-1,None]
+    # delta time is off by 1 time bin due a bug in the
+    out=np.copy(trigger_rates)
+    tau=11e-6
+    live_time=1 - tau*trig
+    photo_in=trig/(live_time)
+        """
+
+    @classmethod
+    def L1_live_time_correction(cls, triggers, counts_arr, time_bins):
+        """ Live time correction
+        Args
+            triggers: ndarray
+                triggers in the spectrogram
+            counts_arr:ndarray
+                counts in the spectrogram
+            time_bins: ndarray
+                time_bins in the spectrogram
+        Returns
+        live_time_ratio: ndarray
+            live time ratio of detectors
+        count_rate:
+            corrected count rate
+        photons_in:
+            rate of photons illuminating the detector group
+
+        """
+
+        fpga_tau=10.1e-6
+        asic_tau=2.63e-6
+        trig_tau = fpga_tau+asic_tau
+
+        time_bins = time_bins[:, None]
+        photons_in = triggers/(time_bins-trig_tau*triggers)
+        #photon rate calculated using triggers 
+
+        correction_factors= np.zeros((time_bins.size, 32))
+        time_bins = time_bins[:, :, None, None]
+
+        time_bins = time_bins[:, :, None, None]
+        count_rates = counts_arr/time_bins
+        # print(counts_arr.shape)
+        for det in range(32):
+            trig_idx=inst.detector_id_to_trigger_index[det]
+            nin=photons_in[:,trig_idx]
+            cor_factor=0.94
+            live_ratio[:,det]=np.exp(- cor_factor*nin*asic_tau*1e-6)/(1+ nin*trig_tau)
+
+        return correction_factors, corrected_rates , count_rates,photons_in
+
+

Static methods

+
+
+def L1_live_time_correction(triggers, counts_arr, time_bins) +
+
+

Live time correction +Args +triggers: ndarray +triggers in the spectrogram +counts_arr:ndarray +counts in the spectrogram +time_bins: ndarray +time_bins in the spectrogram +Returns +live_time_ratio: ndarray +live time ratio of detectors +count_rate: +corrected count rate +photons_in: +rate of photons illuminating the detector group

+
+ +Expand source code + +
@classmethod
+def L1_live_time_correction(cls, triggers, counts_arr, time_bins):
+    """ Live time correction
+    Args
+        triggers: ndarray
+            triggers in the spectrogram
+        counts_arr:ndarray
+            counts in the spectrogram
+        time_bins: ndarray
+            time_bins in the spectrogram
+    Returns
+    live_time_ratio: ndarray
+        live time ratio of detectors
+    count_rate:
+        corrected count rate
+    photons_in:
+        rate of photons illuminating the detector group
+
+    """
+
+    fpga_tau=10.1e-6
+    asic_tau=2.63e-6
+    trig_tau = fpga_tau+asic_tau
+
+    time_bins = time_bins[:, None]
+    photons_in = triggers/(time_bins-trig_tau*triggers)
+    #photon rate calculated using triggers 
+
+    correction_factors= np.zeros((time_bins.size, 32))
+    time_bins = time_bins[:, :, None, None]
+
+    time_bins = time_bins[:, :, None, None]
+    count_rates = counts_arr/time_bins
+    # print(counts_arr.shape)
+    for det in range(32):
+        trig_idx=inst.detector_id_to_trigger_index[det]
+        nin=photons_in[:,trig_idx]
+        cor_factor=0.94
+        live_ratio[:,det]=np.exp(- cor_factor*nin*asic_tau*1e-6)/(1+ nin*trig_tau)
+
+    return correction_factors, corrected_rates , count_rates,photons_in
+
+
+
+
+
+class TransmissionCorrection +
+
+
+
+ +Expand source code + +
class TransmissionCorrection(object):
+    pass
+
+
+
+
+
+ +
+ + + \ No newline at end of file diff --git a/docs/stixdcpy/detector_view.html b/docs/stixdcpy/detector_view.html new file mode 100644 index 0000000..704c1e4 --- /dev/null +++ b/docs/stixdcpy/detector_view.html @@ -0,0 +1,877 @@ + + + + + + +stixdcpy.detector_view API documentation + + + + + + + + + + + +
+
+
+

Module stixdcpy.detector_view

+
+
+
+ +Expand source code + +
#!/usr/bin/python3
+#create STIX detector view plot
+# Author: Hualin Xiao
+# date: Dec 17, 2021
+import numpy as np
+from matplotlib import pyplot as plt
+
+
+class DetectorView(object):
+    CANVAS_W = 1005
+    CANVAS_H = 1105
+    VIEW_W = int(3 * CANVAS_W)
+    VIEW_H = int(3 * CANVAS_H)
+    VIEWBOX = f'0  0 {VIEW_W} {VIEW_H}'
+    RFRAME = 450
+    RASPECT = 70
+    P0 = np.array([CANVAS_W / 2., CANVAS_H - RFRAME - 5])
+    WHITE = 'rgb(255,255,255)'
+
+    def __init__(self,
+                 pixel_counts=np.zeros(384),
+                 cmap='viridis',
+                 colorbar=False,
+                 logscale=False):
+        """
+         Plot STIX detector
+         Parameters
+          pixel_counts: 1d np.array
+            
+            counts in 384 pixels
+          cmap:  str, optional
+            matploat colormap, for example viridis, plasma, etc.
+          colorbar: bool
+            Plot colobar if it is True 
+         Returns
+           python object
+
+        """
+        self.cmap_name = cmap
+        self.pixel_counts = pixel_counts
+        col = (np.array(plt.get_cmap(cmap).colors) * 256).astype(int)
+        self.color_map = [f'rgb({x[0]},{x[1]},{x[2]})' for x in col]
+        self.color_x = np.linspace(0, 1, len(self.color_map))
+
+        self.colors = [self.WHITE] * 384
+
+        self.vis_counts = pixel_counts if not logscale else np.log(
+            pixel_counts,
+            where=np.array(pixel_counts) > 0,
+            out=np.zeros_like(pixel_counts))
+        if np.max(self.vis_counts) > 0:
+            max_val = np.max(self.vis_counts)
+            min_val = np.min(self.vis_counts)
+            if max_val > min_val:
+                nx = (self.vis_counts - min_val) / (max_val - min_val)
+                self.colors = np.array([
+                    self.color_map[np.argmin(np.abs(y - self.color_x))]
+                    for y in nx
+                ])
+        self.svg = self.create_detector_svg(colorbar)
+        self.html = f'<div style="width:400px;height:400px;">{self.svg}</html>'
+
+    def get_html(self):
+        return self.html
+
+    def get_svg(self):
+        """
+        get svg string
+        """
+        return self.svg
+
+    def save(self, filename):
+        """
+            save detector view to a svg file
+        Parameters:
+          filename: str
+            svg filename
+        Returns None
+        """
+        with open(filename, 'w') as f:
+            f.write(self.svg)
+
+    def plot_in_notebook(self):
+        """
+         Plot detector in nootbook
+        """
+        from IPython.display import SVG
+        SVG(self.svg)
+
+    def _create_color_bar(self, x0, y0, width, height):
+        path = (
+            '<rect x="{x0}" y="{y0}" width="{width}" height="{height}"'
+            'style="fill:rgb(250,250,250); stroke-width:0;stroke:rgb(0,0,255)" />'
+        ).format(x0=x0, y0=y0, width=width, height=height)
+        num = len(self.color_map)
+        dl = width / num
+        max_value = np.max(self.pixel_counts)
+        for i, col in enumerate(self.color_map):
+            x = dl * i + x0
+            y = y0
+            path += '<rect x="{}" y="{}" width="{}" height="{}"  style="fill:{}; stroke-width:1;stroke:{}" />'.format(
+                x, y, dl, height, col, col)
+        num_ticks = 10
+        for i in range(0, num_ticks):
+            x = dl * i + x0
+            y = y0 - 20
+            path += '<text x="{}" y="{}" > {} </text>'.format(
+                x, y, max_value * i / num_ticks)
+
+        return path
+
+    def create_detector_svg(self, colorbar=True):
+        positions = [[135, 412.5], [135, 527.5], [135, 662.5], [135, 777.5],
+                     [260, 297.5], [260, 412.5], [260, 527.5], [260, 662.5],
+                     [260, 777.5], [260, 892.5], [385, 227.5], [385, 342.5],
+                     [385, 457.5], [385, 732.5], [385, 847.5], [385, 962.5],
+                     [510, 227.5], [510, 342.5], [510, 457.5], [510, 732.5],
+                     [510, 847.5], [510, 962.5], [635, 297.5], [635, 412.5],
+                     [635, 527.5], [635, 662.5], [635, 777.5], [635, 892.5],
+                     [760, 412.5], [760, 527.5], [760, 662.5], [760, 777.5]]
+        svg_start = '''
+            <svg width="{cw}" height="{ch}" viewBox="{view_box}">
+          <circle
+              style="opacity:0.1;fill:#0000ff;stroke:#0000ff;stroke-width:1.046;stroke-miterlimit:4;stroke-dasharray:none;stroke-opacity:1"
+             id="path5200"
+             cx="{x0}"
+             cy="{y0}"
+             r="{r_frame}"/>
+          <path  style="stroke-width:3;stroke:rgb(0,0,250)"  d="M{x0} {y_min} L{x0} {y_max} " />
+          <path  style="stroke-width:3;stroke:rgb(0,0,250)"  d="M{x_min} {y0} L{x_max} {y0}" />
+      <circle
+         style="opacity:0.95999995;fill:#222b00;stroke:#0000ff;stroke-width:1.046;stroke-miterlimit:4;stroke-dasharray:none;stroke-opacity:1"
+         id="path5204"
+         cx="{x0}"
+         cy="{y0}"
+         r="{r_aspect}" />
+          '''.format(cw=self.CANVAS_W,
+                     ch=self.CANVAS_H,
+                     view_box=self.VIEWBOX,
+                     x0=self.P0[0],
+                     y0=self.P0[1],
+                     y_min=self.P0[1] - self.RFRAME,
+                     r_frame=self.RFRAME,
+                     r_aspect=self.RASPECT,
+                     y_max=self.P0[1] + self.RFRAME,
+                     x_min=self.P0[0] - self.RFRAME,
+                     x_max=self.P0[0] + self.RFRAME)
+
+        svg_end = '   </svg>'
+
+        color_bar = ''
+        if colorbar:
+            color_bar = self._create_color_bar(10, 100, 1000, 30)
+        template = svg_start + color_bar + '{}' + svg_end
+        items = []
+        for i, pos in enumerate(positions):
+            pos[1] = pos[1] + 5
+            items.append(self.create_one_detector_svg(i, pos, '{}'))
+
+        return template.format('\n'.join(items))
+
+    def create_one_detector_svg(self,
+                                detector_id=0,
+                                start=(0, 0),
+                                svg_template=''):
+        """ data is a 32*12 array """
+
+        if not svg_template:
+            svg_template = """
+            <svg width="110" height="110">
+            {}
+            </svg>
+            """
+        group = ''
+
+        pixel_template = '''
+          <path id="{}" text="" style="fill:{};stroke-width:1;stroke:rgb(200,200,200)"
+          d="{}" ><title>{}</title></path>'''
+
+        start_x = start[0]
+        start_y = start[1]
+        offset = np.array([start_x, start_y])
+        fill_color = 'rgb(230,230,230)'
+
+        pitch_x = 22
+        pitch_y = 46
+
+        big_p0_top = offset + np.array([6, 4])
+        big_p0_bottom = offset + np.array([6, 4 + 92])
+
+        big_pixel_top = 'h 22 v 46 h -11 v -4.5 h -11 Z'
+        big_pixel_bottom = 'h 22 v -46 h -11 v 4.5 h -11 Z'
+
+        small_p0 = offset + np.array([6, 50 - 4.5])
+        small_pixel_path = 'h 11 v 9 h -11  Z'
+
+        container = []
+        #create big pixels
+
+        guardring = '<rect x="{}" y="{}" width="100" height="100"  style="fill:rgb(255,255,255);stroke-width:1;stroke:rgb(0,0,0)" />'.format(
+            offset[0], offset[1])
+        x0 = offset[0]
+        y0 = offset[1]
+        #print("'det_{}':'M{} {} L {} {} L{} {} L{} {} Z ',".format(detector_id,x0,y0,x0+100,y0,x0+100,y0+100, x0,y0+100))
+        container.append(guardring)
+        text = '<text x="{}" y="{}" filled="red"> #{} </text>'.format(
+            offset[0] + 40, offset[1] + 110, detector_id + 1)
+        container.append(text)
+
+        for i in range(0, 4):
+            start = big_p0_top + np.array([i * pitch_x, 0])
+            path = 'M {} {} {}'.format(start[0], start[1], big_pixel_top)
+            pid = 'id-{}-{}'.format(detector_id, i)
+            pid = detector_id * 12 + i
+            counts = self.pixel_counts[pid]
+            fill_color = self.colors[pid]
+
+            container.append(
+                pixel_template.format(pid, fill_color, path, counts))
+
+        for i in range(0, 4):
+            start = big_p0_bottom + np.array([i * pitch_x, 0])
+            path = 'M {} {} {}'.format(start[0], start[1], big_pixel_bottom)
+            pid = 'id-{}-{}'.format(detector_id, i + 4)
+            pid = detector_id * 12 + i + 4
+            counts = self.pixel_counts[pid]
+            fill_color = self.colors[pid]
+
+            container.append(
+                pixel_template.format(pid, fill_color, path, counts))
+
+        for i in range(0, 4):
+            start = small_p0 + np.array([i * pitch_x, 0])
+            path = 'M {} {} {}'.format(start[0], start[1], small_pixel_path)
+            pid = 'id-{}-{}'.format(detector_id, i + 8)
+            pid = detector_id * 12 + i + 8
+            counts = self.pixel_counts[pid]
+            fill_color = self.colors[pid]
+            container.append(
+                pixel_template.format(pid, fill_color, path, counts))
+        group = '<g> {} </g>'.format('\n'.join(container))
+        return svg_template.format(group)
+
+
+if __name__ == '__main__':
+    with open('detector.svg', 'w') as f:
+        data = np.arange(384)
+        det = DetectorView(data)
+        f.write(det.get_svg())
+
+
+
+
+
+
+
+
+
+

Classes

+
+
+class DetectorView +(pixel_counts=array([0., 0., 0., 0., 0., 0., 0., 0., 0., 0., 0., 0., 0., 0., 0., 0., 0., +0., 0., 0., 0., 0., 0., 0., 0., 0., 0., 0., 0., 0., 0., 0., 0., 0., +0., 0., 0., 0., 0., 0., 0., 0., 0., 0., 0., 0., 0., 0., 0., 0., 0., +0., 0., 0., 0., 0., 0., 0., 0., 0., 0., 0., 0., 0., 0., 0., 0., 0., +0., 0., 0., 0., 0., 0., 0., 0., 0., 0., 0., 0., 0., 0., 0., 0., 0., +0., 0., 0., 0., 0., 0., 0., 0., 0., 0., 0., 0., 0., 0., 0., 0., 0., +0., 0., 0., 0., 0., 0., 0., 0., 0., 0., 0., 0., 0., 0., 0., 0., 0., +0., 0., 0., 0., 0., 0., 0., 0., 0., 0., 0., 0., 0., 0., 0., 0., 0., +0., 0., 0., 0., 0., 0., 0., 0., 0., 0., 0., 0., 0., 0., 0., 0., 0., +0., 0., 0., 0., 0., 0., 0., 0., 0., 0., 0., 0., 0., 0., 0., 0., 0., +0., 0., 0., 0., 0., 0., 0., 0., 0., 0., 0., 0., 0., 0., 0., 0., 0., +0., 0., 0., 0., 0., 0., 0., 0., 0., 0., 0., 0., 0., 0., 0., 0., 0., +0., 0., 0., 0., 0., 0., 0., 0., 0., 0., 0., 0., 0., 0., 0., 0., 0., +0., 0., 0., 0., 0., 0., 0., 0., 0., 0., 0., 0., 0., 0., 0., 0., 0., +0., 0., 0., 0., 0., 0., 0., 0., 0., 0., 0., 0., 0., 0., 0., 0., 0., +0., 0., 0., 0., 0., 0., 0., 0., 0., 0., 0., 0., 0., 0., 0., 0., 0., +0., 0., 0., 0., 0., 0., 0., 0., 0., 0., 0., 0., 0., 0., 0., 0., 0., +0., 0., 0., 0., 0., 0., 0., 0., 0., 0., 0., 0., 0., 0., 0., 0., 0., +0., 0., 0., 0., 0., 0., 0., 0., 0., 0., 0., 0., 0., 0., 0., 0., 0., +0., 0., 0., 0., 0., 0., 0., 0., 0., 0., 0., 0., 0., 0., 0., 0., 0., +0., 0., 0., 0., 0., 0., 0., 0., 0., 0., 0., 0., 0., 0., 0., 0., 0., +0., 0., 0., 0., 0., 0., 0., 0., 0., 0., 0., 0., 0., 0., 0., 0., 0., +0., 0., 0., 0., 0., 0., 0., 0., 0., 0.]), cmap='viridis', colorbar=False, logscale=False) +
+
+

Plot STIX detector +Parameters +pixel_counts: 1d np.array

+

counts in 384 pixels +cmap: +str, optional +matploat colormap, for example viridis, plasma, etc. +colorbar: bool +Plot colobar if it is True +Returns +python object

+
+ +Expand source code + +
class DetectorView(object):
+    CANVAS_W = 1005
+    CANVAS_H = 1105
+    VIEW_W = int(3 * CANVAS_W)
+    VIEW_H = int(3 * CANVAS_H)
+    VIEWBOX = f'0  0 {VIEW_W} {VIEW_H}'
+    RFRAME = 450
+    RASPECT = 70
+    P0 = np.array([CANVAS_W / 2., CANVAS_H - RFRAME - 5])
+    WHITE = 'rgb(255,255,255)'
+
+    def __init__(self,
+                 pixel_counts=np.zeros(384),
+                 cmap='viridis',
+                 colorbar=False,
+                 logscale=False):
+        """
+         Plot STIX detector
+         Parameters
+          pixel_counts: 1d np.array
+            
+            counts in 384 pixels
+          cmap:  str, optional
+            matploat colormap, for example viridis, plasma, etc.
+          colorbar: bool
+            Plot colobar if it is True 
+         Returns
+           python object
+
+        """
+        self.cmap_name = cmap
+        self.pixel_counts = pixel_counts
+        col = (np.array(plt.get_cmap(cmap).colors) * 256).astype(int)
+        self.color_map = [f'rgb({x[0]},{x[1]},{x[2]})' for x in col]
+        self.color_x = np.linspace(0, 1, len(self.color_map))
+
+        self.colors = [self.WHITE] * 384
+
+        self.vis_counts = pixel_counts if not logscale else np.log(
+            pixel_counts,
+            where=np.array(pixel_counts) > 0,
+            out=np.zeros_like(pixel_counts))
+        if np.max(self.vis_counts) > 0:
+            max_val = np.max(self.vis_counts)
+            min_val = np.min(self.vis_counts)
+            if max_val > min_val:
+                nx = (self.vis_counts - min_val) / (max_val - min_val)
+                self.colors = np.array([
+                    self.color_map[np.argmin(np.abs(y - self.color_x))]
+                    for y in nx
+                ])
+        self.svg = self.create_detector_svg(colorbar)
+        self.html = f'<div style="width:400px;height:400px;">{self.svg}</html>'
+
+    def get_html(self):
+        return self.html
+
+    def get_svg(self):
+        """
+        get svg string
+        """
+        return self.svg
+
+    def save(self, filename):
+        """
+            save detector view to a svg file
+        Parameters:
+          filename: str
+            svg filename
+        Returns None
+        """
+        with open(filename, 'w') as f:
+            f.write(self.svg)
+
+    def plot_in_notebook(self):
+        """
+         Plot detector in nootbook
+        """
+        from IPython.display import SVG
+        SVG(self.svg)
+
+    def _create_color_bar(self, x0, y0, width, height):
+        path = (
+            '<rect x="{x0}" y="{y0}" width="{width}" height="{height}"'
+            'style="fill:rgb(250,250,250); stroke-width:0;stroke:rgb(0,0,255)" />'
+        ).format(x0=x0, y0=y0, width=width, height=height)
+        num = len(self.color_map)
+        dl = width / num
+        max_value = np.max(self.pixel_counts)
+        for i, col in enumerate(self.color_map):
+            x = dl * i + x0
+            y = y0
+            path += '<rect x="{}" y="{}" width="{}" height="{}"  style="fill:{}; stroke-width:1;stroke:{}" />'.format(
+                x, y, dl, height, col, col)
+        num_ticks = 10
+        for i in range(0, num_ticks):
+            x = dl * i + x0
+            y = y0 - 20
+            path += '<text x="{}" y="{}" > {} </text>'.format(
+                x, y, max_value * i / num_ticks)
+
+        return path
+
+    def create_detector_svg(self, colorbar=True):
+        positions = [[135, 412.5], [135, 527.5], [135, 662.5], [135, 777.5],
+                     [260, 297.5], [260, 412.5], [260, 527.5], [260, 662.5],
+                     [260, 777.5], [260, 892.5], [385, 227.5], [385, 342.5],
+                     [385, 457.5], [385, 732.5], [385, 847.5], [385, 962.5],
+                     [510, 227.5], [510, 342.5], [510, 457.5], [510, 732.5],
+                     [510, 847.5], [510, 962.5], [635, 297.5], [635, 412.5],
+                     [635, 527.5], [635, 662.5], [635, 777.5], [635, 892.5],
+                     [760, 412.5], [760, 527.5], [760, 662.5], [760, 777.5]]
+        svg_start = '''
+            <svg width="{cw}" height="{ch}" viewBox="{view_box}">
+          <circle
+              style="opacity:0.1;fill:#0000ff;stroke:#0000ff;stroke-width:1.046;stroke-miterlimit:4;stroke-dasharray:none;stroke-opacity:1"
+             id="path5200"
+             cx="{x0}"
+             cy="{y0}"
+             r="{r_frame}"/>
+          <path  style="stroke-width:3;stroke:rgb(0,0,250)"  d="M{x0} {y_min} L{x0} {y_max} " />
+          <path  style="stroke-width:3;stroke:rgb(0,0,250)"  d="M{x_min} {y0} L{x_max} {y0}" />
+      <circle
+         style="opacity:0.95999995;fill:#222b00;stroke:#0000ff;stroke-width:1.046;stroke-miterlimit:4;stroke-dasharray:none;stroke-opacity:1"
+         id="path5204"
+         cx="{x0}"
+         cy="{y0}"
+         r="{r_aspect}" />
+          '''.format(cw=self.CANVAS_W,
+                     ch=self.CANVAS_H,
+                     view_box=self.VIEWBOX,
+                     x0=self.P0[0],
+                     y0=self.P0[1],
+                     y_min=self.P0[1] - self.RFRAME,
+                     r_frame=self.RFRAME,
+                     r_aspect=self.RASPECT,
+                     y_max=self.P0[1] + self.RFRAME,
+                     x_min=self.P0[0] - self.RFRAME,
+                     x_max=self.P0[0] + self.RFRAME)
+
+        svg_end = '   </svg>'
+
+        color_bar = ''
+        if colorbar:
+            color_bar = self._create_color_bar(10, 100, 1000, 30)
+        template = svg_start + color_bar + '{}' + svg_end
+        items = []
+        for i, pos in enumerate(positions):
+            pos[1] = pos[1] + 5
+            items.append(self.create_one_detector_svg(i, pos, '{}'))
+
+        return template.format('\n'.join(items))
+
+    def create_one_detector_svg(self,
+                                detector_id=0,
+                                start=(0, 0),
+                                svg_template=''):
+        """ data is a 32*12 array """
+
+        if not svg_template:
+            svg_template = """
+            <svg width="110" height="110">
+            {}
+            </svg>
+            """
+        group = ''
+
+        pixel_template = '''
+          <path id="{}" text="" style="fill:{};stroke-width:1;stroke:rgb(200,200,200)"
+          d="{}" ><title>{}</title></path>'''
+
+        start_x = start[0]
+        start_y = start[1]
+        offset = np.array([start_x, start_y])
+        fill_color = 'rgb(230,230,230)'
+
+        pitch_x = 22
+        pitch_y = 46
+
+        big_p0_top = offset + np.array([6, 4])
+        big_p0_bottom = offset + np.array([6, 4 + 92])
+
+        big_pixel_top = 'h 22 v 46 h -11 v -4.5 h -11 Z'
+        big_pixel_bottom = 'h 22 v -46 h -11 v 4.5 h -11 Z'
+
+        small_p0 = offset + np.array([6, 50 - 4.5])
+        small_pixel_path = 'h 11 v 9 h -11  Z'
+
+        container = []
+        #create big pixels
+
+        guardring = '<rect x="{}" y="{}" width="100" height="100"  style="fill:rgb(255,255,255);stroke-width:1;stroke:rgb(0,0,0)" />'.format(
+            offset[0], offset[1])
+        x0 = offset[0]
+        y0 = offset[1]
+        #print("'det_{}':'M{} {} L {} {} L{} {} L{} {} Z ',".format(detector_id,x0,y0,x0+100,y0,x0+100,y0+100, x0,y0+100))
+        container.append(guardring)
+        text = '<text x="{}" y="{}" filled="red"> #{} </text>'.format(
+            offset[0] + 40, offset[1] + 110, detector_id + 1)
+        container.append(text)
+
+        for i in range(0, 4):
+            start = big_p0_top + np.array([i * pitch_x, 0])
+            path = 'M {} {} {}'.format(start[0], start[1], big_pixel_top)
+            pid = 'id-{}-{}'.format(detector_id, i)
+            pid = detector_id * 12 + i
+            counts = self.pixel_counts[pid]
+            fill_color = self.colors[pid]
+
+            container.append(
+                pixel_template.format(pid, fill_color, path, counts))
+
+        for i in range(0, 4):
+            start = big_p0_bottom + np.array([i * pitch_x, 0])
+            path = 'M {} {} {}'.format(start[0], start[1], big_pixel_bottom)
+            pid = 'id-{}-{}'.format(detector_id, i + 4)
+            pid = detector_id * 12 + i + 4
+            counts = self.pixel_counts[pid]
+            fill_color = self.colors[pid]
+
+            container.append(
+                pixel_template.format(pid, fill_color, path, counts))
+
+        for i in range(0, 4):
+            start = small_p0 + np.array([i * pitch_x, 0])
+            path = 'M {} {} {}'.format(start[0], start[1], small_pixel_path)
+            pid = 'id-{}-{}'.format(detector_id, i + 8)
+            pid = detector_id * 12 + i + 8
+            counts = self.pixel_counts[pid]
+            fill_color = self.colors[pid]
+            container.append(
+                pixel_template.format(pid, fill_color, path, counts))
+        group = '<g> {} </g>'.format('\n'.join(container))
+        return svg_template.format(group)
+
+

Class variables

+
+
var CANVAS_H
+
+
+
+
var CANVAS_W
+
+
+
+
var P0
+
+
+
+
var RASPECT
+
+
+
+
var RFRAME
+
+
+
+
var VIEWBOX
+
+
+
+
var VIEW_H
+
+
+
+
var VIEW_W
+
+
+
+
var WHITE
+
+
+
+
+

Methods

+
+
+def create_detector_svg(self, colorbar=True) +
+
+
+
+ +Expand source code + +
def create_detector_svg(self, colorbar=True):
+    positions = [[135, 412.5], [135, 527.5], [135, 662.5], [135, 777.5],
+                 [260, 297.5], [260, 412.5], [260, 527.5], [260, 662.5],
+                 [260, 777.5], [260, 892.5], [385, 227.5], [385, 342.5],
+                 [385, 457.5], [385, 732.5], [385, 847.5], [385, 962.5],
+                 [510, 227.5], [510, 342.5], [510, 457.5], [510, 732.5],
+                 [510, 847.5], [510, 962.5], [635, 297.5], [635, 412.5],
+                 [635, 527.5], [635, 662.5], [635, 777.5], [635, 892.5],
+                 [760, 412.5], [760, 527.5], [760, 662.5], [760, 777.5]]
+    svg_start = '''
+        <svg width="{cw}" height="{ch}" viewBox="{view_box}">
+      <circle
+          style="opacity:0.1;fill:#0000ff;stroke:#0000ff;stroke-width:1.046;stroke-miterlimit:4;stroke-dasharray:none;stroke-opacity:1"
+         id="path5200"
+         cx="{x0}"
+         cy="{y0}"
+         r="{r_frame}"/>
+      <path  style="stroke-width:3;stroke:rgb(0,0,250)"  d="M{x0} {y_min} L{x0} {y_max} " />
+      <path  style="stroke-width:3;stroke:rgb(0,0,250)"  d="M{x_min} {y0} L{x_max} {y0}" />
+  <circle
+     style="opacity:0.95999995;fill:#222b00;stroke:#0000ff;stroke-width:1.046;stroke-miterlimit:4;stroke-dasharray:none;stroke-opacity:1"
+     id="path5204"
+     cx="{x0}"
+     cy="{y0}"
+     r="{r_aspect}" />
+      '''.format(cw=self.CANVAS_W,
+                 ch=self.CANVAS_H,
+                 view_box=self.VIEWBOX,
+                 x0=self.P0[0],
+                 y0=self.P0[1],
+                 y_min=self.P0[1] - self.RFRAME,
+                 r_frame=self.RFRAME,
+                 r_aspect=self.RASPECT,
+                 y_max=self.P0[1] + self.RFRAME,
+                 x_min=self.P0[0] - self.RFRAME,
+                 x_max=self.P0[0] + self.RFRAME)
+
+    svg_end = '   </svg>'
+
+    color_bar = ''
+    if colorbar:
+        color_bar = self._create_color_bar(10, 100, 1000, 30)
+    template = svg_start + color_bar + '{}' + svg_end
+    items = []
+    for i, pos in enumerate(positions):
+        pos[1] = pos[1] + 5
+        items.append(self.create_one_detector_svg(i, pos, '{}'))
+
+    return template.format('\n'.join(items))
+
+
+
+def create_one_detector_svg(self, detector_id=0, start=(0, 0), svg_template='') +
+
+

data is a 32*12 array

+
+ +Expand source code + +
def create_one_detector_svg(self,
+                            detector_id=0,
+                            start=(0, 0),
+                            svg_template=''):
+    """ data is a 32*12 array """
+
+    if not svg_template:
+        svg_template = """
+        <svg width="110" height="110">
+        {}
+        </svg>
+        """
+    group = ''
+
+    pixel_template = '''
+      <path id="{}" text="" style="fill:{};stroke-width:1;stroke:rgb(200,200,200)"
+      d="{}" ><title>{}</title></path>'''
+
+    start_x = start[0]
+    start_y = start[1]
+    offset = np.array([start_x, start_y])
+    fill_color = 'rgb(230,230,230)'
+
+    pitch_x = 22
+    pitch_y = 46
+
+    big_p0_top = offset + np.array([6, 4])
+    big_p0_bottom = offset + np.array([6, 4 + 92])
+
+    big_pixel_top = 'h 22 v 46 h -11 v -4.5 h -11 Z'
+    big_pixel_bottom = 'h 22 v -46 h -11 v 4.5 h -11 Z'
+
+    small_p0 = offset + np.array([6, 50 - 4.5])
+    small_pixel_path = 'h 11 v 9 h -11  Z'
+
+    container = []
+    #create big pixels
+
+    guardring = '<rect x="{}" y="{}" width="100" height="100"  style="fill:rgb(255,255,255);stroke-width:1;stroke:rgb(0,0,0)" />'.format(
+        offset[0], offset[1])
+    x0 = offset[0]
+    y0 = offset[1]
+    #print("'det_{}':'M{} {} L {} {} L{} {} L{} {} Z ',".format(detector_id,x0,y0,x0+100,y0,x0+100,y0+100, x0,y0+100))
+    container.append(guardring)
+    text = '<text x="{}" y="{}" filled="red"> #{} </text>'.format(
+        offset[0] + 40, offset[1] + 110, detector_id + 1)
+    container.append(text)
+
+    for i in range(0, 4):
+        start = big_p0_top + np.array([i * pitch_x, 0])
+        path = 'M {} {} {}'.format(start[0], start[1], big_pixel_top)
+        pid = 'id-{}-{}'.format(detector_id, i)
+        pid = detector_id * 12 + i
+        counts = self.pixel_counts[pid]
+        fill_color = self.colors[pid]
+
+        container.append(
+            pixel_template.format(pid, fill_color, path, counts))
+
+    for i in range(0, 4):
+        start = big_p0_bottom + np.array([i * pitch_x, 0])
+        path = 'M {} {} {}'.format(start[0], start[1], big_pixel_bottom)
+        pid = 'id-{}-{}'.format(detector_id, i + 4)
+        pid = detector_id * 12 + i + 4
+        counts = self.pixel_counts[pid]
+        fill_color = self.colors[pid]
+
+        container.append(
+            pixel_template.format(pid, fill_color, path, counts))
+
+    for i in range(0, 4):
+        start = small_p0 + np.array([i * pitch_x, 0])
+        path = 'M {} {} {}'.format(start[0], start[1], small_pixel_path)
+        pid = 'id-{}-{}'.format(detector_id, i + 8)
+        pid = detector_id * 12 + i + 8
+        counts = self.pixel_counts[pid]
+        fill_color = self.colors[pid]
+        container.append(
+            pixel_template.format(pid, fill_color, path, counts))
+    group = '<g> {} </g>'.format('\n'.join(container))
+    return svg_template.format(group)
+
+
+
+def get_html(self) +
+
+
+
+ +Expand source code + +
def get_html(self):
+    return self.html
+
+
+
+def get_svg(self) +
+
+

get svg string

+
+ +Expand source code + +
def get_svg(self):
+    """
+    get svg string
+    """
+    return self.svg
+
+
+
+def plot_in_notebook(self) +
+
+

Plot detector in nootbook

+
+ +Expand source code + +
def plot_in_notebook(self):
+    """
+     Plot detector in nootbook
+    """
+    from IPython.display import SVG
+    SVG(self.svg)
+
+
+
+def save(self, filename) +
+
+

save detector view to a svg file

+

Parameters

+

filename: str +svg filename +Returns None

+
+ +Expand source code + +
def save(self, filename):
+    """
+        save detector view to a svg file
+    Parameters:
+      filename: str
+        svg filename
+    Returns None
+    """
+    with open(filename, 'w') as f:
+        f.write(self.svg)
+
+
+
+
+
+
+
+ +
+ + + \ No newline at end of file diff --git a/docs/stixdcpy/energylut.html b/docs/stixdcpy/energylut.html new file mode 100644 index 0000000..2c7c08a --- /dev/null +++ b/docs/stixdcpy/energylut.html @@ -0,0 +1,569 @@ + + + + + + +stixdcpy.energylut API documentation + + + + + + + + + + + +
+
+
+

Module stixdcpy.energylut

+
+
+

This script provides APIs to retrieve energy +calibration data from STIX data center +,and some tools to display the data +Author: Hualin Xiao (hualin.xiao@fhnw.ch) +Date: Sep. 1, 2021

+
+ +Expand source code + +
#!/usr/bin/python
+"""
+    This script provides APIs to retrieve energy  calibration data from STIX data center  ,and some tools to display the data
+    Author: Hualin Xiao (hualin.xiao@fhnw.ch)
+    Date: Sep. 1, 2021
+
+"""
+from pprint import pprint
+
+import numpy as np
+from stixdcpy.logger import logger
+from stixdcpy import io as sio
+from stixdcpy.net import JSONRequest as jreq
+from stixdcpy.transmission import Transmission
+
+
+class EnergyLUT(sio.IO):
+    def __init__(self, data):
+        self.data = data
+        self.tran = Transmission()
+
+    @classmethod
+    def request(cls, utc):
+        data = jreq.fetch_elut(utc)
+        '''
+        data structure
+        {'data':{
+                    'onboard':self.onboard_elut, 
+                    'calibration':self.calibration_run_elut,
+                    'true_energy_bin_edges':self.true_energy_bin_edges,
+                    'energy_bin_edges':NOMINAL_EBIN_EDGES,
+                },
+                'info': self.info(),
+                }
+                '''
+        return cls(data)
+
+    @classmethod
+    def from_npy(cls, filename):
+        with np.load(filename, allow_picke=True) as data:
+            elut_data = data.item()['elut']
+            cls(elut_data)
+
+    def save_npy(self, filename):
+        np.save(filename, {'elut': self.data})
+
+    def info(self):
+        try:
+            pprint(self.data['info'])
+            # pprint('Pixel 0 true energy bin  edges: ')
+            # pprint(self.get_pixel_true_ebins(0))
+            # pprint('...')
+
+        except KeyError as e:
+            logger.error(e)
+
+    def __getattr__(self, name):
+        if name == 'data':
+            return self.data['data']
+
+    def get_data(self):
+        return self.data['data']
+
+    def get_calibration_data(self):
+        """Get calibration data
+
+        Returns:
+            result: dict, or None
+                Calibration data python dictionary if success or None if failed 
+        """
+        try:
+            return self.data['data']['calibration']
+        except Exception as e:
+            print(e)
+            return None
+
+    def get_onboard_elut(self):
+        try:
+            return self.data['data']['onboard']
+        except (KeyError, TypeError):
+            logger.error('Failed to retrieve onboard elut!')
+            return None
+
+    def get_pixel_true_ebins(self, pixel):
+        """Get the real energy bin ranges for the given pixel
+
+        Args:
+            pixel (int): pixel ID ranging from 0...383
+
+        Returns:
+            ebins: numpy.array
+                Lower and upper bounds of 32 energy bins
+        """        
+        true_ebins = np.array(self.data['data']['true_energy_bin_edges'])
+        pixel_ebins = true_ebins[:, pixel]  # 33 x 384 retrieve the column
+        ebins = np.column_stack((pixel_ebins[:-1], pixel_ebins[1:]))
+        return ebins
+
+    def get_pixel_ebins_transmissions(self):
+        """
+        Get transmission for pixels at a given time
+        Args: 
+            None
+        Returns:
+            A numpy array with a shape of 32 x12 x 32.  The three dimensions indicate detector, pixel, and transmission for 32 energy channels.
+            The transmission for the last energy bin set to 0
+            """
+        true_ebins = np.array(
+            self.data['data']
+            ['true_energy_bin_edges'])  # an 2d array: 33 x 384
+        trans = np.zeros((32, 12, 32))
+        for i in range(32):
+            for j in range(12):
+                ipix = i * 12 + j
+                pixel_ebins = true_ebins[:, ipix]  # retrieve the column
+                ebins = np.column_stack((pixel_ebins[:-1], pixel_ebins[1:]))
+                ebins[0][0] = np.finfo(float).eps
+                ebins[31][1] = 300
+
+                trans[i][j] = self.tran.get_detector_transmission(
+                    i, ebins, attenuator=False)
+        trans[:, :,
+              31] = 0  # set the transmission for the last energy bin to 0
+        trans[:, :,
+              0] = 0  # set the transmission for the first energy bin to 0
+        return trans
+
+
+
+
+
+
+
+
+
+

Classes

+
+
+class EnergyLUT +(data) +
+
+

Base object

+
+ +Expand source code + +
class EnergyLUT(sio.IO):
+    def __init__(self, data):
+        self.data = data
+        self.tran = Transmission()
+
+    @classmethod
+    def request(cls, utc):
+        data = jreq.fetch_elut(utc)
+        '''
+        data structure
+        {'data':{
+                    'onboard':self.onboard_elut, 
+                    'calibration':self.calibration_run_elut,
+                    'true_energy_bin_edges':self.true_energy_bin_edges,
+                    'energy_bin_edges':NOMINAL_EBIN_EDGES,
+                },
+                'info': self.info(),
+                }
+                '''
+        return cls(data)
+
+    @classmethod
+    def from_npy(cls, filename):
+        with np.load(filename, allow_picke=True) as data:
+            elut_data = data.item()['elut']
+            cls(elut_data)
+
+    def save_npy(self, filename):
+        np.save(filename, {'elut': self.data})
+
+    def info(self):
+        try:
+            pprint(self.data['info'])
+            # pprint('Pixel 0 true energy bin  edges: ')
+            # pprint(self.get_pixel_true_ebins(0))
+            # pprint('...')
+
+        except KeyError as e:
+            logger.error(e)
+
+    def __getattr__(self, name):
+        if name == 'data':
+            return self.data['data']
+
+    def get_data(self):
+        return self.data['data']
+
+    def get_calibration_data(self):
+        """Get calibration data
+
+        Returns:
+            result: dict, or None
+                Calibration data python dictionary if success or None if failed 
+        """
+        try:
+            return self.data['data']['calibration']
+        except Exception as e:
+            print(e)
+            return None
+
+    def get_onboard_elut(self):
+        try:
+            return self.data['data']['onboard']
+        except (KeyError, TypeError):
+            logger.error('Failed to retrieve onboard elut!')
+            return None
+
+    def get_pixel_true_ebins(self, pixel):
+        """Get the real energy bin ranges for the given pixel
+
+        Args:
+            pixel (int): pixel ID ranging from 0...383
+
+        Returns:
+            ebins: numpy.array
+                Lower and upper bounds of 32 energy bins
+        """        
+        true_ebins = np.array(self.data['data']['true_energy_bin_edges'])
+        pixel_ebins = true_ebins[:, pixel]  # 33 x 384 retrieve the column
+        ebins = np.column_stack((pixel_ebins[:-1], pixel_ebins[1:]))
+        return ebins
+
+    def get_pixel_ebins_transmissions(self):
+        """
+        Get transmission for pixels at a given time
+        Args: 
+            None
+        Returns:
+            A numpy array with a shape of 32 x12 x 32.  The three dimensions indicate detector, pixel, and transmission for 32 energy channels.
+            The transmission for the last energy bin set to 0
+            """
+        true_ebins = np.array(
+            self.data['data']
+            ['true_energy_bin_edges'])  # an 2d array: 33 x 384
+        trans = np.zeros((32, 12, 32))
+        for i in range(32):
+            for j in range(12):
+                ipix = i * 12 + j
+                pixel_ebins = true_ebins[:, ipix]  # retrieve the column
+                ebins = np.column_stack((pixel_ebins[:-1], pixel_ebins[1:]))
+                ebins[0][0] = np.finfo(float).eps
+                ebins[31][1] = 300
+
+                trans[i][j] = self.tran.get_detector_transmission(
+                    i, ebins, attenuator=False)
+        trans[:, :,
+              31] = 0  # set the transmission for the last energy bin to 0
+        trans[:, :,
+              0] = 0  # set the transmission for the first energy bin to 0
+        return trans
+
+

Ancestors

+ +

Static methods

+
+
+def from_npy(filename) +
+
+
+
+ +Expand source code + +
@classmethod
+def from_npy(cls, filename):
+    with np.load(filename, allow_picke=True) as data:
+        elut_data = data.item()['elut']
+        cls(elut_data)
+
+
+
+def request(utc) +
+
+
+
+ +Expand source code + +
@classmethod
+def request(cls, utc):
+    data = jreq.fetch_elut(utc)
+    '''
+    data structure
+    {'data':{
+                'onboard':self.onboard_elut, 
+                'calibration':self.calibration_run_elut,
+                'true_energy_bin_edges':self.true_energy_bin_edges,
+                'energy_bin_edges':NOMINAL_EBIN_EDGES,
+            },
+            'info': self.info(),
+            }
+            '''
+    return cls(data)
+
+
+
+

Methods

+
+
+def get_calibration_data(self) +
+
+

Get calibration data

+

Returns

+
+
result
+
dict, or None +Calibration data python dictionary if success or None if failed
+
+
+ +Expand source code + +
def get_calibration_data(self):
+    """Get calibration data
+
+    Returns:
+        result: dict, or None
+            Calibration data python dictionary if success or None if failed 
+    """
+    try:
+        return self.data['data']['calibration']
+    except Exception as e:
+        print(e)
+        return None
+
+
+
+def get_data(self) +
+
+
+
+ +Expand source code + +
def get_data(self):
+    return self.data['data']
+
+
+
+def get_onboard_elut(self) +
+
+
+
+ +Expand source code + +
def get_onboard_elut(self):
+    try:
+        return self.data['data']['onboard']
+    except (KeyError, TypeError):
+        logger.error('Failed to retrieve onboard elut!')
+        return None
+
+
+
+def get_pixel_ebins_transmissions(self) +
+
+

Get transmission for pixels at a given time +Args: +None

+

Returns

+

A numpy array with a shape of 32 x12 x 32. +The three dimensions indicate detector, pixel, and transmission for 32 energy channels. +The transmission for the last energy bin set to 0

+
+ +Expand source code + +
def get_pixel_ebins_transmissions(self):
+    """
+    Get transmission for pixels at a given time
+    Args: 
+        None
+    Returns:
+        A numpy array with a shape of 32 x12 x 32.  The three dimensions indicate detector, pixel, and transmission for 32 energy channels.
+        The transmission for the last energy bin set to 0
+        """
+    true_ebins = np.array(
+        self.data['data']
+        ['true_energy_bin_edges'])  # an 2d array: 33 x 384
+    trans = np.zeros((32, 12, 32))
+    for i in range(32):
+        for j in range(12):
+            ipix = i * 12 + j
+            pixel_ebins = true_ebins[:, ipix]  # retrieve the column
+            ebins = np.column_stack((pixel_ebins[:-1], pixel_ebins[1:]))
+            ebins[0][0] = np.finfo(float).eps
+            ebins[31][1] = 300
+
+            trans[i][j] = self.tran.get_detector_transmission(
+                i, ebins, attenuator=False)
+    trans[:, :,
+          31] = 0  # set the transmission for the last energy bin to 0
+    trans[:, :,
+          0] = 0  # set the transmission for the first energy bin to 0
+    return trans
+
+
+
+def get_pixel_true_ebins(self, pixel) +
+
+

Get the real energy bin ranges for the given pixel

+

Args

+
+
pixel : int
+
pixel ID ranging from 0…383
+
+

Returns

+
+
ebins
+
numpy.array +Lower and upper bounds of 32 energy bins
+
+
+ +Expand source code + +
def get_pixel_true_ebins(self, pixel):
+    """Get the real energy bin ranges for the given pixel
+
+    Args:
+        pixel (int): pixel ID ranging from 0...383
+
+    Returns:
+        ebins: numpy.array
+            Lower and upper bounds of 32 energy bins
+    """        
+    true_ebins = np.array(self.data['data']['true_energy_bin_edges'])
+    pixel_ebins = true_ebins[:, pixel]  # 33 x 384 retrieve the column
+    ebins = np.column_stack((pixel_ebins[:-1], pixel_ebins[1:]))
+    return ebins
+
+
+
+def info(self) +
+
+
+
+ +Expand source code + +
def info(self):
+    try:
+        pprint(self.data['info'])
+        # pprint('Pixel 0 true energy bin  edges: ')
+        # pprint(self.get_pixel_true_ebins(0))
+        # pprint('...')
+
+    except KeyError as e:
+        logger.error(e)
+
+
+
+def save_npy(self, filename) +
+
+
+
+ +Expand source code + +
def save_npy(self, filename):
+    np.save(filename, {'elut': self.data})
+
+
+
+

Inherited members

+ +
+
+
+
+ +
+ + + \ No newline at end of file diff --git a/docs/stixdcpy/housekeeping.html b/docs/stixdcpy/housekeeping.html new file mode 100644 index 0000000..3b3031d --- /dev/null +++ b/docs/stixdcpy/housekeeping.html @@ -0,0 +1,362 @@ + + + + + + +stixdcpy.housekeeping API documentation + + + + + + + + + + + +
+
+
+

Module stixdcpy.housekeeping

+
+
+

This module provides APIs to retrieve Housekeeping data from STIX data center +,and some tools to display the data +Author: Hualin Xiao (hualin.xiao@fhnw.ch) +Date: Sep. 1, 2021

+
+ +Expand source code + +
#!/usr/bin/python
+
+"""
+    This module provides APIs to retrieve Housekeeping data from STIX data center  ,and some tools to display the data
+    Author: Hualin Xiao (hualin.xiao@fhnw.ch)
+    Date: Sep. 1, 2021
+
+"""
+import pandas as pd
+from astropy.io import fits
+from matplotlib import pyplot as plt
+
+from stixdcpy import io as sio
+from stixdcpy import time as sdt
+from stixdcpy.net import JSONRequest as jreq
+
+
+class Housekeeping(sio.IO):
+    def __init__(self, data):
+        data['datetime'] = [sdt.utc2datetime(x) for x in data['time']]
+        self.data = data
+        self.param_names = self.data['names']
+
+    @classmethod
+    def from_sdc(cls, start_utc: str, end_utc: str):
+        """
+            Fetch housekeeping data from server
+            Parameters
+            start_utc: str
+                data start time 
+            end_utc: str
+                data end time 
+            Returns:
+            housekeeping data object
+
+        """
+        data = jreq.fetch_housekeeping(start_utc, end_utc)
+        return cls(data)
+
+    def plot(self, parameters, which='eng', ax=None):
+        """
+        Plot a housekeeping parameter
+        Parameters
+        param: str
+          parameter name
+        which: str
+          what parameter to plot. It can be 'raw' or 'eng'
+        ax: matplotlib axes, optional
+          a plot will be created if it is not specified
+        Returns:
+        ax:  matplotlib axes
+        """
+        params = parameters.split(',')
+        if not ax:
+            _, ax = plt.subplots()
+        key = 'raw_values' if which == 'raw' else 'eng_values'
+        for param in params:
+            if param not in self.data[key]:
+                raise KeyError('Invalid housekeeping parameter name')
+            ax.plot(self.data['datetime'],
+                    self.data[key][param],
+                    label=self.data['names'].get(param, ''))
+        ax.set_xlabel('UTC')
+        ax.set_ylabel('Value')
+        return ax
+
+    def __getattr__(self, name):
+        if name == 'data':
+            return self.data
+
+    def get_data(self):
+        return self.data
+
+    def peek(self, ax=None, legend_loc='upper right'):
+        if not ax:
+            _, ax = plt.subplots()
+        ax.plot(self.data['datetime'], self.data['eng_values']['NIX00081'])
+        ax.set_title(self.data['names']['NIX00081'])
+        return ax
+
+
+
+
+
+
+
+
+
+

Classes

+
+
+class Housekeeping +(data) +
+
+

Base object

+
+ +Expand source code + +
class Housekeeping(sio.IO):
+    def __init__(self, data):
+        data['datetime'] = [sdt.utc2datetime(x) for x in data['time']]
+        self.data = data
+        self.param_names = self.data['names']
+
+    @classmethod
+    def from_sdc(cls, start_utc: str, end_utc: str):
+        """
+            Fetch housekeeping data from server
+            Parameters
+            start_utc: str
+                data start time 
+            end_utc: str
+                data end time 
+            Returns:
+            housekeeping data object
+
+        """
+        data = jreq.fetch_housekeeping(start_utc, end_utc)
+        return cls(data)
+
+    def plot(self, parameters, which='eng', ax=None):
+        """
+        Plot a housekeeping parameter
+        Parameters
+        param: str
+          parameter name
+        which: str
+          what parameter to plot. It can be 'raw' or 'eng'
+        ax: matplotlib axes, optional
+          a plot will be created if it is not specified
+        Returns:
+        ax:  matplotlib axes
+        """
+        params = parameters.split(',')
+        if not ax:
+            _, ax = plt.subplots()
+        key = 'raw_values' if which == 'raw' else 'eng_values'
+        for param in params:
+            if param not in self.data[key]:
+                raise KeyError('Invalid housekeeping parameter name')
+            ax.plot(self.data['datetime'],
+                    self.data[key][param],
+                    label=self.data['names'].get(param, ''))
+        ax.set_xlabel('UTC')
+        ax.set_ylabel('Value')
+        return ax
+
+    def __getattr__(self, name):
+        if name == 'data':
+            return self.data
+
+    def get_data(self):
+        return self.data
+
+    def peek(self, ax=None, legend_loc='upper right'):
+        if not ax:
+            _, ax = plt.subplots()
+        ax.plot(self.data['datetime'], self.data['eng_values']['NIX00081'])
+        ax.set_title(self.data['names']['NIX00081'])
+        return ax
+
+

Ancestors

+ +

Static methods

+
+
+def from_sdc(start_utc: str, end_utc: str) +
+
+

Fetch housekeeping data from server +Parameters +start_utc: str +data start time +end_utc: str +data end time +Returns: +housekeeping data object

+
+ +Expand source code + +
@classmethod
+def from_sdc(cls, start_utc: str, end_utc: str):
+    """
+        Fetch housekeeping data from server
+        Parameters
+        start_utc: str
+            data start time 
+        end_utc: str
+            data end time 
+        Returns:
+        housekeeping data object
+
+    """
+    data = jreq.fetch_housekeeping(start_utc, end_utc)
+    return cls(data)
+
+
+
+

Methods

+
+
+def get_data(self) +
+
+
+
+ +Expand source code + +
def get_data(self):
+    return self.data
+
+
+
+def peek(self, ax=None, legend_loc='upper right') +
+
+
+
+ +Expand source code + +
def peek(self, ax=None, legend_loc='upper right'):
+    if not ax:
+        _, ax = plt.subplots()
+    ax.plot(self.data['datetime'], self.data['eng_values']['NIX00081'])
+    ax.set_title(self.data['names']['NIX00081'])
+    return ax
+
+
+
+def plot(self, parameters, which='eng', ax=None) +
+
+

Plot a housekeeping parameter +Parameters +param: str +parameter name +which: str +what parameter to plot. It can be 'raw' or 'eng' +ax: matplotlib axes, optional +a plot will be created if it is not specified +Returns: +ax: +matplotlib axes

+
+ +Expand source code + +
def plot(self, parameters, which='eng', ax=None):
+    """
+    Plot a housekeeping parameter
+    Parameters
+    param: str
+      parameter name
+    which: str
+      what parameter to plot. It can be 'raw' or 'eng'
+    ax: matplotlib axes, optional
+      a plot will be created if it is not specified
+    Returns:
+    ax:  matplotlib axes
+    """
+    params = parameters.split(',')
+    if not ax:
+        _, ax = plt.subplots()
+    key = 'raw_values' if which == 'raw' else 'eng_values'
+    for param in params:
+        if param not in self.data[key]:
+            raise KeyError('Invalid housekeeping parameter name')
+        ax.plot(self.data['datetime'],
+                self.data[key][param],
+                label=self.data['names'].get(param, ''))
+    ax.set_xlabel('UTC')
+    ax.set_ylabel('Value')
+    return ax
+
+
+
+

Inherited members

+ +
+
+
+
+ +
+ + + \ No newline at end of file diff --git a/docs/stixdcpy/index.html b/docs/stixdcpy/index.html new file mode 100644 index 0000000..e3cf0d5 --- /dev/null +++ b/docs/stixdcpy/index.html @@ -0,0 +1,144 @@ + + + + + + +stixdcpy API documentation + + + + + + + + + + + +
+
+
+

Package stixdcpy

+
+
+
+
+

Sub-modules

+
+
stixdcpy.ancillary
+
+

This module provides APIs to retrieve Quick-look data from STIX data center +,and some tools to display the data +Author: Hualin Xiao …

+
+
stixdcpy.cfl
+
+
+
+
stixdcpy.correction
+
+

This module provides algorithms to correct detector effects +Author: Hualin Xiao (hualin.xiao@fhnw.ch) +Date: Sep. 1, 2021

+
+
stixdcpy.detector_view
+
+
+
+
stixdcpy.energylut
+
+

This script provides APIs to retrieve energy +calibration data from STIX data center +,and some tools to display the data +Author: Hualin Xiao …

+
+
stixdcpy.housekeeping
+
+

This module provides APIs to retrieve Housekeeping data from STIX data center +,and some tools to display the data +Author: Hualin Xiao …

+
+
stixdcpy.instrument
+
+
+
+
stixdcpy.io
+
+
+
+
stixdcpy.logger
+
+
+
+
stixdcpy.net
+
+

This module provides APIs to retrieve data from STIX data center +Author: Hualin Xiao (hualin.xiao@fhnw.ch) +Date: Sep. 1, 2021

+
+
stixdcpy.quicklook
+
+

This module provides APIs to retrieve Quick-look data from STIX data center +,and some tools to display the data +Author: Hualin Xiao …

+
+
stixdcpy.science
+
+

This module provides APIs to retrieve Quick-look data from STIX data center , and provides tools to display the data +Author: Hualin Xiao …

+
+
stixdcpy.time
+
+
+
+
stixdcpy.transmission
+
+

calculation of stix transmission, taken from stixcore

+
+
stixdcpy.transmission_backup
+
+
+
+
+
+
+
+
+
+
+
+
+ +
+ + + \ No newline at end of file diff --git a/docs/stixdcpy/instrument.html b/docs/stixdcpy/instrument.html new file mode 100644 index 0000000..a441751 --- /dev/null +++ b/docs/stixdcpy/instrument.html @@ -0,0 +1,1673 @@ + + + + + + +stixdcpy.instrument API documentation + + + + + + + + + + + +
+
+
+

Module stixdcpy.instrument

+
+
+
+ +Expand source code + +
import math
+
+import numpy as np
+
+nominal_grid_parameters = {
+    "1": {
+        "Label": "3c",
+        "SlitWidth": 0.0419,
+        "FrontPitch": 0.078039,
+        "FrontOrient": 169.9559,
+        "RearPitch": 0.077364,
+        "RearOrient": 170.0437,
+        "PitchToler": 0.0000245,
+        "OrientToler": 0.0181,
+        "BridgePitch": 1.13,
+        "BridgeOrient": 80,
+        "BridgeWidth": 0.05
+    },
+    "2": {
+        "Label": "5c",
+        "SlitWidth": 0.0825,
+        "FrontPitch": 0.158078,
+        "FrontOrient": 130.3942,
+        "RearPitch": 0.159925,
+        "RearOrient": 129.6012,
+        "PitchToler": 0.000103,
+        "OrientToler": 0.037,
+        "BridgePitch": 1.97,
+        "BridgeOrient": 40,
+        "BridgeWidth": 0.05
+    },
+    "3": {
+        "Label": "10a",
+        "SlitWidth": 0.4793,
+        "FrontPitch": 0.909644,
+        "FrontOrient": 151.4808,
+        "RearPitch": 0.999045,
+        "RearOrient": 148.3736,
+        "PitchToler": 0.00368,
+        "OrientToler": 0.222,
+        "BridgePitch": "NA",
+        "BridgeOrient": "NA",
+        "BridgeWidth": "NA"
+    },
+    "4": {
+        "Label": "8c",
+        "SlitWidth": 0.2358,
+        "FrontPitch": 0.461187,
+        "FrontOrient": 68.589,
+        "RearPitch": 0.469602,
+        "RearOrient": 71.4367,
+        "PitchToler": 0.000879,
+        "OrientToler": 0.108,
+        "BridgePitch": 3.15,
+        "BridgeOrient": 160,
+        "BridgeWidth": 0.05
+    },
+    "5": {
+        "Label": "4b",
+        "SlitWidth": 0.0586,
+        "FrontPitch": 0.110594,
+        "FrontOrient": 29.82,
+        "RearPitch": 0.111811,
+        "RearOrient": 30.182,
+        "PitchToler": 0.0000502,
+        "OrientToler": 0.0259,
+        "BridgePitch": 1.69,
+        "BridgeOrient": 120,
+        "BridgeWidth": 0.05
+    },
+    "6": {
+        "Label": "5a",
+        "SlitWidth": 0.0825,
+        "FrontPitch": 0.158505,
+        "FrontOrient": 69.5151,
+        "RearPitch": 0.159487,
+        "RearOrient": 70.4879,
+        "PitchToler": 0.000103,
+        "OrientToler": 0.037,
+        "BridgePitch": 1.58,
+        "BridgeOrient": 160,
+        "BridgeWidth": 0.05
+    },
+    "7": {
+        "Label": "3a",
+        "SlitWidth": 0.0419,
+        "FrontPitch": 0.077582,
+        "FrontOrient": 110.2373,
+        "RearPitch": 0.077817,
+        "RearOrient": 109.7619,
+        "PitchToler": 0.0000245,
+        "OrientToler": 0.0181,
+        "BridgePitch": 1.05,
+        "BridgeOrient": 20,
+        "BridgeWidth": 0.05
+    },
+    "8": {
+        "Label": "7b",
+        "SlitWidth": 0.1657,
+        "FrontPitch": 0.320259,
+        "FrontOrient": 150.5213,
+        "RearPitch": 0.33068,
+        "RearOrient": 149.4617,
+        "PitchToler": 0.00043,
+        "OrientToler": 0.0757,
+        "BridgePitch": 2.66,
+        "BridgeOrient": 60,
+        "BridgeWidth": 0.05
+    },
+    "9": {
+        "Label": "CFL",
+        "SlitWidth": "NA",
+        "FrontPitch": "NA",
+        "FrontOrient": "NA",
+        "RearPitch": "NA",
+        "RearOrient": "NA",
+        "PitchToler": "NA",
+        "OrientToler": "NA",
+        "BridgePitch": "NA",
+        "BridgeOrient": "NA",
+        "BridgeWidth": "NA"
+    },
+    "10": {
+        "Label": "BKG",
+        "SlitWidth": "NA",
+        "FrontPitch": "NA",
+        "FrontOrient": "NA",
+        "RearPitch": "NA",
+        "RearOrient": "NA",
+        "PitchToler": "NA",
+        "OrientToler": "NA",
+        "BridgePitch": "NA",
+        "BridgeOrient": "NA",
+        "BridgeWidth": "NA"
+    },
+    "11": {
+        "Label": "1a",
+        "SlitWidth": 0.022,
+        "FrontPitch": 0.037929,
+        "FrontOrient": 150.0617,
+        "RearPitch": 0.038071,
+        "RearOrient": 149.938,
+        "PitchToler": 0.00000586,
+        "OrientToler": 0.00884,
+        "BridgePitch": 1.1,
+        "BridgeOrient": 60,
+        "BridgeWidth": 0.05
+    },
+    "12": {
+        "Label": "2a",
+        "SlitWidth": 0.0302,
+        "FrontPitch": 0.054408,
+        "FrontOrient": 129.8643,
+        "RearPitch": 0.054192,
+        "RearOrient": 130.1351,
+        "PitchToler": 0.000012,
+        "OrientToler": 0.0126,
+        "BridgePitch": 1.18,
+        "BridgeOrient": 40,
+        "BridgeWidth": 0.05
+    },
+    "13": {
+        "Label": "1b",
+        "SlitWidth": 0.022,
+        "FrontPitch": 0.038,
+        "FrontOrient": 90.1237,
+        "RearPitch": 0.038,
+        "RearOrient": 89.8763,
+        "PitchToler": 0.00000586,
+        "OrientToler": 0.00884,
+        "BridgePitch": 1.1,
+        "BridgeOrient": 0,
+        "BridgeWidth": 0.05
+    },
+    "14": {
+        "Label": "9b",
+        "SlitWidth": 0.336,
+        "FrontPitch": 0.674193,
+        "FrontOrient": 107.9371,
+        "RearPitch": 0.656988,
+        "RearOrient": 112.0102,
+        "PitchToler": 0.0018,
+        "OrientToler": 0.155,
+        "BridgePitch": "NA",
+        "BridgeOrient": "NA",
+        "BridgeWidth": "NA"
+    },
+    "15": {
+        "Label": "6a",
+        "SlitWidth": 0.1168,
+        "FrontPitch": 0.229395,
+        "FrontOrient": 50.5721,
+        "RearPitch": 0.225614,
+        "RearOrient": 49.4374,
+        "PitchToler": 0.00021,
+        "OrientToler": 0.0529,
+        "BridgePitch": 1.97,
+        "BridgeOrient": 140,
+        "BridgeWidth": 0.05
+    },
+    "16": {
+        "Label": "9a",
+        "SlitWidth": 0.336,
+        "FrontPitch": 0.641967,
+        "FrontOrient": 170.3629,
+        "RearPitch": 0.691656,
+        "RearOrient": 169.609,
+        "PitchToler": 0.0018,
+        "OrientToler": 0.155,
+        "BridgePitch": "NA",
+        "BridgeOrient": "NA",
+        "BridgeWidth": "NA"
+    },
+    "17": {
+        "Label": "2c",
+        "SlitWidth": 0.0302,
+        "FrontPitch": 0.054136,
+        "FrontOrient": 9.9694,
+        "RearPitch": 0.054465,
+        "RearOrient": 10.0308,
+        "PitchToler": 0.000012,
+        "OrientToler": 0.0126,
+        "BridgePitch": 1.13,
+        "BridgeOrient": 100,
+        "BridgeWidth": 0.05
+    },
+    "18": {
+        "Label": "1c",
+        "SlitWidth": 0.022,
+        "FrontPitch": 0.037929,
+        "FrontOrient": 29.9383,
+        "RearPitch": 0.038071,
+        "RearOrient": 30.062,
+        "PitchToler": 0.00000586,
+        "OrientToler": 0.00884,
+        "BridgePitch": 1.1,
+        "BridgeOrient": 120,
+        "BridgeWidth": 0.05
+    },
+    "19": {
+        "Label": "2b",
+        "SlitWidth": 0.0302,
+        "FrontPitch": 0.054357,
+        "FrontOrient": 70.1663,
+        "RearPitch": 0.054243,
+        "RearOrient": 69.8341,
+        "PitchToler": 0.000012,
+        "OrientToler": 0.0126,
+        "BridgePitch": 1.05,
+        "BridgeOrient": 160,
+        "BridgeWidth": 0.05
+    },
+    "20": {
+        "Label": "10b",
+        "SlitWidth": 0.4793,
+        "FrontPitch": 0.951208,
+        "FrontOrient": 86.9019,
+        "RearPitch": 0.951208,
+        "RearOrient": 93.0981,
+        "PitchToler": 0.00368,
+        "OrientToler": 0.222,
+        "BridgePitch": "NA",
+        "BridgeOrient": "NA",
+        "BridgeWidth": "NA"
+    },
+    "21": {
+        "Label": "8a",
+        "SlitWidth": 0.2358,
+        "FrontPitch": 0.453678,
+        "FrontOrient": 9.7435,
+        "RearPitch": 0.477944,
+        "RearOrient": 10.2702,
+        "PitchToler": 0.000879,
+        "OrientToler": 0.108,
+        "BridgePitch": 3.02,
+        "BridgeOrient": 100,
+        "BridgeWidth": 0.05
+    },
+    "22": {
+        "Label": "10c",
+        "SlitWidth": 0.4793,
+        "FrontPitch": 0.909644,
+        "FrontOrient": 28.5192,
+        "RearPitch": 0.999045,
+        "RearOrient": 31.6264,
+        "PitchToler": 0.00368,
+        "OrientToler": 0.222,
+        "BridgePitch": "NA",
+        "BridgeOrient": "NA",
+        "BridgeWidth": "NA"
+    },
+    "23": {
+        "Label": "4c",
+        "SlitWidth": 0.0586,
+        "FrontPitch": 0.110594,
+        "FrontOrient": 150.18,
+        "RearPitch": 0.111811,
+        "RearOrient": 149.818,
+        "PitchToler": 0.0000502,
+        "OrientToler": 0.0259,
+        "BridgePitch": 1.69,
+        "BridgeOrient": 60,
+        "BridgeWidth": 0.05
+    },
+    "24": {
+        "Label": "7a",
+        "SlitWidth": 0.1657,
+        "FrontPitch": 0.320259,
+        "FrontOrient": 29.4787,
+        "RearPitch": 0.33068,
+        "RearOrient": 30.5383,
+        "PitchToler": 0.00043,
+        "OrientToler": 0.0757,
+        "BridgePitch": 2.66,
+        "BridgeOrient": 120,
+        "BridgeWidth": 0.05
+    },
+    "25": {
+        "Label": "4a",
+        "SlitWidth": 0.0586,
+        "FrontPitch": 0.111198,
+        "FrontOrient": 89.638,
+        "RearPitch": 0.111198,
+        "RearOrient": 90.362,
+        "PitchToler": 0.0000502,
+        "OrientToler": 0.0259,
+        "BridgePitch": 1.1,
+        "BridgeOrient": 0,
+        "BridgeWidth": 0.05
+    },
+    "26": {
+        "Label": "8b",
+        "SlitWidth": 0.2358,
+        "FrontPitch": 0.457628,
+        "FrontOrient": 131.1413,
+        "RearPitch": 0.47345,
+        "RearOrient": 128.8192,
+        "PitchToler": 0.000879,
+        "OrientToler": 0.108,
+        "BridgePitch": 2.95,
+        "BridgeOrient": 40,
+        "BridgeWidth": 0.05
+    },
+    "27": {
+        "Label": "6b",
+        "SlitWidth": 0.1168,
+        "FrontPitch": 0.230433,
+        "FrontOrient": 169.8697,
+        "RearPitch": 0.22464,
+        "RearOrient": 170.127,
+        "PitchToler": 0.00021,
+        "OrientToler": 0.0529,
+        "BridgePitch": 2.28,
+        "BridgeOrient": 80,
+        "BridgeWidth": 0.05
+    },
+    "28": {
+        "Label": "7c",
+        "SlitWidth": 0.1657,
+        "FrontPitch": 0.325344,
+        "FrontOrient": 91.0592,
+        "RearPitch": 0.325344,
+        "RearOrient": 88.9408,
+        "PitchToler": 0.00043,
+        "OrientToler": 0.0757,
+        "BridgePitch": 2.2,
+        "BridgeOrient": 0,
+        "BridgeWidth": 0.05
+    },
+    "29": {
+        "Label": "3b",
+        "SlitWidth": 0.0419,
+        "FrontPitch": 0.077921,
+        "FrontOrient": 50.1943,
+        "RearPitch": 0.07748,
+        "RearOrient": 49.8068,
+        "PitchToler": 0.0000245,
+        "OrientToler": 0.0181,
+        "BridgePitch": 1.18,
+        "BridgeOrient": 140,
+        "BridgeWidth": 0.05
+    },
+    "30": {
+        "Label": "5b",
+        "SlitWidth": 0.0825,
+        "FrontPitch": 0.160427,
+        "FrontOrient": 10.0907,
+        "RearPitch": 0.157598,
+        "RearOrient": 9.9109,
+        "PitchToler": 0.000103,
+        "OrientToler": 0.037,
+        "BridgePitch": 1.81,
+        "BridgeOrient": 100,
+        "BridgeWidth": 0.05
+    },
+    "31": {
+        "Label": "6c",
+        "SlitWidth": 0.1168,
+        "FrontPitch": 0.228493,
+        "FrontOrient": 109.301,
+        "RearPitch": 0.226482,
+        "RearOrient": 110.6929,
+        "PitchToler": 0.00021,
+        "OrientToler": 0.0529,
+        "BridgePitch": 2.07,
+        "BridgeOrient": 20,
+        "BridgeWidth": 0.05
+    },
+    "32": {
+        "Label": "9c",
+        "SlitWidth": 0.336,
+        "FrontPitch": 0.682197,
+        "FrontOrient": 51.7015,
+        "RearPitch": 0.64983,
+        "RearOrient": 48.3792,
+        "PitchToler": 0.0018,
+        "OrientToler": 0.155,
+        "BridgePitch": "NA",
+        "BridgeOrient": "NA",
+        "BridgeWidth": "NA"
+    },
+    "33": {
+        "Label": "dummy",
+        "SlitWidth": 0.0302 * 0.5,
+        "FrontPitch": 0.054136 * 0.5,
+        "FrontOrient": 9.9694,
+        "RearPitch": 0.054465 * .5,
+        "RearOrient": 10.0308,
+        "PitchToler": 0.000012,
+        "OrientToler": 0.0126,
+        "BridgePitch": 1.13,
+        "BridgeOrient": 100,
+        "BridgeWidth": 0.05
+    },
+    '34': {
+        "Label": "9c",
+        "SlitWidth": 0.5,
+        "FrontPitch": 1,
+        "FrontOrient": 90,
+        "RearPitch": 1,
+        "RearOrient": 90,
+        "PitchToler": 0,
+        "OrientToler": 0,
+        "BridgePitch": "NA",
+        "BridgeOrient": "NA",
+        "BridgeWidth": "NA"
+    },
+    "units": {
+        "SlitWidth": "mm",
+        "FrontPitch": "mm",
+        "FrontOrient": "deg",
+        "RearPitch": "mm",
+        "RearOrient": "deg",
+        "PitchToler": "mm",
+        "OrientToler": "deg",
+        "BridgePitch": "mm",
+        "BridgeOrient": "deg",
+        "BridgeWidth": "mm",
+        "AvgOrient": 'deg',
+        'AngRes': 'arcsec',
+        'Pitch': 'mm',
+    },
+}
+# data from matj
+real_grid_parameters = {
+    "1": {
+        "FrontPitch": 0.07805,
+        "FrontOrient": 169.977,
+        "FrontPhase": 0.0048,
+        "FrontSlitWidth": 0.0457,
+        "FrontSlitGradient": 0.0009,
+        "FrontRMS": 0.0012,
+        "FrontThickness": 0.3538,
+        "FrontBridgeWidth": 0.0433,
+        "FrontBridgePitch": 1.130299,
+        "RearPitch": 0.077388,
+        "RearOrient": 170.037,
+        "RearPhase": 0.0173,
+        "RearSlitWidth": 0.0507,
+        "RearSlitGradient": 0.0007,
+        "RearRMS": 0.0011,
+        "RearThickness": 0.3628,
+        "RearBridgeWidth": 0.0398,
+        "RearBridgePitch": 1.130199
+    },
+    "2": {
+        "FrontPitch": 0.158102,
+        "FrontOrient": 130.406,
+        "FrontPhase": 0.1136,
+        "FrontSlitWidth": 0.07645,
+        "FrontSlitGradient": 0.0008,
+        "FrontRMS": 0.0009,
+        "FrontThickness": 0.3897,
+        "FrontBridgeWidth": 0.0587,
+        "FrontBridgePitch": 1.970416,
+        "RearPitch": 0.159965,
+        "RearOrient": 129.588,
+        "RearPhase": 0.1497,
+        "RearSlitWidth": 0.0806,
+        "RearSlitGradient": 0.0004,
+        "RearRMS": 0.0008,
+        "RearThickness": 0.3901,
+        "RearBridgeWidth": 0.0543,
+        "RearBridgePitch": 1.970729
+    },
+    "3": {
+        "FrontPitch": 0.909818,
+        "FrontOrient": 151.503,
+        "FrontPhase": 0.1114,
+        "FrontSlitWidth": 0.4811,
+        "FrontSlitGradient": 0.0008,
+        "FrontRMS": 0.0014,
+        "FrontThickness": 0.4413,
+        "FrontBridgeWidth": 0,
+        "FrontBridgePitch": 0,
+        "RearPitch": 0.999226,
+        "RearOrient": 148.373,
+        "RearPhase": 0.086,
+        "RearSlitWidth": 0.492,
+        "RearSlitGradient": 0.0026,
+        "RearRMS": 0.0011,
+        "RearThickness": 0.421,
+        "RearBridgeWidth": 0,
+        "RearBridgePitch": 0
+    },
+    "4": {
+        "FrontPitch": 0.46131,
+        "FrontOrient": 68.608,
+        "FrontPhase": 0.1562,
+        "FrontSlitWidth": 0.2352,
+        "FrontSlitGradient": 0.0004,
+        "FrontRMS": 0.0011,
+        "FrontThickness": 0.4171,
+        "FrontBridgeWidth": 0.0426,
+        "FrontBridgePitch": 3.150334,
+        "RearPitch": 0.469697,
+        "RearOrient": 71.434,
+        "RearPhase": 0.456,
+        "RearSlitWidth": 0.2431,
+        "RearSlitGradient": 0.0029,
+        "RearRMS": 0.001,
+        "RearThickness": 0.3922,
+        "RearBridgeWidth": 0.0416,
+        "RearBridgePitch": 3.150274
+    },
+    "5": {
+        "FrontPitch": 0.110609,
+        "FrontOrient": 29.839,
+        "FrontPhase": 0.0102,
+        "FrontSlitWidth": 0.0566,
+        "FrontSlitGradient": 0.0009,
+        "FrontRMS": 0.0008,
+        "FrontThickness": 0.3813,
+        "FrontBridgeWidth": 0.5,
+        "FrontBridgePitch": 1.65,
+        "RearPitch": 0.111831,
+        "RearOrient": 30.18,
+        "RearPhase": 0.0497,
+        "RearSlitWidth": 0.0623,
+        "RearSlitGradient": 0.0005,
+        "RearRMS": 0.0009,
+        "RearThickness": 0.4082,
+        "RearBridgeWidth": 0.0378,
+        "RearBridgePitch": 1.690653
+    },
+    "6": {
+        "FrontPitch": 0.15853,
+        "FrontOrient": 69.527,
+        "FrontPhase": 0.0247,
+        "FrontSlitWidth": 0.0741,
+        "FrontSlitGradient": 0.0007,
+        "FrontRMS": 0.0007,
+        "FrontThickness": 0.3924,
+        "FrontBridgeWidth": 0.0618,
+        "FrontBridgePitch": 1.580188,
+        "RearPitch": 0.159539,
+        "RearOrient": 70.48,
+        "RearPhase": 0.0086,
+        "RearSlitWidth": 0.0849,
+        "RearSlitGradient": 0.0006,
+        "RearRMS": 0.0007,
+        "RearThickness": 0.4226,
+        "RearBridgeWidth": 0.0582,
+        "RearBridgePitch": 1.580039
+    },
+    "7": {
+        "FrontPitch": 0.077594,
+        "FrontOrient": 110.252,
+        "FrontPhase": 0.0195,
+        "FrontSlitWidth": 0.0465,
+        "FrontSlitGradient": 0.0019,
+        "FrontRMS": 0.0009,
+        "FrontThickness": 0.374,
+        "FrontBridgeWidth": 0.0422,
+        "FrontBridgePitch": 1.050062,
+        "RearPitch": 0.077834,
+        "RearOrient": 109.754,
+        "RearPhase": 0.0388,
+        "RearSlitWidth": 0.0534,
+        "RearSlitGradient": 0.0012,
+        "RearRMS": 0.0007,
+        "RearThickness": 0.3896,
+        "RearBridgeWidth": 0.0399,
+        "RearBridgePitch": 1.050446
+    },
+    "8": {
+        "FrontPitch": 0.32033,
+        "FrontOrient": 150.541,
+        "FrontPhase": 0.0178,
+        "FrontSlitWidth": 0.1589,
+        "FrontSlitGradient": 0.0006,
+        "FrontRMS": 0.0008,
+        "FrontThickness": 0.405,
+        "FrontBridgeWidth": 0.0441,
+        "FrontBridgePitch": 2.661093,
+        "RearPitch": 0.330751,
+        "RearOrient": 149.46,
+        "RearPhase": 0.3021,
+        "RearSlitWidth": 0.1712,
+        "RearSlitGradient": 0.001,
+        "RearRMS": 0.0009,
+        "RearThickness": 0.3805,
+        "RearBridgeWidth": 0.0434,
+        "RearBridgePitch": 2.660393
+    },
+    "9": {
+        "FrontPitch": "CFL",
+        "FrontOrient": "CFL",
+        "FrontPhase": "CFL",
+        "FrontSlitWidth": "CFL",
+        "FrontSlitGradient": "CFL",
+        "FrontRMS": "CFL",
+        "FrontThickness": "CFL",
+        "FrontBridgeWidth": "CFL",
+        "FrontBridgePitch": "CFL",
+        "RearPitch": "CFL",
+        "RearOrient": "CFL",
+        "RearPhase": "CFL",
+        "RearSlitWidth": "CFL",
+        "RearSlitGradient": "CFL",
+        "RearRMS": "CFL",
+        "RearThickness": "CFL",
+        "RearBridgeWidth": "CFL",
+        "RearBridgePitch": "CFL"
+    },
+    "10": {
+        "FrontPitch": "BKG",
+        "FrontOrient": "BKG",
+        "FrontPhase": "BKG",
+        "FrontSlitWidth": "BKG",
+        "FrontSlitGradient": "BKG",
+        "FrontRMS": "BKG",
+        "FrontThickness": "BKG",
+        "FrontBridgeWidth": "BKG",
+        "FrontBridgePitch": "BKG",
+        "RearPitch": "BKG",
+        "RearOrient": "BKG",
+        "RearPhase": "BKG",
+        "RearSlitWidth": "BKG",
+        "RearSlitGradient": "BKG",
+        "RearRMS": "BKG",
+        "RearThickness": "BKG",
+        "RearBridgeWidth": "BKG",
+        "RearBridgePitch": "BKG"
+    },
+    "11": {
+        "FrontPitch": 0.113799,
+        "FrontOrient": 150.076,
+        "FrontPhase": 0.0147,
+        "FrontSlitWidth": 0.0934,
+        "FrontSlitGradient": 0.0013,
+        "FrontRMS": 0.0011,
+        "FrontThickness": "Non-recov.",
+        "FrontBridgeWidth": 0.0464,
+        "FrontBridgePitch": 1.099888,
+        "RearPitch": 0.114224,
+        "RearOrient": 149.93,
+        "RearPhase": 0.0668,
+        "RearSlitWidth": 0.0971,
+        "RearSlitGradient": 0.0004,
+        "RearRMS": 0.0011,
+        "RearThickness": "Non-recov.",
+        "RearBridgeWidth": 0.0495,
+        "RearBridgePitch": 1.100279
+    },
+    "15": {
+        "FrontPitch": 0.229421,
+        "FrontOrient": 50.582,
+        "FrontPhase": 0.0469,
+        "FrontSlitWidth": 0.1094,
+        "FrontSlitGradient": 0.0014,
+        "FrontRMS": 0.0016,
+        "FrontThickness": 0.3819,
+        "FrontBridgeWidth": 0.0516,
+        "FrontBridgePitch": 1.970634,
+        "RearPitch": 0.225653,
+        "RearOrient": 49.427,
+        "RearPhase": 0.0326,
+        "RearSlitWidth": 0.1155,
+        "RearSlitGradient": 0.002,
+        "RearRMS": 0.0014,
+        "RearThickness": 0.3787,
+        "RearBridgeWidth": 0.0527,
+        "RearBridgePitch": 1.970511
+    },
+    "16": {
+        "FrontPitch": 0.642102,
+        "FrontOrient": 170.393,
+        "FrontPhase": 0.0152,
+        "FrontSlitWidth": 0.3364,
+        "FrontSlitGradient": 0.0031,
+        "FrontRMS": 0.0014,
+        "FrontThickness": 0.4011,
+        "FrontBridgeWidth": 0,
+        "FrontBridgePitch": 0,
+        "RearPitch": 0.691758,
+        "RearOrient": 169.609,
+        "RearPhase": 0.3612,
+        "RearSlitWidth": 0.3451,
+        "RearSlitGradient": 0.0021,
+        "RearRMS": 0.0011,
+        "RearThickness": 0.4053,
+        "RearBridgeWidth": 0,
+        "RearBridgePitch": 0
+    },
+    "20": {
+        "FrontPitch": 0.951346,
+        "FrontOrient": 86.916,
+        "FrontPhase": 0.913,
+        "FrontSlitWidth": 0.4903,
+        "FrontSlitGradient": 0.0017,
+        "FrontRMS": 0.0012,
+        "FrontThickness": 0.4375,
+        "FrontBridgeWidth": 0,
+        "FrontBridgePitch": 0,
+        "RearPitch": 0.951412,
+        "RearOrient": 93.105,
+        "RearPhase": 0.2194,
+        "RearSlitWidth": 0.492,
+        "RearSlitGradient": 0.0039,
+        "RearRMS": 0.0014,
+        "RearThickness": 0.4052,
+        "RearBridgeWidth": 0,
+        "RearBridgePitch": 0
+    },
+    "21": {
+        "FrontPitch": 0.453733,
+        "FrontOrient": 9.763,
+        "FrontPhase": 0.1752,
+        "FrontSlitWidth": 0.2286,
+        "FrontSlitGradient": 0.0024,
+        "FrontRMS": 0.0019,
+        "FrontThickness": 0.3819,
+        "FrontBridgeWidth": 0.0463,
+        "FrontBridgePitch": 3.020667,
+        "RearPitch": 0.478018,
+        "RearOrient": 10.273,
+        "RearPhase": 0.4254,
+        "RearSlitWidth": 0.2415,
+        "RearSlitGradient": 0.0012,
+        "RearRMS": 0.0014,
+        "RearThickness": 0.3866,
+        "RearBridgeWidth": 0.0436,
+        "RearBridgePitch": 3.021032
+    },
+    "22": {
+        "FrontPitch": 0.909875,
+        "FrontOrient": 28.534,
+        "FrontPhase": 0.7453,
+        "FrontSlitWidth": 0.4781,
+        "FrontSlitGradient": 0.0009,
+        "FrontRMS": 0.0027,
+        "FrontThickness": 0.4153,
+        "FrontBridgeWidth": 0,
+        "FrontBridgePitch": 0,
+        "RearPitch": 0.999212,
+        "RearOrient": 31.621,
+        "RearPhase": 0.2162,
+        "RearSlitWidth": 0.4878,
+        "RearSlitGradient": 0.0026,
+        "RearRMS": 0.0016,
+        "RearThickness": 0.4144,
+        "RearBridgeWidth": 0,
+        "RearBridgePitch": 0
+    },
+    "23": {
+        "FrontPitch": 0.110621,
+        "FrontOrient": 150.188,
+        "FrontPhase": 0.0762,
+        "FrontSlitWidth": 0.0555,
+        "FrontSlitGradient": 0.001,
+        "FrontRMS": 0.0009,
+        "FrontThickness": 0.3714,
+        "FrontBridgeWidth": 0.0356,
+        "FrontBridgePitch": 1.690305,
+        "RearPitch": 0.111829,
+        "RearOrient": 149.804,
+        "RearPhase": 0.038,
+        "RearSlitWidth": 0.0624,
+        "RearSlitGradient": 0.0009,
+        "RearRMS": 0.0009,
+        "RearThickness": 0.3947,
+        "RearBridgeWidth": 0.0391,
+        "RearBridgePitch": 1.69002
+    },
+    "24": {
+        "FrontPitch": 0.320329,
+        "FrontOrient": 29.494,
+        "FrontPhase": 0.192,
+        "FrontSlitWidth": 0.1555,
+        "FrontSlitGradient": 0.001,
+        "FrontRMS": 0.0011,
+        "FrontThickness": 0.4183,
+        "FrontBridgeWidth": 0.0508,
+        "FrontBridgePitch": 2.660021,
+        "RearPitch": 0.330741,
+        "RearOrient": 30.534,
+        "RearPhase": 0.2552,
+        "RearSlitWidth": 0.1632,
+        "RearSlitGradient": 0.0005,
+        "RearRMS": 0.001,
+        "RearThickness": 0.4123,
+        "RearBridgeWidth": 0.0467,
+        "RearBridgePitch": 2.660331
+    },
+    "25": {
+        "FrontPitch": 0.111218,
+        "FrontOrient": 89.65,
+        "FrontPhase": 0.0078,
+        "FrontSlitWidth": 0.0575,
+        "FrontSlitGradient": 0.0009,
+        "FrontRMS": 0.0006,
+        "FrontThickness": 0.391,
+        "FrontBridgeWidth": 0.0386,
+        "FrontBridgePitch": 1.100597,
+        "RearPitch": 0.111216,
+        "RearOrient": 90.354,
+        "RearPhase": 0.1018,
+        "RearSlitWidth": 0.0626,
+        "RearSlitGradient": 0.0008,
+        "RearRMS": 0.0005,
+        "RearThickness": 0.3697,
+        "RearBridgeWidth": 0.042,
+        "RearBridgePitch": 1.09966
+    },
+    "26": {
+        "FrontPitch": 0.457701,
+        "FrontOrient": 131.16,
+        "FrontPhase": 0.1632,
+        "FrontSlitWidth": 0.2307,
+        "FrontSlitGradient": 0.0044,
+        "FrontRMS": 0.0014,
+        "FrontThickness": 0.3609,
+        "FrontBridgeWidth": 0.0492,
+        "FrontBridgePitch": 2.9513,
+        "RearPitch": 0.473501,
+        "RearOrient": 128.82,
+        "RearPhase": 0.3551,
+        "RearSlitWidth": 0.241,
+        "RearSlitGradient": 0.0057,
+        "RearRMS": 0.0015,
+        "RearThickness": 0.3879,
+        "RearBridgeWidth": 0.0399,
+        "RearBridgePitch": 2.949872
+    },
+    "27": {
+        "FrontPitch": 0.23049,
+        "FrontOrient": 169.887,
+        "FrontPhase": 0.0272,
+        "FrontSlitWidth": 0.1039,
+        "FrontSlitGradient": 0.0017,
+        "FrontRMS": 0.0016,
+        "FrontThickness": 0.3476,
+        "FrontBridgeWidth": 0.0568,
+        "FrontBridgePitch": 2.280569,
+        "RearPitch": 0.224674,
+        "RearOrient": 170.124,
+        "RearPhase": 0.2222,
+        "RearSlitWidth": 0.1155,
+        "RearSlitGradient": 0.0024,
+        "RearRMS": 0.0011,
+        "RearThickness": 0.3676,
+        "RearBridgeWidth": 0.0567,
+        "RearBridgePitch": 2.279257
+    },
+    "28": {
+        "FrontPitch": 0.32543,
+        "FrontOrient": 91.078,
+        "FrontPhase": 0.2984,
+        "FrontSlitWidth": 0.1679,
+        "FrontSlitGradient": 0.0006,
+        "FrontRMS": 0.0013,
+        "FrontThickness": 0.4149,
+        "FrontBridgeWidth": 0.0554,
+        "FrontBridgePitch": 2.200088,
+        "RearPitch": 0.325412,
+        "RearOrient": 88.938,
+        "RearPhase": 0.058,
+        "RearSlitWidth": 0.171,
+        "RearSlitGradient": 0.0014,
+        "RearRMS": 0.0015,
+        "RearThickness": 0.3852,
+        "RearBridgeWidth": 0.0521,
+        "RearBridgePitch": 2.200617
+    },
+    "29": {
+        "FrontPitch": 0.077934,
+        "FrontOrient": 50.203,
+        "FrontPhase": 0.0628,
+        "FrontSlitWidth": 0.046,
+        "FrontSlitGradient": 0.0011,
+        "FrontRMS": 0.0009,
+        "FrontThickness": 0.3597,
+        "FrontBridgeWidth": 0.0446,
+        "FrontBridgePitch": 1.180051,
+        "RearPitch": 0.077494,
+        "RearOrient": 49.798,
+        "RearPhase": 0.0494,
+        "RearSlitWidth": 0.0513,
+        "RearSlitGradient": 0.0005,
+        "RearRMS": 0.0007,
+        "RearThickness": 0.3546,
+        "RearBridgeWidth": 0.0357,
+        "RearBridgePitch": 1.180175
+    },
+    "30": {
+        "FrontPitch": 0.16043,
+        "FrontOrient": 10.117,
+        "FrontPhase": 0.0749,
+        "FrontSlitWidth": 0.0772,
+        "FrontSlitGradient": 0.0007,
+        "FrontRMS": 0.0011,
+        "FrontThickness": 0.3903,
+        "FrontBridgeWidth": 0.059,
+        "FrontBridgePitch": 1.810433,
+        "RearPitch": 0.157633,
+        "RearOrient": 9.911,
+        "RearPhase": 0.0927,
+        "RearSlitWidth": 0.0852,
+        "RearSlitGradient": 0.0008,
+        "RearRMS": 0.001,
+        "RearThickness": 0.3989,
+        "RearBridgeWidth": 0.0615,
+        "RearBridgePitch": 1.810039
+    },
+    "31": {
+        "FrontPitch": 0.228531,
+        "FrontOrient": 109.323,
+        "FrontPhase": 0.0969,
+        "FrontSlitWidth": 0.119,
+        "FrontSlitGradient": 0.0006,
+        "FrontRMS": 0.001,
+        "FrontThickness": 0.3838,
+        "FrontBridgeWidth": 0.0595,
+        "FrontBridgePitch": 2.070182,
+        "RearPitch": 0.226511,
+        "RearOrient": 110.694,
+        "RearPhase": 0.1825,
+        "RearSlitWidth": 0.115,
+        "RearSlitGradient": 0.001,
+        "RearRMS": 0.0013,
+        "RearThickness": 0.365,
+        "RearBridgeWidth": 0.0541,
+        "RearBridgePitch": 2.070283
+    },
+    "32": {
+        "FrontPitch": 0.682253,
+        "FrontOrient": 51.714,
+        "FrontPhase": 0.4855,
+        "FrontSlitWidth": 0.3384,
+        "FrontSlitGradient": 0.0018,
+        "FrontRMS": 0.0032,
+        "FrontThickness": 0.398,
+        "FrontBridgeWidth": 0,
+        "FrontBridgePitch": 0,
+        "RearPitch": 0.649947,
+        "RearOrient": 48.378,
+        "RearPhase": 0.3333,
+        "RearSlitWidth": 0.3421,
+        "RearSlitGradient": 0.0034,
+        "RearRMS": 0.0012,
+        "RearThickness": 0.3884,
+        "RearBridgeWidth": 0,
+        "RearBridgePitch": 0
+    },
+    "12a": {
+        "FrontPitch": 0.108817,
+        "FrontOrient": 129.883,
+        "FrontPhase": 0.059,
+        "FrontSlitWidth": 0.0795,
+        "FrontSlitGradient": 0.0014,
+        "FrontRMS": 0.001,
+        "FrontThickness": "Non-recov.",
+        "FrontBridgeWidth": 0.044,
+        "FrontBridgePitch": 1.180036,
+        "RearPitch": 0.108394,
+        "RearOrient": 130.131,
+        "RearPhase": 0.0542,
+        "RearSlitWidth": 0.0813,
+        "RearSlitGradient": 0.0003,
+        "RearRMS": 0.001,
+        "RearThickness": "Non-recov.",
+        "RearBridgeWidth": 0.0462,
+        "RearBridgePitch": 1.180239
+    },
+    "12b": {
+        "FrontPitch": 0.108825,
+        "FrontOrient": 129.879,
+        "FrontPhase": 0.0032,
+        "FrontSlitWidth": 0.0835,
+        "FrontSlitGradient": 0.0008,
+        "FrontRMS": 0.001,
+        "FrontThickness": "Non-recov.",
+        "FrontBridgeWidth": "",
+        "FrontBridgePitch": "",
+        "RearPitch": 0.108406,
+        "RearOrient": 130.131,
+        "RearPhase": 0.1026,
+        "RearSlitWidth": 0.081,
+        "RearSlitGradient": 0.0005,
+        "RearRMS": 0.001,
+        "RearThickness": "Non-recov.",
+        "RearBridgeWidth": "",
+        "RearBridgePitch": ""
+    },
+    "13a": {
+        "FrontPitch": 0.113998,
+        "FrontOrient": 90.143,
+        "FrontPhase": 0.0533,
+        "FrontSlitWidth": 0.0919,
+        "FrontSlitGradient": 0.0019,
+        "FrontRMS": 0.0009,
+        "FrontThickness": "Non-recov.",
+        "FrontBridgeWidth": "",
+        "FrontBridgePitch": "",
+        "RearPitch": 0.113995,
+        "RearOrient": 89.865,
+        "RearPhase": 0.0362,
+        "RearSlitWidth": 0.0915,
+        "RearSlitGradient": 0.0007,
+        "RearRMS": 0.0008,
+        "RearThickness": "Non-recov.",
+        "RearBridgeWidth": "",
+        "RearBridgePitch": ""
+    },
+    "13b": {
+        "FrontPitch": 0.114008,
+        "FrontOrient": 90.137,
+        "FrontPhase": 0.0121,
+        "FrontSlitWidth": 0.0867,
+        "FrontSlitGradient": 0.0008,
+        "FrontRMS": 0.0008,
+        "FrontThickness": "Non-recov.",
+        "FrontBridgeWidth": "",
+        "FrontBridgePitch": "",
+        "RearPitch": 0.114015,
+        "RearOrient": 89.862,
+        "RearPhase": 0.0658,
+        "RearSlitWidth": 0.0833,
+        "RearSlitGradient": 0.0009,
+        "RearRMS": 0.0009,
+        "RearThickness": "Non-recov.",
+        "RearBridgeWidth": "",
+        "RearBridgePitch": ""
+    },
+    "14c": {
+        "FrontPitch": 0.674276,
+        "FrontOrient": 107.955,
+        "FrontPhase": 0.0477,
+        "FrontSlitWidth": 0.3377,
+        "FrontSlitGradient": 0.0006,
+        "FrontRMS": 0.0016,
+        "FrontThickness": 0.4024,
+        "FrontBridgeWidth": 0,
+        "FrontBridgePitch": 0,
+        "RearPitch": 0.657124,
+        "RearOrient": 112.013,
+        "RearPhase": 0.2675,
+        "RearSlitWidth": 0.3455,
+        "RearSlitGradient": 0.0031,
+        "RearRMS": 0.0013,
+        "RearThickness": 0.3977,
+        "RearBridgeWidth": 0,
+        "RearBridgePitch": 0
+    },
+    "17a": {
+        "FrontPitch": 0.108278,
+        "FrontOrient": 9.995,
+        "FrontPhase": 0.1656,
+        "FrontSlitWidth": 0.0839,
+        "FrontSlitGradient": 0.0007,
+        "FrontRMS": 0.0012,
+        "FrontThickness": "Non-recov.",
+        "FrontBridgeWidth": 0.0544,
+        "FrontBridgePitch": 1.130375,
+        "RearPitch": 0.10894,
+        "RearOrient": 10.031,
+        "RearPhase": 0.1056,
+        "RearSlitWidth": 0.0861,
+        "RearSlitGradient": 0.0004,
+        "RearRMS": 0.001,
+        "RearThickness": "Non-recov.",
+        "RearBridgeWidth": 0.0594,
+        "RearBridgePitch": 1.129875
+    },
+    "17b": {
+        "FrontPitch": 0.108286,
+        "FrontOrient": 9.99,
+        "FrontPhase": 0.0569,
+        "FrontSlitWidth": 0.0852,
+        "FrontSlitGradient": 0.0008,
+        "FrontRMS": 0.0011,
+        "FrontThickness": "Non-recov.",
+        "FrontBridgeWidth": "",
+        "FrontBridgePitch": "",
+        "RearPitch": 0.108958,
+        "RearOrient": 10.034,
+        "RearPhase": 0.0523,
+        "RearSlitWidth": 0.0845,
+        "RearSlitGradient": 0.0005,
+        "RearRMS": 0.0009,
+        "RearThickness": "Non-recov.",
+        "RearBridgeWidth": "",
+        "RearBridgePitch": ""
+    },
+    "18a": {
+        "FrontPitch": 0.113806,
+        "FrontOrient": 29.957,
+        "FrontPhase": 0.0366,
+        "FrontSlitWidth": 0.0881,
+        "FrontSlitGradient": 0.002,
+        "FrontRMS": 0.0013,
+        "FrontThickness": "Non-recov.",
+        "FrontBridgeWidth": 0.0469,
+        "FrontBridgePitch": 1.100317,
+        "RearPitch": 0.114231,
+        "RearOrient": 30.058,
+        "RearPhase": 0.0923,
+        "RearSlitWidth": 0.0954,
+        "RearSlitGradient": 0.0007,
+        "RearRMS": 0.0013,
+        "RearThickness": "Non-recov.",
+        "RearBridgeWidth": 0.0506,
+        "RearBridgePitch": 1.100059
+    },
+    "18b": {
+        "FrontPitch": 0.113801,
+        "FrontOrient": 29.954,
+        "FrontPhase": 0.106,
+        "FrontSlitWidth": 0.0929,
+        "FrontSlitGradient": 0.0007,
+        "FrontRMS": 0.0011,
+        "FrontThickness": "Non-recov.",
+        "FrontBridgeWidth": "",
+        "FrontBridgePitch": "",
+        "RearPitch": 0.11422,
+        "RearOrient": 30.063,
+        "RearPhase": 0.0608,
+        "RearSlitWidth": 0.0941,
+        "RearSlitGradient": 0.0006,
+        "RearRMS": 0.0011,
+        "RearThickness": "Non-recov.",
+        "RearBridgeWidth": "",
+        "RearBridgePitch": ""
+    },
+    "18c": {
+        "FrontPitch": 0.113808,
+        "FrontOrient": 29.956,
+        "FrontPhase": 0.071,
+        "FrontSlitWidth": 0.0929,
+        "FrontSlitGradient": 0.0011,
+        "FrontRMS": 0.0011,
+        "FrontThickness": "Non-recov.",
+        "FrontBridgeWidth": "",
+        "FrontBridgePitch": "",
+        "RearPitch": 0.114238,
+        "RearOrient": 30.06,
+        "RearPhase": 0.0166,
+        "RearSlitWidth": 0.0919,
+        "RearSlitGradient": 0.0014,
+        "RearRMS": 0.0011,
+        "RearThickness": "Non-recov.",
+        "RearBridgeWidth": "",
+        "RearBridgePitch": ""
+    },
+    "19a": {
+        "FrontPitch": 0.108729,
+        "FrontOrient": 70.188,
+        "FrontPhase": 0.0098,
+        "FrontSlitWidth": 0.0833,
+        "FrontSlitGradient": 0.0012,
+        "FrontRMS": 0.0007,
+        "FrontThickness": "Non-recov.",
+        "FrontBridgeWidth": "",
+        "FrontBridgePitch": "",
+        "RearPitch": 0.108493,
+        "RearOrient": 69.834,
+        "RearPhase": 0.0257,
+        "RearSlitWidth": 0.0814,
+        "RearSlitGradient": 0.0009,
+        "RearRMS": 0.0009,
+        "RearThickness": "Non-recov.",
+        "RearBridgeWidth": "",
+        "RearBridgePitch": ""
+    }
+}
+detector_center_coords = {
+    "1": {
+        "x": -62.5,
+        "y": 36.5
+    },
+    "2": {
+        "x": -62.5,
+        "y": 13.5
+    },
+    "3": {
+        "x": -62.5,
+        "y": -13.5
+    },
+    "4": {
+        "x": -62.5,
+        "y": -36.5
+    },
+    "5": {
+        "x": -37.5,
+        "y": 59.5
+    },
+    "6": {
+        "x": -37.5,
+        "y": 36.5
+    },
+    "7": {
+        "x": -37.5,
+        "y": 13.5
+    },
+    "8": {
+        "x": -37.5,
+        "y": -13.5
+    },
+    "9": {
+        "x": -37.5,
+        "y": -36.5
+    },
+    "10": {
+        "x": -37.5,
+        "y": -59.5
+    },
+    "11": {
+        "x": -12.5,
+        "y": 73.5
+    },
+    "12": {
+        "x": -12.5,
+        "y": 50.5
+    },
+    "13": {
+        "x": -12.5,
+        "y": 27.5
+    },
+    "14": {
+        "x": -12.5,
+        "y": -27.5
+    },
+    "15": {
+        "x": -12.5,
+        "y": -50.5
+    },
+    "16": {
+        "x": -12.5,
+        "y": -73.5
+    },
+    "17": {
+        "x": 12.5,
+        "y": 73.5
+    },
+    "18": {
+        "x": 12.5,
+        "y": 50.5
+    },
+    "19": {
+        "x": 12.5,
+        "y": 27.5
+    },
+    "20": {
+        "x": 12.5,
+        "y": -27.5
+    },
+    "21": {
+        "x": 12.5,
+        "y": -50.5
+    },
+    "22": {
+        "x": 12.5,
+        "y": -73.5
+    },
+    "23": {
+        "x": 37.5,
+        "y": 59.5
+    },
+    "24": {
+        "x": 37.5,
+        "y": 36.5
+    },
+    "25": {
+        "x": 37.5,
+        "y": 13.5
+    },
+    "26": {
+        "x": 37.5,
+        "y": -13.5
+    },
+    "27": {
+        "x": 37.5,
+        "y": -36.5
+    },
+    "28": {
+        "x": 37.5,
+        "y": -59.5
+    },
+    "29": {
+        "x": 62.5,
+        "y": 36.5
+    },
+    "30": {
+        "x": 62.5,
+        "y": 13.5
+    },
+    "31": {
+        "x": 62.5,
+        "y": -13.5
+    },
+    "32": {
+        "x": 62.5,
+        "y": -36.5
+    }
+}
+cfl_hole_coords = {
+    'outer': [(-14.3, -13.45), (-14.3, 13.45), (14.3, 13.45), (14.3, -13.45)],
+    'top': [(-4.4, 3.45), (-4.4, 10.0), (4.4, 10.0), (4.4, 3.45)],
+    'bottom': [(-4.4, -10.0), (-4.4, -3.45), (4.4, -3.45), (4.4, -10.0)],
+    'left_top': [(-11.0, 3.45), (-11.0, 10.0), (-9.9, 10.0), (-9.9, 3.45)],
+    'left_bottom': [(-11.0, -10.0), (-11.0, -3.45), (-9.9, -3.45),
+                    (-9.9, -10.0)],
+    'right_top': [(9.9, 3.45), (9.9, 10.0), (11.0, 10.0), (11.0, 3.45)],
+    'right_bottom': [(9.9, -10.0), (9.9, -3.45), (11.0, -3.45), (11.0, -10.0)]
+}
+
+r_front_detector = 550 + 47  # measured from CAD
+r_rear_detector = 47
+frame_vertices = {
+    'front': [(-11, -10), (-11, 10), (11, 10), (11, -10), (-11, -10)],
+    'rear': [(-6.5, -6.5), (-6.5, 6.5), (6.5, 6.5), (6.5, -6.5), (-6.5, -6.5)]
+}
+grid_dim = {'front': (22, 20), 'rear': (13, 13)}  # grid dimemsions
+grid_z = {
+    'det': 0,
+    'rear': r_rear_detector,
+    'front': r_front_detector
+}  # grid z coordinates
+
+bkg_hole_coords = {}
+
+ebin_low_edges = np.array([
+    0, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 18, 20, 22, 25, 28, 32,
+    36, 40, 45, 50, 56, 63, 70, 76, 84, 100, 120, 150, math.inf
+])
+ebins = np.vstack((ebin_low_edges[0:-1], ebin_low_edges[1:])).T
+detector_ids_in_trigger_accumulators = np.array([[1, 2], [6, 7], [5, 11], [12, 13], [14, 15],
+                                                [10, 16], [8, 9], [3, 4], [
+                                                    31, 32], [26, 27],
+                                                 [22, 28], [20, 21], [18, 19], [
+                                                     17, 23], [24, 25],
+                                                 [29, 30]])-1
+# detector ids of in trigger accounumator
+detector_group_map = np.array([
+    0, 0, 7, 7, 2, 1, 1, 6, 6, 5, 2, 3, 3, 4, 4, 5, 13, 12, 12, 11, 11, 10, 13,
+    14, 14, 9, 9, 10, 15, 15, 8, 8
+])
+
+detector_pairs = {
+    0: 1,
+    5: 6,
+    4: 10,
+    11: 12,
+    13: 14,
+    9: 15,
+    7: 8,
+    2: 3,
+    30: 31,
+    25: 26,
+    21: 27,
+    19: 20,
+    17: 18,
+    16: 22,
+    23: 24,
+    28: 29,
+    1: 0,
+    6: 5,
+    10: 4,
+    12: 11,
+    14: 13,
+    15: 9,
+    8: 7,
+    3: 2,
+    31: 30,
+    26: 25,
+    27: 21,
+    20: 19,
+    18: 17,
+    22: 16,
+    24: 23,
+    29: 28
+}
+
+QL_LC_energy_slicers = [slice(1, 7), slice(
+    7, 12), slice(12, 17), slice(17, 23), slice(23, 28)]
+# energy slicer
+DETECTOR_GROUPS = [[1, 2], [6, 7], [5, 11], [12, 13], [14, 15], [10, 16],
+                   [8, 9], [3, 4], [31, 32], [26, 27], [22, 28], [20, 21],
+                   [18, 19], [17, 23], [24, 25], [29, 30]]
+DET_SIBLINGS = {
+    0: 1,
+    1: 0,
+    5: 6,
+    6: 5,
+    4: 10,
+    10: 4,
+    11: 12,
+    12: 11,
+    13: 14,
+    14: 13,
+    9: 15,
+    15: 9,
+    7: 8,
+    8: 7,
+    2: 3,
+    3: 2,
+    30: 31,
+    31: 30,
+    25: 26,
+    26: 25,
+    21: 27,
+    27: 21,
+    19: 20,
+    20: 19,
+    17: 18,
+    18: 17,
+    16: 22,
+    22: 16,
+    23: 24,
+    24: 23,
+    28: 29,
+    29: 28
+}
+
+det_id_to_trig_idx={0: 0,
+ 1: 0,
+ 2: 7,
+ 3: 7,
+ 4: 2,
+ 5: 1,
+ 6: 1,
+ 7: 6,
+ 8: 6,
+ 9: 5,
+ 10: 2,
+ 11: 3,
+ 12: 3,
+ 13: 4,
+ 14: 4,
+ 15: 5,
+ 16: 13,
+ 17: 12,
+ 18: 12,
+ 19: 11,
+ 20: 11,
+ 21: 10,
+ 22: 13,
+ 23: 14,
+ 24: 14,
+ 25: 9,
+ 26: 9,
+ 27: 10,
+ 28: 15,
+ 29: 15,
+ 30: 8,
+ 31: 8}
+
+def detector_id_to_trigger_index(i):
+    return det_id_to_trig_idx[i]
+
+def get_detector_in_same_group(idx):
+    """Get detector index in the same group
+    Args:
+        idx: int
+            detector id, detector id range: [0,31]
+    Returns
+        idx: int
+            ID of the detector in the same group
+    """
+    return detector_pairs.get(idx, None)
+
+
+def get_trigger_index(idx: int):
+    w = np.where(detector_ids_in_trigger_accumulators == idx)
+    return w[0][0]
+
+
+def get_trigger_acc_detector_ids():
+    return detector_ids_in_trigger_accumulators
+
+
+def get_sci_ebins(a, b):
+    low = np.where(ebin_low_edges == a)[0][0]
+    up = np.where(ebin_low_edges == b)[0][0]-1
+
+    return (low, up)
+
+
+
+
+
+
+
+

Functions

+
+
+def detector_id_to_trigger_index(i) +
+
+
+
+ +Expand source code + +
def detector_id_to_trigger_index(i):
+    return det_id_to_trig_idx[i]
+
+
+
+def get_detector_in_same_group(idx) +
+
+

Get detector index in the same group

+

Args

+
+
idx
+
int +detector id, detector id range: [0,31]
+
+

Returns +idx: int +ID of the detector in the same group

+
+ +Expand source code + +
def get_detector_in_same_group(idx):
+    """Get detector index in the same group
+    Args:
+        idx: int
+            detector id, detector id range: [0,31]
+    Returns
+        idx: int
+            ID of the detector in the same group
+    """
+    return detector_pairs.get(idx, None)
+
+
+
+def get_sci_ebins(a, b) +
+
+
+
+ +Expand source code + +
def get_sci_ebins(a, b):
+    low = np.where(ebin_low_edges == a)[0][0]
+    up = np.where(ebin_low_edges == b)[0][0]-1
+
+    return (low, up)
+
+
+
+def get_trigger_acc_detector_ids() +
+
+
+
+ +Expand source code + +
def get_trigger_acc_detector_ids():
+    return detector_ids_in_trigger_accumulators
+
+
+
+def get_trigger_index(idx: int) +
+
+
+
+ +Expand source code + +
def get_trigger_index(idx: int):
+    w = np.where(detector_ids_in_trigger_accumulators == idx)
+    return w[0][0]
+
+
+
+
+
+
+
+ +
+ + + \ No newline at end of file diff --git a/docs/stixdcpy/io.html b/docs/stixdcpy/io.html new file mode 100644 index 0000000..b5a96dc --- /dev/null +++ b/docs/stixdcpy/io.html @@ -0,0 +1,287 @@ + + + + + + +stixdcpy.io API documentation + + + + + + + + + + + +
+
+
+

Module stixdcpy.io

+
+
+
+ +Expand source code + +
#!/usr/bin/python
+import joblib
+import numpy as np
+import pandas as pd
+
+from stixdcpy.logger import logger
+'''
+    Methods in this module allow to save/load  objects to/from  npy  files
+
+    Author: Hualin Xiao (hualin.xiao@fhnw.ch)
+    Date: Sep. 1, 2021
+
+'''
+ALLOWED_EXTENSIONS = ['.pickle', '.npy', '.h5', '.fits']
+
+
+class IO(object):
+    """
+        Base object
+    """
+
+    def __init__(self):
+        pass
+
+    def dump(self, data, filename):
+        """Dump object to joblib file
+        Args
+            data: object
+                data object
+            filename: str
+                filename
+
+        Returns:
+            filename: str
+                filename
+        """
+        joblib.dump(data, filename)
+        return filename
+        #logger.error("this feature has not been implemented!")
+        # pass
+
+    def load(self, filename):
+        """load object from file
+
+        Args:
+            filename:  str
+
+        Returns:
+            data: object
+
+
+        """
+        return joblib.load(filename)
+        #logger.error("this feature has not been implemented!")
+        # pass
+
+    def to_pandas(self):
+        if self.data:
+            return pd.DataFrame(self.data)
+        return None
+
+
+
+
+
+
+
+
+
+

Classes

+
+
+class IO +
+
+

Base object

+
+ +Expand source code + +
class IO(object):
+    """
+        Base object
+    """
+
+    def __init__(self):
+        pass
+
+    def dump(self, data, filename):
+        """Dump object to joblib file
+        Args
+            data: object
+                data object
+            filename: str
+                filename
+
+        Returns:
+            filename: str
+                filename
+        """
+        joblib.dump(data, filename)
+        return filename
+        #logger.error("this feature has not been implemented!")
+        # pass
+
+    def load(self, filename):
+        """load object from file
+
+        Args:
+            filename:  str
+
+        Returns:
+            data: object
+
+
+        """
+        return joblib.load(filename)
+        #logger.error("this feature has not been implemented!")
+        # pass
+
+    def to_pandas(self):
+        if self.data:
+            return pd.DataFrame(self.data)
+        return None
+
+

Subclasses

+ +

Methods

+
+
+def dump(self, data, filename) +
+
+

Dump object to joblib file +Args +data: object +data object +filename: str +filename

+

Returns

+
+
filename
+
str +filename
+
+
+ +Expand source code + +
def dump(self, data, filename):
+    """Dump object to joblib file
+    Args
+        data: object
+            data object
+        filename: str
+            filename
+
+    Returns:
+        filename: str
+            filename
+    """
+    joblib.dump(data, filename)
+    return filename
+    #logger.error("this feature has not been implemented!")
+    # pass
+
+
+
+def load(self, filename) +
+
+

load object from file

+

Args

+
+
filename
+
str
+
+

Returns

+
+
data
+
object
+
+
+ +Expand source code + +
def load(self, filename):
+    """load object from file
+
+    Args:
+        filename:  str
+
+    Returns:
+        data: object
+
+
+    """
+    return joblib.load(filename)
+    #logger.error("this feature has not been implemented!")
+    # pass
+
+
+
+def to_pandas(self) +
+
+
+
+ +Expand source code + +
def to_pandas(self):
+    if self.data:
+        return pd.DataFrame(self.data)
+    return None
+
+
+
+
+
+
+
+ +
+ + + \ No newline at end of file diff --git a/docs/stixdcpy/logger.html b/docs/stixdcpy/logger.html new file mode 100644 index 0000000..7e23638 --- /dev/null +++ b/docs/stixdcpy/logger.html @@ -0,0 +1,61 @@ + + + + + + +stixdcpy.logger API documentation + + + + + + + + + + + +
+
+
+

Module stixdcpy.logger

+
+
+
+ +Expand source code + +
import logging
+logger = logging.getLogger('stixdcpy')
+logger.setLevel(logging.DEBUG)
+
+
+
+
+
+
+
+
+
+
+
+ +
+ + + \ No newline at end of file diff --git a/docs/stixdcpy/net.html b/docs/stixdcpy/net.html new file mode 100644 index 0000000..f227860 --- /dev/null +++ b/docs/stixdcpy/net.html @@ -0,0 +1,1509 @@ + + + + + + +stixdcpy.net API documentation + + + + + + + + + + + +
+
+
+

Module stixdcpy.net

+
+
+

This module provides APIs to retrieve data from STIX data center +Author: Hualin Xiao (hualin.xiao@fhnw.ch) +Date: Sep. 1, 2021

+
+ +Expand source code + +
#!/usr/bin/python
+"""
+    This module provides APIs to retrieve data from STIX data center
+    Author: Hualin Xiao (hualin.xiao@fhnw.ch)
+    Date: Sep. 1, 2021
+
+"""
+
+import hashlib
+
+import numpy as np
+import pandas as pd
+import pprint
+from pathlib import Path, PurePath
+from dateutil import parser as dtparser
+
+import requests
+from astropy.io import fits
+from tqdm import tqdm
+
+DOWNLOAD_PATH = Path.cwd() / 'downloads'
+DOWNLOAD_PATH.mkdir(parents=False, exist_ok=True)
+HOST = 'https://datacenter.stix.i4ds.net'
+#HOST='http://localhost:5000'
+URLS_POST = {
+    'LC': f'{HOST}/api/request/ql/lightcurves',
+    'HK': f'{HOST}/api/request/housekeeping',
+    'HK2': f'{HOST}/api/request/hk2',
+    'ELUT': f'{HOST}/api/request/eluts',
+    'EPHEMERIS': f'{HOST}/api/request/ephemeris',
+    'ATTITUDE': f'{HOST}/api/request/solo/attitude',
+    'SCIENCE': f'{HOST}/api/request/science-data/id',
+    'TRANSMISSION': f'{HOST}/api/request/transmission',
+    'FLARE_LIST': f'{HOST}/api/request/flare-list',
+    'STIX_POINTING': f'{HOST}/api/request/stixfov',
+    'CFL_SOLVER': f'{HOST}/api/request/solve/cfl'
+}
+
+FITS_TYPES = {
+    'l0', 'l1', 'l2', 'l3', 'spec', 'qlspec', 'asp', 'aspect', 'lc', 'bkg',
+    'var', 'ffl', 'cal', 'hkmin', 'hkmax'
+}
+
+
+class FitsQueryResult(object):
+    def __init__(self, resp):
+        self.hdu_objects = []
+        self.result = resp
+        self.downloaded_fits_files = []
+
+    def __repr__(self):
+        return str(self.result)
+
+    def __getitem__(self, index):
+        return self.result[index]
+
+    def __getattr__(self, name):
+        if name in ['num', 'len']:
+            return len(self.result)
+        elif name == 'hduls':
+            return self.hdu_objects
+
+    def __len__(self):
+        return len(self.result)
+
+    def pprint(self):
+        pprint.pprint(self.result)
+
+    def to_pandas(self):
+        return pd.DataFrame(self.result)
+
+    def open_fits(self):
+        self.hdu_objects = []
+        for filename in self.downloaded_fits_files:
+            self.hdu_objects.append(fits.open(filename))
+        return self.hdu_objects
+
+    def fits_info(self):
+        for hdu in self.hdu_objects:
+            print(hdu.info())
+
+    def get_fits_ids(self):
+        return [row['fits_id'] for row in self.result]
+
+    def fetch(self):
+        if self.result:
+            self.downloaded_fits_files = FitsQuery.fetch(self.result)
+            return self.downloaded_fits_files
+        else:
+            print('WARNING: Nothing to be downloaded from stix data center!')
+
+
+class FitsQuery(object):
+    """
+    Request FITS format data from STIX data center
+    """
+    def __init__(self):
+        self.fits_file_list = []
+
+    @staticmethod
+    def wget(url: str, desc: str, progress_bar=True):
+        """Download a file from the link and save the file to a temporary file.
+           Downloading progress will be shown in a progress bar
+
+        Args:
+            url (str): URL
+            desc (str): description to be shown on the progress bar
+
+        Returns:
+            temporary filename 
+        """
+        stream = progress_bar
+        resp = requests.get(url, stream=stream)
+        content_type = resp.headers.get('content-type')
+        if content_type != 'binary/x-fits':
+            print('ERROR:', resp.content)
+            return None
+
+        folder = DOWNLOAD_PATH
+        try:
+            fname = resp.headers.get("Content-Disposition").split(
+                "filename=")[1]
+        except AttributeError:
+            md5hex = hashlib.md5(url.encode('utf-8')).hexdigest()
+            fname = f'{md5hex}.fits'
+        filename = PurePath(folder, fname)
+        file_path = Path(filename)
+        if file_path.is_file():
+            print(f'Found the data in local storage. Filename: {filename} ...')
+            return str(file_path)
+        f = open(filename, 'wb')
+        chunk_size = 1024
+        total = int(resp.headers.get('content-length', 0))
+        with tqdm(
+                desc=desc,
+                total=total,
+                unit='iB',
+                unit_scale=True,
+                unit_divisor=chunk_size,
+        ) as bar:
+            for data in resp.iter_content(chunk_size=chunk_size):
+                size = f.write(data)
+                bar.update(size)
+        name = f.name
+        f.close()
+        return name
+
+    @staticmethod
+    def query(start_utc, stop_utc, product_type='lc'):
+        if product_type not in FITS_TYPES:
+            raise TypeError(
+                f'Invalid product type! product_type can be one of {str(FITS_TYPES)}'
+            )
+        url = f'{HOST}/query/fits/{start_utc}/{stop_utc}/{product_type}'
+        r = requests.get(url).json()
+        res = []
+        if isinstance(r, list):
+            res = r
+        elif 'error' in r:
+            print(r['error'])
+        return FitsQueryResult(res)
+
+    @staticmethod
+    def fetch_bulk_science_by_request_id(request_id):
+        url = f'{HOST}/download/fits/bsd/{request_id}'
+        fname = FitsQuery.wget(url, f'Downloading STIX Science data #{request_id}')
+        return fname
+
+    @staticmethod
+    def fetch(query_results):
+        fits_ids = []
+        if isinstance(query_results, FitsQueryResult):
+            fits_ids = query_results.get_fits_ids()
+        elif isinstance(query_results, int):
+            fits_ids = [query_results]
+        elif isinstance(query_results, list):
+            try:
+                fits_ids = [row['fits_id'] for row in query_results]
+            except Exception as e:
+                pass
+            if not fits_ids:
+                try:
+                    fits_ids = [
+                        row for row in query_results if isinstance(row, int)
+                    ]
+                except:
+                    pass
+        if not fits_ids:
+            raise TypeError('Invalid argument type')
+
+        fits_filenames = []
+        try:
+            for file_id in fits_ids:
+                fname = FitsQuery.get_fits(file_id)
+                fits_filenames.append(fname)
+        except Exception as e:
+            raise e
+        # self.fits_file_list=fits_filenames
+        return fits_filenames
+
+    @staticmethod
+    def get_fits(fits_id, progress_bar=True):
+        """Download FITS data products from STIX data center.
+        Args:
+            fits_id: FITS file ID
+            progress_bar: show the progress bar if it is true
+
+
+        Returns:
+            A FITS hdulist object if success;  None if failed
+        """
+        url = f'{HOST}/download/fits/{fits_id}'
+        fname = FitsQuery.wget(url, 'Downloading data', progress_bar)
+        return fname
+
+    @staticmethod
+    def fetch_continuous_data(start_utc, end_utc, data_type):
+        if data_type not in ['hkmax', 'lc', 'var', 'qlspec', 'bkg']:
+            raise TypeError(f'Data type {data_type} not supported!')
+        url = f'{HOST}/create/fits/{start_utc}/{end_utc}/{data_type}'
+        fname = FitsQuery.wget(url, 'Downloading data', True)
+        return fname
+
+
+class JSONRequest(object):
+    """Request json format data from STIX data center """
+    @staticmethod
+    def post(url, form):
+        response = requests.post(url, data=form)
+        data = response.json()
+
+        if 'error' in data:
+            if data['error']:
+                return None
+        return data
+
+    @staticmethod
+    def fetch_light_curves(begin_utc: str, end_utc: str, ltc: bool):
+        """ Request light curve from STIX data center
+
+        Args:
+            begin_utc:  str
+                Observation start time
+            end_utc: str
+                Observation end time
+            ltc: bool, optional
+                Light time correction enabling flag.   Do light time correction if True
+        Returns:
+            lightcurve: dict
+                A python dictionary containing light curve data
+
+        """
+        form = {'begin': begin_utc, 'ltc': ltc, 'end': end_utc}
+        url = URLS_POST['LC']
+        return JSONRequest.post(url, form)
+
+    @staticmethod
+    def fetch_housekeeping(begin_utc: str, end_utc: str):
+        """Fetch housekeeping data from STIX data center
+
+        Args:
+            begin_utc: Data start time
+            end_utc: data end time
+
+        Returns:
+            result:  dict
+            housekeeping data
+
+        """
+        if not begin_utc.endswith('Z'):
+            begin_utc += 'Z'
+        if not end_utc.endswith('Z'):
+            end_utc += 'Z'
+        start_unix = dtparser.parse(begin_utc).timestamp()
+        end_unix = dtparser.parse(end_utc).timestamp()
+        duration = int(end_unix) - int(start_unix)
+        form = {
+            'start_unix': start_unix,
+            'duration': duration,
+        }
+        url = URLS_POST['HK']
+        return JSONRequest.post(url, form)
+
+    @staticmethod
+    def solve_cfl(cfl_counts, cfl_counts_err, fluence, fluence_err):
+        """compute flare location using the online flare location solver
+
+        Args:
+            cfl_counts: numpy array or list
+                counts recorded by the 12 CFL pixels
+            cfl_counts_err:  numpy array or list
+                standard deviations of  the counts recorded by the 12 CFL pixels
+            fluence: float
+                X-ray fluence in units of  counts/mm2,  calculated using counts recorded by other detectors
+            fluence_err: float
+                Errors in fluence in counts/mm2 units
+        Returns:
+            location: dict
+                CFL location, ephemeris and the chisquare map
+
+        """
+        form = {'counts': cfl_counts, 'counts_err':cfl_counts_err,
+                'fluence':fluence,'fluence_err':fluence_err}
+        url = URLS_POST['CFL_SOLVER']
+        return JSONRequest.post(url, form)
+
+    @staticmethod
+    def fetch_elut(utc):
+        """Download ELUT from STIX data center
+        Args:
+            utc: Time
+        Returns: dict
+            object: a diction string containing elut information
+        """
+        form = {'utc': utc}
+        url = URLS_POST['ELUT']
+        return JSONRequest.post(url, form)
+
+    @staticmethod
+    def request_ephemeris(start_utc: str, end_utc: str, steps=1):
+        return JSONRequest.post(URLS_POST['EPHEMERIS'], {
+            'start_utc': start_utc,
+            'end_utc': end_utc,
+            'steps': steps
+        })
+    @staticmethod
+    def request_pointing(utc: str):
+        return JSONRequest.post(URLS_POST['STIX_POINTING'], {
+            'utc': utc,
+        })
+    @staticmethod
+    def request_attitude(start_utc: str, end_utc: str,  steps=1, instrument_frame='SOLO_SRF', ref_frame='SOLO_SUN_RTN'):
+        form={
+            'start_utc': start_utc,
+            'end_utc': end_utc,
+            'steps': steps,
+            'frame1':instrument_frame,
+            'frame2':ref_frame
+        }
+        ret=JSONRequest.post(URLS_POST['ATTITUDE'], form)
+        return ret
+    @staticmethod
+    def fetch_science_data(_id: int):
+        """fetch science data from stix data center
+
+        Args:
+            _id: int
+                science data unique ID, which can be found on STIX data center bulk science data web page
+
+
+        Returns:
+            science_data: dict
+                science data received from data center if success or None if failed
+
+        """
+        return JSONRequest.post(URLS_POST['SCIENCE'], {
+            'id': _id,
+        })
+
+    @staticmethod
+    def fetch_flare_list(start_utc: str, end_utc: str, sort: str = 'time'):
+        """ query and download flare list from stix data center
+
+        Args:
+            start_utc: str
+                flare start UTC
+            end_utc: str
+                flare end UTC
+            sort: str
+                key to sort flares. It can be one of ['goes','time', 'LC0','LC1','LC2','LC3','LC4], LCi here means the i-th QL light curve
+
+
+        Returns:
+            flare_list: dict or None
+                flare list if success or None if failed.
+
+        """
+        return JSONRequest.post(URLS_POST['FLARE_LIST'], {
+            'start_utc': start_utc,
+            'end_utc': end_utc,
+            'sort': sort
+        })
+
+
+
+
+
+
+
+
+
+

Classes

+
+
+class FitsQuery +
+
+

Request FITS format data from STIX data center

+
+ +Expand source code + +
class FitsQuery(object):
+    """
+    Request FITS format data from STIX data center
+    """
+    def __init__(self):
+        self.fits_file_list = []
+
+    @staticmethod
+    def wget(url: str, desc: str, progress_bar=True):
+        """Download a file from the link and save the file to a temporary file.
+           Downloading progress will be shown in a progress bar
+
+        Args:
+            url (str): URL
+            desc (str): description to be shown on the progress bar
+
+        Returns:
+            temporary filename 
+        """
+        stream = progress_bar
+        resp = requests.get(url, stream=stream)
+        content_type = resp.headers.get('content-type')
+        if content_type != 'binary/x-fits':
+            print('ERROR:', resp.content)
+            return None
+
+        folder = DOWNLOAD_PATH
+        try:
+            fname = resp.headers.get("Content-Disposition").split(
+                "filename=")[1]
+        except AttributeError:
+            md5hex = hashlib.md5(url.encode('utf-8')).hexdigest()
+            fname = f'{md5hex}.fits'
+        filename = PurePath(folder, fname)
+        file_path = Path(filename)
+        if file_path.is_file():
+            print(f'Found the data in local storage. Filename: {filename} ...')
+            return str(file_path)
+        f = open(filename, 'wb')
+        chunk_size = 1024
+        total = int(resp.headers.get('content-length', 0))
+        with tqdm(
+                desc=desc,
+                total=total,
+                unit='iB',
+                unit_scale=True,
+                unit_divisor=chunk_size,
+        ) as bar:
+            for data in resp.iter_content(chunk_size=chunk_size):
+                size = f.write(data)
+                bar.update(size)
+        name = f.name
+        f.close()
+        return name
+
+    @staticmethod
+    def query(start_utc, stop_utc, product_type='lc'):
+        if product_type not in FITS_TYPES:
+            raise TypeError(
+                f'Invalid product type! product_type can be one of {str(FITS_TYPES)}'
+            )
+        url = f'{HOST}/query/fits/{start_utc}/{stop_utc}/{product_type}'
+        r = requests.get(url).json()
+        res = []
+        if isinstance(r, list):
+            res = r
+        elif 'error' in r:
+            print(r['error'])
+        return FitsQueryResult(res)
+
+    @staticmethod
+    def fetch_bulk_science_by_request_id(request_id):
+        url = f'{HOST}/download/fits/bsd/{request_id}'
+        fname = FitsQuery.wget(url, f'Downloading STIX Science data #{request_id}')
+        return fname
+
+    @staticmethod
+    def fetch(query_results):
+        fits_ids = []
+        if isinstance(query_results, FitsQueryResult):
+            fits_ids = query_results.get_fits_ids()
+        elif isinstance(query_results, int):
+            fits_ids = [query_results]
+        elif isinstance(query_results, list):
+            try:
+                fits_ids = [row['fits_id'] for row in query_results]
+            except Exception as e:
+                pass
+            if not fits_ids:
+                try:
+                    fits_ids = [
+                        row for row in query_results if isinstance(row, int)
+                    ]
+                except:
+                    pass
+        if not fits_ids:
+            raise TypeError('Invalid argument type')
+
+        fits_filenames = []
+        try:
+            for file_id in fits_ids:
+                fname = FitsQuery.get_fits(file_id)
+                fits_filenames.append(fname)
+        except Exception as e:
+            raise e
+        # self.fits_file_list=fits_filenames
+        return fits_filenames
+
+    @staticmethod
+    def get_fits(fits_id, progress_bar=True):
+        """Download FITS data products from STIX data center.
+        Args:
+            fits_id: FITS file ID
+            progress_bar: show the progress bar if it is true
+
+
+        Returns:
+            A FITS hdulist object if success;  None if failed
+        """
+        url = f'{HOST}/download/fits/{fits_id}'
+        fname = FitsQuery.wget(url, 'Downloading data', progress_bar)
+        return fname
+
+    @staticmethod
+    def fetch_continuous_data(start_utc, end_utc, data_type):
+        if data_type not in ['hkmax', 'lc', 'var', 'qlspec', 'bkg']:
+            raise TypeError(f'Data type {data_type} not supported!')
+        url = f'{HOST}/create/fits/{start_utc}/{end_utc}/{data_type}'
+        fname = FitsQuery.wget(url, 'Downloading data', True)
+        return fname
+
+

Static methods

+
+
+def fetch(query_results) +
+
+
+
+ +Expand source code + +
@staticmethod
+def fetch(query_results):
+    fits_ids = []
+    if isinstance(query_results, FitsQueryResult):
+        fits_ids = query_results.get_fits_ids()
+    elif isinstance(query_results, int):
+        fits_ids = [query_results]
+    elif isinstance(query_results, list):
+        try:
+            fits_ids = [row['fits_id'] for row in query_results]
+        except Exception as e:
+            pass
+        if not fits_ids:
+            try:
+                fits_ids = [
+                    row for row in query_results if isinstance(row, int)
+                ]
+            except:
+                pass
+    if not fits_ids:
+        raise TypeError('Invalid argument type')
+
+    fits_filenames = []
+    try:
+        for file_id in fits_ids:
+            fname = FitsQuery.get_fits(file_id)
+            fits_filenames.append(fname)
+    except Exception as e:
+        raise e
+    # self.fits_file_list=fits_filenames
+    return fits_filenames
+
+
+
+def fetch_bulk_science_by_request_id(request_id) +
+
+
+
+ +Expand source code + +
@staticmethod
+def fetch_bulk_science_by_request_id(request_id):
+    url = f'{HOST}/download/fits/bsd/{request_id}'
+    fname = FitsQuery.wget(url, f'Downloading STIX Science data #{request_id}')
+    return fname
+
+
+
+def fetch_continuous_data(start_utc, end_utc, data_type) +
+
+
+
+ +Expand source code + +
@staticmethod
+def fetch_continuous_data(start_utc, end_utc, data_type):
+    if data_type not in ['hkmax', 'lc', 'var', 'qlspec', 'bkg']:
+        raise TypeError(f'Data type {data_type} not supported!')
+    url = f'{HOST}/create/fits/{start_utc}/{end_utc}/{data_type}'
+    fname = FitsQuery.wget(url, 'Downloading data', True)
+    return fname
+
+
+
+def get_fits(fits_id, progress_bar=True) +
+
+

Download FITS data products from STIX data center.

+

Args

+
+
fits_id
+
FITS file ID
+
progress_bar
+
show the progress bar if it is true
+
+

Returns

+

A FITS hdulist object if success; +None if failed

+
+ +Expand source code + +
@staticmethod
+def get_fits(fits_id, progress_bar=True):
+    """Download FITS data products from STIX data center.
+    Args:
+        fits_id: FITS file ID
+        progress_bar: show the progress bar if it is true
+
+
+    Returns:
+        A FITS hdulist object if success;  None if failed
+    """
+    url = f'{HOST}/download/fits/{fits_id}'
+    fname = FitsQuery.wget(url, 'Downloading data', progress_bar)
+    return fname
+
+
+
+def query(start_utc, stop_utc, product_type='lc') +
+
+
+
+ +Expand source code + +
@staticmethod
+def query(start_utc, stop_utc, product_type='lc'):
+    if product_type not in FITS_TYPES:
+        raise TypeError(
+            f'Invalid product type! product_type can be one of {str(FITS_TYPES)}'
+        )
+    url = f'{HOST}/query/fits/{start_utc}/{stop_utc}/{product_type}'
+    r = requests.get(url).json()
+    res = []
+    if isinstance(r, list):
+        res = r
+    elif 'error' in r:
+        print(r['error'])
+    return FitsQueryResult(res)
+
+
+
+def wget(url: str, desc: str, progress_bar=True) +
+
+

Download a file from the link and save the file to a temporary file. +Downloading progress will be shown in a progress bar

+

Args

+
+
url : str
+
URL
+
desc : str
+
description to be shown on the progress bar
+
+

Returns

+

temporary filename

+
+ +Expand source code + +
@staticmethod
+def wget(url: str, desc: str, progress_bar=True):
+    """Download a file from the link and save the file to a temporary file.
+       Downloading progress will be shown in a progress bar
+
+    Args:
+        url (str): URL
+        desc (str): description to be shown on the progress bar
+
+    Returns:
+        temporary filename 
+    """
+    stream = progress_bar
+    resp = requests.get(url, stream=stream)
+    content_type = resp.headers.get('content-type')
+    if content_type != 'binary/x-fits':
+        print('ERROR:', resp.content)
+        return None
+
+    folder = DOWNLOAD_PATH
+    try:
+        fname = resp.headers.get("Content-Disposition").split(
+            "filename=")[1]
+    except AttributeError:
+        md5hex = hashlib.md5(url.encode('utf-8')).hexdigest()
+        fname = f'{md5hex}.fits'
+    filename = PurePath(folder, fname)
+    file_path = Path(filename)
+    if file_path.is_file():
+        print(f'Found the data in local storage. Filename: {filename} ...')
+        return str(file_path)
+    f = open(filename, 'wb')
+    chunk_size = 1024
+    total = int(resp.headers.get('content-length', 0))
+    with tqdm(
+            desc=desc,
+            total=total,
+            unit='iB',
+            unit_scale=True,
+            unit_divisor=chunk_size,
+    ) as bar:
+        for data in resp.iter_content(chunk_size=chunk_size):
+            size = f.write(data)
+            bar.update(size)
+    name = f.name
+    f.close()
+    return name
+
+
+
+
+
+class FitsQueryResult +(resp) +
+
+
+
+ +Expand source code + +
class FitsQueryResult(object):
+    def __init__(self, resp):
+        self.hdu_objects = []
+        self.result = resp
+        self.downloaded_fits_files = []
+
+    def __repr__(self):
+        return str(self.result)
+
+    def __getitem__(self, index):
+        return self.result[index]
+
+    def __getattr__(self, name):
+        if name in ['num', 'len']:
+            return len(self.result)
+        elif name == 'hduls':
+            return self.hdu_objects
+
+    def __len__(self):
+        return len(self.result)
+
+    def pprint(self):
+        pprint.pprint(self.result)
+
+    def to_pandas(self):
+        return pd.DataFrame(self.result)
+
+    def open_fits(self):
+        self.hdu_objects = []
+        for filename in self.downloaded_fits_files:
+            self.hdu_objects.append(fits.open(filename))
+        return self.hdu_objects
+
+    def fits_info(self):
+        for hdu in self.hdu_objects:
+            print(hdu.info())
+
+    def get_fits_ids(self):
+        return [row['fits_id'] for row in self.result]
+
+    def fetch(self):
+        if self.result:
+            self.downloaded_fits_files = FitsQuery.fetch(self.result)
+            return self.downloaded_fits_files
+        else:
+            print('WARNING: Nothing to be downloaded from stix data center!')
+
+

Methods

+
+
+def fetch(self) +
+
+
+
+ +Expand source code + +
def fetch(self):
+    if self.result:
+        self.downloaded_fits_files = FitsQuery.fetch(self.result)
+        return self.downloaded_fits_files
+    else:
+        print('WARNING: Nothing to be downloaded from stix data center!')
+
+
+
+def fits_info(self) +
+
+
+
+ +Expand source code + +
def fits_info(self):
+    for hdu in self.hdu_objects:
+        print(hdu.info())
+
+
+
+def get_fits_ids(self) +
+
+
+
+ +Expand source code + +
def get_fits_ids(self):
+    return [row['fits_id'] for row in self.result]
+
+
+
+def open_fits(self) +
+
+
+
+ +Expand source code + +
def open_fits(self):
+    self.hdu_objects = []
+    for filename in self.downloaded_fits_files:
+        self.hdu_objects.append(fits.open(filename))
+    return self.hdu_objects
+
+
+
+def pprint(self) +
+
+
+
+ +Expand source code + +
def pprint(self):
+    pprint.pprint(self.result)
+
+
+
+def to_pandas(self) +
+
+
+
+ +Expand source code + +
def to_pandas(self):
+    return pd.DataFrame(self.result)
+
+
+
+
+
+class JSONRequest +
+
+

Request json format data from STIX data center

+
+ +Expand source code + +
class JSONRequest(object):
+    """Request json format data from STIX data center """
+    @staticmethod
+    def post(url, form):
+        response = requests.post(url, data=form)
+        data = response.json()
+
+        if 'error' in data:
+            if data['error']:
+                return None
+        return data
+
+    @staticmethod
+    def fetch_light_curves(begin_utc: str, end_utc: str, ltc: bool):
+        """ Request light curve from STIX data center
+
+        Args:
+            begin_utc:  str
+                Observation start time
+            end_utc: str
+                Observation end time
+            ltc: bool, optional
+                Light time correction enabling flag.   Do light time correction if True
+        Returns:
+            lightcurve: dict
+                A python dictionary containing light curve data
+
+        """
+        form = {'begin': begin_utc, 'ltc': ltc, 'end': end_utc}
+        url = URLS_POST['LC']
+        return JSONRequest.post(url, form)
+
+    @staticmethod
+    def fetch_housekeeping(begin_utc: str, end_utc: str):
+        """Fetch housekeeping data from STIX data center
+
+        Args:
+            begin_utc: Data start time
+            end_utc: data end time
+
+        Returns:
+            result:  dict
+            housekeeping data
+
+        """
+        if not begin_utc.endswith('Z'):
+            begin_utc += 'Z'
+        if not end_utc.endswith('Z'):
+            end_utc += 'Z'
+        start_unix = dtparser.parse(begin_utc).timestamp()
+        end_unix = dtparser.parse(end_utc).timestamp()
+        duration = int(end_unix) - int(start_unix)
+        form = {
+            'start_unix': start_unix,
+            'duration': duration,
+        }
+        url = URLS_POST['HK']
+        return JSONRequest.post(url, form)
+
+    @staticmethod
+    def solve_cfl(cfl_counts, cfl_counts_err, fluence, fluence_err):
+        """compute flare location using the online flare location solver
+
+        Args:
+            cfl_counts: numpy array or list
+                counts recorded by the 12 CFL pixels
+            cfl_counts_err:  numpy array or list
+                standard deviations of  the counts recorded by the 12 CFL pixels
+            fluence: float
+                X-ray fluence in units of  counts/mm2,  calculated using counts recorded by other detectors
+            fluence_err: float
+                Errors in fluence in counts/mm2 units
+        Returns:
+            location: dict
+                CFL location, ephemeris and the chisquare map
+
+        """
+        form = {'counts': cfl_counts, 'counts_err':cfl_counts_err,
+                'fluence':fluence,'fluence_err':fluence_err}
+        url = URLS_POST['CFL_SOLVER']
+        return JSONRequest.post(url, form)
+
+    @staticmethod
+    def fetch_elut(utc):
+        """Download ELUT from STIX data center
+        Args:
+            utc: Time
+        Returns: dict
+            object: a diction string containing elut information
+        """
+        form = {'utc': utc}
+        url = URLS_POST['ELUT']
+        return JSONRequest.post(url, form)
+
+    @staticmethod
+    def request_ephemeris(start_utc: str, end_utc: str, steps=1):
+        return JSONRequest.post(URLS_POST['EPHEMERIS'], {
+            'start_utc': start_utc,
+            'end_utc': end_utc,
+            'steps': steps
+        })
+    @staticmethod
+    def request_pointing(utc: str):
+        return JSONRequest.post(URLS_POST['STIX_POINTING'], {
+            'utc': utc,
+        })
+    @staticmethod
+    def request_attitude(start_utc: str, end_utc: str,  steps=1, instrument_frame='SOLO_SRF', ref_frame='SOLO_SUN_RTN'):
+        form={
+            'start_utc': start_utc,
+            'end_utc': end_utc,
+            'steps': steps,
+            'frame1':instrument_frame,
+            'frame2':ref_frame
+        }
+        ret=JSONRequest.post(URLS_POST['ATTITUDE'], form)
+        return ret
+    @staticmethod
+    def fetch_science_data(_id: int):
+        """fetch science data from stix data center
+
+        Args:
+            _id: int
+                science data unique ID, which can be found on STIX data center bulk science data web page
+
+
+        Returns:
+            science_data: dict
+                science data received from data center if success or None if failed
+
+        """
+        return JSONRequest.post(URLS_POST['SCIENCE'], {
+            'id': _id,
+        })
+
+    @staticmethod
+    def fetch_flare_list(start_utc: str, end_utc: str, sort: str = 'time'):
+        """ query and download flare list from stix data center
+
+        Args:
+            start_utc: str
+                flare start UTC
+            end_utc: str
+                flare end UTC
+            sort: str
+                key to sort flares. It can be one of ['goes','time', 'LC0','LC1','LC2','LC3','LC4], LCi here means the i-th QL light curve
+
+
+        Returns:
+            flare_list: dict or None
+                flare list if success or None if failed.
+
+        """
+        return JSONRequest.post(URLS_POST['FLARE_LIST'], {
+            'start_utc': start_utc,
+            'end_utc': end_utc,
+            'sort': sort
+        })
+
+

Static methods

+
+
+def fetch_elut(utc) +
+
+

Download ELUT from STIX data center

+

Args

+
+
utc
+
Time
+
+

Returns: dict +object: a diction string containing elut information

+
+ +Expand source code + +
@staticmethod
+def fetch_elut(utc):
+    """Download ELUT from STIX data center
+    Args:
+        utc: Time
+    Returns: dict
+        object: a diction string containing elut information
+    """
+    form = {'utc': utc}
+    url = URLS_POST['ELUT']
+    return JSONRequest.post(url, form)
+
+
+
+def fetch_flare_list(start_utc: str, end_utc: str, sort: str = 'time') +
+
+

query and download flare list from stix data center

+

Args

+
+
start_utc
+
str +flare start UTC
+
end_utc
+
str +flare end UTC
+
sort
+
str +key to sort flares. It can be one of ['goes','time', 'LC0','LC1','LC2','LC3','LC4], LCi here means the i-th QL light curve
+
+

Returns

+
+
flare_list
+
dict or None +flare list if success or None if failed.
+
+
+ +Expand source code + +
@staticmethod
+def fetch_flare_list(start_utc: str, end_utc: str, sort: str = 'time'):
+    """ query and download flare list from stix data center
+
+    Args:
+        start_utc: str
+            flare start UTC
+        end_utc: str
+            flare end UTC
+        sort: str
+            key to sort flares. It can be one of ['goes','time', 'LC0','LC1','LC2','LC3','LC4], LCi here means the i-th QL light curve
+
+
+    Returns:
+        flare_list: dict or None
+            flare list if success or None if failed.
+
+    """
+    return JSONRequest.post(URLS_POST['FLARE_LIST'], {
+        'start_utc': start_utc,
+        'end_utc': end_utc,
+        'sort': sort
+    })
+
+
+
+def fetch_housekeeping(begin_utc: str, end_utc: str) +
+
+

Fetch housekeeping data from STIX data center

+

Args

+
+
begin_utc
+
Data start time
+
end_utc
+
data end time
+
+

Returns

+
+
result
+
dict
+
+

housekeeping data

+
+ +Expand source code + +
@staticmethod
+def fetch_housekeeping(begin_utc: str, end_utc: str):
+    """Fetch housekeeping data from STIX data center
+
+    Args:
+        begin_utc: Data start time
+        end_utc: data end time
+
+    Returns:
+        result:  dict
+        housekeeping data
+
+    """
+    if not begin_utc.endswith('Z'):
+        begin_utc += 'Z'
+    if not end_utc.endswith('Z'):
+        end_utc += 'Z'
+    start_unix = dtparser.parse(begin_utc).timestamp()
+    end_unix = dtparser.parse(end_utc).timestamp()
+    duration = int(end_unix) - int(start_unix)
+    form = {
+        'start_unix': start_unix,
+        'duration': duration,
+    }
+    url = URLS_POST['HK']
+    return JSONRequest.post(url, form)
+
+
+
+def fetch_light_curves(begin_utc: str, end_utc: str, ltc: bool) +
+
+

Request light curve from STIX data center

+

Args

+
+
begin_utc
+
str +Observation start time
+
end_utc
+
str +Observation end time
+
ltc
+
bool, optional +Light time correction enabling flag. +Do light time correction if True
+
+

Returns

+
+
lightcurve
+
dict +A python dictionary containing light curve data
+
+
+ +Expand source code + +
@staticmethod
+def fetch_light_curves(begin_utc: str, end_utc: str, ltc: bool):
+    """ Request light curve from STIX data center
+
+    Args:
+        begin_utc:  str
+            Observation start time
+        end_utc: str
+            Observation end time
+        ltc: bool, optional
+            Light time correction enabling flag.   Do light time correction if True
+    Returns:
+        lightcurve: dict
+            A python dictionary containing light curve data
+
+    """
+    form = {'begin': begin_utc, 'ltc': ltc, 'end': end_utc}
+    url = URLS_POST['LC']
+    return JSONRequest.post(url, form)
+
+
+
+def fetch_science_data(_id: int) +
+
+

fetch science data from stix data center

+

Args

+
+
_id
+
int +science data unique ID, which can be found on STIX data center bulk science data web page
+
+

Returns

+
+
science_data
+
dict +science data received from data center if success or None if failed
+
+
+ +Expand source code + +
@staticmethod
+def fetch_science_data(_id: int):
+    """fetch science data from stix data center
+
+    Args:
+        _id: int
+            science data unique ID, which can be found on STIX data center bulk science data web page
+
+
+    Returns:
+        science_data: dict
+            science data received from data center if success or None if failed
+
+    """
+    return JSONRequest.post(URLS_POST['SCIENCE'], {
+        'id': _id,
+    })
+
+
+
+def post(url, form) +
+
+
+
+ +Expand source code + +
@staticmethod
+def post(url, form):
+    response = requests.post(url, data=form)
+    data = response.json()
+
+    if 'error' in data:
+        if data['error']:
+            return None
+    return data
+
+
+
+def request_attitude(start_utc: str, end_utc: str, steps=1, instrument_frame='SOLO_SRF', ref_frame='SOLO_SUN_RTN') +
+
+
+
+ +Expand source code + +
@staticmethod
+def request_attitude(start_utc: str, end_utc: str,  steps=1, instrument_frame='SOLO_SRF', ref_frame='SOLO_SUN_RTN'):
+    form={
+        'start_utc': start_utc,
+        'end_utc': end_utc,
+        'steps': steps,
+        'frame1':instrument_frame,
+        'frame2':ref_frame
+    }
+    ret=JSONRequest.post(URLS_POST['ATTITUDE'], form)
+    return ret
+
+
+
+def request_ephemeris(start_utc: str, end_utc: str, steps=1) +
+
+
+
+ +Expand source code + +
@staticmethod
+def request_ephemeris(start_utc: str, end_utc: str, steps=1):
+    return JSONRequest.post(URLS_POST['EPHEMERIS'], {
+        'start_utc': start_utc,
+        'end_utc': end_utc,
+        'steps': steps
+    })
+
+
+
+def request_pointing(utc: str) +
+
+
+
+ +Expand source code + +
@staticmethod
+def request_pointing(utc: str):
+    return JSONRequest.post(URLS_POST['STIX_POINTING'], {
+        'utc': utc,
+    })
+
+
+
+def solve_cfl(cfl_counts, cfl_counts_err, fluence, fluence_err) +
+
+

compute flare location using the online flare location solver

+

Args

+
+
cfl_counts
+
numpy array or list +counts recorded by the 12 CFL pixels
+
cfl_counts_err
+
numpy array or list +standard deviations of +the counts recorded by the 12 CFL pixels
+
fluence
+
float +X-ray fluence in units of +counts/mm2, +calculated using counts recorded by other detectors
+
fluence_err
+
float +Errors in fluence in counts/mm2 units
+
+

Returns

+
+
location
+
dict +CFL location, ephemeris and the chisquare map
+
+
+ +Expand source code + +
@staticmethod
+def solve_cfl(cfl_counts, cfl_counts_err, fluence, fluence_err):
+    """compute flare location using the online flare location solver
+
+    Args:
+        cfl_counts: numpy array or list
+            counts recorded by the 12 CFL pixels
+        cfl_counts_err:  numpy array or list
+            standard deviations of  the counts recorded by the 12 CFL pixels
+        fluence: float
+            X-ray fluence in units of  counts/mm2,  calculated using counts recorded by other detectors
+        fluence_err: float
+            Errors in fluence in counts/mm2 units
+    Returns:
+        location: dict
+            CFL location, ephemeris and the chisquare map
+
+    """
+    form = {'counts': cfl_counts, 'counts_err':cfl_counts_err,
+            'fluence':fluence,'fluence_err':fluence_err}
+    url = URLS_POST['CFL_SOLVER']
+    return JSONRequest.post(url, form)
+
+
+
+
+
+
+
+ +
+ + + \ No newline at end of file diff --git a/docs/stixdcpy/quicklook.html b/docs/stixdcpy/quicklook.html new file mode 100644 index 0000000..0020948 --- /dev/null +++ b/docs/stixdcpy/quicklook.html @@ -0,0 +1,452 @@ + + + + + + +stixdcpy.quicklook API documentation + + + + + + + + + + + +
+
+
+

Module stixdcpy.quicklook

+
+
+

This module provides APIs to retrieve Quick-look data from STIX data center +,and some tools to display the data +Author: Hualin Xiao (hualin.xiao@fhnw.ch) +Date: Sep. 1, 2021

+
+ +Expand source code + +
#!/usr/bin/python
+"""
+    This module provides APIs to retrieve Quick-look data from STIX data center  ,and some tools to display the data
+    Author: Hualin Xiao (hualin.xiao@fhnw.ch)
+    Date: Sep. 1, 2021
+
+"""
+import datetime
+
+from matplotlib import pyplot as plt
+from stixdcpy import io as sio
+from stixdcpy.net import JSONRequest as jreq
+
+
+class QuickLook(sio.IO):
+    def __init__(self):
+        pass
+
+    # def save_fits(self,fname):
+    #    self.data.writeto(fname)
+
+
+class LightCurves(QuickLook):
+    def __init__(self, data):
+        if 'error' not in data:
+            self.data = data
+        else:
+            self.data = None
+
+    @classmethod
+    def from_sdc(cls, start_utc: str, end_utc: str, ltc=False):
+        """ fetch light curve data from STIX data center
+
+        Args:
+            start_utc: str
+                data start UTC
+            end_utc: str
+                data end UTC
+            ltc: bool
+                Light time correction flag. Do light time correction if it is True
+
+
+        Returns:
+            lc: python object
+                Lightcurve object
+
+        """
+        data = jreq.fetch_light_curves(start_utc, end_utc, ltc)
+        if 'light_curves' in data:
+            # correct key name
+            data['counts'] = data['light_curves']
+            del data['light_curves']
+        return cls(data)
+
+    def __getattr__(self, name):
+        if name == 'data':
+            return self.data
+
+    def get_data(self):
+        """ get light curve data
+        Returns:
+            data: dict
+                light curve data
+
+        """
+        return self.data
+
+    def peek(self, ax=None, legend_loc='upper right'):
+        """
+        Plot light curves
+        Args:
+            ltc: light time correction flag. The default value is False. Do light time correction if ltc=True
+        Returns
+            ax: matplotlib axs
+
+        """
+        if not self.data:
+            ax.text(0.5, 0.5, 'LC not available!')
+            return ax
+
+        if not ax:
+            _, ax = plt.subplots()
+        dt = [
+            datetime.datetime.utcfromtimestamp(t)
+            for t in self.data['unix_time']
+        ]
+        for i in range(5):
+            ax.plot(dt,
+                    self.data['counts'][str(i)],
+                    label=self.data['energy_bins']['names'][i])
+        dlt = self.data['DELTA_LIGHT_TIME']
+        light_time_corrected = self.data['IS_LIGHT_TIME_CORRECTED']
+
+        xlabel = f'UTC + {dlt:.2f} (4 sec time bins)' if light_time_corrected else 'UTC (4 sec time bins)'
+        ax.set_xlabel(xlabel)
+        ax.set_ylabel('Counts')
+        ax.legend(loc=legend_loc)
+        ax.set_yscale('log')
+        return ax
+
+
+
+
+
+
+
+
+
+

Classes

+
+
+class LightCurves +(data) +
+
+

Base object

+
+ +Expand source code + +
class LightCurves(QuickLook):
+    def __init__(self, data):
+        if 'error' not in data:
+            self.data = data
+        else:
+            self.data = None
+
+    @classmethod
+    def from_sdc(cls, start_utc: str, end_utc: str, ltc=False):
+        """ fetch light curve data from STIX data center
+
+        Args:
+            start_utc: str
+                data start UTC
+            end_utc: str
+                data end UTC
+            ltc: bool
+                Light time correction flag. Do light time correction if it is True
+
+
+        Returns:
+            lc: python object
+                Lightcurve object
+
+        """
+        data = jreq.fetch_light_curves(start_utc, end_utc, ltc)
+        if 'light_curves' in data:
+            # correct key name
+            data['counts'] = data['light_curves']
+            del data['light_curves']
+        return cls(data)
+
+    def __getattr__(self, name):
+        if name == 'data':
+            return self.data
+
+    def get_data(self):
+        """ get light curve data
+        Returns:
+            data: dict
+                light curve data
+
+        """
+        return self.data
+
+    def peek(self, ax=None, legend_loc='upper right'):
+        """
+        Plot light curves
+        Args:
+            ltc: light time correction flag. The default value is False. Do light time correction if ltc=True
+        Returns
+            ax: matplotlib axs
+
+        """
+        if not self.data:
+            ax.text(0.5, 0.5, 'LC not available!')
+            return ax
+
+        if not ax:
+            _, ax = plt.subplots()
+        dt = [
+            datetime.datetime.utcfromtimestamp(t)
+            for t in self.data['unix_time']
+        ]
+        for i in range(5):
+            ax.plot(dt,
+                    self.data['counts'][str(i)],
+                    label=self.data['energy_bins']['names'][i])
+        dlt = self.data['DELTA_LIGHT_TIME']
+        light_time_corrected = self.data['IS_LIGHT_TIME_CORRECTED']
+
+        xlabel = f'UTC + {dlt:.2f} (4 sec time bins)' if light_time_corrected else 'UTC (4 sec time bins)'
+        ax.set_xlabel(xlabel)
+        ax.set_ylabel('Counts')
+        ax.legend(loc=legend_loc)
+        ax.set_yscale('log')
+        return ax
+
+

Ancestors

+ +

Static methods

+
+
+def from_sdc(start_utc: str, end_utc: str, ltc=False) +
+
+

fetch light curve data from STIX data center

+

Args

+
+
start_utc
+
str +data start UTC
+
end_utc
+
str +data end UTC
+
ltc
+
bool +Light time correction flag. Do light time correction if it is True
+
+

Returns

+
+
lc
+
python object +Lightcurve object
+
+
+ +Expand source code + +
@classmethod
+def from_sdc(cls, start_utc: str, end_utc: str, ltc=False):
+    """ fetch light curve data from STIX data center
+
+    Args:
+        start_utc: str
+            data start UTC
+        end_utc: str
+            data end UTC
+        ltc: bool
+            Light time correction flag. Do light time correction if it is True
+
+
+    Returns:
+        lc: python object
+            Lightcurve object
+
+    """
+    data = jreq.fetch_light_curves(start_utc, end_utc, ltc)
+    if 'light_curves' in data:
+        # correct key name
+        data['counts'] = data['light_curves']
+        del data['light_curves']
+    return cls(data)
+
+
+
+

Methods

+
+
+def get_data(self) +
+
+

get light curve data

+

Returns

+
+
data
+
dict +light curve data
+
+
+ +Expand source code + +
def get_data(self):
+    """ get light curve data
+    Returns:
+        data: dict
+            light curve data
+
+    """
+    return self.data
+
+
+
+def peek(self, ax=None, legend_loc='upper right') +
+
+

Plot light curves

+

Args

+
+
ltc
+
light time correction flag. The default value is False. Do light time correction if ltc=True
+
+

Returns +ax: matplotlib axs

+
+ +Expand source code + +
def peek(self, ax=None, legend_loc='upper right'):
+    """
+    Plot light curves
+    Args:
+        ltc: light time correction flag. The default value is False. Do light time correction if ltc=True
+    Returns
+        ax: matplotlib axs
+
+    """
+    if not self.data:
+        ax.text(0.5, 0.5, 'LC not available!')
+        return ax
+
+    if not ax:
+        _, ax = plt.subplots()
+    dt = [
+        datetime.datetime.utcfromtimestamp(t)
+        for t in self.data['unix_time']
+    ]
+    for i in range(5):
+        ax.plot(dt,
+                self.data['counts'][str(i)],
+                label=self.data['energy_bins']['names'][i])
+    dlt = self.data['DELTA_LIGHT_TIME']
+    light_time_corrected = self.data['IS_LIGHT_TIME_CORRECTED']
+
+    xlabel = f'UTC + {dlt:.2f} (4 sec time bins)' if light_time_corrected else 'UTC (4 sec time bins)'
+    ax.set_xlabel(xlabel)
+    ax.set_ylabel('Counts')
+    ax.legend(loc=legend_loc)
+    ax.set_yscale('log')
+    return ax
+
+
+
+

Inherited members

+ +
+
+class QuickLook +
+
+

Base object

+
+ +Expand source code + +
class QuickLook(sio.IO):
+    def __init__(self):
+        pass
+
+    # def save_fits(self,fname):
+    #    self.data.writeto(fname)
+
+

Ancestors

+ +

Subclasses

+ +

Inherited members

+ +
+
+
+
+ +
+ + + \ No newline at end of file diff --git a/docs/stixdcpy/science.html b/docs/stixdcpy/science.html new file mode 100644 index 0000000..cfc2150 --- /dev/null +++ b/docs/stixdcpy/science.html @@ -0,0 +1,1577 @@ + + + + + + +stixdcpy.science API documentation + + + + + + + + + + + +
+
+
+

Module stixdcpy.science

+
+
+

This module provides APIs to retrieve Quick-look data from STIX data center , and provides tools to display the data +Author: Hualin Xiao (hualin.xiao@fhnw.ch) +Date: Sep. 1, 2021

+
+ +Expand source code + +
#!/usr/bin/python
+"""
+    This module provides APIs to retrieve Quick-look data from STIX data center , and provides tools to display the data
+    Author: Hualin Xiao (hualin.xiao@fhnw.ch)
+    Date: Sep. 1, 2021
+"""
+import datetime
+import numpy as np
+from astropy.io import fits
+from matplotlib import pyplot as plt
+from stixdcpy import time as sdt
+from stixdcpy.logger import logger
+from stixdcpy import io as sio, net
+from stixdcpy.net import FitsQuery as freq
+from stixdcpy import instrument as inst
+from pathlib import PurePath
+
+FPGA_TAU=10.1e-6
+ASIC_TAU=2.63e-6
+
+
+class ScienceData(sio.IO):
+    """
+      Retrieve science data from stix data center or load fits file from local storage
+
+    """
+    def __init__(self, request_id=None, fname=None):
+        self.fname = fname
+        self.data_type=None
+        if not fname:
+            raise Exception("FITS filename not specified")
+        self.request_id = request_id
+        self.time_shift_applied=0
+        self.hdul = fits.open(fname)
+        self.energies=[]
+        #self.read_data()
+    @property
+    def url(self):
+        req_id=self.request_id if not isinstance(self.request_id, list) else self.request_id[0]
+        link=f'{net.HOST}/view/list/bsd/uid/{req_id}'
+        return f'<a href="{link}">{link}</a>'
+
+    def read_fits(self, light_time_correction=True):
+        """
+            Read data  L1 compression level  FITS files
+            Parameters
+            ---------------------
+            light_time_correction: boolean
+                Correct light time difference
+        """
+
+        self.data = self.hdul['DATA'].data
+        self.T0_utc = self.hdul['PRIMARY'].header['DATE_BEG']
+        self.counts= self.data['counts']
+
+        self.light_time_del= self.hdul['PRIMARY'].header['EAR_TDEL']
+        self.light_time_corrected=light_time_correction
+
+        self.T0_unix = sdt.utc2unix(self.T0_utc)
+        self.triggers = self.data['triggers']
+        self.rcr = self.data['rcr']
+
+        self.timedel = self.data['timedel']
+        self.time = self.data['time']
+
+        if self.is_time_bin_shifted(self.T0_unix):
+            self.timedel = self.timedel[:-1]
+            self.time = self.time[1:]
+            logger.info('Shifted time bins have been corrected automatically!')
+            if self.data_type=='ScienceL1':
+                self.counts= self.counts[1:, :, :, :]
+                self.triggers = self.triggers[1:, :]
+                self.rcr = self.rcr[1:]
+            elif self.data_type=='Spectrogram':
+                self.counts= self.counts[1:, :]
+                self.triggers = self.triggers[1:]
+                #self.rcr = self.rcr[1:]
+
+        self.request_id = self.hdul['CONTROL'].data['request_id']
+        
+        self.time_shift_applied=0 if light_time_correction else self.light_time_del
+        self.datetime = [
+            sdt.unix2datetime(self.T0_unix + x + y * 0.5 + self.time_shift_applied)
+            for x, y in zip(self.time, self.timedel)
+        ]
+
+        self.duration = self.time[-1] - self.time[0] + (self.timedel[0] +
+                                                        self.timedel[-1]) / 2
+
+        self.energies = self.hdul['ENERGIES'].data
+
+        self.energy_bin_names = [
+            f'{a} - {b}'
+            for a, b in zip(self.energies['e_low'], self.energies['e_high'])
+        ]
+        self.energy_bin_mask = self.hdul["CONTROL"].data["energy_bin_mask"]
+
+        ebin_nz_idx =self.energy_bin_mask.nonzero()
+        self.max_ebin = np.max(ebin_nz_idx)  #indices of the non-zero elements
+        self.min_ebin = np.min(ebin_nz_idx)
+
+        self.ebins_mid = [
+            (a + b) / 2.
+            for a, b in zip(self.energies['e_low'], self.energies['e_high'])
+        ]
+        self.ebins_low, self.ebins_high = self.energies[
+            'e_low'], self.energies['e_high']
+
+        if self.data_type=='ScienceL1':
+            self.pixel_counts=self.counts
+            self.pixel_count_rates= self.pixel_counts/self.timedel[:,None,None, None]
+            self.trigger_rates = self.triggers / self.timedel[:, None] 
+        elif self.data_type=='Spectrogram':
+            self.count_rates= self.counts/self.timedel[:,None]
+            self.trigger_rates = self.triggers / self.timedel
+
+
+    def is_time_bin_shifted(self, unix_time):
+        """
+            Time bins are shifted in the data collected before 2021-12-09 due a bug in the flight software
+
+            Check if time bin is shifted in L1 data
+            Parameters
+                unix_time: float 
+            Returns
+                is_shifted: bool
+                    True if time bin is shifted else False
+        """
+
+        return (unix_time < sdt.utc2unix('2021-12-09T14:00:00'))
+
+    @classmethod
+    def from_sdc(cls, request_id):
+        '''
+        download science data file from stix data center
+        Parameters
+        ------
+        request_id :  int
+            bulk science data request unique ID; Unique IDs can be found on the science data web page  at stix data center
+
+
+        Returns
+        ------
+            science data class object
+        '''
+        request_id = request_id
+        fname = freq.fetch_bulk_science_by_request_id(request_id)
+        return cls(request_id, fname)
+
+    @classmethod
+    def from_fits(cls, filename):
+        """
+        factory class
+        Arguments
+        filename: str
+            FITS filename
+        """
+        request_id = None
+        return cls(request_id, filename)
+
+    def get_energy_range_slicer(self, elow, ehigh):
+        sel=[]
+        i=0
+        for a, b in zip(self.energies['e_low'], self.energies['e_high']):
+            if a>=elow  and b<=ehigh:
+                sel.append(i)
+            i+=1
+        return slice(min(sel),max(sel))
+
+
+
+    def rebin(self, ebins, min_tbin=0):
+        """
+         Energy rebin and time rebin
+         Arguments:
+         ebins: list or numpy array
+            energy bin range in units of keV
+         min_tbin: float
+            minimum time bin, shorter time bins are merged
+         Returns:
+            an object containing rebinned light curves
+        """
+        pass
+
+    def save(self, filename=None):
+        '''
+           Save data to a fits file
+           Parameters
+           filename : output fits filename
+           Returns
+           filename if success or error message
+        '''
+        if not isinstance(self.hdul, fits.hdu.hdulist.HDUList):
+            logger.error('The data object is a not a fits hdu object!')
+            return None
+        try:
+            if filename is None:
+                basename = self.hdul['PRIMARY'].header['FILENAME']
+                filename = PurePath(net.DOWNLOAD_PATH, basename)
+            self.hdul.writeto(filename)
+            return filename
+        except Exception as e:
+            logger.error(e)
+
+    def __getattr__(self, name):
+        if name == 'data':
+            return self.hdul
+        elif name == 'type':
+            return self.hdul.get('data_type', 'INVALID_TYPE')
+        elif name == 'filename':
+            return self.fname
+
+    def get_data(self):
+        return self.hdul
+
+
+class ScienceL1(ScienceData):
+    """
+    Tools to analyze L1 science data
+    """
+
+    def __init__(self, reqeust_id,fname):
+        print(reqeust_id, fname)
+        super().__init__(reqeust_id, fname)
+        self.data_type='ScienceL1'
+        self.pixel_count_rates=None
+        self.correct_pixel_count_rates=None
+        self.read_fits()
+        self.make_spectra()
+
+    def make_spectra(self, pixel_counts=None):
+        if pixel_counts is None:
+            pixel_counts=self.pixel_counts
+        self.spectrogram = np.sum(pixel_counts, axis=(1, 2))
+        self.count_rate_spectrogram = self.spectrogram / self.timedel[:, np.
+                                                                      newaxis]
+        self.spectrum = np.sum(pixel_counts, axis=(0, 1, 2))
+        self.mean_pixel_rate_spectra = np.sum(self.pixel_counts,
+                                              axis=0) / self.duration
+        self.mean_pixel_rate_spectra_err = np.sqrt(
+            self.mean_pixel_rate_spectra) / np.sqrt(self.duration)
+        #sum over all time bins and then divide them by the duration, counts per second
+
+    def solve_cfl(self, start_utc, end_utc, elow=0, eup=31, ax=None):
+        """calculate flare location using the online flare location solver.
+          
+        Args:
+            start_utc: str
+                ROI start time
+            end_utc: str
+                ROI end time
+            elow: int
+                ROI lower energy limit (science channel). 
+            eup: int
+                ROI upper energy limit (science channel). 
+        Returns:
+            cfl_loc: dict
+                containing coarse flare location as well as ephemeris and chisquare map
+
+        """
+        pass
+
+    def correct_live_time(self, clone=False):
+        """ Live time correction
+        Returns:
+          scienceL1 object
+        """
+
+        trig_tau = FPGA_TAU+ASIC_TAU
+        time_bins = self.time_bins[:, None]
+        photons_in = self.triggers/(time_bins-trig_tau*self.triggers)
+        #photon rate calculated using triggers 
+        cm= np.zeros((time_bins.size, 32))
+        time_bins = time_bins[:, :, None, None]
+        count_rates = self.pixel_counts/time_bins
+        for det in range(32):
+            trig_idx=inst.detector_id_to_trigger_index(det)
+
+            cm[:,det]= 1 + self.trigger_rates[:,trig_idx]*FPGA_TAU #live time per second 
+        self.correct_pixel_count_rates=count_rates*cm[:, :, None, None]/np.exp(-count_rates*ASIC_TAU)
+        return self
+
+    def peek(self,
+             plots=['spg', 'lc', 'spec', 'tbin', 'qllc'],
+             ax0=None,
+             ax1=None,
+             ax2=None,
+             ax3=None):
+        """
+            Create quick-look plots for the loaded science data
+        """
+        if not self.hdul:
+            logger.logger(f'Data not loaded. ')
+            return None
+        if isinstance(plots, str) and plots:
+            plots = plots.split(',')
+        if not self.data_loaded:
+            self.read_fits()
+            self.data_loaded = True
+
+        if 'spg' in plots:
+            if not ax0:
+                _, ax0 = plt.subplots()
+            X, Y = np.meshgrid(self.time,
+                               np.arange(self.min_ebin, self.max_ebin))
+            im = ax0.pcolormesh(
+                X, Y,
+                np.transpose(
+                    self.count_rate_spectrogram[:, self.min_ebin:self.max_ebin]
+                ))  #pixel summed energy spectrum
+            ax0.set_yticks(
+                self.energies['channel'][self.min_ebin:self.max_ebin:2])
+            ax0.set_yticklabels(
+                self.energy_bin_names[self.min_ebin:self.max_ebin:2])
+            fig = plt.gcf()
+            cbar = fig.colorbar(im, ax=ax0)
+            cbar.set_label('Counts')
+            ax0.set_title('Count rate spectrogram')
+            ax0.set_ylabel('Energy range(keV')
+            ax0.set_xlabel(f"T0 at {self.T0_utc} ")
+        if 'lc' in plots or 'qllc' in plots:
+            if not ax1:
+                _, ax1 = plt.subplots()
+            self.count_rate_spectrogram = self.spectrogram / self.timedel[:,
+                                                                          None]
+            if 'qllc' in plots:
+               ql_ebins=[(4, 10),(10 ,15 ),(15 ,25 ),(25 ,50), (50 ,84)]
+               labels=('4 - 10 keV','10 - 15 keV','15 - 25 keV','25 - 50 keV', '50 - 84 keV')
+               ql_sci_ebins=[self.get_energy_range_slicer(s[0],s[1]) for s in ql_ebins]
+               for ebin_slicer,label in zip(ql_sci_ebins, labels):
+                   ax1.plot(self.time,
+                        np.sum(self.count_rate_spectrogram[:, ebin_slicer], axis=1),label=label) 
+                   ax1.set_title(f'Detector summed count rates (L1 request #{self.request_id})')
+            else:
+                ax1.plot(
+                    self.time,
+                    self.count_rate_spectrogram[:, self.min_ebin:self.max_ebin])
+            #correct
+            ax1.set_ylabel('counts / sec')
+            #plt.legend(self.energy_bin_names, ncol=4)
+            ax1.set_yscale('log')
+            ax1.set_xlabel(f"seconds since {self.T0_utc} ")
+            plt.legend()
+        if 'spec' in plots:
+            if not ax2:
+                _, ax2 = plt.subplots()
+            ax2.plot(self.ebins_low, self.spectrum, drawstyle='steps-post')
+            #ax.set_xticks(self.data[3].data['channel'])
+            ax2.set_xscale('log')
+            ax2.set_yscale('log')
+            ax2.set_xlabel('Energy (keV)')
+            ax2.set_ylabel('Counts')
+        if 'tbin' in plots:
+            if not ax3:
+                _, ax3 = plt.subplots()
+            ax3.plot(self.time, self.timedel)
+            ax3.set_xlabel(f"T0 at {self.T0_utc} ")
+            ax3.set_ylabel('Integration time (sec)')
+            plt.suptitle(f'L1 request #{self.request_id}')
+
+        #plt.tight_layout()
+        return ax0, ax1, ax2, ax3
+
+
+class Spectrogram(ScienceData):
+
+
+    def __init__(self, reqeust_id,fname):
+        super().__init__(reqeust_id, fname)
+        self.data_type='Spectrogram'
+
+        self.read_fits()
+
+        self.spectrum = np.sum(self.counts, axis=0)
+
+    def peek(self, ax0=None, ax1=None, ax2=None, ax3=None):
+        """
+            preivew Science data
+        Arguments:
+        ax0: matplotlib axe 
+        ax0: matplotlib axe 
+        """
+        if not self.hdul:
+            print(f'Data not loaded. ')
+            return None
+
+        #((ax0, ax1), (ax2, ax3))=axs
+        if not any([ax0, ax1, ax2, ax3]):
+            _, ((ax0, ax1), (ax2, ax3)) = plt.subplots(2, 2, figsize=(8, 6))
+
+        if ax0:
+            X, Y = np.meshgrid(self.time,
+                               self.hdul['ENERGIES'].data['channel'])
+            im = ax0.pcolormesh(X, Y, np.transpose(
+                self.counts))  #pixel summed energy spectrum
+            ax0.set_yticks(self.hdul['ENERGIES'].data['channel'][::2])
+            ax0.set_yticklabels(self.energy_bin_names[::2])
+            fig = plt.gcf()
+            cbar = fig.colorbar(im, ax=ax0)
+            cbar.set_label('Counts')
+            ax0.set_title('Spectrogram')
+            ax0.set_ylabel('Energy range(keV')
+            ax0.set_xlabel(f"Seconds since {self.T0}s ")
+        if ax1:
+            #convert to 2d
+            ax1.plot(self.time, self.count_rates)
+            ax1.set_yscale('log')
+            ax1.set_ylabel('Counts / sec')
+            ax1.set_xlabel(f"Seconds since {self.T0}s ")
+        if ax2:
+            ax2.plot(self.ebins_low, self.spectrum, drawstyle='steps-post')
+            ax2.set_xscale('log')
+            ax2.set_yscale('log')
+            ax2.set_xlabel('Energy (keV)')
+            ax2.set_ylabel('Counts')
+        if ax3:
+            ax3.plot(self.time, self.timedel)
+            ax3.set_xlabel(f"Seconds since {self.T0}s ")
+            ax3.set_ylabel('Integration time (sec)')
+        plt.suptitle(f'L4 request #{self.request_id}')
+        plt.tight_layout()
+        return fig, ((ax0, ax1), (ax2, ax3))
+
+
+
+
+
+
+
+
+
+

Classes

+
+
+class ScienceData +(request_id=None, fname=None) +
+
+

Retrieve science data from stix data center or load fits file from local storage

+
+ +Expand source code + +
class ScienceData(sio.IO):
+    """
+      Retrieve science data from stix data center or load fits file from local storage
+
+    """
+    def __init__(self, request_id=None, fname=None):
+        self.fname = fname
+        self.data_type=None
+        if not fname:
+            raise Exception("FITS filename not specified")
+        self.request_id = request_id
+        self.time_shift_applied=0
+        self.hdul = fits.open(fname)
+        self.energies=[]
+        #self.read_data()
+    @property
+    def url(self):
+        req_id=self.request_id if not isinstance(self.request_id, list) else self.request_id[0]
+        link=f'{net.HOST}/view/list/bsd/uid/{req_id}'
+        return f'<a href="{link}">{link}</a>'
+
+    def read_fits(self, light_time_correction=True):
+        """
+            Read data  L1 compression level  FITS files
+            Parameters
+            ---------------------
+            light_time_correction: boolean
+                Correct light time difference
+        """
+
+        self.data = self.hdul['DATA'].data
+        self.T0_utc = self.hdul['PRIMARY'].header['DATE_BEG']
+        self.counts= self.data['counts']
+
+        self.light_time_del= self.hdul['PRIMARY'].header['EAR_TDEL']
+        self.light_time_corrected=light_time_correction
+
+        self.T0_unix = sdt.utc2unix(self.T0_utc)
+        self.triggers = self.data['triggers']
+        self.rcr = self.data['rcr']
+
+        self.timedel = self.data['timedel']
+        self.time = self.data['time']
+
+        if self.is_time_bin_shifted(self.T0_unix):
+            self.timedel = self.timedel[:-1]
+            self.time = self.time[1:]
+            logger.info('Shifted time bins have been corrected automatically!')
+            if self.data_type=='ScienceL1':
+                self.counts= self.counts[1:, :, :, :]
+                self.triggers = self.triggers[1:, :]
+                self.rcr = self.rcr[1:]
+            elif self.data_type=='Spectrogram':
+                self.counts= self.counts[1:, :]
+                self.triggers = self.triggers[1:]
+                #self.rcr = self.rcr[1:]
+
+        self.request_id = self.hdul['CONTROL'].data['request_id']
+        
+        self.time_shift_applied=0 if light_time_correction else self.light_time_del
+        self.datetime = [
+            sdt.unix2datetime(self.T0_unix + x + y * 0.5 + self.time_shift_applied)
+            for x, y in zip(self.time, self.timedel)
+        ]
+
+        self.duration = self.time[-1] - self.time[0] + (self.timedel[0] +
+                                                        self.timedel[-1]) / 2
+
+        self.energies = self.hdul['ENERGIES'].data
+
+        self.energy_bin_names = [
+            f'{a} - {b}'
+            for a, b in zip(self.energies['e_low'], self.energies['e_high'])
+        ]
+        self.energy_bin_mask = self.hdul["CONTROL"].data["energy_bin_mask"]
+
+        ebin_nz_idx =self.energy_bin_mask.nonzero()
+        self.max_ebin = np.max(ebin_nz_idx)  #indices of the non-zero elements
+        self.min_ebin = np.min(ebin_nz_idx)
+
+        self.ebins_mid = [
+            (a + b) / 2.
+            for a, b in zip(self.energies['e_low'], self.energies['e_high'])
+        ]
+        self.ebins_low, self.ebins_high = self.energies[
+            'e_low'], self.energies['e_high']
+
+        if self.data_type=='ScienceL1':
+            self.pixel_counts=self.counts
+            self.pixel_count_rates= self.pixel_counts/self.timedel[:,None,None, None]
+            self.trigger_rates = self.triggers / self.timedel[:, None] 
+        elif self.data_type=='Spectrogram':
+            self.count_rates= self.counts/self.timedel[:,None]
+            self.trigger_rates = self.triggers / self.timedel
+
+
+    def is_time_bin_shifted(self, unix_time):
+        """
+            Time bins are shifted in the data collected before 2021-12-09 due a bug in the flight software
+
+            Check if time bin is shifted in L1 data
+            Parameters
+                unix_time: float 
+            Returns
+                is_shifted: bool
+                    True if time bin is shifted else False
+        """
+
+        return (unix_time < sdt.utc2unix('2021-12-09T14:00:00'))
+
+    @classmethod
+    def from_sdc(cls, request_id):
+        '''
+        download science data file from stix data center
+        Parameters
+        ------
+        request_id :  int
+            bulk science data request unique ID; Unique IDs can be found on the science data web page  at stix data center
+
+
+        Returns
+        ------
+            science data class object
+        '''
+        request_id = request_id
+        fname = freq.fetch_bulk_science_by_request_id(request_id)
+        return cls(request_id, fname)
+
+    @classmethod
+    def from_fits(cls, filename):
+        """
+        factory class
+        Arguments
+        filename: str
+            FITS filename
+        """
+        request_id = None
+        return cls(request_id, filename)
+
+    def get_energy_range_slicer(self, elow, ehigh):
+        sel=[]
+        i=0
+        for a, b in zip(self.energies['e_low'], self.energies['e_high']):
+            if a>=elow  and b<=ehigh:
+                sel.append(i)
+            i+=1
+        return slice(min(sel),max(sel))
+
+
+
+    def rebin(self, ebins, min_tbin=0):
+        """
+         Energy rebin and time rebin
+         Arguments:
+         ebins: list or numpy array
+            energy bin range in units of keV
+         min_tbin: float
+            minimum time bin, shorter time bins are merged
+         Returns:
+            an object containing rebinned light curves
+        """
+        pass
+
+    def save(self, filename=None):
+        '''
+           Save data to a fits file
+           Parameters
+           filename : output fits filename
+           Returns
+           filename if success or error message
+        '''
+        if not isinstance(self.hdul, fits.hdu.hdulist.HDUList):
+            logger.error('The data object is a not a fits hdu object!')
+            return None
+        try:
+            if filename is None:
+                basename = self.hdul['PRIMARY'].header['FILENAME']
+                filename = PurePath(net.DOWNLOAD_PATH, basename)
+            self.hdul.writeto(filename)
+            return filename
+        except Exception as e:
+            logger.error(e)
+
+    def __getattr__(self, name):
+        if name == 'data':
+            return self.hdul
+        elif name == 'type':
+            return self.hdul.get('data_type', 'INVALID_TYPE')
+        elif name == 'filename':
+            return self.fname
+
+    def get_data(self):
+        return self.hdul
+
+

Ancestors

+ +

Subclasses

+ +

Static methods

+
+
+def from_fits(filename) +
+
+

factory class +Arguments +filename: str +FITS filename

+
+ +Expand source code + +
@classmethod
+def from_fits(cls, filename):
+    """
+    factory class
+    Arguments
+    filename: str
+        FITS filename
+    """
+    request_id = None
+    return cls(request_id, filename)
+
+
+
+def from_sdc(request_id) +
+
+

download science data file from stix data center +Parameters

+
+
+
request_id :  int
+
bulk science data request unique ID; Unique IDs can be found on the science data web page +at stix data center
+
+

Returns

+
science data class object
+
+
+ +Expand source code + +
@classmethod
+def from_sdc(cls, request_id):
+    '''
+    download science data file from stix data center
+    Parameters
+    ------
+    request_id :  int
+        bulk science data request unique ID; Unique IDs can be found on the science data web page  at stix data center
+
+
+    Returns
+    ------
+        science data class object
+    '''
+    request_id = request_id
+    fname = freq.fetch_bulk_science_by_request_id(request_id)
+    return cls(request_id, fname)
+
+
+
+

Instance variables

+
+
var url
+
+
+
+ +Expand source code + +
@property
+def url(self):
+    req_id=self.request_id if not isinstance(self.request_id, list) else self.request_id[0]
+    link=f'{net.HOST}/view/list/bsd/uid/{req_id}'
+    return f'<a href="{link}">{link}</a>'
+
+
+
+

Methods

+
+
+def get_data(self) +
+
+
+
+ +Expand source code + +
def get_data(self):
+    return self.hdul
+
+
+
+def get_energy_range_slicer(self, elow, ehigh) +
+
+
+
+ +Expand source code + +
def get_energy_range_slicer(self, elow, ehigh):
+    sel=[]
+    i=0
+    for a, b in zip(self.energies['e_low'], self.energies['e_high']):
+        if a>=elow  and b<=ehigh:
+            sel.append(i)
+        i+=1
+    return slice(min(sel),max(sel))
+
+
+
+def is_time_bin_shifted(self, unix_time) +
+
+

Time bins are shifted in the data collected before 2021-12-09 due a bug in the flight software

+

Check if time bin is shifted in L1 data +Parameters +unix_time: float +Returns +is_shifted: bool +True if time bin is shifted else False

+
+ +Expand source code + +
def is_time_bin_shifted(self, unix_time):
+    """
+        Time bins are shifted in the data collected before 2021-12-09 due a bug in the flight software
+
+        Check if time bin is shifted in L1 data
+        Parameters
+            unix_time: float 
+        Returns
+            is_shifted: bool
+                True if time bin is shifted else False
+    """
+
+    return (unix_time < sdt.utc2unix('2021-12-09T14:00:00'))
+
+
+
+def read_fits(self, light_time_correction=True) +
+
+

Read data +L1 compression level +FITS files +Parameters

+
+
+
light_time_correction : boolean
+
Correct light time difference
+
+
+ +Expand source code + +
def read_fits(self, light_time_correction=True):
+    """
+        Read data  L1 compression level  FITS files
+        Parameters
+        ---------------------
+        light_time_correction: boolean
+            Correct light time difference
+    """
+
+    self.data = self.hdul['DATA'].data
+    self.T0_utc = self.hdul['PRIMARY'].header['DATE_BEG']
+    self.counts= self.data['counts']
+
+    self.light_time_del= self.hdul['PRIMARY'].header['EAR_TDEL']
+    self.light_time_corrected=light_time_correction
+
+    self.T0_unix = sdt.utc2unix(self.T0_utc)
+    self.triggers = self.data['triggers']
+    self.rcr = self.data['rcr']
+
+    self.timedel = self.data['timedel']
+    self.time = self.data['time']
+
+    if self.is_time_bin_shifted(self.T0_unix):
+        self.timedel = self.timedel[:-1]
+        self.time = self.time[1:]
+        logger.info('Shifted time bins have been corrected automatically!')
+        if self.data_type=='ScienceL1':
+            self.counts= self.counts[1:, :, :, :]
+            self.triggers = self.triggers[1:, :]
+            self.rcr = self.rcr[1:]
+        elif self.data_type=='Spectrogram':
+            self.counts= self.counts[1:, :]
+            self.triggers = self.triggers[1:]
+            #self.rcr = self.rcr[1:]
+
+    self.request_id = self.hdul['CONTROL'].data['request_id']
+    
+    self.time_shift_applied=0 if light_time_correction else self.light_time_del
+    self.datetime = [
+        sdt.unix2datetime(self.T0_unix + x + y * 0.5 + self.time_shift_applied)
+        for x, y in zip(self.time, self.timedel)
+    ]
+
+    self.duration = self.time[-1] - self.time[0] + (self.timedel[0] +
+                                                    self.timedel[-1]) / 2
+
+    self.energies = self.hdul['ENERGIES'].data
+
+    self.energy_bin_names = [
+        f'{a} - {b}'
+        for a, b in zip(self.energies['e_low'], self.energies['e_high'])
+    ]
+    self.energy_bin_mask = self.hdul["CONTROL"].data["energy_bin_mask"]
+
+    ebin_nz_idx =self.energy_bin_mask.nonzero()
+    self.max_ebin = np.max(ebin_nz_idx)  #indices of the non-zero elements
+    self.min_ebin = np.min(ebin_nz_idx)
+
+    self.ebins_mid = [
+        (a + b) / 2.
+        for a, b in zip(self.energies['e_low'], self.energies['e_high'])
+    ]
+    self.ebins_low, self.ebins_high = self.energies[
+        'e_low'], self.energies['e_high']
+
+    if self.data_type=='ScienceL1':
+        self.pixel_counts=self.counts
+        self.pixel_count_rates= self.pixel_counts/self.timedel[:,None,None, None]
+        self.trigger_rates = self.triggers / self.timedel[:, None] 
+    elif self.data_type=='Spectrogram':
+        self.count_rates= self.counts/self.timedel[:,None]
+        self.trigger_rates = self.triggers / self.timedel
+
+
+
+def rebin(self, ebins, min_tbin=0) +
+
+

Energy rebin and time rebin +Arguments: +ebins: list or numpy array +energy bin range in units of keV +min_tbin: float +minimum time bin, shorter time bins are merged

+

Returns

+

an object containing rebinned light curves

+
+ +Expand source code + +
def rebin(self, ebins, min_tbin=0):
+    """
+     Energy rebin and time rebin
+     Arguments:
+     ebins: list or numpy array
+        energy bin range in units of keV
+     min_tbin: float
+        minimum time bin, shorter time bins are merged
+     Returns:
+        an object containing rebinned light curves
+    """
+    pass
+
+
+
+def save(self, filename=None) +
+
+

Save data to a fits file +Parameters +filename : output fits filename +Returns +filename if success or error message

+
+ +Expand source code + +
def save(self, filename=None):
+    '''
+       Save data to a fits file
+       Parameters
+       filename : output fits filename
+       Returns
+       filename if success or error message
+    '''
+    if not isinstance(self.hdul, fits.hdu.hdulist.HDUList):
+        logger.error('The data object is a not a fits hdu object!')
+        return None
+    try:
+        if filename is None:
+            basename = self.hdul['PRIMARY'].header['FILENAME']
+            filename = PurePath(net.DOWNLOAD_PATH, basename)
+        self.hdul.writeto(filename)
+        return filename
+    except Exception as e:
+        logger.error(e)
+
+
+
+

Inherited members

+ +
+
+class ScienceL1 +(reqeust_id, fname) +
+
+

Tools to analyze L1 science data

+
+ +Expand source code + +
class ScienceL1(ScienceData):
+    """
+    Tools to analyze L1 science data
+    """
+
+    def __init__(self, reqeust_id,fname):
+        print(reqeust_id, fname)
+        super().__init__(reqeust_id, fname)
+        self.data_type='ScienceL1'
+        self.pixel_count_rates=None
+        self.correct_pixel_count_rates=None
+        self.read_fits()
+        self.make_spectra()
+
+    def make_spectra(self, pixel_counts=None):
+        if pixel_counts is None:
+            pixel_counts=self.pixel_counts
+        self.spectrogram = np.sum(pixel_counts, axis=(1, 2))
+        self.count_rate_spectrogram = self.spectrogram / self.timedel[:, np.
+                                                                      newaxis]
+        self.spectrum = np.sum(pixel_counts, axis=(0, 1, 2))
+        self.mean_pixel_rate_spectra = np.sum(self.pixel_counts,
+                                              axis=0) / self.duration
+        self.mean_pixel_rate_spectra_err = np.sqrt(
+            self.mean_pixel_rate_spectra) / np.sqrt(self.duration)
+        #sum over all time bins and then divide them by the duration, counts per second
+
+    def solve_cfl(self, start_utc, end_utc, elow=0, eup=31, ax=None):
+        """calculate flare location using the online flare location solver.
+          
+        Args:
+            start_utc: str
+                ROI start time
+            end_utc: str
+                ROI end time
+            elow: int
+                ROI lower energy limit (science channel). 
+            eup: int
+                ROI upper energy limit (science channel). 
+        Returns:
+            cfl_loc: dict
+                containing coarse flare location as well as ephemeris and chisquare map
+
+        """
+        pass
+
+    def correct_live_time(self, clone=False):
+        """ Live time correction
+        Returns:
+          scienceL1 object
+        """
+
+        trig_tau = FPGA_TAU+ASIC_TAU
+        time_bins = self.time_bins[:, None]
+        photons_in = self.triggers/(time_bins-trig_tau*self.triggers)
+        #photon rate calculated using triggers 
+        cm= np.zeros((time_bins.size, 32))
+        time_bins = time_bins[:, :, None, None]
+        count_rates = self.pixel_counts/time_bins
+        for det in range(32):
+            trig_idx=inst.detector_id_to_trigger_index(det)
+
+            cm[:,det]= 1 + self.trigger_rates[:,trig_idx]*FPGA_TAU #live time per second 
+        self.correct_pixel_count_rates=count_rates*cm[:, :, None, None]/np.exp(-count_rates*ASIC_TAU)
+        return self
+
+    def peek(self,
+             plots=['spg', 'lc', 'spec', 'tbin', 'qllc'],
+             ax0=None,
+             ax1=None,
+             ax2=None,
+             ax3=None):
+        """
+            Create quick-look plots for the loaded science data
+        """
+        if not self.hdul:
+            logger.logger(f'Data not loaded. ')
+            return None
+        if isinstance(plots, str) and plots:
+            plots = plots.split(',')
+        if not self.data_loaded:
+            self.read_fits()
+            self.data_loaded = True
+
+        if 'spg' in plots:
+            if not ax0:
+                _, ax0 = plt.subplots()
+            X, Y = np.meshgrid(self.time,
+                               np.arange(self.min_ebin, self.max_ebin))
+            im = ax0.pcolormesh(
+                X, Y,
+                np.transpose(
+                    self.count_rate_spectrogram[:, self.min_ebin:self.max_ebin]
+                ))  #pixel summed energy spectrum
+            ax0.set_yticks(
+                self.energies['channel'][self.min_ebin:self.max_ebin:2])
+            ax0.set_yticklabels(
+                self.energy_bin_names[self.min_ebin:self.max_ebin:2])
+            fig = plt.gcf()
+            cbar = fig.colorbar(im, ax=ax0)
+            cbar.set_label('Counts')
+            ax0.set_title('Count rate spectrogram')
+            ax0.set_ylabel('Energy range(keV')
+            ax0.set_xlabel(f"T0 at {self.T0_utc} ")
+        if 'lc' in plots or 'qllc' in plots:
+            if not ax1:
+                _, ax1 = plt.subplots()
+            self.count_rate_spectrogram = self.spectrogram / self.timedel[:,
+                                                                          None]
+            if 'qllc' in plots:
+               ql_ebins=[(4, 10),(10 ,15 ),(15 ,25 ),(25 ,50), (50 ,84)]
+               labels=('4 - 10 keV','10 - 15 keV','15 - 25 keV','25 - 50 keV', '50 - 84 keV')
+               ql_sci_ebins=[self.get_energy_range_slicer(s[0],s[1]) for s in ql_ebins]
+               for ebin_slicer,label in zip(ql_sci_ebins, labels):
+                   ax1.plot(self.time,
+                        np.sum(self.count_rate_spectrogram[:, ebin_slicer], axis=1),label=label) 
+                   ax1.set_title(f'Detector summed count rates (L1 request #{self.request_id})')
+            else:
+                ax1.plot(
+                    self.time,
+                    self.count_rate_spectrogram[:, self.min_ebin:self.max_ebin])
+            #correct
+            ax1.set_ylabel('counts / sec')
+            #plt.legend(self.energy_bin_names, ncol=4)
+            ax1.set_yscale('log')
+            ax1.set_xlabel(f"seconds since {self.T0_utc} ")
+            plt.legend()
+        if 'spec' in plots:
+            if not ax2:
+                _, ax2 = plt.subplots()
+            ax2.plot(self.ebins_low, self.spectrum, drawstyle='steps-post')
+            #ax.set_xticks(self.data[3].data['channel'])
+            ax2.set_xscale('log')
+            ax2.set_yscale('log')
+            ax2.set_xlabel('Energy (keV)')
+            ax2.set_ylabel('Counts')
+        if 'tbin' in plots:
+            if not ax3:
+                _, ax3 = plt.subplots()
+            ax3.plot(self.time, self.timedel)
+            ax3.set_xlabel(f"T0 at {self.T0_utc} ")
+            ax3.set_ylabel('Integration time (sec)')
+            plt.suptitle(f'L1 request #{self.request_id}')
+
+        #plt.tight_layout()
+        return ax0, ax1, ax2, ax3
+
+

Ancestors

+ +

Methods

+
+
+def correct_live_time(self, clone=False) +
+
+

Live time correction

+

Returns

+

scienceL1 object

+
+ +Expand source code + +
def correct_live_time(self, clone=False):
+    """ Live time correction
+    Returns:
+      scienceL1 object
+    """
+
+    trig_tau = FPGA_TAU+ASIC_TAU
+    time_bins = self.time_bins[:, None]
+    photons_in = self.triggers/(time_bins-trig_tau*self.triggers)
+    #photon rate calculated using triggers 
+    cm= np.zeros((time_bins.size, 32))
+    time_bins = time_bins[:, :, None, None]
+    count_rates = self.pixel_counts/time_bins
+    for det in range(32):
+        trig_idx=inst.detector_id_to_trigger_index(det)
+
+        cm[:,det]= 1 + self.trigger_rates[:,trig_idx]*FPGA_TAU #live time per second 
+    self.correct_pixel_count_rates=count_rates*cm[:, :, None, None]/np.exp(-count_rates*ASIC_TAU)
+    return self
+
+
+
+def make_spectra(self, pixel_counts=None) +
+
+
+
+ +Expand source code + +
def make_spectra(self, pixel_counts=None):
+    if pixel_counts is None:
+        pixel_counts=self.pixel_counts
+    self.spectrogram = np.sum(pixel_counts, axis=(1, 2))
+    self.count_rate_spectrogram = self.spectrogram / self.timedel[:, np.
+                                                                  newaxis]
+    self.spectrum = np.sum(pixel_counts, axis=(0, 1, 2))
+    self.mean_pixel_rate_spectra = np.sum(self.pixel_counts,
+                                          axis=0) / self.duration
+    self.mean_pixel_rate_spectra_err = np.sqrt(
+        self.mean_pixel_rate_spectra) / np.sqrt(self.duration)
+    #sum over all time bins and then divide them by the duration, counts per second
+
+
+
+def peek(self, plots=['spg', 'lc', 'spec', 'tbin', 'qllc'], ax0=None, ax1=None, ax2=None, ax3=None) +
+
+

Create quick-look plots for the loaded science data

+
+ +Expand source code + +
def peek(self,
+         plots=['spg', 'lc', 'spec', 'tbin', 'qllc'],
+         ax0=None,
+         ax1=None,
+         ax2=None,
+         ax3=None):
+    """
+        Create quick-look plots for the loaded science data
+    """
+    if not self.hdul:
+        logger.logger(f'Data not loaded. ')
+        return None
+    if isinstance(plots, str) and plots:
+        plots = plots.split(',')
+    if not self.data_loaded:
+        self.read_fits()
+        self.data_loaded = True
+
+    if 'spg' in plots:
+        if not ax0:
+            _, ax0 = plt.subplots()
+        X, Y = np.meshgrid(self.time,
+                           np.arange(self.min_ebin, self.max_ebin))
+        im = ax0.pcolormesh(
+            X, Y,
+            np.transpose(
+                self.count_rate_spectrogram[:, self.min_ebin:self.max_ebin]
+            ))  #pixel summed energy spectrum
+        ax0.set_yticks(
+            self.energies['channel'][self.min_ebin:self.max_ebin:2])
+        ax0.set_yticklabels(
+            self.energy_bin_names[self.min_ebin:self.max_ebin:2])
+        fig = plt.gcf()
+        cbar = fig.colorbar(im, ax=ax0)
+        cbar.set_label('Counts')
+        ax0.set_title('Count rate spectrogram')
+        ax0.set_ylabel('Energy range(keV')
+        ax0.set_xlabel(f"T0 at {self.T0_utc} ")
+    if 'lc' in plots or 'qllc' in plots:
+        if not ax1:
+            _, ax1 = plt.subplots()
+        self.count_rate_spectrogram = self.spectrogram / self.timedel[:,
+                                                                      None]
+        if 'qllc' in plots:
+           ql_ebins=[(4, 10),(10 ,15 ),(15 ,25 ),(25 ,50), (50 ,84)]
+           labels=('4 - 10 keV','10 - 15 keV','15 - 25 keV','25 - 50 keV', '50 - 84 keV')
+           ql_sci_ebins=[self.get_energy_range_slicer(s[0],s[1]) for s in ql_ebins]
+           for ebin_slicer,label in zip(ql_sci_ebins, labels):
+               ax1.plot(self.time,
+                    np.sum(self.count_rate_spectrogram[:, ebin_slicer], axis=1),label=label) 
+               ax1.set_title(f'Detector summed count rates (L1 request #{self.request_id})')
+        else:
+            ax1.plot(
+                self.time,
+                self.count_rate_spectrogram[:, self.min_ebin:self.max_ebin])
+        #correct
+        ax1.set_ylabel('counts / sec')
+        #plt.legend(self.energy_bin_names, ncol=4)
+        ax1.set_yscale('log')
+        ax1.set_xlabel(f"seconds since {self.T0_utc} ")
+        plt.legend()
+    if 'spec' in plots:
+        if not ax2:
+            _, ax2 = plt.subplots()
+        ax2.plot(self.ebins_low, self.spectrum, drawstyle='steps-post')
+        #ax.set_xticks(self.data[3].data['channel'])
+        ax2.set_xscale('log')
+        ax2.set_yscale('log')
+        ax2.set_xlabel('Energy (keV)')
+        ax2.set_ylabel('Counts')
+    if 'tbin' in plots:
+        if not ax3:
+            _, ax3 = plt.subplots()
+        ax3.plot(self.time, self.timedel)
+        ax3.set_xlabel(f"T0 at {self.T0_utc} ")
+        ax3.set_ylabel('Integration time (sec)')
+        plt.suptitle(f'L1 request #{self.request_id}')
+
+    #plt.tight_layout()
+    return ax0, ax1, ax2, ax3
+
+
+
+def solve_cfl(self, start_utc, end_utc, elow=0, eup=31, ax=None) +
+
+

calculate flare location using the online flare location solver.

+

Args

+
+
start_utc
+
str +ROI start time
+
end_utc
+
str +ROI end time
+
elow
+
int +ROI lower energy limit (science channel).
+
eup
+
int +ROI upper energy limit (science channel).
+
+

Returns

+
+
cfl_loc
+
dict +containing coarse flare location as well as ephemeris and chisquare map
+
+
+ +Expand source code + +
def solve_cfl(self, start_utc, end_utc, elow=0, eup=31, ax=None):
+    """calculate flare location using the online flare location solver.
+      
+    Args:
+        start_utc: str
+            ROI start time
+        end_utc: str
+            ROI end time
+        elow: int
+            ROI lower energy limit (science channel). 
+        eup: int
+            ROI upper energy limit (science channel). 
+    Returns:
+        cfl_loc: dict
+            containing coarse flare location as well as ephemeris and chisquare map
+
+    """
+    pass
+
+
+
+

Inherited members

+ +
+
+class Spectrogram +(reqeust_id, fname) +
+
+

Retrieve science data from stix data center or load fits file from local storage

+
+ +Expand source code + +
class Spectrogram(ScienceData):
+
+
+    def __init__(self, reqeust_id,fname):
+        super().__init__(reqeust_id, fname)
+        self.data_type='Spectrogram'
+
+        self.read_fits()
+
+        self.spectrum = np.sum(self.counts, axis=0)
+
+    def peek(self, ax0=None, ax1=None, ax2=None, ax3=None):
+        """
+            preivew Science data
+        Arguments:
+        ax0: matplotlib axe 
+        ax0: matplotlib axe 
+        """
+        if not self.hdul:
+            print(f'Data not loaded. ')
+            return None
+
+        #((ax0, ax1), (ax2, ax3))=axs
+        if not any([ax0, ax1, ax2, ax3]):
+            _, ((ax0, ax1), (ax2, ax3)) = plt.subplots(2, 2, figsize=(8, 6))
+
+        if ax0:
+            X, Y = np.meshgrid(self.time,
+                               self.hdul['ENERGIES'].data['channel'])
+            im = ax0.pcolormesh(X, Y, np.transpose(
+                self.counts))  #pixel summed energy spectrum
+            ax0.set_yticks(self.hdul['ENERGIES'].data['channel'][::2])
+            ax0.set_yticklabels(self.energy_bin_names[::2])
+            fig = plt.gcf()
+            cbar = fig.colorbar(im, ax=ax0)
+            cbar.set_label('Counts')
+            ax0.set_title('Spectrogram')
+            ax0.set_ylabel('Energy range(keV')
+            ax0.set_xlabel(f"Seconds since {self.T0}s ")
+        if ax1:
+            #convert to 2d
+            ax1.plot(self.time, self.count_rates)
+            ax1.set_yscale('log')
+            ax1.set_ylabel('Counts / sec')
+            ax1.set_xlabel(f"Seconds since {self.T0}s ")
+        if ax2:
+            ax2.plot(self.ebins_low, self.spectrum, drawstyle='steps-post')
+            ax2.set_xscale('log')
+            ax2.set_yscale('log')
+            ax2.set_xlabel('Energy (keV)')
+            ax2.set_ylabel('Counts')
+        if ax3:
+            ax3.plot(self.time, self.timedel)
+            ax3.set_xlabel(f"Seconds since {self.T0}s ")
+            ax3.set_ylabel('Integration time (sec)')
+        plt.suptitle(f'L4 request #{self.request_id}')
+        plt.tight_layout()
+        return fig, ((ax0, ax1), (ax2, ax3))
+
+

Ancestors

+ +

Methods

+
+
+def peek(self, ax0=None, ax1=None, ax2=None, ax3=None) +
+
+

preivew Science data +Arguments: +ax0: matplotlib axe +ax0: matplotlib axe

+
+ +Expand source code + +
def peek(self, ax0=None, ax1=None, ax2=None, ax3=None):
+    """
+        preivew Science data
+    Arguments:
+    ax0: matplotlib axe 
+    ax0: matplotlib axe 
+    """
+    if not self.hdul:
+        print(f'Data not loaded. ')
+        return None
+
+    #((ax0, ax1), (ax2, ax3))=axs
+    if not any([ax0, ax1, ax2, ax3]):
+        _, ((ax0, ax1), (ax2, ax3)) = plt.subplots(2, 2, figsize=(8, 6))
+
+    if ax0:
+        X, Y = np.meshgrid(self.time,
+                           self.hdul['ENERGIES'].data['channel'])
+        im = ax0.pcolormesh(X, Y, np.transpose(
+            self.counts))  #pixel summed energy spectrum
+        ax0.set_yticks(self.hdul['ENERGIES'].data['channel'][::2])
+        ax0.set_yticklabels(self.energy_bin_names[::2])
+        fig = plt.gcf()
+        cbar = fig.colorbar(im, ax=ax0)
+        cbar.set_label('Counts')
+        ax0.set_title('Spectrogram')
+        ax0.set_ylabel('Energy range(keV')
+        ax0.set_xlabel(f"Seconds since {self.T0}s ")
+    if ax1:
+        #convert to 2d
+        ax1.plot(self.time, self.count_rates)
+        ax1.set_yscale('log')
+        ax1.set_ylabel('Counts / sec')
+        ax1.set_xlabel(f"Seconds since {self.T0}s ")
+    if ax2:
+        ax2.plot(self.ebins_low, self.spectrum, drawstyle='steps-post')
+        ax2.set_xscale('log')
+        ax2.set_yscale('log')
+        ax2.set_xlabel('Energy (keV)')
+        ax2.set_ylabel('Counts')
+    if ax3:
+        ax3.plot(self.time, self.timedel)
+        ax3.set_xlabel(f"Seconds since {self.T0}s ")
+        ax3.set_ylabel('Integration time (sec)')
+    plt.suptitle(f'L4 request #{self.request_id}')
+    plt.tight_layout()
+    return fig, ((ax0, ax1), (ax2, ax3))
+
+
+
+

Inherited members

+ +
+
+
+
+ +
+ + + \ No newline at end of file diff --git a/docs/stixdcpy/time.html b/docs/stixdcpy/time.html new file mode 100644 index 0000000..26c3e10 --- /dev/null +++ b/docs/stixdcpy/time.html @@ -0,0 +1,310 @@ + + + + + + +stixdcpy.time API documentation + + + + + + + + + + + +
+
+
+

Module stixdcpy.time

+
+
+
+ +Expand source code + +
#!/usr/bin/python3
+
+from datetime import datetime
+from dateutil import parser as dtparser
+
+
+def format_datetime(dt):
+    if isinstance(dt, datetime):
+        return dt.isoformat(timespec='milliseconds')
+    elif isinstance(dt, (int, float)):
+        return datetime.utcfromtimestamp(dt).isoformat(timespec='milliseconds')
+    elif isinstance(dt, str):
+        try:
+            return format_datetime(float(dt))
+        except ValueError:
+            return dt
+    else:
+        return '1970-01-01T00:00:00.000Z'
+
+
+def now():
+    return datetime.utcnow()
+
+
+def get_now(dtype='unix'):
+    utc_iso = datetime.utcnow().isoformat() + 'Z'
+    if dtype == 'unix':
+        return dtparser.parse(utc_iso).timestamp()
+    return utc_iso
+
+
+def utc2unix(utc):
+    if isinstance(utc, str):
+        if not utc.endswith('Z'):
+            utc += 'Z'
+        try:
+            return dtparser.parse(utc).timestamp()
+        except:
+            return 0
+    elif isinstance(utc, int) or isinstance(utc, float):
+        return utc
+    else:
+        return 0
+
+
+def utc2datetime(utc):
+    if not utc.endswith('Z'):
+        utc += 'Z'
+    try:
+        return dtparser.parse(utc)
+    except:
+        return None
+
+
+def unix2datetime(timestamp):
+    dt = None
+    if isinstance(timestamp, float):
+        dt = datetime.utcfromtimestamp(timestamp)
+    elif isinstance(timestamp, str):
+        try:
+            ts = float(timestamp)
+            dt = datetime.utcfromtimestamp(ts)
+        except ValueError:
+            dt = dtparser.parse(timestamp)
+    elif isinstance(timestamp, datetime.datetime):
+        dt = timestamp
+    return dt
+
+
+def datetime2unix(timestamp):
+    dt = None
+    if isinstance(timestamp, float):
+        dt = datetime.utcfromtimestamp(timestamp)
+    elif isinstance(timestamp, str):
+        try:
+            ts = float(timestamp)
+            dt = datetime.utcfromtimestamp(ts)
+        except ValueError:
+            dt = dtparser.parse(timestamp)
+    elif isinstance(timestamp, datetime.datetime):
+        dt = timestamp
+    if dt:
+        return dt.timestamp()
+    return 0
+
+
+def unix2utc(ts):
+    return datetime.utcfromtimestamp(ts).isoformat(timespec='milliseconds')
+
+
+def unix2datetime(unix_timestamp):
+    return datetime.utcfromtimestamp(unix_timestamp)
+
+
+
+
+
+
+
+

Functions

+
+
+def datetime2unix(timestamp) +
+
+
+
+ +Expand source code + +
def datetime2unix(timestamp):
+    dt = None
+    if isinstance(timestamp, float):
+        dt = datetime.utcfromtimestamp(timestamp)
+    elif isinstance(timestamp, str):
+        try:
+            ts = float(timestamp)
+            dt = datetime.utcfromtimestamp(ts)
+        except ValueError:
+            dt = dtparser.parse(timestamp)
+    elif isinstance(timestamp, datetime.datetime):
+        dt = timestamp
+    if dt:
+        return dt.timestamp()
+    return 0
+
+
+
+def format_datetime(dt) +
+
+
+
+ +Expand source code + +
def format_datetime(dt):
+    if isinstance(dt, datetime):
+        return dt.isoformat(timespec='milliseconds')
+    elif isinstance(dt, (int, float)):
+        return datetime.utcfromtimestamp(dt).isoformat(timespec='milliseconds')
+    elif isinstance(dt, str):
+        try:
+            return format_datetime(float(dt))
+        except ValueError:
+            return dt
+    else:
+        return '1970-01-01T00:00:00.000Z'
+
+
+
+def get_now(dtype='unix') +
+
+
+
+ +Expand source code + +
def get_now(dtype='unix'):
+    utc_iso = datetime.utcnow().isoformat() + 'Z'
+    if dtype == 'unix':
+        return dtparser.parse(utc_iso).timestamp()
+    return utc_iso
+
+
+
+def now() +
+
+
+
+ +Expand source code + +
def now():
+    return datetime.utcnow()
+
+
+
+def unix2datetime(unix_timestamp) +
+
+
+
+ +Expand source code + +
def unix2datetime(unix_timestamp):
+    return datetime.utcfromtimestamp(unix_timestamp)
+
+
+
+def unix2utc(ts) +
+
+
+
+ +Expand source code + +
def unix2utc(ts):
+    return datetime.utcfromtimestamp(ts).isoformat(timespec='milliseconds')
+
+
+
+def utc2datetime(utc) +
+
+
+
+ +Expand source code + +
def utc2datetime(utc):
+    if not utc.endswith('Z'):
+        utc += 'Z'
+    try:
+        return dtparser.parse(utc)
+    except:
+        return None
+
+
+
+def utc2unix(utc) +
+
+
+
+ +Expand source code + +
def utc2unix(utc):
+    if isinstance(utc, str):
+        if not utc.endswith('Z'):
+            utc += 'Z'
+        try:
+            return dtparser.parse(utc).timestamp()
+        except:
+            return 0
+    elif isinstance(utc, int) or isinstance(utc, float):
+        return utc
+    else:
+        return 0
+
+
+
+
+
+
+
+ +
+ + + \ No newline at end of file diff --git a/docs/stixdcpy/transmission.html b/docs/stixdcpy/transmission.html new file mode 100644 index 0000000..2474972 --- /dev/null +++ b/docs/stixdcpy/transmission.html @@ -0,0 +1,1066 @@ + + + + + + +stixdcpy.transmission API documentation + + + + + + + + + + + +
+
+
+

Module stixdcpy.transmission

+
+
+

calculation of stix transmission, taken from stixcore

+
+ +Expand source code + +
"""
+  calculation of stix transmission, taken from stixcore
+"""
+from collections import OrderedDict
+from functools import partial
+from stixdcpy import instrument as ins
+import astropy.units as u
+import numpy as np
+from astropy.table.table import Table
+from roentgen.absorption.material import Compound, MassAttenuationCoefficient, Material
+
+#from stixcore.config.reader import read_energy_channels
+
+__all__ = ['Transmission']
+
+MIL_SI = 0.0254 * u.mm
+
+# TODO move to configuration files
+COMPONENTS = OrderedDict([
+    ('front_window', [('solarblack', 0.005 * u.mm), ('be', 2 * u.mm)]),
+    ('rear_window', [('be', 1 * u.mm)]),
+    ('grid_covers', [('kapton', 4 * 2 * MIL_SI)]),
+    ('dem', [('kapton', 2 * 3 * MIL_SI)]),
+    ('attenuator', [('al', 0.6 * u.mm)]),
+    ('mli', [('al', 1000 * u.angstrom), ('kapton', 3 * MIL_SI),
+             ('al', 40 * 1000 * u.angstrom), ('mylar', 20 * 0.25 * MIL_SI),
+             ('pet', 21 * 0.005 * u.mm), ('kapton', 3 * MIL_SI),
+             ('al', 1000 * u.angstrom)]),
+    ('calibration_foil', [('al', 4 * 1000 * u.angstrom),
+                          ('kapton', 4 * 2 * MIL_SI)]),
+    ('dead_layer', [('te_o2', 392 * u.nm)]),
+])
+
+MATERIALS = OrderedDict([
+    ('al', ({
+        'Al': 1.0
+    }, 2.7 * u.g / u.cm**3)),
+    ('be', ({
+        'Be': 1.0
+    }, 1.85 * u.g / u.cm**3)),
+    ('kapton', ({
+        'H': 0.026362,
+        'C': 0.691133,
+        'N': 0.073270,
+        'O': 0.209235
+    }, 1.43 * u.g / u.cm**3)),
+    ('mylar', ({
+        'H': 0.041959,
+        'C': 0.625017,
+        'O': 0.333025
+    }, 1.38 * u.g / u.cm**3)),
+    ('pet', ({
+        'H': 0.041960,
+        'C': 0.625016,
+        'O': 0.333024
+    }, 1.370 * u.g / u.cm**3)),
+    ('solarblack_oxygen', ({
+        'H': 0.002,
+        'O': 0.415,
+        'Ca': 0.396,
+        'P': 0.187
+    }, 3.2 * u.g / u.cm**3)),
+    ('solarblack_carbon', ({
+        'C': 0.301,
+        'Ca': 0.503,
+        'P': 0.195
+    }, 3.2 * u.g / u.cm**3)),
+    ('te_o2', ({
+        'Te': 0.7995088158691722,
+        'O': 0.20049124678825841
+    }, 5.670 * u.g / u.cm**3)),
+])
+
+#    'Channel Number', 'Channel Edge', 'Energy Edge ', 'Elower', 'Eupper ',
+#    'BinWidth', 'dE/E', 'QL channel'
+default_energy_bins = [['0', '0', '0', '0', '4', '4', '2', 'n/a'],
+                       ['1', '1', '4', '4', '5', '1', '0.222', '0'],
+                       ['2', '2', '5', '5', '6', '1', '0.182', '0'],
+                       ['3', '3', '6', '6', '7', '1', '0.154', '0'],
+                       ['4', '4', '7', '7', '8', '1', '0.133', '0'],
+                       ['5', '5', '8', '8', '9', '1', '0.118', '0'],
+                       ['6', '6', '9', '9', '10', '1', '0.105', '0'],
+                       ['7', '7', '10', '10', '11', '1', '0.095', '1'],
+                       ['8', '8', '11', '11', '12', '1', '0.087', '1'],
+                       ['9', '9', '12', '12', '13', '1', '0.08', '1'],
+                       ['10', '10', '13', '13', '14', '1', '0.074', '1'],
+                       ['11', '11', '14', '14', '15', '1', '0.069', '1'],
+                       ['12', '12', '15', '15', '16', '1', '0.065', '2'],
+                       ['13', '13', '16', '16', '17', '1', '0.061', '2'],
+                       ['14', '14', '18', '18', '20', '2', '0.105', '2'],
+                       ['15', '15', '20', '20', '22', '2', '0.095', '2'],
+                       ['16', '16', '22', '22', '25', '3', '0.128', '2'],
+                       ['17', '17', '25', '25', '28', '3', '0.113', '3'],
+                       ['18', '18', '28', '28', '32', '4', '0.133', '3'],
+                       ['19', '19', '32', '32', '36', '4', '0.118', '3'],
+                       ['20', '20', '36', '36', '40', '4', '0.105', '3'],
+                       ['21', '21', '40', '40', '45', '5', '0.118', '3'],
+                       ['22', '22', '45', '45', '50', '5', '0.105', '3'],
+                       ['23', '23', '50', '50', '56', '6', '0.113', '4'],
+                       ['24', '24', '56', '56', '63', '7', '0.118', '4'],
+                       ['25', '25', '63', '63', '70', '7', '0.105', '4'],
+                       ['26', '26', '70', '70', '76', '6', '0.082', '4'],
+                       ['27', '27', '76', '76', '84', '8', '0.1', '4'],
+                       ['28', '28', '84', '84', '100', '16', '0.174', '4'],
+                       ['29', '29', '100', '100', '120', '20', '0.182', '4'],
+                       ['30', '30', '120', '120', '150', '30', '0.222', '4'],
+                       [
+                           '31', '31', '150', '150', 'maxADC', 'n/a', 'n/a',
+                           'n/a'
+                       ], ['', '32', 'max ADC', '', '', '', '', '']]
+
+
+def float_def(value, default=np.inf):
+    """Parse the value into a float or return the default value.
+
+    Parameters
+    ----------
+    value : `str`
+        the value to parse
+    default : `double`, optional
+        default value to return in case of pasring errors, by default numpy.inf
+
+    Returns
+    -------
+    `double`
+        the parsed value
+    """
+    try:
+        return float(value)
+    except ValueError:
+        return default
+
+
+def int_def(value, default=0):
+    """Parse the value into a int or return the default value.
+
+    Parameters
+    ----------
+    value : `str`
+        the value to parse
+    default : `int`, optional
+        default value to return in case of pasring errors, by default 0
+
+    Returns
+    -------
+    `int`
+        the parsed value
+    """
+    try:
+        return int(value)
+    except ValueError:
+        return default
+
+
+# TODO get file from config
+
+
+class Transmission:
+    """
+    Calculate the energy dependant transmission of X-ray through the instrument
+    """
+    def __init__(self, solarblack='solarblack_carbon'):
+        """
+        Create a new instance of the transmission with the given solar black composition.
+
+        Parameters
+        ----------
+
+        solarblack : `str` optional
+            The SolarBlack composition to use.
+        """
+        if solarblack not in ['solarblack_oxygen', 'solarblack_carbon']:
+            raise ValueError(
+                "solarblack must be either 'solarblack_oxygen' or "
+                "'solarblack_carbon'.")
+
+        self.solarblack = solarblack
+        self.materials = MATERIALS
+        self.components = COMPONENTS
+        self.components = dict()
+
+        for name, layers in COMPONENTS.items():
+            parts = []
+            for material, thickness in layers:
+                if material == 'solarblack':
+                    material = self.solarblack
+                mass_frac, den = MATERIALS[material]
+                if material == 'al':
+                    thickness = thickness * 0.8
+                parts.append(
+                    self.create_material(name=material,
+                                         fractional_masses=mass_frac,
+                                         thickness=thickness,
+                                         density=den))
+            self.components[name] = Compound(parts)
+
+    def get_transmission(self, energies, attenuator=False):
+        """
+        Get the transmission for each detector at the center of the given energy bins.
+
+        If energies are not supplied will evaluate at standard science energy channels
+
+        Parameters
+        ----------
+        energies : `astropy.units.Quantity`, optional
+            The energies to evaluate the transmission
+        attenuator : `bool`, optional
+            True for attenuator in X-ray path, False for attenuator not in X-ray path
+
+        Returns
+        -------
+        `astropy.table.Table`
+            Table containing the transmission values for each energy and detector
+        """
+        base_comps = [
+            self.components[name] for name in [
+                'front_window', 'rear_window', 'dem', 'mli',
+                'calibration_foil', 'dead_layer'
+            ]
+        ]
+
+        #if energies is None:
+        energies = energies * u.keV
+        #    self.energies = [ENERGY_CHANNELS[i].e_lower for i in range(1, 32)] * u.keV
+
+        if attenuator:
+            base_comps.append(self.components['attenuator'])
+
+        base = Compound(base_comps)
+        base_trans = base.transmission(energies)
+
+        fine = Compound(base_comps + [self.components['grid_covers']])
+        fine_trans = fine.transmission(energies)
+
+        # TODO need to move to configuration db
+        fine_grids = np.array([11, 13, 18, 12, 19, 17]) - 1
+        detector_transmission = Table()
+        # transmission['sci_channel'] = range(1, 31)
+        detector_transmission['energies'] = energies
+        for i in range(32):
+            name = f'det-{i}'
+            if np.isin(i, fine_grids):
+                detector_transmission[name] = fine_trans
+            else:
+                detector_transmission[name] = base_trans
+        return detector_transmission
+
+    def get_detector_transmission(self,
+                                  detector_id,
+                                  energy_bins,
+                                  attenuator=False):
+        '''
+            get transmission for detector
+            Arguments
+            ---------
+            detector:  ranges from 0...31 
+            energy_bins:   32 x 2 array like [[e_bin_0_low, ebin_0_up], ...[]]
+            Returns
+            --------
+            transmission for the energy bins
+            
+        '''
+        base_comps = [
+            self.components[name] for name in [
+                'front_window', 'rear_window', 'dem', 'mli',
+                'calibration_foil', 'dead_layer'
+            ]
+        ]
+
+        if attenuator:
+            base_comps.append(self.components['attenuator'])
+
+        fine_grids = [10, 12, 17, 11, 18, 16]
+
+        if detector_id in fine_grids:
+            comp = Compound(base_comps + [self.components['grid_covers']])
+        else:
+            comp = Compound(base_comps)
+
+        ebins_1d = energy_bins.reshape(-1) * u.keV
+        #convert energy bin ranges to 1d
+        det_trans = comp.transmission(ebins_1d)
+        mean_trans = np.mean(det_trans.reshape((-1, 2)), axis=1)
+        #calculate mean energy transmission factors for energy bins
+        return mean_trans
+
+    def get_transmission_by_component(self):
+        """
+        Get the contributions to the total transmission by broken down by component.
+
+        Returns
+        -------
+        `dict`
+            Entries are Compounds for each component
+        """
+        return self.components
+
+    def get_transmission_by_material(self):
+        """
+        Get the contribution to the transmission by total thickness for each material.
+
+        Layers of the same materials are combined to return one instance with the total thickness.
+
+        Returns
+        -------
+        `dict`
+            Entries are meterials with the total thickness for that material.
+        """
+        material_thickness = dict()
+        for name, layers in COMPONENTS.items():
+            for material_name, thickness in layers:
+                if material_name == 'solarblack':
+                    material_name = self.solarblack
+                if material_name in material_thickness.keys():
+                    material_thickness[material_name] += thickness.to('mm')
+                else:
+                    material_thickness[material_name] = thickness.to('mm')
+        res = {}
+        for name, thickness in material_thickness.items():
+            frac_mass, density = self.materials[name]
+            mat = self.create_material(name=name,
+                                       fractional_masses=frac_mass,
+                                       density=density,
+                                       thickness=thickness)
+            res[name] = mat
+
+        return res
+    @classmethod
+    def get_stix_ebins_transmission(cls, ebins=ins.ebins):
+        pass
+    @classmethod
+    def create_material(cls,
+                        name=None,
+                        fractional_masses=None,
+                        thickness=None,
+                        density=None):
+        """
+        Create a new material given the composition and fractional masses.
+
+        Parameters
+        ----------
+        name : `str`
+            Name of the meterial
+        fractional_masses : `dict`
+            The element and fractional masses of the material e.g. `{'H': 0.031, 'O': 0.969}`
+        thickness : `astropy.units.Quantity`
+            Thickness of the material
+        density : `astropy.units.Quantity`
+            Density of the material
+
+        Returns
+        -------
+        `roentgen.absorption.material.Material`
+            The material
+        """
+        material = Material('h', thickness, density)
+        material.name = name
+        # probably don't need this
+        material.density = density
+
+        # TODO remove in favour of upstream fix when completed
+        #  see https://github.com/ehsteve/roentgen/issues/26
+        def func(composition, e):
+            return sum([
+                MassAttenuationCoefficient(element).func(e) * frac_mass
+                for element, frac_mass in composition.items()
+            ])
+
+        material_func = partial(func, fractional_masses)
+
+        material.mass_attenuation_coefficient.func = material_func
+        return material
+
+
+def get_detector_absorption(energies=None):
+    mass_fraction = {'Te': 0.531644, 'Cd': 0.4683554}
+    density = 5.85 * u.g / u.cm**3
+    thickness = 1 * u.mm
+    material = Transmission.create_material(name='cdte',
+                                            fractional_masses=mass_fraction,
+                                            thickness=thickness,
+                                            density=density)
+    if energies is None:
+        energies = np.linspace(2, 150, 1001)
+    energies_keV = energies * u.keV
+    absorption = material.absorption(energies_keV)
+    return energies, absorption
+
+
+#def get_transmission(energies):
+#    return trans.get_transmission(energies)
+if __name__ == '__main__':
+    energies = np.linspace(2, 150, 1001)
+    #tr=Transmission()
+    #t=tr.get_transmission(energies)
+    #t.pprint()
+    #print(t['det-0'][0])
+    get_detector_absorption()
+
+
+
+
+
+
+
+
+
+

Classes

+
+
+class Transmission +(solarblack='solarblack_carbon') +
+
+

Calculate the energy dependant transmission of X-ray through the instrument

+

Create a new instance of the transmission with the given solar black composition.

+

Parameters

+
+
solarblack : str</code> optional
+
The SolarBlack composition to use.
+
+
+ +Expand source code + +
class Transmission:
+    """
+    Calculate the energy dependant transmission of X-ray through the instrument
+    """
+    def __init__(self, solarblack='solarblack_carbon'):
+        """
+        Create a new instance of the transmission with the given solar black composition.
+
+        Parameters
+        ----------
+
+        solarblack : `str` optional
+            The SolarBlack composition to use.
+        """
+        if solarblack not in ['solarblack_oxygen', 'solarblack_carbon']:
+            raise ValueError(
+                "solarblack must be either 'solarblack_oxygen' or "
+                "'solarblack_carbon'.")
+
+        self.solarblack = solarblack
+        self.materials = MATERIALS
+        self.components = COMPONENTS
+        self.components = dict()
+
+        for name, layers in COMPONENTS.items():
+            parts = []
+            for material, thickness in layers:
+                if material == 'solarblack':
+                    material = self.solarblack
+                mass_frac, den = MATERIALS[material]
+                if material == 'al':
+                    thickness = thickness * 0.8
+                parts.append(
+                    self.create_material(name=material,
+                                         fractional_masses=mass_frac,
+                                         thickness=thickness,
+                                         density=den))
+            self.components[name] = Compound(parts)
+
+    def get_transmission(self, energies, attenuator=False):
+        """
+        Get the transmission for each detector at the center of the given energy bins.
+
+        If energies are not supplied will evaluate at standard science energy channels
+
+        Parameters
+        ----------
+        energies : `astropy.units.Quantity`, optional
+            The energies to evaluate the transmission
+        attenuator : `bool`, optional
+            True for attenuator in X-ray path, False for attenuator not in X-ray path
+
+        Returns
+        -------
+        `astropy.table.Table`
+            Table containing the transmission values for each energy and detector
+        """
+        base_comps = [
+            self.components[name] for name in [
+                'front_window', 'rear_window', 'dem', 'mli',
+                'calibration_foil', 'dead_layer'
+            ]
+        ]
+
+        #if energies is None:
+        energies = energies * u.keV
+        #    self.energies = [ENERGY_CHANNELS[i].e_lower for i in range(1, 32)] * u.keV
+
+        if attenuator:
+            base_comps.append(self.components['attenuator'])
+
+        base = Compound(base_comps)
+        base_trans = base.transmission(energies)
+
+        fine = Compound(base_comps + [self.components['grid_covers']])
+        fine_trans = fine.transmission(energies)
+
+        # TODO need to move to configuration db
+        fine_grids = np.array([11, 13, 18, 12, 19, 17]) - 1
+        detector_transmission = Table()
+        # transmission['sci_channel'] = range(1, 31)
+        detector_transmission['energies'] = energies
+        for i in range(32):
+            name = f'det-{i}'
+            if np.isin(i, fine_grids):
+                detector_transmission[name] = fine_trans
+            else:
+                detector_transmission[name] = base_trans
+        return detector_transmission
+
+    def get_detector_transmission(self,
+                                  detector_id,
+                                  energy_bins,
+                                  attenuator=False):
+        '''
+            get transmission for detector
+            Arguments
+            ---------
+            detector:  ranges from 0...31 
+            energy_bins:   32 x 2 array like [[e_bin_0_low, ebin_0_up], ...[]]
+            Returns
+            --------
+            transmission for the energy bins
+            
+        '''
+        base_comps = [
+            self.components[name] for name in [
+                'front_window', 'rear_window', 'dem', 'mli',
+                'calibration_foil', 'dead_layer'
+            ]
+        ]
+
+        if attenuator:
+            base_comps.append(self.components['attenuator'])
+
+        fine_grids = [10, 12, 17, 11, 18, 16]
+
+        if detector_id in fine_grids:
+            comp = Compound(base_comps + [self.components['grid_covers']])
+        else:
+            comp = Compound(base_comps)
+
+        ebins_1d = energy_bins.reshape(-1) * u.keV
+        #convert energy bin ranges to 1d
+        det_trans = comp.transmission(ebins_1d)
+        mean_trans = np.mean(det_trans.reshape((-1, 2)), axis=1)
+        #calculate mean energy transmission factors for energy bins
+        return mean_trans
+
+    def get_transmission_by_component(self):
+        """
+        Get the contributions to the total transmission by broken down by component.
+
+        Returns
+        -------
+        `dict`
+            Entries are Compounds for each component
+        """
+        return self.components
+
+    def get_transmission_by_material(self):
+        """
+        Get the contribution to the transmission by total thickness for each material.
+
+        Layers of the same materials are combined to return one instance with the total thickness.
+
+        Returns
+        -------
+        `dict`
+            Entries are meterials with the total thickness for that material.
+        """
+        material_thickness = dict()
+        for name, layers in COMPONENTS.items():
+            for material_name, thickness in layers:
+                if material_name == 'solarblack':
+                    material_name = self.solarblack
+                if material_name in material_thickness.keys():
+                    material_thickness[material_name] += thickness.to('mm')
+                else:
+                    material_thickness[material_name] = thickness.to('mm')
+        res = {}
+        for name, thickness in material_thickness.items():
+            frac_mass, density = self.materials[name]
+            mat = self.create_material(name=name,
+                                       fractional_masses=frac_mass,
+                                       density=density,
+                                       thickness=thickness)
+            res[name] = mat
+
+        return res
+    @classmethod
+    def get_stix_ebins_transmission(cls, ebins=ins.ebins):
+        pass
+    @classmethod
+    def create_material(cls,
+                        name=None,
+                        fractional_masses=None,
+                        thickness=None,
+                        density=None):
+        """
+        Create a new material given the composition and fractional masses.
+
+        Parameters
+        ----------
+        name : `str`
+            Name of the meterial
+        fractional_masses : `dict`
+            The element and fractional masses of the material e.g. `{'H': 0.031, 'O': 0.969}`
+        thickness : `astropy.units.Quantity`
+            Thickness of the material
+        density : `astropy.units.Quantity`
+            Density of the material
+
+        Returns
+        -------
+        `roentgen.absorption.material.Material`
+            The material
+        """
+        material = Material('h', thickness, density)
+        material.name = name
+        # probably don't need this
+        material.density = density
+
+        # TODO remove in favour of upstream fix when completed
+        #  see https://github.com/ehsteve/roentgen/issues/26
+        def func(composition, e):
+            return sum([
+                MassAttenuationCoefficient(element).func(e) * frac_mass
+                for element, frac_mass in composition.items()
+            ])
+
+        material_func = partial(func, fractional_masses)
+
+        material.mass_attenuation_coefficient.func = material_func
+        return material
+
+

Static methods

+
+
+def create_material(name=None, fractional_masses=None, thickness=None, density=None) +
+
+

Create a new material given the composition and fractional masses.

+

Parameters

+
+
name : str
+
Name of the meterial
+
fractional_masses : dict
+
The element and fractional masses of the material e.g. {'H': 0.031, 'O': 0.969}
+
thickness : astropy.units.Quantity
+
Thickness of the material
+
density : astropy.units.Quantity
+
Density of the material
+
+

Returns

+

roentgen.absorption.material.Material +The material

+
+ +Expand source code + +
@classmethod
+def create_material(cls,
+                    name=None,
+                    fractional_masses=None,
+                    thickness=None,
+                    density=None):
+    """
+    Create a new material given the composition and fractional masses.
+
+    Parameters
+    ----------
+    name : `str`
+        Name of the meterial
+    fractional_masses : `dict`
+        The element and fractional masses of the material e.g. `{'H': 0.031, 'O': 0.969}`
+    thickness : `astropy.units.Quantity`
+        Thickness of the material
+    density : `astropy.units.Quantity`
+        Density of the material
+
+    Returns
+    -------
+    `roentgen.absorption.material.Material`
+        The material
+    """
+    material = Material('h', thickness, density)
+    material.name = name
+    # probably don't need this
+    material.density = density
+
+    # TODO remove in favour of upstream fix when completed
+    #  see https://github.com/ehsteve/roentgen/issues/26
+    def func(composition, e):
+        return sum([
+            MassAttenuationCoefficient(element).func(e) * frac_mass
+            for element, frac_mass in composition.items()
+        ])
+
+    material_func = partial(func, fractional_masses)
+
+    material.mass_attenuation_coefficient.func = material_func
+    return material
+
+
+
+def get_stix_ebins_transmission(ebins=array([[ +0., +4.], +[ +4., +5.], +[ +5., +6.], +[ +6., +7.], +[ +7., +8.], +[ +8., +9.], +[ +9., +10.], +[ 10., +11.], +[ 11., +12.], +[ 12., +13.], +[ 13., +14.], +[ 14., +15.], +[ 15., +16.], +[ 16., +18.], +[ 18., +20.], +[ 20., +22.], +[ 22., +25.], +[ 25., +28.], +[ 28., +32.], +[ 32., +36.], +[ 36., +40.], +[ 40., +45.], +[ 45., +50.], +[ 50., +56.], +[ 56., +63.], +[ 63., +70.], +[ 70., +76.], +[ 76., +84.], +[ 84., 100.], +[100., 120.], +[120., 150.], +[150., +inf]])) +
+
+
+
+ +Expand source code + +
@classmethod
+def get_stix_ebins_transmission(cls, ebins=ins.ebins):
+    pass
+
+
+
+

Methods

+
+
+def get_detector_transmission(self, detector_id, energy_bins, attenuator=False) +
+
+

get transmission for detector +Arguments

+
+
+
detector :  ranges from 0…31
+
 
+
energy_bins :  +32 x 2 array like [[e_bin_0_low, ebin_0_up], …[]]
+
 
+
+

Returns

+
+
transmission for the energy bins
+
 
+
+
+ +Expand source code + +
def get_detector_transmission(self,
+                              detector_id,
+                              energy_bins,
+                              attenuator=False):
+    '''
+        get transmission for detector
+        Arguments
+        ---------
+        detector:  ranges from 0...31 
+        energy_bins:   32 x 2 array like [[e_bin_0_low, ebin_0_up], ...[]]
+        Returns
+        --------
+        transmission for the energy bins
+        
+    '''
+    base_comps = [
+        self.components[name] for name in [
+            'front_window', 'rear_window', 'dem', 'mli',
+            'calibration_foil', 'dead_layer'
+        ]
+    ]
+
+    if attenuator:
+        base_comps.append(self.components['attenuator'])
+
+    fine_grids = [10, 12, 17, 11, 18, 16]
+
+    if detector_id in fine_grids:
+        comp = Compound(base_comps + [self.components['grid_covers']])
+    else:
+        comp = Compound(base_comps)
+
+    ebins_1d = energy_bins.reshape(-1) * u.keV
+    #convert energy bin ranges to 1d
+    det_trans = comp.transmission(ebins_1d)
+    mean_trans = np.mean(det_trans.reshape((-1, 2)), axis=1)
+    #calculate mean energy transmission factors for energy bins
+    return mean_trans
+
+
+
+def get_transmission(self, energies, attenuator=False) +
+
+

Get the transmission for each detector at the center of the given energy bins.

+

If energies are not supplied will evaluate at standard science energy channels

+

Parameters

+
+
energies : astropy.units.Quantity, optional
+
The energies to evaluate the transmission
+
attenuator : bool, optional
+
True for attenuator in X-ray path, False for attenuator not in X-ray path
+
+

Returns

+

astropy.table.Table +Table containing the transmission values for each energy and detector

+
+ +Expand source code + +
def get_transmission(self, energies, attenuator=False):
+    """
+    Get the transmission for each detector at the center of the given energy bins.
+
+    If energies are not supplied will evaluate at standard science energy channels
+
+    Parameters
+    ----------
+    energies : `astropy.units.Quantity`, optional
+        The energies to evaluate the transmission
+    attenuator : `bool`, optional
+        True for attenuator in X-ray path, False for attenuator not in X-ray path
+
+    Returns
+    -------
+    `astropy.table.Table`
+        Table containing the transmission values for each energy and detector
+    """
+    base_comps = [
+        self.components[name] for name in [
+            'front_window', 'rear_window', 'dem', 'mli',
+            'calibration_foil', 'dead_layer'
+        ]
+    ]
+
+    #if energies is None:
+    energies = energies * u.keV
+    #    self.energies = [ENERGY_CHANNELS[i].e_lower for i in range(1, 32)] * u.keV
+
+    if attenuator:
+        base_comps.append(self.components['attenuator'])
+
+    base = Compound(base_comps)
+    base_trans = base.transmission(energies)
+
+    fine = Compound(base_comps + [self.components['grid_covers']])
+    fine_trans = fine.transmission(energies)
+
+    # TODO need to move to configuration db
+    fine_grids = np.array([11, 13, 18, 12, 19, 17]) - 1
+    detector_transmission = Table()
+    # transmission['sci_channel'] = range(1, 31)
+    detector_transmission['energies'] = energies
+    for i in range(32):
+        name = f'det-{i}'
+        if np.isin(i, fine_grids):
+            detector_transmission[name] = fine_trans
+        else:
+            detector_transmission[name] = base_trans
+    return detector_transmission
+
+
+
+def get_transmission_by_component(self) +
+
+

Get the contributions to the total transmission by broken down by component.

+

Returns

+

dict +Entries are Compounds for each component

+
+ +Expand source code + +
def get_transmission_by_component(self):
+    """
+    Get the contributions to the total transmission by broken down by component.
+
+    Returns
+    -------
+    `dict`
+        Entries are Compounds for each component
+    """
+    return self.components
+
+
+
+def get_transmission_by_material(self) +
+
+

Get the contribution to the transmission by total thickness for each material.

+

Layers of the same materials are combined to return one instance with the total thickness.

+

Returns

+

dict +Entries are meterials with the total thickness for that material.

+
+ +Expand source code + +
def get_transmission_by_material(self):
+    """
+    Get the contribution to the transmission by total thickness for each material.
+
+    Layers of the same materials are combined to return one instance with the total thickness.
+
+    Returns
+    -------
+    `dict`
+        Entries are meterials with the total thickness for that material.
+    """
+    material_thickness = dict()
+    for name, layers in COMPONENTS.items():
+        for material_name, thickness in layers:
+            if material_name == 'solarblack':
+                material_name = self.solarblack
+            if material_name in material_thickness.keys():
+                material_thickness[material_name] += thickness.to('mm')
+            else:
+                material_thickness[material_name] = thickness.to('mm')
+    res = {}
+    for name, thickness in material_thickness.items():
+        frac_mass, density = self.materials[name]
+        mat = self.create_material(name=name,
+                                   fractional_masses=frac_mass,
+                                   density=density,
+                                   thickness=thickness)
+        res[name] = mat
+
+    return res
+
+
+
+
+
+
+
+ +
+ + + \ No newline at end of file diff --git a/docs/stixdcpy/transmission_backup.html b/docs/stixdcpy/transmission_backup.html new file mode 100644 index 0000000..d98be6c --- /dev/null +++ b/docs/stixdcpy/transmission_backup.html @@ -0,0 +1,1067 @@ + + + + + + +stixdcpy.transmission_backup API documentation + + + + + + + + + + + +
+
+
+

Module stixdcpy.transmission_backup

+
+
+
+ +Expand source code + +
from collections import OrderedDict
+from functools import partial
+
+import astropy.units as u
+import numpy as np
+from astropy.table.table import Table
+from roentgen.absorption.material import Compound, MassAttenuationCoefficient, Material
+
+#from stixcore.config.reader import read_energy_channels
+
+__all__ = ['Transmission']
+
+MIL_SI = 0.0254 * u.mm
+
+# TODO move to configuration files
+COMPONENTS = OrderedDict([
+    ('front_window', [('solarblack', 0.005 * u.mm), ('be', 2 * u.mm)]),
+    ('rear_window', [('be', 1 * u.mm)]),
+    ('grid_covers', [('kapton', 4 * 2 * MIL_SI)]),
+    ('dem', [('kapton', 2 * 3 * MIL_SI)]),
+    ('attenuator', [('al', 0.6 * u.mm)]),
+    ('mli', [('al', 1000 * u.angstrom), ('kapton', 3 * MIL_SI),
+             ('al', 40 * 1000 * u.angstrom), ('mylar', 20 * 0.25 * MIL_SI),
+             ('pet', 21 * 0.005 * u.mm), ('kapton', 3 * MIL_SI),
+             ('al', 1000 * u.angstrom)]),
+    ('calibration_foil', [('al', 4 * 1000 * u.angstrom),
+                          ('kapton', 4 * 2 * MIL_SI)]),
+    ('dead_layer', [('te_o2', 392 * u.nm)]),
+])
+
+MATERIALS = OrderedDict([
+    ('al', ({
+        'Al': 1.0
+    }, 2.7 * u.g / u.cm**3)),
+    ('be', ({
+        'Be': 1.0
+    }, 1.85 * u.g / u.cm**3)),
+    ('kapton', ({
+        'H': 0.026362,
+        'C': 0.691133,
+        'N': 0.073270,
+        'O': 0.209235
+    }, 1.43 * u.g / u.cm**3)),
+    ('mylar', ({
+        'H': 0.041959,
+        'C': 0.625017,
+        'O': 0.333025
+    }, 1.38 * u.g / u.cm**3)),
+    ('pet', ({
+        'H': 0.041960,
+        'C': 0.625016,
+        'O': 0.333024
+    }, 1.370 * u.g / u.cm**3)),
+    ('solarblack_oxygen', ({
+        'H': 0.002,
+        'O': 0.415,
+        'Ca': 0.396,
+        'P': 0.187
+    }, 3.2 * u.g / u.cm**3)),
+    ('solarblack_carbon', ({
+        'C': 0.301,
+        'Ca': 0.503,
+        'P': 0.195
+    }, 3.2 * u.g / u.cm**3)),
+    ('te_o2', ({
+        'Te': 0.7995088158691722,
+        'O': 0.20049124678825841
+    }, 5.670 * u.g / u.cm**3)),
+])
+
+#    'Channel Number', 'Channel Edge', 'Energy Edge ', 'Elower', 'Eupper ',
+#    'BinWidth', 'dE/E', 'QL channel'
+default_energy_bins = [['0', '0', '0', '0', '4', '4', '2', 'n/a'],
+                       ['1', '1', '4', '4', '5', '1', '0.222', '0'],
+                       ['2', '2', '5', '5', '6', '1', '0.182', '0'],
+                       ['3', '3', '6', '6', '7', '1', '0.154', '0'],
+                       ['4', '4', '7', '7', '8', '1', '0.133', '0'],
+                       ['5', '5', '8', '8', '9', '1', '0.118', '0'],
+                       ['6', '6', '9', '9', '10', '1', '0.105', '0'],
+                       ['7', '7', '10', '10', '11', '1', '0.095', '1'],
+                       ['8', '8', '11', '11', '12', '1', '0.087', '1'],
+                       ['9', '9', '12', '12', '13', '1', '0.08', '1'],
+                       ['10', '10', '13', '13', '14', '1', '0.074', '1'],
+                       ['11', '11', '14', '14', '15', '1', '0.069', '1'],
+                       ['12', '12', '15', '15', '16', '1', '0.065', '2'],
+                       ['13', '13', '16', '16', '17', '1', '0.061', '2'],
+                       ['14', '14', '18', '18', '20', '2', '0.105', '2'],
+                       ['15', '15', '20', '20', '22', '2', '0.095', '2'],
+                       ['16', '16', '22', '22', '25', '3', '0.128', '2'],
+                       ['17', '17', '25', '25', '28', '3', '0.113', '3'],
+                       ['18', '18', '28', '28', '32', '4', '0.133', '3'],
+                       ['19', '19', '32', '32', '36', '4', '0.118', '3'],
+                       ['20', '20', '36', '36', '40', '4', '0.105', '3'],
+                       ['21', '21', '40', '40', '45', '5', '0.118', '3'],
+                       ['22', '22', '45', '45', '50', '5', '0.105', '3'],
+                       ['23', '23', '50', '50', '56', '6', '0.113', '4'],
+                       ['24', '24', '56', '56', '63', '7', '0.118', '4'],
+                       ['25', '25', '63', '63', '70', '7', '0.105', '4'],
+                       ['26', '26', '70', '70', '76', '6', '0.082', '4'],
+                       ['27', '27', '76', '76', '84', '8', '0.1', '4'],
+                       ['28', '28', '84', '84', '100', '16', '0.174', '4'],
+                       ['29', '29', '100', '100', '120', '20', '0.182', '4'],
+                       ['30', '30', '120', '120', '150', '30', '0.222', '4'],
+                       [
+                           '31', '31', '150', '150', 'maxADC', 'n/a', 'n/a',
+                           'n/a'
+                       ], ['', '32', 'max ADC', '', '', '', '', '']]
+
+
+def float_def(value, default=np.inf):
+    """Parse the value into a float or return the default value.
+
+    Parameters
+    ----------
+    value : `str`
+        the value to parse
+    default : `double`, optional
+        default value to return in case of pasring errors, by default numpy.inf
+
+    Returns
+    -------
+    `double`
+        the parsed value
+    """
+    try:
+        return float(value)
+    except ValueError:
+        return default
+
+
+def int_def(value, default=0):
+    """Parse the value into a int or return the default value.
+
+    Parameters
+    ----------
+    value : `str`
+        the value to parse
+    default : `int`, optional
+        default value to return in case of pasring errors, by default 0
+
+    Returns
+    -------
+    `int`
+        the parsed value
+    """
+    try:
+        return int(value)
+    except ValueError:
+        return default
+
+
+# TODO get file from config
+'''
+class EnergyChannel:
+    """Represent a STIX energy channel.
+
+    Attributes
+    ----------
+    channel_edge : ´int´
+        chanel idx
+    energy_edge : ´int´
+        edge on energy axis
+    e_lower : ´float´
+        start of the energy band in keV
+    e_upper : ´float´
+        end of the energy band in keV
+    bin_width : ´float´
+        width of the energy band in keV
+    dE_E : ´float´
+        TODO
+    """
+
+    def __init__(self, *, channel_edge, energy_edge, e_lower, e_upper, bin_width, dE_E):
+        self.channel_edge = channel_edge
+        self.energy_edge = energy_edge
+        self.e_lower = e_lower
+        self.e_upper = e_upper
+        self.bin_width = bin_width
+        self.dE_E = dE_E
+
+    def __repr__(self):
+        return f'{self.__class__.__name__}(channel_edge={self.channel_edge}, ' +\
+               f'energy_edge={self.energy_edge}, e_lower={self.e_lower}, e_upper={self.e_upper},' +\
+               f' bin_width={self.bin_width}, dE_E={self.dE_E})'
+def read_energy_channels(energy_bin_config=default_energy_bins):
+    """Read the energy channels from the configuration file.
+
+    Parameters
+    ----------
+    path : `pathlib.Path`
+        path to the config file
+
+    Returns
+    -------
+    `dict`
+        set of `EnergyChannel` accessible by index
+    """
+    energy_channels = dict()
+    if energy_bin_config:
+        for row in energy_bin_config:
+        
+            idx = int_def(row[0], -1)
+            if idx == -1:
+                continue
+            energy_channels[idx] = EnergyChannel(
+                channel_edge=int_def(row[1]),
+                energy_edge=int_def(row[2]),
+                e_lower=float_def(row[3]),
+                e_upper=float_def(row[4]),
+                bin_width=float_def(row[5]),
+                dE_E=float_def(row[6])
+            )
+
+    return energy_channels
+
+#ENERGY_CHANNELS = read_energy_channels(default_energy_bins)
+'''
+
+
+class Transmission:
+    """
+    Calculate the energy dependant transmission of X-ray through the instrument
+    """
+    def __init__(self, solarblack='solarblack_carbon'):
+        """
+        Create a new instance of the transmission with the given solar black composition.
+
+        Parameters
+        ----------
+
+        solarblack : `str` optional
+            The SolarBlack composition to use.
+        """
+        if solarblack not in ['solarblack_oxygen', 'solarblack_carbon']:
+            raise ValueError(
+                "solarblack must be either 'solarblack_oxygen' or "
+                "'solarblack_carbon'.")
+
+        self.solarblack = solarblack
+        self.materials = MATERIALS
+        self.components = COMPONENTS
+        self.components = dict()
+
+        for name, layers in COMPONENTS.items():
+            parts = []
+            for material, thickness in layers:
+                if material == 'solarblack':
+                    material = self.solarblack
+                mass_frac, den = MATERIALS[material]
+                if material == 'al':
+                    thickness = thickness * 0.8
+                parts.append(
+                    self.create_material(name=material,
+                                         fractional_masses=mass_frac,
+                                         thickness=thickness,
+                                         density=den))
+            self.components[name] = Compound(parts)
+
+    def get_transmission(self, energies, attenuator=False):
+        """
+        Get the transmission for each detector at the center of the given energy bins.
+
+        If energies are not supplied will evaluate at standard science energy channels
+
+        Parameters
+        ----------
+        energies : `astropy.units.Quantity`, optional
+            The energies to evaluate the transmission
+        attenuator : `bool`, optional
+            True for attenuator in X-ray path, False for attenuator not in X-ray path
+
+        Returns
+        -------
+        `astropy.table.Table`
+            Table containing the transmission values for each energy and detector
+        """
+        base_comps = [
+            self.components[name] for name in [
+                'front_window', 'rear_window', 'dem', 'mli',
+                'calibration_foil', 'dead_layer'
+            ]
+        ]
+
+        #if energies is None:
+        energies = energies * u.keV
+        #    self.energies = [ENERGY_CHANNELS[i].e_lower for i in range(1, 32)] * u.keV
+
+        if attenuator:
+            base_comps.append(self.components['attenuator'])
+
+        base = Compound(base_comps)
+        base_trans = base.transmission(energies)
+
+        fine = Compound(base_comps + [self.components['grid_covers']])
+        fine_trans = fine.transmission(energies)
+
+        # TODO need to move to configuration db
+        fine_grids = np.array([11, 13, 18, 12, 19, 17]) - 1
+        detector_transmission = Table()
+        # transmission['sci_channel'] = range(1, 31)
+        detector_transmission['energies'] = energies
+        for i in range(32):
+            name = f'det-{i}'
+            if np.isin(i, fine_grids):
+                detector_transmission[name] = fine_trans
+            else:
+                detector_transmission[name] = base_trans
+        return detector_transmission
+
+    def get_detector_transmission(self,
+                                  detector_id,
+                                  energy_bins,
+                                  attenuator=False):
+        '''
+            get transmission for detector
+            Arguments
+            ---------
+            detector:  ranges from 0...31 
+            energy_bins:   32 x 2 array like [[e_bin_0_low, ebin_0_up], ...[]]
+            Returns
+            --------
+            transmission for the energy bins
+            
+        '''
+        base_comps = [
+            self.components[name] for name in [
+                'front_window', 'rear_window', 'dem', 'mli',
+                'calibration_foil', 'dead_layer'
+            ]
+        ]
+
+        if attenuator:
+            base_comps.append(self.components['attenuator'])
+
+        fine_grids = [10, 12, 17, 11, 18, 16]
+
+        if detector_id in fine_grids:
+            comp = Compound(base_comps + [self.components['grid_covers']])
+        else:
+            comp = Compound(base_comps)
+
+        ebins_1d = energy_bins.reshape(-1) * u.keV
+        #convert energy bin ranges to 1d
+        det_trans = comp.transmission(ebins_1d)
+        mean_trans = np.mean(det_trans.reshape((-1, 2)), axis=1)
+        #calculate mean energy transmission factors for energy bins
+        return mean_trans
+
+    def get_transmission_by_component(self):
+        """
+        Get the contributions to the total transmission by broken down by component.
+
+        Returns
+        -------
+        `dict`
+            Entries are Compounds for each component
+        """
+        return self.components
+
+    def get_transmission_by_material(self):
+        """
+        Get the contribution to the transmission by total thickness for each material.
+
+        Layers of the same materials are combined to return one instance with the total thickness.
+
+        Returns
+        -------
+        `dict`
+            Entries are meterials with the total thickness for that material.
+        """
+        material_thickness = dict()
+        for name, layers in COMPONENTS.items():
+            for material_name, thickness in layers:
+                if material_name == 'solarblack':
+                    material_name = self.solarblack
+                if material_name in material_thickness.keys():
+                    material_thickness[material_name] += thickness.to('mm')
+                else:
+                    material_thickness[material_name] = thickness.to('mm')
+        res = {}
+        for name, thickness in material_thickness.items():
+            frac_mass, density = self.materials[name]
+            mat = self.create_material(name=name,
+                                       fractional_masses=frac_mass,
+                                       density=density,
+                                       thickness=thickness)
+            res[name] = mat
+
+        return res
+
+    @classmethod
+    def create_material(cls,
+                        name=None,
+                        fractional_masses=None,
+                        thickness=None,
+                        density=None):
+        """
+        Create a new material given the composition and fractional masses.
+
+        Parameters
+        ----------
+        name : `str`
+            Name of the meterial
+        fractional_masses : `dict`
+            The element and fractional masses of the material e.g. `{'H': 0.031, 'O': 0.969}`
+        thickness : `astropy.units.Quantity`
+            Thickness of the material
+        density : `astropy.units.Quantity`
+            Density of the material
+
+        Returns
+        -------
+        `roentgen.absorption.material.Material`
+            The material
+        """
+        material = Material('h', thickness, density)
+        material.name = name
+        # probably don't need this
+        material.density = density
+
+        # TODO remove in favour of upstream fix when completed
+        #  see https://github.com/ehsteve/roentgen/issues/26
+        def func(composition, e):
+            return sum([
+                MassAttenuationCoefficient(element).func(e) * frac_mass
+                for element, frac_mass in composition.items()
+            ])
+
+        material_func = partial(func, fractional_masses)
+
+        material.mass_attenuation_coefficient.func = material_func
+        return material
+
+
+"""
+def generate_transmission_tables():
+    from datetime import datetime
+    cur_date = datetime.now().strftime('%Y%m%d')
+    datetime.now().strftime('%Y%m%d')
+    trans = Transmission()
+    norm_sci_energies = trans.get_transmission()
+    norm_sci_energies.write(f'stix_transmission_sci_energies_{cur_date}.csv')
+    norm_high_res = trans.get_transmission(energies=energies)
+    norm_high_res.write(f'stix_transmission_highres_{cur_date}.csv')
+
+    comps = trans.get_transmission_by_component()
+
+    comps_sci_energies = Table([c.transmission(trans.energies) for c in comps.values()],
+                               names=[k for k in comps.keys()])
+    comps_sci_energies['energy'] = trans.energies
+    comps_sci_energies.write(f'stix_transmission_by_component_sci_energies_{cur_date}.csv')
+
+    comps_highres = Table([c.transmission(energies) for c in comps.values()],
+                          names=[k for k in comps.keys()])
+    comps_highres['energy'] = energies
+    comps_highres.write(f'stix_transmission_by_component_highres_{cur_date}.csv')
+
+generate_transmission_tables()
+"""
+
+
+def get_detector_absorption(energies=None):
+    mass_fraction = {'Te': 0.531644, 'Cd': 0.4683554}
+    desity = 5.85 * u.g / u.cm**3
+    thickness = 1 * u.mm
+    material = Transmission.create_material(name='cdte',
+                                            fractional_masses=mass_fraction,
+                                            thickness=thickness,
+                                            density=density)
+    if energies is None:
+        energies = np.linspace(2, 150, 1001)
+        energies = energies * u.keV
+    absorption = material.absorption(energies)
+    print(absorption)
+
+
+#def get_transmission(energies):
+#    return trans.get_transmission(energies)
+if __name__ == '__main__':
+    energies = np.linspace(2, 150, 1001)
+    tr = Transmission()
+    t = tr.get_transmission(energies)
+    t.pprint()
+    print(t['det-0'][0])
+
+
+
+
+
+
+
+
+
+

Classes

+
+
+class Transmission +(solarblack='solarblack_carbon') +
+
+

Calculate the energy dependant transmission of X-ray through the instrument

+

Create a new instance of the transmission with the given solar black composition.

+

Parameters

+
+
solarblack : str</code> optional
+
The SolarBlack composition to use.
+
+
+ +Expand source code + +
class Transmission:
+    """
+    Calculate the energy dependant transmission of X-ray through the instrument
+    """
+    def __init__(self, solarblack='solarblack_carbon'):
+        """
+        Create a new instance of the transmission with the given solar black composition.
+
+        Parameters
+        ----------
+
+        solarblack : `str` optional
+            The SolarBlack composition to use.
+        """
+        if solarblack not in ['solarblack_oxygen', 'solarblack_carbon']:
+            raise ValueError(
+                "solarblack must be either 'solarblack_oxygen' or "
+                "'solarblack_carbon'.")
+
+        self.solarblack = solarblack
+        self.materials = MATERIALS
+        self.components = COMPONENTS
+        self.components = dict()
+
+        for name, layers in COMPONENTS.items():
+            parts = []
+            for material, thickness in layers:
+                if material == 'solarblack':
+                    material = self.solarblack
+                mass_frac, den = MATERIALS[material]
+                if material == 'al':
+                    thickness = thickness * 0.8
+                parts.append(
+                    self.create_material(name=material,
+                                         fractional_masses=mass_frac,
+                                         thickness=thickness,
+                                         density=den))
+            self.components[name] = Compound(parts)
+
+    def get_transmission(self, energies, attenuator=False):
+        """
+        Get the transmission for each detector at the center of the given energy bins.
+
+        If energies are not supplied will evaluate at standard science energy channels
+
+        Parameters
+        ----------
+        energies : `astropy.units.Quantity`, optional
+            The energies to evaluate the transmission
+        attenuator : `bool`, optional
+            True for attenuator in X-ray path, False for attenuator not in X-ray path
+
+        Returns
+        -------
+        `astropy.table.Table`
+            Table containing the transmission values for each energy and detector
+        """
+        base_comps = [
+            self.components[name] for name in [
+                'front_window', 'rear_window', 'dem', 'mli',
+                'calibration_foil', 'dead_layer'
+            ]
+        ]
+
+        #if energies is None:
+        energies = energies * u.keV
+        #    self.energies = [ENERGY_CHANNELS[i].e_lower for i in range(1, 32)] * u.keV
+
+        if attenuator:
+            base_comps.append(self.components['attenuator'])
+
+        base = Compound(base_comps)
+        base_trans = base.transmission(energies)
+
+        fine = Compound(base_comps + [self.components['grid_covers']])
+        fine_trans = fine.transmission(energies)
+
+        # TODO need to move to configuration db
+        fine_grids = np.array([11, 13, 18, 12, 19, 17]) - 1
+        detector_transmission = Table()
+        # transmission['sci_channel'] = range(1, 31)
+        detector_transmission['energies'] = energies
+        for i in range(32):
+            name = f'det-{i}'
+            if np.isin(i, fine_grids):
+                detector_transmission[name] = fine_trans
+            else:
+                detector_transmission[name] = base_trans
+        return detector_transmission
+
+    def get_detector_transmission(self,
+                                  detector_id,
+                                  energy_bins,
+                                  attenuator=False):
+        '''
+            get transmission for detector
+            Arguments
+            ---------
+            detector:  ranges from 0...31 
+            energy_bins:   32 x 2 array like [[e_bin_0_low, ebin_0_up], ...[]]
+            Returns
+            --------
+            transmission for the energy bins
+            
+        '''
+        base_comps = [
+            self.components[name] for name in [
+                'front_window', 'rear_window', 'dem', 'mli',
+                'calibration_foil', 'dead_layer'
+            ]
+        ]
+
+        if attenuator:
+            base_comps.append(self.components['attenuator'])
+
+        fine_grids = [10, 12, 17, 11, 18, 16]
+
+        if detector_id in fine_grids:
+            comp = Compound(base_comps + [self.components['grid_covers']])
+        else:
+            comp = Compound(base_comps)
+
+        ebins_1d = energy_bins.reshape(-1) * u.keV
+        #convert energy bin ranges to 1d
+        det_trans = comp.transmission(ebins_1d)
+        mean_trans = np.mean(det_trans.reshape((-1, 2)), axis=1)
+        #calculate mean energy transmission factors for energy bins
+        return mean_trans
+
+    def get_transmission_by_component(self):
+        """
+        Get the contributions to the total transmission by broken down by component.
+
+        Returns
+        -------
+        `dict`
+            Entries are Compounds for each component
+        """
+        return self.components
+
+    def get_transmission_by_material(self):
+        """
+        Get the contribution to the transmission by total thickness for each material.
+
+        Layers of the same materials are combined to return one instance with the total thickness.
+
+        Returns
+        -------
+        `dict`
+            Entries are meterials with the total thickness for that material.
+        """
+        material_thickness = dict()
+        for name, layers in COMPONENTS.items():
+            for material_name, thickness in layers:
+                if material_name == 'solarblack':
+                    material_name = self.solarblack
+                if material_name in material_thickness.keys():
+                    material_thickness[material_name] += thickness.to('mm')
+                else:
+                    material_thickness[material_name] = thickness.to('mm')
+        res = {}
+        for name, thickness in material_thickness.items():
+            frac_mass, density = self.materials[name]
+            mat = self.create_material(name=name,
+                                       fractional_masses=frac_mass,
+                                       density=density,
+                                       thickness=thickness)
+            res[name] = mat
+
+        return res
+
+    @classmethod
+    def create_material(cls,
+                        name=None,
+                        fractional_masses=None,
+                        thickness=None,
+                        density=None):
+        """
+        Create a new material given the composition and fractional masses.
+
+        Parameters
+        ----------
+        name : `str`
+            Name of the meterial
+        fractional_masses : `dict`
+            The element and fractional masses of the material e.g. `{'H': 0.031, 'O': 0.969}`
+        thickness : `astropy.units.Quantity`
+            Thickness of the material
+        density : `astropy.units.Quantity`
+            Density of the material
+
+        Returns
+        -------
+        `roentgen.absorption.material.Material`
+            The material
+        """
+        material = Material('h', thickness, density)
+        material.name = name
+        # probably don't need this
+        material.density = density
+
+        # TODO remove in favour of upstream fix when completed
+        #  see https://github.com/ehsteve/roentgen/issues/26
+        def func(composition, e):
+            return sum([
+                MassAttenuationCoefficient(element).func(e) * frac_mass
+                for element, frac_mass in composition.items()
+            ])
+
+        material_func = partial(func, fractional_masses)
+
+        material.mass_attenuation_coefficient.func = material_func
+        return material
+
+

Static methods

+
+
+def create_material(name=None, fractional_masses=None, thickness=None, density=None) +
+
+

Create a new material given the composition and fractional masses.

+

Parameters

+
+
name : str
+
Name of the meterial
+
fractional_masses : dict
+
The element and fractional masses of the material e.g. {'H': 0.031, 'O': 0.969}
+
thickness : astropy.units.Quantity
+
Thickness of the material
+
density : astropy.units.Quantity
+
Density of the material
+
+

Returns

+

roentgen.absorption.material.Material +The material

+
+ +Expand source code + +
@classmethod
+def create_material(cls,
+                    name=None,
+                    fractional_masses=None,
+                    thickness=None,
+                    density=None):
+    """
+    Create a new material given the composition and fractional masses.
+
+    Parameters
+    ----------
+    name : `str`
+        Name of the meterial
+    fractional_masses : `dict`
+        The element and fractional masses of the material e.g. `{'H': 0.031, 'O': 0.969}`
+    thickness : `astropy.units.Quantity`
+        Thickness of the material
+    density : `astropy.units.Quantity`
+        Density of the material
+
+    Returns
+    -------
+    `roentgen.absorption.material.Material`
+        The material
+    """
+    material = Material('h', thickness, density)
+    material.name = name
+    # probably don't need this
+    material.density = density
+
+    # TODO remove in favour of upstream fix when completed
+    #  see https://github.com/ehsteve/roentgen/issues/26
+    def func(composition, e):
+        return sum([
+            MassAttenuationCoefficient(element).func(e) * frac_mass
+            for element, frac_mass in composition.items()
+        ])
+
+    material_func = partial(func, fractional_masses)
+
+    material.mass_attenuation_coefficient.func = material_func
+    return material
+
+
+
+

Methods

+
+
+def get_detector_transmission(self, detector_id, energy_bins, attenuator=False) +
+
+

get transmission for detector +Arguments

+
+
+
detector :  ranges from 0…31
+
 
+
energy_bins :  +32 x 2 array like [[e_bin_0_low, ebin_0_up], …[]]
+
 
+
+

Returns

+
+
transmission for the energy bins
+
 
+
+
+ +Expand source code + +
def get_detector_transmission(self,
+                              detector_id,
+                              energy_bins,
+                              attenuator=False):
+    '''
+        get transmission for detector
+        Arguments
+        ---------
+        detector:  ranges from 0...31 
+        energy_bins:   32 x 2 array like [[e_bin_0_low, ebin_0_up], ...[]]
+        Returns
+        --------
+        transmission for the energy bins
+        
+    '''
+    base_comps = [
+        self.components[name] for name in [
+            'front_window', 'rear_window', 'dem', 'mli',
+            'calibration_foil', 'dead_layer'
+        ]
+    ]
+
+    if attenuator:
+        base_comps.append(self.components['attenuator'])
+
+    fine_grids = [10, 12, 17, 11, 18, 16]
+
+    if detector_id in fine_grids:
+        comp = Compound(base_comps + [self.components['grid_covers']])
+    else:
+        comp = Compound(base_comps)
+
+    ebins_1d = energy_bins.reshape(-1) * u.keV
+    #convert energy bin ranges to 1d
+    det_trans = comp.transmission(ebins_1d)
+    mean_trans = np.mean(det_trans.reshape((-1, 2)), axis=1)
+    #calculate mean energy transmission factors for energy bins
+    return mean_trans
+
+
+
+def get_transmission(self, energies, attenuator=False) +
+
+

Get the transmission for each detector at the center of the given energy bins.

+

If energies are not supplied will evaluate at standard science energy channels

+

Parameters

+
+
energies : astropy.units.Quantity, optional
+
The energies to evaluate the transmission
+
attenuator : bool, optional
+
True for attenuator in X-ray path, False for attenuator not in X-ray path
+
+

Returns

+

astropy.table.Table +Table containing the transmission values for each energy and detector

+
+ +Expand source code + +
def get_transmission(self, energies, attenuator=False):
+    """
+    Get the transmission for each detector at the center of the given energy bins.
+
+    If energies are not supplied will evaluate at standard science energy channels
+
+    Parameters
+    ----------
+    energies : `astropy.units.Quantity`, optional
+        The energies to evaluate the transmission
+    attenuator : `bool`, optional
+        True for attenuator in X-ray path, False for attenuator not in X-ray path
+
+    Returns
+    -------
+    `astropy.table.Table`
+        Table containing the transmission values for each energy and detector
+    """
+    base_comps = [
+        self.components[name] for name in [
+            'front_window', 'rear_window', 'dem', 'mli',
+            'calibration_foil', 'dead_layer'
+        ]
+    ]
+
+    #if energies is None:
+    energies = energies * u.keV
+    #    self.energies = [ENERGY_CHANNELS[i].e_lower for i in range(1, 32)] * u.keV
+
+    if attenuator:
+        base_comps.append(self.components['attenuator'])
+
+    base = Compound(base_comps)
+    base_trans = base.transmission(energies)
+
+    fine = Compound(base_comps + [self.components['grid_covers']])
+    fine_trans = fine.transmission(energies)
+
+    # TODO need to move to configuration db
+    fine_grids = np.array([11, 13, 18, 12, 19, 17]) - 1
+    detector_transmission = Table()
+    # transmission['sci_channel'] = range(1, 31)
+    detector_transmission['energies'] = energies
+    for i in range(32):
+        name = f'det-{i}'
+        if np.isin(i, fine_grids):
+            detector_transmission[name] = fine_trans
+        else:
+            detector_transmission[name] = base_trans
+    return detector_transmission
+
+
+
+def get_transmission_by_component(self) +
+
+

Get the contributions to the total transmission by broken down by component.

+

Returns

+

dict +Entries are Compounds for each component

+
+ +Expand source code + +
def get_transmission_by_component(self):
+    """
+    Get the contributions to the total transmission by broken down by component.
+
+    Returns
+    -------
+    `dict`
+        Entries are Compounds for each component
+    """
+    return self.components
+
+
+
+def get_transmission_by_material(self) +
+
+

Get the contribution to the transmission by total thickness for each material.

+

Layers of the same materials are combined to return one instance with the total thickness.

+

Returns

+

dict +Entries are meterials with the total thickness for that material.

+
+ +Expand source code + +
def get_transmission_by_material(self):
+    """
+    Get the contribution to the transmission by total thickness for each material.
+
+    Layers of the same materials are combined to return one instance with the total thickness.
+
+    Returns
+    -------
+    `dict`
+        Entries are meterials with the total thickness for that material.
+    """
+    material_thickness = dict()
+    for name, layers in COMPONENTS.items():
+        for material_name, thickness in layers:
+            if material_name == 'solarblack':
+                material_name = self.solarblack
+            if material_name in material_thickness.keys():
+                material_thickness[material_name] += thickness.to('mm')
+            else:
+                material_thickness[material_name] = thickness.to('mm')
+    res = {}
+    for name, thickness in material_thickness.items():
+        frac_mass, density = self.materials[name]
+        mat = self.create_material(name=name,
+                                   fractional_masses=frac_mass,
+                                   density=density,
+                                   thickness=thickness)
+        res[name] = mat
+
+    return res
+
+
+
+
+
+
+
+ +
+ + + \ No newline at end of file diff --git a/downloads/solo_L1A_stix-sci-xray-l1-2105090003_20210509T042711-20210509T044405_010270_V01.fits b/downloads/solo_L1A_stix-sci-xray-l1-2105090003_20210509T042711-20210509T044405_010270_V01.fits new file mode 100755 index 0000000..9b900b7 Binary files /dev/null and b/downloads/solo_L1A_stix-sci-xray-l1-2105090003_20210509T042711-20210509T044405_010270_V01.fits differ diff --git a/stixdcpy/correction.py b/stixdcpy/correction.py index af20b01..93a1209 100755 --- a/stixdcpy/correction.py +++ b/stixdcpy/correction.py @@ -206,7 +206,7 @@ def L1_live_time_correction(cls, triggers, counts_arr, time_bins): cor_factor=0.94 live_ratio[:,det]=np.exp(- cor_factor*nin*asic_tau*1e-6)/(1+ nin*trig_tau) - return correction_factors, corrected_rates , count_rates,photons_in + return correction_factors, corrected_rates , count_rates,photons_in