From c9a5e188ab6f0e4bea8116bc99da9e3fc69b0a88 Mon Sep 17 00:00:00 2001 From: GitHub Action Date: Thu, 24 Oct 2024 11:05:45 +0000 Subject: [PATCH] Update documentation --- FAQ.html | 24 +- _autosummary/one.alf.cache.html | 24 +- _autosummary/one.alf.exceptions.html | 38 ++- _autosummary/one.alf.files.html | 24 +- _autosummary/one.alf.html | 26 +- _autosummary/one.alf.io.html | 24 +- .../one.alf.spec.COLLECTION_SPEC.html | 24 +- _autosummary/one.alf.spec.FILE_SPEC.html | 24 +- _autosummary/one.alf.spec.FULL_SPEC.html | 24 +- _autosummary/one.alf.spec.REL_PATH_SPEC.html | 24 +- _autosummary/one.alf.spec.SESSION_SPEC.html | 24 +- .../one.alf.spec.SPEC_DESCRIPTION.html | 24 +- _autosummary/one.alf.spec.html | 24 +- _autosummary/one.api.N_THREADS.html | 24 +- _autosummary/one.api.html | 45 +-- _autosummary/one.converters.html | 27 +- _autosummary/one.html | 24 +- .../one.params.CACHE_DIR_DEFAULT.html | 24 +- _autosummary/one.params.html | 24 +- _autosummary/one.registration.html | 24 +- _autosummary/one.remote.aws.html | 24 +- _autosummary/one.remote.base.ALYX_JSON.html | 24 +- _autosummary/one.remote.base.html | 24 +- .../one.remote.globus.CLIENT_KEY.html | 24 +- .../one.remote.globus.DEFAULT_PAR.html | 24 +- .../one.remote.globus.STATUS_MAP.html | 24 +- _autosummary/one.remote.globus.html | 24 +- _autosummary/one.remote.html | 24 +- _autosummary/one.tests.alf.html | 24 +- .../one.tests.alf.test_alf_files.html | 24 +- _autosummary/one.tests.alf.test_alf_io.html | 24 +- _autosummary/one.tests.alf.test_alf_spec.html | 24 +- _autosummary/one.tests.alf.test_cache.html | 24 +- _autosummary/one.tests.html | 24 +- _autosummary/one.tests.remote.html | 24 +- _autosummary/one.tests.remote.test_aws.html | 24 +- _autosummary/one.tests.remote.test_base.html | 24 +- .../one.tests.remote.test_globus.html | 24 +- _autosummary/one.tests.test_alyxclient.html | 30 +- _autosummary/one.tests.test_alyxrest.html | 24 +- _autosummary/one.tests.test_converters.html | 24 +- _autosummary/one.tests.test_one.html | 103 ++++--- _autosummary/one.tests.test_params.html | 24 +- _autosummary/one.tests.test_registration.html | 24 +- _autosummary/one.tests.util.html | 29 +- _autosummary/one.util.QC_TYPE.html | 24 +- _autosummary/one.util.html | 74 ++++- _autosummary/one.webclient.html | 29 +- _modules/index.html | 24 +- _modules/one/alf/cache.html | 54 ++-- _modules/one/alf/exceptions.html | 34 ++- _modules/one/alf/files.html | 24 +- _modules/one/alf/io.html | 24 +- _modules/one/alf/spec.html | 24 +- _modules/one/api.html | 241 +++++++++------ _modules/one/converters.html | 110 +++---- _modules/one/params.html | 31 +- _modules/one/registration.html | 27 +- _modules/one/remote/aws.html | 24 +- _modules/one/remote/base.html | 24 +- _modules/one/remote/globus.html | 26 +- _modules/one/tests/alf/test_alf_files.html | 24 +- _modules/one/tests/alf/test_alf_io.html | 26 +- _modules/one/tests/alf/test_alf_spec.html | 24 +- _modules/one/tests/alf/test_cache.html | 33 +-- _modules/one/tests/remote/test_aws.html | 24 +- _modules/one/tests/remote/test_base.html | 24 +- _modules/one/tests/remote/test_globus.html | 26 +- _modules/one/tests/test_alyxclient.html | 125 +++++++- _modules/one/tests/test_alyxrest.html | 24 +- _modules/one/tests/test_converters.html | 44 +-- _modules/one/tests/test_one.html | 275 +++++++++++++----- _modules/one/tests/test_params.html | 24 +- _modules/one/tests/test_registration.html | 24 +- _modules/one/tests/util.html | 44 +-- _modules/one/util.html | 197 +++++++++---- _modules/one/webclient.html | 77 +++-- .../_autosummary/one.alf.exceptions.rst.txt | 1 + _sources/one_installation.md.txt | 2 +- _static/basic.css | 15 +- _static/css/badge_only.css | 2 +- _static/css/theme.css | 2 +- _static/doctools.js | 7 - _static/js/versions.js | 224 ++++++++++++++ _static/language_data.js | 7 - _static/searchtools.js | 38 ++- alf_intro.html | 24 +- api_reference.html | 24 +- contributing.html | 24 +- genindex.html | 34 ++- index.html | 28 +- notebooks/alyx_files.html | 28 +- notebooks/data_sharing.html | 28 +- notebooks/datasets_and_types.html | 28 +- notebooks/experiment_ids.html | 28 +- notebooks/one_advanced/one_advanced.html | 28 +- notebooks/one_list/one_list.html | 28 +- notebooks/one_load/one_load.html | 28 +- notebooks/one_modes.html | 28 +- notebooks/one_quickstart.html | 28 +- notebooks/one_search/one_search.html | 28 +- notebooks/recording_data_access.html | 28 +- notebooks/useful_alyx_queries.html | 28 +- objects.inv | Bin 20066 -> 20136 bytes one_installation.html | 26 +- one_reference.html | 24 +- py-modindex.html | 24 +- readme.html | 24 +- search.html | 24 +- searchindex.js | 2 +- 110 files changed, 2222 insertions(+), 1689 deletions(-) create mode 100644 _static/js/versions.js diff --git a/FAQ.html b/FAQ.html index 08ea3f26..8be76785 100644 --- a/FAQ.html +++ b/FAQ.html @@ -1,3 +1,5 @@ + + @@ -6,23 +8,19 @@ FAQ — ONE documentation - + - - - - - - - - - - + + + + + + + + diff --git a/_autosummary/one.alf.cache.html b/_autosummary/one.alf.cache.html index f64035ae..f74dba32 100644 --- a/_autosummary/one.alf.cache.html +++ b/_autosummary/one.alf.cache.html @@ -1,3 +1,5 @@ + + @@ -6,23 +8,19 @@ one.alf.cache — ONE documentation - + - - - - - - - - - - + + + + + + + + diff --git a/_autosummary/one.alf.exceptions.html b/_autosummary/one.alf.exceptions.html index 82bb2941..65fceb52 100644 --- a/_autosummary/one.alf.exceptions.html +++ b/_autosummary/one.alf.exceptions.html @@ -1,3 +1,5 @@ + + @@ -6,23 +8,19 @@ one.alf.exceptions — ONE documentation - + - - - - - - - - - - + + + + + + + + @@ -135,7 +133,7 @@

one.alf.exceptions

-

ALyx File related errors.

+

ALyx File related errors and warnings.

A set of Alyx and ALF related error classes which provide a more verbose description of the raised issues.

Exceptions

@@ -156,7 +154,10 @@

ALFObjectNotFound(*args[, terse])

'Object not found' error

-

AlyxSubjectNotFound(*args[, terse])

+

ALFWarning

+

Cautions when loading ALF datasets.

+ +

AlyxSubjectNotFound(*args[, terse])

'Subject not found' error

@@ -245,6 +246,13 @@ +
+
+exception ALFWarning[source]
+

Bases: Warning

+

Cautions when loading ALF datasets.

+
+
diff --git a/_autosummary/one.alf.files.html b/_autosummary/one.alf.files.html index 1bfc1e3f..51ca4354 100644 --- a/_autosummary/one.alf.files.html +++ b/_autosummary/one.alf.files.html @@ -1,3 +1,5 @@ + + @@ -6,23 +8,19 @@ one.alf.files — ONE documentation - + - - - - - - - - - - + + + + + + + + diff --git a/_autosummary/one.alf.html b/_autosummary/one.alf.html index 9b7da1ab..f6924d73 100644 --- a/_autosummary/one.alf.html +++ b/_autosummary/one.alf.html @@ -1,3 +1,5 @@ + + @@ -6,23 +8,19 @@ one.alf — ONE documentation - + - - - - - - - - - - + + + + + + + + @@ -141,7 +139,7 @@

Construct Parquet database from local file system.

exceptions

-

ALyx File related errors.

+

ALyx File related errors and warnings.

files

Module for identifying and parsing ALF file names.

diff --git a/_autosummary/one.alf.io.html b/_autosummary/one.alf.io.html index 8d0ce14e..e7793211 100644 --- a/_autosummary/one.alf.io.html +++ b/_autosummary/one.alf.io.html @@ -1,3 +1,5 @@ + + @@ -6,23 +8,19 @@ one.alf.io — ONE documentation - + - - - - - - - - - - + + + + + + + + diff --git a/_autosummary/one.alf.spec.COLLECTION_SPEC.html b/_autosummary/one.alf.spec.COLLECTION_SPEC.html index b18492e5..7bd95c5e 100644 --- a/_autosummary/one.alf.spec.COLLECTION_SPEC.html +++ b/_autosummary/one.alf.spec.COLLECTION_SPEC.html @@ -1,3 +1,5 @@ + + @@ -6,23 +8,19 @@ one.alf.spec.COLLECTION_SPEC — ONE documentation - + - - - - - - - - - - + + + + + + + + diff --git a/_autosummary/one.alf.spec.FILE_SPEC.html b/_autosummary/one.alf.spec.FILE_SPEC.html index 503ca11a..2b7de030 100644 --- a/_autosummary/one.alf.spec.FILE_SPEC.html +++ b/_autosummary/one.alf.spec.FILE_SPEC.html @@ -1,3 +1,5 @@ + + @@ -6,23 +8,19 @@ one.alf.spec.FILE_SPEC — ONE documentation - + - - - - - - - - - - + + + + + + + + diff --git a/_autosummary/one.alf.spec.FULL_SPEC.html b/_autosummary/one.alf.spec.FULL_SPEC.html index a3da0b88..00759dad 100644 --- a/_autosummary/one.alf.spec.FULL_SPEC.html +++ b/_autosummary/one.alf.spec.FULL_SPEC.html @@ -1,3 +1,5 @@ + + @@ -6,23 +8,19 @@ one.alf.spec.FULL_SPEC — ONE documentation - + - - - - - - - - - - + + + + + + + + diff --git a/_autosummary/one.alf.spec.REL_PATH_SPEC.html b/_autosummary/one.alf.spec.REL_PATH_SPEC.html index 4cd4aa65..155abf01 100644 --- a/_autosummary/one.alf.spec.REL_PATH_SPEC.html +++ b/_autosummary/one.alf.spec.REL_PATH_SPEC.html @@ -1,3 +1,5 @@ + + @@ -6,23 +8,19 @@ one.alf.spec.REL_PATH_SPEC — ONE documentation - + - - - - - - - - - - + + + + + + + + diff --git a/_autosummary/one.alf.spec.SESSION_SPEC.html b/_autosummary/one.alf.spec.SESSION_SPEC.html index 65a80fc2..51bbd347 100644 --- a/_autosummary/one.alf.spec.SESSION_SPEC.html +++ b/_autosummary/one.alf.spec.SESSION_SPEC.html @@ -1,3 +1,5 @@ + + @@ -6,23 +8,19 @@ one.alf.spec.SESSION_SPEC — ONE documentation - + - - - - - - - - - - + + + + + + + + diff --git a/_autosummary/one.alf.spec.SPEC_DESCRIPTION.html b/_autosummary/one.alf.spec.SPEC_DESCRIPTION.html index a018a1de..6e37f77c 100644 --- a/_autosummary/one.alf.spec.SPEC_DESCRIPTION.html +++ b/_autosummary/one.alf.spec.SPEC_DESCRIPTION.html @@ -1,3 +1,5 @@ + + @@ -6,23 +8,19 @@ one.alf.spec.SPEC_DESCRIPTION — ONE documentation - + - - - - - - - - - - + + + + + + + + diff --git a/_autosummary/one.alf.spec.html b/_autosummary/one.alf.spec.html index cd692190..2b7807b9 100644 --- a/_autosummary/one.alf.spec.html +++ b/_autosummary/one.alf.spec.html @@ -1,3 +1,5 @@ + + @@ -6,23 +8,19 @@ one.alf.spec — ONE documentation - + - - - - - - - - - - + + + + + + + + diff --git a/_autosummary/one.api.N_THREADS.html b/_autosummary/one.api.N_THREADS.html index ca08a50a..ee8395ff 100644 --- a/_autosummary/one.api.N_THREADS.html +++ b/_autosummary/one.api.N_THREADS.html @@ -1,3 +1,5 @@ + + @@ -6,23 +8,19 @@ one.api.N_THREADS — ONE documentation - + - - - - - - - - - - + + + + + + + + diff --git a/_autosummary/one.api.html b/_autosummary/one.api.html index e03e29c2..841eeb03 100644 --- a/_autosummary/one.api.html +++ b/_autosummary/one.api.html @@ -1,3 +1,5 @@ + + @@ -6,23 +8,19 @@ one.api — ONE documentation - + - - - - - - - - - - + + + + + + + + @@ -414,7 +412,7 @@
-list_datasets(eid=None, filename=None, collection=None, revision=None, qc=QC.FAIL, ignore_qc_not_set=False, details=False, query_type=None) ndarray | DataFrame[source]
+list_datasets(eid=None, filename=None, collection=None, revision=None, qc=QC.FAIL, ignore_qc_not_set=False, details=False, query_type=None, default_revisions_only=False) ndarray | DataFrame[source]

Given an eid, return the datasets for those sessions.

If no eid is provided, a list of all datasets is returned. When details is false, a sorted array of unique datasets is returned (their relative paths).

@@ -436,6 +434,8 @@
  • details (bool) – When true, a pandas DataFrame is returned, otherwise a numpy array of relative paths (collection/revision/filename) - see one.alf.spec.describe for details.

  • query_type (str) – Query cache (‘local’) or Alyx database (‘remote’).

  • +
  • default_revisions_only (bool) – When true, only matching datasets that are considered default revisions are returned. +If no ‘default_revision’ column is present, and ALFError is raised.

  • Returns:
    @@ -688,9 +688,10 @@
    load_datasets(eid: str | Path | UUID, datasets: List[str], collections: str | None = None, revisions: str | None = None, query_type: str | None = None, assert_present=True, download_only: bool = False, check_hash: bool = True) Any[source]
    -

    Load datasets for a given session id. Returns two lists the length of datasets. The -first is the data (or file paths if download_data is false), the second is a list of -meta data Bunches. If assert_present is false, missing data will be returned as None.

    +

    Load datasets for a given session id.

    +

    Returns two lists the length of datasets. The first is the data (or file paths if +download_data is false), the second is a list of meta data Bunches. If assert_present is +false, missing data will be returned as None.

    Parameters:
      @@ -714,8 +715,8 @@
    Returns:

      -
    • list – A list of data (or file paths) the length of datasets

    • -
    • list – A list of meta data Bunches. If assert_present is False, missing data will be None

    • +
    • list – A list of data (or file paths) the length of datasets.

    • +
    • list – A list of meta data Bunches. If assert_present is False, missing data will be None.

    @@ -730,6 +731,8 @@ revision as separate keyword arguments.

  • To ensure you are loading the correct revision, use the revisions kwarg instead of relative paths.

  • +
  • To load an exact revision (i.e. not the last revision before a given date), pass in +a list of relative paths or a data frame.

  • Raises:
    @@ -945,7 +948,7 @@
    -list_datasets(eid=None, filename=None, collection=None, revision=None, qc=QC.FAIL, ignore_qc_not_set=False, details=False, query_type=None) ndarray | DataFrame[source]
    +list_datasets(eid=None, filename=None, collection=None, revision=None, qc=QC.FAIL, ignore_qc_not_set=False, details=False, query_type=None, default_revisions_only=False) ndarray | DataFrame[source]

    Given an eid, return the datasets for those sessions.

    If no eid is provided, a list of all datasets is returned. When details is false, a sorted array of unique datasets is returned (their relative paths).

    @@ -967,6 +970,8 @@
  • details (bool) – When true, a pandas DataFrame is returned, otherwise a numpy array of relative paths (collection/revision/filename) - see one.alf.spec.describe for details.

  • query_type (str) – Query cache (‘local’) or Alyx database (‘remote’).

  • +
  • default_revisions_only (bool) – When true, only matching datasets that are considered default revisions are returned. +If no ‘default_revision’ column is present, and ALFError is raised.

  • Returns:
    diff --git a/_autosummary/one.converters.html b/_autosummary/one.converters.html index f8d132d9..665a0b1a 100644 --- a/_autosummary/one.converters.html +++ b/_autosummary/one.converters.html @@ -1,3 +1,5 @@ + + @@ -6,23 +8,19 @@ one.converters — ONE documentation - + - - - - - - - - - - + + + + + + + + @@ -329,8 +327,7 @@
    record2path(dataset) Path | None[source]
    -

    Given a set of dataset records, checks the corresponding exists flag in the cache -correctly reflects the files system.

    +

    Given a set of dataset records, returns the corresponding paths

    Parameters:

    dataset (pd.DataFrame, pd.Series) – A datasets dataframe slice

    diff --git a/_autosummary/one.html b/_autosummary/one.html index 561e4512..74acbe5a 100644 --- a/_autosummary/one.html +++ b/_autosummary/one.html @@ -1,3 +1,5 @@ + + @@ -6,23 +8,19 @@ one — ONE documentation - + - - - - - - - - - - + + + + + + + + diff --git a/_autosummary/one.params.CACHE_DIR_DEFAULT.html b/_autosummary/one.params.CACHE_DIR_DEFAULT.html index 094327df..828eeab8 100644 --- a/_autosummary/one.params.CACHE_DIR_DEFAULT.html +++ b/_autosummary/one.params.CACHE_DIR_DEFAULT.html @@ -1,3 +1,5 @@ + + @@ -6,23 +8,19 @@ one.params.CACHE_DIR_DEFAULT — ONE documentation - + - - - - - - - - - - + + + + + + + + diff --git a/_autosummary/one.params.html b/_autosummary/one.params.html index 333e930d..7a78eac2 100644 --- a/_autosummary/one.params.html +++ b/_autosummary/one.params.html @@ -1,3 +1,5 @@ + + @@ -6,23 +8,19 @@ one.params — ONE documentation - + - - - - - - - - - - + + + + + + + + diff --git a/_autosummary/one.registration.html b/_autosummary/one.registration.html index f6cc9298..349737f4 100644 --- a/_autosummary/one.registration.html +++ b/_autosummary/one.registration.html @@ -1,3 +1,5 @@ + + @@ -6,23 +8,19 @@ one.registration — ONE documentation - + - - - - - - - - - - + + + + + + + + diff --git a/_autosummary/one.remote.aws.html b/_autosummary/one.remote.aws.html index 3a263b5f..0a4079ef 100644 --- a/_autosummary/one.remote.aws.html +++ b/_autosummary/one.remote.aws.html @@ -1,3 +1,5 @@ + + @@ -6,23 +8,19 @@ one.remote.aws — ONE documentation - + - - - - - - - - - - + + + + + + + + diff --git a/_autosummary/one.remote.base.ALYX_JSON.html b/_autosummary/one.remote.base.ALYX_JSON.html index b21fb416..991c1b60 100644 --- a/_autosummary/one.remote.base.ALYX_JSON.html +++ b/_autosummary/one.remote.base.ALYX_JSON.html @@ -1,3 +1,5 @@ + + @@ -6,23 +8,19 @@ one.remote.base.ALYX_JSON — ONE documentation - + - - - - - - - - - - + + + + + + + + diff --git a/_autosummary/one.remote.base.html b/_autosummary/one.remote.base.html index 00bfde9d..843e0fd1 100644 --- a/_autosummary/one.remote.base.html +++ b/_autosummary/one.remote.base.html @@ -1,3 +1,5 @@ + + @@ -6,23 +8,19 @@ one.remote.base — ONE documentation - + - - - - - - - - - - + + + + + + + + diff --git a/_autosummary/one.remote.globus.CLIENT_KEY.html b/_autosummary/one.remote.globus.CLIENT_KEY.html index bebdbe3e..add0ed52 100644 --- a/_autosummary/one.remote.globus.CLIENT_KEY.html +++ b/_autosummary/one.remote.globus.CLIENT_KEY.html @@ -1,3 +1,5 @@ + + @@ -6,23 +8,19 @@ one.remote.globus.CLIENT_KEY — ONE documentation - + - - - - - - - - - - + + + + + + + + diff --git a/_autosummary/one.remote.globus.DEFAULT_PAR.html b/_autosummary/one.remote.globus.DEFAULT_PAR.html index 3b09ce37..e0a2a215 100644 --- a/_autosummary/one.remote.globus.DEFAULT_PAR.html +++ b/_autosummary/one.remote.globus.DEFAULT_PAR.html @@ -1,3 +1,5 @@ + + @@ -6,23 +8,19 @@ one.remote.globus.DEFAULT_PAR — ONE documentation - + - - - - - - - - - - + + + + + + + + diff --git a/_autosummary/one.remote.globus.STATUS_MAP.html b/_autosummary/one.remote.globus.STATUS_MAP.html index e06ce8db..31133425 100644 --- a/_autosummary/one.remote.globus.STATUS_MAP.html +++ b/_autosummary/one.remote.globus.STATUS_MAP.html @@ -1,3 +1,5 @@ + + @@ -6,23 +8,19 @@ one.remote.globus.STATUS_MAP — ONE documentation - + - - - - - - - - - - + + + + + + + + diff --git a/_autosummary/one.remote.globus.html b/_autosummary/one.remote.globus.html index 94060f6f..83aea070 100644 --- a/_autosummary/one.remote.globus.html +++ b/_autosummary/one.remote.globus.html @@ -1,3 +1,5 @@ + + @@ -6,23 +8,19 @@ one.remote.globus — ONE documentation - + - - - - - - - - - - + + + + + + + + diff --git a/_autosummary/one.remote.html b/_autosummary/one.remote.html index 07142173..c6506d62 100644 --- a/_autosummary/one.remote.html +++ b/_autosummary/one.remote.html @@ -1,3 +1,5 @@ + + @@ -6,23 +8,19 @@ one.remote — ONE documentation - + - - - - - - - - - - + + + + + + + + diff --git a/_autosummary/one.tests.alf.html b/_autosummary/one.tests.alf.html index 47cefb4e..647150d2 100644 --- a/_autosummary/one.tests.alf.html +++ b/_autosummary/one.tests.alf.html @@ -1,3 +1,5 @@ + + @@ -6,23 +8,19 @@ one.tests.alf — ONE documentation - + - - - - - - - - - - + + + + + + + + diff --git a/_autosummary/one.tests.alf.test_alf_files.html b/_autosummary/one.tests.alf.test_alf_files.html index d50dfb0f..655dcf07 100644 --- a/_autosummary/one.tests.alf.test_alf_files.html +++ b/_autosummary/one.tests.alf.test_alf_files.html @@ -1,3 +1,5 @@ + + @@ -6,23 +8,19 @@ one.tests.alf.test_alf_files — ONE documentation - + - - - - - - - - - - + + + + + + + + diff --git a/_autosummary/one.tests.alf.test_alf_io.html b/_autosummary/one.tests.alf.test_alf_io.html index ab23907e..5164151a 100644 --- a/_autosummary/one.tests.alf.test_alf_io.html +++ b/_autosummary/one.tests.alf.test_alf_io.html @@ -1,3 +1,5 @@ + + @@ -6,23 +8,19 @@ one.tests.alf.test_alf_io — ONE documentation - + - - - - - - - - - - + + + + + + + + diff --git a/_autosummary/one.tests.alf.test_alf_spec.html b/_autosummary/one.tests.alf.test_alf_spec.html index 0bd1806f..9872d7b1 100644 --- a/_autosummary/one.tests.alf.test_alf_spec.html +++ b/_autosummary/one.tests.alf.test_alf_spec.html @@ -1,3 +1,5 @@ + + @@ -6,23 +8,19 @@ one.tests.alf.test_alf_spec — ONE documentation - + - - - - - - - - - - + + + + + + + + diff --git a/_autosummary/one.tests.alf.test_cache.html b/_autosummary/one.tests.alf.test_cache.html index 1ff1e747..77c09ced 100644 --- a/_autosummary/one.tests.alf.test_cache.html +++ b/_autosummary/one.tests.alf.test_cache.html @@ -1,3 +1,5 @@ + + @@ -6,23 +8,19 @@ one.tests.alf.test_cache — ONE documentation - + - - - - - - - - - - + + + + + + + + diff --git a/_autosummary/one.tests.html b/_autosummary/one.tests.html index a7971cd5..981b666e 100644 --- a/_autosummary/one.tests.html +++ b/_autosummary/one.tests.html @@ -1,3 +1,5 @@ + + @@ -6,23 +8,19 @@ one.tests — ONE documentation - + - - - - - - - - - - + + + + + + + + diff --git a/_autosummary/one.tests.remote.html b/_autosummary/one.tests.remote.html index 953978b6..8966a410 100644 --- a/_autosummary/one.tests.remote.html +++ b/_autosummary/one.tests.remote.html @@ -1,3 +1,5 @@ + + @@ -6,23 +8,19 @@ one.tests.remote — ONE documentation - + - - - - - - - - - - + + + + + + + + diff --git a/_autosummary/one.tests.remote.test_aws.html b/_autosummary/one.tests.remote.test_aws.html index 2103c844..9b0954df 100644 --- a/_autosummary/one.tests.remote.test_aws.html +++ b/_autosummary/one.tests.remote.test_aws.html @@ -1,3 +1,5 @@ + + @@ -6,23 +8,19 @@ one.tests.remote.test_aws — ONE documentation - + - - - - - - - - - - + + + + + + + + diff --git a/_autosummary/one.tests.remote.test_base.html b/_autosummary/one.tests.remote.test_base.html index 5621f603..72bca354 100644 --- a/_autosummary/one.tests.remote.test_base.html +++ b/_autosummary/one.tests.remote.test_base.html @@ -1,3 +1,5 @@ + + @@ -6,23 +8,19 @@ one.tests.remote.test_base — ONE documentation - + - - - - - - - - - - + + + + + + + + diff --git a/_autosummary/one.tests.remote.test_globus.html b/_autosummary/one.tests.remote.test_globus.html index a548d35f..63914118 100644 --- a/_autosummary/one.tests.remote.test_globus.html +++ b/_autosummary/one.tests.remote.test_globus.html @@ -1,3 +1,5 @@ + + @@ -6,23 +8,19 @@ one.tests.remote.test_globus — ONE documentation - + - - - - - - - - - - + + + + + + + + diff --git a/_autosummary/one.tests.test_alyxclient.html b/_autosummary/one.tests.test_alyxclient.html index 96453d16..b080a22c 100644 --- a/_autosummary/one.tests.test_alyxclient.html +++ b/_autosummary/one.tests.test_alyxclient.html @@ -1,3 +1,5 @@ + + @@ -6,23 +8,19 @@ one.tests.test_alyxclient — ONE documentation - + - - - - - - - - - - + + + + + + + + @@ -335,6 +333,12 @@

    Tests setter for AlyxClient.cache_dir attribute.

    +
    +
    +test_paginated_response()[source]
    +

    Test the _PaginatedResponse class.

    +
    +
    diff --git a/_autosummary/one.tests.test_alyxrest.html b/_autosummary/one.tests.test_alyxrest.html index e22189e5..16982c71 100644 --- a/_autosummary/one.tests.test_alyxrest.html +++ b/_autosummary/one.tests.test_alyxrest.html @@ -1,3 +1,5 @@ + + @@ -6,23 +8,19 @@ one.tests.test_alyxrest — ONE documentation - + - - - - - - - - - - + + + + + + + + diff --git a/_autosummary/one.tests.test_converters.html b/_autosummary/one.tests.test_converters.html index 0ec2959e..77c10af5 100644 --- a/_autosummary/one.tests.test_converters.html +++ b/_autosummary/one.tests.test_converters.html @@ -1,3 +1,5 @@ + + @@ -6,23 +8,19 @@ one.tests.test_converters — ONE documentation - + - - - - - - - - - - + + + + + + + + diff --git a/_autosummary/one.tests.test_one.html b/_autosummary/one.tests.test_one.html index 38ae5354..da6f9294 100644 --- a/_autosummary/one.tests.test_one.html +++ b/_autosummary/one.tests.test_one.html @@ -1,3 +1,5 @@ + + @@ -6,23 +8,19 @@ one.tests.test_one — ONE documentation - + - - - - - - - - - - + + + + + + + + @@ -174,16 +172,16 @@

    This could be an offline test.

    TestOneDownload

    -

    Test downloading datasets using OpenAlyx

    +

    Test downloading datasets using OpenAlyx.

    TestOneMisc

    -

    Test functions in one.util

    +

    Test functions in one.util.

    TestOneRemote

    Test remote queries using OpenAlyx

    TestOneSetup

    -

    Test parameter setup upon ONE instantiation and calling setup methods

    +

    Test parameter setup upon ONE instantiation and calling setup methods.

    @@ -267,8 +265,8 @@
    test_check_filesystem()[source]
    -

    Test for One._check_filesystem. -Most is already covered by other tests, this checks that it can deal with dataset frame +

    Test for One._check_filesystem.

    +

    Most is already covered by other tests, this checks that it can deal with dataset frame without eid index and without a session_path column.

    @@ -494,25 +492,25 @@
    test_search_terms()[source]
    -

    Test OneAlyx.search_terms

    +

    Test OneAlyx.search_terms.

    test_load_dataset()[source]
    -

    Test OneAlyx.load_dataset

    +

    Test OneAlyx.load_dataset.

    test_load_object()[source]
    -

    Test OneAlyx.load_object

    +

    Test OneAlyx.load_object.

    test_get_details()[source]
    -

    Test OneAlyx.get_details

    +

    Test OneAlyx.get_details.

    @@ -521,7 +519,7 @@
    class TestOneDownload(methodName='runTest')[source]

    Bases: TestCase

    -

    Test downloading datasets using OpenAlyx

    +

    Test downloading datasets using OpenAlyx.

    tempdir = None
    @@ -541,7 +539,7 @@
    test_download_datasets()[source]
    -

    Test OneAlyx._download_dataset, _download_file and _dset2url

    +

    Test OneAlyx._download_dataset, _download_file and _dset2url.

    @@ -553,8 +551,8 @@
    test_tag_mismatched_file_record()[source]
    -

    Test for OneAlyx._tag_mismatched_file_record. -This method is also tested in test_download_datasets.

    +

    Test for OneAlyx._tag_mismatched_file_record.

    +

    This method is also tested in test_download_datasets.

    @@ -569,7 +567,7 @@
    class TestOneSetup(methodName='runTest')[source]

    Bases: TestCase

    -

    Test parameter setup upon ONE instantiation and calling setup methods

    +

    Test parameter setup upon ONE instantiation and calling setup methods.

    setUp() None[source]
    @@ -579,48 +577,52 @@
    test_local_cache_setup_prompt()[source]
    -

    Test One.setup

    +

    Test One.setup.

    test_setup_silent()[source]
    -

    Test setting up parameters with silent flag. -- Mock getfile to return temp dir as param file location -- Mock input function as fail safe in case function erroneously prompts user for input

    +

    Test setting up parameters with silent flag.

    +
      +
    • Mock getfile to return temp dir as param file location

    • +
    • Mock input function as fail safe in case function erroneously prompts user for input

    • +
    test_setup_username()[source]
    -

    Test setting up parameters with a provided username. -- Mock getfile to return temp dir as param file location -- Mock input function as fail safe in case function erroneously prompts user for input -- Mock requests.post returns a fake user authentication response

    +

    Test setting up parameters with a provided username.

    +
      +
    • Mock getfile to return temp dir as param file location

    • +
    • Mock input function as fail safe in case function erroneously prompts user for input

    • +
    • Mock requests.post returns a fake user authentication response

    • +
    test_static_setup()[source]
    -

    Test OneAlyx.setup

    +

    Test OneAlyx.setup.

    test_setup()[source]
    -

    Test one.params.setup

    +

    Test one.params.setup.

    test_patch_params()[source]
    -

    Test patching legacy params to the new location

    +

    Test patching legacy params to the new location.

    test_one_factory()[source]
    -

    Tests the ONE class factory

    +

    Tests the ONE class factory.

    @@ -629,47 +631,54 @@
    class TestOneMisc(methodName='runTest')[source]

    Bases: TestCase

    -

    Test functions in one.util

    +

    Test functions in one.util.

    test_validate_date_range()[source]
    -

    Test one.util.validate_date_range

    +

    Test one.util.validate_date_range.

    test_index_last_before()[source]
    -

    Test one.util.index_last_before

    +

    Test one.util.index_last_before.

    test_collection_spec()[source]
    -

    Test one.util._collection_spec

    +

    Test one.util._collection_spec.

    test_revision_last_before()[source]
    -

    Test one.util.filter_revision_last_before

    +

    Test one.util.filter_revision_last_before.

    test_parse_id()[source]
    -

    Test one.util.parse_id

    +

    Test one.util.parse_id.

    test_autocomplete()[source]
    -

    Test one.util.autocomplete

    +

    Test one.util.autocomplete.

    test_LazyID()[source]
    -

    Test one.util.LazyID

    +

    Test one.util.LazyID.

    +
    + +
    +
    +test_ensure_list()[source]
    +

    Test one.util.ensure_list.

    +

    This function has now moved therefore we simply check for deprecation warning.

    diff --git a/_autosummary/one.tests.test_params.html b/_autosummary/one.tests.test_params.html index 230346f2..b40baf2e 100644 --- a/_autosummary/one.tests.test_params.html +++ b/_autosummary/one.tests.test_params.html @@ -1,3 +1,5 @@ + + @@ -6,23 +8,19 @@ one.tests.test_params — ONE documentation - + - - - - - - - - - - + + + + + + + + diff --git a/_autosummary/one.tests.test_registration.html b/_autosummary/one.tests.test_registration.html index ff1e4044..cd36a305 100644 --- a/_autosummary/one.tests.test_registration.html +++ b/_autosummary/one.tests.test_registration.html @@ -1,3 +1,5 @@ + + @@ -6,23 +8,19 @@ one.tests.test_registration — ONE documentation - + - - - - - - - - - - + + + + + + + + diff --git a/_autosummary/one.tests.util.html b/_autosummary/one.tests.util.html index 5a2d522b..fc8b56df 100644 --- a/_autosummary/one.tests.util.html +++ b/_autosummary/one.tests.util.html @@ -1,3 +1,5 @@ + + @@ -6,23 +8,19 @@ one.tests.util — ONE documentation - + - - - - - - - - - - + + + + + + + + @@ -221,7 +219,7 @@
    -revisions_datasets_table(collections=('', 'alf/probe00', 'alf/probe01'), revisions=('', '2020-01-08', '2021-07-06'), object='spikes', attributes=('times', 'waveforems'))[source]
    +revisions_datasets_table(collections=('', 'alf/probe00', 'alf/probe01'), revisions=('', '2020-01-08', '2021-07-06'), object='spikes', attributes=('times', 'waveforems'), touch_path=None)[source]

    Returns a datasets cache DataFrame containing datasets with revision folders.

    As there are no revised datasets on the test databases, this function acts as a fixture for testing the filtering of datasets by a revision.

    @@ -232,10 +230,11 @@
  • revisions (tuple) – A list of revisions

  • object (str) – An ALF object

  • attributes (tuple) – A list of ALF attributes

  • +
  • touch_path (pathlib.Path, str) – If provided, files are created in this directory.

  • Returns:
    -

    A datasets cache table containing datasets made from the input names

    +

    A datasets cache table containing datasets made from the input names.

    Return type:

    pd.DataFrame

    diff --git a/_autosummary/one.util.QC_TYPE.html b/_autosummary/one.util.QC_TYPE.html index cae3ed9f..45960298 100644 --- a/_autosummary/one.util.QC_TYPE.html +++ b/_autosummary/one.util.QC_TYPE.html @@ -1,3 +1,5 @@ + + @@ -6,23 +8,19 @@ one.util.QC_TYPE — ONE documentation - + - - - - - - - - - - + + + + + + + + diff --git a/_autosummary/one.util.html b/_autosummary/one.util.html index e10e70bd..157dcfdb 100644 --- a/_autosummary/one.util.html +++ b/_autosummary/one.util.html @@ -1,3 +1,5 @@ + + @@ -6,23 +8,19 @@ one.util — ONE documentation - + - - - - - - - - - - + + + + + + + + @@ -341,7 +339,9 @@ not permitted.

  • revision_last_before (bool) – When true and no exact match exists, the (lexicographically) previous revision is used instead. When false the revision string is matched like collection and filename, -with regular expressions permitted.

  • +with regular expressions permitted. NB: When true and revision is None the default +revision is returned which may not be the last revision. If no default is defined, the +last revision is returned.

  • qc (str, int, one.alf.spec.QC) – Returns datasets at or below this QC level. Integer values should correspond to the QC enumeration NOT the qc category column codes in the pandas table.

  • ignore_qc_not_set (bool) – When true, do not return datasets for which QC is NOT_SET.

  • @@ -382,6 +382,25 @@
    >>> datasets filter_datasets(all_datasets, qc='PASS', ignore_qc_not_set=True)
     
    +
    +
    Raises:
    +
      +
    • one.alf.exceptions.ALFMultipleCollectionsFound – The matching list of datasets have more than one unique collection and assert_unique is + True.

    • +
    • one.alf.exceptions.ALFMultipleRevisionsFound – When revision_last_before is false, the matching list of datasets have more than one + unique revision. When revision_last_before is true, a ‘default_revision’ column exists, + and no revision is passed, this error means that one or more matching datasets have + multiple revisions specified as the default. This is typically an error in the cache table + itself as all datasets should have one and only one default revision specified.

    • +
    • one.alf.exceptions.ALFMultipleObjectsFound – The matching list of datasets have more than one unique filename and both assert_unique + and revision_last_before are true.

    • +
    • one.alf.exceptions.ALFError – When both assert_unique and revision_last_before is true, and a ‘default_revision’ + column exists but revision is None; one or more matching datasets have no default + revision specified. This is typically an error in the cache table itself as all datasets + should have one and only one default revision specified.

    • +
    +
    +

    Notes

    • It is not possible to match datasets that are in a given collection OR NOT in ANY collection. @@ -392,7 +411,7 @@

      -filter_revision_last_before(datasets, revision=None, assert_unique=True)[source]
      +filter_revision_last_before(datasets, revision=None, assert_unique=True, assert_consistent=False)[source]

      Filter datasets by revision, returning previous revision in ordered list if revision doesn’t exactly match.

      @@ -402,6 +421,8 @@
    • revision (str) – A revision string to match (regular expressions not permitted).

    • assert_unique (bool) – When true an alferr.ALFMultipleRevisionsFound exception is raised when multiple default revisions are found; an alferr.ALFError when no default revision is found.

    • +
    • assert_consistent (bool) – Will raise alferr.ALFMultipleRevisionsFound if matching revision is different between +datasets.

    Returns:
    @@ -410,7 +431,30 @@
    Return type:

    pd.DataFrame

    +
    Raises:
    +
      +
    • one.alf.exceptions.ALFMultipleRevisionsFound – When the ‘default_revision’ column exists and no revision is passed, this error means that + one or more matching datasets have multiple revisions specified as the default. This is + typically an error in the cache table itself as all datasets should have one and only one + default revision specified. + When assert_consistent is True, this error may mean that the matching datasets have + mixed revisions.

    • +
    • one.alf.exceptions.ALFMultipleObjectsFound – The matching list of datasets have more than one unique filename and both assert_unique + and revision_last_before are true.

    • +
    • one.alf.exceptions.ALFError – When both assert_unique and revision_last_before is true, and a ‘default_revision’ + column exists but revision is None; one or more matching datasets have no default + revision specified. This is typically an error in the cache table itself as all datasets + should have one and only one default revision specified.

    • +
    +
    +

    Notes

    +
      +
    • When revision is not None, the default revision value is not used. If an older revision is +the default one (uncommon), passing in a revision may lead to a newer revision being returned +than if revision is None.

    • +
    • A view is returned if a revision column is present, otherwise a copy is returned.

    • +
    diff --git a/_autosummary/one.webclient.html b/_autosummary/one.webclient.html index ddf70da1..26b20693 100644 --- a/_autosummary/one.webclient.html +++ b/_autosummary/one.webclient.html @@ -1,3 +1,5 @@ + + @@ -6,23 +8,19 @@ one.webclient — ONE documentation - + - - - - - - - - - - + + + + + + + + @@ -445,8 +443,9 @@
    logout()[source]
    -

    Log out from Alyx. -Deletes the cached authentication token for the currently logged-in user.

    +

    Log out from Alyx.

    +

    Deletes the cached authentication token for the currently logged-in user +and clears the REST cache.

    diff --git a/_modules/index.html b/_modules/index.html index d996c3b2..ca39add7 100644 --- a/_modules/index.html +++ b/_modules/index.html @@ -1,3 +1,5 @@ + + @@ -5,23 +7,19 @@ Overview: module code — ONE documentation - + - - - - - - - - - - + + + + + + + + diff --git a/_modules/one/alf/cache.html b/_modules/one/alf/cache.html index a26c6fd7..214968d1 100644 --- a/_modules/one/alf/cache.html +++ b/_modules/one/alf/cache.html @@ -1,3 +1,5 @@ + + @@ -5,23 +7,19 @@ one.alf.cache — ONE documentation - + - - - - - - - - - - + + + + + + + + @@ -139,7 +137,7 @@

    Source code for one.alf.cache

     from one.alf.io import iter_sessions, iter_datasets
     from one.alf.files import session_path_parts, get_alf_path
     from one.converters import session_record2path
    -from one.util import QC_TYPE
    +from one.util import QC_TYPE, patch_cache
     
     __all__ = ['make_parquet_db', 'remove_missing_datasets', 'DATASETS_COLUMNS', 'SESSIONS_COLUMNS']
     _logger = logging.getLogger(__name__)
    @@ -161,7 +159,6 @@ 

    Source code for one.alf.cache

     DATASETS_COLUMNS = (
         'id',               # int64
         'eid',              # int64
    -    'session_path',     # relative to the root
         'rel_path',         # relative to the session path, includes the filename
         'file_size',        # file size in bytes
         'hash',             # sha1/md5, computed in load function
    @@ -198,7 +195,6 @@ 

    Source code for one.alf.cache

         return {
             'id': Path(rel_ses_path, rel_dset_path).as_posix(),
             'eid': str(ses_eid),
    -        'session_path': str(rel_ses_path),
             'rel_path': Path(rel_dset_path).as_posix(),
             'file_size': file_size,
             'hash': md5(full_dset_path) if compute_hash else None,
    @@ -411,18 +407,30 @@ 

    Source code for one.alf.cache

         if tables is None:
             tables = {}
             for name in ('datasets', 'sessions'):
    -            tables[name], _ = parquet.load(cache_dir / f'{name}.pqt')
    -    to_delete = []
    +            table, m = parquet.load(cache_dir / f'{name}.pqt')
    +            tables[name] = patch_cache(table, m.get('min_api_version'), name)
    +
    +    INDEX_KEY = '.?id'
    +    for name in tables:
    +        # Set the appropriate index if none already set
    +        if isinstance(tables[name].index, pd.RangeIndex):
    +            idx_columns = sorted(tables[name].filter(regex=INDEX_KEY).columns)
    +            tables[name].set_index(idx_columns, inplace=True)
    +
    +    to_delete = set()
         gen_path = partial(session_record2path, root_dir=cache_dir)
    -    sessions = sorted(map(lambda x: gen_path(x[1]), tables['sessions'].iterrows()))
    +    # map of session path to eid
    +    sessions = {gen_path(rec): eid for eid, rec in tables['sessions'].iterrows()}
         for session_path in iter_sessions(cache_dir):
    -        rel_session_path = session_path.relative_to(cache_dir).as_posix()
    -        datasets = tables['datasets'][tables['datasets']['session_path'] == rel_session_path]
    +        try:
    +            datasets = tables['datasets'].loc[sessions[session_path]]
    +        except KeyError:
    +            datasets = tables['datasets'].iloc[0:0, :]
             for dataset in iter_datasets(session_path):
                 if dataset.as_posix() not in datasets['rel_path']:
    -                to_delete.append(session_path.joinpath(dataset))
    +                to_delete.add(session_path.joinpath(dataset))
             if session_path not in sessions and remove_empty_sessions:
    -            to_delete.append(session_path)
    +            to_delete.add(session_path)
     
         if dry:
             print('The following session and datasets would be removed:', end='\n\t')
    diff --git a/_modules/one/alf/exceptions.html b/_modules/one/alf/exceptions.html
    index 0a7954b9..acdbce66 100644
    --- a/_modules/one/alf/exceptions.html
    +++ b/_modules/one/alf/exceptions.html
    @@ -1,3 +1,5 @@
    +
    +
     
     
     
    @@ -5,23 +7,19 @@
       
       one.alf.exceptions — ONE  documentation
           
    -      
    +      
           
           
     
       
    -  
    -  
    -        
    -        
    -        
    -        
    -        
    -        
    -        
    -        
    +      
    +      
    +      
    +      
    +      
    +      
    +      
    +      
         
         
          
    @@ -107,7 +105,7 @@
                

    Source code for one.alf.exceptions

    -"""ALyx File related errors.
    +"""ALyx File related errors and warnings.
     
     A set of Alyx and ALF related error classes which provide a more verbose description of the raised
     issues.
    @@ -209,6 +207,14 @@ 

    Source code for one.alf.exceptions

                        'Multiple datasets in different revision folders were found with no default '
                        'specified.')
    + + +
    +[docs] +class ALFWarning(Warning): + """Cautions when loading ALF datasets.""" + pass
    +
    diff --git a/_modules/one/alf/files.html b/_modules/one/alf/files.html index b54cd842..170f6723 100644 --- a/_modules/one/alf/files.html +++ b/_modules/one/alf/files.html @@ -1,3 +1,5 @@ + + @@ -5,23 +7,19 @@ one.alf.files — ONE documentation - + - - - - - - - - - - + + + + + + + + diff --git a/_modules/one/alf/io.html b/_modules/one/alf/io.html index 12e00b4e..be5314cd 100644 --- a/_modules/one/alf/io.html +++ b/_modules/one/alf/io.html @@ -1,3 +1,5 @@ + + @@ -5,23 +7,19 @@ one.alf.io — ONE documentation - + - - - - - - - - - - + + + + + + + + diff --git a/_modules/one/alf/spec.html b/_modules/one/alf/spec.html index 97ff0068..f0eb5555 100644 --- a/_modules/one/alf/spec.html +++ b/_modules/one/alf/spec.html @@ -1,3 +1,5 @@ + + @@ -5,23 +7,19 @@ one.alf.spec — ONE documentation - + - - - - - - - - - - + + + + + + + + diff --git a/_modules/one/api.html b/_modules/one/api.html index 6c837113..e3f331bd 100644 --- a/_modules/one/api.html +++ b/_modules/one/api.html @@ -1,3 +1,5 @@ + + @@ -5,23 +7,19 @@ one.api — ONE documentation - + - - - - - - - - - - + + + + + + + + @@ -129,7 +127,7 @@

    Source code for one.api

     import packaging.version
     
     from iblutil.io import parquet, hashfile
    -from iblutil.util import Bunch, flatten
    +from iblutil.util import Bunch, flatten, ensure_list
     
     import one.params
     import one.webclient as wc
    @@ -137,10 +135,10 @@ 

    Source code for one.api

     import one.alf.files as alfiles
     import one.alf.exceptions as alferr
     from .alf.cache import make_parquet_db, DATASETS_COLUMNS, SESSIONS_COLUMNS
    -from .alf.spec import is_uuid_string, QC
    +from .alf.spec import is_uuid_string, QC, to_alf
     from . import __version__
     from one.converters import ConversionMixin, session_record2path
    -import one.util as util
    +from one import util
     
     _logger = logging.getLogger(__name__)
     __all__ = ['ONE', 'One', 'OneAlyx']
    @@ -247,7 +245,7 @@ 

    Source code for one.api

     
                 # Set the appropriate index if none already set
                 if isinstance(cache.index, pd.RangeIndex):
    -                idx_columns = cache.filter(regex=INDEX_KEY).columns.tolist()
    +                idx_columns = sorted(cache.filter(regex=INDEX_KEY).columns)
                     if len(idx_columns) == 0:
                         raise KeyError('Failed to set index')
                     cache.set_index(idx_columns, inplace=True)
    @@ -410,9 +408,10 @@ 

    Source code for one.api

                 if not strict:
                     # Deal with case where there are extra columns in the cache
                     extra_columns = set(self._cache[table].columns) - set(records.columns)
    -                for col in extra_columns:
    -                    n = list(self._cache[table].columns).index(col)
    -                    records.insert(n, col, np.nan)
    +                column_ids = map(list(self._cache[table].columns).index, extra_columns)
    +                for col, n in sorted(zip(extra_columns, column_ids), key=lambda x: x[1]):
    +                    val = records.get('exists', True) if col.startswith('exists_') else np.nan
    +                    records.insert(n, col, val)
                     # Drop any extra columns in the records that aren't in cache table
                     to_drop = set(records.columns) - set(self._cache[table].columns)
                     records.drop(to_drop, axis=1, inplace=True)
    @@ -425,7 +424,8 @@ 

    Source code for one.api

                 to_assign = records[~to_update]
                 if isinstance(self._cache[table].index, pd.MultiIndex) and not to_assign.empty:
                     # Concatenate and sort (no other way for non-unique index within MultiIndex)
    -                self._cache[table] = pd.concat([self._cache[table], to_assign]).sort_index()
    +                frames = filter(lambda x: not x.empty, [self._cache[table], to_assign])
    +                self._cache[table] = pd.concat(frames).sort_index()
                 else:
                     for index, record in to_assign.iterrows():
                         self._cache[table].loc[index, :] = record[self._cache[table].columns].values
    @@ -629,7 +629,7 @@ 

    Source code for one.api

                     return ([], None) if details else []
                 # String fields
                 elif key in ('subject', 'task_protocol', 'laboratory', 'projects'):
    -                query = '|'.join(util.ensure_list(value))
    +                query = '|'.join(ensure_list(value))
                     key = 'lab' if key == 'laboratory' else key
                     mask = sessions[key].str.contains(query, regex=self.wildcards)
                     sessions = sessions[mask.astype(bool, copy=False)]
    @@ -638,7 +638,7 @@ 

    Source code for one.api

                     session_date = pd.to_datetime(sessions['date'])
                     sessions = sessions[(session_date >= start) & (session_date <= end)]
                 elif key == 'number':
    -                query = util.ensure_list(value)
    +                query = ensure_list(value)
                     sessions = sessions[sessions[key].isin(map(int, query))]
                 # Dataset/QC check is biggest so this should be done last
                 elif key == 'dataset' or (key == 'dataset_qc_lte' and 'dataset' not in queries):
    @@ -646,7 +646,7 @@ 

    Source code for one.api

                     qc = QC.validate(queries.get('dataset_qc_lte', 'FAIL')).name  # validate value
                     has_dset = sessions.index.isin(datasets.index.get_level_values('eid'))
                     datasets = datasets.loc[(sessions.index.values[has_dset], ), :]
    -                query = util.ensure_list(value if key == 'dataset' else '')
    +                query = ensure_list(value if key == 'dataset' else '')
                     # For each session check any dataset both contains query and exists
                     mask = (
                         (datasets
    @@ -679,9 +679,8 @@ 

    Source code for one.api

     
             Given a set of datasets, check whether records correctly reflect the filesystem.
             Called by load methods, this returns a list of file paths to load and return.
    -        TODO This needs changing; overload for downloading?
    -         This changes datasets frame, calls _update_cache(sessions=None, datasets=None) to
    -         update and save tables.  Download_datasets can also call this function.
    +        This changes datasets frame, calls _update_cache(sessions=None, datasets=None) to
    +        update and save tables.  Download_datasets may also call this function.
     
             Parameters
             ----------
    @@ -702,12 +701,18 @@ 

    Source code for one.api

             """
             if isinstance(datasets, pd.Series):
                 datasets = pd.DataFrame([datasets])
    +            assert datasets.index.nlevels <= 2
    +            idx_names = ['eid', 'id'] if datasets.index.nlevels == 2 else ['id']
    +            datasets.index.set_names(idx_names, inplace=True)
             elif not isinstance(datasets, pd.DataFrame):
                 # Cast set of dicts (i.e. from REST datasets endpoint)
                 datasets = util.datasets2records(list(datasets))
    +        else:
    +            datasets = datasets.copy()
             indices_to_download = []  # indices of datasets that need (re)downloading
             files = []  # file path list to return
             # If the session_path field is missing from the datasets table, fetch from sessions table
    +        # Typically only aggregate frames contain this column
             if 'session_path' not in datasets.columns:
                 if 'eid' not in datasets.index.names:
                     # Get slice of full frame with eid in index
    @@ -748,20 +753,6 @@ 

    Source code for one.api

                     files.append(None)
                     # Add this index to list of datasets that need downloading
                     indices_to_download.append(i)
    -            if rec['exists'] != file.exists():
    -                with warnings.catch_warnings():
    -                    # Suppress future warning: exist column should always be present
    -                    msg = '.*indexing on a MultiIndex with a nested sequence of labels.*'
    -                    warnings.filterwarnings('ignore', message=msg)
    -                    datasets.at[i, 'exists'] = not rec['exists']
    -                    if update_exists:
    -                        _logger.debug('Updating exists field')
    -                        if isinstance(i, tuple):
    -                            self._cache['datasets'].loc[i, 'exists'] = not rec['exists']
    -                        else:  # eid index level missing in datasets input
    -                            i = pd.IndexSlice[:, i]
    -                            self._cache['datasets'].loc[i, 'exists'] = not rec['exists']
    -                        self._cache['_meta']['modified_time'] = datetime.now()
     
             # If online and we have datasets to download, call download_datasets with these datasets
             if not (offline or self.offline) and indices_to_download:
    @@ -772,14 +763,32 @@ 

    Source code for one.api

                 for i, file in zip(indices_to_download, new_files):
                     files[datasets.index.get_loc(i)] = file
     
    +        # NB: Currently if not offline and a remote file is missing, an exception will be raised
    +        # before we reach this point. This could change in the future.
    +        exists = list(map(bool, files))
    +        if not all(datasets['exists'] == exists):
    +            with warnings.catch_warnings():
    +                # Suppress future warning: exist column should always be present
    +                msg = '.*indexing on a MultiIndex with a nested sequence of labels.*'
    +                warnings.filterwarnings('ignore', message=msg)
    +                datasets['exists'] = exists
    +                if update_exists:
    +                    _logger.debug('Updating exists field')
    +                    i = datasets.index
    +                    if i.nlevels == 1:
    +                        # eid index level missing in datasets input
    +                        i = pd.IndexSlice[:, i]
    +                    self._cache['datasets'].loc[i, 'exists'] = exists
    +                    self._cache['_meta']['modified_time'] = datetime.now()
    +
             if self.record_loaded:
                 loaded = np.fromiter(map(bool, files), bool)
    -            loaded_ids = np.array(datasets.index.to_list())[loaded]
    +            loaded_ids = datasets.index.get_level_values('id')[loaded].to_numpy()
                 if '_loaded_datasets' not in self._cache:
                     self._cache['_loaded_datasets'] = np.unique(loaded_ids)
                 else:
                     loaded_set = np.hstack([self._cache['_loaded_datasets'], loaded_ids])
    -                self._cache['_loaded_datasets'] = np.unique(loaded_set, axis=0)
    +                self._cache['_loaded_datasets'] = np.unique(loaded_set)
     
             # Return full list of file paths
             return files
    @@ -838,7 +847,7 @@ 

    Source code for one.api

         @util.refresh
         def list_datasets(
                 self, eid=None, filename=None, collection=None, revision=None, qc=QC.FAIL,
    -            ignore_qc_not_set=False, details=False, query_type=None
    +            ignore_qc_not_set=False, details=False, query_type=None, default_revisions_only=False
         ) -> Union[np.ndarray, pd.DataFrame]:
             """
             Given an eid, return the datasets for those sessions.
    @@ -871,6 +880,9 @@ 

    Source code for one.api

                 relative paths (collection/revision/filename) - see one.alf.spec.describe for details.
             query_type : str
                 Query cache ('local') or Alyx database ('remote').
    +        default_revisions_only : bool
    +            When true, only matching datasets that are considered default revisions are returned.
    +            If no 'default_revision' column is present, and ALFError is raised.
     
             Returns
             -------
    @@ -900,6 +912,11 @@ 

    Source code for one.api

             >>> datasets = one.list_datasets(eid, {'object': ['wheel', 'trial?']})
             """
             datasets = self._cache['datasets']
    +        if default_revisions_only:
    +            if 'default_revision' not in datasets.columns:
    +                raise alferr.ALFError('No default revisions specified')
    +            datasets = datasets[datasets['default_revision']]
    +
             filter_args = dict(
                 collection=collection, filename=filename, wildcards=self.wildcards, revision=revision,
                 revision_last_before=False, assert_unique=False, qc=qc,
    @@ -1149,6 +1166,9 @@ 

    Source code for one.api

     
             # For those that don't exist, download them
             offline = None if query_type == 'auto' else self.mode == 'local'
    +        if datasets.index.nlevels == 1:
    +            # Reinstate eid index
    +            datasets = pd.concat({str(eid): datasets}, names=['eid'])
             files = self._check_filesystem(datasets, offline=offline, check_hash=check_hash)
             files = [x for x in files if x]
             if not files:
    @@ -1256,6 +1276,9 @@ 

    Source code for one.api

                                             wildcards=self.wildcards, assert_unique=assert_unique)
             if len(datasets) == 0:
                 raise alferr.ALFObjectNotFound(f'Dataset "{dataset}" not found')
    +        if datasets.index.nlevels == 1:
    +            # Reinstate eid index
    +            datasets = pd.concat({str(eid): datasets}, names=['eid'])
     
             # Check files exist / download remote files
             offline = None if query_type == 'auto' else self.mode == 'local'
    @@ -1282,9 +1305,11 @@ 

    Source code for one.api

                           download_only: bool = False,
                           check_hash: bool = True) -> Any:
             """
    -        Load datasets for a given session id.  Returns two lists the length of datasets.  The
    -        first is the data (or file paths if download_data is false), the second is a list of
    -        meta data Bunches.  If assert_present is false, missing data will be returned as None.
    +        Load datasets for a given session id.
    +
    +        Returns two lists the length of datasets.  The first is the data (or file paths if
    +        download_data is false), the second is a list of meta data Bunches.  If assert_present is
    +        false, missing data will be returned as None.
     
             Parameters
             ----------
    @@ -1316,9 +1341,9 @@ 

    Source code for one.api

             Returns
             -------
             list
    -            A list of data (or file paths) the length of datasets
    +            A list of data (or file paths) the length of datasets.
             list
    -            A list of meta data Bunches. If assert_present is False, missing data will be None
    +            A list of meta data Bunches. If assert_present is False, missing data will be None.
     
             Notes
             -----
    @@ -1330,6 +1355,8 @@ 

    Source code for one.api

               revision as separate keyword arguments.
             - To ensure you are loading the correct revision, use the revisions kwarg instead of
               relative paths.
    +        - To load an exact revision (i.e. not the last revision before a given date), pass in
    +          a list of relative paths or a data frame.
     
             Raises
             ------
    @@ -1372,8 +1399,25 @@ 

    Source code for one.api

     
             if isinstance(datasets, str):
                 raise TypeError('`datasets` must be a non-string iterable')
    -        # Check input args
    -        collections, revisions = _verify_specifiers([collections, revisions])
    +
    +        # Check if rel paths have been used (e.g. the output of list_datasets)
    +        is_frame = isinstance(datasets, pd.DataFrame)
    +        if is_rel_paths := (is_frame or any('/' in x for x in datasets)):
    +            if not (collections, revisions) == (None, None):
    +                raise ValueError(
    +                    'collection and revision kwargs must be None when dataset is a relative path')
    +            if is_frame:
    +                if 'eid' in datasets.index.names:
    +                    assert set(datasets.index.get_level_values('eid')) == {eid}
    +                datasets = datasets['rel_path'].tolist()
    +            datasets = list(map(partial(alfiles.rel_path_parts, as_dict=True), datasets))
    +            if len(datasets) > 0:
    +                # Extract collection and revision from each of the parsed datasets
    +                # None -> '' ensures exact collections and revisions are used in filter
    +                # NB: f user passes in dicts, any collection/revision keys will be ignored.
    +                collections, revisions = zip(
    +                    *((x.pop('collection') or '', x.pop('revision') or '') for x in datasets)
    +                )
     
             # Short circuit
             query_type = query_type or self.mode
    @@ -1387,35 +1431,49 @@ 

    Source code for one.api

             if len(datasets) == 0:
                 return None, all_datasets.iloc[0:0]  # Return empty
     
    -        # Filter and load missing
    -        if self.wildcards:  # Append extension wildcard if 'object.attribute' string
    -            datasets = [x + ('.*' if isinstance(x, str) and len(x.split('.')) == 2 else '')
    -                        for x in datasets]
    +        # More input validation
    +        input_types = [(isinstance(x, str), isinstance(x, dict)) for x in datasets]
    +        if not all(map(any, input_types)) or not any(map(all, zip(*input_types))):
    +            raise ValueError('`datasets` must be iterable of only str or only dicts')
    +        if self.wildcards and input_types[0][0]:  # if wildcards and input is iter of str
    +            # Append extension wildcard if 'object.attribute' string
    +            datasets = [
    +                x + ('.*' if isinstance(x, str) and len(x.split('.')) == 2 else '')
    +                for x in datasets
    +            ]
    +
    +        # Check input args
    +        collections, revisions = _verify_specifiers([collections, revisions])
    +
             # If collections provided in datasets list, e.g. [collection/x.y.z], do not assert unique
    -        validate = not any(('/' if isinstance(d, str) else 'collection') in d for d in datasets)
    -        if not validate and not all(x is None for x in collections + revisions):
    -            raise ValueError(
    -                'collection and revision kwargs must be None when dataset is a relative path')
    -        ops = dict(wildcards=self.wildcards, assert_unique=validate)
    +        # If not a dataframe, use revision last before (we've asserted no revision in rel_path)
    +        ops = dict(
    +            wildcards=self.wildcards, assert_unique=True, revision_last_before=not is_rel_paths)
             slices = [util.filter_datasets(all_datasets, x, y, z, **ops)
                       for x, y, z in zip(datasets, collections, revisions)]
             present = [len(x) == 1 for x in slices]
             present_datasets = pd.concat(slices)
    +        if present_datasets.index.nlevels == 1:
    +            # Reinstate eid index
    +            present_datasets = pd.concat({str(eid): present_datasets}, names=['eid'])
     
             # Check if user is blindly downloading all data and warn of non-default revisions
             if 'default_revision' in present_datasets and \
    -                not any(revisions) and not all(present_datasets['default_revision']):
    +                is_rel_paths and not all(present_datasets['default_revision']):
                 old = present_datasets.loc[~present_datasets['default_revision'], 'rel_path'].to_list()
                 warnings.warn(
                     'The following datasets may have been revised and ' +
                     'are therefore not recommended for analysis:\n\t' +
                     '\n\t'.join(old) + '\n'
    -                'To avoid this warning, specify the revision as a kwarg or use load_dataset.'
    +                'To avoid this warning, specify the revision as a kwarg or use load_dataset.',
    +                alferr.ALFWarning
                 )
     
             if not all(present):
    -            missing_list = ', '.join(x for x, y in zip(datasets, present) if not y)
    -            # FIXME include collection and revision also
    +            missing_list = (x if isinstance(x, str) else to_alf(**x) for x in datasets)
    +            missing_list = ('/'.join(filter(None, [c, f'#{r}#' if r else None, d]))
    +                            for c, r, d in zip(collections, revisions, missing_list))
    +            missing_list = ', '.join(x for x, y in zip(missing_list, present) if not y)
                 message = f'The following datasets are not in the cache: {missing_list}'
                 if assert_present:
                     raise alferr.ALFObjectNotFound(message)
    @@ -1436,7 +1494,7 @@ 

    Source code for one.api

     
             # Make list of metadata Bunches out of the table
             records = (present_datasets
    -                   .reset_index(names='id')
    +                   .reset_index(names=['eid', 'id'])
                        .to_dict('records', into=Bunch))
     
             # Ensure result same length as input datasets list
    @@ -1575,6 +1633,9 @@ 

    Source code for one.api

             if len(datasets) == 0:
                 raise alferr.ALFObjectNotFound(object or '')
             parts = [alfiles.rel_path_parts(x) for x in datasets.rel_path]
    +        if datasets.index.nlevels == 1:
    +            # Reinstate eid index
    +            datasets = pd.concat({str(eid): datasets}, names=['eid'])
     
             # For those that don't exist, download them
             offline = None if query_type == 'auto' else self.mode == 'local'
    @@ -1945,11 +2006,11 @@ 

    Source code for one.api

         @util.refresh
         def list_datasets(
                 self, eid=None, filename=None, collection=None, revision=None, qc=QC.FAIL,
    -            ignore_qc_not_set=False, details=False, query_type=None
    +            ignore_qc_not_set=False, details=False, query_type=None, default_revisions_only=False
         ) -> Union[np.ndarray, pd.DataFrame]:
             filters = dict(
    -            collection=collection, filename=filename, revision=revision,
    -            qc=qc, ignore_qc_not_set=ignore_qc_not_set)
    +            collection=collection, filename=filename, revision=revision, qc=qc,
    +            ignore_qc_not_set=ignore_qc_not_set, default_revisions_only=default_revisions_only)
             if (query_type or self.mode) != 'remote':
                 return super().list_datasets(eid, details=details, query_type=query_type, **filters)
             elif not eid:
    @@ -1964,6 +2025,7 @@ 

    Source code for one.api

             if datasets is None or datasets.empty:
                 return self._cache['datasets'].iloc[0:0] if details else []  # Return empty
             assert set(datasets.index.unique('eid')) == {eid}
    +        del filters['default_revisions_only']
             datasets = util.filter_datasets(
                 datasets.droplevel('eid'), assert_unique=False, wildcards=self.wildcards, **filters)
             # Return only the relative path
    @@ -2007,8 +2069,7 @@ 

    Source code for one.api

             all_aggregates = self.alyx.rest('datasets', 'list', django=query)
             records = (util.datasets2records(all_aggregates)
                        .reset_index(level=0)
    -                   .drop('eid', axis=1)
    -                   .rename_axis(index={'id': 'did'}))
    +                   .drop('eid', axis=1))
             # Since rel_path for public FI file records starts with 'public/aggregates' instead of just
             # 'aggregates', we should discard the file path parts before 'aggregates' (if present)
             records['rel_path'] = records['rel_path'].str.replace(
    @@ -2029,11 +2090,6 @@ 

    Source code for one.api

                 # NB: We avoid exact matches as most users will only include subject, not lab/subject
                 records = records[records['identifier'].str.contains(identifier)]
     
    -        # Add exists_aws field for download method
    -        for i, rec in records.iterrows():
    -            fr = next(x['file_records'] for x in all_aggregates if x['url'].endswith(i))
    -            records.loc[i, 'exists_aws'] = any(
    -                x['data_repository'].startswith('aws') and x['exists'] for x in fr)
             return util.filter_datasets(records, filename=dataset, revision=revision,
                                         wildcards=True, assert_unique=assert_unique)
    @@ -2092,6 +2148,7 @@

    Source code for one.api

                 raise alferr.ALFObjectNotFound(
                     f'{dataset or "dataset"} not found for {relation}/{identifier}')
             # update_exists=False because these datasets are not in the cache table
    +        records['session_path'] = ''  # explicitly add session path column
             file, = self._check_filesystem(records, update_exists=False)
             if not file:
                 raise alferr.ALFObjectNotFound('Dataset file not found on disk')
    @@ -2409,7 +2466,7 @@ 

    Source code for one.api

     
             def _add_date(records):
                 """Add date field for compatibility with One.search output."""
    -            for s in util.ensure_list(records):
    +            for s in ensure_list(records):
                     s['date'] = datetime.fromisoformat(s['start_time']).date()
                 return records
     
    @@ -2441,9 +2498,12 @@ 

    Source code for one.api

             try:
                 if not isinstance(dsets, pd.DataFrame):
                     raise TypeError('Input datasets must be a pandas data frame for AWS download.')
    -            if 'exists_aws' in dsets and np.all(np.equal(dsets['exists_aws'].values, True)):
    -                _logger.info('Downloading from AWS')
    -                return self._download_aws(map(lambda x: x[1], dsets.iterrows()), **kwargs)
    +            assert 'exists_aws' not in dsets or np.all(np.equal(dsets['exists_aws'].values, True))
    +            _logger.debug('Downloading from AWS')
    +            files = self._download_aws(map(lambda x: x[1], dsets.iterrows()), **kwargs)
    +            # Trigger fallback download of any files missing on AWS
    +            assert all(files), f'{sum(map(bool, files))} datasets not found on AWS'
    +            return files
             except Exception as ex:
                 _logger.debug(ex)
             return self._download_dataset(dsets, **kwargs)
    @@ -2479,7 +2539,7 @@ 

    Source code for one.api

             assert self.mode != 'local'
             # Get all dataset URLs
             dsets = list(dsets)  # Ensure not generator
    -        uuids = [util.ensure_list(x.name)[-1] for x in dsets]
    +        uuids = [ensure_list(x.name)[-1] for x in dsets]
             # If number of UUIDs is too high, fetch in loop to avoid 414 HTTP status code
             remote_records = []
             N = 100  # Number of UUIDs per query
    @@ -2493,15 +2553,18 @@ 

    Source code for one.api

                 # Fetch file record path
                 record = next((x for x in record['file_records']
                                if x['data_repository'].startswith('aws') and x['exists']), None)
    -            if not record and update_exists and 'exists_aws' in self._cache['datasets']:
    -                _logger.debug('Updating exists field')
    -                self._cache['datasets'].loc[(slice(None), uuid), 'exists_aws'] = False
    -                self._cache['_meta']['modified_time'] = datetime.now()
    +            if not record:
    +                if update_exists and 'exists_aws' in self._cache['datasets']:
    +                    _logger.debug('Updating exists field')
    +                    self._cache['datasets'].loc[(slice(None), uuid), 'exists_aws'] = False
    +                    self._cache['_meta']['modified_time'] = datetime.now()
                     out_files.append(None)
                     continue
    +            assert record['relative_path'].endswith(dset['rel_path']), \
    +                f'Relative path for dataset {uuid} does not match Alyx record'
                 source_path = PurePosixPath(record['data_repository_path'], record['relative_path'])
                 source_path = alfiles.add_uuid_string(source_path, uuid)
    -            local_path = self.cache_dir.joinpath(dset['session_path'], dset['rel_path'])
    +            local_path = self.cache_dir.joinpath(record['relative_path'])
                 if keep_uuid is True or (keep_uuid is None and self.uuid_filenames is True):
                     local_path = alfiles.add_uuid_string(local_path, uuid)
                 local_path.parent.mkdir(exist_ok=True, parents=True)
    @@ -2550,7 +2613,7 @@ 

    Source code for one.api

                     did = dset['id']
                 elif 'file_records' not in dset:  # Convert dataset Series to alyx dataset dict
                     url = self.record2url(dset)  # NB: URL will always be returned but may not exist
    -                did = util.ensure_list(dset.name)[-1]
    +                did = ensure_list(dset.name)[-1]
                 else:  # from datasets endpoint
                     repo = getattr(getattr(self._web_client, '_par', None), 'HTTP_DATA_SERVER', None)
                     url = next(
    @@ -2564,7 +2627,7 @@ 

    Source code for one.api

                 _logger.debug('Updating cache')
                 # NB: This will be considerably easier when IndexSlice supports Ellipsis
                 idx = [slice(None)] * int(self._cache['datasets'].index.nlevels / 2)
    -            self._cache['datasets'].loc[(*idx, *util.ensure_list(did)), 'exists'] = False
    +            self._cache['datasets'].loc[(*idx, *ensure_list(did)), 'exists'] = False
                 self._cache['_meta']['modified_time'] = datetime.now()
     
             return url
    @@ -2658,7 +2721,7 @@ 

    Source code for one.api

             """
             assert not self.offline
             # Ensure all target directories exist
    -        [Path(x).mkdir(parents=True, exist_ok=True) for x in set(util.ensure_list(target_dir))]
    +        [Path(x).mkdir(parents=True, exist_ok=True) for x in set(ensure_list(target_dir))]
     
             # download file(s) from url(s), returns file path(s) with UUID
             local_path, md5 = self.alyx.download_file(url, target_dir=target_dir, return_md5=True)
    @@ -2667,7 +2730,7 @@ 

    Source code for one.api

             if isinstance(url, (tuple, list)):
                 assert (file_size is None) or len(file_size) == len(url)
                 assert (hash is None) or len(hash) == len(url)
    -        for args in zip(*map(util.ensure_list, (file_size, md5, hash, local_path, url))):
    +        for args in zip(*map(ensure_list, (file_size, md5, hash, local_path, url))):
                 self._check_hash_and_file_size_mismatch(*args)
     
             # check if we are keeping the uuid on the list of file names
    diff --git a/_modules/one/converters.html b/_modules/one/converters.html
    index cd6c3235..578c7943 100644
    --- a/_modules/one/converters.html
    +++ b/_modules/one/converters.html
    @@ -1,3 +1,5 @@
    +
    +
     
     
     
    @@ -5,23 +7,19 @@
       
       one.converters — ONE  documentation
           
    -      
    +      
           
           
     
       
    -  
    -  
    -        
    -        
    -        
    -        
    -        
    -        
    -        
    -        
    +      
    +      
    +      
    +      
    +      
    +      
    +      
    +      
         
         
          
    @@ -122,15 +120,14 @@ 

    Source code for one.converters

     from uuid import UUID
     from inspect import unwrap
     from pathlib import Path, PurePosixPath
    -from urllib.parse import urlsplit
     from typing import Optional, Union, Mapping, List, Iterable as Iter
     
     import pandas as pd
     from iblutil.util import Bunch
     
     from one.alf.spec import is_session_path, is_uuid_string
    -from one.alf.files import get_session_path, add_uuid_string, session_path_parts, remove_uuid_string
    -from .util import Listable, ensure_list
    +from one.alf.files import get_session_path, add_uuid_string, session_path_parts, get_alf_path
    +from .util import Listable
     
     
     
    @@ -360,39 +357,43 @@

    Source code for one.converters

                 A cache file record
             """
             is_session = is_session_path(path)
    -        rec = self._cache['sessions' if is_session else 'datasets']
    -        if rec.empty:
    -            return
    -        # if (rec := self._cache['datasets']).empty:  # py 3.8
    -        #     return
    +        if self._cache['sessions' if is_session else 'datasets'].empty:
    +            return  # short circuit: no records in the cache
     
             if is_session_path(path):
                 lab, subject, date, number = session_path_parts(path)
    -            rec = rec[
    -                (rec['lab'] == lab) & (rec['subject'] == subject) &
    -                (rec['number'] == int(number)) &
    -                (rec['date'] == datetime.date.fromisoformat(date))
    +            df = self._cache['sessions']
    +            rec = df[
    +                (df['lab'] == lab) & (df['subject'] == subject) &
    +                (df['number'] == int(number)) &
    +                (df['date'] == datetime.date.fromisoformat(date))
                 ]
                 return None if rec.empty else rec.squeeze()
     
    -        # Deal with file path
    -        if isinstance(path, str) and path.startswith('http'):
    -            # Remove the UUID from path
    -            path = urlsplit(path).path.strip('/')
    -            path = remove_uuid_string(PurePosixPath(path))
    -            session_path = get_session_path(path).as_posix()
    -        else:
    -            # No way of knowing root session path parts without cache tables
    -            eid = self.path2eid(path)
    -            session_series = self.list_datasets(eid, details=True).session_path
    -            if not eid or session_series.empty:
    +        # Deal with dataset path
    +        if isinstance(path, str):
    +            path = Path(path)
    +        # If there's a UUID in the path, use that to fetch the record
    +        name_parts = path.stem.split('.')
    +        if is_uuid_string(uuid := name_parts[-1]):
    +            try:
    +                return self._cache['datasets'].loc[pd.IndexSlice[:, uuid], :].squeeze()
    +            except KeyError:
                     return
    -            session_path, *_ = session_series
     
    -        rec = rec[rec['session_path'] == session_path]
    -        rec = rec[rec['rel_path'].apply(lambda x: path.as_posix().endswith(x))]
    +        # Fetch via session record
    +        eid = self.path2eid(path)
    +        df = self.list_datasets(eid, details=True)
    +        if not eid or df.empty:
    +            return
    +
    +        # Find row where relative path matches
    +        rec = df[df['rel_path'] == path.relative_to(get_session_path(path)).as_posix()]
             assert len(rec) < 2, 'Multiple records found'
    -        return None if rec.empty else rec.squeeze()
    + if rec.empty: + return None + # Convert slice to series and reinstate eid index if dropped + return rec.squeeze().rename(index=(eid, rec.index.get_level_values('id')[0]))
    @@ -447,13 +448,13 @@

    Source code for one.converters

                     session_spec = '{lab}/Subjects/{subject}/{date}/{number:03d}'
                     url = record.get('session_path') or session_spec.format(**record)
                     return webclient.rel_path2url(url)
    -            uuid = ensure_list(record.name)[-1]  # may be (eid, did) or simply did
             else:
                 raise TypeError(
                     f'record must be pandas.DataFrame or pandas.Series, got {type(record)} instead')
    -
    -        session_path, rel_path = record[['session_path', 'rel_path']].to_numpy().flatten()
    -        url = PurePosixPath(session_path, rel_path)
    +        assert isinstance(record.name, tuple) and len(record.name) == 2
    +        eid, uuid = record.name  # must be (eid, did)
    +        session_path = self.eid2path(eid)
    +        url = PurePosixPath(get_alf_path(session_path), record['rel_path'])
             return webclient.rel_path2url(add_uuid_string(url, uuid).as_posix())
    @@ -461,8 +462,7 @@

    Source code for one.converters

     [docs]
         def record2path(self, dataset) -> Optional[Path]:
             """
    -        Given a set of dataset records, checks the corresponding exists flag in the cache
    -        correctly reflects the files system.
    +        Given a set of dataset records, returns the corresponding paths
     
             Parameters
             ----------
    @@ -474,13 +474,19 @@ 

    Source code for one.converters

             pathlib.Path
                 File path for the record
             """
    -        assert isinstance(dataset, pd.Series) or len(dataset) == 1
    -        session_path, rel_path = dataset[['session_path', 'rel_path']].to_numpy().flatten()
    -        file = Path(self.cache_dir, session_path, rel_path)
    +        if isinstance(dataset, pd.DataFrame):
    +            return [self.record2path(r) for _, r in dataset.iterrows()]
    +        elif not isinstance(dataset, pd.Series):
    +            raise TypeError(
    +                f'record must be pandas.DataFrame or pandas.Series, got {type(dataset)} instead')
    +        assert isinstance(dataset.name, tuple) and len(dataset.name) == 2
    +        eid, uuid = dataset.name  # must be (eid, did)
    +        if not (session_path := self.eid2path(eid)):
    +            raise ValueError(f'Failed to determine session path for eid "{eid}"')
    +        file = session_path / dataset['rel_path']
             if self.uuid_filenames:
    -            i = dataset.name if isinstance(dataset, pd.Series) else dataset.index[0]
    -            file = add_uuid_string(file, i[1] if isinstance(i, tuple) else i)
    -        return file  # files[0] if len(datasets) == 1 else files
    + file = add_uuid_string(file, uuid) + return file
    diff --git a/_modules/one/params.html b/_modules/one/params.html index 85caca7e..aa5b467a 100644 --- a/_modules/one/params.html +++ b/_modules/one/params.html @@ -1,3 +1,5 @@ + + @@ -5,23 +7,19 @@ one.params — ONE documentation - + - - - - - - - - - - + + + + + + + + @@ -272,7 +270,8 @@

    Source code for one.params

     
             # Prompt for cache directory (default may have changed after prompt)
             client_key = _key_from_url(par.ALYX_URL)
    -        cache_dir = cache_dir or Path(CACHE_DIR_DEFAULT, client_key)
    +        def_cache_dir = cache_map.CLIENT_MAP.get(client_key) or Path(CACHE_DIR_DEFAULT, client_key)
    +        cache_dir = cache_dir or def_cache_dir
             prompt = f'Enter the location of the download cache, current value is ["{cache_dir}"]:'
             cache_dir = input(prompt) or cache_dir
     
    @@ -299,7 +298,9 @@ 

    Source code for one.params

             # Precedence: user provided cache_dir; previously defined; the default location
             default_cache_dir = Path(CACHE_DIR_DEFAULT, client_key)
             cache_dir = cache_dir or cache_map.CLIENT_MAP.get(client_key, default_cache_dir)
    -        par = par_current
    +        # Use current params but drop any extras (such as the TOKEN or ALYX_PWD field)
    +        keep_keys = par_default.as_dict().keys()
    +        par = iopar.from_dict({k: v for k, v in par_current.as_dict().items() if k in keep_keys})
             if any(v for k, v in cache_map.CLIENT_MAP.items() if k != client_key and v == cache_dir):
                 warnings.warn('Warning: the directory provided is already a cache for another URL.')
     
    diff --git a/_modules/one/registration.html b/_modules/one/registration.html
    index 53bb8080..ca5bbc32 100644
    --- a/_modules/one/registration.html
    +++ b/_modules/one/registration.html
    @@ -1,3 +1,5 @@
    +
    +
     
     
     
    @@ -5,23 +7,19 @@
       
       one.registration — ONE  documentation
           
    -      
    +      
           
           
     
       
    -  
    -  
    -        
    -        
    -        
    -        
    -        
    -        
    -        
    -        
    +      
    +      
    +      
    +      
    +      
    +      
    +      
    +      
         
         
          
    @@ -132,14 +130,13 @@ 

    Source code for one.registration

     import requests.exceptions
     
     from iblutil.io import hashfile
    -from iblutil.util import Bunch
    +from iblutil.util import Bunch, ensure_list
     
     import one.alf.io as alfio
     from one.alf.files import session_path_parts, get_session_path, folder_parts, filename_parts
     from one.alf.spec import is_valid
     import one.alf.exceptions as alferr
     from one.api import ONE
    -from one.util import ensure_list
     from one.webclient import no_cache
     
     _logger = logging.getLogger(__name__)
    diff --git a/_modules/one/remote/aws.html b/_modules/one/remote/aws.html
    index 35b16890..a190bb21 100644
    --- a/_modules/one/remote/aws.html
    +++ b/_modules/one/remote/aws.html
    @@ -1,3 +1,5 @@
    +
    +
     
     
     
    @@ -5,23 +7,19 @@
       
       one.remote.aws — ONE  documentation
           
    -      
    +      
           
           
     
       
    -  
    -  
    -        
    -        
    -        
    -        
    -        
    -        
    -        
    -        
    +      
    +      
    +      
    +      
    +      
    +      
    +      
    +      
         
         
          
    diff --git a/_modules/one/remote/base.html b/_modules/one/remote/base.html
    index d1b43b86..9a5bcd9b 100644
    --- a/_modules/one/remote/base.html
    +++ b/_modules/one/remote/base.html
    @@ -1,3 +1,5 @@
    +
    +
     
     
     
    @@ -5,23 +7,19 @@
       
       one.remote.base — ONE  documentation
           
    -      
    +      
           
           
     
       
    -  
    -  
    -        
    -        
    -        
    -        
    -        
    -        
    -        
    -        
    +      
    +      
    +      
    +      
    +      
    +      
    +      
    +      
         
         
          
    diff --git a/_modules/one/remote/globus.html b/_modules/one/remote/globus.html
    index fcf441c4..249e3a08 100644
    --- a/_modules/one/remote/globus.html
    +++ b/_modules/one/remote/globus.html
    @@ -1,3 +1,5 @@
    +
    +
     
     
     
    @@ -5,23 +7,19 @@
       
       one.remote.globus — ONE  documentation
           
    -      
    +      
           
           
     
       
    -  
    -  
    -        
    -        
    -        
    -        
    -        
    -        
    -        
    -        
    +      
    +      
    +      
    +      
    +      
    +      
    +      
    +      
         
         
          
    @@ -206,12 +204,12 @@ 

    Source code for one.remote.globus

     from globus_sdk import TransferAPIError, GlobusAPIError, NetworkError, GlobusTimeoutError, \
         GlobusConnectionError, GlobusConnectionTimeoutError, GlobusSDKUsageError, NullAuthorizer
     from iblutil.io import params as iopar
    +from iblutil.util import ensure_list
     
     from one.alf.spec import is_uuid
     from one.alf.files import remove_uuid_string
     import one.params
     from one.webclient import AlyxClient
    -from one.util import ensure_list
     from .base import DownloadClient, load_client_params, save_client_params
     
     __all__ = ['Globus', 'get_lab_from_endpoint_id', 'as_globus_path']
    diff --git a/_modules/one/tests/alf/test_alf_files.html b/_modules/one/tests/alf/test_alf_files.html
    index 7b13153b..74e22617 100644
    --- a/_modules/one/tests/alf/test_alf_files.html
    +++ b/_modules/one/tests/alf/test_alf_files.html
    @@ -1,3 +1,5 @@
    +
    +
     
     
     
    @@ -5,23 +7,19 @@
       
       one.tests.alf.test_alf_files — ONE  documentation
           
    -      
    +      
           
           
     
       
    -  
    -  
    -        
    -        
    -        
    -        
    -        
    -        
    -        
    -        
    +      
    +      
    +      
    +      
    +      
    +      
    +      
    +      
         
         
          
    diff --git a/_modules/one/tests/alf/test_alf_io.html b/_modules/one/tests/alf/test_alf_io.html
    index 9e99833b..fc571b7f 100644
    --- a/_modules/one/tests/alf/test_alf_io.html
    +++ b/_modules/one/tests/alf/test_alf_io.html
    @@ -1,3 +1,5 @@
    +
    +
     
     
     
    @@ -5,23 +7,19 @@
       
       one.tests.alf.test_alf_io — ONE  documentation
           
    -      
    +      
           
           
     
       
    -  
    -  
    -        
    -        
    -        
    -        
    -        
    -        
    -        
    -        
    +      
    +      
    +      
    +      
    +      
    +      
    +      
    +      
         
         
          
    @@ -966,7 +964,7 @@ 

    Source code for one.tests.alf.test_alf_io

                 self.session_path.joinpath(f'bar.baz_y.{uuid.uuid4()}.npy'),
                 self.session_path.joinpath('#2021-01-01#', f'bar.baz.{uuid.uuid4()}.npy'),
                 self.session_path.joinpath('task_00', 'x.y.z'),
    -            self.session_path.joinpath('x.y.z'),
    +            self.session_path.joinpath('x.y.z')
             ]
             for f in self.dsets:
                 f.parent.mkdir(exist_ok=True, parents=True)
    diff --git a/_modules/one/tests/alf/test_alf_spec.html b/_modules/one/tests/alf/test_alf_spec.html
    index f703c045..7d443373 100644
    --- a/_modules/one/tests/alf/test_alf_spec.html
    +++ b/_modules/one/tests/alf/test_alf_spec.html
    @@ -1,3 +1,5 @@
    +
    +
     
     
     
    @@ -5,23 +7,19 @@
       
       one.tests.alf.test_alf_spec — ONE  documentation
           
    -      
    +      
           
           
     
       
    -  
    -  
    -        
    -        
    -        
    -        
    -        
    -        
    -        
    -        
    +      
    +      
    +      
    +      
    +      
    +      
    +      
    +      
         
         
          
    diff --git a/_modules/one/tests/alf/test_cache.html b/_modules/one/tests/alf/test_cache.html
    index 23650d23..73e75c0f 100644
    --- a/_modules/one/tests/alf/test_cache.html
    +++ b/_modules/one/tests/alf/test_cache.html
    @@ -1,3 +1,5 @@
    +
    +
     
     
     
    @@ -5,23 +7,19 @@
       
       one.tests.alf.test_cache — ONE  documentation
           
    -      
    +      
           
           
     
       
    -  
    -  
    -        
    -        
    -        
    -        
    -        
    -        
    -        
    -        
    +      
    +      
    +      
    +      
    +      
    +      
    +      
    +      
         
         
          
    @@ -206,7 +204,6 @@ 

    Source code for one.tests.alf.test_cache

             print('Datasets dataframe')
             print(df)
             dset_info = df.loc[0].to_dict()
    -        self.assertEqual(dset_info['session_path'], self.rel_ses_path[:-1])
             self.assertEqual(dset_info['rel_path'], self.rel_ses_files[0].as_posix())
             self.assertTrue(dset_info['file_size'] > 0)
             self.assertFalse(df.rel_path.str.contains('invalid').any())
    @@ -228,7 +225,6 @@

    Source code for one.tests.alf.test_cache

             df_dsets, metadata2 = parquet.load(fn_dsets)
             self.assertEqual(metadata2, metadata_exp)
             dset_info = df_dsets.loc[0].to_dict()
    -        self.assertEqual(dset_info['session_path'], self.rel_ses_path[:-1])
             self.assertEqual(dset_info['rel_path'], self.rel_ses_files[0].as_posix())
     
             # Check behaviour when no files found
    @@ -243,12 +239,9 @@ 

    Source code for one.tests.alf.test_cache

                 apt.make_parquet_db(self.tmpdir, hash_ids=False, lab='another')
     
             # Create some more datasets in a session folder outside of a lab directory
    -        dsets = revisions_datasets_table()
             with tempfile.TemporaryDirectory() as tdir:
    -            for session_path, rel_path in dsets[['session_path', 'rel_path']].values:
    -                filepath = Path(tdir).joinpath(session_path, rel_path)
    -                filepath.parent.mkdir(exist_ok=True, parents=True)
    -                filepath.touch()
    +            session_path = Path(tdir).joinpath('subject', '1900-01-01', '001')
    +            _ = revisions_datasets_table(touch_path=session_path)  # create some files
                 fn_ses, _ = apt.make_parquet_db(tdir, hash_ids=False, lab='another')
                 df_ses, _ = parquet.load(fn_ses)
                 self.assertTrue((df_ses['lab'] == 'another').all())
    diff --git a/_modules/one/tests/remote/test_aws.html b/_modules/one/tests/remote/test_aws.html index 4b09e950..68015dc5 100644 --- a/_modules/one/tests/remote/test_aws.html +++ b/_modules/one/tests/remote/test_aws.html @@ -1,3 +1,5 @@ + + @@ -5,23 +7,19 @@ one.tests.remote.test_aws — ONE documentation - + - - - - - - - - - - + + + + + + + + diff --git a/_modules/one/tests/remote/test_base.html b/_modules/one/tests/remote/test_base.html index e1e30428..0695539e 100644 --- a/_modules/one/tests/remote/test_base.html +++ b/_modules/one/tests/remote/test_base.html @@ -1,3 +1,5 @@ + + @@ -5,23 +7,19 @@ one.tests.remote.test_base — ONE documentation - + - - - - - - - - - - + + + + + + + + diff --git a/_modules/one/tests/remote/test_globus.html b/_modules/one/tests/remote/test_globus.html index 91b7d6ba..43fc6204 100644 --- a/_modules/one/tests/remote/test_globus.html +++ b/_modules/one/tests/remote/test_globus.html @@ -1,3 +1,5 @@ + + @@ -5,23 +7,19 @@ one.tests.remote.test_globus — ONE documentation - + - - - - - - - - - - + + + + + + + + @@ -229,7 +227,7 @@

    Source code for one.tests.remote.test_globus

    # Only test this on windows
             if sys.platform == 'win32':
                 actual = globus.as_globus_path('/foo/bar')
    -            self.assertEqual(actual, f'/{Path.cwd().drive[0]}/foo/bar')
    +            self.assertEqual(actual, f'/{Path.cwd().drive[0].upper()}/foo/bar')
     
             # On all systems an explicit Windows path should be converted to a POSIX one
             actual = globus.as_globus_path(PureWindowsPath('E:\\FlatIron\\integration'))
    diff --git a/_modules/one/tests/test_alyxclient.html b/_modules/one/tests/test_alyxclient.html
    index 1ed3fde0..867583cd 100644
    --- a/_modules/one/tests/test_alyxclient.html
    +++ b/_modules/one/tests/test_alyxclient.html
    @@ -1,3 +1,5 @@
    +
    +
     
     
     
    @@ -5,23 +7,19 @@
       
       one.tests.test_alyxclient — ONE  documentation
           
    -      
    +      
           
           
     
       
    -  
    -  
    -        
    -        
    -        
    -        
    -        
    -        
    -        
    -        
    +      
    +      
    +      
    +      
    +      
    +      
    +      
    +      
         
         
          
    @@ -110,6 +108,7 @@ 

    Source code for one.tests.test_alyxclient

     """Unit tests for the one.webclient module"""
     import unittest
     from unittest import mock
    +import urllib.parse
     import random
     import os
     import one.webclient as wc
    @@ -167,10 +166,17 @@ 

    Source code for one.tests.test_alyxclient

                 ac.authenticate()
                 mock_input.assert_not_called()
             self.assertTrue(ac.is_logged_in)
    +
    +        # When password is None and in silent mode, there should be a warning
    +        # followed by a failed login attempt
    +        ac._par = ac._par.set('ALYX_PWD', None)
    +        ac.logout()
    +        with self.assertWarns(UserWarning), self.assertRaises(requests.HTTPError):
    +            self.ac.authenticate(password=None)
    +
             # Test using input args
             ac._par = iopar.from_dict({k: v for k, v in ac._par.as_dict().items()
                                        if k not in login_keys})
    -        ac.logout()
             with mock.patch('builtins.input') as mock_input:
                 ac.authenticate(TEST_DB_2['username'], TEST_DB_2['password'], cache_token=False)
                 mock_input.assert_not_called()
    @@ -192,6 +198,16 @@ 

    Source code for one.tests.test_alyxclient

             with mock.patch('one.webclient.getpass', return_value=TEST_DB_2['password']) as mock_pwd:
                 ac.authenticate(cache_token=True, force=True)
                 mock_pwd.assert_called()
    +        # If a password is passed, should always force re-authentication
    +        rep = requests.Response()
    +        rep.status_code = 200
    +        rep.json = lambda **_: {'token': 'abc'}
    +        assert self.ac.is_logged_in
    +        with mock.patch('one.webclient.requests.post', return_value=rep) as m:
    +            self.ac.authenticate(password='foo', force=False)
    +            expected = {'username': TEST_DB_2['username'], 'password': 'foo'}
    +            m.assert_called_once_with(TEST_DB_2['base_url'] + '/auth-token', data=expected)
    +
             # Check non-silent double logout
             ac.logout()
             ac.logout()  # Shouldn't complain
    @@ -655,7 +671,86 @@

    Source code for one.tests.test_alyxclient

                 self.assertTrue(str(ac.cache_dir).endswith('foobar'))
             finally:
                 ac._par = ac._par.set('CACHE_DIR', prev_path)
    -
    + + +
    +[docs] + def test_paginated_response(self): + """Test the _PaginatedResponse class.""" + alyx = mock.Mock(spec_set=ac) + N, lim = 2000, 250 # 2000 results, 250 records per page + url = ac.base_url + f'/?foo=bar&offset={lim}&limit={lim}' + res = {'count': N, 'next': url, 'previous': None, 'results': []} + res['results'] = [{'id': i} for i in range(lim)] + alyx._generic_request.return_value = res + # Check initialization + pg = wc._PaginatedResponse(alyx, res, cache_args=dict(clobber=True)) + self.assertEqual(pg.count, N) + self.assertEqual(len(pg), N) + self.assertEqual(pg.limit, lim) + self.assertEqual(len(pg._cache), N) + self.assertEqual(pg._cache[:lim], res['results']) + self.assertTrue(not any(pg._cache[lim:])) + self.assertIs(pg.alyx, alyx) + + # Check fetching cached item with +ve int + self.assertEqual({'id': 1}, pg[1]) + alyx._generic_request.assert_not_called() + # Check fetching cached item with +ve slice + self.assertEqual([{'id': 1}, {'id': 2}], pg[1:3]) + alyx._generic_request.assert_not_called() + # Check fetching cached item with -ve int + self.assertEqual({'id': 100}, pg[-1900]) + alyx._generic_request.assert_not_called() + # Check fetching cached item with -ve slice + self.assertEqual([{'id': 100}, {'id': 101}], pg[-1900:-1898]) + alyx._generic_request.assert_not_called() + # Check fetching uncached item with +ve int + n = offset = lim + res['results'] = [{'id': i} for i in range(offset, offset + lim)] + assert not any(pg._cache[offset:offset + lim]) + self.assertEqual({'id': lim}, pg[n]) + self.assertEqual(res['results'], pg._cache[offset:offset + lim]) + alyx._generic_request.assert_called_once_with(requests.get, mock.ANY, clobber=True) + self._check_get_query(alyx._generic_request.call_args, lim, offset) + # Check fetching uncached item with -ve int + offset = lim * 3 + res['results'] = [{'id': i} for i in range(offset, offset + lim)] + n = offset - N + 2 + assert not any(pg._cache[offset:offset + lim]) + self.assertEqual({'id': N + n}, pg[n]) + self.assertEqual(res['results'], pg._cache[offset:offset + lim]) + alyx._generic_request.assert_called_with(requests.get, mock.ANY, clobber=True) + self._check_get_query(alyx._generic_request.call_args, lim, offset) + # Check fetching uncached item with +ve slice + offset = lim * 5 + res['results'] = [{'id': i} for i in range(offset, offset + lim)] + n = offset + 20 + assert not any(pg._cache[offset:offset + lim]) + self.assertEqual([{'id': n}, {'id': n + 1}], pg[n:n + 2]) + self.assertEqual(res['results'], pg._cache[offset:offset + lim]) + alyx._generic_request.assert_called_with(requests.get, mock.ANY, clobber=True) + self._check_get_query(alyx._generic_request.call_args, lim, offset) + # Check fetching uncached item with -ve slice + offset = N - lim + res['results'] = [{'id': i} for i in range(offset, offset + lim)] + assert not any(pg._cache[offset:offset + lim]) + self.assertEqual([{'id': N - 2}, {'id': N - 1}], pg[-2:]) + self.assertEqual(res['results'], pg._cache[offset:offset + lim]) + alyx._generic_request.assert_called_with(requests.get, mock.ANY, clobber=True) + self._check_get_query(alyx._generic_request.call_args, lim, offset) + # At this point, there should be a certain number of None values left + self.assertEqual(expected_calls := 4, alyx._generic_request.call_count) + self.assertEqual((expected_calls + 1) * lim, sum(list(map(bool, pg._cache))))
    + + + def _check_get_query(self, call_args, limit, offset): + """Check URL get query contains the expected limit and offset params.""" + (_, url), _ = call_args + self.assertTrue(url.startswith(ac.base_url)) + query = urllib.parse.parse_qs(urllib.parse.urlparse(url).query) + expected = {'foo': ['bar'], 'offset': [str(offset)], 'limit': [str(limit)]} + self.assertDictEqual(query, expected)
    diff --git a/_modules/one/tests/test_alyxrest.html b/_modules/one/tests/test_alyxrest.html index b29e15d5..ae5c671a 100644 --- a/_modules/one/tests/test_alyxrest.html +++ b/_modules/one/tests/test_alyxrest.html @@ -1,3 +1,5 @@ + + @@ -5,23 +7,19 @@ one.tests.test_alyxrest — ONE documentation - + - - - - - - - - - - + + + + + + + + diff --git a/_modules/one/tests/test_converters.html b/_modules/one/tests/test_converters.html index 775fc321..baf46464 100644 --- a/_modules/one/tests/test_converters.html +++ b/_modules/one/tests/test_converters.html @@ -1,3 +1,5 @@ + + @@ -5,23 +7,19 @@ one.tests.test_converters — ONE documentation - + - - - - - - - - - - + + + + + + + + @@ -111,7 +109,7 @@

    Source code for one.tests.test_converters

     import unittest
     from unittest import mock
     from pathlib import Path, PurePosixPath, PureWindowsPath
    -from uuid import UUID
    +from uuid import UUID, uuid4
     import datetime
     
     import pandas as pd
    @@ -244,11 +242,17 @@ 

    Source code for one.tests.test_converters

             self.assertTrue(file.as_posix().endswith(rec['rel_path']))
     
             # Test URL
    -        parts = add_uuid_string(file, '94285bfd-7500-4583-83b1-906c420cc667').parts[-7:]
    +        uuid = '6cbb724e-c7ec-4eab-b24b-555001502d10'
    +        parts = add_uuid_string(file, uuid).parts[-7:]
             url = TEST_DB_2['base_url'] + '/'.join(('', *parts))
             rec = self.one.path2record(url)
             self.assertIsInstance(rec, pd.Series)
             self.assertTrue(file.as_posix().endswith(rec['rel_path']))
    +        # With a UUID missing from cache, should return None
    +        uuid = '94285bfd-7500-4583-83b1-906c420cc667'
    +        parts = add_uuid_string(file, uuid).parts[-7:]
    +        url = TEST_DB_2['base_url'] + '/'.join(('', *parts))
    +        self.assertIsNone(self.one.path2record(url))
     
             file = file.parent / '_fake_obj.attr.npy'
             self.assertIsNone(self.one.path2record(file))
    @@ -435,14 +439,18 @@ 

    Source code for one.tests.test_converters

             # As pd.DataFrame
             idx = rec.rel_path == 'alf/probe00/_phy_spikes_subset.channels.npy'
             path = self.one.record2path(rec[idx])
    -        self.assertEqual(expected, path)
    +        self.assertEqual([expected], path)
    +        # Test validation
    +        self.assertRaises(AssertionError, self.one.record2path, rec[idx].droplevel(0))  # no eid
    +        self.assertRaises(TypeError, self.one.record2path, rec[idx].to_dict())
    +        unknown = rec[idx].squeeze().rename(index=(str(uuid4()), data_id))
    +        self.assertRaises(ValueError, self.one.record2path, unknown)  # unknown eid
             # With UUID in file name
             try:
                 self.one.uuid_filenames = True
                 expected = expected.with_suffix(f'.{data_id}.npy')
    -            self.assertEqual(expected, self.one.record2path(rec[idx]))  # as pd.DataFrame
    +            self.assertEqual([expected], self.one.record2path(rec[idx]))  # as pd.DataFrame
                 self.assertEqual(expected, self.one.record2path(rec[idx].squeeze()))  # as pd.Series
    -            self.assertEqual(expected, self.one.record2path(rec[idx].droplevel(0)))  # no eid
             finally:
                 self.one.uuid_filenames = False
    diff --git a/_modules/one/tests/test_one.html b/_modules/one/tests/test_one.html index 72b42c4c..97fa2f1d 100644 --- a/_modules/one/tests/test_one.html +++ b/_modules/one/tests/test_one.html @@ -1,3 +1,5 @@ + + @@ -5,23 +7,19 @@ one.tests.test_one — ONE documentation - + - - - - - - - - - - + + + + + + + + @@ -157,7 +155,7 @@

    Source code for one.tests.test_one

     from one.api import ONE, One, OneAlyx
     from one.util import (
         ses2records, validate_date_range, index_last_before, filter_datasets, _collection_spec,
    -    filter_revision_last_before, parse_id, autocomplete, LazyId, datasets2records
    +    filter_revision_last_before, parse_id, autocomplete, LazyId, datasets2records, ensure_list
     )
     import one.params
     import one.alf.exceptions as alferr
    @@ -421,15 +419,22 @@ 

    Source code for one.tests.test_one

             datasets['rel_path'] = revisions
     
             # Should return last revision before date for each collection/dataset
    +        # These comprise mixed revisions which should trigger ALF warning
             revision = '2020-09-06'
    -        verifiable = filter_datasets(datasets, None, None, revision, assert_unique=False)
    +        expected_warn = 'Multiple revisions: "2020-08-31", "2020-01-01"'
    +        with self.assertWarnsRegex(alferr.ALFWarning, expected_warn):
    +            verifiable = filter_datasets(datasets, None, None, revision, assert_unique=False)
             self.assertEqual(2, len(verifiable))
             self.assertTrue(all(x.split('#')[1] < revision for x in verifiable['rel_path']))
     
    -        # Should return single dataset with last revision when default specified
    -        with self.assertRaises(alferr.ALFMultipleRevisionsFound):
    -            filter_datasets(datasets, '*spikes.times*', 'alf/probe00', None,
    -                            assert_unique=True, wildcards=True, revision_last_before=True)
    +        # with no default_revisions column there should be a warning about return latest revision
    +        # when no revision is provided.
    +        with self.assertWarnsRegex(alferr.ALFWarning, 'No default revision for dataset'):
    +            verifiable = filter_datasets(
    +                datasets, '*spikes.times*', 'alf/probe00', None,
    +                assert_unique=True, wildcards=True, revision_last_before=True)
    +            self.assertEqual(1, len(verifiable))
    +            self.assertTrue(verifiable['rel_path'].str.contains('#2021-xx-xx#').all())
     
             # Should return matching revision
             verifiable = filter_datasets(datasets, None, None, r'2020-08-\d{2}',
    @@ -470,8 +475,8 @@ 

    Source code for one.tests.test_one

                                          assert_unique=True, wildcards=True, revision_last_before=True)
             self.assertEqual(verifiable.rel_path.to_list(),
                              ['alf/probe00/#2020-01-01#/spikes.times.npy'])
    -        # When revision_last_before is false, expect multiple objects error
    -        with self.assertRaises(alferr.ALFMultipleObjectsFound):
    +        # When revision_last_before is false, expect multiple revisions error
    +        with self.assertRaises(alferr.ALFMultipleRevisionsFound):
                 filter_datasets(datasets, '*spikes.times*', 'alf/probe00', None,
                                 assert_unique=True, wildcards=True, revision_last_before=False)
    @@ -486,11 +491,28 @@

    Source code for one.tests.test_one

                                          assert_unique=False, wildcards=True)
             self.assertTrue(len(verifiable) == 2)
             # As dict with list (should act as logical OR)
    +        kwargs = dict(assert_unique=False, revision_last_before=False, wildcards=True)
             dataset = dict(attribute=['timestamp?', 'raw'])
    -        verifiable = filter_datasets(datasets, dataset, None, None,
    -                                     assert_unique=False, revision_last_before=False,
    -                                     wildcards=True)
    -        self.assertEqual(4, len(verifiable))
    + verifiable = filter_datasets(datasets, dataset, None, None, **kwargs) + self.assertEqual(4, len(verifiable)) + + # Test handling greedy captures of collection parts when there are wildcards at the start + # of the filename patten. + + # Add some identical files that exist in collections and sub-collections + # (i.e. raw_ephys_data, raw_ephys_data/probe00, raw_ephys_data/probe01) + all_datasets = self.one._cache.datasets + meta_datasets = all_datasets[all_datasets.rel_path.str.contains('meta')].copy() + datasets = pd.concat([datasets, meta_datasets]) + + # Matching *meta should not capture raw_ephys_data/probe00, etc. + verifiable = filter_datasets(datasets, '*.meta', 'raw_ephys_data', None, **kwargs) + expected = ['raw_ephys_data/_spikeglx_ephysData_g0_t0.nidq.meta'] + self.assertCountEqual(expected, verifiable.rel_path) + verifiable = filter_datasets(datasets, '*.meta', 'raw_ephys_data/probe??', None, **kwargs) + self.assertEqual(2, len(verifiable)) + verifiable = filter_datasets(datasets, '*.meta', 'raw_ephys_data*', None, **kwargs) + self.assertEqual(3, len(verifiable))
    @@ -534,7 +556,26 @@

    Source code for one.tests.test_one

             for eid in [None, 'KS005/2019-04-02/001']:
                 dsets = self.one.list_datasets(eid, details=False)
                 self.assertIsInstance(dsets, list)
    -            self.assertTrue(len(dsets) == np.unique(dsets).size)
    + self.assertTrue(len(dsets) == np.unique(dsets).size) + + # Test default_revisions_only=True + with self.assertRaises(alferr.ALFError): # should raise as no 'default_revision' column + self.one.list_datasets('KS005/2019-04-02/001', default_revisions_only=True) + # Add the column and add some alternates + datasets = util.revisions_datasets_table(collections=['alf'], revisions=['', '2023-01-01']) + datasets['default_revision'] = [False, True] * 2 + self.one._cache.datasets['default_revision'] = True + self.one._cache.datasets = pd.concat([self.one._cache.datasets, datasets]).sort_index() + eid, *_ = datasets.index.get_level_values(0) + dsets = self.one.list_datasets(eid, 'spikes.*', default_revisions_only=False) + self.assertEqual(4, len(dsets)) + dsets = self.one.list_datasets(eid, 'spikes.*', default_revisions_only=True) + self.assertEqual(2, len(dsets)) + self.assertTrue(all('#2023-01-01#' in x for x in dsets)) + # Should be the same with details=True + dsets = self.one.list_datasets(eid, 'spikes.*', default_revisions_only=True, details=True) + self.assertEqual(2, len(dsets)) + self.assertTrue(all('#2023-01-01#' in x for x in dsets.rel_path))
    @@ -628,23 +669,46 @@

    Source code for one.tests.test_one

     [docs]
         def test_check_filesystem(self):
             """Test for One._check_filesystem.
    +
             Most is already covered by other tests, this checks that it can deal with dataset frame
             without eid index and without a session_path column.
             """
             # Get two eids to test
             eids = self.one._cache['datasets'].index.get_level_values(0)[[0, -1]]
    -        datasets = self.one._cache['datasets'].loc[eids].drop('session_path', axis=1)
    +        datasets = self.one._cache['datasets'].loc[eids]
             files = self.one._check_filesystem(datasets)
             self.assertEqual(53, len(files))
    +
             # Expect same number of unique session paths as eids
             session_paths = set(map(lambda p: p.parents[1], files))
             self.assertEqual(len(eids), len(session_paths))
             expected = map(lambda x: '/'.join(x.parts[-3:]), session_paths)
             session_parts = self.one._cache['sessions'].loc[eids, ['subject', 'date', 'number']].values
             self.assertCountEqual(expected, map(lambda x: f'{x[0]}/{x[1]}/{x[2]:03}', session_parts))
    -        # Attempt the same with the eid index missing
    -        datasets = datasets.droplevel(0).drop('session_path', axis=1)
    +
    +        # Test a very rare occurence of a missing dataset with eid index missing
    +        # but session_path column present
    +        idx = self.one._cache.datasets.index[(i := 5)]  # pick a random dataset to make vanish
    +        _eid2path = {
    +            e: self.one.eid2path(e).relative_to(self.one.cache_dir).as_posix() for e in eids
    +        }
    +        session_paths = list(map(_eid2path.get, datasets.index.get_level_values(0)))
    +        datasets['session_path'] = session_paths
    +        datasets = datasets.droplevel(0)
    +        files[(i := 5)].unlink()
    +        # For this check the current state should be exists==True in the main cache
    +        assert self.one._cache.datasets.loc[idx, 'exists'].all()
    +        _files = self.one._check_filesystem(datasets, update_exists=True)
    +        self.assertIsNone(_files[i])
    +        self.assertFalse(
    +            self.one._cache.datasets.loc[idx, 'exists'].all(), 'failed to update cache exists')
    +        files[i].touch()  # restore file for next check
    +
    +        # Attempt to load datasets with both eid index
    +        # and session_path column missing (most common)
    +        datasets = datasets.drop('session_path', axis=1)
             self.assertEqual(files, self.one._check_filesystem(datasets))
    +
             # Test with uuid_filenames as True
             self.one.uuid_filenames = True
             try:
    @@ -763,21 +827,48 @@ 

    Source code for one.tests.test_one

             files, meta = self.one.load_datasets(eid, dsets, download_only=True)
             self.assertTrue(all(isinstance(x, Path) for x in files))
     
    +        # Check behaviour when loading with a data frame (undocumented)
    +        eid = '01390fcc-4f86-4707-8a3b-4d9309feb0a1'
    +        datasets = self.one._cache.datasets.loc[([eid],), :].iloc[:3, :]
    +        files, meta = self.one.load_datasets(eid, datasets, download_only=True)
    +        self.assertTrue(all(isinstance(x, Path) for x in files))
    +        # Should raise when data frame contains a different eid
    +        self.assertRaises(AssertionError, self.one.load_datasets, uuid4(), datasets)
    +
    +        # Mix of str and dict
    +        # Check download only
    +        dsets = [
    +            spec.regex(spec.FILE_SPEC).match('_ibl_wheel.position.npy').groupdict(),
    +            '_ibl_wheel.timestamps.npy'
    +        ]
    +        with self.assertRaises(ValueError):
    +            self.one.load_datasets('KS005/2019-04-02/001', dsets, assert_present=False)
    +
             # Loading of non default revisions without using the revision kwarg causes user warning.
    -        # With relative paths provided as input, dataset uniqueness validation is supressed.
    +        # With relative paths provided as input, dataset uniqueness validation is suppressed.
    +        eid = self.one._cache.sessions.iloc[0].name
             datasets = util.revisions_datasets_table(
    -            revisions=('', '2020-01-08'), attributes=('times',))
    +            revisions=('', '2020-01-08'), attributes=('times',), touch_path=self.one.eid2path(eid))
             datasets['default_revision'] = [False, True] * 3
    -        eid = datasets.iloc[0].name[0]
    +        datasets.index = datasets.index.set_levels([eid], level=0)
             self.one._cache.datasets = datasets
    -        with self.assertWarns(UserWarning):
    -            self.one.load_datasets(eid, datasets['rel_path'].to_list(),
    -                                   download_only=True, assert_present=False)
    +        with self.assertWarns(alferr.ALFWarning):
    +            self.one.load_datasets(eid, datasets['rel_path'].to_list(), download_only=True)
     
             # When loading without collections in the dataset list (i.e. just the dataset names)
             # an exception should be raised when datasets belong to multiple collections.
             self.assertRaises(
    -            alferr.ALFMultipleCollectionsFound, self.one.load_datasets, eid, ['spikes.times'])
    + alferr.ALFMultipleCollectionsFound, self.one.load_datasets, eid, ['spikes.times']) + + # Ensure that when rel paths are passed, a null collection/revision is not interpreted as + # an ANY. NB this means the output of 'spikes.times.npy' will be different depending on + # weather other datasets in list include a collection or revision. + self.one._cache.datasets = datasets.iloc[:2, :].copy() # only two datasets, one default + (file,), _ = self.one.load_datasets(eid, ['spikes.times.npy', ], download_only=True) + self.assertTrue(file.as_posix().endswith('001/#2020-01-08#/spikes.times.npy')) + (file, _), _ = self.one.load_datasets( + eid, ['spikes.times.npy', 'xx/obj.attr.ext'], download_only=True, assert_present=False) + self.assertTrue(file.as_posix().endswith('001/spikes.times.npy'))
    @@ -1009,13 +1100,24 @@

    Source code for one.tests.test_one

             # Check behaviour when columns don't match
             datasets.loc[:, 'exists'] = ~datasets.loc[:, 'exists']
             datasets['extra_column'] = True
    +        self.one._cache.datasets['foo_bar'] = 12  # this column is missing in our new records
             self.one._cache.datasets['new_column'] = False
    -        self.addCleanup(self.one._cache.datasets.drop, 'new_column', axis=1, inplace=True)
    +        self.addCleanup(self.one._cache.datasets.drop, 'foo_bar', axis=1, inplace=True)
    +        # An exception is exists_* as the Alyx cache contains exists_aws and exists_flatiron
    +        # These should simply be filled with the values of exists as Alyx won't return datasets
    +        # that don't exist on FlatIron and if they don't exist on AWS it falls back to this.
    +        self.one._cache.datasets['exists_aws'] = False
             with self.assertRaises(AssertionError):
                 self.one._update_cache_from_records(datasets=datasets, strict=True)
             self.one._update_cache_from_records(datasets=datasets)
             verifiable = self.one._cache.datasets.loc[datasets.index.values, 'exists']
             self.assertTrue(np.all(verifiable == datasets.loc[:, 'exists']))
    +        self.one._update_cache_from_records(datasets=datasets)
    +        verifiable = self.one._cache.datasets.loc[datasets.index.values, 'exists_aws']
    +        self.assertTrue(np.all(verifiable == datasets.loc[:, 'exists']))
    +        # If the extra column does not start with 'exists' it should be set to NaN
    +        verifiable = self.one._cache.datasets.loc[datasets.index.values, 'foo_bar']
    +        self.assertTrue(np.isnan(verifiable).all())
     
             # Check fringe cases
             with self.assertRaises(KeyError):
    @@ -1053,14 +1155,14 @@ 

    Source code for one.tests.test_one

             old_cache = self.one._cache['datasets']
             try:
                 datasets = [self.one._cache.datasets, dset.to_frame().T]
    -            datasets = pd.concat(datasets).astype(old_cache.dtypes)
    +            datasets = pd.concat(datasets).astype(old_cache.dtypes).sort_index()
    +            datasets.index.set_names(('eid', 'id'), inplace=True)
                 self.one._cache['datasets'] = datasets
                 dsets = [dset['rel_path'], '_ibl_trials.feedback_times.npy']
                 new_files, rec = self.one.load_datasets(eid, dsets, assert_present=False)
                 loaded = self.one._cache['_loaded_datasets']
                 # One dataset is already in the list (test for duplicates) and other doesn't exist
                 self.assertEqual(len(files), len(loaded), 'No new UUIDs should have been added')
    -            self.assertIn(rec[1]['id'], loaded)  # Already in list
                 self.assertEqual(len(loaded), len(np.unique(loaded)))
                 self.assertNotIn(dset.name[1], loaded)  # Wasn't loaded as doesn't exist on disk
             finally:
    @@ -1474,9 +1576,6 @@ 

    Source code for one.tests.test_one

             # Test listing by relation
             datasets = self.one.list_aggregates('subjects')
             self.assertTrue(all(datasets['rel_path'].str.startswith('aggregates/Subjects')))
    -        self.assertIn('exists_aws', datasets.columns)
    -        self.assertIn('session_path', datasets.columns)
    -        self.assertTrue(all(datasets['session_path'] == ''))
             self.assertTrue(self.one.list_aggregates('foobar').empty)
             # Test filtering with an identifier
             datasets = self.one.list_aggregates('subjects', 'ZM_1085')
    @@ -1714,7 +1813,7 @@ 

    Source code for one.tests.test_one

     
    [docs] def test_search_terms(self): - """Test OneAlyx.search_terms""" + """Test OneAlyx.search_terms.""" assert self.one.mode != 'remote' search1 = self.one.search_terms() self.assertIn('dataset', search1) @@ -1735,7 +1834,7 @@

    Source code for one.tests.test_one

     
    [docs] def test_load_dataset(self): - """Test OneAlyx.load_dataset""" + """Test OneAlyx.load_dataset.""" file = self.one.load_dataset(self.eid, '_spikeglx_sync.channels.npy', collection='raw_ephys_data', query_type='remote', download_only=True) @@ -1754,7 +1853,7 @@

    Source code for one.tests.test_one

     
    [docs] def test_load_object(self): - """Test OneAlyx.load_object""" + """Test OneAlyx.load_object.""" files = self.one.load_object(self.eid, 'wheel', collection='alf', query_type='remote', download_only=True) @@ -1767,7 +1866,7 @@

    Source code for one.tests.test_one

     
    [docs] def test_get_details(self): - """Test OneAlyx.get_details""" + """Test OneAlyx.get_details.""" det = self.one.get_details(self.eid, query_type='remote') self.assertIsInstance(det, dict) self.assertEqual('SWC_043', det['subject']) @@ -1788,7 +1887,7 @@

    Source code for one.tests.test_one

     [docs]
     @unittest.skipIf(OFFLINE_ONLY, 'online only test')
     class TestOneDownload(unittest.TestCase):
    -    """Test downloading datasets using OpenAlyx"""
    +    """Test downloading datasets using OpenAlyx."""
         tempdir = None
         one = None
     
    @@ -1807,7 +1906,7 @@ 

    Source code for one.tests.test_one

     
    [docs] def test_download_datasets(self): - """Test OneAlyx._download_dataset, _download_file and _dset2url""" + """Test OneAlyx._download_dataset, _download_file and _dset2url.""" det = self.one.get_details(self.eid, True) rec = next(x for x in det['data_dataset_session_related'] if 'channels.brainLocation' in x['dataset_type']) @@ -1889,6 +1988,8 @@

    Source code for one.tests.test_one

             rec = self.one.list_datasets(self.eid, details=True)
             rec = rec[rec.rel_path.str.contains('00/pykilosort/channels.brainLocation')]
             rec['exists_aws'] = False  # Ensure we use FlatIron for this
    +        rec = pd.concat({str(self.eid): rec}, names=['eid'])
    +
             files = self.one._download_datasets(rec)
             self.assertFalse(None in files)
     
    @@ -1902,8 +2003,11 @@ 

    Source code for one.tests.test_one

         def test_download_aws(self):
             """Test for OneAlyx._download_aws method."""
             # Test download datasets via AWS
    -        dsets = self.one.list_datasets(self.eid, details=True)
    -        file = self.one.cache_dir / dsets['rel_path'].values[0]
    +        dsets = self.one.list_datasets(
    +            self.eid, filename='*wiring.json', collection='raw_ephys_data/probe??', details=True)
    +        dsets = pd.concat({str(self.eid): dsets}, names=['eid'])
    +
    +        file = self.one.eid2path(self.eid) / dsets['rel_path'].values[0]
             with mock.patch('one.remote.aws.get_s3_from_alyx', return_value=(None, None)), \
                     mock.patch('one.remote.aws.s3_download_file', return_value=file) as method:
                 self.one._download_datasets(dsets)
    @@ -1915,23 +2019,25 @@ 

    Source code for one.tests.test_one

                 # Check keep_uuid = True
                 self.one._download_datasets(dsets, keep_uuid=True)
                 _, local = method.call_args.args
    -            self.assertIn(dsets.iloc[-1].name, local.name)
    +            self.assertIn(dsets.iloc[-1].name[1], local.name)
     
             # Test behaviour when dataset not remotely accessible
             dsets = dsets[:1].copy()
    -        rec = self.one.alyx.rest('datasets', 'read', id=dsets.index[0])
    +        rec = self.one.alyx.rest('datasets', 'read', id=dsets.index[0][1])
             # need to find the index of matching aws repo, this is not constant across releases
             iaws = list(map(lambda x: x['data_repository'].startswith('aws'),
                             rec['file_records'])).index(True)
             rec['file_records'][iaws]['exists'] = False  # Set AWS file record to non-existent
    +        self.one._cache.datasets['exists_aws'] = True  # Only changes column if exists
             with mock.patch('one.remote.aws.get_s3_from_alyx', return_value=(None, None)), \
                     mock.patch.object(self.one.alyx, 'rest', return_value=[rec]), \
                     self.assertLogs('one.api', logging.DEBUG) as log:
    -            self.assertEqual([None], self.one._download_datasets(dsets))
    -            self.assertRegex(log.output[-1], 'Updating exists field')
    +            # should still download file via fallback method
    +            self.assertEqual([file], self.one._download_datasets(dsets))
    +            self.assertRegex(log.output[1], 'Updating exists field')
                 datasets = self.one._cache['datasets']
                 self.assertFalse(
    -                datasets.loc[pd.IndexSlice[:, dsets.index[0]], 'exists_aws'].any()
    +                datasets.loc[pd.IndexSlice[:, dsets.index[0][1]], 'exists_aws'].any()
                 )
     
             # Check falls back to HTTP when error raised
    @@ -1949,6 +2055,7 @@ 

    Source code for one.tests.test_one

     [docs]
         def test_tag_mismatched_file_record(self):
             """Test for OneAlyx._tag_mismatched_file_record.
    +
             This method is also tested in test_download_datasets.
             """
             did = '4a1500c2-60f3-418f-afa2-c752bb1890f0'
    @@ -1978,7 +2085,7 @@ 

    Source code for one.tests.test_one

     
    [docs] class TestOneSetup(unittest.TestCase): - """Test parameter setup upon ONE instantiation and calling setup methods""" + """Test parameter setup upon ONE instantiation and calling setup methods."""
    [docs] def setUp(self) -> None: @@ -1994,7 +2101,7 @@

    Source code for one.tests.test_one

     
    [docs] def test_local_cache_setup_prompt(self): - """Test One.setup""" + """Test One.setup.""" path = Path(self.tempdir.name).joinpath('subject', '2020-01-01', '1', 'spikes.times.npy') path.parent.mkdir(parents=True) path.touch() @@ -2021,6 +2128,7 @@

    Source code for one.tests.test_one

     [docs]
         def test_setup_silent(self):
             """Test setting up parameters with silent flag.
    +
             - Mock getfile to return temp dir as param file location
             - Mock input function as fail safe in case function erroneously prompts user for input
             """
    @@ -2054,6 +2162,7 @@ 

    Source code for one.tests.test_one

     [docs]
         def test_setup_username(self):
             """Test setting up parameters with a provided username.
    +
             - Mock getfile to return temp dir as param file location
             - Mock input function as fail safe in case function erroneously prompts user for input
             - Mock requests.post returns a fake user authentication response
    @@ -2085,7 +2194,7 @@ 

    Source code for one.tests.test_one

     [docs]
         @unittest.skipIf(OFFLINE_ONLY, 'online only test')
         def test_static_setup(self):
    -        """Test OneAlyx.setup"""
    +        """Test OneAlyx.setup."""
             with mock.patch('iblutil.io.params.getfile', new=self.get_file), \
                     mock.patch('one.webclient.getpass', return_value='international'):
                 one_obj = OneAlyx.setup(silent=True)
    @@ -2095,7 +2204,7 @@ 

    Source code for one.tests.test_one

     
    [docs] def test_setup(self): - """Test one.params.setup""" + """Test one.params.setup.""" url = TEST_DB_1['base_url'] def mock_input(prompt): @@ -2142,7 +2251,7 @@

    Source code for one.tests.test_one

     
    [docs] def test_patch_params(self): - """Test patching legacy params to the new location""" + """Test patching legacy params to the new location.""" # Save some old-style params old_pars = one.params.default().set('HTTP_DATA_SERVER', 'openalyx.org') # Save a REST query in the old location @@ -2162,7 +2271,7 @@

    Source code for one.tests.test_one

     
    [docs] def test_one_factory(self): - """Tests the ONE class factory""" + """Tests the ONE class factory.""" with mock.patch('iblutil.io.params.getfile', new=self.get_file), \ mock.patch('one.params.input', new=self.assertFalse): # Cache dir not in client cache map; use One (light) @@ -2200,11 +2309,11 @@

    Source code for one.tests.test_one

     
    [docs] class TestOneMisc(unittest.TestCase): - """Test functions in one.util""" + """Test functions in one.util."""
    [docs] def test_validate_date_range(self): - """Test one.util.validate_date_range""" + """Test one.util.validate_date_range.""" # Single string date actual = validate_date_range('2020-01-01') # On this day expected = (pd.Timestamp('2020-01-01 00:00:00'), @@ -2250,7 +2359,7 @@

    Source code for one.tests.test_one

     
    [docs] def test_index_last_before(self): - """Test one.util.index_last_before""" + """Test one.util.index_last_before.""" revisions = ['2021-01-01', '2020-08-01', '', '2020-09-30'] verifiable = index_last_before(revisions, '2021-01-01') self.assertEqual(0, verifiable) @@ -2270,7 +2379,7 @@

    Source code for one.tests.test_one

     
    [docs] def test_collection_spec(self): - """Test one.util._collection_spec""" + """Test one.util._collection_spec.""" # Test every combination of input inputs = [] _collection = {None: '({collection}/)?', '': '', '-': '{collection}/'} @@ -2287,20 +2396,20 @@

    Source code for one.tests.test_one

     
    [docs] def test_revision_last_before(self): - """Test one.util.filter_revision_last_before""" + """Test one.util.filter_revision_last_before.""" datasets = util.revisions_datasets_table() df = datasets[datasets.rel_path.str.startswith('alf/probe00')].copy() - verifiable = filter_revision_last_before(df, - revision='2020-09-01', assert_unique=False) + verifiable = filter_revision_last_before(df, revision='2020-09-01', assert_unique=False) self.assertTrue(len(verifiable) == 2) - # Test assert unique + # Remove one of the datasets' revisions to test assert unique on mixed revisions + df_mixed = df.drop((df['revision'] == '2020-01-08').idxmax()) with self.assertRaises(alferr.ALFMultipleRevisionsFound): - filter_revision_last_before(df, revision='2020-09-01', assert_unique=True) + filter_revision_last_before(df_mixed, revision='2020-09-01', assert_consistent=True) # Test with default revisions df['default_revision'] = False - with self.assertLogs(logging.getLogger('one.util')): + with self.assertWarnsRegex(alferr.ALFWarning, 'No default revision for dataset'): verifiable = filter_revision_last_before(df.copy(), assert_unique=False) self.assertTrue(len(verifiable) == 2) @@ -2311,8 +2420,10 @@

    Source code for one.tests.test_one

     
             # Add unique default revisions
             df.iloc[[0, 4], -1] = True
    -        verifiable = filter_revision_last_before(df.copy(), assert_unique=True)
    -        self.assertTrue(len(verifiable) == 2)
    +        # Should log mixed revisions
    +        with self.assertWarnsRegex(alferr.ALFWarning, 'Multiple revisions'):
    +            verifiable = filter_revision_last_before(df.copy(), assert_unique=True)
    +        self.assertEqual(2, len(verifiable))
             self.assertCountEqual(verifiable['rel_path'], df['rel_path'].iloc[[0, 4]])
     
             # Add multiple default revisions
    @@ -2324,7 +2435,7 @@ 

    Source code for one.tests.test_one

     
    [docs] def test_parse_id(self): - """Test one.util.parse_id""" + """Test one.util.parse_id.""" obj = unittest.mock.MagicMock() # Mock object to decorate obj.to_eid.return_value = 'parsed_id' # Method to be called input = 'subj/date/num' # Input id to pass to `to_eid` @@ -2341,7 +2452,7 @@

    Source code for one.tests.test_one

     
    [docs] def test_autocomplete(self): - """Test one.util.autocomplete""" + """Test one.util.autocomplete.""" search_terms = ('subject', 'date_range', 'dataset', 'dataset_type') self.assertEqual('subject', autocomplete('Subj', search_terms)) self.assertEqual('dataset', autocomplete('dataset', search_terms)) @@ -2354,7 +2465,7 @@

    Source code for one.tests.test_one

     
    [docs] def test_LazyID(self): - """Test one.util.LazyID""" + """Test one.util.LazyID.""" uuids = [ 'c1a2758d-3ce5-4fa7-8d96-6b960f029fa9', '0780da08-a12b-452a-b936-ebc576aa7670', @@ -2368,6 +2479,18 @@

    Source code for one.tests.test_one

             self.assertEqual(ez[0:2], uuids[0:2])
             ez = LazyId([{'id': x} for x in uuids])
             self.assertCountEqual(map(str, ez), uuids)
    + + +
    +[docs] + def test_ensure_list(self): + """Test one.util.ensure_list. + + This function has now moved therefore we simply check for deprecation warning. + """ + with self.assertWarns(DeprecationWarning): + self.assertEqual(['123'], ensure_list('123')) + self.assertIs(x := ['123'], ensure_list(x))
    diff --git a/_modules/one/tests/test_params.html b/_modules/one/tests/test_params.html index efae23ab..5d75c12d 100644 --- a/_modules/one/tests/test_params.html +++ b/_modules/one/tests/test_params.html @@ -1,3 +1,5 @@ + + @@ -5,23 +7,19 @@ one.tests.test_params — ONE documentation - + - - - - - - - - - - + + + + + + + + diff --git a/_modules/one/tests/test_registration.html b/_modules/one/tests/test_registration.html index a0166704..60ff270e 100644 --- a/_modules/one/tests/test_registration.html +++ b/_modules/one/tests/test_registration.html @@ -1,3 +1,5 @@ + + @@ -5,23 +7,19 @@ one.tests.test_registration — ONE documentation - + - - - - - - - - - - + + + + + + + + diff --git a/_modules/one/tests/util.html b/_modules/one/tests/util.html index 3b4e2f7d..1d3bbda1 100644 --- a/_modules/one/tests/util.html +++ b/_modules/one/tests/util.html @@ -1,3 +1,5 @@ + + @@ -5,23 +7,19 @@ one.tests.util — ONE documentation - + - - - - - - - - - - + + + + + + + + @@ -120,6 +118,7 @@

    Source code for one.tests.util

     
     import one.params
     from one.util import QC_TYPE
    +from one.converters import session_record2path
     
     
     
    @@ -185,7 +184,8 @@

    Source code for one.tests.util

     
         """
         # Create dset files from cache
    -    for session_path, rel_path in one._cache.datasets[['session_path', 'rel_path']].values:
    +    for (eid, _), rel_path in one._cache.datasets['rel_path'].items():
    +        session_path = session_record2path(one._cache.sessions.loc[eid])
             filepath = Path(one.cache_dir).joinpath(session_path, rel_path)
             filepath.parent.mkdir(exist_ok=True, parents=True)
             filepath.touch()
    @@ -239,7 +239,8 @@

    Source code for one.tests.util

     def revisions_datasets_table(collections=('', 'alf/probe00', 'alf/probe01'),
                                  revisions=('', '2020-01-08', '2021-07-06'),
                                  object='spikes',
    -                             attributes=('times', 'waveforems')):
    +                             attributes=('times', 'waveforems'),
    +                             touch_path=None):
         """Returns a datasets cache DataFrame containing datasets with revision folders.
     
         As there are no revised datasets on the test databases, this function acts as a fixture for
    @@ -255,11 +256,13 @@ 

    Source code for one.tests.util

             An ALF object
         attributes : tuple
             A list of ALF attributes
    +    touch_path : pathlib.Path, str
    +        If provided, files are created in this directory.
     
         Returns
         -------
         pd.DataFrame
    -        A datasets cache table containing datasets made from the input names
    +        A datasets cache table containing datasets made from the input names.
     
         """
         rel_path = []
    @@ -269,8 +272,7 @@ 

    Source code for one.tests.util

                     rel_path.append('/'.join(x for x in (collec, rev, f'{object}.{attr}.npy') if x))
         d = {
             'rel_path': rel_path,
    -        'session_path': 'subject/1900-01-01/001',
    -        'file_size': None,
    +        'file_size': 0,
             'hash': None,
             'exists': True,
             'qc': 'NOT_SET',
    @@ -278,6 +280,12 @@ 

    Source code for one.tests.util

             'id': map(str, (uuid4() for _ in rel_path))
         }
     
    +    if touch_path:
    +        for p in rel_path:
    +            path = Path(touch_path).joinpath(p)
    +            path.parent.mkdir(parents=True, exist_ok=True)
    +            path.touch()
    +
         return pd.DataFrame(data=d).astype({'qc': QC_TYPE}).set_index(['eid', 'id'])
    diff --git a/_modules/one/util.html b/_modules/one/util.html index c9fae638..600f7c7e 100644 --- a/_modules/one/util.html +++ b/_modules/one/util.html @@ -1,3 +1,5 @@ + + @@ -5,23 +7,19 @@ one.util — ONE documentation - + - - - - - - - - - - + + + + + + + + @@ -108,16 +106,19 @@

    Source code for one.util

     """Decorators and small standalone functions for api module."""
    +import re
     import logging
     import urllib.parse
    -from functools import wraps
    +import fnmatch
    +import warnings
    +from functools import wraps, partial
     from typing import Sequence, Union, Iterable, Optional, List
     from collections.abc import Mapping
    -import fnmatch
     from datetime import datetime
     
     import pandas as pd
     from iblutil.io import parquet
    +from iblutil.util import ensure_list as _ensure_list
     import numpy as np
     from packaging import version
     
    @@ -172,8 +173,8 @@ 

    Source code for one.util

             rec['eid'] = session.name
             file_path = urllib.parse.urlsplit(d['data_url'], allow_fragments=False).path.strip('/')
             file_path = get_alf_path(remove_uuid_string(file_path))
    -        rec['session_path'] = get_session_path(file_path).as_posix()
    -        rec['rel_path'] = file_path[len(rec['session_path']):].strip('/')
    +        session_path = get_session_path(file_path).as_posix()
    +        rec['rel_path'] = file_path[len(session_path):].strip('/')
             rec['default_revision'] = d['default_revision'] == 'True'
             rec['qc'] = d.get('qc', 'NOT_SET')
             return rec
    @@ -211,7 +212,7 @@ 

    Source code for one.util

         """
         records = []
     
    -    for d in ensure_list(datasets):
    +    for d in _ensure_list(datasets):
             file_record = next((x for x in d['file_records'] if x['data_url'] and x['exists']), None)
             if not file_record:
                 continue  # Ignore files that are not accessible
    @@ -221,10 +222,10 @@ 

    Source code for one.util

             data_url = urllib.parse.urlsplit(file_record['data_url'], allow_fragments=False)
             file_path = get_alf_path(data_url.path.strip('/'))
             file_path = remove_uuid_string(file_path).as_posix()
    -        rec['session_path'] = get_session_path(file_path) or ''
    -        if rec['session_path']:
    -            rec['session_path'] = rec['session_path'].as_posix()
    -        rec['rel_path'] = file_path[len(rec['session_path']):].strip('/')
    +        session_path = get_session_path(file_path) or ''
    +        if session_path:
    +            session_path = session_path.as_posix()
    +        rec['rel_path'] = file_path[len(session_path):].strip('/')
             rec['default_revision'] = d['default_dataset']
             rec['qc'] = d.get('qc')
             for field in additional or []:
    @@ -436,7 +437,9 @@ 

    Source code for one.util

         revision_last_before : bool
             When true and no exact match exists, the (lexicographically) previous revision is used
             instead.  When false the revision string is matched like collection and filename,
    -        with regular expressions permitted.
    +        with regular expressions permitted.  NB: When true and `revision` is None the default
    +        revision is returned which may not be the last revision. If no default is defined, the
    +        last revision is returned.
         qc : str, int, one.alf.spec.QC
             Returns datasets at or below this QC level.  Integer values should correspond to the QC
             enumeration NOT the qc category column codes in the pandas table.
    @@ -479,6 +482,26 @@ 

    Source code for one.util

     
         >>> datasets filter_datasets(all_datasets, qc='PASS', ignore_qc_not_set=True)
     
    +    Raises
    +    ------
    +    one.alf.exceptions.ALFMultipleCollectionsFound
    +        The matching list of datasets have more than one unique collection and `assert_unique` is
    +        True.
    +    one.alf.exceptions.ALFMultipleRevisionsFound
    +        When `revision_last_before` is false, the matching list of datasets have more than one
    +        unique revision.  When `revision_last_before` is true, a 'default_revision' column exists,
    +        and no revision is passed, this error means that one or more matching datasets have
    +        multiple revisions specified as the default. This is typically an error in the cache table
    +        itself as all datasets should have one and only one default revision specified.
    +    one.alf.exceptions.ALFMultipleObjectsFound
    +        The matching list of datasets have more than one unique filename and both `assert_unique`
    +        and `revision_last_before` are true.
    +    one.alf.exceptions.ALFError
    +        When both `assert_unique` and `revision_last_before` is true, and a 'default_revision'
    +        column exists but `revision` is None; one or more matching datasets have no default
    +        revision specified. This is typically an error in the cache table itself as all datasets
    +        should have one and only one default revision specified.
    +
         Notes
         -----
         - It is not possible to match datasets that are in a given collection OR NOT in ANY collection.
    @@ -494,9 +517,15 @@ 

    Source code for one.util

             spec_str += _file_spec(**filename)
             regex_args.update(**filename)
         else:
    -        # Convert to regex is necessary and assert end of string
    -        filename = [fnmatch.translate(x) if wildcards else x + '$' for x in ensure_list(filename)]
    -        spec_str += '|'.join(filename)
    +        # Convert to regex if necessary and assert end of string
    +        flagless_token = re.escape(r'(?s:')  # fnmatch.translate may wrap input in flagless group
    +        # If there is a wildcard at the start of the filename we must exclude capture of slashes to
    +        # avoid capture of collection part, e.g. * -> .* -> [^/]* (one or more non-slash chars)
    +        exclude_slash = partial(re.sub, fr'^({flagless_token})?\.\*', r'\g<1>[^/]*')
    +        spec_str += '|'.join(
    +            exclude_slash(fnmatch.translate(x)) if wildcards else x + '$'
    +            for x in _ensure_list(filename)
    +        )
     
         # If matching revision name, add to regex string
         if not revision_last_before:
    @@ -507,7 +536,7 @@ 

    Source code for one.util

                 continue
             if wildcards:
                 # Convert to regex, remove \\Z which asserts end of string
    -            v = (fnmatch.translate(x).replace('\\Z', '') for x in ensure_list(v))
    +            v = (fnmatch.translate(x).replace('\\Z', '') for x in _ensure_list(v))
             if not isinstance(v, str):
                 regex_args[k] = '|'.join(v)  # logical OR
     
    @@ -522,36 +551,40 @@ 

    Source code for one.util

             qc_match &= all_datasets['qc'].ne('NOT_SET')
     
         # Filter datasets on path and QC
    -    match = all_datasets[path_match & qc_match]
    +    match = all_datasets[path_match & qc_match].copy()
         if len(match) == 0 or not (revision_last_before or assert_unique):
             return match
     
    -    revisions = [rel_path_parts(x)[1] or '' for x in match.rel_path.values]
    +    # Extract revision to separate column
    +    if 'revision' not in match.columns:
    +        match['revision'] = match.rel_path.map(lambda x: rel_path_parts(x)[1] or '')
         if assert_unique:
             collections = set(rel_path_parts(x)[0] or '' for x in match.rel_path.values)
             if len(collections) > 1:
                 _list = '"' + '", "'.join(collections) + '"'
                 raise alferr.ALFMultipleCollectionsFound(_list)
             if not revision_last_before:
    -            if filename and len(match) > 1:
    +            if len(set(match['revision'])) > 1:
    +                _list = '"' + '", "'.join(set(match['revision'])) + '"'
    +                raise alferr.ALFMultipleRevisionsFound(_list)
    +            if len(match) > 1:
                     _list = '"' + '", "'.join(match['rel_path']) + '"'
                     raise alferr.ALFMultipleObjectsFound(_list)
    -            if len(set(revisions)) > 1:
    -                _list = '"' + '", "'.join(set(revisions)) + '"'
    -                raise alferr.ALFMultipleRevisionsFound(_list)
                 else:
                     return match
    -        elif filename and len(set(revisions)) != len(revisions):
    -            _list = '"' + '", "'.join(match['rel_path']) + '"'
    -            raise alferr.ALFMultipleObjectsFound(_list)
     
    -    return filter_revision_last_before(match, revision, assert_unique=assert_unique)
    + match = filter_revision_last_before(match, revision, assert_unique=assert_unique) + if assert_unique and len(match) > 1: + _list = '"' + '", "'.join(match['rel_path']) + '"' + raise alferr.ALFMultipleObjectsFound(_list) + return match
    [docs] -def filter_revision_last_before(datasets, revision=None, assert_unique=True): +def filter_revision_last_before( + datasets, revision=None, assert_unique=True, assert_consistent=False): """ Filter datasets by revision, returning previous revision in ordered list if revision doesn't exactly match. @@ -565,43 +598,80 @@

    Source code for one.util

         assert_unique : bool
             When true an alferr.ALFMultipleRevisionsFound exception is raised when multiple
             default revisions are found; an alferr.ALFError when no default revision is found.
    +    assert_consistent : bool
    +        Will raise alferr.ALFMultipleRevisionsFound if matching revision is different between
    +        datasets.
     
         Returns
         -------
         pd.DataFrame
             A datasets DataFrame with 0 or 1 row per unique dataset.
    +
    +    Raises
    +    ------
    +    one.alf.exceptions.ALFMultipleRevisionsFound
    +        When the 'default_revision' column exists and no revision is passed, this error means that
    +        one or more matching datasets have multiple revisions specified as the default. This is
    +        typically an error in the cache table itself as all datasets should have one and only one
    +        default revision specified.
    +        When `assert_consistent` is True, this error may mean that the matching datasets have
    +        mixed revisions.
    +    one.alf.exceptions.ALFMultipleObjectsFound
    +        The matching list of datasets have more than one unique filename and both `assert_unique`
    +        and `revision_last_before` are true.
    +    one.alf.exceptions.ALFError
    +        When both `assert_unique` and `revision_last_before` is true, and a 'default_revision'
    +        column exists but `revision` is None; one or more matching datasets have no default
    +        revision specified. This is typically an error in the cache table itself as all datasets
    +        should have one and only one default revision specified.
    +
    +    Notes
    +    -----
    +    - When `revision` is not None, the default revision value is not used. If an older revision is
    +      the default one (uncommon), passing in a revision may lead to a newer revision being returned
    +      than if revision is None.
    +    - A view is returned if a revision column is present, otherwise a copy is returned.
         """
         def _last_before(df):
             """Takes a DataFrame with only one dataset and multiple revisions, returns matching row"""
    -        if revision is None and 'default_revision' in df.columns:
    -            if assert_unique and sum(df.default_revision) > 1:
    -                revisions = df['revision'][df.default_revision.values]
    -                rev_list = '"' + '", "'.join(revisions) + '"'
    -                raise alferr.ALFMultipleRevisionsFound(rev_list)
    -            if sum(df.default_revision) == 1:
    -                return df[df.default_revision]
    -            if len(df) == 1:  # This may be the case when called from load_datasets
    -                return df  # It's not the default be there's only one available revision
    -            # default_revision column all False; default isn't copied to remote repository
    +        if revision is None:
                 dset_name = df['rel_path'].iloc[0]
    -            if assert_unique:
    -                raise alferr.ALFError(f'No default revision for dataset {dset_name}')
    -            else:
    -                logger.warning(f'No default revision for dataset {dset_name}; using most recent')
    +            if 'default_revision' in df.columns:
    +                if assert_unique and sum(df.default_revision) > 1:
    +                    revisions = df['revision'][df.default_revision.values]
    +                    rev_list = '"' + '", "'.join(revisions) + '"'
    +                    raise alferr.ALFMultipleRevisionsFound(rev_list)
    +                if sum(df.default_revision) == 1:
    +                    return df[df.default_revision]
    +                if len(df) == 1:  # This may be the case when called from load_datasets
    +                    return df  # It's not the default but there's only one available revision
    +                # default_revision column all False; default isn't copied to remote repository
    +                if assert_unique:
    +                    raise alferr.ALFError(f'No default revision for dataset {dset_name}')
    +            warnings.warn(
    +                f'No default revision for dataset {dset_name}; using most recent',
    +                alferr.ALFWarning)
             # Compare revisions lexicographically
    -        if assert_unique and len(df['revision'].unique()) > 1:
    -            rev_list = '"' + '", "'.join(df['revision'].unique()) + '"'
    -            raise alferr.ALFMultipleRevisionsFound(rev_list)
    -        # Square brackets forces 1 row DataFrame returned instead of Series
             idx = index_last_before(df['revision'].tolist(), revision)
    -        # return df.iloc[slice(0, 0) if idx is None else [idx], :]
    +        # Square brackets forces 1 row DataFrame returned instead of Series
             return df.iloc[slice(0, 0) if idx is None else [idx], :]
     
    -    with pd.option_context('mode.chained_assignment', None):  # FIXME Explicitly copy?
    -        datasets['revision'] = [rel_path_parts(x)[1] or '' for x in datasets.rel_path]
    +    # Extract revision to separate column
    +    if 'revision' not in datasets.columns:
    +        with pd.option_context('mode.chained_assignment', None):  # FIXME Explicitly copy?
    +            datasets['revision'] = datasets.rel_path.map(lambda x: rel_path_parts(x)[1] or '')
    +    # Group by relative path (sans revision)
         groups = datasets.rel_path.str.replace('#.*#/', '', regex=True).values
         grouped = datasets.groupby(groups, group_keys=False)
    -    return grouped.apply(_last_before)
    + filtered = grouped.apply(_last_before) + # Raise if matching revision is different between datasets + if len(filtered['revision'].unique()) > 1: + rev_list = '"' + '", "'.join(filtered['revision'].unique()) + '"' + if assert_consistent: + raise alferr.ALFMultipleRevisionsFound(rev_list) + else: + warnings.warn(f'Multiple revisions: {rev_list}', alferr.ALFWarning) + return filtered
    @@ -662,7 +732,10 @@

    Source code for one.util

     [docs]
     def ensure_list(value):
         """Ensure input is a list."""
    -    return [value] if isinstance(value, (str, dict)) or not isinstance(value, Iterable) else value
    + warnings.warn( + 'one.util.ensure_list is deprecated, use iblutil.util.ensure_list instead', + DeprecationWarning) + return _ensure_list(value)
    @@ -759,6 +832,8 @@

    Source code for one.util

         if name == 'datasets' and min_version < version.Version('2.7.0') and 'qc' not in table.columns:
             qc = pd.Categorical.from_codes(np.zeros(len(table.index), dtype=int), dtype=QC_TYPE)
             table = table.assign(qc=qc)
    +    if name == 'datasets' and 'session_path' in table.columns:
    +        table = table.drop('session_path', axis=1)
         return table
    diff --git a/_modules/one/webclient.html b/_modules/one/webclient.html index 14cd0762..20f3d528 100644 --- a/_modules/one/webclient.html +++ b/_modules/one/webclient.html @@ -1,3 +1,5 @@ + + @@ -5,23 +7,19 @@ one.webclient — ONE documentation - + - - - - - - - - - - + + + + + + + + @@ -163,7 +161,7 @@

    Source code for one.webclient

     import one.params
     from iblutil.io import hashfile
     from iblutil.io.params import set_hidden
    -from one.util import ensure_list
    +from iblutil.util import ensure_list
     import concurrent.futures
     _logger = logging.getLogger(__name__)
     
    @@ -325,9 +323,12 @@ 

    Source code for one.webclient

         def __getitem__(self, item):
             if isinstance(item, slice):
                 while None in self._cache[item]:
    -                self.populate(item.start + self._cache[item].index(None))
    +                # If slice start index is -ve, convert to +ve index
    +                i = self.count + item.start if item.start < 0 else item.start
    +                self.populate(i + self._cache[item].index(None))
             elif self._cache[item] is None:
    -            self.populate(item)
    +            # If index is -ve, convert to +ve
    +            self.populate(self.count + item if item < 0 else item)
             return self._cache[item]
     
         def populate(self, idx):
    @@ -779,6 +780,11 @@ 

    Source code for one.webclient

             if username is None and not self.silent:
                 username = input('Enter Alyx username:')
     
    +        # If user passes in a password, force re-authentication even if token cached
    +        if password is not None:
    +            if not force:
    +                _logger.debug('Forcing token request with provided password')
    +            force = True
             # Check if token cached
             if not force and getattr(self._par, 'TOKEN', False) and username in self._par.TOKEN:
                 self._token = self._par.TOKEN[username]
    @@ -791,8 +797,17 @@ 

    Source code for one.webclient

             # Get password
             if password is None:
                 password = getattr(self._par, 'ALYX_PWD', None)
    -        if password is None and not self.silent:
    -            password = getpass(f'Enter Alyx password for "{username}":')
    +        if password is None:
    +            if self.silent:
    +                warnings.warn(
    +                    'No password or cached token in silent mode. '
    +                    'Please run the following to re-authenticate:\n\t'
    +                    'AlyxClient(silent=False).authenticate'
    +                    '(username=<username>, force=True)', UserWarning)
    +            else:
    +                password = getpass(f'Enter Alyx password for "{username}":')
    +        # Remove previous token
    +        self._clear_token(username)
             try:
                 credentials = {'username': username, 'password': password}
                 rep = requests.post(self.base_url + '/auth-token', data=credentials)
    @@ -830,16 +845,12 @@ 

    Source code for one.webclient

                 print(f'Connected to {self.base_url} as user "{self.user}"')
    -
    -[docs] - def logout(self): - """Log out from Alyx. - Deletes the cached authentication token for the currently logged-in user. + def _clear_token(self, username): + """Remove auth token from client params. + + Deletes the cached authentication token for a given user. """ - if not self.is_logged_in: - return par = one.params.get(client=self.base_url, silent=True) - username = self.user # Remove token from cache if getattr(par, 'TOKEN', False) and username in par.TOKEN: del par.TOKEN[username] @@ -848,10 +859,22 @@

    Source code for one.webclient

             if getattr(self._par, 'TOKEN', False) and username in self._par.TOKEN:
                 del self._par.TOKEN[username]
             # Remove token from object
    -        self.user = None
             self._token = None
             if self._headers and 'Authorization' in self._headers:
                 del self._headers['Authorization']
    +
    +
    +[docs] + def logout(self): + """Log out from Alyx. + + Deletes the cached authentication token for the currently logged-in user + and clears the REST cache. + """ + if not self.is_logged_in: + return + self._clear_token(username := self.user) + self.user = None self.clear_rest_cache() if not self.silent: print(f'{username} logged out from {self.base_url}')
    diff --git a/_sources/_autosummary/one.alf.exceptions.rst.txt b/_sources/_autosummary/one.alf.exceptions.rst.txt index e2cb2aa8..b224a8b6 100644 --- a/_sources/_autosummary/one.alf.exceptions.rst.txt +++ b/_sources/_autosummary/one.alf.exceptions.rst.txt @@ -26,6 +26,7 @@ one.alf.exceptions ALFMultipleObjectsFound ALFMultipleRevisionsFound ALFObjectNotFound + ALFWarning AlyxSubjectNotFound diff --git a/_sources/one_installation.md.txt b/_sources/one_installation.md.txt index b4f8ba81..6296523e 100644 --- a/_sources/one_installation.md.txt +++ b/_sources/one_installation.md.txt @@ -61,7 +61,7 @@ one = ONE() To change your default database, or re-run the setup for a given database, you can use the following ```python -ONE._setup(base_url='https://test.alyx.internationalbrainlab.org', make_default=True) +ONE.setup(base_url='https://test.alyx.internationalbrainlab.org', make_default=True) ``` ## 4. Update diff --git a/_static/basic.css b/_static/basic.css index f316efcb..7ebbd6d0 100644 --- a/_static/basic.css +++ b/_static/basic.css @@ -1,12 +1,5 @@ /* - * basic.css - * ~~~~~~~~~ - * * Sphinx stylesheet -- basic theme. - * - * :copyright: Copyright 2007-2024 by the Sphinx team, see AUTHORS. - * :license: BSD, see LICENSE for details. - * */ /* -- main layout ----------------------------------------------------------- */ @@ -115,15 +108,11 @@ img { /* -- search page ----------------------------------------------------------- */ ul.search { - margin: 10px 0 0 20px; - padding: 0; + margin-top: 10px; } ul.search li { - padding: 5px 0 5px 20px; - background-image: url(file.png); - background-repeat: no-repeat; - background-position: 0 7px; + padding: 5px 0; } ul.search li a { diff --git a/_static/css/badge_only.css b/_static/css/badge_only.css index c718cee4..88ba55b9 100644 --- a/_static/css/badge_only.css +++ b/_static/css/badge_only.css @@ -1 +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 +.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-other-versions .rtd-current-item{font-weight:700}.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}}#flyout-search-form{padding:6px} \ No newline at end of file diff --git a/_static/css/theme.css b/_static/css/theme.css index 19a446a0..0f14f106 100644 --- a/_static/css/theme.css +++ b/_static/css/theme.css @@ -1,4 +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 + */@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 .wy-dropdown>aactive,.wy-side-nav-search .wy-dropdown>afocus,.wy-side-nav-search>a:hover,.wy-side-nav-search>aactive,.wy-side-nav-search>afocus{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,.wy-side-nav-search>a.icon{display:block}.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.switch-menus{position:relative;display:block;margin-top:-.4045em;margin-bottom:.809em;font-weight:400;color:hsla(0,0%,100%,.3)}.wy-side-nav-search>div.switch-menus>div.language-switch,.wy-side-nav-search>div.switch-menus>div.version-switch{display:inline-block;padding:.2em}.wy-side-nav-search>div.switch-menus>div.language-switch select,.wy-side-nav-search>div.switch-menus>div.version-switch select{display:inline-block;margin-right:-2rem;padding-right:2rem;max-width:240px;text-align-last:center;background:none;border:none;border-radius:0;box-shadow:none;font-family:Lato,proxima-nova,Helvetica Neue,Arial,sans-serif;font-size:1em;font-weight:400;color:hsla(0,0%,100%,.3);cursor:pointer;appearance:none;-webkit-appearance:none;-moz-appearance:none}.wy-side-nav-search>div.switch-menus>div.language-switch select:active,.wy-side-nav-search>div.switch-menus>div.language-switch select:focus,.wy-side-nav-search>div.switch-menus>div.language-switch select:hover,.wy-side-nav-search>div.switch-menus>div.version-switch select:active,.wy-side-nav-search>div.switch-menus>div.version-switch select:focus,.wy-side-nav-search>div.switch-menus>div.version-switch select:hover{background:hsla(0,0%,100%,.1);color:hsla(0,0%,100%,.5)}.wy-side-nav-search>div.switch-menus>div.language-switch select option,.wy-side-nav-search>div.switch-menus>div.version-switch select option{color:#000}.wy-side-nav-search>div.switch-menus>div.language-switch:has(>select):after,.wy-side-nav-search>div.switch-menus>div.version-switch:has(>select):after{display:inline-block;width:1.5em;height:100%;padding:.1em;content:"\f0d7";font-size:1em;line-height:1.2em;font-family:FontAwesome;text-align:center;pointer-events:none;box-sizing:border-box}.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-other-versions .rtd-current-item{font-weight:700}.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}}#flyout-search-form{padding:6px}.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 index 4d67807d..0398ebb9 100644 --- a/_static/doctools.js +++ b/_static/doctools.js @@ -1,12 +1,5 @@ /* - * doctools.js - * ~~~~~~~~~~~ - * * Base JavaScript utilities for all Sphinx HTML documentation. - * - * :copyright: Copyright 2007-2024 by the Sphinx team, see AUTHORS. - * :license: BSD, see LICENSE for details. - * */ "use strict"; diff --git a/_static/js/versions.js b/_static/js/versions.js new file mode 100644 index 00000000..818bc996 --- /dev/null +++ b/_static/js/versions.js @@ -0,0 +1,224 @@ +const themeFlyoutDisplay = "hidden"; +const themeVersionSelector = "True"; +const themeLanguageSelector = "True"; + +if (themeFlyoutDisplay === "attached") { + function renderLanguages(config) { + if (!config.projects.translations.length) { + return ""; + } + + const languagesHTML = ` +
    +
    Languages
    + ${config.projects.translations + .map( + (translation) => ` +
    + ${translation.language.code} +
    + `, + ) + .join("\n")} +
    + `; + return languagesHTML; + } + + function renderVersions(config) { + if (!config.versions.active.length) { + return ""; + } + const versionsHTML = ` +
    +
    Versions
    + ${config.versions.active + .map( + (version) => ` +
    + ${version.slug} +
    + `, + ) + .join("\n")} +
    + `; + return versionsHTML; + } + + function renderDownloads(config) { + if (!Object.keys(config.versions.current.downloads).length) { + return ""; + } + const downloadsNameDisplay = { + pdf: "PDF", + epub: "Epub", + htmlzip: "HTML", + }; + + const downloadsHTML = ` +
    +
    Downloads
    + ${Object.entries(config.versions.current.downloads) + .map( + ([name, url]) => ` +
    + ${downloadsNameDisplay[name]} +
    + `, + ) + .join("\n")} +
    + `; + return downloadsHTML; + } + + document.addEventListener("readthedocs-addons-data-ready", function (event) { + const config = event.detail.data(); + + const flyout = ` +
    + + Read the Docs + v: ${config.versions.current.slug} + + +
    +
    + ${renderLanguages(config)} + ${renderVersions(config)} + ${renderDownloads(config)} +
    +
    On Read the Docs
    +
    + Project Home +
    +
    + Builds +
    +
    + Downloads +
    +
    +
    +
    Search
    +
    +
    + +
    +
    +
    +
    + + Hosted by Read the Docs + +
    +
    + `; + + // Inject the generated flyout into the body HTML element. + document.body.insertAdjacentHTML("beforeend", flyout); + + // Trigger the Read the Docs Addons Search modal when clicking on the "Search docs" input from inside the flyout. + document + .querySelector("#flyout-search-form") + .addEventListener("focusin", () => { + const event = new CustomEvent("readthedocs-search-show"); + document.dispatchEvent(event); + }); + }) +} + +if (themeLanguageSelector || themeVersionSelector) { + function onSelectorSwitch(event) { + const option = event.target.selectedIndex; + const item = event.target.options[option]; + window.location.href = item.dataset.url; + } + + document.addEventListener("readthedocs-addons-data-ready", function (event) { + const config = event.detail.data(); + + const versionSwitch = document.querySelector( + "div.switch-menus > div.version-switch", + ); + if (themeVersionSelector) { + let versions = config.versions.active; + if (config.versions.current.hidden || config.versions.current.type === "external") { + versions.unshift(config.versions.current); + } + const versionSelect = ` + + `; + + versionSwitch.innerHTML = versionSelect; + versionSwitch.firstElementChild.addEventListener("change", onSelectorSwitch); + } + + const languageSwitch = document.querySelector( + "div.switch-menus > div.language-switch", + ); + + if (themeLanguageSelector) { + if (config.projects.translations.length) { + // Add the current language to the options on the selector + let languages = config.projects.translations.concat( + config.projects.current, + ); + languages = languages.sort((a, b) => + a.language.name.localeCompare(b.language.name), + ); + + const languageSelect = ` + + `; + + languageSwitch.innerHTML = languageSelect; + languageSwitch.firstElementChild.addEventListener("change", onSelectorSwitch); + } + else { + languageSwitch.remove(); + } + } + }); +} + +document.addEventListener("readthedocs-addons-data-ready", function (event) { + // Trigger the Read the Docs Addons Search modal when clicking on "Search docs" input from the topnav. + document + .querySelector("[role='search'] input") + .addEventListener("focusin", () => { + const event = new CustomEvent("readthedocs-search-show"); + document.dispatchEvent(event); + }); +}); \ No newline at end of file diff --git a/_static/language_data.js b/_static/language_data.js index 367b8ed8..c7fe6c6f 100644 --- a/_static/language_data.js +++ b/_static/language_data.js @@ -1,13 +1,6 @@ /* - * language_data.js - * ~~~~~~~~~~~~~~~~ - * * This script contains the language-specific data used by searchtools.js, * namely the list of stopwords, stemmer, scorer and splitter. - * - * :copyright: Copyright 2007-2024 by the Sphinx team, see AUTHORS. - * :license: BSD, see LICENSE for details. - * */ var stopwords = ["a", "and", "are", "as", "at", "be", "but", "by", "for", "if", "in", "into", "is", "it", "near", "no", "not", "of", "on", "or", "such", "that", "the", "their", "then", "there", "these", "they", "this", "to", "was", "will", "with"]; diff --git a/_static/searchtools.js b/_static/searchtools.js index b08d58c9..2c774d17 100644 --- a/_static/searchtools.js +++ b/_static/searchtools.js @@ -1,12 +1,5 @@ /* - * searchtools.js - * ~~~~~~~~~~~~~~~~ - * * Sphinx JavaScript utilities for the full-text search. - * - * :copyright: Copyright 2007-2024 by the Sphinx team, see AUTHORS. - * :license: BSD, see LICENSE for details. - * */ "use strict"; @@ -20,7 +13,7 @@ if (typeof Scorer === "undefined") { // and returns the new score. /* score: result => { - const [docname, title, anchor, descr, score, filename] = result + const [docname, title, anchor, descr, score, filename, kind] = result return score }, */ @@ -47,6 +40,14 @@ if (typeof Scorer === "undefined") { }; } +// Global search result kind enum, used by themes to style search results. +class SearchResultKind { + static get index() { return "index"; } + static get object() { return "object"; } + static get text() { return "text"; } + static get title() { return "title"; } +} + const _removeChildren = (element) => { while (element && element.lastChild) element.removeChild(element.lastChild); }; @@ -64,9 +65,13 @@ const _displayItem = (item, searchTerms, highlightTerms) => { const showSearchSummary = DOCUMENTATION_OPTIONS.SHOW_SEARCH_SUMMARY; const contentRoot = document.documentElement.dataset.content_root; - const [docName, title, anchor, descr, score, _filename] = item; + const [docName, title, anchor, descr, score, _filename, kind] = item; let listItem = document.createElement("li"); + // Add a class representing the item's type: + // can be used by a theme's CSS selector for styling + // See SearchResultKind for the class names. + listItem.classList.add(`kind-${kind}`); let requestUrl; let linkUrl; if (docBuilder === "dirhtml") { @@ -115,8 +120,10 @@ const _finishSearch = (resultCount) => { "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." + Search.status.innerText = Documentation.ngettext( + "Search finished, found one page matching the search query.", + "Search finished, found ${resultCount} pages matching the search query.", + resultCount, ).replace('${resultCount}', resultCount); }; const _displayNextItem = ( @@ -138,7 +145,7 @@ const _displayNextItem = ( else _finishSearch(resultCount); }; // Helper function used by query() to order search results. -// Each input is an array of [docname, title, anchor, descr, score, filename]. +// Each input is an array of [docname, title, anchor, descr, score, filename, kind]. // Order the results by score (in opposite order of appearance, since the // `_displayNextItem` function uses pop() to retrieve items) and then alphabetically. const _orderResultsByScoreThenName = (a, b) => { @@ -248,6 +255,7 @@ const Search = { searchSummary.classList.add("search-summary"); searchSummary.innerText = ""; const searchList = document.createElement("ul"); + searchList.setAttribute("role", "list"); searchList.classList.add("search"); const out = document.getElementById("search-results"); @@ -318,7 +326,7 @@ const Search = { const indexEntries = Search._index.indexentries; // Collect multiple result groups to be sorted separately and then ordered. - // Each is an array of [docname, title, anchor, descr, score, filename]. + // Each is an array of [docname, title, anchor, descr, score, filename, kind]. const normalResults = []; const nonMainIndexResults = []; @@ -337,6 +345,7 @@ const Search = { null, score + boost, filenames[file], + SearchResultKind.title, ]); } } @@ -354,6 +363,7 @@ const Search = { null, score, filenames[file], + SearchResultKind.index, ]; if (isMain) { normalResults.push(result); @@ -475,6 +485,7 @@ const Search = { descr, score, filenames[match[0]], + SearchResultKind.object, ]); }; Object.keys(objects).forEach((prefix) => @@ -585,6 +596,7 @@ const Search = { null, score, filenames[file], + SearchResultKind.text, ]); } return results; diff --git a/alf_intro.html b/alf_intro.html index 93558748..93824f3d 100644 --- a/alf_intro.html +++ b/alf_intro.html @@ -1,3 +1,5 @@ + + @@ -6,23 +8,19 @@ ALyx Filenames (ALF) — ONE documentation - + - - - - - - - - - - + + + + + + + + diff --git a/api_reference.html b/api_reference.html index 4d382d5c..a280670f 100644 --- a/api_reference.html +++ b/api_reference.html @@ -1,3 +1,5 @@ + + @@ -6,23 +8,19 @@ API Reference — ONE documentation - + - - - - - - - - - - + + + + + + + + diff --git a/contributing.html b/contributing.html index cac9b737..d812ee77 100644 --- a/contributing.html +++ b/contributing.html @@ -1,3 +1,5 @@ + + @@ -6,23 +8,19 @@ Contributing to documentation — ONE documentation - + - - - - - - - - - - + + + + + + + + diff --git a/genindex.html b/genindex.html index 8bd7d15e..2293b3c7 100644 --- a/genindex.html +++ b/genindex.html @@ -1,3 +1,5 @@ + + @@ -5,23 +7,19 @@ Index — ONE documentation - + - - - - - - - - - - + + + + + + + + @@ -152,14 +150,16 @@

    A

  • ALFObjectNotFound
  • +
  • ALFWarning +
  • + + -