diff --git a/.buildinfo b/.buildinfo new file mode 100644 index 0000000..0f7bbac --- /dev/null +++ b/.buildinfo @@ -0,0 +1,4 @@ +# Sphinx build info version 1 +# This file hashes the configuration used when building these files. When it is not found, a full rebuild will be done. +config: 9b9f7ca5503430bd1b9c7e338b67cd53 +tags: 645f666f9bcd5a90fca523b33c5a78b7 diff --git a/.nojekyll b/.nojekyll new file mode 100644 index 0000000..e69de29 diff --git a/_images/activity.drawio.svg b/_images/activity.drawio.svg new file mode 100644 index 0000000..9e05ebe --- /dev/null +++ b/_images/activity.drawio.svg @@ -0,0 +1,4 @@ + + + +Container: mardi-mysql
Entity mappings
(DB table)
Entity mappings...
called by cronjob
1 x day
crontab is in
mardi-importer
container
calle...
Container: mardi-wikibase
WikibaseImport (Mediawiki extension)
WikibaseImport (Mediawiki extension)
Load list of entities to import
Load list of entities...
Import entities from Wikidata into portal
Import entities from...
Store entity mappings
as a table
in portal wiki DB
Store entity mappings...
Container: mardi-importer
wikidata
wikidata
zbmath (Python package)
zbmath (Python package)
swmath_importer (Python package)
swmath_importer (Python pa...
Read softwares list
Read softwares list
Softwares list
(csv file)
Softwares list...
Select software from list
Select software from...
<parse_pages>
zbMath API call,
paginate
<parse_pages>...
<parse_record_list>
parse response XML
<parse_record_list>...
XML
XML
pandas data frame
pandas data...
Append publication details to publications list about this software
Append publication deta...
empty list
empty list
unescape special chars,
drop incomplete entries
unescape special chars,...
Pre-process data
Pre-process data
(pandas data frames)
  • all authors
  • all papers
  • paper-to-author relations
  • all software
  • paper-to-software relations
  • all journals
  • publishers
  • languages
  • keywords
  • categories



(pandas data frames)...
no more software
no more so...
next software
next softw...
zbmath_entity_creator (Python package)
zbmath_entity_creator (Python package)
Read entity mappings
Read entity mappings
Should work with estimated 40k papers,but watch it
Should work with est...
This has to be updated too, currently it's a static file
This has to be...
Login to the Wikibase
Login to the Wikibase
Bot login
credentials
Bot login...
Apply entity mappings
Apply entity mappings
Import data using
Wikibase API
Import data using...
<EntityCreator.create_entities>
start entity import
<EntityCreator.create_entities>...
WBAPI_populate_portal.ipynb
see notebook prototype
see notebook prototype
List of entities
(txt file)
List of entities...
Mappings are stored in  DB table, not as wiki properties
Mappings are stored...
WB_wikidata_properties.ipynb
see notebook prototype
see notebook prototype
zbMath_filter_papers_by_software.ipynb
see notebook prototype
see notebook prototype
import completed
import...
Text is not SVG - cannot display
\ No newline at end of file diff --git a/_modules/index.html b/_modules/index.html new file mode 100644 index 0000000..5c3dc7c --- /dev/null +++ b/_modules/index.html @@ -0,0 +1,121 @@ + + + + + + Overview: module code — MaRDI Importer documentation + + + + + + + + + + + + + + + + + +
+ + +
+ +
+
+
+
    +
  • + +
  • +
  • +
+
+
+ + +
+
+
+
+ + + + \ No newline at end of file diff --git a/_modules/mardi_importer/cran/CRANSource.html b/_modules/mardi_importer/cran/CRANSource.html new file mode 100644 index 0000000..a4f95bf --- /dev/null +++ b/_modules/mardi_importer/cran/CRANSource.html @@ -0,0 +1,254 @@ + + + + + + mardi_importer.cran.CRANSource — MaRDI Importer documentation + + + + + + + + + + + + + + + + + +
+ + +
+ +
+
+
+
    +
  • + + +
  • +
  • +
+
+
+
+
+ +

Source code for mardi_importer.cran.CRANSource

+#!/usr/bin/env python3
+# -*- coding: utf-8 -*-
+
+from mardi_importer.importer.Importer import ADataSource, ImporterException
+from mardi_importer.integrator import MardiIntegrator
+from .RPackage import RPackage
+
+import pandas as pd
+import time
+import json
+import os
+import logging
+log = logging.getLogger('CRANlogger')
+
+
+[docs] +class CRANSource(ADataSource): + """Processes data from the Comprehensive R Archive Network. + + Metadata for each R package is scrapped from the CRAN Repository. Each + Wikibase item corresponding to each R package is subsequently updated + or created, in case of a new package. + + Attributes: + packages (Pandas dataframe): + Dataframe with **package name**, **title** and **date of publication** for + each package in CRAN. + """ + + def __init__(self): + self.integrator = MardiIntegrator() + self.filepath = os.path.realpath(os.path.dirname(__file__)) + self.packages = "" + +
+[docs] + def setup(self): + """Create all necessary properties and entities for CRAN + """ + # Import entities from Wikidata + filename = self.filepath + "/wikidata_entities.txt" + self.integrator.import_entities(filename=filename) + + # Create new required local entities + self.create_local_entities()
+ + +
+[docs] + def create_local_entities(self): + filename = self.filepath + "/new_entities.json" + f = open(filename) + entities = json.load(f) + + for prop_element in entities['properties']: + prop = self.integrator.property.new() + prop.labels.set(language='en', value=prop_element['label']) + prop.descriptions.set(language='en', value=prop_element['description']) + prop.datatype = prop_element['datatype'] + if not prop.exists(): prop.write() + + for item_element in entities['items']: + item = self.integrator.item.new() + item.labels.set(language='en', value=item_element['label']) + item.descriptions.set(language='en', value=item_element['description']) + for key, value in item_element['claims'].items(): + item.add_claim(key,value=value) + if not item.exists(): item.write()
+ + +
+[docs] + def pull(self): + """Reads **date**, **package name** and **title** from the CRAN Repository URL. + + The result is saved as a pandas dataframe in the attribute **packages**. + + Returns: + Pandas dataframe: Attribute ``packages`` + + Raises: + ImporterException: If table at the CRAN url cannot be accessed or read. + """ + url = r"https://cran.r-project.org/web/packages/available_packages_by_date.html" + + try: + tables = pd.read_html(url) # Returns list of all tables on page + except Exception as e: + raise ImporterException( + "Error attempting to read table from CRAN url\n{}".format(e) + ) + else: + self.packages = tables[0] + return self.packages
+ + +
+[docs] + def push(self): + """Updates the MaRDI Wikibase entities corresponding to R packages. + + For each **package name** in the attribute **packages** checks + if the date in CRAN coincides with the date in the MaRDI + knowledge graph. If not, the package is updated. If the package + is not found in the MaRDI knowledge graph, the corresponding + item is created. + + It creates a :class:`mardi_importer.cran.RPackage` instance + for each package. + """ + # Limit the query to only 30 packages (Comment next line to process data on all ~19000 packages) + #self.packages = self.packages.loc[:100, :] + + flag = False + + for _, row in self.packages.iterrows(): + package_date = row["Date"] + package_label = row["Package"] + package_title = row["Title"] + + #if not flag and package_label != "BeSS": + # continue + #flag = True + #if package_label == "GeoModels": + + package = RPackage(package_date, package_label, package_title, self.integrator) + if package.exists(): + if not package.is_updated(): + print(f"Package {package_label} found: Not up to date. Attempting update...") + package.update() + else: + print(f"Package {package_label} found: Already up to date.") + else: + print(f"Package {package_label} not found: Attempting item creation...") + package.create() + + time.sleep(2)
+
+ +
+ +
+
+ +
+
+
+
+ + + + \ No newline at end of file diff --git a/_modules/mardi_importer/cran/RPackage.html b/_modules/mardi_importer/cran/RPackage.html new file mode 100644 index 0000000..32b1653 --- /dev/null +++ b/_modules/mardi_importer/cran/RPackage.html @@ -0,0 +1,1066 @@ + + + + + + mardi_importer.cran.RPackage — MaRDI Importer documentation + + + + + + + + + + + + + + + + + +
+ + +
+ +
+
+
+ +
+
+
+
+ +

Source code for mardi_importer.cran.RPackage

+#!/usr/bin/env python3
+# -*- coding: utf-8 -*-
+
+from mardi_importer.integrator import MardiIntegrator, MardiItemEntity
+from mardi_importer.publications import (ArxivPublication, 
+                                         CrossrefPublication,
+                                         ZenodoResource, 
+                                         Author)
+from wikibaseintegrator.wbi_enums import ActionIfExists
+from wikibaseintegrator.wbi_helpers import search_entities, remove_claims
+
+from dataclasses import dataclass, field
+from typing import Optional, Dict, List, Tuple
+from io import StringIO
+
+from bs4 import BeautifulSoup
+import pandas as pd
+import requests
+import re
+
+import logging
+log = logging.getLogger('CRANlogger')
+
+
+[docs] +@dataclass +class RPackage: + """Class to manage R package items in the local Wikibase instance. + + Attributes: + date: + Date of publication + label: + Package name + description: + Title of the R package + long_description: + Detailed description of the R package + url: + URL to the CRAN repository + version: + Version of the R package + versions: + Previous published versions + author: + Author(s) of the package + license: + Software license + dependency: + Dependencies to R and other packages + imports: + Imported R packages + maintainer: + Software maintainer + _QID: + Package QID + integrator: + API to MaRDI integrator + """ + date: str + label: str + description: str + api: MardiIntegrator + long_description: str = "" + url: str = "" + version: str = "" + versions: List[Tuple[str, str]] = field(default_factory=list) + authors: List[Author] = field(default_factory=list) + license_data: List[Tuple[str, str]] = field(default_factory=list) + dependencies: List[Tuple[str, str]] = field(default_factory=list) + imports: List[Tuple[str, str]] = field(default_factory=list) + maintainer: str = "" + author_pool: List[Author] = field(default_factory=list) + crossref_publications: List[CrossrefPublication] = field(default_factory=list) + arxiv_publications: List[ArxivPublication] = field(default_factory=list) + zenodo_resources: List[ZenodoResource] = field(default_factory=list) + _QID: str = "" + _item: MardiItemEntity = None + + @property + def QID(self) -> str: + """Return the QID of the R package in the knowledge graph. + + Searches for an item with the package label in the Wikibase + SQL tables and returns the QID if a matching result is found. + + Returns: + str: The entity QID representing the R package. + """ + self._QID = self._QID or self.item.is_instance_of('wd:Q73539779') + return self._QID + + @property + def item(self) -> MardiItemEntity: + """Return the integrator Item representing the R package. + + Adds also the label and description of the package. + + Returns: + MardiItemEntity: Integrator item + """ + if not self._item: + self._item = self.api.item.new() + self._item.labels.set(language="en", value=self.label) + description = self.description + if self.label == self.description: + description += " (R Package)" + self._item.descriptions.set( + language="en", + value=description + ) + return self._item + +
+[docs] + def exists(self) -> str: + """Checks if an item corresponding to the R package already exists. + + Returns: + str: Entity ID + """ + if self.QID: + self._item = self.api.item.get(entity_id=self.QID) + return self.QID
+ + +
+[docs] + def is_updated(self) -> bool: + """Checks if the Item corresponding to the R package is up to date. + + Compares the last update property in the local knowledge graph with + the publication date imported from CRAN. + + Returns: + bool: **True** if both dates coincide, **False** otherwise. + """ + return self.date == self.get_last_update()
+ + +
+[docs] + def pull(self): + """Imports metadata from CRAN corresponding to the R package. + + Imports **Version**, **Dependencies**, **Imports**m **Authors**, + **Maintainer** and **License** and saves them as instance + attributes. + """ + self.url = f"https://CRAN.R-project.org/package={self.label}" + + try: + page = requests.get(self.url) + soup = BeautifulSoup(page.content, 'lxml') + except: + log.warning(f"Package {self.label} package not found in CRAN.") + return None + else: + if soup.find_all('table'): + self.long_description = soup.find_all('p')[0].get_text() or "" + self.parse_publications(self.long_description) + self.long_description = re.sub("\n", "", self.long_description).strip() + self.long_description = re.sub("\t", "", self.long_description).strip() + + table = soup.find_all('table')[0] + package_df = self.clean_package_list(table) + + if "Version" in package_df.columns: + self.version = package_df.loc[1, "Version"] + if "Author" in package_df.columns: + self.authors = package_df.loc[1, "Author"] + if "License" in package_df.columns: + self.license_data = package_df.loc[1, "License"] + if "Depends" in package_df.columns: + self.dependencies = package_df.loc[1, "Depends"] + if "Imports" in package_df.columns: + self.imports = package_df.loc[1, "Imports"] + if "Maintainer" in package_df.columns: + self.maintainer = package_df.loc[1, "Maintainer"] + + self.get_versions() + else: + log.warning(f"Metadata table not found in CRAN. Package has probably been archived.") + return self
+ + +
+[docs] + def create(self) -> None: + """Create a package in the Wikibase instance. + + This function pulls the package, inserts its claims, and writes + it to the Wikibase instance. + + Returns: + None + """ + package = self.pull() + + if package: + package = package.insert_claims().write() + + if package: + log.info(f"Package created with QID: {package['QID']}.") + #print('package created') + else: + log.info(f"Package could not be created.")
+ + #print('package not created') + +
+[docs] + def write(self) -> Optional[Dict[str, str]]: + """Write the package item to the Wikibase instance. + + If the item has claims, it will be written to the Wikibase instance. + If the item is successfully written, a dictionary with the QID of the + item will be returned. + + Returns: + Optional[Dict[str, str]]: + A dictionary with the QID of the written item if successful, + or None otherwise. + """ + if self.item.claims: + item = self.item.write() + if item: + return {'QID': item.id}
+ + +
+[docs] + def insert_claims(self): + + # Instance of: R package + self.item.add_claim("wdt:P31", "wd:Q73539779") + + # Programmed in: R + self.item.add_claim("wdt:P277", "wd:Q206904") + + # Long description + prop_nr = self.api.get_local_id_by_label("description", "property") + self.item.add_claim(prop_nr, self.long_description) + + # Last update date + self.item.add_claim("wdt:P5017", f"+{self.date}T00:00:00Z") + + # Software version identifiers + for version, publication_date in self.versions: + qualifier = [self.api.get_claim("wdt:P577", publication_date)] + self.item.add_claim("wdt:P348", version, qualifiers=qualifier) + + if self.version: + qualifier = [self.api.get_claim("wdt:P577", f"+{self.date}T00:00:00Z")] + self.item.add_claim("wdt:P348", self.version, qualifiers=qualifier) + + # Disambiguate Authors and create corresponding Author items + self.author_pool = Author.disambiguate_authors(self.author_pool) + + # Authors + for author in self.authors: + author.pull_QID(self.author_pool) + self.item.add_claim("wdt:P50", author.QID) + + # Maintainer + self.maintainer.pull_QID(self.author_pool) + self.item.add_claim("wdt:P126", self.maintainer.QID) + + # Licenses + if self.license_data: + claims = self.process_claims(self.license_data, 'wdt:P275', 'wdt:P9767') + self.item.add_claims(claims) + + # Dependencies + if self.dependencies: + claims = self.process_claims(self.dependencies, 'wdt:P1547', 'wdt:P348') + self.item.add_claims(claims) + + # Imports + if self.imports: + prop_nr = self.api.get_local_id_by_label("imports", "property") + claims = self.process_claims(self.imports, prop_nr, 'wdt:P348') + self.item.add_claims(claims) + + # Related publications and sources + cites_work = "wdt:P2860" + for publications in [self.crossref_publications, self.arxiv_publications, self.zenodo_resources]: + for publication in publications: + for author in publication.authors: + author.pull_QID(self.author_pool) + publication.create() + self.item.add_claim(cites_work, publication.QID) + + # CRAN Project + self.item.add_claim("wdt:P5565", self.label) + + # Wikidata QID + wikidata_QID = self.get_wikidata_QID() + if wikidata_QID: self.item.add_claim("Wikidata QID", wikidata_QID) + + return self
+ + +
+[docs] + def update(self): + """Updates existing WB item with the imported metadata from CRAN. + + The metadata corresponding to the package is first pulled from CRAN and + saved as instance attributes through :meth:`pull`. The statements that + do not coincide with the locally saved information are updated or + subsituted with the updated information. + + Uses :class:`mardi_importer.wikibase.WBItem` to update the item + corresponding to the R package. + + Returns: + str: ID of the updated R package. + """ + if self.pull(): + # Obtain current Authors + current_authors = self.item.get_value('wdt:P50') + for author_qid in current_authors: + author_item = self.api.item.get(entity_id=author_qid) + author_label = str(author_item.labels.get('en')) + current_author = Author(self.api, name=author_label) + current_author._QID = author_qid + self.author_pool += [current_author] + + # Disambiguate Authors and create corresponding Author items + self.author_pool = Author.disambiguate_authors(self.author_pool) + + # GUID to remove + remove_guid = [] + props_to_delete = ['wdt:P50', 'wdt:P275', 'wdt:P1547', 'imports', 'wdt:P2860'] + for prop_str in props_to_delete: + prop_nr = self.api.get_local_id_by_label(prop_str, 'property') + for claim in self.item.claims.get(prop_nr): + remove_guid.append(claim.id) + + for guid in remove_guid: + remove_claims(guid, login=self.api.login, is_bot=True) + + # Restart item state + self.exists() + + if self.item.descriptions.values.get('en') != self.description: + description = self.description + if self.label == self.description: + description += " (R Package)" + self.item.descriptions.set( + language="en", + value=description + ) + + # Long description + self.item.add_claim("description", self.long_description, action="replace_all") + + # Last update date + self.item.add_claim("wdt:P5017", f"+{self.date}T00:00:00Z", action="replace_all") + + # Software version identifiers + for version, publication_date in self.versions: + qualifier = [self.api.get_claim("wdt:P577", publication_date)] + self.item.add_claim("wdt:P348", version, qualifiers=qualifier) + + if self.version: + qualifier = [self.api.get_claim("wdt:P577", f"+{self.date}T00:00:00Z")] + self.item.add_claim("wdt:P348", self.version, qualifiers=qualifier) + + # Authors + for author in self.authors: + author.pull_QID(self.author_pool) + self.item.add_claim("wdt:P50", author.QID) + + # Maintainer + self.maintainer.pull_QID(self.author_pool) + self.item.add_claim("wdt:P126", self.maintainer.QID, action="replace_all") + + # Licenses + if self.license_data: + claims = self.process_claims(self.license_data, 'wdt:P275', 'wdt:P9767') + self.item.add_claims(claims) + + # Dependencies + if self.dependencies: + claims = self.process_claims(self.dependencies, 'wdt:P1547', 'wdt:P348') + self.item.add_claims(claims) + + # Imports + if self.imports: + prop_nr = self.api.get_local_id_by_label("imports", "property") + claims = self.process_claims(self.imports, prop_nr, 'wdt:P348') + self.item.add_claims(claims) + + # Related publications and sources + cites_work = "wdt:P2860" + for publications in [self.crossref_publications, self.arxiv_publications, self.zenodo_resources]: + for publication in publications: + for author in publication.authors: + author.pull_QID(self.author_pool) + publication.create() + self.item.add_claim(cites_work, publication.QID) + + # CRAN Project + self.item.add_claim("wdt:P5565", self.label, action="replace_all") + + # Wikidata QID + wikidata_QID = self.get_wikidata_QID() + if wikidata_QID: self.item.add_claim("Wikidata QID", wikidata_QID, action="replace_all") + + package = self.write() + + if package: + print(f"Package with QID updated: {package['QID']}.") + else: + print(f"Package could not be updated.")
+ + +
+[docs] + def process_claims(self, data, prop_nr, qualifier_nr=None): + + claims = [] + for value, qualifier_value in data: + qualifier_prop_nr = ( + 'wdt:P2699' if qualifier_value.startswith('https') else qualifier_nr + ) + qualifier = ( + [self.api.get_claim(qualifier_prop_nr, qualifier_value)] + if qualifier_value else [] + ) + claims.append(self.api.get_claim(prop_nr, value, qualifiers=qualifier)) + return claims
+ + +
+[docs] + def parse_publications(self, description): + """Extracts the DOI identification of related publications. + + Identifies the DOI of publications that are mentioned using the + format *doi:* or *arXiv:* in the long description of the + R package. + + Returns: + List: + List containing the wikibase IDs of mentioned publications. + """ + doi_references = re.findall('<doi:(.*?)>', description) + arxiv_references = re.findall('<arXiv:(.*?)>', description) + zenodo_references = re.findall('<zenodo:(.*?)>', description) + + doi_references = list(map(lambda x: x[:-1] if x.endswith('.') else x, doi_references)) + arxiv_references = list(map(lambda x: x[:-1] if x.endswith('.') else x, arxiv_references)) + zenodo_references = list(map(lambda x: x[:-1] if x.endswith('.') else x, zenodo_references)) + + crossref_references = [] + + for doi in doi_references: + doi = doi.strip().lower() + if re.search('10.48550/', doi): + arxiv_id = doi.replace(":",".") + arxiv_id = arxiv_id.replace('10.48550/arxiv.', '') + arxiv_references.append(arxiv_id.strip()) + elif re.search('10.5281/', doi): + zenodo_id = doi.replace(":",".") + zenodo_id = doi.replace('10.5281/zenodo.', '') + zenodo_references.append(zenodo_id.strip()) + else: + crossref_references.append(doi) + + for doi in crossref_references: + publication = CrossrefPublication(self.api, doi) + self.author_pool += publication.authors + self.crossref_publications.append(publication) + + for arxiv_id in arxiv_references: + arxiv_id = arxiv_id.replace(":",".") + publication = ArxivPublication(self.api, arxiv_id) + if publication.title != "Error": + self.author_pool += publication.authors + self.arxiv_publications.append(publication) + + for zenodo_id in zenodo_references: + zenodo_id = zenodo_id.replace(":",".") + publication = ZenodoResource(self.api, zenodo_id) + self.author_pool += publication.authors + self.zenodo_resources.append(publication)
+ + +
+[docs] + def get_last_update(self): + """Returns the package last update date saved in the Wikibase instance. + + Returns: + str: Last update date in format DD-MM-YYYY. + """ + last_update = self.item.get_value("wdt:P5017") + return last_update[0][1:11] if last_update else None
+ + +
+[docs] + def clean_package_list(self, table_html): + """Processes raw imported data from CRAN to enable the creation of items. + + - Package dependencies are splitted at the comma position. + - License information is processed using the :meth:`parse_license` method. + - Author information is processed using the :meth:`parse_authors` method. + - Maintainer information is processed using the :meth:`parse_maintainer` method. + + Args: + table_html: + HTML code obtained with BeautifulSoup corresponding to the table + containing the metadata of the R package imported from CRAN. + Returns: + (Pandas dataframe): + Dataframe with processed data from a single R package including columns: + **Version**, **Author**, **License**, **Depends**, **Imports** + and **Maintainer**. + """ + package_df = pd.read_html(StringIO(str(table_html))) + package_df = package_df[0].set_index(0).T + package_df.columns = package_df.columns.str[:-1] + if "Depends" in package_df.columns: + package_df["Depends"] = package_df["Depends"].apply(self.parse_software) + if "Imports" in package_df.columns: + package_df["Imports"] = package_df["Imports"].apply(self.parse_software) + if "License" in package_df.columns: + package_df["License"] = package_df["License"].apply(self.parse_license) + if "Author" in package_df.columns: + package_df["Author"] = str(table_html.find("td", text="Author:").find_next_sibling("td")).replace('\n', '').replace('\r', '') + package_df["Author"] = package_df["Author"].apply(self.parse_authors) + if "Maintainer" in package_df.columns: + package_df["Maintainer"] = package_df["Maintainer"].apply(self.parse_maintainer) + return package_df
+ + +
+[docs] + def parse_software(self, software_str: str) -> List[Tuple[str, str]]: + """Processes the dependency and import information of each R package. + + This includes: + - Extracting the version information of each dependency/import if provided. + - Providing the Item QID given the dependency/import label. + - Creating a new Item if the dependency/import is not found in the + local knowledge graph. + + Returns: + List[Tuple[str, str]]: + List of tuples including software QID and version. + """ + if pd.isna(software_str): + return [] + + software_list = str(software_str).split(", ") + software_tuples = [] + + for software_string in software_list: + software_version = re.search("\((.*?)\)", software_string) + software_version = software_version.group(1) if software_version else "" + + software_name = re.sub("\(.*?\)", "", software_string).strip() + + # Instance of R package + if software_name == "R": + # Software = R + software_QID = self.api.query("local_id", "Q206904") + else: + item = self.api.item.new() + item.labels.set(language="en", value=software_name) + software_id = item.is_instance_of("wd:Q73539779") + if software_id: + # Software = R package + software_QID = software_id + else: + # Software = New instance of R package + item.add_claim("wdt:P31", "wd:Q73539779") + item.add_claim("wdt:P277", "wd:Q206904") + software_QID = item.write().id + + software_tuples.append((software_QID, software_version)) + + return software_tuples
+ + +
+[docs] + def parse_license(self, x: str) -> List[Tuple[str, str]]: + """Splits string of licenses. + + Takes into account that licenses are often not uniformly listed. + Characters \|, + and , are used to separate licenses. Further + details on each license are often included in square brackets. + + The concrete License is identified and linked to the corresponding + item that has previously been imported from Wikidata. Further license + information, when provided between round or square brackets, is added + as a qualifier. + + If a file license is mentioned, the linked to the file license + in CRAN is added as a qualifier. + + Args: + x (str): String imported from CRAN representing license + information. + + Returns: + List[Tuple[str, str]]: + List of license tuples. Each tuple contains the license QID + as the first element and the license qualifier as the + second element. + """ + if pd.isna(x): + return [] + + license_list = [] + licenses = str(x).split(" | ") + + i = 0 + while i in range(len(licenses)): + if not re.findall(r"\[", licenses[i]) or ( + re.findall(r"\[", licenses[i]) and re.findall(r"\]", licenses[i]) + ): + license_list.append(licenses[i]) + i += 1 + elif re.findall(r"\[", licenses[i]) and not re.findall( + r"\]", licenses[i] + ): + j = i + 1 + license_aux = licenses[i] + closed = False + while j < len(licenses) and not closed: + license_aux += " | " + license_aux += licenses[j] + if re.findall(r"\]", licenses[j]): + closed = True + j += 1 + license_list.append(license_aux) + i = j + + split_list = [] + for item in license_list: + items = item.split(" + ") + i = 0 + while i in range(len(items)): + if not re.findall(r"\[", items[i]) or ( + re.findall(r"\[", items[i]) and re.findall(r"\]", items[i]) + ): + split_list.append(items[i]) + i += 1 + elif re.findall(r"\[", items[i]) and not re.findall(r"\]", items[i]): + j = i + 1 + items_aux = items[i] + closed = False + while j < len(items) and not closed: + items_aux += " + " + items_aux += items[j] + if re.findall(r"\]", items[j]): + closed = True + j += 1 + split_list.append(items_aux) + i = j + license_list = list(dict.fromkeys(split_list)) + + license_tuples = [] + for license_str in license_list: + license_qualifier = "" + if re.findall(r"\(.*?\)", license_str): + qualifier_groups = re.search(r"\((.*?)\)", license_str) + license_qualifier = qualifier_groups.group(1) + license_aux = re.sub(r"\(.*?\)", "", license_str) + if re.findall(r"\[.*?\]", license_aux): + qualifier_groups = re.search(r"\[(.*?)\]", license_str) + license_qualifier = qualifier_groups.group(1) + license_str = re.sub(r"\[.*?\]", "", license_aux) + else: + license_str = license_aux + elif re.findall(r"\[.*?\]", license_str): + qualifier_groups = re.search(r"\[(.*?)\]", license_str) + license_qualifier = qualifier_groups.group(1) + license_str = re.sub(r"\[.*?\]", "", license_str) + + license_str = license_str.strip() + if license_str in ["file LICENSE", "file LICENCE"]: + license_qualifier = f"https://cran.r-project.org/web/packages/{self.label}/LICENSE" + + license_QID = self.get_license_QID(license_str) + license_tuples.append((license_QID, license_qualifier)) + return license_tuples
+ + +
+[docs] + def parse_authors(self, x): + """Splits the string corresponding to the authors into a dictionary. + + Author information in CRAN is not registered uniformly. This function + parses the imported string and returns just the names of the individuals + that can be unequivocally identified as authors (i.e. they are followed + by the *[aut]* abbreviation). + + Generally, authors in CRAN are indicated with the abbreviation *[aut]*. + When no abbreviations are included, only the first individual is imported + to Wikibase (otherwise it can often not be established whether + information after the first author refers to another individual, + an institution, a funder, etc.) + + Args: + x (String): String imported from CRAN representing author + information. + + Returns: + (Dict): Dictionary of authors and corresponding ORCID ID, if provided. + """ + td_match = re.match(r'<td>(.*?)</td>', x) + if td_match: x = td_match.groups()[0] + + x = re.sub("<img alt.*?a>", "", x) # Delete img tags + x = re.sub(r"\(.*?\)", "", x) # Delete text in brackets + x = re.sub(r'"', "", x) # Delete quotation marks + x = re.sub("\t", "", x) # Delete tabs + x = re.sub("ORCID iD", "", x) # Delete orcid id refs + author_list = re.findall(r".*?\]", x) + + authors = [] + if author_list: + for author in author_list: + labels = re.findall(r"\[.*?\]", author) + if labels: + is_author = re.findall("aut", labels[0]) + if is_author: + orcid = re.findall(r"\d{4}-\d{4}-\d{4}-.{4}", author) + if orcid: + orcid = orcid[0] + author = re.sub(r"<a href=.*?>", "", author) + author = re.sub(r"\[.*?\]", "", author) + author = re.sub(r"^\s?,", "", author) + author = re.sub(r"^\s?and\s?", "", author) + author = re.sub( + r"[a-zA-Z0-9_.+-]+@[a-zA-Z0-9-]+\.[a-zA-Z0-9-.]+", "", author + ) + author = author.strip() + multiple_words = author.split(" ") + if len(multiple_words) > 1: + if author: + authors.append(Author(self.api, author, orcid)) + else: + authors_comma = x.split(", ") + authors_and = x.split(" and ") + if len(authors_and) > len(authors_comma): + author = re.sub( + r"[a-zA-Z0-9_.+-]+@[a-zA-Z0-9-]+\.[a-zA-Z0-9-.]+", "", authors_and[0] + ) + else: + author = re.sub( + r"[a-zA-Z0-9_.+-]+@[a-zA-Z0-9-]+\.[a-zA-Z0-9-.]+", + "", + authors_comma[0], + ) + if len(author.split(" ")) > 5 or re.findall(r"[@\(\)\[\]&]", author): + author = "" + if author: + authors.append(Author(self.api, author)) + self.author_pool += authors + return authors
+ + +
+[docs] + def parse_maintainer(self, name: str) -> str: + """Remove unnecessary information from maintainer string. + + Args: + x (str): String imported from CRAN which may contain e-mail + address and comments within brackets + + Returns: + (str): Name of the maintainer + """ + if pd.isna(name): return name + + quotes = re.match(r'"(.*?)"', name) + if quotes: + name = quotes.groups()[0] + + name = re.sub(r"<.*?>", "", name) + name = re.sub(r"\(.*?\)", "", name) + name = name.strip() + name = name.split(',') + maintainer = Author(self.api, name=name[0]) + self.author_pool += [maintainer] + return maintainer
+ + +
+[docs] + def get_license_QID(self, license_str: str) -> str: + """Returns the Wikidata item ID corresponding to a software license. + + The same license is often denominated in CRAN using differents names. + This function returns the wikidata item ID corresponding to a single + unique license that is referenced in CRAN under different names (e.g. + *Artistic-2.0* and *Artistic License 2.0* both refer to the same + license, corresponding to item *Q14624826*). + + Args: + license_str (str): String corresponding to a license imported from CRAN. + + Returns: + (str): Wikidata item ID. + """ + def get_license(label: str) -> str: + license_item = self.api.item.new() + license_item.labels.set(language="en", value=label) + return license_item.is_instance_of("wd:Q207621") + + license_mapping = { + "ACM": get_license("ACM Software License Agreement"), + "AGPL":"wd:Q28130012", + "AGPL-3": "wd:Q27017232", + "Apache License": "wd:Q616526", + "Apache License 2.0": "wd:Q13785927", + "Apache License version 1.1": "wd:Q17817999", + "Apache License version 2.0": "wd:Q13785927", + "Artistic-2.0": "wd:Q14624826", + "Artistic License 2.0": "wd:Q14624826", + "BSD 2-clause License": "wd:Q18517294", + "BSD 3-clause License": "wd:Q18491847", + "BSD_2_clause": "wd:Q18517294", + "BSD_3_clause": "wd:Q18491847", + "BSL": "wd:Q2353141", + "BSL-1.0": "wd:Q2353141", + "CC0": "wd:Q6938433", + "CC BY 4.0": "wd:Q20007257", + "CC BY-SA 4.0": "wd:Q18199165", + "CC BY-NC 4.0": "wd:Q34179348", + "CC BY-NC-SA 4.0": "wd:Q42553662", + "CeCILL": "wd:Q1052189", + "CeCILL-2": "wd:Q19216649", + "Common Public License Version 1.0": "wd:Q2477807", + "CPL-1.0": "wd:Q2477807", + "Creative Commons Attribution 4.0 International License": "wd:Q20007257", + "EPL": "wd:Q1281977", + "EUPL": "wd:Q1376919", + "EUPL-1.1": "wd:Q1376919", + "file LICENCE": get_license("File License"), + "file LICENSE": get_license("File License"), + "FreeBSD": "wd:Q34236", + "GNU Affero General Public License": "wd:Q1131681", + "GNU General Public License": "wd:Q7603", + "GNU General Public License version 2": "wd:Q10513450", + "GNU General Public License version 3": "wd:Q10513445", + "GPL": "wd:Q7603", + "GPL-2": "wd:Q10513450", + "GPL-3": "wd:Q10513445", + "LGPL": "wd:Q192897", + "LGPL-2": "wd:Q23035974", + "LGPL-2.1": "wd:Q18534390", + "LGPL-3": "wd:Q18534393", + "Lucent Public License": "wd:Q6696468", + "MIT": "wd:Q334661", + "MIT License": "wd:Q334661", + "Mozilla Public License 1.1": "wd:Q26737735", + "Mozilla Public License 2.0": "wd:Q25428413", + "Mozilla Public License Version 2.0": "wd:Q25428413", + "MPL": "wd:Q308915", + "MPL version 1.0": "wd:Q26737738", + "MPL version 1.1": "wd:Q26737735", + "MPL version 2.0": "wd:Q25428413", + "MPL-1.1": "wd:Q26737735", + "MPL-2.0": "wd:Q25428413", + "Unlimited": get_license("Unlimited License"), + } + + license_info = license_mapping.get(license_str) + if callable(license_info): + return license_info() + else: + return license_info
+ + +
+[docs] + def get_wikidata_QID(self) -> Optional[str]: + """Get the Wikidata QID for the R package. + + Searches for the R package in Wikidata using its label. Retrieves + the QID of matching entities and checks if there is an instance of + an R package. If so, returns the QID. + + Returns: + Optional[str]: + The Wikidata QID of the R package if found, or None otherwise. + """ + results = search_entities( + search_string=self.label, + mediawiki_api_url='https://www.wikidata.org/w/api.php' + ) + + for result in results: + item = self.api.item.get( + entity_id=result, + mediawiki_api_url='https://www.wikidata.org/w/api.php' + ) + if 'P31' in item.claims.get_json().keys(): + instance_claims = item.claims.get('P31') + if instance_claims: + for claim in instance_claims: + claim = claim.get_json() + if claim['mainsnak']['datatype'] == "wikibase-item": + # If instance of R package + if 'datavalue' in claim['mainsnak'].keys(): + if claim['mainsnak']['datavalue']['value']['id'] == "Q73539779": + return result
+ + +
+[docs] + def get_versions(self): + url = f"https://cran.r-project.org/src/contrib/Archive/{self.label}" + + try: + page = requests.get(url) + soup = BeautifulSoup(page.content, 'lxml') + except: + log.warning(f"Version page for package {self.label} not found.") + else: + if soup.find_all('table'): + table = soup.find_all('table')[0] + versions_df = pd.read_html(StringIO(str(table))) + versions_df = versions_df[0] + versions_df = versions_df.drop(columns=['Unnamed: 0', 'Size', 'Description']) + versions_df = versions_df.drop(index= [0, 1]) + + for _, row in versions_df.iterrows(): + name = row['Name'] + publication_date = row['Last modified'] + if isinstance(name, str): + version = re.sub(f'{self.label}_', '', name) + version = re.sub('.tar.gz', '', version) + + publication_date = publication_date.split()[0] + publication_date = f"+{publication_date}T00:00:00Z" + + self.versions.append((version, publication_date))
+
+ +
+ +
+
+ +
+
+
+
+ + + + \ No newline at end of file diff --git a/_modules/mardi_importer/importer/Importer.html b/_modules/mardi_importer/importer/Importer.html new file mode 100644 index 0000000..11abe2c --- /dev/null +++ b/_modules/mardi_importer/importer/Importer.html @@ -0,0 +1,220 @@ + + + + + + mardi_importer.importer.Importer — MaRDI Importer documentation + + + + + + + + + + + + + + + + + +
+ + +
+ +
+
+
+
    +
  • + + +
  • +
  • +
+
+
+
+
+ +

Source code for mardi_importer.importer.Importer

+#!/usr/bin/env python3
+# -*- coding: utf-8 -*-
+"""
+Created on Thu Feb 17 18:53:53 2022
+
+@author: alvaro
+"""
+
+
+
+[docs] +class Importer: + """Controller class for importing data from an external source to the local Wikibase.""" + + def __init__(self, dataSource): + """ + Construct. + Args: + entityCreator: object implementing AEntityCreator + dataSource: object implementig ADataSource + """ + self.dataSource = dataSource + +
+[docs] + def import_all(self, pull=True, push=True): + """ + Manages the import process. + """ + self.dataSource.setup() + if pull: + self.dataSource.pull() + if push: + self.dataSource.push()
+
+ + + +
+[docs] +class ADataSource: + """Abstract base class for reading data from external sources.""" + +
+[docs] + def write_data_dump(self): + """ + Write data dump from API. + """ + raise NotImplementedError
+ + +
+[docs] + def process_data(self): + """ + Process data dump. + """ + raise NotImplementedError
+ + +
+[docs] + def pull(self): + """ + Pull data from DataSource + """ + raise NotImplementedError
+ + +
+[docs] + def push(self): + """ + Push data into the MaRDI knowledge graph. + """ + raise NotImplementedError
+
+ + + +
+[docs] +class AConfigParser: + """Abstract base class for parsing config files""" + +
+[docs] + def parse_config(self): + """ + Parse config file. + Returns: + Dictionary: Dictionary containing config values + """
+
+ + + +
+[docs] +class ImporterException(Exception): + """Failed importer operation.""" + + pass
+ +
+ +
+
+ +
+
+
+
+ + + + \ No newline at end of file diff --git a/_modules/mardi_importer/integrator/MardiEntities.html b/_modules/mardi_importer/integrator/MardiEntities.html new file mode 100644 index 0000000..cc04a61 --- /dev/null +++ b/_modules/mardi_importer/integrator/MardiEntities.html @@ -0,0 +1,265 @@ + + + + + + mardi_importer.integrator.MardiEntities — MaRDI Importer documentation + + + + + + + + + + + + + + + + + +
+ + +
+ +
+
+
+
    +
  • + + +
  • +
  • +
+
+
+
+
+ +

Source code for mardi_importer.integrator.MardiEntities

+import re
+import sqlalchemy as db
+from sqlalchemy import and_
+
+from mardiclient import MardiItem, MardiProperty
+from wikibaseintegrator.wbi_exceptions import ModificationFailed
+from wikibaseintegrator.datatypes import ExternalID
+from wikibaseintegrator.wbi_enums import ActionIfExists
+from mardi_importer.importer import ImporterException
+
+
+[docs] +class MardiItemEntity(MardiItem): + +
+[docs] + def new(self, **kwargs): + return MardiItemEntity(api=self.api, **kwargs)
+ + +
+[docs] + def get(self, entity_id, **kwargs): + json_data = super(MardiItemEntity, self)._get(entity_id=entity_id, **kwargs) + return MardiItemEntity(api=self.api).from_json(json_data=json_data['entities'][entity_id])
+ + +
+[docs] + def get_QID(self, alias=False): + """Creates a list of QID of all items in the local wikibase with the + same label + + Returns: + QIDs (list): List of QID + """ + + label = "" + if 'en' in self.labels.values: + label = self.labels.values['en'].value + + def query_wikidata_table(field_type): + # field_type = 1 : Label + # field_type = 2 : Alias + # see: https://doc.wikimedia.org/Wikibase/REL1_41/php/docs_sql_wbt_type.html + entity_id = [] + with self.api.engine.connect() as connection: + metadata = db.MetaData() + try: + wbt_item_terms = db.Table( + "wbt_item_terms", metadata, autoload_with=connection + ) + wbt_term_in_lang = db.Table( + "wbt_term_in_lang", metadata, autoload_with=connection + ) + wbt_text_in_lang = db.Table( + "wbt_text_in_lang", metadata, autoload_with=connection + ) + wbt_text = db.Table( + "wbt_text", metadata, autoload_with=connection + ) + query = (db.select(wbt_item_terms.columns.wbit_item_id) + .join(wbt_term_in_lang, wbt_item_terms.columns.wbit_term_in_lang_id == wbt_term_in_lang.columns.wbtl_id) + .join(wbt_text_in_lang, wbt_term_in_lang.columns.wbtl_text_in_lang_id == wbt_text_in_lang.columns.wbxl_id) + .join(wbt_text, wbt_text.columns.wbx_id == wbt_text_in_lang.columns.wbxl_text_id) + .where(and_(wbt_text.columns.wbx_text == bytes(label, "utf-8"), + wbt_term_in_lang.columns.wbtl_type_id == field_type, + wbt_text_in_lang.columns.wbxl_language == bytes("en", "utf-8")))) + results = connection.execute(query).fetchall() + if results: + for result in results: + entity_id.append(f"Q{str(result[0])}") + + except Exception as e: + raise ImporterException( + "Error attempting to read mappings from database\n{}".format(e) + ) + + return entity_id + + entity_id = query_wikidata_table(field_type=1) + if alias: + entity_id += query_wikidata_table(field_type=2) + + return entity_id
+
+ + + +
+[docs] +class MardiPropertyEntity(MardiProperty): + +
+[docs] + def new(self, **kwargs): + return MardiPropertyEntity(api=self.api, **kwargs)
+ + +
+[docs] + def get(self, entity_id, **kwargs): + json_data = super(MardiPropertyEntity, self)._get(entity_id=entity_id, **kwargs) + return MardiPropertyEntity(api=self.api).from_json(json_data=json_data['entities'][entity_id])
+ + +
+[docs] + def get_PID(self): + """Returns the PID of the property with the same label + """ + + label = "" + if 'en' in self.labels.values: + label = self.labels.values['en'].value + + with self.api.engine.connect() as connection: + metadata = db.MetaData() + try: + wbt_property_terms = db.Table( + "wbt_property_terms", metadata, autoload_with=connection + ) + wbt_term_in_lang = db.Table( + "wbt_term_in_lang", metadata, autoload_with=connection + ) + wbt_text_in_lang = db.Table( + "wbt_text_in_lang", metadata, autoload_with=connection + ) + wbt_text = db.Table( + "wbt_text", metadata, autoload_with=connection + ) + query = (db.select(wbt_property_terms.columns.wbpt_property_id) + .join(wbt_term_in_lang, wbt_term_in_lang.columns.wbtl_id == wbt_property_terms.columns.wbpt_term_in_lang_id) + .join(wbt_text_in_lang, wbt_term_in_lang.columns.wbtl_text_in_lang_id == wbt_text_in_lang.columns.wbxl_id) + .join(wbt_text, wbt_text.columns.wbx_id == wbt_text_in_lang.columns.wbxl_text_id) + .where(and_(wbt_text.columns.wbx_text == bytes(label, "utf-8"), + wbt_term_in_lang.columns.wbtl_type_id == 1, + wbt_text_in_lang.columns.wbxl_language == bytes("en", "utf-8")))) + prefix = "P" + results = connection.execute(query).fetchall() + if results: + for result in results: + return f"P{str(result[0])}" + + except Exception as e: + raise ImporterException( + "Error attempting to read mappings from database\n{}".format(e) + )
+
+ +
+ +
+
+ +
+
+
+
+ + + + \ No newline at end of file diff --git a/_modules/mardi_importer/integrator/MardiIntegrator.html b/_modules/mardi_importer/integrator/MardiIntegrator.html new file mode 100644 index 0000000..b3a2c28 --- /dev/null +++ b/_modules/mardi_importer/integrator/MardiIntegrator.html @@ -0,0 +1,989 @@ + + + + + + mardi_importer.integrator.MardiIntegrator — MaRDI Importer documentation + + + + + + + + + + + + + + + + + +
+ + +
+ +
+
+
+
    +
  • + + +
  • +
  • +
+
+
+
+
+ +

Source code for mardi_importer.integrator.MardiIntegrator

+import os
+import re
+import sqlalchemy as db
+
+from .MardiEntities import MardiItemEntity, MardiPropertyEntity
+from mardiclient import MardiClient
+from wikibaseintegrator import wbi_login
+from wikibaseintegrator.models import Claim, Claims, Qualifiers, Reference
+from wikibaseintegrator.wbi_config import config as wbi_config
+from wikibaseintegrator.wbi_enums import ActionIfExists
+from wikibaseintegrator.wbi_helpers import search_entities, execute_sparql_query
+from wikibaseintegrator.datatypes import (URL, CommonsMedia, ExternalID, Form, GeoShape, GlobeCoordinate, Item, Lexeme, Math, MonolingualText, MusicalNotation, Property, Quantity,
+                                          Sense, String, TabularData, Time)
+
+
+[docs] +class MardiIntegrator(MardiClient): + def __init__(self, languages=["en", "de"]) -> None: + super().__init__() + self.languages = languages + + self.setup = True + self.login = self.config() + self.engine = self.create_engine() + self.create_db_table() + + # local id of properties for linking to wikidata PID/QID + self.wikidata_PID = self.init_wikidata_PID() if self.setup else None + self.wikidata_QID = self.init_wikidata_QID() if self.setup else None + + self.item = MardiItemEntity(api=self) + self.property = MardiPropertyEntity(api=self) + + self.excluded_properties = ['P1151', 'P1855', 'P2139', 'P2302', \ + 'P2559', 'P2875', 'P3254', 'P3709', \ + 'P3713', 'P3734', 'P6104', 'P6685', \ + 'P8093', 'P8979'] + +
+[docs] + def config(self): + """ + Sets up initial configuration for the integrator + + Returns: + Clientlogin object + """ + if os.environ.get("IMPORTER_USER") and os.environ.get("IMPORTER_PASS"): + wbi_config["USER_AGENT"] = os.environ.get("IMPORTER_AGENT") + wbi_config["MEDIAWIKI_API_URL"] = os.environ.get("MEDIAWIKI_API_URL") + wbi_config["SPARQL_ENDPOINT_URL"] = os.environ.get("SPARQL_ENDPOINT_URL") + wbi_config["WIKIBASE_URL"] = os.environ.get("WIKIBASE_URL") + return wbi_login.Clientlogin( + user=os.environ.get("IMPORTER_USER"), + password=os.environ.get("IMPORTER_PASS"), + ) + else: + self.setup = False
+ + +
+[docs] + def create_engine(self): + """ + Creates SQLalchemy engine + + Returns: + SQLalchemy engine + """ + if self.setup: + db_user = os.environ["DB_USER"] + db_pass = os.environ["DB_PASS"] + db_name = os.environ["DB_NAME"] + db_host = os.environ["DB_HOST"] + return db.create_engine( + f"mysql+mysqlconnector://{db_user}:{db_pass}@{db_host}/{db_name}" + )
+ + +
+[docs] + def create_id_list_from_file(self, file): + """Function for creating a list of ids + from a while where each id is in a new line + + Args: + file: path to file + + Returns: list of ids + """ + id_list = [] + with open(file, "r") as file: + for line in file: + id_list.append(line.strip()) + return id_list
+ + +
+[docs] + def create_db_table(self): + """ + Check if db table for id mapping is there; if not, create. + + Args: + None + + Returns: + None + """ + if self.engine: + with self.engine.connect() as connection: + metadata = db.MetaData() + if not db.inspect(self.engine).has_table("wb_id_mapping"): + mapping_table = db.Table( + "wb_id_mapping", + metadata, + db.Column("id", db.Integer, primary_key=True), + db.Column("wikidata_id", db.String(24), nullable=False), + db.Column("local_id", db.String(24), nullable=False), + db.Column("has_all_claims", db.Boolean(), nullable=False), + db.UniqueConstraint("wikidata_id"), + db.UniqueConstraint("local_id"), + ) + metadata.create_all(self.engine)
+ + +
+[docs] + def insert_id_in_db(self, wikidata_id, local_id, has_all_claims): + """ + Insert wikidata_id, local_id and has_all_claims into mapping table. + + Args: + wikidata_id: Wikidata id + local_id: local Wikibase id + has_all_claims: Boolean indicating whether the entity has been + imported with all claims or no claims (i.e. no recurse) + + Returns: + None + """ + metadata = db.MetaData() + table = db.Table( + "wb_id_mapping", + metadata, + autoload_with=self.engine + ) + + ins = table.insert().values( + wikidata_id=wikidata_id, + local_id=local_id, + has_all_claims=has_all_claims + ) + + with self.engine.connect() as connection: + connection.execute(ins) + connection.commit()
+ + +
+[docs] + def update_has_all_claims(self, wikidata_id): + """ + Set the has_all_claims property in the wb_id_mapping table + to True for the given wikidata_id. + + Args: + wikidata_id: Wikidata id to be updated. + + Returns: + None + """ + metadata = db.MetaData() + table = db.Table( + "wb_id_mapping", + metadata, + autoload_with=self.engine + ) + + ins = table.update().values( + has_all_claims=True + ).where(table.c.wikidata_id == wikidata_id) + + with self.engine.connect() as connection: + connection.execute(ins) + connection.commit()
+ + +
+[docs] + def init_wikidata_PID(self): + """ + Searches the wikidata PID property ID to link + properties to its ID in wikidata. When not found, + it creates the property. + + Returns + wikidata_PID (str): wikidata PID property ID + """ + label = "Wikidata PID" + wikidata_PID = self.get_local_id_by_label(label, "property") + if not wikidata_PID: + prop = self.property.new() + prop.labels.set(language="en", value=label) + prop.descriptions.set( + language="en", + value="Identifier in Wikidata of the corresponding properties" + ) + prop.datatype = "external-id" + wikidata_PID = prop.write(login=self.login, as_new=True).id + return wikidata_PID
+ + +
+[docs] + def init_wikidata_QID(self): + """ + Searches the wikidata QID property ID to link + items to its ID in wikidata. When not found, + it creates the property. + + Returns + wikidata_QID (str): wikidata QID property ID + """ + label = "Wikidata QID" + wikidata_QID = self.get_local_id_by_label(label, "property") + if not wikidata_QID: + prop = self.property.new() + prop.labels.set(language="en", value=label) + prop.descriptions.set( + language="en", + value="Corresponding QID in Wikidata" + ) + prop.datatype = "external-id" + wikidata_QID = prop.write(login=self.login, as_new=True).id + return wikidata_QID
+ + +
+[docs] + def import_entities(self, id_list=None, filename="", recurse=True): + """Function for importing entities from wikidata + into the local instance. + + It can accept a single id, a list of ids or a file containing + a the ids to be imported. + + Args: + id_list: Single string or list of strings of wikidata + entity ids. Lexemes not supported. + filename: Filename containing list of entities to be + imported. + recurse: Whether to import claims for the entities in + id_list + + Returns: + Imported entities (Dict): Dictionary containing the local ids of + all the imported entities. + """ + imported_entities = {} + if filename: id_list = self.create_id_list_from_file(filename) + if isinstance(id_list, str): id_list = [id_list] + + for wikidata_id in id_list: + + if wikidata_id.startswith("L"): + print( + f"Warning: Lexemes not supported. Lexeme {wikidata_id} was not imported" + ) + continue + + print(f"importing entity {wikidata_id}") + + has_all_claims = self.query('has_all_claims', wikidata_id) + if not has_all_claims: + # API call + entity = self.get_wikidata_information( + wikidata_id, + recurse + ) + + if not entity: + print(f"No labels for entity with id {wikidata_id}, skipping") + continue + + if entity.type == "property" and entity.datatype.value in \ + ["wikibase-lexeme", "wikibase-sense", "wikibase-form"]: + print(f"Warning: Lexemes not supported. Property skipped") + continue + + # Check if there is an internal ID redirection in Wikidata + if wikidata_id != entity.id: + wikidata_id = entity.id + has_all_claims = self.query('has_all_claims', wikidata_id) + if has_all_claims: + imported_entities[wikidata_id] = self.query('local_id', wikidata_id) + continue + + if recurse: + self.convert_claim_ids(entity) + + entity.add_linker_claim(wikidata_id) + + local_id = entity.exists() + if not local_id: + local_id = self.query('local_id', wikidata_id) + + if local_id: + # Update existing entity + if entity.type == "item": + local_entity = self.item.get(entity_id=local_id) + elif entity.type == "property": + local_entity = self.property.get(entity_id=local_id) + # replace descriptions + local_entity.descriptions = entity.descriptions + # add new claims if they are different from old claims + local_entity.claims.add( + entity.claims, + ActionIfExists.APPEND_OR_REPLACE, + ) + local_entity.write(login=self.login) + if self.query('local_id', wikidata_id) and recurse: + self.update_has_all_claims(wikidata_id) + else: + self.insert_id_in_db(wikidata_id, local_id, has_all_claims=recurse) + else: + # Create entity + local_id = entity.write(login=self.login, as_new=True).id + self.insert_id_in_db(wikidata_id, local_id, has_all_claims=recurse) + + if has_all_claims: + imported_entities[wikidata_id] = self.query('local_id', wikidata_id) + else: + imported_entities[wikidata_id] = local_id + + if len(imported_entities) == 1: + return list(imported_entities.values())[0] + return imported_entities
+ + +
+[docs] + def overwrite_entity(self, wikidata_id, local_id): + """Function for completing an already existing local entity + with its statements from wikidata. + + Args: + wikidata_id: Wikidata entity ID to be imported. + local_id: Local id of the existing entity that needs to + be completed with further statements. + + Returns: + local_id: Local entity ID + """ + if wikidata_id.startswith("L"): + print( + f"Warning: Lexemes not supported. Lexeme {wikidata_id} was not imported" + ) + + print(f"Overwriting entity {local_id}") + + has_all_claims = self.query('has_all_claims', wikidata_id) + if has_all_claims: + return self.query('local_id', wikidata_id) + else: + # API call + entity = self.get_wikidata_information( + wikidata_id, + recurse=True + ) + + if entity: + + # Check if there is an entity ID redirection in Wikidata + if wikidata_id != entity.id: + wikidata_id = entity.id + has_all_claims = self.query('has_all_claims', wikidata_id) + if has_all_claims: + return self.query('local_id', wikidata_id) + + self.convert_claim_ids(entity) + entity.add_linker_claim(wikidata_id) + + # Retrieve existing entity + if entity.type == "item": + local_entity = self.item.get(entity_id=local_id) + elif entity.type == "property": + local_entity = self.property.get(entity_id=local_id) + # replace descriptions + local_entity.descriptions = entity.descriptions + # add new claims if they are different from old claims + local_entity.claims.add( + entity.claims, + ActionIfExists.APPEND_OR_REPLACE, + ) + local_entity.write(login=self.login) + if self.query('local_id', wikidata_id): + self.update_has_all_claims(wikidata_id) + else: + self.insert_id_in_db(wikidata_id, local_id, has_all_claims=True) + + return local_id
+ + +
+[docs] + def import_claim_entities(self, wikidata_id): + """Function for importing entities that are mentioned + in claims from wikidata to the local wikibase instance + + Args: + wikidata_id(str): id of the entity to be imported + + Returns: + local id or None, if the entity had no labels + """ + local_id = self.query('local_id', wikidata_id) + if local_id: return local_id + else: + entity = self.get_wikidata_information(wikidata_id) + + if not entity: + return None + + if entity.type == "property" and \ + entity.datatype.value in ["wikibase-lexeme", \ + "wikibase-sense", "wikibase-form"]: + return None + + elif wikidata_id != entity.id: + wikidata_id = entity.id + local_id = self.query('local_id', wikidata_id) + if local_id: return local_id + + # Check if the entity has been redirected by Wikidata + # into another entity that has already been imported + local_id = self.query('local_id', entity.id) + if local_id: return local_id + + local_id = entity.exists() + if local_id: + if entity.type == "item": + new_entity = self.item.get(entity_id=local_id) + elif entity.type == "property": + new_entity = self.property.get(entity_id=local_id) + # replace descriptions + new_entity.descriptions = entity.descriptions + entity = new_entity + entity.add_linker_claim(wikidata_id) + local_id = entity.write(login=self.login).id + else: + entity.add_linker_claim(wikidata_id) + local_id = entity.write(login=self.login, as_new=True).id + + self.insert_id_in_db(wikidata_id, local_id, has_all_claims=False) + return local_id
+ + +
+[docs] + def get_wikidata_information(self, wikidata_id, recurse=False): + """Function for pulling wikidata information + + Args: + wikidata_id (str): wikidata id of the desired entity + recurse (Bool): if claims should also be imported + + Returns: wikibase integrator entity or None, if the entity has no labels + + """ + if wikidata_id.startswith("Q"): + entity = self.item.get( + entity_id=wikidata_id, + mediawiki_api_url='https://www.wikidata.org/w/api.php' + ) + elif wikidata_id.startswith("P"): + entity = self.property.get( + entity_id=wikidata_id, + mediawiki_api_url='https://www.wikidata.org/w/api.php' + ) + else: + raise Exception( + f"Wrong ID format, should start with P, L or Q but ID is {wikidata_id}" + ) + if not self.languages == "all": + # set labels in desired languages + label_dict = { + k: entity.labels.values[k] + for k in self.languages + if k in entity.labels.values + } + # if there are no labels, this is not + # a valid entity + if not label_dict: + return None + entity.labels.values = label_dict + + # set descriptions in desired languages + description_dict = { + k: entity.descriptions.values[k] + for k in self.languages + if k in entity.descriptions.values + } + entity.descriptions.values = description_dict + + # make sure label != description (e.g. wdt:P121) + for k in self.languages: + if (label_dict.get(k) and + label_dict.get(k) == description_dict.get(k)): + entity.descriptions.set( + language=k, + value=None + ) + + # set aliases in desired languages + alias_dict = { + k: entity.aliases.aliases[k] + for k in self.languages + if k in entity.aliases.aliases + } + entity.aliases.aliases = alias_dict + if not recurse: + entity.claims = Claims() + return entity
+ + +
+[docs] + def convert_claim_ids(self, entity): + """Function for in-place conversion of wikidata + ids found in claims into local ids + + Args: + entity + + Returns: + None + """ + entity_names = [ + "wikibase-item", + "wikibase-property", + ] + claims = entity.claims.claims + new_claims = {} + # structure of claims: Dict[str,List[Claim]] + # where str is the property id + for prop_id, claim_list in claims.items(): + local_claim_list = [] + if prop_id not in self.excluded_properties: + local_prop_id = self.import_claim_entities(wikidata_id=prop_id) + if not local_prop_id: + print("Warning: local id skipped") + continue + for c in claim_list: + c_dict = c.get_json() + if c_dict["mainsnak"]["datatype"] in entity_names: + if "datavalue" in c_dict["mainsnak"]: + local_mainsnak_id = self.import_claim_entities( + wikidata_id=c_dict["mainsnak"]["datavalue"]["value"]["id"], + ) + if not local_mainsnak_id: + continue + c_dict["mainsnak"]["datavalue"]["value"][ + "id" + ] = local_mainsnak_id + c_dict["mainsnak"]["datavalue"]["value"]["numeric-id"] = int( + local_mainsnak_id[1:] + ) + c_dict["mainsnak"]["property"] = local_prop_id + # to avoid problem with missing reference hash + if "references" in c_dict: + c_dict.pop("references") + new_c = Claim().from_json(c_dict) + new_c.id = None + else: + continue + elif c_dict["mainsnak"]["datatype"] in ["wikibase-lexeme", "wikibase-sense", "wikibase-form"]: + continue + else: + self.convert_entity_links(snak=c_dict["mainsnak"]) + new_c = c + new_c.mainsnak.property_number = local_prop_id + new_c.id = None + # get reference details + new_references = self.get_references(c) + if new_references: + new_c.references.references = new_references + # get qualifier details + new_qualifiers = self.get_qualifiers(c) + new_c.qualifiers = new_qualifiers + local_claim_list.append(new_c) + new_claims[local_prop_id] = local_claim_list + entity.claims.claims = new_claims
+ + +
+[docs] + def get_references(self, claim): + """Function for creating references from wikidata references + and in place adding them to the claim + + Args: + claim: a wikibaseintegrator claim + + Returns: + List with references, can also be an empty list + """ + entity_names = [ + "wikibase-item", + "wikibase-property", + ] + # format: List(Reference) + ref_list = claim.references.references + if not ref_list: + return None + new_ref_list = [] + for ref in ref_list: + new_snak_dict = {} + snak_dict = ref.get_json() + for prop_id, snak_list in snak_dict["snaks"].items(): + new_snak_list = [] + new_prop_id = self.import_claim_entities( + wikidata_id=prop_id, + ) + if not new_prop_id: + continue + for snak in snak_list: + if snak["datatype"] in entity_names: + if not "datavalue" in snak: + continue + new_snak_id = self.import_claim_entities( + wikidata_id=snak["datavalue"]["value"]["id"], + ) + if not new_snak_id: + continue + snak["datavalue"]["value"]["id"] = new_snak_id + snak["datavalue"]["value"]["numeric-id"] = int(new_snak_id[1:]) + elif snak["datatype"] in ["wikibase-lexeme", "wikibase-sense", "wikibase-form"]: + continue + else: + self.convert_entity_links( + snak=snak, + ) + snak["property"] = new_prop_id + new_snak_list.append(snak) + new_snak_dict[new_prop_id] = new_snak_list + complete_new_snak_dict = {} + complete_new_snak_dict["hash"] = None + complete_new_snak_dict["snaks"] = new_snak_dict + complete_new_snak_dict["snaks-order"] = [] + r = Reference() + new_ref_list.append(r.from_json(json_data=complete_new_snak_dict)) + return new_ref_list
+ + +
+[docs] + def get_qualifiers(self, claim): + """Function for creating qualifiers from wikidata qualifiers + and in place adding them to the claim + + Args: + claim: a wikibaseintegrator claim + + Returns: + Qualifiers object, can also be an empty object + """ + entity_names = [ + "wikibase-item", + "wikibase-property", + ] + qual_dict = claim.qualifiers.get_json() + new_qual_dict = {} + for qual_id, qual_list in qual_dict.items(): + new_qual_id = self.import_claim_entities(wikidata_id=qual_id) + if not new_qual_id: + continue + new_qual_list = [] + for qual_val in qual_list: + if qual_val["datatype"] in entity_names: + if not "datavalue" in qual_val: + continue + new_qual_val_id = self.import_claim_entities( + wikidata_id=qual_val["datavalue"]["value"]["id"], + ) + if not new_qual_val_id: + continue + qual_val["datavalue"]["value"]["id"] = new_qual_val_id + qual_val["datavalue"]["value"]["numeric-id"] = int( + new_qual_val_id[1:] + ) + elif qual_val["datatype"] in ["wikibase-lexeme", "wikibase-sense", "wikibase-form"]: + continue + else: + self.convert_entity_links( + snak=qual_val, + ) + qual_val["property"] = new_qual_id + new_qual_list.append(qual_val) + new_qual_dict[new_qual_id] = new_qual_list + q = Qualifiers() + qualifiers = q.from_json(json_data=new_qual_dict) + return qualifiers
+ + + + + +
+[docs] + def query(self, parameter, wikidata_id): + """Query the wb_id_mapping db table for a given parameter. + + The two important parameters are the local_id and whether the + entity has already been imported with all claims + + Args: + parameter (str): Either local_id or has_all_claims + wikidata_id (str): Wikidata ID + Returns: + str or boolean: for local_id returns the local ID if it exists, + otherwise None. For has_all_claims, a boolean is returned. + """ + metadata = db.MetaData() + table = db.Table( + "wb_id_mapping", + metadata, + autoload_with=self.engine + ) + if parameter in ['local_id', 'has_all_claims']: + sql = db.select(table.columns[parameter]).where( + table.columns.wikidata_id == wikidata_id, + ) + with self.engine.connect() as connection: + db_result = connection.execute(sql).fetchone() + if db_result: + return db_result[0]
+ + +
+[docs] + def query_with_local_id(self, parameter, local_id): + """Query the wb_id_mapping db table for a given parameter. + + The two important parameters are the wikidata_id and whether the + entity has already been imported with all claims + + Args: + parameter (str): Either wikidata_id or has_all_claims + local_id (str): local ID + Returns: + str or boolean: for wikidata_id returns the wikidata ID if it exists, + otherwise None. For has_all_claims, a boolean is returned. + """ + metadata = db.MetaData() + table = db.Table( + "wb_id_mapping", + metadata, + autoload_with=self.engine + ) + if parameter in ['wikidata_id', 'has_all_claims']: + sql = db.select(table.columns[parameter]).where( + table.columns.local_id == local_id, + ) + with self.engine.connect() as connection: + db_result = connection.execute(sql).fetchone() + if db_result: + return db_result[0]
+ + +
+[docs] + def get_local_id_by_label(self, entity_str, entity_type): + """Check if entity with a given label or wikidata PID/QID + exists in the local wikibase instance. + + Args: + entity_str (str): It can be a string label or a wikidata ID, + specified with the prefix wdt: for properties and wd: + for items. + entity_type (str): Either 'property' or 'item' to specify + which type of entity to look for. + + Returns: + str: Local ID of the entity, if found. + """ + if re.match("^[PQ]\d+$", entity_str): + return entity_str + elif not entity_str.startswith("wdt:") and not entity_str.startswith("wd:"): + if entity_type == "property": + new_property = MardiPropertyEntity(api=self).new() + new_property.labels.set(language='en', value=entity_str) + return new_property.get_PID() + elif entity_type == "item": + new_item = MardiItemEntity(api=self).new() + new_item.labels.set(language='en', value=entity_str) + return new_item.get_QID() + elif entity_str.startswith("wdt:"): + wikidata_id = entity_str[4:] + elif entity_str.startswith("wd:"): + wikidata_id = entity_str[3:] + + with self.engine.connect() as connection: + metadata = db.MetaData() + table = db.Table( + "wb_id_mapping", metadata, autoload_with=connection + ) + sql = db.select(table.columns.local_id).where( + table.columns.wikidata_id == wikidata_id, + ) + db_result = connection.execute(sql).fetchone() + if db_result: + return db_result[0]
+ + +
+[docs] + def import_from_label(self, label): + """ + Imports an entity from Wikidata just from a label + + Args: + label (str): label to be imported from wikidata + + Returns: + local_id (str): local id for the imported entity + """ + results = search_entities(label, + dict_result=True, + mediawiki_api_url='https://www.wikidata.org/w/api.php') + for result in results: + if label == result['label']: + return self.import_entities(result['id']) + if label.lower() == result['label'].lower(): + return self.import_entities(result['id']) + if result['aliases']: + if label.lower() == result['aliases'][0].lower(): + return self.import_entities(result['id'])
+
+ +
+ +
+
+ +
+
+
+
+ + + + \ No newline at end of file diff --git a/_modules/mardi_importer/zbmath/ZBMathSource.html b/_modules/mardi_importer/zbmath/ZBMathSource.html new file mode 100644 index 0000000..dd0ce7f --- /dev/null +++ b/_modules/mardi_importer/zbmath/ZBMathSource.html @@ -0,0 +1,727 @@ + + + + + + mardi_importer.zbmath.ZBMathSource — MaRDI Importer documentation + + + + + + + + + + + + + + + + + +
+ + +
+ +
+
+
+
    +
  • + + +
  • +
  • +
+
+
+
+
+ +

Source code for mardi_importer.zbmath.ZBMathSource

+import json
+import os
+import re
+import sys
+import time
+import traceback
+import xml.etree.ElementTree as ET
+
+from datetime import datetime
+from habanero import Crossref  # , RequestError
+from requests.exceptions import HTTPError, ContentDecodingError
+from sickle import Sickle
+
+from mardi_importer.integrator import MardiIntegrator
+from mardi_importer.importer import ADataSource
+from .ZBMathPublication import ZBMathPublication
+from .ZBMathAuthor import ZBMathAuthor
+from .ZBMathJournal import ZBMathJournal
+from .misc import get_tag, get_info_from_doi
+
+
+
+[docs] +class ZBMathSource(ADataSource): + """Reads data from zb math API.""" + + def __init__( + self, + out_dir, + tags, + from_date=None, + until_date=None, + raw_dump_path=None, + processed_dump_path=None, + split_id=None, + ): # , path + """ + Args: + out_dir (string): target directory for saved files + tags (list): list of tags to extract from the zbMath response + from_date (string, optional): earliest date from when to pull information + until_date (string, optional): latest date from when to pull information + raw_dump_path (string, optional): path where the raw data dump is located, in case it has previously been pulled + processed_dump_path (string, optional): path to the processed dump file + split_id (string, optional): zbMath id from where to start processing the raw dump, in case it aborted mid-processing + """ + # load the list of swMath software + # software_df = pd.read_csv(path) + # self.software_list = software_df['Software'].tolist() + if out_dir[-1] != "/": + out_dir = out_dir + "/" + self.out_dir = out_dir + self.split_id = split_id + if self.split_id: + self.split_mode = True + else: + self.split_mode = False + self.from_date = from_date + self.until_date = until_date + self.tags = tags + self.integrator = MardiIntegrator() + self.conflict_string = ( + "zbMATH Open Web Interface contents unavailable due to conflicting licenses" + ) + self.raw_dump_path = raw_dump_path + self.filepath = os.path.realpath(os.path.dirname(__file__)) + self.processed_dump_path = processed_dump_path + self.namespace = "http://www.openarchives.org/OAI/2.0/" + self.preview_namespace = "https://zbmath.org/OAI/2.0/oai_zb_preview/" + self.tag_namespace = "https://zbmath.org/zbmath/elements/1.0/" + self.conflict_text = "zbMATH Open Web Interface contents unavailable due to conflicting licenses." + # dict for counting how often a doi was not found and which agency it was registered with + self.unknown_doi_agency_dict = {"Crossref": [], "crossref": [], "nonsense": []} + # tags that will not be found in doi query + self.internal_tags = ["author_id", "source", "classifications", "links"] + self.existing_authors = {} + self.existing_journals = {} + +
+[docs] + def setup(self): + """Create all necessary properties and entities for zbMath""" + # Import entities from Wikidata + filename = self.filepath + "/wikidata_entities.txt" + self.integrator.import_entities(filename=filename) + self.create_local_entities() + self.de_number_prop = self.integrator.get_local_id_by_label( + "zbMATH DE Number", "property" + ) + self.keyword_prop = self.integrator.get_local_id_by_label( + "zbMATH Keywords", "property" + )
+ + +
+[docs] + def create_local_entities(self): + filename = self.filepath + "/new_entities.json" + f = open(filename) + entities = json.load(f) + + for prop_element in entities["properties"]: + prop = self.integrator.property.new() + prop.labels.set(language="en", value=prop_element["label"]) + prop.descriptions.set(language="en", value=prop_element["description"]) + prop.datatype = prop_element["datatype"] + if not prop.exists(): + prop.write() + + for item_element in entities["items"]: + item = self.integrator.item.new() + item.labels.set(language="en", value=item_element["label"]) + item.descriptions.set(language="en", value=item_element["description"]) + for key, value in item_element["claims"].items(): + item.add_claim(key, value=value) + if not item.exists(): + item.write()
+ + +
+[docs] + def pull(self): + # self.write_data_dump() + self.process_data()
+ + +
+[docs] + def write_data_dump(self): + """ + Overrides abstract method. + This method queries the zbMath API to get a data dump of all records, + optionally between from_date and until_date + """ + timestr = time.strftime("%Y%m%d-%H%M%S") + self.raw_dump_path = self.out_dir + "raw_zbmath_data_dump" + timestr + ".txt" + sickle = Sickle("https://oai.zbmath.org/v1") + # date has to have format like 2012-12-12 + if self.from_date and self.until_date: + records = sickle.ListRecords( + **{ + "metadataPrefix": "oai_zb_preview", + "from": self.from_date, + "until": self.until_date, + } + ) + elif self.from_date: + records = sickle.ListRecords( + **{"metadataPrefix": "oai_zb_preview", "from": self.from_date} + ) + elif self.until_date: + records = sickle.ListRecords( + **{"metadataPrefix": "oai_zb_preview", "until": self.until_date} + ) + else: + records = sickle.ListRecords(metadataPrefix="oai_zb_preview") + with open(self.raw_dump_path, "w+") as f: + for rec in records: + f.write(rec.raw + "\n")
+ + +
+[docs] + def process_data(self): + """ + Overrides abstract method. + Reads a raw zbMath data dump and processes it, then saves it as a csv. + """ + if not (self.processed_dump_path and self.split_mode): + timestr = time.strftime("%Y%m%d-%H%M%S") + self.processed_dump_path = ( + self.out_dir + "zbmath_data_dump" + timestr + ".csv" + ) + # def do_all(xml_file, out_file): + with open(self.raw_dump_path) as infile: + with open(self.processed_dump_path, "a") as outfile: + # if we are not continuing with a pre-filled file + if not self.split_mode: + outfile.write( + "de_number\t" + + "creation_date\t" + + ("\t").join(self.tags) + + "_text\treview_sign\treviewer_id\n" + ) + record_string = "" + for line in infile: + record_string = record_string + line + if line.endswith("</record>\n"): + element = ET.fromstring(record_string) + if self.split_mode: + de_number = self.get_de_number(element) + # if the last processed id is found + if de_number == self.split_id: + # next iteration, continue with writing + self.split_mode = False + record_string = "" + continue + else: + # continue searching + record_string = "" + continue + record = self.parse_record(element) + if record: + outfile.write( + "\t".join(str(x) for x in record.values()) + "\n" + ) + record_string = ""
+ + +
+[docs] + def parse_record(self, xml_record): + """ + Parse xml record from zbMath API. + + Args: + xml_record (xml element): record returned by zbMath API + + Returns: + dict: dict of (tag,value) pairs extracted from xml_record + """ + is_conflict = False + new_entry = {} + # zbMath identifier + de_number = self.get_de_number(xml_record) + creation_date = self.get_creation_date(xml_record) + new_entry["de_number"] = de_number + new_entry["creation_date"] = creation_date + # read tags + zb_preview = xml_record.find( + get_tag("metadata", namespace=self.namespace) + ).find(get_tag("zbmath", self.preview_namespace)) + if zb_preview: + for tag in self.tags: + value = zb_preview.find(get_tag(tag, self.tag_namespace)) + if value is not None: + if len(value): + if tag == "review": + for subtag in ["review_text", "review_sign", "reviewer_id"]: + subvalue = value.find( + get_tag(subtag, self.tag_namespace) + ) + if subvalue is not None: + if len(subvalue): + sys.exit(f"tag {subtag} has children") + else: + text = subvalue.text + if subtag == "review_text": + text = text.replace("\t", " ") + text = text.replace("\n", " ") + new_entry[subtag] = text + else: + new_entry[subtag] = None + continue + + # element has children + texts = [] + for child in value: + texts.append(child.text) + texts = [t for t in texts if t is not None] + text = ";".join( + texts + ) # multiple values are rendered as a semicolon-separated string + + else: + # element content is a simple text + text = zb_preview.find(get_tag(tag, self.tag_namespace)).text + + text = text.replace("\n", " ") + new_entry[tag] = text + # if tag is not found in zbMath return, we still want to get it from doi + else: + new_entry[tag] = None + # return record, even if incomplete + return new_entry + else: + sys.exit("Error: zb_preview not found")
+ + +
+[docs] + def push(self): + """Updates the MaRDI Wikibase entities corresponding to zbMath publications. + It creates a :class:`mardi_importer.zbmath.ZBMathPublication` instance + for each publication. Authors and journals are added, as well. + """ + found = False + with open(self.processed_dump_path, "r") as infile: + in_header_line = True + for line in infile: + if in_header_line: + headers = line.strip().split("\t") + in_header_line = False + continue + split_line = line.strip("\n").split("\t") + # formatting error: skip + if len(split_line) != len(headers): + continue + info_dict = dict(zip(headers, split_line)) + # this part is for continuing at a certain position if the import failed + # if not found: + # if info_dict["de_number"].strip() != " ": + # if info_dict["document_title"] != "Unimodular supergravity": + # continue + # else: + # found = True + # continue + # if there is not title, don't add + if self.conflict_string in info_dict["document_title"]: + if ( + self.conflict_string not in info_dict["doi"] + and info_dict["doi"] != "None" + ): + document_title = get_info_from_doi( + doi=info_dict["doi"].strip(), key="document_title" + ) + if not document_title: + print("No title from doi, uploading empty") + else: + print(f"Found document title {document_title} from doi") + else: + print("No doi found, uploading empty.") + document_title = None + # only upload those where there was a conflict before + else: + document_title = info_dict["document_title"].strip() + if not info_dict["zbl_id"] == "None": + zbl_id = info_dict["zbl_id"] + else: + zbl_id = None + + if ( + not self.conflict_string in info_dict["author_ids"] + and "None" not in info_dict["author_ids"] + ): + author_ids = info_dict["author_ids"].split(";") + if ( + self.conflict_string in info_dict["author"] + or "None" in info_dict["author"] + ): + author_strings = [None] * len(author_ids) + else: + author_strings = info_dict["author"].split(";") + authors = [] + for a, a_id in zip(author_strings, author_ids): + if not a and not a_id: + continue + if a: + a = a.strip() + a_id = a_id.strip() + if a_id in self.existing_authors: + authors.append(self.existing_authors[a_id]) + print(f"Author with name {a} was already created this run.") + else: + for attempt in range(5): + try: + author = ZBMathAuthor( + integrator=self.integrator, + name=a, + zbmath_author_id=a_id, + ) + local_author_id = author.create() + except Exception as e: + print(f"Exception: {e}, sleeping") + print(traceback.format_exc()) + time.sleep(120) + else: + break + else: + sys.exit("Uploading author did not work after retries!") + authors.append(local_author_id) + self.existing_authors[a_id] = local_author_id + else: + authors = [] + + if ( + self.conflict_string in info_dict["serial"] + or info_dict["serial"].strip() == "None" + ): + if ( + self.conflict_string not in info_dict["doi"] + and info_dict["doi"] != "None" + ): + journal_string = get_info_from_doi( + doi=info_dict["doi"].strip(), key="journal" + ) + else: + journal_string = None + else: + journal_string = info_dict["serial"].split(";")[-1].strip() + if journal_string: + if journal_string in self.existing_journals: + journal = self.existing_journals[journal_string] + print( + f"Journal {journal_string} was already created in this run." + ) + else: + for attempt in range(5): + try: + journal_item = ZBMathJournal( + integrator=self.integrator, name=journal_string + ) + if journal_item.exists(): + print(f"Journal {journal_string} exists!") + journal = journal_item.QID + else: + print(f"Creating journal {journal_string}") + journal = journal_item.create() + except Exception as e: + print(f"Exception: {e}, sleeping") + print(traceback.format_exc()) + time.sleep(120) + else: + break + else: + sys.exit("Uploading journal did not work after retries!") + self.existing_journals[journal_string] = journal + else: + journal = None + + if not self.conflict_string in info_dict["language"]: + language = info_dict["language"].strip() + else: + language = None + + if not self.conflict_string in info_dict["publication_year"]: + time_string = ( + f"+{info_dict['publication_year'].strip()}-00-00T00:00:00Z" + ) + else: + time_string = None + + if not self.conflict_string in info_dict["links"]: + pattern = re.compile( + r"^([a-z][a-z\d+.-]*):([^][<>\"\x00-\x20\x7F])+$" + ) + links = info_dict["links"].split(";") + links = [ + x.strip() for x in links if (pattern.match(x) and "http" in x) + ] + else: + links = [] + + if ( + not self.conflict_string in info_dict["doi"] + and not "None" in info_dict["doi"] + ): + doi = info_dict["doi"].strip() + else: + doi = None + + if info_dict["creation_date"] != "0001-01-01T00:00:00": + # because there can be no hours etc + creation_date = ( + f"{info_dict['creation_date'].split('T')[0]}T00:00:00Z" + ) + else: + creation_date = None + + if ( + not self.conflict_string in info_dict["review_text"] + and info_dict["review_text"].strip() != "None" + ): + review_text = info_dict["review_text"].strip() + if ( + not self.conflict_string in info_dict["review_sign"] + and info_dict["review_sign"].strip() != "None" + and not self.conflict_string in info_dict["reviewer_id"] + and info_dict["reviewer_id"].strip() != "None" + and info_dict["reviewer_id"].strip() != "" + ): + reviewer_id = info_dict["reviewer_id"].strip() + reviewer_name = ( + info_dict["review_sign"] + .strip() + .split("/")[0] + .strip() + .split("(")[0] + .strip() + ) + if reviewer_id in self.existing_authors: + reviewer = self.existing_authors[reviewer_id] + print( + f"Reviewer with name {a} was already created this run." + ) + else: + for attempt in range(5): + try: + reviewer_object = ZBMathAuthor( + integrator=self.integrator, + name=reviewer_name, + zbmath_author_id=reviewer_id, + ) + reviewer = reviewer_object.create() + except Exception as e: + print(f"Exception: {e}, sleeping") + print(traceback.format_exc()) + time.sleep(120) + else: + break + else: + sys.exit( + "Uploading reviewer did not work after retries!" + ) + self.existing_authors[reviewer_id] = reviewer + else: + reviewer = None + else: + review_text = None + reviewer = None + + if ( + not self.conflict_string in info_dict["classifications"] + and info_dict["classifications"].strip() != "None" + and info_dict["classifications"].strip() != "" + ): + classifications = info_dict["classifications"].strip().split(";") + else: + classifications = None + + if info_dict["de_number"].strip() != "None": + de_number = info_dict["de_number"].strip() + else: + de_number = None + + if ( + not self.conflict_string in info_dict["keywords"] + and info_dict["keywords"].strip() != "None" + and info_dict["keywords"].strip() != "" + ): + keywords = info_dict["keywords"].strip().split(";") + keywords = [x.strip() for x in keywords] + else: + keywords = None + for attempt in range(5): + try: + publication = ZBMathPublication( + integrator=self.integrator, + title=document_title, + doi=doi, + authors=authors, + journal=journal, + language=language, + time=time_string, + links=links, + creation_date=creation_date, + zbl_id=zbl_id, + review_text=review_text, + reviewer=reviewer, + classifications=classifications, + de_number=de_number, + keywords=keywords, + de_number_prop=self.de_number_prop, + keyword_prop=self.keyword_prop, + ) + if publication.exists(): + print(f"Publication {document_title} exists") + publication.update() + else: + print(f"Creating publication {document_title}") + publication.create() + except Exception as e: + print(f"Exception: {e}, sleeping") + print(traceback.format_exc()) + time.sleep(120) + else: + break + else: + sys.exit("Uploading publication did not work after retries!")
+ + +
+[docs] + def get_de_number(self, xml_record): + """ + Get zbMath id from xml record. + + Args: + xml_record (xml element): record returned by zbMath API + + Returns: + string: zbMath ID + """ + de_number = ( + xml_record.find(get_tag("header", self.namespace)) + .find(get_tag("identifier", namespace=self.namespace)) + .text + ) + de_number = de_number.split(":")[-1] + return de_number
+ + +
+[docs] + def get_creation_date(self, xml_record): + """ + Get creation date from xml record. + + Args: + xml_record (xml element): record returned by zbMath API + + Returns: + string: creation date + """ + creation_date = ( + xml_record.find(get_tag("header", self.namespace)) + .find(get_tag("datestamp", namespace=self.namespace)) + .text + ) + return creation_date
+
+ +
+ +
+
+ +
+
+
+
+ + + + \ No newline at end of file diff --git a/_modules/mardi_importer/zbmath/misc.html b/_modules/mardi_importer/zbmath/misc.html new file mode 100644 index 0000000..9437b47 --- /dev/null +++ b/_modules/mardi_importer/zbmath/misc.html @@ -0,0 +1,264 @@ + + + + + + mardi_importer.zbmath.misc — MaRDI Importer documentation + + + + + + + + + + + + + + + + + +
+ + +
+ +
+
+
+ +
+
+
+
+ +

Source code for mardi_importer.zbmath.misc

+from habanero import Crossref
+from requests.exceptions import HTTPError
+
+
+
+[docs] +def get_tag(tag_name, namespace): + """ + Returns a fully qualified tag name. + + Args: + tag_name (string): name of tag, e.g. author + namespace (string): namespace URL of a namespace + """ + return "{{{}}}{}".format(namespace, tag_name)
+ + + +
+[docs] +def parse_doi_info(val, work_info): + """ + Function to extract information returned by a doi query for a specific tag. + + Args: + val (string): tag, e.g. author + work_info (dict): information from doi query response + + Returns: + string: information for specific tag, None if not found + """ + # information about return fields can be found under https://api.crossref.org/swagger-ui/index.html#/Works/get_works + if val == "author": + # author and the familiy subfield are mandatory fields in crossref api + # looks like: 'author': [{'given': 'Max', 'family': 'Mustermann', 'sequence': 'first', 'affiliation': []}] + if "author" not in work_info: + return None + first_name = "" + family_name = "" + author_list = [] + for author_dict in work_info["author"]: + # family name not known: too little information + if "family" not in author_dict: + return None + family_name = author_dict["family"] + # family name not known; too little information + if not family_name: + return None + if "given" in author_dict: + first_name = author_dict["given"] + # first name not necessarily needed + if not first_name: + author_list.append(family_name) + else: + author_list.append(family_name + ", " + first_name) + + return ";".join(author_list) + elif val == "document_title": + if "document_title" not in work_info: + return None + title_list = work_info["title"] + if title_list: + return ";".join(title_list) + else: + return None + elif val == "publication_year": + # date-parts is a mandaory field for published in crossref api + # 'published': {'date-parts': [[2008]]}} this is not necessarily the year this was published in the journal, apparently... + if "published" not in work_info: + return None + # this is either a year or None + return work_info["published"]["date_parts"][0][0] + elif val == "serial": + if "reference" not in work_info: + return None + serials = [] + for serial_dict in work_info["reference"]: + if "journal_title" in serial_dict: + serials.append(serial_dict["journal-title"]) + # if no serials were found + if not serials: + return None + # make list unique + serials = list(set(serials)) + return ";".join(serials) + + elif val == "language": + if "language" not in work_info: + return None + return work_info["language"] + elif val == "keywords": + if "subject" not in work_info: + return None + return ";".join(work_info["subject"])
+ + + +
+[docs] +def get_info_from_doi(doi, key): + """ + Query crossref API for DOI information. + + Args: + doi: doi + key: document_title only for now + + Returns: + title: document title + """ + doi_list = doi.split(";") + # print("doi") + # print(doi) + # print("doi list") + # print(doi_list) + cr = Crossref(mailto="pusch@zib.de") + for doi in doi_list: + try: + work_info = cr.works(ids=doi) + # print("work info") + # print(work_info) + if key == "document_title": + if "title" not in work_info["message"]: + continue + # print(work_info["message"]) + # print(work_info["message"]["title"]) + title_list = work_info["message"]["title"] + if title_list: + joint_title = ";".join(title_list).strip() + joint_title = joint_title.replace("\n", " ").strip() + joint_title = joint_title.replace("\t", " ").strip() + if len(joint_title) > 500: + return None + return joint_title + else: + continue + elif key == "journal": + if "container-title" not in work_info["message"]: + return None + if not work_info["message"]["container-title"]: + return None + journal = work_info["message"]["container-title"][0].strip() + return journal + # if the doi is not found, there is a 404 + except HTTPError: + print("HTTP Error!") + continue + return None
+ +
+ +
+
+ +
+
+
+
+ + + + \ No newline at end of file diff --git a/_sources/cran.rst.txt b/_sources/cran.rst.txt new file mode 100644 index 0000000..85164f5 --- /dev/null +++ b/_sources/cran.rst.txt @@ -0,0 +1,41 @@ +CRAN module +=========== + +This module imports R packages published at the Comprehensive R Archive Network `(CRAN) `_. + +Specifically, it reads the table of `packages ordered by date of publication `_. +This table contains for each R package the **package name**, **title** and **date of publication**. Based on the **package name**, +each package url can be accessed from: + +``https://cran.r-project.org/web/packages//index.html`` + +Several attributes are listed for each package. Among them, the following attributes are imported, when present, to the MaRDI knowledge graph: + +:Version: Version of the package. +:Depends: Software and package dependencies, including other R packages. +:Published: Date of publication. +:Author: Authors of the package are to be indicated according to the `CRAN Repository Policy `_ with the abbreviation \[aut\]. Given that this guideline is not always implemented, it is not always + possible to properly parse the authors. + + When no abbrevations describing the role of each individual are included, just the first listed author is imported. +:License: `List of accepted licenses `_. +:Maintainer: Software maintainer (Generally one of the authors). + + +mardi_importer.cran.CRANSource class +-------------------------------------------- + +.. automodule:: mardi_importer.cran.CRANSource + :members: + :undoc-members: + :show-inheritance: + :member-order: bysource + +mardi_importer.cran.RPackage class +-------------------------------------------- + +.. automodule:: mardi_importer.cran.RPackage + :members: + :undoc-members: + :show-inheritance: + :member-order: bysource \ No newline at end of file diff --git a/_sources/importer.rst.txt b/_sources/importer.rst.txt new file mode 100644 index 0000000..df17ad8 --- /dev/null +++ b/_sources/importer.rst.txt @@ -0,0 +1,10 @@ +mardi_importer.importer module +============================== + +mardi_importer.importer.Importer module +--------------------------------------- + +.. automodule:: mardi_importer.importer.Importer + :members: + :undoc-members: + :show-inheritance: diff --git a/_sources/index.rst.txt b/_sources/index.rst.txt new file mode 100644 index 0000000..bd16a96 --- /dev/null +++ b/_sources/index.rst.txt @@ -0,0 +1,40 @@ +.. MaRDI Importer documentation master file, created by + sphinx-quickstart on Thu Apr 21 13:46:03 2022. + You can adapt this file completely to your liking, but it should at least + contain the root `toctree` directive. + +MaRDI Importer Documentation +============================ + +This is the documentation of docker-importer. + + +Table of contents +----------------- + +.. toctree:: + :maxdepth: 2 + :caption: Manual + + main + tech + +.. toctree:: + :maxdepth: 2 + :caption: API Documentation + + scripts + cran + importer + integrator + polydb + zbmath + + + +Indices and tables +================== + +* :ref:`genindex` +* :ref:`modindex` +* :ref:`search` diff --git a/_sources/integrator.rst.txt b/_sources/integrator.rst.txt new file mode 100644 index 0000000..ad92de5 --- /dev/null +++ b/_sources/integrator.rst.txt @@ -0,0 +1,18 @@ +mardi_importer.integrator module +================================ + +mardi_importer.integrator.MardiIntegrator module +------------------------------------------------ + +.. automodule:: mardi_importer.integrator.MardiIntegrator + :members: + :undoc-members: + :show-inheritance: + +mardi_importer.integrator.MardiEntities module +---------------------------------------------- + +.. automodule:: mardi_importer.integrator.MardiEntities + :members: + :undoc-members: + :show-inheritance: \ No newline at end of file diff --git a/_sources/main.rst.txt b/_sources/main.rst.txt new file mode 100644 index 0000000..329e40c --- /dev/null +++ b/_sources/main.rst.txt @@ -0,0 +1,55 @@ +Introduction +============ + +What is this about? + + +Installation +============ + +Without Docker +-------------- + +Install the python package of :code:`mardi-importer` by first installing the +requirements from :code:`requirements.txt`, + +.. code:: shell + + pip install -r requirements.txt + +Then install the packages via + +.. code:: shell + + pip install -U -e . + +:code:`-U` enforces reinstalling the package, with :code:`-e` modifications in +the source files are automatically taken into account. + +Note: for convenience, local installations not using docker can be placed within +virtual environments by first calling + +.. code:: shell + + python3 -m venv env + source env/bin/activate + +With Docker +----------- + +TODO + + +Build documentation +------------------- + +In :code:`docs/`, run :code:`make html` to generate the documentation for a +local installation. The modules have to be installed and findable by :code:`import +module`. To view the docs, open the file :code:`docs/_build/html/index.html`. + + +Usage +===== + +TODO + diff --git a/_sources/polydb.rst.txt b/_sources/polydb.rst.txt new file mode 100644 index 0000000..377f979 --- /dev/null +++ b/_sources/polydb.rst.txt @@ -0,0 +1,14 @@ +mardi_importer.polydb module +============================ + +mardi_importer.polydb.PolyDBSource module +----------------------------------------- + +.. automodule:: mardi_importer.polydb + :members: + :undoc-members: + :show-inheritance: + + + + diff --git a/_sources/scripts.rst.txt b/_sources/scripts.rst.txt new file mode 100644 index 0000000..efbe32f --- /dev/null +++ b/_sources/scripts.rst.txt @@ -0,0 +1,7 @@ +Launcher script +--------------- + +.. argparse:: + :filename: ../mardi_importer/mardi_importer/scripts/import.py + :func: get_parser + :prog: import.py diff --git a/_sources/tech.rst.txt b/_sources/tech.rst.txt new file mode 100644 index 0000000..dc39da6 --- /dev/null +++ b/_sources/tech.rst.txt @@ -0,0 +1,4 @@ +Importer diagram +================ + +.. image:: activity.drawio.svg diff --git a/_sources/zbmath.rst.txt b/_sources/zbmath.rst.txt new file mode 100644 index 0000000..b02abbc --- /dev/null +++ b/_sources/zbmath.rst.txt @@ -0,0 +1,18 @@ +mardi_importer.zbmath module +============================ + +mardi_importer.zbmath.ZBMathSource module +----------------------------------------- + +.. automodule:: mardi_importer.zbmath.ZBMathSource + :members: + :undoc-members: + :show-inheritance: + +mardi_importer.zbmath.misc module +--------------------------------- + +.. automodule:: mardi_importer.zbmath.misc + :members: + :undoc-members: + :show-inheritance: diff --git a/_static/_sphinx_javascript_frameworks_compat.js b/_static/_sphinx_javascript_frameworks_compat.js new file mode 100644 index 0000000..8141580 --- /dev/null +++ b/_static/_sphinx_javascript_frameworks_compat.js @@ -0,0 +1,123 @@ +/* Compatability shim for jQuery and underscores.js. + * + * Copyright Sphinx contributors + * Released under the two clause BSD licence + */ + +/** + * small helper function to urldecode strings + * + * See https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/decodeURIComponent#Decoding_query_parameters_from_a_URL + */ +jQuery.urldecode = function(x) { + if (!x) { + return x + } + return decodeURIComponent(x.replace(/\+/g, ' ')); +}; + +/** + * small helper function to urlencode strings + */ +jQuery.urlencode = encodeURIComponent; + +/** + * This function returns the parsed url parameters of the + * current request. Multiple values per key are supported, + * it will always return arrays of strings for the value parts. + */ +jQuery.getQueryParameters = function(s) { + if (typeof s === 'undefined') + s = document.location.search; + var parts = s.substr(s.indexOf('?') + 1).split('&'); + var result = {}; + for (var i = 0; i < parts.length; i++) { + var tmp = parts[i].split('=', 2); + var key = jQuery.urldecode(tmp[0]); + var value = jQuery.urldecode(tmp[1]); + if (key in result) + result[key].push(value); + else + result[key] = [value]; + } + return result; +}; + +/** + * highlight a given string on a jquery object by wrapping it in + * span elements with the given class name. + */ +jQuery.fn.highlightText = function(text, className) { + function highlight(node, addItems) { + if (node.nodeType === 3) { + var val = node.nodeValue; + var pos = val.toLowerCase().indexOf(text); + if (pos >= 0 && + !jQuery(node.parentNode).hasClass(className) && + !jQuery(node.parentNode).hasClass("nohighlight")) { + var span; + var isInSVG = jQuery(node).closest("body, svg, foreignObject").is("svg"); + if (isInSVG) { + span = document.createElementNS("http://www.w3.org/2000/svg", "tspan"); + } else { + span = document.createElement("span"); + span.className = className; + } + span.appendChild(document.createTextNode(val.substr(pos, text.length))); + node.parentNode.insertBefore(span, node.parentNode.insertBefore( + document.createTextNode(val.substr(pos + text.length)), + node.nextSibling)); + node.nodeValue = val.substr(0, pos); + if (isInSVG) { + var rect = document.createElementNS("http://www.w3.org/2000/svg", "rect"); + var bbox = node.parentElement.getBBox(); + rect.x.baseVal.value = bbox.x; + rect.y.baseVal.value = bbox.y; + rect.width.baseVal.value = bbox.width; + rect.height.baseVal.value = bbox.height; + rect.setAttribute('class', className); + addItems.push({ + "parent": node.parentNode, + "target": rect}); + } + } + } + else if (!jQuery(node).is("button, select, textarea")) { + jQuery.each(node.childNodes, function() { + highlight(this, addItems); + }); + } + } + var addItems = []; + var result = this.each(function() { + highlight(this, addItems); + }); + for (var i = 0; i < addItems.length; ++i) { + jQuery(addItems[i].parent).before(addItems[i].target); + } + return result; +}; + +/* + * backward compatibility for jQuery.browser + * This will be supported until firefox bug is fixed. + */ +if (!jQuery.browser) { + jQuery.uaMatch = function(ua) { + ua = ua.toLowerCase(); + + var match = /(chrome)[ \/]([\w.]+)/.exec(ua) || + /(webkit)[ \/]([\w.]+)/.exec(ua) || + /(opera)(?:.*version|)[ \/]([\w.]+)/.exec(ua) || + /(msie) ([\w.]+)/.exec(ua) || + ua.indexOf("compatible") < 0 && /(mozilla)(?:.*? rv:([\w.]+)|)/.exec(ua) || + []; + + return { + browser: match[ 1 ] || "", + version: match[ 2 ] || "0" + }; + }; + jQuery.browser = {}; + jQuery.browser[jQuery.uaMatch(navigator.userAgent).browser] = true; +} diff --git a/_static/basic.css b/_static/basic.css new file mode 100644 index 0000000..30fee9d --- /dev/null +++ b/_static/basic.css @@ -0,0 +1,925 @@ +/* + * basic.css + * ~~~~~~~~~ + * + * Sphinx stylesheet -- basic theme. + * + * :copyright: Copyright 2007-2023 by the Sphinx team, see AUTHORS. + * :license: BSD, see LICENSE for details. + * + */ + +/* -- main layout ----------------------------------------------------------- */ + +div.clearer { + clear: both; +} + +div.section::after { + display: block; + content: ''; + clear: left; +} + +/* -- relbar ---------------------------------------------------------------- */ + +div.related { + width: 100%; + font-size: 90%; +} + +div.related h3 { + display: none; +} + +div.related ul { + margin: 0; + padding: 0 0 0 10px; + list-style: none; +} + +div.related li { + display: inline; +} + +div.related li.right { + float: right; + margin-right: 5px; +} + +/* -- sidebar --------------------------------------------------------------- */ + +div.sphinxsidebarwrapper { + padding: 10px 5px 0 10px; +} + +div.sphinxsidebar { + float: left; + width: 230px; + margin-left: -100%; + font-size: 90%; + word-wrap: break-word; + overflow-wrap : break-word; +} + +div.sphinxsidebar ul { + list-style: none; +} + +div.sphinxsidebar ul ul, +div.sphinxsidebar ul.want-points { + margin-left: 20px; + list-style: square; +} + +div.sphinxsidebar ul ul { + margin-top: 0; + margin-bottom: 0; +} + +div.sphinxsidebar form { + margin-top: 10px; +} + +div.sphinxsidebar input { + border: 1px solid #98dbcc; + font-family: sans-serif; + font-size: 1em; +} + +div.sphinxsidebar #searchbox form.search { + overflow: hidden; +} + +div.sphinxsidebar #searchbox input[type="text"] { + float: left; + width: 80%; + padding: 0.25em; + box-sizing: border-box; +} + +div.sphinxsidebar #searchbox input[type="submit"] { + float: left; + width: 20%; + border-left: none; + padding: 0.25em; + box-sizing: border-box; +} + + +img { + border: 0; + max-width: 100%; +} + +/* -- search page ----------------------------------------------------------- */ + +ul.search { + margin: 10px 0 0 20px; + padding: 0; +} + +ul.search li { + padding: 5px 0 5px 20px; + background-image: url(file.png); + background-repeat: no-repeat; + background-position: 0 7px; +} + +ul.search li a { + font-weight: bold; +} + +ul.search li p.context { + color: #888; + margin: 2px 0 0 30px; + text-align: left; +} + +ul.keywordmatches li.goodmatch a { + font-weight: bold; +} + +/* -- index page ------------------------------------------------------------ */ + +table.contentstable { + width: 90%; + margin-left: auto; + margin-right: auto; +} + +table.contentstable p.biglink { + line-height: 150%; +} + +a.biglink { + font-size: 1.3em; +} + +span.linkdescr { + font-style: italic; + padding-top: 5px; + font-size: 90%; +} + +/* -- general index --------------------------------------------------------- */ + +table.indextable { + width: 100%; +} + +table.indextable td { + text-align: left; + vertical-align: top; +} + +table.indextable ul { + margin-top: 0; + margin-bottom: 0; + list-style-type: none; +} + +table.indextable > tbody > tr > td > ul { + padding-left: 0em; +} + +table.indextable tr.pcap { + height: 10px; +} + +table.indextable tr.cap { + margin-top: 10px; + background-color: #f2f2f2; +} + +img.toggler { + margin-right: 3px; + margin-top: 3px; + cursor: pointer; +} + +div.modindex-jumpbox { + border-top: 1px solid #ddd; + border-bottom: 1px solid #ddd; + margin: 1em 0 1em 0; + padding: 0.4em; +} + +div.genindex-jumpbox { + border-top: 1px solid #ddd; + border-bottom: 1px solid #ddd; + margin: 1em 0 1em 0; + padding: 0.4em; +} + +/* -- domain module index --------------------------------------------------- */ + +table.modindextable td { + padding: 2px; + border-collapse: collapse; +} + +/* -- general body styles --------------------------------------------------- */ + +div.body { + min-width: 360px; + max-width: 800px; +} + +div.body p, div.body dd, div.body li, div.body blockquote { + -moz-hyphens: auto; + -ms-hyphens: auto; + -webkit-hyphens: auto; + hyphens: auto; +} + +a.headerlink { + visibility: hidden; +} + +a:visited { + color: #551A8B; +} + +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; +} + +nav.contents, +aside.topic, +div.admonition, div.topic, blockquote { + clear: left; +} + +/* -- topics ---------------------------------------------------------------- */ + +nav.contents, +aside.topic, +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, +nav.contents > :last-child, +aside.topic > :last-child, +div.topic > :last-child, +div.admonition > :last-child { + margin-bottom: 0; +} + +div.sidebar::after, +aside.sidebar::after, +nav.contents::after, +aside.topic::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; +} + +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; +} + +aside.footnote > span, +div.citation > span { + float: left; +} +aside.footnote > span:last-of-type, +div.citation > span:last-of-type { + padding-right: 0.5em; +} +aside.footnote > p { + margin-left: 2em; +} +div.citation > p { + margin-left: 4em; +} +aside.footnote > p:last-of-type, +div.citation > p:last-of-type { + margin-bottom: 0em; +} +aside.footnote > p:last-of-type:after, +div.citation > p:last-of-type:after { + content: ""; + clear: both; +} + +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 > 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; +} + +.sig dd { + margin-top: 0px; + margin-bottom: 0px; +} + +.sig dl { + margin-top: 0px; + margin-bottom: 0px; +} + +dl > dd:last-child, +dl > dd:last-child > :last-child { + margin-bottom: 0; +} + +dt:target, span.highlighted { + background-color: #fbe54e; +} + +rect.highlighted { + fill: #fbe54e; +} + +dl.glossary dt { + font-weight: bold; + font-size: 1.1em; +} + +.versionmodified { + font-style: italic; +} + +.system-message { + background-color: #fda; + padding: 5px; + border: 3px solid red; +} + +.footnote:target { + background-color: #ffa; +} + +.line-block { + display: block; + margin-top: 1em; + margin-bottom: 1em; +} + +.line-block .line-block { + margin-top: 0; + margin-bottom: 0; + margin-left: 1.5em; +} + +.guilabel, .menuselection { + font-family: sans-serif; +} + +.accelerator { + text-decoration: underline; +} + +.classifier { + font-style: oblique; +} + +.classifier:before { + font-style: normal; + margin: 0 0.5em; + content: ":"; + display: inline-block; +} + +abbr, acronym { + border-bottom: dotted 1px; + cursor: help; +} + +.translated { + background-color: rgba(207, 255, 207, 0.2) +} + +.untranslated { + background-color: rgba(255, 207, 207, 0.2) +} + +/* -- code displays --------------------------------------------------------- */ + +pre { + overflow: auto; + overflow-y: hidden; /* fixes display issues on Chrome browsers */ +} + +pre, div[class*="highlight-"] { + clear: both; +} + +span.pre { + -moz-hyphens: none; + -ms-hyphens: none; + -webkit-hyphens: none; + hyphens: none; + white-space: nowrap; +} + +div[class*="highlight-"] { + margin: 1em 0; +} + +td.linenos pre { + border: 0; + background-color: transparent; + color: #aaa; +} + +table.highlighttable { + display: block; +} + +table.highlighttable tbody { + display: block; +} + +table.highlighttable tr { + display: flex; +} + +table.highlighttable td { + margin: 0; + padding: 0; +} + +table.highlighttable td.linenos { + padding-right: 0.5em; +} + +table.highlighttable td.code { + flex: 1; + overflow: hidden; +} + +.highlight .hll { + display: block; +} + +div.highlight pre, +table.highlighttable pre { + margin: 0; +} + +div.code-block-caption + div { + margin-top: 0; +} + +div.code-block-caption { + margin-top: 1em; + padding: 2px 5px; + font-size: small; +} + +div.code-block-caption code { + background-color: transparent; +} + +table.highlighttable td.linenos, +span.linenos, +div.highlight span.gp { /* gp: Generic.Prompt */ + user-select: none; + -webkit-user-select: text; /* Safari fallback only */ + -webkit-user-select: none; /* Chrome/Safari */ + -moz-user-select: none; /* Firefox */ + -ms-user-select: none; /* IE10+ */ +} + +div.code-block-caption span.caption-number { + padding: 0.1em 0.3em; + font-style: italic; +} + +div.code-block-caption span.caption-text { +} + +div.literal-block-wrapper { + margin: 1em 0; +} + +code.xref, a code { + background-color: transparent; + font-weight: bold; +} + +h1 code, h2 code, h3 code, h4 code, h5 code, h6 code { + background-color: transparent; +} + +.viewcode-link { + float: right; +} + +.viewcode-back { + float: right; + font-family: sans-serif; +} + +div.viewcode-block:target { + margin: -1px -10px; + padding: 0 10px; +} + +/* -- math display ---------------------------------------------------------- */ + +img.math { + vertical-align: middle; +} + +div.body div.math p { + text-align: center; +} + +span.eqno { + float: right; +} + +span.eqno a.headerlink { + position: absolute; + z-index: 1; +} + +div.math:hover a.headerlink { + visibility: visible; +} + +/* -- printout stylesheet --------------------------------------------------- */ + +@media print { + div.document, + div.documentwrapper, + div.bodywrapper { + margin: 0 !important; + width: 100%; + } + + div.sphinxsidebar, + div.related, + div.footer, + #top-link { + display: none; + } +} \ No newline at end of file diff --git a/_static/css/badge_only.css b/_static/css/badge_only.css new file mode 100644 index 0000000..c718cee --- /dev/null +++ b/_static/css/badge_only.css @@ -0,0 +1 @@ +.clearfix{*zoom:1}.clearfix:after,.clearfix:before{display:table;content:""}.clearfix:after{clear:both}@font-face{font-family:FontAwesome;font-style:normal;font-weight:400;src:url(fonts/fontawesome-webfont.eot?674f50d287a8c48dc19ba404d20fe713?#iefix) format("embedded-opentype"),url(fonts/fontawesome-webfont.woff2?af7ae505a9eed503f8b8e6982036873e) format("woff2"),url(fonts/fontawesome-webfont.woff?fee66e712a8a08eef5805a46892932ad) format("woff"),url(fonts/fontawesome-webfont.ttf?b06871f281fee6b241d60582ae9369b9) format("truetype"),url(fonts/fontawesome-webfont.svg?912ec66d7572ff821749319396470bde#FontAwesome) format("svg")}.fa:before{font-family:FontAwesome;font-style:normal;font-weight:400;line-height:1}.fa:before,a .fa{text-decoration:inherit}.fa:before,a .fa,li .fa{display:inline-block}li .fa-large:before{width:1.875em}ul.fas{list-style-type:none;margin-left:2em;text-indent:-.8em}ul.fas li .fa{width:.8em}ul.fas li .fa-large:before{vertical-align:baseline}.fa-book:before,.icon-book:before{content:"\f02d"}.fa-caret-down:before,.icon-caret-down:before{content:"\f0d7"}.fa-caret-up:before,.icon-caret-up:before{content:"\f0d8"}.fa-caret-left:before,.icon-caret-left:before{content:"\f0d9"}.fa-caret-right:before,.icon-caret-right:before{content:"\f0da"}.rst-versions{position:fixed;bottom:0;left:0;width:300px;color:#fcfcfc;background:#1f1d1d;font-family:Lato,proxima-nova,Helvetica Neue,Arial,sans-serif;z-index:400}.rst-versions a{color:#2980b9;text-decoration:none}.rst-versions .rst-badge-small{display:none}.rst-versions .rst-current-version{padding:12px;background-color:#272525;display:block;text-align:right;font-size:90%;cursor:pointer;color:#27ae60}.rst-versions .rst-current-version:after{clear:both;content:"";display:block}.rst-versions .rst-current-version .fa{color:#fcfcfc}.rst-versions .rst-current-version .fa-book,.rst-versions .rst-current-version .icon-book{float:left}.rst-versions .rst-current-version.rst-out-of-date{background-color:#e74c3c;color:#fff}.rst-versions .rst-current-version.rst-active-old-version{background-color:#f1c40f;color:#000}.rst-versions.shift-up{height:auto;max-height:100%;overflow-y:scroll}.rst-versions.shift-up .rst-other-versions{display:block}.rst-versions .rst-other-versions{font-size:90%;padding:12px;color:grey;display:none}.rst-versions .rst-other-versions hr{display:block;height:1px;border:0;margin:20px 0;padding:0;border-top:1px solid #413d3d}.rst-versions .rst-other-versions dd{display:inline-block;margin:0}.rst-versions .rst-other-versions dd a{display:inline-block;padding:6px;color:#fcfcfc}.rst-versions.rst-badge{width:auto;bottom:20px;right:20px;left:auto;border:none;max-width:300px;max-height:90%}.rst-versions.rst-badge .fa-book,.rst-versions.rst-badge .icon-book{float:none;line-height:30px}.rst-versions.rst-badge.shift-up .rst-current-version{text-align:right}.rst-versions.rst-badge.shift-up .rst-current-version .fa-book,.rst-versions.rst-badge.shift-up .rst-current-version .icon-book{float:left}.rst-versions.rst-badge>.rst-current-version{width:auto;height:30px;line-height:30px;padding:0 6px;display:block;text-align:center}@media screen and (max-width:768px){.rst-versions{width:85%;display:none}.rst-versions.shift{display:block}} \ No newline at end of file diff --git a/_static/css/fonts/Roboto-Slab-Bold.woff b/_static/css/fonts/Roboto-Slab-Bold.woff new file mode 100644 index 0000000..6cb6000 Binary files /dev/null and b/_static/css/fonts/Roboto-Slab-Bold.woff differ diff --git a/_static/css/fonts/Roboto-Slab-Bold.woff2 b/_static/css/fonts/Roboto-Slab-Bold.woff2 new file mode 100644 index 0000000..7059e23 Binary files /dev/null and b/_static/css/fonts/Roboto-Slab-Bold.woff2 differ diff --git a/_static/css/fonts/Roboto-Slab-Regular.woff b/_static/css/fonts/Roboto-Slab-Regular.woff new file mode 100644 index 0000000..f815f63 Binary files /dev/null and b/_static/css/fonts/Roboto-Slab-Regular.woff differ diff --git a/_static/css/fonts/Roboto-Slab-Regular.woff2 b/_static/css/fonts/Roboto-Slab-Regular.woff2 new file mode 100644 index 0000000..f2c76e5 Binary files /dev/null and b/_static/css/fonts/Roboto-Slab-Regular.woff2 differ diff --git a/_static/css/fonts/fontawesome-webfont.eot b/_static/css/fonts/fontawesome-webfont.eot new file mode 100644 index 0000000..e9f60ca Binary files /dev/null and b/_static/css/fonts/fontawesome-webfont.eot differ diff --git a/_static/css/fonts/fontawesome-webfont.svg b/_static/css/fonts/fontawesome-webfont.svg new file mode 100644 index 0000000..855c845 --- /dev/null +++ b/_static/css/fonts/fontawesome-webfont.svg @@ -0,0 +1,2671 @@ + + + + +Created by FontForge 20120731 at Mon Oct 24 17:37:40 2016 + By ,,, +Copyright Dave Gandy 2016. All rights reserved. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/_static/css/fonts/fontawesome-webfont.ttf b/_static/css/fonts/fontawesome-webfont.ttf new file mode 100644 index 0000000..35acda2 Binary files /dev/null and b/_static/css/fonts/fontawesome-webfont.ttf differ diff --git a/_static/css/fonts/fontawesome-webfont.woff b/_static/css/fonts/fontawesome-webfont.woff new file mode 100644 index 0000000..400014a Binary files /dev/null and b/_static/css/fonts/fontawesome-webfont.woff differ diff --git a/_static/css/fonts/fontawesome-webfont.woff2 b/_static/css/fonts/fontawesome-webfont.woff2 new file mode 100644 index 0000000..4d13fc6 Binary files /dev/null and b/_static/css/fonts/fontawesome-webfont.woff2 differ diff --git a/_static/css/fonts/lato-bold-italic.woff b/_static/css/fonts/lato-bold-italic.woff new file mode 100644 index 0000000..88ad05b Binary files /dev/null and b/_static/css/fonts/lato-bold-italic.woff differ diff --git a/_static/css/fonts/lato-bold-italic.woff2 b/_static/css/fonts/lato-bold-italic.woff2 new file mode 100644 index 0000000..c4e3d80 Binary files /dev/null and b/_static/css/fonts/lato-bold-italic.woff2 differ diff --git a/_static/css/fonts/lato-bold.woff b/_static/css/fonts/lato-bold.woff new file mode 100644 index 0000000..c6dff51 Binary files /dev/null and b/_static/css/fonts/lato-bold.woff differ diff --git a/_static/css/fonts/lato-bold.woff2 b/_static/css/fonts/lato-bold.woff2 new file mode 100644 index 0000000..bb19504 Binary files /dev/null and b/_static/css/fonts/lato-bold.woff2 differ diff --git a/_static/css/fonts/lato-normal-italic.woff b/_static/css/fonts/lato-normal-italic.woff new file mode 100644 index 0000000..76114bc Binary files /dev/null and b/_static/css/fonts/lato-normal-italic.woff differ diff --git a/_static/css/fonts/lato-normal-italic.woff2 b/_static/css/fonts/lato-normal-italic.woff2 new file mode 100644 index 0000000..3404f37 Binary files /dev/null and b/_static/css/fonts/lato-normal-italic.woff2 differ diff --git a/_static/css/fonts/lato-normal.woff b/_static/css/fonts/lato-normal.woff new file mode 100644 index 0000000..ae1307f Binary files /dev/null and b/_static/css/fonts/lato-normal.woff differ diff --git a/_static/css/fonts/lato-normal.woff2 b/_static/css/fonts/lato-normal.woff2 new file mode 100644 index 0000000..3bf9843 Binary files /dev/null and b/_static/css/fonts/lato-normal.woff2 differ diff --git a/_static/css/theme.css b/_static/css/theme.css new file mode 100644 index 0000000..19a446a --- /dev/null +++ b/_static/css/theme.css @@ -0,0 +1,4 @@ +html{box-sizing:border-box}*,:after,:before{box-sizing:inherit}article,aside,details,figcaption,figure,footer,header,hgroup,nav,section{display:block}audio,canvas,video{display:inline-block;*display:inline;*zoom:1}[hidden],audio:not([controls]){display:none}*{-webkit-box-sizing:border-box;-moz-box-sizing:border-box;box-sizing:border-box}html{font-size:100%;-webkit-text-size-adjust:100%;-ms-text-size-adjust:100%}body{margin:0}a:active,a:hover{outline:0}abbr[title]{border-bottom:1px dotted}b,strong{font-weight:700}blockquote{margin:0}dfn{font-style:italic}ins{background:#ff9;text-decoration:none}ins,mark{color:#000}mark{background:#ff0;font-style:italic;font-weight:700}.rst-content code,.rst-content tt,code,kbd,pre,samp{font-family:monospace,serif;_font-family:courier new,monospace;font-size:1em}pre{white-space:pre}q{quotes:none}q:after,q:before{content:"";content:none}small{font-size:85%}sub,sup{font-size:75%;line-height:0;position:relative;vertical-align:baseline}sup{top:-.5em}sub{bottom:-.25em}dl,ol,ul{margin:0;padding:0;list-style:none;list-style-image:none}li{list-style:none}dd{margin:0}img{border:0;-ms-interpolation-mode:bicubic;vertical-align:middle;max-width:100%}svg:not(:root){overflow:hidden}figure,form{margin:0}label{cursor:pointer}button,input,select,textarea{font-size:100%;margin:0;vertical-align:baseline;*vertical-align:middle}button,input{line-height:normal}button,input[type=button],input[type=reset],input[type=submit]{cursor:pointer;-webkit-appearance:button;*overflow:visible}button[disabled],input[disabled]{cursor:default}input[type=search]{-webkit-appearance:textfield;-moz-box-sizing:content-box;-webkit-box-sizing:content-box;box-sizing:content-box}textarea{resize:vertical}table{border-collapse:collapse;border-spacing:0}td{vertical-align:top}.chromeframe{margin:.2em 0;background:#ccc;color:#000;padding:.2em 0}.ir{display:block;border:0;text-indent:-999em;overflow:hidden;background-color:transparent;background-repeat:no-repeat;text-align:left;direction:ltr;*line-height:0}.ir br{display:none}.hidden{display:none!important;visibility:hidden}.visuallyhidden{border:0;clip:rect(0 0 0 0);height:1px;margin:-1px;overflow:hidden;padding:0;position:absolute;width:1px}.visuallyhidden.focusable:active,.visuallyhidden.focusable:focus{clip:auto;height:auto;margin:0;overflow:visible;position:static;width:auto}.invisible{visibility:hidden}.relative{position:relative}big,small{font-size:100%}@media print{body,html,section{background:none!important}*{box-shadow:none!important;text-shadow:none!important;filter:none!important;-ms-filter:none!important}a,a:visited{text-decoration:underline}.ir a:after,a[href^="#"]:after,a[href^="javascript:"]:after{content:""}blockquote,pre{page-break-inside:avoid}thead{display:table-header-group}img,tr{page-break-inside:avoid}img{max-width:100%!important}@page{margin:.5cm}.rst-content .toctree-wrapper>p.caption,h2,h3,p{orphans:3;widows:3}.rst-content .toctree-wrapper>p.caption,h2,h3{page-break-after:avoid}}.btn,.fa:before,.icon:before,.rst-content .admonition,.rst-content .admonition-title:before,.rst-content .admonition-todo,.rst-content .attention,.rst-content .caution,.rst-content .code-block-caption .headerlink:before,.rst-content .danger,.rst-content .eqno .headerlink:before,.rst-content .error,.rst-content .hint,.rst-content .important,.rst-content .note,.rst-content .seealso,.rst-content .tip,.rst-content .warning,.rst-content code.download span:first-child:before,.rst-content dl dt .headerlink:before,.rst-content h1 .headerlink:before,.rst-content h2 .headerlink:before,.rst-content h3 .headerlink:before,.rst-content h4 .headerlink:before,.rst-content h5 .headerlink:before,.rst-content h6 .headerlink:before,.rst-content p.caption .headerlink:before,.rst-content p .headerlink:before,.rst-content table>caption .headerlink:before,.rst-content tt.download span:first-child:before,.wy-alert,.wy-dropdown .caret:before,.wy-inline-validate.wy-inline-validate-danger .wy-input-context:before,.wy-inline-validate.wy-inline-validate-info .wy-input-context:before,.wy-inline-validate.wy-inline-validate-success .wy-input-context:before,.wy-inline-validate.wy-inline-validate-warning .wy-input-context:before,.wy-menu-vertical li.current>a button.toctree-expand:before,.wy-menu-vertical li.on a button.toctree-expand:before,.wy-menu-vertical li button.toctree-expand:before,input[type=color],input[type=date],input[type=datetime-local],input[type=datetime],input[type=email],input[type=month],input[type=number],input[type=password],input[type=search],input[type=tel],input[type=text],input[type=time],input[type=url],input[type=week],select,textarea{-webkit-font-smoothing:antialiased}.clearfix{*zoom:1}.clearfix:after,.clearfix:before{display:table;content:""}.clearfix:after{clear:both}/*! + * Font Awesome 4.7.0 by @davegandy - http://fontawesome.io - @fontawesome + * License - http://fontawesome.io/license (Font: SIL OFL 1.1, CSS: MIT License) + */@font-face{font-family:FontAwesome;src:url(fonts/fontawesome-webfont.eot?674f50d287a8c48dc19ba404d20fe713);src:url(fonts/fontawesome-webfont.eot?674f50d287a8c48dc19ba404d20fe713?#iefix&v=4.7.0) format("embedded-opentype"),url(fonts/fontawesome-webfont.woff2?af7ae505a9eed503f8b8e6982036873e) format("woff2"),url(fonts/fontawesome-webfont.woff?fee66e712a8a08eef5805a46892932ad) format("woff"),url(fonts/fontawesome-webfont.ttf?b06871f281fee6b241d60582ae9369b9) format("truetype"),url(fonts/fontawesome-webfont.svg?912ec66d7572ff821749319396470bde#fontawesomeregular) format("svg");font-weight:400;font-style:normal}.fa,.icon,.rst-content .admonition-title,.rst-content .code-block-caption .headerlink,.rst-content .eqno .headerlink,.rst-content code.download span:first-child,.rst-content dl dt .headerlink,.rst-content h1 .headerlink,.rst-content h2 .headerlink,.rst-content h3 .headerlink,.rst-content h4 .headerlink,.rst-content h5 .headerlink,.rst-content h6 .headerlink,.rst-content p.caption .headerlink,.rst-content p .headerlink,.rst-content table>caption .headerlink,.rst-content tt.download span:first-child,.wy-menu-vertical li.current>a button.toctree-expand,.wy-menu-vertical li.on a button.toctree-expand,.wy-menu-vertical li button.toctree-expand{display:inline-block;font:normal normal normal 14px/1 FontAwesome;font-size:inherit;text-rendering:auto;-webkit-font-smoothing:antialiased;-moz-osx-font-smoothing:grayscale}.fa-lg{font-size:1.33333em;line-height:.75em;vertical-align:-15%}.fa-2x{font-size:2em}.fa-3x{font-size:3em}.fa-4x{font-size:4em}.fa-5x{font-size:5em}.fa-fw{width:1.28571em;text-align:center}.fa-ul{padding-left:0;margin-left:2.14286em;list-style-type:none}.fa-ul>li{position:relative}.fa-li{position:absolute;left:-2.14286em;width:2.14286em;top:.14286em;text-align:center}.fa-li.fa-lg{left:-1.85714em}.fa-border{padding:.2em .25em .15em;border:.08em solid #eee;border-radius:.1em}.fa-pull-left{float:left}.fa-pull-right{float:right}.fa-pull-left.icon,.fa.fa-pull-left,.rst-content .code-block-caption .fa-pull-left.headerlink,.rst-content .eqno .fa-pull-left.headerlink,.rst-content .fa-pull-left.admonition-title,.rst-content code.download span.fa-pull-left:first-child,.rst-content dl dt .fa-pull-left.headerlink,.rst-content h1 .fa-pull-left.headerlink,.rst-content h2 .fa-pull-left.headerlink,.rst-content h3 .fa-pull-left.headerlink,.rst-content h4 .fa-pull-left.headerlink,.rst-content h5 .fa-pull-left.headerlink,.rst-content h6 .fa-pull-left.headerlink,.rst-content p .fa-pull-left.headerlink,.rst-content table>caption .fa-pull-left.headerlink,.rst-content tt.download span.fa-pull-left:first-child,.wy-menu-vertical li.current>a button.fa-pull-left.toctree-expand,.wy-menu-vertical li.on a button.fa-pull-left.toctree-expand,.wy-menu-vertical li button.fa-pull-left.toctree-expand{margin-right:.3em}.fa-pull-right.icon,.fa.fa-pull-right,.rst-content .code-block-caption .fa-pull-right.headerlink,.rst-content .eqno .fa-pull-right.headerlink,.rst-content .fa-pull-right.admonition-title,.rst-content code.download span.fa-pull-right:first-child,.rst-content dl dt .fa-pull-right.headerlink,.rst-content h1 .fa-pull-right.headerlink,.rst-content h2 .fa-pull-right.headerlink,.rst-content h3 .fa-pull-right.headerlink,.rst-content h4 .fa-pull-right.headerlink,.rst-content h5 .fa-pull-right.headerlink,.rst-content h6 .fa-pull-right.headerlink,.rst-content p .fa-pull-right.headerlink,.rst-content table>caption .fa-pull-right.headerlink,.rst-content tt.download span.fa-pull-right:first-child,.wy-menu-vertical li.current>a button.fa-pull-right.toctree-expand,.wy-menu-vertical li.on a button.fa-pull-right.toctree-expand,.wy-menu-vertical li button.fa-pull-right.toctree-expand{margin-left:.3em}.pull-right{float:right}.pull-left{float:left}.fa.pull-left,.pull-left.icon,.rst-content .code-block-caption .pull-left.headerlink,.rst-content .eqno .pull-left.headerlink,.rst-content .pull-left.admonition-title,.rst-content code.download span.pull-left:first-child,.rst-content dl dt .pull-left.headerlink,.rst-content h1 .pull-left.headerlink,.rst-content h2 .pull-left.headerlink,.rst-content h3 .pull-left.headerlink,.rst-content h4 .pull-left.headerlink,.rst-content h5 .pull-left.headerlink,.rst-content h6 .pull-left.headerlink,.rst-content p .pull-left.headerlink,.rst-content table>caption .pull-left.headerlink,.rst-content tt.download span.pull-left:first-child,.wy-menu-vertical li.current>a button.pull-left.toctree-expand,.wy-menu-vertical li.on a button.pull-left.toctree-expand,.wy-menu-vertical li button.pull-left.toctree-expand{margin-right:.3em}.fa.pull-right,.pull-right.icon,.rst-content .code-block-caption .pull-right.headerlink,.rst-content .eqno .pull-right.headerlink,.rst-content .pull-right.admonition-title,.rst-content code.download span.pull-right:first-child,.rst-content dl dt .pull-right.headerlink,.rst-content h1 .pull-right.headerlink,.rst-content h2 .pull-right.headerlink,.rst-content h3 .pull-right.headerlink,.rst-content h4 .pull-right.headerlink,.rst-content h5 .pull-right.headerlink,.rst-content h6 .pull-right.headerlink,.rst-content p .pull-right.headerlink,.rst-content table>caption .pull-right.headerlink,.rst-content tt.download span.pull-right:first-child,.wy-menu-vertical li.current>a button.pull-right.toctree-expand,.wy-menu-vertical li.on a button.pull-right.toctree-expand,.wy-menu-vertical li button.pull-right.toctree-expand{margin-left:.3em}.fa-spin{-webkit-animation:fa-spin 2s linear infinite;animation:fa-spin 2s linear infinite}.fa-pulse{-webkit-animation:fa-spin 1s steps(8) infinite;animation:fa-spin 1s steps(8) infinite}@-webkit-keyframes fa-spin{0%{-webkit-transform:rotate(0deg);transform:rotate(0deg)}to{-webkit-transform:rotate(359deg);transform:rotate(359deg)}}@keyframes fa-spin{0%{-webkit-transform:rotate(0deg);transform:rotate(0deg)}to{-webkit-transform:rotate(359deg);transform:rotate(359deg)}}.fa-rotate-90{-ms-filter:"progid:DXImageTransform.Microsoft.BasicImage(rotation=1)";-webkit-transform:rotate(90deg);-ms-transform:rotate(90deg);transform:rotate(90deg)}.fa-rotate-180{-ms-filter:"progid:DXImageTransform.Microsoft.BasicImage(rotation=2)";-webkit-transform:rotate(180deg);-ms-transform:rotate(180deg);transform:rotate(180deg)}.fa-rotate-270{-ms-filter:"progid:DXImageTransform.Microsoft.BasicImage(rotation=3)";-webkit-transform:rotate(270deg);-ms-transform:rotate(270deg);transform:rotate(270deg)}.fa-flip-horizontal{-ms-filter:"progid:DXImageTransform.Microsoft.BasicImage(rotation=0, mirror=1)";-webkit-transform:scaleX(-1);-ms-transform:scaleX(-1);transform:scaleX(-1)}.fa-flip-vertical{-ms-filter:"progid:DXImageTransform.Microsoft.BasicImage(rotation=2, mirror=1)";-webkit-transform:scaleY(-1);-ms-transform:scaleY(-1);transform:scaleY(-1)}:root .fa-flip-horizontal,:root .fa-flip-vertical,:root .fa-rotate-90,:root .fa-rotate-180,:root .fa-rotate-270{filter:none}.fa-stack{position:relative;display:inline-block;width:2em;height:2em;line-height:2em;vertical-align:middle}.fa-stack-1x,.fa-stack-2x{position:absolute;left:0;width:100%;text-align:center}.fa-stack-1x{line-height:inherit}.fa-stack-2x{font-size:2em}.fa-inverse{color:#fff}.fa-glass:before{content:""}.fa-music:before{content:""}.fa-search:before,.icon-search:before{content:""}.fa-envelope-o:before{content:""}.fa-heart:before{content:""}.fa-star:before{content:""}.fa-star-o:before{content:""}.fa-user:before{content:""}.fa-film:before{content:""}.fa-th-large:before{content:""}.fa-th:before{content:""}.fa-th-list:before{content:""}.fa-check:before{content:""}.fa-close:before,.fa-remove:before,.fa-times:before{content:""}.fa-search-plus:before{content:""}.fa-search-minus:before{content:""}.fa-power-off:before{content:""}.fa-signal:before{content:""}.fa-cog:before,.fa-gear:before{content:""}.fa-trash-o:before{content:""}.fa-home:before,.icon-home:before{content:""}.fa-file-o:before{content:""}.fa-clock-o:before{content:""}.fa-road:before{content:""}.fa-download:before,.rst-content code.download span:first-child:before,.rst-content tt.download span:first-child:before{content:""}.fa-arrow-circle-o-down:before{content:""}.fa-arrow-circle-o-up:before{content:""}.fa-inbox:before{content:""}.fa-play-circle-o:before{content:""}.fa-repeat:before,.fa-rotate-right:before{content:""}.fa-refresh:before{content:""}.fa-list-alt:before{content:""}.fa-lock:before{content:""}.fa-flag:before{content:""}.fa-headphones:before{content:""}.fa-volume-off:before{content:""}.fa-volume-down:before{content:""}.fa-volume-up:before{content:""}.fa-qrcode:before{content:""}.fa-barcode:before{content:""}.fa-tag:before{content:""}.fa-tags:before{content:""}.fa-book:before,.icon-book:before{content:""}.fa-bookmark:before{content:""}.fa-print:before{content:""}.fa-camera:before{content:""}.fa-font:before{content:""}.fa-bold:before{content:""}.fa-italic:before{content:""}.fa-text-height:before{content:""}.fa-text-width:before{content:""}.fa-align-left:before{content:""}.fa-align-center:before{content:""}.fa-align-right:before{content:""}.fa-align-justify:before{content:""}.fa-list:before{content:""}.fa-dedent:before,.fa-outdent:before{content:""}.fa-indent:before{content:""}.fa-video-camera:before{content:""}.fa-image:before,.fa-photo:before,.fa-picture-o:before{content:""}.fa-pencil:before{content:""}.fa-map-marker:before{content:""}.fa-adjust:before{content:""}.fa-tint:before{content:""}.fa-edit:before,.fa-pencil-square-o:before{content:""}.fa-share-square-o:before{content:""}.fa-check-square-o:before{content:""}.fa-arrows:before{content:""}.fa-step-backward:before{content:""}.fa-fast-backward:before{content:""}.fa-backward:before{content:""}.fa-play:before{content:""}.fa-pause:before{content:""}.fa-stop:before{content:""}.fa-forward:before{content:""}.fa-fast-forward:before{content:""}.fa-step-forward:before{content:""}.fa-eject:before{content:""}.fa-chevron-left:before{content:""}.fa-chevron-right:before{content:""}.fa-plus-circle:before{content:""}.fa-minus-circle:before{content:""}.fa-times-circle:before,.wy-inline-validate.wy-inline-validate-danger .wy-input-context:before{content:""}.fa-check-circle:before,.wy-inline-validate.wy-inline-validate-success .wy-input-context:before{content:""}.fa-question-circle:before{content:""}.fa-info-circle:before{content:""}.fa-crosshairs:before{content:""}.fa-times-circle-o:before{content:""}.fa-check-circle-o:before{content:""}.fa-ban:before{content:""}.fa-arrow-left:before{content:""}.fa-arrow-right:before{content:""}.fa-arrow-up:before{content:""}.fa-arrow-down:before{content:""}.fa-mail-forward:before,.fa-share:before{content:""}.fa-expand:before{content:""}.fa-compress:before{content:""}.fa-plus:before{content:""}.fa-minus:before{content:""}.fa-asterisk:before{content:""}.fa-exclamation-circle:before,.rst-content .admonition-title:before,.wy-inline-validate.wy-inline-validate-info .wy-input-context:before,.wy-inline-validate.wy-inline-validate-warning .wy-input-context:before{content:""}.fa-gift:before{content:""}.fa-leaf:before{content:""}.fa-fire:before,.icon-fire:before{content:""}.fa-eye:before{content:""}.fa-eye-slash:before{content:""}.fa-exclamation-triangle:before,.fa-warning:before{content:""}.fa-plane:before{content:""}.fa-calendar:before{content:""}.fa-random:before{content:""}.fa-comment:before{content:""}.fa-magnet:before{content:""}.fa-chevron-up:before{content:""}.fa-chevron-down:before{content:""}.fa-retweet:before{content:""}.fa-shopping-cart:before{content:""}.fa-folder:before{content:""}.fa-folder-open:before{content:""}.fa-arrows-v:before{content:""}.fa-arrows-h:before{content:""}.fa-bar-chart-o:before,.fa-bar-chart:before{content:""}.fa-twitter-square:before{content:""}.fa-facebook-square:before{content:""}.fa-camera-retro:before{content:""}.fa-key:before{content:""}.fa-cogs:before,.fa-gears:before{content:""}.fa-comments:before{content:""}.fa-thumbs-o-up:before{content:""}.fa-thumbs-o-down:before{content:""}.fa-star-half:before{content:""}.fa-heart-o:before{content:""}.fa-sign-out:before{content:""}.fa-linkedin-square:before{content:""}.fa-thumb-tack:before{content:""}.fa-external-link:before{content:""}.fa-sign-in:before{content:""}.fa-trophy:before{content:""}.fa-github-square:before{content:""}.fa-upload:before{content:""}.fa-lemon-o:before{content:""}.fa-phone:before{content:""}.fa-square-o:before{content:""}.fa-bookmark-o:before{content:""}.fa-phone-square:before{content:""}.fa-twitter:before{content:""}.fa-facebook-f:before,.fa-facebook:before{content:""}.fa-github:before,.icon-github:before{content:""}.fa-unlock:before{content:""}.fa-credit-card:before{content:""}.fa-feed:before,.fa-rss:before{content:""}.fa-hdd-o:before{content:""}.fa-bullhorn:before{content:""}.fa-bell:before{content:""}.fa-certificate:before{content:""}.fa-hand-o-right:before{content:""}.fa-hand-o-left:before{content:""}.fa-hand-o-up:before{content:""}.fa-hand-o-down:before{content:""}.fa-arrow-circle-left:before,.icon-circle-arrow-left:before{content:""}.fa-arrow-circle-right:before,.icon-circle-arrow-right:before{content:""}.fa-arrow-circle-up:before{content:""}.fa-arrow-circle-down:before{content:""}.fa-globe:before{content:""}.fa-wrench:before{content:""}.fa-tasks:before{content:""}.fa-filter:before{content:""}.fa-briefcase:before{content:""}.fa-arrows-alt:before{content:""}.fa-group:before,.fa-users:before{content:""}.fa-chain:before,.fa-link:before,.icon-link:before{content:""}.fa-cloud:before{content:""}.fa-flask:before{content:""}.fa-cut:before,.fa-scissors:before{content:""}.fa-copy:before,.fa-files-o:before{content:""}.fa-paperclip:before{content:""}.fa-floppy-o:before,.fa-save:before{content:""}.fa-square:before{content:""}.fa-bars:before,.fa-navicon:before,.fa-reorder:before{content:""}.fa-list-ul:before{content:""}.fa-list-ol:before{content:""}.fa-strikethrough:before{content:""}.fa-underline:before{content:""}.fa-table:before{content:""}.fa-magic:before{content:""}.fa-truck:before{content:""}.fa-pinterest:before{content:""}.fa-pinterest-square:before{content:""}.fa-google-plus-square:before{content:""}.fa-google-plus:before{content:""}.fa-money:before{content:""}.fa-caret-down:before,.icon-caret-down:before,.wy-dropdown .caret:before{content:""}.fa-caret-up:before{content:""}.fa-caret-left:before{content:""}.fa-caret-right:before{content:""}.fa-columns:before{content:""}.fa-sort:before,.fa-unsorted:before{content:""}.fa-sort-desc:before,.fa-sort-down:before{content:""}.fa-sort-asc:before,.fa-sort-up:before{content:""}.fa-envelope:before{content:""}.fa-linkedin:before{content:""}.fa-rotate-left:before,.fa-undo:before{content:""}.fa-gavel:before,.fa-legal:before{content:""}.fa-dashboard:before,.fa-tachometer:before{content:""}.fa-comment-o:before{content:""}.fa-comments-o:before{content:""}.fa-bolt:before,.fa-flash:before{content:""}.fa-sitemap:before{content:""}.fa-umbrella:before{content:""}.fa-clipboard:before,.fa-paste:before{content:""}.fa-lightbulb-o:before{content:""}.fa-exchange:before{content:""}.fa-cloud-download:before{content:""}.fa-cloud-upload:before{content:""}.fa-user-md:before{content:""}.fa-stethoscope:before{content:""}.fa-suitcase:before{content:""}.fa-bell-o:before{content:""}.fa-coffee:before{content:""}.fa-cutlery:before{content:""}.fa-file-text-o:before{content:""}.fa-building-o:before{content:""}.fa-hospital-o:before{content:""}.fa-ambulance:before{content:""}.fa-medkit:before{content:""}.fa-fighter-jet:before{content:""}.fa-beer:before{content:""}.fa-h-square:before{content:""}.fa-plus-square:before{content:""}.fa-angle-double-left:before{content:""}.fa-angle-double-right:before{content:""}.fa-angle-double-up:before{content:""}.fa-angle-double-down:before{content:""}.fa-angle-left:before{content:""}.fa-angle-right:before{content:""}.fa-angle-up:before{content:""}.fa-angle-down:before{content:""}.fa-desktop:before{content:""}.fa-laptop:before{content:""}.fa-tablet:before{content:""}.fa-mobile-phone:before,.fa-mobile:before{content:""}.fa-circle-o:before{content:""}.fa-quote-left:before{content:""}.fa-quote-right:before{content:""}.fa-spinner:before{content:""}.fa-circle:before{content:""}.fa-mail-reply:before,.fa-reply:before{content:""}.fa-github-alt:before{content:""}.fa-folder-o:before{content:""}.fa-folder-open-o:before{content:""}.fa-smile-o:before{content:""}.fa-frown-o:before{content:""}.fa-meh-o:before{content:""}.fa-gamepad:before{content:""}.fa-keyboard-o:before{content:""}.fa-flag-o:before{content:""}.fa-flag-checkered:before{content:""}.fa-terminal:before{content:""}.fa-code:before{content:""}.fa-mail-reply-all:before,.fa-reply-all:before{content:""}.fa-star-half-empty:before,.fa-star-half-full:before,.fa-star-half-o:before{content:""}.fa-location-arrow:before{content:""}.fa-crop:before{content:""}.fa-code-fork:before{content:""}.fa-chain-broken:before,.fa-unlink:before{content:""}.fa-question:before{content:""}.fa-info:before{content:""}.fa-exclamation:before{content:""}.fa-superscript:before{content:""}.fa-subscript:before{content:""}.fa-eraser:before{content:""}.fa-puzzle-piece:before{content:""}.fa-microphone:before{content:""}.fa-microphone-slash:before{content:""}.fa-shield:before{content:""}.fa-calendar-o:before{content:""}.fa-fire-extinguisher:before{content:""}.fa-rocket:before{content:""}.fa-maxcdn:before{content:""}.fa-chevron-circle-left:before{content:""}.fa-chevron-circle-right:before{content:""}.fa-chevron-circle-up:before{content:""}.fa-chevron-circle-down:before{content:""}.fa-html5:before{content:""}.fa-css3:before{content:""}.fa-anchor:before{content:""}.fa-unlock-alt:before{content:""}.fa-bullseye:before{content:""}.fa-ellipsis-h:before{content:""}.fa-ellipsis-v:before{content:""}.fa-rss-square:before{content:""}.fa-play-circle:before{content:""}.fa-ticket:before{content:""}.fa-minus-square:before{content:""}.fa-minus-square-o:before,.wy-menu-vertical li.current>a button.toctree-expand:before,.wy-menu-vertical li.on a button.toctree-expand:before{content:""}.fa-level-up:before{content:""}.fa-level-down:before{content:""}.fa-check-square:before{content:""}.fa-pencil-square:before{content:""}.fa-external-link-square:before{content:""}.fa-share-square:before{content:""}.fa-compass:before{content:""}.fa-caret-square-o-down:before,.fa-toggle-down:before{content:""}.fa-caret-square-o-up:before,.fa-toggle-up:before{content:""}.fa-caret-square-o-right:before,.fa-toggle-right:before{content:""}.fa-eur:before,.fa-euro:before{content:""}.fa-gbp:before{content:""}.fa-dollar:before,.fa-usd:before{content:""}.fa-inr:before,.fa-rupee:before{content:""}.fa-cny:before,.fa-jpy:before,.fa-rmb:before,.fa-yen:before{content:""}.fa-rouble:before,.fa-rub:before,.fa-ruble:before{content:""}.fa-krw:before,.fa-won:before{content:""}.fa-bitcoin:before,.fa-btc:before{content:""}.fa-file:before{content:""}.fa-file-text:before{content:""}.fa-sort-alpha-asc:before{content:""}.fa-sort-alpha-desc:before{content:""}.fa-sort-amount-asc:before{content:""}.fa-sort-amount-desc:before{content:""}.fa-sort-numeric-asc:before{content:""}.fa-sort-numeric-desc:before{content:""}.fa-thumbs-up:before{content:""}.fa-thumbs-down:before{content:""}.fa-youtube-square:before{content:""}.fa-youtube:before{content:""}.fa-xing:before{content:""}.fa-xing-square:before{content:""}.fa-youtube-play:before{content:""}.fa-dropbox:before{content:""}.fa-stack-overflow:before{content:""}.fa-instagram:before{content:""}.fa-flickr:before{content:""}.fa-adn:before{content:""}.fa-bitbucket:before,.icon-bitbucket:before{content:""}.fa-bitbucket-square:before{content:""}.fa-tumblr:before{content:""}.fa-tumblr-square:before{content:""}.fa-long-arrow-down:before{content:""}.fa-long-arrow-up:before{content:""}.fa-long-arrow-left:before{content:""}.fa-long-arrow-right:before{content:""}.fa-apple:before{content:""}.fa-windows:before{content:""}.fa-android:before{content:""}.fa-linux:before{content:""}.fa-dribbble:before{content:""}.fa-skype:before{content:""}.fa-foursquare:before{content:""}.fa-trello:before{content:""}.fa-female:before{content:""}.fa-male:before{content:""}.fa-gittip:before,.fa-gratipay:before{content:""}.fa-sun-o:before{content:""}.fa-moon-o:before{content:""}.fa-archive:before{content:""}.fa-bug:before{content:""}.fa-vk:before{content:""}.fa-weibo:before{content:""}.fa-renren:before{content:""}.fa-pagelines:before{content:""}.fa-stack-exchange:before{content:""}.fa-arrow-circle-o-right:before{content:""}.fa-arrow-circle-o-left:before{content:""}.fa-caret-square-o-left:before,.fa-toggle-left:before{content:""}.fa-dot-circle-o:before{content:""}.fa-wheelchair:before{content:""}.fa-vimeo-square:before{content:""}.fa-try:before,.fa-turkish-lira:before{content:""}.fa-plus-square-o:before,.wy-menu-vertical li button.toctree-expand:before{content:""}.fa-space-shuttle:before{content:""}.fa-slack:before{content:""}.fa-envelope-square:before{content:""}.fa-wordpress:before{content:""}.fa-openid:before{content:""}.fa-bank:before,.fa-institution:before,.fa-university:before{content:""}.fa-graduation-cap:before,.fa-mortar-board:before{content:""}.fa-yahoo:before{content:""}.fa-google:before{content:""}.fa-reddit:before{content:""}.fa-reddit-square:before{content:""}.fa-stumbleupon-circle:before{content:""}.fa-stumbleupon:before{content:""}.fa-delicious:before{content:""}.fa-digg:before{content:""}.fa-pied-piper-pp:before{content:""}.fa-pied-piper-alt:before{content:""}.fa-drupal:before{content:""}.fa-joomla:before{content:""}.fa-language:before{content:""}.fa-fax:before{content:""}.fa-building:before{content:""}.fa-child:before{content:""}.fa-paw:before{content:""}.fa-spoon:before{content:""}.fa-cube:before{content:""}.fa-cubes:before{content:""}.fa-behance:before{content:""}.fa-behance-square:before{content:""}.fa-steam:before{content:""}.fa-steam-square:before{content:""}.fa-recycle:before{content:""}.fa-automobile:before,.fa-car:before{content:""}.fa-cab:before,.fa-taxi:before{content:""}.fa-tree:before{content:""}.fa-spotify:before{content:""}.fa-deviantart:before{content:""}.fa-soundcloud:before{content:""}.fa-database:before{content:""}.fa-file-pdf-o:before{content:""}.fa-file-word-o:before{content:""}.fa-file-excel-o:before{content:""}.fa-file-powerpoint-o:before{content:""}.fa-file-image-o:before,.fa-file-photo-o:before,.fa-file-picture-o:before{content:""}.fa-file-archive-o:before,.fa-file-zip-o:before{content:""}.fa-file-audio-o:before,.fa-file-sound-o:before{content:""}.fa-file-movie-o:before,.fa-file-video-o:before{content:""}.fa-file-code-o:before{content:""}.fa-vine:before{content:""}.fa-codepen:before{content:""}.fa-jsfiddle:before{content:""}.fa-life-bouy:before,.fa-life-buoy:before,.fa-life-ring:before,.fa-life-saver:before,.fa-support:before{content:""}.fa-circle-o-notch:before{content:""}.fa-ra:before,.fa-rebel:before,.fa-resistance:before{content:""}.fa-empire:before,.fa-ge:before{content:""}.fa-git-square:before{content:""}.fa-git:before{content:""}.fa-hacker-news:before,.fa-y-combinator-square:before,.fa-yc-square:before{content:""}.fa-tencent-weibo:before{content:""}.fa-qq:before{content:""}.fa-wechat:before,.fa-weixin:before{content:""}.fa-paper-plane:before,.fa-send:before{content:""}.fa-paper-plane-o:before,.fa-send-o:before{content:""}.fa-history:before{content:""}.fa-circle-thin:before{content:""}.fa-header:before{content:""}.fa-paragraph:before{content:""}.fa-sliders:before{content:""}.fa-share-alt:before{content:""}.fa-share-alt-square:before{content:""}.fa-bomb:before{content:""}.fa-futbol-o:before,.fa-soccer-ball-o:before{content:""}.fa-tty:before{content:""}.fa-binoculars:before{content:""}.fa-plug:before{content:""}.fa-slideshare:before{content:""}.fa-twitch:before{content:""}.fa-yelp:before{content:""}.fa-newspaper-o:before{content:""}.fa-wifi:before{content:""}.fa-calculator:before{content:""}.fa-paypal:before{content:""}.fa-google-wallet:before{content:""}.fa-cc-visa:before{content:""}.fa-cc-mastercard:before{content:""}.fa-cc-discover:before{content:""}.fa-cc-amex:before{content:""}.fa-cc-paypal:before{content:""}.fa-cc-stripe:before{content:""}.fa-bell-slash:before{content:""}.fa-bell-slash-o:before{content:""}.fa-trash:before{content:""}.fa-copyright:before{content:""}.fa-at:before{content:""}.fa-eyedropper:before{content:""}.fa-paint-brush:before{content:""}.fa-birthday-cake:before{content:""}.fa-area-chart:before{content:""}.fa-pie-chart:before{content:""}.fa-line-chart:before{content:""}.fa-lastfm:before{content:""}.fa-lastfm-square:before{content:""}.fa-toggle-off:before{content:""}.fa-toggle-on:before{content:""}.fa-bicycle:before{content:""}.fa-bus:before{content:""}.fa-ioxhost:before{content:""}.fa-angellist:before{content:""}.fa-cc:before{content:""}.fa-ils:before,.fa-shekel:before,.fa-sheqel:before{content:""}.fa-meanpath:before{content:""}.fa-buysellads:before{content:""}.fa-connectdevelop:before{content:""}.fa-dashcube:before{content:""}.fa-forumbee:before{content:""}.fa-leanpub:before{content:""}.fa-sellsy:before{content:""}.fa-shirtsinbulk:before{content:""}.fa-simplybuilt:before{content:""}.fa-skyatlas:before{content:""}.fa-cart-plus:before{content:""}.fa-cart-arrow-down:before{content:""}.fa-diamond:before{content:""}.fa-ship:before{content:""}.fa-user-secret:before{content:""}.fa-motorcycle:before{content:""}.fa-street-view:before{content:""}.fa-heartbeat:before{content:""}.fa-venus:before{content:""}.fa-mars:before{content:""}.fa-mercury:before{content:""}.fa-intersex:before,.fa-transgender:before{content:""}.fa-transgender-alt:before{content:""}.fa-venus-double:before{content:""}.fa-mars-double:before{content:""}.fa-venus-mars:before{content:""}.fa-mars-stroke:before{content:""}.fa-mars-stroke-v:before{content:""}.fa-mars-stroke-h:before{content:""}.fa-neuter:before{content:""}.fa-genderless:before{content:""}.fa-facebook-official:before{content:""}.fa-pinterest-p:before{content:""}.fa-whatsapp:before{content:""}.fa-server:before{content:""}.fa-user-plus:before{content:""}.fa-user-times:before{content:""}.fa-bed:before,.fa-hotel:before{content:""}.fa-viacoin:before{content:""}.fa-train:before{content:""}.fa-subway:before{content:""}.fa-medium:before{content:""}.fa-y-combinator:before,.fa-yc:before{content:""}.fa-optin-monster:before{content:""}.fa-opencart:before{content:""}.fa-expeditedssl:before{content:""}.fa-battery-4:before,.fa-battery-full:before,.fa-battery:before{content:""}.fa-battery-3:before,.fa-battery-three-quarters:before{content:""}.fa-battery-2:before,.fa-battery-half:before{content:""}.fa-battery-1:before,.fa-battery-quarter:before{content:""}.fa-battery-0:before,.fa-battery-empty:before{content:""}.fa-mouse-pointer:before{content:""}.fa-i-cursor:before{content:""}.fa-object-group:before{content:""}.fa-object-ungroup:before{content:""}.fa-sticky-note:before{content:""}.fa-sticky-note-o:before{content:""}.fa-cc-jcb:before{content:""}.fa-cc-diners-club:before{content:""}.fa-clone:before{content:""}.fa-balance-scale:before{content:""}.fa-hourglass-o:before{content:""}.fa-hourglass-1:before,.fa-hourglass-start:before{content:""}.fa-hourglass-2:before,.fa-hourglass-half:before{content:""}.fa-hourglass-3:before,.fa-hourglass-end:before{content:""}.fa-hourglass:before{content:""}.fa-hand-grab-o:before,.fa-hand-rock-o:before{content:""}.fa-hand-paper-o:before,.fa-hand-stop-o:before{content:""}.fa-hand-scissors-o:before{content:""}.fa-hand-lizard-o:before{content:""}.fa-hand-spock-o:before{content:""}.fa-hand-pointer-o:before{content:""}.fa-hand-peace-o:before{content:""}.fa-trademark:before{content:""}.fa-registered:before{content:""}.fa-creative-commons:before{content:""}.fa-gg:before{content:""}.fa-gg-circle:before{content:""}.fa-tripadvisor:before{content:""}.fa-odnoklassniki:before{content:""}.fa-odnoklassniki-square:before{content:""}.fa-get-pocket:before{content:""}.fa-wikipedia-w:before{content:""}.fa-safari:before{content:""}.fa-chrome:before{content:""}.fa-firefox:before{content:""}.fa-opera:before{content:""}.fa-internet-explorer:before{content:""}.fa-television:before,.fa-tv:before{content:""}.fa-contao:before{content:""}.fa-500px:before{content:""}.fa-amazon:before{content:""}.fa-calendar-plus-o:before{content:""}.fa-calendar-minus-o:before{content:""}.fa-calendar-times-o:before{content:""}.fa-calendar-check-o:before{content:""}.fa-industry:before{content:""}.fa-map-pin:before{content:""}.fa-map-signs:before{content:""}.fa-map-o:before{content:""}.fa-map:before{content:""}.fa-commenting:before{content:""}.fa-commenting-o:before{content:""}.fa-houzz:before{content:""}.fa-vimeo:before{content:""}.fa-black-tie:before{content:""}.fa-fonticons:before{content:""}.fa-reddit-alien:before{content:""}.fa-edge:before{content:""}.fa-credit-card-alt:before{content:""}.fa-codiepie:before{content:""}.fa-modx:before{content:""}.fa-fort-awesome:before{content:""}.fa-usb:before{content:""}.fa-product-hunt:before{content:""}.fa-mixcloud:before{content:""}.fa-scribd:before{content:""}.fa-pause-circle:before{content:""}.fa-pause-circle-o:before{content:""}.fa-stop-circle:before{content:""}.fa-stop-circle-o:before{content:""}.fa-shopping-bag:before{content:""}.fa-shopping-basket:before{content:""}.fa-hashtag:before{content:""}.fa-bluetooth:before{content:""}.fa-bluetooth-b:before{content:""}.fa-percent:before{content:""}.fa-gitlab:before,.icon-gitlab:before{content:""}.fa-wpbeginner:before{content:""}.fa-wpforms:before{content:""}.fa-envira:before{content:""}.fa-universal-access:before{content:""}.fa-wheelchair-alt:before{content:""}.fa-question-circle-o:before{content:""}.fa-blind:before{content:""}.fa-audio-description:before{content:""}.fa-volume-control-phone:before{content:""}.fa-braille:before{content:""}.fa-assistive-listening-systems:before{content:""}.fa-american-sign-language-interpreting:before,.fa-asl-interpreting:before{content:""}.fa-deaf:before,.fa-deafness:before,.fa-hard-of-hearing:before{content:""}.fa-glide:before{content:""}.fa-glide-g:before{content:""}.fa-sign-language:before,.fa-signing:before{content:""}.fa-low-vision:before{content:""}.fa-viadeo:before{content:""}.fa-viadeo-square:before{content:""}.fa-snapchat:before{content:""}.fa-snapchat-ghost:before{content:""}.fa-snapchat-square:before{content:""}.fa-pied-piper:before{content:""}.fa-first-order:before{content:""}.fa-yoast:before{content:""}.fa-themeisle:before{content:""}.fa-google-plus-circle:before,.fa-google-plus-official:before{content:""}.fa-fa:before,.fa-font-awesome:before{content:""}.fa-handshake-o:before{content:""}.fa-envelope-open:before{content:""}.fa-envelope-open-o:before{content:""}.fa-linode:before{content:""}.fa-address-book:before{content:""}.fa-address-book-o:before{content:""}.fa-address-card:before,.fa-vcard:before{content:""}.fa-address-card-o:before,.fa-vcard-o:before{content:""}.fa-user-circle:before{content:""}.fa-user-circle-o:before{content:""}.fa-user-o:before{content:""}.fa-id-badge:before{content:""}.fa-drivers-license:before,.fa-id-card:before{content:""}.fa-drivers-license-o:before,.fa-id-card-o:before{content:""}.fa-quora:before{content:""}.fa-free-code-camp:before{content:""}.fa-telegram:before{content:""}.fa-thermometer-4:before,.fa-thermometer-full:before,.fa-thermometer:before{content:""}.fa-thermometer-3:before,.fa-thermometer-three-quarters:before{content:""}.fa-thermometer-2:before,.fa-thermometer-half:before{content:""}.fa-thermometer-1:before,.fa-thermometer-quarter:before{content:""}.fa-thermometer-0:before,.fa-thermometer-empty:before{content:""}.fa-shower:before{content:""}.fa-bath:before,.fa-bathtub:before,.fa-s15:before{content:""}.fa-podcast:before{content:""}.fa-window-maximize:before{content:""}.fa-window-minimize:before{content:""}.fa-window-restore:before{content:""}.fa-times-rectangle:before,.fa-window-close:before{content:""}.fa-times-rectangle-o:before,.fa-window-close-o:before{content:""}.fa-bandcamp:before{content:""}.fa-grav:before{content:""}.fa-etsy:before{content:""}.fa-imdb:before{content:""}.fa-ravelry:before{content:""}.fa-eercast:before{content:""}.fa-microchip:before{content:""}.fa-snowflake-o:before{content:""}.fa-superpowers:before{content:""}.fa-wpexplorer:before{content:""}.fa-meetup:before{content:""}.sr-only{position:absolute;width:1px;height:1px;padding:0;margin:-1px;overflow:hidden;clip:rect(0,0,0,0);border:0}.sr-only-focusable:active,.sr-only-focusable:focus{position:static;width:auto;height:auto;margin:0;overflow:visible;clip:auto}.fa,.icon,.rst-content .admonition-title,.rst-content .code-block-caption .headerlink,.rst-content .eqno .headerlink,.rst-content code.download span:first-child,.rst-content dl dt .headerlink,.rst-content h1 .headerlink,.rst-content h2 .headerlink,.rst-content h3 .headerlink,.rst-content h4 .headerlink,.rst-content h5 .headerlink,.rst-content h6 .headerlink,.rst-content p.caption .headerlink,.rst-content p .headerlink,.rst-content table>caption .headerlink,.rst-content tt.download span:first-child,.wy-dropdown .caret,.wy-inline-validate.wy-inline-validate-danger .wy-input-context,.wy-inline-validate.wy-inline-validate-info .wy-input-context,.wy-inline-validate.wy-inline-validate-success .wy-input-context,.wy-inline-validate.wy-inline-validate-warning .wy-input-context,.wy-menu-vertical li.current>a button.toctree-expand,.wy-menu-vertical li.on a button.toctree-expand,.wy-menu-vertical li button.toctree-expand{font-family:inherit}.fa:before,.icon:before,.rst-content .admonition-title:before,.rst-content .code-block-caption .headerlink:before,.rst-content .eqno .headerlink:before,.rst-content code.download span:first-child:before,.rst-content dl dt .headerlink:before,.rst-content h1 .headerlink:before,.rst-content h2 .headerlink:before,.rst-content h3 .headerlink:before,.rst-content h4 .headerlink:before,.rst-content h5 .headerlink:before,.rst-content h6 .headerlink:before,.rst-content p.caption .headerlink:before,.rst-content p .headerlink:before,.rst-content table>caption .headerlink:before,.rst-content tt.download span:first-child:before,.wy-dropdown .caret:before,.wy-inline-validate.wy-inline-validate-danger .wy-input-context:before,.wy-inline-validate.wy-inline-validate-info .wy-input-context:before,.wy-inline-validate.wy-inline-validate-success .wy-input-context:before,.wy-inline-validate.wy-inline-validate-warning .wy-input-context:before,.wy-menu-vertical li.current>a button.toctree-expand:before,.wy-menu-vertical li.on a button.toctree-expand:before,.wy-menu-vertical li button.toctree-expand:before{font-family:FontAwesome;display:inline-block;font-style:normal;font-weight:400;line-height:1;text-decoration:inherit}.rst-content .code-block-caption a .headerlink,.rst-content .eqno a .headerlink,.rst-content a .admonition-title,.rst-content code.download a span:first-child,.rst-content dl dt a .headerlink,.rst-content h1 a .headerlink,.rst-content h2 a .headerlink,.rst-content h3 a .headerlink,.rst-content h4 a .headerlink,.rst-content h5 a .headerlink,.rst-content h6 a .headerlink,.rst-content p.caption a .headerlink,.rst-content p a .headerlink,.rst-content table>caption a .headerlink,.rst-content tt.download a span:first-child,.wy-menu-vertical li.current>a button.toctree-expand,.wy-menu-vertical li.on a button.toctree-expand,.wy-menu-vertical li a button.toctree-expand,a .fa,a .icon,a .rst-content .admonition-title,a .rst-content .code-block-caption .headerlink,a .rst-content .eqno .headerlink,a .rst-content code.download span:first-child,a .rst-content dl dt .headerlink,a .rst-content h1 .headerlink,a .rst-content h2 .headerlink,a .rst-content h3 .headerlink,a .rst-content h4 .headerlink,a .rst-content h5 .headerlink,a .rst-content h6 .headerlink,a .rst-content p.caption .headerlink,a .rst-content p .headerlink,a .rst-content table>caption .headerlink,a .rst-content tt.download span:first-child,a .wy-menu-vertical li button.toctree-expand{display:inline-block;text-decoration:inherit}.btn .fa,.btn .icon,.btn .rst-content .admonition-title,.btn .rst-content .code-block-caption .headerlink,.btn .rst-content .eqno .headerlink,.btn .rst-content code.download span:first-child,.btn .rst-content dl dt .headerlink,.btn .rst-content h1 .headerlink,.btn .rst-content h2 .headerlink,.btn .rst-content h3 .headerlink,.btn .rst-content h4 .headerlink,.btn .rst-content h5 .headerlink,.btn .rst-content h6 .headerlink,.btn .rst-content p .headerlink,.btn .rst-content table>caption .headerlink,.btn .rst-content tt.download span:first-child,.btn .wy-menu-vertical li.current>a button.toctree-expand,.btn .wy-menu-vertical li.on a button.toctree-expand,.btn .wy-menu-vertical li button.toctree-expand,.nav .fa,.nav .icon,.nav .rst-content .admonition-title,.nav .rst-content .code-block-caption .headerlink,.nav .rst-content .eqno .headerlink,.nav .rst-content code.download span:first-child,.nav .rst-content dl dt .headerlink,.nav .rst-content h1 .headerlink,.nav .rst-content h2 .headerlink,.nav .rst-content h3 .headerlink,.nav .rst-content h4 .headerlink,.nav .rst-content h5 .headerlink,.nav .rst-content h6 .headerlink,.nav .rst-content p .headerlink,.nav .rst-content table>caption .headerlink,.nav .rst-content tt.download span:first-child,.nav .wy-menu-vertical li.current>a button.toctree-expand,.nav .wy-menu-vertical li.on a button.toctree-expand,.nav .wy-menu-vertical li button.toctree-expand,.rst-content .btn .admonition-title,.rst-content .code-block-caption .btn .headerlink,.rst-content .code-block-caption .nav .headerlink,.rst-content .eqno .btn .headerlink,.rst-content .eqno .nav .headerlink,.rst-content .nav .admonition-title,.rst-content code.download .btn span:first-child,.rst-content code.download .nav span:first-child,.rst-content dl dt .btn .headerlink,.rst-content dl dt .nav .headerlink,.rst-content h1 .btn .headerlink,.rst-content h1 .nav .headerlink,.rst-content h2 .btn .headerlink,.rst-content h2 .nav .headerlink,.rst-content h3 .btn .headerlink,.rst-content h3 .nav .headerlink,.rst-content h4 .btn .headerlink,.rst-content h4 .nav .headerlink,.rst-content h5 .btn .headerlink,.rst-content h5 .nav .headerlink,.rst-content h6 .btn .headerlink,.rst-content h6 .nav .headerlink,.rst-content p .btn .headerlink,.rst-content p .nav .headerlink,.rst-content table>caption .btn .headerlink,.rst-content table>caption .nav .headerlink,.rst-content tt.download .btn span:first-child,.rst-content tt.download .nav span:first-child,.wy-menu-vertical li .btn button.toctree-expand,.wy-menu-vertical li.current>a .btn button.toctree-expand,.wy-menu-vertical li.current>a .nav button.toctree-expand,.wy-menu-vertical li .nav button.toctree-expand,.wy-menu-vertical li.on a .btn button.toctree-expand,.wy-menu-vertical li.on a .nav button.toctree-expand{display:inline}.btn .fa-large.icon,.btn .fa.fa-large,.btn .rst-content .code-block-caption .fa-large.headerlink,.btn .rst-content .eqno .fa-large.headerlink,.btn .rst-content .fa-large.admonition-title,.btn .rst-content code.download span.fa-large:first-child,.btn .rst-content dl dt .fa-large.headerlink,.btn .rst-content h1 .fa-large.headerlink,.btn .rst-content h2 .fa-large.headerlink,.btn .rst-content h3 .fa-large.headerlink,.btn .rst-content h4 .fa-large.headerlink,.btn .rst-content h5 .fa-large.headerlink,.btn .rst-content h6 .fa-large.headerlink,.btn .rst-content p .fa-large.headerlink,.btn .rst-content table>caption .fa-large.headerlink,.btn .rst-content tt.download span.fa-large:first-child,.btn .wy-menu-vertical li button.fa-large.toctree-expand,.nav .fa-large.icon,.nav .fa.fa-large,.nav .rst-content .code-block-caption .fa-large.headerlink,.nav .rst-content .eqno .fa-large.headerlink,.nav .rst-content .fa-large.admonition-title,.nav .rst-content code.download span.fa-large:first-child,.nav .rst-content dl dt .fa-large.headerlink,.nav .rst-content h1 .fa-large.headerlink,.nav .rst-content h2 .fa-large.headerlink,.nav .rst-content h3 .fa-large.headerlink,.nav .rst-content h4 .fa-large.headerlink,.nav .rst-content h5 .fa-large.headerlink,.nav .rst-content h6 .fa-large.headerlink,.nav .rst-content p .fa-large.headerlink,.nav .rst-content table>caption .fa-large.headerlink,.nav .rst-content tt.download span.fa-large:first-child,.nav .wy-menu-vertical li button.fa-large.toctree-expand,.rst-content .btn .fa-large.admonition-title,.rst-content .code-block-caption .btn .fa-large.headerlink,.rst-content .code-block-caption .nav .fa-large.headerlink,.rst-content .eqno .btn .fa-large.headerlink,.rst-content .eqno .nav .fa-large.headerlink,.rst-content .nav .fa-large.admonition-title,.rst-content code.download .btn span.fa-large:first-child,.rst-content code.download .nav span.fa-large:first-child,.rst-content dl dt .btn .fa-large.headerlink,.rst-content dl dt .nav .fa-large.headerlink,.rst-content h1 .btn .fa-large.headerlink,.rst-content h1 .nav .fa-large.headerlink,.rst-content h2 .btn .fa-large.headerlink,.rst-content h2 .nav .fa-large.headerlink,.rst-content h3 .btn .fa-large.headerlink,.rst-content h3 .nav .fa-large.headerlink,.rst-content h4 .btn .fa-large.headerlink,.rst-content h4 .nav .fa-large.headerlink,.rst-content h5 .btn .fa-large.headerlink,.rst-content h5 .nav .fa-large.headerlink,.rst-content h6 .btn .fa-large.headerlink,.rst-content h6 .nav .fa-large.headerlink,.rst-content p .btn .fa-large.headerlink,.rst-content p .nav .fa-large.headerlink,.rst-content table>caption .btn .fa-large.headerlink,.rst-content table>caption .nav .fa-large.headerlink,.rst-content tt.download .btn span.fa-large:first-child,.rst-content tt.download .nav span.fa-large:first-child,.wy-menu-vertical li .btn button.fa-large.toctree-expand,.wy-menu-vertical li .nav button.fa-large.toctree-expand{line-height:.9em}.btn .fa-spin.icon,.btn .fa.fa-spin,.btn .rst-content .code-block-caption .fa-spin.headerlink,.btn .rst-content .eqno .fa-spin.headerlink,.btn .rst-content .fa-spin.admonition-title,.btn .rst-content code.download span.fa-spin:first-child,.btn .rst-content dl dt .fa-spin.headerlink,.btn .rst-content h1 .fa-spin.headerlink,.btn .rst-content h2 .fa-spin.headerlink,.btn .rst-content h3 .fa-spin.headerlink,.btn .rst-content h4 .fa-spin.headerlink,.btn .rst-content h5 .fa-spin.headerlink,.btn .rst-content h6 .fa-spin.headerlink,.btn .rst-content p .fa-spin.headerlink,.btn .rst-content table>caption .fa-spin.headerlink,.btn .rst-content tt.download span.fa-spin:first-child,.btn .wy-menu-vertical li button.fa-spin.toctree-expand,.nav .fa-spin.icon,.nav .fa.fa-spin,.nav .rst-content .code-block-caption .fa-spin.headerlink,.nav .rst-content .eqno .fa-spin.headerlink,.nav .rst-content .fa-spin.admonition-title,.nav .rst-content code.download span.fa-spin:first-child,.nav .rst-content dl dt .fa-spin.headerlink,.nav .rst-content h1 .fa-spin.headerlink,.nav .rst-content h2 .fa-spin.headerlink,.nav .rst-content h3 .fa-spin.headerlink,.nav .rst-content h4 .fa-spin.headerlink,.nav .rst-content h5 .fa-spin.headerlink,.nav .rst-content h6 .fa-spin.headerlink,.nav .rst-content p .fa-spin.headerlink,.nav .rst-content table>caption .fa-spin.headerlink,.nav .rst-content tt.download span.fa-spin:first-child,.nav .wy-menu-vertical li button.fa-spin.toctree-expand,.rst-content .btn .fa-spin.admonition-title,.rst-content .code-block-caption .btn .fa-spin.headerlink,.rst-content .code-block-caption .nav .fa-spin.headerlink,.rst-content .eqno .btn .fa-spin.headerlink,.rst-content .eqno .nav .fa-spin.headerlink,.rst-content .nav .fa-spin.admonition-title,.rst-content code.download .btn span.fa-spin:first-child,.rst-content code.download .nav span.fa-spin:first-child,.rst-content dl dt .btn .fa-spin.headerlink,.rst-content dl dt .nav .fa-spin.headerlink,.rst-content h1 .btn .fa-spin.headerlink,.rst-content h1 .nav .fa-spin.headerlink,.rst-content h2 .btn .fa-spin.headerlink,.rst-content h2 .nav .fa-spin.headerlink,.rst-content h3 .btn .fa-spin.headerlink,.rst-content h3 .nav .fa-spin.headerlink,.rst-content h4 .btn .fa-spin.headerlink,.rst-content h4 .nav .fa-spin.headerlink,.rst-content h5 .btn .fa-spin.headerlink,.rst-content h5 .nav .fa-spin.headerlink,.rst-content h6 .btn .fa-spin.headerlink,.rst-content h6 .nav .fa-spin.headerlink,.rst-content p .btn .fa-spin.headerlink,.rst-content p .nav .fa-spin.headerlink,.rst-content table>caption .btn .fa-spin.headerlink,.rst-content table>caption .nav .fa-spin.headerlink,.rst-content tt.download .btn span.fa-spin:first-child,.rst-content tt.download .nav span.fa-spin:first-child,.wy-menu-vertical li .btn button.fa-spin.toctree-expand,.wy-menu-vertical li .nav button.fa-spin.toctree-expand{display:inline-block}.btn.fa:before,.btn.icon:before,.rst-content .btn.admonition-title:before,.rst-content .code-block-caption .btn.headerlink:before,.rst-content .eqno .btn.headerlink:before,.rst-content code.download span.btn:first-child:before,.rst-content dl dt .btn.headerlink:before,.rst-content h1 .btn.headerlink:before,.rst-content h2 .btn.headerlink:before,.rst-content h3 .btn.headerlink:before,.rst-content h4 .btn.headerlink:before,.rst-content h5 .btn.headerlink:before,.rst-content h6 .btn.headerlink:before,.rst-content p .btn.headerlink:before,.rst-content table>caption .btn.headerlink:before,.rst-content tt.download span.btn:first-child:before,.wy-menu-vertical li button.btn.toctree-expand:before{opacity:.5;-webkit-transition:opacity .05s ease-in;-moz-transition:opacity .05s ease-in;transition:opacity .05s ease-in}.btn.fa:hover:before,.btn.icon:hover:before,.rst-content .btn.admonition-title:hover:before,.rst-content .code-block-caption .btn.headerlink:hover:before,.rst-content .eqno .btn.headerlink:hover:before,.rst-content code.download span.btn:first-child:hover:before,.rst-content dl dt .btn.headerlink:hover:before,.rst-content h1 .btn.headerlink:hover:before,.rst-content h2 .btn.headerlink:hover:before,.rst-content h3 .btn.headerlink:hover:before,.rst-content h4 .btn.headerlink:hover:before,.rst-content h5 .btn.headerlink:hover:before,.rst-content h6 .btn.headerlink:hover:before,.rst-content p .btn.headerlink:hover:before,.rst-content table>caption .btn.headerlink:hover:before,.rst-content tt.download span.btn:first-child:hover:before,.wy-menu-vertical li button.btn.toctree-expand:hover:before{opacity:1}.btn-mini .fa:before,.btn-mini .icon:before,.btn-mini .rst-content .admonition-title:before,.btn-mini .rst-content .code-block-caption .headerlink:before,.btn-mini .rst-content .eqno .headerlink:before,.btn-mini .rst-content code.download span:first-child:before,.btn-mini .rst-content dl dt .headerlink:before,.btn-mini .rst-content h1 .headerlink:before,.btn-mini .rst-content h2 .headerlink:before,.btn-mini .rst-content h3 .headerlink:before,.btn-mini .rst-content h4 .headerlink:before,.btn-mini .rst-content h5 .headerlink:before,.btn-mini .rst-content h6 .headerlink:before,.btn-mini .rst-content p .headerlink:before,.btn-mini .rst-content table>caption .headerlink:before,.btn-mini .rst-content tt.download span:first-child:before,.btn-mini .wy-menu-vertical li button.toctree-expand:before,.rst-content .btn-mini .admonition-title:before,.rst-content .code-block-caption .btn-mini .headerlink:before,.rst-content .eqno .btn-mini .headerlink:before,.rst-content code.download .btn-mini span:first-child:before,.rst-content dl dt .btn-mini .headerlink:before,.rst-content h1 .btn-mini .headerlink:before,.rst-content h2 .btn-mini .headerlink:before,.rst-content h3 .btn-mini .headerlink:before,.rst-content h4 .btn-mini .headerlink:before,.rst-content h5 .btn-mini .headerlink:before,.rst-content h6 .btn-mini .headerlink:before,.rst-content p .btn-mini .headerlink:before,.rst-content table>caption .btn-mini .headerlink:before,.rst-content tt.download .btn-mini span:first-child:before,.wy-menu-vertical li .btn-mini button.toctree-expand:before{font-size:14px;vertical-align:-15%}.rst-content .admonition,.rst-content .admonition-todo,.rst-content .attention,.rst-content .caution,.rst-content .danger,.rst-content .error,.rst-content .hint,.rst-content .important,.rst-content .note,.rst-content .seealso,.rst-content .tip,.rst-content .warning,.wy-alert{padding:12px;line-height:24px;margin-bottom:24px;background:#e7f2fa}.rst-content .admonition-title,.wy-alert-title{font-weight:700;display:block;color:#fff;background:#6ab0de;padding:6px 12px;margin:-12px -12px 12px}.rst-content .danger,.rst-content .error,.rst-content .wy-alert-danger.admonition,.rst-content .wy-alert-danger.admonition-todo,.rst-content .wy-alert-danger.attention,.rst-content .wy-alert-danger.caution,.rst-content .wy-alert-danger.hint,.rst-content .wy-alert-danger.important,.rst-content .wy-alert-danger.note,.rst-content .wy-alert-danger.seealso,.rst-content .wy-alert-danger.tip,.rst-content .wy-alert-danger.warning,.wy-alert.wy-alert-danger{background:#fdf3f2}.rst-content .danger .admonition-title,.rst-content .danger .wy-alert-title,.rst-content .error .admonition-title,.rst-content .error .wy-alert-title,.rst-content .wy-alert-danger.admonition-todo .admonition-title,.rst-content .wy-alert-danger.admonition-todo .wy-alert-title,.rst-content .wy-alert-danger.admonition .admonition-title,.rst-content .wy-alert-danger.admonition .wy-alert-title,.rst-content .wy-alert-danger.attention .admonition-title,.rst-content .wy-alert-danger.attention .wy-alert-title,.rst-content .wy-alert-danger.caution .admonition-title,.rst-content .wy-alert-danger.caution .wy-alert-title,.rst-content .wy-alert-danger.hint .admonition-title,.rst-content .wy-alert-danger.hint .wy-alert-title,.rst-content .wy-alert-danger.important .admonition-title,.rst-content .wy-alert-danger.important .wy-alert-title,.rst-content .wy-alert-danger.note .admonition-title,.rst-content .wy-alert-danger.note .wy-alert-title,.rst-content .wy-alert-danger.seealso .admonition-title,.rst-content .wy-alert-danger.seealso .wy-alert-title,.rst-content .wy-alert-danger.tip .admonition-title,.rst-content .wy-alert-danger.tip .wy-alert-title,.rst-content .wy-alert-danger.warning .admonition-title,.rst-content .wy-alert-danger.warning .wy-alert-title,.rst-content .wy-alert.wy-alert-danger .admonition-title,.wy-alert.wy-alert-danger .rst-content .admonition-title,.wy-alert.wy-alert-danger .wy-alert-title{background:#f29f97}.rst-content .admonition-todo,.rst-content .attention,.rst-content .caution,.rst-content .warning,.rst-content .wy-alert-warning.admonition,.rst-content .wy-alert-warning.danger,.rst-content .wy-alert-warning.error,.rst-content .wy-alert-warning.hint,.rst-content .wy-alert-warning.important,.rst-content .wy-alert-warning.note,.rst-content .wy-alert-warning.seealso,.rst-content .wy-alert-warning.tip,.wy-alert.wy-alert-warning{background:#ffedcc}.rst-content .admonition-todo .admonition-title,.rst-content .admonition-todo .wy-alert-title,.rst-content .attention .admonition-title,.rst-content .attention .wy-alert-title,.rst-content .caution .admonition-title,.rst-content .caution .wy-alert-title,.rst-content .warning .admonition-title,.rst-content .warning .wy-alert-title,.rst-content .wy-alert-warning.admonition .admonition-title,.rst-content .wy-alert-warning.admonition .wy-alert-title,.rst-content .wy-alert-warning.danger .admonition-title,.rst-content .wy-alert-warning.danger .wy-alert-title,.rst-content .wy-alert-warning.error .admonition-title,.rst-content .wy-alert-warning.error .wy-alert-title,.rst-content .wy-alert-warning.hint .admonition-title,.rst-content .wy-alert-warning.hint .wy-alert-title,.rst-content .wy-alert-warning.important .admonition-title,.rst-content .wy-alert-warning.important .wy-alert-title,.rst-content .wy-alert-warning.note .admonition-title,.rst-content .wy-alert-warning.note .wy-alert-title,.rst-content .wy-alert-warning.seealso .admonition-title,.rst-content .wy-alert-warning.seealso .wy-alert-title,.rst-content .wy-alert-warning.tip .admonition-title,.rst-content .wy-alert-warning.tip .wy-alert-title,.rst-content .wy-alert.wy-alert-warning .admonition-title,.wy-alert.wy-alert-warning .rst-content .admonition-title,.wy-alert.wy-alert-warning .wy-alert-title{background:#f0b37e}.rst-content .note,.rst-content .seealso,.rst-content .wy-alert-info.admonition,.rst-content .wy-alert-info.admonition-todo,.rst-content .wy-alert-info.attention,.rst-content .wy-alert-info.caution,.rst-content .wy-alert-info.danger,.rst-content .wy-alert-info.error,.rst-content .wy-alert-info.hint,.rst-content .wy-alert-info.important,.rst-content .wy-alert-info.tip,.rst-content .wy-alert-info.warning,.wy-alert.wy-alert-info{background:#e7f2fa}.rst-content .note .admonition-title,.rst-content .note .wy-alert-title,.rst-content .seealso .admonition-title,.rst-content .seealso .wy-alert-title,.rst-content .wy-alert-info.admonition-todo .admonition-title,.rst-content .wy-alert-info.admonition-todo .wy-alert-title,.rst-content .wy-alert-info.admonition .admonition-title,.rst-content .wy-alert-info.admonition .wy-alert-title,.rst-content .wy-alert-info.attention .admonition-title,.rst-content .wy-alert-info.attention .wy-alert-title,.rst-content .wy-alert-info.caution .admonition-title,.rst-content .wy-alert-info.caution .wy-alert-title,.rst-content .wy-alert-info.danger .admonition-title,.rst-content .wy-alert-info.danger .wy-alert-title,.rst-content .wy-alert-info.error .admonition-title,.rst-content .wy-alert-info.error .wy-alert-title,.rst-content .wy-alert-info.hint .admonition-title,.rst-content .wy-alert-info.hint .wy-alert-title,.rst-content .wy-alert-info.important .admonition-title,.rst-content .wy-alert-info.important .wy-alert-title,.rst-content .wy-alert-info.tip .admonition-title,.rst-content .wy-alert-info.tip .wy-alert-title,.rst-content .wy-alert-info.warning .admonition-title,.rst-content .wy-alert-info.warning .wy-alert-title,.rst-content .wy-alert.wy-alert-info .admonition-title,.wy-alert.wy-alert-info .rst-content .admonition-title,.wy-alert.wy-alert-info .wy-alert-title{background:#6ab0de}.rst-content .hint,.rst-content .important,.rst-content .tip,.rst-content .wy-alert-success.admonition,.rst-content .wy-alert-success.admonition-todo,.rst-content .wy-alert-success.attention,.rst-content .wy-alert-success.caution,.rst-content .wy-alert-success.danger,.rst-content .wy-alert-success.error,.rst-content .wy-alert-success.note,.rst-content .wy-alert-success.seealso,.rst-content .wy-alert-success.warning,.wy-alert.wy-alert-success{background:#dbfaf4}.rst-content .hint .admonition-title,.rst-content .hint .wy-alert-title,.rst-content .important .admonition-title,.rst-content .important .wy-alert-title,.rst-content .tip .admonition-title,.rst-content .tip .wy-alert-title,.rst-content .wy-alert-success.admonition-todo .admonition-title,.rst-content .wy-alert-success.admonition-todo .wy-alert-title,.rst-content .wy-alert-success.admonition .admonition-title,.rst-content .wy-alert-success.admonition .wy-alert-title,.rst-content .wy-alert-success.attention .admonition-title,.rst-content .wy-alert-success.attention .wy-alert-title,.rst-content .wy-alert-success.caution .admonition-title,.rst-content .wy-alert-success.caution .wy-alert-title,.rst-content .wy-alert-success.danger .admonition-title,.rst-content .wy-alert-success.danger .wy-alert-title,.rst-content .wy-alert-success.error .admonition-title,.rst-content .wy-alert-success.error .wy-alert-title,.rst-content .wy-alert-success.note .admonition-title,.rst-content .wy-alert-success.note .wy-alert-title,.rst-content .wy-alert-success.seealso .admonition-title,.rst-content .wy-alert-success.seealso .wy-alert-title,.rst-content .wy-alert-success.warning .admonition-title,.rst-content .wy-alert-success.warning .wy-alert-title,.rst-content .wy-alert.wy-alert-success .admonition-title,.wy-alert.wy-alert-success .rst-content .admonition-title,.wy-alert.wy-alert-success .wy-alert-title{background:#1abc9c}.rst-content .wy-alert-neutral.admonition,.rst-content .wy-alert-neutral.admonition-todo,.rst-content .wy-alert-neutral.attention,.rst-content .wy-alert-neutral.caution,.rst-content .wy-alert-neutral.danger,.rst-content .wy-alert-neutral.error,.rst-content .wy-alert-neutral.hint,.rst-content .wy-alert-neutral.important,.rst-content .wy-alert-neutral.note,.rst-content .wy-alert-neutral.seealso,.rst-content .wy-alert-neutral.tip,.rst-content .wy-alert-neutral.warning,.wy-alert.wy-alert-neutral{background:#f3f6f6}.rst-content .wy-alert-neutral.admonition-todo .admonition-title,.rst-content .wy-alert-neutral.admonition-todo .wy-alert-title,.rst-content .wy-alert-neutral.admonition .admonition-title,.rst-content .wy-alert-neutral.admonition .wy-alert-title,.rst-content .wy-alert-neutral.attention .admonition-title,.rst-content .wy-alert-neutral.attention .wy-alert-title,.rst-content .wy-alert-neutral.caution .admonition-title,.rst-content .wy-alert-neutral.caution .wy-alert-title,.rst-content .wy-alert-neutral.danger .admonition-title,.rst-content .wy-alert-neutral.danger .wy-alert-title,.rst-content .wy-alert-neutral.error .admonition-title,.rst-content .wy-alert-neutral.error .wy-alert-title,.rst-content .wy-alert-neutral.hint .admonition-title,.rst-content .wy-alert-neutral.hint .wy-alert-title,.rst-content .wy-alert-neutral.important .admonition-title,.rst-content .wy-alert-neutral.important .wy-alert-title,.rst-content .wy-alert-neutral.note .admonition-title,.rst-content .wy-alert-neutral.note .wy-alert-title,.rst-content .wy-alert-neutral.seealso .admonition-title,.rst-content .wy-alert-neutral.seealso .wy-alert-title,.rst-content .wy-alert-neutral.tip .admonition-title,.rst-content .wy-alert-neutral.tip .wy-alert-title,.rst-content .wy-alert-neutral.warning .admonition-title,.rst-content .wy-alert-neutral.warning .wy-alert-title,.rst-content .wy-alert.wy-alert-neutral .admonition-title,.wy-alert.wy-alert-neutral .rst-content .admonition-title,.wy-alert.wy-alert-neutral .wy-alert-title{color:#404040;background:#e1e4e5}.rst-content .wy-alert-neutral.admonition-todo a,.rst-content .wy-alert-neutral.admonition a,.rst-content .wy-alert-neutral.attention a,.rst-content .wy-alert-neutral.caution a,.rst-content .wy-alert-neutral.danger a,.rst-content .wy-alert-neutral.error a,.rst-content .wy-alert-neutral.hint a,.rst-content .wy-alert-neutral.important a,.rst-content .wy-alert-neutral.note a,.rst-content .wy-alert-neutral.seealso a,.rst-content .wy-alert-neutral.tip a,.rst-content .wy-alert-neutral.warning a,.wy-alert.wy-alert-neutral a{color:#2980b9}.rst-content .admonition-todo p:last-child,.rst-content .admonition p:last-child,.rst-content .attention p:last-child,.rst-content .caution p:last-child,.rst-content .danger p:last-child,.rst-content .error p:last-child,.rst-content .hint p:last-child,.rst-content .important p:last-child,.rst-content .note p:last-child,.rst-content .seealso p:last-child,.rst-content .tip p:last-child,.rst-content .warning p:last-child,.wy-alert p:last-child{margin-bottom:0}.wy-tray-container{position:fixed;bottom:0;left:0;z-index:600}.wy-tray-container li{display:block;width:300px;background:transparent;color:#fff;text-align:center;box-shadow:0 5px 5px 0 rgba(0,0,0,.1);padding:0 24px;min-width:20%;opacity:0;height:0;line-height:56px;overflow:hidden;-webkit-transition:all .3s ease-in;-moz-transition:all .3s ease-in;transition:all .3s ease-in}.wy-tray-container li.wy-tray-item-success{background:#27ae60}.wy-tray-container li.wy-tray-item-info{background:#2980b9}.wy-tray-container li.wy-tray-item-warning{background:#e67e22}.wy-tray-container li.wy-tray-item-danger{background:#e74c3c}.wy-tray-container li.on{opacity:1;height:56px}@media screen and (max-width:768px){.wy-tray-container{bottom:auto;top:0;width:100%}.wy-tray-container li{width:100%}}button{font-size:100%;margin:0;vertical-align:baseline;*vertical-align:middle;cursor:pointer;line-height:normal;-webkit-appearance:button;*overflow:visible}button::-moz-focus-inner,input::-moz-focus-inner{border:0;padding:0}button[disabled]{cursor:default}.btn{display:inline-block;border-radius:2px;line-height:normal;white-space:nowrap;text-align:center;cursor:pointer;font-size:100%;padding:6px 12px 8px;color:#fff;border:1px solid rgba(0,0,0,.1);background-color:#27ae60;text-decoration:none;font-weight:400;font-family:Lato,proxima-nova,Helvetica Neue,Arial,sans-serif;box-shadow:inset 0 1px 2px -1px hsla(0,0%,100%,.5),inset 0 -2px 0 0 rgba(0,0,0,.1);outline-none:false;vertical-align:middle;*display:inline;zoom:1;-webkit-user-drag:none;-webkit-user-select:none;-moz-user-select:none;-ms-user-select:none;user-select:none;-webkit-transition:all .1s linear;-moz-transition:all .1s linear;transition:all .1s linear}.btn-hover{background:#2e8ece;color:#fff}.btn:hover{background:#2cc36b;color:#fff}.btn:focus{background:#2cc36b;outline:0}.btn:active{box-shadow:inset 0 -1px 0 0 rgba(0,0,0,.05),inset 0 2px 0 0 rgba(0,0,0,.1);padding:8px 12px 6px}.btn:visited{color:#fff}.btn-disabled,.btn-disabled:active,.btn-disabled:focus,.btn-disabled:hover,.btn:disabled{background-image:none;filter:progid:DXImageTransform.Microsoft.gradient(enabled = false);filter:alpha(opacity=40);opacity:.4;cursor:not-allowed;box-shadow:none}.btn::-moz-focus-inner{padding:0;border:0}.btn-small{font-size:80%}.btn-info{background-color:#2980b9!important}.btn-info:hover{background-color:#2e8ece!important}.btn-neutral{background-color:#f3f6f6!important;color:#404040!important}.btn-neutral:hover{background-color:#e5ebeb!important;color:#404040}.btn-neutral:visited{color:#404040!important}.btn-success{background-color:#27ae60!important}.btn-success:hover{background-color:#295!important}.btn-danger{background-color:#e74c3c!important}.btn-danger:hover{background-color:#ea6153!important}.btn-warning{background-color:#e67e22!important}.btn-warning:hover{background-color:#e98b39!important}.btn-invert{background-color:#222}.btn-invert:hover{background-color:#2f2f2f!important}.btn-link{background-color:transparent!important;color:#2980b9;box-shadow:none;border-color:transparent!important}.btn-link:active,.btn-link:hover{background-color:transparent!important;color:#409ad5!important;box-shadow:none}.btn-link:visited{color:#9b59b6}.wy-btn-group .btn,.wy-control .btn{vertical-align:middle}.wy-btn-group{margin-bottom:24px;*zoom:1}.wy-btn-group:after,.wy-btn-group:before{display:table;content:""}.wy-btn-group:after{clear:both}.wy-dropdown{position:relative;display:inline-block}.wy-dropdown-active .wy-dropdown-menu{display:block}.wy-dropdown-menu{position:absolute;left:0;display:none;float:left;top:100%;min-width:100%;background:#fcfcfc;z-index:100;border:1px solid #cfd7dd;box-shadow:0 2px 2px 0 rgba(0,0,0,.1);padding:12px}.wy-dropdown-menu>dd>a{display:block;clear:both;color:#404040;white-space:nowrap;font-size:90%;padding:0 12px;cursor:pointer}.wy-dropdown-menu>dd>a:hover{background:#2980b9;color:#fff}.wy-dropdown-menu>dd.divider{border-top:1px solid #cfd7dd;margin:6px 0}.wy-dropdown-menu>dd.search{padding-bottom:12px}.wy-dropdown-menu>dd.search input[type=search]{width:100%}.wy-dropdown-menu>dd.call-to-action{background:#e3e3e3;text-transform:uppercase;font-weight:500;font-size:80%}.wy-dropdown-menu>dd.call-to-action:hover{background:#e3e3e3}.wy-dropdown-menu>dd.call-to-action .btn{color:#fff}.wy-dropdown.wy-dropdown-up .wy-dropdown-menu{bottom:100%;top:auto;left:auto;right:0}.wy-dropdown.wy-dropdown-bubble .wy-dropdown-menu{background:#fcfcfc;margin-top:2px}.wy-dropdown.wy-dropdown-bubble .wy-dropdown-menu a{padding:6px 12px}.wy-dropdown.wy-dropdown-bubble .wy-dropdown-menu a:hover{background:#2980b9;color:#fff}.wy-dropdown.wy-dropdown-left .wy-dropdown-menu{right:0;left:auto;text-align:right}.wy-dropdown-arrow:before{content:" ";border-bottom:5px solid #f5f5f5;border-left:5px solid transparent;border-right:5px solid transparent;position:absolute;display:block;top:-4px;left:50%;margin-left:-3px}.wy-dropdown-arrow.wy-dropdown-arrow-left:before{left:11px}.wy-form-stacked select{display:block}.wy-form-aligned .wy-help-inline,.wy-form-aligned input,.wy-form-aligned label,.wy-form-aligned select,.wy-form-aligned textarea{display:inline-block;*display:inline;*zoom:1;vertical-align:middle}.wy-form-aligned .wy-control-group>label{display:inline-block;vertical-align:middle;width:10em;margin:6px 12px 0 0;float:left}.wy-form-aligned .wy-control{float:left}.wy-form-aligned .wy-control label{display:block}.wy-form-aligned .wy-control select{margin-top:6px}fieldset{margin:0}fieldset,legend{border:0;padding:0}legend{width:100%;white-space:normal;margin-bottom:24px;font-size:150%;*margin-left:-7px}label,legend{display:block}label{margin:0 0 .3125em;color:#333;font-size:90%}input,select,textarea{font-size:100%;margin:0;vertical-align:baseline;*vertical-align:middle}.wy-control-group{margin-bottom:24px;max-width:1200px;margin-left:auto;margin-right:auto;*zoom:1}.wy-control-group:after,.wy-control-group:before{display:table;content:""}.wy-control-group:after{clear:both}.wy-control-group.wy-control-group-required>label:after{content:" *";color:#e74c3c}.wy-control-group .wy-form-full,.wy-control-group .wy-form-halves,.wy-control-group .wy-form-thirds{padding-bottom:12px}.wy-control-group .wy-form-full input[type=color],.wy-control-group .wy-form-full input[type=date],.wy-control-group .wy-form-full input[type=datetime-local],.wy-control-group .wy-form-full input[type=datetime],.wy-control-group .wy-form-full input[type=email],.wy-control-group .wy-form-full input[type=month],.wy-control-group .wy-form-full input[type=number],.wy-control-group .wy-form-full input[type=password],.wy-control-group .wy-form-full input[type=search],.wy-control-group .wy-form-full input[type=tel],.wy-control-group .wy-form-full input[type=text],.wy-control-group .wy-form-full input[type=time],.wy-control-group .wy-form-full input[type=url],.wy-control-group .wy-form-full input[type=week],.wy-control-group .wy-form-full select,.wy-control-group .wy-form-halves input[type=color],.wy-control-group .wy-form-halves input[type=date],.wy-control-group .wy-form-halves input[type=datetime-local],.wy-control-group .wy-form-halves input[type=datetime],.wy-control-group .wy-form-halves input[type=email],.wy-control-group .wy-form-halves input[type=month],.wy-control-group .wy-form-halves input[type=number],.wy-control-group .wy-form-halves input[type=password],.wy-control-group .wy-form-halves input[type=search],.wy-control-group .wy-form-halves input[type=tel],.wy-control-group .wy-form-halves input[type=text],.wy-control-group .wy-form-halves input[type=time],.wy-control-group .wy-form-halves input[type=url],.wy-control-group .wy-form-halves input[type=week],.wy-control-group .wy-form-halves select,.wy-control-group .wy-form-thirds input[type=color],.wy-control-group .wy-form-thirds input[type=date],.wy-control-group .wy-form-thirds input[type=datetime-local],.wy-control-group .wy-form-thirds input[type=datetime],.wy-control-group .wy-form-thirds input[type=email],.wy-control-group .wy-form-thirds input[type=month],.wy-control-group .wy-form-thirds input[type=number],.wy-control-group .wy-form-thirds input[type=password],.wy-control-group .wy-form-thirds input[type=search],.wy-control-group .wy-form-thirds input[type=tel],.wy-control-group .wy-form-thirds input[type=text],.wy-control-group .wy-form-thirds input[type=time],.wy-control-group .wy-form-thirds input[type=url],.wy-control-group .wy-form-thirds input[type=week],.wy-control-group .wy-form-thirds select{width:100%}.wy-control-group .wy-form-full{float:left;display:block;width:100%;margin-right:0}.wy-control-group .wy-form-full:last-child{margin-right:0}.wy-control-group .wy-form-halves{float:left;display:block;margin-right:2.35765%;width:48.82117%}.wy-control-group .wy-form-halves:last-child,.wy-control-group .wy-form-halves:nth-of-type(2n){margin-right:0}.wy-control-group .wy-form-halves:nth-of-type(odd){clear:left}.wy-control-group .wy-form-thirds{float:left;display:block;margin-right:2.35765%;width:31.76157%}.wy-control-group .wy-form-thirds:last-child,.wy-control-group .wy-form-thirds:nth-of-type(3n){margin-right:0}.wy-control-group .wy-form-thirds:nth-of-type(3n+1){clear:left}.wy-control-group.wy-control-group-no-input .wy-control,.wy-control-no-input{margin:6px 0 0;font-size:90%}.wy-control-no-input{display:inline-block}.wy-control-group.fluid-input input[type=color],.wy-control-group.fluid-input input[type=date],.wy-control-group.fluid-input input[type=datetime-local],.wy-control-group.fluid-input input[type=datetime],.wy-control-group.fluid-input input[type=email],.wy-control-group.fluid-input input[type=month],.wy-control-group.fluid-input input[type=number],.wy-control-group.fluid-input input[type=password],.wy-control-group.fluid-input input[type=search],.wy-control-group.fluid-input input[type=tel],.wy-control-group.fluid-input input[type=text],.wy-control-group.fluid-input input[type=time],.wy-control-group.fluid-input input[type=url],.wy-control-group.fluid-input input[type=week]{width:100%}.wy-form-message-inline{padding-left:.3em;color:#666;font-size:90%}.wy-form-message{display:block;color:#999;font-size:70%;margin-top:.3125em;font-style:italic}.wy-form-message p{font-size:inherit;font-style:italic;margin-bottom:6px}.wy-form-message p:last-child{margin-bottom:0}input{line-height:normal}input[type=button],input[type=reset],input[type=submit]{-webkit-appearance:button;cursor:pointer;font-family:Lato,proxima-nova,Helvetica Neue,Arial,sans-serif;*overflow:visible}input[type=color],input[type=date],input[type=datetime-local],input[type=datetime],input[type=email],input[type=month],input[type=number],input[type=password],input[type=search],input[type=tel],input[type=text],input[type=time],input[type=url],input[type=week]{-webkit-appearance:none;padding:6px;display:inline-block;border:1px solid #ccc;font-size:80%;font-family:Lato,proxima-nova,Helvetica Neue,Arial,sans-serif;box-shadow:inset 0 1px 3px #ddd;border-radius:0;-webkit-transition:border .3s linear;-moz-transition:border .3s linear;transition:border .3s linear}input[type=datetime-local]{padding:.34375em .625em}input[disabled]{cursor:default}input[type=checkbox],input[type=radio]{padding:0;margin-right:.3125em;*height:13px;*width:13px}input[type=checkbox],input[type=radio],input[type=search]{-webkit-box-sizing:border-box;-moz-box-sizing:border-box;box-sizing:border-box}input[type=search]::-webkit-search-cancel-button,input[type=search]::-webkit-search-decoration{-webkit-appearance:none}input[type=color]:focus,input[type=date]:focus,input[type=datetime-local]:focus,input[type=datetime]:focus,input[type=email]:focus,input[type=month]:focus,input[type=number]:focus,input[type=password]:focus,input[type=search]:focus,input[type=tel]:focus,input[type=text]:focus,input[type=time]:focus,input[type=url]:focus,input[type=week]:focus{outline:0;outline:thin dotted\9;border-color:#333}input.no-focus:focus{border-color:#ccc!important}input[type=checkbox]:focus,input[type=file]:focus,input[type=radio]:focus{outline:thin dotted #333;outline:1px auto #129fea}input[type=color][disabled],input[type=date][disabled],input[type=datetime-local][disabled],input[type=datetime][disabled],input[type=email][disabled],input[type=month][disabled],input[type=number][disabled],input[type=password][disabled],input[type=search][disabled],input[type=tel][disabled],input[type=text][disabled],input[type=time][disabled],input[type=url][disabled],input[type=week][disabled]{cursor:not-allowed;background-color:#fafafa}input:focus:invalid,select:focus:invalid,textarea:focus:invalid{color:#e74c3c;border:1px solid #e74c3c}input:focus:invalid:focus,select:focus:invalid:focus,textarea:focus:invalid:focus{border-color:#e74c3c}input[type=checkbox]:focus:invalid:focus,input[type=file]:focus:invalid:focus,input[type=radio]:focus:invalid:focus{outline-color:#e74c3c}input.wy-input-large{padding:12px;font-size:100%}textarea{overflow:auto;vertical-align:top;width:100%;font-family:Lato,proxima-nova,Helvetica Neue,Arial,sans-serif}select,textarea{padding:.5em .625em;display:inline-block;border:1px solid #ccc;font-size:80%;box-shadow:inset 0 1px 3px #ddd;-webkit-transition:border .3s linear;-moz-transition:border .3s linear;transition:border .3s linear}select{border:1px solid #ccc;background-color:#fff}select[multiple]{height:auto}select:focus,textarea:focus{outline:0}input[readonly],select[disabled],select[readonly],textarea[disabled],textarea[readonly]{cursor:not-allowed;background-color:#fafafa}input[type=checkbox][disabled],input[type=radio][disabled]{cursor:not-allowed}.wy-checkbox,.wy-radio{margin:6px 0;color:#404040;display:block}.wy-checkbox input,.wy-radio input{vertical-align:baseline}.wy-form-message-inline{display:inline-block;*display:inline;*zoom:1;vertical-align:middle}.wy-input-prefix,.wy-input-suffix{white-space:nowrap;padding:6px}.wy-input-prefix .wy-input-context,.wy-input-suffix .wy-input-context{line-height:27px;padding:0 8px;display:inline-block;font-size:80%;background-color:#f3f6f6;border:1px solid #ccc;color:#999}.wy-input-suffix .wy-input-context{border-left:0}.wy-input-prefix .wy-input-context{border-right:0}.wy-switch{position:relative;display:block;height:24px;margin-top:12px;cursor:pointer}.wy-switch:before{left:0;top:0;width:36px;height:12px;background:#ccc}.wy-switch:after,.wy-switch:before{position:absolute;content:"";display:block;border-radius:4px;-webkit-transition:all .2s ease-in-out;-moz-transition:all .2s ease-in-out;transition:all .2s ease-in-out}.wy-switch:after{width:18px;height:18px;background:#999;left:-3px;top:-3px}.wy-switch span{position:absolute;left:48px;display:block;font-size:12px;color:#ccc;line-height:1}.wy-switch.active:before{background:#1e8449}.wy-switch.active:after{left:24px;background:#27ae60}.wy-switch.disabled{cursor:not-allowed;opacity:.8}.wy-control-group.wy-control-group-error .wy-form-message,.wy-control-group.wy-control-group-error>label{color:#e74c3c}.wy-control-group.wy-control-group-error input[type=color],.wy-control-group.wy-control-group-error input[type=date],.wy-control-group.wy-control-group-error input[type=datetime-local],.wy-control-group.wy-control-group-error input[type=datetime],.wy-control-group.wy-control-group-error input[type=email],.wy-control-group.wy-control-group-error input[type=month],.wy-control-group.wy-control-group-error input[type=number],.wy-control-group.wy-control-group-error input[type=password],.wy-control-group.wy-control-group-error input[type=search],.wy-control-group.wy-control-group-error input[type=tel],.wy-control-group.wy-control-group-error input[type=text],.wy-control-group.wy-control-group-error input[type=time],.wy-control-group.wy-control-group-error input[type=url],.wy-control-group.wy-control-group-error input[type=week],.wy-control-group.wy-control-group-error textarea{border:1px solid #e74c3c}.wy-inline-validate{white-space:nowrap}.wy-inline-validate .wy-input-context{padding:.5em .625em;display:inline-block;font-size:80%}.wy-inline-validate.wy-inline-validate-success .wy-input-context{color:#27ae60}.wy-inline-validate.wy-inline-validate-danger .wy-input-context{color:#e74c3c}.wy-inline-validate.wy-inline-validate-warning .wy-input-context{color:#e67e22}.wy-inline-validate.wy-inline-validate-info .wy-input-context{color:#2980b9}.rotate-90{-webkit-transform:rotate(90deg);-moz-transform:rotate(90deg);-ms-transform:rotate(90deg);-o-transform:rotate(90deg);transform:rotate(90deg)}.rotate-180{-webkit-transform:rotate(180deg);-moz-transform:rotate(180deg);-ms-transform:rotate(180deg);-o-transform:rotate(180deg);transform:rotate(180deg)}.rotate-270{-webkit-transform:rotate(270deg);-moz-transform:rotate(270deg);-ms-transform:rotate(270deg);-o-transform:rotate(270deg);transform:rotate(270deg)}.mirror{-webkit-transform:scaleX(-1);-moz-transform:scaleX(-1);-ms-transform:scaleX(-1);-o-transform:scaleX(-1);transform:scaleX(-1)}.mirror.rotate-90{-webkit-transform:scaleX(-1) rotate(90deg);-moz-transform:scaleX(-1) rotate(90deg);-ms-transform:scaleX(-1) rotate(90deg);-o-transform:scaleX(-1) rotate(90deg);transform:scaleX(-1) rotate(90deg)}.mirror.rotate-180{-webkit-transform:scaleX(-1) rotate(180deg);-moz-transform:scaleX(-1) rotate(180deg);-ms-transform:scaleX(-1) rotate(180deg);-o-transform:scaleX(-1) rotate(180deg);transform:scaleX(-1) rotate(180deg)}.mirror.rotate-270{-webkit-transform:scaleX(-1) rotate(270deg);-moz-transform:scaleX(-1) rotate(270deg);-ms-transform:scaleX(-1) rotate(270deg);-o-transform:scaleX(-1) rotate(270deg);transform:scaleX(-1) rotate(270deg)}@media only screen and (max-width:480px){.wy-form button[type=submit]{margin:.7em 0 0}.wy-form input[type=color],.wy-form input[type=date],.wy-form input[type=datetime-local],.wy-form input[type=datetime],.wy-form input[type=email],.wy-form input[type=month],.wy-form input[type=number],.wy-form input[type=password],.wy-form input[type=search],.wy-form input[type=tel],.wy-form input[type=text],.wy-form input[type=time],.wy-form input[type=url],.wy-form input[type=week],.wy-form label{margin-bottom:.3em;display:block}.wy-form input[type=color],.wy-form input[type=date],.wy-form input[type=datetime-local],.wy-form input[type=datetime],.wy-form input[type=email],.wy-form input[type=month],.wy-form input[type=number],.wy-form input[type=password],.wy-form input[type=search],.wy-form input[type=tel],.wy-form input[type=time],.wy-form input[type=url],.wy-form input[type=week]{margin-bottom:0}.wy-form-aligned .wy-control-group label{margin-bottom:.3em;text-align:left;display:block;width:100%}.wy-form-aligned .wy-control{margin:1.5em 0 0}.wy-form-message,.wy-form-message-inline,.wy-form .wy-help-inline{display:block;font-size:80%;padding:6px 0}}@media screen and (max-width:768px){.tablet-hide{display:none}}@media screen and (max-width:480px){.mobile-hide{display:none}}.float-left{float:left}.float-right{float:right}.full-width{width:100%}.rst-content table.docutils,.rst-content table.field-list,.wy-table{border-collapse:collapse;border-spacing:0;empty-cells:show;margin-bottom:24px}.rst-content table.docutils caption,.rst-content table.field-list caption,.wy-table caption{color:#000;font:italic 85%/1 arial,sans-serif;padding:1em 0;text-align:center}.rst-content table.docutils td,.rst-content table.docutils th,.rst-content table.field-list td,.rst-content table.field-list th,.wy-table td,.wy-table th{font-size:90%;margin:0;overflow:visible;padding:8px 16px}.rst-content table.docutils td:first-child,.rst-content table.docutils th:first-child,.rst-content table.field-list td:first-child,.rst-content table.field-list th:first-child,.wy-table td:first-child,.wy-table th:first-child{border-left-width:0}.rst-content table.docutils thead,.rst-content table.field-list thead,.wy-table thead{color:#000;text-align:left;vertical-align:bottom;white-space:nowrap}.rst-content table.docutils thead th,.rst-content table.field-list thead th,.wy-table thead th{font-weight:700;border-bottom:2px solid #e1e4e5}.rst-content table.docutils td,.rst-content table.field-list td,.wy-table td{background-color:transparent;vertical-align:middle}.rst-content table.docutils td p,.rst-content table.field-list td p,.wy-table td p{line-height:18px}.rst-content table.docutils td p:last-child,.rst-content table.field-list td p:last-child,.wy-table td p:last-child{margin-bottom:0}.rst-content table.docutils .wy-table-cell-min,.rst-content table.field-list .wy-table-cell-min,.wy-table .wy-table-cell-min{width:1%;padding-right:0}.rst-content table.docutils .wy-table-cell-min input[type=checkbox],.rst-content table.field-list .wy-table-cell-min input[type=checkbox],.wy-table .wy-table-cell-min input[type=checkbox]{margin:0}.wy-table-secondary{color:grey;font-size:90%}.wy-table-tertiary{color:grey;font-size:80%}.rst-content table.docutils:not(.field-list) tr:nth-child(2n-1) td,.wy-table-backed,.wy-table-odd td,.wy-table-striped tr:nth-child(2n-1) td{background-color:#f3f6f6}.rst-content table.docutils,.wy-table-bordered-all{border:1px solid #e1e4e5}.rst-content table.docutils td,.wy-table-bordered-all td{border-bottom:1px solid #e1e4e5;border-left:1px solid #e1e4e5}.rst-content table.docutils tbody>tr:last-child td,.wy-table-bordered-all tbody>tr:last-child td{border-bottom-width:0}.wy-table-bordered{border:1px solid #e1e4e5}.wy-table-bordered-rows td{border-bottom:1px solid #e1e4e5}.wy-table-bordered-rows tbody>tr:last-child td{border-bottom-width:0}.wy-table-horizontal td,.wy-table-horizontal th{border-width:0 0 1px;border-bottom:1px solid #e1e4e5}.wy-table-horizontal tbody>tr:last-child td{border-bottom-width:0}.wy-table-responsive{margin-bottom:24px;max-width:100%;overflow:auto}.wy-table-responsive table{margin-bottom:0!important}.wy-table-responsive table td,.wy-table-responsive table th{white-space:nowrap}a{color:#2980b9;text-decoration:none;cursor:pointer}a:hover{color:#3091d1}a:visited{color:#9b59b6}html{height:100%}body,html{overflow-x:hidden}body{font-family:Lato,proxima-nova,Helvetica Neue,Arial,sans-serif;font-weight:400;color:#404040;min-height:100%;background:#edf0f2}.wy-text-left{text-align:left}.wy-text-center{text-align:center}.wy-text-right{text-align:right}.wy-text-large{font-size:120%}.wy-text-normal{font-size:100%}.wy-text-small,small{font-size:80%}.wy-text-strike{text-decoration:line-through}.wy-text-warning{color:#e67e22!important}a.wy-text-warning:hover{color:#eb9950!important}.wy-text-info{color:#2980b9!important}a.wy-text-info:hover{color:#409ad5!important}.wy-text-success{color:#27ae60!important}a.wy-text-success:hover{color:#36d278!important}.wy-text-danger{color:#e74c3c!important}a.wy-text-danger:hover{color:#ed7669!important}.wy-text-neutral{color:#404040!important}a.wy-text-neutral:hover{color:#595959!important}.rst-content .toctree-wrapper>p.caption,h1,h2,h3,h4,h5,h6,legend{margin-top:0;font-weight:700;font-family:Roboto Slab,ff-tisa-web-pro,Georgia,Arial,sans-serif}p{line-height:24px;font-size:16px;margin:0 0 24px}h1{font-size:175%}.rst-content .toctree-wrapper>p.caption,h2{font-size:150%}h3{font-size:125%}h4{font-size:115%}h5{font-size:110%}h6{font-size:100%}hr{display:block;height:1px;border:0;border-top:1px solid #e1e4e5;margin:24px 0;padding:0}.rst-content code,.rst-content tt,code{white-space:nowrap;max-width:100%;background:#fff;border:1px solid #e1e4e5;font-size:75%;padding:0 5px;font-family:SFMono-Regular,Menlo,Monaco,Consolas,Liberation Mono,Courier New,Courier,monospace;color:#e74c3c;overflow-x:auto}.rst-content tt.code-large,code.code-large{font-size:90%}.rst-content .section ul,.rst-content .toctree-wrapper ul,.rst-content section ul,.wy-plain-list-disc,article ul{list-style:disc;line-height:24px;margin-bottom:24px}.rst-content .section ul li,.rst-content .toctree-wrapper ul li,.rst-content section ul li,.wy-plain-list-disc li,article ul li{list-style:disc;margin-left:24px}.rst-content .section ul li p:last-child,.rst-content .section ul li ul,.rst-content .toctree-wrapper ul li p:last-child,.rst-content .toctree-wrapper ul li ul,.rst-content section ul li p:last-child,.rst-content section ul li ul,.wy-plain-list-disc li p:last-child,.wy-plain-list-disc li ul,article ul li p:last-child,article ul li ul{margin-bottom:0}.rst-content .section ul li li,.rst-content .toctree-wrapper ul li li,.rst-content section ul li li,.wy-plain-list-disc li li,article ul li li{list-style:circle}.rst-content .section ul li li li,.rst-content .toctree-wrapper ul li li li,.rst-content section ul li li li,.wy-plain-list-disc li li li,article ul li li li{list-style:square}.rst-content .section ul li ol li,.rst-content .toctree-wrapper ul li ol li,.rst-content section ul li ol li,.wy-plain-list-disc li ol li,article ul li ol li{list-style:decimal}.rst-content .section ol,.rst-content .section ol.arabic,.rst-content .toctree-wrapper ol,.rst-content .toctree-wrapper ol.arabic,.rst-content section ol,.rst-content section ol.arabic,.wy-plain-list-decimal,article ol{list-style:decimal;line-height:24px;margin-bottom:24px}.rst-content .section ol.arabic li,.rst-content .section ol li,.rst-content .toctree-wrapper ol.arabic li,.rst-content .toctree-wrapper ol li,.rst-content section ol.arabic li,.rst-content section ol li,.wy-plain-list-decimal li,article ol li{list-style:decimal;margin-left:24px}.rst-content .section ol.arabic li ul,.rst-content .section ol li p:last-child,.rst-content .section ol li ul,.rst-content .toctree-wrapper ol.arabic li ul,.rst-content .toctree-wrapper ol li p:last-child,.rst-content .toctree-wrapper ol li ul,.rst-content section ol.arabic li ul,.rst-content section ol li p:last-child,.rst-content section ol li ul,.wy-plain-list-decimal li p:last-child,.wy-plain-list-decimal li ul,article ol li p:last-child,article ol li ul{margin-bottom:0}.rst-content .section ol.arabic li ul li,.rst-content .section ol li ul li,.rst-content .toctree-wrapper ol.arabic li ul li,.rst-content .toctree-wrapper ol li ul li,.rst-content section ol.arabic li ul li,.rst-content section ol li ul li,.wy-plain-list-decimal li ul li,article ol li ul li{list-style:disc}.wy-breadcrumbs{*zoom:1}.wy-breadcrumbs:after,.wy-breadcrumbs:before{display:table;content:""}.wy-breadcrumbs:after{clear:both}.wy-breadcrumbs>li{display:inline-block;padding-top:5px}.wy-breadcrumbs>li.wy-breadcrumbs-aside{float:right}.rst-content .wy-breadcrumbs>li code,.rst-content .wy-breadcrumbs>li tt,.wy-breadcrumbs>li .rst-content tt,.wy-breadcrumbs>li code{all:inherit;color:inherit}.breadcrumb-item:before{content:"/";color:#bbb;font-size:13px;padding:0 6px 0 3px}.wy-breadcrumbs-extra{margin-bottom:0;color:#b3b3b3;font-size:80%;display:inline-block}@media screen and (max-width:480px){.wy-breadcrumbs-extra,.wy-breadcrumbs li.wy-breadcrumbs-aside{display:none}}@media print{.wy-breadcrumbs li.wy-breadcrumbs-aside{display:none}}html{font-size:16px}.wy-affix{position:fixed;top:1.618em}.wy-menu a:hover{text-decoration:none}.wy-menu-horiz{*zoom:1}.wy-menu-horiz:after,.wy-menu-horiz:before{display:table;content:""}.wy-menu-horiz:after{clear:both}.wy-menu-horiz li,.wy-menu-horiz ul{display:inline-block}.wy-menu-horiz li:hover{background:hsla(0,0%,100%,.1)}.wy-menu-horiz li.divide-left{border-left:1px solid #404040}.wy-menu-horiz li.divide-right{border-right:1px solid #404040}.wy-menu-horiz a{height:32px;display:inline-block;line-height:32px;padding:0 16px}.wy-menu-vertical{width:300px}.wy-menu-vertical header,.wy-menu-vertical p.caption{color:#55a5d9;height:32px;line-height:32px;padding:0 1.618em;margin:12px 0 0;display:block;font-weight:700;text-transform:uppercase;font-size:85%;white-space:nowrap}.wy-menu-vertical ul{margin-bottom:0}.wy-menu-vertical li.divide-top{border-top:1px solid #404040}.wy-menu-vertical li.divide-bottom{border-bottom:1px solid #404040}.wy-menu-vertical li.current{background:#e3e3e3}.wy-menu-vertical li.current a{color:grey;border-right:1px solid #c9c9c9;padding:.4045em 2.427em}.wy-menu-vertical li.current a:hover{background:#d6d6d6}.rst-content .wy-menu-vertical li tt,.wy-menu-vertical li .rst-content tt,.wy-menu-vertical li code{border:none;background:inherit;color:inherit;padding-left:0;padding-right:0}.wy-menu-vertical li button.toctree-expand{display:block;float:left;margin-left:-1.2em;line-height:18px;color:#4d4d4d;border:none;background:none;padding:0}.wy-menu-vertical li.current>a,.wy-menu-vertical li.on a{color:#404040;font-weight:700;position:relative;background:#fcfcfc;border:none;padding:.4045em 1.618em}.wy-menu-vertical li.current>a:hover,.wy-menu-vertical li.on a:hover{background:#fcfcfc}.wy-menu-vertical li.current>a:hover button.toctree-expand,.wy-menu-vertical li.on a:hover button.toctree-expand{color:grey}.wy-menu-vertical li.current>a button.toctree-expand,.wy-menu-vertical li.on a button.toctree-expand{display:block;line-height:18px;color:#333}.wy-menu-vertical li.toctree-l1.current>a{border-bottom:1px solid #c9c9c9;border-top:1px solid #c9c9c9}.wy-menu-vertical .toctree-l1.current .toctree-l2>ul,.wy-menu-vertical .toctree-l2.current .toctree-l3>ul,.wy-menu-vertical .toctree-l3.current .toctree-l4>ul,.wy-menu-vertical .toctree-l4.current .toctree-l5>ul,.wy-menu-vertical .toctree-l5.current .toctree-l6>ul,.wy-menu-vertical .toctree-l6.current .toctree-l7>ul,.wy-menu-vertical .toctree-l7.current .toctree-l8>ul,.wy-menu-vertical .toctree-l8.current .toctree-l9>ul,.wy-menu-vertical .toctree-l9.current .toctree-l10>ul,.wy-menu-vertical .toctree-l10.current .toctree-l11>ul{display:none}.wy-menu-vertical .toctree-l1.current .current.toctree-l2>ul,.wy-menu-vertical .toctree-l2.current .current.toctree-l3>ul,.wy-menu-vertical .toctree-l3.current .current.toctree-l4>ul,.wy-menu-vertical .toctree-l4.current .current.toctree-l5>ul,.wy-menu-vertical .toctree-l5.current .current.toctree-l6>ul,.wy-menu-vertical .toctree-l6.current .current.toctree-l7>ul,.wy-menu-vertical .toctree-l7.current .current.toctree-l8>ul,.wy-menu-vertical .toctree-l8.current .current.toctree-l9>ul,.wy-menu-vertical .toctree-l9.current .current.toctree-l10>ul,.wy-menu-vertical .toctree-l10.current .current.toctree-l11>ul{display:block}.wy-menu-vertical li.toctree-l3,.wy-menu-vertical li.toctree-l4{font-size:.9em}.wy-menu-vertical li.toctree-l2 a,.wy-menu-vertical li.toctree-l3 a,.wy-menu-vertical li.toctree-l4 a,.wy-menu-vertical li.toctree-l5 a,.wy-menu-vertical li.toctree-l6 a,.wy-menu-vertical li.toctree-l7 a,.wy-menu-vertical li.toctree-l8 a,.wy-menu-vertical li.toctree-l9 a,.wy-menu-vertical li.toctree-l10 a{color:#404040}.wy-menu-vertical li.toctree-l2 a:hover button.toctree-expand,.wy-menu-vertical li.toctree-l3 a:hover button.toctree-expand,.wy-menu-vertical li.toctree-l4 a:hover button.toctree-expand,.wy-menu-vertical li.toctree-l5 a:hover button.toctree-expand,.wy-menu-vertical li.toctree-l6 a:hover button.toctree-expand,.wy-menu-vertical li.toctree-l7 a:hover button.toctree-expand,.wy-menu-vertical li.toctree-l8 a:hover button.toctree-expand,.wy-menu-vertical li.toctree-l9 a:hover button.toctree-expand,.wy-menu-vertical li.toctree-l10 a:hover button.toctree-expand{color:grey}.wy-menu-vertical li.toctree-l2.current li.toctree-l3>a,.wy-menu-vertical li.toctree-l3.current li.toctree-l4>a,.wy-menu-vertical li.toctree-l4.current li.toctree-l5>a,.wy-menu-vertical li.toctree-l5.current li.toctree-l6>a,.wy-menu-vertical li.toctree-l6.current li.toctree-l7>a,.wy-menu-vertical li.toctree-l7.current li.toctree-l8>a,.wy-menu-vertical li.toctree-l8.current li.toctree-l9>a,.wy-menu-vertical li.toctree-l9.current li.toctree-l10>a,.wy-menu-vertical li.toctree-l10.current li.toctree-l11>a{display:block}.wy-menu-vertical li.toctree-l2.current>a{padding:.4045em 2.427em}.wy-menu-vertical li.toctree-l2.current li.toctree-l3>a{padding:.4045em 1.618em .4045em 4.045em}.wy-menu-vertical li.toctree-l3.current>a{padding:.4045em 4.045em}.wy-menu-vertical li.toctree-l3.current li.toctree-l4>a{padding:.4045em 1.618em .4045em 5.663em}.wy-menu-vertical li.toctree-l4.current>a{padding:.4045em 5.663em}.wy-menu-vertical li.toctree-l4.current li.toctree-l5>a{padding:.4045em 1.618em .4045em 7.281em}.wy-menu-vertical li.toctree-l5.current>a{padding:.4045em 7.281em}.wy-menu-vertical li.toctree-l5.current li.toctree-l6>a{padding:.4045em 1.618em .4045em 8.899em}.wy-menu-vertical li.toctree-l6.current>a{padding:.4045em 8.899em}.wy-menu-vertical li.toctree-l6.current li.toctree-l7>a{padding:.4045em 1.618em .4045em 10.517em}.wy-menu-vertical li.toctree-l7.current>a{padding:.4045em 10.517em}.wy-menu-vertical li.toctree-l7.current li.toctree-l8>a{padding:.4045em 1.618em .4045em 12.135em}.wy-menu-vertical li.toctree-l8.current>a{padding:.4045em 12.135em}.wy-menu-vertical li.toctree-l8.current li.toctree-l9>a{padding:.4045em 1.618em .4045em 13.753em}.wy-menu-vertical li.toctree-l9.current>a{padding:.4045em 13.753em}.wy-menu-vertical li.toctree-l9.current li.toctree-l10>a{padding:.4045em 1.618em .4045em 15.371em}.wy-menu-vertical li.toctree-l10.current>a{padding:.4045em 15.371em}.wy-menu-vertical li.toctree-l10.current li.toctree-l11>a{padding:.4045em 1.618em .4045em 16.989em}.wy-menu-vertical li.toctree-l2.current>a,.wy-menu-vertical li.toctree-l2.current li.toctree-l3>a{background:#c9c9c9}.wy-menu-vertical li.toctree-l2 button.toctree-expand{color:#a3a3a3}.wy-menu-vertical li.toctree-l3.current>a,.wy-menu-vertical li.toctree-l3.current li.toctree-l4>a{background:#bdbdbd}.wy-menu-vertical li.toctree-l3 button.toctree-expand{color:#969696}.wy-menu-vertical li.current ul{display:block}.wy-menu-vertical li ul{margin-bottom:0;display:none}.wy-menu-vertical li ul li a{margin-bottom:0;color:#d9d9d9;font-weight:400}.wy-menu-vertical a{line-height:18px;padding:.4045em 1.618em;display:block;position:relative;font-size:90%;color:#d9d9d9}.wy-menu-vertical a:hover{background-color:#4e4a4a;cursor:pointer}.wy-menu-vertical a:hover button.toctree-expand{color:#d9d9d9}.wy-menu-vertical a:active{background-color:#2980b9;cursor:pointer;color:#fff}.wy-menu-vertical a:active button.toctree-expand{color:#fff}.wy-side-nav-search{display:block;width:300px;padding:.809em;margin-bottom:.809em;z-index:200;background-color:#2980b9;text-align:center;color:#fcfcfc}.wy-side-nav-search input[type=text]{width:100%;border-radius:50px;padding:6px 12px;border-color:#2472a4}.wy-side-nav-search img{display:block;margin:auto auto .809em;height:45px;width:45px;background-color:#2980b9;padding:5px;border-radius:100%}.wy-side-nav-search .wy-dropdown>a,.wy-side-nav-search>a{color:#fcfcfc;font-size:100%;font-weight:700;display:inline-block;padding:4px 6px;margin-bottom:.809em;max-width:100%}.wy-side-nav-search .wy-dropdown>a:hover,.wy-side-nav-search>a:hover{background:hsla(0,0%,100%,.1)}.wy-side-nav-search .wy-dropdown>a img.logo,.wy-side-nav-search>a img.logo{display:block;margin:0 auto;height:auto;width:auto;border-radius:0;max-width:100%;background:transparent}.wy-side-nav-search .wy-dropdown>a.icon img.logo,.wy-side-nav-search>a.icon img.logo{margin-top:.85em}.wy-side-nav-search>div.version{margin-top:-.4045em;margin-bottom:.809em;font-weight:400;color:hsla(0,0%,100%,.3)}.wy-nav .wy-menu-vertical header{color:#2980b9}.wy-nav .wy-menu-vertical a{color:#b3b3b3}.wy-nav .wy-menu-vertical a:hover{background-color:#2980b9;color:#fff}[data-menu-wrap]{-webkit-transition:all .2s ease-in;-moz-transition:all .2s ease-in;transition:all .2s ease-in;position:absolute;opacity:1;width:100%;opacity:0}[data-menu-wrap].move-center{left:0;right:auto;opacity:1}[data-menu-wrap].move-left{right:auto;left:-100%;opacity:0}[data-menu-wrap].move-right{right:-100%;left:auto;opacity:0}.wy-body-for-nav{background:#fcfcfc}.wy-grid-for-nav{position:absolute;width:100%;height:100%}.wy-nav-side{position:fixed;top:0;bottom:0;left:0;padding-bottom:2em;width:300px;overflow-x:hidden;overflow-y:hidden;min-height:100%;color:#9b9b9b;background:#343131;z-index:200}.wy-side-scroll{width:320px;position:relative;overflow-x:hidden;overflow-y:scroll;height:100%}.wy-nav-top{display:none;background:#2980b9;color:#fff;padding:.4045em .809em;position:relative;line-height:50px;text-align:center;font-size:100%;*zoom:1}.wy-nav-top:after,.wy-nav-top:before{display:table;content:""}.wy-nav-top:after{clear:both}.wy-nav-top a{color:#fff;font-weight:700}.wy-nav-top img{margin-right:12px;height:45px;width:45px;background-color:#2980b9;padding:5px;border-radius:100%}.wy-nav-top i{font-size:30px;float:left;cursor:pointer;padding-top:inherit}.wy-nav-content-wrap{margin-left:300px;background:#fcfcfc;min-height:100%}.wy-nav-content{padding:1.618em 3.236em;height:100%;max-width:800px;margin:auto}.wy-body-mask{position:fixed;width:100%;height:100%;background:rgba(0,0,0,.2);display:none;z-index:499}.wy-body-mask.on{display:block}footer{color:grey}footer p{margin-bottom:12px}.rst-content footer span.commit tt,footer span.commit .rst-content tt,footer span.commit code{padding:0;font-family:SFMono-Regular,Menlo,Monaco,Consolas,Liberation Mono,Courier New,Courier,monospace;font-size:1em;background:none;border:none;color:grey}.rst-footer-buttons{*zoom:1}.rst-footer-buttons:after,.rst-footer-buttons:before{width:100%;display:table;content:""}.rst-footer-buttons:after{clear:both}.rst-breadcrumbs-buttons{margin-top:12px;*zoom:1}.rst-breadcrumbs-buttons:after,.rst-breadcrumbs-buttons:before{display:table;content:""}.rst-breadcrumbs-buttons:after{clear:both}#search-results .search li{margin-bottom:24px;border-bottom:1px solid #e1e4e5;padding-bottom:24px}#search-results .search li:first-child{border-top:1px solid #e1e4e5;padding-top:24px}#search-results .search li a{font-size:120%;margin-bottom:12px;display:inline-block}#search-results .context{color:grey;font-size:90%}.genindextable li>ul{margin-left:24px}@media screen and (max-width:768px){.wy-body-for-nav{background:#fcfcfc}.wy-nav-top{display:block}.wy-nav-side{left:-300px}.wy-nav-side.shift{width:85%;left:0}.wy-menu.wy-menu-vertical,.wy-side-nav-search,.wy-side-scroll{width:auto}.wy-nav-content-wrap{margin-left:0}.wy-nav-content-wrap .wy-nav-content{padding:1.618em}.wy-nav-content-wrap.shift{position:fixed;min-width:100%;left:85%;top:0;height:100%;overflow:hidden}}@media screen and (min-width:1100px){.wy-nav-content-wrap{background:rgba(0,0,0,.05)}.wy-nav-content{margin:0;background:#fcfcfc}}@media print{.rst-versions,.wy-nav-side,footer{display:none}.wy-nav-content-wrap{margin-left:0}}.rst-versions{position:fixed;bottom:0;left:0;width:300px;color:#fcfcfc;background:#1f1d1d;font-family:Lato,proxima-nova,Helvetica Neue,Arial,sans-serif;z-index:400}.rst-versions a{color:#2980b9;text-decoration:none}.rst-versions .rst-badge-small{display:none}.rst-versions .rst-current-version{padding:12px;background-color:#272525;display:block;text-align:right;font-size:90%;cursor:pointer;color:#27ae60;*zoom:1}.rst-versions .rst-current-version:after,.rst-versions .rst-current-version:before{display:table;content:""}.rst-versions .rst-current-version:after{clear:both}.rst-content .code-block-caption .rst-versions .rst-current-version .headerlink,.rst-content .eqno .rst-versions .rst-current-version .headerlink,.rst-content .rst-versions .rst-current-version .admonition-title,.rst-content code.download .rst-versions .rst-current-version span:first-child,.rst-content dl dt .rst-versions .rst-current-version .headerlink,.rst-content h1 .rst-versions .rst-current-version .headerlink,.rst-content h2 .rst-versions .rst-current-version .headerlink,.rst-content h3 .rst-versions .rst-current-version .headerlink,.rst-content h4 .rst-versions .rst-current-version .headerlink,.rst-content h5 .rst-versions .rst-current-version .headerlink,.rst-content h6 .rst-versions .rst-current-version .headerlink,.rst-content p .rst-versions .rst-current-version .headerlink,.rst-content table>caption .rst-versions .rst-current-version .headerlink,.rst-content tt.download .rst-versions .rst-current-version span:first-child,.rst-versions .rst-current-version .fa,.rst-versions .rst-current-version .icon,.rst-versions .rst-current-version .rst-content .admonition-title,.rst-versions .rst-current-version .rst-content .code-block-caption .headerlink,.rst-versions .rst-current-version .rst-content .eqno .headerlink,.rst-versions .rst-current-version .rst-content code.download span:first-child,.rst-versions .rst-current-version .rst-content dl dt .headerlink,.rst-versions .rst-current-version .rst-content h1 .headerlink,.rst-versions .rst-current-version .rst-content h2 .headerlink,.rst-versions .rst-current-version .rst-content h3 .headerlink,.rst-versions .rst-current-version .rst-content h4 .headerlink,.rst-versions .rst-current-version .rst-content h5 .headerlink,.rst-versions .rst-current-version .rst-content h6 .headerlink,.rst-versions .rst-current-version .rst-content p .headerlink,.rst-versions .rst-current-version .rst-content table>caption .headerlink,.rst-versions .rst-current-version .rst-content tt.download span:first-child,.rst-versions .rst-current-version .wy-menu-vertical li button.toctree-expand,.wy-menu-vertical li .rst-versions .rst-current-version button.toctree-expand{color:#fcfcfc}.rst-versions .rst-current-version .fa-book,.rst-versions .rst-current-version .icon-book{float:left}.rst-versions .rst-current-version.rst-out-of-date{background-color:#e74c3c;color:#fff}.rst-versions .rst-current-version.rst-active-old-version{background-color:#f1c40f;color:#000}.rst-versions.shift-up{height:auto;max-height:100%;overflow-y:scroll}.rst-versions.shift-up .rst-other-versions{display:block}.rst-versions .rst-other-versions{font-size:90%;padding:12px;color:grey;display:none}.rst-versions .rst-other-versions hr{display:block;height:1px;border:0;margin:20px 0;padding:0;border-top:1px solid #413d3d}.rst-versions .rst-other-versions dd{display:inline-block;margin:0}.rst-versions .rst-other-versions dd a{display:inline-block;padding:6px;color:#fcfcfc}.rst-versions.rst-badge{width:auto;bottom:20px;right:20px;left:auto;border:none;max-width:300px;max-height:90%}.rst-versions.rst-badge .fa-book,.rst-versions.rst-badge .icon-book{float:none;line-height:30px}.rst-versions.rst-badge.shift-up .rst-current-version{text-align:right}.rst-versions.rst-badge.shift-up .rst-current-version .fa-book,.rst-versions.rst-badge.shift-up .rst-current-version .icon-book{float:left}.rst-versions.rst-badge>.rst-current-version{width:auto;height:30px;line-height:30px;padding:0 6px;display:block;text-align:center}@media screen and (max-width:768px){.rst-versions{width:85%;display:none}.rst-versions.shift{display:block}}.rst-content .toctree-wrapper>p.caption,.rst-content h1,.rst-content h2,.rst-content h3,.rst-content h4,.rst-content h5,.rst-content h6{margin-bottom:24px}.rst-content img{max-width:100%;height:auto}.rst-content div.figure,.rst-content figure{margin-bottom:24px}.rst-content div.figure .caption-text,.rst-content figure .caption-text{font-style:italic}.rst-content div.figure p:last-child.caption,.rst-content figure p:last-child.caption{margin-bottom:0}.rst-content div.figure.align-center,.rst-content figure.align-center{text-align:center}.rst-content .section>a>img,.rst-content .section>img,.rst-content section>a>img,.rst-content section>img{margin-bottom:24px}.rst-content abbr[title]{text-decoration:none}.rst-content.style-external-links a.reference.external:after{font-family:FontAwesome;content:"\f08e";color:#b3b3b3;vertical-align:super;font-size:60%;margin:0 .2em}.rst-content blockquote{margin-left:24px;line-height:24px;margin-bottom:24px}.rst-content pre.literal-block{white-space:pre;margin:0;padding:12px;font-family:SFMono-Regular,Menlo,Monaco,Consolas,Liberation Mono,Courier New,Courier,monospace;display:block;overflow:auto}.rst-content div[class^=highlight],.rst-content pre.literal-block{border:1px solid #e1e4e5;overflow-x:auto;margin:1px 0 24px}.rst-content div[class^=highlight] div[class^=highlight],.rst-content pre.literal-block div[class^=highlight]{padding:0;border:none;margin:0}.rst-content div[class^=highlight] td.code{width:100%}.rst-content .linenodiv pre{border-right:1px solid #e6e9ea;margin:0;padding:12px;font-family:SFMono-Regular,Menlo,Monaco,Consolas,Liberation Mono,Courier New,Courier,monospace;user-select:none;pointer-events:none}.rst-content div[class^=highlight] pre{white-space:pre;margin:0;padding:12px;display:block;overflow:auto}.rst-content div[class^=highlight] pre .hll{display:block;margin:0 -12px;padding:0 12px}.rst-content .linenodiv pre,.rst-content div[class^=highlight] pre,.rst-content pre.literal-block{font-family:SFMono-Regular,Menlo,Monaco,Consolas,Liberation Mono,Courier New,Courier,monospace;font-size:12px;line-height:1.4}.rst-content div.highlight .gp,.rst-content div.highlight span.linenos{user-select:none;pointer-events:none}.rst-content div.highlight span.linenos{display:inline-block;padding-left:0;padding-right:12px;margin-right:12px;border-right:1px solid #e6e9ea}.rst-content .code-block-caption{font-style:italic;font-size:85%;line-height:1;padding:1em 0;text-align:center}@media print{.rst-content .codeblock,.rst-content div[class^=highlight],.rst-content div[class^=highlight] pre{white-space:pre-wrap}}.rst-content .admonition,.rst-content .admonition-todo,.rst-content .attention,.rst-content .caution,.rst-content .danger,.rst-content .error,.rst-content .hint,.rst-content .important,.rst-content .note,.rst-content .seealso,.rst-content .tip,.rst-content .warning{clear:both}.rst-content .admonition-todo .last,.rst-content .admonition-todo>:last-child,.rst-content .admonition .last,.rst-content .admonition>:last-child,.rst-content .attention .last,.rst-content .attention>:last-child,.rst-content .caution .last,.rst-content .caution>:last-child,.rst-content .danger .last,.rst-content .danger>:last-child,.rst-content .error .last,.rst-content .error>:last-child,.rst-content .hint .last,.rst-content .hint>:last-child,.rst-content .important .last,.rst-content .important>:last-child,.rst-content .note .last,.rst-content .note>:last-child,.rst-content .seealso .last,.rst-content .seealso>:last-child,.rst-content .tip .last,.rst-content .tip>:last-child,.rst-content .warning .last,.rst-content .warning>:last-child{margin-bottom:0}.rst-content .admonition-title:before{margin-right:4px}.rst-content .admonition table{border-color:rgba(0,0,0,.1)}.rst-content .admonition table td,.rst-content .admonition table th{background:transparent!important;border-color:rgba(0,0,0,.1)!important}.rst-content .section ol.loweralpha,.rst-content .section ol.loweralpha>li,.rst-content .toctree-wrapper ol.loweralpha,.rst-content .toctree-wrapper ol.loweralpha>li,.rst-content section ol.loweralpha,.rst-content section ol.loweralpha>li{list-style:lower-alpha}.rst-content .section ol.upperalpha,.rst-content .section ol.upperalpha>li,.rst-content .toctree-wrapper ol.upperalpha,.rst-content .toctree-wrapper ol.upperalpha>li,.rst-content section ol.upperalpha,.rst-content section ol.upperalpha>li{list-style:upper-alpha}.rst-content .section ol li>*,.rst-content .section ul li>*,.rst-content .toctree-wrapper ol li>*,.rst-content .toctree-wrapper ul li>*,.rst-content section ol li>*,.rst-content section ul li>*{margin-top:12px;margin-bottom:12px}.rst-content .section ol li>:first-child,.rst-content .section ul li>:first-child,.rst-content .toctree-wrapper ol li>:first-child,.rst-content .toctree-wrapper ul li>:first-child,.rst-content section ol li>:first-child,.rst-content section ul li>:first-child{margin-top:0}.rst-content .section ol li>p,.rst-content .section ol li>p:last-child,.rst-content .section ul li>p,.rst-content .section ul li>p:last-child,.rst-content .toctree-wrapper ol li>p,.rst-content .toctree-wrapper ol li>p:last-child,.rst-content .toctree-wrapper ul li>p,.rst-content .toctree-wrapper ul li>p:last-child,.rst-content section ol li>p,.rst-content section ol li>p:last-child,.rst-content section ul li>p,.rst-content section ul li>p:last-child{margin-bottom:12px}.rst-content .section ol li>p:only-child,.rst-content .section ol li>p:only-child:last-child,.rst-content .section ul li>p:only-child,.rst-content .section ul li>p:only-child:last-child,.rst-content .toctree-wrapper ol li>p:only-child,.rst-content .toctree-wrapper ol li>p:only-child:last-child,.rst-content .toctree-wrapper ul li>p:only-child,.rst-content .toctree-wrapper ul li>p:only-child:last-child,.rst-content section ol li>p:only-child,.rst-content section ol li>p:only-child:last-child,.rst-content section ul li>p:only-child,.rst-content section ul li>p:only-child:last-child{margin-bottom:0}.rst-content .section ol li>ol,.rst-content .section ol li>ul,.rst-content .section ul li>ol,.rst-content .section ul li>ul,.rst-content .toctree-wrapper ol li>ol,.rst-content .toctree-wrapper ol li>ul,.rst-content .toctree-wrapper ul li>ol,.rst-content .toctree-wrapper ul li>ul,.rst-content section ol li>ol,.rst-content section ol li>ul,.rst-content section ul li>ol,.rst-content section ul li>ul{margin-bottom:12px}.rst-content .section ol.simple li>*,.rst-content .section ol.simple li ol,.rst-content .section ol.simple li ul,.rst-content .section ul.simple li>*,.rst-content .section ul.simple li ol,.rst-content .section ul.simple li ul,.rst-content .toctree-wrapper ol.simple li>*,.rst-content .toctree-wrapper ol.simple li ol,.rst-content .toctree-wrapper ol.simple li ul,.rst-content .toctree-wrapper ul.simple li>*,.rst-content .toctree-wrapper ul.simple li ol,.rst-content .toctree-wrapper ul.simple li ul,.rst-content section ol.simple li>*,.rst-content section ol.simple li ol,.rst-content section ol.simple li ul,.rst-content section ul.simple li>*,.rst-content section ul.simple li ol,.rst-content section ul.simple li ul{margin-top:0;margin-bottom:0}.rst-content .line-block{margin-left:0;margin-bottom:24px;line-height:24px}.rst-content .line-block .line-block{margin-left:24px;margin-bottom:0}.rst-content .topic-title{font-weight:700;margin-bottom:12px}.rst-content .toc-backref{color:#404040}.rst-content .align-right{float:right;margin:0 0 24px 24px}.rst-content .align-left{float:left;margin:0 24px 24px 0}.rst-content .align-center{margin:auto}.rst-content .align-center:not(table){display:block}.rst-content .code-block-caption .headerlink,.rst-content .eqno .headerlink,.rst-content .toctree-wrapper>p.caption .headerlink,.rst-content dl dt .headerlink,.rst-content h1 .headerlink,.rst-content h2 .headerlink,.rst-content h3 .headerlink,.rst-content h4 .headerlink,.rst-content h5 .headerlink,.rst-content h6 .headerlink,.rst-content p.caption .headerlink,.rst-content p .headerlink,.rst-content table>caption .headerlink{opacity:0;font-size:14px;font-family:FontAwesome;margin-left:.5em}.rst-content .code-block-caption .headerlink:focus,.rst-content .code-block-caption:hover .headerlink,.rst-content .eqno .headerlink:focus,.rst-content .eqno:hover .headerlink,.rst-content .toctree-wrapper>p.caption .headerlink:focus,.rst-content .toctree-wrapper>p.caption:hover .headerlink,.rst-content dl dt .headerlink:focus,.rst-content dl dt:hover .headerlink,.rst-content h1 .headerlink:focus,.rst-content h1:hover .headerlink,.rst-content h2 .headerlink:focus,.rst-content h2:hover .headerlink,.rst-content h3 .headerlink:focus,.rst-content h3:hover .headerlink,.rst-content h4 .headerlink:focus,.rst-content h4:hover .headerlink,.rst-content h5 .headerlink:focus,.rst-content h5:hover .headerlink,.rst-content h6 .headerlink:focus,.rst-content h6:hover .headerlink,.rst-content p.caption .headerlink:focus,.rst-content p.caption:hover .headerlink,.rst-content p .headerlink:focus,.rst-content p:hover .headerlink,.rst-content table>caption .headerlink:focus,.rst-content table>caption:hover .headerlink{opacity:1}.rst-content p a{overflow-wrap:anywhere}.rst-content .wy-table td p,.rst-content .wy-table td ul,.rst-content .wy-table th p,.rst-content .wy-table th ul,.rst-content table.docutils td p,.rst-content table.docutils td ul,.rst-content table.docutils th p,.rst-content table.docutils th ul,.rst-content table.field-list td p,.rst-content table.field-list td ul,.rst-content table.field-list th p,.rst-content table.field-list th ul{font-size:inherit}.rst-content .btn:focus{outline:2px solid}.rst-content table>caption .headerlink:after{font-size:12px}.rst-content .centered{text-align:center}.rst-content .sidebar{float:right;width:40%;display:block;margin:0 0 24px 24px;padding:24px;background:#f3f6f6;border:1px solid #e1e4e5}.rst-content .sidebar dl,.rst-content .sidebar p,.rst-content .sidebar ul{font-size:90%}.rst-content .sidebar .last,.rst-content .sidebar>:last-child{margin-bottom:0}.rst-content .sidebar .sidebar-title{display:block;font-family:Roboto Slab,ff-tisa-web-pro,Georgia,Arial,sans-serif;font-weight:700;background:#e1e4e5;padding:6px 12px;margin:-24px -24px 24px;font-size:100%}.rst-content .highlighted{background:#f1c40f;box-shadow:0 0 0 2px #f1c40f;display:inline;font-weight:700}.rst-content .citation-reference,.rst-content .footnote-reference{vertical-align:baseline;position:relative;top:-.4em;line-height:0;font-size:90%}.rst-content .citation-reference>span.fn-bracket,.rst-content .footnote-reference>span.fn-bracket{display:none}.rst-content .hlist{width:100%}.rst-content dl dt span.classifier:before{content:" : "}.rst-content dl dt span.classifier-delimiter{display:none!important}html.writer-html4 .rst-content table.docutils.citation,html.writer-html4 .rst-content table.docutils.footnote{background:none;border:none}html.writer-html4 .rst-content table.docutils.citation td,html.writer-html4 .rst-content table.docutils.citation tr,html.writer-html4 .rst-content table.docutils.footnote td,html.writer-html4 .rst-content table.docutils.footnote tr{border:none;background-color:transparent!important;white-space:normal}html.writer-html4 .rst-content table.docutils.citation td.label,html.writer-html4 .rst-content table.docutils.footnote td.label{padding-left:0;padding-right:0;vertical-align:top}html.writer-html5 .rst-content dl.citation,html.writer-html5 .rst-content dl.field-list,html.writer-html5 .rst-content dl.footnote{display:grid;grid-template-columns:auto minmax(80%,95%)}html.writer-html5 .rst-content dl.citation>dt,html.writer-html5 .rst-content dl.field-list>dt,html.writer-html5 .rst-content dl.footnote>dt{display:inline-grid;grid-template-columns:max-content auto}html.writer-html5 .rst-content aside.citation,html.writer-html5 .rst-content aside.footnote,html.writer-html5 .rst-content div.citation{display:grid;grid-template-columns:auto auto minmax(.65rem,auto) minmax(40%,95%)}html.writer-html5 .rst-content aside.citation>span.label,html.writer-html5 .rst-content aside.footnote>span.label,html.writer-html5 .rst-content div.citation>span.label{grid-column-start:1;grid-column-end:2}html.writer-html5 .rst-content aside.citation>span.backrefs,html.writer-html5 .rst-content aside.footnote>span.backrefs,html.writer-html5 .rst-content div.citation>span.backrefs{grid-column-start:2;grid-column-end:3;grid-row-start:1;grid-row-end:3}html.writer-html5 .rst-content aside.citation>p,html.writer-html5 .rst-content aside.footnote>p,html.writer-html5 .rst-content div.citation>p{grid-column-start:4;grid-column-end:5}html.writer-html5 .rst-content dl.citation,html.writer-html5 .rst-content dl.field-list,html.writer-html5 .rst-content dl.footnote{margin-bottom:24px}html.writer-html5 .rst-content dl.citation>dt,html.writer-html5 .rst-content dl.field-list>dt,html.writer-html5 .rst-content dl.footnote>dt{padding-left:1rem}html.writer-html5 .rst-content dl.citation>dd,html.writer-html5 .rst-content dl.citation>dt,html.writer-html5 .rst-content dl.field-list>dd,html.writer-html5 .rst-content dl.field-list>dt,html.writer-html5 .rst-content dl.footnote>dd,html.writer-html5 .rst-content dl.footnote>dt{margin-bottom:0}html.writer-html5 .rst-content dl.citation,html.writer-html5 .rst-content dl.footnote{font-size:.9rem}html.writer-html5 .rst-content dl.citation>dt,html.writer-html5 .rst-content dl.footnote>dt{margin:0 .5rem .5rem 0;line-height:1.2rem;word-break:break-all;font-weight:400}html.writer-html5 .rst-content dl.citation>dt>span.brackets:before,html.writer-html5 .rst-content dl.footnote>dt>span.brackets:before{content:"["}html.writer-html5 .rst-content dl.citation>dt>span.brackets:after,html.writer-html5 .rst-content dl.footnote>dt>span.brackets:after{content:"]"}html.writer-html5 .rst-content dl.citation>dt>span.fn-backref,html.writer-html5 .rst-content dl.footnote>dt>span.fn-backref{text-align:left;font-style:italic;margin-left:.65rem;word-break:break-word;word-spacing:-.1rem;max-width:5rem}html.writer-html5 .rst-content dl.citation>dt>span.fn-backref>a,html.writer-html5 .rst-content dl.footnote>dt>span.fn-backref>a{word-break:keep-all}html.writer-html5 .rst-content dl.citation>dt>span.fn-backref>a:not(:first-child):before,html.writer-html5 .rst-content dl.footnote>dt>span.fn-backref>a:not(:first-child):before{content:" "}html.writer-html5 .rst-content dl.citation>dd,html.writer-html5 .rst-content dl.footnote>dd{margin:0 0 .5rem;line-height:1.2rem}html.writer-html5 .rst-content dl.citation>dd p,html.writer-html5 .rst-content dl.footnote>dd p{font-size:.9rem}html.writer-html5 .rst-content aside.citation,html.writer-html5 .rst-content aside.footnote,html.writer-html5 .rst-content div.citation{padding-left:1rem;padding-right:1rem;font-size:.9rem;line-height:1.2rem}html.writer-html5 .rst-content aside.citation p,html.writer-html5 .rst-content aside.footnote p,html.writer-html5 .rst-content div.citation p{font-size:.9rem;line-height:1.2rem;margin-bottom:12px}html.writer-html5 .rst-content aside.citation span.backrefs,html.writer-html5 .rst-content aside.footnote span.backrefs,html.writer-html5 .rst-content div.citation span.backrefs{text-align:left;font-style:italic;margin-left:.65rem;word-break:break-word;word-spacing:-.1rem;max-width:5rem}html.writer-html5 .rst-content aside.citation span.backrefs>a,html.writer-html5 .rst-content aside.footnote span.backrefs>a,html.writer-html5 .rst-content div.citation span.backrefs>a{word-break:keep-all}html.writer-html5 .rst-content aside.citation span.backrefs>a:not(:first-child):before,html.writer-html5 .rst-content aside.footnote span.backrefs>a:not(:first-child):before,html.writer-html5 .rst-content div.citation span.backrefs>a:not(:first-child):before{content:" "}html.writer-html5 .rst-content aside.citation span.label,html.writer-html5 .rst-content aside.footnote span.label,html.writer-html5 .rst-content div.citation span.label{line-height:1.2rem}html.writer-html5 .rst-content aside.citation-list,html.writer-html5 .rst-content aside.footnote-list,html.writer-html5 .rst-content div.citation-list{margin-bottom:24px}html.writer-html5 .rst-content dl.option-list kbd{font-size:.9rem}.rst-content table.docutils.footnote,html.writer-html4 .rst-content table.docutils.citation,html.writer-html5 .rst-content aside.footnote,html.writer-html5 .rst-content aside.footnote-list aside.footnote,html.writer-html5 .rst-content div.citation-list>div.citation,html.writer-html5 .rst-content dl.citation,html.writer-html5 .rst-content dl.footnote{color:grey}.rst-content table.docutils.footnote code,.rst-content table.docutils.footnote tt,html.writer-html4 .rst-content table.docutils.citation code,html.writer-html4 .rst-content table.docutils.citation tt,html.writer-html5 .rst-content aside.footnote-list aside.footnote code,html.writer-html5 .rst-content aside.footnote-list aside.footnote tt,html.writer-html5 .rst-content aside.footnote code,html.writer-html5 .rst-content aside.footnote tt,html.writer-html5 .rst-content div.citation-list>div.citation code,html.writer-html5 .rst-content div.citation-list>div.citation tt,html.writer-html5 .rst-content dl.citation code,html.writer-html5 .rst-content dl.citation tt,html.writer-html5 .rst-content dl.footnote code,html.writer-html5 .rst-content dl.footnote tt{color:#555}.rst-content .wy-table-responsive.citation,.rst-content .wy-table-responsive.footnote{margin-bottom:0}.rst-content .wy-table-responsive.citation+:not(.citation),.rst-content .wy-table-responsive.footnote+:not(.footnote){margin-top:24px}.rst-content .wy-table-responsive.citation:last-child,.rst-content .wy-table-responsive.footnote:last-child{margin-bottom:24px}.rst-content table.docutils th{border-color:#e1e4e5}html.writer-html5 .rst-content table.docutils th{border:1px solid #e1e4e5}html.writer-html5 .rst-content table.docutils td>p,html.writer-html5 .rst-content table.docutils th>p{line-height:1rem;margin-bottom:0;font-size:.9rem}.rst-content table.docutils td .last,.rst-content table.docutils td .last>:last-child{margin-bottom:0}.rst-content table.field-list,.rst-content table.field-list td{border:none}.rst-content table.field-list td p{line-height:inherit}.rst-content table.field-list td>strong{display:inline-block}.rst-content table.field-list .field-name{padding-right:10px;text-align:left;white-space:nowrap}.rst-content table.field-list .field-body{text-align:left}.rst-content code,.rst-content tt{color:#000;font-family:SFMono-Regular,Menlo,Monaco,Consolas,Liberation Mono,Courier New,Courier,monospace;padding:2px 5px}.rst-content code big,.rst-content code em,.rst-content tt big,.rst-content tt em{font-size:100%!important;line-height:normal}.rst-content code.literal,.rst-content tt.literal{color:#e74c3c;white-space:normal}.rst-content code.xref,.rst-content tt.xref,a .rst-content code,a .rst-content tt{font-weight:700;color:#404040;overflow-wrap:normal}.rst-content kbd,.rst-content pre,.rst-content samp{font-family:SFMono-Regular,Menlo,Monaco,Consolas,Liberation Mono,Courier New,Courier,monospace}.rst-content a code,.rst-content a tt{color:#2980b9}.rst-content dl{margin-bottom:24px}.rst-content dl dt{font-weight:700;margin-bottom:12px}.rst-content dl ol,.rst-content dl p,.rst-content dl table,.rst-content dl ul{margin-bottom:12px}.rst-content dl dd{margin:0 0 12px 24px;line-height:24px}.rst-content dl dd>ol:last-child,.rst-content dl dd>p:last-child,.rst-content dl dd>table:last-child,.rst-content dl dd>ul:last-child{margin-bottom:0}html.writer-html4 .rst-content dl:not(.docutils),html.writer-html5 .rst-content dl[class]:not(.option-list):not(.field-list):not(.footnote):not(.citation):not(.glossary):not(.simple){margin-bottom:24px}html.writer-html4 .rst-content dl:not(.docutils)>dt,html.writer-html5 .rst-content dl[class]:not(.option-list):not(.field-list):not(.footnote):not(.citation):not(.glossary):not(.simple)>dt{display:table;margin:6px 0;font-size:90%;line-height:normal;background:#e7f2fa;color:#2980b9;border-top:3px solid #6ab0de;padding:6px;position:relative}html.writer-html4 .rst-content dl:not(.docutils)>dt:before,html.writer-html5 .rst-content dl[class]:not(.option-list):not(.field-list):not(.footnote):not(.citation):not(.glossary):not(.simple)>dt:before{color:#6ab0de}html.writer-html4 .rst-content dl:not(.docutils)>dt .headerlink,html.writer-html5 .rst-content dl[class]:not(.option-list):not(.field-list):not(.footnote):not(.citation):not(.glossary):not(.simple)>dt .headerlink{color:#404040;font-size:100%!important}html.writer-html4 .rst-content dl:not(.docutils) dl:not(.option-list):not(.field-list):not(.footnote):not(.citation):not(.glossary):not(.simple)>dt,html.writer-html5 .rst-content dl[class]:not(.option-list):not(.field-list):not(.footnote):not(.citation):not(.glossary):not(.simple) dl:not(.option-list):not(.field-list):not(.footnote):not(.citation):not(.glossary):not(.simple)>dt{margin-bottom:6px;border:none;border-left:3px solid #ccc;background:#f0f0f0;color:#555}html.writer-html4 .rst-content dl:not(.docutils) dl:not(.option-list):not(.field-list):not(.footnote):not(.citation):not(.glossary):not(.simple)>dt .headerlink,html.writer-html5 .rst-content dl[class]:not(.option-list):not(.field-list):not(.footnote):not(.citation):not(.glossary):not(.simple) dl:not(.option-list):not(.field-list):not(.footnote):not(.citation):not(.glossary):not(.simple)>dt .headerlink{color:#404040;font-size:100%!important}html.writer-html4 .rst-content dl:not(.docutils)>dt:first-child,html.writer-html5 .rst-content dl[class]:not(.option-list):not(.field-list):not(.footnote):not(.citation):not(.glossary):not(.simple)>dt:first-child{margin-top:0}html.writer-html4 .rst-content dl:not(.docutils) code.descclassname,html.writer-html4 .rst-content dl:not(.docutils) code.descname,html.writer-html4 .rst-content dl:not(.docutils) tt.descclassname,html.writer-html4 .rst-content dl:not(.docutils) tt.descname,html.writer-html5 .rst-content dl[class]:not(.option-list):not(.field-list):not(.footnote):not(.citation):not(.glossary):not(.simple) code.descclassname,html.writer-html5 .rst-content dl[class]:not(.option-list):not(.field-list):not(.footnote):not(.citation):not(.glossary):not(.simple) code.descname,html.writer-html5 .rst-content dl[class]:not(.option-list):not(.field-list):not(.footnote):not(.citation):not(.glossary):not(.simple) tt.descclassname,html.writer-html5 .rst-content dl[class]:not(.option-list):not(.field-list):not(.footnote):not(.citation):not(.glossary):not(.simple) tt.descname{background-color:transparent;border:none;padding:0;font-size:100%!important}html.writer-html4 .rst-content dl:not(.docutils) code.descname,html.writer-html4 .rst-content dl:not(.docutils) tt.descname,html.writer-html5 .rst-content dl[class]:not(.option-list):not(.field-list):not(.footnote):not(.citation):not(.glossary):not(.simple) code.descname,html.writer-html5 .rst-content dl[class]:not(.option-list):not(.field-list):not(.footnote):not(.citation):not(.glossary):not(.simple) tt.descname{font-weight:700}html.writer-html4 .rst-content dl:not(.docutils) .optional,html.writer-html5 .rst-content dl[class]:not(.option-list):not(.field-list):not(.footnote):not(.citation):not(.glossary):not(.simple) .optional{display:inline-block;padding:0 4px;color:#000;font-weight:700}html.writer-html4 .rst-content dl:not(.docutils) .property,html.writer-html5 .rst-content dl[class]:not(.option-list):not(.field-list):not(.footnote):not(.citation):not(.glossary):not(.simple) .property{display:inline-block;padding-right:8px;max-width:100%}html.writer-html4 .rst-content dl:not(.docutils) .k,html.writer-html5 .rst-content dl[class]:not(.option-list):not(.field-list):not(.footnote):not(.citation):not(.glossary):not(.simple) .k{font-style:italic}html.writer-html4 .rst-content dl:not(.docutils) .descclassname,html.writer-html4 .rst-content dl:not(.docutils) .descname,html.writer-html4 .rst-content dl:not(.docutils) .sig-name,html.writer-html5 .rst-content dl[class]:not(.option-list):not(.field-list):not(.footnote):not(.citation):not(.glossary):not(.simple) .descclassname,html.writer-html5 .rst-content dl[class]:not(.option-list):not(.field-list):not(.footnote):not(.citation):not(.glossary):not(.simple) .descname,html.writer-html5 .rst-content dl[class]:not(.option-list):not(.field-list):not(.footnote):not(.citation):not(.glossary):not(.simple) .sig-name{font-family:SFMono-Regular,Menlo,Monaco,Consolas,Liberation Mono,Courier New,Courier,monospace;color:#000}.rst-content .viewcode-back,.rst-content .viewcode-link{display:inline-block;color:#27ae60;font-size:80%;padding-left:24px}.rst-content .viewcode-back{display:block;float:right}.rst-content p.rubric{margin-bottom:12px;font-weight:700}.rst-content code.download,.rst-content tt.download{background:inherit;padding:inherit;font-weight:400;font-family:inherit;font-size:inherit;color:inherit;border:inherit;white-space:inherit}.rst-content code.download span:first-child,.rst-content tt.download span:first-child{-webkit-font-smoothing:subpixel-antialiased}.rst-content code.download span:first-child:before,.rst-content tt.download span:first-child:before{margin-right:4px}.rst-content .guilabel,.rst-content .menuselection{font-size:80%;font-weight:700;border-radius:4px;padding:2.4px 6px;margin:auto 2px}.rst-content .guilabel,.rst-content .menuselection{border:1px solid #7fbbe3;background:#e7f2fa}.rst-content :not(dl.option-list)>:not(dt):not(kbd):not(.kbd)>.kbd,.rst-content :not(dl.option-list)>:not(dt):not(kbd):not(.kbd)>kbd{color:inherit;font-size:80%;background-color:#fff;border:1px solid #a6a6a6;border-radius:4px;box-shadow:0 2px grey;padding:2.4px 6px;margin:auto 0}.rst-content .versionmodified{font-style:italic}@media screen and (max-width:480px){.rst-content .sidebar{width:100%}}span[id*=MathJax-Span]{color:#404040}.math{text-align:center}@font-face{font-family:Lato;src:url(fonts/lato-normal.woff2?bd03a2cc277bbbc338d464e679fe9942) format("woff2"),url(fonts/lato-normal.woff?27bd77b9162d388cb8d4c4217c7c5e2a) format("woff");font-weight:400;font-style:normal;font-display:block}@font-face{font-family:Lato;src:url(fonts/lato-bold.woff2?cccb897485813c7c256901dbca54ecf2) format("woff2"),url(fonts/lato-bold.woff?d878b6c29b10beca227e9eef4246111b) format("woff");font-weight:700;font-style:normal;font-display:block}@font-face{font-family:Lato;src:url(fonts/lato-bold-italic.woff2?0b6bb6725576b072c5d0b02ecdd1900d) format("woff2"),url(fonts/lato-bold-italic.woff?9c7e4e9eb485b4a121c760e61bc3707c) format("woff");font-weight:700;font-style:italic;font-display:block}@font-face{font-family:Lato;src:url(fonts/lato-normal-italic.woff2?4eb103b4d12be57cb1d040ed5e162e9d) format("woff2"),url(fonts/lato-normal-italic.woff?f28f2d6482446544ef1ea1ccc6dd5892) format("woff");font-weight:400;font-style:italic;font-display:block}@font-face{font-family:Roboto Slab;font-style:normal;font-weight:400;src:url(fonts/Roboto-Slab-Regular.woff2?7abf5b8d04d26a2cafea937019bca958) format("woff2"),url(fonts/Roboto-Slab-Regular.woff?c1be9284088d487c5e3ff0a10a92e58c) format("woff");font-display:block}@font-face{font-family:Roboto Slab;font-style:normal;font-weight:700;src:url(fonts/Roboto-Slab-Bold.woff2?9984f4a9bda09be08e83f2506954adbe) format("woff2"),url(fonts/Roboto-Slab-Bold.woff?bed5564a116b05148e3b3bea6fb1162a) format("woff");font-display:block} \ No newline at end of file diff --git a/_static/doctools.js b/_static/doctools.js new file mode 100644 index 0000000..d06a71d --- /dev/null +++ b/_static/doctools.js @@ -0,0 +1,156 @@ +/* + * doctools.js + * ~~~~~~~~~~~ + * + * Base JavaScript utilities for all Sphinx HTML documentation. + * + * :copyright: Copyright 2007-2023 by the Sphinx team, see AUTHORS. + * :license: BSD, see LICENSE for details. + * + */ +"use strict"; + +const BLACKLISTED_KEY_CONTROL_ELEMENTS = new Set([ + "TEXTAREA", + "INPUT", + "SELECT", + "BUTTON", +]); + +const _ready = (callback) => { + if (document.readyState !== "loading") { + callback(); + } else { + document.addEventListener("DOMContentLoaded", callback); + } +}; + +/** + * Small JavaScript module for the documentation. + */ +const Documentation = { + init: () => { + Documentation.initDomainIndexTable(); + Documentation.initOnKeyListeners(); + }, + + /** + * i18n support + */ + TRANSLATIONS: {}, + PLURAL_EXPR: (n) => (n === 1 ? 0 : 1), + LOCALE: "unknown", + + // gettext and ngettext don't access this so that the functions + // can safely bound to a different name (_ = Documentation.gettext) + gettext: (string) => { + const translated = Documentation.TRANSLATIONS[string]; + switch (typeof translated) { + case "undefined": + return string; // no translation + case "string": + return translated; // translation exists + default: + return translated[0]; // (singular, plural) translation tuple exists + } + }, + + ngettext: (singular, plural, n) => { + const translated = Documentation.TRANSLATIONS[singular]; + if (typeof translated !== "undefined") + return translated[Documentation.PLURAL_EXPR(n)]; + return n === 1 ? singular : plural; + }, + + addTranslations: (catalog) => { + Object.assign(Documentation.TRANSLATIONS, catalog.messages); + Documentation.PLURAL_EXPR = new Function( + "n", + `return (${catalog.plural_expr})` + ); + Documentation.LOCALE = catalog.locale; + }, + + /** + * helper function to focus on search bar + */ + focusSearchBar: () => { + document.querySelectorAll("input[name=q]")[0]?.focus(); + }, + + /** + * Initialise the domain index toggle buttons + */ + initDomainIndexTable: () => { + const toggler = (el) => { + const idNumber = el.id.substr(7); + const toggledRows = document.querySelectorAll(`tr.cg-${idNumber}`); + if (el.src.substr(-9) === "minus.png") { + el.src = `${el.src.substr(0, el.src.length - 9)}plus.png`; + toggledRows.forEach((el) => (el.style.display = "none")); + } else { + el.src = `${el.src.substr(0, el.src.length - 8)}minus.png`; + toggledRows.forEach((el) => (el.style.display = "")); + } + }; + + const togglerElements = document.querySelectorAll("img.toggler"); + togglerElements.forEach((el) => + el.addEventListener("click", (event) => toggler(event.currentTarget)) + ); + togglerElements.forEach((el) => (el.style.display = "")); + if (DOCUMENTATION_OPTIONS.COLLAPSE_INDEX) togglerElements.forEach(toggler); + }, + + initOnKeyListeners: () => { + // only install a listener if it is really needed + if ( + !DOCUMENTATION_OPTIONS.NAVIGATION_WITH_KEYS && + !DOCUMENTATION_OPTIONS.ENABLE_SEARCH_SHORTCUTS + ) + return; + + document.addEventListener("keydown", (event) => { + // bail for input elements + if (BLACKLISTED_KEY_CONTROL_ELEMENTS.has(document.activeElement.tagName)) return; + // bail with special keys + if (event.altKey || event.ctrlKey || event.metaKey) return; + + if (!event.shiftKey) { + switch (event.key) { + case "ArrowLeft": + if (!DOCUMENTATION_OPTIONS.NAVIGATION_WITH_KEYS) break; + + const prevLink = document.querySelector('link[rel="prev"]'); + if (prevLink && prevLink.href) { + window.location.href = prevLink.href; + event.preventDefault(); + } + break; + case "ArrowRight": + if (!DOCUMENTATION_OPTIONS.NAVIGATION_WITH_KEYS) break; + + const nextLink = document.querySelector('link[rel="next"]'); + if (nextLink && nextLink.href) { + window.location.href = nextLink.href; + event.preventDefault(); + } + break; + } + } + + // some keyboard layouts may need Shift to get / + switch (event.key) { + case "/": + if (!DOCUMENTATION_OPTIONS.ENABLE_SEARCH_SHORTCUTS) break; + Documentation.focusSearchBar(); + event.preventDefault(); + } + }); + }, +}; + +// quick alias for translations +const _ = Documentation.gettext; + +_ready(Documentation.init); diff --git a/_static/documentation_options.js b/_static/documentation_options.js new file mode 100644 index 0000000..7e4c114 --- /dev/null +++ b/_static/documentation_options.js @@ -0,0 +1,13 @@ +const DOCUMENTATION_OPTIONS = { + VERSION: '', + LANGUAGE: 'en', + COLLAPSE_INDEX: false, + BUILDER: 'html', + FILE_SUFFIX: '.html', + LINK_SUFFIX: '.html', + HAS_SOURCE: true, + SOURCELINK_SUFFIX: '.txt', + NAVIGATION_WITH_KEYS: false, + SHOW_SEARCH_SUMMARY: true, + ENABLE_SEARCH_SHORTCUTS: true, +}; \ No newline at end of file diff --git a/_static/file.png b/_static/file.png new file mode 100644 index 0000000..a858a41 Binary files /dev/null and b/_static/file.png differ diff --git a/_static/jquery.js b/_static/jquery.js new file mode 100644 index 0000000..c4c6022 --- /dev/null +++ b/_static/jquery.js @@ -0,0 +1,2 @@ +/*! jQuery v3.6.0 | (c) OpenJS Foundation and other contributors | jquery.org/license */ +!function(e,t){"use strict";"object"==typeof module&&"object"==typeof module.exports?module.exports=e.document?t(e,!0):function(e){if(!e.document)throw new Error("jQuery requires a window with a document");return t(e)}:t(e)}("undefined"!=typeof window?window:this,function(C,e){"use strict";var t=[],r=Object.getPrototypeOf,s=t.slice,g=t.flat?function(e){return t.flat.call(e)}:function(e){return t.concat.apply([],e)},u=t.push,i=t.indexOf,n={},o=n.toString,v=n.hasOwnProperty,a=v.toString,l=a.call(Object),y={},m=function(e){return"function"==typeof e&&"number"!=typeof e.nodeType&&"function"!=typeof e.item},x=function(e){return null!=e&&e===e.window},E=C.document,c={type:!0,src:!0,nonce:!0,noModule:!0};function b(e,t,n){var r,i,o=(n=n||E).createElement("script");if(o.text=e,t)for(r in c)(i=t[r]||t.getAttribute&&t.getAttribute(r))&&o.setAttribute(r,i);n.head.appendChild(o).parentNode.removeChild(o)}function w(e){return null==e?e+"":"object"==typeof e||"function"==typeof e?n[o.call(e)]||"object":typeof e}var f="3.6.0",S=function(e,t){return new S.fn.init(e,t)};function p(e){var t=!!e&&"length"in e&&e.length,n=w(e);return!m(e)&&!x(e)&&("array"===n||0===t||"number"==typeof t&&0+~]|"+M+")"+M+"*"),U=new RegExp(M+"|>"),X=new RegExp(F),V=new RegExp("^"+I+"$"),G={ID:new RegExp("^#("+I+")"),CLASS:new RegExp("^\\.("+I+")"),TAG:new RegExp("^("+I+"|[*])"),ATTR:new RegExp("^"+W),PSEUDO:new RegExp("^"+F),CHILD:new RegExp("^:(only|first|last|nth|nth-last)-(child|of-type)(?:\\("+M+"*(even|odd|(([+-]|)(\\d*)n|)"+M+"*(?:([+-]|)"+M+"*(\\d+)|))"+M+"*\\)|)","i"),bool:new RegExp("^(?:"+R+")$","i"),needsContext:new RegExp("^"+M+"*[>+~]|:(even|odd|eq|gt|lt|nth|first|last)(?:\\("+M+"*((?:-\\d)?\\d*)"+M+"*\\)|)(?=[^-]|$)","i")},Y=/HTML$/i,Q=/^(?:input|select|textarea|button)$/i,J=/^h\d$/i,K=/^[^{]+\{\s*\[native \w/,Z=/^(?:#([\w-]+)|(\w+)|\.([\w-]+))$/,ee=/[+~]/,te=new RegExp("\\\\[\\da-fA-F]{1,6}"+M+"?|\\\\([^\\r\\n\\f])","g"),ne=function(e,t){var n="0x"+e.slice(1)-65536;return t||(n<0?String.fromCharCode(n+65536):String.fromCharCode(n>>10|55296,1023&n|56320))},re=/([\0-\x1f\x7f]|^-?\d)|^-$|[^\0-\x1f\x7f-\uFFFF\w-]/g,ie=function(e,t){return t?"\0"===e?"\ufffd":e.slice(0,-1)+"\\"+e.charCodeAt(e.length-1).toString(16)+" ":"\\"+e},oe=function(){T()},ae=be(function(e){return!0===e.disabled&&"fieldset"===e.nodeName.toLowerCase()},{dir:"parentNode",next:"legend"});try{H.apply(t=O.call(p.childNodes),p.childNodes),t[p.childNodes.length].nodeType}catch(e){H={apply:t.length?function(e,t){L.apply(e,O.call(t))}:function(e,t){var n=e.length,r=0;while(e[n++]=t[r++]);e.length=n-1}}}function se(t,e,n,r){var i,o,a,s,u,l,c,f=e&&e.ownerDocument,p=e?e.nodeType:9;if(n=n||[],"string"!=typeof t||!t||1!==p&&9!==p&&11!==p)return n;if(!r&&(T(e),e=e||C,E)){if(11!==p&&(u=Z.exec(t)))if(i=u[1]){if(9===p){if(!(a=e.getElementById(i)))return n;if(a.id===i)return n.push(a),n}else if(f&&(a=f.getElementById(i))&&y(e,a)&&a.id===i)return n.push(a),n}else{if(u[2])return H.apply(n,e.getElementsByTagName(t)),n;if((i=u[3])&&d.getElementsByClassName&&e.getElementsByClassName)return H.apply(n,e.getElementsByClassName(i)),n}if(d.qsa&&!N[t+" "]&&(!v||!v.test(t))&&(1!==p||"object"!==e.nodeName.toLowerCase())){if(c=t,f=e,1===p&&(U.test(t)||z.test(t))){(f=ee.test(t)&&ye(e.parentNode)||e)===e&&d.scope||((s=e.getAttribute("id"))?s=s.replace(re,ie):e.setAttribute("id",s=S)),o=(l=h(t)).length;while(o--)l[o]=(s?"#"+s:":scope")+" "+xe(l[o]);c=l.join(",")}try{return H.apply(n,f.querySelectorAll(c)),n}catch(e){N(t,!0)}finally{s===S&&e.removeAttribute("id")}}}return g(t.replace($,"$1"),e,n,r)}function ue(){var r=[];return function e(t,n){return r.push(t+" ")>b.cacheLength&&delete e[r.shift()],e[t+" "]=n}}function le(e){return e[S]=!0,e}function ce(e){var t=C.createElement("fieldset");try{return!!e(t)}catch(e){return!1}finally{t.parentNode&&t.parentNode.removeChild(t),t=null}}function fe(e,t){var n=e.split("|"),r=n.length;while(r--)b.attrHandle[n[r]]=t}function pe(e,t){var n=t&&e,r=n&&1===e.nodeType&&1===t.nodeType&&e.sourceIndex-t.sourceIndex;if(r)return r;if(n)while(n=n.nextSibling)if(n===t)return-1;return e?1:-1}function de(t){return function(e){return"input"===e.nodeName.toLowerCase()&&e.type===t}}function he(n){return function(e){var t=e.nodeName.toLowerCase();return("input"===t||"button"===t)&&e.type===n}}function ge(t){return function(e){return"form"in e?e.parentNode&&!1===e.disabled?"label"in e?"label"in e.parentNode?e.parentNode.disabled===t:e.disabled===t:e.isDisabled===t||e.isDisabled!==!t&&ae(e)===t:e.disabled===t:"label"in e&&e.disabled===t}}function ve(a){return le(function(o){return o=+o,le(function(e,t){var n,r=a([],e.length,o),i=r.length;while(i--)e[n=r[i]]&&(e[n]=!(t[n]=e[n]))})})}function ye(e){return e&&"undefined"!=typeof e.getElementsByTagName&&e}for(e in d=se.support={},i=se.isXML=function(e){var t=e&&e.namespaceURI,n=e&&(e.ownerDocument||e).documentElement;return!Y.test(t||n&&n.nodeName||"HTML")},T=se.setDocument=function(e){var t,n,r=e?e.ownerDocument||e:p;return r!=C&&9===r.nodeType&&r.documentElement&&(a=(C=r).documentElement,E=!i(C),p!=C&&(n=C.defaultView)&&n.top!==n&&(n.addEventListener?n.addEventListener("unload",oe,!1):n.attachEvent&&n.attachEvent("onunload",oe)),d.scope=ce(function(e){return a.appendChild(e).appendChild(C.createElement("div")),"undefined"!=typeof e.querySelectorAll&&!e.querySelectorAll(":scope fieldset div").length}),d.attributes=ce(function(e){return e.className="i",!e.getAttribute("className")}),d.getElementsByTagName=ce(function(e){return e.appendChild(C.createComment("")),!e.getElementsByTagName("*").length}),d.getElementsByClassName=K.test(C.getElementsByClassName),d.getById=ce(function(e){return a.appendChild(e).id=S,!C.getElementsByName||!C.getElementsByName(S).length}),d.getById?(b.filter.ID=function(e){var t=e.replace(te,ne);return function(e){return e.getAttribute("id")===t}},b.find.ID=function(e,t){if("undefined"!=typeof t.getElementById&&E){var n=t.getElementById(e);return n?[n]:[]}}):(b.filter.ID=function(e){var n=e.replace(te,ne);return function(e){var t="undefined"!=typeof e.getAttributeNode&&e.getAttributeNode("id");return t&&t.value===n}},b.find.ID=function(e,t){if("undefined"!=typeof t.getElementById&&E){var n,r,i,o=t.getElementById(e);if(o){if((n=o.getAttributeNode("id"))&&n.value===e)return[o];i=t.getElementsByName(e),r=0;while(o=i[r++])if((n=o.getAttributeNode("id"))&&n.value===e)return[o]}return[]}}),b.find.TAG=d.getElementsByTagName?function(e,t){return"undefined"!=typeof t.getElementsByTagName?t.getElementsByTagName(e):d.qsa?t.querySelectorAll(e):void 0}:function(e,t){var n,r=[],i=0,o=t.getElementsByTagName(e);if("*"===e){while(n=o[i++])1===n.nodeType&&r.push(n);return r}return o},b.find.CLASS=d.getElementsByClassName&&function(e,t){if("undefined"!=typeof t.getElementsByClassName&&E)return t.getElementsByClassName(e)},s=[],v=[],(d.qsa=K.test(C.querySelectorAll))&&(ce(function(e){var t;a.appendChild(e).innerHTML="",e.querySelectorAll("[msallowcapture^='']").length&&v.push("[*^$]="+M+"*(?:''|\"\")"),e.querySelectorAll("[selected]").length||v.push("\\["+M+"*(?:value|"+R+")"),e.querySelectorAll("[id~="+S+"-]").length||v.push("~="),(t=C.createElement("input")).setAttribute("name",""),e.appendChild(t),e.querySelectorAll("[name='']").length||v.push("\\["+M+"*name"+M+"*="+M+"*(?:''|\"\")"),e.querySelectorAll(":checked").length||v.push(":checked"),e.querySelectorAll("a#"+S+"+*").length||v.push(".#.+[+~]"),e.querySelectorAll("\\\f"),v.push("[\\r\\n\\f]")}),ce(function(e){e.innerHTML="";var t=C.createElement("input");t.setAttribute("type","hidden"),e.appendChild(t).setAttribute("name","D"),e.querySelectorAll("[name=d]").length&&v.push("name"+M+"*[*^$|!~]?="),2!==e.querySelectorAll(":enabled").length&&v.push(":enabled",":disabled"),a.appendChild(e).disabled=!0,2!==e.querySelectorAll(":disabled").length&&v.push(":enabled",":disabled"),e.querySelectorAll("*,:x"),v.push(",.*:")})),(d.matchesSelector=K.test(c=a.matches||a.webkitMatchesSelector||a.mozMatchesSelector||a.oMatchesSelector||a.msMatchesSelector))&&ce(function(e){d.disconnectedMatch=c.call(e,"*"),c.call(e,"[s!='']:x"),s.push("!=",F)}),v=v.length&&new RegExp(v.join("|")),s=s.length&&new RegExp(s.join("|")),t=K.test(a.compareDocumentPosition),y=t||K.test(a.contains)?function(e,t){var n=9===e.nodeType?e.documentElement:e,r=t&&t.parentNode;return e===r||!(!r||1!==r.nodeType||!(n.contains?n.contains(r):e.compareDocumentPosition&&16&e.compareDocumentPosition(r)))}:function(e,t){if(t)while(t=t.parentNode)if(t===e)return!0;return!1},j=t?function(e,t){if(e===t)return l=!0,0;var n=!e.compareDocumentPosition-!t.compareDocumentPosition;return n||(1&(n=(e.ownerDocument||e)==(t.ownerDocument||t)?e.compareDocumentPosition(t):1)||!d.sortDetached&&t.compareDocumentPosition(e)===n?e==C||e.ownerDocument==p&&y(p,e)?-1:t==C||t.ownerDocument==p&&y(p,t)?1:u?P(u,e)-P(u,t):0:4&n?-1:1)}:function(e,t){if(e===t)return l=!0,0;var n,r=0,i=e.parentNode,o=t.parentNode,a=[e],s=[t];if(!i||!o)return e==C?-1:t==C?1:i?-1:o?1:u?P(u,e)-P(u,t):0;if(i===o)return pe(e,t);n=e;while(n=n.parentNode)a.unshift(n);n=t;while(n=n.parentNode)s.unshift(n);while(a[r]===s[r])r++;return r?pe(a[r],s[r]):a[r]==p?-1:s[r]==p?1:0}),C},se.matches=function(e,t){return se(e,null,null,t)},se.matchesSelector=function(e,t){if(T(e),d.matchesSelector&&E&&!N[t+" "]&&(!s||!s.test(t))&&(!v||!v.test(t)))try{var n=c.call(e,t);if(n||d.disconnectedMatch||e.document&&11!==e.document.nodeType)return n}catch(e){N(t,!0)}return 0":{dir:"parentNode",first:!0}," ":{dir:"parentNode"},"+":{dir:"previousSibling",first:!0},"~":{dir:"previousSibling"}},preFilter:{ATTR:function(e){return e[1]=e[1].replace(te,ne),e[3]=(e[3]||e[4]||e[5]||"").replace(te,ne),"~="===e[2]&&(e[3]=" "+e[3]+" "),e.slice(0,4)},CHILD:function(e){return e[1]=e[1].toLowerCase(),"nth"===e[1].slice(0,3)?(e[3]||se.error(e[0]),e[4]=+(e[4]?e[5]+(e[6]||1):2*("even"===e[3]||"odd"===e[3])),e[5]=+(e[7]+e[8]||"odd"===e[3])):e[3]&&se.error(e[0]),e},PSEUDO:function(e){var t,n=!e[6]&&e[2];return G.CHILD.test(e[0])?null:(e[3]?e[2]=e[4]||e[5]||"":n&&X.test(n)&&(t=h(n,!0))&&(t=n.indexOf(")",n.length-t)-n.length)&&(e[0]=e[0].slice(0,t),e[2]=n.slice(0,t)),e.slice(0,3))}},filter:{TAG:function(e){var t=e.replace(te,ne).toLowerCase();return"*"===e?function(){return!0}:function(e){return e.nodeName&&e.nodeName.toLowerCase()===t}},CLASS:function(e){var t=m[e+" "];return t||(t=new RegExp("(^|"+M+")"+e+"("+M+"|$)"))&&m(e,function(e){return t.test("string"==typeof e.className&&e.className||"undefined"!=typeof e.getAttribute&&e.getAttribute("class")||"")})},ATTR:function(n,r,i){return function(e){var t=se.attr(e,n);return null==t?"!="===r:!r||(t+="","="===r?t===i:"!="===r?t!==i:"^="===r?i&&0===t.indexOf(i):"*="===r?i&&-1:\x20\t\r\n\f]*)[\x20\t\r\n\f]*\/?>(?:<\/\1>|)$/i;function j(e,n,r){return m(n)?S.grep(e,function(e,t){return!!n.call(e,t,e)!==r}):n.nodeType?S.grep(e,function(e){return e===n!==r}):"string"!=typeof n?S.grep(e,function(e){return-1)[^>]*|#([\w-]+))$/;(S.fn.init=function(e,t,n){var r,i;if(!e)return this;if(n=n||D,"string"==typeof e){if(!(r="<"===e[0]&&">"===e[e.length-1]&&3<=e.length?[null,e,null]:q.exec(e))||!r[1]&&t)return!t||t.jquery?(t||n).find(e):this.constructor(t).find(e);if(r[1]){if(t=t instanceof S?t[0]:t,S.merge(this,S.parseHTML(r[1],t&&t.nodeType?t.ownerDocument||t:E,!0)),N.test(r[1])&&S.isPlainObject(t))for(r in t)m(this[r])?this[r](t[r]):this.attr(r,t[r]);return this}return(i=E.getElementById(r[2]))&&(this[0]=i,this.length=1),this}return e.nodeType?(this[0]=e,this.length=1,this):m(e)?void 0!==n.ready?n.ready(e):e(S):S.makeArray(e,this)}).prototype=S.fn,D=S(E);var L=/^(?:parents|prev(?:Until|All))/,H={children:!0,contents:!0,next:!0,prev:!0};function O(e,t){while((e=e[t])&&1!==e.nodeType);return e}S.fn.extend({has:function(e){var t=S(e,this),n=t.length;return this.filter(function(){for(var e=0;e\x20\t\r\n\f]*)/i,he=/^$|^module$|\/(?:java|ecma)script/i;ce=E.createDocumentFragment().appendChild(E.createElement("div")),(fe=E.createElement("input")).setAttribute("type","radio"),fe.setAttribute("checked","checked"),fe.setAttribute("name","t"),ce.appendChild(fe),y.checkClone=ce.cloneNode(!0).cloneNode(!0).lastChild.checked,ce.innerHTML="",y.noCloneChecked=!!ce.cloneNode(!0).lastChild.defaultValue,ce.innerHTML="",y.option=!!ce.lastChild;var ge={thead:[1,"","
"],col:[2,"","
"],tr:[2,"","
"],td:[3,"","
"],_default:[0,"",""]};function ve(e,t){var n;return n="undefined"!=typeof e.getElementsByTagName?e.getElementsByTagName(t||"*"):"undefined"!=typeof e.querySelectorAll?e.querySelectorAll(t||"*"):[],void 0===t||t&&A(e,t)?S.merge([e],n):n}function ye(e,t){for(var n=0,r=e.length;n",""]);var me=/<|&#?\w+;/;function xe(e,t,n,r,i){for(var o,a,s,u,l,c,f=t.createDocumentFragment(),p=[],d=0,h=e.length;d\s*$/g;function je(e,t){return A(e,"table")&&A(11!==t.nodeType?t:t.firstChild,"tr")&&S(e).children("tbody")[0]||e}function De(e){return e.type=(null!==e.getAttribute("type"))+"/"+e.type,e}function qe(e){return"true/"===(e.type||"").slice(0,5)?e.type=e.type.slice(5):e.removeAttribute("type"),e}function Le(e,t){var n,r,i,o,a,s;if(1===t.nodeType){if(Y.hasData(e)&&(s=Y.get(e).events))for(i in Y.remove(t,"handle events"),s)for(n=0,r=s[i].length;n").attr(n.scriptAttrs||{}).prop({charset:n.scriptCharset,src:n.url}).on("load error",i=function(e){r.remove(),i=null,e&&t("error"===e.type?404:200,e.type)}),E.head.appendChild(r[0])},abort:function(){i&&i()}}});var _t,zt=[],Ut=/(=)\?(?=&|$)|\?\?/;S.ajaxSetup({jsonp:"callback",jsonpCallback:function(){var e=zt.pop()||S.expando+"_"+wt.guid++;return this[e]=!0,e}}),S.ajaxPrefilter("json jsonp",function(e,t,n){var r,i,o,a=!1!==e.jsonp&&(Ut.test(e.url)?"url":"string"==typeof e.data&&0===(e.contentType||"").indexOf("application/x-www-form-urlencoded")&&Ut.test(e.data)&&"data");if(a||"jsonp"===e.dataTypes[0])return r=e.jsonpCallback=m(e.jsonpCallback)?e.jsonpCallback():e.jsonpCallback,a?e[a]=e[a].replace(Ut,"$1"+r):!1!==e.jsonp&&(e.url+=(Tt.test(e.url)?"&":"?")+e.jsonp+"="+r),e.converters["script json"]=function(){return o||S.error(r+" was not called"),o[0]},e.dataTypes[0]="json",i=C[r],C[r]=function(){o=arguments},n.always(function(){void 0===i?S(C).removeProp(r):C[r]=i,e[r]&&(e.jsonpCallback=t.jsonpCallback,zt.push(r)),o&&m(i)&&i(o[0]),o=i=void 0}),"script"}),y.createHTMLDocument=((_t=E.implementation.createHTMLDocument("").body).innerHTML="
",2===_t.childNodes.length),S.parseHTML=function(e,t,n){return"string"!=typeof e?[]:("boolean"==typeof t&&(n=t,t=!1),t||(y.createHTMLDocument?((r=(t=E.implementation.createHTMLDocument("")).createElement("base")).href=E.location.href,t.head.appendChild(r)):t=E),o=!n&&[],(i=N.exec(e))?[t.createElement(i[1])]:(i=xe([e],t,o),o&&o.length&&S(o).remove(),S.merge([],i.childNodes)));var r,i,o},S.fn.load=function(e,t,n){var r,i,o,a=this,s=e.indexOf(" ");return-1").append(S.parseHTML(e)).find(r):e)}).always(n&&function(e,t){a.each(function(){n.apply(this,o||[e.responseText,t,e])})}),this},S.expr.pseudos.animated=function(t){return S.grep(S.timers,function(e){return t===e.elem}).length},S.offset={setOffset:function(e,t,n){var r,i,o,a,s,u,l=S.css(e,"position"),c=S(e),f={};"static"===l&&(e.style.position="relative"),s=c.offset(),o=S.css(e,"top"),u=S.css(e,"left"),("absolute"===l||"fixed"===l)&&-1<(o+u).indexOf("auto")?(a=(r=c.position()).top,i=r.left):(a=parseFloat(o)||0,i=parseFloat(u)||0),m(t)&&(t=t.call(e,n,S.extend({},s))),null!=t.top&&(f.top=t.top-s.top+a),null!=t.left&&(f.left=t.left-s.left+i),"using"in t?t.using.call(e,f):c.css(f)}},S.fn.extend({offset:function(t){if(arguments.length)return void 0===t?this:this.each(function(e){S.offset.setOffset(this,t,e)});var e,n,r=this[0];return r?r.getClientRects().length?(e=r.getBoundingClientRect(),n=r.ownerDocument.defaultView,{top:e.top+n.pageYOffset,left:e.left+n.pageXOffset}):{top:0,left:0}:void 0},position:function(){if(this[0]){var e,t,n,r=this[0],i={top:0,left:0};if("fixed"===S.css(r,"position"))t=r.getBoundingClientRect();else{t=this.offset(),n=r.ownerDocument,e=r.offsetParent||n.documentElement;while(e&&(e===n.body||e===n.documentElement)&&"static"===S.css(e,"position"))e=e.parentNode;e&&e!==r&&1===e.nodeType&&((i=S(e).offset()).top+=S.css(e,"borderTopWidth",!0),i.left+=S.css(e,"borderLeftWidth",!0))}return{top:t.top-i.top-S.css(r,"marginTop",!0),left:t.left-i.left-S.css(r,"marginLeft",!0)}}},offsetParent:function(){return this.map(function(){var e=this.offsetParent;while(e&&"static"===S.css(e,"position"))e=e.offsetParent;return e||re})}}),S.each({scrollLeft:"pageXOffset",scrollTop:"pageYOffset"},function(t,i){var o="pageYOffset"===i;S.fn[t]=function(e){return $(this,function(e,t,n){var r;if(x(e)?r=e:9===e.nodeType&&(r=e.defaultView),void 0===n)return r?r[i]:e[t];r?r.scrollTo(o?r.pageXOffset:n,o?n:r.pageYOffset):e[t]=n},t,e,arguments.length)}}),S.each(["top","left"],function(e,n){S.cssHooks[n]=Fe(y.pixelPosition,function(e,t){if(t)return t=We(e,n),Pe.test(t)?S(e).position()[n]+"px":t})}),S.each({Height:"height",Width:"width"},function(a,s){S.each({padding:"inner"+a,content:s,"":"outer"+a},function(r,o){S.fn[o]=function(e,t){var n=arguments.length&&(r||"boolean"!=typeof e),i=r||(!0===e||!0===t?"margin":"border");return $(this,function(e,t,n){var r;return x(e)?0===o.indexOf("outer")?e["inner"+a]:e.document.documentElement["client"+a]:9===e.nodeType?(r=e.documentElement,Math.max(e.body["scroll"+a],r["scroll"+a],e.body["offset"+a],r["offset"+a],r["client"+a])):void 0===n?S.css(e,t,i):S.style(e,t,n,i)},s,n?e:void 0,n)}})}),S.each(["ajaxStart","ajaxStop","ajaxComplete","ajaxError","ajaxSuccess","ajaxSend"],function(e,t){S.fn[t]=function(e){return this.on(t,e)}}),S.fn.extend({bind:function(e,t,n){return this.on(e,null,t,n)},unbind:function(e,t){return this.off(e,null,t)},delegate:function(e,t,n,r){return this.on(t,e,n,r)},undelegate:function(e,t,n){return 1===arguments.length?this.off(e,"**"):this.off(t,e||"**",n)},hover:function(e,t){return this.mouseenter(e).mouseleave(t||e)}}),S.each("blur focus focusin focusout resize scroll click dblclick mousedown mouseup mousemove mouseover mouseout mouseenter mouseleave change select submit keydown keypress keyup contextmenu".split(" "),function(e,n){S.fn[n]=function(e,t){return 0",d.insertBefore(c.lastChild,d.firstChild)}function d(){var a=y.elements;return"string"==typeof a?a.split(" "):a}function e(a,b){var c=y.elements;"string"!=typeof c&&(c=c.join(" ")),"string"!=typeof a&&(a=a.join(" ")),y.elements=c+" "+a,j(b)}function f(a){var b=x[a[v]];return b||(b={},w++,a[v]=w,x[w]=b),b}function g(a,c,d){if(c||(c=b),q)return c.createElement(a);d||(d=f(c));var e;return e=d.cache[a]?d.cache[a].cloneNode():u.test(a)?(d.cache[a]=d.createElem(a)).cloneNode():d.createElem(a),!e.canHaveChildren||t.test(a)||e.tagUrn?e:d.frag.appendChild(e)}function h(a,c){if(a||(a=b),q)return a.createDocumentFragment();c=c||f(a);for(var e=c.frag.cloneNode(),g=0,h=d(),i=h.length;i>g;g++)e.createElement(h[g]);return e}function i(a,b){b.cache||(b.cache={},b.createElem=a.createElement,b.createFrag=a.createDocumentFragment,b.frag=b.createFrag()),a.createElement=function(c){return y.shivMethods?g(c,a,b):b.createElem(c)},a.createDocumentFragment=Function("h,f","return function(){var n=f.cloneNode(),c=n.createElement;h.shivMethods&&("+d().join().replace(/[\w\-:]+/g,function(a){return b.createElem(a),b.frag.createElement(a),'c("'+a+'")'})+");return n}")(y,b.frag)}function j(a){a||(a=b);var d=f(a);return!y.shivCSS||p||d.hasCSS||(d.hasCSS=!!c(a,"article,aside,dialog,figcaption,figure,footer,header,hgroup,main,nav,section{display:block}mark{background:#FF0;color:#000}template{display:none}")),q||i(a,d),a}function k(a){for(var b,c=a.getElementsByTagName("*"),e=c.length,f=RegExp("^(?:"+d().join("|")+")$","i"),g=[];e--;)b=c[e],f.test(b.nodeName)&&g.push(b.applyElement(l(b)));return g}function l(a){for(var b,c=a.attributes,d=c.length,e=a.ownerDocument.createElement(A+":"+a.nodeName);d--;)b=c[d],b.specified&&e.setAttribute(b.nodeName,b.nodeValue);return e.style.cssText=a.style.cssText,e}function m(a){for(var b,c=a.split("{"),e=c.length,f=RegExp("(^|[\\s,>+~])("+d().join("|")+")(?=[[\\s,>+~#.:]|$)","gi"),g="$1"+A+"\\:$2";e--;)b=c[e]=c[e].split("}"),b[b.length-1]=b[b.length-1].replace(f,g),c[e]=b.join("}");return c.join("{")}function n(a){for(var b=a.length;b--;)a[b].removeNode()}function o(a){function b(){clearTimeout(g._removeSheetTimer),d&&d.removeNode(!0),d=null}var d,e,g=f(a),h=a.namespaces,i=a.parentWindow;return!B||a.printShived?a:("undefined"==typeof h[A]&&h.add(A),i.attachEvent("onbeforeprint",function(){b();for(var f,g,h,i=a.styleSheets,j=[],l=i.length,n=Array(l);l--;)n[l]=i[l];for(;h=n.pop();)if(!h.disabled&&z.test(h.media)){try{f=h.imports,g=f.length}catch(o){g=0}for(l=0;g>l;l++)n.push(f[l]);try{j.push(h.cssText)}catch(o){}}j=m(j.reverse().join("")),e=k(a),d=c(a,j)}),i.attachEvent("onafterprint",function(){n(e),clearTimeout(g._removeSheetTimer),g._removeSheetTimer=setTimeout(b,500)}),a.printShived=!0,a)}var p,q,r="3.7.3",s=a.html5||{},t=/^<|^(?:button|map|select|textarea|object|iframe|option|optgroup)$/i,u=/^(?:a|b|code|div|fieldset|h1|h2|h3|h4|h5|h6|i|label|li|ol|p|q|span|strong|style|table|tbody|td|th|tr|ul)$/i,v="_html5shiv",w=0,x={};!function(){try{var a=b.createElement("a");a.innerHTML="",p="hidden"in a,q=1==a.childNodes.length||function(){b.createElement("a");var a=b.createDocumentFragment();return"undefined"==typeof a.cloneNode||"undefined"==typeof a.createDocumentFragment||"undefined"==typeof a.createElement}()}catch(c){p=!0,q=!0}}();var y={elements:s.elements||"abbr article aside audio bdi canvas data datalist details dialog figcaption figure footer header hgroup main mark meter nav output picture progress section summary template time video",version:r,shivCSS:s.shivCSS!==!1,supportsUnknownElements:q,shivMethods:s.shivMethods!==!1,type:"default",shivDocument:j,createElement:g,createDocumentFragment:h,addElements:e};a.html5=y,j(b);var z=/^$|\b(?:all|print)\b/,A="html5shiv",B=!q&&function(){var c=b.documentElement;return!("undefined"==typeof b.namespaces||"undefined"==typeof b.parentWindow||"undefined"==typeof c.applyElement||"undefined"==typeof c.removeNode||"undefined"==typeof a.attachEvent)}();y.type+=" print",y.shivPrint=o,o(b),"object"==typeof module&&module.exports&&(module.exports=y)}("undefined"!=typeof window?window:this,document); \ No newline at end of file diff --git a/_static/js/html5shiv.min.js b/_static/js/html5shiv.min.js new file mode 100644 index 0000000..cd1c674 --- /dev/null +++ b/_static/js/html5shiv.min.js @@ -0,0 +1,4 @@ +/** +* @preserve HTML5 Shiv 3.7.3 | @afarkas @jdalton @jon_neal @rem | MIT/GPL2 Licensed +*/ +!function(a,b){function c(a,b){var c=a.createElement("p"),d=a.getElementsByTagName("head")[0]||a.documentElement;return c.innerHTML="x",d.insertBefore(c.lastChild,d.firstChild)}function d(){var a=t.elements;return"string"==typeof a?a.split(" "):a}function e(a,b){var c=t.elements;"string"!=typeof c&&(c=c.join(" ")),"string"!=typeof a&&(a=a.join(" ")),t.elements=c+" "+a,j(b)}function f(a){var b=s[a[q]];return b||(b={},r++,a[q]=r,s[r]=b),b}function g(a,c,d){if(c||(c=b),l)return c.createElement(a);d||(d=f(c));var e;return e=d.cache[a]?d.cache[a].cloneNode():p.test(a)?(d.cache[a]=d.createElem(a)).cloneNode():d.createElem(a),!e.canHaveChildren||o.test(a)||e.tagUrn?e:d.frag.appendChild(e)}function h(a,c){if(a||(a=b),l)return a.createDocumentFragment();c=c||f(a);for(var e=c.frag.cloneNode(),g=0,h=d(),i=h.length;i>g;g++)e.createElement(h[g]);return e}function i(a,b){b.cache||(b.cache={},b.createElem=a.createElement,b.createFrag=a.createDocumentFragment,b.frag=b.createFrag()),a.createElement=function(c){return t.shivMethods?g(c,a,b):b.createElem(c)},a.createDocumentFragment=Function("h,f","return function(){var n=f.cloneNode(),c=n.createElement;h.shivMethods&&("+d().join().replace(/[\w\-:]+/g,function(a){return b.createElem(a),b.frag.createElement(a),'c("'+a+'")'})+");return n}")(t,b.frag)}function j(a){a||(a=b);var d=f(a);return!t.shivCSS||k||d.hasCSS||(d.hasCSS=!!c(a,"article,aside,dialog,figcaption,figure,footer,header,hgroup,main,nav,section{display:block}mark{background:#FF0;color:#000}template{display:none}")),l||i(a,d),a}var k,l,m="3.7.3-pre",n=a.html5||{},o=/^<|^(?:button|map|select|textarea|object|iframe|option|optgroup)$/i,p=/^(?:a|b|code|div|fieldset|h1|h2|h3|h4|h5|h6|i|label|li|ol|p|q|span|strong|style|table|tbody|td|th|tr|ul)$/i,q="_html5shiv",r=0,s={};!function(){try{var a=b.createElement("a");a.innerHTML="",k="hidden"in a,l=1==a.childNodes.length||function(){b.createElement("a");var a=b.createDocumentFragment();return"undefined"==typeof a.cloneNode||"undefined"==typeof a.createDocumentFragment||"undefined"==typeof a.createElement}()}catch(c){k=!0,l=!0}}();var t={elements:n.elements||"abbr article aside audio bdi canvas data datalist details dialog figcaption figure footer header hgroup main mark meter nav output picture progress section summary template time video",version:m,shivCSS:n.shivCSS!==!1,supportsUnknownElements:l,shivMethods:n.shivMethods!==!1,type:"default",shivDocument:j,createElement:g,createDocumentFragment:h,addElements:e};a.html5=t,j(b),"object"==typeof module&&module.exports&&(module.exports=t)}("undefined"!=typeof window?window:this,document); \ No newline at end of file diff --git a/_static/js/theme.js b/_static/js/theme.js new file mode 100644 index 0000000..1fddb6e --- /dev/null +++ b/_static/js/theme.js @@ -0,0 +1 @@ +!function(n){var e={};function t(i){if(e[i])return e[i].exports;var o=e[i]={i:i,l:!1,exports:{}};return n[i].call(o.exports,o,o.exports,t),o.l=!0,o.exports}t.m=n,t.c=e,t.d=function(n,e,i){t.o(n,e)||Object.defineProperty(n,e,{enumerable:!0,get:i})},t.r=function(n){"undefined"!=typeof Symbol&&Symbol.toStringTag&&Object.defineProperty(n,Symbol.toStringTag,{value:"Module"}),Object.defineProperty(n,"__esModule",{value:!0})},t.t=function(n,e){if(1&e&&(n=t(n)),8&e)return n;if(4&e&&"object"==typeof n&&n&&n.__esModule)return n;var i=Object.create(null);if(t.r(i),Object.defineProperty(i,"default",{enumerable:!0,value:n}),2&e&&"string"!=typeof n)for(var o in n)t.d(i,o,function(e){return n[e]}.bind(null,o));return i},t.n=function(n){var e=n&&n.__esModule?function(){return n.default}:function(){return n};return t.d(e,"a",e),e},t.o=function(n,e){return Object.prototype.hasOwnProperty.call(n,e)},t.p="",t(t.s=0)}([function(n,e,t){t(1),n.exports=t(3)},function(n,e,t){(function(){var e="undefined"!=typeof window?window.jQuery:t(2);n.exports.ThemeNav={navBar:null,win:null,winScroll:!1,winResize:!1,linkScroll:!1,winPosition:0,winHeight:null,docHeight:null,isRunning:!1,enable:function(n){var t=this;void 0===n&&(n=!0),t.isRunning||(t.isRunning=!0,e((function(e){t.init(e),t.reset(),t.win.on("hashchange",t.reset),n&&t.win.on("scroll",(function(){t.linkScroll||t.winScroll||(t.winScroll=!0,requestAnimationFrame((function(){t.onScroll()})))})),t.win.on("resize",(function(){t.winResize||(t.winResize=!0,requestAnimationFrame((function(){t.onResize()})))})),t.onResize()})))},enableSticky:function(){this.enable(!0)},init:function(n){n(document);var e=this;this.navBar=n("div.wy-side-scroll:first"),this.win=n(window),n(document).on("click","[data-toggle='wy-nav-top']",(function(){n("[data-toggle='wy-nav-shift']").toggleClass("shift"),n("[data-toggle='rst-versions']").toggleClass("shift")})).on("click",".wy-menu-vertical .current ul li a",(function(){var t=n(this);n("[data-toggle='wy-nav-shift']").removeClass("shift"),n("[data-toggle='rst-versions']").toggleClass("shift"),e.toggleCurrent(t),e.hashChange()})).on("click","[data-toggle='rst-current-version']",(function(){n("[data-toggle='rst-versions']").toggleClass("shift-up")})),n("table.docutils:not(.field-list,.footnote,.citation)").wrap("
"),n("table.docutils.footnote").wrap("
"),n("table.docutils.citation").wrap("
"),n(".wy-menu-vertical ul").not(".simple").siblings("a").each((function(){var t=n(this);expand=n(''),expand.on("click",(function(n){return e.toggleCurrent(t),n.stopPropagation(),!1})),t.prepend(expand)}))},reset:function(){var n=encodeURI(window.location.hash)||"#";try{var e=$(".wy-menu-vertical"),t=e.find('[href="'+n+'"]');if(0===t.length){var i=$('.document [id="'+n.substring(1)+'"]').closest("div.section");0===(t=e.find('[href="#'+i.attr("id")+'"]')).length&&(t=e.find('[href="#"]'))}if(t.length>0){$(".wy-menu-vertical .current").removeClass("current").attr("aria-expanded","false"),t.addClass("current").attr("aria-expanded","true"),t.closest("li.toctree-l1").parent().addClass("current").attr("aria-expanded","true");for(let n=1;n<=10;n++)t.closest("li.toctree-l"+n).addClass("current").attr("aria-expanded","true");t[0].scrollIntoView()}}catch(n){console.log("Error expanding nav for anchor",n)}},onScroll:function(){this.winScroll=!1;var n=this.win.scrollTop(),e=n+this.winHeight,t=this.navBar.scrollTop()+(n-this.winPosition);n<0||e>this.docHeight||(this.navBar.scrollTop(t),this.winPosition=n)},onResize:function(){this.winResize=!1,this.winHeight=this.win.height(),this.docHeight=$(document).height()},hashChange:function(){this.linkScroll=!0,this.win.one("hashchange",(function(){this.linkScroll=!1}))},toggleCurrent:function(n){var e=n.closest("li");e.siblings("li.current").removeClass("current").attr("aria-expanded","false"),e.siblings().find("li.current").removeClass("current").attr("aria-expanded","false");var t=e.find("> ul li");t.length&&(t.removeClass("current").attr("aria-expanded","false"),e.toggleClass("current").attr("aria-expanded",(function(n,e){return"true"==e?"false":"true"})))}},"undefined"!=typeof window&&(window.SphinxRtdTheme={Navigation:n.exports.ThemeNav,StickyNav:n.exports.ThemeNav}),function(){for(var n=0,e=["ms","moz","webkit","o"],t=0;t0 + var meq1 = "^(" + C + ")?" + V + C + "(" + V + ")?$"; // [C]VC[V] is m=1 + var mgr1 = "^(" + C + ")?" + V + C + V + C; // [C]VCVC... is m>1 + var s_v = "^(" + C + ")?" + v; // vowel in stem + + this.stemWord = function (w) { + var stem; + var suffix; + var firstch; + var origword = w; + + if (w.length < 3) + return w; + + var re; + var re2; + var re3; + var re4; + + firstch = w.substr(0,1); + if (firstch == "y") + w = firstch.toUpperCase() + w.substr(1); + + // Step 1a + re = /^(.+?)(ss|i)es$/; + re2 = /^(.+?)([^s])s$/; + + if (re.test(w)) + w = w.replace(re,"$1$2"); + else if (re2.test(w)) + w = w.replace(re2,"$1$2"); + + // Step 1b + re = /^(.+?)eed$/; + re2 = /^(.+?)(ed|ing)$/; + if (re.test(w)) { + var fp = re.exec(w); + re = new RegExp(mgr0); + if (re.test(fp[1])) { + re = /.$/; + w = w.replace(re,""); + } + } + else if (re2.test(w)) { + var fp = re2.exec(w); + stem = fp[1]; + re2 = new RegExp(s_v); + if (re2.test(stem)) { + w = stem; + re2 = /(at|bl|iz)$/; + re3 = new RegExp("([^aeiouylsz])\\1$"); + re4 = new RegExp("^" + C + v + "[^aeiouwxy]$"); + if (re2.test(w)) + w = w + "e"; + else if (re3.test(w)) { + re = /.$/; + w = w.replace(re,""); + } + else if (re4.test(w)) + w = w + "e"; + } + } + + // Step 1c + re = /^(.+?)y$/; + if (re.test(w)) { + var fp = re.exec(w); + stem = fp[1]; + re = new RegExp(s_v); + if (re.test(stem)) + w = stem + "i"; + } + + // Step 2 + re = /^(.+?)(ational|tional|enci|anci|izer|bli|alli|entli|eli|ousli|ization|ation|ator|alism|iveness|fulness|ousness|aliti|iviti|biliti|logi)$/; + if (re.test(w)) { + var fp = re.exec(w); + stem = fp[1]; + suffix = fp[2]; + re = new RegExp(mgr0); + if (re.test(stem)) + w = stem + step2list[suffix]; + } + + // Step 3 + re = /^(.+?)(icate|ative|alize|iciti|ical|ful|ness)$/; + if (re.test(w)) { + var fp = re.exec(w); + stem = fp[1]; + suffix = fp[2]; + re = new RegExp(mgr0); + if (re.test(stem)) + w = stem + step3list[suffix]; + } + + // Step 4 + re = /^(.+?)(al|ance|ence|er|ic|able|ible|ant|ement|ment|ent|ou|ism|ate|iti|ous|ive|ize)$/; + re2 = /^(.+?)(s|t)(ion)$/; + if (re.test(w)) { + var fp = re.exec(w); + stem = fp[1]; + re = new RegExp(mgr1); + if (re.test(stem)) + w = stem; + } + else if (re2.test(w)) { + var fp = re2.exec(w); + stem = fp[1] + fp[2]; + re2 = new RegExp(mgr1); + if (re2.test(stem)) + w = stem; + } + + // Step 5 + re = /^(.+?)e$/; + if (re.test(w)) { + var fp = re.exec(w); + stem = fp[1]; + re = new RegExp(mgr1); + re2 = new RegExp(meq1); + re3 = new RegExp("^" + C + v + "[^aeiouwxy]$"); + if (re.test(stem) || (re2.test(stem) && !(re3.test(stem)))) + w = stem; + } + re = /ll$/; + re2 = new RegExp(mgr1); + if (re.test(w) && re2.test(w)) { + re = /.$/; + w = w.replace(re,""); + } + + // and turn initial Y back to y + if (firstch == "y") + w = firstch.toLowerCase() + w.substr(1); + return w; + } +} + diff --git a/_static/minus.png b/_static/minus.png new file mode 100644 index 0000000..d96755f Binary files /dev/null and b/_static/minus.png differ diff --git a/_static/plus.png b/_static/plus.png new file mode 100644 index 0000000..7107cec Binary files /dev/null and b/_static/plus.png differ diff --git a/_static/pygments.css b/_static/pygments.css new file mode 100644 index 0000000..84ab303 --- /dev/null +++ b/_static/pygments.css @@ -0,0 +1,75 @@ +pre { line-height: 125%; } +td.linenos .normal { color: inherit; background-color: transparent; padding-left: 5px; padding-right: 5px; } +span.linenos { color: inherit; background-color: transparent; padding-left: 5px; padding-right: 5px; } +td.linenos .special { color: #000000; background-color: #ffffc0; padding-left: 5px; padding-right: 5px; } +span.linenos.special { color: #000000; background-color: #ffffc0; padding-left: 5px; padding-right: 5px; } +.highlight .hll { background-color: #ffffcc } +.highlight { background: #f8f8f8; } +.highlight .c { color: #3D7B7B; font-style: italic } /* Comment */ +.highlight .err { border: 1px solid #FF0000 } /* Error */ +.highlight .k { color: #008000; font-weight: bold } /* Keyword */ +.highlight .o { color: #666666 } /* Operator */ +.highlight .ch { color: #3D7B7B; font-style: italic } /* Comment.Hashbang */ +.highlight .cm { color: #3D7B7B; font-style: italic } /* Comment.Multiline */ +.highlight .cp { color: #9C6500 } /* Comment.Preproc */ +.highlight .cpf { color: #3D7B7B; font-style: italic } /* Comment.PreprocFile */ +.highlight .c1 { color: #3D7B7B; font-style: italic } /* Comment.Single */ +.highlight .cs { color: #3D7B7B; font-style: italic } /* Comment.Special */ +.highlight .gd { color: #A00000 } /* Generic.Deleted */ +.highlight .ge { font-style: italic } /* Generic.Emph */ +.highlight .ges { font-weight: bold; font-style: italic } /* Generic.EmphStrong */ +.highlight .gr { color: #E40000 } /* Generic.Error */ +.highlight .gh { color: #000080; font-weight: bold } /* Generic.Heading */ +.highlight .gi { color: #008400 } /* Generic.Inserted */ +.highlight .go { color: #717171 } /* Generic.Output */ +.highlight .gp { color: #000080; font-weight: bold } /* Generic.Prompt */ +.highlight .gs { font-weight: bold } /* Generic.Strong */ +.highlight .gu { color: #800080; font-weight: bold } /* Generic.Subheading */ +.highlight .gt { color: #0044DD } /* Generic.Traceback */ +.highlight .kc { color: #008000; font-weight: bold } /* Keyword.Constant */ +.highlight .kd { color: #008000; font-weight: bold } /* Keyword.Declaration */ +.highlight .kn { color: #008000; font-weight: bold } /* Keyword.Namespace */ +.highlight .kp { color: #008000 } /* Keyword.Pseudo */ +.highlight .kr { color: #008000; font-weight: bold } /* Keyword.Reserved */ +.highlight .kt { color: #B00040 } /* Keyword.Type */ +.highlight .m { color: #666666 } /* Literal.Number */ +.highlight .s { color: #BA2121 } /* Literal.String */ +.highlight .na { color: #687822 } /* Name.Attribute */ +.highlight .nb { color: #008000 } /* Name.Builtin */ +.highlight .nc { color: #0000FF; font-weight: bold } /* Name.Class */ +.highlight .no { color: #880000 } /* Name.Constant */ +.highlight .nd { color: #AA22FF } /* Name.Decorator */ +.highlight .ni { color: #717171; font-weight: bold } /* Name.Entity */ +.highlight .ne { color: #CB3F38; font-weight: bold } /* Name.Exception */ +.highlight .nf { color: #0000FF } /* Name.Function */ +.highlight .nl { color: #767600 } /* Name.Label */ +.highlight .nn { color: #0000FF; font-weight: bold } /* Name.Namespace */ +.highlight .nt { color: #008000; font-weight: bold } /* Name.Tag */ +.highlight .nv { color: #19177C } /* Name.Variable */ +.highlight .ow { color: #AA22FF; font-weight: bold } /* Operator.Word */ +.highlight .w { color: #bbbbbb } /* Text.Whitespace */ +.highlight .mb { color: #666666 } /* Literal.Number.Bin */ +.highlight .mf { color: #666666 } /* Literal.Number.Float */ +.highlight .mh { color: #666666 } /* Literal.Number.Hex */ +.highlight .mi { color: #666666 } /* Literal.Number.Integer */ +.highlight .mo { color: #666666 } /* Literal.Number.Oct */ +.highlight .sa { color: #BA2121 } /* Literal.String.Affix */ +.highlight .sb { color: #BA2121 } /* Literal.String.Backtick */ +.highlight .sc { color: #BA2121 } /* Literal.String.Char */ +.highlight .dl { color: #BA2121 } /* Literal.String.Delimiter */ +.highlight .sd { color: #BA2121; font-style: italic } /* Literal.String.Doc */ +.highlight .s2 { color: #BA2121 } /* Literal.String.Double */ +.highlight .se { color: #AA5D1F; font-weight: bold } /* Literal.String.Escape */ +.highlight .sh { color: #BA2121 } /* Literal.String.Heredoc */ +.highlight .si { color: #A45A77; font-weight: bold } /* Literal.String.Interpol */ +.highlight .sx { color: #008000 } /* Literal.String.Other */ +.highlight .sr { color: #A45A77 } /* Literal.String.Regex */ +.highlight .s1 { color: #BA2121 } /* Literal.String.Single */ +.highlight .ss { color: #19177C } /* Literal.String.Symbol */ +.highlight .bp { color: #008000 } /* Name.Builtin.Pseudo */ +.highlight .fm { color: #0000FF } /* Name.Function.Magic */ +.highlight .vc { color: #19177C } /* Name.Variable.Class */ +.highlight .vg { color: #19177C } /* Name.Variable.Global */ +.highlight .vi { color: #19177C } /* Name.Variable.Instance */ +.highlight .vm { color: #19177C } /* Name.Variable.Magic */ +.highlight .il { color: #666666 } /* Literal.Number.Integer.Long */ \ No newline at end of file diff --git a/_static/searchtools.js b/_static/searchtools.js new file mode 100644 index 0000000..7918c3f --- /dev/null +++ b/_static/searchtools.js @@ -0,0 +1,574 @@ +/* + * searchtools.js + * ~~~~~~~~~~~~~~~~ + * + * Sphinx JavaScript utilities for the full-text search. + * + * :copyright: Copyright 2007-2023 by the Sphinx team, see AUTHORS. + * :license: BSD, see LICENSE for details. + * + */ +"use strict"; + +/** + * Simple result scoring code. + */ +if (typeof Scorer === "undefined") { + var Scorer = { + // Implement the following function to further tweak the score for each result + // The function takes a result array [docname, title, anchor, descr, score, filename] + // and returns the new score. + /* + score: result => { + const [docname, title, anchor, descr, score, filename] = result + return score + }, + */ + + // query matches the full name of an object + objNameMatch: 11, + // or matches in the last dotted part of the object name + objPartialMatch: 6, + // Additive scores depending on the priority of the object + objPrio: { + 0: 15, // used to be importantResults + 1: 5, // used to be objectResults + 2: -5, // used to be unimportantResults + }, + // Used when the priority is not in the mapping. + objPrioDefault: 0, + + // query found in title + title: 15, + partialTitle: 7, + // query found in terms + term: 5, + partialTerm: 2, + }; +} + +const _removeChildren = (element) => { + while (element && element.lastChild) element.removeChild(element.lastChild); +}; + +/** + * See https://developer.mozilla.org/en-US/docs/Web/JavaScript/Guide/Regular_Expressions#escaping + */ +const _escapeRegExp = (string) => + string.replace(/[.*+\-?^${}()|[\]\\]/g, "\\$&"); // $& means the whole matched string + +const _displayItem = (item, searchTerms, highlightTerms) => { + const docBuilder = DOCUMENTATION_OPTIONS.BUILDER; + const docFileSuffix = DOCUMENTATION_OPTIONS.FILE_SUFFIX; + const docLinkSuffix = DOCUMENTATION_OPTIONS.LINK_SUFFIX; + const showSearchSummary = DOCUMENTATION_OPTIONS.SHOW_SEARCH_SUMMARY; + const contentRoot = document.documentElement.dataset.content_root; + + const [docName, title, anchor, descr, score, _filename] = item; + + let listItem = document.createElement("li"); + let requestUrl; + let linkUrl; + if (docBuilder === "dirhtml") { + // dirhtml builder + let dirname = docName + "/"; + if (dirname.match(/\/index\/$/)) + dirname = dirname.substring(0, dirname.length - 6); + else if (dirname === "index/") dirname = ""; + requestUrl = contentRoot + dirname; + linkUrl = requestUrl; + } else { + // normal html builders + requestUrl = contentRoot + docName + docFileSuffix; + linkUrl = docName + docLinkSuffix; + } + let linkEl = listItem.appendChild(document.createElement("a")); + linkEl.href = linkUrl + anchor; + linkEl.dataset.score = score; + linkEl.innerHTML = title; + if (descr) { + listItem.appendChild(document.createElement("span")).innerHTML = + " (" + descr + ")"; + // highlight search terms in the description + if (SPHINX_HIGHLIGHT_ENABLED) // set in sphinx_highlight.js + highlightTerms.forEach((term) => _highlightText(listItem, term, "highlighted")); + } + else if (showSearchSummary) + fetch(requestUrl) + .then((responseData) => responseData.text()) + .then((data) => { + if (data) + listItem.appendChild( + Search.makeSearchSummary(data, searchTerms) + ); + // highlight search terms in the summary + if (SPHINX_HIGHLIGHT_ENABLED) // set in sphinx_highlight.js + highlightTerms.forEach((term) => _highlightText(listItem, term, "highlighted")); + }); + Search.output.appendChild(listItem); +}; +const _finishSearch = (resultCount) => { + Search.stopPulse(); + Search.title.innerText = _("Search Results"); + if (!resultCount) + Search.status.innerText = Documentation.gettext( + "Your search did not match any documents. Please make sure that all words are spelled correctly and that you've selected enough categories." + ); + else + Search.status.innerText = _( + `Search finished, found ${resultCount} page(s) matching the search query.` + ); +}; +const _displayNextItem = ( + results, + resultCount, + searchTerms, + highlightTerms, +) => { + // results left, load the summary and display it + // this is intended to be dynamic (don't sub resultsCount) + if (results.length) { + _displayItem(results.pop(), searchTerms, highlightTerms); + setTimeout( + () => _displayNextItem(results, resultCount, searchTerms, highlightTerms), + 5 + ); + } + // search finished, update title and status message + else _finishSearch(resultCount); +}; + +/** + * Default splitQuery function. Can be overridden in ``sphinx.search`` with a + * custom function per language. + * + * The regular expression works by splitting the string on consecutive characters + * that are not Unicode letters, numbers, underscores, or emoji characters. + * This is the same as ``\W+`` in Python, preserving the surrogate pair area. + */ +if (typeof splitQuery === "undefined") { + var splitQuery = (query) => query + .split(/[^\p{Letter}\p{Number}_\p{Emoji_Presentation}]+/gu) + .filter(term => term) // remove remaining empty strings +} + +/** + * Search Module + */ +const Search = { + _index: null, + _queued_query: null, + _pulse_status: -1, + + htmlToText: (htmlString) => { + const htmlElement = new DOMParser().parseFromString(htmlString, 'text/html'); + htmlElement.querySelectorAll(".headerlink").forEach((el) => { el.remove() }); + const docContent = htmlElement.querySelector('[role="main"]'); + if (docContent !== undefined) return docContent.textContent; + console.warn( + "Content block not found. Sphinx search tries to obtain it via '[role=main]'. Could you check your theme or template." + ); + return ""; + }, + + init: () => { + const query = new URLSearchParams(window.location.search).get("q"); + document + .querySelectorAll('input[name="q"]') + .forEach((el) => (el.value = query)); + if (query) Search.performSearch(query); + }, + + loadIndex: (url) => + (document.body.appendChild(document.createElement("script")).src = url), + + setIndex: (index) => { + Search._index = index; + if (Search._queued_query !== null) { + const query = Search._queued_query; + Search._queued_query = null; + Search.query(query); + } + }, + + hasIndex: () => Search._index !== null, + + deferQuery: (query) => (Search._queued_query = query), + + stopPulse: () => (Search._pulse_status = -1), + + startPulse: () => { + if (Search._pulse_status >= 0) return; + + const pulse = () => { + Search._pulse_status = (Search._pulse_status + 1) % 4; + Search.dots.innerText = ".".repeat(Search._pulse_status); + if (Search._pulse_status >= 0) window.setTimeout(pulse, 500); + }; + pulse(); + }, + + /** + * perform a search for something (or wait until index is loaded) + */ + performSearch: (query) => { + // create the required interface elements + const searchText = document.createElement("h2"); + searchText.textContent = _("Searching"); + const searchSummary = document.createElement("p"); + searchSummary.classList.add("search-summary"); + searchSummary.innerText = ""; + const searchList = document.createElement("ul"); + searchList.classList.add("search"); + + const out = document.getElementById("search-results"); + Search.title = out.appendChild(searchText); + Search.dots = Search.title.appendChild(document.createElement("span")); + Search.status = out.appendChild(searchSummary); + Search.output = out.appendChild(searchList); + + const searchProgress = document.getElementById("search-progress"); + // Some themes don't use the search progress node + if (searchProgress) { + searchProgress.innerText = _("Preparing search..."); + } + Search.startPulse(); + + // index already loaded, the browser was quick! + if (Search.hasIndex()) Search.query(query); + else Search.deferQuery(query); + }, + + /** + * execute search (requires search index to be loaded) + */ + query: (query) => { + const filenames = Search._index.filenames; + const docNames = Search._index.docnames; + const titles = Search._index.titles; + const allTitles = Search._index.alltitles; + const indexEntries = Search._index.indexentries; + + // stem the search terms and add them to the correct list + const stemmer = new Stemmer(); + const searchTerms = new Set(); + const excludedTerms = new Set(); + const highlightTerms = new Set(); + const objectTerms = new Set(splitQuery(query.toLowerCase().trim())); + splitQuery(query.trim()).forEach((queryTerm) => { + const queryTermLower = queryTerm.toLowerCase(); + + // maybe skip this "word" + // stopwords array is from language_data.js + if ( + stopwords.indexOf(queryTermLower) !== -1 || + queryTerm.match(/^\d+$/) + ) + return; + + // stem the word + let word = stemmer.stemWord(queryTermLower); + // select the correct list + if (word[0] === "-") excludedTerms.add(word.substr(1)); + else { + searchTerms.add(word); + highlightTerms.add(queryTermLower); + } + }); + + if (SPHINX_HIGHLIGHT_ENABLED) { // set in sphinx_highlight.js + localStorage.setItem("sphinx_highlight_terms", [...highlightTerms].join(" ")) + } + + // console.debug("SEARCH: searching for:"); + // console.info("required: ", [...searchTerms]); + // console.info("excluded: ", [...excludedTerms]); + + // array of [docname, title, anchor, descr, score, filename] + let results = []; + _removeChildren(document.getElementById("search-progress")); + + const queryLower = query.toLowerCase(); + for (const [title, foundTitles] of Object.entries(allTitles)) { + if (title.toLowerCase().includes(queryLower) && (queryLower.length >= title.length/2)) { + for (const [file, id] of foundTitles) { + let score = Math.round(100 * queryLower.length / title.length) + results.push([ + docNames[file], + titles[file] !== title ? `${titles[file]} > ${title}` : title, + id !== null ? "#" + id : "", + null, + score, + filenames[file], + ]); + } + } + } + + // search for explicit entries in index directives + for (const [entry, foundEntries] of Object.entries(indexEntries)) { + if (entry.includes(queryLower) && (queryLower.length >= entry.length/2)) { + for (const [file, id] of foundEntries) { + let score = Math.round(100 * queryLower.length / entry.length) + results.push([ + docNames[file], + titles[file], + id ? "#" + id : "", + null, + score, + filenames[file], + ]); + } + } + } + + // lookup as object + objectTerms.forEach((term) => + results.push(...Search.performObjectSearch(term, objectTerms)) + ); + + // lookup as search terms in fulltext + results.push(...Search.performTermsSearch(searchTerms, excludedTerms)); + + // let the scorer override scores with a custom scoring function + if (Scorer.score) results.forEach((item) => (item[4] = Scorer.score(item))); + + // now sort the results by score (in opposite order of appearance, since the + // display function below uses pop() to retrieve items) and then + // alphabetically + results.sort((a, b) => { + const leftScore = a[4]; + const rightScore = b[4]; + if (leftScore === rightScore) { + // same score: sort alphabetically + const leftTitle = a[1].toLowerCase(); + const rightTitle = b[1].toLowerCase(); + if (leftTitle === rightTitle) return 0; + return leftTitle > rightTitle ? -1 : 1; // inverted is intentional + } + return leftScore > rightScore ? 1 : -1; + }); + + // remove duplicate search results + // note the reversing of results, so that in the case of duplicates, the highest-scoring entry is kept + let seen = new Set(); + results = results.reverse().reduce((acc, result) => { + let resultStr = result.slice(0, 4).concat([result[5]]).map(v => String(v)).join(','); + if (!seen.has(resultStr)) { + acc.push(result); + seen.add(resultStr); + } + return acc; + }, []); + + results = results.reverse(); + + // for debugging + //Search.lastresults = results.slice(); // a copy + // console.info("search results:", Search.lastresults); + + // print the results + _displayNextItem(results, results.length, searchTerms, highlightTerms); + }, + + /** + * search for object names + */ + performObjectSearch: (object, objectTerms) => { + const filenames = Search._index.filenames; + const docNames = Search._index.docnames; + const objects = Search._index.objects; + const objNames = Search._index.objnames; + const titles = Search._index.titles; + + const results = []; + + const objectSearchCallback = (prefix, match) => { + const name = match[4] + const fullname = (prefix ? prefix + "." : "") + name; + const fullnameLower = fullname.toLowerCase(); + if (fullnameLower.indexOf(object) < 0) return; + + let score = 0; + const parts = fullnameLower.split("."); + + // check for different match types: exact matches of full name or + // "last name" (i.e. last dotted part) + if (fullnameLower === object || parts.slice(-1)[0] === object) + score += Scorer.objNameMatch; + else if (parts.slice(-1)[0].indexOf(object) > -1) + score += Scorer.objPartialMatch; // matches in last name + + const objName = objNames[match[1]][2]; + const title = titles[match[0]]; + + // If more than one term searched for, we require other words to be + // found in the name/title/description + const otherTerms = new Set(objectTerms); + otherTerms.delete(object); + if (otherTerms.size > 0) { + const haystack = `${prefix} ${name} ${objName} ${title}`.toLowerCase(); + if ( + [...otherTerms].some((otherTerm) => haystack.indexOf(otherTerm) < 0) + ) + return; + } + + let anchor = match[3]; + if (anchor === "") anchor = fullname; + else if (anchor === "-") anchor = objNames[match[1]][1] + "-" + fullname; + + const descr = objName + _(", in ") + title; + + // add custom score for some objects according to scorer + if (Scorer.objPrio.hasOwnProperty(match[2])) + score += Scorer.objPrio[match[2]]; + else score += Scorer.objPrioDefault; + + results.push([ + docNames[match[0]], + fullname, + "#" + anchor, + descr, + score, + filenames[match[0]], + ]); + }; + Object.keys(objects).forEach((prefix) => + objects[prefix].forEach((array) => + objectSearchCallback(prefix, array) + ) + ); + return results; + }, + + /** + * search for full-text terms in the index + */ + performTermsSearch: (searchTerms, excludedTerms) => { + // prepare search + const terms = Search._index.terms; + const titleTerms = Search._index.titleterms; + const filenames = Search._index.filenames; + const docNames = Search._index.docnames; + const titles = Search._index.titles; + + const scoreMap = new Map(); + const fileMap = new Map(); + + // perform the search on the required terms + searchTerms.forEach((word) => { + const files = []; + const arr = [ + { files: terms[word], score: Scorer.term }, + { files: titleTerms[word], score: Scorer.title }, + ]; + // add support for partial matches + if (word.length > 2) { + const escapedWord = _escapeRegExp(word); + Object.keys(terms).forEach((term) => { + if (term.match(escapedWord) && !terms[word]) + arr.push({ files: terms[term], score: Scorer.partialTerm }); + }); + Object.keys(titleTerms).forEach((term) => { + if (term.match(escapedWord) && !titleTerms[word]) + arr.push({ files: titleTerms[word], score: Scorer.partialTitle }); + }); + } + + // no match but word was a required one + if (arr.every((record) => record.files === undefined)) return; + + // found search word in contents + arr.forEach((record) => { + if (record.files === undefined) return; + + let recordFiles = record.files; + if (recordFiles.length === undefined) recordFiles = [recordFiles]; + files.push(...recordFiles); + + // set score for the word in each file + recordFiles.forEach((file) => { + if (!scoreMap.has(file)) scoreMap.set(file, {}); + scoreMap.get(file)[word] = record.score; + }); + }); + + // create the mapping + files.forEach((file) => { + if (fileMap.has(file) && fileMap.get(file).indexOf(word) === -1) + fileMap.get(file).push(word); + else fileMap.set(file, [word]); + }); + }); + + // now check if the files don't contain excluded terms + const results = []; + for (const [file, wordList] of fileMap) { + // check if all requirements are matched + + // as search terms with length < 3 are discarded + const filteredTermCount = [...searchTerms].filter( + (term) => term.length > 2 + ).length; + if ( + wordList.length !== searchTerms.size && + wordList.length !== filteredTermCount + ) + continue; + + // ensure that none of the excluded terms is in the search result + if ( + [...excludedTerms].some( + (term) => + terms[term] === file || + titleTerms[term] === file || + (terms[term] || []).includes(file) || + (titleTerms[term] || []).includes(file) + ) + ) + break; + + // select one (max) score for the file. + const score = Math.max(...wordList.map((w) => scoreMap.get(file)[w])); + // add result to the result list + results.push([ + docNames[file], + titles[file], + "", + null, + score, + filenames[file], + ]); + } + return results; + }, + + /** + * helper function to return a node containing the + * search summary for a given text. keywords is a list + * of stemmed words. + */ + makeSearchSummary: (htmlText, keywords) => { + const text = Search.htmlToText(htmlText); + if (text === "") return null; + + const textLower = text.toLowerCase(); + const actualStartPosition = [...keywords] + .map((k) => textLower.indexOf(k.toLowerCase())) + .filter((i) => i > -1) + .slice(-1)[0]; + const startWithContext = Math.max(actualStartPosition - 120, 0); + + const top = startWithContext === 0 ? "" : "..."; + const tail = startWithContext + 240 < text.length ? "..." : ""; + + let summary = document.createElement("p"); + summary.classList.add("context"); + summary.textContent = top + text.substr(startWithContext, 240).trim() + tail; + + return summary; + }, +}; + +_ready(Search.init); diff --git a/_static/sphinx_highlight.js b/_static/sphinx_highlight.js new file mode 100644 index 0000000..8a96c69 --- /dev/null +++ b/_static/sphinx_highlight.js @@ -0,0 +1,154 @@ +/* Highlighting utilities for Sphinx HTML documentation. */ +"use strict"; + +const SPHINX_HIGHLIGHT_ENABLED = true + +/** + * highlight a given string on a node by wrapping it in + * span elements with the given class name. + */ +const _highlight = (node, addItems, text, className) => { + if (node.nodeType === Node.TEXT_NODE) { + const val = node.nodeValue; + const parent = node.parentNode; + const pos = val.toLowerCase().indexOf(text); + if ( + pos >= 0 && + !parent.classList.contains(className) && + !parent.classList.contains("nohighlight") + ) { + let span; + + const closestNode = parent.closest("body, svg, foreignObject"); + const isInSVG = closestNode && closestNode.matches("svg"); + if (isInSVG) { + span = document.createElementNS("http://www.w3.org/2000/svg", "tspan"); + } else { + span = document.createElement("span"); + span.classList.add(className); + } + + span.appendChild(document.createTextNode(val.substr(pos, text.length))); + const rest = document.createTextNode(val.substr(pos + text.length)); + parent.insertBefore( + span, + parent.insertBefore( + rest, + node.nextSibling + ) + ); + node.nodeValue = val.substr(0, pos); + /* There may be more occurrences of search term in this node. So call this + * function recursively on the remaining fragment. + */ + _highlight(rest, addItems, text, className); + + if (isInSVG) { + const rect = document.createElementNS( + "http://www.w3.org/2000/svg", + "rect" + ); + const bbox = parent.getBBox(); + rect.x.baseVal.value = bbox.x; + rect.y.baseVal.value = bbox.y; + rect.width.baseVal.value = bbox.width; + rect.height.baseVal.value = bbox.height; + rect.setAttribute("class", className); + addItems.push({ parent: parent, target: rect }); + } + } + } else if (node.matches && !node.matches("button, select, textarea")) { + node.childNodes.forEach((el) => _highlight(el, addItems, text, className)); + } +}; +const _highlightText = (thisNode, text, className) => { + let addItems = []; + _highlight(thisNode, addItems, text, className); + addItems.forEach((obj) => + obj.parent.insertAdjacentElement("beforebegin", obj.target) + ); +}; + +/** + * Small JavaScript module for the documentation. + */ +const SphinxHighlight = { + + /** + * highlight the search words provided in localstorage in the text + */ + highlightSearchWords: () => { + if (!SPHINX_HIGHLIGHT_ENABLED) return; // bail if no highlight + + // get and clear terms from localstorage + const url = new URL(window.location); + const highlight = + localStorage.getItem("sphinx_highlight_terms") + || url.searchParams.get("highlight") + || ""; + localStorage.removeItem("sphinx_highlight_terms") + url.searchParams.delete("highlight"); + window.history.replaceState({}, "", url); + + // get individual terms from highlight string + const terms = highlight.toLowerCase().split(/\s+/).filter(x => x); + if (terms.length === 0) return; // nothing to do + + // There should never be more than one element matching "div.body" + const divBody = document.querySelectorAll("div.body"); + const body = divBody.length ? divBody[0] : document.querySelector("body"); + window.setTimeout(() => { + terms.forEach((term) => _highlightText(body, term, "highlighted")); + }, 10); + + const searchBox = document.getElementById("searchbox"); + if (searchBox === null) return; + searchBox.appendChild( + document + .createRange() + .createContextualFragment( + '" + ) + ); + }, + + /** + * helper function to hide the search marks again + */ + hideSearchWords: () => { + document + .querySelectorAll("#searchbox .highlight-link") + .forEach((el) => el.remove()); + document + .querySelectorAll("span.highlighted") + .forEach((el) => el.classList.remove("highlighted")); + localStorage.removeItem("sphinx_highlight_terms") + }, + + initEscapeListener: () => { + // only install a listener if it is really needed + if (!DOCUMENTATION_OPTIONS.ENABLE_SEARCH_SHORTCUTS) return; + + document.addEventListener("keydown", (event) => { + // bail for input elements + if (BLACKLISTED_KEY_CONTROL_ELEMENTS.has(document.activeElement.tagName)) return; + // bail with special keys + if (event.shiftKey || event.altKey || event.ctrlKey || event.metaKey) return; + if (DOCUMENTATION_OPTIONS.ENABLE_SEARCH_SHORTCUTS && (event.key === "Escape")) { + SphinxHighlight.hideSearchWords(); + event.preventDefault(); + } + }); + }, +}; + +_ready(() => { + /* Do not call highlightSearchWords() when we are on the search page. + * It will highlight words from the *previous* search query. + */ + if (typeof Search === "undefined") SphinxHighlight.highlightSearchWords(); + SphinxHighlight.initEscapeListener(); +}); diff --git a/cran.html b/cran.html new file mode 100644 index 0000000..fa468ea --- /dev/null +++ b/cran.html @@ -0,0 +1,844 @@ + + + + + + + CRAN module — MaRDI Importer documentation + + + + + + + + + + + + + + + + + + + +
+ + +
+ +
+
+
+ +
+
+
+
+ +
+

CRAN module

+

This module imports R packages published at the Comprehensive R Archive Network (CRAN).

+

Specifically, it reads the table of packages ordered by date of publication. +This table contains for each R package the package name, title and date of publication. Based on the package name, +each package url can be accessed from:

+

https://cran.r-project.org/web/packages/<package_name>/index.html

+

Several attributes are listed for each package. Among them, the following attributes are imported, when present, to the MaRDI knowledge graph:

+
+
Version:
+

Version of the package.

+
+
Depends:
+

Software and package dependencies, including other R packages.

+
+
Published:
+

Date of publication.

+
+
Author:
+

Authors of the package are to be indicated according to the CRAN Repository Policy with the abbreviation [aut]. Given that this guideline is not always implemented, it is not always +possible to properly parse the authors.

+

When no abbrevations describing the role of each individual are included, just the first listed author is imported.

+
+
License:
+

List of accepted licenses.

+
+
Maintainer:
+

Software maintainer (Generally one of the authors).

+
+
+
+

mardi_importer.cran.CRANSource class

+
+
+class mardi_importer.cran.CRANSource.CRANSource[source]
+

Bases: ADataSource

+

Processes data from the Comprehensive R Archive Network.

+

Metadata for each R package is scrapped from the CRAN Repository. Each +Wikibase item corresponding to each R package is subsequently updated +or created, in case of a new package.

+
+
+packages
+

Dataframe with package name, title and date of publication for +each package in CRAN.

+
+
Type:
+

Pandas dataframe

+
+
+
+ +
+
+setup()[source]
+

Create all necessary properties and entities for CRAN

+
+ +
+
+create_local_entities()[source]
+
+ +
+
+pull()[source]
+

Reads date, package name and title from the CRAN Repository URL.

+

The result is saved as a pandas dataframe in the attribute packages.

+
+
Returns:
+

Attribute packages

+
+
Return type:
+

Pandas dataframe

+
+
Raises:
+

ImporterException – If table at the CRAN url cannot be accessed or read.

+
+
+
+ +
+
+push()[source]
+

Updates the MaRDI Wikibase entities corresponding to R packages.

+

For each package name in the attribute packages checks +if the date in CRAN coincides with the date in the MaRDI +knowledge graph. If not, the package is updated. If the package +is not found in the MaRDI knowledge graph, the corresponding +item is created.

+

It creates a mardi_importer.cran.RPackage instance +for each package.

+
+ +
+ +
+
+

mardi_importer.cran.RPackage class

+
+
+class mardi_importer.cran.RPackage.RPackage(date: str, label: str, description: str, api: ~mardi_importer.integrator.MardiIntegrator.MardiIntegrator, long_description: str = '', url: str = '', version: str = '', versions: ~typing.List[~typing.Tuple[str, str]] = <factory>, authors: ~typing.List[~mardi_importer.publications.Author.Author] = <factory>, license_data: ~typing.List[~typing.Tuple[str, str]] = <factory>, dependencies: ~typing.List[~typing.Tuple[str, str]] = <factory>, imports: ~typing.List[~typing.Tuple[str, str]] = <factory>, maintainer: str = '', author_pool: ~typing.List[~mardi_importer.publications.Author.Author] = <factory>, crossref_publications: ~typing.List[~mardi_importer.publications.CrossrefPublication.CrossrefPublication] = <factory>, arxiv_publications: ~typing.List[~mardi_importer.publications.ArxivPublication.ArxivPublication] = <factory>, zenodo_resources: ~typing.List[~mardi_importer.publications.ZenodoResource.ZenodoResource] = <factory>, _QID: str = '', _item: ~mardi_importer.integrator.MardiEntities.MardiItemEntity = None)[source]
+

Bases: object

+

Class to manage R package items in the local Wikibase instance.

+
+
+date
+

Date of publication

+
+
Type:
+

str

+
+
+
+ +
+
+label
+

Package name

+
+
Type:
+

str

+
+
+
+ +
+
+description
+

Title of the R package

+
+
Type:
+

str

+
+
+
+ +
+
+long_description
+

Detailed description of the R package

+
+
Type:
+

str

+
+
+
+ +
+
+url
+

URL to the CRAN repository

+
+
Type:
+

str

+
+
+
+ +
+
+version
+

Version of the R package

+
+
Type:
+

str

+
+
+
+ +
+
+versions
+

Previous published versions

+
+
Type:
+

List[Tuple[str, str]]

+
+
+
+ +
+
+author
+

Author(s) of the package

+
+ +
+
+license
+

Software license

+
+ +
+
+dependency
+

Dependencies to R and other packages

+
+ +
+
+imports
+

Imported R packages

+
+
Type:
+

List[Tuple[str, str]]

+
+
+
+ +
+
+maintainer
+

Software maintainer

+
+
Type:
+

str

+
+
+
+ +
+
+_QID
+

Package QID

+
+
Type:
+

str

+
+
+
+ +
+
+integrator
+

API to MaRDI integrator

+
+ +
+
+date: str
+
+ +
+
+label: str
+
+ +
+
+description: str
+
+ +
+
+api: MardiIntegrator
+
+ +
+
+long_description: str = ''
+
+ +
+
+url: str = ''
+
+ +
+
+version: str = ''
+
+ +
+
+versions: List[Tuple[str, str]]
+
+ +
+
+authors: List[Author]
+
+ +
+
+license_data: List[Tuple[str, str]]
+
+ +
+
+dependencies: List[Tuple[str, str]]
+
+ +
+
+imports: List[Tuple[str, str]]
+
+ +
+
+maintainer: str = ''
+
+ +
+
+author_pool: List[Author]
+
+ +
+
+crossref_publications: List[CrossrefPublication]
+
+ +
+
+arxiv_publications: List[ArxivPublication]
+
+ +
+
+zenodo_resources: List[ZenodoResource]
+
+ +
+
+property QID: str
+

Return the QID of the R package in the knowledge graph.

+

Searches for an item with the package label in the Wikibase +SQL tables and returns the QID if a matching result is found.

+
+
Returns:
+

The entity QID representing the R package.

+
+
Return type:
+

str

+
+
+
+ +
+
+property item: MardiItemEntity
+

Return the integrator Item representing the R package.

+

Adds also the label and description of the package.

+
+
Returns:
+

Integrator item

+
+
Return type:
+

MardiItemEntity

+
+
+
+ +
+
+exists() str[source]
+

Checks if an item corresponding to the R package already exists.

+
+
Returns:
+

Entity ID

+
+
Return type:
+

str

+
+
+
+ +
+
+is_updated() bool[source]
+

Checks if the Item corresponding to the R package is up to date.

+

Compares the last update property in the local knowledge graph with +the publication date imported from CRAN.

+
+
Returns:
+

True if both dates coincide, False otherwise.

+
+
Return type:
+

bool

+
+
+
+ +
+
+pull()[source]
+

Imports metadata from CRAN corresponding to the R package.

+

Imports Version, Dependencies, Imports**m **Authors, +Maintainer and License and saves them as instance +attributes.

+
+ +
+
+create() None[source]
+

Create a package in the Wikibase instance.

+

This function pulls the package, inserts its claims, and writes +it to the Wikibase instance.

+
+
Returns:
+

None

+
+
+
+ +
+
+write() Dict[str, str] | None[source]
+

Write the package item to the Wikibase instance.

+

If the item has claims, it will be written to the Wikibase instance. +If the item is successfully written, a dictionary with the QID of the +item will be returned.

+
+
Returns:
+

A dictionary with the QID of the written item if successful, +or None otherwise.

+
+
Return type:
+

Optional[Dict[str, str]]

+
+
+
+ +
+
+insert_claims()[source]
+
+ +
+
+update()[source]
+

Updates existing WB item with the imported metadata from CRAN.

+

The metadata corresponding to the package is first pulled from CRAN and +saved as instance attributes through pull(). The statements that +do not coincide with the locally saved information are updated or +subsituted with the updated information.

+

Uses mardi_importer.wikibase.WBItem to update the item +corresponding to the R package.

+
+
Returns:
+

ID of the updated R package.

+
+
Return type:
+

str

+
+
+
+ +
+
+process_claims(data, prop_nr, qualifier_nr=None)[source]
+
+ +
+
+parse_publications(description)[source]
+

Extracts the DOI identification of related publications.

+

Identifies the DOI of publications that are mentioned using the +format doi: or arXiv: in the long description of the +R package.

+
+
Returns:
+

List containing the wikibase IDs of mentioned publications.

+
+
Return type:
+

List

+
+
+
+ +
+
+get_last_update()[source]
+

Returns the package last update date saved in the Wikibase instance.

+
+
Returns:
+

Last update date in format DD-MM-YYYY.

+
+
Return type:
+

str

+
+
+
+ +
+
+clean_package_list(table_html)[source]
+

Processes raw imported data from CRAN to enable the creation of items.

+
    +
  • Package dependencies are splitted at the comma position.

  • +
  • License information is processed using the parse_license() method.

  • +
  • Author information is processed using the parse_authors() method.

  • +
  • Maintainer information is processed using the parse_maintainer() method.

  • +
+
+
Parameters:
+

table_html – HTML code obtained with BeautifulSoup corresponding to the table +containing the metadata of the R package imported from CRAN.

+
+
Returns:
+

Dataframe with processed data from a single R package including columns: +Version, Author, License, Depends, Imports +and Maintainer.

+
+
Return type:
+

(Pandas dataframe)

+
+
+
+ +
+
+parse_software(software_str: str) List[Tuple[str, str]][source]
+

Processes the dependency and import information of each R package.

+

This includes: +- Extracting the version information of each dependency/import if provided. +- Providing the Item QID given the dependency/import label. +- Creating a new Item if the dependency/import is not found in the

+
+

local knowledge graph.

+
+
+
Returns:
+

List of tuples including software QID and version.

+
+
Return type:
+

List[Tuple[str, str]]

+
+
+
+ +
+
+parse_license(x: str) List[Tuple[str, str]][source]
+

Splits string of licenses.

+

Takes into account that licenses are often not uniformly listed. +Characters |, + and , are used to separate licenses. Further +details on each license are often included in square brackets.

+

The concrete License is identified and linked to the corresponding +item that has previously been imported from Wikidata. Further license +information, when provided between round or square brackets, is added +as a qualifier.

+

If a file license is mentioned, the linked to the file license +in CRAN is added as a qualifier.

+
+
Parameters:
+

x (str) – String imported from CRAN representing license +information.

+
+
Returns:
+

List of license tuples. Each tuple contains the license QID +as the first element and the license qualifier as the +second element.

+
+
Return type:
+

List[Tuple[str, str]]

+
+
+
+ +
+
+parse_authors(x)[source]
+

Splits the string corresponding to the authors into a dictionary.

+

Author information in CRAN is not registered uniformly. This function +parses the imported string and returns just the names of the individuals +that can be unequivocally identified as authors (i.e. they are followed +by the [aut] abbreviation).

+

Generally, authors in CRAN are indicated with the abbreviation [aut]. +When no abbreviations are included, only the first individual is imported +to Wikibase (otherwise it can often not be established whether +information after the first author refers to another individual, +an institution, a funder, etc.)

+
+
Parameters:
+

x (String) – String imported from CRAN representing author +information.

+
+
Returns:
+

Dictionary of authors and corresponding ORCID ID, if provided.

+
+
Return type:
+

(Dict)

+
+
+
+ +
+
+parse_maintainer(name: str) str[source]
+

Remove unnecessary information from maintainer string.

+
+
Parameters:
+

x (str) – String imported from CRAN which may contain e-mail +address and comments within brackets

+
+
Returns:
+

Name of the maintainer

+
+
Return type:
+

(str)

+
+
+
+ +
+
+get_license_QID(license_str: str) str[source]
+

Returns the Wikidata item ID corresponding to a software license.

+

The same license is often denominated in CRAN using differents names. +This function returns the wikidata item ID corresponding to a single +unique license that is referenced in CRAN under different names (e.g. +Artistic-2.0 and Artistic License 2.0 both refer to the same +license, corresponding to item Q14624826).

+
+
Parameters:
+

license_str (str) – String corresponding to a license imported from CRAN.

+
+
Returns:
+

Wikidata item ID.

+
+
Return type:
+

(str)

+
+
+
+ +
+
+get_wikidata_QID() str | None[source]
+

Get the Wikidata QID for the R package.

+

Searches for the R package in Wikidata using its label. Retrieves +the QID of matching entities and checks if there is an instance of +an R package. If so, returns the QID.

+
+
Returns:
+

The Wikidata QID of the R package if found, or None otherwise.

+
+
Return type:
+

Optional[str]

+
+
+
+ +
+
+get_versions()[source]
+
+ +
+ +
+
+ + +
+
+ +
+
+
+
+ + + + \ No newline at end of file diff --git a/genindex.html b/genindex.html new file mode 100644 index 0000000..9cbd39c --- /dev/null +++ b/genindex.html @@ -0,0 +1,573 @@ + + + + + + Index — MaRDI Importer documentation + + + + + + + + + + + + + + + + + +
+ + +
+ +
+
+
+
    +
  • + +
  • +
  • +
+
+
+
+
+ + +

Index

+ +
+ _ + | A + | C + | D + | E + | G + | I + | L + | M + | N + | O + | P + | Q + | R + | S + | U + | V + | W + | Z + +
+

_

+ + +
+ +

A

+ + + +
+ +

C

+ + + +
+ +

D

+ + + +
+ +

E

+ + +
+ +

G

+ + + +
+ +

I

+ + + +
+ +

L

+ + + +
+ +

M

+ + + +
+ +

N

+ + +
+ +

O

+ + +
+ +

P

+ + + +
+ +

Q

+ + + +
+ +

R

+ + +
+ +

S

+ + +
+ +

U

+ + + +
+ +

V

+ + + +
+ +

W

+ + + +
+ +

Z

+ + + +
+ + + +
+
+ +
+
+
+
+ + + + \ No newline at end of file diff --git a/importer.html b/importer.html new file mode 100644 index 0000000..2baf599 --- /dev/null +++ b/importer.html @@ -0,0 +1,215 @@ + + + + + + + mardi_importer.importer module — MaRDI Importer documentation + + + + + + + + + + + + + + + + + + + +
+ + +
+ +
+
+
+ +
+
+
+
+ +
+

mardi_importer.importer module

+
+

mardi_importer.importer.Importer module

+

Created on Thu Feb 17 18:53:53 2022

+

@author: alvaro

+
+
+class mardi_importer.importer.Importer.AConfigParser[source]
+

Bases: object

+

Abstract base class for parsing config files

+
+
+parse_config()[source]
+

Parse config file. +:returns: Dictionary containing config values +:rtype: Dictionary

+
+ +
+ +
+
+class mardi_importer.importer.Importer.ADataSource[source]
+

Bases: object

+

Abstract base class for reading data from external sources.

+
+
+process_data()[source]
+

Process data dump.

+
+ +
+
+pull()[source]
+

Pull data from DataSource

+
+ +
+
+push()[source]
+

Push data into the MaRDI knowledge graph.

+
+ +
+
+write_data_dump()[source]
+

Write data dump from API.

+
+ +
+ +
+
+class mardi_importer.importer.Importer.Importer(dataSource)[source]
+

Bases: object

+

Controller class for importing data from an external source to the local Wikibase.

+
+
+import_all(pull=True, push=True)[source]
+

Manages the import process.

+
+ +
+ +
+
+exception mardi_importer.importer.Importer.ImporterException[source]
+

Bases: Exception

+

Failed importer operation.

+
+ +
+
+ + +
+
+ +
+
+
+
+ + + + \ No newline at end of file diff --git a/index.html b/index.html new file mode 100644 index 0000000..9ee794e --- /dev/null +++ b/index.html @@ -0,0 +1,179 @@ + + + + + + + MaRDI Importer Documentation — MaRDI Importer documentation + + + + + + + + + + + + + + + + + + + + + + + \ No newline at end of file diff --git a/integrator.html b/integrator.html new file mode 100644 index 0000000..2a6e978 --- /dev/null +++ b/integrator.html @@ -0,0 +1,584 @@ + + + + + + + mardi_importer.integrator module — MaRDI Importer documentation + + + + + + + + + + + + + + + + + + + +
+ + +
+ +
+
+
+ +
+
+
+
+ +
+

mardi_importer.integrator module

+
+

mardi_importer.integrator.MardiIntegrator module

+
+
+class mardi_importer.integrator.MardiIntegrator.MardiIntegrator(languages=['en', 'de'])[source]
+

Bases: MardiClient

+
+
+config()[source]
+

Sets up initial configuration for the integrator

+
+
Returns:
+

Clientlogin object

+
+
+
+ +
+
+convert_claim_ids(entity)[source]
+

Function for in-place conversion of wikidata +ids found in claims into local ids

+
+
Parameters:
+

entity

+
+
Returns:
+

None

+
+
+
+ +
+ +

Function for in-place conversion of unit for quantity +and globe for globecoordinate to a link to the local entity +instead of a link to the wikidata entity.

+
+
Parameters:
+

snak – a wikibaseintegrator snak

+
+
Returns:
+

None

+
+
+
+ +
+
+create_db_table()[source]
+

Check if db table for id mapping is there; if not, create.

+
+
Parameters:
+

None

+
+
Returns:
+

None

+
+
+
+ +
+
+create_engine()[source]
+

Creates SQLalchemy engine

+
+
Returns:
+

SQLalchemy engine

+
+
+
+ +
+
+create_id_list_from_file(file)[source]
+

Function for creating a list of ids +from a while where each id is in a new line

+
+
Parameters:
+

file – path to file

+
+
+

Returns: list of ids

+
+ +
+
+get_local_id_by_label(entity_str, entity_type)[source]
+

Check if entity with a given label or wikidata PID/QID +exists in the local wikibase instance.

+
+
Parameters:
+
    +
  • entity_str (str) – It can be a string label or a wikidata ID, +specified with the prefix wdt: for properties and wd: +for items.

  • +
  • entity_type (str) – Either ‘property’ or ‘item’ to specify +which type of entity to look for.

  • +
+
+
Returns:
+

Local ID of the entity, if found.

+
+
Return type:
+

str

+
+
+
+ +
+
+get_qualifiers(claim)[source]
+

Function for creating qualifiers from wikidata qualifiers +and in place adding them to the claim

+
+
Parameters:
+

claim – a wikibaseintegrator claim

+
+
Returns:
+

Qualifiers object, can also be an empty object

+
+
+
+ +
+
+get_references(claim)[source]
+

Function for creating references from wikidata references +and in place adding them to the claim

+
+
Parameters:
+

claim – a wikibaseintegrator claim

+
+
Returns:
+

List with references, can also be an empty list

+
+
+
+ +
+
+get_wikidata_information(wikidata_id, recurse=False)[source]
+

Function for pulling wikidata information

+
+
Parameters:
+
    +
  • wikidata_id (str) – wikidata id of the desired entity

  • +
  • recurse (Bool) – if claims should also be imported

  • +
+
+
+

Returns: wikibase integrator entity or None, if the entity has no labels

+
+ +
+
+import_claim_entities(wikidata_id)[source]
+

Function for importing entities that are mentioned +in claims from wikidata to the local wikibase instance

+
+
Parameters:
+

wikidata_id (str) – id of the entity to be imported

+
+
Returns:
+

local id or None, if the entity had no labels

+
+
+
+ +
+
+import_entities(id_list=None, filename='', recurse=True)[source]
+

Function for importing entities from wikidata +into the local instance.

+

It can accept a single id, a list of ids or a file containing +a the ids to be imported.

+
+
Parameters:
+
    +
  • id_list – Single string or list of strings of wikidata +entity ids. Lexemes not supported.

  • +
  • filename – Filename containing list of entities to be +imported.

  • +
  • recurse – Whether to import claims for the entities in +id_list

  • +
+
+
Returns:
+

Dictionary containing the local ids of +all the imported entities.

+
+
Return type:
+

Imported entities (Dict)

+
+
+
+ +
+
+import_from_label(label)[source]
+

Imports an entity from Wikidata just from a label

+
+
Parameters:
+

label (str) – label to be imported from wikidata

+
+
Returns:
+

local id for the imported entity

+
+
Return type:
+

local_id (str)

+
+
+
+ +
+
+init_wikidata_PID()[source]
+

Searches the wikidata PID property ID to link +properties to its ID in wikidata. When not found, +it creates the property.

+
+
Returns

wikidata_PID (str): wikidata PID property ID

+
+
+
+ +
+
+init_wikidata_QID()[source]
+

Searches the wikidata QID property ID to link +items to its ID in wikidata. When not found, +it creates the property.

+
+
Returns

wikidata_QID (str): wikidata QID property ID

+
+
+
+ +
+
+insert_id_in_db(wikidata_id, local_id, has_all_claims)[source]
+

Insert wikidata_id, local_id and has_all_claims into mapping table.

+
+
Parameters:
+
    +
  • wikidata_id – Wikidata id

  • +
  • local_id – local Wikibase id

  • +
  • has_all_claims – Boolean indicating whether the entity has been +imported with all claims or no claims (i.e. no recurse)

  • +
+
+
Returns:
+

None

+
+
+
+ +
+
+overwrite_entity(wikidata_id, local_id)[source]
+

Function for completing an already existing local entity +with its statements from wikidata.

+
+
Parameters:
+
    +
  • wikidata_id – Wikidata entity ID to be imported.

  • +
  • local_id – Local id of the existing entity that needs to +be completed with further statements.

  • +
+
+
Returns:
+

Local entity ID

+
+
Return type:
+

local_id

+
+
+
+ +
+
+query(parameter, wikidata_id)[source]
+

Query the wb_id_mapping db table for a given parameter.

+

The two important parameters are the local_id and whether the +entity has already been imported with all claims

+
+
Parameters:
+
    +
  • parameter (str) – Either local_id or has_all_claims

  • +
  • wikidata_id (str) – Wikidata ID

  • +
+
+
Returns:
+

+
for local_id returns the local ID if it exists,

otherwise None. For has_all_claims, a boolean is returned.

+
+
+

+
+
Return type:
+

str or boolean

+
+
+
+ +
+
+query_with_local_id(parameter, local_id)[source]
+

Query the wb_id_mapping db table for a given parameter.

+

The two important parameters are the wikidata_id and whether the +entity has already been imported with all claims

+
+
Parameters:
+
    +
  • parameter (str) – Either wikidata_id or has_all_claims

  • +
  • local_id (str) – local ID

  • +
+
+
Returns:
+

+
for wikidata_id returns the wikidata ID if it exists,

otherwise None. For has_all_claims, a boolean is returned.

+
+
+

+
+
Return type:
+

str or boolean

+
+
+
+ +
+
+update_has_all_claims(wikidata_id)[source]
+

Set the has_all_claims property in the wb_id_mapping table +to True for the given wikidata_id.

+
+
Parameters:
+

wikidata_id – Wikidata id to be updated.

+
+
Returns:
+

None

+
+
+
+ +
+ +
+
+

mardi_importer.integrator.MardiEntities module

+
+
+class mardi_importer.integrator.MardiEntities.MardiItemEntity(labels: Labels | None = None, descriptions: Descriptions | None = None, aliases: Aliases | None = None, sitelinks: Sitelinks | None = None, **kwargs: Any)[source]
+

Bases: MardiItem

+
+
+get(entity_id, **kwargs)[source]
+

Request the MediaWiki API to get data for the entity specified in argument.

+
+
Parameters:
+
    +
  • entity_id – The entity_id of the Item entity you want. Must start with a ‘Q’.

  • +
  • kwargs

  • +
+
+
Returns:
+

an ItemEntity instance

+
+
+
+ +
+
+get_QID(alias=False)[source]
+

Creates a list of QID of all items in the local wikibase with the +same label

+
+
Returns:
+

List of QID

+
+
Return type:
+

QIDs (list)

+
+
+
+ +
+
+new(**kwargs)[source]
+
+ +
+ +
+
+class mardi_importer.integrator.MardiEntities.MardiPropertyEntity(datatype: str | WikibaseDatatype | None = None, labels: Labels | None = None, descriptions: Descriptions | None = None, aliases: Aliases | None = None, **kwargs: Any)[source]
+

Bases: MardiProperty

+
+
+get(entity_id, **kwargs)[source]
+
+ +
+
+get_PID()[source]
+

Returns the PID of the property with the same label

+
+ +
+
+new(**kwargs)[source]
+
+ +
+ +
+
+ + +
+
+ +
+
+
+
+ + + + \ No newline at end of file diff --git a/main.html b/main.html new file mode 100644 index 0000000..00e2ad7 --- /dev/null +++ b/main.html @@ -0,0 +1,166 @@ + + + + + + + Introduction — MaRDI Importer documentation + + + + + + + + + + + + + + + + + + + +
+ + +
+ +
+
+
+ +
+
+
+
+ +
+

Introduction

+

What is this about?

+
+
+

Installation

+
+

Without Docker

+

Install the python package of mardi-importer by first installing the +requirements from requirements.txt,

+
pip install -r requirements.txt
+
+
+

Then install the packages via

+
pip install -U -e .
+
+
+

-U enforces reinstalling the package, with -e modifications in +the source files are automatically taken into account.

+

Note: for convenience, local installations not using docker can be placed within +virtual environments by first calling

+
python3 -m venv env
+source env/bin/activate
+
+
+
+
+

With Docker

+

TODO

+
+
+

Build documentation

+

In docs/, run make html to generate the documentation for a +local installation. The modules have to be installed and findable by import +module. To view the docs, open the file docs/_build/html/index.html.

+
+
+
+

Usage

+

TODO

+
+ + +
+
+ +
+
+
+
+ + + + \ No newline at end of file diff --git a/objects.inv b/objects.inv new file mode 100644 index 0000000..0fdda28 Binary files /dev/null and b/objects.inv differ diff --git a/polydb.html b/polydb.html new file mode 100644 index 0000000..c26efaa --- /dev/null +++ b/polydb.html @@ -0,0 +1,129 @@ + + + + + + + mardi_importer.polydb module — MaRDI Importer documentation + + + + + + + + + + + + + + + + + + + +
+ + +
+ +
+
+
+ +
+
+
+
+ +
+

mardi_importer.polydb module

+
+

mardi_importer.polydb.PolyDBSource module

+
+
+ + +
+
+ +
+
+
+
+ + + + \ No newline at end of file diff --git a/py-modindex.html b/py-modindex.html new file mode 100644 index 0000000..2d1552e --- /dev/null +++ b/py-modindex.html @@ -0,0 +1,174 @@ + + + + + + Python Module Index — MaRDI Importer documentation + + + + + + + + + + + + + + + + + + + + +
+ + +
+ +
+
+
+
    +
  • + +
  • +
  • +
+
+
+
+
+ + +

Python Module Index

+ +
+ m +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
 
+ m
+ mardi_importer +
    + mardi_importer.cran.CRANSource +
    + mardi_importer.cran.RPackage +
    + mardi_importer.importer.Importer +
    + mardi_importer.integrator.MardiEntities +
    + mardi_importer.integrator.MardiIntegrator +
    + mardi_importer.polydb +
    + mardi_importer.zbmath.misc +
    + mardi_importer.zbmath.ZBMathSource +
+ + +
+
+ +
+
+
+
+ + + + \ No newline at end of file diff --git a/scripts.html b/scripts.html new file mode 100644 index 0000000..fec89ab --- /dev/null +++ b/scripts.html @@ -0,0 +1,143 @@ + + + + + + + Launcher script — MaRDI Importer documentation + + + + + + + + + + + + + + + + + + + +
+ + +
+ +
+
+
+ +
+
+
+
+ +
+

Launcher script

+
usage: import.py [-h] --mode {ZBMath,CRAN,polydb,OpenML}
+                 [--conf_path CONF_PATH]
+                 [--wikidata_id_file_path WIKIDATA_ID_FILE_PATH]
+
+
+
+

Named Arguments

+
+
--mode
+

Possible choices: ZBMath, CRAN, polydb, OpenML

+
+
--conf_path
+
+
--wikidata_id_file_path
+
+
+
+
+ + +
+
+ +
+
+
+
+ + + + \ No newline at end of file diff --git a/search.html b/search.html new file mode 100644 index 0000000..3a76551 --- /dev/null +++ b/search.html @@ -0,0 +1,134 @@ + + + + + + Search — MaRDI Importer documentation + + + + + + + + + + + + + + + + + + + + +
+ + +
+ +
+
+
+
    +
  • + +
  • +
  • +
+
+
+
+
+ + + + +
+ +
+ +
+
+ +
+
+
+
+ + + + + + + + + \ No newline at end of file diff --git a/searchindex.js b/searchindex.js new file mode 100644 index 0000000..65eabf6 --- /dev/null +++ b/searchindex.js @@ -0,0 +1 @@ +Search.setIndex({"docnames": ["cran", "importer", "index", "integrator", "main", "polydb", "scripts", "tech", "zbmath"], "filenames": ["cran.rst", "importer.rst", "index.rst", "integrator.rst", "main.rst", "polydb.rst", "scripts.rst", "tech.rst", "zbmath.rst"], "titles": ["CRAN module", "mardi_importer.importer module", "MaRDI Importer Documentation", "mardi_importer.integrator module", "Introduction", "mardi_importer.polydb module", "Launcher script", "Importer diagram", "mardi_importer.zbmath module"], "terms": {"thi": [0, 2, 4, 8], "import": [0, 3, 4, 6], "r": [0, 4], "packag": [0, 4], "publish": 0, "comprehens": 0, "archiv": 0, "network": 0, "specif": [0, 8], "read": [0, 1, 8], "tabl": [0, 3], "order": 0, "date": [0, 8], "public": [0, 8], "contain": [0, 1, 3], "each": [0, 3, 8], "name": [0, 2, 8], "titl": [0, 8], "base": [0, 1, 3, 8], "url": [0, 8], "can": [0, 3, 4], "access": 0, "from": [0, 1, 3, 4, 8], "http": 0, "project": 0, "org": 0, "web": 0, "package_nam": 0, "index": [0, 2, 4], "html": [0, 4], "sever": 0, "attribut": 0, "ar": [0, 3, 4, 8], "list": [0, 3], "among": 0, "them": [0, 3], "follow": 0, "when": [0, 3], "present": 0, "mardi": [0, 1, 4, 8], "knowledg": [0, 1], "graph": [0, 1], "version": 0, "depend": 0, "softwar": 0, "includ": 0, "other": 0, "author": [0, 1, 8], "indic": [0, 3], "accord": 0, "repositori": 0, "polici": 0, "abbrevi": 0, "aut": 0, "given": [0, 3], "guidelin": 0, "i": [0, 2, 3, 4], "alwai": 0, "implement": 0, "possibl": [0, 6], "properli": 0, "pars": [0, 1, 8], "abbrev": 0, "describ": 0, "role": 0, "individu": 0, "just": [0, 3], "first": [0, 4], "licens": 0, "accept": [0, 3], "maintain": 0, "gener": [0, 4], "one": 0, "sourc": [0, 1, 3, 4, 8], "adatasourc": [0, 1, 8], "process": [0, 1, 8], "data": [0, 1, 3, 8], "metadata": 0, "scrap": 0, "wikibas": [0, 1, 3, 8], "item": [0, 3], "correspond": [0, 8], "subsequ": 0, "updat": [0, 3, 8], "creat": [0, 1, 3, 8], "case": 0, "new": [0, 3], "datafram": 0, "type": [0, 3, 8], "panda": 0, "setup": [0, 8], "all": [0, 3, 8], "necessari": [0, 8], "properti": [0, 3, 8], "entiti": [0, 3, 8], "create_local_ent": [0, 8], "pull": [0, 1, 3, 8], "The": [0, 3, 4], "result": 0, "save": [0, 8], "return": [0, 1, 3, 8], "rais": 0, "importerexcept": [0, 1], "If": 0, "cannot": 0, "push": [0, 1, 8], "For": [0, 3], "check": [0, 3], "coincid": 0, "found": [0, 3, 8], "It": [0, 3, 8], "instanc": [0, 3, 8], "str": [0, 3], "label": [0, 3], "descript": [0, 3], "api": [0, 1, 3, 8], "integr": [0, 2], "mardiintegr": [0, 2], "long_descript": 0, "tupl": 0, "factori": 0, "license_data": 0, "author_pool": 0, "crossref_publ": 0, "crossrefpubl": 0, "arxiv_publ": 0, "arxivpubl": 0, "zenodo_resourc": 0, "zenodoresourc": 0, "_qid": 0, "_item": 0, "mardient": [0, 2], "mardiitement": [0, 3], "none": [0, 3, 8], "object": [0, 1, 3], "manag": [0, 1], "local": [0, 1, 3, 4], "detail": 0, "previou": 0, "": 0, "qid": [0, 3], "search": [0, 2, 3], "an": [0, 1, 3], "sql": 0, "match": 0, "repres": 0, "add": 0, "also": [0, 3], "exist": [0, 3], "alreadi": [0, 3], "id": [0, 3, 8], "is_upd": 0, "bool": [0, 3], "up": [0, 3], "compar": 0, "last": 0, "true": [0, 1, 3], "both": 0, "fals": [0, 3], "otherwis": [0, 3], "m": [0, 4], "function": [0, 3, 8], "insert": [0, 3], "its": [0, 3], "claim": [0, 3], "write": [0, 1], "dict": [0, 3, 8], "ha": [0, 3], "written": 0, "successfulli": 0, "dictionari": [0, 1, 3], "A": 0, "success": 0, "option": [0, 8], "insert_claim": 0, "wb": 0, "through": 0, "statement": [0, 3], "do": 0, "inform": [0, 3, 8], "subsitut": 0, "us": [0, 4], "wbitem": 0, "process_claim": 0, "prop_nr": 0, "qualifier_nr": 0, "parse_publ": 0, "extract": [0, 8], "doi": [0, 8], "identif": 0, "relat": 0, "identifi": 0, "mention": [0, 3], "format": 0, "arxiv": 0, "long": 0, "get_last_upd": 0, "dd": 0, "mm": 0, "yyyi": 0, "clean_package_list": 0, "table_html": 0, "raw": [0, 8], "enabl": 0, "creation": [0, 8], "split": 0, "comma": 0, "posit": 0, "parse_licens": 0, "method": [0, 8], "parse_author": 0, "parse_maintain": 0, "paramet": [0, 3, 8], "code": 0, "obtain": 0, "beautifulsoup": 0, "singl": [0, 3], "column": 0, "parse_softwar": 0, "software_str": 0, "provid": 0, "x": 0, "string": [0, 3, 8], "take": 0, "account": [0, 4], "often": 0, "uniformli": 0, "charact": 0, "separ": 0, "further": [0, 3], "squar": 0, "bracket": 0, "concret": 0, "link": [0, 3], "previous": 0, "been": [0, 3], "wikidata": [0, 3], "between": [0, 8], "round": 0, "ad": [0, 3, 8], "qualifi": [0, 3, 8], "file": [0, 1, 3, 4], "element": [0, 8], "second": 0, "regist": 0, "unequivoc": 0, "e": [0, 3, 4, 8], "thei": 0, "onli": [0, 8], "establish": 0, "whether": [0, 3], "after": 0, "refer": [0, 3], "anoth": 0, "institut": 0, "funder": 0, "etc": 0, "orcid": 0, "remov": 0, "unnecessari": 0, "which": [0, 3], "mai": 0, "mail": 0, "address": 0, "comment": 0, "within": [0, 4], "get_license_qid": 0, "license_str": 0, "same": [0, 3], "denomin": 0, "differ": 0, "uniqu": 0, "referenc": 0, "under": 0, "g": [0, 8], "artist": 0, "2": 0, "0": 0, "q14624826": 0, "get_wikidata_qid": 0, "get": [0, 3, 8], "retriev": 0, "so": 0, "get_vers": 0, "thu": 1, "feb": 1, "17": 1, "18": 1, "53": 1, "2022": 1, "alvaro": 1, "class": [1, 2, 3, 8], "aconfigpars": 1, "abstract": [1, 8], "config": [1, 3], "parse_config": 1, "valu": [1, 8], "rtype": 1, "extern": 1, "process_data": [1, 8], "dump": [1, 8], "datasourc": [1, 8], "write_data_dump": [1, 8], "control": 1, "import_al": 1, "except": 1, "fail": 1, "oper": 1, "docker": 2, "introduct": 2, "instal": 2, "without": 2, "With": 2, "build": 2, "usag": [2, 6], "diagram": 2, "launcher": 2, "script": 2, "argument": [2, 3], "cran": [2, 6], "modul": [2, 4], "mardi_import": 2, "cransourc": 2, "rpackag": 2, "polydb": [2, 6], "polydbsourc": 2, "zbmath": [2, 6], "zbmathsourc": 2, "misc": 2, "page": 2, "languag": 3, "en": 3, "de": 3, "mardicli": 3, "set": 3, "initi": 3, "configur": 3, "clientlogin": 3, "convert_claim_id": 3, "place": [3, 4], "convers": 3, "convert_entity_link": 3, "snak": 3, "unit": 3, "quantiti": 3, "globe": 3, "globecoordin": 3, "instead": 3, "wikibaseintegr": 3, "create_db_t": 3, "db": 3, "map": 3, "create_engin": 3, "sqlalchemi": 3, "engin": 3, "create_id_list_from_fil": 3, "while": 3, "where": 3, "line": 3, "path": 3, "get_local_id_by_label": 3, "entity_str": 3, "entity_typ": 3, "pid": 3, "specifi": 3, "prefix": 3, "wdt": 3, "wd": 3, "either": 3, "look": 3, "get_qualifi": 3, "empti": 3, "get_refer": 3, "get_wikidata_inform": 3, "wikidata_id": 3, "recurs": 3, "desir": 3, "should": 3, "import_claim_ent": 3, "had": 3, "import_ent": 3, "id_list": 3, "filenam": 3, "lexem": 3, "support": 3, "import_from_label": 3, "local_id": 3, "init_wikidata_pid": 3, "wikidata_pid": 3, "init_wikidata_qid": 3, "wikidata_qid": 3, "insert_id_in_db": 3, "has_all_claim": 3, "boolean": 3, "overwrite_ent": 3, "complet": 3, "need": 3, "queri": [3, 8], "wb_id_map": 3, "two": 3, "query_with_local_id": 3, "update_has_all_claim": 3, "alias": 3, "sitelink": 3, "kwarg": 3, "ani": 3, "mardiitem": 3, "entity_id": 3, "request": 3, "mediawiki": 3, "you": 3, "want": 3, "must": 3, "start": 3, "q": 3, "itement": 3, "get_qid": 3, "alia": 3, "mardipropertyent": 3, "datatyp": 3, "wikibasedatatyp": 3, "mardiproperti": 3, "get_pid": 3, "what": 4, "about": 4, "python": 4, "requir": 4, "txt": 4, "pip": 4, "Then": 4, "via": 4, "u": 4, "enforc": 4, "reinstal": 4, "modif": 4, "automat": 4, "taken": 4, "note": 4, "conveni": 4, "virtual": 4, "environ": 4, "call": 4, "python3": 4, "venv": 4, "env": 4, "bin": 4, "activ": 4, "todo": 4, "In": 4, "doc": 4, "run": 4, "make": 4, "have": 4, "findabl": 4, "To": 4, "view": 4, "open": 4, "_build": 4, "py": 6, "h": 6, "mode": 6, "openml": 6, "conf_path": 6, "wikidata_id_file_path": 6, "choic": 6, "out_dir": 8, "tag": 8, "from_dat": 8, "until_d": 8, "raw_dump_path": 8, "processed_dump_path": 8, "split_id": 8, "zb": 8, "math": 8, "get_creation_d": 8, "xml_record": 8, "xml": 8, "record": 8, "get_de_numb": 8, "parse_record": 8, "pair": 8, "overrid": 8, "csv": 8, "zbmathpubl": 8, "journal": 8, "well": 8, "get_info_from_doi": 8, "kei": 8, "crossref": 8, "document_titl": 8, "now": 8, "document": 8, "get_tag": 8, "tag_nam": 8, "namespac": 8, "fulli": 8, "parse_doi_info": 8, "val": 8, "work_info": 8, "respons": 8}, "objects": {"mardi_importer.cran": [[0, 0, 0, "-", "CRANSource"], [0, 0, 0, "-", "RPackage"]], "mardi_importer.cran.CRANSource": [[0, 1, 1, "", "CRANSource"]], "mardi_importer.cran.CRANSource.CRANSource": [[0, 2, 1, "", "create_local_entities"], [0, 3, 1, "", "packages"], [0, 2, 1, "", "pull"], [0, 2, 1, "", "push"], [0, 2, 1, "", "setup"]], "mardi_importer.cran.RPackage": [[0, 1, 1, "", "RPackage"]], "mardi_importer.cran.RPackage.RPackage": [[0, 4, 1, "", "QID"], [0, 3, 1, "", "_QID"], [0, 3, 1, "", "api"], [0, 3, 1, "", "arxiv_publications"], [0, 3, 1, "", "author"], [0, 3, 1, "", "author_pool"], [0, 3, 1, "", "authors"], [0, 2, 1, "", "clean_package_list"], [0, 2, 1, "", "create"], [0, 3, 1, "", "crossref_publications"], [0, 3, 1, "id0", "date"], [0, 3, 1, "", "dependencies"], [0, 3, 1, "", "dependency"], [0, 3, 1, "id2", "description"], [0, 2, 1, "", "exists"], [0, 2, 1, "", "get_last_update"], [0, 2, 1, "", "get_license_QID"], [0, 2, 1, "", "get_versions"], [0, 2, 1, "", "get_wikidata_QID"], [0, 3, 1, "id7", "imports"], [0, 2, 1, "", "insert_claims"], [0, 3, 1, "", "integrator"], [0, 2, 1, "", "is_updated"], [0, 4, 1, "", "item"], [0, 3, 1, "id1", "label"], [0, 3, 1, "", "license"], [0, 3, 1, "", "license_data"], [0, 3, 1, "id3", "long_description"], [0, 3, 1, "id8", "maintainer"], [0, 2, 1, "", "parse_authors"], [0, 2, 1, "", "parse_license"], [0, 2, 1, "", "parse_maintainer"], [0, 2, 1, "", "parse_publications"], [0, 2, 1, "", "parse_software"], [0, 2, 1, "", "process_claims"], [0, 2, 1, "", "pull"], [0, 2, 1, "", "update"], [0, 3, 1, "id4", "url"], [0, 3, 1, "id5", "version"], [0, 3, 1, "id6", "versions"], [0, 2, 1, "", "write"], [0, 3, 1, "", "zenodo_resources"]], "mardi_importer.importer": [[1, 0, 0, "-", "Importer"]], "mardi_importer.importer.Importer": [[1, 1, 1, "", "AConfigParser"], [1, 1, 1, "", "ADataSource"], [1, 1, 1, "", "Importer"], [1, 5, 1, "", "ImporterException"]], "mardi_importer.importer.Importer.AConfigParser": [[1, 2, 1, "", "parse_config"]], "mardi_importer.importer.Importer.ADataSource": [[1, 2, 1, "", "process_data"], [1, 2, 1, "", "pull"], [1, 2, 1, "", "push"], [1, 2, 1, "", "write_data_dump"]], "mardi_importer.importer.Importer.Importer": [[1, 2, 1, "", "import_all"]], "mardi_importer.integrator": [[3, 0, 0, "-", "MardiEntities"], [3, 0, 0, "-", "MardiIntegrator"]], "mardi_importer.integrator.MardiEntities": [[3, 1, 1, "", "MardiItemEntity"], [3, 1, 1, "", "MardiPropertyEntity"]], "mardi_importer.integrator.MardiEntities.MardiItemEntity": [[3, 2, 1, "", "get"], [3, 2, 1, "", "get_QID"], [3, 2, 1, "", "new"]], "mardi_importer.integrator.MardiEntities.MardiPropertyEntity": [[3, 2, 1, "", "get"], [3, 2, 1, "", "get_PID"], [3, 2, 1, "", "new"]], "mardi_importer.integrator.MardiIntegrator": [[3, 1, 1, "", "MardiIntegrator"]], "mardi_importer.integrator.MardiIntegrator.MardiIntegrator": [[3, 2, 1, "", "config"], [3, 2, 1, "", "convert_claim_ids"], [3, 2, 1, "", "convert_entity_links"], [3, 2, 1, "", "create_db_table"], [3, 2, 1, "", "create_engine"], [3, 2, 1, "", "create_id_list_from_file"], [3, 2, 1, "", "get_local_id_by_label"], [3, 2, 1, "", "get_qualifiers"], [3, 2, 1, "", "get_references"], [3, 2, 1, "", "get_wikidata_information"], [3, 2, 1, "", "import_claim_entities"], [3, 2, 1, "", "import_entities"], [3, 2, 1, "", "import_from_label"], [3, 2, 1, "", "init_wikidata_PID"], [3, 2, 1, "", "init_wikidata_QID"], [3, 2, 1, "", "insert_id_in_db"], [3, 2, 1, "", "overwrite_entity"], [3, 2, 1, "", "query"], [3, 2, 1, "", "query_with_local_id"], [3, 2, 1, "", "update_has_all_claims"]], "mardi_importer": [[5, 0, 0, "-", "polydb"]], "mardi_importer.zbmath": [[8, 0, 0, "-", "ZBMathSource"], [8, 0, 0, "-", "misc"]], "mardi_importer.zbmath.ZBMathSource": [[8, 1, 1, "", "ZBMathSource"]], "mardi_importer.zbmath.ZBMathSource.ZBMathSource": [[8, 2, 1, "", "create_local_entities"], [8, 2, 1, "", "get_creation_date"], [8, 2, 1, "", "get_de_number"], [8, 2, 1, "", "parse_record"], [8, 2, 1, "", "process_data"], [8, 2, 1, "", "pull"], [8, 2, 1, "", "push"], [8, 2, 1, "", "setup"], [8, 2, 1, "", "write_data_dump"]], "mardi_importer.zbmath.misc": [[8, 6, 1, "", "get_info_from_doi"], [8, 6, 1, "", "get_tag"], [8, 6, 1, "", "parse_doi_info"]]}, "objtypes": {"0": "py:module", "1": "py:class", "2": "py:method", "3": "py:attribute", "4": "py:property", "5": "py:exception", "6": "py:function"}, "objnames": {"0": ["py", "module", "Python module"], "1": ["py", "class", "Python class"], "2": ["py", "method", "Python method"], "3": ["py", "attribute", "Python attribute"], "4": ["py", "property", "Python property"], "5": ["py", "exception", "Python exception"], "6": ["py", "function", "Python function"]}, "titleterms": {"cran": 0, "modul": [0, 1, 3, 5, 8], "mardi_import": [0, 1, 3, 5, 8], "cransourc": 0, "class": 0, "rpackag": 0, "import": [1, 2, 7], "mardi": 2, "document": [2, 4], "tabl": 2, "content": 2, "manual": 2, "api": 2, "indic": 2, "integr": 3, "mardiintegr": 3, "mardient": 3, "introduct": 4, "instal": 4, "without": 4, "docker": 4, "With": 4, "build": 4, "usag": 4, "polydb": 5, "polydbsourc": 5, "launcher": 6, "script": 6, "name": 6, "argument": 6, "diagram": 7, "zbmath": 8, "zbmathsourc": 8, "misc": 8}, "envversion": {"sphinx.domains.c": 3, "sphinx.domains.changeset": 1, "sphinx.domains.citation": 1, "sphinx.domains.cpp": 9, "sphinx.domains.index": 1, "sphinx.domains.javascript": 3, "sphinx.domains.math": 2, "sphinx.domains.python": 4, "sphinx.domains.rst": 2, "sphinx.domains.std": 2, "sphinx.ext.viewcode": 1, "sphinx.ext.todo": 2, "sphinx": 60}, "alltitles": {"CRAN module": [[0, "cran-module"]], "mardi_importer.cran.CRANSource class": [[0, "module-mardi_importer.cran.CRANSource"]], "mardi_importer.cran.RPackage class": [[0, "module-mardi_importer.cran.RPackage"]], "mardi_importer.importer module": [[1, "mardi-importer-importer-module"]], "mardi_importer.importer.Importer module": [[1, "module-mardi_importer.importer.Importer"]], "MaRDI Importer Documentation": [[2, "mardi-importer-documentation"]], "Table of contents": [[2, "table-of-contents"]], "Manual": [[2, null]], "API Documentation": [[2, null]], "Indices and tables": [[2, "indices-and-tables"]], "mardi_importer.integrator module": [[3, "mardi-importer-integrator-module"]], "mardi_importer.integrator.MardiIntegrator module": [[3, "module-mardi_importer.integrator.MardiIntegrator"]], "mardi_importer.integrator.MardiEntities module": [[3, "module-mardi_importer.integrator.MardiEntities"]], "Introduction": [[4, "introduction"]], "Installation": [[4, "installation"]], "Without Docker": [[4, "without-docker"]], "With Docker": [[4, "with-docker"]], "Build documentation": [[4, "build-documentation"]], "Usage": [[4, "usage"]], "mardi_importer.polydb module": [[5, "mardi-importer-polydb-module"]], "mardi_importer.polydb.PolyDBSource module": [[5, "module-mardi_importer.polydb"]], "Launcher script": [[6, "launcher-script"]], "Named Arguments": [[6, "named-arguments"]], "Importer diagram": [[7, "importer-diagram"]], "mardi_importer.zbmath module": [[8, "mardi-importer-zbmath-module"]], "mardi_importer.zbmath.ZBMathSource module": [[8, "module-mardi_importer.zbmath.ZBMathSource"]], "mardi_importer.zbmath.misc module": [[8, "module-mardi_importer.zbmath.misc"]]}, "indexentries": {"cransource (class in mardi_importer.cran.cransource)": [[0, "mardi_importer.cran.CRANSource.CRANSource"]], "qid (mardi_importer.cran.rpackage.rpackage property)": [[0, "mardi_importer.cran.RPackage.RPackage.QID"]], "rpackage (class in mardi_importer.cran.rpackage)": [[0, "mardi_importer.cran.RPackage.RPackage"]], "_qid (mardi_importer.cran.rpackage.rpackage attribute)": [[0, "mardi_importer.cran.RPackage.RPackage._QID"]], "api (mardi_importer.cran.rpackage.rpackage attribute)": [[0, "mardi_importer.cran.RPackage.RPackage.api"]], "arxiv_publications (mardi_importer.cran.rpackage.rpackage attribute)": [[0, "mardi_importer.cran.RPackage.RPackage.arxiv_publications"]], "author (mardi_importer.cran.rpackage.rpackage attribute)": [[0, "mardi_importer.cran.RPackage.RPackage.author"]], "author_pool (mardi_importer.cran.rpackage.rpackage attribute)": [[0, "mardi_importer.cran.RPackage.RPackage.author_pool"]], "authors (mardi_importer.cran.rpackage.rpackage attribute)": [[0, "mardi_importer.cran.RPackage.RPackage.authors"]], "clean_package_list() (mardi_importer.cran.rpackage.rpackage method)": [[0, "mardi_importer.cran.RPackage.RPackage.clean_package_list"]], "create() (mardi_importer.cran.rpackage.rpackage method)": [[0, "mardi_importer.cran.RPackage.RPackage.create"]], "create_local_entities() (mardi_importer.cran.cransource.cransource method)": [[0, "mardi_importer.cran.CRANSource.CRANSource.create_local_entities"]], "crossref_publications (mardi_importer.cran.rpackage.rpackage attribute)": [[0, "mardi_importer.cran.RPackage.RPackage.crossref_publications"]], "date (mardi_importer.cran.rpackage.rpackage attribute)": [[0, "id0"], [0, "mardi_importer.cran.RPackage.RPackage.date"]], "dependencies (mardi_importer.cran.rpackage.rpackage attribute)": [[0, "mardi_importer.cran.RPackage.RPackage.dependencies"]], "dependency (mardi_importer.cran.rpackage.rpackage attribute)": [[0, "mardi_importer.cran.RPackage.RPackage.dependency"]], "description (mardi_importer.cran.rpackage.rpackage attribute)": [[0, "id2"], [0, "mardi_importer.cran.RPackage.RPackage.description"]], "exists() (mardi_importer.cran.rpackage.rpackage method)": [[0, "mardi_importer.cran.RPackage.RPackage.exists"]], "get_last_update() (mardi_importer.cran.rpackage.rpackage method)": [[0, "mardi_importer.cran.RPackage.RPackage.get_last_update"]], "get_license_qid() (mardi_importer.cran.rpackage.rpackage method)": [[0, "mardi_importer.cran.RPackage.RPackage.get_license_QID"]], "get_versions() (mardi_importer.cran.rpackage.rpackage method)": [[0, "mardi_importer.cran.RPackage.RPackage.get_versions"]], "get_wikidata_qid() (mardi_importer.cran.rpackage.rpackage method)": [[0, "mardi_importer.cran.RPackage.RPackage.get_wikidata_QID"]], "imports (mardi_importer.cran.rpackage.rpackage attribute)": [[0, "id7"], [0, "mardi_importer.cran.RPackage.RPackage.imports"]], "insert_claims() (mardi_importer.cran.rpackage.rpackage method)": [[0, "mardi_importer.cran.RPackage.RPackage.insert_claims"]], "integrator (mardi_importer.cran.rpackage.rpackage attribute)": [[0, "mardi_importer.cran.RPackage.RPackage.integrator"]], "is_updated() (mardi_importer.cran.rpackage.rpackage method)": [[0, "mardi_importer.cran.RPackage.RPackage.is_updated"]], "item (mardi_importer.cran.rpackage.rpackage property)": [[0, "mardi_importer.cran.RPackage.RPackage.item"]], "label (mardi_importer.cran.rpackage.rpackage attribute)": [[0, "id1"], [0, "mardi_importer.cran.RPackage.RPackage.label"]], "license (mardi_importer.cran.rpackage.rpackage attribute)": [[0, "mardi_importer.cran.RPackage.RPackage.license"]], "license_data (mardi_importer.cran.rpackage.rpackage attribute)": [[0, "mardi_importer.cran.RPackage.RPackage.license_data"]], "long_description (mardi_importer.cran.rpackage.rpackage attribute)": [[0, "id3"], [0, "mardi_importer.cran.RPackage.RPackage.long_description"]], "maintainer (mardi_importer.cran.rpackage.rpackage attribute)": [[0, "id8"], [0, "mardi_importer.cran.RPackage.RPackage.maintainer"]], "mardi_importer.cran.cransource": [[0, "module-mardi_importer.cran.CRANSource"]], "mardi_importer.cran.rpackage": [[0, "module-mardi_importer.cran.RPackage"]], "module": [[0, "module-mardi_importer.cran.CRANSource"], [0, "module-mardi_importer.cran.RPackage"], [1, "module-mardi_importer.importer.Importer"], [3, "module-mardi_importer.integrator.MardiEntities"], [3, "module-mardi_importer.integrator.MardiIntegrator"], [5, "module-mardi_importer.polydb"], [8, "module-mardi_importer.zbmath.ZBMathSource"], [8, "module-mardi_importer.zbmath.misc"]], "packages (mardi_importer.cran.cransource.cransource attribute)": [[0, "mardi_importer.cran.CRANSource.CRANSource.packages"]], "parse_authors() (mardi_importer.cran.rpackage.rpackage method)": [[0, "mardi_importer.cran.RPackage.RPackage.parse_authors"]], "parse_license() (mardi_importer.cran.rpackage.rpackage method)": [[0, "mardi_importer.cran.RPackage.RPackage.parse_license"]], "parse_maintainer() (mardi_importer.cran.rpackage.rpackage method)": [[0, "mardi_importer.cran.RPackage.RPackage.parse_maintainer"]], "parse_publications() (mardi_importer.cran.rpackage.rpackage method)": [[0, "mardi_importer.cran.RPackage.RPackage.parse_publications"]], "parse_software() (mardi_importer.cran.rpackage.rpackage method)": [[0, "mardi_importer.cran.RPackage.RPackage.parse_software"]], "process_claims() (mardi_importer.cran.rpackage.rpackage method)": [[0, "mardi_importer.cran.RPackage.RPackage.process_claims"]], "pull() (mardi_importer.cran.cransource.cransource method)": [[0, "mardi_importer.cran.CRANSource.CRANSource.pull"]], "pull() (mardi_importer.cran.rpackage.rpackage method)": [[0, "mardi_importer.cran.RPackage.RPackage.pull"]], "push() (mardi_importer.cran.cransource.cransource method)": [[0, "mardi_importer.cran.CRANSource.CRANSource.push"]], "setup() (mardi_importer.cran.cransource.cransource method)": [[0, "mardi_importer.cran.CRANSource.CRANSource.setup"]], "update() (mardi_importer.cran.rpackage.rpackage method)": [[0, "mardi_importer.cran.RPackage.RPackage.update"]], "url (mardi_importer.cran.rpackage.rpackage attribute)": [[0, "id4"], [0, "mardi_importer.cran.RPackage.RPackage.url"]], "version (mardi_importer.cran.rpackage.rpackage attribute)": [[0, "id5"], [0, "mardi_importer.cran.RPackage.RPackage.version"]], "versions (mardi_importer.cran.rpackage.rpackage attribute)": [[0, "id6"], [0, "mardi_importer.cran.RPackage.RPackage.versions"]], "write() (mardi_importer.cran.rpackage.rpackage method)": [[0, "mardi_importer.cran.RPackage.RPackage.write"]], "zenodo_resources (mardi_importer.cran.rpackage.rpackage attribute)": [[0, "mardi_importer.cran.RPackage.RPackage.zenodo_resources"]], "aconfigparser (class in mardi_importer.importer.importer)": [[1, "mardi_importer.importer.Importer.AConfigParser"]], "adatasource (class in mardi_importer.importer.importer)": [[1, "mardi_importer.importer.Importer.ADataSource"]], "importer (class in mardi_importer.importer.importer)": [[1, "mardi_importer.importer.Importer.Importer"]], "importerexception": [[1, "mardi_importer.importer.Importer.ImporterException"]], "import_all() (mardi_importer.importer.importer.importer method)": [[1, "mardi_importer.importer.Importer.Importer.import_all"]], "mardi_importer.importer.importer": [[1, "module-mardi_importer.importer.Importer"]], "parse_config() (mardi_importer.importer.importer.aconfigparser method)": [[1, "mardi_importer.importer.Importer.AConfigParser.parse_config"]], "process_data() (mardi_importer.importer.importer.adatasource method)": [[1, "mardi_importer.importer.Importer.ADataSource.process_data"]], "pull() (mardi_importer.importer.importer.adatasource method)": [[1, "mardi_importer.importer.Importer.ADataSource.pull"]], "push() (mardi_importer.importer.importer.adatasource method)": [[1, "mardi_importer.importer.Importer.ADataSource.push"]], "write_data_dump() (mardi_importer.importer.importer.adatasource method)": [[1, "mardi_importer.importer.Importer.ADataSource.write_data_dump"]], "mardiintegrator (class in mardi_importer.integrator.mardiintegrator)": [[3, "mardi_importer.integrator.MardiIntegrator.MardiIntegrator"]], "mardiitementity (class in mardi_importer.integrator.mardientities)": [[3, "mardi_importer.integrator.MardiEntities.MardiItemEntity"]], "mardipropertyentity (class in mardi_importer.integrator.mardientities)": [[3, "mardi_importer.integrator.MardiEntities.MardiPropertyEntity"]], "config() (mardi_importer.integrator.mardiintegrator.mardiintegrator method)": [[3, "mardi_importer.integrator.MardiIntegrator.MardiIntegrator.config"]], "convert_claim_ids() (mardi_importer.integrator.mardiintegrator.mardiintegrator method)": [[3, "mardi_importer.integrator.MardiIntegrator.MardiIntegrator.convert_claim_ids"]], "convert_entity_links() (mardi_importer.integrator.mardiintegrator.mardiintegrator method)": [[3, "mardi_importer.integrator.MardiIntegrator.MardiIntegrator.convert_entity_links"]], "create_db_table() (mardi_importer.integrator.mardiintegrator.mardiintegrator method)": [[3, "mardi_importer.integrator.MardiIntegrator.MardiIntegrator.create_db_table"]], "create_engine() (mardi_importer.integrator.mardiintegrator.mardiintegrator method)": [[3, "mardi_importer.integrator.MardiIntegrator.MardiIntegrator.create_engine"]], "create_id_list_from_file() (mardi_importer.integrator.mardiintegrator.mardiintegrator method)": [[3, "mardi_importer.integrator.MardiIntegrator.MardiIntegrator.create_id_list_from_file"]], "get() (mardi_importer.integrator.mardientities.mardiitementity method)": [[3, "mardi_importer.integrator.MardiEntities.MardiItemEntity.get"]], "get() (mardi_importer.integrator.mardientities.mardipropertyentity method)": [[3, "mardi_importer.integrator.MardiEntities.MardiPropertyEntity.get"]], "get_pid() (mardi_importer.integrator.mardientities.mardipropertyentity method)": [[3, "mardi_importer.integrator.MardiEntities.MardiPropertyEntity.get_PID"]], "get_qid() (mardi_importer.integrator.mardientities.mardiitementity method)": [[3, "mardi_importer.integrator.MardiEntities.MardiItemEntity.get_QID"]], "get_local_id_by_label() (mardi_importer.integrator.mardiintegrator.mardiintegrator method)": [[3, "mardi_importer.integrator.MardiIntegrator.MardiIntegrator.get_local_id_by_label"]], "get_qualifiers() (mardi_importer.integrator.mardiintegrator.mardiintegrator method)": [[3, "mardi_importer.integrator.MardiIntegrator.MardiIntegrator.get_qualifiers"]], "get_references() (mardi_importer.integrator.mardiintegrator.mardiintegrator method)": [[3, "mardi_importer.integrator.MardiIntegrator.MardiIntegrator.get_references"]], "get_wikidata_information() (mardi_importer.integrator.mardiintegrator.mardiintegrator method)": [[3, "mardi_importer.integrator.MardiIntegrator.MardiIntegrator.get_wikidata_information"]], "import_claim_entities() (mardi_importer.integrator.mardiintegrator.mardiintegrator method)": [[3, "mardi_importer.integrator.MardiIntegrator.MardiIntegrator.import_claim_entities"]], "import_entities() (mardi_importer.integrator.mardiintegrator.mardiintegrator method)": [[3, "mardi_importer.integrator.MardiIntegrator.MardiIntegrator.import_entities"]], "import_from_label() (mardi_importer.integrator.mardiintegrator.mardiintegrator method)": [[3, "mardi_importer.integrator.MardiIntegrator.MardiIntegrator.import_from_label"]], "init_wikidata_pid() (mardi_importer.integrator.mardiintegrator.mardiintegrator method)": [[3, "mardi_importer.integrator.MardiIntegrator.MardiIntegrator.init_wikidata_PID"]], "init_wikidata_qid() (mardi_importer.integrator.mardiintegrator.mardiintegrator method)": [[3, "mardi_importer.integrator.MardiIntegrator.MardiIntegrator.init_wikidata_QID"]], "insert_id_in_db() (mardi_importer.integrator.mardiintegrator.mardiintegrator method)": [[3, "mardi_importer.integrator.MardiIntegrator.MardiIntegrator.insert_id_in_db"]], "mardi_importer.integrator.mardientities": [[3, "module-mardi_importer.integrator.MardiEntities"]], "mardi_importer.integrator.mardiintegrator": [[3, "module-mardi_importer.integrator.MardiIntegrator"]], "new() (mardi_importer.integrator.mardientities.mardiitementity method)": [[3, "mardi_importer.integrator.MardiEntities.MardiItemEntity.new"]], "new() (mardi_importer.integrator.mardientities.mardipropertyentity method)": [[3, "mardi_importer.integrator.MardiEntities.MardiPropertyEntity.new"]], "overwrite_entity() (mardi_importer.integrator.mardiintegrator.mardiintegrator method)": [[3, "mardi_importer.integrator.MardiIntegrator.MardiIntegrator.overwrite_entity"]], "query() (mardi_importer.integrator.mardiintegrator.mardiintegrator method)": [[3, "mardi_importer.integrator.MardiIntegrator.MardiIntegrator.query"]], "query_with_local_id() (mardi_importer.integrator.mardiintegrator.mardiintegrator method)": [[3, "mardi_importer.integrator.MardiIntegrator.MardiIntegrator.query_with_local_id"]], "update_has_all_claims() (mardi_importer.integrator.mardiintegrator.mardiintegrator method)": [[3, "mardi_importer.integrator.MardiIntegrator.MardiIntegrator.update_has_all_claims"]], "mardi_importer.polydb": [[5, "module-mardi_importer.polydb"]], "zbmathsource (class in mardi_importer.zbmath.zbmathsource)": [[8, "mardi_importer.zbmath.ZBMathSource.ZBMathSource"]], "create_local_entities() (mardi_importer.zbmath.zbmathsource.zbmathsource method)": [[8, "mardi_importer.zbmath.ZBMathSource.ZBMathSource.create_local_entities"]], "get_creation_date() (mardi_importer.zbmath.zbmathsource.zbmathsource method)": [[8, "mardi_importer.zbmath.ZBMathSource.ZBMathSource.get_creation_date"]], "get_de_number() (mardi_importer.zbmath.zbmathsource.zbmathsource method)": [[8, "mardi_importer.zbmath.ZBMathSource.ZBMathSource.get_de_number"]], "get_info_from_doi() (in module mardi_importer.zbmath.misc)": [[8, "mardi_importer.zbmath.misc.get_info_from_doi"]], "get_tag() (in module mardi_importer.zbmath.misc)": [[8, "mardi_importer.zbmath.misc.get_tag"]], "mardi_importer.zbmath.zbmathsource": [[8, "module-mardi_importer.zbmath.ZBMathSource"]], "mardi_importer.zbmath.misc": [[8, "module-mardi_importer.zbmath.misc"]], "parse_doi_info() (in module mardi_importer.zbmath.misc)": [[8, "mardi_importer.zbmath.misc.parse_doi_info"]], "parse_record() (mardi_importer.zbmath.zbmathsource.zbmathsource method)": [[8, "mardi_importer.zbmath.ZBMathSource.ZBMathSource.parse_record"]], "process_data() (mardi_importer.zbmath.zbmathsource.zbmathsource method)": [[8, "mardi_importer.zbmath.ZBMathSource.ZBMathSource.process_data"]], "pull() (mardi_importer.zbmath.zbmathsource.zbmathsource method)": [[8, "mardi_importer.zbmath.ZBMathSource.ZBMathSource.pull"]], "push() (mardi_importer.zbmath.zbmathsource.zbmathsource method)": [[8, "mardi_importer.zbmath.ZBMathSource.ZBMathSource.push"]], "setup() (mardi_importer.zbmath.zbmathsource.zbmathsource method)": [[8, "mardi_importer.zbmath.ZBMathSource.ZBMathSource.setup"]], "write_data_dump() (mardi_importer.zbmath.zbmathsource.zbmathsource method)": [[8, "mardi_importer.zbmath.ZBMathSource.ZBMathSource.write_data_dump"]]}}) \ No newline at end of file diff --git a/tech.html b/tech.html new file mode 100644 index 0000000..e3c9601 --- /dev/null +++ b/tech.html @@ -0,0 +1,123 @@ + + + + + + + Importer diagram — MaRDI Importer documentation + + + + + + + + + + + + + + + + + + + +
+ + +
+ +
+
+
+ +
+
+
+
+ +
+

Importer diagram

+_images/activity.drawio.svg
+ + +
+
+ +
+
+
+
+ + + + \ No newline at end of file diff --git a/zbmath.html b/zbmath.html new file mode 100644 index 0000000..db696e8 --- /dev/null +++ b/zbmath.html @@ -0,0 +1,302 @@ + + + + + + + mardi_importer.zbmath module — MaRDI Importer documentation + + + + + + + + + + + + + + + + + + +
+ + +
+ +
+
+
+ +
+
+
+
+ +
+

mardi_importer.zbmath module

+
+

mardi_importer.zbmath.ZBMathSource module

+
+
+class mardi_importer.zbmath.ZBMathSource.ZBMathSource(out_dir, tags, from_date=None, until_date=None, raw_dump_path=None, processed_dump_path=None, split_id=None)[source]
+

Bases: ADataSource

+

Reads data from zb math API.

+
+
+create_local_entities()[source]
+
+ +
+
+get_creation_date(xml_record)[source]
+

Get creation date from xml record.

+
+
Parameters:
+

xml_record (xml element) – record returned by zbMath API

+
+
Returns:
+

creation date

+
+
Return type:
+

string

+
+
+
+ +
+
+get_de_number(xml_record)[source]
+

Get zbMath id from xml record.

+
+
Parameters:
+

xml_record (xml element) – record returned by zbMath API

+
+
Returns:
+

zbMath ID

+
+
Return type:
+

string

+
+
+
+ +
+
+parse_record(xml_record)[source]
+

Parse xml record from zbMath API.

+
+
Parameters:
+

xml_record (xml element) – record returned by zbMath API

+
+
Returns:
+

dict of (tag,value) pairs extracted from xml_record

+
+
Return type:
+

dict

+
+
+
+ +
+
+process_data()[source]
+

Overrides abstract method. +Reads a raw zbMath data dump and processes it, then saves it as a csv.

+
+ +
+
+pull()[source]
+

Pull data from DataSource

+
+ +
+
+push()[source]
+

Updates the MaRDI Wikibase entities corresponding to zbMath publications. +It creates a mardi_importer.zbmath.ZBMathPublication instance +for each publication. Authors and journals are added, as well.

+
+ +
+
+setup()[source]
+

Create all necessary properties and entities for zbMath

+
+ +
+
+write_data_dump()[source]
+

Overrides abstract method. +This method queries the zbMath API to get a data dump of all records, +optionally between from_date and until_date

+
+ +
+ +
+
+

mardi_importer.zbmath.misc module

+
+
+mardi_importer.zbmath.misc.get_info_from_doi(doi, key)[source]
+

Query crossref API for DOI information.

+
+
Parameters:
+
    +
  • doi – doi

  • +
  • key – document_title only for now

  • +
+
+
Returns:
+

document title

+
+
Return type:
+

title

+
+
+
+ +
+
+mardi_importer.zbmath.misc.get_tag(tag_name, namespace)[source]
+

Returns a fully qualified tag name.

+
+
Parameters:
+
    +
  • tag_name (string) – name of tag, e.g. author

  • +
  • namespace (string) – namespace URL of a namespace

  • +
+
+
+
+ +
+
+mardi_importer.zbmath.misc.parse_doi_info(val, work_info)[source]
+

Function to extract information returned by a doi query for a specific tag.

+
+
Parameters:
+
    +
  • val (string) – tag, e.g. author

  • +
  • work_info (dict) – information from doi query response

  • +
+
+
Returns:
+

information for specific tag, None if not found

+
+
Return type:
+

string

+
+
+
+ +
+
+ + +
+
+ +
+
+
+
+ + + + \ No newline at end of file