diff --git a/master/.buildinfo b/master/.buildinfo index 663087e5..b7cb97b2 100644 --- a/master/.buildinfo +++ b/master/.buildinfo @@ -1,4 +1,4 @@ # Sphinx build info version 1 # This file hashes the configuration used when building these files. When it is not found, a full rebuild will be done. -config: aada98f00cd1f0e143fc1743c5771102 +config: fdc8792656888f5e7515f197b77125d6 tags: 645f666f9bcd5a90fca523b33c5a78b7 diff --git a/master/API-Doc.html b/master/API-Doc.html index 1b4ceb34..b3ecdd09 100644 --- a/master/API-Doc.html +++ b/master/API-Doc.html @@ -3,15 +3,16 @@ - + + API-Documentation — ConfigSpace documentation - - - + + + - + @@ -164,13 +165,13 @@
-
+

API-Documentation

-
+

ConfigurationSpace

-
-class ConfigSpace.configuration_space.ConfigurationSpace(name: Optional[str] = None, seed: Optional[int] = None, meta: Optional[Dict] = None)
+
+class ConfigSpace.configuration_space.ConfigurationSpace(name: Optional[str] = None, seed: Optional[int] = None, meta: Optional[Dict] = None)

A collection-like object containing a set of hyperparameter definitions and conditions.

A configuration space organizes all hyperparameters and its conditions as well as its forbidden clauses. Configurations can be sampled from @@ -188,8 +189,8 @@

ConfigurationSpace -
-add_condition(condition: ConfigSpace.conditions.ConditionComponent) → ConfigSpace.conditions.ConditionComponent
+
+add_condition(condition: ConfigSpace.conditions.ConditionComponent) → ConfigSpace.conditions.ConditionComponent

Add a condition to the configuration space. Check if adding the condition is legal:

+

Configuration

-
-class ConfigSpace.configuration_space.Configuration(configuration_space: ConfigSpace.configuration_space.ConfigurationSpace, values: Union[None, Dict[str, Union[str, float, int]]] = None, vector: Union[None, numpy.ndarray] = None, allow_inactive_with_values: bool = False, origin: Any = None, config_id: Optional[int] = None)
+
+class ConfigSpace.configuration_space.Configuration(configuration_space: ConfigSpace.configuration_space.ConfigurationSpace, values: Union[None, Dict[str, Union[str, float, int]]] = None, vector: Union[None, numpy.ndarray] = None, allow_inactive_with_values: bool = False, origin: Any = None, config_id: Optional[int] = None)

Class for a single configuration.

The Configuration object holds for all active hyperparameters a value. While the @@ -683,8 +684,8 @@

Configuration -
-get(item: unicode, default: Union[None, Any] = None) → Union[None, Any]
+
+get(item: unicode, default: Union[None, Any] = None) → Union[None, Any]

Return for a given hyperparameter name item the value of this hyperparameter. default if the hyperparameter name doesn’t exist.

@@ -704,8 +705,8 @@

Configuration -
-get_array() → numpy.ndarray
+
+get_array() → numpy.ndarray

Return the internal vector representation of the Configuration. All continuous values are scaled between zero and one.

@@ -720,8 +721,8 @@

Configuration -
-get_dictionary() → Dict[str, Union[str, float, int]]
+
+get_dictionary() → Dict[str, Union[str, float, int]]

Return a representation of the Configuration in dictionary form.

@@ -736,16 +737,16 @@

Configuration -
-is_valid_configuration() → None
+
+is_valid_configuration() → None

Check if the object is a valid Configuration. Raise an error if configuration is not valid.

-
-keys() → List[str]
+
+keys() → List[str]

Cache the keys to speed up the process of retrieving the keys.

Returns
@@ -759,18 +760,18 @@

Configuration +

+

Hyperparameters

ConfigSpace contains integer, float, categorical, as well as ordinal hyperparameters. Integer and float hyperparameter can be sampled from a uniform or normal distribution. Example usages are shown in the quickstart.

-
+

3.1 Integer hyperparameters

-
-class ConfigSpace.hyperparameters.UniformIntegerHyperparameter
+
+class ConfigSpace.hyperparameters.UniformIntegerHyperparameter

An integer hyperparameter.

Its values are sampled from a uniform distribution with bounds lower and upper.

@@ -802,8 +803,8 @@

3.1 Integer hyperparameters -
-class ConfigSpace.hyperparameters.NormalIntegerHyperparameter
+
+class ConfigSpace.hyperparameters.NormalIntegerHyperparameter

An integer hyperparameter.

Its values are sampled from a normal distribution \(\mathcal{N}(\mu, \sigma^2)\).

@@ -835,12 +836,12 @@

3.1 Integer hyperparameters +

+

3.2 Float hyperparameters

-
-class ConfigSpace.hyperparameters.UniformFloatHyperparameter
+
+class ConfigSpace.hyperparameters.UniformFloatHyperparameter

A float hyperparameter.

Its values are sampled from a uniform distribution with values from lower to upper.

@@ -872,8 +873,8 @@

3.2 Float hyperparameters

-
-class ConfigSpace.hyperparameters.NormalFloatHyperparameter
+
+class ConfigSpace.hyperparameters.NormalFloatHyperparameter

A float hyperparameter.

Its values are sampled from a normal distribution \(\mathcal{N}(\mu, \sigma^2)\).

@@ -904,12 +905,12 @@

3.2 Float hyperparameters

-
-
+
+

3.3 Categorical hyperparameters

-
-class ConfigSpace.hyperparameters.CategoricalHyperparameter
+
+class ConfigSpace.hyperparameters.CategoricalHyperparameter

A categorical hyperparameter.

Its values are sampled from a set of values.

None is a forbidden value, please use a string constant instead and parse @@ -939,12 +940,12 @@

3.2 Float hyperparameters

-
-
+
+

3.4 OrdinalHyperparameters

-
-class ConfigSpace.hyperparameters.OrdinalHyperparameter
+
+class ConfigSpace.hyperparameters.OrdinalHyperparameter

An ordinal hyperparameter.

Its values are sampled form a sequence of values. The sequence of values from a ordinal hyperparameter is ordered.

@@ -973,12 +974,12 @@

3.4 OrdinalHyperparameters +

+

3.5 Constant

-
-class ConfigSpace.hyperparameters.Constant
+
+class ConfigSpace.hyperparameters.Constant

Representing a constant hyperparameter in the configuration space.

By sampling from the configuration space each time only a single, constant value will be drawn from this hyperparameter.

@@ -994,19 +995,19 @@

3.4 OrdinalHyperparameters +

+ +

Conditions

ConfigSpace can realize equal, not equal, less than, greater than and in conditions. Conditions can be combined by using the conjunctions and and or. To see how to use conditions, please take a look at the user guide.

-
+

4.1 EqualsCondition

-
-class ConfigSpace.conditions.EqualsCondition
+
+class ConfigSpace.conditions.EqualsCondition

Hyperparameter child is conditional on the parent hyperparameter being equal to value.

Example

@@ -1037,12 +1038,12 @@

4.1 EqualsCondition +

+

4.2 NotEqualsCondition

-
-class ConfigSpace.conditions.NotEqualsCondition
+
+class ConfigSpace.conditions.NotEqualsCondition

Hyperparameter child is conditional on the parent hyperparameter being not equal to value.

Example

@@ -1074,12 +1075,12 @@

4.1 EqualsCondition +

+

4.3 LessThanCondition

-
-class ConfigSpace.conditions.LessThanCondition
+
+class ConfigSpace.conditions.LessThanCondition

Hyperparameter child is conditional on the parent hyperparameter being less than value.

Example

@@ -1110,12 +1111,12 @@

4.1 EqualsCondition +

+

4.4 GreaterThanCondition

-
-class ConfigSpace.conditions.GreaterThanCondition
+
+class ConfigSpace.conditions.GreaterThanCondition

Hyperparameter child is conditional on the parent hyperparameter being greater than value.

Example

@@ -1146,12 +1147,12 @@

4.4 GreaterThanCondition

-
-
+
+

4.5 InCondition

-
-class ConfigSpace.conditions.InCondition
+
+class ConfigSpace.conditions.InCondition

Hyperparameter child is conditional on the parent hyperparameter being in a set of values.

Example

@@ -1182,12 +1183,12 @@

4.5 InCondition +

+

4.6 AndConjunction

-
-class ConfigSpace.conditions.AndConjunction
+
+class ConfigSpace.conditions.AndConjunction

By using the AndConjunction, constraints can easily be connected.

Example

The following example shows how two constraints with an @@ -1215,12 +1216,12 @@

4.6 AndConjunction +

+

4.7 OrConjunction

-
-class ConfigSpace.conditions.OrConjunction
+
+class ConfigSpace.conditions.OrConjunction

Similar to the AndConjunction, constraints can be combined by using the OrConjunction.

Example

@@ -1247,9 +1248,9 @@

4.7 OrConjunction +

+ +

Forbidden Clauses

ConfigSpace contains forbidden equal and forbidden in clauses. The ForbiddenEqualsClause and the ForbiddenInClause can forbid values to be @@ -1257,11 +1258,11 @@

4.7 OrConjunctionuser guide.

-
+

5.1 ForbiddenEqualsClause

-
-class ConfigSpace.ForbiddenEqualsClause(hyperparameter, value)
+
+class ConfigSpace.ForbiddenEqualsClause(hyperparameter, value)

A ForbiddenEqualsClause

It forbids a value from the value range of a hyperparameter to be equal to value.

@@ -1288,12 +1289,12 @@

5.1 ForbiddenEqualsClause

-
-
+

+

5.2 ForbiddenInClause

-
-class ConfigSpace.ForbiddenInClause(hyperparameter, values)
+
+class ConfigSpace.ForbiddenInClause(hyperparameter, values)

A ForbiddenInClause.

It forbids a value from the value range of a hyperparameter to be in a collection of values.

@@ -1324,12 +1325,12 @@

5.2 ForbiddenInClause +

+

5.3 ForbiddenAndConjunction

-
-class ConfigSpace.ForbiddenAndConjunction(*args)
+
+class ConfigSpace.ForbiddenAndConjunction(*args)

A ForbiddenAndConjunction.

The ForbiddenAndConjunction combines forbidden-clauses, which allows to build powerful constraints.

@@ -1355,20 +1356,20 @@

5.3 ForbiddenAndConjunction +

+ +

Serialization

ConfigSpace offers json, pcs and pcs_new writers/readers. These classes can serialize and deserialize configuration spaces. Serializing configuration spaces is useful to share configuration spaces across experiments, or use them in other tools, for example, to analyze hyperparameter importance with CAVE.

-
+

6.1 Serialization to JSON

-
-ConfigSpace.read_and_write.json.read(jason_string)[source]
+
+ConfigSpace.read_and_write.json.read(jason_string)[source]

Create a configuration space definition from a json string.

Example

>>> from ConfigSpace.read_and_write import json
@@ -1391,8 +1392,8 @@ 
5.3 ForbiddenAndConjunction
-

-ConfigSpace.read_and_write.json.write(configuration_space, indent=2)[source]

+

+ConfigSpace.read_and_write.json.write(configuration_space, indent=2)[source]

 
Create a string representation of a
 ConfigurationSpace in json format.
 This string can be written to file.

@@ -1426,8 +1427,8 @@ 
5.3 ForbiddenAndConjunction
+
+

6.2 Serialization with pcs-new

Pcs is a simple, human-readable file format for the description of an algorithm’s configurable parameters, their possible values, as well as any @@ -1446,8 +1447,8 @@

5.3 ForbiddenAndConjunctionpcs module.

-
-ConfigSpace.read_and_write.pcs_new.read(pcs_string, debug=False)[source]
+
+ConfigSpace.read_and_write.pcs_new.read(pcs_string, debug=False)[source]

Read in a ConfigurationSpace definition from a pcs file.

Example

@@ -1473,8 +1474,8 @@

5.3 ForbiddenAndConjunction -
-ConfigSpace.read_and_write.pcs_new.write(configuration_space)[source]
+
+ConfigSpace.read_and_write.pcs_new.write(configuration_space)[source]

Create a string representation of a ConfigurationSpace in pcs_new format. This string can be written to file.

@@ -1504,12 +1505,12 @@

5.3 ForbiddenAndConjunction +

+

6.3 Serialization with pcs

-
-ConfigSpace.read_and_write.pcs.read(pcs_string, debug=False)[source]
+
+ConfigSpace.read_and_write.pcs.read(pcs_string, debug=False)[source]

Read in a ConfigurationSpace definition from a pcs file.

Example

@@ -1535,8 +1536,8 @@

5.3 ForbiddenAndConjunction -
-ConfigSpace.read_and_write.pcs.write(configuration_space)[source]
+
+ConfigSpace.read_and_write.pcs.write(configuration_space)[source]

Create a string representation of a ConfigurationSpace in pcs format. This string can be written to file.

@@ -1566,16 +1567,16 @@

5.3 ForbiddenAndConjunction +

+ +

Utils

Functions defined in the utils module can be helpful to develop custom tools that create configurations from a given configuration space or modify a given configuration space.

-
-ConfigSpace.util.deactivate_inactive_hyperparameters()
+
+ConfigSpace.util.deactivate_inactive_hyperparameters()

Remove inactive hyperparameters from a given configuration

Parameters
@@ -1602,8 +1603,8 @@

Utils

-
-ConfigSpace.util.fix_types()
+
+ConfigSpace.util.fix_types()

Iterate over all hyperparameters in the ConfigSpace and fix the types of the parameter values in configuration.

@@ -1624,8 +1625,8 @@

Utils

-
-ConfigSpace.util.generate_grid()
+
+ConfigSpace.util.generate_grid()

Generates a grid of Configurations for a given ConfigurationSpace. Can be used, for example, for grid search.

@@ -1654,8 +1655,8 @@

Utils

-
-ConfigSpace.util.get_one_exchange_neighbourhood()
+
+ConfigSpace.util.get_one_exchange_neighbourhood()

Return all configurations in a one-exchange neighborhood.

The method is implemented as defined by: Frank Hutter, Holger H. Hoos and Kevin Leyton-Brown @@ -1685,8 +1686,8 @@

Utils

-
-ConfigSpace.util.get_random_neighbor()
+
+ConfigSpace.util.get_random_neighbor()

Draw a random neighbor by changing one parameter of a configuration.

  • If the parameter is categorical, it changes it to another value.

    • @@ -1715,8 +1716,8 @@

    Utils

-
-ConfigSpace.util.impute_inactive_values()
+
+ConfigSpace.util.impute_inactive_values()

Impute inactive parameters.

Iterate through the hyperparameters of a Configuration and set the values of the inactive hyperparamters to their default values if the choosen @@ -1742,8 +1743,8 @@

Utils

-
-
+ + @@ -1765,7 +1766,7 @@

Utils

© Copyright 2014-2021, Matthias Feurer, Katharina Eggensperger, Syed Mohsin Ali, Christina Hernandez Wunsch, Julien-Charles Levesque, Jost Tobias Springenberg, Philipp Mueller, Marius Lindauer, Jorn Tuyls.
- Created using Sphinx 3.5.4.
+ Created using Sphinx 4.0.2.

diff --git a/master/User-Guide.html b/master/User-Guide.html index 69168729..a418e3e4 100644 --- a/master/User-Guide.html +++ b/master/User-Guide.html @@ -3,15 +3,16 @@ - + + User Guide — ConfigSpace documentation - - - + + + - + @@ -136,14 +137,14 @@
-
+

User Guide

In this user guide, the concepts of using different hyperparameters, applying conditions and forbidden clauses to a configuration space are explained.

These concepts will be introduced by defining a more complex configuration space for a support vector machine.

-
+

1st Example: Integer hyperparameters and float hyperparameters

Assume that we want to use a support vector machine (=SVM) for classification tasks and therefore, we want to optimize its hyperparameters:

@@ -197,8 +198,8 @@

1st Example: Integer hyperparameters and float hyperparameters42

-
-
+ +

2nd Example: Categorical hyperparameters and conditions

The scikit-learn SVM supports different kernels, such as an RBF, a sigmoid, a linear or a polynomial kernel. We want to include them in the configuration space. @@ -282,8 +283,8 @@

2nd Example: Categorical hyperparameters and conditionsEqualsCondition is evaluated to True.

- -
+ +

3rd Example: Forbidden clauses

It may occur that some states in the configuration space are not allowed. ConfigSpace supports this functionality by offering Forbidden Clauses.

@@ -338,8 +339,8 @@

3rd Example: Forbidden clauses[(Forbidden: penalty == 'l1' && Forbidden: loss == 'hinge'), ...]

- -
+ +

4th Example Serialization

If you want to use the configuration space in another tool, such as CAVE, it is useful to store it to file. @@ -359,8 +360,8 @@

4th Example Serialization... restored_conf = json.read(json_string)

- - + + @@ -382,7 +383,7 @@

4th Example SerializationSphinx 3.5.4.
+ Created using Sphinx 4.0.2.

diff --git a/master/_modules/ConfigSpace/read_and_write/json.html b/master/_modules/ConfigSpace/read_and_write/json.html index ba4e6771..627751db 100644 --- a/master/_modules/ConfigSpace/read_and_write/json.html +++ b/master/_modules/ConfigSpace/read_and_write/json.html @@ -5,9 +5,9 @@ ConfigSpace.read_and_write.json — ConfigSpace documentation - - - + + + @@ -755,7 +755,7 @@

Source code for ConfigSpace.read_and_write.json

<

© Copyright 2014-2021, Matthias Feurer, Katharina Eggensperger, Syed Mohsin Ali, Christina Hernandez Wunsch, Julien-Charles Levesque, Jost Tobias Springenberg, Philipp Mueller, Marius Lindauer, Jorn Tuyls.
- Created using Sphinx 3.5.4.
+ Created using Sphinx 4.0.2.

diff --git a/master/_modules/ConfigSpace/read_and_write/pcs.html b/master/_modules/ConfigSpace/read_and_write/pcs.html index cbbdf1c0..fe9dd293 100644 --- a/master/_modules/ConfigSpace/read_and_write/pcs.html +++ b/master/_modules/ConfigSpace/read_and_write/pcs.html @@ -5,9 +5,9 @@ ConfigSpace.read_and_write.pcs — ConfigSpace documentation - - - + + + @@ -609,7 +609,7 @@

Source code for ConfigSpace.read_and_write.pcs

© Copyright 2014-2021, Matthias Feurer, Katharina Eggensperger, Syed Mohsin Ali, Christina Hernandez Wunsch, Julien-Charles Levesque, Jost Tobias Springenberg, Philipp Mueller, Marius Lindauer, Jorn Tuyls.
- Created using Sphinx 3.5.4.
+ Created using Sphinx 4.0.2.

diff --git a/master/_modules/ConfigSpace/read_and_write/pcs_new.html b/master/_modules/ConfigSpace/read_and_write/pcs_new.html index e27b5acc..1f3e7c8e 100644 --- a/master/_modules/ConfigSpace/read_and_write/pcs_new.html +++ b/master/_modules/ConfigSpace/read_and_write/pcs_new.html @@ -5,9 +5,9 @@ ConfigSpace.read_and_write.pcs_new — ConfigSpace documentation - - - + + + @@ -190,8 +190,11 @@

Source code for ConfigSpace.read_and_write.pcs_new

pp_e_notation = pyparsing.Combine(pp_floatorint + pp_eorE + pp_int) pp_number = pp_e_notation | pp_float | pp_int pp_numberorname = pp_number | pp_param_name -pp_log = pyparsing.Word("log") -pp_connective = pyparsing.Word("||" + "&&") +pp_log = pyparsing.Literal("log") +# A word matches each character as a set. So && is processed as & +# https://pythonhosted.org/pyparsing/pyparsing.Word-class.html +pp_connectiveOR = pyparsing.Literal("||") +pp_connectiveAND = pyparsing.Literal("&&") pp_choices = pp_param_name + pyparsing.Optional(pyparsing.OneOrMore("," + pp_param_name)) pp_sequence = pp_param_name + pyparsing.Optional(pyparsing.OneOrMore("," + pp_param_name)) pp_ord_param = pp_param_name + pp_param_type + "{" + pp_sequence + "}" + "[" + pp_param_name + "]" @@ -204,7 +207,7 @@

Source code for ConfigSpace.read_and_write.pcs_new

pyparsing.Optional('{') + pp_param_val + pyparsing.Optional('}') + \ pyparsing.Optional( pyparsing.OneOrMore( - pp_connective + pp_param_name + pp_param_operation + (pp_connectiveAND | pp_connectiveOR) + pp_param_name + pp_param_operation + pyparsing.Optional('{') + pp_param_val + pyparsing.Optional('}') ) ) @@ -767,7 +770,7 @@

Source code for ConfigSpace.read_and_write.pcs_new

Sphinx 3.5.4.
+ Created using Sphinx 4.0.2.

diff --git a/master/_modules/index.html b/master/_modules/index.html index 339b7e31..2ad36b50 100644 --- a/master/_modules/index.html +++ b/master/_modules/index.html @@ -5,9 +5,9 @@ Overview: module code — ConfigSpace documentation - - - + + + @@ -150,7 +150,7 @@

All modules for which code is available

© Copyright 2014-2021, Matthias Feurer, Katharina Eggensperger, Syed Mohsin Ali, Christina Hernandez Wunsch, Julien-Charles Levesque, Jost Tobias Springenberg, Philipp Mueller, Marius Lindauer, Jorn Tuyls.
- Created using Sphinx 3.5.4.
+ Created using Sphinx 4.0.2.

diff --git a/master/_static/basic.css b/master/_static/basic.css index b3bdc004..aa9df316 100644 --- a/master/_static/basic.css +++ b/master/_static/basic.css @@ -130,7 +130,7 @@ ul.search li a { font-weight: bold; } -ul.search li div.context { +ul.search li p.context { color: #888; margin: 2px 0 0 30px; text-align: left; @@ -508,6 +508,63 @@ table.hlist td { vertical-align: top; } +/* -- object description styles --------------------------------------------- */ + +.sig { + font-family: 'Consolas', 'Menlo', 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', monospace; +} + +.sig-name, code.descname { + background-color: transparent; + font-weight: bold; +} + +.sig-name { + font-size: 1.1em; +} + +code.descname { + font-size: 1.2em; +} + +.sig-prename, code.descclassname { + background-color: transparent; +} + +.optional { + font-size: 1.3em; +} + +.sig-paren { + font-size: larger; +} + +.sig-param.n { + font-style: italic; +} + +/* C++ specific styling */ + +.sig-inline.c-texpr, +.sig-inline.cpp-texpr { + font-family: unset; +} + +.sig.c .k, .sig.c .kt, +.sig.cpp .k, .sig.cpp .kt { + color: #0033B3; +} + +.sig.c .m, +.sig.cpp .m { + color: #1750EB; +} + +.sig.c .s, .sig.c .sc, +.sig.cpp .s, .sig.cpp .sc { + color: #067D17; +} + /* -- other body styles ----------------------------------------------------- */ @@ -634,14 +691,6 @@ dl.glossary dt { font-size: 1.1em; } -.optional { - font-size: 1.3em; -} - -.sig-paren { - font-size: larger; -} - .versionmodified { font-style: italic; } @@ -771,7 +820,11 @@ div.code-block-caption code { table.highlighttable td.linenos, span.linenos, div.doctest > div.highlight span.gp { /* gp: Generic.Prompt */ - user-select: none; + user-select: none; + -webkit-user-select: text; /* Safari fallback only */ + -webkit-user-select: none; /* Chrome/Safari */ + -moz-user-select: none; /* Firefox */ + -ms-user-select: none; /* IE10+ */ } div.code-block-caption span.caption-number { @@ -786,16 +839,6 @@ div.literal-block-wrapper { margin: 1em 0; } -code.descname { - background-color: transparent; - font-weight: bold; - font-size: 1.2em; -} - -code.descclassname { - background-color: transparent; -} - code.xref, a code { background-color: transparent; font-weight: bold; diff --git a/master/_static/searchtools.js b/master/_static/searchtools.js index 1a90152e..e09f9263 100644 --- a/master/_static/searchtools.js +++ b/master/_static/searchtools.js @@ -509,7 +509,7 @@ var Search = { var excerpt = ((start > 0) ? '...' : '') + $.trim(text.substr(start, 240)) + ((start + 240 - text.length) ? '...' : ''); - var rv = $('
').text(excerpt); + var rv = $('

').text(excerpt); $.each(hlwords, function() { rv = rv.highlightText(this, 'highlighted'); }); diff --git a/master/_static/underscore-1.12.0.js b/master/_static/underscore-1.13.1.js similarity index 94% rename from master/_static/underscore-1.12.0.js rename to master/_static/underscore-1.13.1.js index 3af6352e..ffd77af9 100644 --- a/master/_static/underscore-1.12.0.js +++ b/master/_static/underscore-1.13.1.js @@ -1,19 +1,19 @@ (function (global, factory) { typeof exports === 'object' && typeof module !== 'undefined' ? module.exports = factory() : typeof define === 'function' && define.amd ? define('underscore', factory) : - (global = global || self, (function () { + (global = typeof globalThis !== 'undefined' ? globalThis : global || self, (function () { var current = global._; var exports = global._ = factory(); exports.noConflict = function () { global._ = current; return exports; }; }())); }(this, (function () { - // Underscore.js 1.12.0 + // Underscore.js 1.13.1 // https://underscorejs.org - // (c) 2009-2020 Jeremy Ashkenas, DocumentCloud and Investigative Reporters & Editors + // (c) 2009-2021 Jeremy Ashkenas, Julian Gonggrijp, and DocumentCloud and Investigative Reporters & Editors // Underscore may be freely distributed under the MIT license. // Current version. - var VERSION = '1.12.0'; + var VERSION = '1.13.1'; // Establish the root object, `window` (`self`) in the browser, `global` // on the server, or `this` in some virtual machines. We use `self` @@ -170,7 +170,7 @@ var isArray = nativeIsArray || tagTester('Array'); // Internal function to check whether `key` is an own property name of `obj`. - function has(obj, key) { + function has$1(obj, key) { return obj != null && hasOwnProperty.call(obj, key); } @@ -181,7 +181,7 @@ (function() { if (!isArguments(arguments)) { isArguments = function(obj) { - return has(obj, 'callee'); + return has$1(obj, 'callee'); }; } }()); @@ -268,7 +268,7 @@ // Constructor is a special case. var prop = 'constructor'; - if (has(obj, prop) && !keys.contains(prop)) keys.push(prop); + if (has$1(obj, prop) && !keys.contains(prop)) keys.push(prop); while (nonEnumIdx--) { prop = nonEnumerableProps[nonEnumIdx]; @@ -284,7 +284,7 @@ if (!isObject(obj)) return []; if (nativeKeys) return nativeKeys(obj); var keys = []; - for (var key in obj) if (has(obj, key)) keys.push(key); + for (var key in obj) if (has$1(obj, key)) keys.push(key); // Ahem, IE < 9. if (hasEnumBug) collectNonEnumProps(obj, keys); return keys; @@ -318,24 +318,24 @@ // If Underscore is called as a function, it returns a wrapped object that can // be used OO-style. This wrapper holds altered versions of all functions added // through `_.mixin`. Wrapped objects may be chained. - function _(obj) { - if (obj instanceof _) return obj; - if (!(this instanceof _)) return new _(obj); + function _$1(obj) { + if (obj instanceof _$1) return obj; + if (!(this instanceof _$1)) return new _$1(obj); this._wrapped = obj; } - _.VERSION = VERSION; + _$1.VERSION = VERSION; // Extracts the result from a wrapped and chained object. - _.prototype.value = function() { + _$1.prototype.value = function() { return this._wrapped; }; // Provide unwrapping proxies for some methods used in engine operations // such as arithmetic and JSON stringification. - _.prototype.valueOf = _.prototype.toJSON = _.prototype.value; + _$1.prototype.valueOf = _$1.prototype.toJSON = _$1.prototype.value; - _.prototype.toString = function() { + _$1.prototype.toString = function() { return String(this._wrapped); }; @@ -370,8 +370,8 @@ // Internal recursive comparison function for `_.isEqual`. function deepEq(a, b, aStack, bStack) { // Unwrap any wrapped objects. - if (a instanceof _) a = a._wrapped; - if (b instanceof _) b = b._wrapped; + if (a instanceof _$1) a = a._wrapped; + if (b instanceof _$1) b = b._wrapped; // Compare `[[Class]]` names. var className = toString.call(a); if (className !== toString.call(b)) return false; @@ -463,7 +463,7 @@ while (length--) { // Deep compare each member key = _keys[length]; - if (!(has(b, key) && eq(a[key], b[key], aStack, bStack))) return false; + if (!(has$1(b, key) && eq(a[key], b[key], aStack, bStack))) return false; } } // Remove the first object from the stack of traversed objects. @@ -642,15 +642,15 @@ // Normalize a (deep) property `path` to array. // Like `_.iteratee`, this function can be customized. - function toPath(path) { + function toPath$1(path) { return isArray(path) ? path : [path]; } - _.toPath = toPath; + _$1.toPath = toPath$1; // Internal wrapper for `_.toPath` to enable minification. // Similar to `cb` for `_.iteratee`. - function toPath$1(path) { - return _.toPath(path); + function toPath(path) { + return _$1.toPath(path); } // Internal function to obtain a nested property in `obj` along `path`. @@ -668,19 +668,19 @@ // `undefined`, return `defaultValue` instead. // The `path` is normalized through `_.toPath`. function get(object, path, defaultValue) { - var value = deepGet(object, toPath$1(path)); + var value = deepGet(object, toPath(path)); return isUndefined(value) ? defaultValue : value; } // Shortcut function for checking if an object has a given property directly on // itself (in other words, not on a prototype). Unlike the internal `has` // function, this public version can also traverse nested properties. - function has$1(obj, path) { - path = toPath$1(path); + function has(obj, path) { + path = toPath(path); var length = path.length; for (var i = 0; i < length; i++) { var key = path[i]; - if (!has(obj, key)) return false; + if (!has$1(obj, key)) return false; obj = obj[key]; } return !!length; @@ -703,7 +703,7 @@ // Creates a function that, when passed an object, will traverse that object’s // properties down the given `path`, specified as an array of keys or indices. function property(path) { - path = toPath$1(path); + path = toPath(path); return function(obj) { return deepGet(obj, path); }; @@ -747,12 +747,12 @@ function iteratee(value, context) { return baseIteratee(value, context, Infinity); } - _.iteratee = iteratee; + _$1.iteratee = iteratee; // The function we call internally to generate a callback. It invokes // `_.iteratee` if overridden, otherwise `baseIteratee`. function cb(value, context, argCount) { - if (_.iteratee !== iteratee) return _.iteratee(value, context); + if (_$1.iteratee !== iteratee) return _$1.iteratee(value, context); return baseIteratee(value, context, argCount); } @@ -840,7 +840,7 @@ // By default, Underscore uses ERB-style template delimiters. Change the // following template settings to use alternative delimiters. - var templateSettings = _.templateSettings = { + var templateSettings = _$1.templateSettings = { evaluate: /<%([\s\S]+?)%>/g, interpolate: /<%=([\s\S]+?)%>/g, escape: /<%-([\s\S]+?)%>/g @@ -868,13 +868,20 @@ return '\\' + escapes[match]; } + // In order to prevent third-party code injection through + // `_.templateSettings.variable`, we test it against the following regular + // expression. It is intentionally a bit more liberal than just matching valid + // identifiers, but still prevents possible loopholes through defaults or + // destructuring assignment. + var bareIdentifier = /^\s*(\w|\$)+\s*$/; + // JavaScript micro-templating, similar to John Resig's implementation. // Underscore templating handles arbitrary delimiters, preserves whitespace, // and correctly escapes quotes within interpolated code. // NB: `oldSettings` only exists for backwards compatibility. function template(text, settings, oldSettings) { if (!settings && oldSettings) settings = oldSettings; - settings = defaults({}, settings, _.templateSettings); + settings = defaults({}, settings, _$1.templateSettings); // Combine delimiters into one regular expression via alternation. var matcher = RegExp([ @@ -903,8 +910,17 @@ }); source += "';\n"; - // If a variable is not specified, place data values in local scope. - if (!settings.variable) source = 'with(obj||{}){\n' + source + '}\n'; + var argument = settings.variable; + if (argument) { + // Insure against third-party code injection. (CVE-2021-23358) + if (!bareIdentifier.test(argument)) throw new Error( + 'variable is not a bare identifier: ' + argument + ); + } else { + // If a variable is not specified, place data values in local scope. + source = 'with(obj||{}){\n' + source + '}\n'; + argument = 'obj'; + } source = "var __t,__p='',__j=Array.prototype.join," + "print=function(){__p+=__j.call(arguments,'');};\n" + @@ -912,18 +928,17 @@ var render; try { - render = new Function(settings.variable || 'obj', '_', source); + render = new Function(argument, '_', source); } catch (e) { e.source = source; throw e; } var template = function(data) { - return render.call(this, data, _); + return render.call(this, data, _$1); }; // Provide the compiled source as a convenience for precompilation. - var argument = settings.variable || 'obj'; template.source = 'function(' + argument + '){\n' + source + '}'; return template; @@ -933,7 +948,7 @@ // is invoked with its parent as context. Returns the value of the final // child, or `fallback` if any child is undefined. function result(obj, path, fallback) { - path = toPath$1(path); + path = toPath(path); var length = path.length; if (!length) { return isFunction$1(fallback) ? fallback.call(obj) : fallback; @@ -959,7 +974,7 @@ // Start chaining a wrapped Underscore object. function chain(obj) { - var instance = _(obj); + var instance = _$1(obj); instance._chain = true; return instance; } @@ -993,7 +1008,7 @@ return bound; }); - partial.placeholder = _; + partial.placeholder = _$1; // Create a function bound to a given object (assigning `this`, and arguments, // optionally). @@ -1012,7 +1027,7 @@ var isArrayLike = createSizePropertyCheck(getLength); // Internal implementation of a recursive `flatten` function. - function flatten(input, depth, strict, output) { + function flatten$1(input, depth, strict, output) { output = output || []; if (!depth && depth !== 0) { depth = Infinity; @@ -1025,7 +1040,7 @@ if (isArrayLike(value) && (isArray(value) || isArguments$1(value))) { // Flatten current level of array or arguments object. if (depth > 1) { - flatten(value, depth - 1, strict, output); + flatten$1(value, depth - 1, strict, output); idx = output.length; } else { var j = 0, len = value.length; @@ -1042,7 +1057,7 @@ // are the method names to be bound. Useful for ensuring that all callbacks // defined on an object belong to it. var bindAll = restArguments(function(obj, keys) { - keys = flatten(keys, false, false); + keys = flatten$1(keys, false, false); var index = keys.length; if (index < 1) throw new Error('bindAll must be passed function names'); while (index--) { @@ -1057,7 +1072,7 @@ var memoize = function(key) { var cache = memoize.cache; var address = '' + (hasher ? hasher.apply(this, arguments) : key); - if (!has(cache, address)) cache[address] = func.apply(this, arguments); + if (!has$1(cache, address)) cache[address] = func.apply(this, arguments); return cache[address]; }; memoize.cache = {}; @@ -1074,7 +1089,7 @@ // Defers a function, scheduling it to run after the current call stack has // cleared. - var defer = partial(delay, _, 1); + var defer = partial(delay, _$1, 1); // Returns a function, that, when invoked, will only be triggered at most once // during a given window of time. Normally, the throttled function will run @@ -1420,7 +1435,7 @@ if (isFunction$1(path)) { func = path; } else { - path = toPath$1(path); + path = toPath(path); contextPath = path.slice(0, -1); path = path[path.length - 1]; } @@ -1562,7 +1577,7 @@ // Groups the object's values by a criterion. Pass either a string attribute // to group by, or a function that returns the criterion. var groupBy = group(function(result, value, key) { - if (has(result, key)) result[key].push(value); else result[key] = [value]; + if (has$1(result, key)) result[key].push(value); else result[key] = [value]; }); // Indexes the object's values by a criterion, similar to `_.groupBy`, but for @@ -1575,7 +1590,7 @@ // either a string attribute to count by, or a function that returns the // criterion. var countBy = group(function(result, value, key) { - if (has(result, key)) result[key]++; else result[key] = 1; + if (has$1(result, key)) result[key]++; else result[key] = 1; }); // Split a collection into two arrays: one whose elements all pass the given @@ -1618,7 +1633,7 @@ keys = allKeys(obj); } else { iteratee = keyInObj; - keys = flatten(keys, false, false); + keys = flatten$1(keys, false, false); obj = Object(obj); } for (var i = 0, length = keys.length; i < length; i++) { @@ -1636,7 +1651,7 @@ iteratee = negate(iteratee); if (keys.length > 1) context = keys[1]; } else { - keys = map(flatten(keys, false, false), String); + keys = map(flatten$1(keys, false, false), String); iteratee = function(value, key) { return !contains(keys, key); }; @@ -1681,14 +1696,14 @@ // Flatten out an array, either recursively (by default), or up to `depth`. // Passing `true` or `false` as `depth` means `1` or `Infinity`, respectively. - function flatten$1(array, depth) { - return flatten(array, depth, false); + function flatten(array, depth) { + return flatten$1(array, depth, false); } // Take the difference between one array and a number of other arrays. // Only the elements present in just the first array will remain. var difference = restArguments(function(array, rest) { - rest = flatten(rest, true, true); + rest = flatten$1(rest, true, true); return filter(array, function(value){ return !contains(rest, value); }); @@ -1734,7 +1749,7 @@ // Produce an array that contains the union: each distinct element from all of // the passed-in arrays. var union = restArguments(function(arrays) { - return uniq(flatten(arrays, true, true)); + return uniq(flatten$1(arrays, true, true)); }); // Produce an array that contains every item shared between all the @@ -1821,26 +1836,26 @@ // Helper function to continue chaining intermediate results. function chainResult(instance, obj) { - return instance._chain ? _(obj).chain() : obj; + return instance._chain ? _$1(obj).chain() : obj; } // Add your own custom functions to the Underscore object. function mixin(obj) { each(functions(obj), function(name) { - var func = _[name] = obj[name]; - _.prototype[name] = function() { + var func = _$1[name] = obj[name]; + _$1.prototype[name] = function() { var args = [this._wrapped]; push.apply(args, arguments); - return chainResult(this, func.apply(_, args)); + return chainResult(this, func.apply(_$1, args)); }; }); - return _; + return _$1; } // Add all mutator `Array` functions to the wrapper. each(['pop', 'push', 'reverse', 'shift', 'sort', 'splice', 'unshift'], function(name) { var method = ArrayProto[name]; - _.prototype[name] = function() { + _$1.prototype[name] = function() { var obj = this._wrapped; if (obj != null) { method.apply(obj, arguments); @@ -1855,7 +1870,7 @@ // Add all accessor `Array` functions to the wrapper. each(['concat', 'join', 'slice'], function(name) { var method = ArrayProto[name]; - _.prototype[name] = function() { + _$1.prototype[name] = function() { var obj = this._wrapped; if (obj != null) obj = method.apply(obj, arguments); return chainResult(this, obj); @@ -1909,12 +1924,12 @@ clone: clone, tap: tap, get: get, - has: has$1, + has: has, mapObject: mapObject, identity: identity, constant: constant, noop: noop, - toPath: toPath, + toPath: toPath$1, property: property, propertyOf: propertyOf, matcher: matcher, @@ -1997,7 +2012,7 @@ tail: rest, drop: rest, compact: compact, - flatten: flatten$1, + flatten: flatten, without: without, uniq: uniq, unique: uniq, @@ -2011,17 +2026,17 @@ range: range, chunk: chunk, mixin: mixin, - 'default': _ + 'default': _$1 }; // Default Export // Add all of the Underscore functions to the wrapper object. - var _$1 = mixin(allExports); + var _ = mixin(allExports); // Legacy Node.js API. - _$1._ = _$1; + _._ = _; - return _$1; + return _; }))); -//# sourceMappingURL=underscore.js.map +//# sourceMappingURL=underscore-umd.js.map diff --git a/master/_static/underscore.js b/master/_static/underscore.js index 166240ef..cf177d42 100644 --- a/master/_static/underscore.js +++ b/master/_static/underscore.js @@ -1,6 +1,6 @@ -!function(n,r){"object"==typeof exports&&"undefined"!=typeof module?module.exports=r():"function"==typeof define&&define.amd?define("underscore",r):(n=n||self,function(){var t=n._,e=n._=r();e.noConflict=function(){return n._=t,e}}())}(this,(function(){ -// Underscore.js 1.12.0 +!function(n,r){"object"==typeof exports&&"undefined"!=typeof module?module.exports=r():"function"==typeof define&&define.amd?define("underscore",r):(n="undefined"!=typeof globalThis?globalThis:n||self,function(){var t=n._,e=n._=r();e.noConflict=function(){return n._=t,e}}())}(this,(function(){ +// Underscore.js 1.13.1 // https://underscorejs.org -// (c) 2009-2020 Jeremy Ashkenas, DocumentCloud and Investigative Reporters & Editors +// (c) 2009-2021 Jeremy Ashkenas, Julian Gonggrijp, and DocumentCloud and Investigative Reporters & Editors // Underscore may be freely distributed under the MIT license. -var n="1.12.0",r="object"==typeof self&&self.self===self&&self||"object"==typeof global&&global.global===global&&global||Function("return this")()||{},t=Array.prototype,e=Object.prototype,u="undefined"!=typeof Symbol?Symbol.prototype:null,o=t.push,i=t.slice,a=e.toString,f=e.hasOwnProperty,c="undefined"!=typeof ArrayBuffer,l="undefined"!=typeof DataView,s=Array.isArray,p=Object.keys,v=Object.create,h=c&&ArrayBuffer.isView,y=isNaN,g=isFinite,d=!{toString:null}.propertyIsEnumerable("toString"),b=["valueOf","isPrototypeOf","toString","propertyIsEnumerable","hasOwnProperty","toLocaleString"],m=Math.pow(2,53)-1;function j(n,r){return r=null==r?n.length-1:+r,function(){for(var t=Math.max(arguments.length-r,0),e=Array(t),u=0;u=0&&t<=m}}function $(n){return function(r){return null==r?void 0:r[n]}}var G=$("byteLength"),H=J(G),Q=/\[object ((I|Ui)nt(8|16|32)|Float(32|64)|Uint8Clamped|Big(I|Ui)nt64)Array\]/;var X=c?function(n){return h?h(n)&&!q(n):H(n)&&Q.test(a.call(n))}:K(!1),Y=$("length");function Z(n,r){r=function(n){for(var r={},t=n.length,e=0;e":">",'"':""","'":"'","`":"`"},Kn=Ln(Cn),Jn=Ln(_n(Cn)),$n=tn.templateSettings={evaluate:/<%([\s\S]+?)%>/g,interpolate:/<%=([\s\S]+?)%>/g,escape:/<%-([\s\S]+?)%>/g},Gn=/(.)^/,Hn={"'":"'","\\":"\\","\r":"r","\n":"n","\u2028":"u2028","\u2029":"u2029"},Qn=/\\|'|\r|\n|\u2028|\u2029/g;function Xn(n){return"\\"+Hn[n]}var Yn=0;function Zn(n,r,t,e,u){if(!(e instanceof r))return n.apply(t,u);var o=Mn(n.prototype),i=n.apply(o,u);return _(i)?i:o}var nr=j((function(n,r){var t=nr.placeholder,e=function(){for(var u=0,o=r.length,i=Array(o),a=0;a1)er(a,r-1,t,e),u=e.length;else for(var f=0,c=a.length;f0&&(t=r.apply(this,arguments)),n<=1&&(r=null),t}}var cr=nr(fr,2);function lr(n,r,t){r=qn(r,t);for(var e,u=nn(n),o=0,i=u.length;o0?0:u-1;o>=0&&o0?a=o>=0?o:Math.max(o+f,a):f=o>=0?Math.min(o+1,f):o+f+1;else if(t&&o&&f)return e[o=t(e,u)]===u?o:-1;if(u!=u)return(o=r(i.call(e,a,f),C))>=0?o+a:-1;for(o=n>0?a:f-1;o>=0&&o0?0:i-1;for(u||(e=r[o?o[a]:a],a+=n);a>=0&&a=3;return r(n,Fn(t,u,4),e,o)}}var wr=_r(1),Ar=_r(-1);function xr(n,r,t){var e=[];return r=qn(r,t),mr(n,(function(n,t,u){r(n,t,u)&&e.push(n)})),e}function Sr(n,r,t){r=qn(r,t);for(var e=!tr(n)&&nn(n),u=(e||n).length,o=0;o=0}var Er=j((function(n,r,t){var e,u;return D(r)?u=r:(r=Nn(r),e=r.slice(0,-1),r=r[r.length-1]),jr(n,(function(n){var o=u;if(!o){if(e&&e.length&&(n=In(n,e)),null==n)return;o=n[r]}return null==o?o:o.apply(n,t)}))}));function Br(n,r){return jr(n,Rn(r))}function Nr(n,r,t){var e,u,o=-1/0,i=-1/0;if(null==r||"number"==typeof r&&"object"!=typeof n[0]&&null!=n)for(var a=0,f=(n=tr(n)?n:jn(n)).length;ao&&(o=e);else r=qn(r,t),mr(n,(function(n,t,e){((u=r(n,t,e))>i||u===-1/0&&o===-1/0)&&(o=n,i=u)}));return o}function Ir(n,r,t){if(null==r||t)return tr(n)||(n=jn(n)),n[Wn(n.length-1)];var e=tr(n)?En(n):jn(n),u=Y(e);r=Math.max(Math.min(r,u),0);for(var o=u-1,i=0;i1&&(e=Fn(e,r[1])),r=an(n)):(e=Pr,r=er(r,!1,!1),n=Object(n));for(var u=0,o=r.length;u1&&(t=r[1])):(r=jr(er(r,!1,!1),String),e=function(n,t){return!Mr(r,t)}),qr(n,e,t)}));function Wr(n,r,t){return i.call(n,0,Math.max(0,n.length-(null==r||t?1:r)))}function zr(n,r,t){return null==n||n.length<1?null==r||t?void 0:[]:null==r||t?n[0]:Wr(n,n.length-r)}function Lr(n,r,t){return i.call(n,null==r||t?1:r)}var Cr=j((function(n,r){return r=er(r,!0,!0),xr(n,(function(n){return!Mr(r,n)}))})),Kr=j((function(n,r){return Cr(n,r)}));function Jr(n,r,t,e){A(r)||(e=t,t=r,r=!1),null!=t&&(t=qn(t,e));for(var u=[],o=[],i=0,a=Y(n);ir?(e&&(clearTimeout(e),e=null),a=c,i=n.apply(u,o),e||(u=o=null)):e||!1===t.trailing||(e=setTimeout(f,l)),i};return c.cancel=function(){clearTimeout(e),a=0,e=u=o=null},c},debounce:function(n,r,t){var e,u,o=function(r,t){e=null,t&&(u=n.apply(r,t))},i=j((function(i){if(e&&clearTimeout(e),t){var a=!e;e=setTimeout(o,r),a&&(u=n.apply(this,i))}else e=or(o,r,this,i);return u}));return i.cancel=function(){clearTimeout(e),e=null},i},wrap:function(n,r){return nr(r,n)},negate:ar,compose:function(){var n=arguments,r=n.length-1;return function(){for(var t=r,e=n[r].apply(this,arguments);t--;)e=n[t].call(this,e);return e}},after:function(n,r){return function(){if(--n<1)return r.apply(this,arguments)}},before:fr,once:cr,findKey:lr,findIndex:pr,findLastIndex:vr,sortedIndex:hr,indexOf:gr,lastIndexOf:dr,find:br,detect:br,findWhere:function(n,r){return br(n,Dn(r))},each:mr,forEach:mr,map:jr,collect:jr,reduce:wr,foldl:wr,inject:wr,reduceRight:Ar,foldr:Ar,filter:xr,select:xr,reject:function(n,r,t){return xr(n,ar(qn(r)),t)},every:Sr,all:Sr,some:Or,any:Or,contains:Mr,includes:Mr,include:Mr,invoke:Er,pluck:Br,where:function(n,r){return xr(n,Dn(r))},max:Nr,min:function(n,r,t){var e,u,o=1/0,i=1/0;if(null==r||"number"==typeof r&&"object"!=typeof n[0]&&null!=n)for(var a=0,f=(n=tr(n)?n:jn(n)).length;ae||void 0===t)return 1;if(t=0&&t<=m}}function J(n){return function(r){return null==r?void 0:r[n]}}var G=J("byteLength"),H=K(G),Q=/\[object ((I|Ui)nt(8|16|32)|Float(32|64)|Uint8Clamped|Big(I|Ui)nt64)Array\]/;var X=c?function(n){return h?h(n)&&!q(n):H(n)&&Q.test(a.call(n))}:C(!1),Y=J("length");function Z(n,r){r=function(n){for(var r={},t=n.length,e=0;e":">",'"':""","'":"'","`":"`"},Cn=Ln($n),Kn=Ln(_n($n)),Jn=tn.templateSettings={evaluate:/<%([\s\S]+?)%>/g,interpolate:/<%=([\s\S]+?)%>/g,escape:/<%-([\s\S]+?)%>/g},Gn=/(.)^/,Hn={"'":"'","\\":"\\","\r":"r","\n":"n","\u2028":"u2028","\u2029":"u2029"},Qn=/\\|'|\r|\n|\u2028|\u2029/g;function Xn(n){return"\\"+Hn[n]}var Yn=/^\s*(\w|\$)+\s*$/;var Zn=0;function nr(n,r,t,e,u){if(!(e instanceof r))return n.apply(t,u);var o=Mn(n.prototype),i=n.apply(o,u);return _(i)?i:o}var rr=j((function(n,r){var t=rr.placeholder,e=function(){for(var u=0,o=r.length,i=Array(o),a=0;a1)ur(a,r-1,t,e),u=e.length;else for(var f=0,c=a.length;f0&&(t=r.apply(this,arguments)),n<=1&&(r=null),t}}var lr=rr(cr,2);function sr(n,r,t){r=qn(r,t);for(var e,u=nn(n),o=0,i=u.length;o0?0:u-1;o>=0&&o0?a=o>=0?o:Math.max(o+f,a):f=o>=0?Math.min(o+1,f):o+f+1;else if(t&&o&&f)return e[o=t(e,u)]===u?o:-1;if(u!=u)return(o=r(i.call(e,a,f),$))>=0?o+a:-1;for(o=n>0?a:f-1;o>=0&&o0?0:i-1;for(u||(e=r[o?o[a]:a],a+=n);a>=0&&a=3;return r(n,Fn(t,u,4),e,o)}}var Ar=wr(1),xr=wr(-1);function Sr(n,r,t){var e=[];return r=qn(r,t),jr(n,(function(n,t,u){r(n,t,u)&&e.push(n)})),e}function Or(n,r,t){r=qn(r,t);for(var e=!er(n)&&nn(n),u=(e||n).length,o=0;o=0}var Br=j((function(n,r,t){var e,u;return D(r)?u=r:(r=Nn(r),e=r.slice(0,-1),r=r[r.length-1]),_r(n,(function(n){var o=u;if(!o){if(e&&e.length&&(n=In(n,e)),null==n)return;o=n[r]}return null==o?o:o.apply(n,t)}))}));function Nr(n,r){return _r(n,Rn(r))}function Ir(n,r,t){var e,u,o=-1/0,i=-1/0;if(null==r||"number"==typeof r&&"object"!=typeof n[0]&&null!=n)for(var a=0,f=(n=er(n)?n:jn(n)).length;ao&&(o=e);else r=qn(r,t),jr(n,(function(n,t,e){((u=r(n,t,e))>i||u===-1/0&&o===-1/0)&&(o=n,i=u)}));return o}function Tr(n,r,t){if(null==r||t)return er(n)||(n=jn(n)),n[Wn(n.length-1)];var e=er(n)?En(n):jn(n),u=Y(e);r=Math.max(Math.min(r,u),0);for(var o=u-1,i=0;i1&&(e=Fn(e,r[1])),r=an(n)):(e=qr,r=ur(r,!1,!1),n=Object(n));for(var u=0,o=r.length;u1&&(t=r[1])):(r=_r(ur(r,!1,!1),String),e=function(n,t){return!Er(r,t)}),Ur(n,e,t)}));function zr(n,r,t){return i.call(n,0,Math.max(0,n.length-(null==r||t?1:r)))}function Lr(n,r,t){return null==n||n.length<1?null==r||t?void 0:[]:null==r||t?n[0]:zr(n,n.length-r)}function $r(n,r,t){return i.call(n,null==r||t?1:r)}var Cr=j((function(n,r){return r=ur(r,!0,!0),Sr(n,(function(n){return!Er(r,n)}))})),Kr=j((function(n,r){return Cr(n,r)}));function Jr(n,r,t,e){A(r)||(e=t,t=r,r=!1),null!=t&&(t=qn(t,e));for(var u=[],o=[],i=0,a=Y(n);ir?(e&&(clearTimeout(e),e=null),a=c,i=n.apply(u,o),e||(u=o=null)):e||!1===t.trailing||(e=setTimeout(f,l)),i};return c.cancel=function(){clearTimeout(e),a=0,e=u=o=null},c},debounce:function(n,r,t){var e,u,o,i,a,f=function(){var c=zn()-u;r>c?e=setTimeout(f,r-c):(e=null,t||(i=n.apply(a,o)),e||(o=a=null))},c=j((function(c){return a=this,o=c,u=zn(),e||(e=setTimeout(f,r),t&&(i=n.apply(a,o))),i}));return c.cancel=function(){clearTimeout(e),e=o=a=null},c},wrap:function(n,r){return rr(r,n)},negate:fr,compose:function(){var n=arguments,r=n.length-1;return function(){for(var t=r,e=n[r].apply(this,arguments);t--;)e=n[t].call(this,e);return e}},after:function(n,r){return function(){if(--n<1)return r.apply(this,arguments)}},before:cr,once:lr,findKey:sr,findIndex:vr,findLastIndex:hr,sortedIndex:yr,indexOf:gr,lastIndexOf:br,find:mr,detect:mr,findWhere:function(n,r){return mr(n,Dn(r))},each:jr,forEach:jr,map:_r,collect:_r,reduce:Ar,foldl:Ar,inject:Ar,reduceRight:xr,foldr:xr,filter:Sr,select:Sr,reject:function(n,r,t){return Sr(n,fr(qn(r)),t)},every:Or,all:Or,some:Mr,any:Mr,contains:Er,includes:Er,include:Er,invoke:Br,pluck:Nr,where:function(n,r){return Sr(n,Dn(r))},max:Ir,min:function(n,r,t){var e,u,o=1/0,i=1/0;if(null==r||"number"==typeof r&&"object"!=typeof n[0]&&null!=n)for(var a=0,f=(n=er(n)?n:jn(n)).length;ae||void 0===t)return 1;if(t Index — ConfigSpace documentation - - - + + + @@ -450,7 +450,7 @@

W

© Copyright 2014-2021, Matthias Feurer, Katharina Eggensperger, Syed Mohsin Ali, Christina Hernandez Wunsch, Julien-Charles Levesque, Jost Tobias Springenberg, Philipp Mueller, Marius Lindauer, Jorn Tuyls.
- Created using Sphinx 3.5.4.
+ Created using Sphinx 4.0.2.

diff --git a/master/index.html b/master/index.html index f8892a13..8f207e96 100644 --- a/master/index.html +++ b/master/index.html @@ -3,11 +3,12 @@ - + + Welcome to ConfigSpace’s documentation! — ConfigSpace documentation - - - + + + @@ -131,7 +132,7 @@
-
+

Welcome to ConfigSpace’s documentation!

ConfigSpace is a simple python package to manage configuration spaces for algorithm configuration and @@ -165,8 +166,8 @@

Welcome to ConfigSpace’s documentation! b, Value: 'blue'

- -
+ +

Installation

ConfigSpace requires Python 3.6 or higher.

ConfigSpace can be installed with pip:

@@ -183,8 +184,8 @@

Installation
conda install gxx_linux-64 gcc_linux-64

- -
+ +

Citing the ConfigSpace

@article{
     title   = {BOAH: A Tool Suite for Multi-Fidelity Bayesian Optimization & Analysis of Hyperparameters},
@@ -194,8 +195,8 @@ 
Citing the ConfigSpace
-
-
+ +

Contents

    @@ -222,7 +223,7 @@

    ContentsSphinx 3.5.4.
    + Created using Sphinx 4.0.2.

diff --git a/master/objects.inv b/master/objects.inv index 6ef51804..32026dd1 100644 Binary files a/master/objects.inv and b/master/objects.inv differ diff --git a/master/py-modindex.html b/master/py-modindex.html index 9fc38efb..6856aeec 100644 --- a/master/py-modindex.html +++ b/master/py-modindex.html @@ -5,9 +5,9 @@ Python Module Index — ConfigSpace documentation - - - + + + @@ -182,7 +182,7 @@

Python Module Index

© Copyright 2014-2021, Matthias Feurer, Katharina Eggensperger, Syed Mohsin Ali, Christina Hernandez Wunsch, Julien-Charles Levesque, Jost Tobias Springenberg, Philipp Mueller, Marius Lindauer, Jorn Tuyls.
- Created using Sphinx 3.5.4.
+ Created using Sphinx 4.0.2.

diff --git a/master/quickstart.html b/master/quickstart.html index 7f454d57..51c0340e 100644 --- a/master/quickstart.html +++ b/master/quickstart.html @@ -3,15 +3,16 @@ - + + Quickstart — ConfigSpace documentation - - - + + + - + @@ -133,7 +134,7 @@
-
+

Quickstart

A ConfigurationSpace is a data structure to describe the configuration space of an algorithm to tune. @@ -158,7 +159,7 @@

QuickstartConfigurationSpace for ridge regression. Note that the topics adding constraints, adding forbidden clauses and serialization are explained in the user guide.

-
+

Basic Usage

We take a look at a simple ridge regression, @@ -190,8 +191,8 @@

Basic Usageuser guide section. There are more information about hyperparameters, as well as an introduction to the powerful concepts of Conditions and Forbidden Clauses.

-

-

+ +
@@ -213,7 +214,7 @@

Basic UsageSphinx 3.5.4.
+ Created using Sphinx 4.0.2.

diff --git a/master/search.html b/master/search.html index 2325285b..284def1e 100644 --- a/master/search.html +++ b/master/search.html @@ -5,9 +5,9 @@ Search — ConfigSpace documentation - - - + + + @@ -175,7 +175,7 @@

Search

© Copyright 2014-2021, Matthias Feurer, Katharina Eggensperger, Syed Mohsin Ali, Christina Hernandez Wunsch, Julien-Charles Levesque, Jost Tobias Springenberg, Philipp Mueller, Marius Lindauer, Jorn Tuyls.
- Created using Sphinx 3.5.4.
+ Created using Sphinx 4.0.2.

diff --git a/master/searchindex.js b/master/searchindex.js index 2a8e76b4..456fa6a1 100644 --- a/master/searchindex.js +++ b/master/searchindex.js @@ -1 +1 @@ -Search.setIndex({docnames:["API-Doc","User-Guide","index","quickstart"],envversion:{"sphinx.domains.c":2,"sphinx.domains.changeset":1,"sphinx.domains.citation":1,"sphinx.domains.cpp":3,"sphinx.domains.index":1,"sphinx.domains.javascript":2,"sphinx.domains.math":2,"sphinx.domains.python":2,"sphinx.domains.rst":2,"sphinx.domains.std":2,"sphinx.ext.viewcode":1,sphinx:56},filenames:["API-Doc.rst","User-Guide.rst","index.rst","quickstart.rst"],objects:{"ConfigSpace.conditions":{AndConjunction:[0,0,1,""],EqualsCondition:[0,0,1,""],GreaterThanCondition:[0,0,1,""],InCondition:[0,0,1,""],LessThanCondition:[0,0,1,""],NotEqualsCondition:[0,0,1,""],OrConjunction:[0,0,1,""]},"ConfigSpace.configuration_space":{Configuration:[0,0,1,""],ConfigurationSpace:[0,0,1,""]},"ConfigSpace.configuration_space.Configuration":{get:[0,1,1,""],get_array:[0,1,1,""],get_dictionary:[0,1,1,""],is_valid_configuration:[0,1,1,""],keys:[0,1,1,""]},"ConfigSpace.configuration_space.ConfigurationSpace":{add_condition:[0,1,1,""],add_conditions:[0,1,1,""],add_configuration_space:[0,1,1,""],add_forbidden_clause:[0,1,1,""],add_forbidden_clauses:[0,1,1,""],add_hyperparameter:[0,1,1,""],add_hyperparameters:[0,1,1,""],check_configuration:[0,1,1,""],check_configuration_vector_representation:[0,1,1,""],generate_all_continuous_from_bounds:[0,1,1,""],get_active_hyperparameters:[0,1,1,""],get_all_conditional_hyperparameters:[0,1,1,""],get_all_unconditional_hyperparameters:[0,1,1,""],get_child_conditions_of:[0,1,1,""],get_children_of:[0,1,1,""],get_conditions:[0,1,1,""],get_default_configuration:[0,1,1,""],get_forbiddens:[0,1,1,""],get_hyperparameter:[0,1,1,""],get_hyperparameter_by_idx:[0,1,1,""],get_hyperparameter_names:[0,1,1,""],get_hyperparameters:[0,1,1,""],get_hyperparameters_dict:[0,1,1,""],get_idx_by_hyperparameter_name:[0,1,1,""],get_parent_conditions_of:[0,1,1,""],get_parents_of:[0,1,1,""],sample_configuration:[0,1,1,""],seed:[0,1,1,""]},"ConfigSpace.hyperparameters":{CategoricalHyperparameter:[0,0,1,""],Constant:[0,0,1,""],NormalFloatHyperparameter:[0,0,1,""],NormalIntegerHyperparameter:[0,0,1,""],OrdinalHyperparameter:[0,0,1,""],UniformFloatHyperparameter:[0,0,1,""],UniformIntegerHyperparameter:[0,0,1,""]},"ConfigSpace.read_and_write":{json:[0,2,0,"-"],pcs:[0,2,0,"-"],pcs_new:[0,2,0,"-"]},"ConfigSpace.read_and_write.json":{read:[0,3,1,""],write:[0,3,1,""]},"ConfigSpace.read_and_write.pcs":{read:[0,3,1,""],write:[0,3,1,""]},"ConfigSpace.read_and_write.pcs_new":{read:[0,3,1,""],write:[0,3,1,""]},"ConfigSpace.util":{deactivate_inactive_hyperparameters:[0,3,1,""],fix_types:[0,3,1,""],generate_grid:[0,3,1,""],get_one_exchange_neighbourhood:[0,3,1,""],get_random_neighbor:[0,3,1,""],impute_inactive_values:[0,3,1,""]},ConfigSpace:{ForbiddenAndConjunction:[0,0,1,""],ForbiddenEqualsClause:[0,0,1,""],ForbiddenInClause:[0,0,1,""],util:[0,2,0,"-"]}},objnames:{"0":["py","class","Python class"],"1":["py","method","Python method"],"2":["py","module","Python module"],"3":["py","function","Python function"]},objtypes:{"0":"py:class","1":"py:method","2":"py:module","3":"py:function"},terms:{"06756":2,"100":[0,1,2],"10000":0,"1234":[1,2,3],"159":0,"1908":2,"1915194503788923":3,"1e2":1,"1st":2,"2016":0,"2019":2,"2nd":2,"305":0,"3rd":2,"4th":2,"6169610992422154":1,"class":0,"default":[0,1,2,3],"final":0,"float":[2,3],"function":[0,1,2],"import":[0,1,2,3],"int":0,"m\u00fcller":2,"new":1,"return":0,"short":0,"true":[0,1],"while":0,And:3,But:1,For:[0,1,3],Its:0,Not:0,Pcs:0,The:[0,1,2,3],There:3,These:[0,1],Used:0,abl:0,about:[0,1,2,3],abov:0,abstractcondit:0,abstractforbiddencompon:0,access:[0,1],achiev:1,aclib:0,across:0,activ:0,add:[0,1,2,3],add_condit:[0,1],add_configuration_spac:0,add_forbidden_claus:[0,1],add_hyperparamet:[0,1,2,3],added:[0,1,3],adding:[0,3],addit:1,addition:2,after:0,again:1,algorithm:[0,2,3],all:[0,1,3],allow:[0,1],allow_inactive_with_valu:0,alpha:3,also:[0,1,3],alwai:[1,3],anaconda:2,analysi:2,analyz:0,ani:0,anoth:[0,1],apart:0,api:2,appli:1,approach:0,apt:2,arg:0,argument:1,around:0,arrai:0,articl:2,arxiv:2,assum:1,author:2,auto:[2,3],autom:3,automl:[0,2,3],base:0,basic:2,bayesian:2,becaus:1,been:0,being:[0,1],besid:2,between:[0,1,2],biedenkapp:2,blue:[0,2],boah:2,bohb:[2,3],bool:0,both:0,bound:0,brown:0,build:[0,2],cach:0,calcul:0,call:1,can:[0,1,2,3],cartesian:0,cat_hp:0,categor:[2,3],categoricalhyperparamet:[0,1,2],cave:[0,1],certain:[0,1],chang:0,check:0,check_configur:0,check_configuration_vector_represent:0,child:[0,1],children:0,choic:[0,1,2],choos:1,choosen:0,chosen:[1,3],classif:1,classifi:1,claus:[2,3],code:0,coef0:1,coeffici:1,collect:0,com:0,combin:[0,1],compar:0,compil:2,complex:1,comput:0,concept:[1,3],cond:0,cond_1:1,cond_2:1,cond_3:1,conda:2,condit:[2,3],conditioncompon:0,conf:1,confer:0,config:0,config_id:0,configspac:[0,1,3],configur:[1,2,3],configuration_spac:0,configurationspac:[1,2,3],conjunct:[0,1],connect:0,constant:1,constant_penalty_and_loss:1,constrain:1,constraint:[0,1,2,3],contain:[0,1,2],content:0,continu:[0,1,3],correspond:0,creat:[0,1,3],csh:[0,1,2,3],custom:0,cycl:0,cython:2,data:[0,3],date:2,deactiv:0,deactivate_inactive_hyperparamet:0,debug:0,default_valu:[0,1],defin:[0,1,3],definit:[0,1],degre:1,delimit:0,demonstr:[1,2,3],depend:0,describ:[1,3],descript:[0,2],deseri:0,deserialized_conf:0,desir:0,detail:0,determin:0,dev:2,develop:0,deviat:0,dict:0,dictionari:[0,1],differ:[1,2],digraph:0,distribut:0,divid:0,document:1,doesn:0,don:[0,1],draw:0,drawn:0,dual:1,due:1,dure:0,each:0,easili:[0,1],edg:0,effici:0,eggensperg:2,either:[0,1],element:0,els:0,end:0,equal:[0,1],equalscondit:1,equival:0,error:0,essenti:2,evalu:1,even:1,exampl:[0,2],except:0,exchang:0,exemplari:3,exist:0,experi:0,explain:[1,2,3],explan:0,express:1,factor:0,fals:[0,1,2],fast:1,featur:2,feurer:2,fidel:2,field:0,file:[0,1],find:[0,1],finit:1,first:[1,3],fix:0,fix_typ:0,floor:0,follow:[0,1,3],forbid:[0,1],forbidden:[2,3],forbidden_claus:0,forbidden_clause_a:0,forbidden_clause_b:0,forbiddenandconjunct:1,forbiddenequalsclaus:1,form:[0,1],format:[0,1,2],found:0,frank:0,free:3,from:[0,1,3],further:[0,1],furthermor:[1,2],gamma:1,gcc_linux:2,gener:0,generate_all_continuous_from_bound:0,generate_grid:0,get:[0,2],get_active_hyperparamet:0,get_all_conditional_hyperparamet:0,get_all_unconditional_hyperparamet:0,get_arrai:0,get_child_conditions_of:0,get_children_of:0,get_condit:0,get_default_configur:0,get_dictionari:0,get_forbidden:0,get_hyperparamet:0,get_hyperparameter_by_idx:0,get_hyperparameter_nam:0,get_hyperparameters_dict:0,get_idx_by_hyperparameter_nam:0,get_one_exchange_neighbourhood:0,get_parent_conditions_of:0,get_parents_of:0,get_random_neighbor:0,github:0,give:0,given:0,good:1,greater:0,greater_cond:0,greaterthancondit:1,green:[0,2],grid:0,group:2,grow:1,guid:[0,2,3],gxx_linux:2,has:[0,1,2,3],have:[0,1,3],header:2,heavi:3,help:0,here:[0,1],higher:[0,2],hing:1,hold:0,holger:0,homepag:2,hoo:0,how:[0,2,3],http:0,human:0,hutter:[0,2],hyperparamet:[2,3],hyperparameter_nam:0,hyperparamt:0,idx:0,implement:[0,1],imput:0,impute_inactive_valu:0,inaccuraci:1,inact:0,inactiv:0,includ:[0,1,2,3],incondit:1,indent:0,independ:1,inform:[0,3],input:0,insert:1,instanc:[0,1],instead:0,integ:2,intellig:0,intern:0,introduc:[1,2],introduct:3,involv:1,is_valid_configur:0,issu:0,item:0,iter:[0,1],its:[0,1,2],jason_str:0,journal:2,json:1,json_str:1,just:1,keep:0,kei:0,kernel:1,kernel_typ:1,kevin:0,know:0,last:1,later:2,learn:[0,1,3],legal:0,less:0,less_cond:0,lessthancondit:1,leyton:0,librari:0,like:0,limit:1,lindauer:2,linear:1,lion:0,list:0,log:[0,1,2],logarithm:0,look:[0,1,3],loss:1,lot:1,lower:[0,1,2,3],machin:[1,3],made:0,mai:1,make:[0,1,3],manag:2,marben:2,mathbb:1,mathcal:[0,1],max_it:1,maximum:1,mean:[0,1],met:[0,1],meta:0,method:0,miniconda:2,model:0,modifi:[0,1],modul:[0,2,3],more:[0,1,2,3],multi:2,multipl:1,must:[0,1],name:[0,1,3],ndarrai:0,necessari:0,need:1,neg:0,neigbour:0,neighbor:0,neighborhood:0,neighbourhood:0,next:0,none:0,norm:1,normal:0,normal_float:0,normal_float_hp:0,normal_int:0,normal_int_hp:0,normalfloat:0,normalfloathyperparamet:0,normalinteg:0,normalintegerhyperparamet:0,note:3,notequalscondit:1,now:1,num_neighbor:0,num_steps_dict:0,number:[0,1],numer:3,numpi:[0,2],object:[0,1,3],observ:1,occur:1,offer:[0,1],often:2,old:0,old_nam:0,one:[0,3],onli:[0,1,3],open:[0,1],optim:[0,1,2],option:[0,3],orconjunct:1,ord_hp:0,order:[0,1],ordereddict:0,ordin:[0,3],ordinal_hp:0,org:2,organ:0,origin:0,other:0,otherwis:0,our:2,out:1,output:1,over:0,own:[0,3],packag:[0,2,3],pair:0,paramet:[0,1],parent:[0,1],parent_hyperparamet:0,pars:0,part:0,pcs:1,pcs_new:0,pcs_string:0,penal:1,penalti:1,penalty_and_du:1,penalty_and_loss:1,pip:2,pleas:[0,1],point:[0,1,3],poli:1,polynomi:1,possibl:[0,1,3],power:[0,3],prefix:0,previous:0,probabl:0,problem:1,proceed:0,process:0,product:0,program:0,project:2,provid:0,purpos:[1,3],pypars:2,pysmac:0,python3:2,python:[0,1,2],quantiz:0,quickli:1,quickstart:[0,2],rais:0,random:0,rang:[0,1,2,3],rbf:1,read:[0,1,2,3],read_and_writ:[0,1],readabl:0,reader:0,realiz:[0,1,3],red:[0,2],referenc:0,regress:3,regular:1,reject:0,relat:1,remov:0,renam:0,replac:0,repres:0,represant:0,represent:0,request:0,requir:2,restored_conf:1,restrict:[0,1],retriev:0,ridg:3,same:0,sampl:[0,1,3],sample_configur:[0,1,2,3],satisfi:0,scale:0,scikit:1,scope:1,search:[0,1],second:1,section:[2,3],see:[0,2],seed:[0,1,2,3],select:3,sens:1,sequenc:0,sequenti:0,serial:[2,3],set:[0,2,3],share:0,should:0,show:[0,3],shown:[0,1],side:0,sigma:0,sigmoid:1,signific:1,similar:[0,1],simpl:[0,1,2,3],sinc:1,singl:0,situat:0,size:0,sklearn:[1,2,3],smac3:[2,3],smac:0,solv:1,solver:1,some:1,sourc:0,space:[0,1,2,3],specifi:[0,1],speed:0,split:0,squared_hing:1,standard:0,state:[0,1],statement:0,stdev:0,step:[1,3],store:[0,1],str:0,strategi:0,string:0,structur:[0,3],subset:0,sudo:2,suit:2,summari:0,support:[0,1],sure:1,svm:1,take:[0,1,3],taken:0,task:[1,2],term:1,text:2,than:0,thei:0,them:[0,1],therefor:1,thi:[0,1,2,3],third:1,those:[1,2,3],three:1,through:0,thu:1,time:0,titl:2,togeth:1,tool:[0,1,2,3],toolkit:3,topic:3,track:0,translat:2,tree:0,tune:[1,3],tupl:0,tutori:3,two:0,type:[0,1,2,3],ubuntu:2,uncondit:0,underli:0,uni_float:0,uni_int:0,unicod:0,uniform:0,uniform_float_hp:0,uniform_integer_hp:0,uniformfloat:[0,1,3],uniformfloathyperparamet:[0,1,3],uniforminteg:[0,2],uniformintegerhyperparamet:[0,1,2],union:0,unlik:1,upper:[0,1,2,3],usag:[0,1,2],use:[0,1,2,3],used:[0,1,2],useful:[0,1],user:[0,2,3],uses:0,using:[0,1,2,3],util:2,valid:[0,1],valu:[0,1,2,3],valueerror:0,variou:2,vector:[0,1],veri:1,version:0,visit:[2,3],wai:3,want:1,weight:0,well:[0,1,3],were:0,what:3,when:2,where:0,whether:0,which:[0,1,3],whitespac:0,within:[0,1],work:1,write:[0,1],writer:0,written:0,year:0,you:[1,2,3],your:[0,3],zero:0},titles:["API-Documentation","User Guide","Welcome to ConfigSpace\u2019s documentation!","Quickstart"],titleterms:{"1st":1,"2nd":1,"3rd":1,"4th":1,"float":[0,1],"new":0,andconjunct:0,api:0,basic:3,categor:[0,1],cite:2,claus:[0,1],condit:[0,1],configspac:2,configur:0,configurationspac:0,constant:0,content:2,document:[0,2],equalscondit:0,exampl:1,forbidden:[0,1],forbiddenandconjunct:0,forbiddenequalsclaus:0,forbiddeninclaus:0,greaterthancondit:0,guid:1,hyperparamet:[0,1],incondit:0,instal:2,integ:[0,1],json:0,lessthancondit:0,notequalscondit:0,orconjunct:0,ordinalhyperparamet:0,pcs:0,quickstart:3,serial:[0,1],usag:3,user:1,util:0,welcom:2}}) \ No newline at end of file +Search.setIndex({docnames:["API-Doc","User-Guide","index","quickstart"],envversion:{"sphinx.domains.c":2,"sphinx.domains.changeset":1,"sphinx.domains.citation":1,"sphinx.domains.cpp":3,"sphinx.domains.index":1,"sphinx.domains.javascript":2,"sphinx.domains.math":2,"sphinx.domains.python":3,"sphinx.domains.rst":2,"sphinx.domains.std":2,"sphinx.ext.viewcode":1,sphinx:56},filenames:["API-Doc.rst","User-Guide.rst","index.rst","quickstart.rst"],objects:{"ConfigSpace.conditions":{AndConjunction:[0,0,1,""],EqualsCondition:[0,0,1,""],GreaterThanCondition:[0,0,1,""],InCondition:[0,0,1,""],LessThanCondition:[0,0,1,""],NotEqualsCondition:[0,0,1,""],OrConjunction:[0,0,1,""]},"ConfigSpace.configuration_space":{Configuration:[0,0,1,""],ConfigurationSpace:[0,0,1,""]},"ConfigSpace.configuration_space.Configuration":{get:[0,1,1,""],get_array:[0,1,1,""],get_dictionary:[0,1,1,""],is_valid_configuration:[0,1,1,""],keys:[0,1,1,""]},"ConfigSpace.configuration_space.ConfigurationSpace":{add_condition:[0,1,1,""],add_conditions:[0,1,1,""],add_configuration_space:[0,1,1,""],add_forbidden_clause:[0,1,1,""],add_forbidden_clauses:[0,1,1,""],add_hyperparameter:[0,1,1,""],add_hyperparameters:[0,1,1,""],check_configuration:[0,1,1,""],check_configuration_vector_representation:[0,1,1,""],generate_all_continuous_from_bounds:[0,1,1,""],get_active_hyperparameters:[0,1,1,""],get_all_conditional_hyperparameters:[0,1,1,""],get_all_unconditional_hyperparameters:[0,1,1,""],get_child_conditions_of:[0,1,1,""],get_children_of:[0,1,1,""],get_conditions:[0,1,1,""],get_default_configuration:[0,1,1,""],get_forbiddens:[0,1,1,""],get_hyperparameter:[0,1,1,""],get_hyperparameter_by_idx:[0,1,1,""],get_hyperparameter_names:[0,1,1,""],get_hyperparameters:[0,1,1,""],get_hyperparameters_dict:[0,1,1,""],get_idx_by_hyperparameter_name:[0,1,1,""],get_parent_conditions_of:[0,1,1,""],get_parents_of:[0,1,1,""],sample_configuration:[0,1,1,""],seed:[0,1,1,""]},"ConfigSpace.hyperparameters":{CategoricalHyperparameter:[0,0,1,""],Constant:[0,0,1,""],NormalFloatHyperparameter:[0,0,1,""],NormalIntegerHyperparameter:[0,0,1,""],OrdinalHyperparameter:[0,0,1,""],UniformFloatHyperparameter:[0,0,1,""],UniformIntegerHyperparameter:[0,0,1,""]},"ConfigSpace.read_and_write":{json:[0,2,0,"-"],pcs:[0,2,0,"-"],pcs_new:[0,2,0,"-"]},"ConfigSpace.read_and_write.json":{read:[0,3,1,""],write:[0,3,1,""]},"ConfigSpace.read_and_write.pcs":{read:[0,3,1,""],write:[0,3,1,""]},"ConfigSpace.read_and_write.pcs_new":{read:[0,3,1,""],write:[0,3,1,""]},"ConfigSpace.util":{deactivate_inactive_hyperparameters:[0,3,1,""],fix_types:[0,3,1,""],generate_grid:[0,3,1,""],get_one_exchange_neighbourhood:[0,3,1,""],get_random_neighbor:[0,3,1,""],impute_inactive_values:[0,3,1,""]},ConfigSpace:{ForbiddenAndConjunction:[0,0,1,""],ForbiddenEqualsClause:[0,0,1,""],ForbiddenInClause:[0,0,1,""],util:[0,2,0,"-"]}},objnames:{"0":["py","class","Python class"],"1":["py","method","Python method"],"2":["py","module","Python module"],"3":["py","function","Python function"]},objtypes:{"0":"py:class","1":"py:method","2":"py:module","3":"py:function"},terms:{"0":[0,1,3],"06756":2,"1":[1,3],"10":[0,1,2],"100":[0,1,2],"10000":0,"1234":[1,2,3],"15":0,"159":0,"1908":2,"1915194503788923":3,"1e":1,"1e2":1,"1st":2,"2":1,"20":0,"2016":0,"2019":2,"27":[0,2],"2nd":2,"3":2,"30":0,"305":0,"3rd":2,"4":1,"42":1,"4th":2,"5":[1,3],"55":[0,2],"6":2,"6169610992422154":1,"64":2,"66":1,"8":0,"class":0,"default":[0,1,2,3],"final":0,"float":[2,3],"function":[0,1,2],"import":[0,1,2,3],"int":0,"m\u00fcller":2,"new":1,"return":0,"short":0,"true":[0,1],"while":0,A:[0,2,3],And:3,As:[0,1],But:1,By:0,For:[0,1,3],If:[0,1],In:[0,1,2],It:[0,1,2],Its:0,Not:0,On:2,The:[0,1,2,3],There:3,These:[0,1],To:[0,1,2,3],_:0,abl:0,about:[0,1,2,3],abov:0,abstractcondit:0,abstractforbiddencompon:0,access:[0,1],achiev:1,aclib:0,across:0,activ:0,ad:[0,1,3],add:[0,1,2,3],add_condit:[0,1],add_configuration_spac:0,add_forbidden_claus:[0,1],add_hyperparamet:[0,1,2,3],addit:1,addition:2,after:0,again:1,algorithm:[0,2,3],all:[0,1,3],allow:[0,1],allow_inactive_with_valu:0,alpha:3,also:[0,1,3],alwai:[1,3],an:[0,1,3],anaconda:2,analysi:2,analyz:0,ani:0,anoth:[0,1],apart:0,api:2,appli:1,approach:0,apt:2,ar:[0,1,2,3],arg:0,argument:1,around:0,arrai:0,articl:2,arxiv:2,assum:1,author:2,auto:[2,3],autom:3,automl:[0,2,3],b:[0,2],base:0,basic:2,bayesian:2,becaus:1,been:0,being:[0,1],besid:2,between:[0,1,2],biedenkapp:2,blue:[0,2],boah:2,bohb:[2,3],bool:0,both:0,bound:0,brown:0,build:[0,2],c:[0,1,2],cach:0,calcul:0,call:1,can:[0,1,2,3],cartesian:0,cat_hp:0,categor:[2,3],categoricalhyperparamet:[0,1,2],cave:[0,1],certain:[0,1],chang:0,check:0,check_configur:0,check_configuration_vector_represent:0,child:[0,1],children:0,choic:[0,1,2],choos:1,choosen:0,chosen:[1,3],classif:1,classifi:1,claus:[2,3],code:0,coef0:1,coeffici:1,collect:0,com:0,combin:[0,1],compar:0,compil:2,complex:1,comput:0,concept:[1,3],cond:0,cond_1:1,cond_2:1,cond_3:1,conda:2,condit:[2,3],conditioncompon:0,conf:1,confer:0,config:0,config_id:0,configspac:[0,1,3],configur:[1,2,3],configuration_spac:0,configurationspac:[1,2,3],conjunct:[0,1],connect:0,constant:1,constant_penalty_and_loss:1,constrain:1,constraint:[0,1,2,3],contain:[0,1,2],content:0,continu:[0,1,3],correspond:0,creat:[0,1,3],cs:[0,1,2,3],csh:[0,1,2,3],custom:0,cycl:0,cython:2,data:[0,3],date:2,deactiv:0,deactivate_inactive_hyperparamet:0,debug:0,default_valu:[0,1],defin:[0,1,3],definit:[0,1],degre:1,delimit:0,demonstr:[1,2,3],depend:0,describ:[1,3],descript:[0,2],deseri:0,deserialized_conf:0,desir:0,detail:0,determin:0,dev:2,develop:0,deviat:0,dict:0,dictionari:[0,1],differ:[1,2],digraph:0,distribut:0,divid:0,document:1,doesn:0,don:[0,1],draw:0,drawn:0,dual:1,due:1,dure:0,each:0,easili:[0,1],edg:0,effici:0,eggensperg:2,either:[0,1],element:0,els:0,end:0,equal:[0,1],equalscondit:1,equival:0,error:0,essenti:2,evalu:1,even:1,exampl:[0,2],except:0,exchang:0,exemplari:3,exist:0,experi:0,explain:[1,2,3],explan:0,express:1,f:[0,2],factor:0,fals:[0,1,2],fast:1,featur:2,feurer:2,fh:[0,1],fidel:2,field:0,file:[0,1],find:[0,1],finit:1,first:[1,3],fix:0,fix_typ:0,floor:0,follow:[0,1,3],forbid:[0,1],forbidden:[2,3],forbidden_claus:0,forbidden_clause_a:0,forbidden_clause_b:0,forbiddenandconjunct:1,forbiddenequalsclaus:1,form:[0,1],format:[0,1,2],found:0,frank:0,free:3,from:[0,1,3],further:[0,1],furthermor:[1,2],gamma:1,gcc_linux:2,gener:0,generate_all_continuous_from_bound:0,generate_grid:0,get:[0,2],get_active_hyperparamet:0,get_all_conditional_hyperparamet:0,get_all_unconditional_hyperparamet:0,get_arrai:0,get_child_conditions_of:0,get_children_of:0,get_condit:0,get_default_configur:0,get_dictionari:0,get_forbidden:0,get_hyperparamet:0,get_hyperparameter_by_idx:0,get_hyperparameter_nam:0,get_hyperparameters_dict:0,get_idx_by_hyperparameter_nam:0,get_one_exchange_neighbourhood:0,get_parent_conditions_of:0,get_parents_of:0,get_random_neighbor:0,github:0,give:0,given:0,good:1,greater:0,greater_cond:0,greaterthancondit:1,green:[0,2],grid:0,group:2,grow:1,guid:[0,2,3],gxx_linux:2,h:0,ha:[0,1,2,3],have:[0,1,3],header:2,heavi:3,help:0,here:[0,1],higher:[0,2],hing:1,hold:0,holger:0,homepag:2,hoo:0,how:[0,2,3],http:0,human:0,hutter:[0,2],hyperparamet:[2,3],hyperparameter_nam:0,hyperparamt:0,id:0,idx:0,implement:[0,1],imput:0,impute_inactive_valu:0,inaccuraci:1,inact:0,inactiv:0,includ:[0,1,2,3],incondit:1,indent:0,independ:1,inform:[0,3],input:0,insert:1,instanc:[0,1],instead:0,integ:2,intellig:0,intern:0,introduc:[1,2],introduct:3,involv:1,is_valid_configur:0,issu:0,item:0,iter:[0,1],its:[0,1,2],j:2,jason_str:0,journal:2,json:1,json_str:1,just:1,k:2,keep:0,kei:0,kernel:1,kernel_typ:1,kevin:0,know:0,l1:1,l2:1,last:1,later:2,learn:[0,1,3],legal:0,less:0,less_cond:0,lessthancondit:1,leyton:0,lg:2,librari:0,like:0,limit:1,lindauer:2,linear:1,lion:0,list:0,log:[0,1,2],logarithm:0,look:[0,1,3],loss:1,lot:1,lower:[0,1,2,3],m:2,machin:[1,3],made:0,mai:1,make:[0,1,3],manag:2,marben:2,mathbb:1,mathcal:[0,1],max_it:1,maximum:1,mean:[0,1],met:[0,1],meta:0,method:0,miniconda:2,model:0,modifi:[0,1],modul:[0,2,3],more:[0,1,2,3],mu:0,multi:2,multipl:1,must:[0,1],n:[0,1],name:[0,1,3],ndarrai:0,necessari:0,need:1,neg:0,neigbour:0,neighbor:0,neighborhood:0,neighbourhood:0,next:0,none:0,norm:1,normal:0,normal_float:0,normal_float_hp:0,normal_int:0,normal_int_hp:0,normalfloat:0,normalfloathyperparamet:0,normalinteg:0,normalintegerhyperparamet:0,note:3,notequalscondit:1,now:1,np:0,num_neighbor:0,num_steps_dict:0,number:[0,1],numer:3,numpi:[0,2],object:[0,1,3],observ:1,occur:1,offer:[0,1],often:2,old:0,old_nam:0,one:[0,3],onli:[0,1,3],open:[0,1],optim:[0,1,2],option:[0,3],orconjunct:1,ord_hp:0,order:[0,1],ordereddict:0,ordin:[0,3],ordinal_hp:0,org:2,organ:0,origin:0,other:0,otherwis:0,our:2,out:1,output:1,over:0,own:[0,3],p:2,packag:[0,2,3],pair:0,paramet:[0,1],parent:[0,1],parent_hyperparamet:0,pars:0,part:0,pc:1,pcs_new:0,pcs_string:0,penal:1,penalti:1,penalty_and_du:1,penalty_and_loss:1,pip:2,pleas:[0,1],point:[0,1,3],poli:1,polynomi:1,possibl:[0,1,3],power:[0,3],prefix:0,previous:0,probabl:0,problem:1,proceed:0,process:0,product:0,program:0,project:2,provid:0,purpos:[1,3],pypars:2,pysmac:0,python3:2,python:[0,1,2],q:0,quantiz:0,quickli:1,quickstart:[0,2],r:[0,1],rais:0,random:0,rang:[0,1,2,3],rbf:1,read:[0,1,2,3],read_and_writ:[0,1],readabl:0,reader:0,realiz:[0,1,3],red:[0,2],referenc:0,regress:3,regular:1,reject:0,relat:1,remov:0,renam:0,replac:0,repres:0,represant:0,represent:0,request:0,requir:2,restored_conf:1,restrict:[0,1],retriev:0,ridg:3,s:[0,3],same:0,sampl:[0,1,3],sample_configur:[0,1,2,3],satisfi:0,scale:0,scikit:1,scope:1,search:[0,1],second:1,section:[2,3],see:[0,2],seed:[0,1,2,3],select:3,sens:1,sequenc:0,sequenti:0,serial:[2,3],set:[0,2,3],share:0,should:0,show:[0,3],shown:[0,1],side:0,sigma:0,sigmoid:1,signific:1,similar:[0,1],simpl:[0,1,2,3],sinc:1,singl:0,situat:0,size:0,sklearn:[1,2,3],smac3:[2,3],smac:0,solv:1,solver:1,some:1,sourc:0,space:[0,1,2,3],specifi:[0,1],speed:0,split:0,squared_hing:1,standard:0,state:[0,1],statement:0,stdev:0,step:[1,3],store:[0,1],str:0,strategi:0,string:0,structur:[0,3],subset:0,sudo:2,suit:2,summari:0,support:[0,1],sure:1,svm:1,t:[0,1],take:[0,1,3],taken:0,task:[1,2],term:1,text:2,than:0,thei:0,them:[0,1],therefor:1,thi:[0,1,2,3],third:1,those:[1,2,3],three:1,through:0,thu:1,time:0,titl:2,togeth:1,tool:[0,1,2,3],toolkit:3,topic:3,track:0,translat:2,tree:0,tune:[1,3],tupl:0,tutori:3,two:0,type:[0,1,2,3],ubuntu:2,uncondit:0,underli:0,uni_float:0,uni_int:0,unicod:0,uniform:0,uniform_float_hp:0,uniform_integer_hp:0,uniformfloat:[0,1,3],uniformfloathyperparamet:[0,1,3],uniforminteg:[0,2],uniformintegerhyperparamet:[0,1,2],union:0,unlik:1,up:[0,2,3],upper:[0,1,2,3],us:[0,1,2,3],usag:[0,1,2],user:[0,2,3],util:2,valid:[0,1],valu:[0,1,2,3],valueerror:0,variou:2,vector:[0,1],veri:1,version:0,visit:[2,3],w:[0,1],wa:0,wai:3,want:1,we:[1,3],weight:0,well:[0,1,3],were:0,what:3,when:2,where:0,whether:0,which:[0,1,3],whitespac:0,within:[0,1],work:1,write:[0,1],writer:0,written:0,year:0,you:[1,2,3],your:[0,3],zero:0},titles:["API-Documentation","User Guide","Welcome to ConfigSpace\u2019s documentation!","Quickstart"],titleterms:{"1":0,"1st":1,"2":0,"2nd":1,"3":0,"3rd":1,"4":0,"4th":1,"5":0,"6":0,"7":0,"float":[0,1],"new":0,andconjunct:0,api:0,basic:3,categor:[0,1],cite:2,claus:[0,1],condit:[0,1],configspac:2,configur:0,configurationspac:0,constant:0,content:2,document:[0,2],equalscondit:0,exampl:1,forbidden:[0,1],forbiddenandconjunct:0,forbiddenequalsclaus:0,forbiddeninclaus:0,greaterthancondit:0,guid:1,hyperparamet:[0,1],incondit:0,instal:2,integ:[0,1],json:0,lessthancondit:0,notequalscondit:0,orconjunct:0,ordinalhyperparamet:0,pc:0,quickstart:3,s:2,serial:[0,1],usag:3,user:1,util:0,welcom:2}}) \ No newline at end of file