From 38fb71f01afc0da37743c4762a8c9d6d8387f6c8 Mon Sep 17 00:00:00 2001 From: hrntsm Date: Fri, 5 Aug 2022 23:32:20 +0900 Subject: [PATCH 01/65] Add hypervolume visualization --- Tunny/Solver/Optuna/Optuna.cs | 72 +++++++++++++++++++++++++ Tunny/UI/OptimizationWindow.Designer.cs | 3 +- 2 files changed, 74 insertions(+), 1 deletion(-) diff --git a/Tunny/Solver/Optuna/Optuna.cs b/Tunny/Solver/Optuna/Optuna.cs index f65b8fa8..61d8ee0d 100644 --- a/Tunny/Solver/Optuna/Optuna.cs +++ b/Tunny/Solver/Optuna/Optuna.cs @@ -152,6 +152,9 @@ private static void ShowPlot(dynamic optuna, string visualize, dynamic study, st case "slice": vis = optuna.visualization.plot_slice(study, target_name: nickNames[0]); break; + case "hypervolume": + vis = PlotHypervolume(optuna, study); + break; default: TunnyMessageBox.Show("This visualization type is not supported in this study case.", "Tunny"); return; @@ -159,6 +162,75 @@ private static void ShowPlot(dynamic optuna, string visualize, dynamic study, st vis.show(); } + private static dynamic PlotHypervolume(dynamic optuna, dynamic study) + { + + var trials = (dynamic[])study.trials; + int objectivesCount = ((double[])trials[0].values).Length; + var trialValues = new List(); + foreach (dynamic trial in trials) + { + trialValues.Add((double[])trial.values); + } + double[] maxObjectiveValues = new double[objectivesCount]; + for (int i = 0; i < objectivesCount; i++) + { + maxObjectiveValues[i] = trialValues.Select(v => v[i]).Max(); + } + + PyList hvs = ComputeHypervolume(optuna, trials, maxObjectiveValues, out PyList trialNumbers); + return CreateFigure(trials, hvs, trialNumbers); + } + + private static PyList ComputeHypervolume(dynamic optuna, dynamic[] trials, double[] maxObjectiveValues, out PyList trialNumbers) + { + dynamic np = Py.Import("numpy"); + + var hvs = new PyList(); + var rpObj = new PyList(); + trialNumbers = new PyList(); + + foreach (double max in maxObjectiveValues) + { + rpObj.Append(new PyFloat(max)); + } + dynamic referencePoint = np.array(rpObj); + + dynamic wfg = optuna._hypervolume.WFG(); + for (int i = 1; i < trials.Length + 1; i++) + { + var vector = new PyList(); + for (int j = 0; j < i; j++) + { + vector.Append(trials[j].values); + } + hvs.Append(wfg.compute(np.array(vector), referencePoint)); + trialNumbers.Append(new PyInt(i)); + } + return hvs; + } + + private static dynamic CreateFigure(dynamic[] trials, PyList hvs, PyList trialNumbers) + { + dynamic go = Py.Import("plotly.graph_objects"); + + var plotItems = new PyDict(); + plotItems.SetItem("x", trialNumbers); + plotItems.SetItem("y", hvs); + + var plotRange = new PyDict(); + var rangeObj = new PyObject[] { new PyFloat(0), new PyFloat(trials.Length + 1) }; + plotRange.SetItem("range", new PyList(rangeObj)); + + dynamic fig = go.Figure(); + fig.add_trace(go.Scatter(plotItems, name: "Hyper Volume")); + fig.update_layout(xaxis: plotRange); + fig.update_xaxes(title_text: "#Trials"); + fig.update_yaxes(title_text: "Hyper Volume"); + + return fig; + } + public ModelResult[] GetModelResult(int[] resultNum, string studyName, BackgroundWorker worker) { string storage = "sqlite:///" + _settings.Storage; diff --git a/Tunny/UI/OptimizationWindow.Designer.cs b/Tunny/UI/OptimizationWindow.Designer.cs index a735e42d..49e6de32 100644 --- a/Tunny/UI/OptimizationWindow.Designer.cs +++ b/Tunny/UI/OptimizationWindow.Designer.cs @@ -321,7 +321,8 @@ private void InitializeComponent() "parallel coordinate", "param importances", "pareto front", - "slice"}); + "slice", + "hypervolume"}); this.visualizeTypeComboBox.Location = new System.Drawing.Point(33, 160); this.visualizeTypeComboBox.Margin = new System.Windows.Forms.Padding(4, 6, 4, 6); this.visualizeTypeComboBox.Name = "visualizeTypeComboBox"; From 40f55691d4a8cb19e40215d0d2dc13d9b2ae84e0 Mon Sep 17 00:00:00 2001 From: hrntsm Date: Fri, 5 Aug 2022 23:35:09 +0900 Subject: [PATCH 02/65] Update CHANGELOG --- CHANGELOG.md | 7 +++++++ 1 file changed, 7 insertions(+) diff --git a/CHANGELOG.md b/CHANGELOG.md index 4d75e5f7..8bdd7025 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -6,6 +6,13 @@ The format is based on [Keep a Changelog](http://keepachangelog.com/) and this p Please see [here](https://github.com/hrntsm/Tunny/releases) for the data released for each version. +## [UNRELEASED] + +### Added + +- Hypervolume visualization + - It is useful for determining convergence in multi-objective optimization. + ## [0.4.0] -2022-07-09 ### Added From a16444f6935270684b34d95357412744e3023e89 Mon Sep 17 00:00:00 2001 From: hrntsm Date: Sat, 6 Aug 2022 00:24:33 +0900 Subject: [PATCH 03/65] Add BoTorch sampler --- Tunny/Settings/BoTorch.cs | 10 ++++++++++ Tunny/Settings/Sampler.cs | 1 + Tunny/Solver/Optuna/Algorithm.cs | 9 ++++++--- Tunny/Solver/Optuna/Sampler.cs | 9 +++++++++ Tunny/Tunny.csproj | 2 +- Tunny/UI/OptimizationWindow.Designer.cs | 11 ++++++----- 6 files changed, 33 insertions(+), 9 deletions(-) create mode 100644 Tunny/Settings/BoTorch.cs diff --git a/Tunny/Settings/BoTorch.cs b/Tunny/Settings/BoTorch.cs new file mode 100644 index 00000000..f69d632a --- /dev/null +++ b/Tunny/Settings/BoTorch.cs @@ -0,0 +1,10 @@ +namespace Tunny.Settings +{ + /// + /// https://optuna.readthedocs.io/en/stable/reference/generated/optuna.integration.BoTorchSampler.html + /// + public class BoTorch + { + public int NStartupTrials { get; set; } = 10; + } +} diff --git a/Tunny/Settings/Sampler.cs b/Tunny/Settings/Sampler.cs index 4829a008..5c9c5fd6 100644 --- a/Tunny/Settings/Sampler.cs +++ b/Tunny/Settings/Sampler.cs @@ -9,5 +9,6 @@ public class Sampler public Tpe Tpe { get; set; } = new Tpe(); public CmaEs CmaEs { get; set; } = new CmaEs(); public NSGAII NsgaII { get; set; } = new NSGAII(); + public BoTorch BoTorch { get; set; } = new BoTorch(); } } diff --git a/Tunny/Solver/Optuna/Algorithm.cs b/Tunny/Solver/Optuna/Algorithm.cs index 609e6233..a663e863 100644 --- a/Tunny/Solver/Optuna/Algorithm.cs +++ b/Tunny/Solver/Optuna/Algorithm.cs @@ -255,15 +255,18 @@ private dynamic SetSamplerSettings(int samplerType, ref int nTrials, dynamic opt sampler = Sampler.TPE(optuna, Settings); break; case 1: - sampler = Sampler.NSGAII(optuna, Settings); + sampler = Sampler.BoTorch(optuna, Settings); break; case 2: - sampler = Sampler.CmaEs(optuna, Settings); + sampler = Sampler.NSGAII(optuna, Settings); break; case 3: - sampler = Sampler.Random(optuna, Settings); + sampler = Sampler.CmaEs(optuna, Settings); break; case 4: + sampler = Sampler.Random(optuna, Settings); + break; + case 5: sampler = Sampler.Grid(optuna, Variables, ref nTrials); break; default: diff --git a/Tunny/Solver/Optuna/Sampler.cs b/Tunny/Solver/Optuna/Sampler.cs index 45b63e0e..70f836ef 100644 --- a/Tunny/Solver/Optuna/Sampler.cs +++ b/Tunny/Solver/Optuna/Sampler.cs @@ -8,6 +8,15 @@ namespace Tunny.Solver.Optuna { public static class Sampler { + internal static dynamic BoTorch(dynamic optuna, TunnySettings settings) + { + BoTorch boTorch = settings.Optimize.Sampler.BoTorch; + return optuna.integration.BoTorchSampler( + n_startup_trials: boTorch.NStartupTrials + ); + + } + internal static dynamic Random(dynamic optuna, TunnySettings settings) { Settings.Random random = settings.Optimize.Sampler.Random; diff --git a/Tunny/Tunny.csproj b/Tunny/Tunny.csproj index f4a07bf1..c0c84ce3 100644 --- a/Tunny/Tunny.csproj +++ b/Tunny/Tunny.csproj @@ -2,7 +2,7 @@ net48 - 0.4.0 + 0.5.0 Tunny Tunny is an optimization component wrapped in optuna. .gha diff --git a/Tunny/UI/OptimizationWindow.Designer.cs b/Tunny/UI/OptimizationWindow.Designer.cs index 49e6de32..081e46e9 100644 --- a/Tunny/UI/OptimizationWindow.Designer.cs +++ b/Tunny/UI/OptimizationWindow.Designer.cs @@ -159,15 +159,16 @@ private void InitializeComponent() // this.samplerComboBox.FormattingEnabled = true; this.samplerComboBox.Items.AddRange(new object[] { - "TPE", - "NSGA-II", - "CMA-ES", + "BayesianOpt (TPE)", + "BayesianOpt (GP)", + "GeneticAlgorithm (NSGA-II)", + "EvolutionStrategy (CMA-ES)", "Random", "Grid"}); - this.samplerComboBox.Location = new System.Drawing.Point(148, 12); + this.samplerComboBox.Location = new System.Drawing.Point(104, 12); this.samplerComboBox.Margin = new System.Windows.Forms.Padding(4, 6, 4, 6); this.samplerComboBox.Name = "samplerComboBox"; - this.samplerComboBox.Size = new System.Drawing.Size(214, 31); + this.samplerComboBox.Size = new System.Drawing.Size(258, 31); this.samplerComboBox.TabIndex = 7; // // samplerTypeText From a595de302abd25e63d13f18906296a3064596a75 Mon Sep 17 00:00:00 2001 From: hrntsm Date: Sat, 6 Aug 2022 00:47:40 +0900 Subject: [PATCH 04/65] Update requirements.txt --- PYTHON_PACKAGE_LICENSES | 6357 +++++++++++++++++++++--------------- Tunny/Lib/requirements.txt | 9 + 2 files changed, 3761 insertions(+), 2605 deletions(-) diff --git a/PYTHON_PACKAGE_LICENSES b/PYTHON_PACKAGE_LICENSES index 46c4ee7c..3e500fda 100644 --- a/PYTHON_PACKAGE_LICENSES +++ b/PYTHON_PACKAGE_LICENSES @@ -1,980 +1,579 @@ +---------------------------------------------------------------------------------------------------- + Some distributions of this package include a copy of the C Python dlls and standard library, which are covered by the Python license. https://docs.python.org/3/license.html +---------------------------------------------------------------------------------------------------- -autopage -0.5.1 -Apache Software License -Zane Bitter -https://github.com/zaneb/autopage -A library to provide automatic paging for console output +Mako +1.2.0 +MIT License +https://www.makotemplates.org/ +Copyright 2006-2021 the Mako authors and contributors . - Apache License - Version 2.0, January 2004 - http://www.apache.org/licenses/ +Permission is hereby granted, free of charge, to any person obtaining a copy of +this software and associated documentation files (the "Software"), to deal in +the Software without restriction, including without limitation the rights to +use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies +of the Software, and to permit persons to whom the Software is furnished to do +so, subject to the following conditions: - TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION - - 1. Definitions. - - "License" shall mean the terms and conditions for use, reproduction, - and distribution as defined by Sections 1 through 9 of this document. - - "Licensor" shall mean the copyright owner or entity authorized by - the copyright owner that is granting the License. - - "Legal Entity" shall mean the union of the acting entity and all - other entities that control, are controlled by, or are under common - control with that entity. For the purposes of this definition, - "control" means (i) the power, direct or indirect, to cause the - direction or management of such entity, whether by contract or - otherwise, or (ii) ownership of fifty percent (50%) or more of the - outstanding shares, or (iii) beneficial ownership of such entity. - - "You" (or "Your") shall mean an individual or Legal Entity - exercising permissions granted by this License. - - "Source" form shall mean the preferred form for making modifications, - including but not limited to software source code, documentation - source, and configuration files. - - "Object" form shall mean any form resulting from mechanical - transformation or translation of a Source form, including but - not limited to compiled object code, generated documentation, - and conversions to other media types. - - "Work" shall mean the work of authorship, whether in Source or - Object form, made available under the License, as indicated by a - copyright notice that is included in or attached to the work - (an example is provided in the Appendix below). - - "Derivative Works" shall mean any work, whether in Source or Object - form, that is based on (or derived from) the Work and for which the - editorial revisions, annotations, elaborations, or other modifications - represent, as a whole, an original work of authorship. For the purposes - of this License, Derivative Works shall not include works that remain - separable from, or merely link (or bind by name) to the interfaces of, - the Work and Derivative Works thereof. - - "Contribution" shall mean any work of authorship, including - the original version of the Work and any modifications or additions - to that Work or Derivative Works thereof, that is intentionally - submitted to Licensor for inclusion in the Work by the copyright owner - or by an individual or Legal Entity authorized to submit on behalf of - the copyright owner. For the purposes of this definition, "submitted" - means any form of electronic, verbal, or written communication sent - to the Licensor or its representatives, including but not limited to - communication on electronic mailing lists, source code control systems, - and issue tracking systems that are managed by, or on behalf of, the - Licensor for the purpose of discussing and improving the Work, but - excluding communication that is conspicuously marked or otherwise - designated in writing by the copyright owner as "Not a Contribution." - - "Contributor" shall mean Licensor and any individual or Legal Entity - on behalf of whom a Contribution has been received by Licensor and - subsequently incorporated within the Work. - - 2. Grant of Copyright License. Subject to the terms and conditions of - this License, each Contributor hereby grants to You a perpetual, - worldwide, non-exclusive, no-charge, royalty-free, irrevocable - copyright license to reproduce, prepare Derivative Works of, - publicly display, publicly perform, sublicense, and distribute the - Work and such Derivative Works in Source or Object form. - - 3. Grant of Patent License. Subject to the terms and conditions of - this License, each Contributor hereby grants to You a perpetual, - worldwide, non-exclusive, no-charge, royalty-free, irrevocable - (except as stated in this section) patent license to make, have made, - use, offer to sell, sell, import, and otherwise transfer the Work, - where such license applies only to those patent claims licensable - by such Contributor that are necessarily infringed by their - Contribution(s) alone or by combination of their Contribution(s) - with the Work to which such Contribution(s) was submitted. If You - institute patent litigation against any entity (including a - cross-claim or counterclaim in a lawsuit) alleging that the Work - or a Contribution incorporated within the Work constitutes direct - or contributory patent infringement, then any patent licenses - granted to You under this License for that Work shall terminate - as of the date such litigation is filed. - - 4. Redistribution. You may reproduce and distribute copies of the - Work or Derivative Works thereof in any medium, with or without - modifications, and in Source or Object form, provided that You - meet the following conditions: - - (a) You must give any other recipients of the Work or - Derivative Works a copy of this License; and - - (b) You must cause any modified files to carry prominent notices - stating that You changed the files; and - - (c) You must retain, in the Source form of any Derivative Works - that You distribute, all copyright, patent, trademark, and - attribution notices from the Source form of the Work, - excluding those notices that do not pertain to any part of - the Derivative Works; and - - (d) If the Work includes a "NOTICE" text file as part of its - distribution, then any Derivative Works that You distribute must - include a readable copy of the attribution notices contained - within such NOTICE file, excluding those notices that do not - pertain to any part of the Derivative Works, in at least one - of the following places: within a NOTICE text file distributed - as part of the Derivative Works; within the Source form or - documentation, if provided along with the Derivative Works; or, - within a display generated by the Derivative Works, if and - wherever such third-party notices normally appear. The contents - of the NOTICE file are for informational purposes only and - do not modify the License. You may add Your own attribution - notices within Derivative Works that You distribute, alongside - or as an addendum to the NOTICE text from the Work, provided - that such additional attribution notices cannot be construed - as modifying the License. - - You may add Your own copyright statement to Your modifications and - may provide additional or different license terms and conditions - for use, reproduction, or distribution of Your modifications, or - for any such Derivative Works as a whole, provided Your use, - reproduction, and distribution of the Work otherwise complies with - the conditions stated in this License. - - 5. Submission of Contributions. Unless You explicitly state otherwise, - any Contribution intentionally submitted for inclusion in the Work - by You to the Licensor shall be under the terms and conditions of - this License, without any additional terms or conditions. - Notwithstanding the above, nothing herein shall supersede or modify - the terms of any separate license agreement you may have executed - with Licensor regarding such Contributions. - - 6. Trademarks. This License does not grant permission to use the trade - names, trademarks, service marks, or product names of the Licensor, - except as required for reasonable and customary use in describing the - origin of the Work and reproducing the content of the NOTICE file. - - 7. Disclaimer of Warranty. Unless required by applicable law or - agreed to in writing, Licensor provides the Work (and each - Contributor provides its Contributions) on an "AS IS" BASIS, - WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or - implied, including, without limitation, any warranties or conditions - of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A - PARTICULAR PURPOSE. You are solely responsible for determining the - appropriateness of using or redistributing the Work and assume any - risks associated with Your exercise of permissions under this License. - - 8. Limitation of Liability. In no event and under no legal theory, - whether in tort (including negligence), contract, or otherwise, - unless required by applicable law (such as deliberate and grossly - negligent acts) or agreed to in writing, shall any Contributor be - liable to You for damages, including any direct, indirect, special, - incidental, or consequential damages of any character arising as a - result of this License or out of the use or inability to use the - Work (including but not limited to damages for loss of goodwill, - work stoppage, computer failure or malfunction, or any and all - other commercial damages or losses), even if such Contributor - has been advised of the possibility of such damages. - - 9. Accepting Warranty or Additional Liability. While redistributing - the Work or Derivative Works thereof, You may choose to offer, - and charge a fee for, acceptance of support, warranty, indemnity, - or other liability obligations and/or rights consistent with this - License. However, in accepting such obligations, You may act only - on Your own behalf and on Your sole responsibility, not on behalf - of any other Contributor, and only if You agree to indemnify, - defend, and hold each Contributor harmless for any liability - incurred by, or claims asserted against, such Contributor by reason - of your accepting any such warranty or additional liability. +The above copyright notice and this permission notice shall be included in all +copies or substantial portions of the Software. +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE +AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, +OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE +SOFTWARE. +MarkupSafe +2.1.1 +BSD License +https://palletsprojects.com/p/markupsafe/ +Copyright 2010 Pallets -cliff -3.10.1 -Apache Software License -OpenStack -https://docs.openstack.org/cliff/latest/ -Command Line Interface Formulation Framework +Redistribution and use in source and binary forms, with or without +modification, are permitted provided that the following conditions are +met: - Apache License - Version 2.0, January 2004 - http://www.apache.org/licenses/ +1. Redistributions of source code must retain the above copyright + notice, this list of conditions and the following disclaimer. - TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION - - 1. Definitions. - - "License" shall mean the terms and conditions for use, reproduction, - and distribution as defined by Sections 1 through 9 of this document. - - "Licensor" shall mean the copyright owner or entity authorized by - the copyright owner that is granting the License. - - "Legal Entity" shall mean the union of the acting entity and all - other entities that control, are controlled by, or are under common - control with that entity. For the purposes of this definition, - "control" means (i) the power, direct or indirect, to cause the - direction or management of such entity, whether by contract or - otherwise, or (ii) ownership of fifty percent (50%) or more of the - outstanding shares, or (iii) beneficial ownership of such entity. - - "You" (or "Your") shall mean an individual or Legal Entity - exercising permissions granted by this License. - - "Source" form shall mean the preferred form for making modifications, - including but not limited to software source code, documentation - source, and configuration files. - - "Object" form shall mean any form resulting from mechanical - transformation or translation of a Source form, including but - not limited to compiled object code, generated documentation, - and conversions to other media types. - - "Work" shall mean the work of authorship, whether in Source or - Object form, made available under the License, as indicated by a - copyright notice that is included in or attached to the work - (an example is provided in the Appendix below). - - "Derivative Works" shall mean any work, whether in Source or Object - form, that is based on (or derived from) the Work and for which the - editorial revisions, annotations, elaborations, or other modifications - represent, as a whole, an original work of authorship. For the purposes - of this License, Derivative Works shall not include works that remain - separable from, or merely link (or bind by name) to the interfaces of, - the Work and Derivative Works thereof. - - "Contribution" shall mean any work of authorship, including - the original version of the Work and any modifications or additions - to that Work or Derivative Works thereof, that is intentionally - submitted to Licensor for inclusion in the Work by the copyright owner - or by an individual or Legal Entity authorized to submit on behalf of - the copyright owner. For the purposes of this definition, "submitted" - means any form of electronic, verbal, or written communication sent - to the Licensor or its representatives, including but not limited to - communication on electronic mailing lists, source code control systems, - and issue tracking systems that are managed by, or on behalf of, the - Licensor for the purpose of discussing and improving the Work, but - excluding communication that is conspicuously marked or otherwise - designated in writing by the copyright owner as "Not a Contribution." - - "Contributor" shall mean Licensor and any individual or Legal Entity - on behalf of whom a Contribution has been received by Licensor and - subsequently incorporated within the Work. - - 2. Grant of Copyright License. Subject to the terms and conditions of - this License, each Contributor hereby grants to You a perpetual, - worldwide, non-exclusive, no-charge, royalty-free, irrevocable - copyright license to reproduce, prepare Derivative Works of, - publicly display, publicly perform, sublicense, and distribute the - Work and such Derivative Works in Source or Object form. - - 3. Grant of Patent License. Subject to the terms and conditions of - this License, each Contributor hereby grants to You a perpetual, - worldwide, non-exclusive, no-charge, royalty-free, irrevocable - (except as stated in this section) patent license to make, have made, - use, offer to sell, sell, import, and otherwise transfer the Work, - where such license applies only to those patent claims licensable - by such Contributor that are necessarily infringed by their - Contribution(s) alone or by combination of their Contribution(s) - with the Work to which such Contribution(s) was submitted. If You - institute patent litigation against any entity (including a - cross-claim or counterclaim in a lawsuit) alleging that the Work - or a Contribution incorporated within the Work constitutes direct - or contributory patent infringement, then any patent licenses - granted to You under this License for that Work shall terminate - as of the date such litigation is filed. - - 4. Redistribution. You may reproduce and distribute copies of the - Work or Derivative Works thereof in any medium, with or without - modifications, and in Source or Object form, provided that You - meet the following conditions: - - (a) You must give any other recipients of the Work or - Derivative Works a copy of this License; and - - (b) You must cause any modified files to carry prominent notices - stating that You changed the files; and - - (c) You must retain, in the Source form of any Derivative Works - that You distribute, all copyright, patent, trademark, and - attribution notices from the Source form of the Work, - excluding those notices that do not pertain to any part of - the Derivative Works; and - - (d) If the Work includes a "NOTICE" text file as part of its - distribution, then any Derivative Works that You distribute must - include a readable copy of the attribution notices contained - within such NOTICE file, excluding those notices that do not - pertain to any part of the Derivative Works, in at least one - of the following places: within a NOTICE text file distributed - as part of the Derivative Works; within the Source form or - documentation, if provided along with the Derivative Works; or, - within a display generated by the Derivative Works, if and - wherever such third-party notices normally appear. The contents - of the NOTICE file are for informational purposes only and - do not modify the License. You may add Your own attribution - notices within Derivative Works that You distribute, alongside - or as an addendum to the NOTICE text from the Work, provided - that such additional attribution notices cannot be construed - as modifying the License. - - You may add Your own copyright statement to Your modifications and - may provide additional or different license terms and conditions - for use, reproduction, or distribution of Your modifications, or - for any such Derivative Works as a whole, provided Your use, - reproduction, and distribution of the Work otherwise complies with - the conditions stated in this License. - - 5. Submission of Contributions. Unless You explicitly state otherwise, - any Contribution intentionally submitted for inclusion in the Work - by You to the Licensor shall be under the terms and conditions of - this License, without any additional terms or conditions. - Notwithstanding the above, nothing herein shall supersede or modify - the terms of any separate license agreement you may have executed - with Licensor regarding such Contributions. - - 6. Trademarks. This License does not grant permission to use the trade - names, trademarks, service marks, or product names of the Licensor, - except as required for reasonable and customary use in describing the - origin of the Work and reproducing the content of the NOTICE file. - - 7. Disclaimer of Warranty. Unless required by applicable law or - agreed to in writing, Licensor provides the Work (and each - Contributor provides its Contributions) on an "AS IS" BASIS, - WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or - implied, including, without limitation, any warranties or conditions - of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A - PARTICULAR PURPOSE. You are solely responsible for determining the - appropriateness of using or redistributing the Work and assume any - risks associated with Your exercise of permissions under this License. - - 8. Limitation of Liability. In no event and under no legal theory, - whether in tort (including negligence), contract, or otherwise, - unless required by applicable law (such as deliberate and grossly - negligent acts) or agreed to in writing, shall any Contributor be - liable to You for damages, including any direct, indirect, special, - incidental, or consequential damages of any character arising as a - result of this License or out of the use or inability to use the - Work (including but not limited to damages for loss of goodwill, - work stoppage, computer failure or malfunction, or any and all - other commercial damages or losses), even if such Contributor - has been advised of the possibility of such damages. - - 9. Accepting Warranty or Additional Liability. While redistributing - the Work or Derivative Works thereof, You may choose to offer, - and charge a fee for, acceptance of support, warranty, indemnity, - or other liability obligations and/or rights consistent with this - License. However, in accepting such obligations, You may act only - on Your own behalf and on Your sole responsibility, not on behalf - of any other Contributor, and only if You agree to indemnify, - defend, and hold each Contributor harmless for any liability - incurred by, or claims asserted against, such Contributor by reason - of your accepting any such warranty or additional liability. - - END OF TERMS AND CONDITIONS - - APPENDIX: How to apply the Apache License to your work. +2. Redistributions in binary form must reproduce the above copyright + notice, this list of conditions and the following disclaimer in the + documentation and/or other materials provided with the distribution. - To apply the Apache License to your work, attach the following - boilerplate notice, with the fields enclosed by brackets "[]" - replaced with your own identifying information. (Don't include - the brackets!) The text should be enclosed in the appropriate - comment syntax for the file format. We also recommend that a - file or class name and description of purpose be included on the - same "printed page" as the copyright notice for easier - identification within third-party archives. +3. Neither the name of the copyright holder nor the names of its + contributors may be used to endorse or promote products derived from + this software without specific prior written permission. - Copyright [yyyy] [name of copyright owner] +THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS +"AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT +LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A +PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT +HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, +SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED +TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR +PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF +LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING +NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS +SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. - Licensed under the Apache License, Version 2.0 (the "License"); - you may not use this file except in compliance with the License. - You may obtain a copy of the License at +PyYAML +6.0 +MIT License +https://pyyaml.org/ +Copyright (c) 2017-2021 Ingy döt Net +Copyright (c) 2006-2016 Kirill Simonov - http://www.apache.org/licenses/LICENSE-2.0 +Permission is hereby granted, free of charge, to any person obtaining a copy of +this software and associated documentation files (the "Software"), to deal in +the Software without restriction, including without limitation the rights to +use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies +of the Software, and to permit persons to whom the Software is furnished to do +so, subject to the following conditions: - Unless required by applicable law or agreed to in writing, software - distributed under the License is distributed on an "AS IS" BASIS, - WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. - See the License for the specific language governing permissions and - limitations under the License. +The above copyright notice and this permission notice shall be included in all +copies or substantial portions of the Software. +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE +AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, +OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE +SOFTWARE. -pbr -5.9.0 -Apache Software License -OpenStack -https://docs.openstack.org/pbr/latest/ -Python Build Reasonableness +SQLAlchemy +1.4.39 +MIT License +https://www.sqlalchemy.org +Copyright 2005-2022 SQLAlchemy authors and contributors . - Apache License - Version 2.0, January 2004 - http://www.apache.org/licenses/ +Permission is hereby granted, free of charge, to any person obtaining a copy of +this software and associated documentation files (the "Software"), to deal in +the Software without restriction, including without limitation the rights to +use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies +of the Software, and to permit persons to whom the Software is furnished to do +so, subject to the following conditions: - TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION - - 1. Definitions. - - "License" shall mean the terms and conditions for use, reproduction, - and distribution as defined by Sections 1 through 9 of this document. - - "Licensor" shall mean the copyright owner or entity authorized by - the copyright owner that is granting the License. - - "Legal Entity" shall mean the union of the acting entity and all - other entities that control, are controlled by, or are under common - control with that entity. For the purposes of this definition, - "control" means (i) the power, direct or indirect, to cause the - direction or management of such entity, whether by contract or - otherwise, or (ii) ownership of fifty percent (50%) or more of the - outstanding shares, or (iii) beneficial ownership of such entity. - - "You" (or "Your") shall mean an individual or Legal Entity - exercising permissions granted by this License. - - "Source" form shall mean the preferred form for making modifications, - including but not limited to software source code, documentation - source, and configuration files. - - "Object" form shall mean any form resulting from mechanical - transformation or translation of a Source form, including but - not limited to compiled object code, generated documentation, - and conversions to other media types. - - "Work" shall mean the work of authorship, whether in Source or - Object form, made available under the License, as indicated by a - copyright notice that is included in or attached to the work - (an example is provided in the Appendix below). - - "Derivative Works" shall mean any work, whether in Source or Object - form, that is based on (or derived from) the Work and for which the - editorial revisions, annotations, elaborations, or other modifications - represent, as a whole, an original work of authorship. For the purposes - of this License, Derivative Works shall not include works that remain - separable from, or merely link (or bind by name) to the interfaces of, - the Work and Derivative Works thereof. - - "Contribution" shall mean any work of authorship, including - the original version of the Work and any modifications or additions - to that Work or Derivative Works thereof, that is intentionally - submitted to Licensor for inclusion in the Work by the copyright owner - or by an individual or Legal Entity authorized to submit on behalf of - the copyright owner. For the purposes of this definition, "submitted" - means any form of electronic, verbal, or written communication sent - to the Licensor or its representatives, including but not limited to - communication on electronic mailing lists, source code control systems, - and issue tracking systems that are managed by, or on behalf of, the - Licensor for the purpose of discussing and improving the Work, but - excluding communication that is conspicuously marked or otherwise - designated in writing by the copyright owner as "Not a Contribution." - - "Contributor" shall mean Licensor and any individual or Legal Entity - on behalf of whom a Contribution has been received by Licensor and - subsequently incorporated within the Work. - - 2. Grant of Copyright License. Subject to the terms and conditions of - this License, each Contributor hereby grants to You a perpetual, - worldwide, non-exclusive, no-charge, royalty-free, irrevocable - copyright license to reproduce, prepare Derivative Works of, - publicly display, publicly perform, sublicense, and distribute the - Work and such Derivative Works in Source or Object form. - - 3. Grant of Patent License. Subject to the terms and conditions of - this License, each Contributor hereby grants to You a perpetual, - worldwide, non-exclusive, no-charge, royalty-free, irrevocable - (except as stated in this section) patent license to make, have made, - use, offer to sell, sell, import, and otherwise transfer the Work, - where such license applies only to those patent claims licensable - by such Contributor that are necessarily infringed by their - Contribution(s) alone or by combination of their Contribution(s) - with the Work to which such Contribution(s) was submitted. If You - institute patent litigation against any entity (including a - cross-claim or counterclaim in a lawsuit) alleging that the Work - or a Contribution incorporated within the Work constitutes direct - or contributory patent infringement, then any patent licenses - granted to You under this License for that Work shall terminate - as of the date such litigation is filed. - - 4. Redistribution. You may reproduce and distribute copies of the - Work or Derivative Works thereof in any medium, with or without - modifications, and in Source or Object form, provided that You - meet the following conditions: - - (a) You must give any other recipients of the Work or - Derivative Works a copy of this License; and - - (b) You must cause any modified files to carry prominent notices - stating that You changed the files; and - - (c) You must retain, in the Source form of any Derivative Works - that You distribute, all copyright, patent, trademark, and - attribution notices from the Source form of the Work, - excluding those notices that do not pertain to any part of - the Derivative Works; and - - (d) If the Work includes a "NOTICE" text file as part of its - distribution, then any Derivative Works that You distribute must - include a readable copy of the attribution notices contained - within such NOTICE file, excluding those notices that do not - pertain to any part of the Derivative Works, in at least one - of the following places: within a NOTICE text file distributed - as part of the Derivative Works; within the Source form or - documentation, if provided along with the Derivative Works; or, - within a display generated by the Derivative Works, if and - wherever such third-party notices normally appear. The contents - of the NOTICE file are for informational purposes only and - do not modify the License. You may add Your own attribution - notices within Derivative Works that You distribute, alongside - or as an addendum to the NOTICE text from the Work, provided - that such additional attribution notices cannot be construed - as modifying the License. - - You may add Your own copyright statement to Your modifications and - may provide additional or different license terms and conditions - for use, reproduction, or distribution of Your modifications, or - for any such Derivative Works as a whole, provided Your use, - reproduction, and distribution of the Work otherwise complies with - the conditions stated in this License. - - 5. Submission of Contributions. Unless You explicitly state otherwise, - any Contribution intentionally submitted for inclusion in the Work - by You to the Licensor shall be under the terms and conditions of - this License, without any additional terms or conditions. - Notwithstanding the above, nothing herein shall supersede or modify - the terms of any separate license agreement you may have executed - with Licensor regarding such Contributions. - - 6. Trademarks. This License does not grant permission to use the trade - names, trademarks, service marks, or product names of the Licensor, - except as required for reasonable and customary use in describing the - origin of the Work and reproducing the content of the NOTICE file. - - 7. Disclaimer of Warranty. Unless required by applicable law or - agreed to in writing, Licensor provides the Work (and each - Contributor provides its Contributions) on an "AS IS" BASIS, - WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or - implied, including, without limitation, any warranties or conditions - of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A - PARTICULAR PURPOSE. You are solely responsible for determining the - appropriateness of using or redistributing the Work and assume any - risks associated with Your exercise of permissions under this License. - - 8. Limitation of Liability. In no event and under no legal theory, - whether in tort (including negligence), contract, or otherwise, - unless required by applicable law (such as deliberate and grossly - negligent acts) or agreed to in writing, shall any Contributor be - liable to You for damages, including any direct, indirect, special, - incidental, or consequential damages of any character arising as a - result of this License or out of the use or inability to use the - Work (including but not limited to damages for loss of goodwill, - work stoppage, computer failure or malfunction, or any and all - other commercial damages or losses), even if such Contributor - has been advised of the possibility of such damages. - - 9. Accepting Warranty or Additional Liability. While redistributing - the Work or Derivative Works thereof, You may choose to offer, - and charge a fee for, acceptance of support, warranty, indemnity, - or other liability obligations and/or rights consistent with this - License. However, in accepting such obligations, You may act only - on Your own behalf and on Your sole responsibility, not on behalf - of any other Contributor, and only if You agree to indemnify, - defend, and hold each Contributor harmless for any liability - incurred by, or claims asserted against, such Contributor by reason - of your accepting any such warranty or additional liability. +The above copyright notice and this permission notice shall be included in all +copies or substantial portions of the Software. +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE +AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, +OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE +SOFTWARE. +alembic +1.8.0 +MIT License +https://alembic.sqlalchemy.org +Copyright 2009-2022 Michael Bayer. -stevedore -3.5.0 +Permission is hereby granted, free of charge, to any person obtaining a copy of +this software and associated documentation files (the "Software"), to deal in +the Software without restriction, including without limitation the rights to +use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies +of the Software, and to permit persons to whom the Software is furnished to do +so, subject to the following conditions: + +The above copyright notice and this permission notice shall be included in all +copies or substantial portions of the Software. + +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE +AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, +OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE +SOFTWARE. + +attrs +21.4.0 +MIT License +https://www.attrs.org/ +The MIT License (MIT) + +Copyright (c) 2015 Hynek Schlawack + +Permission is hereby granted, free of charge, to any person obtaining a copy +of this software and associated documentation files (the "Software"), to deal +in the Software without restriction, including without limitation the rights +to use, copy, modify, merge, publish, distribute, sublicense, and/or sell +copies of the Software, and to permit persons to whom the Software is +furnished to do so, subject to the following conditions: + +The above copyright notice and this permission notice shall be included in all +copies or substantial portions of the Software. + +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE +AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, +OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE +SOFTWARE. + +autopage +0.5.1 Apache Software License -OpenStack -https://docs.openstack.org/stevedore/latest/ -Manage dynamic plugins for Python applications +https://github.com/zaneb/autopage Apache License Version 2.0, January 2004 http://www.apache.org/licenses/ - TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION - - 1. Definitions. - - "License" shall mean the terms and conditions for use, reproduction, - and distribution as defined by Sections 1 through 9 of this document. - - "Licensor" shall mean the copyright owner or entity authorized by - the copyright owner that is granting the License. - - "Legal Entity" shall mean the union of the acting entity and all - other entities that control, are controlled by, or are under common - control with that entity. For the purposes of this definition, - "control" means (i) the power, direct or indirect, to cause the - direction or management of such entity, whether by contract or - otherwise, or (ii) ownership of fifty percent (50%) or more of the - outstanding shares, or (iii) beneficial ownership of such entity. - - "You" (or "Your") shall mean an individual or Legal Entity - exercising permissions granted by this License. - - "Source" form shall mean the preferred form for making modifications, - including but not limited to software source code, documentation - source, and configuration files. - - "Object" form shall mean any form resulting from mechanical - transformation or translation of a Source form, including but - not limited to compiled object code, generated documentation, - and conversions to other media types. - - "Work" shall mean the work of authorship, whether in Source or - Object form, made available under the License, as indicated by a - copyright notice that is included in or attached to the work - (an example is provided in the Appendix below). - - "Derivative Works" shall mean any work, whether in Source or Object - form, that is based on (or derived from) the Work and for which the - editorial revisions, annotations, elaborations, or other modifications - represent, as a whole, an original work of authorship. For the purposes - of this License, Derivative Works shall not include works that remain - separable from, or merely link (or bind by name) to the interfaces of, - the Work and Derivative Works thereof. - - "Contribution" shall mean any work of authorship, including - the original version of the Work and any modifications or additions - to that Work or Derivative Works thereof, that is intentionally - submitted to Licensor for inclusion in the Work by the copyright owner - or by an individual or Legal Entity authorized to submit on behalf of - the copyright owner. For the purposes of this definition, "submitted" - means any form of electronic, verbal, or written communication sent - to the Licensor or its representatives, including but not limited to - communication on electronic mailing lists, source code control systems, - and issue tracking systems that are managed by, or on behalf of, the - Licensor for the purpose of discussing and improving the Work, but - excluding communication that is conspicuously marked or otherwise - designated in writing by the copyright owner as "Not a Contribution." - - "Contributor" shall mean Licensor and any individual or Legal Entity - on behalf of whom a Contribution has been received by Licensor and - subsequently incorporated within the Work. - - 2. Grant of Copyright License. Subject to the terms and conditions of - this License, each Contributor hereby grants to You a perpetual, - worldwide, non-exclusive, no-charge, royalty-free, irrevocable - copyright license to reproduce, prepare Derivative Works of, - publicly display, publicly perform, sublicense, and distribute the - Work and such Derivative Works in Source or Object form. - - 3. Grant of Patent License. Subject to the terms and conditions of - this License, each Contributor hereby grants to You a perpetual, - worldwide, non-exclusive, no-charge, royalty-free, irrevocable - (except as stated in this section) patent license to make, have made, - use, offer to sell, sell, import, and otherwise transfer the Work, - where such license applies only to those patent claims licensable - by such Contributor that are necessarily infringed by their - Contribution(s) alone or by combination of their Contribution(s) - with the Work to which such Contribution(s) was submitted. If You - institute patent litigation against any entity (including a - cross-claim or counterclaim in a lawsuit) alleging that the Work - or a Contribution incorporated within the Work constitutes direct - or contributory patent infringement, then any patent licenses - granted to You under this License for that Work shall terminate - as of the date such litigation is filed. - - 4. Redistribution. You may reproduce and distribute copies of the - Work or Derivative Works thereof in any medium, with or without - modifications, and in Source or Object form, provided that You - meet the following conditions: - - (a) You must give any other recipients of the Work or - Derivative Works a copy of this License; and - - (b) You must cause any modified files to carry prominent notices - stating that You changed the files; and - - (c) You must retain, in the Source form of any Derivative Works - that You distribute, all copyright, patent, trademark, and - attribution notices from the Source form of the Work, - excluding those notices that do not pertain to any part of - the Derivative Works; and - - (d) If the Work includes a "NOTICE" text file as part of its - distribution, then any Derivative Works that You distribute must - include a readable copy of the attribution notices contained - within such NOTICE file, excluding those notices that do not - pertain to any part of the Derivative Works, in at least one - of the following places: within a NOTICE text file distributed - as part of the Derivative Works; within the Source form or - documentation, if provided along with the Derivative Works; or, - within a display generated by the Derivative Works, if and - wherever such third-party notices normally appear. The contents - of the NOTICE file are for informational purposes only and - do not modify the License. You may add Your own attribution - notices within Derivative Works that You distribute, alongside - or as an addendum to the NOTICE text from the Work, provided - that such additional attribution notices cannot be construed - as modifying the License. - - You may add Your own copyright statement to Your modifications and - may provide additional or different license terms and conditions - for use, reproduction, or distribution of Your modifications, or - for any such Derivative Works as a whole, provided Your use, - reproduction, and distribution of the Work otherwise complies with - the conditions stated in this License. - - 5. Submission of Contributions. Unless You explicitly state otherwise, - any Contribution intentionally submitted for inclusion in the Work - by You to the Licensor shall be under the terms and conditions of - this License, without any additional terms or conditions. - Notwithstanding the above, nothing herein shall supersede or modify - the terms of any separate license agreement you may have executed - with Licensor regarding such Contributions. - - 6. Trademarks. This License does not grant permission to use the trade - names, trademarks, service marks, or product names of the Licensor, - except as required for reasonable and customary use in describing the - origin of the Work and reproducing the content of the NOTICE file. - - 7. Disclaimer of Warranty. Unless required by applicable law or - agreed to in writing, Licensor provides the Work (and each - Contributor provides its Contributions) on an "AS IS" BASIS, - WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or - implied, including, without limitation, any warranties or conditions - of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A - PARTICULAR PURPOSE. You are solely responsible for determining the - appropriateness of using or redistributing the Work and assume any - risks associated with Your exercise of permissions under this License. - - 8. Limitation of Liability. In no event and under no legal theory, - whether in tort (including negligence), contract, or otherwise, - unless required by applicable law (such as deliberate and grossly - negligent acts) or agreed to in writing, shall any Contributor be - liable to You for damages, including any direct, indirect, special, - incidental, or consequential damages of any character arising as a - result of this License or out of the use or inability to use the - Work (including but not limited to damages for loss of goodwill, - work stoppage, computer failure or malfunction, or any and all - other commercial damages or losses), even if such Contributor - has been advised of the possibility of such damages. - - 9. Accepting Warranty or Additional Liability. While redistributing - the Work or Derivative Works thereof, You may choose to offer, - and charge a fee for, acceptance of support, warranty, indemnity, - or other liability obligations and/or rights consistent with this - License. However, in accepting such obligations, You may act only - on Your own behalf and on Your sole responsibility, not on behalf - of any other Contributor, and only if You agree to indemnify, - defend, and hold each Contributor harmless for any liability - incurred by, or claims asserted against, such Contributor by reason - of your accepting any such warranty or additional liability. - - END OF TERMS AND CONDITIONS - - APPENDIX: How to apply the Apache License to your work. +TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION + +1. Definitions. + + "License" shall mean the terms and conditions for use, reproduction, + and distribution as defined by Sections 1 through 9 of this document. + + "Licensor" shall mean the copyright owner or entity authorized by + the copyright owner that is granting the License. + + "Legal Entity" shall mean the union of the acting entity and all + other entities that control, are controlled by, or are under common + control with that entity. For the purposes of this definition, + "control" means (i) the power, direct or indirect, to cause the + direction or management of such entity, whether by contract or + otherwise, or (ii) ownership of fifty percent (50%) or more of the + outstanding shares, or (iii) beneficial ownership of such entity. + + "You" (or "Your") shall mean an individual or Legal Entity + exercising permissions granted by this License. + + "Source" form shall mean the preferred form for making modifications, + including but not limited to software source code, documentation + source, and configuration files. + + "Object" form shall mean any form resulting from mechanical + transformation or translation of a Source form, including but + not limited to compiled object code, generated documentation, + and conversions to other media types. + + "Work" shall mean the work of authorship, whether in Source or + Object form, made available under the License, as indicated by a + copyright notice that is included in or attached to the work + (an example is provided in the Appendix below). + + "Derivative Works" shall mean any work, whether in Source or Object + form, that is based on (or derived from) the Work and for which the + editorial revisions, annotations, elaborations, or other modifications + represent, as a whole, an original work of authorship. For the purposes + of this License, Derivative Works shall not include works that remain + separable from, or merely link (or bind by name) to the interfaces of, + the Work and Derivative Works thereof. + + "Contribution" shall mean any work of authorship, including + the original version of the Work and any modifications or additions + to that Work or Derivative Works thereof, that is intentionally + submitted to Licensor for inclusion in the Work by the copyright owner + or by an individual or Legal Entity authorized to submit on behalf of + the copyright owner. For the purposes of this definition, "submitted" + means any form of electronic, verbal, or written communication sent + to the Licensor or its representatives, including but not limited to + communication on electronic mailing lists, source code control systems, + and issue tracking systems that are managed by, or on behalf of, the + Licensor for the purpose of discussing and improving the Work, but + excluding communication that is conspicuously marked or otherwise + designated in writing by the copyright owner as "Not a Contribution." + + "Contributor" shall mean Licensor and any individual or Legal Entity + on behalf of whom a Contribution has been received by Licensor and + subsequently incorporated within the Work. + +2. Grant of Copyright License. Subject to the terms and conditions of + this License, each Contributor hereby grants to You a perpetual, + worldwide, non-exclusive, no-charge, royalty-free, irrevocable + copyright license to reproduce, prepare Derivative Works of, + publicly display, publicly perform, sublicense, and distribute the + Work and such Derivative Works in Source or Object form. + +3. Grant of Patent License. Subject to the terms and conditions of + this License, each Contributor hereby grants to You a perpetual, + worldwide, non-exclusive, no-charge, royalty-free, irrevocable + (except as stated in this section) patent license to make, have made, + use, offer to sell, sell, import, and otherwise transfer the Work, + where such license applies only to those patent claims licensable + by such Contributor that are necessarily infringed by their + Contribution(s) alone or by combination of their Contribution(s) + with the Work to which such Contribution(s) was submitted. If You + institute patent litigation against any entity (including a + cross-claim or counterclaim in a lawsuit) alleging that the Work + or a Contribution incorporated within the Work constitutes direct + or contributory patent infringement, then any patent licenses + granted to You under this License for that Work shall terminate + as of the date such litigation is filed. + +4. Redistribution. You may reproduce and distribute copies of the + Work or Derivative Works thereof in any medium, with or without + modifications, and in Source or Object form, provided that You + meet the following conditions: + + (a) You must give any other recipients of the Work or + Derivative Works a copy of this License; and + + (b) You must cause any modified files to carry prominent notices + stating that You changed the files; and + + (c) You must retain, in the Source form of any Derivative Works + that You distribute, all copyright, patent, trademark, and + attribution notices from the Source form of the Work, + excluding those notices that do not pertain to any part of + the Derivative Works; and + + (d) If the Work includes a "NOTICE" text file as part of its + distribution, then any Derivative Works that You distribute must + include a readable copy of the attribution notices contained + within such NOTICE file, excluding those notices that do not + pertain to any part of the Derivative Works, in at least one + of the following places: within a NOTICE text file distributed + as part of the Derivative Works; within the Source form or + documentation, if provided along with the Derivative Works; or, + within a display generated by the Derivative Works, if and + wherever such third-party notices normally appear. The contents + of the NOTICE file are for informational purposes only and + do not modify the License. You may add Your own attribution + notices within Derivative Works that You distribute, alongside + or as an addendum to the NOTICE text from the Work, provided + that such additional attribution notices cannot be construed + as modifying the License. + + You may add Your own copyright statement to Your modifications and + may provide additional or different license terms and conditions + for use, reproduction, or distribution of Your modifications, or + for any such Derivative Works as a whole, provided Your use, + reproduction, and distribution of the Work otherwise complies with + the conditions stated in this License. + +5. Submission of Contributions. Unless You explicitly state otherwise, + any Contribution intentionally submitted for inclusion in the Work + by You to the Licensor shall be under the terms and conditions of + this License, without any additional terms or conditions. + Notwithstanding the above, nothing herein shall supersede or modify + the terms of any separate license agreement you may have executed + with Licensor regarding such Contributions. + +6. Trademarks. This License does not grant permission to use the trade + names, trademarks, service marks, or product names of the Licensor, + except as required for reasonable and customary use in describing the + origin of the Work and reproducing the content of the NOTICE file. + +7. Disclaimer of Warranty. Unless required by applicable law or + agreed to in writing, Licensor provides the Work (and each + Contributor provides its Contributions) on an "AS IS" BASIS, + WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or + implied, including, without limitation, any warranties or conditions + of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A + PARTICULAR PURPOSE. You are solely responsible for determining the + appropriateness of using or redistributing the Work and assume any + risks associated with Your exercise of permissions under this License. + +8. Limitation of Liability. In no event and under no legal theory, + whether in tort (including negligence), contract, or otherwise, + unless required by applicable law (such as deliberate and grossly + negligent acts) or agreed to in writing, shall any Contributor be + liable to You for damages, including any direct, indirect, special, + incidental, or consequential damages of any character arising as a + result of this License or out of the use or inability to use the + Work (including but not limited to damages for loss of goodwill, + work stoppage, computer failure or malfunction, or any and all + other commercial damages or losses), even if such Contributor + has been advised of the possibility of such damages. + +9. Accepting Warranty or Additional Liability. While redistributing + the Work or Derivative Works thereof, You may choose to offer, + and charge a fee for, acceptance of support, warranty, indemnity, + or other liability obligations and/or rights consistent with this + License. However, in accepting such obligations, You may act only + on Your own behalf and on Your sole responsibility, not on behalf + of any other Contributor, and only if You agree to indemnify, + defend, and hold each Contributor harmless for any liability + incurred by, or claims asserted against, such Contributor by reason + of your accepting any such warranty or additional liability. + +botorch +0.6.5 +MIT License +https://botorch.org +MIT License + +Copyright (c) Meta Platforms, Inc. and affiliates. - To apply the Apache License to your work, attach the following - boilerplate notice, with the fields enclosed by brackets "[]" - replaced with your own identifying information. (Don't include - the brackets!) The text should be enclosed in the appropriate - comment syntax for the file format. We also recommend that a - file or class name and description of purpose be included on the - same "printed page" as the copyright notice for easier - identification within third-party archives. +Permission is hereby granted, free of charge, to any person obtaining a copy +of this software and associated documentation files (the "Software"), to deal +in the Software without restriction, including without limitation the rights +to use, copy, modify, merge, publish, distribute, sublicense, and/or sell +copies of the Software, and to permit persons to whom the Software is +furnished to do so, subject to the following conditions: + +The above copyright notice and this permission notice shall be included in all +copies or substantial portions of the Software. - Copyright [yyyy] [name of copyright owner] +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE +AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, +OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE +SOFTWARE. - Licensed under the Apache License, Version 2.0 (the "License"); - you may not use this file except in compliance with the License. - You may obtain a copy of the License at +bottle +0.12.21 +MIT License +http://bottlepy.org/ +Copyright (c) 2012, Marcel Hellkamp. - http://www.apache.org/licenses/LICENSE-2.0 +Permission is hereby granted, free of charge, to any person obtaining a copy +of this software and associated documentation files (the "Software"), to deal +in the Software without restriction, including without limitation the rights +to use, copy, modify, merge, publish, distribute, sublicense, and/or sell +copies of the Software, and to permit persons to whom the Software is +furnished to do so, subject to the following conditions: - Unless required by applicable law or agreed to in writing, software - distributed under the License is distributed on an "AS IS" BASIS, - WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. - See the License for the specific language governing permissions and - limitations under the License. +The above copyright notice and this permission notice shall be included in +all copies or substantial portions of the Software. +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE +AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, +OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN +THE SOFTWARE. -tenacity -8.0.1 +cliff +3.10.1 Apache Software License -Julien Danjou -https://github.com/jd/tenacity -Retry code until it succeeds +https://docs.openstack.org/cliff/latest/ Apache License Version 2.0, January 2004 http://www.apache.org/licenses/ - TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION - - 1. Definitions. - - "License" shall mean the terms and conditions for use, reproduction, - and distribution as defined by Sections 1 through 9 of this document. - - "Licensor" shall mean the copyright owner or entity authorized by - the copyright owner that is granting the License. - - "Legal Entity" shall mean the union of the acting entity and all - other entities that control, are controlled by, or are under common - control with that entity. For the purposes of this definition, - "control" means (i) the power, direct or indirect, to cause the - direction or management of such entity, whether by contract or - otherwise, or (ii) ownership of fifty percent (50%) or more of the - outstanding shares, or (iii) beneficial ownership of such entity. - - "You" (or "Your") shall mean an individual or Legal Entity - exercising permissions granted by this License. - - "Source" form shall mean the preferred form for making modifications, - including but not limited to software source code, documentation - source, and configuration files. - - "Object" form shall mean any form resulting from mechanical - transformation or translation of a Source form, including but - not limited to compiled object code, generated documentation, - and conversions to other media types. - - "Work" shall mean the work of authorship, whether in Source or - Object form, made available under the License, as indicated by a - copyright notice that is included in or attached to the work - (an example is provided in the Appendix below). - - "Derivative Works" shall mean any work, whether in Source or Object - form, that is based on (or derived from) the Work and for which the - editorial revisions, annotations, elaborations, or other modifications - represent, as a whole, an original work of authorship. For the purposes - of this License, Derivative Works shall not include works that remain - separable from, or merely link (or bind by name) to the interfaces of, - the Work and Derivative Works thereof. - - "Contribution" shall mean any work of authorship, including - the original version of the Work and any modifications or additions - to that Work or Derivative Works thereof, that is intentionally - submitted to Licensor for inclusion in the Work by the copyright owner - or by an individual or Legal Entity authorized to submit on behalf of - the copyright owner. For the purposes of this definition, "submitted" - means any form of electronic, verbal, or written communication sent - to the Licensor or its representatives, including but not limited to - communication on electronic mailing lists, source code control systems, - and issue tracking systems that are managed by, or on behalf of, the - Licensor for the purpose of discussing and improving the Work, but - excluding communication that is conspicuously marked or otherwise - designated in writing by the copyright owner as "Not a Contribution." - - "Contributor" shall mean Licensor and any individual or Legal Entity - on behalf of whom a Contribution has been received by Licensor and - subsequently incorporated within the Work. - - 2. Grant of Copyright License. Subject to the terms and conditions of - this License, each Contributor hereby grants to You a perpetual, - worldwide, non-exclusive, no-charge, royalty-free, irrevocable - copyright license to reproduce, prepare Derivative Works of, - publicly display, publicly perform, sublicense, and distribute the - Work and such Derivative Works in Source or Object form. - - 3. Grant of Patent License. Subject to the terms and conditions of - this License, each Contributor hereby grants to You a perpetual, - worldwide, non-exclusive, no-charge, royalty-free, irrevocable - (except as stated in this section) patent license to make, have made, - use, offer to sell, sell, import, and otherwise transfer the Work, - where such license applies only to those patent claims licensable - by such Contributor that are necessarily infringed by their - Contribution(s) alone or by combination of their Contribution(s) - with the Work to which such Contribution(s) was submitted. If You - institute patent litigation against any entity (including a - cross-claim or counterclaim in a lawsuit) alleging that the Work - or a Contribution incorporated within the Work constitutes direct - or contributory patent infringement, then any patent licenses - granted to You under this License for that Work shall terminate - as of the date such litigation is filed. - - 4. Redistribution. You may reproduce and distribute copies of the - Work or Derivative Works thereof in any medium, with or without - modifications, and in Source or Object form, provided that You - meet the following conditions: - - (a) You must give any other recipients of the Work or - Derivative Works a copy of this License; and - - (b) You must cause any modified files to carry prominent notices - stating that You changed the files; and - - (c) You must retain, in the Source form of any Derivative Works - that You distribute, all copyright, patent, trademark, and - attribution notices from the Source form of the Work, - excluding those notices that do not pertain to any part of - the Derivative Works; and - - (d) If the Work includes a "NOTICE" text file as part of its - distribution, then any Derivative Works that You distribute must - include a readable copy of the attribution notices contained - within such NOTICE file, excluding those notices that do not - pertain to any part of the Derivative Works, in at least one - of the following places: within a NOTICE text file distributed - as part of the Derivative Works; within the Source form or - documentation, if provided along with the Derivative Works; or, - within a display generated by the Derivative Works, if and - wherever such third-party notices normally appear. The contents - of the NOTICE file are for informational purposes only and - do not modify the License. You may add Your own attribution - notices within Derivative Works that You distribute, alongside - or as an addendum to the NOTICE text from the Work, provided - that such additional attribution notices cannot be construed - as modifying the License. - - You may add Your own copyright statement to Your modifications and - may provide additional or different license terms and conditions - for use, reproduction, or distribution of Your modifications, or - for any such Derivative Works as a whole, provided Your use, - reproduction, and distribution of the Work otherwise complies with - the conditions stated in this License. - - 5. Submission of Contributions. Unless You explicitly state otherwise, - any Contribution intentionally submitted for inclusion in the Work - by You to the Licensor shall be under the terms and conditions of - this License, without any additional terms or conditions. - Notwithstanding the above, nothing herein shall supersede or modify - the terms of any separate license agreement you may have executed - with Licensor regarding such Contributions. - - 6. Trademarks. This License does not grant permission to use the trade - names, trademarks, service marks, or product names of the Licensor, - except as required for reasonable and customary use in describing the - origin of the Work and reproducing the content of the NOTICE file. - - 7. Disclaimer of Warranty. Unless required by applicable law or - agreed to in writing, Licensor provides the Work (and each - Contributor provides its Contributions) on an "AS IS" BASIS, - WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or - implied, including, without limitation, any warranties or conditions - of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A - PARTICULAR PURPOSE. You are solely responsible for determining the - appropriateness of using or redistributing the Work and assume any - risks associated with Your exercise of permissions under this License. - - 8. Limitation of Liability. In no event and under no legal theory, - whether in tort (including negligence), contract, or otherwise, - unless required by applicable law (such as deliberate and grossly - negligent acts) or agreed to in writing, shall any Contributor be - liable to You for damages, including any direct, indirect, special, - incidental, or consequential damages of any character arising as a - result of this License or out of the use or inability to use the - Work (including but not limited to damages for loss of goodwill, - work stoppage, computer failure or malfunction, or any and all - other commercial damages or losses), even if such Contributor - has been advised of the possibility of such damages. - - 9. Accepting Warranty or Additional Liability. While redistributing - the Work or Derivative Works thereof, You may choose to offer, - and charge a fee for, acceptance of support, warranty, indemnity, - or other liability obligations and/or rights consistent with this - License. However, in accepting such obligations, You may act only - on Your own behalf and on Your sole responsibility, not on behalf - of any other Contributor, and only if You agree to indemnify, - defend, and hold each Contributor harmless for any liability - incurred by, or claims asserted against, such Contributor by reason - of your accepting any such warranty or additional liability. - - END OF TERMS AND CONDITIONS - - APPENDIX: How to apply the Apache License to your work. +TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION + +1. Definitions. + + "License" shall mean the terms and conditions for use, reproduction, + and distribution as defined by Sections 1 through 9 of this document. + + "Licensor" shall mean the copyright owner or entity authorized by + the copyright owner that is granting the License. + + "Legal Entity" shall mean the union of the acting entity and all + other entities that control, are controlled by, or are under common + control with that entity. For the purposes of this definition, + "control" means (i) the power, direct or indirect, to cause the + direction or management of such entity, whether by contract or + otherwise, or (ii) ownership of fifty percent (50%) or more of the + outstanding shares, or (iii) beneficial ownership of such entity. + + "You" (or "Your") shall mean an individual or Legal Entity + exercising permissions granted by this License. + + "Source" form shall mean the preferred form for making modifications, + including but not limited to software source code, documentation + source, and configuration files. + + "Object" form shall mean any form resulting from mechanical + transformation or translation of a Source form, including but + not limited to compiled object code, generated documentation, + and conversions to other media types. + + "Work" shall mean the work of authorship, whether in Source or + Object form, made available under the License, as indicated by a + copyright notice that is included in or attached to the work + (an example is provided in the Appendix below). + + "Derivative Works" shall mean any work, whether in Source or Object + form, that is based on (or derived from) the Work and for which the + editorial revisions, annotations, elaborations, or other modifications + represent, as a whole, an original work of authorship. For the purposes + of this License, Derivative Works shall not include works that remain + separable from, or merely link (or bind by name) to the interfaces of, + the Work and Derivative Works thereof. + + "Contribution" shall mean any work of authorship, including + the original version of the Work and any modifications or additions + to that Work or Derivative Works thereof, that is intentionally + submitted to Licensor for inclusion in the Work by the copyright owner + or by an individual or Legal Entity authorized to submit on behalf of + the copyright owner. For the purposes of this definition, "submitted" + means any form of electronic, verbal, or written communication sent + to the Licensor or its representatives, including but not limited to + communication on electronic mailing lists, source code control systems, + and issue tracking systems that are managed by, or on behalf of, the + Licensor for the purpose of discussing and improving the Work, but + excluding communication that is conspicuously marked or otherwise + designated in writing by the copyright owner as "Not a Contribution." + + "Contributor" shall mean Licensor and any individual or Legal Entity + on behalf of whom a Contribution has been received by Licensor and + subsequently incorporated within the Work. + +2. Grant of Copyright License. Subject to the terms and conditions of + this License, each Contributor hereby grants to You a perpetual, + worldwide, non-exclusive, no-charge, royalty-free, irrevocable + copyright license to reproduce, prepare Derivative Works of, + publicly display, publicly perform, sublicense, and distribute the + Work and such Derivative Works in Source or Object form. + +3. Grant of Patent License. Subject to the terms and conditions of + this License, each Contributor hereby grants to You a perpetual, + worldwide, non-exclusive, no-charge, royalty-free, irrevocable + (except as stated in this section) patent license to make, have made, + use, offer to sell, sell, import, and otherwise transfer the Work, + where such license applies only to those patent claims licensable + by such Contributor that are necessarily infringed by their + Contribution(s) alone or by combination of their Contribution(s) + with the Work to which such Contribution(s) was submitted. If You + institute patent litigation against any entity (including a + cross-claim or counterclaim in a lawsuit) alleging that the Work + or a Contribution incorporated within the Work constitutes direct + or contributory patent infringement, then any patent licenses + granted to You under this License for that Work shall terminate + as of the date such litigation is filed. + +4. Redistribution. You may reproduce and distribute copies of the + Work or Derivative Works thereof in any medium, with or without + modifications, and in Source or Object form, provided that You + meet the following conditions: + + (a) You must give any other recipients of the Work or + Derivative Works a copy of this License; and + + (b) You must cause any modified files to carry prominent notices + stating that You changed the files; and + + (c) You must retain, in the Source form of any Derivative Works + that You distribute, all copyright, patent, trademark, and + attribution notices from the Source form of the Work, + excluding those notices that do not pertain to any part of + the Derivative Works; and + + (d) If the Work includes a "NOTICE" text file as part of its + distribution, then any Derivative Works that You distribute must + include a readable copy of the attribution notices contained + within such NOTICE file, excluding those notices that do not + pertain to any part of the Derivative Works, in at least one + of the following places: within a NOTICE text file distributed + as part of the Derivative Works; within the Source form or + documentation, if provided along with the Derivative Works; or, + within a display generated by the Derivative Works, if and + wherever such third-party notices normally appear. The contents + of the NOTICE file are for informational purposes only and + do not modify the License. You may add Your own attribution + notices within Derivative Works that You distribute, alongside + or as an addendum to the NOTICE text from the Work, provided + that such additional attribution notices cannot be construed + as modifying the License. + + You may add Your own copyright statement to Your modifications and + may provide additional or different license terms and conditions + for use, reproduction, or distribution of Your modifications, or + for any such Derivative Works as a whole, provided Your use, + reproduction, and distribution of the Work otherwise complies with + the conditions stated in this License. + +5. Submission of Contributions. Unless You explicitly state otherwise, + any Contribution intentionally submitted for inclusion in the Work + by You to the Licensor shall be under the terms and conditions of + this License, without any additional terms or conditions. + Notwithstanding the above, nothing herein shall supersede or modify + the terms of any separate license agreement you may have executed + with Licensor regarding such Contributions. + +6. Trademarks. This License does not grant permission to use the trade + names, trademarks, service marks, or product names of the Licensor, + except as required for reasonable and customary use in describing the + origin of the Work and reproducing the content of the NOTICE file. + +7. Disclaimer of Warranty. Unless required by applicable law or + agreed to in writing, Licensor provides the Work (and each + Contributor provides its Contributions) on an "AS IS" BASIS, + WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or + implied, including, without limitation, any warranties or conditions + of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A + PARTICULAR PURPOSE. You are solely responsible for determining the + appropriateness of using or redistributing the Work and assume any + risks associated with Your exercise of permissions under this License. + +8. Limitation of Liability. In no event and under no legal theory, + whether in tort (including negligence), contract, or otherwise, + unless required by applicable law (such as deliberate and grossly + negligent acts) or agreed to in writing, shall any Contributor be + liable to You for damages, including any direct, indirect, special, + incidental, or consequential damages of any character arising as a + result of this License or out of the use or inability to use the + Work (including but not limited to damages for loss of goodwill, + work stoppage, computer failure or malfunction, or any and all + other commercial damages or losses), even if such Contributor + has been advised of the possibility of such damages. + +9. Accepting Warranty or Additional Liability. While redistributing + the Work or Derivative Works thereof, You may choose to offer, + and charge a fee for, acceptance of support, warranty, indemnity, + or other liability obligations and/or rights consistent with this + License. However, in accepting such obligations, You may act only + on Your own behalf and on Your sole responsibility, not on behalf + of any other Contributor, and only if You agree to indemnify, + defend, and hold each Contributor harmless for any liability + incurred by, or claims asserted against, such Contributor by reason + of your accepting any such warranty or additional liability. + +END OF TERMS AND CONDITIONS + +APPENDIX: How to apply the Apache License to your work. To apply the Apache License to your work, attach the following boilerplate notice, with the fields enclosed by brackets "[]" @@ -985,87 +584,90 @@ Retry code until it succeeds same "printed page" as the copyright notice for easier identification within third-party archives. - Copyright [yyyy] [name of copyright owner] +Copyright [yyyy] [name of copyright owner] - Licensed under the Apache License, Version 2.0 (the "License"); - you may not use this file except in compliance with the License. - You may obtain a copy of the License at +Licensed under the Apache License, Version 2.0 (the "License"); +you may not use this file except in compliance with the License. +You may obtain a copy of the License at http://www.apache.org/licenses/LICENSE-2.0 - Unless required by applicable law or agreed to in writing, software - distributed under the License is distributed on an "AS IS" BASIS, - WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. - See the License for the specific language governing permissions and - limitations under the License. +Unless required by applicable law or agreed to in writing, software +distributed under the License is distributed on an "AS IS" BASIS, +WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +See the License for the specific language governing permissions and +limitations under the License. -packaging -21.3 -Apache Software License; BSD License -Donald Stufft and individual contributors -https://github.com/pypa/packaging -Core utilities for Python packages -This software is made available under the terms of *either* of the licenses -found in LICENSE.APACHE or LICENSE.BSD. Contributions to this software is made -under the terms of *both* these licenses. +cmaes +0.8.2 +MIT License +https://github.com/CyberAgent/cmaes +MIT License +Copyright (c) 2020-2021 CyberAgent, Inc. -MarkupSafe -2.1.1 -BSD License -Armin Ronacher -https://palletsprojects.com/p/markupsafe/ -Safely add untrusted strings to HTML/XML markup. -Copyright 2010 Pallets +Permission is hereby granted, free of charge, to any person obtaining a copy +of this software and associated documentation files (the "Software"), to deal +in the Software without restriction, including without limitation the rights +to use, copy, modify, merge, publish, distribute, sublicense, and/or sell +copies of the Software, and to permit persons to whom the Software is +furnished to do so, subject to the following conditions: -Redistribution and use in source and binary forms, with or without -modification, are permitted provided that the following conditions are -met: +The above copyright notice and this permission notice shall be included in all +copies or substantial portions of the Software. -1. Redistributions of source code must retain the above copyright - notice, this list of conditions and the following disclaimer. +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE +AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, +OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE +SOFTWARE. -2. Redistributions in binary form must reproduce the above copyright - notice, this list of conditions and the following disclaimer in the - documentation and/or other materials provided with the distribution. +cmd2 +2.4.1 +MIT License +https://github.com/python-cmd2/cmd2 +The MIT License (MIT) -3. Neither the name of the copyright holder nor the names of its - contributors may be used to endorse or promote products derived from - this software without specific prior written permission. +Copyright (c) 2008-2022 Catherine Devlin and others -THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS -"AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT -LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A -PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT -HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, -SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED -TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR -PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF -LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING -NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS -SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. +Permission is hereby granted, free of charge, to any person obtaining a copy +of this software and associated documentation files (the "Software"), to deal +in the Software without restriction, including without limitation the rights +to use, copy, modify, merge, publish, distribute, sublicense, and/or sell +copies of the Software, and to permit persons to whom the Software is +furnished to do so, subject to the following conditions: + +The above copyright notice and this permission notice shall be included in +all copies or substantial portions of the Software. +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE +AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, +OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN +THE SOFTWARE. colorama 0.4.5 BSD License -Jonathan Hartley https://github.com/tartley/colorama -Cross-platform colored terminal text. Copyright (c) 2010 Jonathan Hartley All rights reserved. Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met: -* Redistributions of source code must retain the above copyright notice, this +- Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer. -* Redistributions in binary form must reproduce the above copyright notice, +- Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution. -* Neither the name of the copyright holders, nor those of its contributors +- Neither the name of the copyright holders, nor those of its contributors may be used to endorse or promote products derived from this software without specific prior written permission. @@ -1080,13 +682,96 @@ CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. +colorlog +6.6.0 +MIT License +https://github.com/borntyping/python-colorlog +The MIT License (MIT) + +Copyright (c) 2012-2021 Sam Clements + +Permission is hereby granted, free of charge, to any person obtaining a copy of +this software and associated documentation files (the "Software"), to deal in +the Software without restriction, including without limitation the rights to +use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of +the Software, and to permit persons to whom the Software is furnished to do so, +subject to the following conditions: + +The above copyright notice and this permission notice shall be included in all +copies or substantial portions of the Software. + +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS +FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR +COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER +IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN +CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. + +gpytorch +1.8.0 +MIT +https://gpytorch.ai +MIT License + +Copyright (c) 2017 Jake Gardner + +Permission is hereby granted, free of charge, to any person obtaining a copy +of this software and associated documentation files (the "Software"), to deal +in the Software without restriction, including without limitation the rights +to use, copy, modify, merge, publish, distribute, sublicense, and/or sell +copies of the Software, and to permit persons to whom the Software is +furnished to do so, subject to the following conditions: + +The above copyright notice and this permission notice shall be included in all +copies or substantial portions of the Software. + +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE +AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, +OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE +SOFTWARE. + +greenlet +1.1.2 +MIT License +https://greenlet.readthedocs.io/ +The following files are derived from Stackless Python and are subject to the +same license as Stackless Python: + + src/greenlet/slp_platformselect.h + files in src/greenlet/platform/ directory + +See LICENSE.PSF and http://www.stackless.com/ for details. + +Unless otherwise noted, the files in greenlet have been released under the +following MIT license: + +Copyright (c) Armin Rigo, Christian Tismer and contributors + +Permission is hereby granted, free of charge, to any person obtaining a copy +of this software and associated documentation files (the "Software"), to deal +in the Software without restriction, including without limitation the rights +to use, copy, modify, merge, publish, distribute, sublicense, and/or sell +copies of the Software, and to permit persons to whom the Software is +furnished to do so, subject to the following conditions: + +The above copyright notice and this permission notice shall be included in +all copies or substantial portions of the Software. + +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE +AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, +OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN +THE SOFTWARE. joblib 1.1.0 BSD License -Gael Varoquaux https://joblib.readthedocs.io -Lightweight pipelining with Python functions BSD 3-Clause License Copyright (c) 2008-2021, The joblib developers. @@ -1095,14 +780,14 @@ All rights reserved. Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met: -* Redistributions of source code must retain the above copyright notice, this +- Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer. -* Redistributions in binary form must reproduce the above copyright notice, +- Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution. -* Neither the name of the copyright holder nor the names of its +- Neither the name of the copyright holder nor the names of its contributors may be used to endorse or promote products derived from this software without specific prior written permission. @@ -1117,13 +802,16 @@ CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. +multipledispatch +0.6.0 +BSD +http://github.com/mrocklin/multipledispatch/ +UNKNOWN numpy 1.23.0 BSD License -Travis E. Oliphant et al. https://www.numpy.org -NumPy is the fundamental package for array computing with Python. Copyright (c) 2005-2022, NumPy Developers. All rights reserved. @@ -1155,22 +843,21 @@ THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. ----- +--- This binary distribution of NumPy also bundles the following software: - Name: OpenBLAS -Files: extra-dll\libopenb*.dll +Files: extra-dll\libopenb\*.dll Description: bundled as a dynamically linked library Availability: https://github.com/xianyi/OpenBLAS/ License: 3-clause BSD - Copyright (c) 2011-2014, The OpenBLAS Project - All rights reserved. +Copyright (c) 2011-2014, The OpenBLAS Project +All rights reserved. - Redistribution and use in source and binary forms, with or without - modification, are permitted provided that the following conditions are - met: +Redistribution and use in source and binary forms, with or without +modification, are permitted provided that the following conditions are +met: 1. Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer. @@ -1184,164 +871,160 @@ License: 3-clause BSD derived from this software without specific prior written permission. - THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" - AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE - IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE - ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE - LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL - DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR - SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER - CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, - OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE - USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. - +THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" +AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE +IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE +ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE +LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL +DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR +SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER +CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, +OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE +USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. Name: LAPACK -Files: extra-dll\libopenb*.dll +Files: extra-dll\libopenb\*.dll Description: bundled in OpenBLAS Availability: https://github.com/xianyi/OpenBLAS/ License 3-clause BSD - Copyright (c) 1992-2013 The University of Tennessee and The University - of Tennessee Research Foundation. All rights - reserved. - Copyright (c) 2000-2013 The University of California Berkeley. All - rights reserved. - Copyright (c) 2006-2013 The University of Colorado Denver. All rights - reserved. +Copyright (c) 1992-2013 The University of Tennessee and The University +of Tennessee Research Foundation. All rights +reserved. +Copyright (c) 2000-2013 The University of California Berkeley. All +rights reserved. +Copyright (c) 2006-2013 The University of Colorado Denver. All rights +reserved. - $COPYRIGHT$ +$COPYRIGHT$ - Additional copyrights may follow +Additional copyrights may follow - $HEADER$ +$HEADER$ - Redistribution and use in source and binary forms, with or without - modification, are permitted provided that the following conditions are - met: +Redistribution and use in source and binary forms, with or without +modification, are permitted provided that the following conditions are +met: - - Redistributions of source code must retain the above copyright - notice, this list of conditions and the following disclaimer. +- Redistributions of source code must retain the above copyright + notice, this list of conditions and the following disclaimer. - - Redistributions in binary form must reproduce the above copyright - notice, this list of conditions and the following disclaimer listed - in this license in the documentation and/or other materials - provided with the distribution. +- Redistributions in binary form must reproduce the above copyright + notice, this list of conditions and the following disclaimer listed + in this license in the documentation and/or other materials + provided with the distribution. - - Neither the name of the copyright holders nor the names of its - contributors may be used to endorse or promote products derived from - this software without specific prior written permission. +- Neither the name of the copyright holders nor the names of its + contributors may be used to endorse or promote products derived from + this software without specific prior written permission. - The copyright holders provide no reassurances that the source code - provided does not infringe any patent, copyright, or any other - intellectual property rights of third parties. The copyright holders - disclaim any liability to any recipient for claims brought against - recipient by any third party for infringement of that parties - intellectual property rights. - - THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS - "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT - LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR - A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT - OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, - SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT - LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, - DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY - THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT - (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE - OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. +The copyright holders provide no reassurances that the source code +provided does not infringe any patent, copyright, or any other +intellectual property rights of third parties. The copyright holders +disclaim any liability to any recipient for claims brought against +recipient by any third party for infringement of that parties +intellectual property rights. +THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS +"AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT +LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR +A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT +OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, +SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT +LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, +DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY +THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT +(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE +OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. Name: GCC runtime library Files: extra-dll\*.dll Description: statically linked, in DLL files compiled with gfortran only Availability: https://gcc.gnu.org/viewcvs/gcc/ License: GPLv3 + runtime exception - Copyright (C) 2002-2017 Free Software Foundation, Inc. - - Libgfortran is free software; you can redistribute it and/or modify - it under the terms of the GNU General Public License as published by - the Free Software Foundation; either version 3, or (at your option) - any later version. +Copyright (C) 2002-2017 Free Software Foundation, Inc. - Libgfortran is distributed in the hope that it will be useful, - but WITHOUT ANY WARRANTY; without even the implied warranty of - MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the - GNU General Public License for more details. +Libgfortran is free software; you can redistribute it and/or modify +it under the terms of the GNU General Public License as published by +the Free Software Foundation; either version 3, or (at your option) +any later version. - Under Section 7 of GPL version 3, you are granted additional - permissions described in the GCC Runtime Library Exception, version - 3.1, as published by the Free Software Foundation. +Libgfortran is distributed in the hope that it will be useful, +but WITHOUT ANY WARRANTY; without even the implied warranty of +MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +GNU General Public License for more details. - You should have received a copy of the GNU General Public License and - a copy of the GCC Runtime Library Exception along with this program; - see the files COPYING3 and COPYING.RUNTIME respectively. If not, see - . +Under Section 7 of GPL version 3, you are granted additional +permissions described in the GCC Runtime Library Exception, version +3.1, as published by the Free Software Foundation. +You should have received a copy of the GNU General Public License and +a copy of the GCC Runtime Library Exception along with this program; +see the files COPYING3 and COPYING.RUNTIME respectively. If not, see +. Name: Microsoft Visual C++ Runtime Files Files: extra-dll\msvcp140.dll License: MSVC - https://www.visualstudio.com/license-terms/distributable-code-microsoft-visual-studio-2015-rc-microsoft-visual-studio-2015-sdk-rc-includes-utilities-buildserver-files/#visual-c-runtime +https://www.visualstudio.com/license-terms/distributable-code-microsoft-visual-studio-2015-rc-microsoft-visual-studio-2015-sdk-rc-includes-utilities-buildserver-files/#visual-c-runtime - Subject to the License Terms for the software, you may copy and - distribute with your program any of the files within the followng - folder and its subfolders except as noted below. You may not modify - these files. +Subject to the License Terms for the software, you may copy and +distribute with your program any of the files within the followng +folder and its subfolders except as noted below. You may not modify +these files. C:\Program Files (x86)\Microsoft Visual Studio 14.0\VC\redist - You may not distribute the contents of the following folders: +You may not distribute the contents of the following folders: C:\Program Files (x86)\Microsoft Visual Studio 14.0\VC\redist\debug_nonredist C:\Program Files (x86)\Microsoft Visual Studio 14.0\VC\redist\onecore\debug_nonredist - Subject to the License Terms for the software, you may copy and - distribute the following files with your program in your program’s - application local folder or by deploying them into the Global - Assembly Cache (GAC): - - VC\atlmfc\lib\mfcmifc80.dll - VC\atlmfc\lib\amd64\mfcmifc80.dll +Subject to the License Terms for the software, you may copy and +distribute the following files with your program in your program’s +application local folder or by deploying them into the Global +Assembly Cache (GAC): +VC\atlmfc\lib\mfcmifc80.dll +VC\atlmfc\lib\amd64\mfcmifc80.dll Name: Microsoft Visual C++ Runtime Files Files: extra-dll\msvc*90.dll, extra-dll\Microsoft.VC90.CRT.manifest License: MSVC - For your convenience, we have provided the following folders for - use when redistributing VC++ runtime files. Subject to the license - terms for the software, you may redistribute the folder - (unmodified) in the application local folder as a sub-folder with - no change to the folder name. You may also redistribute all the - files (*.dll and *.manifest) within a folder, listed below the - folder for your convenience, as an entire set. - - \VC\redist\x86\Microsoft.VC90.ATL\ - atl90.dll - Microsoft.VC90.ATL.manifest - \VC\redist\ia64\Microsoft.VC90.ATL\ - atl90.dll - Microsoft.VC90.ATL.manifest - \VC\redist\amd64\Microsoft.VC90.ATL\ - atl90.dll - Microsoft.VC90.ATL.manifest - \VC\redist\x86\Microsoft.VC90.CRT\ - msvcm90.dll - msvcp90.dll - msvcr90.dll - Microsoft.VC90.CRT.manifest - \VC\redist\ia64\Microsoft.VC90.CRT\ - msvcm90.dll - msvcp90.dll - msvcr90.dll - Microsoft.VC90.CRT.manifest - ----- +For your convenience, we have provided the following folders for +use when redistributing VC++ runtime files. Subject to the license +terms for the software, you may redistribute the folder +(unmodified) in the application local folder as a sub-folder with +no change to the folder name. You may also redistribute all the +files (*.dll and \*.manifest) within a folder, listed below the +folder for your convenience, as an entire set. + +\VC\redist\x86\Microsoft.VC90.ATL\ + atl90.dll +Microsoft.VC90.ATL.manifest +\VC\redist\ia64\Microsoft.VC90.ATL\ + atl90.dll +Microsoft.VC90.ATL.manifest +\VC\redist\amd64\Microsoft.VC90.ATL\ + atl90.dll +Microsoft.VC90.ATL.manifest +\VC\redist\x86\Microsoft.VC90.CRT\ + msvcm90.dll +msvcp90.dll +msvcr90.dll +Microsoft.VC90.CRT.manifest +\VC\redist\ia64\Microsoft.VC90.CRT\ + msvcm90.dll +msvcp90.dll +msvcr90.dll +Microsoft.VC90.CRT.manifest + +--- Full text of license texts referred to above follows (that they are listed below does not necessarily imply the conditions apply to the present binary release): ----- +--- GCC RUNTIME LIBRARY EXCEPTION @@ -1416,195 +1099,195 @@ The availability of this Exception does not imply any general presumption that third-party software is unaffected by the copyleft requirements of the license of GCC. ----- +--- GNU GENERAL PUBLIC LICENSE Version 3, 29 June 2007 - Copyright (C) 2007 Free Software Foundation, Inc. - Everyone is permitted to copy and distribute verbatim copies - of this license document, but changing it is not allowed. +Copyright (C) 2007 Free Software Foundation, Inc. +Everyone is permitted to copy and distribute verbatim copies +of this license document, but changing it is not allowed. Preamble - The GNU General Public License is a free, copyleft license for +The GNU General Public License is a free, copyleft license for software and other kinds of works. - The licenses for most software and other practical works are designed -to take away your freedom to share and change the works. By contrast, +The licenses for most software and other practical works are designed +to take away your freedom to share and change the works. By contrast, the GNU General Public License is intended to guarantee your freedom to share and change all versions of a program--to make sure it remains free -software for all its users. We, the Free Software Foundation, use the +software for all its users. We, the Free Software Foundation, use the GNU General Public License for most of our software; it applies also to -any other work released this way by its authors. You can apply it to +any other work released this way by its authors. You can apply it to your programs, too. - When we speak of free software, we are referring to freedom, not -price. Our General Public Licenses are designed to make sure that you +When we speak of free software, we are referring to freedom, not +price. Our General Public Licenses are designed to make sure that you have the freedom to distribute copies of free software (and charge for them if you wish), that you receive source code or can get it if you want it, that you can change the software or use pieces of it in new free programs, and that you know you can do these things. - To protect your rights, we need to prevent others from denying you -these rights or asking you to surrender the rights. Therefore, you have +To protect your rights, we need to prevent others from denying you +these rights or asking you to surrender the rights. Therefore, you have certain responsibilities if you distribute copies of the software, or if you modify it: responsibilities to respect the freedom of others. - For example, if you distribute copies of such a program, whether +For example, if you distribute copies of such a program, whether gratis or for a fee, you must pass on to the recipients the same -freedoms that you received. You must make sure that they, too, receive -or can get the source code. And you must show them these terms so they +freedoms that you received. You must make sure that they, too, receive +or can get the source code. And you must show them these terms so they know their rights. - Developers that use the GNU GPL protect your rights with two steps: +Developers that use the GNU GPL protect your rights with two steps: (1) assert copyright on the software, and (2) offer you this License giving you legal permission to copy, distribute and/or modify it. - For the developers' and authors' protection, the GPL clearly explains -that there is no warranty for this free software. For both users' and +For the developers' and authors' protection, the GPL clearly explains +that there is no warranty for this free software. For both users' and authors' sake, the GPL requires that modified versions be marked as changed, so that their problems will not be attributed erroneously to authors of previous versions. - Some devices are designed to deny users access to install or run +Some devices are designed to deny users access to install or run modified versions of the software inside them, although the manufacturer -can do so. This is fundamentally incompatible with the aim of -protecting users' freedom to change the software. The systematic +can do so. This is fundamentally incompatible with the aim of +protecting users' freedom to change the software. The systematic pattern of such abuse occurs in the area of products for individuals to -use, which is precisely where it is most unacceptable. Therefore, we +use, which is precisely where it is most unacceptable. Therefore, we have designed this version of the GPL to prohibit the practice for those -products. If such problems arise substantially in other domains, we +products. If such problems arise substantially in other domains, we stand ready to extend this provision to those domains in future versions of the GPL, as needed to protect the freedom of users. - Finally, every program is threatened constantly by software patents. +Finally, every program is threatened constantly by software patents. States should not allow patents to restrict development and use of software on general-purpose computers, but in those that do, we wish to avoid the special danger that patents applied to a free program could -make it effectively proprietary. To prevent this, the GPL assures that +make it effectively proprietary. To prevent this, the GPL assures that patents cannot be used to render the program non-free. - The precise terms and conditions for copying, distribution and +The precise terms and conditions for copying, distribution and modification follow. TERMS AND CONDITIONS - 0. Definitions. +0. Definitions. - "This License" refers to version 3 of the GNU General Public License. +"This License" refers to version 3 of the GNU General Public License. - "Copyright" also means copyright-like laws that apply to other kinds of +"Copyright" also means copyright-like laws that apply to other kinds of works, such as semiconductor masks. - "The Program" refers to any copyrightable work licensed under this -License. Each licensee is addressed as "you". "Licensees" and +"The Program" refers to any copyrightable work licensed under this +License. Each licensee is addressed as "you". "Licensees" and "recipients" may be individuals or organizations. - To "modify" a work means to copy from or adapt all or part of the work +To "modify" a work means to copy from or adapt all or part of the work in a fashion requiring copyright permission, other than the making of an -exact copy. The resulting work is called a "modified version" of the +exact copy. The resulting work is called a "modified version" of the earlier work or a work "based on" the earlier work. - A "covered work" means either the unmodified Program or a work based +A "covered work" means either the unmodified Program or a work based on the Program. - To "propagate" a work means to do anything with it that, without +To "propagate" a work means to do anything with it that, without permission, would make you directly or secondarily liable for infringement under applicable copyright law, except executing it on a -computer or modifying a private copy. Propagation includes copying, +computer or modifying a private copy. Propagation includes copying, distribution (with or without modification), making available to the public, and in some countries other activities as well. - To "convey" a work means any kind of propagation that enables other -parties to make or receive copies. Mere interaction with a user through +To "convey" a work means any kind of propagation that enables other +parties to make or receive copies. Mere interaction with a user through a computer network, with no transfer of a copy, is not conveying. - An interactive user interface displays "Appropriate Legal Notices" +An interactive user interface displays "Appropriate Legal Notices" to the extent that it includes a convenient and prominently visible feature that (1) displays an appropriate copyright notice, and (2) tells the user that there is no warranty for the work (except to the extent that warranties are provided), that licensees may convey the -work under this License, and how to view a copy of this License. If +work under this License, and how to view a copy of this License. If the interface presents a list of user commands or options, such as a menu, a prominent item in the list meets this criterion. - 1. Source Code. +1. Source Code. - The "source code" for a work means the preferred form of the work -for making modifications to it. "Object code" means any non-source +The "source code" for a work means the preferred form of the work +for making modifications to it. "Object code" means any non-source form of a work. - A "Standard Interface" means an interface that either is an official +A "Standard Interface" means an interface that either is an official standard defined by a recognized standards body, or, in the case of interfaces specified for a particular programming language, one that is widely used among developers working in that language. - The "System Libraries" of an executable work include anything, other +The "System Libraries" of an executable work include anything, other than the work as a whole, that (a) is included in the normal form of packaging a Major Component, but which is not part of that Major Component, and (b) serves only to enable use of the work with that Major Component, or to implement a Standard Interface for which an -implementation is available to the public in source code form. A +implementation is available to the public in source code form. A "Major Component", in this context, means a major essential component (kernel, window system, and so on) of the specific operating system (if any) on which the executable work runs, or a compiler used to produce the work, or an object code interpreter used to run it. - The "Corresponding Source" for a work in object code form means all +The "Corresponding Source" for a work in object code form means all the source code needed to generate, install, and (for an executable work) run the object code and to modify the work, including scripts to -control those activities. However, it does not include the work's +control those activities. However, it does not include the work's System Libraries, or general-purpose tools or generally available free programs which are used unmodified in performing those activities but -which are not part of the work. For example, Corresponding Source +which are not part of the work. For example, Corresponding Source includes interface definition files associated with source files for the work, and the source code for shared libraries and dynamically linked subprograms that the work is specifically designed to require, such as by intimate data communication or control flow between those subprograms and other parts of the work. - The Corresponding Source need not include anything that users +The Corresponding Source need not include anything that users can regenerate automatically from other parts of the Corresponding Source. - The Corresponding Source for a work in source code form is that +The Corresponding Source for a work in source code form is that same work. - 2. Basic Permissions. +2. Basic Permissions. - All rights granted under this License are granted for the term of +All rights granted under this License are granted for the term of copyright on the Program, and are irrevocable provided the stated -conditions are met. This License explicitly affirms your unlimited -permission to run the unmodified Program. The output from running a +conditions are met. This License explicitly affirms your unlimited +permission to run the unmodified Program. The output from running a covered work is covered by this License only if the output, given its -content, constitutes a covered work. This License acknowledges your +content, constitutes a covered work. This License acknowledges your rights of fair use or other equivalent, as provided by copyright law. - You may make, run and propagate covered works that you do not +You may make, run and propagate covered works that you do not convey, without conditions so long as your license otherwise remains -in force. You may convey covered works to others for the sole purpose +in force. You may convey covered works to others for the sole purpose of having them make modifications exclusively for you, or provide you with facilities for running those works, provided that you comply with the terms of this License in conveying all material for which you do -not control copyright. Those thus making or running the covered works +not control copyright. Those thus making or running the covered works for you must do so exclusively on your behalf, under your direction and control, on terms that prohibit them from making any copies of your copyrighted material outside their relationship with you. - Conveying under any other circumstances is permitted solely under -the conditions stated below. Sublicensing is not allowed; section 10 +Conveying under any other circumstances is permitted solely under +the conditions stated below. Sublicensing is not allowed; section 10 makes it unnecessary. - 3. Protecting Users' Legal Rights From Anti-Circumvention Law. +3. Protecting Users' Legal Rights From Anti-Circumvention Law. - No covered work shall be deemed part of an effective technological +No covered work shall be deemed part of an effective technological measure under any applicable law fulfilling obligations under article 11 of the WIPO copyright treaty adopted on 20 December 1996, or similar laws prohibiting or restricting circumvention of such measures. - When you convey a covered work, you waive any legal power to forbid +When you convey a covered work, you waive any legal power to forbid circumvention of technological measures to the extent such circumvention is effected by exercising rights under this License with respect to the covered work, and you disclaim any intention to limit operation or @@ -1612,9 +1295,9 @@ modification of the work as a means of enforcing, against the work's users, your or third parties' legal rights to forbid circumvention of technological measures. - 4. Conveying Verbatim Copies. +4. Conveying Verbatim Copies. - You may convey verbatim copies of the Program's source code as you +You may convey verbatim copies of the Program's source code as you receive it, in any medium, provided that you conspicuously and appropriately publish on each copy an appropriate copyright notice; keep intact all notices stating that this License and any @@ -1622,12 +1305,12 @@ non-permissive terms added in accord with section 7 apply to the code; keep intact all notices of the absence of any warranty; and give all recipients a copy of this License along with the Program. - You may charge any price or no price for each copy that you convey, +You may charge any price or no price for each copy that you convey, and you may offer support or warranty protection for a fee. - 5. Conveying Modified Source Versions. +5. Conveying Modified Source Versions. - You may convey a work based on the Program, or the modifications to +You may convey a work based on the Program, or the modifications to produce it from the Program, in the form of source code under the terms of section 4, provided that you also meet all of these conditions: @@ -1652,19 +1335,19 @@ terms of section 4, provided that you also meet all of these conditions: interfaces that do not display Appropriate Legal Notices, your work need not make them do so. - A compilation of a covered work with other separate and independent +A compilation of a covered work with other separate and independent works, which are not by their nature extensions of the covered work, and which are not combined with it such as to form a larger program, in or on a volume of a storage or distribution medium, is called an "aggregate" if the compilation and its resulting copyright are not used to limit the access or legal rights of the compilation's users -beyond what the individual works permit. Inclusion of a covered work +beyond what the individual works permit. Inclusion of a covered work in an aggregate does not cause this License to apply to the other parts of the aggregate. - 6. Conveying Non-Source Forms. +6. Conveying Non-Source Forms. - You may convey a covered work in object code form under the terms +You may convey a covered work in object code form under the terms of sections 4 and 5, provided that you also convey the machine-readable Corresponding Source under the terms of this License, in one of these ways: @@ -1710,75 +1393,75 @@ in one of these ways: Source of the work are being offered to the general public at no charge under subsection 6d. - A separable portion of the object code, whose source code is excluded +A separable portion of the object code, whose source code is excluded from the Corresponding Source as a System Library, need not be included in conveying the object code work. - A "User Product" is either (1) a "consumer product", which means any +A "User Product" is either (1) a "consumer product", which means any tangible personal property which is normally used for personal, family, or household purposes, or (2) anything designed or sold for incorporation -into a dwelling. In determining whether a product is a consumer product, -doubtful cases shall be resolved in favor of coverage. For a particular +into a dwelling. In determining whether a product is a consumer product, +doubtful cases shall be resolved in favor of coverage. For a particular product received by a particular user, "normally used" refers to a typical or common use of that class of product, regardless of the status of the particular user or of the way in which the particular user -actually uses, or expects or is expected to use, the product. A product +actually uses, or expects or is expected to use, the product. A product is a consumer product regardless of whether the product has substantial commercial, industrial or non-consumer uses, unless such uses represent the only significant mode of use of the product. - "Installation Information" for a User Product means any methods, +"Installation Information" for a User Product means any methods, procedures, authorization keys, or other information required to install and execute modified versions of a covered work in that User Product from -a modified version of its Corresponding Source. The information must +a modified version of its Corresponding Source. The information must suffice to ensure that the continued functioning of the modified object code is in no case prevented or interfered with solely because modification has been made. - If you convey an object code work under this section in, or with, or +If you convey an object code work under this section in, or with, or specifically for use in, a User Product, and the conveying occurs as part of a transaction in which the right of possession and use of the User Product is transferred to the recipient in perpetuity or for a fixed term (regardless of how the transaction is characterized), the Corresponding Source conveyed under this section must be accompanied -by the Installation Information. But this requirement does not apply +by the Installation Information. But this requirement does not apply if neither you nor any third party retains the ability to install modified object code on the User Product (for example, the work has been installed in ROM). - The requirement to provide Installation Information does not include a +The requirement to provide Installation Information does not include a requirement to continue to provide support service, warranty, or updates for a work that has been modified or installed by the recipient, or for -the User Product in which it has been modified or installed. Access to a +the User Product in which it has been modified or installed. Access to a network may be denied when the modification itself materially and adversely affects the operation of the network or violates the rules and protocols for communication across the network. - Corresponding Source conveyed, and Installation Information provided, +Corresponding Source conveyed, and Installation Information provided, in accord with this section must be in a format that is publicly documented (and with an implementation available to the public in source code form), and must require no special password or key for unpacking, reading or copying. - 7. Additional Terms. +7. Additional Terms. - "Additional permissions" are terms that supplement the terms of this +"Additional permissions" are terms that supplement the terms of this License by making exceptions from one or more of its conditions. Additional permissions that are applicable to the entire Program shall be treated as though they were included in this License, to the extent -that they are valid under applicable law. If additional permissions +that they are valid under applicable law. If additional permissions apply only to part of the Program, that part may be used separately under those permissions, but the entire Program remains governed by this License without regard to the additional permissions. - When you convey a copy of a covered work, you may at your option +When you convey a copy of a covered work, you may at your option remove any additional permissions from that copy, or from any part of -it. (Additional permissions may be written to require their own -removal in certain cases when you modify the work.) You may place +it. (Additional permissions may be written to require their own +removal in certain cases when you modify the work.) You may place additional permissions on material, added by you to a covered work, for which you have or can give appropriate copyright permission. - Notwithstanding any other provision of this License, for material you +Notwithstanding any other provision of this License, for material you add to a covered work, you may (if authorized by the copyright holders of that material) supplement the terms of this License with terms: @@ -1805,74 +1488,74 @@ that material) supplement the terms of this License with terms: any liability that these contractual assumptions directly impose on those licensors and authors. - All other non-permissive additional terms are considered "further -restrictions" within the meaning of section 10. If the Program as you +All other non-permissive additional terms are considered "further +restrictions" within the meaning of section 10. If the Program as you received it, or any part of it, contains a notice stating that it is governed by this License along with a term that is a further -restriction, you may remove that term. If a license document contains +restriction, you may remove that term. If a license document contains a further restriction but permits relicensing or conveying under this License, you may add to a covered work material governed by the terms of that license document, provided that the further restriction does not survive such relicensing or conveying. - If you add terms to a covered work in accord with this section, you +If you add terms to a covered work in accord with this section, you must place, in the relevant source files, a statement of the additional terms that apply to those files, or a notice indicating where to find the applicable terms. - Additional terms, permissive or non-permissive, may be stated in the +Additional terms, permissive or non-permissive, may be stated in the form of a separately written license, or stated as exceptions; the above requirements apply either way. - 8. Termination. +8. Termination. - You may not propagate or modify a covered work except as expressly -provided under this License. Any attempt otherwise to propagate or +You may not propagate or modify a covered work except as expressly +provided under this License. Any attempt otherwise to propagate or modify it is void, and will automatically terminate your rights under this License (including any patent licenses granted under the third paragraph of section 11). - However, if you cease all violation of this License, then your +However, if you cease all violation of this License, then your license from a particular copyright holder is reinstated (a) provisionally, unless and until the copyright holder explicitly and finally terminates your license, and (b) permanently, if the copyright holder fails to notify you of the violation by some reasonable means prior to 60 days after the cessation. - Moreover, your license from a particular copyright holder is +Moreover, your license from a particular copyright holder is reinstated permanently if the copyright holder notifies you of the violation by some reasonable means, this is the first time you have received notice of violation of this License (for any work) from that copyright holder, and you cure the violation prior to 30 days after your receipt of the notice. - Termination of your rights under this section does not terminate the +Termination of your rights under this section does not terminate the licenses of parties who have received copies or rights from you under -this License. If your rights have been terminated and not permanently +this License. If your rights have been terminated and not permanently reinstated, you do not qualify to receive new licenses for the same material under section 10. - 9. Acceptance Not Required for Having Copies. +9. Acceptance Not Required for Having Copies. - You are not required to accept this License in order to receive or -run a copy of the Program. Ancillary propagation of a covered work +You are not required to accept this License in order to receive or +run a copy of the Program. Ancillary propagation of a covered work occurring solely as a consequence of using peer-to-peer transmission -to receive a copy likewise does not require acceptance. However, +to receive a copy likewise does not require acceptance. However, nothing other than this License grants you permission to propagate or -modify any covered work. These actions infringe copyright if you do -not accept this License. Therefore, by modifying or propagating a +modify any covered work. These actions infringe copyright if you do +not accept this License. Therefore, by modifying or propagating a covered work, you indicate your acceptance of this License to do so. - 10. Automatic Licensing of Downstream Recipients. +10. Automatic Licensing of Downstream Recipients. - Each time you convey a covered work, the recipient automatically +Each time you convey a covered work, the recipient automatically receives a license from the original licensors, to run, modify and -propagate that work, subject to this License. You are not responsible +propagate that work, subject to this License. You are not responsible for enforcing compliance by third parties with this License. - An "entity transaction" is a transaction transferring control of an +An "entity transaction" is a transaction transferring control of an organization, or substantially all assets of one, or subdividing an -organization, or merging organizations. If propagation of a covered +organization, or merging organizations. If propagation of a covered work results from an entity transaction, each party to that transaction who receives a copy of the work also receives whatever licenses to the work the party's predecessor in interest had or could @@ -1880,43 +1563,43 @@ give under the previous paragraph, plus a right to possession of the Corresponding Source of the work from the predecessor in interest, if the predecessor has it or can get it with reasonable efforts. - You may not impose any further restrictions on the exercise of the -rights granted or affirmed under this License. For example, you may +You may not impose any further restrictions on the exercise of the +rights granted or affirmed under this License. For example, you may not impose a license fee, royalty, or other charge for exercise of rights granted under this License, and you may not initiate litigation (including a cross-claim or counterclaim in a lawsuit) alleging that any patent claim is infringed by making, using, selling, offering for sale, or importing the Program or any portion of it. - 11. Patents. +11. Patents. - A "contributor" is a copyright holder who authorizes use under this -License of the Program or a work on which the Program is based. The +A "contributor" is a copyright holder who authorizes use under this +License of the Program or a work on which the Program is based. The work thus licensed is called the contributor's "contributor version". - A contributor's "essential patent claims" are all patent claims +A contributor's "essential patent claims" are all patent claims owned or controlled by the contributor, whether already acquired or hereafter acquired, that would be infringed by some manner, permitted by this License, of making, using, or selling its contributor version, but do not include claims that would be infringed only as a -consequence of further modification of the contributor version. For +consequence of further modification of the contributor version. For purposes of this definition, "control" includes the right to grant patent sublicenses in a manner consistent with the requirements of this License. - Each contributor grants you a non-exclusive, worldwide, royalty-free +Each contributor grants you a non-exclusive, worldwide, royalty-free patent license under the contributor's essential patent claims, to make, use, sell, offer for sale, import and otherwise run, modify and propagate the contents of its contributor version. - In the following three paragraphs, a "patent license" is any express +In the following three paragraphs, a "patent license" is any express agreement or commitment, however denominated, not to enforce a patent (such as an express permission to practice a patent or covenant not to -sue for patent infringement). To "grant" such a patent license to a +sue for patent infringement). To "grant" such a patent license to a party means to make such an agreement or commitment not to enforce a patent against the party. - If you convey a covered work, knowingly relying on a patent license, +If you convey a covered work, knowingly relying on a patent license, and the Corresponding Source of the work is not available for anyone to copy, free of charge and under the terms of this License, through a publicly available network server or other readily accessible means, @@ -1924,13 +1607,13 @@ then you must either (1) cause the Corresponding Source to be so available, or (2) arrange to deprive yourself of the benefit of the patent license for this particular work, or (3) arrange, in a manner consistent with the requirements of this License, to extend the patent -license to downstream recipients. "Knowingly relying" means you have +license to downstream recipients. "Knowingly relying" means you have actual knowledge that, but for the patent license, your conveying the covered work in a country, or your recipient's use of the covered work in a country, would infringe one or more identifiable patents in that country that you have reason to believe are valid. - If, pursuant to or in connection with a single transaction or +If, pursuant to or in connection with a single transaction or arrangement, you convey, or propagate by procuring conveyance of, a covered work, and grant a patent license to some of the parties receiving the covered work authorizing them to use, propagate, modify @@ -1938,10 +1621,10 @@ or convey a specific copy of the covered work, then the patent license you grant is automatically extended to all recipients of the covered work and works based on it. - A patent license is "discriminatory" if it does not include within +A patent license is "discriminatory" if it does not include within the scope of its coverage, prohibits the exercise of, or is conditioned on the non-exercise of one or more of the rights that are -specifically granted under this License. You may not convey a covered +specifically granted under this License. You may not convey a covered work if you are a party to an arrangement with a third party that is in the business of distributing software, under which you make payment to the third party based on the extent of your activity of conveying @@ -1953,73 +1636,73 @@ for and in connection with specific products or compilations that contain the covered work, unless you entered into that arrangement, or that patent license was granted, prior to 28 March 2007. - Nothing in this License shall be construed as excluding or limiting +Nothing in this License shall be construed as excluding or limiting any implied license or other defenses to infringement that may otherwise be available to you under applicable patent law. - 12. No Surrender of Others' Freedom. +12. No Surrender of Others' Freedom. - If conditions are imposed on you (whether by court order, agreement or +If conditions are imposed on you (whether by court order, agreement or otherwise) that contradict the conditions of this License, they do not -excuse you from the conditions of this License. If you cannot convey a +excuse you from the conditions of this License. If you cannot convey a covered work so as to satisfy simultaneously your obligations under this License and any other pertinent obligations, then as a consequence you may -not convey it at all. For example, if you agree to terms that obligate you +not convey it at all. For example, if you agree to terms that obligate you to collect a royalty for further conveying from those to whom you convey the Program, the only way you could satisfy both those terms and this License would be to refrain entirely from conveying the Program. - 13. Use with the GNU Affero General Public License. +13. Use with the GNU Affero General Public License. - Notwithstanding any other provision of this License, you have +Notwithstanding any other provision of this License, you have permission to link or combine any covered work with a work licensed under version 3 of the GNU Affero General Public License into a single -combined work, and to convey the resulting work. The terms of this +combined work, and to convey the resulting work. The terms of this License will continue to apply to the part which is the covered work, but the special requirements of the GNU Affero General Public License, section 13, concerning interaction through a network will apply to the combination as such. - 14. Revised Versions of this License. +14. Revised Versions of this License. - The Free Software Foundation may publish revised and/or new versions of -the GNU General Public License from time to time. Such new versions will +The Free Software Foundation may publish revised and/or new versions of +the GNU General Public License from time to time. Such new versions will be similar in spirit to the present version, but may differ in detail to address new problems or concerns. - Each version is given a distinguishing version number. If the +Each version is given a distinguishing version number. If the Program specifies that a certain numbered version of the GNU General Public License "or any later version" applies to it, you have the option of following the terms and conditions either of that numbered version or of any later version published by the Free Software -Foundation. If the Program does not specify a version number of the +Foundation. If the Program does not specify a version number of the GNU General Public License, you may choose any version ever published by the Free Software Foundation. - If the Program specifies that a proxy can decide which future +If the Program specifies that a proxy can decide which future versions of the GNU General Public License can be used, that proxy's public statement of acceptance of a version permanently authorizes you to choose that version for the Program. - Later license versions may give you additional or different -permissions. However, no additional obligations are imposed on any +Later license versions may give you additional or different +permissions. However, no additional obligations are imposed on any author or copyright holder as a result of your choosing to follow a later version. - 15. Disclaimer of Warranty. +15. Disclaimer of Warranty. - THERE IS NO WARRANTY FOR THE PROGRAM, TO THE EXTENT PERMITTED BY -APPLICABLE LAW. EXCEPT WHEN OTHERWISE STATED IN WRITING THE COPYRIGHT +THERE IS NO WARRANTY FOR THE PROGRAM, TO THE EXTENT PERMITTED BY +APPLICABLE LAW. EXCEPT WHEN OTHERWISE STATED IN WRITING THE COPYRIGHT HOLDERS AND/OR OTHER PARTIES PROVIDE THE PROGRAM "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR -PURPOSE. THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE PROGRAM -IS WITH YOU. SHOULD THE PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF +PURPOSE. THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE PROGRAM +IS WITH YOU. SHOULD THE PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF ALL NECESSARY SERVICING, REPAIR OR CORRECTION. - 16. Limitation of Liability. +16. Limitation of Liability. - IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING +IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MODIFIES AND/OR CONVEYS THE PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES, INCLUDING ANY GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE @@ -2029,9 +1712,9 @@ PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER PROGRAMS), EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES. - 17. Interpretation of Sections 15 and 16. +17. Interpretation of Sections 15 and 16. - If the disclaimer of warranty and limitation of liability provided +If the disclaimer of warranty and limitation of liability provided above cannot be given local legal effect according to their terms, reviewing courts shall apply local law that most closely approximates an absolute waiver of all civil liability in connection with the @@ -2042,11 +1725,11 @@ copy of the Program in return for a fee. How to Apply These Terms to Your New Programs - If you develop a new program, and you want it to be of the greatest +If you develop a new program, and you want it to be of the greatest possible use to the public, the best way to achieve this is to make it free software which everyone can redistribute and change under these terms. - To do so, attach the following notices to the program. It is safest +To do so, attach the following notices to the program. It is safest to attach them to the start of each source file to most effectively state the exclusion of warranty; and each file should have at least the "copyright" line and a pointer to where the full notice is found. @@ -2069,7 +1752,7 @@ the "copyright" line and a pointer to where the full notice is found. Also add information on how to contact you by electronic and paper mail. - If the program does terminal interaction, make it output a short +If the program does terminal interaction, make it output a short notice like this when it starts in an interactive mode: Copyright (C) @@ -2078,1422 +1761,1913 @@ notice like this when it starts in an interactive mode: under certain conditions; type `show c' for details. The hypothetical commands `show w' and `show c' should show the appropriate -parts of the General Public License. Of course, your program's commands +parts of the General Public License. Of course, your program's commands might be different; for a GUI interface, you would use an "about box". - You should also get your employer (if you work as a programmer) or school, +You should also get your employer (if you work as a programmer) or school, if any, to sign a "copyright disclaimer" for the program, if necessary. For more information on this, and how to apply and follow the GNU GPL, see . - The GNU General Public License does not permit incorporating your program -into proprietary programs. If your program is a subroutine library, you +The GNU General Public License does not permit incorporating your program +into proprietary programs. If your program is a subroutine library, you may consider it more useful to permit linking proprietary applications with -the library. If this is what you want to do, use the GNU Lesser General -Public License instead of this License. But first, please read +the library. If this is what you want to do, use the GNU Lesser General +Public License instead of this License. But first, please read . -prettytable +opt-einsum 3.3.0 -BSD License -Luke Maurits -https://github.com/jazzband/prettytable -A simple Python library for easily displaying tabular data in a visually appealing ASCII table format -# Copyright (c) 2009-2014 Luke Maurits -# All rights reserved. -# With contributions from: -# * Chris Clark -# * Klein Stephane -# * John Filleau -# * Vladimir Vrzić -# -# Redistribution and use in source and binary forms, with or without -# modification, are permitted provided that the following conditions are met: -# -# * Redistributions of source code must retain the above copyright notice, -# this list of conditions and the following disclaimer. -# * Redistributions in binary form must reproduce the above copyright notice, -# this list of conditions and the following disclaimer in the documentation -# and/or other materials provided with the distribution. -# * The name of the author may not be used to endorse or promote products -# derived from this software without specific prior written permission. -# -# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" -# AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE -# IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE -# ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE -# LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR -# CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF -# SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS -# INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN -# CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) -# ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE -# POSSIBILITY OF SUCH DAMAGE. - - -pyperclip -1.8.2 -BSD License -Al Sweigart -https://github.com/asweigart/pyperclip -A cross-platform clipboard module for Python. (Only handles plain text for now.) -Copyright (c) 2014, Al Sweigart -All rights reserved. +MIT +https://github.com/dgasmith/opt_einsum +The MIT License (MIT) -Redistribution and use in source and binary forms, with or without -modification, are permitted provided that the following conditions are met: +Copyright (c) 2014 Daniel Smith -* Redistributions of source code must retain the above copyright notice, this - list of conditions and the following disclaimer. +Permission is hereby granted, free of charge, to any person obtaining a copy +of this software and associated documentation files (the "Software"), to deal +in the Software without restriction, including without limitation the rights +to use, copy, modify, merge, publish, distribute, sublicense, and/or sell +copies of the Software, and to permit persons to whom the Software is +furnished to do so, subject to the following conditions: -* Redistributions in binary form must reproduce the above copyright notice, - this list of conditions and the following disclaimer in the documentation - and/or other materials provided with the distribution. +The above copyright notice and this permission notice shall be included in all +copies or substantial portions of the Software. -* Neither the name of the {organization} nor the names of its - contributors may be used to endorse or promote products derived from - this software without specific prior written permission. +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE +AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, +OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE +SOFTWARE. -THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" -AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE -IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE -DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE -FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL -DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR -SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER -CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, -OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE -OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. +optuna +2.10.1 +MIT License +https://optuna.org/ +MIT License +Copyright (c) 2018 Preferred Networks, Inc. -pyreadline3 -3.4.1 -BSD License -Bassem Girgis -https://pypi.python.org/pypi/pyreadline3/ -A python implementation of GNU readline. -# LICENSE +Permission is hereby granted, free of charge, to any person obtaining a copy +of this software and associated documentation files (the "Software"), to deal +in the Software without restriction, including without limitation the rights +to use, copy, modify, merge, publish, distribute, sublicense, and/or sell +copies of the Software, and to permit persons to whom the Software is +furnished to do so, subject to the following conditions: -## pyreadline3 copyright and licensing notes +The above copyright notice and this permission notice shall be included in all +copies or substantial portions of the Software. -Unless indicated otherwise, files in this project are covered by a BSD-type -license, included below. +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE +AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, +OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE +SOFTWARE. -Individual authors are the holders of the copyright for their code and are -listed in each file. - -Some files may be licensed under different conditions. Ultimately each file -indicates clearly the conditions under which its author/authors have -decided to publish the code. - -## pyreadline3 license +optuna-dashboard +0.7.1 +MIT License +https://github.com/optuna/optuna-dashboard +MIT License -pyreadline3 is released under a BSD-type license. +Copyright (c) 2020-2021 Masashi SHIBATA -Copyright (c) 2020 Bassem Girgis . +Permission is hereby granted, free of charge, to any person obtaining a copy +of this software and associated documentation files (the "Software"), to deal +in the Software without restriction, including without limitation the rights +to use, copy, modify, merge, publish, distribute, sublicense, and/or sell +copies of the Software, and to permit persons to whom the Software is +furnished to do so, subject to the following conditions: -Copyright (c) 2006-2020 J�rgen Stenarson . +The above copyright notice and this permission notice shall be included in all +copies or substantial portions of the Software. -Copyright (c) 2003-2006 Gary Bishop +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE +AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, +OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE +SOFTWARE. -Copyright (c) 2003-2006 Jack Trainor +packaging +21.3 +Apache Software License; BSD License +https://github.com/pypa/packaging +This software is made available under the terms of _either_ of the licenses +found in LICENSE.APACHE or LICENSE.BSD. Contributions to this software is made +under the terms of _both_ these licenses. -All rights reserved. +pbr +5.9.0 +Apache Software License +https://docs.openstack.org/pbr/latest/ -Redistribution and use in source and binary forms, with or without -modification, are permitted provided that the following conditions are met: + Apache License + Version 2.0, January 2004 + http://www.apache.org/licenses/ -a. Redistributions of source code must retain the above copyright notice, - this list of conditions and the following disclaimer. +TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION + +1. Definitions. + + "License" shall mean the terms and conditions for use, reproduction, + and distribution as defined by Sections 1 through 9 of this document. + + "Licensor" shall mean the copyright owner or entity authorized by + the copyright owner that is granting the License. + + "Legal Entity" shall mean the union of the acting entity and all + other entities that control, are controlled by, or are under common + control with that entity. For the purposes of this definition, + "control" means (i) the power, direct or indirect, to cause the + direction or management of such entity, whether by contract or + otherwise, or (ii) ownership of fifty percent (50%) or more of the + outstanding shares, or (iii) beneficial ownership of such entity. + + "You" (or "Your") shall mean an individual or Legal Entity + exercising permissions granted by this License. + + "Source" form shall mean the preferred form for making modifications, + including but not limited to software source code, documentation + source, and configuration files. + + "Object" form shall mean any form resulting from mechanical + transformation or translation of a Source form, including but + not limited to compiled object code, generated documentation, + and conversions to other media types. + + "Work" shall mean the work of authorship, whether in Source or + Object form, made available under the License, as indicated by a + copyright notice that is included in or attached to the work + (an example is provided in the Appendix below). + + "Derivative Works" shall mean any work, whether in Source or Object + form, that is based on (or derived from) the Work and for which the + editorial revisions, annotations, elaborations, or other modifications + represent, as a whole, an original work of authorship. For the purposes + of this License, Derivative Works shall not include works that remain + separable from, or merely link (or bind by name) to the interfaces of, + the Work and Derivative Works thereof. + + "Contribution" shall mean any work of authorship, including + the original version of the Work and any modifications or additions + to that Work or Derivative Works thereof, that is intentionally + submitted to Licensor for inclusion in the Work by the copyright owner + or by an individual or Legal Entity authorized to submit on behalf of + the copyright owner. For the purposes of this definition, "submitted" + means any form of electronic, verbal, or written communication sent + to the Licensor or its representatives, including but not limited to + communication on electronic mailing lists, source code control systems, + and issue tracking systems that are managed by, or on behalf of, the + Licensor for the purpose of discussing and improving the Work, but + excluding communication that is conspicuously marked or otherwise + designated in writing by the copyright owner as "Not a Contribution." + + "Contributor" shall mean Licensor and any individual or Legal Entity + on behalf of whom a Contribution has been received by Licensor and + subsequently incorporated within the Work. + +2. Grant of Copyright License. Subject to the terms and conditions of + this License, each Contributor hereby grants to You a perpetual, + worldwide, non-exclusive, no-charge, royalty-free, irrevocable + copyright license to reproduce, prepare Derivative Works of, + publicly display, publicly perform, sublicense, and distribute the + Work and such Derivative Works in Source or Object form. + +3. Grant of Patent License. Subject to the terms and conditions of + this License, each Contributor hereby grants to You a perpetual, + worldwide, non-exclusive, no-charge, royalty-free, irrevocable + (except as stated in this section) patent license to make, have made, + use, offer to sell, sell, import, and otherwise transfer the Work, + where such license applies only to those patent claims licensable + by such Contributor that are necessarily infringed by their + Contribution(s) alone or by combination of their Contribution(s) + with the Work to which such Contribution(s) was submitted. If You + institute patent litigation against any entity (including a + cross-claim or counterclaim in a lawsuit) alleging that the Work + or a Contribution incorporated within the Work constitutes direct + or contributory patent infringement, then any patent licenses + granted to You under this License for that Work shall terminate + as of the date such litigation is filed. + +4. Redistribution. You may reproduce and distribute copies of the + Work or Derivative Works thereof in any medium, with or without + modifications, and in Source or Object form, provided that You + meet the following conditions: + + (a) You must give any other recipients of the Work or + Derivative Works a copy of this License; and + + (b) You must cause any modified files to carry prominent notices + stating that You changed the files; and + + (c) You must retain, in the Source form of any Derivative Works + that You distribute, all copyright, patent, trademark, and + attribution notices from the Source form of the Work, + excluding those notices that do not pertain to any part of + the Derivative Works; and + + (d) If the Work includes a "NOTICE" text file as part of its + distribution, then any Derivative Works that You distribute must + include a readable copy of the attribution notices contained + within such NOTICE file, excluding those notices that do not + pertain to any part of the Derivative Works, in at least one + of the following places: within a NOTICE text file distributed + as part of the Derivative Works; within the Source form or + documentation, if provided along with the Derivative Works; or, + within a display generated by the Derivative Works, if and + wherever such third-party notices normally appear. The contents + of the NOTICE file are for informational purposes only and + do not modify the License. You may add Your own attribution + notices within Derivative Works that You distribute, alongside + or as an addendum to the NOTICE text from the Work, provided + that such additional attribution notices cannot be construed + as modifying the License. + + You may add Your own copyright statement to Your modifications and + may provide additional or different license terms and conditions + for use, reproduction, or distribution of Your modifications, or + for any such Derivative Works as a whole, provided Your use, + reproduction, and distribution of the Work otherwise complies with + the conditions stated in this License. + +5. Submission of Contributions. Unless You explicitly state otherwise, + any Contribution intentionally submitted for inclusion in the Work + by You to the Licensor shall be under the terms and conditions of + this License, without any additional terms or conditions. + Notwithstanding the above, nothing herein shall supersede or modify + the terms of any separate license agreement you may have executed + with Licensor regarding such Contributions. + +6. Trademarks. This License does not grant permission to use the trade + names, trademarks, service marks, or product names of the Licensor, + except as required for reasonable and customary use in describing the + origin of the Work and reproducing the content of the NOTICE file. + +7. Disclaimer of Warranty. Unless required by applicable law or + agreed to in writing, Licensor provides the Work (and each + Contributor provides its Contributions) on an "AS IS" BASIS, + WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or + implied, including, without limitation, any warranties or conditions + of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A + PARTICULAR PURPOSE. You are solely responsible for determining the + appropriateness of using or redistributing the Work and assume any + risks associated with Your exercise of permissions under this License. + +8. Limitation of Liability. In no event and under no legal theory, + whether in tort (including negligence), contract, or otherwise, + unless required by applicable law (such as deliberate and grossly + negligent acts) or agreed to in writing, shall any Contributor be + liable to You for damages, including any direct, indirect, special, + incidental, or consequential damages of any character arising as a + result of this License or out of the use or inability to use the + Work (including but not limited to damages for loss of goodwill, + work stoppage, computer failure or malfunction, or any and all + other commercial damages or losses), even if such Contributor + has been advised of the possibility of such damages. + +9. Accepting Warranty or Additional Liability. While redistributing + the Work or Derivative Works thereof, You may choose to offer, + and charge a fee for, acceptance of support, warranty, indemnity, + or other liability obligations and/or rights consistent with this + License. However, in accepting such obligations, You may act only + on Your own behalf and on Your sole responsibility, not on behalf + of any other Contributor, and only if You agree to indemnify, + defend, and hold each Contributor harmless for any liability + incurred by, or claims asserted against, such Contributor by reason + of your accepting any such warranty or additional liability. -b. Redistributions in binary form must reproduce the above copyright - notice, this list of conditions and the following disclaimer in the - documentation and/or other materials provided with the distribution. +plotly +5.9.0 +MIT +https://plotly.com/python/ +The MIT License (MIT) -c. Neither the name of the copyright holders nor the names of any - contributors to this software may be used to endorse or promote products - derived from this software without specific prior written permission. +Copyright (c) 2016-2018 Plotly, Inc +Permission is hereby granted, free of charge, to any person obtaining a copy +of this software and associated documentation files (the "Software"), to deal +in the Software without restriction, including without limitation the rights +to use, copy, modify, merge, publish, distribute, sublicense, and/or sell +copies of the Software, and to permit persons to whom the Software is +furnished to do so, subject to the following conditions: -THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" -AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE -IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE -ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE FOR -ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL -DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR -SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER -CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT -LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY -OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH -DAMAGE. +The above copyright notice and this permission notice shall be included in +all copies or substantial portions of the Software. +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE +AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, +OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN +THE SOFTWARE. -scipy -1.8.1 +prettytable +3.3.0 BSD License -UNKNOWN -https://www.scipy.org -SciPy: Scientific Library for Python -Copyright (c) 2001-2002 Enthought, Inc. 2003-2019, SciPy Developers. -All rights reserved. - -Redistribution and use in source and binary forms, with or without -modification, are permitted provided that the following conditions -are met: - -1. Redistributions of source code must retain the above copyright - notice, this list of conditions and the following disclaimer. +https://github.com/jazzband/prettytable -2. Redistributions in binary form must reproduce the above - copyright notice, this list of conditions and the following - disclaimer in the documentation and/or other materials provided - with the distribution. +# Copyright (c) 2009-2014 Luke Maurits -3. Neither the name of the copyright holder nor the names of its - contributors may be used to endorse or promote products derived - from this software without specific prior written permission. +# All rights reserved. -THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS -"AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT -LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR -A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT -OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, -SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT -LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, -DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY -THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT -(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE -OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. +# With contributions from: ----- +# \* Chris Clark -This binary distribution of Scipy also bundles the following software: +# \* Klein Stephane +# \* John Filleau -Name: OpenBLAS -Files: extra-dll\libopenb*.dll -Description: bundled as a dynamically linked library -Availability: https://github.com/xianyi/OpenBLAS/ -License: 3-clause BSD - Copyright (c) 2011-2014, The OpenBLAS Project - All rights reserved. - - Redistribution and use in source and binary forms, with or without - modification, are permitted provided that the following conditions are - met: - - 1. Redistributions of source code must retain the above copyright - notice, this list of conditions and the following disclaimer. - - 2. Redistributions in binary form must reproduce the above copyright - notice, this list of conditions and the following disclaimer in - the documentation and/or other materials provided with the - distribution. - 3. Neither the name of the OpenBLAS project nor the names of - its contributors may be used to endorse or promote products - derived from this software without specific prior written - permission. - - THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" - AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE - IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE - ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE - LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL - DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR - SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER - CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, - OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE - USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. +# \* Vladimir Vrzić +# -Name: LAPACK -Files: extra-dll\libopenb*.dll -Description: bundled in OpenBLAS -Availability: https://github.com/xianyi/OpenBLAS/ -License 3-clause BSD - Copyright (c) 1992-2013 The University of Tennessee and The University - of Tennessee Research Foundation. All rights - reserved. - Copyright (c) 2000-2013 The University of California Berkeley. All - rights reserved. - Copyright (c) 2006-2013 The University of Colorado Denver. All rights - reserved. - - $COPYRIGHT$ - - Additional copyrights may follow - - $HEADER$ - - Redistribution and use in source and binary forms, with or without - modification, are permitted provided that the following conditions are - met: - - - Redistributions of source code must retain the above copyright - notice, this list of conditions and the following disclaimer. - - - Redistributions in binary form must reproduce the above copyright - notice, this list of conditions and the following disclaimer listed - in this license in the documentation and/or other materials - provided with the distribution. - - - Neither the name of the copyright holders nor the names of its - contributors may be used to endorse or promote products derived from - this software without specific prior written permission. - - The copyright holders provide no reassurances that the source code - provided does not infringe any patent, copyright, or any other - intellectual property rights of third parties. The copyright holders - disclaim any liability to any recipient for claims brought against - recipient by any third party for infringement of that parties - intellectual property rights. - - THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS - "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT - LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR - A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT - OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, - SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT - LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, - DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY - THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT - (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE - OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. +# Redistribution and use in source and binary forms, with or without +# modification, are permitted provided that the following conditions are met: -Name: GCC runtime library -Files: extra-dll\*.dll -Description: statically linked, in DLL files compiled with gfortran only -Availability: https://gcc.gnu.org/viewcvs/gcc/ -License: GPLv3 + runtime exception - Copyright (C) 2002-2017 Free Software Foundation, Inc. - - Libgfortran is free software; you can redistribute it and/or modify - it under the terms of the GNU General Public License as published by - the Free Software Foundation; either version 3, or (at your option) - any later version. - - Libgfortran is distributed in the hope that it will be useful, - but WITHOUT ANY WARRANTY; without even the implied warranty of - MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the - GNU General Public License for more details. - - Under Section 7 of GPL version 3, you are granted additional - permissions described in the GCC Runtime Library Exception, version - 3.1, as published by the Free Software Foundation. - - You should have received a copy of the GNU General Public License and - a copy of the GCC Runtime Library Exception along with this program; - see the files COPYING3 and COPYING.RUNTIME respectively. If not, see - . +# +# \* Redistributions of source code must retain the above copyright notice, -Name: Microsoft Visual C++ Runtime Files -Files: extra-dll\msvcp140.dll -License: MSVC - https://www.visualstudio.com/license-terms/distributable-code-microsoft-visual-studio-2015-rc-microsoft-visual-studio-2015-sdk-rc-includes-utilities-buildserver-files/#visual-c-runtime +# this list of conditions and the following disclaimer. - Subject to the License Terms for the software, you may copy and - distribute with your program any of the files within the followng - folder and its subfolders except as noted below. You may not modify - these files. +# \* Redistributions in binary form must reproduce the above copyright notice, - C:\Program Files (x86)\Microsoft Visual Studio 14.0\VC\redist +# this list of conditions and the following disclaimer in the documentation - You may not distribute the contents of the following folders: +# and/or other materials provided with the distribution. - C:\Program Files (x86)\Microsoft Visual Studio 14.0\VC\redist\debug_nonredist - C:\Program Files (x86)\Microsoft Visual Studio 14.0\VC\redist\onecore\debug_nonredist +# \* The name of the author may not be used to endorse or promote products - Subject to the License Terms for the software, you may copy and - distribute the following files with your program in your program’s - application local folder or by deploying them into the Global - Assembly Cache (GAC): +# derived from this software without specific prior written permission. - VC\atlmfc\lib\mfcmifc80.dll - VC\atlmfc\lib\amd64\mfcmifc80.dll +# +# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" -Name: Microsoft Visual C++ Runtime Files -Files: extra-dll\msvc*90.dll, extra-dll\Microsoft.VC90.CRT.manifest -License: MSVC - For your convenience, we have provided the following folders for - use when redistributing VC++ runtime files. Subject to the license - terms for the software, you may redistribute the folder - (unmodified) in the application local folder as a sub-folder with - no change to the folder name. You may also redistribute all the - files (*.dll and *.manifest) within a folder, listed below the - folder for your convenience, as an entire set. - - \VC\redist\x86\Microsoft.VC90.ATL\ - atl90.dll - Microsoft.VC90.ATL.manifest - \VC\redist\ia64\Microsoft.VC90.ATL\ - atl90.dll - Microsoft.VC90.ATL.manifest - \VC\redist\amd64\Microsoft.VC90.ATL\ - atl90.dll - Microsoft.VC90.ATL.manifest - \VC\redist\x86\Microsoft.VC90.CRT\ - msvcm90.dll - msvcp90.dll - msvcr90.dll - Microsoft.VC90.CRT.manifest - \VC\redist\ia64\Microsoft.VC90.CRT\ - msvcm90.dll - msvcp90.dll - msvcr90.dll - Microsoft.VC90.CRT.manifest - ----- +# AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE -Full text of license texts referred to above follows (that they are -listed below does not necessarily imply the conditions apply to the -present binary release): +# IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ----- +# ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE -GCC RUNTIME LIBRARY EXCEPTION +# LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR -Version 3.1, 31 March 2009 +# CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF -Copyright (C) 2009 Free Software Foundation, Inc. +# SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS -Everyone is permitted to copy and distribute verbatim copies of this -license document, but changing it is not allowed. +# INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN -This GCC Runtime Library Exception ("Exception") is an additional -permission under section 7 of the GNU General Public License, version -3 ("GPLv3"). It applies to a given file (the "Runtime Library") that -bears a notice placed by the copyright holder of the file stating that -the file is governed by GPLv3 along with this Exception. +# CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) -When you use GCC to compile a program, GCC may combine portions of -certain GCC header files and runtime libraries with the compiled -program. The purpose of this Exception is to allow compilation of -non-GPL (including proprietary) programs to use, in this way, the -header files and runtime libraries covered by this Exception. +# ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE -0. Definitions. +# POSSIBILITY OF SUCH DAMAGE. -A file is an "Independent Module" if it either requires the Runtime -Library for execution after a Compilation Process, or makes use of an -interface provided by the Runtime Library, but is not otherwise based -on the Runtime Library. +pyparsing +3.0.9 +MIT License +UNKNOWN +Permission is hereby granted, free of charge, to any person obtaining +a copy of this software and associated documentation files (the +"Software"), to deal in the Software without restriction, including +without limitation the rights to use, copy, modify, merge, publish, +distribute, sublicense, and/or sell copies of the Software, and to +permit persons to whom the Software is furnished to do so, subject to +the following conditions: -"GCC" means a version of the GNU Compiler Collection, with or without -modifications, governed by version 3 (or a specified later version) of -the GNU General Public License (GPL) with the option of using any -subsequent versions published by the FSF. +The above copyright notice and this permission notice shall be +included in all copies or substantial portions of the Software. -"GPL-compatible Software" is software whose conditions of propagation, -modification and use would permit combination with GCC in accord with -the license of GCC. +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, +EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF +MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. +IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY +CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, +TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE +SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. -"Target Code" refers to output from any compiler for a real or virtual -target processor architecture, in executable form or suitable for -input to an assembler, loader, linker and/or execution -phase. Notwithstanding that, Target Code does not include data in any -format that is used as a compiler intermediate representation, or used -for producing a compiler intermediate representation. +pyperclip +1.8.2 +BSD License +https://github.com/asweigart/pyperclip +Copyright (c) 2014, Al Sweigart +All rights reserved. -The "Compilation Process" transforms code entirely represented in -non-intermediate languages designed for human-written code, and/or in -Java Virtual Machine byte code, into Target Code. Thus, for example, -use of source code generators and preprocessors need not be considered -part of the Compilation Process, since the Compilation Process can be -understood as starting with the output of the generators or -preprocessors. +Redistribution and use in source and binary forms, with or without +modification, are permitted provided that the following conditions are met: -A Compilation Process is "Eligible" if it is done using GCC, alone or -with other GPL-compatible software, or if it is done without using any -work based on GCC. For example, using non-GPL-compatible Software to -optimize any GCC intermediate representations would not qualify as an -Eligible Compilation Process. +- Redistributions of source code must retain the above copyright notice, this + list of conditions and the following disclaimer. -1. Grant of Additional Permission. +- Redistributions in binary form must reproduce the above copyright notice, + this list of conditions and the following disclaimer in the documentation + and/or other materials provided with the distribution. -You have permission to propagate a work of Target Code formed by -combining the Runtime Library with Independent Modules, even if such -propagation would otherwise violate the terms of GPLv3, provided that -all Target Code was generated by Eligible Compilation Processes. You -may then convey such a combination under terms of your choice, -consistent with the licensing of the Independent Modules. +- Neither the name of the {organization} nor the names of its + contributors may be used to endorse or promote products derived from + this software without specific prior written permission. -2. No Weakening of GCC Copyleft. - -The availability of this Exception does not imply any general -presumption that third-party software is unaffected by the copyleft -requirements of the license of GCC. +THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" +AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE +IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE +DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE +FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL +DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR +SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER +CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, +OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE +OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. ----- +pyreadline3 +3.4.1 +BSD License +https://pypi.python.org/pypi/pyreadline3/ - GNU GENERAL PUBLIC LICENSE - Version 3, 29 June 2007 +# LICENSE - Copyright (C) 2007 Free Software Foundation, Inc. - Everyone is permitted to copy and distribute verbatim copies - of this license document, but changing it is not allowed. +## pyreadline3 copyright and licensing notes - Preamble +Unless indicated otherwise, files in this project are covered by a BSD-type +license, included below. - The GNU General Public License is a free, copyleft license for -software and other kinds of works. +Individual authors are the holders of the copyright for their code and are +listed in each file. - The licenses for most software and other practical works are designed -to take away your freedom to share and change the works. By contrast, -the GNU General Public License is intended to guarantee your freedom to -share and change all versions of a program--to make sure it remains free -software for all its users. We, the Free Software Foundation, use the -GNU General Public License for most of our software; it applies also to -any other work released this way by its authors. You can apply it to -your programs, too. +Some files may be licensed under different conditions. Ultimately each file +indicates clearly the conditions under which its author/authors have +decided to publish the code. - When we speak of free software, we are referring to freedom, not -price. Our General Public Licenses are designed to make sure that you -have the freedom to distribute copies of free software (and charge for -them if you wish), that you receive source code or can get it if you -want it, that you can change the software or use pieces of it in new -free programs, and that you know you can do these things. +## pyreadline3 license - To protect your rights, we need to prevent others from denying you -these rights or asking you to surrender the rights. Therefore, you have -certain responsibilities if you distribute copies of the software, or if -you modify it: responsibilities to respect the freedom of others. +pyreadline3 is released under a BSD-type license. - For example, if you distribute copies of such a program, whether -gratis or for a fee, you must pass on to the recipients the same -freedoms that you received. You must make sure that they, too, receive -or can get the source code. And you must show them these terms so they -know their rights. +Copyright (c) 2020 Bassem Girgis . - Developers that use the GNU GPL protect your rights with two steps: -(1) assert copyright on the software, and (2) offer you this License -giving you legal permission to copy, distribute and/or modify it. +Copyright (c) 2006-2020 J�rgen Stenarson . - For the developers' and authors' protection, the GPL clearly explains -that there is no warranty for this free software. For both users' and -authors' sake, the GPL requires that modified versions be marked as -changed, so that their problems will not be attributed erroneously to -authors of previous versions. +Copyright (c) 2003-2006 Gary Bishop - Some devices are designed to deny users access to install or run -modified versions of the software inside them, although the manufacturer -can do so. This is fundamentally incompatible with the aim of -protecting users' freedom to change the software. The systematic -pattern of such abuse occurs in the area of products for individuals to -use, which is precisely where it is most unacceptable. Therefore, we -have designed this version of the GPL to prohibit the practice for those -products. If such problems arise substantially in other domains, we -stand ready to extend this provision to those domains in future versions -of the GPL, as needed to protect the freedom of users. +Copyright (c) 2003-2006 Jack Trainor - Finally, every program is threatened constantly by software patents. -States should not allow patents to restrict development and use of -software on general-purpose computers, but in those that do, we wish to -avoid the special danger that patents applied to a free program could -make it effectively proprietary. To prevent this, the GPL assures that -patents cannot be used to render the program non-free. +All rights reserved. - The precise terms and conditions for copying, distribution and -modification follow. +Redistribution and use in source and binary forms, with or without +modification, are permitted provided that the following conditions are met: - TERMS AND CONDITIONS +a. Redistributions of source code must retain the above copyright notice, +this list of conditions and the following disclaimer. - 0. Definitions. +b. Redistributions in binary form must reproduce the above copyright +notice, this list of conditions and the following disclaimer in the +documentation and/or other materials provided with the distribution. - "This License" refers to version 3 of the GNU General Public License. +c. Neither the name of the copyright holders nor the names of any +contributors to this software may be used to endorse or promote products +derived from this software without specific prior written permission. - "Copyright" also means copyright-like laws that apply to other kinds of -works, such as semiconductor masks. +THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" +AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE +IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE +ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE FOR +ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL +DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR +SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER +CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT +LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY +OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH +DAMAGE. - "The Program" refers to any copyrightable work licensed under this -License. Each licensee is addressed as "you". "Licensees" and -"recipients" may be individuals or organizations. +pyro-api +0.1.2 +Apache Software License +https://github.com/pyro-ppl/pyro-api - To "modify" a work means to copy from or adapt all or part of the work -in a fashion requiring copyright permission, other than the making of an -exact copy. The resulting work is called a "modified version" of the -earlier work or a work "based on" the earlier work. + Apache License + Version 2.0, January 2004 + http://www.apache.org/licenses/ - A "covered work" means either the unmodified Program or a work based -on the Program. +TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION + +1. Definitions. + + "License" shall mean the terms and conditions for use, reproduction, + and distribution as defined by Sections 1 through 9 of this document. + + "Licensor" shall mean the copyright owner or entity authorized by + the copyright owner that is granting the License. + + "Legal Entity" shall mean the union of the acting entity and all + other entities that control, are controlled by, or are under common + control with that entity. For the purposes of this definition, + "control" means (i) the power, direct or indirect, to cause the + direction or management of such entity, whether by contract or + otherwise, or (ii) ownership of fifty percent (50%) or more of the + outstanding shares, or (iii) beneficial ownership of such entity. + + "You" (or "Your") shall mean an individual or Legal Entity + exercising permissions granted by this License. + + "Source" form shall mean the preferred form for making modifications, + including but not limited to software source code, documentation + source, and configuration files. + + "Object" form shall mean any form resulting from mechanical + transformation or translation of a Source form, including but + not limited to compiled object code, generated documentation, + and conversions to other media types. + + "Work" shall mean the work of authorship, whether in Source or + Object form, made available under the License, as indicated by a + copyright notice that is included in or attached to the work + (an example is provided in the Appendix below). + + "Derivative Works" shall mean any work, whether in Source or Object + form, that is based on (or derived from) the Work and for which the + editorial revisions, annotations, elaborations, or other modifications + represent, as a whole, an original work of authorship. For the purposes + of this License, Derivative Works shall not include works that remain + separable from, or merely link (or bind by name) to the interfaces of, + the Work and Derivative Works thereof. + + "Contribution" shall mean any work of authorship, including + the original version of the Work and any modifications or additions + to that Work or Derivative Works thereof, that is intentionally + submitted to Licensor for inclusion in the Work by the copyright owner + or by an individual or Legal Entity authorized to submit on behalf of + the copyright owner. For the purposes of this definition, "submitted" + means any form of electronic, verbal, or written communication sent + to the Licensor or its representatives, including but not limited to + communication on electronic mailing lists, source code control systems, + and issue tracking systems that are managed by, or on behalf of, the + Licensor for the purpose of discussing and improving the Work, but + excluding communication that is conspicuously marked or otherwise + designated in writing by the copyright owner as "Not a Contribution." + + "Contributor" shall mean Licensor and any individual or Legal Entity + on behalf of whom a Contribution has been received by Licensor and + subsequently incorporated within the Work. + +2. Grant of Copyright License. Subject to the terms and conditions of + this License, each Contributor hereby grants to You a perpetual, + worldwide, non-exclusive, no-charge, royalty-free, irrevocable + copyright license to reproduce, prepare Derivative Works of, + publicly display, publicly perform, sublicense, and distribute the + Work and such Derivative Works in Source or Object form. + +3. Grant of Patent License. Subject to the terms and conditions of + this License, each Contributor hereby grants to You a perpetual, + worldwide, non-exclusive, no-charge, royalty-free, irrevocable + (except as stated in this section) patent license to make, have made, + use, offer to sell, sell, import, and otherwise transfer the Work, + where such license applies only to those patent claims licensable + by such Contributor that are necessarily infringed by their + Contribution(s) alone or by combination of their Contribution(s) + with the Work to which such Contribution(s) was submitted. If You + institute patent litigation against any entity (including a + cross-claim or counterclaim in a lawsuit) alleging that the Work + or a Contribution incorporated within the Work constitutes direct + or contributory patent infringement, then any patent licenses + granted to You under this License for that Work shall terminate + as of the date such litigation is filed. + +4. Redistribution. You may reproduce and distribute copies of the + Work or Derivative Works thereof in any medium, with or without + modifications, and in Source or Object form, provided that You + meet the following conditions: + + (a) You must give any other recipients of the Work or + Derivative Works a copy of this License; and + + (b) You must cause any modified files to carry prominent notices + stating that You changed the files; and + + (c) You must retain, in the Source form of any Derivative Works + that You distribute, all copyright, patent, trademark, and + attribution notices from the Source form of the Work, + excluding those notices that do not pertain to any part of + the Derivative Works; and + + (d) If the Work includes a "NOTICE" text file as part of its + distribution, then any Derivative Works that You distribute must + include a readable copy of the attribution notices contained + within such NOTICE file, excluding those notices that do not + pertain to any part of the Derivative Works, in at least one + of the following places: within a NOTICE text file distributed + as part of the Derivative Works; within the Source form or + documentation, if provided along with the Derivative Works; or, + within a display generated by the Derivative Works, if and + wherever such third-party notices normally appear. The contents + of the NOTICE file are for informational purposes only and + do not modify the License. You may add Your own attribution + notices within Derivative Works that You distribute, alongside + or as an addendum to the NOTICE text from the Work, provided + that such additional attribution notices cannot be construed + as modifying the License. + + You may add Your own copyright statement to Your modifications and + may provide additional or different license terms and conditions + for use, reproduction, or distribution of Your modifications, or + for any such Derivative Works as a whole, provided Your use, + reproduction, and distribution of the Work otherwise complies with + the conditions stated in this License. + +5. Submission of Contributions. Unless You explicitly state otherwise, + any Contribution intentionally submitted for inclusion in the Work + by You to the Licensor shall be under the terms and conditions of + this License, without any additional terms or conditions. + Notwithstanding the above, nothing herein shall supersede or modify + the terms of any separate license agreement you may have executed + with Licensor regarding such Contributions. + +6. Trademarks. This License does not grant permission to use the trade + names, trademarks, service marks, or product names of the Licensor, + except as required for reasonable and customary use in describing the + origin of the Work and reproducing the content of the NOTICE file. + +7. Disclaimer of Warranty. Unless required by applicable law or + agreed to in writing, Licensor provides the Work (and each + Contributor provides its Contributions) on an "AS IS" BASIS, + WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or + implied, including, without limitation, any warranties or conditions + of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A + PARTICULAR PURPOSE. You are solely responsible for determining the + appropriateness of using or redistributing the Work and assume any + risks associated with Your exercise of permissions under this License. + +8. Limitation of Liability. In no event and under no legal theory, + whether in tort (including negligence), contract, or otherwise, + unless required by applicable law (such as deliberate and grossly + negligent acts) or agreed to in writing, shall any Contributor be + liable to You for damages, including any direct, indirect, special, + incidental, or consequential damages of any character arising as a + result of this License or out of the use or inability to use the + Work (including but not limited to damages for loss of goodwill, + work stoppage, computer failure or malfunction, or any and all + other commercial damages or losses), even if such Contributor + has been advised of the possibility of such damages. + +9. Accepting Warranty or Additional Liability. While redistributing + the Work or Derivative Works thereof, You may choose to offer, + and charge a fee for, acceptance of support, warranty, indemnity, + or other liability obligations and/or rights consistent with this + License. However, in accepting such obligations, You may act only + on Your own behalf and on Your sole responsibility, not on behalf + of any other Contributor, and only if You agree to indemnify, + defend, and hold each Contributor harmless for any liability + incurred by, or claims asserted against, such Contributor by reason + of your accepting any such warranty or additional liability. + +END OF TERMS AND CONDITIONS + +APPENDIX: How to apply the Apache License to your work. - To "propagate" a work means to do anything with it that, without -permission, would make you directly or secondarily liable for -infringement under applicable copyright law, except executing it on a -computer or modifying a private copy. Propagation includes copying, -distribution (with or without modification), making available to the -public, and in some countries other activities as well. + To apply the Apache License to your work, attach the following + boilerplate notice, with the fields enclosed by brackets "[]" + replaced with your own identifying information. (Don't include + the brackets!) The text should be enclosed in the appropriate + comment syntax for the file format. We also recommend that a + file or class name and description of purpose be included on the + same "printed page" as the copyright notice for easier + identification within third-party archives. - To "convey" a work means any kind of propagation that enables other -parties to make or receive copies. Mere interaction with a user through -a computer network, with no transfer of a copy, is not conveying. +Copyright [yyyy] [name of copyright owner] - An interactive user interface displays "Appropriate Legal Notices" -to the extent that it includes a convenient and prominently visible -feature that (1) displays an appropriate copyright notice, and (2) -tells the user that there is no warranty for the work (except to the -extent that warranties are provided), that licensees may convey the -work under this License, and how to view a copy of this License. If -the interface presents a list of user commands or options, such as a -menu, a prominent item in the list meets this criterion. +Licensed under the Apache License, Version 2.0 (the "License"); +you may not use this file except in compliance with the License. +You may obtain a copy of the License at - 1. Source Code. + http://www.apache.org/licenses/LICENSE-2.0 - The "source code" for a work means the preferred form of the work -for making modifications to it. "Object code" means any non-source -form of a work. +Unless required by applicable law or agreed to in writing, software +distributed under the License is distributed on an "AS IS" BASIS, +WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +See the License for the specific language governing permissions and +limitations under the License. - A "Standard Interface" means an interface that either is an official -standard defined by a recognized standards body, or, in the case of -interfaces specified for a particular programming language, one that -is widely used among developers working in that language. +pyro-ppl +1.8.1 +Apache Software License +http://pyro.ai - The "System Libraries" of an executable work include anything, other -than the work as a whole, that (a) is included in the normal form of -packaging a Major Component, but which is not part of that Major -Component, and (b) serves only to enable use of the work with that -Major Component, or to implement a Standard Interface for which an -implementation is available to the public in source code form. A -"Major Component", in this context, means a major essential component -(kernel, window system, and so on) of the specific operating system -(if any) on which the executable work runs, or a compiler used to -produce the work, or an object code interpreter used to run it. + Apache License + Version 2.0, January 2004 + http://www.apache.org/licenses/ - The "Corresponding Source" for a work in object code form means all -the source code needed to generate, install, and (for an executable -work) run the object code and to modify the work, including scripts to -control those activities. However, it does not include the work's -System Libraries, or general-purpose tools or generally available free -programs which are used unmodified in performing those activities but -which are not part of the work. For example, Corresponding Source -includes interface definition files associated with source files for -the work, and the source code for shared libraries and dynamically -linked subprograms that the work is specifically designed to require, -such as by intimate data communication or control flow between those -subprograms and other parts of the work. +TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION + +1. Definitions. + + "License" shall mean the terms and conditions for use, reproduction, + and distribution as defined by Sections 1 through 9 of this document. + + "Licensor" shall mean the copyright owner or entity authorized by + the copyright owner that is granting the License. + + "Legal Entity" shall mean the union of the acting entity and all + other entities that control, are controlled by, or are under common + control with that entity. For the purposes of this definition, + "control" means (i) the power, direct or indirect, to cause the + direction or management of such entity, whether by contract or + otherwise, or (ii) ownership of fifty percent (50%) or more of the + outstanding shares, or (iii) beneficial ownership of such entity. + + "You" (or "Your") shall mean an individual or Legal Entity + exercising permissions granted by this License. + + "Source" form shall mean the preferred form for making modifications, + including but not limited to software source code, documentation + source, and configuration files. + + "Object" form shall mean any form resulting from mechanical + transformation or translation of a Source form, including but + not limited to compiled object code, generated documentation, + and conversions to other media types. + + "Work" shall mean the work of authorship, whether in Source or + Object form, made available under the License, as indicated by a + copyright notice that is included in or attached to the work + (an example is provided in the Appendix below). + + "Derivative Works" shall mean any work, whether in Source or Object + form, that is based on (or derived from) the Work and for which the + editorial revisions, annotations, elaborations, or other modifications + represent, as a whole, an original work of authorship. For the purposes + of this License, Derivative Works shall not include works that remain + separable from, or merely link (or bind by name) to the interfaces of, + the Work and Derivative Works thereof. + + "Contribution" shall mean any work of authorship, including + the original version of the Work and any modifications or additions + to that Work or Derivative Works thereof, that is intentionally + submitted to Licensor for inclusion in the Work by the copyright owner + or by an individual or Legal Entity authorized to submit on behalf of + the copyright owner. For the purposes of this definition, "submitted" + means any form of electronic, verbal, or written communication sent + to the Licensor or its representatives, including but not limited to + communication on electronic mailing lists, source code control systems, + and issue tracking systems that are managed by, or on behalf of, the + Licensor for the purpose of discussing and improving the Work, but + excluding communication that is conspicuously marked or otherwise + designated in writing by the copyright owner as "Not a Contribution." + + "Contributor" shall mean Licensor and any individual or Legal Entity + on behalf of whom a Contribution has been received by Licensor and + subsequently incorporated within the Work. + +2. Grant of Copyright License. Subject to the terms and conditions of + this License, each Contributor hereby grants to You a perpetual, + worldwide, non-exclusive, no-charge, royalty-free, irrevocable + copyright license to reproduce, prepare Derivative Works of, + publicly display, publicly perform, sublicense, and distribute the + Work and such Derivative Works in Source or Object form. + +3. Grant of Patent License. Subject to the terms and conditions of + this License, each Contributor hereby grants to You a perpetual, + worldwide, non-exclusive, no-charge, royalty-free, irrevocable + (except as stated in this section) patent license to make, have made, + use, offer to sell, sell, import, and otherwise transfer the Work, + where such license applies only to those patent claims licensable + by such Contributor that are necessarily infringed by their + Contribution(s) alone or by combination of their Contribution(s) + with the Work to which such Contribution(s) was submitted. If You + institute patent litigation against any entity (including a + cross-claim or counterclaim in a lawsuit) alleging that the Work + or a Contribution incorporated within the Work constitutes direct + or contributory patent infringement, then any patent licenses + granted to You under this License for that Work shall terminate + as of the date such litigation is filed. + +4. Redistribution. You may reproduce and distribute copies of the + Work or Derivative Works thereof in any medium, with or without + modifications, and in Source or Object form, provided that You + meet the following conditions: + + (a) You must give any other recipients of the Work or + Derivative Works a copy of this License; and + + (b) You must cause any modified files to carry prominent notices + stating that You changed the files; and + + (c) You must retain, in the Source form of any Derivative Works + that You distribute, all copyright, patent, trademark, and + attribution notices from the Source form of the Work, + excluding those notices that do not pertain to any part of + the Derivative Works; and + + (d) If the Work includes a "NOTICE" text file as part of its + distribution, then any Derivative Works that You distribute must + include a readable copy of the attribution notices contained + within such NOTICE file, excluding those notices that do not + pertain to any part of the Derivative Works, in at least one + of the following places: within a NOTICE text file distributed + as part of the Derivative Works; within the Source form or + documentation, if provided along with the Derivative Works; or, + within a display generated by the Derivative Works, if and + wherever such third-party notices normally appear. The contents + of the NOTICE file are for informational purposes only and + do not modify the License. You may add Your own attribution + notices within Derivative Works that You distribute, alongside + or as an addendum to the NOTICE text from the Work, provided + that such additional attribution notices cannot be construed + as modifying the License. + + You may add Your own copyright statement to Your modifications and + may provide additional or different license terms and conditions + for use, reproduction, or distribution of Your modifications, or + for any such Derivative Works as a whole, provided Your use, + reproduction, and distribution of the Work otherwise complies with + the conditions stated in this License. + +5. Submission of Contributions. Unless You explicitly state otherwise, + any Contribution intentionally submitted for inclusion in the Work + by You to the Licensor shall be under the terms and conditions of + this License, without any additional terms or conditions. + Notwithstanding the above, nothing herein shall supersede or modify + the terms of any separate license agreement you may have executed + with Licensor regarding such Contributions. + +6. Trademarks. This License does not grant permission to use the trade + names, trademarks, service marks, or product names of the Licensor, + except as required for reasonable and customary use in describing the + origin of the Work and reproducing the content of the NOTICE file. + +7. Disclaimer of Warranty. Unless required by applicable law or + agreed to in writing, Licensor provides the Work (and each + Contributor provides its Contributions) on an "AS IS" BASIS, + WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or + implied, including, without limitation, any warranties or conditions + of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A + PARTICULAR PURPOSE. You are solely responsible for determining the + appropriateness of using or redistributing the Work and assume any + risks associated with Your exercise of permissions under this License. + +8. Limitation of Liability. In no event and under no legal theory, + whether in tort (including negligence), contract, or otherwise, + unless required by applicable law (such as deliberate and grossly + negligent acts) or agreed to in writing, shall any Contributor be + liable to You for damages, including any direct, indirect, special, + incidental, or consequential damages of any character arising as a + result of this License or out of the use or inability to use the + Work (including but not limited to damages for loss of goodwill, + work stoppage, computer failure or malfunction, or any and all + other commercial damages or losses), even if such Contributor + has been advised of the possibility of such damages. + +9. Accepting Warranty or Additional Liability. While redistributing + the Work or Derivative Works thereof, You may choose to offer, + and charge a fee for, acceptance of support, warranty, indemnity, + or other liability obligations and/or rights consistent with this + License. However, in accepting such obligations, You may act only + on Your own behalf and on Your sole responsibility, not on behalf + of any other Contributor, and only if You agree to indemnify, + defend, and hold each Contributor harmless for any liability + incurred by, or claims asserted against, such Contributor by reason + of your accepting any such warranty or additional liability. + +END OF TERMS AND CONDITIONS + +APPENDIX: How to apply the Apache License to your work. - The Corresponding Source need not include anything that users -can regenerate automatically from other parts of the Corresponding -Source. + To apply the Apache License to your work, attach the following + boilerplate notice, with the fields enclosed by brackets "[]" + replaced with your own identifying information. (Don't include + the brackets!) The text should be enclosed in the appropriate + comment syntax for the file format. We also recommend that a + file or class name and description of purpose be included on the + same "printed page" as the copyright notice for easier + identification within third-party archives. - The Corresponding Source for a work in source code form is that -same work. +Copyright [yyyy] [name of copyright owner] - 2. Basic Permissions. +Licensed under the Apache License, Version 2.0 (the "License"); +you may not use this file except in compliance with the License. +You may obtain a copy of the License at - All rights granted under this License are granted for the term of -copyright on the Program, and are irrevocable provided the stated -conditions are met. This License explicitly affirms your unlimited -permission to run the unmodified Program. The output from running a -covered work is covered by this License only if the output, given its -content, constitutes a covered work. This License acknowledges your -rights of fair use or other equivalent, as provided by copyright law. + http://www.apache.org/licenses/LICENSE-2.0 - You may make, run and propagate covered works that you do not -convey, without conditions so long as your license otherwise remains -in force. You may convey covered works to others for the sole purpose -of having them make modifications exclusively for you, or provide you -with facilities for running those works, provided that you comply with -the terms of this License in conveying all material for which you do -not control copyright. Those thus making or running the covered works -for you must do so exclusively on your behalf, under your direction -and control, on terms that prohibit them from making any copies of -your copyrighted material outside their relationship with you. +Unless required by applicable law or agreed to in writing, software +distributed under the License is distributed on an "AS IS" BASIS, +WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +See the License for the specific language governing permissions and +limitations under the License. - Conveying under any other circumstances is permitted solely under -the conditions stated below. Sublicensing is not allowed; section 10 -makes it unnecessary. +scikit-learn +1.1.1 +new BSD +http://scikit-learn.org +BSD 3-Clause License - 3. Protecting Users' Legal Rights From Anti-Circumvention Law. +Copyright (c) 2007-2021 The scikit-learn developers. +All rights reserved. - No covered work shall be deemed part of an effective technological -measure under any applicable law fulfilling obligations under article -11 of the WIPO copyright treaty adopted on 20 December 1996, or -similar laws prohibiting or restricting circumvention of such -measures. +Redistribution and use in source and binary forms, with or without +modification, are permitted provided that the following conditions are met: - When you convey a covered work, you waive any legal power to forbid -circumvention of technological measures to the extent such circumvention -is effected by exercising rights under this License with respect to -the covered work, and you disclaim any intention to limit operation or -modification of the work as a means of enforcing, against the work's -users, your or third parties' legal rights to forbid circumvention of -technological measures. +- Redistributions of source code must retain the above copyright notice, this + list of conditions and the following disclaimer. - 4. Conveying Verbatim Copies. +- Redistributions in binary form must reproduce the above copyright notice, + this list of conditions and the following disclaimer in the documentation + and/or other materials provided with the distribution. - You may convey verbatim copies of the Program's source code as you -receive it, in any medium, provided that you conspicuously and -appropriately publish on each copy an appropriate copyright notice; -keep intact all notices stating that this License and any -non-permissive terms added in accord with section 7 apply to the code; -keep intact all notices of the absence of any warranty; and give all -recipients a copy of this License along with the Program. +- Neither the name of the copyright holder nor the names of its + contributors may be used to endorse or promote products derived from + this software without specific prior written permission. - You may charge any price or no price for each copy that you convey, -and you may offer support or warranty protection for a fee. +THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" +AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE +IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE +DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE +FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL +DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR +SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER +CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, +OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE +OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. - 5. Conveying Modified Source Versions. +scipy +1.8.1 +BSD License +https://www.scipy.org +Copyright (c) 2001-2002 Enthought, Inc. 2003-2019, SciPy Developers. +All rights reserved. - You may convey a work based on the Program, or the modifications to -produce it from the Program, in the form of source code under the -terms of section 4, provided that you also meet all of these conditions: +Redistribution and use in source and binary forms, with or without +modification, are permitted provided that the following conditions +are met: - a) The work must carry prominent notices stating that you modified - it, and giving a relevant date. +1. Redistributions of source code must retain the above copyright + notice, this list of conditions and the following disclaimer. - b) The work must carry prominent notices stating that it is - released under this License and any conditions added under section - 7. This requirement modifies the requirement in section 4 to - "keep intact all notices". +2. Redistributions in binary form must reproduce the above + copyright notice, this list of conditions and the following + disclaimer in the documentation and/or other materials provided + with the distribution. - c) You must license the entire work, as a whole, under this - License to anyone who comes into possession of a copy. This - License will therefore apply, along with any applicable section 7 - additional terms, to the whole of the work, and all its parts, - regardless of how they are packaged. This License gives no - permission to license the work in any other way, but it does not - invalidate such permission if you have separately received it. +3. Neither the name of the copyright holder nor the names of its + contributors may be used to endorse or promote products derived + from this software without specific prior written permission. - d) If the work has interactive user interfaces, each must display - Appropriate Legal Notices; however, if the Program has interactive - interfaces that do not display Appropriate Legal Notices, your - work need not make them do so. +THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS +"AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT +LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR +A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT +OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, +SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT +LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, +DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY +THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT +(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE +OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. - A compilation of a covered work with other separate and independent -works, which are not by their nature extensions of the covered work, -and which are not combined with it such as to form a larger program, -in or on a volume of a storage or distribution medium, is called an -"aggregate" if the compilation and its resulting copyright are not -used to limit the access or legal rights of the compilation's users -beyond what the individual works permit. Inclusion of a covered work -in an aggregate does not cause this License to apply to the other -parts of the aggregate. +--- - 6. Conveying Non-Source Forms. +This binary distribution of Scipy also bundles the following software: - You may convey a covered work in object code form under the terms -of sections 4 and 5, provided that you also convey the -machine-readable Corresponding Source under the terms of this License, -in one of these ways: +Name: OpenBLAS +Files: extra-dll\libopenb\*.dll +Description: bundled as a dynamically linked library +Availability: https://github.com/xianyi/OpenBLAS/ +License: 3-clause BSD +Copyright (c) 2011-2014, The OpenBLAS Project +All rights reserved. - a) Convey the object code in, or embodied in, a physical product - (including a physical distribution medium), accompanied by the - Corresponding Source fixed on a durable physical medium - customarily used for software interchange. +Redistribution and use in source and binary forms, with or without +modification, are permitted provided that the following conditions are +met: - b) Convey the object code in, or embodied in, a physical product - (including a physical distribution medium), accompanied by a - written offer, valid for at least three years and valid for as - long as you offer spare parts or customer support for that product - model, to give anyone who possesses the object code either (1) a - copy of the Corresponding Source for all the software in the - product that is covered by this License, on a durable physical - medium customarily used for software interchange, for a price no - more than your reasonable cost of physically performing this - conveying of source, or (2) access to copy the - Corresponding Source from a network server at no charge. + 1. Redistributions of source code must retain the above copyright + notice, this list of conditions and the following disclaimer. - c) Convey individual copies of the object code with a copy of the - written offer to provide the Corresponding Source. This - alternative is allowed only occasionally and noncommercially, and - only if you received the object code with such an offer, in accord - with subsection 6b. + 2. Redistributions in binary form must reproduce the above copyright + notice, this list of conditions and the following disclaimer in + the documentation and/or other materials provided with the + distribution. + 3. Neither the name of the OpenBLAS project nor the names of + its contributors may be used to endorse or promote products + derived from this software without specific prior written + permission. - d) Convey the object code by offering access from a designated - place (gratis or for a charge), and offer equivalent access to the - Corresponding Source in the same way through the same place at no - further charge. You need not require recipients to copy the - Corresponding Source along with the object code. If the place to - copy the object code is a network server, the Corresponding Source - may be on a different server (operated by you or a third party) - that supports equivalent copying facilities, provided you maintain - clear directions next to the object code saying where to find the - Corresponding Source. Regardless of what server hosts the - Corresponding Source, you remain obligated to ensure that it is - available for as long as needed to satisfy these requirements. +THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" +AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE +IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE +ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE +LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL +DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR +SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER +CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, +OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE +USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. - e) Convey the object code using peer-to-peer transmission, provided - you inform other peers where the object code and Corresponding - Source of the work are being offered to the general public at no - charge under subsection 6d. +Name: LAPACK +Files: extra-dll\libopenb\*.dll +Description: bundled in OpenBLAS +Availability: https://github.com/xianyi/OpenBLAS/ +License 3-clause BSD +Copyright (c) 1992-2013 The University of Tennessee and The University +of Tennessee Research Foundation. All rights +reserved. +Copyright (c) 2000-2013 The University of California Berkeley. All +rights reserved. +Copyright (c) 2006-2013 The University of Colorado Denver. All rights +reserved. - A separable portion of the object code, whose source code is excluded -from the Corresponding Source as a System Library, need not be -included in conveying the object code work. +$COPYRIGHT$ - A "User Product" is either (1) a "consumer product", which means any -tangible personal property which is normally used for personal, family, -or household purposes, or (2) anything designed or sold for incorporation -into a dwelling. In determining whether a product is a consumer product, -doubtful cases shall be resolved in favor of coverage. For a particular -product received by a particular user, "normally used" refers to a -typical or common use of that class of product, regardless of the status -of the particular user or of the way in which the particular user -actually uses, or expects or is expected to use, the product. A product -is a consumer product regardless of whether the product has substantial -commercial, industrial or non-consumer uses, unless such uses represent -the only significant mode of use of the product. +Additional copyrights may follow - "Installation Information" for a User Product means any methods, -procedures, authorization keys, or other information required to install -and execute modified versions of a covered work in that User Product from -a modified version of its Corresponding Source. The information must -suffice to ensure that the continued functioning of the modified object -code is in no case prevented or interfered with solely because -modification has been made. +$HEADER$ - If you convey an object code work under this section in, or with, or -specifically for use in, a User Product, and the conveying occurs as -part of a transaction in which the right of possession and use of the -User Product is transferred to the recipient in perpetuity or for a -fixed term (regardless of how the transaction is characterized), the -Corresponding Source conveyed under this section must be accompanied -by the Installation Information. But this requirement does not apply -if neither you nor any third party retains the ability to install -modified object code on the User Product (for example, the work has -been installed in ROM). +Redistribution and use in source and binary forms, with or without +modification, are permitted provided that the following conditions are +met: - The requirement to provide Installation Information does not include a -requirement to continue to provide support service, warranty, or updates -for a work that has been modified or installed by the recipient, or for -the User Product in which it has been modified or installed. Access to a -network may be denied when the modification itself materially and -adversely affects the operation of the network or violates the rules and -protocols for communication across the network. +- Redistributions of source code must retain the above copyright + notice, this list of conditions and the following disclaimer. - Corresponding Source conveyed, and Installation Information provided, -in accord with this section must be in a format that is publicly -documented (and with an implementation available to the public in -source code form), and must require no special password or key for -unpacking, reading or copying. +- Redistributions in binary form must reproduce the above copyright + notice, this list of conditions and the following disclaimer listed + in this license in the documentation and/or other materials + provided with the distribution. - 7. Additional Terms. +- Neither the name of the copyright holders nor the names of its + contributors may be used to endorse or promote products derived from + this software without specific prior written permission. - "Additional permissions" are terms that supplement the terms of this -License by making exceptions from one or more of its conditions. -Additional permissions that are applicable to the entire Program shall -be treated as though they were included in this License, to the extent -that they are valid under applicable law. If additional permissions -apply only to part of the Program, that part may be used separately -under those permissions, but the entire Program remains governed by -this License without regard to the additional permissions. +The copyright holders provide no reassurances that the source code +provided does not infringe any patent, copyright, or any other +intellectual property rights of third parties. The copyright holders +disclaim any liability to any recipient for claims brought against +recipient by any third party for infringement of that parties +intellectual property rights. - When you convey a copy of a covered work, you may at your option -remove any additional permissions from that copy, or from any part of -it. (Additional permissions may be written to require their own -removal in certain cases when you modify the work.) You may place -additional permissions on material, added by you to a covered work, -for which you have or can give appropriate copyright permission. +THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS +"AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT +LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR +A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT +OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, +SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT +LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, +DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY +THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT +(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE +OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. - Notwithstanding any other provision of this License, for material you -add to a covered work, you may (if authorized by the copyright holders of -that material) supplement the terms of this License with terms: +Name: GCC runtime library +Files: extra-dll\*.dll +Description: statically linked, in DLL files compiled with gfortran only +Availability: https://gcc.gnu.org/viewcvs/gcc/ +License: GPLv3 + runtime exception +Copyright (C) 2002-2017 Free Software Foundation, Inc. - a) Disclaiming warranty or limiting liability differently from the - terms of sections 15 and 16 of this License; or +Libgfortran is free software; you can redistribute it and/or modify +it under the terms of the GNU General Public License as published by +the Free Software Foundation; either version 3, or (at your option) +any later version. - b) Requiring preservation of specified reasonable legal notices or - author attributions in that material or in the Appropriate Legal - Notices displayed by works containing it; or +Libgfortran is distributed in the hope that it will be useful, +but WITHOUT ANY WARRANTY; without even the implied warranty of +MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +GNU General Public License for more details. - c) Prohibiting misrepresentation of the origin of that material, or - requiring that modified versions of such material be marked in - reasonable ways as different from the original version; or +Under Section 7 of GPL version 3, you are granted additional +permissions described in the GCC Runtime Library Exception, version +3.1, as published by the Free Software Foundation. - d) Limiting the use for publicity purposes of names of licensors or - authors of the material; or +You should have received a copy of the GNU General Public License and +a copy of the GCC Runtime Library Exception along with this program; +see the files COPYING3 and COPYING.RUNTIME respectively. If not, see +. - e) Declining to grant rights under trademark law for use of some - trade names, trademarks, or service marks; or +Name: Microsoft Visual C++ Runtime Files +Files: extra-dll\msvcp140.dll +License: MSVC +https://www.visualstudio.com/license-terms/distributable-code-microsoft-visual-studio-2015-rc-microsoft-visual-studio-2015-sdk-rc-includes-utilities-buildserver-files/#visual-c-runtime - f) Requiring indemnification of licensors and authors of that - material by anyone who conveys the material (or modified versions of - it) with contractual assumptions of liability to the recipient, for - any liability that these contractual assumptions directly impose on - those licensors and authors. +Subject to the License Terms for the software, you may copy and +distribute with your program any of the files within the followng +folder and its subfolders except as noted below. You may not modify +these files. - All other non-permissive additional terms are considered "further -restrictions" within the meaning of section 10. If the Program as you -received it, or any part of it, contains a notice stating that it is -governed by this License along with a term that is a further -restriction, you may remove that term. If a license document contains -a further restriction but permits relicensing or conveying under this -License, you may add to a covered work material governed by the terms -of that license document, provided that the further restriction does -not survive such relicensing or conveying. + C:\Program Files (x86)\Microsoft Visual Studio 14.0\VC\redist - If you add terms to a covered work in accord with this section, you -must place, in the relevant source files, a statement of the -additional terms that apply to those files, or a notice indicating -where to find the applicable terms. +You may not distribute the contents of the following folders: - Additional terms, permissive or non-permissive, may be stated in the -form of a separately written license, or stated as exceptions; -the above requirements apply either way. + C:\Program Files (x86)\Microsoft Visual Studio 14.0\VC\redist\debug_nonredist + C:\Program Files (x86)\Microsoft Visual Studio 14.0\VC\redist\onecore\debug_nonredist - 8. Termination. +Subject to the License Terms for the software, you may copy and +distribute the following files with your program in your program’s +application local folder or by deploying them into the Global +Assembly Cache (GAC): - You may not propagate or modify a covered work except as expressly -provided under this License. Any attempt otherwise to propagate or -modify it is void, and will automatically terminate your rights under -this License (including any patent licenses granted under the third -paragraph of section 11). +VC\atlmfc\lib\mfcmifc80.dll +VC\atlmfc\lib\amd64\mfcmifc80.dll - However, if you cease all violation of this License, then your -license from a particular copyright holder is reinstated (a) -provisionally, unless and until the copyright holder explicitly and -finally terminates your license, and (b) permanently, if the copyright -holder fails to notify you of the violation by some reasonable means -prior to 60 days after the cessation. +Name: Microsoft Visual C++ Runtime Files +Files: extra-dll\msvc*90.dll, extra-dll\Microsoft.VC90.CRT.manifest +License: MSVC +For your convenience, we have provided the following folders for +use when redistributing VC++ runtime files. Subject to the license +terms for the software, you may redistribute the folder +(unmodified) in the application local folder as a sub-folder with +no change to the folder name. You may also redistribute all the +files (*.dll and \*.manifest) within a folder, listed below the +folder for your convenience, as an entire set. + +\VC\redist\x86\Microsoft.VC90.ATL\ + atl90.dll +Microsoft.VC90.ATL.manifest +\VC\redist\ia64\Microsoft.VC90.ATL\ + atl90.dll +Microsoft.VC90.ATL.manifest +\VC\redist\amd64\Microsoft.VC90.ATL\ + atl90.dll +Microsoft.VC90.ATL.manifest +\VC\redist\x86\Microsoft.VC90.CRT\ + msvcm90.dll +msvcp90.dll +msvcr90.dll +Microsoft.VC90.CRT.manifest +\VC\redist\ia64\Microsoft.VC90.CRT\ + msvcm90.dll +msvcp90.dll +msvcr90.dll +Microsoft.VC90.CRT.manifest + +--- - Moreover, your license from a particular copyright holder is -reinstated permanently if the copyright holder notifies you of the -violation by some reasonable means, this is the first time you have -received notice of violation of this License (for any work) from that -copyright holder, and you cure the violation prior to 30 days after -your receipt of the notice. +Full text of license texts referred to above follows (that they are +listed below does not necessarily imply the conditions apply to the +present binary release): - Termination of your rights under this section does not terminate the -licenses of parties who have received copies or rights from you under -this License. If your rights have been terminated and not permanently -reinstated, you do not qualify to receive new licenses for the same -material under section 10. +--- - 9. Acceptance Not Required for Having Copies. +GCC RUNTIME LIBRARY EXCEPTION - You are not required to accept this License in order to receive or -run a copy of the Program. Ancillary propagation of a covered work -occurring solely as a consequence of using peer-to-peer transmission -to receive a copy likewise does not require acceptance. However, -nothing other than this License grants you permission to propagate or -modify any covered work. These actions infringe copyright if you do -not accept this License. Therefore, by modifying or propagating a -covered work, you indicate your acceptance of this License to do so. +Version 3.1, 31 March 2009 - 10. Automatic Licensing of Downstream Recipients. +Copyright (C) 2009 Free Software Foundation, Inc. - Each time you convey a covered work, the recipient automatically -receives a license from the original licensors, to run, modify and -propagate that work, subject to this License. You are not responsible -for enforcing compliance by third parties with this License. +Everyone is permitted to copy and distribute verbatim copies of this +license document, but changing it is not allowed. - An "entity transaction" is a transaction transferring control of an -organization, or substantially all assets of one, or subdividing an -organization, or merging organizations. If propagation of a covered -work results from an entity transaction, each party to that -transaction who receives a copy of the work also receives whatever -licenses to the work the party's predecessor in interest had or could -give under the previous paragraph, plus a right to possession of the -Corresponding Source of the work from the predecessor in interest, if -the predecessor has it or can get it with reasonable efforts. +This GCC Runtime Library Exception ("Exception") is an additional +permission under section 7 of the GNU General Public License, version +3 ("GPLv3"). It applies to a given file (the "Runtime Library") that +bears a notice placed by the copyright holder of the file stating that +the file is governed by GPLv3 along with this Exception. - You may not impose any further restrictions on the exercise of the -rights granted or affirmed under this License. For example, you may -not impose a license fee, royalty, or other charge for exercise of -rights granted under this License, and you may not initiate litigation -(including a cross-claim or counterclaim in a lawsuit) alleging that -any patent claim is infringed by making, using, selling, offering for -sale, or importing the Program or any portion of it. +When you use GCC to compile a program, GCC may combine portions of +certain GCC header files and runtime libraries with the compiled +program. The purpose of this Exception is to allow compilation of +non-GPL (including proprietary) programs to use, in this way, the +header files and runtime libraries covered by this Exception. - 11. Patents. +0. Definitions. - A "contributor" is a copyright holder who authorizes use under this -License of the Program or a work on which the Program is based. The -work thus licensed is called the contributor's "contributor version". +A file is an "Independent Module" if it either requires the Runtime +Library for execution after a Compilation Process, or makes use of an +interface provided by the Runtime Library, but is not otherwise based +on the Runtime Library. - A contributor's "essential patent claims" are all patent claims -owned or controlled by the contributor, whether already acquired or -hereafter acquired, that would be infringed by some manner, permitted -by this License, of making, using, or selling its contributor version, -but do not include claims that would be infringed only as a -consequence of further modification of the contributor version. For -purposes of this definition, "control" includes the right to grant -patent sublicenses in a manner consistent with the requirements of -this License. +"GCC" means a version of the GNU Compiler Collection, with or without +modifications, governed by version 3 (or a specified later version) of +the GNU General Public License (GPL) with the option of using any +subsequent versions published by the FSF. - Each contributor grants you a non-exclusive, worldwide, royalty-free -patent license under the contributor's essential patent claims, to -make, use, sell, offer for sale, import and otherwise run, modify and -propagate the contents of its contributor version. +"GPL-compatible Software" is software whose conditions of propagation, +modification and use would permit combination with GCC in accord with +the license of GCC. - In the following three paragraphs, a "patent license" is any express -agreement or commitment, however denominated, not to enforce a patent -(such as an express permission to practice a patent or covenant not to -sue for patent infringement). To "grant" such a patent license to a -party means to make such an agreement or commitment not to enforce a -patent against the party. +"Target Code" refers to output from any compiler for a real or virtual +target processor architecture, in executable form or suitable for +input to an assembler, loader, linker and/or execution +phase. Notwithstanding that, Target Code does not include data in any +format that is used as a compiler intermediate representation, or used +for producing a compiler intermediate representation. - If you convey a covered work, knowingly relying on a patent license, -and the Corresponding Source of the work is not available for anyone -to copy, free of charge and under the terms of this License, through a -publicly available network server or other readily accessible means, -then you must either (1) cause the Corresponding Source to be so -available, or (2) arrange to deprive yourself of the benefit of the -patent license for this particular work, or (3) arrange, in a manner -consistent with the requirements of this License, to extend the patent -license to downstream recipients. "Knowingly relying" means you have -actual knowledge that, but for the patent license, your conveying the -covered work in a country, or your recipient's use of the covered work -in a country, would infringe one or more identifiable patents in that -country that you have reason to believe are valid. - - If, pursuant to or in connection with a single transaction or -arrangement, you convey, or propagate by procuring conveyance of, a -covered work, and grant a patent license to some of the parties -receiving the covered work authorizing them to use, propagate, modify -or convey a specific copy of the covered work, then the patent license -you grant is automatically extended to all recipients of the covered -work and works based on it. - - A patent license is "discriminatory" if it does not include within -the scope of its coverage, prohibits the exercise of, or is -conditioned on the non-exercise of one or more of the rights that are -specifically granted under this License. You may not convey a covered -work if you are a party to an arrangement with a third party that is -in the business of distributing software, under which you make payment -to the third party based on the extent of your activity of conveying -the work, and under which the third party grants, to any of the -parties who would receive the covered work from you, a discriminatory -patent license (a) in connection with copies of the covered work -conveyed by you (or copies made from those copies), or (b) primarily -for and in connection with specific products or compilations that -contain the covered work, unless you entered into that arrangement, -or that patent license was granted, prior to 28 March 2007. +The "Compilation Process" transforms code entirely represented in +non-intermediate languages designed for human-written code, and/or in +Java Virtual Machine byte code, into Target Code. Thus, for example, +use of source code generators and preprocessors need not be considered +part of the Compilation Process, since the Compilation Process can be +understood as starting with the output of the generators or +preprocessors. - Nothing in this License shall be construed as excluding or limiting -any implied license or other defenses to infringement that may -otherwise be available to you under applicable patent law. +A Compilation Process is "Eligible" if it is done using GCC, alone or +with other GPL-compatible software, or if it is done without using any +work based on GCC. For example, using non-GPL-compatible Software to +optimize any GCC intermediate representations would not qualify as an +Eligible Compilation Process. - 12. No Surrender of Others' Freedom. +1. Grant of Additional Permission. - If conditions are imposed on you (whether by court order, agreement or -otherwise) that contradict the conditions of this License, they do not -excuse you from the conditions of this License. If you cannot convey a -covered work so as to satisfy simultaneously your obligations under this -License and any other pertinent obligations, then as a consequence you may -not convey it at all. For example, if you agree to terms that obligate you -to collect a royalty for further conveying from those to whom you convey -the Program, the only way you could satisfy both those terms and this -License would be to refrain entirely from conveying the Program. +You have permission to propagate a work of Target Code formed by +combining the Runtime Library with Independent Modules, even if such +propagation would otherwise violate the terms of GPLv3, provided that +all Target Code was generated by Eligible Compilation Processes. You +may then convey such a combination under terms of your choice, +consistent with the licensing of the Independent Modules. - 13. Use with the GNU Affero General Public License. +2. No Weakening of GCC Copyleft. - Notwithstanding any other provision of this License, you have -permission to link or combine any covered work with a work licensed -under version 3 of the GNU Affero General Public License into a single -combined work, and to convey the resulting work. The terms of this -License will continue to apply to the part which is the covered work, -but the special requirements of the GNU Affero General Public License, -section 13, concerning interaction through a network will apply to the -combination as such. +The availability of this Exception does not imply any general +presumption that third-party software is unaffected by the copyleft +requirements of the license of GCC. - 14. Revised Versions of this License. +--- - The Free Software Foundation may publish revised and/or new versions of -the GNU General Public License from time to time. Such new versions will -be similar in spirit to the present version, but may differ in detail to -address new problems or concerns. + GNU GENERAL PUBLIC LICENSE + Version 3, 29 June 2007 - Each version is given a distinguishing version number. If the -Program specifies that a certain numbered version of the GNU General -Public License "or any later version" applies to it, you have the -option of following the terms and conditions either of that numbered -version or of any later version published by the Free Software -Foundation. If the Program does not specify a version number of the -GNU General Public License, you may choose any version ever published -by the Free Software Foundation. +Copyright (C) 2007 Free Software Foundation, Inc. +Everyone is permitted to copy and distribute verbatim copies +of this license document, but changing it is not allowed. - If the Program specifies that a proxy can decide which future -versions of the GNU General Public License can be used, that proxy's -public statement of acceptance of a version permanently authorizes you -to choose that version for the Program. + Preamble - Later license versions may give you additional or different -permissions. However, no additional obligations are imposed on any -author or copyright holder as a result of your choosing to follow a -later version. +The GNU General Public License is a free, copyleft license for +software and other kinds of works. - 15. Disclaimer of Warranty. +The licenses for most software and other practical works are designed +to take away your freedom to share and change the works. By contrast, +the GNU General Public License is intended to guarantee your freedom to +share and change all versions of a program--to make sure it remains free +software for all its users. We, the Free Software Foundation, use the +GNU General Public License for most of our software; it applies also to +any other work released this way by its authors. You can apply it to +your programs, too. - THERE IS NO WARRANTY FOR THE PROGRAM, TO THE EXTENT PERMITTED BY -APPLICABLE LAW. EXCEPT WHEN OTHERWISE STATED IN WRITING THE COPYRIGHT -HOLDERS AND/OR OTHER PARTIES PROVIDE THE PROGRAM "AS IS" WITHOUT WARRANTY -OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, -THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR -PURPOSE. THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE PROGRAM -IS WITH YOU. SHOULD THE PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF -ALL NECESSARY SERVICING, REPAIR OR CORRECTION. +When we speak of free software, we are referring to freedom, not +price. Our General Public Licenses are designed to make sure that you +have the freedom to distribute copies of free software (and charge for +them if you wish), that you receive source code or can get it if you +want it, that you can change the software or use pieces of it in new +free programs, and that you know you can do these things. - 16. Limitation of Liability. +To protect your rights, we need to prevent others from denying you +these rights or asking you to surrender the rights. Therefore, you have +certain responsibilities if you distribute copies of the software, or if +you modify it: responsibilities to respect the freedom of others. - IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING -WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MODIFIES AND/OR CONVEYS -THE PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES, INCLUDING ANY -GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE -USE OR INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED TO LOSS OF -DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY YOU OR THIRD -PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER PROGRAMS), -EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF -SUCH DAMAGES. +For example, if you distribute copies of such a program, whether +gratis or for a fee, you must pass on to the recipients the same +freedoms that you received. You must make sure that they, too, receive +or can get the source code. And you must show them these terms so they +know their rights. - 17. Interpretation of Sections 15 and 16. +Developers that use the GNU GPL protect your rights with two steps: +(1) assert copyright on the software, and (2) offer you this License +giving you legal permission to copy, distribute and/or modify it. - If the disclaimer of warranty and limitation of liability provided -above cannot be given local legal effect according to their terms, -reviewing courts shall apply local law that most closely approximates -an absolute waiver of all civil liability in connection with the -Program, unless a warranty or assumption of liability accompanies a -copy of the Program in return for a fee. +For the developers' and authors' protection, the GPL clearly explains +that there is no warranty for this free software. For both users' and +authors' sake, the GPL requires that modified versions be marked as +changed, so that their problems will not be attributed erroneously to +authors of previous versions. - END OF TERMS AND CONDITIONS +Some devices are designed to deny users access to install or run +modified versions of the software inside them, although the manufacturer +can do so. This is fundamentally incompatible with the aim of +protecting users' freedom to change the software. The systematic +pattern of such abuse occurs in the area of products for individuals to +use, which is precisely where it is most unacceptable. Therefore, we +have designed this version of the GPL to prohibit the practice for those +products. If such problems arise substantially in other domains, we +stand ready to extend this provision to those domains in future versions +of the GPL, as needed to protect the freedom of users. - How to Apply These Terms to Your New Programs +Finally, every program is threatened constantly by software patents. +States should not allow patents to restrict development and use of +software on general-purpose computers, but in those that do, we wish to +avoid the special danger that patents applied to a free program could +make it effectively proprietary. To prevent this, the GPL assures that +patents cannot be used to render the program non-free. - If you develop a new program, and you want it to be of the greatest -possible use to the public, the best way to achieve this is to make it -free software which everyone can redistribute and change under these terms. +The precise terms and conditions for copying, distribution and +modification follow. - To do so, attach the following notices to the program. It is safest -to attach them to the start of each source file to most effectively -state the exclusion of warranty; and each file should have at least -the "copyright" line and a pointer to where the full notice is found. + TERMS AND CONDITIONS - - Copyright (C) +0. Definitions. - This program is free software: you can redistribute it and/or modify - it under the terms of the GNU General Public License as published by - the Free Software Foundation, either version 3 of the License, or - (at your option) any later version. +"This License" refers to version 3 of the GNU General Public License. - This program is distributed in the hope that it will be useful, - but WITHOUT ANY WARRANTY; without even the implied warranty of - MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the - GNU General Public License for more details. +"Copyright" also means copyright-like laws that apply to other kinds of +works, such as semiconductor masks. - You should have received a copy of the GNU General Public License - along with this program. If not, see . +"The Program" refers to any copyrightable work licensed under this +License. Each licensee is addressed as "you". "Licensees" and +"recipients" may be individuals or organizations. -Also add information on how to contact you by electronic and paper mail. +To "modify" a work means to copy from or adapt all or part of the work +in a fashion requiring copyright permission, other than the making of an +exact copy. The resulting work is called a "modified version" of the +earlier work or a work "based on" the earlier work. - If the program does terminal interaction, make it output a short -notice like this when it starts in an interactive mode: +A "covered work" means either the unmodified Program or a work based +on the Program. - Copyright (C) - This program comes with ABSOLUTELY NO WARRANTY; for details type `show w'. - This is free software, and you are welcome to redistribute it - under certain conditions; type `show c' for details. +To "propagate" a work means to do anything with it that, without +permission, would make you directly or secondarily liable for +infringement under applicable copyright law, except executing it on a +computer or modifying a private copy. Propagation includes copying, +distribution (with or without modification), making available to the +public, and in some countries other activities as well. -The hypothetical commands `show w' and `show c' should show the appropriate -parts of the General Public License. Of course, your program's commands -might be different; for a GUI interface, you would use an "about box". +To "convey" a work means any kind of propagation that enables other +parties to make or receive copies. Mere interaction with a user through +a computer network, with no transfer of a copy, is not conveying. - You should also get your employer (if you work as a programmer) or school, -if any, to sign a "copyright disclaimer" for the program, if necessary. -For more information on this, and how to apply and follow the GNU GPL, see -. +An interactive user interface displays "Appropriate Legal Notices" +to the extent that it includes a convenient and prominently visible +feature that (1) displays an appropriate copyright notice, and (2) +tells the user that there is no warranty for the work (except to the +extent that warranties are provided), that licensees may convey the +work under this License, and how to view a copy of this License. If +the interface presents a list of user commands or options, such as a +menu, a prominent item in the list meets this criterion. - The GNU General Public License does not permit incorporating your program -into proprietary programs. If your program is a subroutine library, you -may consider it more useful to permit linking proprietary applications with -the library. If this is what you want to do, use the GNU Lesser General -Public License instead of this License. But first, please read -. +1. Source Code. +The "source code" for a work means the preferred form of the work +for making modifications to it. "Object code" means any non-source +form of a work. -threadpoolctl -3.1.0 -BSD License -Thomas Moreau -https://github.com/joblib/threadpoolctl -threadpoolctl -Copyright (c) 2019, threadpoolctl contributors +A "Standard Interface" means an interface that either is an official +standard defined by a recognized standards body, or, in the case of +interfaces specified for a particular programming language, one that +is widely used among developers working in that language. -Redistribution and use in source and binary forms, with or without -modification, are permitted provided that the following conditions are met: +The "System Libraries" of an executable work include anything, other +than the work as a whole, that (a) is included in the normal form of +packaging a Major Component, but which is not part of that Major +Component, and (b) serves only to enable use of the work with that +Major Component, or to implement a Standard Interface for which an +implementation is available to the public in source code form. A +"Major Component", in this context, means a major essential component +(kernel, window system, and so on) of the specific operating system +(if any) on which the executable work runs, or a compiler used to +produce the work, or an object code interpreter used to run it. - * Redistributions of source code must retain the above copyright notice, - this list of conditions and the following disclaimer. - * Redistributions in binary form must reproduce the above copyright - notice, this list of conditions and the following disclaimer in the - documentation and/or other materials provided with the distribution. - * Neither the name of copyright holder nor the names of its contributors - may be used to endorse or promote products derived from this software - without specific prior written permission. +The "Corresponding Source" for a work in object code form means all +the source code needed to generate, install, and (for an executable +work) run the object code and to modify the work, including scripts to +control those activities. However, it does not include the work's +System Libraries, or general-purpose tools or generally available free +programs which are used unmodified in performing those activities but +which are not part of the work. For example, Corresponding Source +includes interface definition files associated with source files for +the work, and the source code for shared libraries and dynamically +linked subprograms that the work is specifically designed to require, +such as by intimate data communication or control flow between those +subprograms and other parts of the work. -THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" -AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE -IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE -DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE -FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL -DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR -SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER -CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, -OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE -OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. +The Corresponding Source need not include anything that users +can regenerate automatically from other parts of the Corresponding +Source. -plotly -5.9.0 -MIT -Chris P -https://plotly.com/python/ -An open-source, interactive data visualization library for Python -The MIT License (MIT) +The Corresponding Source for a work in source code form is that +same work. -Copyright (c) 2016-2018 Plotly, Inc +2. Basic Permissions. -Permission is hereby granted, free of charge, to any person obtaining a copy -of this software and associated documentation files (the "Software"), to deal -in the Software without restriction, including without limitation the rights -to use, copy, modify, merge, publish, distribute, sublicense, and/or sell -copies of the Software, and to permit persons to whom the Software is -furnished to do so, subject to the following conditions: +All rights granted under this License are granted for the term of +copyright on the Program, and are irrevocable provided the stated +conditions are met. This License explicitly affirms your unlimited +permission to run the unmodified Program. The output from running a +covered work is covered by this License only if the output, given its +content, constitutes a covered work. This License acknowledges your +rights of fair use or other equivalent, as provided by copyright law. -The above copyright notice and this permission notice shall be included in -all copies or substantial portions of the Software. +You may make, run and propagate covered works that you do not +convey, without conditions so long as your license otherwise remains +in force. You may convey covered works to others for the sole purpose +of having them make modifications exclusively for you, or provide you +with facilities for running those works, provided that you comply with +the terms of this License in conveying all material for which you do +not control copyright. Those thus making or running the covered works +for you must do so exclusively on your behalf, under your direction +and control, on terms that prohibit them from making any copies of +your copyrighted material outside their relationship with you. -THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR -IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, -FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE -AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER -LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, -OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN -THE SOFTWARE. +Conveying under any other circumstances is permitted solely under +the conditions stated below. Sublicensing is not allowed; section 10 +makes it unnecessary. +3. Protecting Users' Legal Rights From Anti-Circumvention Law. -Mako -1.2.0 -MIT License -Mike Bayer -https://www.makotemplates.org/ -A super-fast templating language that borrows the best ideas from the existing templating languages. -Copyright 2006-2021 the Mako authors and contributors . +No covered work shall be deemed part of an effective technological +measure under any applicable law fulfilling obligations under article +11 of the WIPO copyright treaty adopted on 20 December 1996, or +similar laws prohibiting or restricting circumvention of such +measures. -Permission is hereby granted, free of charge, to any person obtaining a copy of -this software and associated documentation files (the "Software"), to deal in -the Software without restriction, including without limitation the rights to -use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies -of the Software, and to permit persons to whom the Software is furnished to do -so, subject to the following conditions: +When you convey a covered work, you waive any legal power to forbid +circumvention of technological measures to the extent such circumvention +is effected by exercising rights under this License with respect to +the covered work, and you disclaim any intention to limit operation or +modification of the work as a means of enforcing, against the work's +users, your or third parties' legal rights to forbid circumvention of +technological measures. -The above copyright notice and this permission notice shall be included in all -copies or substantial portions of the Software. +4. Conveying Verbatim Copies. -THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR -IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, -FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE -AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER -LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, -OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE -SOFTWARE. +You may convey verbatim copies of the Program's source code as you +receive it, in any medium, provided that you conspicuously and +appropriately publish on each copy an appropriate copyright notice; +keep intact all notices stating that this License and any +non-permissive terms added in accord with section 7 apply to the code; +keep intact all notices of the absence of any warranty; and give all +recipients a copy of this License along with the Program. -PyYAML -6.0 -MIT License -Kirill Simonov -https://pyyaml.org/ -YAML parser and emitter for Python -Copyright (c) 2017-2021 Ingy döt Net -Copyright (c) 2006-2016 Kirill Simonov +You may charge any price or no price for each copy that you convey, +and you may offer support or warranty protection for a fee. -Permission is hereby granted, free of charge, to any person obtaining a copy of -this software and associated documentation files (the "Software"), to deal in -the Software without restriction, including without limitation the rights to -use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies -of the Software, and to permit persons to whom the Software is furnished to do -so, subject to the following conditions: +5. Conveying Modified Source Versions. -The above copyright notice and this permission notice shall be included in all -copies or substantial portions of the Software. +You may convey a work based on the Program, or the modifications to +produce it from the Program, in the form of source code under the +terms of section 4, provided that you also meet all of these conditions: -THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR -IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, -FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE -AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER -LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, -OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE -SOFTWARE. + a) The work must carry prominent notices stating that you modified + it, and giving a relevant date. + b) The work must carry prominent notices stating that it is + released under this License and any conditions added under section + 7. This requirement modifies the requirement in section 4 to + "keep intact all notices". -SQLAlchemy -1.4.39 -MIT License -Mike Bayer -https://www.sqlalchemy.org -Database Abstraction Library -Copyright 2005-2022 SQLAlchemy authors and contributors . + c) You must license the entire work, as a whole, under this + License to anyone who comes into possession of a copy. This + License will therefore apply, along with any applicable section 7 + additional terms, to the whole of the work, and all its parts, + regardless of how they are packaged. This License gives no + permission to license the work in any other way, but it does not + invalidate such permission if you have separately received it. -Permission is hereby granted, free of charge, to any person obtaining a copy of -this software and associated documentation files (the "Software"), to deal in -the Software without restriction, including without limitation the rights to -use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies -of the Software, and to permit persons to whom the Software is furnished to do -so, subject to the following conditions: + d) If the work has interactive user interfaces, each must display + Appropriate Legal Notices; however, if the Program has interactive + interfaces that do not display Appropriate Legal Notices, your + work need not make them do so. -The above copyright notice and this permission notice shall be included in all -copies or substantial portions of the Software. +A compilation of a covered work with other separate and independent +works, which are not by their nature extensions of the covered work, +and which are not combined with it such as to form a larger program, +in or on a volume of a storage or distribution medium, is called an +"aggregate" if the compilation and its resulting copyright are not +used to limit the access or legal rights of the compilation's users +beyond what the individual works permit. Inclusion of a covered work +in an aggregate does not cause this License to apply to the other +parts of the aggregate. -THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR -IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, -FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE -AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER -LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, -OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE -SOFTWARE. +6. Conveying Non-Source Forms. +You may convey a covered work in object code form under the terms +of sections 4 and 5, provided that you also convey the +machine-readable Corresponding Source under the terms of this License, +in one of these ways: -alembic -1.8.0 -MIT License -Mike Bayer -https://alembic.sqlalchemy.org -A database migration tool for SQLAlchemy. -Copyright 2009-2022 Michael Bayer. + a) Convey the object code in, or embodied in, a physical product + (including a physical distribution medium), accompanied by the + Corresponding Source fixed on a durable physical medium + customarily used for software interchange. -Permission is hereby granted, free of charge, to any person obtaining a copy of -this software and associated documentation files (the "Software"), to deal in -the Software without restriction, including without limitation the rights to -use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies -of the Software, and to permit persons to whom the Software is furnished to do -so, subject to the following conditions: + b) Convey the object code in, or embodied in, a physical product + (including a physical distribution medium), accompanied by a + written offer, valid for at least three years and valid for as + long as you offer spare parts or customer support for that product + model, to give anyone who possesses the object code either (1) a + copy of the Corresponding Source for all the software in the + product that is covered by this License, on a durable physical + medium customarily used for software interchange, for a price no + more than your reasonable cost of physically performing this + conveying of source, or (2) access to copy the + Corresponding Source from a network server at no charge. -The above copyright notice and this permission notice shall be included in all -copies or substantial portions of the Software. + c) Convey individual copies of the object code with a copy of the + written offer to provide the Corresponding Source. This + alternative is allowed only occasionally and noncommercially, and + only if you received the object code with such an offer, in accord + with subsection 6b. -THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR -IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, -FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE -AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER -LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, -OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE -SOFTWARE. + d) Convey the object code by offering access from a designated + place (gratis or for a charge), and offer equivalent access to the + Corresponding Source in the same way through the same place at no + further charge. You need not require recipients to copy the + Corresponding Source along with the object code. If the place to + copy the object code is a network server, the Corresponding Source + may be on a different server (operated by you or a third party) + that supports equivalent copying facilities, provided you maintain + clear directions next to the object code saying where to find the + Corresponding Source. Regardless of what server hosts the + Corresponding Source, you remain obligated to ensure that it is + available for as long as needed to satisfy these requirements. -attrs -21.4.0 -MIT License -Hynek Schlawack -https://www.attrs.org/ -Classes Without Boilerplate -The MIT License (MIT) + e) Convey the object code using peer-to-peer transmission, provided + you inform other peers where the object code and Corresponding + Source of the work are being offered to the general public at no + charge under subsection 6d. -Copyright (c) 2015 Hynek Schlawack +A separable portion of the object code, whose source code is excluded +from the Corresponding Source as a System Library, need not be +included in conveying the object code work. -Permission is hereby granted, free of charge, to any person obtaining a copy -of this software and associated documentation files (the "Software"), to deal -in the Software without restriction, including without limitation the rights -to use, copy, modify, merge, publish, distribute, sublicense, and/or sell -copies of the Software, and to permit persons to whom the Software is -furnished to do so, subject to the following conditions: +A "User Product" is either (1) a "consumer product", which means any +tangible personal property which is normally used for personal, family, +or household purposes, or (2) anything designed or sold for incorporation +into a dwelling. In determining whether a product is a consumer product, +doubtful cases shall be resolved in favor of coverage. For a particular +product received by a particular user, "normally used" refers to a +typical or common use of that class of product, regardless of the status +of the particular user or of the way in which the particular user +actually uses, or expects or is expected to use, the product. A product +is a consumer product regardless of whether the product has substantial +commercial, industrial or non-consumer uses, unless such uses represent +the only significant mode of use of the product. -The above copyright notice and this permission notice shall be included in all -copies or substantial portions of the Software. +"Installation Information" for a User Product means any methods, +procedures, authorization keys, or other information required to install +and execute modified versions of a covered work in that User Product from +a modified version of its Corresponding Source. The information must +suffice to ensure that the continued functioning of the modified object +code is in no case prevented or interfered with solely because +modification has been made. -THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR -IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, -FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE -AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER -LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, -OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE -SOFTWARE. +If you convey an object code work under this section in, or with, or +specifically for use in, a User Product, and the conveying occurs as +part of a transaction in which the right of possession and use of the +User Product is transferred to the recipient in perpetuity or for a +fixed term (regardless of how the transaction is characterized), the +Corresponding Source conveyed under this section must be accompanied +by the Installation Information. But this requirement does not apply +if neither you nor any third party retains the ability to install +modified object code on the User Product (for example, the work has +been installed in ROM). +The requirement to provide Installation Information does not include a +requirement to continue to provide support service, warranty, or updates +for a work that has been modified or installed by the recipient, or for +the User Product in which it has been modified or installed. Access to a +network may be denied when the modification itself materially and +adversely affects the operation of the network or violates the rules and +protocols for communication across the network. -bottle -0.12.21 -MIT License -Marcel Hellkamp -http://bottlepy.org/ -Fast and simple WSGI-framework for small web-applications. -Copyright (c) 2012, Marcel Hellkamp. +Corresponding Source conveyed, and Installation Information provided, +in accord with this section must be in a format that is publicly +documented (and with an implementation available to the public in +source code form), and must require no special password or key for +unpacking, reading or copying. -Permission is hereby granted, free of charge, to any person obtaining a copy -of this software and associated documentation files (the "Software"), to deal -in the Software without restriction, including without limitation the rights -to use, copy, modify, merge, publish, distribute, sublicense, and/or sell -copies of the Software, and to permit persons to whom the Software is -furnished to do so, subject to the following conditions: +7. Additional Terms. -The above copyright notice and this permission notice shall be included in -all copies or substantial portions of the Software. +"Additional permissions" are terms that supplement the terms of this +License by making exceptions from one or more of its conditions. +Additional permissions that are applicable to the entire Program shall +be treated as though they were included in this License, to the extent +that they are valid under applicable law. If additional permissions +apply only to part of the Program, that part may be used separately +under those permissions, but the entire Program remains governed by +this License without regard to the additional permissions. -THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR -IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, -FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE -AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER -LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, -OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN -THE SOFTWARE. +When you convey a copy of a covered work, you may at your option +remove any additional permissions from that copy, or from any part of +it. (Additional permissions may be written to require their own +removal in certain cases when you modify the work.) You may place +additional permissions on material, added by you to a covered work, +for which you have or can give appropriate copyright permission. +Notwithstanding any other provision of this License, for material you +add to a covered work, you may (if authorized by the copyright holders of +that material) supplement the terms of this License with terms: -cmaes -0.8.2 -MIT License -Masashi Shibata -https://github.com/CyberAgent/cmaes -Lightweight Covariance Matrix Adaptation Evolution Strategy (CMA-ES) implementation for Python 3. -MIT License + a) Disclaiming warranty or limiting liability differently from the + terms of sections 15 and 16 of this License; or -Copyright (c) 2020-2021 CyberAgent, Inc. + b) Requiring preservation of specified reasonable legal notices or + author attributions in that material or in the Appropriate Legal + Notices displayed by works containing it; or -Permission is hereby granted, free of charge, to any person obtaining a copy -of this software and associated documentation files (the "Software"), to deal -in the Software without restriction, including without limitation the rights -to use, copy, modify, merge, publish, distribute, sublicense, and/or sell -copies of the Software, and to permit persons to whom the Software is -furnished to do so, subject to the following conditions: + c) Prohibiting misrepresentation of the origin of that material, or + requiring that modified versions of such material be marked in + reasonable ways as different from the original version; or -The above copyright notice and this permission notice shall be included in all -copies or substantial portions of the Software. + d) Limiting the use for publicity purposes of names of licensors or + authors of the material; or -THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR -IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, -FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE -AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER -LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, -OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE -SOFTWARE. + e) Declining to grant rights under trademark law for use of some + trade names, trademarks, or service marks; or + f) Requiring indemnification of licensors and authors of that + material by anyone who conveys the material (or modified versions of + it) with contractual assumptions of liability to the recipient, for + any liability that these contractual assumptions directly impose on + those licensors and authors. -cmd2 -2.4.1 -MIT License -Catherine Devlin -https://github.com/python-cmd2/cmd2 -cmd2 - quickly build feature-rich and user-friendly interactive command line applications in Python -The MIT License (MIT) +All other non-permissive additional terms are considered "further +restrictions" within the meaning of section 10. If the Program as you +received it, or any part of it, contains a notice stating that it is +governed by this License along with a term that is a further +restriction, you may remove that term. If a license document contains +a further restriction but permits relicensing or conveying under this +License, you may add to a covered work material governed by the terms +of that license document, provided that the further restriction does +not survive such relicensing or conveying. -Copyright (c) 2008-2022 Catherine Devlin and others +If you add terms to a covered work in accord with this section, you +must place, in the relevant source files, a statement of the +additional terms that apply to those files, or a notice indicating +where to find the applicable terms. -Permission is hereby granted, free of charge, to any person obtaining a copy -of this software and associated documentation files (the "Software"), to deal -in the Software without restriction, including without limitation the rights -to use, copy, modify, merge, publish, distribute, sublicense, and/or sell -copies of the Software, and to permit persons to whom the Software is -furnished to do so, subject to the following conditions: +Additional terms, permissive or non-permissive, may be stated in the +form of a separately written license, or stated as exceptions; +the above requirements apply either way. -The above copyright notice and this permission notice shall be included in -all copies or substantial portions of the Software. +8. Termination. -THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR -IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, -FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE -AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER -LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, -OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN -THE SOFTWARE. +You may not propagate or modify a covered work except as expressly +provided under this License. Any attempt otherwise to propagate or +modify it is void, and will automatically terminate your rights under +this License (including any patent licenses granted under the third +paragraph of section 11). + +However, if you cease all violation of this License, then your +license from a particular copyright holder is reinstated (a) +provisionally, unless and until the copyright holder explicitly and +finally terminates your license, and (b) permanently, if the copyright +holder fails to notify you of the violation by some reasonable means +prior to 60 days after the cessation. + +Moreover, your license from a particular copyright holder is +reinstated permanently if the copyright holder notifies you of the +violation by some reasonable means, this is the first time you have +received notice of violation of this License (for any work) from that +copyright holder, and you cure the violation prior to 30 days after +your receipt of the notice. + +Termination of your rights under this section does not terminate the +licenses of parties who have received copies or rights from you under +this License. If your rights have been terminated and not permanently +reinstated, you do not qualify to receive new licenses for the same +material under section 10. + +9. Acceptance Not Required for Having Copies. + +You are not required to accept this License in order to receive or +run a copy of the Program. Ancillary propagation of a covered work +occurring solely as a consequence of using peer-to-peer transmission +to receive a copy likewise does not require acceptance. However, +nothing other than this License grants you permission to propagate or +modify any covered work. These actions infringe copyright if you do +not accept this License. Therefore, by modifying or propagating a +covered work, you indicate your acceptance of this License to do so. + +10. Automatic Licensing of Downstream Recipients. + +Each time you convey a covered work, the recipient automatically +receives a license from the original licensors, to run, modify and +propagate that work, subject to this License. You are not responsible +for enforcing compliance by third parties with this License. + +An "entity transaction" is a transaction transferring control of an +organization, or substantially all assets of one, or subdividing an +organization, or merging organizations. If propagation of a covered +work results from an entity transaction, each party to that +transaction who receives a copy of the work also receives whatever +licenses to the work the party's predecessor in interest had or could +give under the previous paragraph, plus a right to possession of the +Corresponding Source of the work from the predecessor in interest, if +the predecessor has it or can get it with reasonable efforts. + +You may not impose any further restrictions on the exercise of the +rights granted or affirmed under this License. For example, you may +not impose a license fee, royalty, or other charge for exercise of +rights granted under this License, and you may not initiate litigation +(including a cross-claim or counterclaim in a lawsuit) alleging that +any patent claim is infringed by making, using, selling, offering for +sale, or importing the Program or any portion of it. + +11. Patents. + +A "contributor" is a copyright holder who authorizes use under this +License of the Program or a work on which the Program is based. The +work thus licensed is called the contributor's "contributor version". + +A contributor's "essential patent claims" are all patent claims +owned or controlled by the contributor, whether already acquired or +hereafter acquired, that would be infringed by some manner, permitted +by this License, of making, using, or selling its contributor version, +but do not include claims that would be infringed only as a +consequence of further modification of the contributor version. For +purposes of this definition, "control" includes the right to grant +patent sublicenses in a manner consistent with the requirements of +this License. + +Each contributor grants you a non-exclusive, worldwide, royalty-free +patent license under the contributor's essential patent claims, to +make, use, sell, offer for sale, import and otherwise run, modify and +propagate the contents of its contributor version. + +In the following three paragraphs, a "patent license" is any express +agreement or commitment, however denominated, not to enforce a patent +(such as an express permission to practice a patent or covenant not to +sue for patent infringement). To "grant" such a patent license to a +party means to make such an agreement or commitment not to enforce a +patent against the party. + +If you convey a covered work, knowingly relying on a patent license, +and the Corresponding Source of the work is not available for anyone +to copy, free of charge and under the terms of this License, through a +publicly available network server or other readily accessible means, +then you must either (1) cause the Corresponding Source to be so +available, or (2) arrange to deprive yourself of the benefit of the +patent license for this particular work, or (3) arrange, in a manner +consistent with the requirements of this License, to extend the patent +license to downstream recipients. "Knowingly relying" means you have +actual knowledge that, but for the patent license, your conveying the +covered work in a country, or your recipient's use of the covered work +in a country, would infringe one or more identifiable patents in that +country that you have reason to believe are valid. + +If, pursuant to or in connection with a single transaction or +arrangement, you convey, or propagate by procuring conveyance of, a +covered work, and grant a patent license to some of the parties +receiving the covered work authorizing them to use, propagate, modify +or convey a specific copy of the covered work, then the patent license +you grant is automatically extended to all recipients of the covered +work and works based on it. + +A patent license is "discriminatory" if it does not include within +the scope of its coverage, prohibits the exercise of, or is +conditioned on the non-exercise of one or more of the rights that are +specifically granted under this License. You may not convey a covered +work if you are a party to an arrangement with a third party that is +in the business of distributing software, under which you make payment +to the third party based on the extent of your activity of conveying +the work, and under which the third party grants, to any of the +parties who would receive the covered work from you, a discriminatory +patent license (a) in connection with copies of the covered work +conveyed by you (or copies made from those copies), or (b) primarily +for and in connection with specific products or compilations that +contain the covered work, unless you entered into that arrangement, +or that patent license was granted, prior to 28 March 2007. + +Nothing in this License shall be construed as excluding or limiting +any implied license or other defenses to infringement that may +otherwise be available to you under applicable patent law. + +12. No Surrender of Others' Freedom. + +If conditions are imposed on you (whether by court order, agreement or +otherwise) that contradict the conditions of this License, they do not +excuse you from the conditions of this License. If you cannot convey a +covered work so as to satisfy simultaneously your obligations under this +License and any other pertinent obligations, then as a consequence you may +not convey it at all. For example, if you agree to terms that obligate you +to collect a royalty for further conveying from those to whom you convey +the Program, the only way you could satisfy both those terms and this +License would be to refrain entirely from conveying the Program. + +13. Use with the GNU Affero General Public License. + +Notwithstanding any other provision of this License, you have +permission to link or combine any covered work with a work licensed +under version 3 of the GNU Affero General Public License into a single +combined work, and to convey the resulting work. The terms of this +License will continue to apply to the part which is the covered work, +but the special requirements of the GNU Affero General Public License, +section 13, concerning interaction through a network will apply to the +combination as such. + +14. Revised Versions of this License. + +The Free Software Foundation may publish revised and/or new versions of +the GNU General Public License from time to time. Such new versions will +be similar in spirit to the present version, but may differ in detail to +address new problems or concerns. + +Each version is given a distinguishing version number. If the +Program specifies that a certain numbered version of the GNU General +Public License "or any later version" applies to it, you have the +option of following the terms and conditions either of that numbered +version or of any later version published by the Free Software +Foundation. If the Program does not specify a version number of the +GNU General Public License, you may choose any version ever published +by the Free Software Foundation. + +If the Program specifies that a proxy can decide which future +versions of the GNU General Public License can be used, that proxy's +public statement of acceptance of a version permanently authorizes you +to choose that version for the Program. + +Later license versions may give you additional or different +permissions. However, no additional obligations are imposed on any +author or copyright holder as a result of your choosing to follow a +later version. + +15. Disclaimer of Warranty. + +THERE IS NO WARRANTY FOR THE PROGRAM, TO THE EXTENT PERMITTED BY +APPLICABLE LAW. EXCEPT WHEN OTHERWISE STATED IN WRITING THE COPYRIGHT +HOLDERS AND/OR OTHER PARTIES PROVIDE THE PROGRAM "AS IS" WITHOUT WARRANTY +OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, +THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR +PURPOSE. THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE PROGRAM +IS WITH YOU. SHOULD THE PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF +ALL NECESSARY SERVICING, REPAIR OR CORRECTION. + +16. Limitation of Liability. + +IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING +WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MODIFIES AND/OR CONVEYS +THE PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES, INCLUDING ANY +GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE +USE OR INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED TO LOSS OF +DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY YOU OR THIRD +PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER PROGRAMS), +EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF +SUCH DAMAGES. + +17. Interpretation of Sections 15 and 16. + +If the disclaimer of warranty and limitation of liability provided +above cannot be given local legal effect according to their terms, +reviewing courts shall apply local law that most closely approximates +an absolute waiver of all civil liability in connection with the +Program, unless a warranty or assumption of liability accompanies a +copy of the Program in return for a fee. + + END OF TERMS AND CONDITIONS + + How to Apply These Terms to Your New Programs + +If you develop a new program, and you want it to be of the greatest +possible use to the public, the best way to achieve this is to make it +free software which everyone can redistribute and change under these terms. + +To do so, attach the following notices to the program. It is safest +to attach them to the start of each source file to most effectively +state the exclusion of warranty; and each file should have at least +the "copyright" line and a pointer to where the full notice is found. + + + Copyright (C) + + This program is free software: you can redistribute it and/or modify + it under the terms of the GNU General Public License as published by + the Free Software Foundation, either version 3 of the License, or + (at your option) any later version. + + This program is distributed in the hope that it will be useful, + but WITHOUT ANY WARRANTY; without even the implied warranty of + MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + GNU General Public License for more details. + + You should have received a copy of the GNU General Public License + along with this program. If not, see . + +Also add information on how to contact you by electronic and paper mail. + +If the program does terminal interaction, make it output a short +notice like this when it starts in an interactive mode: + + Copyright (C) + This program comes with ABSOLUTELY NO WARRANTY; for details type `show w'. + This is free software, and you are welcome to redistribute it + under certain conditions; type `show c' for details. + +The hypothetical commands `show w' and `show c' should show the appropriate +parts of the General Public License. Of course, your program's commands +might be different; for a GUI interface, you would use an "about box". +You should also get your employer (if you work as a programmer) or school, +if any, to sign a "copyright disclaimer" for the program, if necessary. +For more information on this, and how to apply and follow the GNU GPL, see +. -colorlog -6.6.0 -MIT License -Sam Clements -https://github.com/borntyping/python-colorlog -Add colours to the output of Python's logging module. -The MIT License (MIT) +The GNU General Public License does not permit incorporating your program +into proprietary programs. If your program is a subroutine library, you +may consider it more useful to permit linking proprietary applications with +the library. If this is what you want to do, use the GNU Lesser General +Public License instead of this License. But first, please read +. -Copyright (c) 2012-2021 Sam Clements +six +1.16.0 +MIT License +https://github.com/benjaminp/six +Copyright (c) 2010-2020 Benjamin Peterson Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in @@ -3512,170 +3686,899 @@ COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. +stevedore +3.5.0 +Apache Software License +https://docs.openstack.org/stevedore/latest/ -greenlet -1.1.2 -MIT License -Alexey Borzenkov -https://greenlet.readthedocs.io/ -Lightweight in-process concurrent programming -The following files are derived from Stackless Python and are subject to the -same license as Stackless Python: + Apache License + Version 2.0, January 2004 + http://www.apache.org/licenses/ - src/greenlet/slp_platformselect.h - files in src/greenlet/platform/ directory +TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION + +1. Definitions. + + "License" shall mean the terms and conditions for use, reproduction, + and distribution as defined by Sections 1 through 9 of this document. + + "Licensor" shall mean the copyright owner or entity authorized by + the copyright owner that is granting the License. + + "Legal Entity" shall mean the union of the acting entity and all + other entities that control, are controlled by, or are under common + control with that entity. For the purposes of this definition, + "control" means (i) the power, direct or indirect, to cause the + direction or management of such entity, whether by contract or + otherwise, or (ii) ownership of fifty percent (50%) or more of the + outstanding shares, or (iii) beneficial ownership of such entity. + + "You" (or "Your") shall mean an individual or Legal Entity + exercising permissions granted by this License. + + "Source" form shall mean the preferred form for making modifications, + including but not limited to software source code, documentation + source, and configuration files. + + "Object" form shall mean any form resulting from mechanical + transformation or translation of a Source form, including but + not limited to compiled object code, generated documentation, + and conversions to other media types. + + "Work" shall mean the work of authorship, whether in Source or + Object form, made available under the License, as indicated by a + copyright notice that is included in or attached to the work + (an example is provided in the Appendix below). + + "Derivative Works" shall mean any work, whether in Source or Object + form, that is based on (or derived from) the Work and for which the + editorial revisions, annotations, elaborations, or other modifications + represent, as a whole, an original work of authorship. For the purposes + of this License, Derivative Works shall not include works that remain + separable from, or merely link (or bind by name) to the interfaces of, + the Work and Derivative Works thereof. + + "Contribution" shall mean any work of authorship, including + the original version of the Work and any modifications or additions + to that Work or Derivative Works thereof, that is intentionally + submitted to Licensor for inclusion in the Work by the copyright owner + or by an individual or Legal Entity authorized to submit on behalf of + the copyright owner. For the purposes of this definition, "submitted" + means any form of electronic, verbal, or written communication sent + to the Licensor or its representatives, including but not limited to + communication on electronic mailing lists, source code control systems, + and issue tracking systems that are managed by, or on behalf of, the + Licensor for the purpose of discussing and improving the Work, but + excluding communication that is conspicuously marked or otherwise + designated in writing by the copyright owner as "Not a Contribution." + + "Contributor" shall mean Licensor and any individual or Legal Entity + on behalf of whom a Contribution has been received by Licensor and + subsequently incorporated within the Work. + +2. Grant of Copyright License. Subject to the terms and conditions of + this License, each Contributor hereby grants to You a perpetual, + worldwide, non-exclusive, no-charge, royalty-free, irrevocable + copyright license to reproduce, prepare Derivative Works of, + publicly display, publicly perform, sublicense, and distribute the + Work and such Derivative Works in Source or Object form. + +3. Grant of Patent License. Subject to the terms and conditions of + this License, each Contributor hereby grants to You a perpetual, + worldwide, non-exclusive, no-charge, royalty-free, irrevocable + (except as stated in this section) patent license to make, have made, + use, offer to sell, sell, import, and otherwise transfer the Work, + where such license applies only to those patent claims licensable + by such Contributor that are necessarily infringed by their + Contribution(s) alone or by combination of their Contribution(s) + with the Work to which such Contribution(s) was submitted. If You + institute patent litigation against any entity (including a + cross-claim or counterclaim in a lawsuit) alleging that the Work + or a Contribution incorporated within the Work constitutes direct + or contributory patent infringement, then any patent licenses + granted to You under this License for that Work shall terminate + as of the date such litigation is filed. + +4. Redistribution. You may reproduce and distribute copies of the + Work or Derivative Works thereof in any medium, with or without + modifications, and in Source or Object form, provided that You + meet the following conditions: + + (a) You must give any other recipients of the Work or + Derivative Works a copy of this License; and + + (b) You must cause any modified files to carry prominent notices + stating that You changed the files; and + + (c) You must retain, in the Source form of any Derivative Works + that You distribute, all copyright, patent, trademark, and + attribution notices from the Source form of the Work, + excluding those notices that do not pertain to any part of + the Derivative Works; and + + (d) If the Work includes a "NOTICE" text file as part of its + distribution, then any Derivative Works that You distribute must + include a readable copy of the attribution notices contained + within such NOTICE file, excluding those notices that do not + pertain to any part of the Derivative Works, in at least one + of the following places: within a NOTICE text file distributed + as part of the Derivative Works; within the Source form or + documentation, if provided along with the Derivative Works; or, + within a display generated by the Derivative Works, if and + wherever such third-party notices normally appear. The contents + of the NOTICE file are for informational purposes only and + do not modify the License. You may add Your own attribution + notices within Derivative Works that You distribute, alongside + or as an addendum to the NOTICE text from the Work, provided + that such additional attribution notices cannot be construed + as modifying the License. + + You may add Your own copyright statement to Your modifications and + may provide additional or different license terms and conditions + for use, reproduction, or distribution of Your modifications, or + for any such Derivative Works as a whole, provided Your use, + reproduction, and distribution of the Work otherwise complies with + the conditions stated in this License. + +5. Submission of Contributions. Unless You explicitly state otherwise, + any Contribution intentionally submitted for inclusion in the Work + by You to the Licensor shall be under the terms and conditions of + this License, without any additional terms or conditions. + Notwithstanding the above, nothing herein shall supersede or modify + the terms of any separate license agreement you may have executed + with Licensor regarding such Contributions. + +6. Trademarks. This License does not grant permission to use the trade + names, trademarks, service marks, or product names of the Licensor, + except as required for reasonable and customary use in describing the + origin of the Work and reproducing the content of the NOTICE file. + +7. Disclaimer of Warranty. Unless required by applicable law or + agreed to in writing, Licensor provides the Work (and each + Contributor provides its Contributions) on an "AS IS" BASIS, + WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or + implied, including, without limitation, any warranties or conditions + of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A + PARTICULAR PURPOSE. You are solely responsible for determining the + appropriateness of using or redistributing the Work and assume any + risks associated with Your exercise of permissions under this License. + +8. Limitation of Liability. In no event and under no legal theory, + whether in tort (including negligence), contract, or otherwise, + unless required by applicable law (such as deliberate and grossly + negligent acts) or agreed to in writing, shall any Contributor be + liable to You for damages, including any direct, indirect, special, + incidental, or consequential damages of any character arising as a + result of this License or out of the use or inability to use the + Work (including but not limited to damages for loss of goodwill, + work stoppage, computer failure or malfunction, or any and all + other commercial damages or losses), even if such Contributor + has been advised of the possibility of such damages. + +9. Accepting Warranty or Additional Liability. While redistributing + the Work or Derivative Works thereof, You may choose to offer, + and charge a fee for, acceptance of support, warranty, indemnity, + or other liability obligations and/or rights consistent with this + License. However, in accepting such obligations, You may act only + on Your own behalf and on Your sole responsibility, not on behalf + of any other Contributor, and only if You agree to indemnify, + defend, and hold each Contributor harmless for any liability + incurred by, or claims asserted against, such Contributor by reason + of your accepting any such warranty or additional liability. + +END OF TERMS AND CONDITIONS + +APPENDIX: How to apply the Apache License to your work. -See LICENSE.PSF and http://www.stackless.com/ for details. + To apply the Apache License to your work, attach the following + boilerplate notice, with the fields enclosed by brackets "[]" + replaced with your own identifying information. (Don't include + the brackets!) The text should be enclosed in the appropriate + comment syntax for the file format. We also recommend that a + file or class name and description of purpose be included on the + same "printed page" as the copyright notice for easier + identification within third-party archives. -Unless otherwise noted, the files in greenlet have been released under the -following MIT license: +Copyright [yyyy] [name of copyright owner] -Copyright (c) Armin Rigo, Christian Tismer and contributors +Licensed under the Apache License, Version 2.0 (the "License"); +you may not use this file except in compliance with the License. +You may obtain a copy of the License at -Permission is hereby granted, free of charge, to any person obtaining a copy -of this software and associated documentation files (the "Software"), to deal -in the Software without restriction, including without limitation the rights -to use, copy, modify, merge, publish, distribute, sublicense, and/or sell -copies of the Software, and to permit persons to whom the Software is -furnished to do so, subject to the following conditions: + http://www.apache.org/licenses/LICENSE-2.0 -The above copyright notice and this permission notice shall be included in -all copies or substantial portions of the Software. +Unless required by applicable law or agreed to in writing, software +distributed under the License is distributed on an "AS IS" BASIS, +WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +See the License for the specific language governing permissions and +limitations under the License. -THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR -IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, -FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE -AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER -LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, -OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN -THE SOFTWARE. +tenacity +8.0.1 +Apache Software License +https://github.com/jd/tenacity + Apache License + Version 2.0, January 2004 + http://www.apache.org/licenses/ -optuna -2.10.1 -MIT License -Takuya Akiba -https://optuna.org/ -A hyperparameter optimization framework -MIT License +TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION + +1. Definitions. + + "License" shall mean the terms and conditions for use, reproduction, + and distribution as defined by Sections 1 through 9 of this document. + + "Licensor" shall mean the copyright owner or entity authorized by + the copyright owner that is granting the License. + + "Legal Entity" shall mean the union of the acting entity and all + other entities that control, are controlled by, or are under common + control with that entity. For the purposes of this definition, + "control" means (i) the power, direct or indirect, to cause the + direction or management of such entity, whether by contract or + otherwise, or (ii) ownership of fifty percent (50%) or more of the + outstanding shares, or (iii) beneficial ownership of such entity. + + "You" (or "Your") shall mean an individual or Legal Entity + exercising permissions granted by this License. + + "Source" form shall mean the preferred form for making modifications, + including but not limited to software source code, documentation + source, and configuration files. + + "Object" form shall mean any form resulting from mechanical + transformation or translation of a Source form, including but + not limited to compiled object code, generated documentation, + and conversions to other media types. + + "Work" shall mean the work of authorship, whether in Source or + Object form, made available under the License, as indicated by a + copyright notice that is included in or attached to the work + (an example is provided in the Appendix below). + + "Derivative Works" shall mean any work, whether in Source or Object + form, that is based on (or derived from) the Work and for which the + editorial revisions, annotations, elaborations, or other modifications + represent, as a whole, an original work of authorship. For the purposes + of this License, Derivative Works shall not include works that remain + separable from, or merely link (or bind by name) to the interfaces of, + the Work and Derivative Works thereof. + + "Contribution" shall mean any work of authorship, including + the original version of the Work and any modifications or additions + to that Work or Derivative Works thereof, that is intentionally + submitted to Licensor for inclusion in the Work by the copyright owner + or by an individual or Legal Entity authorized to submit on behalf of + the copyright owner. For the purposes of this definition, "submitted" + means any form of electronic, verbal, or written communication sent + to the Licensor or its representatives, including but not limited to + communication on electronic mailing lists, source code control systems, + and issue tracking systems that are managed by, or on behalf of, the + Licensor for the purpose of discussing and improving the Work, but + excluding communication that is conspicuously marked or otherwise + designated in writing by the copyright owner as "Not a Contribution." + + "Contributor" shall mean Licensor and any individual or Legal Entity + on behalf of whom a Contribution has been received by Licensor and + subsequently incorporated within the Work. + +2. Grant of Copyright License. Subject to the terms and conditions of + this License, each Contributor hereby grants to You a perpetual, + worldwide, non-exclusive, no-charge, royalty-free, irrevocable + copyright license to reproduce, prepare Derivative Works of, + publicly display, publicly perform, sublicense, and distribute the + Work and such Derivative Works in Source or Object form. + +3. Grant of Patent License. Subject to the terms and conditions of + this License, each Contributor hereby grants to You a perpetual, + worldwide, non-exclusive, no-charge, royalty-free, irrevocable + (except as stated in this section) patent license to make, have made, + use, offer to sell, sell, import, and otherwise transfer the Work, + where such license applies only to those patent claims licensable + by such Contributor that are necessarily infringed by their + Contribution(s) alone or by combination of their Contribution(s) + with the Work to which such Contribution(s) was submitted. If You + institute patent litigation against any entity (including a + cross-claim or counterclaim in a lawsuit) alleging that the Work + or a Contribution incorporated within the Work constitutes direct + or contributory patent infringement, then any patent licenses + granted to You under this License for that Work shall terminate + as of the date such litigation is filed. + +4. Redistribution. You may reproduce and distribute copies of the + Work or Derivative Works thereof in any medium, with or without + modifications, and in Source or Object form, provided that You + meet the following conditions: + + (a) You must give any other recipients of the Work or + Derivative Works a copy of this License; and + + (b) You must cause any modified files to carry prominent notices + stating that You changed the files; and + + (c) You must retain, in the Source form of any Derivative Works + that You distribute, all copyright, patent, trademark, and + attribution notices from the Source form of the Work, + excluding those notices that do not pertain to any part of + the Derivative Works; and + + (d) If the Work includes a "NOTICE" text file as part of its + distribution, then any Derivative Works that You distribute must + include a readable copy of the attribution notices contained + within such NOTICE file, excluding those notices that do not + pertain to any part of the Derivative Works, in at least one + of the following places: within a NOTICE text file distributed + as part of the Derivative Works; within the Source form or + documentation, if provided along with the Derivative Works; or, + within a display generated by the Derivative Works, if and + wherever such third-party notices normally appear. The contents + of the NOTICE file are for informational purposes only and + do not modify the License. You may add Your own attribution + notices within Derivative Works that You distribute, alongside + or as an addendum to the NOTICE text from the Work, provided + that such additional attribution notices cannot be construed + as modifying the License. + + You may add Your own copyright statement to Your modifications and + may provide additional or different license terms and conditions + for use, reproduction, or distribution of Your modifications, or + for any such Derivative Works as a whole, provided Your use, + reproduction, and distribution of the Work otherwise complies with + the conditions stated in this License. + +5. Submission of Contributions. Unless You explicitly state otherwise, + any Contribution intentionally submitted for inclusion in the Work + by You to the Licensor shall be under the terms and conditions of + this License, without any additional terms or conditions. + Notwithstanding the above, nothing herein shall supersede or modify + the terms of any separate license agreement you may have executed + with Licensor regarding such Contributions. + +6. Trademarks. This License does not grant permission to use the trade + names, trademarks, service marks, or product names of the Licensor, + except as required for reasonable and customary use in describing the + origin of the Work and reproducing the content of the NOTICE file. + +7. Disclaimer of Warranty. Unless required by applicable law or + agreed to in writing, Licensor provides the Work (and each + Contributor provides its Contributions) on an "AS IS" BASIS, + WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or + implied, including, without limitation, any warranties or conditions + of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A + PARTICULAR PURPOSE. You are solely responsible for determining the + appropriateness of using or redistributing the Work and assume any + risks associated with Your exercise of permissions under this License. + +8. Limitation of Liability. In no event and under no legal theory, + whether in tort (including negligence), contract, or otherwise, + unless required by applicable law (such as deliberate and grossly + negligent acts) or agreed to in writing, shall any Contributor be + liable to You for damages, including any direct, indirect, special, + incidental, or consequential damages of any character arising as a + result of this License or out of the use or inability to use the + Work (including but not limited to damages for loss of goodwill, + work stoppage, computer failure or malfunction, or any and all + other commercial damages or losses), even if such Contributor + has been advised of the possibility of such damages. + +9. Accepting Warranty or Additional Liability. While redistributing + the Work or Derivative Works thereof, You may choose to offer, + and charge a fee for, acceptance of support, warranty, indemnity, + or other liability obligations and/or rights consistent with this + License. However, in accepting such obligations, You may act only + on Your own behalf and on Your sole responsibility, not on behalf + of any other Contributor, and only if You agree to indemnify, + defend, and hold each Contributor harmless for any liability + incurred by, or claims asserted against, such Contributor by reason + of your accepting any such warranty or additional liability. + +END OF TERMS AND CONDITIONS + +APPENDIX: How to apply the Apache License to your work. -Copyright (c) 2018 Preferred Networks, Inc. + To apply the Apache License to your work, attach the following + boilerplate notice, with the fields enclosed by brackets "[]" + replaced with your own identifying information. (Don't include + the brackets!) The text should be enclosed in the appropriate + comment syntax for the file format. We also recommend that a + file or class name and description of purpose be included on the + same "printed page" as the copyright notice for easier + identification within third-party archives. -Permission is hereby granted, free of charge, to any person obtaining a copy -of this software and associated documentation files (the "Software"), to deal -in the Software without restriction, including without limitation the rights -to use, copy, modify, merge, publish, distribute, sublicense, and/or sell -copies of the Software, and to permit persons to whom the Software is -furnished to do so, subject to the following conditions: +Copyright [yyyy] [name of copyright owner] -The above copyright notice and this permission notice shall be included in all -copies or substantial portions of the Software. +Licensed under the Apache License, Version 2.0 (the "License"); +you may not use this file except in compliance with the License. +You may obtain a copy of the License at -THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR -IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, -FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE -AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER -LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, -OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE -SOFTWARE. + http://www.apache.org/licenses/LICENSE-2.0 +Unless required by applicable law or agreed to in writing, software +distributed under the License is distributed on an "AS IS" BASIS, +WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +See the License for the specific language governing permissions and +limitations under the License. -optuna-dashboard -0.7.1 -MIT License -Masashi Shibata -https://github.com/optuna/optuna-dashboard -Real-time dashboard for Optuna. -MIT License +threadpoolctl +3.1.0 +BSD License +https://github.com/joblib/threadpoolctl +Copyright (c) 2019, threadpoolctl contributors -Copyright (c) 2020-2021 Masashi SHIBATA +Redistribution and use in source and binary forms, with or without +modification, are permitted provided that the following conditions are met: -Permission is hereby granted, free of charge, to any person obtaining a copy -of this software and associated documentation files (the "Software"), to deal -in the Software without restriction, including without limitation the rights -to use, copy, modify, merge, publish, distribute, sublicense, and/or sell -copies of the Software, and to permit persons to whom the Software is -furnished to do so, subject to the following conditions: + * Redistributions of source code must retain the above copyright notice, + this list of conditions and the following disclaimer. + * Redistributions in binary form must reproduce the above copyright + notice, this list of conditions and the following disclaimer in the + documentation and/or other materials provided with the distribution. + * Neither the name of copyright holder nor the names of its contributors + may be used to endorse or promote products derived from this software + without specific prior written permission. -The above copyright notice and this permission notice shall be included in all -copies or substantial portions of the Software. +THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" +AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE +IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE +DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE +FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL +DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR +SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER +CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, +OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE +OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. -THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR -IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, -FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE -AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER -LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, -OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE -SOFTWARE. +torch +1.12.0 +BSD License +https://pytorch.org/ +From PyTorch: +Copyright (c) 2016- Facebook, Inc (Adam Paszke) +Copyright (c) 2014- Facebook, Inc (Soumith Chintala) +Copyright (c) 2011-2014 Idiap Research Institute (Ronan Collobert) +Copyright (c) 2012-2014 Deepmind Technologies (Koray Kavukcuoglu) +Copyright (c) 2011-2012 NEC Laboratories America (Koray Kavukcuoglu) +Copyright (c) 2011-2013 NYU (Clement Farabet) +Copyright (c) 2006-2010 NEC Laboratories America (Ronan Collobert, Leon Bottou, Iain Melvin, Jason Weston) +Copyright (c) 2006 Idiap Research Institute (Samy Bengio) +Copyright (c) 2001-2004 Idiap Research Institute (Ronan Collobert, Samy Bengio, Johnny Mariethoz) -pyparsing -3.0.9 -MIT License -UNKNOWN -UNKNOWN -pyparsing module - Classes and methods to define and execute parsing grammars -Permission is hereby granted, free of charge, to any person obtaining -a copy of this software and associated documentation files (the -"Software"), to deal in the Software without restriction, including -without limitation the rights to use, copy, modify, merge, publish, -distribute, sublicense, and/or sell copies of the Software, and to -permit persons to whom the Software is furnished to do so, subject to -the following conditions: +From Caffe2: -The above copyright notice and this permission notice shall be -included in all copies or substantial portions of the Software. +Copyright (c) 2016-present, Facebook Inc. All rights reserved. -THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, -EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF -MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. -IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY -CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, -TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE -SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. +All contributions by Facebook: +Copyright (c) 2016 Facebook Inc. +All contributions by Google: +Copyright (c) 2015 Google Inc. +All rights reserved. -wcwidth -0.2.5 -MIT License -Jeff Quast -https://github.com/jquast/wcwidth -Measures the displayed width of unicode strings in a terminal -The MIT License (MIT) +All contributions by Yangqing Jia: +Copyright (c) 2015 Yangqing Jia +All rights reserved. -Copyright (c) 2014 Jeff Quast +All contributions by Kakao Brain: +Copyright 2019-2020 Kakao Brain -Permission is hereby granted, free of charge, to any person obtaining a copy -of this software and associated documentation files (the "Software"), to deal -in the Software without restriction, including without limitation the rights -to use, copy, modify, merge, publish, distribute, sublicense, and/or sell -copies of the Software, and to permit persons to whom the Software is -furnished to do so, subject to the following conditions: +All contributions by Cruise LLC: +Copyright (c) 2022 Cruise LLC. +All rights reserved. -The above copyright notice and this permission notice shall be included in all -copies or substantial portions of the Software. +All contributions from Caffe: +Copyright(c) 2013, 2014, 2015, the respective contributors +All rights reserved. -THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR -IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, -FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE -AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER -LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, -OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE -SOFTWARE. +All other contributions: +Copyright(c) 2015, 2016 the respective contributors +All rights reserved. -Markus Kuhn -- 2007-05-26 (Unicode 5.0) +Caffe2 uses a copyright model similar to Caffe: each contributor holds +copyright over their contributions to Caffe2. The project versioning records +all such contribution and copyright details. If a contributor wants to further +mark their specific copyright on a particular contribution, they should +indicate their copyright solely in the commit message of the change when it is +committed. -Permission to use, copy, modify, and distribute this software -for any purpose and without fee is hereby granted. The author -disclaims all warranties with regard to this software. +All rights reserved. + +Redistribution and use in source and binary forms, with or without +modification, are permitted provided that the following conditions are met: + +1. Redistributions of source code must retain the above copyright + notice, this list of conditions and the following disclaimer. + +2. Redistributions in binary form must reproduce the above copyright + notice, this list of conditions and the following disclaimer in the + documentation and/or other materials provided with the distribution. +3. Neither the names of Facebook, Deepmind Technologies, NYU, NEC Laboratories America + and IDIAP Research Institute nor the names of its contributors may be + used to endorse or promote products derived from this software without + specific prior written permission. + +THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" +AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE +IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE +ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE +LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR +CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF +SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS +INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN +CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) +ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE +POSSIBILITY OF SUCH DAMAGE. + +The Pytorch repository and source distributions bundle several libraries that are +compatibly licensed. We list these here. + +Name: FP16 +License: MIT +Files: third_party/FP16 +For details, see third_party/FP16/LICENSE + +Name: FP16-source +License: MIT +Files: third_party/XNNPACK/build/FP16-source +For details, see third_party/XNNPACK/build/FP16-source/LICENSE + +Name: FXdiv +License: MIT +Files: third_party/FXdiv +For details, see third_party/FXdiv/LICENSE + +Name: FXdiv-source +License: MIT +Files: third_party/XNNPACK/build/FXdiv-source +For details, see third_party/XNNPACK/build/FXdiv-source/LICENSE + +Name: NNPACK +License: BSD-2-Clause +Files: third_party/NNPACK +For details, see third_party/NNPACK/LICENSE + +Name: QNNPACK +License: BSD-3-Clause +Files: third_party/QNNPACK +For details, see third_party/QNNPACK/LICENSE + +Name: XNNPACK +License: BSD-3-Clause +Files: third_party/XNNPACK +For details, see third_party/XNNPACK/LICENSE + +Name: benchmark +License: Apache-2.0 +Files: third_party/benchmark, +third_party/onnx/third_party/benchmark, +third_party/onnx-tensorrt/third_party/onnx/third_party/benchmark, +third_party/protobuf/third_party/benchmark +For details, see third_party/benchmark/LICENSE, +third_party/onnx/third_party/benchmark/LICENSE, +third_party/onnx-tensorrt/third_party/onnx/third_party/benchmark/LICENSE, +third_party/protobuf/third_party/benchmark/LICENSE + +Name: breakpad +License: BSD-3-Clause +Files: third_party/breakpad +For details, see third_party/breakpad/LICENSE + +Name: clog +License: BSD-2-Clause +Files: third_party/QNNPACK/deps/clog, +third_party/XNNPACK/build/clog-source/deps/clog, +third_party/XNNPACK/build/cpuinfo-source/deps/clog, +third_party/cpuinfo/deps/clog, +third_party/fbgemm/third_party/cpuinfo/deps/clog +For details, see third_party/QNNPACK/deps/clog/LICENSE, +third_party/XNNPACK/build/clog-source/deps/clog/LICENSE, +third_party/XNNPACK/build/cpuinfo-source/deps/clog/LICENSE, +third_party/cpuinfo/deps/clog/LICENSE, +third_party/fbgemm/third_party/cpuinfo/deps/clog/LICENSE + +Name: clog-source +License: BSD-2-Clause +Files: third_party/XNNPACK/build/clog-source +For details, see third_party/XNNPACK/build/clog-source/LICENSE + +Name: cpuinfo +License: BSD-2-Clause +Files: third_party/cpuinfo, +third_party/fbgemm/third_party/cpuinfo +For details, see third_party/cpuinfo/LICENSE, +third_party/fbgemm/third_party/cpuinfo/LICENSE + +Name: cpuinfo-source +License: BSD-2-Clause +Files: third_party/XNNPACK/build/cpuinfo-source +For details, see third_party/XNNPACK/build/cpuinfo-source/LICENSE + +Name: cudnn_frontend +License: MIT +Files: third_party/cudnn_frontend +For details, see third_party/cudnn_frontend/LICENSE.txt + +Name: dart +License: Apache-2.0 +Files: third_party/flatbuffers/dart +For details, see third_party/flatbuffers/dart/LICENSE + +Name: eigen +License: BSD-3-Clause +Files: third_party/eigen +For details, see third_party/eigen/COPYING.BSD + +Name: enum +License: BSD-3-Clause +Files: third_party/python-enum/enum +For details, see third_party/python-enum/enum/LICENSE + +Name: fbgemm +License: BSD-3-Clause +Files: third_party/fbgemm +For details, see third_party/fbgemm/LICENSE + +Name: flatbuffers +License: Apache-2.0 +Files: third_party/flatbuffers +For details, see third_party/flatbuffers/LICENSE.txt + +Name: fmt +License: MIT with exception +Files: third_party/fmt, +third_party/kineto/libkineto/third_party/fmt +For details, see third_party/fmt/LICENSE.rst, +third_party/kineto/libkineto/third_party/fmt/LICENSE.rst + +Name: foxi +License: MIT +Files: third_party/foxi +For details, see third_party/foxi/LICENSE + +Name: gemmlowp +License: Apache-2.0 +Files: third_party/gemmlowp/gemmlowp +For details, see third_party/gemmlowp/gemmlowp/LICENSE + +Name: generator +License: Apache-2.0 +Files: third_party/XNNPACK/build/googletest-source/googlemock/scripts/generator, +third_party/benchmark/build/third_party/googletest/src/googlemock/scripts/generator, +third_party/fbgemm/third_party/googletest/googlemock/scripts/generator, +third_party/googletest/googlemock/scripts/generator, +third_party/kineto/libkineto/third_party/googletest/googlemock/scripts/generator, +third_party/protobuf/third_party/googletest/googlemock/scripts/generator, +third_party/tensorpipe/third_party/googletest/googlemock/scripts/generator +For details, see third_party/XNNPACK/build/googletest-source/googlemock/scripts/generator/LICENSE, +third_party/benchmark/build/third_party/googletest/src/googlemock/scripts/generator/LICENSE, +third_party/fbgemm/third_party/googletest/googlemock/scripts/generator/LICENSE, +third_party/googletest/googlemock/scripts/generator/LICENSE, +third_party/kineto/libkineto/third_party/googletest/googlemock/scripts/generator/LICENSE, +third_party/protobuf/third_party/googletest/googlemock/scripts/generator/LICENSE, +third_party/tensorpipe/third_party/googletest/googlemock/scripts/generator/LICENSE + +Name: gloo +License: BSD-3-Clause +Files: third_party/gloo +For details, see third_party/gloo/LICENSE + +Name: googlebenchmark-source +License: Apache-2.0 +Files: third_party/XNNPACK/build/googlebenchmark-source +For details, see third_party/XNNPACK/build/googlebenchmark-source/LICENSE + +Name: googlemock +License: BSD-3-Clause +Files: third_party/XNNPACK/build/googletest-source/googlemock, +third_party/fbgemm/third_party/googletest/googlemock, +third_party/kineto/libkineto/third_party/googletest/googlemock, +third_party/protobuf/third_party/googletest/googlemock, +third_party/tensorpipe/third_party/googletest/googlemock +For details, see third_party/XNNPACK/build/googletest-source/googlemock/LICENSE, +third_party/fbgemm/third_party/googletest/googlemock/LICENSE, +third_party/kineto/libkineto/third_party/googletest/googlemock/LICENSE, +third_party/protobuf/third_party/googletest/googlemock/LICENSE, +third_party/tensorpipe/third_party/googletest/googlemock/LICENSE + +Name: googletest +License: BSD-3-Clause +Files: third_party/XNNPACK/build/googletest-source/googletest, +third_party/fbgemm/third_party/googletest, +third_party/fbgemm/third_party/googletest/googletest, +third_party/googletest, +third_party/kineto/libkineto/third_party/googletest, +third_party/kineto/libkineto/third_party/googletest/googletest, +third_party/protobuf/third_party/googletest, +third_party/protobuf/third_party/googletest/googletest, +third_party/tensorpipe/third_party/googletest, +third_party/tensorpipe/third_party/googletest/googletest +For details, see third_party/XNNPACK/build/googletest-source/googletest/LICENSE, +third_party/fbgemm/third_party/googletest/LICENSE, +third_party/fbgemm/third_party/googletest/googletest/LICENSE, +third_party/googletest/LICENSE, +third_party/kineto/libkineto/third_party/googletest/LICENSE, +third_party/kineto/libkineto/third_party/googletest/googletest/LICENSE, +third_party/protobuf/third_party/googletest/LICENSE, +third_party/protobuf/third_party/googletest/googletest/LICENSE, +third_party/tensorpipe/third_party/googletest/LICENSE, +third_party/tensorpipe/third_party/googletest/googletest/LICENSE + +Name: googletest-source +License: BSD-3-Clause +Files: third_party/XNNPACK/build/googletest-source +For details, see third_party/XNNPACK/build/googletest-source/LICENSE + +Name: gtest +License: BSD-3-Clause +Files: third_party/ideep/mkl-dnn/tests/gtest, +third_party/ideep/mkl-dnn/third_party/oneDNN/tests/gtests/gtest +For details, see third_party/ideep/mkl-dnn/tests/gtest/LICENSE, +third_party/ideep/mkl-dnn/third_party/oneDNN/tests/gtests/gtest/LICENSE + +Name: ideep +License: MIT +Files: third_party/ideep +For details, see third_party/ideep/LICENSE + +Name: ios-cmake +License: BSD-3-Clause +Files: third_party/ios-cmake +For details, see third_party/ios-cmake/LICENSE + +Name: json +License: MIT +Files: third_party/cudnn_frontend/include/contrib/nlohmann/json +For details, see third_party/cudnn_frontend/include/contrib/nlohmann/json/LICENSE.txt + +Name: kineto +License: BSD-3-Clause +Files: third_party/kineto +For details, see third_party/kineto/LICENSE + +Name: libdisasm +License: Clarified Artistic License +Files: third_party/breakpad/src/third_party/libdisasm +For details, see third_party/breakpad/src/third_party/libdisasm/LICENSE + +Name: libnop +License: Apache-2.0 +Files: third_party/tensorpipe/third_party/libnop +For details, see third_party/tensorpipe/third_party/libnop/LICENSE + +Name: libuv +License: MIT +Files: third_party/tensorpipe/third_party/libuv +For details, see third_party/tensorpipe/third_party/libuv/LICENSE + +Name: lss +License: BSD-3-Clause +Files: third_party/breakpad/src/third_party/lss +For details, see third_party/breakpad/src/third_party/lss/LICENSE + +Name: miniz-2.0.8 +License: MIT +Files: third_party/miniz-2.0.8 +For details, see third_party/miniz-2.0.8/LICENSE + +Name: mkl-dnn +License: Apache-2.0 +Files: third_party/ideep/mkl-dnn +For details, see third_party/ideep/mkl-dnn/LICENSE + +Name: nccl +License: BSD-3-Clause +Files: third_party/nccl/nccl +For details, see third_party/nccl/nccl/LICENSE.txt + +Name: neon2sse +License: BSD-Source-Code +Files: third_party/neon2sse +For details, see third_party/neon2sse/LICENSE + +Name: oneDNN +License: Apache-2.0 +Files: third_party/ideep/mkl-dnn/third_party/oneDNN +For details, see third_party/ideep/mkl-dnn/third_party/oneDNN/LICENSE + +Name: onnx +License: Apache-2.0 +Files: third_party/onnx +For details, see third_party/onnx/LICENSE + +Name: onnx +License: MIT +Files: third_party/onnx-tensorrt/third_party/onnx +For details, see third_party/onnx-tensorrt/third_party/onnx/LICENSE + +Name: onnx-tensorrt +License: MIT +Files: third_party/onnx-tensorrt +For details, see third_party/onnx-tensorrt/LICENSE + +Name: protobuf +License: BSD-3-Clause +Files: third_party/protobuf +For details, see third_party/protobuf/LICENSE + +Name: psimd +License: MIT +Files: third_party/XNNPACK/deps/psimd, +third_party/psimd +For details, see third_party/XNNPACK/deps/psimd/LICENSE, +third_party/psimd/LICENSE + +Name: pthreadpool +License: BSD-2-Clause +Files: third_party/pthreadpool +For details, see third_party/pthreadpool/LICENSE + +Name: pthreadpool-source +License: BSD-2-Clause +Files: third_party/XNNPACK/build/pthreadpool-source +For details, see third_party/XNNPACK/build/pthreadpool-source/LICENSE + +Name: pybind11 +License: BSD-3-Clause +Files: third_party/onnx/third_party/pybind11, +third_party/onnx-tensorrt/third_party/onnx/third_party/pybind11, +third_party/pybind11, +third_party/tensorpipe/third_party/pybind11 +For details, see third_party/onnx/third_party/pybind11/LICENSE, +third_party/onnx-tensorrt/third_party/onnx/third_party/pybind11/LICENSE, +third_party/pybind11/LICENSE, +third_party/tensorpipe/third_party/pybind11/LICENSE + +Name: python-peachpy +License: BSD-2-Clause +Files: third_party/python-peachpy +For details, see third_party/python-peachpy/LICENSE.rst + +Name: python-six +License: MIT +Files: third_party/python-six +For details, see third_party/python-six/LICENSE + +Name: sleef +License: BSL-1.0 +Files: third_party/sleef +For details, see third_party/sleef/LICENSE.txt + +Name: src +License: BSD-3-Clause +Files: third_party/benchmark/build/third_party/googletest/src +For details, see third_party/benchmark/build/third_party/googletest/src/LICENSE + +Name: swift +License: Apache-2.0 +Files: third_party/flatbuffers/swift +For details, see third_party/flatbuffers/swift/LICENSE + +Name: tb_plugin +License: BSD-3-Clause +Files: third_party/kineto/tb_plugin +For details, see third_party/kineto/tb_plugin/LICENSE + +Name: tbb +License: Apache-2.0 +Files: third_party/tbb +For details, see third_party/tbb/LICENSE + +Name: tensorpipe +License: BSD-3-Clause +Files: third_party/tensorpipe +For details, see third_party/tensorpipe/LICENSE.txt + +Name: zstd +License: BSD-3-Clause +Files: third_party/zstd +For details, see third_party/zstd/LICENSE tqdm 4.64.0 MIT License; Mozilla Public License 2.0 (MPL 2.0) -UNKNOWN https://tqdm.github.io -Fast, Extensible Progress Meter `tqdm` is a product of collaborative work. Unless otherwise stated, all authors (see commit logs) retain copyright for their respective work, and release the work under the MIT licence @@ -3684,28 +4587,24 @@ for their respective work, and release the work under the MIT licence Exceptions or notable authors are listed below in reverse chronological order: -* files: * +- files: \* MPLv2.0 2015-2021 (c) Casper da Costa-Luis [casperdcl](https://github.com/casperdcl). -* files: tqdm/_tqdm.py +- files: tqdm/\_tqdm.py MIT 2016 (c) [PR #96] on behalf of Google Inc. -* files: tqdm/_tqdm.py setup.py README.rst MANIFEST.in .gitignore +- files: tqdm/\_tqdm.py setup.py README.rst MANIFEST.in .gitignore MIT 2013 (c) Noam Yorav-Raphael, original author. -[PR #96]: https://github.com/tqdm/tqdm/pull/96 - +[pr #96]: https://github.com/tqdm/tqdm/pull/96 -Mozilla Public Licence (MPL) v. 2.0 - Exhibit A ------------------------------------------------ +## Mozilla Public Licence (MPL) v. 2.0 - Exhibit A This Source Code Form is subject to the terms of the Mozilla Public License, v. 2.0. If a copy of the MPL was not distributed with this project, You can obtain one at https://mozilla.org/MPL/2.0/. - -MIT License (MIT) ------------------ +## MIT License (MIT) Copyright (c) 2013 noamraph @@ -3726,41 +4625,289 @@ COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. - -scikit-learn -1.1.1 -new BSD +typing-extensions +4.3.0 +Python Software Foundation License UNKNOWN -http://scikit-learn.org -A set of python modules for machine learning and data mining -BSD 3-Clause License +A. HISTORY OF THE SOFTWARE +========================== + +Python was created in the early 1990s by Guido van Rossum at Stichting +Mathematisch Centrum (CWI, see http://www.cwi.nl) in the Netherlands +as a successor of a language called ABC. Guido remains Python's +principal author, although it includes many contributions from others. + +In 1995, Guido continued his work on Python at the Corporation for +National Research Initiatives (CNRI, see http://www.cnri.reston.va.us) +in Reston, Virginia where he released several versions of the +software. + +In May 2000, Guido and the Python core development team moved to +BeOpen.com to form the BeOpen PythonLabs team. In October of the same +year, the PythonLabs team moved to Digital Creations (now Zope +Corporation, see http://www.zope.com). In 2001, the Python Software +Foundation (PSF, see http://www.python.org/psf/) was formed, a +non-profit organization created specifically to own Python-related +Intellectual Property. Zope Corporation is a sponsoring member of +the PSF. + +All Python releases are Open Source (see http://www.opensource.org for +the Open Source Definition). Historically, most, but not all, Python +releases have also been GPL-compatible; the table below summarizes +the various releases. + + Release Derived Year Owner GPL- + from compatible? (1) + + 0.9.0 thru 1.2 1991-1995 CWI yes + 1.3 thru 1.5.2 1.2 1995-1999 CNRI yes + 1.6 1.5.2 2000 CNRI no + 2.0 1.6 2000 BeOpen.com no + 1.6.1 1.6 2001 CNRI yes (2) + 2.1 2.0+1.6.1 2001 PSF no + 2.0.1 2.0+1.6.1 2001 PSF yes + 2.1.1 2.1+2.0.1 2001 PSF yes + 2.1.2 2.1.1 2002 PSF yes + 2.1.3 2.1.2 2002 PSF yes + 2.2 and above 2.1.1 2001-now PSF yes + +Footnotes: + +(1) GPL-compatible doesn't mean that we're distributing Python under +the GPL. All Python licenses, unlike the GPL, let you distribute +a modified version without making your changes open source. The +GPL-compatible licenses make it possible to combine Python with +other software that is released under the GPL; the others don't. + +(2) According to Richard Stallman, 1.6.1 is not GPL-compatible, +because its license has a choice of law clause. According to +CNRI, however, Stallman's lawyer has told CNRI's lawyer that 1.6.1 +is "not incompatible" with the GPL. + +Thanks to the many outside volunteers who have worked under Guido's +direction to make these releases possible. + +# B. TERMS AND CONDITIONS FOR ACCESSING OR OTHERWISE USING PYTHON + +## PYTHON SOFTWARE FOUNDATION LICENSE VERSION 2 + +1. This LICENSE AGREEMENT is between the Python Software Foundation + ("PSF"), and the Individual or Organization ("Licensee") accessing and + otherwise using this software ("Python") in source or binary form and + its associated documentation. + +2. Subject to the terms and conditions of this License Agreement, PSF hereby + grants Licensee a nonexclusive, royalty-free, world-wide license to reproduce, + analyze, test, perform and/or display publicly, prepare derivative works, + distribute, and otherwise use Python alone or in any derivative version, + provided, however, that PSF's License Agreement and PSF's notice of copyright, + i.e., "Copyright (c) 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008, 2009, 2010, + 2011, 2012, 2013, 2014 Python Software Foundation; All Rights Reserved" are + retained in Python alone or in any derivative version prepared by Licensee. + +3. In the event Licensee prepares a derivative work that is based on + or incorporates Python or any part thereof, and wants to make + the derivative work available to others as provided herein, then + Licensee hereby agrees to include in any such work a brief summary of + the changes made to Python. + +4. PSF is making Python available to Licensee on an "AS IS" + basis. PSF MAKES NO REPRESENTATIONS OR WARRANTIES, EXPRESS OR + IMPLIED. BY WAY OF EXAMPLE, BUT NOT LIMITATION, PSF MAKES NO AND + DISCLAIMS ANY REPRESENTATION OR WARRANTY OF MERCHANTABILITY OR FITNESS + FOR ANY PARTICULAR PURPOSE OR THAT THE USE OF PYTHON WILL NOT + INFRINGE ANY THIRD PARTY RIGHTS. + +5. PSF SHALL NOT BE LIABLE TO LICENSEE OR ANY OTHER USERS OF PYTHON + FOR ANY INCIDENTAL, SPECIAL, OR CONSEQUENTIAL DAMAGES OR LOSS AS + A RESULT OF MODIFYING, DISTRIBUTING, OR OTHERWISE USING PYTHON, + OR ANY DERIVATIVE THEREOF, EVEN IF ADVISED OF THE POSSIBILITY THEREOF. + +6. This License Agreement will automatically terminate upon a material + breach of its terms and conditions. + +7. Nothing in this License Agreement shall be deemed to create any + relationship of agency, partnership, or joint venture between PSF and + Licensee. This License Agreement does not grant permission to use PSF + trademarks or trade name in a trademark sense to endorse or promote + products or services of Licensee, or any third party. + +8. By copying, installing or otherwise using Python, Licensee + agrees to be bound by the terms and conditions of this License + Agreement. + +## BEOPEN.COM LICENSE AGREEMENT FOR PYTHON 2.0 + +BEOPEN PYTHON OPEN SOURCE LICENSE AGREEMENT VERSION 1 + +1. This LICENSE AGREEMENT is between BeOpen.com ("BeOpen"), having an + office at 160 Saratoga Avenue, Santa Clara, CA 95051, and the + Individual or Organization ("Licensee") accessing and otherwise using + this software in source or binary form and its associated + documentation ("the Software"). + +2. Subject to the terms and conditions of this BeOpen Python License + Agreement, BeOpen hereby grants Licensee a non-exclusive, + royalty-free, world-wide license to reproduce, analyze, test, perform + and/or display publicly, prepare derivative works, distribute, and + otherwise use the Software alone or in any derivative version, + provided, however, that the BeOpen Python License is retained in the + Software, alone or in any derivative version prepared by Licensee. + +3. BeOpen is making the Software available to Licensee on an "AS IS" + basis. BEOPEN MAKES NO REPRESENTATIONS OR WARRANTIES, EXPRESS OR + IMPLIED. BY WAY OF EXAMPLE, BUT NOT LIMITATION, BEOPEN MAKES NO AND + DISCLAIMS ANY REPRESENTATION OR WARRANTY OF MERCHANTABILITY OR FITNESS + FOR ANY PARTICULAR PURPOSE OR THAT THE USE OF THE SOFTWARE WILL NOT + INFRINGE ANY THIRD PARTY RIGHTS. + +4. BEOPEN SHALL NOT BE LIABLE TO LICENSEE OR ANY OTHER USERS OF THE + SOFTWARE FOR ANY INCIDENTAL, SPECIAL, OR CONSEQUENTIAL DAMAGES OR LOSS + AS A RESULT OF USING, MODIFYING OR DISTRIBUTING THE SOFTWARE, OR ANY + DERIVATIVE THEREOF, EVEN IF ADVISED OF THE POSSIBILITY THEREOF. + +5. This License Agreement will automatically terminate upon a material + breach of its terms and conditions. + +6. This License Agreement shall be governed by and interpreted in all + respects by the law of the State of California, excluding conflict of + law provisions. Nothing in this License Agreement shall be deemed to + create any relationship of agency, partnership, or joint venture + between BeOpen and Licensee. This License Agreement does not grant + permission to use BeOpen trademarks or trade names in a trademark + sense to endorse or promote products or services of Licensee, or any + third party. As an exception, the "BeOpen Python" logos available at + http://www.pythonlabs.com/logos.html may be used according to the + permissions granted on that web page. + +7. By copying, installing or otherwise using the software, Licensee + agrees to be bound by the terms and conditions of this License + Agreement. + +## CNRI LICENSE AGREEMENT FOR PYTHON 1.6.1 + +1. This LICENSE AGREEMENT is between the Corporation for National + Research Initiatives, having an office at 1895 Preston White Drive, + Reston, VA 20191 ("CNRI"), and the Individual or Organization + ("Licensee") accessing and otherwise using Python 1.6.1 software in + source or binary form and its associated documentation. + +2. Subject to the terms and conditions of this License Agreement, CNRI + hereby grants Licensee a nonexclusive, royalty-free, world-wide + license to reproduce, analyze, test, perform and/or display publicly, + prepare derivative works, distribute, and otherwise use Python 1.6.1 + alone or in any derivative version, provided, however, that CNRI's + License Agreement and CNRI's notice of copyright, i.e., "Copyright (c) + 1995-2001 Corporation for National Research Initiatives; All Rights + Reserved" are retained in Python 1.6.1 alone or in any derivative + version prepared by Licensee. Alternately, in lieu of CNRI's License + Agreement, Licensee may substitute the following text (omitting the + quotes): "Python 1.6.1 is made available subject to the terms and + conditions in CNRI's License Agreement. This Agreement together with + Python 1.6.1 may be located on the Internet using the following + unique, persistent identifier (known as a handle): 1895.22/1013. This + Agreement may also be obtained from a proxy server on the Internet + using the following URL: http://hdl.handle.net/1895.22/1013". + +3. In the event Licensee prepares a derivative work that is based on + or incorporates Python 1.6.1 or any part thereof, and wants to make + the derivative work available to others as provided herein, then + Licensee hereby agrees to include in any such work a brief summary of + the changes made to Python 1.6.1. + +4. CNRI is making Python 1.6.1 available to Licensee on an "AS IS" + basis. CNRI MAKES NO REPRESENTATIONS OR WARRANTIES, EXPRESS OR + IMPLIED. BY WAY OF EXAMPLE, BUT NOT LIMITATION, CNRI MAKES NO AND + DISCLAIMS ANY REPRESENTATION OR WARRANTY OF MERCHANTABILITY OR FITNESS + FOR ANY PARTICULAR PURPOSE OR THAT THE USE OF PYTHON 1.6.1 WILL NOT + INFRINGE ANY THIRD PARTY RIGHTS. + +5. CNRI SHALL NOT BE LIABLE TO LICENSEE OR ANY OTHER USERS OF PYTHON + 1.6.1 FOR ANY INCIDENTAL, SPECIAL, OR CONSEQUENTIAL DAMAGES OR LOSS AS + A RESULT OF MODIFYING, DISTRIBUTING, OR OTHERWISE USING PYTHON 1.6.1, + OR ANY DERIVATIVE THEREOF, EVEN IF ADVISED OF THE POSSIBILITY THEREOF. + +6. This License Agreement will automatically terminate upon a material + breach of its terms and conditions. + +7. This License Agreement shall be governed by the federal + intellectual property law of the United States, including without + limitation the federal copyright law, and, to the extent such + U.S. federal law does not apply, by the law of the Commonwealth of + Virginia, excluding Virginia's conflict of law provisions. + Notwithstanding the foregoing, with regard to derivative works based + on Python 1.6.1 that incorporate non-separable material that was + previously distributed under the GNU General Public License (GPL), the + law of the Commonwealth of Virginia shall govern this License + Agreement only as to issues arising under or with respect to + Paragraphs 4, 5, and 7 of this License Agreement. Nothing in this + License Agreement shall be deemed to create any relationship of + agency, partnership, or joint venture between CNRI and Licensee. This + License Agreement does not grant permission to use CNRI trademarks or + trade name in a trademark sense to endorse or promote products or + services of Licensee, or any third party. + +8. By clicking on the "ACCEPT" button where indicated, or by copying, + installing or otherwise using Python 1.6.1, Licensee agrees to be + bound by the terms and conditions of this License Agreement. + + ACCEPT + +## CWI LICENSE AGREEMENT FOR PYTHON 0.9.0 THROUGH 1.2 + +Copyright (c) 1991 - 1995, Stichting Mathematisch Centrum Amsterdam, +The Netherlands. All rights reserved. + +Permission to use, copy, modify, and distribute this software and its +documentation for any purpose and without fee is hereby granted, +provided that the above copyright notice appear in all copies and that +both that copyright notice and this permission notice appear in +supporting documentation, and that the name of Stichting Mathematisch +Centrum or CWI not be used in advertising or publicity pertaining to +distribution of the software without specific, written prior +permission. + +STICHTING MATHEMATISCH CENTRUM DISCLAIMS ALL WARRANTIES WITH REGARD TO +THIS SOFTWARE, INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND +FITNESS, IN NO EVENT SHALL STICHTING MATHEMATISCH CENTRUM BE LIABLE +FOR ANY SPECIAL, INDIRECT OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES +WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN +ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT +OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE. -Copyright (c) 2007-2021 The scikit-learn developers. -All rights reserved. +wcwidth +0.2.5 +MIT License +https://github.com/jquast/wcwidth +The MIT License (MIT) -Redistribution and use in source and binary forms, with or without -modification, are permitted provided that the following conditions are met: +Copyright (c) 2014 Jeff Quast -* Redistributions of source code must retain the above copyright notice, this - list of conditions and the following disclaimer. +Permission is hereby granted, free of charge, to any person obtaining a copy +of this software and associated documentation files (the "Software"), to deal +in the Software without restriction, including without limitation the rights +to use, copy, modify, merge, publish, distribute, sublicense, and/or sell +copies of the Software, and to permit persons to whom the Software is +furnished to do so, subject to the following conditions: -* Redistributions in binary form must reproduce the above copyright notice, - this list of conditions and the following disclaimer in the documentation - and/or other materials provided with the distribution. +The above copyright notice and this permission notice shall be included in all +copies or substantial portions of the Software. -* Neither the name of the copyright holder nor the names of its - contributors may be used to endorse or promote products derived from - this software without specific prior written permission. +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE +AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, +OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE +SOFTWARE. -THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" -AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE -IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE -DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE -FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL -DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR -SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER -CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, -OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE -OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. +Markus Kuhn -- 2007-05-26 (Unicode 5.0) + +Permission to use, copy, modify, and distribute this software +for any purpose and without fee is hereby granted. The author +disclaims all warranties with regard to this software. +---------------------------------------------------------------------------------------------------- +This license representation is created by executing the following command using "pip-licenses". +pip-licenses --format=plain-vertical --with-license-file --no-license-path --with-urls --output-file=./PYTHON_PACKAGE_LICENSES diff --git a/Tunny/Lib/requirements.txt b/Tunny/Lib/requirements.txt index 27e34278..3fd61c1e 100644 --- a/Tunny/Lib/requirements.txt +++ b/Tunny/Lib/requirements.txt @@ -1,17 +1,21 @@ alembic==1.8.0 attrs==21.4.0 autopage==0.5.1 +botorch==0.6.5 bottle==0.12.21 cliff==3.10.1 cmaes==0.8.2 cmd2==2.4.1 colorama==0.4.5 colorlog==6.6.0 +gpytorch==1.8.0 greenlet==1.1.2 joblib==1.1.0 Mako==1.2.0 MarkupSafe==2.1.1 +multipledispatch==0.6.0 numpy==1.23.0 +opt-einsum==3.3.0 optuna==2.10.1 optuna-dashboard==0.7.1 packaging==21.3 @@ -21,12 +25,17 @@ prettytable==3.3.0 pyparsing==3.0.9 pyperclip==1.8.2 pyreadline3==3.4.1 +pyro-api==0.1.2 +pyro-ppl==1.8.1 PyYAML==6.0 scikit-learn==1.1.1 scipy==1.8.1 +six==1.16.0 SQLAlchemy==1.4.39 stevedore==3.5.0 tenacity==8.0.1 threadpoolctl==3.1.0 +torch==1.12.0 tqdm==4.64.0 +typing_extensions==4.3.0 wcwidth==0.2.5 From 70abe4e04a656b0db4b3bf6f7ff7c505aa08d951 Mon Sep 17 00:00:00 2001 From: hrntsm Date: Sat, 6 Aug 2022 00:49:59 +0900 Subject: [PATCH 05/65] Update CHANGELOG --- CHANGELOG.md | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/CHANGELOG.md b/CHANGELOG.md index 8bdd7025..d3a583cb 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -12,6 +12,8 @@ Please see [here](https://github.com/hrntsm/Tunny/releases) for the data release - Hypervolume visualization - It is useful for determining convergence in multi-objective optimization. +- BoTorch Sampler + - This sampler use Gaussian Process and support multi-objective optimization. ## [0.4.0] -2022-07-09 @@ -61,7 +63,7 @@ Please see [here](https://github.com/hrntsm/Tunny/releases) for the data release - Use json to set sampler detail settings - Since the settings are saved in Json, the previous values set in the UI remain saved when the window is closed and reopened. -- UI for above detail settings +- UI for above detail settings - If input "-10" in restore model number, Tunny output all result - Fish component - Special GH_Param component for Tunny result to handle its result easier. From db564e9d0705f57de1e63aaa8ac920b55ec0fb6a Mon Sep 17 00:00:00 2001 From: hrntsm Date: Sun, 7 Aug 2022 16:18:51 +0900 Subject: [PATCH 06/65] Update to use genepool nickname --- Tunny/Solver/Optuna/Optuna.cs | 1 + Tunny/UI/PythonInstallDialog.Designer.cs | 26 ++++++++++++++---------- Tunny/Util/GrasshopperInOut.cs | 12 ++++++----- 3 files changed, 23 insertions(+), 16 deletions(-) diff --git a/Tunny/Solver/Optuna/Optuna.cs b/Tunny/Solver/Optuna/Optuna.cs index 61d8ee0d..3ef7f166 100644 --- a/Tunny/Solver/Optuna/Optuna.cs +++ b/Tunny/Solver/Optuna/Optuna.cs @@ -88,6 +88,7 @@ private static void ShowErrorMessages(Exception e) TunnyMessageBox.Show( "Tunny runtime error:\n" + "Please send below message (& gh file if possible) to Tunny support.\n\n" + + "If this error occurs, the Tunny solver will not work after this unless Rhino is restarted." + "\" " + e.Message + " \"", "Tunny", MessageBoxButtons.OK, MessageBoxIcon.Error); } diff --git a/Tunny/UI/PythonInstallDialog.Designer.cs b/Tunny/UI/PythonInstallDialog.Designer.cs index 4a5a1f40..4a94bab6 100644 --- a/Tunny/UI/PythonInstallDialog.Designer.cs +++ b/Tunny/UI/PythonInstallDialog.Designer.cs @@ -39,48 +39,52 @@ private void InitializeComponent() // // installProgressBar // - this.installProgressBar.Location = new System.Drawing.Point(12, 72); + this.installProgressBar.Location = new System.Drawing.Point(22, 144); + this.installProgressBar.Margin = new System.Windows.Forms.Padding(4, 4, 4, 4); this.installProgressBar.Name = "installProgressBar"; - this.installProgressBar.Size = new System.Drawing.Size(334, 23); + this.installProgressBar.Size = new System.Drawing.Size(501, 34); this.installProgressBar.TabIndex = 0; // // installerTitleLabel // this.installerTitleLabel.AutoSize = true; - this.installerTitleLabel.Location = new System.Drawing.Point(12, 9); + this.installerTitleLabel.Location = new System.Drawing.Point(18, 14); + this.installerTitleLabel.Margin = new System.Windows.Forms.Padding(4, 0, 4, 0); this.installerTitleLabel.Name = "installerTitleLabel"; - this.installerTitleLabel.Size = new System.Drawing.Size(282, 15); + this.installerTitleLabel.Size = new System.Drawing.Size(427, 23); this.installerTitleLabel.TabIndex = 1; this.installerTitleLabel.Text = "Installing Python packages depending on Tunny"; // // installItemLabel // - this.installItemLabel.Location = new System.Drawing.Point(35, 39); + this.installItemLabel.Location = new System.Drawing.Point(52, 58); + this.installItemLabel.Margin = new System.Windows.Forms.Padding(4, 0, 4, 0); this.installItemLabel.Name = "installItemLabel"; - this.installItemLabel.Size = new System.Drawing.Size(288, 30); + this.installItemLabel.Size = new System.Drawing.Size(432, 45); this.installItemLabel.TabIndex = 2; this.installItemLabel.Text = "Now Installing: "; // // notificationLabel // - this.notificationLabel.Location = new System.Drawing.Point(12, 109); + this.notificationLabel.Location = new System.Drawing.Point(18, 197); + this.notificationLabel.Margin = new System.Windows.Forms.Padding(4, 0, 4, 0); this.notificationLabel.Name = "notificationLabel"; - this.notificationLabel.Size = new System.Drawing.Size(334, 53); + this.notificationLabel.Size = new System.Drawing.Size(494, 80); this.notificationLabel.TabIndex = 3; this.notificationLabel.Text = "**This process runs only when Tunny is launched for the first time.**"; // // PythonInstallDialog // - this.AutoScaleDimensions = new System.Drawing.SizeF(96F, 96F); + this.AutoScaleDimensions = new System.Drawing.SizeF(144F, 144F); this.AutoScaleMode = System.Windows.Forms.AutoScaleMode.Dpi; - this.ClientSize = new System.Drawing.Size(358, 161); + this.ClientSize = new System.Drawing.Size(537, 286); this.Controls.Add(this.notificationLabel); this.Controls.Add(this.installItemLabel); this.Controls.Add(this.installerTitleLabel); this.Controls.Add(this.installProgressBar); this.Font = new System.Drawing.Font("Meiryo UI", 9F, System.Drawing.FontStyle.Regular, System.Drawing.GraphicsUnit.Point, ((byte)(128))); this.Icon = ((System.Drawing.Icon)(resources.GetObject("$this.Icon"))); - this.Margin = new System.Windows.Forms.Padding(3, 4, 3, 4); + this.Margin = new System.Windows.Forms.Padding(4, 6, 4, 6); this.Name = "PythonInstallDialog"; this.Text = "PythonInstaller"; this.TopMost = true; diff --git a/Tunny/Util/GrasshopperInOut.cs b/Tunny/Util/GrasshopperInOut.cs index 88ade169..6d2751e4 100644 --- a/Tunny/Util/GrasshopperInOut.cs +++ b/Tunny/Util/GrasshopperInOut.cs @@ -151,18 +151,20 @@ private void SetInputSliderValues(ICollection variables) private void SetInputGenePoolValues(ICollection variables) { - int count = 0; - - foreach (GalapagosGeneListObject genePool in _genePool) + var nickNames = new List(); + for (int i = 0; i < _genePool.Count; i++) { + GalapagosGeneListObject genePool = _genePool[i]; + string nickName = nickNames.Contains(genePool.NickName) ? genePool.NickName + i + "-" : genePool.NickName; + nickNames.Add(nickName); bool isInteger = genePool.Decimals == 0; decimal lowerBond = genePool.Minimum; decimal upperBond = genePool.Maximum; for (int j = 0; j < genePool.Count; j++) { - string nickName = "genepool" + count++; - variables.Add(new Variable(Convert.ToDouble(lowerBond), Convert.ToDouble(upperBond), isInteger, nickName)); + string name = nickNames[i] + j; + variables.Add(new Variable(Convert.ToDouble(lowerBond), Convert.ToDouble(upperBond), isInteger, name)); } } } From aa77abf601ead806ed29d19ba991ce19b44109dd Mon Sep 17 00:00:00 2001 From: hrntsm Date: Sun, 7 Aug 2022 16:19:06 +0900 Subject: [PATCH 07/65] Update CHANGELOG --- CHANGELOG.md | 8 ++++++++ 1 file changed, 8 insertions(+) diff --git a/CHANGELOG.md b/CHANGELOG.md index d3a583cb..c9bd4a5e 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -15,6 +15,14 @@ Please see [here](https://github.com/hrntsm/Tunny/releases) for the data release - BoTorch Sampler - This sampler use Gaussian Process and support multi-objective optimization. +### Changed + +- When genepool is an input, it now creates variable names using nicknames. + +### Fixed + +- The PythonInstaller window now has no text on the progress bar. + ## [0.4.0] -2022-07-09 ### Added From da47195b0a933af69661e6a6b265eaace753b8dc Mon Sep 17 00:00:00 2001 From: hrntsm Date: Sun, 7 Aug 2022 17:13:00 +0900 Subject: [PATCH 08/65] Add Variable class to epsilon --- Tunny/Util/Variables.cs | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/Tunny/Util/Variables.cs b/Tunny/Util/Variables.cs index 4407b955..12e88996 100644 --- a/Tunny/Util/Variables.cs +++ b/Tunny/Util/Variables.cs @@ -6,13 +6,15 @@ public struct Variable public double UpperBond { get; } public bool IsInteger { get; } public string NickName { get; } + public double Epsilon { get; } - public Variable(double lowerBond, double upperBond, bool isInteger, string nickName) + public Variable(double lowerBond, double upperBond, bool isInteger, string nickName, double epsilon) { LowerBond = lowerBond; UpperBond = upperBond; IsInteger = isInteger; NickName = nickName; + Epsilon = epsilon; } } } From e947c95da7bd0c5fdf2ea1a63bb3907481eb21a9 Mon Sep 17 00:00:00 2001 From: hrntsm Date: Sun, 7 Aug 2022 17:15:38 +0900 Subject: [PATCH 09/65] Update suggestion to use discrete_uniform and int --- Tunny/Solver/Optuna/Algorithm.cs | 4 +++- Tunny/Util/GrasshopperInOut.cs | 8 ++++---- 2 files changed, 7 insertions(+), 5 deletions(-) diff --git a/Tunny/Solver/Optuna/Algorithm.cs b/Tunny/Solver/Optuna/Algorithm.cs index a663e863..f4b92f46 100644 --- a/Tunny/Solver/Optuna/Algorithm.cs +++ b/Tunny/Solver/Optuna/Algorithm.cs @@ -187,7 +187,9 @@ private void RunOptimize(int nTrials, double timeout, dynamic study, out double[ { for (int j = 0; j < Variables.Count; j++) { - xTest[j] = trial.suggest_uniform(Variables[j].NickName, Variables[j].LowerBond, Variables[j].UpperBond); + xTest[j] = Variables[j].IsInteger + ? trial.suggest_int(Variables[j].NickName, Variables[j].LowerBond, Variables[j].UpperBond, Variables[j].Epsilon) + : trial.suggest_discrete_uniform(Variables[j].NickName, Variables[j].LowerBond, Variables[j].UpperBond, Variables[j].Epsilon); } result = EvalFunc(xTest, progress); diff --git a/Tunny/Util/GrasshopperInOut.cs b/Tunny/Util/GrasshopperInOut.cs index 6d2751e4..45c307fa 100644 --- a/Tunny/Util/GrasshopperInOut.cs +++ b/Tunny/Util/GrasshopperInOut.cs @@ -120,7 +120,7 @@ private void SetInputSliderValues(ICollection variables) { nickName = "param" + i++; } - + double eps = Convert.ToDouble(slider.Slider.Epsilon); switch (slider.Slider.Type) { case Grasshopper.GUI.Base.GH_SliderAccuracy.Even: @@ -145,7 +145,7 @@ private void SetInputSliderValues(ICollection variables) break; } - variables.Add(new Variable(Convert.ToDouble(lowerBond), Convert.ToDouble(upperBond), isInteger, nickName)); + variables.Add(new Variable(Convert.ToDouble(lowerBond), Convert.ToDouble(upperBond), isInteger, nickName, eps)); } } @@ -160,11 +160,11 @@ private void SetInputGenePoolValues(ICollection variables) bool isInteger = genePool.Decimals == 0; decimal lowerBond = genePool.Minimum; decimal upperBond = genePool.Maximum; - + double eps = Math.Pow(10, -genePool.Decimals); for (int j = 0; j < genePool.Count; j++) { string name = nickNames[i] + j; - variables.Add(new Variable(Convert.ToDouble(lowerBond), Convert.ToDouble(upperBond), isInteger, name)); + variables.Add(new Variable(Convert.ToDouble(lowerBond), Convert.ToDouble(upperBond), isInteger, name, eps)); } } } From 4971ea20d839c008736002d8844434ab4bd82191 Mon Sep 17 00:00:00 2001 From: hrntsm Date: Sun, 7 Aug 2022 17:19:38 +0900 Subject: [PATCH 10/65] Update CHANGELOG --- CHANGELOG.md | 1 + 1 file changed, 1 insertion(+) diff --git a/CHANGELOG.md b/CHANGELOG.md index c9bd4a5e..8c9ca14d 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -18,6 +18,7 @@ Please see [here](https://github.com/hrntsm/Tunny/releases) for the data release ### Changed - When genepool is an input, it now creates variable names using nicknames. +- Use `suggest_int` and `suggest_discrete_uniform` instead of `suggest_uniform` for more accurate variable generation in optimization ### Fixed From 36cbedcee466eb6590fa91128d2a2fb18f191cce Mon Sep 17 00:00:00 2001 From: hrntsm Date: Sun, 7 Aug 2022 22:51:57 +0900 Subject: [PATCH 11/65] Fix python installer launch detection --- Tunny/Util/PythonInstaller.cs | 5 +++-- 1 file changed, 3 insertions(+), 2 deletions(-) diff --git a/Tunny/Util/PythonInstaller.cs b/Tunny/Util/PythonInstaller.cs index d9c0fc86..7c6e7641 100644 --- a/Tunny/Util/PythonInstaller.cs +++ b/Tunny/Util/PythonInstaller.cs @@ -54,8 +54,9 @@ internal static bool CheckPackagesIsInstalled() } foreach (string package in packageList) { - string[] singleFilePackages = { "bottle", "optuna-dashboard", "six", "PyYAML", "scikit-learn", "threadpoolctl" }; - if (!Installer.IsModuleInstalled(package) && !singleFilePackages.Contains(package)) + string[] singleFilePackages = { "bottle", "optuna-dashboard", "six", "PyYAML", "scikit-learn", "threadpoolctl", "typing_extensions" }; + string[] useUnderLinePackages = { "opt-einsum", "pyro-api", "pyro-ppl" }; + if (!Installer.IsModuleInstalled(package) && !singleFilePackages.Contains(package) && !useUnderLinePackages.Contains(package)) { return false; } From 42fced9a555016c1a9418a0aaea77901c203fcda Mon Sep 17 00:00:00 2001 From: hrntsm Date: Sun, 7 Aug 2022 23:30:16 +0900 Subject: [PATCH 12/65] Fix change study name error --- Tunny/Solver/Optuna/Algorithm.cs | 10 +++++----- Tunny/Solver/Optuna/Optuna.cs | 4 ++-- 2 files changed, 7 insertions(+), 7 deletions(-) diff --git a/Tunny/Solver/Optuna/Algorithm.cs b/Tunny/Solver/Optuna/Algorithm.cs index f4b92f46..334f55f4 100644 --- a/Tunny/Solver/Optuna/Algorithm.cs +++ b/Tunny/Solver/Optuna/Algorithm.cs @@ -95,16 +95,16 @@ private static string[] SetDirectionValues(int nObjective) private bool CheckExistStudyParameter(int nObjective, dynamic optuna) { PyList studySummaries = optuna.get_all_study_summaries("sqlite:///" + Settings.Storage); - var directions = new Dictionary(); + var studySummaryDict = new Dictionary(); foreach (dynamic pyObj in studySummaries) { - directions.Add((string)pyObj.study_name, (int)pyObj.directions.__len__()); + studySummaryDict.Add((string)pyObj.study_name, (int)pyObj.directions.__len__()); } - return directions.ContainsKey(Settings.StudyName) - ? CheckDirections(nObjective, directions) - : directions.Count == 0; + return studySummaryDict.ContainsKey(Settings.StudyName) + ? CheckDirections(nObjective, studySummaryDict) + : studySummaryDict.Count != 0; } private bool CheckDirections(int nObjective, Dictionary directions) diff --git a/Tunny/Solver/Optuna/Optuna.cs b/Tunny/Solver/Optuna/Optuna.cs index 3ef7f166..02248181 100644 --- a/Tunny/Solver/Optuna/Optuna.cs +++ b/Tunny/Solver/Optuna/Optuna.cs @@ -87,8 +87,8 @@ private static void ShowErrorMessages(Exception e) { TunnyMessageBox.Show( "Tunny runtime error:\n" + - "Please send below message (& gh file if possible) to Tunny support.\n\n" + - "If this error occurs, the Tunny solver will not work after this unless Rhino is restarted." + + "Please send below message (& gh file if possible) to Tunny support.\n" + + "If this error occurs, the Tunny solver will not work after this unless Rhino is restarted.\n\n" + "\" " + e.Message + " \"", "Tunny", MessageBoxButtons.OK, MessageBoxIcon.Error); } From 91d3d4ab3f9d98819bd95ba10ae6f77776571d87 Mon Sep 17 00:00:00 2001 From: hrntsm Date: Sun, 7 Aug 2022 23:33:17 +0900 Subject: [PATCH 13/65] Update CHANGELOG --- CHANGELOG.md | 1 + 1 file changed, 1 insertion(+) diff --git a/CHANGELOG.md b/CHANGELOG.md index 8c9ca14d..33b3d968 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -23,6 +23,7 @@ Please see [here](https://github.com/hrntsm/Tunny/releases) for the data release ### Fixed - The PythonInstaller window now has no text on the progress bar. +- When more than one Study exists, another Study Name is set and RunOpt no longer causes a Solver Error. ## [0.4.0] -2022-07-09 From bccc857e88f81f6d5d8929eb18251bfa2d28892d Mon Sep 17 00:00:00 2001 From: hrntsm Date: Mon, 8 Aug 2022 09:49:10 +0900 Subject: [PATCH 14/65] Add QMC sampler --- Tunny/Settings/QMC.cs | 14 ++++++++++++++ Tunny/Settings/Sampler.cs | 1 + Tunny/Solver/Optuna/Algorithm.cs | 10 ++++++---- Tunny/Solver/Optuna/Optuna.cs | 8 ++++---- Tunny/Solver/Optuna/Sampler.cs | 12 ++++++++++++ Tunny/UI/OptimizationWindow.Designer.cs | 5 +++-- 6 files changed, 40 insertions(+), 10 deletions(-) create mode 100644 Tunny/Settings/QMC.cs diff --git a/Tunny/Settings/QMC.cs b/Tunny/Settings/QMC.cs new file mode 100644 index 00000000..0eff32af --- /dev/null +++ b/Tunny/Settings/QMC.cs @@ -0,0 +1,14 @@ +namespace Tunny.Settings +{ + /// + /// https://optuna.readthedocs.io/en/latest/reference/samplers/generated/optuna.samplers.QMCSampler.html + /// + public class QuasiMonteCarlo + { + public string QmcType { get; set; } = "sobol"; + public bool Scramble { get; set; } + public int? Seed { get; set; } + public bool WarnIndependentSampling { get; set; } = true; + public bool WarnAsynchronousSeeding { get; set; } = true; + } +} diff --git a/Tunny/Settings/Sampler.cs b/Tunny/Settings/Sampler.cs index 5c9c5fd6..0227bf85 100644 --- a/Tunny/Settings/Sampler.cs +++ b/Tunny/Settings/Sampler.cs @@ -9,6 +9,7 @@ public class Sampler public Tpe Tpe { get; set; } = new Tpe(); public CmaEs CmaEs { get; set; } = new CmaEs(); public NSGAII NsgaII { get; set; } = new NSGAII(); + public QuasiMonteCarlo QMC { get; set; } = new QuasiMonteCarlo(); public BoTorch BoTorch { get; set; } = new BoTorch(); } } diff --git a/Tunny/Solver/Optuna/Algorithm.cs b/Tunny/Solver/Optuna/Algorithm.cs index 334f55f4..c36bf6d6 100644 --- a/Tunny/Solver/Optuna/Algorithm.cs +++ b/Tunny/Solver/Optuna/Algorithm.cs @@ -102,9 +102,8 @@ private bool CheckExistStudyParameter(int nObjective, dynamic optuna) studySummaryDict.Add((string)pyObj.study_name, (int)pyObj.directions.__len__()); } - return studySummaryDict.ContainsKey(Settings.StudyName) - ? CheckDirections(nObjective, studySummaryDict) - : studySummaryDict.Count != 0; + return !studySummaryDict.ContainsKey(Settings.StudyName) +|| CheckDirections(nObjective, studySummaryDict); } private bool CheckDirections(int nObjective, Dictionary directions) @@ -266,9 +265,12 @@ private dynamic SetSamplerSettings(int samplerType, ref int nTrials, dynamic opt sampler = Sampler.CmaEs(optuna, Settings); break; case 4: - sampler = Sampler.Random(optuna, Settings); + sampler = Sampler.QMC(optuna, Settings); break; case 5: + sampler = Sampler.Random(optuna, Settings); + break; + case 6: sampler = Sampler.Grid(optuna, Variables, ref nTrials); break; default: diff --git a/Tunny/Solver/Optuna/Optuna.cs b/Tunny/Solver/Optuna/Optuna.cs index 02248181..fca8cf69 100644 --- a/Tunny/Solver/Optuna/Optuna.cs +++ b/Tunny/Solver/Optuna/Optuna.cs @@ -180,7 +180,7 @@ private static dynamic PlotHypervolume(dynamic optuna, dynamic study) } PyList hvs = ComputeHypervolume(optuna, trials, maxObjectiveValues, out PyList trialNumbers); - return CreateFigure(trials, hvs, trialNumbers); + return CreateHypervolumeFigure(trials, hvs, trialNumbers); } private static PyList ComputeHypervolume(dynamic optuna, dynamic[] trials, double[] maxObjectiveValues, out PyList trialNumbers) @@ -211,7 +211,7 @@ private static PyList ComputeHypervolume(dynamic optuna, dynamic[] trials, doubl return hvs; } - private static dynamic CreateFigure(dynamic[] trials, PyList hvs, PyList trialNumbers) + private static dynamic CreateHypervolumeFigure(dynamic[] trials, PyList hvs, PyList trialNumbers) { dynamic go = Py.Import("plotly.graph_objects"); @@ -224,10 +224,10 @@ private static dynamic CreateFigure(dynamic[] trials, PyList hvs, PyList trialNu plotRange.SetItem("range", new PyList(rangeObj)); dynamic fig = go.Figure(); - fig.add_trace(go.Scatter(plotItems, name: "Hyper Volume")); + fig.add_trace(go.Scatter(plotItems, name: "Hypervolume")); fig.update_layout(xaxis: plotRange); fig.update_xaxes(title_text: "#Trials"); - fig.update_yaxes(title_text: "Hyper Volume"); + fig.update_yaxes(title_text: "Hypervolume"); return fig; } diff --git a/Tunny/Solver/Optuna/Sampler.cs b/Tunny/Solver/Optuna/Sampler.cs index 70f836ef..af0efddb 100644 --- a/Tunny/Solver/Optuna/Sampler.cs +++ b/Tunny/Solver/Optuna/Sampler.cs @@ -85,5 +85,17 @@ internal static dynamic TPE(dynamic optuna, TunnySettings settings) constant_liar: tpe.ConstantLiar ); } + + internal static dynamic QMC(dynamic optuna, TunnySettings settings) + { + QuasiMonteCarlo qmc = settings.Optimize.Sampler.QMC; + return optuna.samplers.QMCSampler( + qmc_type: qmc.QmcType, + scramble: qmc.Scramble, + seed: qmc.Seed, + // warn_asynchronous_seeding: qmc.WarnAsynchronousSeeding, + warn_independent_sampling: qmc.WarnIndependentSampling + ); + } } } diff --git a/Tunny/UI/OptimizationWindow.Designer.cs b/Tunny/UI/OptimizationWindow.Designer.cs index 081e46e9..425936d9 100644 --- a/Tunny/UI/OptimizationWindow.Designer.cs +++ b/Tunny/UI/OptimizationWindow.Designer.cs @@ -159,10 +159,11 @@ private void InitializeComponent() // this.samplerComboBox.FormattingEnabled = true; this.samplerComboBox.Items.AddRange(new object[] { - "BayesianOpt (TPE)", - "BayesianOpt (GP)", + "BayesianOptimization (TPE)", + "BayesianOptimization (GP)", "GeneticAlgorithm (NSGA-II)", "EvolutionStrategy (CMA-ES)", + "Quasi-MonteCarlo", "Random", "Grid"}); this.samplerComboBox.Location = new System.Drawing.Point(104, 12); From f7eccff13c62a36e2602bdee3cb5b99eaee0db86 Mon Sep 17 00:00:00 2001 From: hrntsm Date: Mon, 8 Aug 2022 09:50:24 +0900 Subject: [PATCH 15/65] Fix null brep handle error --- Tunny/Optimization/OutputLoop.cs | 5 ++++- Tunny/Util/Converter.cs | 2 +- 2 files changed, 5 insertions(+), 2 deletions(-) diff --git a/Tunny/Optimization/OutputLoop.cs b/Tunny/Optimization/OutputLoop.cs index 725b6cf9..640b9792 100644 --- a/Tunny/Optimization/OutputLoop.cs +++ b/Tunny/Optimization/OutputLoop.cs @@ -104,7 +104,10 @@ private static Dictionary SetAttributes(ModelResult model) var geometries = new List(); foreach (string json in attr.Value) { - geometries.Add(Rhino.Runtime.CommonObject.FromJSON(json) as GeometryBase); + if (!string.IsNullOrEmpty(json)) + { + geometries.Add(Rhino.Runtime.CommonObject.FromJSON(json) as GeometryBase); + } } attribute.Add(attr.Key, geometries); } diff --git a/Tunny/Util/Converter.cs b/Tunny/Util/Converter.cs index e42a11af..b6f9dbc1 100644 --- a/Tunny/Util/Converter.cs +++ b/Tunny/Util/Converter.cs @@ -43,7 +43,7 @@ public static string GooToString(IGH_Goo goo, bool isGeometryBaseToJson, Seriali case GH_Mesh mesh: return mesh.Value.ToJSON(option); case GH_Brep brep: - return brep.Value.ToJSON(option); + return brep.IsValid ? brep.Value.ToJSON(option) : string.Empty; case GH_Curve curve: return curve.Value.ToJSON(option); case GH_Surface surface: From f887f3e1289e9bcb8e9bf6239ecf773dcde5ca2a Mon Sep 17 00:00:00 2001 From: hrntsm Date: Mon, 8 Aug 2022 21:23:43 +0900 Subject: [PATCH 16/65] Update requirements.txt --- Tunny/Lib/requirements.txt | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/Tunny/Lib/requirements.txt b/Tunny/Lib/requirements.txt index 3fd61c1e..740d6842 100644 --- a/Tunny/Lib/requirements.txt +++ b/Tunny/Lib/requirements.txt @@ -16,8 +16,8 @@ MarkupSafe==2.1.1 multipledispatch==0.6.0 numpy==1.23.0 opt-einsum==3.3.0 -optuna==2.10.1 -optuna-dashboard==0.7.1 +optuna==3.0.0rc0 +optuna-dashboard==0.7.2 packaging==21.3 pbr==5.9.0 plotly==5.9.0 From a653a5399db82ce3893d59713721157f49c9f263 Mon Sep 17 00:00:00 2001 From: hrntsm Date: Mon, 8 Aug 2022 21:24:38 +0900 Subject: [PATCH 17/65] Update MO support sampler --- Tunny/Solver/Optuna/Algorithm.cs | 3 +-- Tunny/Solver/Optuna/Sampler.cs | 11 +++++++---- Tunny/UI/OptimizeWindowTab/OptimizeTab.cs | 4 ++-- 3 files changed, 10 insertions(+), 8 deletions(-) diff --git a/Tunny/Solver/Optuna/Algorithm.cs b/Tunny/Solver/Optuna/Algorithm.cs index c36bf6d6..85e7a0eb 100644 --- a/Tunny/Solver/Optuna/Algorithm.cs +++ b/Tunny/Solver/Optuna/Algorithm.cs @@ -102,8 +102,7 @@ private bool CheckExistStudyParameter(int nObjective, dynamic optuna) studySummaryDict.Add((string)pyObj.study_name, (int)pyObj.directions.__len__()); } - return !studySummaryDict.ContainsKey(Settings.StudyName) -|| CheckDirections(nObjective, studySummaryDict); + return !studySummaryDict.ContainsKey(Settings.StudyName) || CheckDirections(nObjective, studySummaryDict); } private bool CheckDirections(int nObjective, Dictionary directions) diff --git a/Tunny/Solver/Optuna/Sampler.cs b/Tunny/Solver/Optuna/Sampler.cs index af0efddb..7e262262 100644 --- a/Tunny/Solver/Optuna/Sampler.cs +++ b/Tunny/Solver/Optuna/Sampler.cs @@ -1,6 +1,8 @@ using System; using System.Collections.Generic; +using Python.Runtime; + using Tunny.Settings; using Tunny.Util; @@ -40,17 +42,18 @@ internal static dynamic CmaEs(dynamic optuna, TunnySettings settings) ); } + //FIXME:FIX internal static dynamic Grid(dynamic optuna, List variables, ref int nTrials) { - var searchSpace = new Dictionary>(); + var searchSpace = new PyDict(); for (int i = 0; i < variables.Count; i++) { - var numSpace = new List(); + var numSpace = new PyList(); for (int j = 0; j < nTrials; j++) { - numSpace.Add(variables[i].LowerBond + (variables[i].UpperBond - variables[i].LowerBond) * j / (nTrials - 1)); + numSpace.Append(new PyFloat(variables[i].LowerBond + (variables[i].UpperBond - variables[i].LowerBond) * j / (nTrials - 1))); } - searchSpace.Add(variables[i].NickName, numSpace); + searchSpace.SetItem(new PyString(variables[i].NickName), numSpace); } nTrials = (int)Math.Pow(nTrials, variables.Count); return optuna.samplers.GridSampler(searchSpace); diff --git a/Tunny/UI/OptimizeWindowTab/OptimizeTab.cs b/Tunny/UI/OptimizeWindowTab/OptimizeTab.cs index b8f44a84..f6af25c2 100644 --- a/Tunny/UI/OptimizeWindowTab/OptimizeTab.cs +++ b/Tunny/UI/OptimizeWindowTab/OptimizeTab.cs @@ -47,10 +47,10 @@ private bool CheckInputValue(GH_DocumentEditor ghCanvas) return false; } else if (objectiveValues.Count > 1 - && (samplerComboBox.Text == "CMA-ES" || samplerComboBox.Text == "Random" || samplerComboBox.Text == "Grid")) + && (samplerComboBox.Text == "EvolutionStrategy (CMA-ES)")) { TunnyMessageBox.Show( - "CMA-ES, Random and Grid samplers only support single objective optimization.", + "CMA-ES samplers only support single objective optimization.", "Tunny", MessageBoxButtons.OK, MessageBoxIcon.Error From 3fa84a1a212c4ce31d9d669a45d3e170fa9e45c8 Mon Sep 17 00:00:00 2001 From: hrntsm Date: Mon, 8 Aug 2022 21:30:12 +0900 Subject: [PATCH 18/65] Update CHANGELOG --- CHANGELOG.md | 5 +++++ 1 file changed, 5 insertions(+) diff --git a/CHANGELOG.md b/CHANGELOG.md index 33b3d968..542faca5 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -14,16 +14,21 @@ Please see [here](https://github.com/hrntsm/Tunny/releases) for the data release - It is useful for determining convergence in multi-objective optimization. - BoTorch Sampler - This sampler use Gaussian Process and support multi-objective optimization. +- Quasi-MonteCarlo Sampler + - [Detail](https://optuna.readthedocs.io/en/latest/reference/samplers/generated/optuna.samplers.QMCSampler.html) ### Changed - When genepool is an input, it now creates variable names using nicknames. - Use `suggest_int` and `suggest_discrete_uniform` instead of `suggest_uniform` for more accurate variable generation in optimization +- Updated Optuna used to v3.0.0rc +- Random and Grid samplers now support multi-objective optimization ### Fixed - The PythonInstaller window now has no text on the progress bar. - When more than one Study exists, another Study Name is set and RunOpt no longer causes a Solver Error. +- The error does not occur when the Brep of Geometry of Attribute is null. ## [0.4.0] -2022-07-09 From d269622fb273e61210f1975e9e4f6cae39a8b930 Mon Sep 17 00:00:00 2001 From: hrntsm Date: Mon, 8 Aug 2022 23:22:43 +0900 Subject: [PATCH 19/65] Add constraint support --- Tunny/Optimization/OptimizeLoop.cs | 4 +-- Tunny/Optimization/OutputLoop.cs | 2 +- Tunny/Solver/Optuna/Algorithm.cs | 35 ++++++++++++++----- Tunny/Solver/Optuna/Optuna.cs | 28 ++++++++-------- Tunny/Solver/Optuna/Sampler.cs | 39 ++++++++++++++-------- Tunny/UI/OptimizeWindowTab/VisualizeTab.cs | 2 +- Tunny/Util/GrasshopperInOut.cs | 2 ++ 7 files changed, 72 insertions(+), 40 deletions(-) diff --git a/Tunny/Optimization/OptimizeLoop.cs b/Tunny/Optimization/OptimizeLoop.cs index 150368b8..20358afc 100644 --- a/Tunny/Optimization/OptimizeLoop.cs +++ b/Tunny/Optimization/OptimizeLoop.cs @@ -48,14 +48,14 @@ private static double[] RunOptimizationLoop(BackgroundWorker worker) { List variables = s_component.GhInOut.Variables; List objectives = s_component.GhInOut.Objectives; + bool hasConstraint = s_component.GhInOut.HasConstraint; if (worker.CancellationPending) { return new[] { double.NaN }; } - var optunaSolver = new Optuna(s_component.GhInOut.ComponentFolder, Settings); - + var optunaSolver = new Optuna(s_component.GhInOut.ComponentFolder, Settings, s_component.GhInOut.HasConstraint); bool solverStarted = optunaSolver.RunSolver(variables, objectives, EvaluateFunction); return solverStarted ? optunaSolver.XOpt : new[] { double.NaN }; diff --git a/Tunny/Optimization/OutputLoop.cs b/Tunny/Optimization/OutputLoop.cs index 640b9792..d295b973 100644 --- a/Tunny/Optimization/OutputLoop.cs +++ b/Tunny/Optimization/OutputLoop.cs @@ -32,7 +32,7 @@ internal static void Run(object sender, DoWorkEventArgs e) var fishes = new List(); - var optunaSolver = new Optuna(s_component.GhInOut.ComponentFolder, Settings); + var optunaSolver = new Optuna(s_component.GhInOut.ComponentFolder, Settings, s_component.GhInOut.HasConstraint); ModelResult[] modelResult = optunaSolver.GetModelResult(Indices, StudyName, s_worker); if (modelResult.Length == 0) { diff --git a/Tunny/Solver/Optuna/Algorithm.cs b/Tunny/Solver/Optuna/Algorithm.cs index 85e7a0eb..efa86dac 100644 --- a/Tunny/Solver/Optuna/Algorithm.cs +++ b/Tunny/Solver/Optuna/Algorithm.cs @@ -14,6 +14,7 @@ namespace Tunny.Solver.Optuna public class Algorithm { private List Variables { get; set; } + private bool HasConstraints { get; set; } private string[] ObjNickName { get; set; } private TunnySettings Settings { get; set; } private Func EvalFunc { get; set; } @@ -22,11 +23,12 @@ public class Algorithm public EndState EndState { get; set; } public Algorithm( - List variables, string[] objNickName, + List variables, bool hasConstraint, string[] objNickName, TunnySettings settings, Func evalFunc) { Variables = variables; + HasConstraints = hasConstraint; ObjNickName = objNickName; Settings = settings; EvalFunc = evalFunc; @@ -46,7 +48,7 @@ public void Solve() using (Py.GIL()) { dynamic optuna = Py.Import("optuna"); - dynamic sampler = SetSamplerSettings(samplerType, ref nTrials, optuna); + dynamic sampler = SetSamplerSettings(samplerType, ref nTrials, optuna, HasConstraints); if (CheckExistStudyParameter(nObjective, optuna)) { @@ -234,31 +236,46 @@ private static void SetTrialUserAttr(EvaluatedGHResult result, dynamic trial) if (result.Attribute != null) { - foreach (KeyValuePair> pair in result.Attribute) + SetNonGeometricAttr(result, trial); + } + } + + private static void SetNonGeometricAttr(EvaluatedGHResult result, dynamic trial) + { + foreach (KeyValuePair> pair in result.Attribute) + { + var pyList = new PyList(); + if (pair.Key == "Constraint") + { + foreach (string str in pair.Value) + { + pyList.Append(new PyFloat(double.Parse(str))); + } + } + else { - var pyList = new PyList(); foreach (string str in pair.Value) { pyList.Append(new PyString(str)); } - trial.set_user_attr(pair.Key, pyList); } + trial.set_user_attr(pair.Key, pyList); } } - private dynamic SetSamplerSettings(int samplerType, ref int nTrials, dynamic optuna) + private dynamic SetSamplerSettings(int samplerType, ref int nTrials, dynamic optuna, bool hasConstraints) { dynamic sampler; switch (samplerType) { case 0: - sampler = Sampler.TPE(optuna, Settings); + sampler = Sampler.TPE(optuna, Settings, hasConstraints); break; case 1: - sampler = Sampler.BoTorch(optuna, Settings); + sampler = Sampler.BoTorch(optuna, Settings, hasConstraints); break; case 2: - sampler = Sampler.NSGAII(optuna, Settings); + sampler = Sampler.NSGAII(optuna, Settings, hasConstraints); break; case 3: sampler = Sampler.CmaEs(optuna, Settings); diff --git a/Tunny/Solver/Optuna/Optuna.cs b/Tunny/Solver/Optuna/Optuna.cs index fca8cf69..8e7b0191 100644 --- a/Tunny/Solver/Optuna/Optuna.cs +++ b/Tunny/Solver/Optuna/Optuna.cs @@ -19,12 +19,14 @@ public class Optuna { public double[] XOpt { get; private set; } private readonly string _componentFolder; + private readonly bool _hasConstraint; private readonly TunnySettings _settings; - public Optuna(string componentFolder, TunnySettings settings) + public Optuna(string componentFolder, TunnySettings settings, bool hasConstraint) { _componentFolder = componentFolder; _settings = settings; + _hasConstraint = hasConstraint; string envPath = PythonInstaller.GetEmbeddedPythonPath() + @"\python310.dll"; Environment.SetEnvironmentVariable("PYTHONNET_PYDLL", envPath, EnvironmentVariableTarget.Process); } @@ -44,7 +46,7 @@ EvaluatedGHResult Eval(double[] x, int progress) try { - var optimize = new Algorithm(variables, objNickName, _settings, Eval); + var optimize = new Algorithm(variables, _hasConstraint, objNickName, _settings, Eval); optimize.Solve(); XOpt = optimize.GetXOptimum(); @@ -124,43 +126,41 @@ public void ShowSelectedTypePlot(string visualize, string studyName) PythonEngine.Shutdown(); } - private static void ShowPlot(dynamic optuna, string visualize, dynamic study, string[] nickNames) + private void ShowPlot(dynamic optuna, string visualize, dynamic study, string[] nickNames) { - dynamic vis; switch (visualize) { case "contour": - vis = optuna.visualization.plot_contour(study, target_name: nickNames[0]); + optuna.visualization.plot_contour(study, target_name: nickNames[0]).show(); break; case "EDF": - vis = optuna.visualization.plot_edf(study, target_name: nickNames[0]); + optuna.visualization.plot_edf(study, target_name: nickNames[0]).show(); break; case "intermediate values": - vis = optuna.visualization.plot_intermediate_values(study); + optuna.visualization.plot_intermediate_values(study).show(); break; case "optimization history": - vis = optuna.visualization.plot_optimization_history(study, target_name: nickNames[0]); + optuna.visualization.plot_optimization_history(study, target_name: nickNames[0]).show(); break; case "parallel coordinate": - vis = optuna.visualization.plot_parallel_coordinate(study, target_name: nickNames[0]); + optuna.visualization.plot_parallel_coordinate(study, target_name: nickNames[0]).show(); break; case "param importances": - vis = optuna.visualization.plot_param_importances(study, target_name: nickNames[0]); + optuna.visualization.plot_param_importances(study, target_name: nickNames[0]).show(); break; case "pareto front": - vis = optuna.visualization.plot_pareto_front(study, target_names: nickNames); + optuna.visualization.plot_pareto_front(study, target_names: nickNames, constraints_func: _hasConstraint ? Sampler.ConstraintFunc() : null).show(); break; case "slice": - vis = optuna.visualization.plot_slice(study, target_name: nickNames[0]); + optuna.visualization.plot_slice(study, target_name: nickNames[0]).show(); break; case "hypervolume": - vis = PlotHypervolume(optuna, study); + PlotHypervolume(optuna, study).show(); break; default: TunnyMessageBox.Show("This visualization type is not supported in this study case.", "Tunny"); return; } - vis.show(); } private static dynamic PlotHypervolume(dynamic optuna, dynamic study) diff --git a/Tunny/Solver/Optuna/Sampler.cs b/Tunny/Solver/Optuna/Sampler.cs index 7e262262..0e6d2d98 100644 --- a/Tunny/Solver/Optuna/Sampler.cs +++ b/Tunny/Solver/Optuna/Sampler.cs @@ -10,15 +10,6 @@ namespace Tunny.Solver.Optuna { public static class Sampler { - internal static dynamic BoTorch(dynamic optuna, TunnySettings settings) - { - BoTorch boTorch = settings.Optimize.Sampler.BoTorch; - return optuna.integration.BoTorchSampler( - n_startup_trials: boTorch.NStartupTrials - ); - - } - internal static dynamic Random(dynamic optuna, TunnySettings settings) { Settings.Random random = settings.Optimize.Sampler.Random; @@ -59,7 +50,7 @@ internal static dynamic Grid(dynamic optuna, List variables, ref int n return optuna.samplers.GridSampler(searchSpace); } - internal static dynamic NSGAII(dynamic optuna, TunnySettings settings) + internal static dynamic NSGAII(dynamic optuna, TunnySettings settings, bool hasConstraints) { NSGAII nsga2 = settings.Optimize.Sampler.NsgaII; return optuna.samplers.NSGAIISampler( @@ -67,11 +58,12 @@ internal static dynamic NSGAII(dynamic optuna, TunnySettings settings) mutation_prob: nsga2.MutationProb, crossover_prob: nsga2.CrossoverProb, swapping_prob: nsga2.SwappingProb, - seed: nsga2.Seed + seed: nsga2.Seed, + constraints_func: hasConstraints ? ConstraintFunc() : null ); } - internal static dynamic TPE(dynamic optuna, TunnySettings settings) + internal static dynamic TPE(dynamic optuna, TunnySettings settings, bool hasConstraints) { Tpe tpe = settings.Optimize.Sampler.Tpe; return optuna.samplers.TPESampler( @@ -85,10 +77,21 @@ internal static dynamic TPE(dynamic optuna, TunnySettings settings) multivariate: tpe.Multivariate, group: tpe.Group, warn_independent_sampling: tpe.WarnIndependentSampling, - constant_liar: tpe.ConstantLiar + constant_liar: tpe.ConstantLiar, + constraints_func: hasConstraints ? ConstraintFunc() : null + ); + } + + internal static dynamic BoTorch(dynamic optuna, TunnySettings settings, bool hasConstraints) + { + BoTorch boTorch = settings.Optimize.Sampler.BoTorch; + return optuna.integration.BoTorchSampler( + n_startup_trials: boTorch.NStartupTrials, + constraints_func: hasConstraints ? ConstraintFunc() : null ); } + internal static dynamic QMC(dynamic optuna, TunnySettings settings) { QuasiMonteCarlo qmc = settings.Optimize.Sampler.QMC; @@ -100,5 +103,15 @@ internal static dynamic QMC(dynamic optuna, TunnySettings settings) warn_independent_sampling: qmc.WarnIndependentSampling ); } + + internal static dynamic ConstraintFunc() + { + PyModule ps = Py.CreateScope(); + ps.Exec( + "def constraints(trial):\n" + + " return trial.user_attrs[\"Constraint\"]\n" + ); + return ps.Get("constraints"); + } } } diff --git a/Tunny/UI/OptimizeWindowTab/VisualizeTab.cs b/Tunny/UI/OptimizeWindowTab/VisualizeTab.cs index 4ce1f948..3a16e4b3 100644 --- a/Tunny/UI/OptimizeWindowTab/VisualizeTab.cs +++ b/Tunny/UI/OptimizeWindowTab/VisualizeTab.cs @@ -26,7 +26,7 @@ private void DashboardButton_Click(object sender, EventArgs e) private void SelectedTypePlotButton_Click(object sender, EventArgs e) { - var optuna = new Optuna(_component.GhInOut.ComponentFolder, _settings); + var optuna = new Optuna(_component.GhInOut.ComponentFolder, _settings, _component.GhInOut.HasConstraint); optuna.ShowSelectedTypePlot(visualizeTypeComboBox.Text, studyNameTextBox.Text); } } diff --git a/Tunny/Util/GrasshopperInOut.cs b/Tunny/Util/GrasshopperInOut.cs index 45c307fa..03fdf82a 100644 --- a/Tunny/Util/GrasshopperInOut.cs +++ b/Tunny/Util/GrasshopperInOut.cs @@ -31,6 +31,7 @@ public class GrasshopperInOut public List Sliders { get; set; } public string ComponentFolder { get; } public List Variables { get; set; } + public bool HasConstraint { get; set; } public string DocumentPath { get; set; } public string DocumentName { get; set; } @@ -224,6 +225,7 @@ private void SetAttributes() if (goo is GH_FishAttribute fishAttr) { _attributes = fishAttr; + HasConstraint = fishAttr.Value.ContainsKey("Constraint"); break; } } From 8a53b06dcdae7e3d5eab71d8057d7969eba5dfc2 Mon Sep 17 00:00:00 2001 From: hrntsm Date: Mon, 8 Aug 2022 23:34:54 +0900 Subject: [PATCH 20/65] Add constructFishAttr to have constraint input --- Tunny/Component/ConstructFishAttribute.cs | 21 ++++++++++++++++++++- 1 file changed, 20 insertions(+), 1 deletion(-) diff --git a/Tunny/Component/ConstructFishAttribute.cs b/Tunny/Component/ConstructFishAttribute.cs index d3071ecf..828192d6 100644 --- a/Tunny/Component/ConstructFishAttribute.cs +++ b/Tunny/Component/ConstructFishAttribute.cs @@ -26,11 +26,13 @@ public ConstructFishAttribute() protected override void RegisterInputParams(GH_InputParamManager pManager) { pManager.AddGeometryParameter("Geometry", "Geometry", _geomDescription, GH_ParamAccess.list); + pManager.AddNumberParameter("Constraint", "Constraint", _geomDescription, GH_ParamAccess.list); pManager.AddGenericParameter("Attr1", "Attr1", _attrDescription, GH_ParamAccess.list); pManager.AddGenericParameter("Attr2", "Attr2", _attrDescription, GH_ParamAccess.list); Params.Input[0].Optional = true; Params.Input[1].Optional = true; Params.Input[2].Optional = true; + Params.Input[3].Optional = true; } protected override void RegisterOutputParams(GH_OutputParamManager pManager) @@ -85,7 +87,13 @@ private bool CheckIsNicknameDuplicated() public IGH_Param CreateParameter(GH_ParameterSide side, int index) { - return side == GH_ParameterSide.Input ? index == 0 ? SetGeometryParameterInput() : SetGenericParameterInput(index) : null; + return side == GH_ParameterSide.Input + ? index == 0 + ? SetGeometryParameterInput() + : index == 1 + ? SetNumberParameterInput() + : SetGenericParameterInput(index) + : null; } private IGH_Param SetGenericParameterInput(int index) @@ -98,6 +106,17 @@ private IGH_Param SetGenericParameterInput(int index) return p; } + private IGH_Param SetNumberParameterInput() + { + var p = new Param_Number(); + p.Name = p.NickName = $"Constraint"; + p.Description = _attrDescription; + p.Access = GH_ParamAccess.list; + p.MutableNickName = false; + p.Optional = true; + return p; + } + private IGH_Param SetGeometryParameterInput() { var p = new Param_Geometry(); From f54e5cc63c279800f2d39c988c0ba5008a6aeeed Mon Sep 17 00:00:00 2001 From: hrntsm Date: Mon, 8 Aug 2022 23:49:27 +0900 Subject: [PATCH 21/65] Add message when constraint is not supported --- Tunny/Solver/Optuna/Algorithm.cs | 5 +++++ 1 file changed, 5 insertions(+) diff --git a/Tunny/Solver/Optuna/Algorithm.cs b/Tunny/Solver/Optuna/Algorithm.cs index efa86dac..6ce96bdd 100644 --- a/Tunny/Solver/Optuna/Algorithm.cs +++ b/Tunny/Solver/Optuna/Algorithm.cs @@ -7,6 +7,7 @@ using Tunny.Optimization; using Tunny.Settings; +using Tunny.UI; using Tunny.Util; namespace Tunny.Solver.Optuna @@ -292,6 +293,10 @@ private dynamic SetSamplerSettings(int samplerType, ref int nTrials, dynamic opt default: throw new ArgumentException("Unknown sampler type"); } + if (samplerType > 2 && hasConstraints) + { + TunnyMessageBox.Show("Only TPE, GP and NSGAII support constraints. Optimization is run without considering constraints.", "Tunny"); + } return sampler; } From fd682171ebae501e2184cf5b166fc80cab60adf1 Mon Sep 17 00:00:00 2001 From: hrntsm Date: Mon, 8 Aug 2022 23:50:52 +0900 Subject: [PATCH 22/65] Update CHANGELOG --- CHANGELOG.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/CHANGELOG.md b/CHANGELOG.md index 542faca5..9e03be63 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -16,6 +16,8 @@ Please see [here](https://github.com/hrntsm/Tunny/releases) for the data release - This sampler use Gaussian Process and support multi-objective optimization. - Quasi-MonteCarlo Sampler - [Detail](https://optuna.readthedocs.io/en/latest/reference/samplers/generated/optuna.samplers.QMCSampler.html) +- Support Constraint. + - Only TPE, GP, NSGAII can use constraint. ### Changed From e46d64bfde0541dc068f35e8bf4eea48823479a0 Mon Sep 17 00:00:00 2001 From: hrntsm Date: Tue, 9 Aug 2022 09:23:49 +0900 Subject: [PATCH 23/65] Clean code --- Tunny/Optimization/OptimizeLoop.cs | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/Tunny/Optimization/OptimizeLoop.cs b/Tunny/Optimization/OptimizeLoop.cs index 20358afc..72e23e2e 100644 --- a/Tunny/Optimization/OptimizeLoop.cs +++ b/Tunny/Optimization/OptimizeLoop.cs @@ -55,7 +55,7 @@ private static double[] RunOptimizationLoop(BackgroundWorker worker) return new[] { double.NaN }; } - var optunaSolver = new Optuna(s_component.GhInOut.ComponentFolder, Settings, s_component.GhInOut.HasConstraint); + var optunaSolver = new Optuna(s_component.GhInOut.ComponentFolder, Settings, hasConstraint); bool solverStarted = optunaSolver.RunSolver(variables, objectives, EvaluateFunction); return solverStarted ? optunaSolver.XOpt : new[] { double.NaN }; From dbf01fdfbbfd8c1d76af632b31813055ce08249f Mon Sep 17 00:00:00 2001 From: hrntsm Date: Tue, 9 Aug 2022 09:34:55 +0900 Subject: [PATCH 24/65] Update python packages licenses --- PYTHON_PACKAGE_LICENSES | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/PYTHON_PACKAGE_LICENSES b/PYTHON_PACKAGE_LICENSES index 3e500fda..30031b02 100644 --- a/PYTHON_PACKAGE_LICENSES +++ b/PYTHON_PACKAGE_LICENSES @@ -1803,7 +1803,7 @@ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. optuna -2.10.1 +3.0.0rc0 MIT License https://optuna.org/ MIT License @@ -1829,7 +1829,7 @@ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. optuna-dashboard -0.7.1 +0.7.2 MIT License https://github.com/optuna/optuna-dashboard MIT License From 7d62a925540600279d13c81e8144e345386fb5cc Mon Sep 17 00:00:00 2001 From: hrntsm Date: Thu, 18 Aug 2022 23:13:57 +0900 Subject: [PATCH 25/65] Add setting tabcontrol --- Tunny/UI/OptimizationWindow.Designer.cs | 901 ++++++++++++++++++++-- Tunny/UI/OptimizationWindow.resx | 5 + Tunny/UI/OptimizeWindowTab/SettingsTab.cs | 38 +- 3 files changed, 840 insertions(+), 104 deletions(-) diff --git a/Tunny/UI/OptimizationWindow.Designer.cs b/Tunny/UI/OptimizationWindow.Designer.cs index 425936d9..491b4d89 100644 --- a/Tunny/UI/OptimizationWindow.Designer.cs +++ b/Tunny/UI/OptimizationWindow.Designer.cs @@ -61,12 +61,52 @@ private void InitializeComponent() this.outputModelNumTextBox = new System.Windows.Forms.TextBox(); this.outputModelLabel = new System.Windows.Forms.Label(); this.settingsTabPage = new System.Windows.Forms.TabPage(); - this.settingsToJson = new System.Windows.Forms.Button(); - this.settingsOpenAPIPage = new System.Windows.Forms.Button(); - this.settingsAPIComboBox = new System.Windows.Forms.ComboBox(); - this.settingsFolderOpen = new System.Windows.Forms.Button(); - this.settingLabel = new System.Windows.Forms.Label(); - this.settingsFromJson = new System.Windows.Forms.Button(); + this.settingsTabControl = new System.Windows.Forms.TabControl(); + this.TPE = new System.Windows.Forms.TabPage(); + this.tpeNEICandidatesLabel = new System.Windows.Forms.Label(); + this.tpeNStartupTrialsLabel = new System.Windows.Forms.Label(); + this.tpePriorWeightLabel = new System.Windows.Forms.Label(); + this.tpeEINumUpDown = new System.Windows.Forms.NumericUpDown(); + this.tpeStartupNumUpDown = new System.Windows.Forms.NumericUpDown(); + this.tpePriorNumUpDown = new System.Windows.Forms.NumericUpDown(); + this.tpeConstantLiarCheckBox = new System.Windows.Forms.CheckBox(); + this.tpeWarnIndependentSamplingCheckBox = new System.Windows.Forms.CheckBox(); + this.tpeGroupCheckBox = new System.Windows.Forms.CheckBox(); + this.tpeMultivariateCheckBox = new System.Windows.Forms.CheckBox(); + this.tpeConsiderEndpointsCheckBox = new System.Windows.Forms.CheckBox(); + this.tpeConsiderMagicClipCheckBox = new System.Windows.Forms.CheckBox(); + this.tpeConsiderPriorCheckBox = new System.Windows.Forms.CheckBox(); + this.GP = new System.Windows.Forms.TabPage(); + this.botorchNStartupTrialsLabel = new System.Windows.Forms.Label(); + this.numericUpDown1 = new System.Windows.Forms.NumericUpDown(); + this.NSGAII = new System.Windows.Forms.TabPage(); + this.nsgaMutationProbCheckBox = new System.Windows.Forms.CheckBox(); + this.nsgaPopulationSizeLabel = new System.Windows.Forms.Label(); + this.nsgaPopulationSizeUpDown = new System.Windows.Forms.NumericUpDown(); + this.nsgaSwappingProbLabel = new System.Windows.Forms.Label(); + this.nsgaSwappingProbUpDown = new System.Windows.Forms.NumericUpDown(); + this.nsgaCrossoverProbLabel = new System.Windows.Forms.Label(); + this.nsgaCrossoverProbUpDown = new System.Windows.Forms.NumericUpDown(); + this.nsgaMutationProbUpDown = new System.Windows.Forms.NumericUpDown(); + this.CMAES = new System.Windows.Forms.TabPage(); + this.cmaesRestartCheckBox = new System.Windows.Forms.CheckBox(); + this.cmaesUseSaparableCmaCheckBox = new System.Windows.Forms.CheckBox(); + this.cmaesNStartupTrialsLabel = new System.Windows.Forms.Label(); + this.cmaesNStartup = new System.Windows.Forms.Label(); + this.numericUpDown4 = new System.Windows.Forms.NumericUpDown(); + this.cmaesStartupNumUpDown = new System.Windows.Forms.NumericUpDown(); + this.cmaesConsiderPruneTrialsCheckBox = new System.Windows.Forms.CheckBox(); + this.cmaesWarnIndependentSamplingCheckBox = new System.Windows.Forms.CheckBox(); + this.cmaesIncPopsizeLabel = new System.Windows.Forms.Label(); + this.cmaesIncPopSizeUpDown = new System.Windows.Forms.NumericUpDown(); + this.cmaesSigmaCheckBox = new System.Windows.Forms.CheckBox(); + this.numericUpDown2 = new System.Windows.Forms.NumericUpDown(); + this.QMC = new System.Windows.Forms.TabPage(); + this.qmcTypeComboBox = new System.Windows.Forms.ComboBox(); + this.qmcTypeLabel = new System.Windows.Forms.Label(); + this.qmcWarnAsyncSeedingCheckBox = new System.Windows.Forms.CheckBox(); + this.qmcScrambleCheckBox = new System.Windows.Forms.CheckBox(); + this.qmcWarnIndependentSamplingcheckBox = new System.Windows.Forms.CheckBox(); this.fileTabPage = new System.Windows.Forms.TabPage(); this.openResultFolderButton = new System.Windows.Forms.Button(); this.clearResultButton = new System.Windows.Forms.Button(); @@ -79,6 +119,24 @@ private void InitializeComponent() this.visualizeTabPage.SuspendLayout(); this.outputTabPage.SuspendLayout(); this.settingsTabPage.SuspendLayout(); + this.settingsTabControl.SuspendLayout(); + this.TPE.SuspendLayout(); + ((System.ComponentModel.ISupportInitialize)(this.tpeEINumUpDown)).BeginInit(); + ((System.ComponentModel.ISupportInitialize)(this.tpeStartupNumUpDown)).BeginInit(); + ((System.ComponentModel.ISupportInitialize)(this.tpePriorNumUpDown)).BeginInit(); + this.GP.SuspendLayout(); + ((System.ComponentModel.ISupportInitialize)(this.numericUpDown1)).BeginInit(); + this.NSGAII.SuspendLayout(); + ((System.ComponentModel.ISupportInitialize)(this.nsgaPopulationSizeUpDown)).BeginInit(); + ((System.ComponentModel.ISupportInitialize)(this.nsgaSwappingProbUpDown)).BeginInit(); + ((System.ComponentModel.ISupportInitialize)(this.nsgaCrossoverProbUpDown)).BeginInit(); + ((System.ComponentModel.ISupportInitialize)(this.nsgaMutationProbUpDown)).BeginInit(); + this.CMAES.SuspendLayout(); + ((System.ComponentModel.ISupportInitialize)(this.numericUpDown4)).BeginInit(); + ((System.ComponentModel.ISupportInitialize)(this.cmaesStartupNumUpDown)).BeginInit(); + ((System.ComponentModel.ISupportInitialize)(this.cmaesIncPopSizeUpDown)).BeginInit(); + ((System.ComponentModel.ISupportInitialize)(this.numericUpDown2)).BeginInit(); + this.QMC.SuspendLayout(); this.fileTabPage.SuspendLayout(); this.SuspendLayout(); // @@ -434,12 +492,7 @@ private void InitializeComponent() // // settingsTabPage // - this.settingsTabPage.Controls.Add(this.settingsToJson); - this.settingsTabPage.Controls.Add(this.settingsOpenAPIPage); - this.settingsTabPage.Controls.Add(this.settingsAPIComboBox); - this.settingsTabPage.Controls.Add(this.settingsFolderOpen); - this.settingsTabPage.Controls.Add(this.settingLabel); - this.settingsTabPage.Controls.Add(this.settingsFromJson); + this.settingsTabPage.Controls.Add(this.settingsTabControl); this.settingsTabPage.Location = new System.Drawing.Point(4, 60); this.settingsTabPage.Margin = new System.Windows.Forms.Padding(4); this.settingsTabPage.Name = "settingsTabPage"; @@ -448,73 +501,688 @@ private void InitializeComponent() this.settingsTabPage.Text = "Settings"; this.settingsTabPage.UseVisualStyleBackColor = true; // - // settingsToJson - // - this.settingsToJson.Location = new System.Drawing.Point(50, 204); - this.settingsToJson.Margin = new System.Windows.Forms.Padding(4); - this.settingsToJson.Name = "settingsToJson"; - this.settingsToJson.Size = new System.Drawing.Size(278, 34); - this.settingsToJson.TabIndex = 5; - this.settingsToJson.Text = "Save settings to json"; - this.settingsToJson.UseVisualStyleBackColor = true; - this.settingsToJson.Click += new System.EventHandler(this.SettingsToJson_Click); - // - // settingsOpenAPIPage - // - this.settingsOpenAPIPage.Location = new System.Drawing.Point(183, 132); - this.settingsOpenAPIPage.Margin = new System.Windows.Forms.Padding(4); - this.settingsOpenAPIPage.Name = "settingsOpenAPIPage"; - this.settingsOpenAPIPage.Size = new System.Drawing.Size(165, 34); - this.settingsOpenAPIPage.TabIndex = 4; - this.settingsOpenAPIPage.Text = "Open API page"; - this.settingsOpenAPIPage.UseVisualStyleBackColor = true; - this.settingsOpenAPIPage.Click += new System.EventHandler(this.SettingsOpenAPIPage_Click); - // - // settingsAPIComboBox - // - this.settingsAPIComboBox.FormattingEnabled = true; - this.settingsAPIComboBox.Items.AddRange(new object[] { - "TPE", - "NSGA-II", - "CMA-ES", - "Random"}); - this.settingsAPIComboBox.Location = new System.Drawing.Point(26, 132); - this.settingsAPIComboBox.Margin = new System.Windows.Forms.Padding(4); - this.settingsAPIComboBox.Name = "settingsAPIComboBox"; - this.settingsAPIComboBox.Size = new System.Drawing.Size(142, 31); - this.settingsAPIComboBox.TabIndex = 3; - // - // settingsFolderOpen - // - this.settingsFolderOpen.Location = new System.Drawing.Point(50, 291); - this.settingsFolderOpen.Margin = new System.Windows.Forms.Padding(4); - this.settingsFolderOpen.Name = "settingsFolderOpen"; - this.settingsFolderOpen.Size = new System.Drawing.Size(278, 34); - this.settingsFolderOpen.TabIndex = 2; - this.settingsFolderOpen.Text = "Open Settings.json folder"; - this.settingsFolderOpen.UseVisualStyleBackColor = true; - this.settingsFolderOpen.Click += new System.EventHandler(this.SettingsFolderOpen_Click); - // - // settingLabel - // - this.settingLabel.Location = new System.Drawing.Point(21, 18); - this.settingLabel.Margin = new System.Windows.Forms.Padding(4, 0, 4, 0); - this.settingLabel.Name = "settingLabel"; - this.settingLabel.Size = new System.Drawing.Size(327, 110); - this.settingLabel.TabIndex = 1; - this.settingLabel.Text = "Detailed optimization settings can be configured in the \"Settings.json\" file in t" + - "he following folder."; - // - // settingsFromJson - // - this.settingsFromJson.Location = new System.Drawing.Point(50, 248); - this.settingsFromJson.Margin = new System.Windows.Forms.Padding(4); - this.settingsFromJson.Name = "settingsFromJson"; - this.settingsFromJson.Size = new System.Drawing.Size(278, 34); - this.settingsFromJson.TabIndex = 0; - this.settingsFromJson.Text = "Load settings from json"; - this.settingsFromJson.UseVisualStyleBackColor = true; - this.settingsFromJson.Click += new System.EventHandler(this.SettingsFromJson_Click); + // settingsTabControl + // + this.settingsTabControl.Controls.Add(this.TPE); + this.settingsTabControl.Controls.Add(this.GP); + this.settingsTabControl.Controls.Add(this.NSGAII); + this.settingsTabControl.Controls.Add(this.CMAES); + this.settingsTabControl.Controls.Add(this.QMC); + this.settingsTabControl.Location = new System.Drawing.Point(3, 3); + this.settingsTabControl.Name = "settingsTabControl"; + this.settingsTabControl.SelectedIndex = 0; + this.settingsTabControl.Size = new System.Drawing.Size(376, 371); + this.settingsTabControl.TabIndex = 0; + // + // TPE + // + this.TPE.Controls.Add(this.tpeNEICandidatesLabel); + this.TPE.Controls.Add(this.tpeNStartupTrialsLabel); + this.TPE.Controls.Add(this.tpePriorWeightLabel); + this.TPE.Controls.Add(this.tpeEINumUpDown); + this.TPE.Controls.Add(this.tpeStartupNumUpDown); + this.TPE.Controls.Add(this.tpePriorNumUpDown); + this.TPE.Controls.Add(this.tpeConstantLiarCheckBox); + this.TPE.Controls.Add(this.tpeWarnIndependentSamplingCheckBox); + this.TPE.Controls.Add(this.tpeGroupCheckBox); + this.TPE.Controls.Add(this.tpeMultivariateCheckBox); + this.TPE.Controls.Add(this.tpeConsiderEndpointsCheckBox); + this.TPE.Controls.Add(this.tpeConsiderMagicClipCheckBox); + this.TPE.Controls.Add(this.tpeConsiderPriorCheckBox); + this.TPE.Location = new System.Drawing.Point(4, 32); + this.TPE.Name = "TPE"; + this.TPE.Padding = new System.Windows.Forms.Padding(3); + this.TPE.Size = new System.Drawing.Size(368, 335); + this.TPE.TabIndex = 0; + this.TPE.Text = "TPE"; + this.toolTip1.SetToolTip(this.TPE, "aa"); + this.TPE.ToolTipText = "aaaaa"; + this.TPE.UseVisualStyleBackColor = true; + // + // tpeNEICandidatesLabel + // + this.tpeNEICandidatesLabel.AutoSize = true; + this.tpeNEICandidatesLabel.Location = new System.Drawing.Point(5, 44); + this.tpeNEICandidatesLabel.Name = "tpeNEICandidatesLabel"; + this.tpeNEICandidatesLabel.Size = new System.Drawing.Size(225, 23); + this.tpeNEICandidatesLabel.TabIndex = 12; + this.tpeNEICandidatesLabel.Text = "Number of EI candidates"; + this.toolTip1.SetToolTip(this.tpeNEICandidatesLabel, "Number of candidate samples used to calculate the expected improvement."); + // + // tpeNStartupTrialsLabel + // + this.tpeNStartupTrialsLabel.AutoSize = true; + this.tpeNStartupTrialsLabel.Location = new System.Drawing.Point(5, 8); + this.tpeNStartupTrialsLabel.Name = "tpeNStartupTrialsLabel"; + this.tpeNStartupTrialsLabel.Size = new System.Drawing.Size(219, 23); + this.tpeNStartupTrialsLabel.TabIndex = 11; + this.tpeNStartupTrialsLabel.Text = "Number of startup trials"; + this.toolTip1.SetToolTip(this.tpeNStartupTrialsLabel, "The random sampling is used instead of the TPE algorithm until the given number o" + + "f trials finish in the same study."); + // + // tpePriorWeightLabel + // + this.tpePriorWeightLabel.AutoSize = true; + this.tpePriorWeightLabel.Location = new System.Drawing.Point(5, 80); + this.tpePriorWeightLabel.Name = "tpePriorWeightLabel"; + this.tpePriorWeightLabel.Size = new System.Drawing.Size(118, 23); + this.tpePriorWeightLabel.TabIndex = 10; + this.tpePriorWeightLabel.Text = "Prior Weight"; + this.toolTip1.SetToolTip(this.tpePriorWeightLabel, "The weight of the prior."); + // + // tpeEINumUpDown + // + this.tpeEINumUpDown.Location = new System.Drawing.Point(253, 42); + this.tpeEINumUpDown.Minimum = new decimal(new int[] { + 1, + 0, + 0, + 0}); + this.tpeEINumUpDown.Name = "tpeEINumUpDown"; + this.tpeEINumUpDown.Size = new System.Drawing.Size(94, 30); + this.tpeEINumUpDown.TabIndex = 9; + this.tpeEINumUpDown.Value = new decimal(new int[] { + 24, + 0, + 0, + 0}); + // + // tpeStartupNumUpDown + // + this.tpeStartupNumUpDown.Location = new System.Drawing.Point(253, 6); + this.tpeStartupNumUpDown.Maximum = new decimal(new int[] { + 1000, + 0, + 0, + 0}); + this.tpeStartupNumUpDown.Minimum = new decimal(new int[] { + 1, + 0, + 0, + 0}); + this.tpeStartupNumUpDown.Name = "tpeStartupNumUpDown"; + this.tpeStartupNumUpDown.Size = new System.Drawing.Size(94, 30); + this.tpeStartupNumUpDown.TabIndex = 8; + this.tpeStartupNumUpDown.Value = new decimal(new int[] { + 10, + 0, + 0, + 0}); + // + // tpePriorNumUpDown + // + this.tpePriorNumUpDown.DecimalPlaces = 1; + this.tpePriorNumUpDown.Increment = new decimal(new int[] { + 1, + 0, + 0, + 65536}); + this.tpePriorNumUpDown.Location = new System.Drawing.Point(253, 78); + this.tpePriorNumUpDown.Name = "tpePriorNumUpDown"; + this.tpePriorNumUpDown.Size = new System.Drawing.Size(94, 30); + this.tpePriorNumUpDown.TabIndex = 7; + this.tpePriorNumUpDown.Value = new decimal(new int[] { + 10, + 0, + 0, + 65536}); + // + // tpeConstantLiarCheckBox + // + this.tpeConstantLiarCheckBox.AutoSize = true; + this.tpeConstantLiarCheckBox.Location = new System.Drawing.Point(210, 203); + this.tpeConstantLiarCheckBox.Name = "tpeConstantLiarCheckBox"; + this.tpeConstantLiarCheckBox.Size = new System.Drawing.Size(152, 27); + this.tpeConstantLiarCheckBox.TabIndex = 6; + this.tpeConstantLiarCheckBox.Text = "Constant Liar"; + this.toolTip1.SetToolTip(this.tpeConstantLiarCheckBox, "If True, penalize running trials to avoid suggesting parameter configurations nea" + + "rby."); + this.tpeConstantLiarCheckBox.UseVisualStyleBackColor = true; + // + // tpeWarnIndependentSamplingCheckBox + // + this.tpeWarnIndependentSamplingCheckBox.AutoSize = true; + this.tpeWarnIndependentSamplingCheckBox.Checked = true; + this.tpeWarnIndependentSamplingCheckBox.CheckState = System.Windows.Forms.CheckState.Checked; + this.tpeWarnIndependentSamplingCheckBox.Location = new System.Drawing.Point(5, 239); + this.tpeWarnIndependentSamplingCheckBox.Name = "tpeWarnIndependentSamplingCheckBox"; + this.tpeWarnIndependentSamplingCheckBox.Size = new System.Drawing.Size(284, 27); + this.tpeWarnIndependentSamplingCheckBox.TabIndex = 5; + this.tpeWarnIndependentSamplingCheckBox.Text = "Warn Independent Sampling"; + this.toolTip1.SetToolTip(this.tpeWarnIndependentSamplingCheckBox, "If this is True and multivariate=True, a warning message is emitted when the valu" + + "e of a parameter is sampled by using an independent sampler. If multivariate=Fal" + + "se, this flag has no effect."); + this.tpeWarnIndependentSamplingCheckBox.UseVisualStyleBackColor = true; + // + // tpeGroupCheckBox + // + this.tpeGroupCheckBox.AutoSize = true; + this.tpeGroupCheckBox.Location = new System.Drawing.Point(210, 170); + this.tpeGroupCheckBox.Name = "tpeGroupCheckBox"; + this.tpeGroupCheckBox.Size = new System.Drawing.Size(89, 27); + this.tpeGroupCheckBox.TabIndex = 4; + this.tpeGroupCheckBox.Text = "Group"; + this.toolTip1.SetToolTip(this.tpeGroupCheckBox, "If this and multivariate are True, the multivariate TPE with the group decomposed" + + " search space is used when suggesting parameters. "); + this.tpeGroupCheckBox.UseVisualStyleBackColor = true; + // + // tpeMultivariateCheckBox + // + this.tpeMultivariateCheckBox.AutoSize = true; + this.tpeMultivariateCheckBox.Location = new System.Drawing.Point(210, 137); + this.tpeMultivariateCheckBox.Name = "tpeMultivariateCheckBox"; + this.tpeMultivariateCheckBox.Size = new System.Drawing.Size(137, 27); + this.tpeMultivariateCheckBox.TabIndex = 3; + this.tpeMultivariateCheckBox.Text = "Maltivariate"; + this.toolTip1.SetToolTip(this.tpeMultivariateCheckBox, "If this is True, the multivariate TPE is used when suggesting parameters. The mul" + + "tivariate TPE is reported to outperform the independent TPE."); + this.tpeMultivariateCheckBox.UseVisualStyleBackColor = true; + // + // tpeConsiderEndpointsCheckBox + // + this.tpeConsiderEndpointsCheckBox.AutoSize = true; + this.tpeConsiderEndpointsCheckBox.Location = new System.Drawing.Point(5, 170); + this.tpeConsiderEndpointsCheckBox.Name = "tpeConsiderEndpointsCheckBox"; + this.tpeConsiderEndpointsCheckBox.Size = new System.Drawing.Size(205, 27); + this.tpeConsiderEndpointsCheckBox.TabIndex = 2; + this.tpeConsiderEndpointsCheckBox.Text = "Consider Endpoints"; + this.toolTip1.SetToolTip(this.tpeConsiderEndpointsCheckBox, "Take endpoints of domains into account when calculating variances of Gaussians in" + + " Parzen estimator."); + this.tpeConsiderEndpointsCheckBox.UseVisualStyleBackColor = true; + // + // tpeConsiderMagicClipCheckBox + // + this.tpeConsiderMagicClipCheckBox.AutoSize = true; + this.tpeConsiderMagicClipCheckBox.Checked = true; + this.tpeConsiderMagicClipCheckBox.CheckState = System.Windows.Forms.CheckState.Checked; + this.tpeConsiderMagicClipCheckBox.Location = new System.Drawing.Point(5, 203); + this.tpeConsiderMagicClipCheckBox.Name = "tpeConsiderMagicClipCheckBox"; + this.tpeConsiderMagicClipCheckBox.Size = new System.Drawing.Size(207, 27); + this.tpeConsiderMagicClipCheckBox.TabIndex = 1; + this.tpeConsiderMagicClipCheckBox.Text = "Consider Magic Clip"; + this.toolTip1.SetToolTip(this.tpeConsiderMagicClipCheckBox, "Enable a heuristic to limit the smallest variances of Gaussians used in the Parze" + + "n estimator."); + this.tpeConsiderMagicClipCheckBox.UseVisualStyleBackColor = true; + // + // tpeConsiderPriorCheckBox + // + this.tpeConsiderPriorCheckBox.AutoSize = true; + this.tpeConsiderPriorCheckBox.Checked = true; + this.tpeConsiderPriorCheckBox.CheckState = System.Windows.Forms.CheckState.Checked; + this.tpeConsiderPriorCheckBox.Location = new System.Drawing.Point(5, 137); + this.tpeConsiderPriorCheckBox.Name = "tpeConsiderPriorCheckBox"; + this.tpeConsiderPriorCheckBox.Size = new System.Drawing.Size(159, 27); + this.tpeConsiderPriorCheckBox.TabIndex = 0; + this.tpeConsiderPriorCheckBox.Text = "Consider Prior"; + this.toolTip1.SetToolTip(this.tpeConsiderPriorCheckBox, "Enhance the stability of Parzen estimator by imposing a Gaussian prior when True." + + ""); + this.tpeConsiderPriorCheckBox.UseVisualStyleBackColor = true; + // + // GP + // + this.GP.Controls.Add(this.botorchNStartupTrialsLabel); + this.GP.Controls.Add(this.numericUpDown1); + this.GP.Location = new System.Drawing.Point(4, 32); + this.GP.Name = "GP"; + this.GP.Padding = new System.Windows.Forms.Padding(3); + this.GP.Size = new System.Drawing.Size(368, 335); + this.GP.TabIndex = 1; + this.GP.Text = "GP"; + this.GP.UseVisualStyleBackColor = true; + // + // botorchNStartupTrialsLabel + // + this.botorchNStartupTrialsLabel.AutoSize = true; + this.botorchNStartupTrialsLabel.Location = new System.Drawing.Point(6, 8); + this.botorchNStartupTrialsLabel.Name = "botorchNStartupTrialsLabel"; + this.botorchNStartupTrialsLabel.Size = new System.Drawing.Size(219, 23); + this.botorchNStartupTrialsLabel.TabIndex = 13; + this.botorchNStartupTrialsLabel.Text = "Number of startup trials"; + this.toolTip1.SetToolTip(this.botorchNStartupTrialsLabel, "Number of initial trials, that is the number of trials to resort to independent s" + + "ampling."); + // + // numericUpDown1 + // + this.numericUpDown1.Location = new System.Drawing.Point(254, 6); + this.numericUpDown1.Maximum = new decimal(new int[] { + 1000, + 0, + 0, + 0}); + this.numericUpDown1.Minimum = new decimal(new int[] { + 1, + 0, + 0, + 0}); + this.numericUpDown1.Name = "numericUpDown1"; + this.numericUpDown1.Size = new System.Drawing.Size(94, 30); + this.numericUpDown1.TabIndex = 12; + this.numericUpDown1.Value = new decimal(new int[] { + 10, + 0, + 0, + 0}); + // + // NSGAII + // + this.NSGAII.Controls.Add(this.nsgaMutationProbCheckBox); + this.NSGAII.Controls.Add(this.nsgaPopulationSizeLabel); + this.NSGAII.Controls.Add(this.nsgaPopulationSizeUpDown); + this.NSGAII.Controls.Add(this.nsgaSwappingProbLabel); + this.NSGAII.Controls.Add(this.nsgaSwappingProbUpDown); + this.NSGAII.Controls.Add(this.nsgaCrossoverProbLabel); + this.NSGAII.Controls.Add(this.nsgaCrossoverProbUpDown); + this.NSGAII.Controls.Add(this.nsgaMutationProbUpDown); + this.NSGAII.Location = new System.Drawing.Point(4, 32); + this.NSGAII.Name = "NSGAII"; + this.NSGAII.Size = new System.Drawing.Size(368, 335); + this.NSGAII.TabIndex = 3; + this.NSGAII.Text = "NSGAII"; + this.NSGAII.UseVisualStyleBackColor = true; + // + // nsgaMutationProbCheckBox + // + this.nsgaMutationProbCheckBox.AutoSize = true; + this.nsgaMutationProbCheckBox.Location = new System.Drawing.Point(13, 8); + this.nsgaMutationProbCheckBox.Name = "nsgaMutationProbCheckBox"; + this.nsgaMutationProbCheckBox.Size = new System.Drawing.Size(212, 27); + this.nsgaMutationProbCheckBox.TabIndex = 22; + this.nsgaMutationProbCheckBox.Text = "Mutation Probability"; + this.toolTip1.SetToolTip(this.nsgaMutationProbCheckBox, "If False, the solver automatically calculates mutation probability."); + this.nsgaMutationProbCheckBox.UseVisualStyleBackColor = true; + // + // nsgaPopulationSizeLabel + // + this.nsgaPopulationSizeLabel.AutoSize = true; + this.nsgaPopulationSizeLabel.Location = new System.Drawing.Point(9, 117); + this.nsgaPopulationSizeLabel.Name = "nsgaPopulationSizeLabel"; + this.nsgaPopulationSizeLabel.Size = new System.Drawing.Size(144, 23); + this.nsgaPopulationSizeLabel.TabIndex = 21; + this.nsgaPopulationSizeLabel.Text = "Population Size"; + this.toolTip1.SetToolTip(this.nsgaPopulationSizeLabel, "Number of individuals (trials) in a generation."); + // + // nsgaPopulationSizeUpDown + // + this.nsgaPopulationSizeUpDown.Location = new System.Drawing.Point(257, 115); + this.nsgaPopulationSizeUpDown.Maximum = new decimal(new int[] { + 1000, + 0, + 0, + 0}); + this.nsgaPopulationSizeUpDown.Minimum = new decimal(new int[] { + 1, + 0, + 0, + 0}); + this.nsgaPopulationSizeUpDown.Name = "nsgaPopulationSizeUpDown"; + this.nsgaPopulationSizeUpDown.Size = new System.Drawing.Size(94, 30); + this.nsgaPopulationSizeUpDown.TabIndex = 20; + this.nsgaPopulationSizeUpDown.Value = new decimal(new int[] { + 50, + 0, + 0, + 0}); + // + // nsgaSwappingProbLabel + // + this.nsgaSwappingProbLabel.AutoSize = true; + this.nsgaSwappingProbLabel.Location = new System.Drawing.Point(9, 81); + this.nsgaSwappingProbLabel.Name = "nsgaSwappingProbLabel"; + this.nsgaSwappingProbLabel.Size = new System.Drawing.Size(194, 23); + this.nsgaSwappingProbLabel.TabIndex = 19; + this.nsgaSwappingProbLabel.Text = "Swapping Probability"; + this.toolTip1.SetToolTip(this.nsgaSwappingProbLabel, "Probability of swapping each parameter of the parents during crossover."); + // + // nsgaSwappingProbUpDown + // + this.nsgaSwappingProbUpDown.DecimalPlaces = 2; + this.nsgaSwappingProbUpDown.Increment = new decimal(new int[] { + 1, + 0, + 0, + 131072}); + this.nsgaSwappingProbUpDown.Location = new System.Drawing.Point(257, 79); + this.nsgaSwappingProbUpDown.Maximum = new decimal(new int[] { + 1, + 0, + 0, + 0}); + this.nsgaSwappingProbUpDown.Name = "nsgaSwappingProbUpDown"; + this.nsgaSwappingProbUpDown.Size = new System.Drawing.Size(94, 30); + this.nsgaSwappingProbUpDown.TabIndex = 18; + this.nsgaSwappingProbUpDown.Value = new decimal(new int[] { + 5, + 0, + 0, + 65536}); + // + // nsgaCrossoverProbLabel + // + this.nsgaCrossoverProbLabel.AutoSize = true; + this.nsgaCrossoverProbLabel.Location = new System.Drawing.Point(9, 45); + this.nsgaCrossoverProbLabel.Name = "nsgaCrossoverProbLabel"; + this.nsgaCrossoverProbLabel.Size = new System.Drawing.Size(195, 23); + this.nsgaCrossoverProbLabel.TabIndex = 17; + this.nsgaCrossoverProbLabel.Text = "Crossover Probability"; + this.toolTip1.SetToolTip(this.nsgaCrossoverProbLabel, "Probability that a crossover (parameters swapping between parents) will occur whe" + + "n creating a new individual."); + // + // nsgaCrossoverProbUpDown + // + this.nsgaCrossoverProbUpDown.DecimalPlaces = 2; + this.nsgaCrossoverProbUpDown.Increment = new decimal(new int[] { + 1, + 0, + 0, + 131072}); + this.nsgaCrossoverProbUpDown.Location = new System.Drawing.Point(257, 43); + this.nsgaCrossoverProbUpDown.Maximum = new decimal(new int[] { + 1, + 0, + 0, + 0}); + this.nsgaCrossoverProbUpDown.Name = "nsgaCrossoverProbUpDown"; + this.nsgaCrossoverProbUpDown.Size = new System.Drawing.Size(94, 30); + this.nsgaCrossoverProbUpDown.TabIndex = 16; + this.nsgaCrossoverProbUpDown.Value = new decimal(new int[] { + 9, + 0, + 0, + 65536}); + // + // nsgaMutationProbUpDown + // + this.nsgaMutationProbUpDown.DecimalPlaces = 2; + this.nsgaMutationProbUpDown.Enabled = false; + this.nsgaMutationProbUpDown.Increment = new decimal(new int[] { + 1, + 0, + 0, + 131072}); + this.nsgaMutationProbUpDown.Location = new System.Drawing.Point(257, 7); + this.nsgaMutationProbUpDown.Maximum = new decimal(new int[] { + 0, + 0, + 0, + 0}); + this.nsgaMutationProbUpDown.Name = "nsgaMutationProbUpDown"; + this.nsgaMutationProbUpDown.Size = new System.Drawing.Size(94, 30); + this.nsgaMutationProbUpDown.TabIndex = 14; + // + // CMAES + // + this.CMAES.Controls.Add(this.cmaesRestartCheckBox); + this.CMAES.Controls.Add(this.cmaesUseSaparableCmaCheckBox); + this.CMAES.Controls.Add(this.cmaesNStartupTrialsLabel); + this.CMAES.Controls.Add(this.cmaesNStartup); + this.CMAES.Controls.Add(this.numericUpDown4); + this.CMAES.Controls.Add(this.cmaesStartupNumUpDown); + this.CMAES.Controls.Add(this.cmaesConsiderPruneTrialsCheckBox); + this.CMAES.Controls.Add(this.cmaesWarnIndependentSamplingCheckBox); + this.CMAES.Controls.Add(this.cmaesIncPopsizeLabel); + this.CMAES.Controls.Add(this.cmaesIncPopSizeUpDown); + this.CMAES.Controls.Add(this.cmaesSigmaCheckBox); + this.CMAES.Controls.Add(this.numericUpDown2); + this.CMAES.Location = new System.Drawing.Point(4, 32); + this.CMAES.Name = "CMAES"; + this.CMAES.Size = new System.Drawing.Size(368, 335); + this.CMAES.TabIndex = 2; + this.CMAES.Text = "CMA-ES"; + this.CMAES.UseVisualStyleBackColor = true; + // + // cmaesRestartCheckBox + // + this.cmaesRestartCheckBox.AutoSize = true; + this.cmaesRestartCheckBox.Location = new System.Drawing.Point(11, 203); + this.cmaesRestartCheckBox.Name = "cmaesRestartCheckBox"; + this.cmaesRestartCheckBox.Size = new System.Drawing.Size(171, 27); + this.cmaesRestartCheckBox.TabIndex = 32; + this.cmaesRestartCheckBox.Text = "RestartStrategy"; + this.toolTip1.SetToolTip(this.cmaesRestartCheckBox, "If given False, CMA-ES will not restart.\r\nStrategy for restarting CMA-ES optimiza" + + "tion when converges to a local minimum. "); + this.cmaesRestartCheckBox.UseVisualStyleBackColor = true; + // + // cmaesUseSaparableCmaCheckBox + // + this.cmaesUseSaparableCmaCheckBox.AutoSize = true; + this.cmaesUseSaparableCmaCheckBox.Location = new System.Drawing.Point(11, 152); + this.cmaesUseSaparableCmaCheckBox.Name = "cmaesUseSaparableCmaCheckBox"; + this.cmaesUseSaparableCmaCheckBox.Size = new System.Drawing.Size(204, 27); + this.cmaesUseSaparableCmaCheckBox.TabIndex = 31; + this.cmaesUseSaparableCmaCheckBox.Text = "Use Separable CMA"; + this.toolTip1.SetToolTip(this.cmaesUseSaparableCmaCheckBox, resources.GetString("cmaesUseSaparableCmaCheckBox.ToolTip")); + this.cmaesUseSaparableCmaCheckBox.UseVisualStyleBackColor = true; + // + // cmaesNStartupTrialsLabel + // + this.cmaesNStartupTrialsLabel.AutoSize = true; + this.cmaesNStartupTrialsLabel.Location = new System.Drawing.Point(7, 7); + this.cmaesNStartupTrialsLabel.Name = "cmaesNStartupTrialsLabel"; + this.cmaesNStartupTrialsLabel.Size = new System.Drawing.Size(219, 23); + this.cmaesNStartupTrialsLabel.TabIndex = 30; + this.cmaesNStartupTrialsLabel.Text = "Number of startup trials"; + this.toolTip1.SetToolTip(this.cmaesNStartupTrialsLabel, "The independent sampling is used instead of the CMA-ES algorithm until the given " + + "number of trials finish in the same study."); + // + // cmaesNStartup + // + this.cmaesNStartup.AutoSize = true; + this.cmaesNStartup.Location = new System.Drawing.Point(7, 5); + this.cmaesNStartup.Name = "cmaesNStartup"; + this.cmaesNStartup.Size = new System.Drawing.Size(219, 23); + this.cmaesNStartup.TabIndex = 30; + this.cmaesNStartup.Text = "Number of startup trials"; + this.toolTip1.SetToolTip(this.cmaesNStartup, "The independent sampling is used instead of the CMA-ES algorithm until the given " + + "number of trials finish in the same study."); + // + // numericUpDown4 + // + this.numericUpDown4.Location = new System.Drawing.Point(258, 5); + this.numericUpDown4.Maximum = new decimal(new int[] { + 1000, + 0, + 0, + 0}); + this.numericUpDown4.Minimum = new decimal(new int[] { + 1, + 0, + 0, + 0}); + this.numericUpDown4.Name = "numericUpDown4"; + this.numericUpDown4.Size = new System.Drawing.Size(94, 30); + this.numericUpDown4.TabIndex = 29; + this.numericUpDown4.Value = new decimal(new int[] { + 1, + 0, + 0, + 0}); + // + // cmaesStartupNumUpDown + // + this.cmaesStartupNumUpDown.Location = new System.Drawing.Point(258, 3); + this.cmaesStartupNumUpDown.Maximum = new decimal(new int[] { + 1000, + 0, + 0, + 0}); + this.cmaesStartupNumUpDown.Minimum = new decimal(new int[] { + 1, + 0, + 0, + 0}); + this.cmaesStartupNumUpDown.Name = "cmaesStartupNumUpDown"; + this.cmaesStartupNumUpDown.Size = new System.Drawing.Size(94, 30); + this.cmaesStartupNumUpDown.TabIndex = 29; + this.cmaesStartupNumUpDown.Value = new decimal(new int[] { + 1, + 0, + 0, + 0}); + // + // cmaesConsiderPruneTrialsCheckBox + // + this.cmaesConsiderPruneTrialsCheckBox.AutoSize = true; + this.cmaesConsiderPruneTrialsCheckBox.Location = new System.Drawing.Point(11, 119); + this.cmaesConsiderPruneTrialsCheckBox.Name = "cmaesConsiderPruneTrialsCheckBox"; + this.cmaesConsiderPruneTrialsCheckBox.Size = new System.Drawing.Size(230, 27); + this.cmaesConsiderPruneTrialsCheckBox.TabIndex = 28; + this.cmaesConsiderPruneTrialsCheckBox.Text = "Consider Pruned Trials"; + this.toolTip1.SetToolTip(this.cmaesConsiderPruneTrialsCheckBox, "If this is True, the PRUNED trials are considered for sampling."); + this.cmaesConsiderPruneTrialsCheckBox.UseVisualStyleBackColor = true; + // + // cmaesWarnIndependentSamplingCheckBox + // + this.cmaesWarnIndependentSamplingCheckBox.AutoSize = true; + this.cmaesWarnIndependentSamplingCheckBox.Checked = true; + this.cmaesWarnIndependentSamplingCheckBox.CheckState = System.Windows.Forms.CheckState.Checked; + this.cmaesWarnIndependentSamplingCheckBox.Location = new System.Drawing.Point(11, 86); + this.cmaesWarnIndependentSamplingCheckBox.Name = "cmaesWarnIndependentSamplingCheckBox"; + this.cmaesWarnIndependentSamplingCheckBox.Size = new System.Drawing.Size(284, 27); + this.cmaesWarnIndependentSamplingCheckBox.TabIndex = 27; + this.cmaesWarnIndependentSamplingCheckBox.Text = "Warn Independent Sampling"; + this.toolTip1.SetToolTip(this.cmaesWarnIndependentSamplingCheckBox, "If this is True and multivariate=True, a warning message is emitted when the valu" + + "e of a parameter is sampled by using an independent sampler. If multivariate=Fal" + + "se, this flag has no effect."); + this.cmaesWarnIndependentSamplingCheckBox.UseVisualStyleBackColor = true; + // + // cmaesIncPopsizeLabel + // + this.cmaesIncPopsizeLabel.AutoSize = true; + this.cmaesIncPopsizeLabel.Location = new System.Drawing.Point(7, 233); + this.cmaesIncPopsizeLabel.Name = "cmaesIncPopsizeLabel"; + this.cmaesIncPopsizeLabel.Size = new System.Drawing.Size(240, 23); + this.cmaesIncPopsizeLabel.TabIndex = 26; + this.cmaesIncPopsizeLabel.Text = "Increasing Population Size"; + this.toolTip1.SetToolTip(this.cmaesIncPopsizeLabel, "Multiplier for increasing population size before each restart."); + // + // cmaesIncPopSizeUpDown + // + this.cmaesIncPopSizeUpDown.Enabled = false; + this.cmaesIncPopSizeUpDown.Location = new System.Drawing.Point(258, 231); + this.cmaesIncPopSizeUpDown.Minimum = new decimal(new int[] { + 1, + 0, + 0, + 0}); + this.cmaesIncPopSizeUpDown.Name = "cmaesIncPopSizeUpDown"; + this.cmaesIncPopSizeUpDown.Size = new System.Drawing.Size(94, 30); + this.cmaesIncPopSizeUpDown.TabIndex = 25; + this.cmaesIncPopSizeUpDown.Value = new decimal(new int[] { + 2, + 0, + 0, + 0}); + // + // cmaesSigmaCheckBox + // + this.cmaesSigmaCheckBox.AutoSize = true; + this.cmaesSigmaCheckBox.Location = new System.Drawing.Point(11, 39); + this.cmaesSigmaCheckBox.Name = "cmaesSigmaCheckBox"; + this.cmaesSigmaCheckBox.Size = new System.Drawing.Size(101, 27); + this.cmaesSigmaCheckBox.TabIndex = 24; + this.cmaesSigmaCheckBox.Text = "Sigma0"; + this.toolTip1.SetToolTip(this.cmaesSigmaCheckBox, "Initial standard deviation of CMA-ES. By default, sigma0 is set to min_range / 6," + + " where min_range denotes the minimum range of the distributions in the search sp" + + "ace."); + this.cmaesSigmaCheckBox.UseVisualStyleBackColor = true; + // + // numericUpDown2 + // + this.numericUpDown2.DecimalPlaces = 2; + this.numericUpDown2.Enabled = false; + this.numericUpDown2.Increment = new decimal(new int[] { + 1, + 0, + 0, + 131072}); + this.numericUpDown2.Location = new System.Drawing.Point(258, 39); + this.numericUpDown2.Maximum = new decimal(new int[] { + 0, + 0, + 0, + 0}); + this.numericUpDown2.Name = "numericUpDown2"; + this.numericUpDown2.Size = new System.Drawing.Size(94, 30); + this.numericUpDown2.TabIndex = 23; + // + // QMC + // + this.QMC.Controls.Add(this.qmcTypeComboBox); + this.QMC.Controls.Add(this.qmcTypeLabel); + this.QMC.Controls.Add(this.qmcWarnAsyncSeedingCheckBox); + this.QMC.Controls.Add(this.qmcScrambleCheckBox); + this.QMC.Controls.Add(this.qmcWarnIndependentSamplingcheckBox); + this.QMC.Location = new System.Drawing.Point(4, 32); + this.QMC.Name = "QMC"; + this.QMC.Size = new System.Drawing.Size(368, 335); + this.QMC.TabIndex = 4; + this.QMC.Text = "QMC"; + this.QMC.UseVisualStyleBackColor = true; + // + // qmcTypeComboBox + // + this.qmcTypeComboBox.FormattingEnabled = true; + this.qmcTypeComboBox.Items.AddRange(new object[] { + "sobol", + "halton"}); + this.qmcTypeComboBox.Location = new System.Drawing.Point(229, 10); + this.qmcTypeComboBox.Margin = new System.Windows.Forms.Padding(4, 6, 4, 6); + this.qmcTypeComboBox.Name = "qmcTypeComboBox"; + this.qmcTypeComboBox.Size = new System.Drawing.Size(135, 31); + this.qmcTypeComboBox.TabIndex = 32; + this.qmcTypeComboBox.Text = "sobol"; + // + // qmcTypeLabel + // + this.qmcTypeLabel.AutoSize = true; + this.qmcTypeLabel.Location = new System.Drawing.Point(3, 13); + this.qmcTypeLabel.Name = "qmcTypeLabel"; + this.qmcTypeLabel.Size = new System.Drawing.Size(97, 23); + this.qmcTypeLabel.TabIndex = 31; + this.qmcTypeLabel.Text = "QMC Type"; + this.toolTip1.SetToolTip(this.qmcTypeLabel, "The type of QMC sequence to be sampled. This must be one of “halton” and “sobol”." + + " "); + // + // qmcWarnAsyncSeedingCheckBox + // + this.qmcWarnAsyncSeedingCheckBox.AutoSize = true; + this.qmcWarnAsyncSeedingCheckBox.Checked = true; + this.qmcWarnAsyncSeedingCheckBox.CheckState = System.Windows.Forms.CheckState.Checked; + this.qmcWarnAsyncSeedingCheckBox.Location = new System.Drawing.Point(7, 121); + this.qmcWarnAsyncSeedingCheckBox.Name = "qmcWarnAsyncSeedingCheckBox"; + this.qmcWarnAsyncSeedingCheckBox.Size = new System.Drawing.Size(284, 27); + this.qmcWarnAsyncSeedingCheckBox.TabIndex = 30; + this.qmcWarnAsyncSeedingCheckBox.Text = "Warn Asynchronous Seeding"; + this.toolTip1.SetToolTip(this.qmcWarnAsyncSeedingCheckBox, "If this is True, a warning message is emitted when the scrambling (randomization)" + + " is applied to the QMC sequence and the random seed of the sampler is not set ma" + + "nually."); + this.qmcWarnAsyncSeedingCheckBox.UseVisualStyleBackColor = true; + // + // qmcScrambleCheckBox + // + this.qmcScrambleCheckBox.AutoSize = true; + this.qmcScrambleCheckBox.Location = new System.Drawing.Point(7, 55); + this.qmcScrambleCheckBox.Name = "qmcScrambleCheckBox"; + this.qmcScrambleCheckBox.Size = new System.Drawing.Size(116, 27); + this.qmcScrambleCheckBox.TabIndex = 29; + this.qmcScrambleCheckBox.Text = "Scramble"; + this.toolTip1.SetToolTip(this.qmcScrambleCheckBox, "If this option is True, scrambling (randomization) is applied to the QMC sequence" + + "s."); + this.qmcScrambleCheckBox.UseVisualStyleBackColor = true; + // + // qmcWarnIndependentSamplingcheckBox + // + this.qmcWarnIndependentSamplingcheckBox.AutoSize = true; + this.qmcWarnIndependentSamplingcheckBox.Checked = true; + this.qmcWarnIndependentSamplingcheckBox.CheckState = System.Windows.Forms.CheckState.Checked; + this.qmcWarnIndependentSamplingcheckBox.Location = new System.Drawing.Point(7, 88); + this.qmcWarnIndependentSamplingcheckBox.Name = "qmcWarnIndependentSamplingcheckBox"; + this.qmcWarnIndependentSamplingcheckBox.Size = new System.Drawing.Size(284, 27); + this.qmcWarnIndependentSamplingcheckBox.TabIndex = 28; + this.qmcWarnIndependentSamplingcheckBox.Text = "Warn Independent Sampling"; + this.toolTip1.SetToolTip(this.qmcWarnIndependentSamplingcheckBox, "If this is True, a warning message is emitted when the value of a parameter is sa" + + "mpled by using an independent sampler."); + this.qmcWarnIndependentSamplingcheckBox.UseVisualStyleBackColor = true; // // fileTabPage // @@ -573,6 +1241,29 @@ private void InitializeComponent() this.outputTabPage.ResumeLayout(false); this.outputTabPage.PerformLayout(); this.settingsTabPage.ResumeLayout(false); + this.settingsTabControl.ResumeLayout(false); + this.TPE.ResumeLayout(false); + this.TPE.PerformLayout(); + ((System.ComponentModel.ISupportInitialize)(this.tpeEINumUpDown)).EndInit(); + ((System.ComponentModel.ISupportInitialize)(this.tpeStartupNumUpDown)).EndInit(); + ((System.ComponentModel.ISupportInitialize)(this.tpePriorNumUpDown)).EndInit(); + this.GP.ResumeLayout(false); + this.GP.PerformLayout(); + ((System.ComponentModel.ISupportInitialize)(this.numericUpDown1)).EndInit(); + this.NSGAII.ResumeLayout(false); + this.NSGAII.PerformLayout(); + ((System.ComponentModel.ISupportInitialize)(this.nsgaPopulationSizeUpDown)).EndInit(); + ((System.ComponentModel.ISupportInitialize)(this.nsgaSwappingProbUpDown)).EndInit(); + ((System.ComponentModel.ISupportInitialize)(this.nsgaCrossoverProbUpDown)).EndInit(); + ((System.ComponentModel.ISupportInitialize)(this.nsgaMutationProbUpDown)).EndInit(); + this.CMAES.ResumeLayout(false); + this.CMAES.PerformLayout(); + ((System.ComponentModel.ISupportInitialize)(this.numericUpDown4)).EndInit(); + ((System.ComponentModel.ISupportInitialize)(this.cmaesStartupNumUpDown)).EndInit(); + ((System.ComponentModel.ISupportInitialize)(this.cmaesIncPopSizeUpDown)).EndInit(); + ((System.ComponentModel.ISupportInitialize)(this.numericUpDown2)).EndInit(); + this.QMC.ResumeLayout(false); + this.QMC.PerformLayout(); this.fileTabPage.ResumeLayout(false); this.ResumeLayout(false); @@ -599,12 +1290,6 @@ private void InitializeComponent() private System.Windows.Forms.ComboBox visualizeTypeComboBox; private System.ComponentModel.BackgroundWorker outputResultBackgroundWorker; private System.Windows.Forms.TabPage settingsTabPage; - private System.Windows.Forms.Button settingsOpenAPIPage; - private System.Windows.Forms.ComboBox settingsAPIComboBox; - private System.Windows.Forms.Button settingsFolderOpen; - private System.Windows.Forms.Label settingLabel; - private System.Windows.Forms.Button settingsFromJson; - private System.Windows.Forms.Button settingsToJson; private System.Windows.Forms.Button dashboardButton; private System.Windows.Forms.TabPage outputTabPage; private System.Windows.Forms.Button outputAllTrialsButton; @@ -621,6 +1306,52 @@ private void InitializeComponent() private System.Windows.Forms.NumericUpDown timeoutNumUpDown; private System.Windows.Forms.ToolTip toolTip1; private System.Windows.Forms.Label Timeout; + private System.Windows.Forms.TabControl settingsTabControl; + private System.Windows.Forms.TabPage TPE; + private System.Windows.Forms.TabPage GP; + private System.Windows.Forms.TabPage NSGAII; + private System.Windows.Forms.TabPage CMAES; + private System.Windows.Forms.TabPage QMC; + private System.Windows.Forms.Label tpeNEICandidatesLabel; + private System.Windows.Forms.Label tpeNStartupTrialsLabel; + private System.Windows.Forms.Label tpePriorWeightLabel; + private System.Windows.Forms.NumericUpDown tpeEINumUpDown; + private System.Windows.Forms.NumericUpDown tpeStartupNumUpDown; + private System.Windows.Forms.NumericUpDown tpePriorNumUpDown; + private System.Windows.Forms.CheckBox tpeConstantLiarCheckBox; + private System.Windows.Forms.CheckBox tpeWarnIndependentSamplingCheckBox; + private System.Windows.Forms.CheckBox tpeGroupCheckBox; + private System.Windows.Forms.CheckBox tpeMultivariateCheckBox; + private System.Windows.Forms.CheckBox tpeConsiderEndpointsCheckBox; + private System.Windows.Forms.CheckBox tpeConsiderMagicClipCheckBox; + private System.Windows.Forms.CheckBox tpeConsiderPriorCheckBox; + private System.Windows.Forms.Label botorchNStartupTrialsLabel; + private System.Windows.Forms.NumericUpDown numericUpDown1; + private System.Windows.Forms.CheckBox nsgaMutationProbCheckBox; + private System.Windows.Forms.Label nsgaPopulationSizeLabel; + private System.Windows.Forms.NumericUpDown nsgaPopulationSizeUpDown; + private System.Windows.Forms.Label nsgaSwappingProbLabel; + private System.Windows.Forms.NumericUpDown nsgaSwappingProbUpDown; + private System.Windows.Forms.Label nsgaCrossoverProbLabel; + private System.Windows.Forms.NumericUpDown nsgaCrossoverProbUpDown; + private System.Windows.Forms.NumericUpDown nsgaMutationProbUpDown; + private System.Windows.Forms.CheckBox cmaesRestartCheckBox; + private System.Windows.Forms.CheckBox cmaesUseSaparableCmaCheckBox; + private System.Windows.Forms.Label cmaesNStartupTrialsLabel; + private System.Windows.Forms.Label cmaesNStartup; + private System.Windows.Forms.NumericUpDown numericUpDown4; + private System.Windows.Forms.NumericUpDown cmaesStartupNumUpDown; + private System.Windows.Forms.CheckBox cmaesConsiderPruneTrialsCheckBox; + private System.Windows.Forms.CheckBox cmaesWarnIndependentSamplingCheckBox; + private System.Windows.Forms.Label cmaesIncPopsizeLabel; + private System.Windows.Forms.NumericUpDown cmaesIncPopSizeUpDown; + private System.Windows.Forms.CheckBox cmaesSigmaCheckBox; + private System.Windows.Forms.NumericUpDown numericUpDown2; + private System.Windows.Forms.CheckBox qmcWarnIndependentSamplingcheckBox; + private System.Windows.Forms.ComboBox qmcTypeComboBox; + private System.Windows.Forms.Label qmcTypeLabel; + private System.Windows.Forms.CheckBox qmcWarnAsyncSeedingCheckBox; + private System.Windows.Forms.CheckBox qmcScrambleCheckBox; } } diff --git a/Tunny/UI/OptimizationWindow.resx b/Tunny/UI/OptimizationWindow.resx index 1796dc55..054d2694 100644 --- a/Tunny/UI/OptimizationWindow.resx +++ b/Tunny/UI/OptimizationWindow.resx @@ -123,6 +123,11 @@ 633, 17 + + If this is True, the covariance matrix is constrained to be diagonal. +Due to reduce the model complexity, the learning rate for the covariance matrix is increased. +Consequently, this algorithm outperforms CMA-ES on separable functions. + 17, 17 diff --git a/Tunny/UI/OptimizeWindowTab/SettingsTab.cs b/Tunny/UI/OptimizeWindowTab/SettingsTab.cs index 85a8e34b..4f3091e6 100644 --- a/Tunny/UI/OptimizeWindowTab/SettingsTab.cs +++ b/Tunny/UI/OptimizeWindowTab/SettingsTab.cs @@ -6,25 +6,25 @@ namespace Tunny.UI { public partial class OptimizationWindow : Form { - private void SettingsOpenAPIPage_Click(object sender, EventArgs e) - { - int apiIndex = settingsAPIComboBox.SelectedIndex; - switch (apiIndex) - { - case 0: // TPE - Process.Start("https://optuna.readthedocs.io/en/stable/reference/generated/optuna.samplers.TPESampler.html"); - break; - case 1: // NSGA2 - Process.Start("https://optuna.readthedocs.io/en/stable/reference/generated/optuna.samplers.NSGAIISampler.html"); - break; - case 2: // CMA-ES - Process.Start("https://optuna.readthedocs.io/en/stable/reference/generated/optuna.samplers.CmaEsSampler.html"); - break; - case 3: // Random - Process.Start("https://optuna.readthedocs.io/en/stable/reference/generated/optuna.samplers.RandomSampler.html"); - break; - } - } + // private void SettingsOpenAPIPage_Click(object sender, EventArgs e) + // { + // int apiIndex = settingsAPIComboBox.SelectedIndex; + // switch (apiIndex) + // { + // case 0: // TPE + // Process.Start("https://optuna.readthedocs.io/en/stable/reference/generated/optuna.samplers.TPESampler.html"); + // break; + // case 1: // NSGA2 + // Process.Start("https://optuna.readthedocs.io/en/stable/reference/generated/optuna.samplers.NSGAIISampler.html"); + // break; + // case 2: // CMA-ES + // Process.Start("https://optuna.readthedocs.io/en/stable/reference/generated/optuna.samplers.CmaEsSampler.html"); + // break; + // case 3: // Random + // Process.Start("https://optuna.readthedocs.io/en/stable/reference/generated/optuna.samplers.RandomSampler.html"); + // break; + // } + // } private void SettingsFromJson_Click(object sender, EventArgs e) { From e008c390d69b66c238ed83a2700fd395c74d1549 Mon Sep 17 00:00:00 2001 From: hrntsm Date: Fri, 19 Aug 2022 19:02:29 +0900 Subject: [PATCH 26/65] Add sampler setting ui value initialize --- Tunny/UI/OptimizationWindow.Designer.cs | 563 ++++++++++------------ Tunny/UI/OptimizationWindow.cs | 1 + Tunny/UI/OptimizationWindow.resx | 5 +- Tunny/UI/OptimizeWindowTab/SettingsTab.cs | 100 ++-- 4 files changed, 342 insertions(+), 327 deletions(-) diff --git a/Tunny/UI/OptimizationWindow.Designer.cs b/Tunny/UI/OptimizationWindow.Designer.cs index 491b4d89..58c42830 100644 --- a/Tunny/UI/OptimizationWindow.Designer.cs +++ b/Tunny/UI/OptimizationWindow.Designer.cs @@ -77,8 +77,8 @@ private void InitializeComponent() this.tpeConsiderMagicClipCheckBox = new System.Windows.Forms.CheckBox(); this.tpeConsiderPriorCheckBox = new System.Windows.Forms.CheckBox(); this.GP = new System.Windows.Forms.TabPage(); - this.botorchNStartupTrialsLabel = new System.Windows.Forms.Label(); - this.numericUpDown1 = new System.Windows.Forms.NumericUpDown(); + this.boTorchNStartupTrialsLabel = new System.Windows.Forms.Label(); + this.boTorchStartupNumUpDown = new System.Windows.Forms.NumericUpDown(); this.NSGAII = new System.Windows.Forms.TabPage(); this.nsgaMutationProbCheckBox = new System.Windows.Forms.CheckBox(); this.nsgaPopulationSizeLabel = new System.Windows.Forms.Label(); @@ -89,24 +89,23 @@ private void InitializeComponent() this.nsgaCrossoverProbUpDown = new System.Windows.Forms.NumericUpDown(); this.nsgaMutationProbUpDown = new System.Windows.Forms.NumericUpDown(); this.CMAES = new System.Windows.Forms.TabPage(); - this.cmaesRestartCheckBox = new System.Windows.Forms.CheckBox(); - this.cmaesUseSaparableCmaCheckBox = new System.Windows.Forms.CheckBox(); - this.cmaesNStartupTrialsLabel = new System.Windows.Forms.Label(); + this.cmaEsRestartCheckBox = new System.Windows.Forms.CheckBox(); + this.cmaEsUseSaparableCmaCheckBox = new System.Windows.Forms.CheckBox(); + this.cmaEsNStartupTrialsLabel = new System.Windows.Forms.Label(); this.cmaesNStartup = new System.Windows.Forms.Label(); - this.numericUpDown4 = new System.Windows.Forms.NumericUpDown(); - this.cmaesStartupNumUpDown = new System.Windows.Forms.NumericUpDown(); - this.cmaesConsiderPruneTrialsCheckBox = new System.Windows.Forms.CheckBox(); - this.cmaesWarnIndependentSamplingCheckBox = new System.Windows.Forms.CheckBox(); - this.cmaesIncPopsizeLabel = new System.Windows.Forms.Label(); - this.cmaesIncPopSizeUpDown = new System.Windows.Forms.NumericUpDown(); - this.cmaesSigmaCheckBox = new System.Windows.Forms.CheckBox(); - this.numericUpDown2 = new System.Windows.Forms.NumericUpDown(); + this.cmaEsStartupNumUpDown = new System.Windows.Forms.NumericUpDown(); + this.cmaEsConsiderPruneTrialsCheckBox = new System.Windows.Forms.CheckBox(); + this.cmaEsWarnIndependentSamplingCheckBox = new System.Windows.Forms.CheckBox(); + this.cmaEsIncPopsizeLabel = new System.Windows.Forms.Label(); + this.cmaEsIncPopSizeUpDown = new System.Windows.Forms.NumericUpDown(); + this.cmaEsSigmaCheckBox = new System.Windows.Forms.CheckBox(); + this.cmaEsSigmaNumUpDown = new System.Windows.Forms.NumericUpDown(); this.QMC = new System.Windows.Forms.TabPage(); this.qmcTypeComboBox = new System.Windows.Forms.ComboBox(); this.qmcTypeLabel = new System.Windows.Forms.Label(); this.qmcWarnAsyncSeedingCheckBox = new System.Windows.Forms.CheckBox(); this.qmcScrambleCheckBox = new System.Windows.Forms.CheckBox(); - this.qmcWarnIndependentSamplingcheckBox = new System.Windows.Forms.CheckBox(); + this.qmcWarnIndependentSamplingCheckBox = new System.Windows.Forms.CheckBox(); this.fileTabPage = new System.Windows.Forms.TabPage(); this.openResultFolderButton = new System.Windows.Forms.Button(); this.clearResultButton = new System.Windows.Forms.Button(); @@ -125,24 +124,23 @@ private void InitializeComponent() ((System.ComponentModel.ISupportInitialize)(this.tpeStartupNumUpDown)).BeginInit(); ((System.ComponentModel.ISupportInitialize)(this.tpePriorNumUpDown)).BeginInit(); this.GP.SuspendLayout(); - ((System.ComponentModel.ISupportInitialize)(this.numericUpDown1)).BeginInit(); + ((System.ComponentModel.ISupportInitialize)(this.boTorchStartupNumUpDown)).BeginInit(); this.NSGAII.SuspendLayout(); ((System.ComponentModel.ISupportInitialize)(this.nsgaPopulationSizeUpDown)).BeginInit(); ((System.ComponentModel.ISupportInitialize)(this.nsgaSwappingProbUpDown)).BeginInit(); ((System.ComponentModel.ISupportInitialize)(this.nsgaCrossoverProbUpDown)).BeginInit(); ((System.ComponentModel.ISupportInitialize)(this.nsgaMutationProbUpDown)).BeginInit(); this.CMAES.SuspendLayout(); - ((System.ComponentModel.ISupportInitialize)(this.numericUpDown4)).BeginInit(); - ((System.ComponentModel.ISupportInitialize)(this.cmaesStartupNumUpDown)).BeginInit(); - ((System.ComponentModel.ISupportInitialize)(this.cmaesIncPopSizeUpDown)).BeginInit(); - ((System.ComponentModel.ISupportInitialize)(this.numericUpDown2)).BeginInit(); + ((System.ComponentModel.ISupportInitialize)(this.cmaEsStartupNumUpDown)).BeginInit(); + ((System.ComponentModel.ISupportInitialize)(this.cmaEsIncPopSizeUpDown)).BeginInit(); + ((System.ComponentModel.ISupportInitialize)(this.cmaEsSigmaNumUpDown)).BeginInit(); this.QMC.SuspendLayout(); this.fileTabPage.SuspendLayout(); this.SuspendLayout(); // // optimizeRunButton // - this.optimizeRunButton.Location = new System.Drawing.Point(20, 252); + this.optimizeRunButton.Location = new System.Drawing.Point(20, 277); this.optimizeRunButton.Margin = new System.Windows.Forms.Padding(4, 6, 4, 6); this.optimizeRunButton.Name = "optimizeRunButton"; this.optimizeRunButton.Size = new System.Drawing.Size(180, 44); @@ -154,10 +152,10 @@ private void InitializeComponent() // optimizeStopButton // this.optimizeStopButton.Enabled = false; - this.optimizeStopButton.Location = new System.Drawing.Point(232, 252); + this.optimizeStopButton.Location = new System.Drawing.Point(246, 277); this.optimizeStopButton.Margin = new System.Windows.Forms.Padding(4, 6, 4, 6); this.optimizeStopButton.Name = "optimizeStopButton"; - this.optimizeStopButton.Size = new System.Drawing.Size(130, 44); + this.optimizeStopButton.Size = new System.Drawing.Size(163, 44); this.optimizeStopButton.TabIndex = 1; this.optimizeStopButton.Text = "Stop"; this.optimizeStopButton.UseVisualStyleBackColor = true; @@ -165,7 +163,7 @@ private void InitializeComponent() // // nTrialNumUpDown // - this.nTrialNumUpDown.Location = new System.Drawing.Point(196, 60); + this.nTrialNumUpDown.Location = new System.Drawing.Point(246, 61); this.nTrialNumUpDown.Margin = new System.Windows.Forms.Padding(4, 6, 4, 6); this.nTrialNumUpDown.Maximum = new decimal(new int[] { 10000, @@ -197,7 +195,7 @@ private void InitializeComponent() this.loadIfExistsCheckBox.AutoSize = true; this.loadIfExistsCheckBox.Checked = true; this.loadIfExistsCheckBox.CheckState = System.Windows.Forms.CheckState.Checked; - this.loadIfExistsCheckBox.Location = new System.Drawing.Point(19, 156); + this.loadIfExistsCheckBox.Location = new System.Drawing.Point(19, 169); this.loadIfExistsCheckBox.Margin = new System.Windows.Forms.Padding(4, 6, 4, 6); this.loadIfExistsCheckBox.Name = "loadIfExistsCheckBox"; this.loadIfExistsCheckBox.Size = new System.Drawing.Size(237, 27); @@ -207,10 +205,10 @@ private void InitializeComponent() // // optimizeProgressBar // - this.optimizeProgressBar.Location = new System.Drawing.Point(20, 308); + this.optimizeProgressBar.Location = new System.Drawing.Point(20, 333); this.optimizeProgressBar.Margin = new System.Windows.Forms.Padding(4, 6, 4, 6); this.optimizeProgressBar.Name = "optimizeProgressBar"; - this.optimizeProgressBar.Size = new System.Drawing.Size(340, 42); + this.optimizeProgressBar.Size = new System.Drawing.Size(389, 42); this.optimizeProgressBar.TabIndex = 6; // // samplerComboBox @@ -224,10 +222,10 @@ private void InitializeComponent() "Quasi-MonteCarlo", "Random", "Grid"}); - this.samplerComboBox.Location = new System.Drawing.Point(104, 12); + this.samplerComboBox.Location = new System.Drawing.Point(104, 13); this.samplerComboBox.Margin = new System.Windows.Forms.Padding(4, 6, 4, 6); this.samplerComboBox.Name = "samplerComboBox"; - this.samplerComboBox.Size = new System.Drawing.Size(258, 31); + this.samplerComboBox.Size = new System.Drawing.Size(305, 31); this.samplerComboBox.TabIndex = 7; // // samplerTypeText @@ -243,7 +241,7 @@ private void InitializeComponent() // studyNameLabel // this.studyNameLabel.AutoSize = true; - this.studyNameLabel.Location = new System.Drawing.Point(14, 193); + this.studyNameLabel.Location = new System.Drawing.Point(14, 206); this.studyNameLabel.Margin = new System.Windows.Forms.Padding(4, 0, 4, 0); this.studyNameLabel.Name = "studyNameLabel"; this.studyNameLabel.Size = new System.Drawing.Size(116, 23); @@ -252,10 +250,10 @@ private void InitializeComponent() // // studyNameTextBox // - this.studyNameTextBox.Location = new System.Drawing.Point(151, 187); + this.studyNameTextBox.Location = new System.Drawing.Point(211, 203); this.studyNameTextBox.Margin = new System.Windows.Forms.Padding(4, 6, 4, 6); this.studyNameTextBox.Name = "studyNameTextBox"; - this.studyNameTextBox.Size = new System.Drawing.Size(205, 30); + this.studyNameTextBox.Size = new System.Drawing.Size(198, 30); this.studyNameTextBox.TabIndex = 10; this.studyNameTextBox.Text = "study1"; // @@ -266,12 +264,12 @@ private void InitializeComponent() this.optimizeTabControl.Controls.Add(this.outputTabPage); this.optimizeTabControl.Controls.Add(this.settingsTabPage); this.optimizeTabControl.Controls.Add(this.fileTabPage); - this.optimizeTabControl.Location = new System.Drawing.Point(21, 22); + this.optimizeTabControl.Location = new System.Drawing.Point(0, -1); this.optimizeTabControl.Margin = new System.Windows.Forms.Padding(4, 6, 4, 6); this.optimizeTabControl.Multiline = true; this.optimizeTabControl.Name = "optimizeTabControl"; this.optimizeTabControl.SelectedIndex = 0; - this.optimizeTabControl.Size = new System.Drawing.Size(387, 438); + this.optimizeTabControl.Size = new System.Drawing.Size(428, 476); this.optimizeTabControl.TabIndex = 11; // // optimizeTabPage @@ -288,18 +286,18 @@ private void InitializeComponent() this.optimizeTabPage.Controls.Add(this.optimizeProgressBar); this.optimizeTabPage.Controls.Add(this.nTrialText); this.optimizeTabPage.Controls.Add(this.loadIfExistsCheckBox); - this.optimizeTabPage.Location = new System.Drawing.Point(4, 60); + this.optimizeTabPage.Location = new System.Drawing.Point(4, 32); this.optimizeTabPage.Margin = new System.Windows.Forms.Padding(4, 6, 4, 6); this.optimizeTabPage.Name = "optimizeTabPage"; this.optimizeTabPage.Padding = new System.Windows.Forms.Padding(4, 6, 4, 6); - this.optimizeTabPage.Size = new System.Drawing.Size(379, 374); + this.optimizeTabPage.Size = new System.Drawing.Size(420, 440); this.optimizeTabPage.TabIndex = 0; this.optimizeTabPage.Text = "Optimize"; this.optimizeTabPage.UseVisualStyleBackColor = true; // // timeoutNumUpDown // - this.timeoutNumUpDown.Location = new System.Drawing.Point(197, 102); + this.timeoutNumUpDown.Location = new System.Drawing.Point(246, 100); this.timeoutNumUpDown.Margin = new System.Windows.Forms.Padding(4, 6, 4, 6); this.timeoutNumUpDown.Maximum = new decimal(new int[] { 10000000, @@ -307,7 +305,7 @@ private void InitializeComponent() 0, 0}); this.timeoutNumUpDown.Name = "timeoutNumUpDown"; - this.timeoutNumUpDown.Size = new System.Drawing.Size(165, 30); + this.timeoutNumUpDown.Size = new System.Drawing.Size(163, 30); this.timeoutNumUpDown.TabIndex = 12; this.timeoutNumUpDown.ThousandsSeparator = true; this.toolTip1.SetToolTip(this.timeoutNumUpDown, "After this time has elapsed, optimization stops.\r\nIf 0 is entered, no stop by tim" + @@ -329,18 +327,18 @@ private void InitializeComponent() this.visualizeTabPage.Controls.Add(this.visualizeButton); this.visualizeTabPage.Controls.Add(this.visualizeTypeLabel); this.visualizeTabPage.Controls.Add(this.visualizeTypeComboBox); - this.visualizeTabPage.Location = new System.Drawing.Point(4, 60); + this.visualizeTabPage.Location = new System.Drawing.Point(4, 32); this.visualizeTabPage.Margin = new System.Windows.Forms.Padding(4, 6, 4, 6); this.visualizeTabPage.Name = "visualizeTabPage"; this.visualizeTabPage.Padding = new System.Windows.Forms.Padding(4, 6, 4, 6); - this.visualizeTabPage.Size = new System.Drawing.Size(379, 374); + this.visualizeTabPage.Size = new System.Drawing.Size(420, 440); this.visualizeTabPage.TabIndex = 1; this.visualizeTabPage.Text = "Visualize"; this.visualizeTabPage.UseVisualStyleBackColor = true; // // dashboardButton // - this.dashboardButton.Location = new System.Drawing.Point(33, 36); + this.dashboardButton.Location = new System.Drawing.Point(54, 40); this.dashboardButton.Margin = new System.Windows.Forms.Padding(4); this.dashboardButton.Name = "dashboardButton"; this.dashboardButton.Size = new System.Drawing.Size(323, 39); @@ -351,7 +349,7 @@ private void InitializeComponent() // // visualizeButton // - this.visualizeButton.Location = new System.Drawing.Point(33, 203); + this.visualizeButton.Location = new System.Drawing.Point(54, 207); this.visualizeButton.Margin = new System.Windows.Forms.Padding(4, 6, 4, 6); this.visualizeButton.Name = "visualizeButton"; this.visualizeButton.Size = new System.Drawing.Size(323, 39); @@ -363,7 +361,7 @@ private void InitializeComponent() // visualizeTypeLabel // this.visualizeTypeLabel.AutoSize = true; - this.visualizeTypeLabel.Location = new System.Drawing.Point(4, 121); + this.visualizeTypeLabel.Location = new System.Drawing.Point(25, 125); this.visualizeTypeLabel.Margin = new System.Windows.Forms.Padding(4, 0, 4, 0); this.visualizeTypeLabel.Name = "visualizeTypeLabel"; this.visualizeTypeLabel.Size = new System.Drawing.Size(130, 23); @@ -383,7 +381,7 @@ private void InitializeComponent() "pareto front", "slice", "hypervolume"}); - this.visualizeTypeComboBox.Location = new System.Drawing.Point(33, 160); + this.visualizeTypeComboBox.Location = new System.Drawing.Point(54, 164); this.visualizeTypeComboBox.Margin = new System.Windows.Forms.Padding(4, 6, 4, 6); this.visualizeTypeComboBox.Name = "visualizeTypeComboBox"; this.visualizeTypeComboBox.Size = new System.Drawing.Size(323, 31); @@ -399,17 +397,17 @@ private void InitializeComponent() this.outputTabPage.Controls.Add(this.outputModelNumberButton); this.outputTabPage.Controls.Add(this.outputModelNumTextBox); this.outputTabPage.Controls.Add(this.outputModelLabel); - this.outputTabPage.Location = new System.Drawing.Point(4, 60); + this.outputTabPage.Location = new System.Drawing.Point(4, 32); this.outputTabPage.Name = "outputTabPage"; this.outputTabPage.Padding = new System.Windows.Forms.Padding(3); - this.outputTabPage.Size = new System.Drawing.Size(379, 374); + this.outputTabPage.Size = new System.Drawing.Size(420, 440); this.outputTabPage.TabIndex = 3; this.outputTabPage.Text = "Output"; this.outputTabPage.UseVisualStyleBackColor = true; // // outputAllTrialsButton // - this.outputAllTrialsButton.Location = new System.Drawing.Point(35, 74); + this.outputAllTrialsButton.Location = new System.Drawing.Point(64, 76); this.outputAllTrialsButton.Margin = new System.Windows.Forms.Padding(4); this.outputAllTrialsButton.Name = "outputAllTrialsButton"; this.outputAllTrialsButton.Size = new System.Drawing.Size(297, 34); @@ -420,7 +418,7 @@ private void InitializeComponent() // // outputParatoSolutionButton // - this.outputParatoSolutionButton.Location = new System.Drawing.Point(35, 22); + this.outputParatoSolutionButton.Location = new System.Drawing.Point(64, 24); this.outputParatoSolutionButton.Margin = new System.Windows.Forms.Padding(4); this.outputParatoSolutionButton.Name = "outputParatoSolutionButton"; this.outputParatoSolutionButton.Size = new System.Drawing.Size(297, 34); @@ -431,7 +429,7 @@ private void InitializeComponent() // // reflectToSliderButton // - this.reflectToSliderButton.Location = new System.Drawing.Point(35, 230); + this.reflectToSliderButton.Location = new System.Drawing.Point(64, 232); this.reflectToSliderButton.Margin = new System.Windows.Forms.Padding(4); this.reflectToSliderButton.Name = "reflectToSliderButton"; this.reflectToSliderButton.Size = new System.Drawing.Size(325, 41); @@ -443,7 +441,7 @@ private void InitializeComponent() // outputStopButton // this.outputStopButton.Enabled = false; - this.outputStopButton.Location = new System.Drawing.Point(297, 320); + this.outputStopButton.Location = new System.Drawing.Point(326, 322); this.outputStopButton.Margin = new System.Windows.Forms.Padding(4); this.outputStopButton.Name = "outputStopButton"; this.outputStopButton.Size = new System.Drawing.Size(75, 40); @@ -454,7 +452,7 @@ private void InitializeComponent() // // outputProgressBar // - this.outputProgressBar.Location = new System.Drawing.Point(35, 320); + this.outputProgressBar.Location = new System.Drawing.Point(64, 322); this.outputProgressBar.Margin = new System.Windows.Forms.Padding(4, 6, 4, 6); this.outputProgressBar.Name = "outputProgressBar"; this.outputProgressBar.Size = new System.Drawing.Size(238, 40); @@ -462,7 +460,7 @@ private void InitializeComponent() // // outputModelNumberButton // - this.outputModelNumberButton.Location = new System.Drawing.Point(243, 179); + this.outputModelNumberButton.Location = new System.Drawing.Point(272, 181); this.outputModelNumberButton.Margin = new System.Windows.Forms.Padding(4); this.outputModelNumberButton.Name = "outputModelNumberButton"; this.outputModelNumberButton.Size = new System.Drawing.Size(117, 30); @@ -473,7 +471,7 @@ private void InitializeComponent() // // outputModelNumTextBox // - this.outputModelNumTextBox.Location = new System.Drawing.Point(35, 179); + this.outputModelNumTextBox.Location = new System.Drawing.Point(64, 181); this.outputModelNumTextBox.Margin = new System.Windows.Forms.Padding(4); this.outputModelNumTextBox.Name = "outputModelNumTextBox"; this.outputModelNumTextBox.Size = new System.Drawing.Size(200, 30); @@ -483,7 +481,7 @@ private void InitializeComponent() // outputModelLabel // this.outputModelLabel.AutoSize = true; - this.outputModelLabel.Location = new System.Drawing.Point(38, 152); + this.outputModelLabel.Location = new System.Drawing.Point(67, 154); this.outputModelLabel.Margin = new System.Windows.Forms.Padding(4, 0, 4, 0); this.outputModelLabel.Name = "outputModelLabel"; this.outputModelLabel.Size = new System.Drawing.Size(175, 23); @@ -493,10 +491,10 @@ private void InitializeComponent() // settingsTabPage // this.settingsTabPage.Controls.Add(this.settingsTabControl); - this.settingsTabPage.Location = new System.Drawing.Point(4, 60); + this.settingsTabPage.Location = new System.Drawing.Point(4, 32); this.settingsTabPage.Margin = new System.Windows.Forms.Padding(4); this.settingsTabPage.Name = "settingsTabPage"; - this.settingsTabPage.Size = new System.Drawing.Size(379, 374); + this.settingsTabPage.Size = new System.Drawing.Size(420, 440); this.settingsTabPage.TabIndex = 2; this.settingsTabPage.Text = "Settings"; this.settingsTabPage.UseVisualStyleBackColor = true; @@ -511,7 +509,7 @@ private void InitializeComponent() this.settingsTabControl.Location = new System.Drawing.Point(3, 3); this.settingsTabControl.Name = "settingsTabControl"; this.settingsTabControl.SelectedIndex = 0; - this.settingsTabControl.Size = new System.Drawing.Size(376, 371); + this.settingsTabControl.Size = new System.Drawing.Size(414, 429); this.settingsTabControl.TabIndex = 0; // // TPE @@ -532,7 +530,7 @@ private void InitializeComponent() this.TPE.Location = new System.Drawing.Point(4, 32); this.TPE.Name = "TPE"; this.TPE.Padding = new System.Windows.Forms.Padding(3); - this.TPE.Size = new System.Drawing.Size(368, 335); + this.TPE.Size = new System.Drawing.Size(406, 393); this.TPE.TabIndex = 0; this.TPE.Text = "TPE"; this.toolTip1.SetToolTip(this.TPE, "aa"); @@ -547,7 +545,7 @@ private void InitializeComponent() this.tpeNEICandidatesLabel.Size = new System.Drawing.Size(225, 23); this.tpeNEICandidatesLabel.TabIndex = 12; this.tpeNEICandidatesLabel.Text = "Number of EI candidates"; - this.toolTip1.SetToolTip(this.tpeNEICandidatesLabel, "Number of candidate samples used to calculate the expected improvement."); + this.toolTip1.SetToolTip(this.tpeNEICandidatesLabel, "Number of candidate samples used to calculate\r\nthe expected improvement."); // // tpeNStartupTrialsLabel // @@ -557,8 +555,8 @@ private void InitializeComponent() this.tpeNStartupTrialsLabel.Size = new System.Drawing.Size(219, 23); this.tpeNStartupTrialsLabel.TabIndex = 11; this.tpeNStartupTrialsLabel.Text = "Number of startup trials"; - this.toolTip1.SetToolTip(this.tpeNStartupTrialsLabel, "The random sampling is used instead of the TPE algorithm until the given number o" + - "f trials finish in the same study."); + this.toolTip1.SetToolTip(this.tpeNStartupTrialsLabel, "The random sampling is used instead of the TPE algorithm\r\nuntil the given number " + + "of trials finish in the same study."); // // tpePriorWeightLabel // @@ -572,7 +570,7 @@ private void InitializeComponent() // // tpeEINumUpDown // - this.tpeEINumUpDown.Location = new System.Drawing.Point(253, 42); + this.tpeEINumUpDown.Location = new System.Drawing.Point(306, 42); this.tpeEINumUpDown.Minimum = new decimal(new int[] { 1, 0, @@ -589,7 +587,7 @@ private void InitializeComponent() // // tpeStartupNumUpDown // - this.tpeStartupNumUpDown.Location = new System.Drawing.Point(253, 6); + this.tpeStartupNumUpDown.Location = new System.Drawing.Point(306, 6); this.tpeStartupNumUpDown.Maximum = new decimal(new int[] { 1000, 0, @@ -617,7 +615,7 @@ private void InitializeComponent() 0, 0, 65536}); - this.tpePriorNumUpDown.Location = new System.Drawing.Point(253, 78); + this.tpePriorNumUpDown.Location = new System.Drawing.Point(306, 78); this.tpePriorNumUpDown.Name = "tpePriorNumUpDown"; this.tpePriorNumUpDown.Size = new System.Drawing.Size(94, 30); this.tpePriorNumUpDown.TabIndex = 7; @@ -630,13 +628,13 @@ private void InitializeComponent() // tpeConstantLiarCheckBox // this.tpeConstantLiarCheckBox.AutoSize = true; - this.tpeConstantLiarCheckBox.Location = new System.Drawing.Point(210, 203); + this.tpeConstantLiarCheckBox.Location = new System.Drawing.Point(241, 203); this.tpeConstantLiarCheckBox.Name = "tpeConstantLiarCheckBox"; this.tpeConstantLiarCheckBox.Size = new System.Drawing.Size(152, 27); this.tpeConstantLiarCheckBox.TabIndex = 6; this.tpeConstantLiarCheckBox.Text = "Constant Liar"; - this.toolTip1.SetToolTip(this.tpeConstantLiarCheckBox, "If True, penalize running trials to avoid suggesting parameter configurations nea" + - "rby."); + this.toolTip1.SetToolTip(this.tpeConstantLiarCheckBox, "If True, \r\npenalize running trials to avoid suggesting parameter configurations n" + + "earby."); this.tpeConstantLiarCheckBox.UseVisualStyleBackColor = true; // // tpeWarnIndependentSamplingCheckBox @@ -649,33 +647,33 @@ private void InitializeComponent() this.tpeWarnIndependentSamplingCheckBox.Size = new System.Drawing.Size(284, 27); this.tpeWarnIndependentSamplingCheckBox.TabIndex = 5; this.tpeWarnIndependentSamplingCheckBox.Text = "Warn Independent Sampling"; - this.toolTip1.SetToolTip(this.tpeWarnIndependentSamplingCheckBox, "If this is True and multivariate=True, a warning message is emitted when the valu" + - "e of a parameter is sampled by using an independent sampler. If multivariate=Fal" + - "se, this flag has no effect."); + this.toolTip1.SetToolTip(this.tpeWarnIndependentSamplingCheckBox, "If this is True and multivariate=True, \r\na warning message is emitted\r\nwhen the v" + + "alue of a parameter is sampled by using an independent sampler. \r\nIf multivariat" + + "e=False, this flag has no effect."); this.tpeWarnIndependentSamplingCheckBox.UseVisualStyleBackColor = true; // // tpeGroupCheckBox // this.tpeGroupCheckBox.AutoSize = true; - this.tpeGroupCheckBox.Location = new System.Drawing.Point(210, 170); + this.tpeGroupCheckBox.Location = new System.Drawing.Point(241, 170); this.tpeGroupCheckBox.Name = "tpeGroupCheckBox"; this.tpeGroupCheckBox.Size = new System.Drawing.Size(89, 27); this.tpeGroupCheckBox.TabIndex = 4; this.tpeGroupCheckBox.Text = "Group"; - this.toolTip1.SetToolTip(this.tpeGroupCheckBox, "If this and multivariate are True, the multivariate TPE with the group decomposed" + - " search space is used when suggesting parameters. "); + this.toolTip1.SetToolTip(this.tpeGroupCheckBox, "If this and multivariate are True,\r\nthe multivariate TPE with the group decompose" + + "d search space\r\nis used when suggesting parameters. "); this.tpeGroupCheckBox.UseVisualStyleBackColor = true; // // tpeMultivariateCheckBox // this.tpeMultivariateCheckBox.AutoSize = true; - this.tpeMultivariateCheckBox.Location = new System.Drawing.Point(210, 137); + this.tpeMultivariateCheckBox.Location = new System.Drawing.Point(241, 137); this.tpeMultivariateCheckBox.Name = "tpeMultivariateCheckBox"; this.tpeMultivariateCheckBox.Size = new System.Drawing.Size(137, 27); this.tpeMultivariateCheckBox.TabIndex = 3; this.tpeMultivariateCheckBox.Text = "Maltivariate"; - this.toolTip1.SetToolTip(this.tpeMultivariateCheckBox, "If this is True, the multivariate TPE is used when suggesting parameters. The mul" + - "tivariate TPE is reported to outperform the independent TPE."); + this.toolTip1.SetToolTip(this.tpeMultivariateCheckBox, "If this is True, \r\nthe multivariate TPE is used when suggesting parameters. \r\nThe" + + " multivariate TPE is reported to outperform the independent TPE."); this.tpeMultivariateCheckBox.UseVisualStyleBackColor = true; // // tpeConsiderEndpointsCheckBox @@ -686,8 +684,8 @@ private void InitializeComponent() this.tpeConsiderEndpointsCheckBox.Size = new System.Drawing.Size(205, 27); this.tpeConsiderEndpointsCheckBox.TabIndex = 2; this.tpeConsiderEndpointsCheckBox.Text = "Consider Endpoints"; - this.toolTip1.SetToolTip(this.tpeConsiderEndpointsCheckBox, "Take endpoints of domains into account when calculating variances of Gaussians in" + - " Parzen estimator."); + this.toolTip1.SetToolTip(this.tpeConsiderEndpointsCheckBox, "Take endpoints of domains into account\r\nwhen calculating variances of Gaussians i" + + "n Parzen estimator."); this.tpeConsiderEndpointsCheckBox.UseVisualStyleBackColor = true; // // tpeConsiderMagicClipCheckBox @@ -720,44 +718,44 @@ private void InitializeComponent() // // GP // - this.GP.Controls.Add(this.botorchNStartupTrialsLabel); - this.GP.Controls.Add(this.numericUpDown1); + this.GP.Controls.Add(this.boTorchNStartupTrialsLabel); + this.GP.Controls.Add(this.boTorchStartupNumUpDown); this.GP.Location = new System.Drawing.Point(4, 32); this.GP.Name = "GP"; this.GP.Padding = new System.Windows.Forms.Padding(3); - this.GP.Size = new System.Drawing.Size(368, 335); + this.GP.Size = new System.Drawing.Size(406, 393); this.GP.TabIndex = 1; this.GP.Text = "GP"; this.GP.UseVisualStyleBackColor = true; // - // botorchNStartupTrialsLabel + // boTorchNStartupTrialsLabel // - this.botorchNStartupTrialsLabel.AutoSize = true; - this.botorchNStartupTrialsLabel.Location = new System.Drawing.Point(6, 8); - this.botorchNStartupTrialsLabel.Name = "botorchNStartupTrialsLabel"; - this.botorchNStartupTrialsLabel.Size = new System.Drawing.Size(219, 23); - this.botorchNStartupTrialsLabel.TabIndex = 13; - this.botorchNStartupTrialsLabel.Text = "Number of startup trials"; - this.toolTip1.SetToolTip(this.botorchNStartupTrialsLabel, "Number of initial trials, that is the number of trials to resort to independent s" + + this.boTorchNStartupTrialsLabel.AutoSize = true; + this.boTorchNStartupTrialsLabel.Location = new System.Drawing.Point(6, 8); + this.boTorchNStartupTrialsLabel.Name = "boTorchNStartupTrialsLabel"; + this.boTorchNStartupTrialsLabel.Size = new System.Drawing.Size(219, 23); + this.boTorchNStartupTrialsLabel.TabIndex = 13; + this.boTorchNStartupTrialsLabel.Text = "Number of startup trials"; + this.toolTip1.SetToolTip(this.boTorchNStartupTrialsLabel, "Number of initial trials, that is the number of trials to resort to independent s" + "ampling."); // - // numericUpDown1 + // boTorchStartupNumUpDown // - this.numericUpDown1.Location = new System.Drawing.Point(254, 6); - this.numericUpDown1.Maximum = new decimal(new int[] { + this.boTorchStartupNumUpDown.Location = new System.Drawing.Point(306, 6); + this.boTorchStartupNumUpDown.Maximum = new decimal(new int[] { 1000, 0, 0, 0}); - this.numericUpDown1.Minimum = new decimal(new int[] { + this.boTorchStartupNumUpDown.Minimum = new decimal(new int[] { 1, 0, 0, 0}); - this.numericUpDown1.Name = "numericUpDown1"; - this.numericUpDown1.Size = new System.Drawing.Size(94, 30); - this.numericUpDown1.TabIndex = 12; - this.numericUpDown1.Value = new decimal(new int[] { + this.boTorchStartupNumUpDown.Name = "boTorchStartupNumUpDown"; + this.boTorchStartupNumUpDown.Size = new System.Drawing.Size(94, 30); + this.boTorchStartupNumUpDown.TabIndex = 12; + this.boTorchStartupNumUpDown.Value = new decimal(new int[] { 10, 0, 0, @@ -775,7 +773,7 @@ private void InitializeComponent() this.NSGAII.Controls.Add(this.nsgaMutationProbUpDown); this.NSGAII.Location = new System.Drawing.Point(4, 32); this.NSGAII.Name = "NSGAII"; - this.NSGAII.Size = new System.Drawing.Size(368, 335); + this.NSGAII.Size = new System.Drawing.Size(406, 393); this.NSGAII.TabIndex = 3; this.NSGAII.Text = "NSGAII"; this.NSGAII.UseVisualStyleBackColor = true; @@ -788,8 +786,9 @@ private void InitializeComponent() this.nsgaMutationProbCheckBox.Size = new System.Drawing.Size(212, 27); this.nsgaMutationProbCheckBox.TabIndex = 22; this.nsgaMutationProbCheckBox.Text = "Mutation Probability"; - this.toolTip1.SetToolTip(this.nsgaMutationProbCheckBox, "If False, the solver automatically calculates mutation probability."); + this.toolTip1.SetToolTip(this.nsgaMutationProbCheckBox, "If False, \r\nthe solver automatically calculates mutation probability."); this.nsgaMutationProbCheckBox.UseVisualStyleBackColor = true; + this.nsgaMutationProbCheckBox.CheckedChanged += new System.EventHandler(this.NsgaMutationProbCheckedChanged); // // nsgaPopulationSizeLabel // @@ -803,7 +802,7 @@ private void InitializeComponent() // // nsgaPopulationSizeUpDown // - this.nsgaPopulationSizeUpDown.Location = new System.Drawing.Point(257, 115); + this.nsgaPopulationSizeUpDown.Location = new System.Drawing.Point(309, 115); this.nsgaPopulationSizeUpDown.Maximum = new decimal(new int[] { 1000, 0, @@ -841,7 +840,7 @@ private void InitializeComponent() 0, 0, 131072}); - this.nsgaSwappingProbUpDown.Location = new System.Drawing.Point(257, 79); + this.nsgaSwappingProbUpDown.Location = new System.Drawing.Point(309, 79); this.nsgaSwappingProbUpDown.Maximum = new decimal(new int[] { 1, 0, @@ -864,8 +863,8 @@ private void InitializeComponent() this.nsgaCrossoverProbLabel.Size = new System.Drawing.Size(195, 23); this.nsgaCrossoverProbLabel.TabIndex = 17; this.nsgaCrossoverProbLabel.Text = "Crossover Probability"; - this.toolTip1.SetToolTip(this.nsgaCrossoverProbLabel, "Probability that a crossover (parameters swapping between parents) will occur whe" + - "n creating a new individual."); + this.toolTip1.SetToolTip(this.nsgaCrossoverProbLabel, "Probability that a crossover (parameters swapping between parents)\r\nwill occur wh" + + "en creating a new individual."); // // nsgaCrossoverProbUpDown // @@ -875,7 +874,7 @@ private void InitializeComponent() 0, 0, 131072}); - this.nsgaCrossoverProbUpDown.Location = new System.Drawing.Point(257, 43); + this.nsgaCrossoverProbUpDown.Location = new System.Drawing.Point(309, 43); this.nsgaCrossoverProbUpDown.Maximum = new decimal(new int[] { 1, 0, @@ -899,9 +898,9 @@ private void InitializeComponent() 0, 0, 131072}); - this.nsgaMutationProbUpDown.Location = new System.Drawing.Point(257, 7); + this.nsgaMutationProbUpDown.Location = new System.Drawing.Point(309, 7); this.nsgaMutationProbUpDown.Maximum = new decimal(new int[] { - 0, + 1, 0, 0, 0}); @@ -911,58 +910,58 @@ private void InitializeComponent() // // CMAES // - this.CMAES.Controls.Add(this.cmaesRestartCheckBox); - this.CMAES.Controls.Add(this.cmaesUseSaparableCmaCheckBox); - this.CMAES.Controls.Add(this.cmaesNStartupTrialsLabel); + this.CMAES.Controls.Add(this.cmaEsRestartCheckBox); + this.CMAES.Controls.Add(this.cmaEsUseSaparableCmaCheckBox); + this.CMAES.Controls.Add(this.cmaEsNStartupTrialsLabel); this.CMAES.Controls.Add(this.cmaesNStartup); - this.CMAES.Controls.Add(this.numericUpDown4); - this.CMAES.Controls.Add(this.cmaesStartupNumUpDown); - this.CMAES.Controls.Add(this.cmaesConsiderPruneTrialsCheckBox); - this.CMAES.Controls.Add(this.cmaesWarnIndependentSamplingCheckBox); - this.CMAES.Controls.Add(this.cmaesIncPopsizeLabel); - this.CMAES.Controls.Add(this.cmaesIncPopSizeUpDown); - this.CMAES.Controls.Add(this.cmaesSigmaCheckBox); - this.CMAES.Controls.Add(this.numericUpDown2); + this.CMAES.Controls.Add(this.cmaEsStartupNumUpDown); + this.CMAES.Controls.Add(this.cmaEsConsiderPruneTrialsCheckBox); + this.CMAES.Controls.Add(this.cmaEsWarnIndependentSamplingCheckBox); + this.CMAES.Controls.Add(this.cmaEsIncPopsizeLabel); + this.CMAES.Controls.Add(this.cmaEsIncPopSizeUpDown); + this.CMAES.Controls.Add(this.cmaEsSigmaCheckBox); + this.CMAES.Controls.Add(this.cmaEsSigmaNumUpDown); this.CMAES.Location = new System.Drawing.Point(4, 32); this.CMAES.Name = "CMAES"; - this.CMAES.Size = new System.Drawing.Size(368, 335); + this.CMAES.Size = new System.Drawing.Size(406, 393); this.CMAES.TabIndex = 2; this.CMAES.Text = "CMA-ES"; this.CMAES.UseVisualStyleBackColor = true; // - // cmaesRestartCheckBox - // - this.cmaesRestartCheckBox.AutoSize = true; - this.cmaesRestartCheckBox.Location = new System.Drawing.Point(11, 203); - this.cmaesRestartCheckBox.Name = "cmaesRestartCheckBox"; - this.cmaesRestartCheckBox.Size = new System.Drawing.Size(171, 27); - this.cmaesRestartCheckBox.TabIndex = 32; - this.cmaesRestartCheckBox.Text = "RestartStrategy"; - this.toolTip1.SetToolTip(this.cmaesRestartCheckBox, "If given False, CMA-ES will not restart.\r\nStrategy for restarting CMA-ES optimiza" + - "tion when converges to a local minimum. "); - this.cmaesRestartCheckBox.UseVisualStyleBackColor = true; - // - // cmaesUseSaparableCmaCheckBox - // - this.cmaesUseSaparableCmaCheckBox.AutoSize = true; - this.cmaesUseSaparableCmaCheckBox.Location = new System.Drawing.Point(11, 152); - this.cmaesUseSaparableCmaCheckBox.Name = "cmaesUseSaparableCmaCheckBox"; - this.cmaesUseSaparableCmaCheckBox.Size = new System.Drawing.Size(204, 27); - this.cmaesUseSaparableCmaCheckBox.TabIndex = 31; - this.cmaesUseSaparableCmaCheckBox.Text = "Use Separable CMA"; - this.toolTip1.SetToolTip(this.cmaesUseSaparableCmaCheckBox, resources.GetString("cmaesUseSaparableCmaCheckBox.ToolTip")); - this.cmaesUseSaparableCmaCheckBox.UseVisualStyleBackColor = true; - // - // cmaesNStartupTrialsLabel - // - this.cmaesNStartupTrialsLabel.AutoSize = true; - this.cmaesNStartupTrialsLabel.Location = new System.Drawing.Point(7, 7); - this.cmaesNStartupTrialsLabel.Name = "cmaesNStartupTrialsLabel"; - this.cmaesNStartupTrialsLabel.Size = new System.Drawing.Size(219, 23); - this.cmaesNStartupTrialsLabel.TabIndex = 30; - this.cmaesNStartupTrialsLabel.Text = "Number of startup trials"; - this.toolTip1.SetToolTip(this.cmaesNStartupTrialsLabel, "The independent sampling is used instead of the CMA-ES algorithm until the given " + - "number of trials finish in the same study."); + // cmaEsRestartCheckBox + // + this.cmaEsRestartCheckBox.AutoSize = true; + this.cmaEsRestartCheckBox.Location = new System.Drawing.Point(11, 203); + this.cmaEsRestartCheckBox.Name = "cmaEsRestartCheckBox"; + this.cmaEsRestartCheckBox.Size = new System.Drawing.Size(171, 27); + this.cmaEsRestartCheckBox.TabIndex = 32; + this.cmaEsRestartCheckBox.Text = "RestartStrategy"; + this.toolTip1.SetToolTip(this.cmaEsRestartCheckBox, "If given False, \r\nCMA-ES will not restart.\r\nStrategy for restarting CMA-ES optimi" + + "zation when converges to a local minimum. "); + this.cmaEsRestartCheckBox.UseVisualStyleBackColor = true; + this.cmaEsRestartCheckBox.CheckedChanged += new System.EventHandler(this.CmaEsRestartStrategyCheckedChanged); + // + // cmaEsUseSaparableCmaCheckBox + // + this.cmaEsUseSaparableCmaCheckBox.AutoSize = true; + this.cmaEsUseSaparableCmaCheckBox.Location = new System.Drawing.Point(11, 152); + this.cmaEsUseSaparableCmaCheckBox.Name = "cmaEsUseSaparableCmaCheckBox"; + this.cmaEsUseSaparableCmaCheckBox.Size = new System.Drawing.Size(204, 27); + this.cmaEsUseSaparableCmaCheckBox.TabIndex = 31; + this.cmaEsUseSaparableCmaCheckBox.Text = "Use Separable CMA"; + this.toolTip1.SetToolTip(this.cmaEsUseSaparableCmaCheckBox, resources.GetString("cmaEsUseSaparableCmaCheckBox.ToolTip")); + this.cmaEsUseSaparableCmaCheckBox.UseVisualStyleBackColor = true; + // + // cmaEsNStartupTrialsLabel + // + this.cmaEsNStartupTrialsLabel.AutoSize = true; + this.cmaEsNStartupTrialsLabel.Location = new System.Drawing.Point(7, 7); + this.cmaEsNStartupTrialsLabel.Name = "cmaEsNStartupTrialsLabel"; + this.cmaEsNStartupTrialsLabel.Size = new System.Drawing.Size(219, 23); + this.cmaEsNStartupTrialsLabel.TabIndex = 30; + this.cmaEsNStartupTrialsLabel.Text = "Number of startup trials"; + this.toolTip1.SetToolTip(this.cmaEsNStartupTrialsLabel, "The independent sampling is used instead of the CMA-ES algorithm\r\nuntil the given" + + " number of trials finish in the same study."); // // cmaesNStartup // @@ -975,135 +974,108 @@ private void InitializeComponent() this.toolTip1.SetToolTip(this.cmaesNStartup, "The independent sampling is used instead of the CMA-ES algorithm until the given " + "number of trials finish in the same study."); // - // numericUpDown4 - // - this.numericUpDown4.Location = new System.Drawing.Point(258, 5); - this.numericUpDown4.Maximum = new decimal(new int[] { - 1000, - 0, - 0, - 0}); - this.numericUpDown4.Minimum = new decimal(new int[] { - 1, - 0, - 0, - 0}); - this.numericUpDown4.Name = "numericUpDown4"; - this.numericUpDown4.Size = new System.Drawing.Size(94, 30); - this.numericUpDown4.TabIndex = 29; - this.numericUpDown4.Value = new decimal(new int[] { - 1, - 0, - 0, - 0}); - // - // cmaesStartupNumUpDown + // cmaEsStartupNumUpDown // - this.cmaesStartupNumUpDown.Location = new System.Drawing.Point(258, 3); - this.cmaesStartupNumUpDown.Maximum = new decimal(new int[] { + this.cmaEsStartupNumUpDown.Location = new System.Drawing.Point(309, 5); + this.cmaEsStartupNumUpDown.Maximum = new decimal(new int[] { 1000, 0, 0, 0}); - this.cmaesStartupNumUpDown.Minimum = new decimal(new int[] { + this.cmaEsStartupNumUpDown.Minimum = new decimal(new int[] { 1, 0, 0, 0}); - this.cmaesStartupNumUpDown.Name = "cmaesStartupNumUpDown"; - this.cmaesStartupNumUpDown.Size = new System.Drawing.Size(94, 30); - this.cmaesStartupNumUpDown.TabIndex = 29; - this.cmaesStartupNumUpDown.Value = new decimal(new int[] { + this.cmaEsStartupNumUpDown.Name = "cmaEsStartupNumUpDown"; + this.cmaEsStartupNumUpDown.Size = new System.Drawing.Size(94, 30); + this.cmaEsStartupNumUpDown.TabIndex = 29; + this.cmaEsStartupNumUpDown.Value = new decimal(new int[] { 1, 0, 0, 0}); // - // cmaesConsiderPruneTrialsCheckBox - // - this.cmaesConsiderPruneTrialsCheckBox.AutoSize = true; - this.cmaesConsiderPruneTrialsCheckBox.Location = new System.Drawing.Point(11, 119); - this.cmaesConsiderPruneTrialsCheckBox.Name = "cmaesConsiderPruneTrialsCheckBox"; - this.cmaesConsiderPruneTrialsCheckBox.Size = new System.Drawing.Size(230, 27); - this.cmaesConsiderPruneTrialsCheckBox.TabIndex = 28; - this.cmaesConsiderPruneTrialsCheckBox.Text = "Consider Pruned Trials"; - this.toolTip1.SetToolTip(this.cmaesConsiderPruneTrialsCheckBox, "If this is True, the PRUNED trials are considered for sampling."); - this.cmaesConsiderPruneTrialsCheckBox.UseVisualStyleBackColor = true; - // - // cmaesWarnIndependentSamplingCheckBox - // - this.cmaesWarnIndependentSamplingCheckBox.AutoSize = true; - this.cmaesWarnIndependentSamplingCheckBox.Checked = true; - this.cmaesWarnIndependentSamplingCheckBox.CheckState = System.Windows.Forms.CheckState.Checked; - this.cmaesWarnIndependentSamplingCheckBox.Location = new System.Drawing.Point(11, 86); - this.cmaesWarnIndependentSamplingCheckBox.Name = "cmaesWarnIndependentSamplingCheckBox"; - this.cmaesWarnIndependentSamplingCheckBox.Size = new System.Drawing.Size(284, 27); - this.cmaesWarnIndependentSamplingCheckBox.TabIndex = 27; - this.cmaesWarnIndependentSamplingCheckBox.Text = "Warn Independent Sampling"; - this.toolTip1.SetToolTip(this.cmaesWarnIndependentSamplingCheckBox, "If this is True and multivariate=True, a warning message is emitted when the valu" + - "e of a parameter is sampled by using an independent sampler. If multivariate=Fal" + - "se, this flag has no effect."); - this.cmaesWarnIndependentSamplingCheckBox.UseVisualStyleBackColor = true; - // - // cmaesIncPopsizeLabel - // - this.cmaesIncPopsizeLabel.AutoSize = true; - this.cmaesIncPopsizeLabel.Location = new System.Drawing.Point(7, 233); - this.cmaesIncPopsizeLabel.Name = "cmaesIncPopsizeLabel"; - this.cmaesIncPopsizeLabel.Size = new System.Drawing.Size(240, 23); - this.cmaesIncPopsizeLabel.TabIndex = 26; - this.cmaesIncPopsizeLabel.Text = "Increasing Population Size"; - this.toolTip1.SetToolTip(this.cmaesIncPopsizeLabel, "Multiplier for increasing population size before each restart."); - // - // cmaesIncPopSizeUpDown - // - this.cmaesIncPopSizeUpDown.Enabled = false; - this.cmaesIncPopSizeUpDown.Location = new System.Drawing.Point(258, 231); - this.cmaesIncPopSizeUpDown.Minimum = new decimal(new int[] { + // cmaEsConsiderPruneTrialsCheckBox + // + this.cmaEsConsiderPruneTrialsCheckBox.AutoSize = true; + this.cmaEsConsiderPruneTrialsCheckBox.Location = new System.Drawing.Point(11, 119); + this.cmaEsConsiderPruneTrialsCheckBox.Name = "cmaEsConsiderPruneTrialsCheckBox"; + this.cmaEsConsiderPruneTrialsCheckBox.Size = new System.Drawing.Size(230, 27); + this.cmaEsConsiderPruneTrialsCheckBox.TabIndex = 28; + this.cmaEsConsiderPruneTrialsCheckBox.Text = "Consider Pruned Trials"; + this.toolTip1.SetToolTip(this.cmaEsConsiderPruneTrialsCheckBox, "If this is True, \r\nthe PRUNED trials are considered for sampling."); + this.cmaEsConsiderPruneTrialsCheckBox.UseVisualStyleBackColor = true; + // + // cmaEsWarnIndependentSamplingCheckBox + // + this.cmaEsWarnIndependentSamplingCheckBox.AutoSize = true; + this.cmaEsWarnIndependentSamplingCheckBox.Checked = true; + this.cmaEsWarnIndependentSamplingCheckBox.CheckState = System.Windows.Forms.CheckState.Checked; + this.cmaEsWarnIndependentSamplingCheckBox.Location = new System.Drawing.Point(11, 86); + this.cmaEsWarnIndependentSamplingCheckBox.Name = "cmaEsWarnIndependentSamplingCheckBox"; + this.cmaEsWarnIndependentSamplingCheckBox.Size = new System.Drawing.Size(284, 27); + this.cmaEsWarnIndependentSamplingCheckBox.TabIndex = 27; + this.cmaEsWarnIndependentSamplingCheckBox.Text = "Warn Independent Sampling"; + this.toolTip1.SetToolTip(this.cmaEsWarnIndependentSamplingCheckBox, "If this is True, \r\na warning message is emitted when the value of a parameter is " + + "sampled by using an independent sampler."); + this.cmaEsWarnIndependentSamplingCheckBox.UseVisualStyleBackColor = true; + // + // cmaEsIncPopsizeLabel + // + this.cmaEsIncPopsizeLabel.AutoSize = true; + this.cmaEsIncPopsizeLabel.Location = new System.Drawing.Point(7, 233); + this.cmaEsIncPopsizeLabel.Name = "cmaEsIncPopsizeLabel"; + this.cmaEsIncPopsizeLabel.Size = new System.Drawing.Size(240, 23); + this.cmaEsIncPopsizeLabel.TabIndex = 26; + this.cmaEsIncPopsizeLabel.Text = "Increasing Population Size"; + this.toolTip1.SetToolTip(this.cmaEsIncPopsizeLabel, "Multiplier for increasing population size before each restart."); + // + // cmaEsIncPopSizeUpDown + // + this.cmaEsIncPopSizeUpDown.Enabled = false; + this.cmaEsIncPopSizeUpDown.Location = new System.Drawing.Point(309, 231); + this.cmaEsIncPopSizeUpDown.Minimum = new decimal(new int[] { 1, 0, 0, 0}); - this.cmaesIncPopSizeUpDown.Name = "cmaesIncPopSizeUpDown"; - this.cmaesIncPopSizeUpDown.Size = new System.Drawing.Size(94, 30); - this.cmaesIncPopSizeUpDown.TabIndex = 25; - this.cmaesIncPopSizeUpDown.Value = new decimal(new int[] { + this.cmaEsIncPopSizeUpDown.Name = "cmaEsIncPopSizeUpDown"; + this.cmaEsIncPopSizeUpDown.Size = new System.Drawing.Size(94, 30); + this.cmaEsIncPopSizeUpDown.TabIndex = 25; + this.cmaEsIncPopSizeUpDown.Value = new decimal(new int[] { 2, 0, 0, 0}); // - // cmaesSigmaCheckBox - // - this.cmaesSigmaCheckBox.AutoSize = true; - this.cmaesSigmaCheckBox.Location = new System.Drawing.Point(11, 39); - this.cmaesSigmaCheckBox.Name = "cmaesSigmaCheckBox"; - this.cmaesSigmaCheckBox.Size = new System.Drawing.Size(101, 27); - this.cmaesSigmaCheckBox.TabIndex = 24; - this.cmaesSigmaCheckBox.Text = "Sigma0"; - this.toolTip1.SetToolTip(this.cmaesSigmaCheckBox, "Initial standard deviation of CMA-ES. By default, sigma0 is set to min_range / 6," + - " where min_range denotes the minimum range of the distributions in the search sp" + - "ace."); - this.cmaesSigmaCheckBox.UseVisualStyleBackColor = true; - // - // numericUpDown2 - // - this.numericUpDown2.DecimalPlaces = 2; - this.numericUpDown2.Enabled = false; - this.numericUpDown2.Increment = new decimal(new int[] { + // cmaEsSigmaCheckBox + // + this.cmaEsSigmaCheckBox.AutoSize = true; + this.cmaEsSigmaCheckBox.Location = new System.Drawing.Point(11, 39); + this.cmaEsSigmaCheckBox.Name = "cmaEsSigmaCheckBox"; + this.cmaEsSigmaCheckBox.Size = new System.Drawing.Size(101, 27); + this.cmaEsSigmaCheckBox.TabIndex = 24; + this.cmaEsSigmaCheckBox.Text = "Sigma0"; + this.toolTip1.SetToolTip(this.cmaEsSigmaCheckBox, "Initial standard deviation of CMA-ES. By default, sigma0 is set to min_range / 6," + + "\r\nwhere min_range denotes the minimum range of the distributions in the search s" + + "pace."); + this.cmaEsSigmaCheckBox.UseVisualStyleBackColor = true; + this.cmaEsSigmaCheckBox.CheckedChanged += new System.EventHandler(this.CmaEsSigmaCheckedChanged); + // + // cmaEsSigmaNumUpDown + // + this.cmaEsSigmaNumUpDown.DecimalPlaces = 2; + this.cmaEsSigmaNumUpDown.Enabled = false; + this.cmaEsSigmaNumUpDown.Increment = new decimal(new int[] { 1, 0, 0, 131072}); - this.numericUpDown2.Location = new System.Drawing.Point(258, 39); - this.numericUpDown2.Maximum = new decimal(new int[] { - 0, - 0, - 0, - 0}); - this.numericUpDown2.Name = "numericUpDown2"; - this.numericUpDown2.Size = new System.Drawing.Size(94, 30); - this.numericUpDown2.TabIndex = 23; + this.cmaEsSigmaNumUpDown.Location = new System.Drawing.Point(309, 38); + this.cmaEsSigmaNumUpDown.Name = "cmaEsSigmaNumUpDown"; + this.cmaEsSigmaNumUpDown.Size = new System.Drawing.Size(94, 30); + this.cmaEsSigmaNumUpDown.TabIndex = 23; // // QMC // @@ -1111,10 +1083,10 @@ private void InitializeComponent() this.QMC.Controls.Add(this.qmcTypeLabel); this.QMC.Controls.Add(this.qmcWarnAsyncSeedingCheckBox); this.QMC.Controls.Add(this.qmcScrambleCheckBox); - this.QMC.Controls.Add(this.qmcWarnIndependentSamplingcheckBox); + this.QMC.Controls.Add(this.qmcWarnIndependentSamplingCheckBox); this.QMC.Location = new System.Drawing.Point(4, 32); this.QMC.Name = "QMC"; - this.QMC.Size = new System.Drawing.Size(368, 335); + this.QMC.Size = new System.Drawing.Size(406, 393); this.QMC.TabIndex = 4; this.QMC.Text = "QMC"; this.QMC.UseVisualStyleBackColor = true; @@ -1125,7 +1097,7 @@ private void InitializeComponent() this.qmcTypeComboBox.Items.AddRange(new object[] { "sobol", "halton"}); - this.qmcTypeComboBox.Location = new System.Drawing.Point(229, 10); + this.qmcTypeComboBox.Location = new System.Drawing.Point(267, 10); this.qmcTypeComboBox.Margin = new System.Windows.Forms.Padding(4, 6, 4, 6); this.qmcTypeComboBox.Name = "qmcTypeComboBox"; this.qmcTypeComboBox.Size = new System.Drawing.Size(135, 31); @@ -1140,8 +1112,7 @@ private void InitializeComponent() this.qmcTypeLabel.Size = new System.Drawing.Size(97, 23); this.qmcTypeLabel.TabIndex = 31; this.qmcTypeLabel.Text = "QMC Type"; - this.toolTip1.SetToolTip(this.qmcTypeLabel, "The type of QMC sequence to be sampled. This must be one of “halton” and “sobol”." + - " "); + this.toolTip1.SetToolTip(this.qmcTypeLabel, "The type of QMC sequence to be sampled.\r\n"); // // qmcWarnAsyncSeedingCheckBox // @@ -1153,9 +1124,9 @@ private void InitializeComponent() this.qmcWarnAsyncSeedingCheckBox.Size = new System.Drawing.Size(284, 27); this.qmcWarnAsyncSeedingCheckBox.TabIndex = 30; this.qmcWarnAsyncSeedingCheckBox.Text = "Warn Asynchronous Seeding"; - this.toolTip1.SetToolTip(this.qmcWarnAsyncSeedingCheckBox, "If this is True, a warning message is emitted when the scrambling (randomization)" + - " is applied to the QMC sequence and the random seed of the sampler is not set ma" + - "nually."); + this.toolTip1.SetToolTip(this.qmcWarnAsyncSeedingCheckBox, "If this is True, \r\na warning message is emitted \r\nwhen the scrambling (randomizat" + + "ion) is applied to the QMC sequence\r\nand the random seed of the sampler is not s" + + "et manually."); this.qmcWarnAsyncSeedingCheckBox.UseVisualStyleBackColor = true; // // qmcScrambleCheckBox @@ -1166,39 +1137,39 @@ private void InitializeComponent() this.qmcScrambleCheckBox.Size = new System.Drawing.Size(116, 27); this.qmcScrambleCheckBox.TabIndex = 29; this.qmcScrambleCheckBox.Text = "Scramble"; - this.toolTip1.SetToolTip(this.qmcScrambleCheckBox, "If this option is True, scrambling (randomization) is applied to the QMC sequence" + - "s."); + this.toolTip1.SetToolTip(this.qmcScrambleCheckBox, "If this option is True, \r\nscrambling (randomization) is applied to the QMC sequen" + + "ces."); this.qmcScrambleCheckBox.UseVisualStyleBackColor = true; // - // qmcWarnIndependentSamplingcheckBox + // qmcWarnIndependentSamplingCheckBox // - this.qmcWarnIndependentSamplingcheckBox.AutoSize = true; - this.qmcWarnIndependentSamplingcheckBox.Checked = true; - this.qmcWarnIndependentSamplingcheckBox.CheckState = System.Windows.Forms.CheckState.Checked; - this.qmcWarnIndependentSamplingcheckBox.Location = new System.Drawing.Point(7, 88); - this.qmcWarnIndependentSamplingcheckBox.Name = "qmcWarnIndependentSamplingcheckBox"; - this.qmcWarnIndependentSamplingcheckBox.Size = new System.Drawing.Size(284, 27); - this.qmcWarnIndependentSamplingcheckBox.TabIndex = 28; - this.qmcWarnIndependentSamplingcheckBox.Text = "Warn Independent Sampling"; - this.toolTip1.SetToolTip(this.qmcWarnIndependentSamplingcheckBox, "If this is True, a warning message is emitted when the value of a parameter is sa" + - "mpled by using an independent sampler."); - this.qmcWarnIndependentSamplingcheckBox.UseVisualStyleBackColor = true; + this.qmcWarnIndependentSamplingCheckBox.AutoSize = true; + this.qmcWarnIndependentSamplingCheckBox.Checked = true; + this.qmcWarnIndependentSamplingCheckBox.CheckState = System.Windows.Forms.CheckState.Checked; + this.qmcWarnIndependentSamplingCheckBox.Location = new System.Drawing.Point(7, 88); + this.qmcWarnIndependentSamplingCheckBox.Name = "qmcWarnIndependentSamplingCheckBox"; + this.qmcWarnIndependentSamplingCheckBox.Size = new System.Drawing.Size(284, 27); + this.qmcWarnIndependentSamplingCheckBox.TabIndex = 28; + this.qmcWarnIndependentSamplingCheckBox.Text = "Warn Independent Sampling"; + this.toolTip1.SetToolTip(this.qmcWarnIndependentSamplingCheckBox, "If this is True, \r\na warning message is emitted when the value of a parameter\r\nis" + + " sampled by using an independent sampler."); + this.qmcWarnIndependentSamplingCheckBox.UseVisualStyleBackColor = true; // // fileTabPage // this.fileTabPage.Controls.Add(this.openResultFolderButton); this.fileTabPage.Controls.Add(this.clearResultButton); - this.fileTabPage.Location = new System.Drawing.Point(4, 60); + this.fileTabPage.Location = new System.Drawing.Point(4, 32); this.fileTabPage.Name = "fileTabPage"; this.fileTabPage.Padding = new System.Windows.Forms.Padding(3); - this.fileTabPage.Size = new System.Drawing.Size(379, 374); + this.fileTabPage.Size = new System.Drawing.Size(420, 440); this.fileTabPage.TabIndex = 4; this.fileTabPage.Text = "File"; this.fileTabPage.UseVisualStyleBackColor = true; // // openResultFolderButton // - this.openResultFolderButton.Location = new System.Drawing.Point(62, 27); + this.openResultFolderButton.Location = new System.Drawing.Point(80, 29); this.openResultFolderButton.Margin = new System.Windows.Forms.Padding(4, 6, 4, 6); this.openResultFolderButton.Name = "openResultFolderButton"; this.openResultFolderButton.Size = new System.Drawing.Size(264, 39); @@ -1209,7 +1180,7 @@ private void InitializeComponent() // // clearResultButton // - this.clearResultButton.Location = new System.Drawing.Point(62, 92); + this.clearResultButton.Location = new System.Drawing.Point(80, 94); this.clearResultButton.Margin = new System.Windows.Forms.Padding(4, 6, 4, 6); this.clearResultButton.Name = "clearResultButton"; this.clearResultButton.Size = new System.Drawing.Size(264, 42); @@ -1249,7 +1220,7 @@ private void InitializeComponent() ((System.ComponentModel.ISupportInitialize)(this.tpePriorNumUpDown)).EndInit(); this.GP.ResumeLayout(false); this.GP.PerformLayout(); - ((System.ComponentModel.ISupportInitialize)(this.numericUpDown1)).EndInit(); + ((System.ComponentModel.ISupportInitialize)(this.boTorchStartupNumUpDown)).EndInit(); this.NSGAII.ResumeLayout(false); this.NSGAII.PerformLayout(); ((System.ComponentModel.ISupportInitialize)(this.nsgaPopulationSizeUpDown)).EndInit(); @@ -1258,10 +1229,9 @@ private void InitializeComponent() ((System.ComponentModel.ISupportInitialize)(this.nsgaMutationProbUpDown)).EndInit(); this.CMAES.ResumeLayout(false); this.CMAES.PerformLayout(); - ((System.ComponentModel.ISupportInitialize)(this.numericUpDown4)).EndInit(); - ((System.ComponentModel.ISupportInitialize)(this.cmaesStartupNumUpDown)).EndInit(); - ((System.ComponentModel.ISupportInitialize)(this.cmaesIncPopSizeUpDown)).EndInit(); - ((System.ComponentModel.ISupportInitialize)(this.numericUpDown2)).EndInit(); + ((System.ComponentModel.ISupportInitialize)(this.cmaEsStartupNumUpDown)).EndInit(); + ((System.ComponentModel.ISupportInitialize)(this.cmaEsIncPopSizeUpDown)).EndInit(); + ((System.ComponentModel.ISupportInitialize)(this.cmaEsSigmaNumUpDown)).EndInit(); this.QMC.ResumeLayout(false); this.QMC.PerformLayout(); this.fileTabPage.ResumeLayout(false); @@ -1325,8 +1295,8 @@ private void InitializeComponent() private System.Windows.Forms.CheckBox tpeConsiderEndpointsCheckBox; private System.Windows.Forms.CheckBox tpeConsiderMagicClipCheckBox; private System.Windows.Forms.CheckBox tpeConsiderPriorCheckBox; - private System.Windows.Forms.Label botorchNStartupTrialsLabel; - private System.Windows.Forms.NumericUpDown numericUpDown1; + private System.Windows.Forms.Label boTorchNStartupTrialsLabel; + private System.Windows.Forms.NumericUpDown boTorchStartupNumUpDown; private System.Windows.Forms.CheckBox nsgaMutationProbCheckBox; private System.Windows.Forms.Label nsgaPopulationSizeLabel; private System.Windows.Forms.NumericUpDown nsgaPopulationSizeUpDown; @@ -1335,19 +1305,18 @@ private void InitializeComponent() private System.Windows.Forms.Label nsgaCrossoverProbLabel; private System.Windows.Forms.NumericUpDown nsgaCrossoverProbUpDown; private System.Windows.Forms.NumericUpDown nsgaMutationProbUpDown; - private System.Windows.Forms.CheckBox cmaesRestartCheckBox; - private System.Windows.Forms.CheckBox cmaesUseSaparableCmaCheckBox; - private System.Windows.Forms.Label cmaesNStartupTrialsLabel; + private System.Windows.Forms.CheckBox cmaEsRestartCheckBox; + private System.Windows.Forms.CheckBox cmaEsUseSaparableCmaCheckBox; + private System.Windows.Forms.Label cmaEsNStartupTrialsLabel; private System.Windows.Forms.Label cmaesNStartup; - private System.Windows.Forms.NumericUpDown numericUpDown4; - private System.Windows.Forms.NumericUpDown cmaesStartupNumUpDown; - private System.Windows.Forms.CheckBox cmaesConsiderPruneTrialsCheckBox; - private System.Windows.Forms.CheckBox cmaesWarnIndependentSamplingCheckBox; - private System.Windows.Forms.Label cmaesIncPopsizeLabel; - private System.Windows.Forms.NumericUpDown cmaesIncPopSizeUpDown; - private System.Windows.Forms.CheckBox cmaesSigmaCheckBox; - private System.Windows.Forms.NumericUpDown numericUpDown2; - private System.Windows.Forms.CheckBox qmcWarnIndependentSamplingcheckBox; + private System.Windows.Forms.NumericUpDown cmaEsStartupNumUpDown; + private System.Windows.Forms.CheckBox cmaEsConsiderPruneTrialsCheckBox; + private System.Windows.Forms.CheckBox cmaEsWarnIndependentSamplingCheckBox; + private System.Windows.Forms.Label cmaEsIncPopsizeLabel; + private System.Windows.Forms.NumericUpDown cmaEsIncPopSizeUpDown; + private System.Windows.Forms.CheckBox cmaEsSigmaCheckBox; + private System.Windows.Forms.NumericUpDown cmaEsSigmaNumUpDown; + private System.Windows.Forms.CheckBox qmcWarnIndependentSamplingCheckBox; private System.Windows.Forms.ComboBox qmcTypeComboBox; private System.Windows.Forms.Label qmcTypeLabel; private System.Windows.Forms.CheckBox qmcWarnAsyncSeedingCheckBox; diff --git a/Tunny/UI/OptimizationWindow.cs b/Tunny/UI/OptimizationWindow.cs index eaed97a8..19c43f84 100644 --- a/Tunny/UI/OptimizationWindow.cs +++ b/Tunny/UI/OptimizationWindow.cs @@ -88,6 +88,7 @@ private void InitializeUIValues() studyNameTextBox.Text = _settings.StudyName; outputModelNumTextBox.Text = _settings.Result.OutputNumberString; visualizeTypeComboBox.SelectedIndex = _settings.Result.SelectVisualizeType; + InitializeSamplerSettings(); } private void UpdateGrasshopper(IList parameters) diff --git a/Tunny/UI/OptimizationWindow.resx b/Tunny/UI/OptimizationWindow.resx index 054d2694..bc95beb2 100644 --- a/Tunny/UI/OptimizationWindow.resx +++ b/Tunny/UI/OptimizationWindow.resx @@ -123,8 +123,9 @@ 633, 17 - - If this is True, the covariance matrix is constrained to be diagonal. + + If this is True, +the covariance matrix is constrained to be diagonal. Due to reduce the model complexity, the learning rate for the covariance matrix is increased. Consequently, this algorithm outperforms CMA-ES on separable functions. diff --git a/Tunny/UI/OptimizeWindowTab/SettingsTab.cs b/Tunny/UI/OptimizeWindowTab/SettingsTab.cs index 4f3091e6..01bfd456 100644 --- a/Tunny/UI/OptimizeWindowTab/SettingsTab.cs +++ b/Tunny/UI/OptimizeWindowTab/SettingsTab.cs @@ -1,46 +1,90 @@ using System; -using System.Diagnostics; using System.Windows.Forms; +using Tunny.Settings; + namespace Tunny.UI { public partial class OptimizationWindow : Form { - // private void SettingsOpenAPIPage_Click(object sender, EventArgs e) - // { - // int apiIndex = settingsAPIComboBox.SelectedIndex; - // switch (apiIndex) - // { - // case 0: // TPE - // Process.Start("https://optuna.readthedocs.io/en/stable/reference/generated/optuna.samplers.TPESampler.html"); - // break; - // case 1: // NSGA2 - // Process.Start("https://optuna.readthedocs.io/en/stable/reference/generated/optuna.samplers.NSGAIISampler.html"); - // break; - // case 2: // CMA-ES - // Process.Start("https://optuna.readthedocs.io/en/stable/reference/generated/optuna.samplers.CmaEsSampler.html"); - // break; - // case 3: // Random - // Process.Start("https://optuna.readthedocs.io/en/stable/reference/generated/optuna.samplers.RandomSampler.html"); - // break; - // } - // } + private void NsgaMutationProbCheckedChanged(object sender, EventArgs e) + { + nsgaMutationProbUpDown.Enabled = nsgaMutationProbCheckBox.Checked; + } + + private void CmaEsSigmaCheckedChanged(object sender, EventArgs e) + { + cmaEsSigmaNumUpDown.Enabled = cmaEsSigmaCheckBox.Checked; + } + + private void CmaEsRestartStrategyCheckedChanged(object sender, EventArgs e) + { + cmaEsIncPopSizeUpDown.Enabled = cmaEsRestartCheckBox.Checked; + } + + private void InitializeSamplerSettings() + { + Sampler sampler = _settings.Optimize.Sampler; + TpeSettingInitialize(sampler.Tpe); + BoTorchSettingInitialize(sampler.BoTorch); + NSGAIISettingsInitialize(sampler.NsgaII); + CmaEsSettingInitialize(sampler.CmaEs); + QMCSettingInitialize(sampler.QMC); + } + + private void TpeSettingInitialize(Tpe tpe) + { + tpeStartupNumUpDown.Value = tpe.NStartupTrials; + tpeEINumUpDown.Value = tpe.NEICandidates; + tpePriorNumUpDown.Value = (decimal)tpe.PriorWeight; - private void SettingsFromJson_Click(object sender, EventArgs e) + tpeConsiderPriorCheckBox.Checked = tpe.ConsiderPrior; + tpeMultivariateCheckBox.Checked = tpe.Multivariate; + tpeConsiderEndpointsCheckBox.Checked = tpe.ConsiderEndpoints; + tpeGroupCheckBox.Checked = tpe.Group; + tpeConsiderMagicClipCheckBox.Checked = tpe.ConsiderMagicClip; + tpeConstantLiarCheckBox.Checked = tpe.ConstantLiar; + tpeWarnIndependentSamplingCheckBox.Checked = tpe.WarnIndependentSampling; + } + + private void BoTorchSettingInitialize(BoTorch boTorch) { - LoadSettingJson(); - InitializeUIValues(); + boTorchStartupNumUpDown.Value = boTorch.NStartupTrials; } - private void SettingsToJson_Click(object sender, EventArgs e) + private void NSGAIISettingsInitialize(NSGAII nsga) { - SaveUIValues(); + nsgaMutationProbCheckBox.Checked = nsga.MutationProb != null; + nsgaMutationProbUpDown.Enabled = nsgaMutationProbCheckBox.Checked; + nsgaMutationProbUpDown.Value = nsga.MutationProb != null ? (decimal)nsga.MutationProb : 0; + nsgaCrossoverProbUpDown.Value = (decimal)nsga.CrossoverProb; + nsgaSwappingProbUpDown.Value = (decimal)nsga.SwappingProb; + nsgaPopulationSizeUpDown.Value = nsga.PopulationSize; } - private void SettingsFolderOpen_Click(object sender, EventArgs e) + private void CmaEsSettingInitialize(CmaEs cmaEs) { - SaveUIValues(); - Process.Start("EXPLORER.EXE", _component.GhInOut.ComponentFolder); + cmaEsStartupNumUpDown.Value = cmaEs.NStartupTrials; + cmaEsSigmaCheckBox.Checked = cmaEs.Sigma0 != null; + cmaEsSigmaNumUpDown.Value = cmaEs.Sigma0 != null ? (decimal)cmaEs.Sigma0 : 0; + cmaEsSigmaNumUpDown.Enabled = cmaEsSigmaCheckBox.Checked; + + cmaEsWarnIndependentSamplingCheckBox.Checked = cmaEs.WarnIndependentSampling; + cmaEsConsiderPruneTrialsCheckBox.Checked = cmaEs.ConsiderPrunedTrials; + cmaEsUseSaparableCmaCheckBox.Checked = cmaEs.UseSeparableCma; + + cmaEsRestartCheckBox.Checked = cmaEs.RestartStrategy != string.Empty; + cmaEsIncPopSizeUpDown.Enabled = cmaEsRestartCheckBox.Checked; + cmaEsIncPopSizeUpDown.Value = cmaEs.IncPopsize; + } + + private void QMCSettingInitialize(QuasiMonteCarlo qmc) + { + qmcTypeComboBox.SelectedIndex = qmc.QmcType == "sobol" ? 0 : 1; + + qmcScrambleCheckBox.Checked = qmc.Scramble; + qmcWarnIndependentSamplingCheckBox.Checked = qmc.WarnIndependentSampling; + qmcWarnAsyncSeedingCheckBox.Checked = qmc.WarnAsynchronousSeeding; } } } From 9dee9d6358829552456f9bb9e3b2cfdb970512ec Mon Sep 17 00:00:00 2001 From: hrntsm Date: Fri, 19 Aug 2022 20:09:47 +0900 Subject: [PATCH 27/65] Add sampler setting getter --- Tunny/Settings/CmaEs.cs | 2 +- Tunny/Solver/Optuna/Sampler.cs | 2 +- Tunny/UI/OptimizationWindow.cs | 7 +- Tunny/UI/OptimizeWindowTab/OptimizeTab.cs | 6 +- Tunny/UI/OptimizeWindowTab/SettingsTab.cs | 95 ++++++++++++++++++++--- 5 files changed, 92 insertions(+), 20 deletions(-) diff --git a/Tunny/Settings/CmaEs.cs b/Tunny/Settings/CmaEs.cs index 11e086ae..c09babef 100644 --- a/Tunny/Settings/CmaEs.cs +++ b/Tunny/Settings/CmaEs.cs @@ -10,7 +10,7 @@ public class CmaEs public int NStartupTrials { get; set; } = 1; public bool WarnIndependentSampling { get; set; } = true; public bool ConsiderPrunedTrials { get; set; } - public string RestartStrategy { get; set; } + public string RestartStrategy { get; set; } = string.Empty; public int IncPopsize { get; set; } = 2; public bool UseSeparableCma { get; set; } } diff --git a/Tunny/Solver/Optuna/Sampler.cs b/Tunny/Solver/Optuna/Sampler.cs index 0e6d2d98..8be211e9 100644 --- a/Tunny/Solver/Optuna/Sampler.cs +++ b/Tunny/Solver/Optuna/Sampler.cs @@ -27,7 +27,7 @@ internal static dynamic CmaEs(dynamic optuna, TunnySettings settings) warn_independent_sampling: cmaEs.WarnIndependentSampling, seed: cmaEs.Seed, consider_pruned_trials: cmaEs.ConsiderPrunedTrials, - restart_strategy: cmaEs.RestartStrategy, + restart_strategy: cmaEs.RestartStrategy == string.Empty ? null : cmaEs.RestartStrategy, inc_popsize: cmaEs.IncPopsize, use_separable_cma: cmaEs.UseSeparableCma ); diff --git a/Tunny/UI/OptimizationWindow.cs b/Tunny/UI/OptimizationWindow.cs index 19c43f84..603e4e1e 100644 --- a/Tunny/UI/OptimizationWindow.cs +++ b/Tunny/UI/OptimizationWindow.cs @@ -112,7 +112,8 @@ private void FormClosingXButton(object sender, FormClosingEventArgs e) { var ghCanvas = Owner as GH_DocumentEditor; ghCanvas?.EnableUI(); - SaveUIValues(); + GetUIValues(); + _settings.Serialize(_component.GhInOut.ComponentFolder + @"\Settings.json"); //TODO: use cancelAsync to stop the background worker safely if (optimizeBackgroundWorker != null) @@ -125,7 +126,7 @@ private void FormClosingXButton(object sender, FormClosingEventArgs e) } } - private void SaveUIValues() + private void GetUIValues() { _settings.Optimize.SelectSampler = samplerComboBox.SelectedIndex; _settings.Optimize.NumberOfTrials = (int)nTrialNumUpDown.Value; @@ -134,7 +135,7 @@ private void SaveUIValues() _settings.StudyName = studyNameTextBox.Text; _settings.Result.OutputNumberString = outputModelNumTextBox.Text; _settings.Result.SelectVisualizeType = visualizeTypeComboBox.SelectedIndex; - _settings.Serialize(_component.GhInOut.ComponentFolder + @"\Settings.json"); + _settings.Optimize.Sampler = GetSamplerSettings(); } } } diff --git a/Tunny/UI/OptimizeWindowTab/OptimizeTab.cs b/Tunny/UI/OptimizeWindowTab/OptimizeTab.cs index f6af25c2..893385c9 100644 --- a/Tunny/UI/OptimizeWindowTab/OptimizeTab.cs +++ b/Tunny/UI/OptimizeWindowTab/OptimizeTab.cs @@ -17,11 +17,7 @@ private void OptimizeRunButton_Click(object sender, EventArgs e) ghCanvas.DisableUI(); optimizeRunButton.Enabled = false; - _settings.Optimize.NumberOfTrials = (int)nTrialNumUpDown.Value; - _settings.Optimize.SelectSampler = samplerComboBox.SelectedIndex; - _settings.StudyName = studyNameTextBox.Text; - _settings.Optimize.Timeout = (double)timeoutNumUpDown.Value; - _settings.Optimize.LoadExistStudy = loadIfExistsCheckBox.Checked; + GetUIValues(); OptimizeLoop.Settings = _settings; if (!CheckInputValue(ghCanvas)) diff --git a/Tunny/UI/OptimizeWindowTab/SettingsTab.cs b/Tunny/UI/OptimizeWindowTab/SettingsTab.cs index 01bfd456..ecf93c86 100644 --- a/Tunny/UI/OptimizeWindowTab/SettingsTab.cs +++ b/Tunny/UI/OptimizeWindowTab/SettingsTab.cs @@ -25,14 +25,14 @@ private void CmaEsRestartStrategyCheckedChanged(object sender, EventArgs e) private void InitializeSamplerSettings() { Sampler sampler = _settings.Optimize.Sampler; - TpeSettingInitialize(sampler.Tpe); - BoTorchSettingInitialize(sampler.BoTorch); - NSGAIISettingsInitialize(sampler.NsgaII); - CmaEsSettingInitialize(sampler.CmaEs); - QMCSettingInitialize(sampler.QMC); + SetTpeSettings(sampler.Tpe); + SetBoTorchSettings(sampler.BoTorch); + SetNSGAIISettings(sampler.NsgaII); + SetCmaEsSettings(sampler.CmaEs); + SetQMCSettings(sampler.QMC); } - private void TpeSettingInitialize(Tpe tpe) + private void SetTpeSettings(Tpe tpe) { tpeStartupNumUpDown.Value = tpe.NStartupTrials; tpeEINumUpDown.Value = tpe.NEICandidates; @@ -47,12 +47,12 @@ private void TpeSettingInitialize(Tpe tpe) tpeWarnIndependentSamplingCheckBox.Checked = tpe.WarnIndependentSampling; } - private void BoTorchSettingInitialize(BoTorch boTorch) + private void SetBoTorchSettings(BoTorch boTorch) { boTorchStartupNumUpDown.Value = boTorch.NStartupTrials; } - private void NSGAIISettingsInitialize(NSGAII nsga) + private void SetNSGAIISettings(NSGAII nsga) { nsgaMutationProbCheckBox.Checked = nsga.MutationProb != null; nsgaMutationProbUpDown.Enabled = nsgaMutationProbCheckBox.Checked; @@ -62,7 +62,7 @@ private void NSGAIISettingsInitialize(NSGAII nsga) nsgaPopulationSizeUpDown.Value = nsga.PopulationSize; } - private void CmaEsSettingInitialize(CmaEs cmaEs) + private void SetCmaEsSettings(CmaEs cmaEs) { cmaEsStartupNumUpDown.Value = cmaEs.NStartupTrials; cmaEsSigmaCheckBox.Checked = cmaEs.Sigma0 != null; @@ -78,7 +78,7 @@ private void CmaEsSettingInitialize(CmaEs cmaEs) cmaEsIncPopSizeUpDown.Value = cmaEs.IncPopsize; } - private void QMCSettingInitialize(QuasiMonteCarlo qmc) + private void SetQMCSettings(QuasiMonteCarlo qmc) { qmcTypeComboBox.SelectedIndex = qmc.QmcType == "sobol" ? 0 : 1; @@ -86,5 +86,80 @@ private void QMCSettingInitialize(QuasiMonteCarlo qmc) qmcWarnIndependentSamplingCheckBox.Checked = qmc.WarnIndependentSampling; qmcWarnAsyncSeedingCheckBox.Checked = qmc.WarnAsynchronousSeeding; } + + private Sampler GetSamplerSettings() + { + return new Sampler + { + Tpe = GetTpeSettings(), + BoTorch = GetBoTorchSettings(), + NsgaII = GetNSGAIISettings(), + CmaEs = GetCmaEsSettings(), + QMC = GetQMCSettings() + }; + } + + private Tpe GetTpeSettings() + { + return new Tpe + { + NStartupTrials = (int)tpeStartupNumUpDown.Value, + NEICandidates = (int)tpeEINumUpDown.Value, + PriorWeight = (double)tpePriorNumUpDown.Value, + ConsiderPrior = tpeConsiderPriorCheckBox.Checked, + Multivariate = tpeMultivariateCheckBox.Checked, + ConsiderEndpoints = tpeConsiderEndpointsCheckBox.Checked, + Group = tpeGroupCheckBox.Checked, + ConsiderMagicClip = tpeConsiderMagicClipCheckBox.Checked, + ConstantLiar = tpeConstantLiarCheckBox.Checked, + WarnIndependentSampling = tpeWarnIndependentSamplingCheckBox.Checked + }; + } + + private BoTorch GetBoTorchSettings() + { + return new BoTorch + { + NStartupTrials = (int)boTorchStartupNumUpDown.Value + }; + } + + private NSGAII GetNSGAIISettings() + { + return new NSGAII + { + MutationProb = nsgaMutationProbCheckBox.Checked + ? (double?)nsgaMutationProbUpDown.Value : null, + CrossoverProb = (double)nsgaCrossoverProbUpDown.Value, + SwappingProb = (double)nsgaSwappingProbUpDown.Value, + PopulationSize = (int)nsgaPopulationSizeUpDown.Value + }; + } + + private CmaEs GetCmaEsSettings() + { + return new CmaEs + { + NStartupTrials = (int)cmaEsStartupNumUpDown.Value, + Sigma0 = cmaEsSigmaCheckBox.Checked + ? (double?)cmaEsSigmaNumUpDown.Value : null, + WarnIndependentSampling = cmaEsWarnIndependentSamplingCheckBox.Checked, + ConsiderPrunedTrials = cmaEsConsiderPruneTrialsCheckBox.Checked, + UseSeparableCma = cmaEsUseSaparableCmaCheckBox.Checked, + RestartStrategy = cmaEsRestartCheckBox.Checked ? "ipop" : string.Empty, + IncPopsize = (int)cmaEsIncPopSizeUpDown.Value + }; + } + + private QuasiMonteCarlo GetQMCSettings() + { + return new QuasiMonteCarlo + { + QmcType = qmcTypeComboBox.SelectedIndex == 0 ? "sobol" : "halton", + Scramble = qmcScrambleCheckBox.Checked, + WarnIndependentSampling = qmcWarnIndependentSamplingCheckBox.Checked, + WarnAsynchronousSeeding = qmcWarnAsyncSeedingCheckBox.Checked + }; + } } } From 2f1f4501e0cd01e65153ad592339411f39c010ae Mon Sep 17 00:00:00 2001 From: hrntsm Date: Fri, 19 Aug 2022 20:22:06 +0900 Subject: [PATCH 28/65] Fix constraint wrong description --- Tunny/Component/ConstructFishAttribute.cs | 9 +++++---- 1 file changed, 5 insertions(+), 4 deletions(-) diff --git a/Tunny/Component/ConstructFishAttribute.cs b/Tunny/Component/ConstructFishAttribute.cs index 828192d6..1b1b248b 100644 --- a/Tunny/Component/ConstructFishAttribute.cs +++ b/Tunny/Component/ConstructFishAttribute.cs @@ -12,7 +12,8 @@ namespace Tunny.Component { public class ConstructFishAttribute : GH_Component, IGH_VariableParameterComponent { - private readonly string _geomDescription = "Connect model geometries here. Not required. Large size models are not recommended as it affects the speed of analysis.\"Geometry\" is a special nickname that is visualized with the optimization results. Do not change it."; + private readonly string _geomDescription = "Connect model geometries here. Not required. Large size models are not recommended as it affects the speed of analysis."; + private readonly string _constraintDescription = "A value strictly larger than 0 means that a constraints is violated. A value equal to or smaller than 0 is considered feasible. "; private readonly string _attrDescription = "Attributes to each trial. Attribute name will be the nickname of the input, so change it to any value."; public override GH_Exposure Exposure => GH_Exposure.secondary; @@ -26,7 +27,7 @@ public ConstructFishAttribute() protected override void RegisterInputParams(GH_InputParamManager pManager) { pManager.AddGeometryParameter("Geometry", "Geometry", _geomDescription, GH_ParamAccess.list); - pManager.AddNumberParameter("Constraint", "Constraint", _geomDescription, GH_ParamAccess.list); + pManager.AddNumberParameter("Constraint", "Constraint", _constraintDescription, GH_ParamAccess.item); pManager.AddGenericParameter("Attr1", "Attr1", _attrDescription, GH_ParamAccess.list); pManager.AddGenericParameter("Attr2", "Attr2", _attrDescription, GH_ParamAccess.list); Params.Input[0].Optional = true; @@ -110,7 +111,7 @@ private IGH_Param SetNumberParameterInput() { var p = new Param_Number(); p.Name = p.NickName = $"Constraint"; - p.Description = _attrDescription; + p.Description = _constraintDescription; p.Access = GH_ParamAccess.list; p.MutableNickName = false; p.Optional = true; @@ -122,7 +123,7 @@ private IGH_Param SetGeometryParameterInput() var p = new Param_Geometry(); p.Name = p.NickName = "Geometry"; p.Description = _geomDescription; - p.Access = GH_ParamAccess.list; + p.Access = GH_ParamAccess.item; p.MutableNickName = false; p.Optional = true; return p; From 0b7376b06fd11aca29aea1aa63b3fdfb39d120ce Mon Sep 17 00:00:00 2001 From: hrntsm Date: Fri, 19 Aug 2022 20:39:36 +0900 Subject: [PATCH 29/65] Add default value button --- Tunny/UI/OptimizationWindow.Designer.cs | 86 +++++++++++++++++++---- Tunny/UI/OptimizationWindow.resx | 6 ++ Tunny/UI/OptimizeWindowTab/SettingsTab.cs | 25 +++++++ 3 files changed, 102 insertions(+), 15 deletions(-) diff --git a/Tunny/UI/OptimizationWindow.Designer.cs b/Tunny/UI/OptimizationWindow.Designer.cs index 58c42830..fac7a3a3 100644 --- a/Tunny/UI/OptimizationWindow.Designer.cs +++ b/Tunny/UI/OptimizationWindow.Designer.cs @@ -63,6 +63,7 @@ private void InitializeComponent() this.settingsTabPage = new System.Windows.Forms.TabPage(); this.settingsTabControl = new System.Windows.Forms.TabControl(); this.TPE = new System.Windows.Forms.TabPage(); + this.tpeDefaultButton = new System.Windows.Forms.Button(); this.tpeNEICandidatesLabel = new System.Windows.Forms.Label(); this.tpeNStartupTrialsLabel = new System.Windows.Forms.Label(); this.tpePriorWeightLabel = new System.Windows.Forms.Label(); @@ -77,9 +78,11 @@ private void InitializeComponent() this.tpeConsiderMagicClipCheckBox = new System.Windows.Forms.CheckBox(); this.tpeConsiderPriorCheckBox = new System.Windows.Forms.CheckBox(); this.GP = new System.Windows.Forms.TabPage(); + this.boTorchDefaultButton = new System.Windows.Forms.Button(); this.boTorchNStartupTrialsLabel = new System.Windows.Forms.Label(); this.boTorchStartupNumUpDown = new System.Windows.Forms.NumericUpDown(); this.NSGAII = new System.Windows.Forms.TabPage(); + this.nsgaDefaultButton = new System.Windows.Forms.Button(); this.nsgaMutationProbCheckBox = new System.Windows.Forms.CheckBox(); this.nsgaPopulationSizeLabel = new System.Windows.Forms.Label(); this.nsgaPopulationSizeUpDown = new System.Windows.Forms.NumericUpDown(); @@ -89,10 +92,10 @@ private void InitializeComponent() this.nsgaCrossoverProbUpDown = new System.Windows.Forms.NumericUpDown(); this.nsgaMutationProbUpDown = new System.Windows.Forms.NumericUpDown(); this.CMAES = new System.Windows.Forms.TabPage(); + this.cmaEsDefaultButton = new System.Windows.Forms.Button(); this.cmaEsRestartCheckBox = new System.Windows.Forms.CheckBox(); this.cmaEsUseSaparableCmaCheckBox = new System.Windows.Forms.CheckBox(); this.cmaEsNStartupTrialsLabel = new System.Windows.Forms.Label(); - this.cmaesNStartup = new System.Windows.Forms.Label(); this.cmaEsStartupNumUpDown = new System.Windows.Forms.NumericUpDown(); this.cmaEsConsiderPruneTrialsCheckBox = new System.Windows.Forms.CheckBox(); this.cmaEsWarnIndependentSamplingCheckBox = new System.Windows.Forms.CheckBox(); @@ -101,6 +104,7 @@ private void InitializeComponent() this.cmaEsSigmaCheckBox = new System.Windows.Forms.CheckBox(); this.cmaEsSigmaNumUpDown = new System.Windows.Forms.NumericUpDown(); this.QMC = new System.Windows.Forms.TabPage(); + this.qmcDefaultButton = new System.Windows.Forms.Button(); this.qmcTypeComboBox = new System.Windows.Forms.ComboBox(); this.qmcTypeLabel = new System.Windows.Forms.Label(); this.qmcWarnAsyncSeedingCheckBox = new System.Windows.Forms.CheckBox(); @@ -514,6 +518,7 @@ private void InitializeComponent() // // TPE // + this.TPE.Controls.Add(this.tpeDefaultButton); this.TPE.Controls.Add(this.tpeNEICandidatesLabel); this.TPE.Controls.Add(this.tpeNStartupTrialsLabel); this.TPE.Controls.Add(this.tpePriorWeightLabel); @@ -537,6 +542,17 @@ private void InitializeComponent() this.TPE.ToolTipText = "aaaaa"; this.TPE.UseVisualStyleBackColor = true; // + // tpeDefaultButton + // + this.tpeDefaultButton.Location = new System.Drawing.Point(300, 349); + this.tpeDefaultButton.Name = "tpeDefaultButton"; + this.tpeDefaultButton.Size = new System.Drawing.Size(100, 38); + this.tpeDefaultButton.TabIndex = 13; + this.tpeDefaultButton.Text = "Default"; + this.toolTip1.SetToolTip(this.tpeDefaultButton, "Set to Optuna\'s default value."); + this.tpeDefaultButton.UseVisualStyleBackColor = true; + this.tpeDefaultButton.Click += new System.EventHandler(this.TpeDefaultButton_Click); + // // tpeNEICandidatesLabel // this.tpeNEICandidatesLabel.AutoSize = true; @@ -718,6 +734,7 @@ private void InitializeComponent() // // GP // + this.GP.Controls.Add(this.boTorchDefaultButton); this.GP.Controls.Add(this.boTorchNStartupTrialsLabel); this.GP.Controls.Add(this.boTorchStartupNumUpDown); this.GP.Location = new System.Drawing.Point(4, 32); @@ -728,6 +745,17 @@ private void InitializeComponent() this.GP.Text = "GP"; this.GP.UseVisualStyleBackColor = true; // + // boTorchDefaultButton + // + this.boTorchDefaultButton.Location = new System.Drawing.Point(300, 349); + this.boTorchDefaultButton.Name = "boTorchDefaultButton"; + this.boTorchDefaultButton.Size = new System.Drawing.Size(100, 38); + this.boTorchDefaultButton.TabIndex = 14; + this.boTorchDefaultButton.Text = "Default"; + this.toolTip1.SetToolTip(this.boTorchDefaultButton, "Set to Optuna\'s default value."); + this.boTorchDefaultButton.UseVisualStyleBackColor = true; + this.boTorchDefaultButton.Click += new System.EventHandler(this.BoTorchDefaultButton_Click); + // // boTorchNStartupTrialsLabel // this.boTorchNStartupTrialsLabel.AutoSize = true; @@ -763,6 +791,7 @@ private void InitializeComponent() // // NSGAII // + this.NSGAII.Controls.Add(this.nsgaDefaultButton); this.NSGAII.Controls.Add(this.nsgaMutationProbCheckBox); this.NSGAII.Controls.Add(this.nsgaPopulationSizeLabel); this.NSGAII.Controls.Add(this.nsgaPopulationSizeUpDown); @@ -778,6 +807,17 @@ private void InitializeComponent() this.NSGAII.Text = "NSGAII"; this.NSGAII.UseVisualStyleBackColor = true; // + // nsgaDefaultButton + // + this.nsgaDefaultButton.Location = new System.Drawing.Point(300, 349); + this.nsgaDefaultButton.Name = "nsgaDefaultButton"; + this.nsgaDefaultButton.Size = new System.Drawing.Size(100, 38); + this.nsgaDefaultButton.TabIndex = 23; + this.nsgaDefaultButton.Text = "Default"; + this.toolTip1.SetToolTip(this.nsgaDefaultButton, "Set to Optuna\'s default value."); + this.nsgaDefaultButton.UseVisualStyleBackColor = true; + this.nsgaDefaultButton.Click += new System.EventHandler(this.NsgaDefaultButton_Click); + // // nsgaMutationProbCheckBox // this.nsgaMutationProbCheckBox.AutoSize = true; @@ -910,10 +950,10 @@ private void InitializeComponent() // // CMAES // + this.CMAES.Controls.Add(this.cmaEsDefaultButton); this.CMAES.Controls.Add(this.cmaEsRestartCheckBox); this.CMAES.Controls.Add(this.cmaEsUseSaparableCmaCheckBox); this.CMAES.Controls.Add(this.cmaEsNStartupTrialsLabel); - this.CMAES.Controls.Add(this.cmaesNStartup); this.CMAES.Controls.Add(this.cmaEsStartupNumUpDown); this.CMAES.Controls.Add(this.cmaEsConsiderPruneTrialsCheckBox); this.CMAES.Controls.Add(this.cmaEsWarnIndependentSamplingCheckBox); @@ -928,6 +968,17 @@ private void InitializeComponent() this.CMAES.Text = "CMA-ES"; this.CMAES.UseVisualStyleBackColor = true; // + // cmaEsDefaultButton + // + this.cmaEsDefaultButton.Location = new System.Drawing.Point(300, 349); + this.cmaEsDefaultButton.Name = "cmaEsDefaultButton"; + this.cmaEsDefaultButton.Size = new System.Drawing.Size(100, 38); + this.cmaEsDefaultButton.TabIndex = 33; + this.cmaEsDefaultButton.Text = "Default"; + this.toolTip1.SetToolTip(this.cmaEsDefaultButton, "Set to Optuna\'s default value."); + this.cmaEsDefaultButton.UseVisualStyleBackColor = true; + this.cmaEsDefaultButton.Click += new System.EventHandler(this.CmaEsDefaultButton_Click); + // // cmaEsRestartCheckBox // this.cmaEsRestartCheckBox.AutoSize = true; @@ -955,24 +1006,13 @@ private void InitializeComponent() // cmaEsNStartupTrialsLabel // this.cmaEsNStartupTrialsLabel.AutoSize = true; - this.cmaEsNStartupTrialsLabel.Location = new System.Drawing.Point(7, 7); + this.cmaEsNStartupTrialsLabel.Location = new System.Drawing.Point(7, 5); this.cmaEsNStartupTrialsLabel.Name = "cmaEsNStartupTrialsLabel"; this.cmaEsNStartupTrialsLabel.Size = new System.Drawing.Size(219, 23); this.cmaEsNStartupTrialsLabel.TabIndex = 30; this.cmaEsNStartupTrialsLabel.Text = "Number of startup trials"; this.toolTip1.SetToolTip(this.cmaEsNStartupTrialsLabel, "The independent sampling is used instead of the CMA-ES algorithm\r\nuntil the given" + " number of trials finish in the same study."); - // - // cmaesNStartup - // - this.cmaesNStartup.AutoSize = true; - this.cmaesNStartup.Location = new System.Drawing.Point(7, 5); - this.cmaesNStartup.Name = "cmaesNStartup"; - this.cmaesNStartup.Size = new System.Drawing.Size(219, 23); - this.cmaesNStartup.TabIndex = 30; - this.cmaesNStartup.Text = "Number of startup trials"; - this.toolTip1.SetToolTip(this.cmaesNStartup, "The independent sampling is used instead of the CMA-ES algorithm until the given " + - "number of trials finish in the same study."); // // cmaEsStartupNumUpDown // @@ -1079,6 +1119,7 @@ private void InitializeComponent() // // QMC // + this.QMC.Controls.Add(this.qmcDefaultButton); this.QMC.Controls.Add(this.qmcTypeComboBox); this.QMC.Controls.Add(this.qmcTypeLabel); this.QMC.Controls.Add(this.qmcWarnAsyncSeedingCheckBox); @@ -1091,6 +1132,17 @@ private void InitializeComponent() this.QMC.Text = "QMC"; this.QMC.UseVisualStyleBackColor = true; // + // qmcDefaultButton + // + this.qmcDefaultButton.Location = new System.Drawing.Point(300, 349); + this.qmcDefaultButton.Name = "qmcDefaultButton"; + this.qmcDefaultButton.Size = new System.Drawing.Size(100, 38); + this.qmcDefaultButton.TabIndex = 33; + this.qmcDefaultButton.Text = "Default"; + this.toolTip1.SetToolTip(this.qmcDefaultButton, "Set to Optuna\'s default value."); + this.qmcDefaultButton.UseVisualStyleBackColor = true; + this.qmcDefaultButton.Click += new System.EventHandler(this.QmcDefaultButton_Click); + // // qmcTypeComboBox // this.qmcTypeComboBox.FormattingEnabled = true; @@ -1308,7 +1360,6 @@ private void InitializeComponent() private System.Windows.Forms.CheckBox cmaEsRestartCheckBox; private System.Windows.Forms.CheckBox cmaEsUseSaparableCmaCheckBox; private System.Windows.Forms.Label cmaEsNStartupTrialsLabel; - private System.Windows.Forms.Label cmaesNStartup; private System.Windows.Forms.NumericUpDown cmaEsStartupNumUpDown; private System.Windows.Forms.CheckBox cmaEsConsiderPruneTrialsCheckBox; private System.Windows.Forms.CheckBox cmaEsWarnIndependentSamplingCheckBox; @@ -1321,6 +1372,11 @@ private void InitializeComponent() private System.Windows.Forms.Label qmcTypeLabel; private System.Windows.Forms.CheckBox qmcWarnAsyncSeedingCheckBox; private System.Windows.Forms.CheckBox qmcScrambleCheckBox; + private System.Windows.Forms.Button tpeDefaultButton; + private System.Windows.Forms.Button boTorchDefaultButton; + private System.Windows.Forms.Button nsgaDefaultButton; + private System.Windows.Forms.Button cmaEsDefaultButton; + private System.Windows.Forms.Button qmcDefaultButton; } } diff --git a/Tunny/UI/OptimizationWindow.resx b/Tunny/UI/OptimizationWindow.resx index bc95beb2..046c6637 100644 --- a/Tunny/UI/OptimizationWindow.resx +++ b/Tunny/UI/OptimizationWindow.resx @@ -129,6 +129,12 @@ the covariance matrix is constrained to be diagonal. Due to reduce the model complexity, the learning rate for the covariance matrix is increased. Consequently, this algorithm outperforms CMA-ES on separable functions. + + 633, 17 + + + 633, 17 + 17, 17 diff --git a/Tunny/UI/OptimizeWindowTab/SettingsTab.cs b/Tunny/UI/OptimizeWindowTab/SettingsTab.cs index ecf93c86..cc383eaf 100644 --- a/Tunny/UI/OptimizeWindowTab/SettingsTab.cs +++ b/Tunny/UI/OptimizeWindowTab/SettingsTab.cs @@ -22,6 +22,31 @@ private void CmaEsRestartStrategyCheckedChanged(object sender, EventArgs e) cmaEsIncPopSizeUpDown.Enabled = cmaEsRestartCheckBox.Checked; } + private void TpeDefaultButton_Click(object sender, EventArgs e) + { + SetTpeSettings(new Tpe()); + } + + private void NsgaDefaultButton_Click(object sender, EventArgs e) + { + SetNSGAIISettings(new NSGAII()); + } + + private void CmaEsDefaultButton_Click(object sender, EventArgs e) + { + SetCmaEsSettings(new CmaEs()); + } + + private void BoTorchDefaultButton_Click(object sender, EventArgs e) + { + SetBoTorchSettings(new BoTorch()); + } + + private void QmcDefaultButton_Click(object sender, EventArgs e) + { + SetQMCSettings(new QuasiMonteCarlo()); + } + private void InitializeSamplerSettings() { Sampler sampler = _settings.Optimize.Sampler; From e5d1b626e84cf5585ea6e6fda1f9ebe365862e09 Mon Sep 17 00:00:00 2001 From: hrntsm Date: Fri, 19 Aug 2022 20:42:26 +0900 Subject: [PATCH 30/65] Update CHANGELOG --- CHANGELOG.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/CHANGELOG.md b/CHANGELOG.md index 9e03be63..46ffc40b 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -18,6 +18,8 @@ Please see [here](https://github.com/hrntsm/Tunny/releases) for the data release - [Detail](https://optuna.readthedocs.io/en/latest/reference/samplers/generated/optuna.samplers.QMCSampler.html) - Support Constraint. - Only TPE, GP, NSGAII can use constraint. +- Sampler detail settings UI + - Previously it was necessary to change the JSON file of the settings, but now it can be changed in the UI ### Changed From 1a7b6522cd7e5d7f1b179bf009e308eb906e1c79 Mon Sep 17 00:00:00 2001 From: hrntsm Date: Sat, 20 Aug 2022 12:41:57 +0900 Subject: [PATCH 31/65] Fix tooltip typo --- Tunny/UI/OptimizationWindow.Designer.cs | 2 -- 1 file changed, 2 deletions(-) diff --git a/Tunny/UI/OptimizationWindow.Designer.cs b/Tunny/UI/OptimizationWindow.Designer.cs index fac7a3a3..c5780d6d 100644 --- a/Tunny/UI/OptimizationWindow.Designer.cs +++ b/Tunny/UI/OptimizationWindow.Designer.cs @@ -538,8 +538,6 @@ private void InitializeComponent() this.TPE.Size = new System.Drawing.Size(406, 393); this.TPE.TabIndex = 0; this.TPE.Text = "TPE"; - this.toolTip1.SetToolTip(this.TPE, "aa"); - this.TPE.ToolTipText = "aaaaa"; this.TPE.UseVisualStyleBackColor = true; // // tpeDefaultButton From 76b4323bb20f93be2671ca9962177688049f2a58 Mon Sep 17 00:00:00 2001 From: hrntsm Date: Sat, 20 Aug 2022 21:52:45 +0900 Subject: [PATCH 32/65] Fix pareto front too long attr disp --- Tunny/Solver/Optuna/Optuna.cs | 26 +++++++++++++++++++++++++- 1 file changed, 25 insertions(+), 1 deletion(-) diff --git a/Tunny/Solver/Optuna/Optuna.cs b/Tunny/Solver/Optuna/Optuna.cs index 8e7b0191..9ce7e46d 100644 --- a/Tunny/Solver/Optuna/Optuna.cs +++ b/Tunny/Solver/Optuna/Optuna.cs @@ -149,7 +149,8 @@ private void ShowPlot(dynamic optuna, string visualize, dynamic study, string[] optuna.visualization.plot_param_importances(study, target_name: nickNames[0]).show(); break; case "pareto front": - optuna.visualization.plot_pareto_front(study, target_names: nickNames, constraints_func: _hasConstraint ? Sampler.ConstraintFunc() : null).show(); + dynamic fig = optuna.visualization.plot_pareto_front(study, target_names: nickNames, constraints_func: _hasConstraint ? Sampler.ConstraintFunc() : null); + TruncateParetoFront(fig, study).show(); break; case "slice": optuna.visualization.plot_slice(study, target_name: nickNames[0]).show(); @@ -163,6 +164,29 @@ private void ShowPlot(dynamic optuna, string visualize, dynamic study, string[] } } + private static dynamic TruncateParetoFront(dynamic fig, dynamic study) + { + PyModule ps = Py.CreateScope(); + ps.Exec( + "def truncate(fig, study):\n" + + " import json\n" + + " user_attr = study.trials[0].user_attrs\n" + + " has_geometry = 'Geometry' in user_attr\n" + + " if has_geometry == False:\n" + + " return fig\n" + + " for scatter_id in range(len(fig.data)):\n" + + " new_texts = []\n" + + " for i, original_label in enumerate(fig.data[scatter_id]['text']):\n" + + " json_label = json.loads(original_label.replace('
', '\\n'))\n" + + " json_label['user_attrs']['Geometry'] = 'True'\n" + + " new_texts.append(json.dumps(json_label, indent=2).replace('\\n', '
'))\n" + + " fig.data[scatter_id]['text'] = new_texts\n" + + " return fig\n" + ); + dynamic truncate = ps.Get("truncate"); + return truncate(fig, study); + } + private static dynamic PlotHypervolume(dynamic optuna, dynamic study) { From 610d9ecf1406481187827f24ddbb3a8c038d7118 Mon Sep 17 00:00:00 2001 From: hrntsm Date: Sun, 21 Aug 2022 17:35:04 +0900 Subject: [PATCH 33/65] Fix constraint input to item input --- Tunny/Component/ConstructFishAttribute.cs | 33 ++++++++++++++++------- 1 file changed, 24 insertions(+), 9 deletions(-) diff --git a/Tunny/Component/ConstructFishAttribute.cs b/Tunny/Component/ConstructFishAttribute.cs index 1b1b248b..e79e3c66 100644 --- a/Tunny/Component/ConstructFishAttribute.cs +++ b/Tunny/Component/ConstructFishAttribute.cs @@ -52,18 +52,33 @@ protected override void SolveInstance(IGH_DataAccess DA) return; } + GetInputData(DA, paramCount, dict); + DA.SetData(0, dict); + } + + private void GetInputData(IGH_DataAccess DA, int paramCount, Dictionary dict) + { for (int i = 0; i < paramCount; i++) { - var list = new List(); - if (!DA.GetDataList(i, list)) + string key = Params.Input[i].NickName; + if (i == 1) { - continue; + double constraint = 0; + if (DA.GetData(i, ref constraint)) + { + dict.Add(key, constraint); + } + } + else + { + var list = new List(); + if (!DA.GetDataList(i, list)) + { + continue; + } + dict.Add(key, list); } - string key = Params.Input[i].NickName; - dict.Add(key, list); } - - DA.SetData(0, dict); } //FIXME: Should be modified to capture and check for change events. @@ -82,9 +97,9 @@ private bool CheckIsNicknameDuplicated() return false; } - public bool CanInsertParameter(GH_ParameterSide side, int index) => side != GH_ParameterSide.Output && (Params.Input.Count == 0 || index != 0); + public bool CanInsertParameter(GH_ParameterSide side, int index) => side != GH_ParameterSide.Output && (Params.Input.Count == 0 || index >= 2); - public bool CanRemoveParameter(GH_ParameterSide side, int index) => side != GH_ParameterSide.Output && index != 0; + public bool CanRemoveParameter(GH_ParameterSide side, int index) => side != GH_ParameterSide.Output && index >= 2; public IGH_Param CreateParameter(GH_ParameterSide side, int index) { From df57c5ff72ce7a5ca05b5902bb80766707c7c9c7 Mon Sep 17 00:00:00 2001 From: hrntsm Date: Sun, 21 Aug 2022 18:49:59 +0900 Subject: [PATCH 34/65] Fix result constraint serialize error --- Tunny/Solver/Optuna/Optuna.cs | 15 ++++++++++++--- Tunny/Type/GH_Fish.cs | 8 ++++++-- 2 files changed, 18 insertions(+), 5 deletions(-) diff --git a/Tunny/Solver/Optuna/Optuna.cs b/Tunny/Solver/Optuna/Optuna.cs index 9ce7e46d..26503ca4 100644 --- a/Tunny/Solver/Optuna/Optuna.cs +++ b/Tunny/Solver/Optuna/Optuna.cs @@ -378,10 +378,19 @@ private static Dictionary> ParseAttributes(dynamic trial) string[] keys = (string[])trial.user_attrs.keys(); for (int i = 0; i < keys.Length; i++) { - string[] values = (string[])trial.user_attrs[keys[i]]; - attributes.Add(keys[i], values.ToList()); + var values = new List(); + if (keys[i] == "Constraint") + { + double[] constraint = (double[])trial.user_attrs[keys[i]]; + values = constraint.Select(v => v.ToString()).ToList(); + } + else + { + string[] valueArray = (string[])trial.user_attrs[keys[i]]; + values = valueArray.ToList(); + } + attributes.Add(keys[i], values); } - return attributes; } } diff --git a/Tunny/Type/GH_Fish.cs b/Tunny/Type/GH_Fish.cs index aaa3674f..a5a3aa9a 100644 --- a/Tunny/Type/GH_Fish.cs +++ b/Tunny/Type/GH_Fish.cs @@ -78,12 +78,16 @@ private void SetAttributeEachItem(StringBuilder sb, KeyValuePair if (attr.Key == "Geometry") { List geometries = Value.GetGeometries(); - foreach (GeometryBase geom in geometries) + for (int i = 0; i < 5; i++) { - string geomString = Converter.GeometryBaseToGoo(geom).ToString(); + string geomString = Converter.GeometryBaseToGoo(geometries[i]).ToString(); valueStrings.Append("\n "); valueStrings.Append(geomString); } + if (geometries.Count > 5) + { + valueStrings.Append("....."); + } } else { From fee05722186e8628f1da6040d3d905f328fb0de8 Mon Sep 17 00:00:00 2001 From: hrntsm Date: Sun, 21 Aug 2022 21:10:44 +0900 Subject: [PATCH 35/65] Add TextBake --- Samples/sample.gh | Bin 202055 -> 214803 bytes Tunny/Component/FishMarket.cs | 33 +++++++++++++++++++++++++++++++++ Tunny/Type/GH_Fish.cs | 3 ++- 3 files changed, 35 insertions(+), 1 deletion(-) diff --git a/Samples/sample.gh b/Samples/sample.gh index 798c6506775b13c7e1c9d40d3f939ea02bbf179b..acdb86edb5d51ad1b2ab884f89174b3f793fb956 100644 GIT binary patch literal 214803 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໭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%0D|CQPfhvgb_KEc@nB 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 Xw{Am<4gd25zNPhCU+trcO~n5I$U%e; literal 202055 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%0D99svT3xr7 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�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 obj_ids) + { + base.BakeGeometry(doc, obj_ids); + + for (int i = 0; i < _fishes.Count; i++) + { + var text3d = new Text3d(_fishes[i].ToString(), _tagPlanes[i], _size); + Vector3d diagonal = text3d.BoundingBox.Diagonal; + Vector3d axisY = _tagPlanes[i].YAxis; + axisY.Unitize(); + Vector3d vecY = -axisY * diagonal.Y; + var pln = new Plane(_tagPlanes[i].Origin + vecY, _tagPlanes[i].Normal); + doc.Objects.AddText(_fishes[i].ToString(), pln, _size, "Meiryo", false, false); + } + } + + public override void AppendAdditionalMenuItems(ToolStripDropDown menu) + { + base.AppendAdditionalMenuItems(menu); + ToolStripMenuItem item = Menu_AppendItem(menu, "Bake with Text", BakeGeometryFromMenu); + item.ToolTipText = "Bake not only geometry, but also result texts."; + } + + private void BakeGeometryFromMenu(object sender, EventArgs e) + { + RhinoDoc doc = RhinoDoc.ActiveDoc; + var objIds = new List(); + BakeGeometry(doc, objIds); + doc.Views.Redraw(); + } + protected override Bitmap Icon => Resource.FishMarket; public override Guid ComponentGuid => new Guid("46E05DFF-8EFD-418A-AC5B-7C9F24559B2E"); diff --git a/Tunny/Type/GH_Fish.cs b/Tunny/Type/GH_Fish.cs index a5a3aa9a..fb22b8a1 100644 --- a/Tunny/Type/GH_Fish.cs +++ b/Tunny/Type/GH_Fish.cs @@ -78,7 +78,8 @@ private void SetAttributeEachItem(StringBuilder sb, KeyValuePair if (attr.Key == "Geometry") { List geometries = Value.GetGeometries(); - for (int i = 0; i < 5; i++) + int maxLength = geometries.Count > 5 ? 5 : geometries.Count; + for (int i = 0; i < maxLength; i++) { string geomString = Converter.GeometryBaseToGoo(geometries[i]).ToString(); valueStrings.Append("\n "); From be99d7119f082223a6b7ba230350c53b00ef587c Mon Sep 17 00:00:00 2001 From: hrntsm Date: Sun, 21 Aug 2022 21:12:47 +0900 Subject: [PATCH 36/65] Update CHANGELOG --- CHANGELOG.md | 1 + 1 file changed, 1 insertion(+) diff --git a/CHANGELOG.md b/CHANGELOG.md index 46ffc40b..c7c83b3e 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -20,6 +20,7 @@ Please see [here](https://github.com/hrntsm/Tunny/releases) for the data release - Only TPE, GP, NSGAII can use constraint. - Sampler detail settings UI - Previously it was necessary to change the JSON file of the settings, but now it can be changed in the UI +- Enable Text Bake in the FishMarket component. ### Changed From 29a4d1766b42f4c7c5683fcea6b6c02a4bf41a1c Mon Sep 17 00:00:00 2001 From: hrntsm Date: Sun, 21 Aug 2022 23:29:07 +0900 Subject: [PATCH 37/65] Fix load constraint value error --- Tunny/Util/GrasshopperInOut.cs | 22 ++++++++++++++++------ 1 file changed, 16 insertions(+), 6 deletions(-) diff --git a/Tunny/Util/GrasshopperInOut.cs b/Tunny/Util/GrasshopperInOut.cs index 03fdf82a..7acd76c1 100644 --- a/Tunny/Util/GrasshopperInOut.cs +++ b/Tunny/Util/GrasshopperInOut.cs @@ -11,8 +11,6 @@ using Grasshopper.Kernel.Special; using Grasshopper.Kernel.Types; -using Rhino.FileIO; - using Tunny.Component; using Tunny.Type; using Tunny.UI; @@ -378,14 +376,26 @@ public Dictionary> GetAttributes() } var value = new List(); - var objList = _attributes.Value[key] as List; - foreach (object param in objList) + if (key == "Constraint") + { + object obj = _attributes.Value[key]; + if (obj is double val) + { + value.Add(val.ToString()); + } + } + else { - if (param is IGH_Goo goo) + var objList = _attributes.Value[key] as List; + foreach (object param in objList) { - value.Add(Converter.GooToString(goo, true)); + if (param is IGH_Goo goo) + { + value.Add(Converter.GooToString(goo, true)); + } } } + attrs.Add(key, value); } From 03d8eb3f52c190150622144a4a2b4162d8f9ed87 Mon Sep 17 00:00:00 2001 From: hrntsm Date: Mon, 22 Aug 2022 10:30:33 +0900 Subject: [PATCH 38/65] Fix FishMarket to use text jestify --- Tunny/Component/FishMarket.cs | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/Tunny/Component/FishMarket.cs b/Tunny/Component/FishMarket.cs index 30dc3dc3..811af63a 100644 --- a/Tunny/Component/FishMarket.cs +++ b/Tunny/Component/FishMarket.cs @@ -185,7 +185,7 @@ public override void BakeGeometry(RhinoDoc doc, List obj_ids) axisY.Unitize(); Vector3d vecY = -axisY * diagonal.Y; var pln = new Plane(_tagPlanes[i].Origin + vecY, _tagPlanes[i].Normal); - doc.Objects.AddText(_fishes[i].ToString(), pln, _size, "Meiryo", false, false); + doc.Objects.AddText(_fishes[i].ToString(), _tagPlanes[i], _size, "Meiryo", false, false, TextJustification.TopLeft); } } From 9ecb997ab59e92d0272e7af5934a9be37966d934 Mon Sep 17 00:00:00 2001 From: hrntsm Date: Mon, 22 Aug 2022 10:31:27 +0900 Subject: [PATCH 39/65] Clean code --- Tunny/Component/FishMarket.cs | 6 ------ 1 file changed, 6 deletions(-) diff --git a/Tunny/Component/FishMarket.cs b/Tunny/Component/FishMarket.cs index 811af63a..7dc2f5da 100644 --- a/Tunny/Component/FishMarket.cs +++ b/Tunny/Component/FishMarket.cs @@ -179,12 +179,6 @@ public override void BakeGeometry(RhinoDoc doc, List obj_ids) for (int i = 0; i < _fishes.Count; i++) { - var text3d = new Text3d(_fishes[i].ToString(), _tagPlanes[i], _size); - Vector3d diagonal = text3d.BoundingBox.Diagonal; - Vector3d axisY = _tagPlanes[i].YAxis; - axisY.Unitize(); - Vector3d vecY = -axisY * diagonal.Y; - var pln = new Plane(_tagPlanes[i].Origin + vecY, _tagPlanes[i].Normal); doc.Objects.AddText(_fishes[i].ToString(), _tagPlanes[i], _size, "Meiryo", false, false, TextJustification.TopLeft); } } From 91f0790934feb189ae8830340b3527ef074cedba Mon Sep 17 00:00:00 2001 From: hrntsm Date: Wed, 24 Aug 2022 22:23:44 +0900 Subject: [PATCH 40/65] Add kmeans plot ui --- Tunny/Settings/Result.cs | 1 + Tunny/Solver/Optuna/Optuna.cs | 80 +++++++++++++++++++++- Tunny/UI/OptimizationWindow.Designer.cs | 70 +++++++++++++++++-- Tunny/UI/OptimizationWindow.resx | 9 +-- Tunny/UI/OptimizeWindowTab/VisualizeTab.cs | 6 ++ 5 files changed, 152 insertions(+), 14 deletions(-) diff --git a/Tunny/Settings/Result.cs b/Tunny/Settings/Result.cs index 3d721548..e3846293 100644 --- a/Tunny/Settings/Result.cs +++ b/Tunny/Settings/Result.cs @@ -4,5 +4,6 @@ public class Result { public string OutputNumberString { get; set; } = "0"; public int SelectVisualizeType { get; set; } = 3; + public int NumberOfClusters { get; set; } = 3; } } diff --git a/Tunny/Solver/Optuna/Optuna.cs b/Tunny/Solver/Optuna/Optuna.cs index 26503ca4..01c43b86 100644 --- a/Tunny/Solver/Optuna/Optuna.cs +++ b/Tunny/Solver/Optuna/Optuna.cs @@ -150,7 +150,7 @@ private void ShowPlot(dynamic optuna, string visualize, dynamic study, string[] break; case "pareto front": dynamic fig = optuna.visualization.plot_pareto_front(study, target_names: nickNames, constraints_func: _hasConstraint ? Sampler.ConstraintFunc() : null); - TruncateParetoFront(fig, study).show(); + TruncateParetoFrontPlotHover(fig, study).show(); break; case "slice": optuna.visualization.plot_slice(study, target_name: nickNames[0]).show(); @@ -164,7 +164,7 @@ private void ShowPlot(dynamic optuna, string visualize, dynamic study, string[] } } - private static dynamic TruncateParetoFront(dynamic fig, dynamic study) + private static dynamic TruncateParetoFrontPlotHover(dynamic fig, dynamic study) { PyModule ps = Py.CreateScope(); ps.Exec( @@ -178,7 +178,7 @@ private static dynamic TruncateParetoFront(dynamic fig, dynamic study) " new_texts = []\n" + " for i, original_label in enumerate(fig.data[scatter_id]['text']):\n" + " json_label = json.loads(original_label.replace('
', '\\n'))\n" + - " json_label['user_attrs']['Geometry'] = 'True'\n" + + " json_label['user_attrs'].pop('Geometry')\n" + " new_texts.append(json.dumps(json_label, indent=2).replace('\\n', '
'))\n" + " fig.data[scatter_id]['text'] = new_texts\n" + " return fig\n" @@ -256,6 +256,80 @@ private static dynamic CreateHypervolumeFigure(dynamic[] trials, PyList hvs, PyL return fig; } + public void ShowClusteringPlot(string studyName, int numCluster) + { + string storage = "sqlite:///" + _settings.Storage; + PythonEngine.Initialize(); + using (Py.GIL()) + { + dynamic study; + dynamic optuna = Py.Import("optuna"); + try + { + study = optuna.load_study(storage: storage, study_name: studyName); + } + catch (Exception e) + { + TunnyMessageBox.Show(e.Message, "Tunny", MessageBoxButtons.OK, MessageBoxIcon.Error); + return; + } + + string[] nickNames = ((string)study.user_attrs["objective_names"]).Split(','); + try + { + ShowCluster(optuna, study, nickNames, numCluster); + } + catch (Exception) + { + TunnyMessageBox.Show("Clustering Error", "Tunny", MessageBoxButtons.OK, MessageBoxIcon.Error); + } + } + PythonEngine.Shutdown(); + + } + + private void ShowCluster(dynamic optuna, dynamic study, string[] nickNames, int numCluster) + { + dynamic fig = optuna.visualization.plot_pareto_front(study, target_names: nickNames, constraints_func: _hasConstraint ? Sampler.ConstraintFunc() : null); + fig = TruncateParetoFrontPlotHover(fig, study); + ClusteringParetoFrontPlot(fig, study, numCluster).show(); + } + + private static dynamic ClusteringParetoFrontPlot(dynamic fig, dynamic study, int numCluster) + { + PyModule ps = Py.CreateScope(); + ps.Exec( + "def clustering(fig, study, num):\n" + + " from sklearn.cluster import KMeans\n" + + + " if 'Constraints' in study.trials[0].user_attrs:\n" + + " best_values = [trial.values for trial in study.best_trials if max(trial.user_attrs['Constraints']) <= 0]\n" + + " else:\n" + + " best_values = [trial.values for trial in study.best_trials]\n" + + + " kmeans = KMeans(n_clusters=num).fit(best_values)\n" + + " labels = kmeans.labels_\n" + + " best_length = len(best_values)\n" + + + " for scatter_id in range(len(fig.data)):\n" + + " color = fig.data[scatter_id]['marker']['color']\n" + + " if (len(color) == best_length):\n" + + " fig.data[scatter_id]['marker']['color'] = labels\n" + + " fig.data[scatter_id]['marker']['colorscale'] = 'rainbow'\n" + + " fig.data[scatter_id]['marker']['colorbar']['title'] = '# Cluster'\n" + + " elif fig.data[scatter_id]['marker']['color'] == '#cccccc':\n" + + " pass\n" + + " else:\n" + + " new_color = ['#cccccc' for c in color]\n" + + " fig.data[scatter_id]['marker']['color'] = new_color\n" + + " fig.data[scatter_id]['marker'].pop('colorscale')\n" + + " fig.data[scatter_id]['marker'].pop('colorbar')\n" + + " return fig\n" + ); + dynamic clustering = ps.Get("clustering"); + return clustering(fig, study, numCluster); + } + public ModelResult[] GetModelResult(int[] resultNum, string studyName, BackgroundWorker worker) { string storage = "sqlite:///" + _settings.Storage; diff --git a/Tunny/UI/OptimizationWindow.Designer.cs b/Tunny/UI/OptimizationWindow.Designer.cs index c5780d6d..122d358d 100644 --- a/Tunny/UI/OptimizationWindow.Designer.cs +++ b/Tunny/UI/OptimizationWindow.Designer.cs @@ -47,6 +47,10 @@ private void InitializeComponent() this.timeoutNumUpDown = new System.Windows.Forms.NumericUpDown(); this.Timeout = new System.Windows.Forms.Label(); this.visualizeTabPage = new System.Windows.Forms.TabPage(); + this.visualizeClusteringPlotButton = new System.Windows.Forms.Button(); + this.visualizeNumClusterLabel = new System.Windows.Forms.Label(); + this.visualizeClusterNumUpDown = new System.Windows.Forms.NumericUpDown(); + this.visualizeClusteringLabel = new System.Windows.Forms.Label(); this.dashboardButton = new System.Windows.Forms.Button(); this.visualizeButton = new System.Windows.Forms.Button(); this.visualizeTypeLabel = new System.Windows.Forms.Label(); @@ -120,6 +124,7 @@ private void InitializeComponent() this.optimizeTabPage.SuspendLayout(); ((System.ComponentModel.ISupportInitialize)(this.timeoutNumUpDown)).BeginInit(); this.visualizeTabPage.SuspendLayout(); + ((System.ComponentModel.ISupportInitialize)(this.visualizeClusterNumUpDown)).BeginInit(); this.outputTabPage.SuspendLayout(); this.settingsTabPage.SuspendLayout(); this.settingsTabControl.SuspendLayout(); @@ -327,6 +332,10 @@ private void InitializeComponent() // // visualizeTabPage // + this.visualizeTabPage.Controls.Add(this.visualizeClusteringPlotButton); + this.visualizeTabPage.Controls.Add(this.visualizeNumClusterLabel); + this.visualizeTabPage.Controls.Add(this.visualizeClusterNumUpDown); + this.visualizeTabPage.Controls.Add(this.visualizeClusteringLabel); this.visualizeTabPage.Controls.Add(this.dashboardButton); this.visualizeTabPage.Controls.Add(this.visualizeButton); this.visualizeTabPage.Controls.Add(this.visualizeTypeLabel); @@ -340,6 +349,53 @@ private void InitializeComponent() this.visualizeTabPage.Text = "Visualize"; this.visualizeTabPage.UseVisualStyleBackColor = true; // + // visualizeClusteringPlotButton + // + this.visualizeClusteringPlotButton.Location = new System.Drawing.Point(54, 343); + this.visualizeClusteringPlotButton.Margin = new System.Windows.Forms.Padding(4, 6, 4, 6); + this.visualizeClusteringPlotButton.Name = "visualizeClusteringPlotButton"; + this.visualizeClusteringPlotButton.Size = new System.Drawing.Size(323, 39); + this.visualizeClusteringPlotButton.TabIndex = 15; + this.visualizeClusteringPlotButton.Text = "Show clustering plot"; + this.visualizeClusteringPlotButton.UseVisualStyleBackColor = true; + this.visualizeClusteringPlotButton.Click += new System.EventHandler(this.VisualizeClusteringPlotButton_Click); + // + // visualizeNumClusterLabel + // + this.visualizeNumClusterLabel.AutoSize = true; + this.visualizeNumClusterLabel.Location = new System.Drawing.Point(50, 306); + this.visualizeNumClusterLabel.Name = "visualizeNumClusterLabel"; + this.visualizeNumClusterLabel.Size = new System.Drawing.Size(166, 23); + this.visualizeNumClusterLabel.TabIndex = 14; + this.visualizeNumClusterLabel.Text = "Number of cluster"; + // + // visualizeClusterNumUpDown + // + this.visualizeClusterNumUpDown.Location = new System.Drawing.Point(284, 304); + this.visualizeClusterNumUpDown.Minimum = new decimal(new int[] { + 1, + 0, + 0, + 0}); + this.visualizeClusterNumUpDown.Name = "visualizeClusterNumUpDown"; + this.visualizeClusterNumUpDown.Size = new System.Drawing.Size(93, 30); + this.visualizeClusterNumUpDown.TabIndex = 13; + this.visualizeClusterNumUpDown.Value = new decimal(new int[] { + 3, + 0, + 0, + 0}); + // + // visualizeClusteringLabel + // + this.visualizeClusteringLabel.AutoSize = true; + this.visualizeClusteringLabel.Location = new System.Drawing.Point(25, 261); + this.visualizeClusteringLabel.Margin = new System.Windows.Forms.Padding(4, 0, 4, 0); + this.visualizeClusteringLabel.Name = "visualizeClusteringLabel"; + this.visualizeClusteringLabel.Size = new System.Drawing.Size(175, 23); + this.visualizeClusteringLabel.TabIndex = 12; + this.visualizeClusteringLabel.Text = "k-means clustering"; + // // dashboardButton // this.dashboardButton.Location = new System.Drawing.Point(54, 40); @@ -353,7 +409,7 @@ private void InitializeComponent() // // visualizeButton // - this.visualizeButton.Location = new System.Drawing.Point(54, 207); + this.visualizeButton.Location = new System.Drawing.Point(54, 191); this.visualizeButton.Margin = new System.Windows.Forms.Padding(4, 6, 4, 6); this.visualizeButton.Name = "visualizeButton"; this.visualizeButton.Size = new System.Drawing.Size(323, 39); @@ -365,7 +421,7 @@ private void InitializeComponent() // visualizeTypeLabel // this.visualizeTypeLabel.AutoSize = true; - this.visualizeTypeLabel.Location = new System.Drawing.Point(25, 125); + this.visualizeTypeLabel.Location = new System.Drawing.Point(25, 109); this.visualizeTypeLabel.Margin = new System.Windows.Forms.Padding(4, 0, 4, 0); this.visualizeTypeLabel.Name = "visualizeTypeLabel"; this.visualizeTypeLabel.Size = new System.Drawing.Size(130, 23); @@ -385,7 +441,7 @@ private void InitializeComponent() "pareto front", "slice", "hypervolume"}); - this.visualizeTypeComboBox.Location = new System.Drawing.Point(54, 164); + this.visualizeTypeComboBox.Location = new System.Drawing.Point(54, 148); this.visualizeTypeComboBox.Margin = new System.Windows.Forms.Padding(4, 6, 4, 6); this.visualizeTypeComboBox.Name = "visualizeTypeComboBox"; this.visualizeTypeComboBox.Size = new System.Drawing.Size(323, 31); @@ -427,7 +483,7 @@ private void InitializeComponent() this.outputParatoSolutionButton.Name = "outputParatoSolutionButton"; this.outputParatoSolutionButton.Size = new System.Drawing.Size(297, 34); this.outputParatoSolutionButton.TabIndex = 17; - this.outputParatoSolutionButton.Text = "Parato solutions"; + this.outputParatoSolutionButton.Text = "Pareto solutions"; this.outputParatoSolutionButton.UseVisualStyleBackColor = true; this.outputParatoSolutionButton.Click += new System.EventHandler(this.OutputParatoSolutionButton_Click); // @@ -471,7 +527,6 @@ private void InitializeComponent() this.outputModelNumberButton.TabIndex = 13; this.outputModelNumberButton.Text = "Output"; this.outputModelNumberButton.UseVisualStyleBackColor = true; - this.outputModelNumberButton.Click += new System.EventHandler(this.OutputModelNumberButton_Click); // // outputModelNumTextBox // @@ -1259,6 +1314,7 @@ private void InitializeComponent() ((System.ComponentModel.ISupportInitialize)(this.timeoutNumUpDown)).EndInit(); this.visualizeTabPage.ResumeLayout(false); this.visualizeTabPage.PerformLayout(); + ((System.ComponentModel.ISupportInitialize)(this.visualizeClusterNumUpDown)).EndInit(); this.outputTabPage.ResumeLayout(false); this.outputTabPage.PerformLayout(); this.settingsTabPage.ResumeLayout(false); @@ -1375,6 +1431,10 @@ private void InitializeComponent() private System.Windows.Forms.Button nsgaDefaultButton; private System.Windows.Forms.Button cmaEsDefaultButton; private System.Windows.Forms.Button qmcDefaultButton; + private System.Windows.Forms.Label visualizeNumClusterLabel; + private System.Windows.Forms.NumericUpDown visualizeClusterNumUpDown; + private System.Windows.Forms.Label visualizeClusteringLabel; + private System.Windows.Forms.Button visualizeClusteringPlotButton; } } diff --git a/Tunny/UI/OptimizationWindow.resx b/Tunny/UI/OptimizationWindow.resx index 046c6637..a9924921 100644 --- a/Tunny/UI/OptimizationWindow.resx +++ b/Tunny/UI/OptimizationWindow.resx @@ -123,18 +123,15 @@ 633, 17 + + 633, 17 + If this is True, the covariance matrix is constrained to be diagonal. Due to reduce the model complexity, the learning rate for the covariance matrix is increased. Consequently, this algorithm outperforms CMA-ES on separable functions. - - 633, 17 - - - 633, 17 - 17, 17 diff --git a/Tunny/UI/OptimizeWindowTab/VisualizeTab.cs b/Tunny/UI/OptimizeWindowTab/VisualizeTab.cs index 3a16e4b3..0b0e5980 100644 --- a/Tunny/UI/OptimizeWindowTab/VisualizeTab.cs +++ b/Tunny/UI/OptimizeWindowTab/VisualizeTab.cs @@ -29,5 +29,11 @@ private void SelectedTypePlotButton_Click(object sender, EventArgs e) var optuna = new Optuna(_component.GhInOut.ComponentFolder, _settings, _component.GhInOut.HasConstraint); optuna.ShowSelectedTypePlot(visualizeTypeComboBox.Text, studyNameTextBox.Text); } + + private void VisualizeClusteringPlotButton_Click(object sender, EventArgs e) + { + var optuna = new Optuna(_component.GhInOut.ComponentFolder, _settings, _component.GhInOut.HasConstraint); + optuna.ShowClusteringPlot(studyNameTextBox.Text, (int)visualizeClusterNumUpDown.Value); + } } } From 42a60b04981b322da2fe42b70b46ede09ddcb353 Mon Sep 17 00:00:00 2001 From: hrntsm Date: Thu, 25 Aug 2022 12:22:50 +0900 Subject: [PATCH 41/65] Update clustering to handle result with constraint --- Tunny/Solver/Optuna/Optuna.cs | 26 ++++++++++++++++++++++---- Tunny/Solver/Optuna/Sampler.cs | 1 - 2 files changed, 22 insertions(+), 5 deletions(-) diff --git a/Tunny/Solver/Optuna/Optuna.cs b/Tunny/Solver/Optuna/Optuna.cs index 01c43b86..b2137339 100644 --- a/Tunny/Solver/Optuna/Optuna.cs +++ b/Tunny/Solver/Optuna/Optuna.cs @@ -298,15 +298,33 @@ private void ShowCluster(dynamic optuna, dynamic study, string[] nickNames, int private static dynamic ClusteringParetoFrontPlot(dynamic fig, dynamic study, int numCluster) { PyModule ps = Py.CreateScope(); + //FIXME: Rewrite to c-sharp code. ps.Exec( "def clustering(fig, study, num):\n" + " from sklearn.cluster import KMeans\n" + - - " if 'Constraints' in study.trials[0].user_attrs:\n" + - " best_values = [trial.values for trial in study.best_trials if max(trial.user_attrs['Constraints']) <= 0]\n" + + " import optuna\n" + + + " if 'Constraint' in study.trials[0].user_attrs:\n" + + " feasible_trials = []\n" + + " infeasible_trials = []\n" + + " for trial in study.get_trials(deepcopy=False, states=(optuna.trial.TrialState.COMPLETE,)):\n" + + " if all(map(lambda x: x <= 0.0, trial.user_attrs['Constraint'])):\n" + + " feasible_trials.append(trial)\n" + + " else:\n" + + " infeasible_trials.append(trial)\n" + + " best_trials = optuna.visualization._pareto_front._get_pareto_front_trials_by_trials(\n" + + " feasible_trials, study.directions)\n" + + " non_best_trials = optuna.visualization._pareto_front._get_non_pareto_front_trials(\n" + + " feasible_trials, best_trials)\n" + " else:\n" + - " best_values = [trial.values for trial in study.best_trials]\n" + + " best_trials = study.best_trials\n" + + + " non_best_trials = optuna.visualization._pareto_front._get_non_pareto_front_trials(\n" + + " study.get_trials(deepcopy=False, states=(optuna.trial.TrialState.COMPLETE,)), best_trials\n" + + " )\n" + + " infeasible_trials = []\n" + + " best_values = [trial.values for trial in best_trials]\n" + " kmeans = KMeans(n_clusters=num).fit(best_values)\n" + " labels = kmeans.labels_\n" + " best_length = len(best_values)\n" + diff --git a/Tunny/Solver/Optuna/Sampler.cs b/Tunny/Solver/Optuna/Sampler.cs index 8be211e9..966e9916 100644 --- a/Tunny/Solver/Optuna/Sampler.cs +++ b/Tunny/Solver/Optuna/Sampler.cs @@ -33,7 +33,6 @@ internal static dynamic CmaEs(dynamic optuna, TunnySettings settings) ); } - //FIXME:FIX internal static dynamic Grid(dynamic optuna, List variables, ref int nTrials) { var searchSpace = new PyDict(); From e6427a7ccfb64c4a8996b921f0fcd639da0a7d0f Mon Sep 17 00:00:00 2001 From: hrntsm Date: Thu, 25 Aug 2022 12:25:03 +0900 Subject: [PATCH 42/65] Add save cluster number --- Tunny/UI/OptimizationWindow.cs | 2 ++ 1 file changed, 2 insertions(+) diff --git a/Tunny/UI/OptimizationWindow.cs b/Tunny/UI/OptimizationWindow.cs index 603e4e1e..e9e6463c 100644 --- a/Tunny/UI/OptimizationWindow.cs +++ b/Tunny/UI/OptimizationWindow.cs @@ -88,6 +88,7 @@ private void InitializeUIValues() studyNameTextBox.Text = _settings.StudyName; outputModelNumTextBox.Text = _settings.Result.OutputNumberString; visualizeTypeComboBox.SelectedIndex = _settings.Result.SelectVisualizeType; + visualizeClusterNumUpDown.Value = _settings.Result.NumberOfClusters; InitializeSamplerSettings(); } @@ -135,6 +136,7 @@ private void GetUIValues() _settings.StudyName = studyNameTextBox.Text; _settings.Result.OutputNumberString = outputModelNumTextBox.Text; _settings.Result.SelectVisualizeType = visualizeTypeComboBox.SelectedIndex; + _settings.Result.NumberOfClusters = (int)visualizeClusterNumUpDown.Value; _settings.Optimize.Sampler = GetSamplerSettings(); } } From d5cca47118f1cc9e37b903b37fcd997e5232b06e Mon Sep 17 00:00:00 2001 From: hrntsm Date: Thu, 25 Aug 2022 12:26:50 +0900 Subject: [PATCH 43/65] Update CHANGELOG --- CHANGELOG.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/CHANGELOG.md b/CHANGELOG.md index c7c83b3e..9da323e8 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -12,6 +12,8 @@ Please see [here](https://github.com/hrntsm/Tunny/releases) for the data release - Hypervolume visualization - It is useful for determining convergence in multi-objective optimization. +- Clustering visualization + - Clustering of results during multi-objective optimization makes it easier to evaluate solutions. - BoTorch Sampler - This sampler use Gaussian Process and support multi-objective optimization. - Quasi-MonteCarlo Sampler From 82e4613ec0b0dd5c2e4f95cc620bed5a42f0e284 Mon Sep 17 00:00:00 2001 From: hrntsm Date: Thu, 25 Aug 2022 12:40:35 +0900 Subject: [PATCH 44/65] Add error msg when clustering single obj opt --- Tunny/Solver/Optuna/Optuna.cs | 15 +++++++++++---- Tunny/UI/OptimizationWindow.Designer.cs | 1 + Tunny/UI/OptimizationWindow.resx | 3 --- 3 files changed, 12 insertions(+), 7 deletions(-) diff --git a/Tunny/Solver/Optuna/Optuna.cs b/Tunny/Solver/Optuna/Optuna.cs index b2137339..a7cdddfd 100644 --- a/Tunny/Solver/Optuna/Optuna.cs +++ b/Tunny/Solver/Optuna/Optuna.cs @@ -275,13 +275,20 @@ public void ShowClusteringPlot(string studyName, int numCluster) } string[] nickNames = ((string)study.user_attrs["objective_names"]).Split(','); - try + if (nickNames.Length == 1) { - ShowCluster(optuna, study, nickNames, numCluster); + TunnyMessageBox.Show("Clustering Error\n\nClustering is for multi-objective optimization only.", "Tunny", MessageBoxButtons.OK, MessageBoxIcon.Error); } - catch (Exception) + else { - TunnyMessageBox.Show("Clustering Error", "Tunny", MessageBoxButtons.OK, MessageBoxIcon.Error); + try + { + ShowCluster(optuna, study, nickNames, numCluster); + } + catch (Exception) + { + TunnyMessageBox.Show("Clustering Error", "Tunny", MessageBoxButtons.OK, MessageBoxIcon.Error); + } } } PythonEngine.Shutdown(); diff --git a/Tunny/UI/OptimizationWindow.Designer.cs b/Tunny/UI/OptimizationWindow.Designer.cs index 122d358d..5480e4ce 100644 --- a/Tunny/UI/OptimizationWindow.Designer.cs +++ b/Tunny/UI/OptimizationWindow.Designer.cs @@ -395,6 +395,7 @@ private void InitializeComponent() this.visualizeClusteringLabel.Size = new System.Drawing.Size(175, 23); this.visualizeClusteringLabel.TabIndex = 12; this.visualizeClusteringLabel.Text = "k-means clustering"; + this.toolTip1.SetToolTip(this.visualizeClusteringLabel, "Cluster the multi-objective optimization results using the k-means method."); // // dashboardButton // diff --git a/Tunny/UI/OptimizationWindow.resx b/Tunny/UI/OptimizationWindow.resx index a9924921..bc95beb2 100644 --- a/Tunny/UI/OptimizationWindow.resx +++ b/Tunny/UI/OptimizationWindow.resx @@ -123,9 +123,6 @@ 633, 17 - - 633, 17 - If this is True, the covariance matrix is constrained to be diagonal. From 463366f765efde7bbc023dac24a1bbcb65660dc4 Mon Sep 17 00:00:00 2001 From: hrntsm Date: Fri, 26 Aug 2022 10:48:27 +0900 Subject: [PATCH 45/65] Fix output model number bug --- Tunny/UI/OptimizationWindow.Designer.cs | 1 + 1 file changed, 1 insertion(+) diff --git a/Tunny/UI/OptimizationWindow.Designer.cs b/Tunny/UI/OptimizationWindow.Designer.cs index 5480e4ce..1866b781 100644 --- a/Tunny/UI/OptimizationWindow.Designer.cs +++ b/Tunny/UI/OptimizationWindow.Designer.cs @@ -528,6 +528,7 @@ private void InitializeComponent() this.outputModelNumberButton.TabIndex = 13; this.outputModelNumberButton.Text = "Output"; this.outputModelNumberButton.UseVisualStyleBackColor = true; + this.outputModelNumberButton.Click += new System.EventHandler(this.OutputModelNumberButton_Click); // // outputModelNumTextBox // From a729d9570c1425e0d408485be2603847d991308c Mon Sep 17 00:00:00 2001 From: hrntsm Date: Mon, 29 Aug 2022 10:58:32 +0900 Subject: [PATCH 46/65] Fix code climate issue --- Tunny/Solver/Optuna/Optuna.cs | 55 ++++++++++++++++++----------------- 1 file changed, 29 insertions(+), 26 deletions(-) diff --git a/Tunny/Solver/Optuna/Optuna.cs b/Tunny/Solver/Optuna/Optuna.cs index a7cdddfd..4041f442 100644 --- a/Tunny/Solver/Optuna/Optuna.cs +++ b/Tunny/Solver/Optuna/Optuna.cs @@ -95,21 +95,30 @@ private static void ShowErrorMessages(Exception e) MessageBoxButtons.OK, MessageBoxIcon.Error); } + private static dynamic LoadStudy(dynamic optuna, string storage, string studyName) + { + try + { + return optuna.load_study(storage: storage, study_name: studyName); + } + catch (Exception e) + { + TunnyMessageBox.Show(e.Message, "Tunny", MessageBoxButtons.OK, MessageBoxIcon.Error); + return null; + } + + } + public void ShowSelectedTypePlot(string visualize, string studyName) { string storage = "sqlite:///" + _settings.Storage; PythonEngine.Initialize(); using (Py.GIL()) { - dynamic study; dynamic optuna = Py.Import("optuna"); - try - { - study = optuna.load_study(storage: storage, study_name: studyName); - } - catch (Exception e) + dynamic study = LoadStudy(optuna, storage, studyName); + if (study == null) { - TunnyMessageBox.Show(e.Message, "Tunny", MessageBoxButtons.OK, MessageBoxIcon.Error); return; } @@ -262,15 +271,10 @@ public void ShowClusteringPlot(string studyName, int numCluster) PythonEngine.Initialize(); using (Py.GIL()) { - dynamic study; dynamic optuna = Py.Import("optuna"); - try - { - study = optuna.load_study(storage: storage, study_name: studyName); - } - catch (Exception e) + dynamic study = LoadStudy(optuna, storage, studyName); + if (study == null) { - TunnyMessageBox.Show(e.Message, "Tunny", MessageBoxButtons.OK, MessageBoxIcon.Error); return; } @@ -281,25 +285,24 @@ public void ShowClusteringPlot(string studyName, int numCluster) } else { - try - { - ShowCluster(optuna, study, nickNames, numCluster); - } - catch (Exception) - { - TunnyMessageBox.Show("Clustering Error", "Tunny", MessageBoxButtons.OK, MessageBoxIcon.Error); - } + ShowCluster(optuna, study, nickNames, numCluster); } } PythonEngine.Shutdown(); - } private void ShowCluster(dynamic optuna, dynamic study, string[] nickNames, int numCluster) { - dynamic fig = optuna.visualization.plot_pareto_front(study, target_names: nickNames, constraints_func: _hasConstraint ? Sampler.ConstraintFunc() : null); - fig = TruncateParetoFrontPlotHover(fig, study); - ClusteringParetoFrontPlot(fig, study, numCluster).show(); + try + { + dynamic fig = optuna.visualization.plot_pareto_front(study, target_names: nickNames, constraints_func: _hasConstraint ? Sampler.ConstraintFunc() : null); + fig = TruncateParetoFrontPlotHover(fig, study); + ClusteringParetoFrontPlot(fig, study, numCluster).show(); + } + catch (Exception) + { + TunnyMessageBox.Show("Clustering Error", "Tunny", MessageBoxButtons.OK, MessageBoxIcon.Error); + } } private static dynamic ClusteringParetoFrontPlot(dynamic fig, dynamic study, int numCluster) From 4dc435217f11c865ffd25046557304cb99170752 Mon Sep 17 00:00:00 2001 From: hrntsm Date: Tue, 30 Aug 2022 23:06:32 +0900 Subject: [PATCH 47/65] Clean hypervolume code --- Tunny/Solver/Optuna/Hypervolume.cs | 79 ++++++++++++++++++++++++++++++ Tunny/Solver/Optuna/Optuna.cs | 71 +-------------------------- 2 files changed, 80 insertions(+), 70 deletions(-) create mode 100644 Tunny/Solver/Optuna/Hypervolume.cs diff --git a/Tunny/Solver/Optuna/Hypervolume.cs b/Tunny/Solver/Optuna/Hypervolume.cs new file mode 100644 index 00000000..275e11e1 --- /dev/null +++ b/Tunny/Solver/Optuna/Hypervolume.cs @@ -0,0 +1,79 @@ +using System.Collections.Generic; +using System.Linq; + +using Python.Runtime; + +namespace Tunny.Solver.Optuna +{ + public static class Hypervolume + { + public static dynamic CreateFigure(dynamic optuna, dynamic study) + { + + var trials = (dynamic[])study.trials; + int objectivesCount = ((double[])trials[0].values).Length; + var trialValues = new List(); + foreach (dynamic trial in trials) + { + trialValues.Add((double[])trial.values); + } + double[] maxObjectiveValues = new double[objectivesCount]; + for (int i = 0; i < objectivesCount; i++) + { + maxObjectiveValues[i] = trialValues.Select(v => v[i]).Max(); + } + + PyList hvs = ComputeHypervolume(optuna, trials, maxObjectiveValues, out PyList trialNumbers); + return CreateHypervolumeFigure(trials, hvs, trialNumbers); + } + + private static PyList ComputeHypervolume(dynamic optuna, dynamic[] trials, double[] maxObjectiveValues, out PyList trialNumbers) + { + dynamic np = Py.Import("numpy"); + + var hvs = new PyList(); + var rpObj = new PyList(); + trialNumbers = new PyList(); + + foreach (double max in maxObjectiveValues) + { + rpObj.Append(new PyFloat(max)); + } + dynamic referencePoint = np.array(rpObj); + + dynamic wfg = optuna._hypervolume.WFG(); + for (int i = 1; i < trials.Length + 1; i++) + { + var vector = new PyList(); + for (int j = 0; j < i; j++) + { + vector.Append(trials[j].values); + } + hvs.Append(wfg.compute(np.array(vector), referencePoint)); + trialNumbers.Append(new PyInt(i)); + } + return hvs; + } + + private static dynamic CreateHypervolumeFigure(dynamic[] trials, PyList hvs, PyList trialNumbers) + { + dynamic go = Py.Import("plotly.graph_objects"); + + var plotItems = new PyDict(); + plotItems.SetItem("x", trialNumbers); + plotItems.SetItem("y", hvs); + + var plotRange = new PyDict(); + var rangeObj = new PyObject[] { new PyFloat(0), new PyFloat(trials.Length + 1) }; + plotRange.SetItem("range", new PyList(rangeObj)); + + dynamic fig = go.Figure(); + fig.add_trace(go.Scatter(plotItems, name: "Hypervolume")); + fig.update_layout(xaxis: plotRange); + fig.update_xaxes(title_text: "#Trials"); + fig.update_yaxes(title_text: "Hypervolume"); + + return fig; + } + } +} diff --git a/Tunny/Solver/Optuna/Optuna.cs b/Tunny/Solver/Optuna/Optuna.cs index 4041f442..edb739a0 100644 --- a/Tunny/Solver/Optuna/Optuna.cs +++ b/Tunny/Solver/Optuna/Optuna.cs @@ -165,7 +165,7 @@ private void ShowPlot(dynamic optuna, string visualize, dynamic study, string[] optuna.visualization.plot_slice(study, target_name: nickNames[0]).show(); break; case "hypervolume": - PlotHypervolume(optuna, study).show(); + Hypervolume.CreateFigure(optuna, study).show(); break; default: TunnyMessageBox.Show("This visualization type is not supported in this study case.", "Tunny"); @@ -196,75 +196,6 @@ private static dynamic TruncateParetoFrontPlotHover(dynamic fig, dynamic study) return truncate(fig, study); } - private static dynamic PlotHypervolume(dynamic optuna, dynamic study) - { - - var trials = (dynamic[])study.trials; - int objectivesCount = ((double[])trials[0].values).Length; - var trialValues = new List(); - foreach (dynamic trial in trials) - { - trialValues.Add((double[])trial.values); - } - double[] maxObjectiveValues = new double[objectivesCount]; - for (int i = 0; i < objectivesCount; i++) - { - maxObjectiveValues[i] = trialValues.Select(v => v[i]).Max(); - } - - PyList hvs = ComputeHypervolume(optuna, trials, maxObjectiveValues, out PyList trialNumbers); - return CreateHypervolumeFigure(trials, hvs, trialNumbers); - } - - private static PyList ComputeHypervolume(dynamic optuna, dynamic[] trials, double[] maxObjectiveValues, out PyList trialNumbers) - { - dynamic np = Py.Import("numpy"); - - var hvs = new PyList(); - var rpObj = new PyList(); - trialNumbers = new PyList(); - - foreach (double max in maxObjectiveValues) - { - rpObj.Append(new PyFloat(max)); - } - dynamic referencePoint = np.array(rpObj); - - dynamic wfg = optuna._hypervolume.WFG(); - for (int i = 1; i < trials.Length + 1; i++) - { - var vector = new PyList(); - for (int j = 0; j < i; j++) - { - vector.Append(trials[j].values); - } - hvs.Append(wfg.compute(np.array(vector), referencePoint)); - trialNumbers.Append(new PyInt(i)); - } - return hvs; - } - - private static dynamic CreateHypervolumeFigure(dynamic[] trials, PyList hvs, PyList trialNumbers) - { - dynamic go = Py.Import("plotly.graph_objects"); - - var plotItems = new PyDict(); - plotItems.SetItem("x", trialNumbers); - plotItems.SetItem("y", hvs); - - var plotRange = new PyDict(); - var rangeObj = new PyObject[] { new PyFloat(0), new PyFloat(trials.Length + 1) }; - plotRange.SetItem("range", new PyList(rangeObj)); - - dynamic fig = go.Figure(); - fig.add_trace(go.Scatter(plotItems, name: "Hypervolume")); - fig.update_layout(xaxis: plotRange); - fig.update_xaxes(title_text: "#Trials"); - fig.update_yaxes(title_text: "Hypervolume"); - - return fig; - } - public void ShowClusteringPlot(string studyName, int numCluster) { string storage = "sqlite:///" + _settings.Storage; From 03c682c349acdc43813b8031d4ac2355964048f8 Mon Sep 17 00:00:00 2001 From: hrntsm Date: Tue, 30 Aug 2022 23:39:53 +0900 Subject: [PATCH 48/65] Add consider feasible output --- Tunny/Solver/Optuna/Optuna.cs | 25 ++++++++++++++++++++++++- 1 file changed, 24 insertions(+), 1 deletion(-) diff --git a/Tunny/Solver/Optuna/Optuna.cs b/Tunny/Solver/Optuna/Optuna.cs index edb739a0..23c422ef 100644 --- a/Tunny/Solver/Optuna/Optuna.cs +++ b/Tunny/Solver/Optuna/Optuna.cs @@ -368,15 +368,38 @@ private void ParatoSolutions(List modelResult, dynamic study, Backg for (int i = 0; i < bestTrials.Length; i++) { dynamic trial = bestTrials[i]; + bool isFeasible = CheckFeasible(trial); if (OutputLoop.IsForcedStopOutput) { break; } - ParseTrial(modelResult, trial); + if (isFeasible) + { + ParseTrial(modelResult, trial); + } worker.ReportProgress(i * 100 / bestTrials.Length); } } + private static bool CheckFeasible(dynamic trial) + { + string[] keys = (string[])trial.user_attrs.keys(); + for (int j = 0; j < keys.Length; j++) + { + if (keys[j] == "Constraint") + { + double[] constraint = (double[])trial.user_attrs[keys[j]]; + double max = constraint.Max(); + if (max > 0) + { + return false; + } + } + } + + return true; + } + private static void ParseTrial(ICollection modelResult, dynamic trial) { var trialResult = new ModelResult From 816b3cedc83cb477309a118aae9a3de3b512cb47 Mon Sep 17 00:00:00 2001 From: hrntsm Date: Tue, 30 Aug 2022 23:42:40 +0900 Subject: [PATCH 49/65] Update CHANGELOG --- CHANGELOG.md | 1 + 1 file changed, 1 insertion(+) diff --git a/CHANGELOG.md b/CHANGELOG.md index 9da323e8..758f5004 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -30,6 +30,7 @@ Please see [here](https://github.com/hrntsm/Tunny/releases) for the data release - Use `suggest_int` and `suggest_discrete_uniform` instead of `suggest_uniform` for more accurate variable generation in optimization - Updated Optuna used to v3.0.0rc - Random and Grid samplers now support multi-objective optimization +- The output of the Pareto solution was made to consider the constraints. ### Fixed From eb2990954938287b4061db1daef0047ffb73b8a7 Mon Sep 17 00:00:00 2001 From: hrntsm Date: Wed, 31 Aug 2022 20:15:15 +0900 Subject: [PATCH 50/65] Clean CheckFeasible method --- Tunny/Solver/Optuna/Optuna.cs | 12 ++++-------- 1 file changed, 4 insertions(+), 8 deletions(-) diff --git a/Tunny/Solver/Optuna/Optuna.cs b/Tunny/Solver/Optuna/Optuna.cs index 23c422ef..f70a9cbd 100644 --- a/Tunny/Solver/Optuna/Optuna.cs +++ b/Tunny/Solver/Optuna/Optuna.cs @@ -384,16 +384,12 @@ private void ParatoSolutions(List modelResult, dynamic study, Backg private static bool CheckFeasible(dynamic trial) { string[] keys = (string[])trial.user_attrs.keys(); - for (int j = 0; j < keys.Length; j++) + if (keys.Contains("Constraint")) { - if (keys[j] == "Constraint") + double[] constraint = (double[])trial.user_attrs["Constraint"]; + if (constraint.Max() > 0) { - double[] constraint = (double[])trial.user_attrs[keys[j]]; - double max = constraint.Max(); - if (max > 0) - { - return false; - } + return false; } } From 4d351b79ad9d46ddcda60ed76f1eacbd31ab4032 Mon Sep 17 00:00:00 2001 From: hrntsm Date: Wed, 31 Aug 2022 20:48:35 +0900 Subject: [PATCH 51/65] Update optuna package --- PYTHON_PACKAGE_LICENSES | 2 +- Tunny/Lib/requirements.txt | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/PYTHON_PACKAGE_LICENSES b/PYTHON_PACKAGE_LICENSES index 30031b02..f58d1908 100644 --- a/PYTHON_PACKAGE_LICENSES +++ b/PYTHON_PACKAGE_LICENSES @@ -1803,7 +1803,7 @@ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. optuna -3.0.0rc0 +3.0.0 MIT License https://optuna.org/ MIT License diff --git a/Tunny/Lib/requirements.txt b/Tunny/Lib/requirements.txt index 740d6842..4b3d926a 100644 --- a/Tunny/Lib/requirements.txt +++ b/Tunny/Lib/requirements.txt @@ -16,7 +16,7 @@ MarkupSafe==2.1.1 multipledispatch==0.6.0 numpy==1.23.0 opt-einsum==3.3.0 -optuna==3.0.0rc0 +optuna==3.0.0 optuna-dashboard==0.7.2 packaging==21.3 pbr==5.9.0 From 9684d2cd0e6d29db25a4a4de41d67eee716ddd7d Mon Sep 17 00:00:00 2001 From: hrntsm Date: Wed, 31 Aug 2022 20:54:03 +0900 Subject: [PATCH 52/65] Update trial.suggest to float --- Tunny/Solver/Optuna/Algorithm.cs | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/Tunny/Solver/Optuna/Algorithm.cs b/Tunny/Solver/Optuna/Algorithm.cs index 6ce96bdd..49a5b1be 100644 --- a/Tunny/Solver/Optuna/Algorithm.cs +++ b/Tunny/Solver/Optuna/Algorithm.cs @@ -189,8 +189,8 @@ private void RunOptimize(int nTrials, double timeout, dynamic study, out double[ for (int j = 0; j < Variables.Count; j++) { xTest[j] = Variables[j].IsInteger - ? trial.suggest_int(Variables[j].NickName, Variables[j].LowerBond, Variables[j].UpperBond, Variables[j].Epsilon) - : trial.suggest_discrete_uniform(Variables[j].NickName, Variables[j].LowerBond, Variables[j].UpperBond, Variables[j].Epsilon); + ? trial.suggest_int(Variables[j].NickName, Variables[j].LowerBond, Variables[j].UpperBond, step: Variables[j].Epsilon) + : trial.suggest_float(Variables[j].NickName, Variables[j].LowerBond, Variables[j].UpperBond, step: Variables[j].Epsilon); } result = EvalFunc(xTest, progress); From 57af65c8eb118066bdcdc2d030ffd6e4a95b0e23 Mon Sep 17 00:00:00 2001 From: hrntsm Date: Wed, 31 Aug 2022 21:00:22 +0900 Subject: [PATCH 53/65] Update TPE multivariate option to true in default --- Tunny/Settings/Tpe.cs | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/Tunny/Settings/Tpe.cs b/Tunny/Settings/Tpe.cs index 8888b7eb..0900e3fc 100644 --- a/Tunny/Settings/Tpe.cs +++ b/Tunny/Settings/Tpe.cs @@ -12,7 +12,7 @@ public class Tpe public bool ConsiderEndpoints { get; set; } public int NStartupTrials { get; set; } = 10; public int NEICandidates { get; set; } = 24; - public bool Multivariate { get; set; } + public bool Multivariate { get; set; } = true; public bool Group { get; set; } public bool WarnIndependentSampling { get; set; } = true; public bool ConstantLiar { get; set; } From ffb42ee960291f83d9961b6d541b0e7e423aec3a Mon Sep 17 00:00:00 2001 From: hrntsm Date: Wed, 31 Aug 2022 21:48:14 +0900 Subject: [PATCH 54/65] Add nsga to crossover option --- Tunny/Settings/NSGAII.cs | 1 + Tunny/Solver/Optuna/Sampler.cs | 22 ++++++++++++++ Tunny/UI/OptimizationWindow.Designer.cs | 35 +++++++++++++++++++++++ Tunny/UI/OptimizationWindow.resx | 3 ++ Tunny/UI/OptimizeWindowTab/SettingsTab.cs | 32 ++++++++++++++++++++- 5 files changed, 92 insertions(+), 1 deletion(-) diff --git a/Tunny/Settings/NSGAII.cs b/Tunny/Settings/NSGAII.cs index f15f24fc..a0c07ea1 100644 --- a/Tunny/Settings/NSGAII.cs +++ b/Tunny/Settings/NSGAII.cs @@ -8,6 +8,7 @@ public class NSGAII public int? Seed { get; set; } public double? MutationProb { get; set; } public int PopulationSize { get; set; } = 50; + public string Crossover { get; set; } = string.Empty; public double CrossoverProb { get; set; } = 0.9; public double SwappingProb { get; set; } = 0.5; } diff --git a/Tunny/Solver/Optuna/Sampler.cs b/Tunny/Solver/Optuna/Sampler.cs index 966e9916..bd35fc89 100644 --- a/Tunny/Solver/Optuna/Sampler.cs +++ b/Tunny/Solver/Optuna/Sampler.cs @@ -58,10 +58,32 @@ internal static dynamic NSGAII(dynamic optuna, TunnySettings settings, bool hasC crossover_prob: nsga2.CrossoverProb, swapping_prob: nsga2.SwappingProb, seed: nsga2.Seed, + crossover: SetCrossover(optuna, nsga2.Crossover), constraints_func: hasConstraints ? ConstraintFunc() : null ); } + private static dynamic SetCrossover(dynamic optuna, string crossover) + { + switch (crossover) + { + case "Uniform": + return optuna.samplers.nsgaii.UniformCrossover(); + case "BLXAlpha": + return optuna.samplers.nsgaii.BLXAlphaCrossover(); + case "SPX": + return optuna.samplers.nsgaii.SPXCrossover(); + case "SBX": + return optuna.samplers.nsgaii.SBXCrossover(); + case "VSBX": + return optuna.samplers.nsgaii.VSBXCrossover(); + case "UNDX": + return optuna.samplers.nsgaii.UNDXCrossover(); + default: + throw new ArgumentException("Unexpected crossover setting"); + } + } + internal static dynamic TPE(dynamic optuna, TunnySettings settings, bool hasConstraints) { Tpe tpe = settings.Optimize.Sampler.Tpe; diff --git a/Tunny/UI/OptimizationWindow.Designer.cs b/Tunny/UI/OptimizationWindow.Designer.cs index 1866b781..683c3c64 100644 --- a/Tunny/UI/OptimizationWindow.Designer.cs +++ b/Tunny/UI/OptimizationWindow.Designer.cs @@ -86,6 +86,8 @@ private void InitializeComponent() this.boTorchNStartupTrialsLabel = new System.Windows.Forms.Label(); this.boTorchStartupNumUpDown = new System.Windows.Forms.NumericUpDown(); this.NSGAII = new System.Windows.Forms.TabPage(); + this.nsgaCrossoverComboBox = new System.Windows.Forms.ComboBox(); + this.nsgaCrossoverCheckBox = new System.Windows.Forms.CheckBox(); this.nsgaDefaultButton = new System.Windows.Forms.Button(); this.nsgaMutationProbCheckBox = new System.Windows.Forms.CheckBox(); this.nsgaPopulationSizeLabel = new System.Windows.Forms.Label(); @@ -846,6 +848,8 @@ private void InitializeComponent() // // NSGAII // + this.NSGAII.Controls.Add(this.nsgaCrossoverComboBox); + this.NSGAII.Controls.Add(this.nsgaCrossoverCheckBox); this.NSGAII.Controls.Add(this.nsgaDefaultButton); this.NSGAII.Controls.Add(this.nsgaMutationProbCheckBox); this.NSGAII.Controls.Add(this.nsgaPopulationSizeLabel); @@ -862,6 +866,35 @@ private void InitializeComponent() this.NSGAII.Text = "NSGAII"; this.NSGAII.UseVisualStyleBackColor = true; // + // nsgaCrossoverComboBox + // + this.nsgaCrossoverComboBox.FormattingEnabled = true; + this.nsgaCrossoverComboBox.Items.AddRange(new object[] { + "Uniform", + "BLXAlpha", + "SPX", + "SBX", + "VSBX", + "UNDX"}); + this.nsgaCrossoverComboBox.Location = new System.Drawing.Point(265, 154); + this.nsgaCrossoverComboBox.Margin = new System.Windows.Forms.Padding(4, 6, 4, 6); + this.nsgaCrossoverComboBox.Name = "nsgaCrossoverComboBox"; + this.nsgaCrossoverComboBox.Size = new System.Drawing.Size(135, 31); + this.nsgaCrossoverComboBox.TabIndex = 33; + this.nsgaCrossoverComboBox.Text = "Uniform"; + // + // nsgaCrossoverCheckBox + // + this.nsgaCrossoverCheckBox.AutoSize = true; + this.nsgaCrossoverCheckBox.Location = new System.Drawing.Point(13, 154); + this.nsgaCrossoverCheckBox.Name = "nsgaCrossoverCheckBox"; + this.nsgaCrossoverCheckBox.Size = new System.Drawing.Size(122, 27); + this.nsgaCrossoverCheckBox.TabIndex = 24; + this.nsgaCrossoverCheckBox.Text = "Crossover"; + this.toolTip1.SetToolTip(this.nsgaCrossoverCheckBox, "Crossover to be applied when creating child individuals. "); + this.nsgaCrossoverCheckBox.UseVisualStyleBackColor = true; + this.nsgaCrossoverCheckBox.CheckedChanged += new System.EventHandler(this.NsgaCrossoverCheckBox_CheckedChanged); + // // nsgaDefaultButton // this.nsgaDefaultButton.Location = new System.Drawing.Point(300, 349); @@ -1437,6 +1470,8 @@ private void InitializeComponent() private System.Windows.Forms.NumericUpDown visualizeClusterNumUpDown; private System.Windows.Forms.Label visualizeClusteringLabel; private System.Windows.Forms.Button visualizeClusteringPlotButton; + private System.Windows.Forms.ComboBox nsgaCrossoverComboBox; + private System.Windows.Forms.CheckBox nsgaCrossoverCheckBox; } } diff --git a/Tunny/UI/OptimizationWindow.resx b/Tunny/UI/OptimizationWindow.resx index bc95beb2..a9924921 100644 --- a/Tunny/UI/OptimizationWindow.resx +++ b/Tunny/UI/OptimizationWindow.resx @@ -123,6 +123,9 @@ 633, 17 + + 633, 17 + If this is True, the covariance matrix is constrained to be diagonal. diff --git a/Tunny/UI/OptimizeWindowTab/SettingsTab.cs b/Tunny/UI/OptimizeWindowTab/SettingsTab.cs index cc383eaf..b33bd174 100644 --- a/Tunny/UI/OptimizeWindowTab/SettingsTab.cs +++ b/Tunny/UI/OptimizeWindowTab/SettingsTab.cs @@ -12,6 +12,11 @@ private void NsgaMutationProbCheckedChanged(object sender, EventArgs e) nsgaMutationProbUpDown.Enabled = nsgaMutationProbCheckBox.Checked; } + private void NsgaCrossoverCheckBox_CheckedChanged(object sender, EventArgs e) + { + nsgaCrossoverComboBox.Enabled = nsgaCrossoverCheckBox.Checked; + } + private void CmaEsSigmaCheckedChanged(object sender, EventArgs e) { cmaEsSigmaNumUpDown.Enabled = cmaEsSigmaCheckBox.Checked; @@ -85,6 +90,29 @@ private void SetNSGAIISettings(NSGAII nsga) nsgaCrossoverProbUpDown.Value = (decimal)nsga.CrossoverProb; nsgaSwappingProbUpDown.Value = (decimal)nsga.SwappingProb; nsgaPopulationSizeUpDown.Value = nsga.PopulationSize; + nsgaCrossoverCheckBox.Checked = nsga.Crossover != string.Empty; + nsgaCrossoverComboBox.SelectedIndex = SetNSGAIICrossoverSetting(nsga.Crossover); + } + + private static int SetNSGAIICrossoverSetting(string crossover) + { + switch (crossover) + { + case "Uniform": + return 0; + case "BLXAlpha": + return 1; + case "SPX": + return 2; + case "SBX": + return 3; + case "VSBX": + return 4; + case "UNDX": + return 5; + default: + throw new ArgumentException("Unexpected crossover setting"); + } } private void SetCmaEsSettings(CmaEs cmaEs) @@ -157,7 +185,9 @@ private NSGAII GetNSGAIISettings() ? (double?)nsgaMutationProbUpDown.Value : null, CrossoverProb = (double)nsgaCrossoverProbUpDown.Value, SwappingProb = (double)nsgaSwappingProbUpDown.Value, - PopulationSize = (int)nsgaPopulationSizeUpDown.Value + PopulationSize = (int)nsgaPopulationSizeUpDown.Value, + Crossover = nsgaCrossoverCheckBox.Checked + ? nsgaCrossoverComboBox.Text : string.Empty, }; } From 87a6f9d34db8e7d5c6e14ca58248903a7b48708e Mon Sep 17 00:00:00 2001 From: hrntsm Date: Wed, 31 Aug 2022 22:45:46 +0900 Subject: [PATCH 55/65] Add cma-es popsize setting --- Tunny/Settings/CmaEs.cs | 1 + Tunny/Solver/Optuna/Sampler.cs | 1 + Tunny/UI/OptimizationWindow.Designer.cs | 41 +++++++++++++++++++++-- Tunny/UI/OptimizationWindow.resx | 6 ++-- Tunny/UI/OptimizeWindowTab/SettingsTab.cs | 9 +++-- 5 files changed, 51 insertions(+), 7 deletions(-) diff --git a/Tunny/Settings/CmaEs.cs b/Tunny/Settings/CmaEs.cs index c09babef..cabbce29 100644 --- a/Tunny/Settings/CmaEs.cs +++ b/Tunny/Settings/CmaEs.cs @@ -12,6 +12,7 @@ public class CmaEs public bool ConsiderPrunedTrials { get; set; } public string RestartStrategy { get; set; } = string.Empty; public int IncPopsize { get; set; } = 2; + public int? PopulationSize { get; set; } public bool UseSeparableCma { get; set; } } } diff --git a/Tunny/Solver/Optuna/Sampler.cs b/Tunny/Solver/Optuna/Sampler.cs index bd35fc89..355f1e24 100644 --- a/Tunny/Solver/Optuna/Sampler.cs +++ b/Tunny/Solver/Optuna/Sampler.cs @@ -29,6 +29,7 @@ internal static dynamic CmaEs(dynamic optuna, TunnySettings settings) consider_pruned_trials: cmaEs.ConsiderPrunedTrials, restart_strategy: cmaEs.RestartStrategy == string.Empty ? null : cmaEs.RestartStrategy, inc_popsize: cmaEs.IncPopsize, + popsize: cmaEs.PopulationSize, use_separable_cma: cmaEs.UseSeparableCma ); } diff --git a/Tunny/UI/OptimizationWindow.Designer.cs b/Tunny/UI/OptimizationWindow.Designer.cs index 683c3c64..dc8b5a39 100644 --- a/Tunny/UI/OptimizationWindow.Designer.cs +++ b/Tunny/UI/OptimizationWindow.Designer.cs @@ -121,6 +121,8 @@ private void InitializeComponent() this.clearResultButton = new System.Windows.Forms.Button(); this.outputResultBackgroundWorker = new System.ComponentModel.BackgroundWorker(); this.toolTip1 = new System.Windows.Forms.ToolTip(this.components); + this.cmaEsPopulationSizeLabel = new System.Windows.Forms.Label(); + this.cmaEsPopulationSizeUpDown = new System.Windows.Forms.NumericUpDown(); ((System.ComponentModel.ISupportInitialize)(this.nTrialNumUpDown)).BeginInit(); this.optimizeTabControl.SuspendLayout(); this.optimizeTabPage.SuspendLayout(); @@ -147,6 +149,7 @@ private void InitializeComponent() ((System.ComponentModel.ISupportInitialize)(this.cmaEsSigmaNumUpDown)).BeginInit(); this.QMC.SuspendLayout(); this.fileTabPage.SuspendLayout(); + ((System.ComponentModel.ISupportInitialize)(this.cmaEsPopulationSizeUpDown)).BeginInit(); this.SuspendLayout(); // // optimizeRunButton @@ -1038,6 +1041,8 @@ private void InitializeComponent() // // CMAES // + this.CMAES.Controls.Add(this.cmaEsPopulationSizeUpDown); + this.CMAES.Controls.Add(this.cmaEsPopulationSizeLabel); this.CMAES.Controls.Add(this.cmaEsDefaultButton); this.CMAES.Controls.Add(this.cmaEsRestartCheckBox); this.CMAES.Controls.Add(this.cmaEsUseSaparableCmaCheckBox); @@ -1152,7 +1157,7 @@ private void InitializeComponent() // cmaEsIncPopsizeLabel // this.cmaEsIncPopsizeLabel.AutoSize = true; - this.cmaEsIncPopsizeLabel.Location = new System.Drawing.Point(7, 233); + this.cmaEsIncPopsizeLabel.Location = new System.Drawing.Point(7, 273); this.cmaEsIncPopsizeLabel.Name = "cmaEsIncPopsizeLabel"; this.cmaEsIncPopsizeLabel.Size = new System.Drawing.Size(240, 23); this.cmaEsIncPopsizeLabel.TabIndex = 26; @@ -1162,7 +1167,7 @@ private void InitializeComponent() // cmaEsIncPopSizeUpDown // this.cmaEsIncPopSizeUpDown.Enabled = false; - this.cmaEsIncPopSizeUpDown.Location = new System.Drawing.Point(309, 231); + this.cmaEsIncPopSizeUpDown.Location = new System.Drawing.Point(309, 271); this.cmaEsIncPopSizeUpDown.Minimum = new decimal(new int[] { 1, 0, @@ -1329,6 +1334,35 @@ private void InitializeComponent() this.clearResultButton.UseVisualStyleBackColor = true; this.clearResultButton.Click += new System.EventHandler(this.ClearResultButton_Click); // + // cmaEsPopulationSizeLabel + // + this.cmaEsPopulationSizeLabel.AutoSize = true; + this.cmaEsPopulationSizeLabel.Location = new System.Drawing.Point(7, 237); + this.cmaEsPopulationSizeLabel.Name = "cmaEsPopulationSizeLabel"; + this.cmaEsPopulationSizeLabel.Size = new System.Drawing.Size(144, 23); + this.cmaEsPopulationSizeLabel.TabIndex = 34; + this.cmaEsPopulationSizeLabel.Text = "Population Size"; + this.toolTip1.SetToolTip(this.cmaEsPopulationSizeLabel, "A population size of CMA-ES. \r\nWhen set restart_strategy is checked,\r\nthis is use" + + "d as the initial population size."); + // + // cmaEsPopulationSizeUpDown + // + this.cmaEsPopulationSizeUpDown.Enabled = false; + this.cmaEsPopulationSizeUpDown.Location = new System.Drawing.Point(309, 235); + this.cmaEsPopulationSizeUpDown.Minimum = new decimal(new int[] { + 1, + 0, + 0, + 0}); + this.cmaEsPopulationSizeUpDown.Name = "cmaEsPopulationSizeUpDown"; + this.cmaEsPopulationSizeUpDown.Size = new System.Drawing.Size(94, 30); + this.cmaEsPopulationSizeUpDown.TabIndex = 35; + this.cmaEsPopulationSizeUpDown.Value = new decimal(new int[] { + 10, + 0, + 0, + 0}); + // // OptimizationWindow // this.AutoScaleDimensions = new System.Drawing.SizeF(144F, 144F); @@ -1376,6 +1410,7 @@ private void InitializeComponent() this.QMC.ResumeLayout(false); this.QMC.PerformLayout(); this.fileTabPage.ResumeLayout(false); + ((System.ComponentModel.ISupportInitialize)(this.cmaEsPopulationSizeUpDown)).EndInit(); this.ResumeLayout(false); } @@ -1472,6 +1507,8 @@ private void InitializeComponent() private System.Windows.Forms.Button visualizeClusteringPlotButton; private System.Windows.Forms.ComboBox nsgaCrossoverComboBox; private System.Windows.Forms.CheckBox nsgaCrossoverCheckBox; + private System.Windows.Forms.NumericUpDown cmaEsPopulationSizeUpDown; + private System.Windows.Forms.Label cmaEsPopulationSizeLabel; } } diff --git a/Tunny/UI/OptimizationWindow.resx b/Tunny/UI/OptimizationWindow.resx index a9924921..7b38f757 100644 --- a/Tunny/UI/OptimizationWindow.resx +++ b/Tunny/UI/OptimizationWindow.resx @@ -123,15 +123,15 @@ 633, 17 - - 633, 17 - If this is True, the covariance matrix is constrained to be diagonal. Due to reduce the model complexity, the learning rate for the covariance matrix is increased. Consequently, this algorithm outperforms CMA-ES on separable functions. + + 633, 17 + 17, 17 diff --git a/Tunny/UI/OptimizeWindowTab/SettingsTab.cs b/Tunny/UI/OptimizeWindowTab/SettingsTab.cs index b33bd174..1c3e5f30 100644 --- a/Tunny/UI/OptimizeWindowTab/SettingsTab.cs +++ b/Tunny/UI/OptimizeWindowTab/SettingsTab.cs @@ -25,6 +25,7 @@ private void CmaEsSigmaCheckedChanged(object sender, EventArgs e) private void CmaEsRestartStrategyCheckedChanged(object sender, EventArgs e) { cmaEsIncPopSizeUpDown.Enabled = cmaEsRestartCheckBox.Checked; + cmaEsPopulationSizeUpDown.Enabled = cmaEsRestartCheckBox.Checked; } private void TpeDefaultButton_Click(object sender, EventArgs e) @@ -91,6 +92,7 @@ private void SetNSGAIISettings(NSGAII nsga) nsgaSwappingProbUpDown.Value = (decimal)nsga.SwappingProb; nsgaPopulationSizeUpDown.Value = nsga.PopulationSize; nsgaCrossoverCheckBox.Checked = nsga.Crossover != string.Empty; + nsgaCrossoverComboBox.Enabled = nsga.Crossover != string.Empty; nsgaCrossoverComboBox.SelectedIndex = SetNSGAIICrossoverSetting(nsga.Crossover); } @@ -111,7 +113,7 @@ private static int SetNSGAIICrossoverSetting(string crossover) case "UNDX": return 5; default: - throw new ArgumentException("Unexpected crossover setting"); + return 0; } } @@ -129,6 +131,8 @@ private void SetCmaEsSettings(CmaEs cmaEs) cmaEsRestartCheckBox.Checked = cmaEs.RestartStrategy != string.Empty; cmaEsIncPopSizeUpDown.Enabled = cmaEsRestartCheckBox.Checked; cmaEsIncPopSizeUpDown.Value = cmaEs.IncPopsize; + cmaEsPopulationSizeUpDown.Enabled = cmaEsRestartCheckBox.Checked; + cmaEsPopulationSizeUpDown.Value = cmaEs.PopulationSize != null ? (decimal)cmaEs.PopulationSize : (decimal)1; } private void SetQMCSettings(QuasiMonteCarlo qmc) @@ -202,7 +206,8 @@ private CmaEs GetCmaEsSettings() ConsiderPrunedTrials = cmaEsConsiderPruneTrialsCheckBox.Checked, UseSeparableCma = cmaEsUseSaparableCmaCheckBox.Checked, RestartStrategy = cmaEsRestartCheckBox.Checked ? "ipop" : string.Empty, - IncPopsize = (int)cmaEsIncPopSizeUpDown.Value + IncPopsize = (int)cmaEsIncPopSizeUpDown.Value, + PopulationSize = cmaEsRestartCheckBox.Checked ? (int?)cmaEsPopulationSizeUpDown.Value : null, }; } From 2126f1db35b547241648cbda4f0b319cc2a3c427 Mon Sep 17 00:00:00 2001 From: hrntsm Date: Wed, 31 Aug 2022 22:46:07 +0900 Subject: [PATCH 56/65] Fix typo --- Tunny/UI/OptimizationWindow.Designer.cs | 4 ++-- Tunny/UI/OptimizationWindow.resx | 9 ++++++--- 2 files changed, 8 insertions(+), 5 deletions(-) diff --git a/Tunny/UI/OptimizationWindow.Designer.cs b/Tunny/UI/OptimizationWindow.Designer.cs index dc8b5a39..6fd5b177 100644 --- a/Tunny/UI/OptimizationWindow.Designer.cs +++ b/Tunny/UI/OptimizationWindow.Designer.cs @@ -745,9 +745,9 @@ private void InitializeComponent() this.tpeMultivariateCheckBox.AutoSize = true; this.tpeMultivariateCheckBox.Location = new System.Drawing.Point(241, 137); this.tpeMultivariateCheckBox.Name = "tpeMultivariateCheckBox"; - this.tpeMultivariateCheckBox.Size = new System.Drawing.Size(137, 27); + this.tpeMultivariateCheckBox.Size = new System.Drawing.Size(138, 27); this.tpeMultivariateCheckBox.TabIndex = 3; - this.tpeMultivariateCheckBox.Text = "Maltivariate"; + this.tpeMultivariateCheckBox.Text = "Multivariate"; this.toolTip1.SetToolTip(this.tpeMultivariateCheckBox, "If this is True, \r\nthe multivariate TPE is used when suggesting parameters. \r\nThe" + " multivariate TPE is reported to outperform the independent TPE."); this.tpeMultivariateCheckBox.UseVisualStyleBackColor = true; diff --git a/Tunny/UI/OptimizationWindow.resx b/Tunny/UI/OptimizationWindow.resx index 7b38f757..f2262cef 100644 --- a/Tunny/UI/OptimizationWindow.resx +++ b/Tunny/UI/OptimizationWindow.resx @@ -123,18 +123,21 @@ 633, 17 + + 633, 17 + If this is True, the covariance matrix is constrained to be diagonal. Due to reduce the model complexity, the learning rate for the covariance matrix is increased. Consequently, this algorithm outperforms CMA-ES on separable functions. - - 633, 17 - 17, 17 + + 633, 17 + From 78e3bbfed51b448537185213020192b4e616a89f Mon Sep 17 00:00:00 2001 From: hrntsm Date: Wed, 31 Aug 2022 23:00:56 +0900 Subject: [PATCH 57/65] Fix empty crossover input --- Tunny/Solver/Optuna/Sampler.cs | 2 ++ Tunny/UI/OptimizeWindowTab/SettingsTab.cs | 3 ++- 2 files changed, 4 insertions(+), 1 deletion(-) diff --git a/Tunny/Solver/Optuna/Sampler.cs b/Tunny/Solver/Optuna/Sampler.cs index 355f1e24..5e4eda44 100644 --- a/Tunny/Solver/Optuna/Sampler.cs +++ b/Tunny/Solver/Optuna/Sampler.cs @@ -80,6 +80,8 @@ private static dynamic SetCrossover(dynamic optuna, string crossover) return optuna.samplers.nsgaii.VSBXCrossover(); case "UNDX": return optuna.samplers.nsgaii.UNDXCrossover(); + case "": + return null; default: throw new ArgumentException("Unexpected crossover setting"); } diff --git a/Tunny/UI/OptimizeWindowTab/SettingsTab.cs b/Tunny/UI/OptimizeWindowTab/SettingsTab.cs index 1c3e5f30..3f65ef6c 100644 --- a/Tunny/UI/OptimizeWindowTab/SettingsTab.cs +++ b/Tunny/UI/OptimizeWindowTab/SettingsTab.cs @@ -100,6 +100,7 @@ private static int SetNSGAIICrossoverSetting(string crossover) { switch (crossover) { + case "": case "Uniform": return 0; case "BLXAlpha": @@ -113,7 +114,7 @@ private static int SetNSGAIICrossoverSetting(string crossover) case "UNDX": return 5; default: - return 0; + throw new ArgumentException("Unexpected crossover method."); } } From 73c0ff94a52ca52054ec23fa1d814e002860721f Mon Sep 17 00:00:00 2001 From: hrntsm Date: Wed, 31 Aug 2022 23:02:08 +0900 Subject: [PATCH 58/65] Update CHANGELOG --- CHANGELOG.md | 11 ++++++++--- 1 file changed, 8 insertions(+), 3 deletions(-) diff --git a/CHANGELOG.md b/CHANGELOG.md index 758f5004..c457ae6d 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -23,14 +23,19 @@ Please see [here](https://github.com/hrntsm/Tunny/releases) for the data release - Sampler detail settings UI - Previously it was necessary to change the JSON file of the settings, but now it can be changed in the UI - Enable Text Bake in the FishMarket component. +- Allows selection of NSGA-II crossover methods. + - `Uniform`, `BLXAlpha`, `SPX`, `SBX`, `VSBX`, `UNDX` +- ability to set Popsize on CMA-ES restart ### Changed - When genepool is an input, it now creates variable names using nicknames. -- Use `suggest_int` and `suggest_discrete_uniform` instead of `suggest_uniform` for more accurate variable generation in optimization -- Updated Optuna used to v3.0.0rc -- Random and Grid samplers now support multi-objective optimization - The output of the Pareto solution was made to consider the constraints. +- Multivariate in TPE sampler default option is false to true +- Updated Optuna used to v3.0.0 + - Use `suggest_int` and `suggest_float` instead of `suggest_uniform` for more accurate variable generation in optimization + - Random and Grid samplers now support multi-objective optimization + - The format of the db file in which the results are saved has changed. Please note that it is not compatible with the previous one. ### Fixed From 16467f685468aa56af80c0ffce4d3fe61127bd90 Mon Sep 17 00:00:00 2001 From: hrntsm Date: Thu, 1 Sep 2022 22:57:20 +0900 Subject: [PATCH 59/65] Add run gc after trial setting --- Tunny/Settings/Optimize.cs | 3 +++ Tunny/Solver/EndState.cs | 12 ++++++++++++ Tunny/Solver/Optuna/Algorithm.cs | 27 ++++++++++++++++++++------- 3 files changed, 35 insertions(+), 7 deletions(-) create mode 100644 Tunny/Solver/EndState.cs diff --git a/Tunny/Settings/Optimize.cs b/Tunny/Settings/Optimize.cs index a4d59f8f..b7b64968 100644 --- a/Tunny/Settings/Optimize.cs +++ b/Tunny/Settings/Optimize.cs @@ -1,3 +1,5 @@ +using Tunny.Solver.Optuna; + namespace Tunny.Settings { public class Optimize @@ -7,5 +9,6 @@ public class Optimize public bool LoadExistStudy { get; set; } = true; public int SelectSampler { get; set; } public double Timeout { get; set; } + public GcAfterTrial GcAfterTrial { get; set; } = GcAfterTrial.HasGeometry; } } diff --git a/Tunny/Solver/EndState.cs b/Tunny/Solver/EndState.cs new file mode 100644 index 00000000..7d533381 --- /dev/null +++ b/Tunny/Solver/EndState.cs @@ -0,0 +1,12 @@ +namespace Tunny.Solver +{ + public enum EndState + { + AllTrialCompleted, + Timeout, + StoppedByUser, + DirectionNumNotMatch, + UseExitStudyWithoutLoading, + Error + } +} diff --git a/Tunny/Solver/Optuna/Algorithm.cs b/Tunny/Solver/Optuna/Algorithm.cs index 49a5b1be..48211d19 100644 --- a/Tunny/Solver/Optuna/Algorithm.cs +++ b/Tunny/Solver/Optuna/Algorithm.cs @@ -213,10 +213,26 @@ private void RunOptimize(int nTrials, double timeout, dynamic study, out double[ catch { } + finally + { + RunGC(result); + } trialNum++; } } + private void RunGC(EvaluatedGHResult result) + { + GcAfterTrial gcAfterTrial = Settings.Optimize.GcAfterTrial; + if (gcAfterTrial == GcAfterTrial.Always || + (result.GeometryJson.Count > 0 && gcAfterTrial == GcAfterTrial.HasGeometry) + ) + { + dynamic gc = Py.Import("gc"); + gc.collect(); + } + } + private static void SetStudyUserAttr(dynamic study, StringBuilder name) { study.set_user_attr("objective_names", name.ToString()); @@ -312,13 +328,10 @@ public double[] GetFxOptimum() } - public enum EndState + public enum GcAfterTrial { - AllTrialCompleted, - Timeout, - StoppedByUser, - DirectionNumNotMatch, - UseExitStudyWithoutLoading, - Error + Always, + HasGeometry, + NoExecute, } } From a3e17aa5a6ed2a68ecf1a99f81ff17a98d6f58ea Mon Sep 17 00:00:00 2001 From: hrntsm Date: Thu, 1 Sep 2022 23:00:39 +0900 Subject: [PATCH 60/65] Update CHANGELOG --- CHANGELOG.md | 5 ++++- 1 file changed, 4 insertions(+), 1 deletion(-) diff --git a/CHANGELOG.md b/CHANGELOG.md index c457ae6d..0208daec 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -25,7 +25,10 @@ Please see [here](https://github.com/hrntsm/Tunny/releases) for the data release - Enable Text Bake in the FishMarket component. - Allows selection of NSGA-II crossover methods. - `Uniform`, `BLXAlpha`, `SPX`, `SBX`, `VSBX`, `UNDX` -- ability to set Popsize on CMA-ES restart +- Ability to set Popsize on CMA-ES restart +- Run GC after trial when has geometry attribute or setting always run. + - **This change probably make optimize slower before** + - If you want to cut this setting, set the value of "GcAfterTrial" to 2 in Settings.json. ### Changed From 646b77eca3998c28ff06a921d875bc929e7bbb54 Mon Sep 17 00:00:00 2001 From: hrntsm Date: Sat, 3 Sep 2022 10:55:24 +0900 Subject: [PATCH 61/65] Add license button --- Tunny/UI/OptimizationWindow.Designer.cs | 219 +++++++++++++++--------- Tunny/UI/OptimizationWindow.resx | 6 - Tunny/UI/OptimizeWindowTab/FileTab.cs | 9 + 3 files changed, 147 insertions(+), 87 deletions(-) diff --git a/Tunny/UI/OptimizationWindow.Designer.cs b/Tunny/UI/OptimizationWindow.Designer.cs index 6fd5b177..c086f40a 100644 --- a/Tunny/UI/OptimizationWindow.Designer.cs +++ b/Tunny/UI/OptimizationWindow.Designer.cs @@ -50,10 +50,8 @@ private void InitializeComponent() this.visualizeClusteringPlotButton = new System.Windows.Forms.Button(); this.visualizeNumClusterLabel = new System.Windows.Forms.Label(); this.visualizeClusterNumUpDown = new System.Windows.Forms.NumericUpDown(); - this.visualizeClusteringLabel = new System.Windows.Forms.Label(); this.dashboardButton = new System.Windows.Forms.Button(); this.visualizeButton = new System.Windows.Forms.Button(); - this.visualizeTypeLabel = new System.Windows.Forms.Label(); this.visualizeTypeComboBox = new System.Windows.Forms.ComboBox(); this.outputTabPage = new System.Windows.Forms.TabPage(); this.outputAllTrialsButton = new System.Windows.Forms.Button(); @@ -98,6 +96,8 @@ private void InitializeComponent() this.nsgaCrossoverProbUpDown = new System.Windows.Forms.NumericUpDown(); this.nsgaMutationProbUpDown = new System.Windows.Forms.NumericUpDown(); this.CMAES = new System.Windows.Forms.TabPage(); + this.cmaEsPopulationSizeUpDown = new System.Windows.Forms.NumericUpDown(); + this.cmaEsPopulationSizeLabel = new System.Windows.Forms.Label(); this.cmaEsDefaultButton = new System.Windows.Forms.Button(); this.cmaEsRestartCheckBox = new System.Windows.Forms.CheckBox(); this.cmaEsUseSaparableCmaCheckBox = new System.Windows.Forms.CheckBox(); @@ -117,12 +117,16 @@ private void InitializeComponent() this.qmcScrambleCheckBox = new System.Windows.Forms.CheckBox(); this.qmcWarnIndependentSamplingCheckBox = new System.Windows.Forms.CheckBox(); this.fileTabPage = new System.Windows.Forms.TabPage(); - this.openResultFolderButton = new System.Windows.Forms.Button(); + this.groupBox1 = new System.Windows.Forms.GroupBox(); this.clearResultButton = new System.Windows.Forms.Button(); + this.openResultFolderButton = new System.Windows.Forms.Button(); + this.licenseGroupBox = new System.Windows.Forms.GroupBox(); + this.showThirdPartyLicenseButton = new System.Windows.Forms.Button(); + this.showTunnyLicenseButton = new System.Windows.Forms.Button(); this.outputResultBackgroundWorker = new System.ComponentModel.BackgroundWorker(); this.toolTip1 = new System.Windows.Forms.ToolTip(this.components); - this.cmaEsPopulationSizeLabel = new System.Windows.Forms.Label(); - this.cmaEsPopulationSizeUpDown = new System.Windows.Forms.NumericUpDown(); + this.visualizeTypeGroupBox = new System.Windows.Forms.GroupBox(); + this.kMeansClusteringGroupBox = new System.Windows.Forms.GroupBox(); ((System.ComponentModel.ISupportInitialize)(this.nTrialNumUpDown)).BeginInit(); this.optimizeTabControl.SuspendLayout(); this.optimizeTabPage.SuspendLayout(); @@ -144,12 +148,16 @@ private void InitializeComponent() ((System.ComponentModel.ISupportInitialize)(this.nsgaCrossoverProbUpDown)).BeginInit(); ((System.ComponentModel.ISupportInitialize)(this.nsgaMutationProbUpDown)).BeginInit(); this.CMAES.SuspendLayout(); + ((System.ComponentModel.ISupportInitialize)(this.cmaEsPopulationSizeUpDown)).BeginInit(); ((System.ComponentModel.ISupportInitialize)(this.cmaEsStartupNumUpDown)).BeginInit(); ((System.ComponentModel.ISupportInitialize)(this.cmaEsIncPopSizeUpDown)).BeginInit(); ((System.ComponentModel.ISupportInitialize)(this.cmaEsSigmaNumUpDown)).BeginInit(); this.QMC.SuspendLayout(); this.fileTabPage.SuspendLayout(); - ((System.ComponentModel.ISupportInitialize)(this.cmaEsPopulationSizeUpDown)).BeginInit(); + this.groupBox1.SuspendLayout(); + this.licenseGroupBox.SuspendLayout(); + this.visualizeTypeGroupBox.SuspendLayout(); + this.kMeansClusteringGroupBox.SuspendLayout(); this.SuspendLayout(); // // optimizeRunButton @@ -337,14 +345,9 @@ private void InitializeComponent() // // visualizeTabPage // - this.visualizeTabPage.Controls.Add(this.visualizeClusteringPlotButton); - this.visualizeTabPage.Controls.Add(this.visualizeNumClusterLabel); - this.visualizeTabPage.Controls.Add(this.visualizeClusterNumUpDown); - this.visualizeTabPage.Controls.Add(this.visualizeClusteringLabel); + this.visualizeTabPage.Controls.Add(this.kMeansClusteringGroupBox); + this.visualizeTabPage.Controls.Add(this.visualizeTypeGroupBox); this.visualizeTabPage.Controls.Add(this.dashboardButton); - this.visualizeTabPage.Controls.Add(this.visualizeButton); - this.visualizeTabPage.Controls.Add(this.visualizeTypeLabel); - this.visualizeTabPage.Controls.Add(this.visualizeTypeComboBox); this.visualizeTabPage.Location = new System.Drawing.Point(4, 32); this.visualizeTabPage.Margin = new System.Windows.Forms.Padding(4, 6, 4, 6); this.visualizeTabPage.Name = "visualizeTabPage"; @@ -356,7 +359,7 @@ private void InitializeComponent() // // visualizeClusteringPlotButton // - this.visualizeClusteringPlotButton.Location = new System.Drawing.Point(54, 343); + this.visualizeClusteringPlotButton.Location = new System.Drawing.Point(29, 80); this.visualizeClusteringPlotButton.Margin = new System.Windows.Forms.Padding(4, 6, 4, 6); this.visualizeClusteringPlotButton.Name = "visualizeClusteringPlotButton"; this.visualizeClusteringPlotButton.Size = new System.Drawing.Size(323, 39); @@ -368,7 +371,7 @@ private void InitializeComponent() // visualizeNumClusterLabel // this.visualizeNumClusterLabel.AutoSize = true; - this.visualizeNumClusterLabel.Location = new System.Drawing.Point(50, 306); + this.visualizeNumClusterLabel.Location = new System.Drawing.Point(25, 43); this.visualizeNumClusterLabel.Name = "visualizeNumClusterLabel"; this.visualizeNumClusterLabel.Size = new System.Drawing.Size(166, 23); this.visualizeNumClusterLabel.TabIndex = 14; @@ -376,7 +379,7 @@ private void InitializeComponent() // // visualizeClusterNumUpDown // - this.visualizeClusterNumUpDown.Location = new System.Drawing.Point(284, 304); + this.visualizeClusterNumUpDown.Location = new System.Drawing.Point(259, 41); this.visualizeClusterNumUpDown.Minimum = new decimal(new int[] { 1, 0, @@ -391,17 +394,6 @@ private void InitializeComponent() 0, 0}); // - // visualizeClusteringLabel - // - this.visualizeClusteringLabel.AutoSize = true; - this.visualizeClusteringLabel.Location = new System.Drawing.Point(25, 261); - this.visualizeClusteringLabel.Margin = new System.Windows.Forms.Padding(4, 0, 4, 0); - this.visualizeClusteringLabel.Name = "visualizeClusteringLabel"; - this.visualizeClusteringLabel.Size = new System.Drawing.Size(175, 23); - this.visualizeClusteringLabel.TabIndex = 12; - this.visualizeClusteringLabel.Text = "k-means clustering"; - this.toolTip1.SetToolTip(this.visualizeClusteringLabel, "Cluster the multi-objective optimization results using the k-means method."); - // // dashboardButton // this.dashboardButton.Location = new System.Drawing.Point(54, 40); @@ -415,7 +407,7 @@ private void InitializeComponent() // // visualizeButton // - this.visualizeButton.Location = new System.Drawing.Point(54, 191); + this.visualizeButton.Location = new System.Drawing.Point(29, 80); this.visualizeButton.Margin = new System.Windows.Forms.Padding(4, 6, 4, 6); this.visualizeButton.Name = "visualizeButton"; this.visualizeButton.Size = new System.Drawing.Size(323, 39); @@ -424,16 +416,6 @@ private void InitializeComponent() this.visualizeButton.UseVisualStyleBackColor = true; this.visualizeButton.Click += new System.EventHandler(this.SelectedTypePlotButton_Click); // - // visualizeTypeLabel - // - this.visualizeTypeLabel.AutoSize = true; - this.visualizeTypeLabel.Location = new System.Drawing.Point(25, 109); - this.visualizeTypeLabel.Margin = new System.Windows.Forms.Padding(4, 0, 4, 0); - this.visualizeTypeLabel.Name = "visualizeTypeLabel"; - this.visualizeTypeLabel.Size = new System.Drawing.Size(130, 23); - this.visualizeTypeLabel.TabIndex = 1; - this.visualizeTypeLabel.Text = "Visualize type"; - // // visualizeTypeComboBox // this.visualizeTypeComboBox.FormattingEnabled = true; @@ -447,7 +429,7 @@ private void InitializeComponent() "pareto front", "slice", "hypervolume"}); - this.visualizeTypeComboBox.Location = new System.Drawing.Point(54, 148); + this.visualizeTypeComboBox.Location = new System.Drawing.Point(29, 32); this.visualizeTypeComboBox.Margin = new System.Windows.Forms.Padding(4, 6, 4, 6); this.visualizeTypeComboBox.Name = "visualizeTypeComboBox"; this.visualizeTypeComboBox.Size = new System.Drawing.Size(323, 31); @@ -1060,6 +1042,35 @@ private void InitializeComponent() this.CMAES.TabIndex = 2; this.CMAES.Text = "CMA-ES"; this.CMAES.UseVisualStyleBackColor = true; + // + // cmaEsPopulationSizeUpDown + // + this.cmaEsPopulationSizeUpDown.Enabled = false; + this.cmaEsPopulationSizeUpDown.Location = new System.Drawing.Point(309, 235); + this.cmaEsPopulationSizeUpDown.Minimum = new decimal(new int[] { + 1, + 0, + 0, + 0}); + this.cmaEsPopulationSizeUpDown.Name = "cmaEsPopulationSizeUpDown"; + this.cmaEsPopulationSizeUpDown.Size = new System.Drawing.Size(94, 30); + this.cmaEsPopulationSizeUpDown.TabIndex = 35; + this.cmaEsPopulationSizeUpDown.Value = new decimal(new int[] { + 10, + 0, + 0, + 0}); + // + // cmaEsPopulationSizeLabel + // + this.cmaEsPopulationSizeLabel.AutoSize = true; + this.cmaEsPopulationSizeLabel.Location = new System.Drawing.Point(7, 237); + this.cmaEsPopulationSizeLabel.Name = "cmaEsPopulationSizeLabel"; + this.cmaEsPopulationSizeLabel.Size = new System.Drawing.Size(144, 23); + this.cmaEsPopulationSizeLabel.TabIndex = 34; + this.cmaEsPopulationSizeLabel.Text = "Population Size"; + this.toolTip1.SetToolTip(this.cmaEsPopulationSizeLabel, "A population size of CMA-ES. \r\nWhen set restart_strategy is checked,\r\nthis is use" + + "d as the initial population size."); // // cmaEsDefaultButton // @@ -1302,8 +1313,8 @@ private void InitializeComponent() // // fileTabPage // - this.fileTabPage.Controls.Add(this.openResultFolderButton); - this.fileTabPage.Controls.Add(this.clearResultButton); + this.fileTabPage.Controls.Add(this.groupBox1); + this.fileTabPage.Controls.Add(this.licenseGroupBox); this.fileTabPage.Location = new System.Drawing.Point(4, 32); this.fileTabPage.Name = "fileTabPage"; this.fileTabPage.Padding = new System.Windows.Forms.Padding(3); @@ -1312,20 +1323,20 @@ private void InitializeComponent() this.fileTabPage.Text = "File"; this.fileTabPage.UseVisualStyleBackColor = true; // - // openResultFolderButton + // groupBox1 // - this.openResultFolderButton.Location = new System.Drawing.Point(80, 29); - this.openResultFolderButton.Margin = new System.Windows.Forms.Padding(4, 6, 4, 6); - this.openResultFolderButton.Name = "openResultFolderButton"; - this.openResultFolderButton.Size = new System.Drawing.Size(264, 39); - this.openResultFolderButton.TabIndex = 6; - this.openResultFolderButton.Text = "Open result file folder"; - this.openResultFolderButton.UseVisualStyleBackColor = true; - this.openResultFolderButton.Click += new System.EventHandler(this.OpenResultFolderButton_Click); + this.groupBox1.Controls.Add(this.clearResultButton); + this.groupBox1.Controls.Add(this.openResultFolderButton); + this.groupBox1.Location = new System.Drawing.Point(22, 6); + this.groupBox1.Name = "groupBox1"; + this.groupBox1.Size = new System.Drawing.Size(378, 171); + this.groupBox1.TabIndex = 9; + this.groupBox1.TabStop = false; + this.groupBox1.Text = "Result"; // // clearResultButton // - this.clearResultButton.Location = new System.Drawing.Point(80, 94); + this.clearResultButton.Location = new System.Drawing.Point(58, 96); this.clearResultButton.Margin = new System.Windows.Forms.Padding(4, 6, 4, 6); this.clearResultButton.Name = "clearResultButton"; this.clearResultButton.Size = new System.Drawing.Size(264, 42); @@ -1334,34 +1345,72 @@ private void InitializeComponent() this.clearResultButton.UseVisualStyleBackColor = true; this.clearResultButton.Click += new System.EventHandler(this.ClearResultButton_Click); // - // cmaEsPopulationSizeLabel - // - this.cmaEsPopulationSizeLabel.AutoSize = true; - this.cmaEsPopulationSizeLabel.Location = new System.Drawing.Point(7, 237); - this.cmaEsPopulationSizeLabel.Name = "cmaEsPopulationSizeLabel"; - this.cmaEsPopulationSizeLabel.Size = new System.Drawing.Size(144, 23); - this.cmaEsPopulationSizeLabel.TabIndex = 34; - this.cmaEsPopulationSizeLabel.Text = "Population Size"; - this.toolTip1.SetToolTip(this.cmaEsPopulationSizeLabel, "A population size of CMA-ES. \r\nWhen set restart_strategy is checked,\r\nthis is use" + - "d as the initial population size."); + // openResultFolderButton // - // cmaEsPopulationSizeUpDown + this.openResultFolderButton.Location = new System.Drawing.Point(58, 45); + this.openResultFolderButton.Margin = new System.Windows.Forms.Padding(4, 6, 4, 6); + this.openResultFolderButton.Name = "openResultFolderButton"; + this.openResultFolderButton.Size = new System.Drawing.Size(264, 39); + this.openResultFolderButton.TabIndex = 6; + this.openResultFolderButton.Text = "Open result file folder"; + this.openResultFolderButton.UseVisualStyleBackColor = true; + this.openResultFolderButton.Click += new System.EventHandler(this.OpenResultFolderButton_Click); // - this.cmaEsPopulationSizeUpDown.Enabled = false; - this.cmaEsPopulationSizeUpDown.Location = new System.Drawing.Point(309, 235); - this.cmaEsPopulationSizeUpDown.Minimum = new decimal(new int[] { - 1, - 0, - 0, - 0}); - this.cmaEsPopulationSizeUpDown.Name = "cmaEsPopulationSizeUpDown"; - this.cmaEsPopulationSizeUpDown.Size = new System.Drawing.Size(94, 30); - this.cmaEsPopulationSizeUpDown.TabIndex = 35; - this.cmaEsPopulationSizeUpDown.Value = new decimal(new int[] { - 10, - 0, - 0, - 0}); + // licenseGroupBox + // + this.licenseGroupBox.Controls.Add(this.showThirdPartyLicenseButton); + this.licenseGroupBox.Controls.Add(this.showTunnyLicenseButton); + this.licenseGroupBox.Location = new System.Drawing.Point(22, 214); + this.licenseGroupBox.Name = "licenseGroupBox"; + this.licenseGroupBox.Size = new System.Drawing.Size(378, 181); + this.licenseGroupBox.TabIndex = 8; + this.licenseGroupBox.TabStop = false; + this.licenseGroupBox.Text = "License"; + // + // showThirdPartyLicenseButton + // + this.showThirdPartyLicenseButton.Location = new System.Drawing.Point(58, 98); + this.showThirdPartyLicenseButton.Margin = new System.Windows.Forms.Padding(4, 6, 4, 6); + this.showThirdPartyLicenseButton.Name = "showThirdPartyLicenseButton"; + this.showThirdPartyLicenseButton.Size = new System.Drawing.Size(264, 42); + this.showThirdPartyLicenseButton.TabIndex = 8; + this.showThirdPartyLicenseButton.Text = "Show Third Party License"; + this.showThirdPartyLicenseButton.UseVisualStyleBackColor = true; + this.showThirdPartyLicenseButton.Click += new System.EventHandler(this.ShowThirdPartyLicenseButton_Click); + // + // showTunnyLicenseButton + // + this.showTunnyLicenseButton.Location = new System.Drawing.Point(58, 44); + this.showTunnyLicenseButton.Margin = new System.Windows.Forms.Padding(4, 6, 4, 6); + this.showTunnyLicenseButton.Name = "showTunnyLicenseButton"; + this.showTunnyLicenseButton.Size = new System.Drawing.Size(264, 42); + this.showTunnyLicenseButton.TabIndex = 7; + this.showTunnyLicenseButton.Text = "Show Tunny License"; + this.showTunnyLicenseButton.UseVisualStyleBackColor = true; + this.showTunnyLicenseButton.Click += new System.EventHandler(this.ShowTunnyLicenseButton_Click); + // + // visualizeTypeGroupBox + // + this.visualizeTypeGroupBox.Controls.Add(this.visualizeTypeComboBox); + this.visualizeTypeGroupBox.Controls.Add(this.visualizeButton); + this.visualizeTypeGroupBox.Location = new System.Drawing.Point(25, 111); + this.visualizeTypeGroupBox.Name = "visualizeTypeGroupBox"; + this.visualizeTypeGroupBox.Size = new System.Drawing.Size(373, 138); + this.visualizeTypeGroupBox.TabIndex = 16; + this.visualizeTypeGroupBox.TabStop = false; + this.visualizeTypeGroupBox.Text = "Visualize type"; + // + // kMeansClusteringGroupBox + // + this.kMeansClusteringGroupBox.Controls.Add(this.visualizeClusterNumUpDown); + this.kMeansClusteringGroupBox.Controls.Add(this.visualizeNumClusterLabel); + this.kMeansClusteringGroupBox.Controls.Add(this.visualizeClusteringPlotButton); + this.kMeansClusteringGroupBox.Location = new System.Drawing.Point(25, 270); + this.kMeansClusteringGroupBox.Name = "kMeansClusteringGroupBox"; + this.kMeansClusteringGroupBox.Size = new System.Drawing.Size(373, 147); + this.kMeansClusteringGroupBox.TabIndex = 17; + this.kMeansClusteringGroupBox.TabStop = false; + this.kMeansClusteringGroupBox.Text = "k-means clustering"; // // OptimizationWindow // @@ -1382,7 +1431,6 @@ private void InitializeComponent() this.optimizeTabPage.PerformLayout(); ((System.ComponentModel.ISupportInitialize)(this.timeoutNumUpDown)).EndInit(); this.visualizeTabPage.ResumeLayout(false); - this.visualizeTabPage.PerformLayout(); ((System.ComponentModel.ISupportInitialize)(this.visualizeClusterNumUpDown)).EndInit(); this.outputTabPage.ResumeLayout(false); this.outputTabPage.PerformLayout(); @@ -1404,13 +1452,18 @@ private void InitializeComponent() ((System.ComponentModel.ISupportInitialize)(this.nsgaMutationProbUpDown)).EndInit(); this.CMAES.ResumeLayout(false); this.CMAES.PerformLayout(); + ((System.ComponentModel.ISupportInitialize)(this.cmaEsPopulationSizeUpDown)).EndInit(); ((System.ComponentModel.ISupportInitialize)(this.cmaEsStartupNumUpDown)).EndInit(); ((System.ComponentModel.ISupportInitialize)(this.cmaEsIncPopSizeUpDown)).EndInit(); ((System.ComponentModel.ISupportInitialize)(this.cmaEsSigmaNumUpDown)).EndInit(); this.QMC.ResumeLayout(false); this.QMC.PerformLayout(); this.fileTabPage.ResumeLayout(false); - ((System.ComponentModel.ISupportInitialize)(this.cmaEsPopulationSizeUpDown)).EndInit(); + this.groupBox1.ResumeLayout(false); + this.licenseGroupBox.ResumeLayout(false); + this.visualizeTypeGroupBox.ResumeLayout(false); + this.kMeansClusteringGroupBox.ResumeLayout(false); + this.kMeansClusteringGroupBox.PerformLayout(); this.ResumeLayout(false); } @@ -1432,7 +1485,6 @@ private void InitializeComponent() private System.Windows.Forms.TabPage optimizeTabPage; private System.Windows.Forms.TabPage visualizeTabPage; private System.Windows.Forms.Button visualizeButton; - private System.Windows.Forms.Label visualizeTypeLabel; private System.Windows.Forms.ComboBox visualizeTypeComboBox; private System.ComponentModel.BackgroundWorker outputResultBackgroundWorker; private System.Windows.Forms.TabPage settingsTabPage; @@ -1503,12 +1555,17 @@ private void InitializeComponent() private System.Windows.Forms.Button qmcDefaultButton; private System.Windows.Forms.Label visualizeNumClusterLabel; private System.Windows.Forms.NumericUpDown visualizeClusterNumUpDown; - private System.Windows.Forms.Label visualizeClusteringLabel; private System.Windows.Forms.Button visualizeClusteringPlotButton; private System.Windows.Forms.ComboBox nsgaCrossoverComboBox; private System.Windows.Forms.CheckBox nsgaCrossoverCheckBox; private System.Windows.Forms.NumericUpDown cmaEsPopulationSizeUpDown; private System.Windows.Forms.Label cmaEsPopulationSizeLabel; + private System.Windows.Forms.GroupBox groupBox1; + private System.Windows.Forms.GroupBox licenseGroupBox; + private System.Windows.Forms.Button showThirdPartyLicenseButton; + private System.Windows.Forms.Button showTunnyLicenseButton; + private System.Windows.Forms.GroupBox kMeansClusteringGroupBox; + private System.Windows.Forms.GroupBox visualizeTypeGroupBox; } } diff --git a/Tunny/UI/OptimizationWindow.resx b/Tunny/UI/OptimizationWindow.resx index f2262cef..bc95beb2 100644 --- a/Tunny/UI/OptimizationWindow.resx +++ b/Tunny/UI/OptimizationWindow.resx @@ -123,9 +123,6 @@ 633, 17 - - 633, 17 - If this is True, the covariance matrix is constrained to be diagonal. @@ -135,9 +132,6 @@ Consequently, this algorithm outperforms CMA-ES on separable functions. 17, 17 - - 633, 17 - diff --git a/Tunny/UI/OptimizeWindowTab/FileTab.cs b/Tunny/UI/OptimizeWindowTab/FileTab.cs index 6120187f..8cf954df 100644 --- a/Tunny/UI/OptimizeWindowTab/FileTab.cs +++ b/Tunny/UI/OptimizeWindowTab/FileTab.cs @@ -16,5 +16,14 @@ private void ClearResultButton_Click(object sender, EventArgs e) { File.Delete(_settings.Storage); } + + private void ShowTunnyLicenseButton_Click(object sender, EventArgs e) + { + Process.Start("https://github.com/hrntsm/Tunny/blob/main/LICENSE"); + } + private void ShowThirdPartyLicenseButton_Click(object sender, EventArgs e) + { + Process.Start("https://github.com/hrntsm/Tunny/blob/main/PYTHON_PACKAGE_LICENSES"); + } } } From 514d48f74519655376de6b1969a7c198c6b4743f Mon Sep 17 00:00:00 2001 From: hrntsm Date: Sat, 3 Sep 2022 11:02:04 +0900 Subject: [PATCH 62/65] Update CHANGELOG --- CHANGELOG.md | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/CHANGELOG.md b/CHANGELOG.md index 0208daec..4d5b65f7 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -17,7 +17,7 @@ Please see [here](https://github.com/hrntsm/Tunny/releases) for the data release - BoTorch Sampler - This sampler use Gaussian Process and support multi-objective optimization. - Quasi-MonteCarlo Sampler - - [Detail](https://optuna.readthedocs.io/en/latest/reference/samplers/generated/optuna.samplers.QMCSampler.html) + - [Detail](https://optuna.readthedocs.io/en/latest/reference/samplers/generated/optuna.samplers.QMCSampler.html) about this sampler. - Support Constraint. - Only TPE, GP, NSGAII can use constraint. - Sampler detail settings UI @@ -29,6 +29,7 @@ Please see [here](https://github.com/hrntsm/Tunny/releases) for the data release - Run GC after trial when has geometry attribute or setting always run. - **This change probably make optimize slower before** - If you want to cut this setting, set the value of "GcAfterTrial" to 2 in Settings.json. +- Show LICENSE button in Tunny UI. ### Changed From d004ca75f4128c4466119d408e36a74c16668d00 Mon Sep 17 00:00:00 2001 From: hrntsm Date: Sat, 3 Sep 2022 12:32:14 +0900 Subject: [PATCH 63/65] Fix incorrect model number input error --- Tunny/UI/OptimizationWindow.resx | 3 ++ Tunny/UI/OptimizeWindowTab/OutputTab.cs | 43 +++++++++++++++++++++---- 2 files changed, 39 insertions(+), 7 deletions(-) diff --git a/Tunny/UI/OptimizationWindow.resx b/Tunny/UI/OptimizationWindow.resx index bc95beb2..a9924921 100644 --- a/Tunny/UI/OptimizationWindow.resx +++ b/Tunny/UI/OptimizationWindow.resx @@ -123,6 +123,9 @@ 633, 17 + + 633, 17 + If this is True, the covariance matrix is constrained to be diagonal. diff --git a/Tunny/UI/OptimizeWindowTab/OutputTab.cs b/Tunny/UI/OptimizeWindowTab/OutputTab.cs index e08ca07e..46b14f66 100644 --- a/Tunny/UI/OptimizeWindowTab/OutputTab.cs +++ b/Tunny/UI/OptimizeWindowTab/OutputTab.cs @@ -1,4 +1,5 @@ using System; +using System.Collections.Generic; using System.ComponentModel; using System.Linq; using System.Windows.Forms; @@ -37,13 +38,17 @@ private void RunOutputLoop(OutputMode mode) OutputLoop.Settings = _settings; OutputLoop.StudyName = studyNameTextBox.Text; OutputLoop.NickNames = _component.GhInOut.Variables.Select(x => x.NickName).ToArray(); - int[] indices = outputModelNumTextBox.Text.Split(',').Select(int.Parse).ToArray(); - SetOutputIndices(mode, indices); - outputResultBackgroundWorker.RunWorkerAsync(_component); + bool result = SetOutputIndices(mode); + if (result) + { + outputResultBackgroundWorker.RunWorkerAsync(_component); + } } - private static void SetOutputIndices(OutputMode mode, int[] indices) + private bool SetOutputIndices(OutputMode mode) { + bool result = true; + var indices = new List(); switch (mode) { case OutputMode.ParatoSolutions: @@ -53,15 +58,39 @@ private static void SetOutputIndices(OutputMode mode, int[] indices) OutputLoop.Indices = new[] { -10 }; break; case OutputMode.ModelNumber: - OutputLoop.Indices = indices; + result = ParseModelNumberInput(ref indices); + if (result) + { + OutputLoop.Indices = indices.ToArray(); + } break; case OutputMode.ReflectToSliders: - CheckIndicesLength(indices); - OutputLoop.Indices = new[] { indices[0] }; + result = ParseModelNumberInput(ref indices); + if (result) + { + CheckIndicesLength(indices.ToArray()); + OutputLoop.Indices = new[] { indices[0] }; + } break; default: throw new ArgumentException("Unsupported output mode."); } + return result; + } + + private bool ParseModelNumberInput(ref List indices) + { + bool result = true; + try + { + indices = outputModelNumTextBox.Text.Split(',').Select(int.Parse).ToList(); + } + catch (Exception) + { + TunnyMessageBox.Show("The model number format of the input is incorrect. \nPlease use a comma separator as follows.\n\"1,2,3\"", "Tunny"); + result = false; + } + return result; } private static void CheckIndicesLength(int[] indices) From 98ca1574e86c76896d09ad7ca6d6c9d3525e55ef Mon Sep 17 00:00:00 2001 From: hrntsm Date: Sat, 3 Sep 2022 12:37:56 +0900 Subject: [PATCH 64/65] Update sample.gh --- Samples/sample.gh | Bin 214803 -> 53272 bytes 1 file changed, 0 insertions(+), 0 deletions(-) diff --git a/Samples/sample.gh b/Samples/sample.gh index acdb86edb5d51ad1b2ab884f89174b3f793fb956..899957f7098e6d1809590ccab7e598db219b762e 100644 GIT binary patch literal 53272 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໭gd{=Czrd;EtMBUI#6OI;vjM1X1ZX5b}RF_l4xR~~wqRwP39#ebk z%U~t6&C4e_$fpS_;gx?%S=jpp_!51pzn=GngYPrbFHx@E-L?Nx_K@}%v1;OWZN;wf zV|U+fW@`@z8~g78jX?_fb$8(pEFqcXvn$4DsjAqv8FG%)m>;65og3ATyc0fW4z-IP zSTzo8VfnbeI!@8?3z#c7VXapMwjemlj!H2*W*JRo@EnYB=3WZuJ?v}yAX?>&3;85K z=1sWew3x=QFYb(QAUhUr1xM8PU_6;+YAE}t1czPL&KXV>@!mF3KCu0azR6P6n?Jk@ zHiBqdxgzzPfG53%8B0HXh|{>2e?oP}Ps63EaYF-byLquyKnz|A z+|5b%me2&(?_zBM|IV?z%Wj6pznVNa3WA}db`qOASMnod)hY*NF7ytS`mbzcf3JKM zo8$BM(5lkecL^s=etT+!C-R_rH$OGw?+Q%-j${Pw0K0CD_4nR4+^%BQtE&BpVm?;Z zw3`PcB82_PbxT${_D|b?Md69rH5J1guT9U*_fNXmVK2|E@tDVT0CCyasu40F8*TA( z)?raF?5`#aaMis2^!SqvYa1n-t;Buf?Fs3lBy>%s!@8YFxeYS>b=TEzdq$o3J@|yw z)60!ShgAd+tBNP2D&*T!KJ4R=T@-deNIIgozK_gxZkA!J@&X+Y@p@istn)g~1)Y%Y znUYRV4zxj6AwUlxbQw|cjn>8>Mfao3*9`^8f^ z?D3p+;VvQW$hU@@b)W1LN-~}IKXh1gR~vZu(gxV%~Rl zv)4r8HFzz7gDOEgvS|qMTvH@8F&xv<=SIn1$v@?f}nb5>YJ-zS~2J6E%`MpySww%xZeui zxj&(f98M2h0>mP?>eXGCNOhQH7u8iYA;=L$sBj&G^0TRwhGDe?-dcViB`ph32KS%S z)c@MU5SU3IYPOc$A@V#Se9t_LXv1naCwk+6UGV)T2jOP=G&xl#;*3{#jbb~ZXLRY_ zH!rusEAoDS_niKQ#;UR+qq=$mX){8ZLa0!Ln)J&p0>8>AQHJdQhi{ldUv)q3%{u{} z2Zx~D_}$wc4h8Af+*;;##vfoe`Jen8zAaK*{C)1G&U_hxxNhiVfAM+}TMZ}k`7Esu zdF(k74Q?&{#3GGETafr&jpMJg3MkndXmZ(ZqypnJWqlg209)bHgUkFT;EQC|RE@Ef zncUP#qC_3!e69_1yjn|~d-HlI_A+UMx0qKNHvam1vAu-X6!Q1fy5~|C&w{t+TLsPn zG)EW`RR51{NHC2Mwg2KjwxNzZ6oEQF3+A`A$~xx$Neu~S_t#(bvb(z#Dg+!sS+=}? zUBl#{Fqmsdoj~nT?y!WbXU;+x45-iBu-?3}e@#Q`ijhatP_=TfBxRQ7?mcyQ?TAPV zf8|?y#xPsFKiGg#R}5&@fL|v1uqQimc|PHO;w1A*Z!%g$FQjwTi)qQNm-dkjp@SzQFVQCj;*(60f*W#3frD|eUi)vPSrg|QRo-##6PYI_!Yhk;W zLO7EljyJsHIX>Vt+jlP|3r~V^n|+uyDM!8hXcwLtSWeAt@693wt zE@EN}{J)0a9`}3=^73?!HyJohnqw-(>05YY)W$^9*@ngqw4K*N=S4qJ)+PN8{W&97fXu+i)C?20W;+74oZ76;jB;vL#* z+}9f^$!>-5*}O2{7iFFX4x6#RDim>i*wBJ0JOm7+@$1>KYYDT&c}XI?8Y68p?|h+t zkvPFetMD!|dl33fl5L2}yZv65atyn~qRw_xuHjMN`BlV>#6?`$wcY*Jbe1W`6D)ex zpS&*KvKQ$#%Rzhck~+)V42Sh_AP6D-CAjTzc-+Ezgx@IxR)`ehCTH|Yv^Gn zeP%yhU$zb(3YzKg+ODH5nlkqv8y<>N({Um%-H`ju(VxCcMVgbz&HdW@r4e-qf3>Mo zd(jKgxY{|mlwd$?TLb)JX}}l*}%I+@kcDSqG(99<5eJlew%M z(1hgeW@I}F2@dvUeBJ)-1v3a~+qk2LyC=s&@0I`&N@9D}HuQAd*t*;q43|{e)mtP* z)Up2i#*51l3`ab0F2(J!r~mD~mv*zh-Zx><^%_$K@svx&+izF4f85e_t==tJ&YPx? zMou*|&N^jW)@So))+rZlb`2%twr#WRy#AZjzGkN8krHjRlN3^sTdmY9y2%LAvxc4_ z`EA+D+j*~J$l#yEpv&MpmXHEYa^5;$_Bq@3g~bo+Gn1R`C)WC4wKve0;U>Z^rs5&F zItkTEtYn7B85civBuhTcMuolL@#Xq(G%Cc`+=UTnjcG~B_(|B+Qqz2I5V@J~4oSqK znXKAY+Oi)G?QO*uC>Fl zm3@6ZXeDeU0AZ7S+D__?hg^1q^#8=?` zG}*uQ;~4f+-ZVE+7um!ZB17*dFcnHahF!4gO8?9Go*Z!lu<)+DgT8X)k`zjTAj0~d zIW?!Zd59Gu;QpUPZRh^@5Y=N*Q*+gn8j*NABS0^HrP5*k`~&jJA}7I}9#Y)RX-T9i zyr7;m@nt;k@a4E~-RSiTZ&xN~%{oY#+WM$S{awy^O!S|qdF%U%E8@7?&C3d9+qco= z^7P*l7}knaCYgQ+7tY7&Tb0BOn$ zd`oDP5vV;BLZSPxWR2D&nJJIE3x#I3rU?VM zbM8Nr{zC~p;9q|%G7o#JIa{$PJdOgp)XgQ~)1r$*0G?YFgz~JyD=8XpM5DuH;1^)@ z*(Z70?HRge?(X(1z~lZBaE)m4U2NIU`-dclGyzQYh_vn(K{q{5nfMJAG{aiIg&u_OUDNj@^uvccISGmqo1R~wbtv7YH@)E))T$Xq zb|CfFAn8Xk{OT^#;Y*j>7f5%}*JXo%B8+@ggi3k; zqX^|OZpgggnvL&^Qr=|0NBzTVuBA_U3|b3?-E#vw|Dx^ewbsO>(k;Aq@0|uAyE1Fw z_Sc8klV!LG^%b6Hh7RRxmdVLj|HUk>>Vhsb-om|BorpJw`Dq!{ksQ>%ZYh0 z_dEEn#det_d5Q31_2pt2p#pMn{F2|(qozq@>Vy7*`FxNPIGmn*$fNETzgYgo>Gmm8 z>v58PO-9iMdY^EG_xS#sP-yBsxZTOE`?9`r^Xb0W>K>y=$;qTt}o0(%*vDj-Ar~D0j47GjoEl2j~*gm=RpH;e0gRo zboaHPr8Z$GqO-f6wsh=W4g2A5KsO_^0oko8Jou4_h?%21Mwgr=&eW?RL7-|qZk>)+*||8?(GfFk_b-Q>imuQ1fu$g3 z0!Ajx*@V4yhgWv0WGo0))2q52!sVrMLv)CjG$25YD@4tGODbG2hA*R|{za;WoJk$9 zA20EInWD}bYpfiR1(r!nypK5UG&Oh&J?US6CC|;XQR%<%!{@Q*BF6kijpTQ(H^DYp zoq;cOU$x}S$6|XEGj%{N!Us29QZeSOL@M|-pL`nL)4Y20?p=l)DEYU!Yr(-aS_q;K zMc4c31i9b$ua?y}6>eoN#0PYQOH^X|1DBx~N%mCR`l`#;{Cju0oSbw*H@ zfW2(#mf^I=noN@WDHZ9agi9!4i}DF{m3jXzm1H0g5m0NT?aG&|)2F~nCcNnN%~(=w zwL5>_V(BqJI|!SG;@bm8ZFcMZCb!9acU>^-Q_kw6zSc)j2HyN7wRNE)YcGQr0a80$ z_X_Wr%n?tBc0hI-rdS@u7tJv~MfK~A>1M~d;nZZ(7>tv$HA}%NdvYq$fj5#)vVw!g zJ{=+~4KOI{C#m^IWv5@fXuaM}Vii*ZX!*hR6eD>b_IWo@YR)gaAlf~!C z((Q7cmur%6e6Pai`Yev-BeKrJsNL#1uby`fVXNTl*u|w+s*P7X_jcrVrGFKe#eL4C z9sqWS-AM38-bco=IqIv@TQaZ_^Xgo?0RG&(YAn#fs_yfh(;f_$4~#jf>fTJ|jX$6n z%sb^eGi&prj(PVy_S^NqTU61w-eB7Q$J<**McFs(-lTvaEg;>XfHX)B(kY09gp7oO zAdN^53W9(%h^VBrgh;nYgLHRych0c?19;u{v-iFCv!3_E`{i20#Cgtexz-#U@jDqP zxSU>>t>hZ&6)$)-5O})P7mbBUPA|SRGn_8ruN^{}smgoU`EtBAZNJuOPJmT`F80^F zUTX!{*?NY0>h1gk4k91TmLJYuusCP^Hk@PAMc{i4VEX~sRlmx%aDT=$;PRP{&AJ!AGb#nU^+O}u+?A7|KphiTy%Tcp!$ z35XuxUWBtDL{ccC97lDK&ibx-y%2;7(~3oB)6Kh$%mX1>G6*~#t&`jkw~oy+Q=qIA zne1`qKaJa7q`rLw&-hO*x&hh9k73T7*^h{*G0d`_KxuwCd(tsp_9HUqr5hx$zf5m` zX($F{Mu2rG_@_SF0kT@QUlj_|2P$oV^O^j(!8)cCX~@wF>Mwq`F7PBOHf?s}oIPa- zOfs}Dv(m(a8(>SR?P!~^xhUo)+}}-t1il(OCOzNHOWJAs@&#vH)zYSr8^o;N5cK1B zE8EA%$X|Z|W?D<|=Ba?Q)Kqh;dXTmjeK<8?+qxgIFRnc|EA%Z>pr^f84kPjR*#wwxVVi%%mXa$XZ2<_R zjQBSJW*=~*-W|t-BL71p+W-`;C<6l~l$*xtvM8UI1RllJR$(NTf3A3irXjvDWV|YC zm+Q%fn$gj;bN1eb8+o^W)6{2WU5>CJI3`A-BFq#`BO6j^z=k4sLPg?j0^ejtX*elZ zRoknHL?KwT{VtFA?@b@?_m4liHD0Pnr`P}$RBUuNWF-g#YfZd zIM;=quhODvAVily%Y0&+_Ew}Aw$!V~E@3Epp%X8vd{9V3C64NRFcO_dViZsU*W03^ z-d7LcNCCek28FcguAe`I4dv#gM1e|sr|b$65PO66)-P@bso(hl?cWh!QTiU7?tp_L zrthO^P_4JIpa5ZleAW_ODfs-459m=d;tnJ{=~z%25afHVVgKg~fcgmi=LJWsyzo!R z_pn~bJr(l@o_}8C^MAgie_D5D*(wgDPyW;aN9xt~4D#ggTVO>X3~~SG6bImgUOnR& zGs{|0*E5I2dn6NiT-dAK7A){V>(P;~fgzuG`8h5RwO)}Wu$vH}fO5UY9V4-mgdQbW zA8Gk;cfLUD>d83L@6OQ^kwa;P8Fd@!ZqOD48DdMdWe!((B_zwEoWNp4_X%pn9%r)3Rj*iOl?rKsR~0x9?hZ@mA0b^rYq|LNkzijspV zeQdueM_W7dB>7(8nu?}7uC=ADVtMw6<*oumtK#ZdBJ-(Y?ST@ zOFYSWOD=kI?5JTIT_bFq^rlgkrj7&x*Du-mC2mGeOkDt+zr`yBwK7phFRh)xgr9WJ zmEQ6=Y{n;@xX5n)XX2^pSx39vUGBDLX!_z-8>|(nEx1iWboBxY1QvZ>1dR{m)m4+X zgLhL*n{62Ja7OaEP-Hakdj*L9)eFCU94gLKXGE{`0^fGt;oB83UqA+WZ+P$B(~jkA z?T8G41F<2&@sxdfv;R@ZDT9;MWg^({o>DVGX|9cYE?t&D>MU$bbES0`--Hj@ESosi z$f?E?QTICX&sW~c_D*_RsM6VZp*Hdl#CEWLX$Y;v2(vN^7kBz!x;Zuj4y;MTV}UojZq@BB(|ksO+^mwmcZE`u3Y-$f%C3A~}( zu~RQC`RGnk{XvOnCh$$?1AOK2EocSy!7{W;D`lQ3qwK`)Tz#e?=>rEAB!Zq&p6YWTf~ z)LFj;wq#M}1MbYw!G?*8W|v25M%p(aruA39{uaH^9Sq>2PRKf0<@5sOHG9`+buU>E z04`kxg2!FhvI;b^x-<*)#da3K0{MLc`pH z;dZ^3nj=LZRez&>f7XxVJon5mgbMgX@HNqg!BK|7>ijLXvR*ox2l?7{o^$(Gf#6-t z0(4RJM+5V(j&2+v$fyRZ2k@nTz&v>d#Z3<1uWGG%lm=7Z-sr$O<)}+@`hA)iN(yRvG0q;rvBpboQ(hHsc^H3F zkgRc|$OH-~6@!8nU;l~J1S4MN%B@aeikV`jevJ<(c&XQ?-3GSdnt;vS6ShasxqkNf zZp$?~(`+DU;I{}Zgsf&i?#fpG>7>WI*-9C2%TsS_j%-JA!5Y3!mIUzBgLLpcwyC1v zihp2tef8p5wHinT{Yo#bo?Kw{oY3V2C`tTw#v3QPaC$I)b=?_{Rg1sXR*DoMO@vv| z78Gs-p;@5t20T!k3Kl%2yf171_%aXAUqbpPA_J4kG!1&?MQ2sw4Nv`NIBrqlXI1~U zMuZ!*H?`@mdvaE$N4AIGels-LrW+n7@SHOqgpeoS9yc}7AMOTd@ka`|PA&}|zEf%s zK4|z>?9oR@N}RWy+Jg82%%8sk<;=bTUU|k?@_nK-QF0~pC6Fg=)i#6n!lAg4)lwqK zsV)pV#>v&B!D40MQQDDbGvI&$q0(g^?V;~Ix@cUpx|)LTw5`86ko({AKXpY$r)!Y? zNNn>@%$O(9HWvPe-(`zPl{N3T-0dG-oF3#aTr|eYdE|wv;u%07KiKh$J_}T#{SzD+ zG%-Jko42SvMH)Rti^eHvV0zG{?klnGs=4OMu2gTnS{3PyUNy-vSe<>@6dQO=k5k7R z*c8W0j?-F1RK_lb0WmHmOWw^lgd~r)b^Q3|8898hR2Wjr7WSJrb@2NDL!!PEl zCT2Pyl?|)g(oBIcvOL8gQj$4+3LhN=l1E|4%oOtCMGkHU-E@R8BRuH|I?-4S#-VUM z+rXsDUzbM*tPHFucw91o%`?~$V+>XT_;ZsW{OgP9IYl?pICm)1J37RI{${~VeTCmw zvsIZDeTo%1Y%Sz?mHc7XMb(P3pUS!G)a9i)G`X88qSgH}F2++Zl7xQ{H^Zunx@+|4 zax`$h193}_&g0(eKV6R=qD>@aG&f11j*97j3_ALy{ddbqhkalMyaqa})Gu_DBVS?&^u+uxdtwQ5 zn!q;EyWOx^u#PLw$n+%UQTO({EvriI5Ey8mVV>S-Nfr2*^!VK#i=zPvuswL<*#Clgw#!JtZdEP_cDfckpj8um0ev znGGKUPwy6}hy51!lE0gZxZfsN>T9K5oY%;p{J7ldDB9&@C$`@O#GZ#+a9>w-a&E#~ zJQqiyf)CT~>5Um>eo0{XsTqj0i%#5K!GM9bSkmcKcA>XkoymU&l(-dCk19Ts5n=0Gj| z{MnZ0tDbrXPc@~XPw4+F2A<`lt(hKVw2a-pep4Btv`Z;l{wHpcZ${JW-vU4!UG%D^C9j5!tM;fgfwyScNTyr*Ks+&Rn_aibG ztJt)>Np%>$2$4cNfqemCUd%6c30>Csb`Cf2wu`ZahZ_|V?2 zf+Wm)fZX=orqju~0$GIji75kA7r!Bt-xeGnhdD9kMysXzPen9+*Be+K4fguQ(r72k z1U3b;+V_kmuJTD_@CcR*v^YyF@lYkH(8sqixS12vd4DNN@qc+MIvwVH5K`KT5$Iog zKlgt1!^LHcZAEvAFF5z^$1r0Ex;8V>aZzszOB}4KpMOuvIeM4pnIN_>FniehS-R@p zvQFBlQC8V}%SL#h;Q_uv24eC>ueUZ?8STHCsWH@3AM8 z+#B)S@@6J1vh#+CO`r|re9aSYzF|$R9wGQ*Q@o||*Z^04Gw8=bTU&+-YEs{h$J3lj zx7*HfkV>@S^-5POA|bXk{+9~H-gR2&yF+8H#5zu^Z7R1`v04ZQ7h~jG^T}bGpqy{X zeL}r|LTa<(-A>menbp|ouTh;_vjBShwQVU1YiT#|sb$t*KgFw5KkYit29$YC|r8)m*^#I?KBxU|@Xm`0X@2Q2QD^Zf-rzr$ zHi@k~W`F+biysW0G*X`5akIKpM`$@sF9Fe0xAfPAlFuyXtO%)pbMnY|!gnFSvQUhw z98|clho4d%vEEajtWykFGiZD+wh9;wgfxCPMKyA1kW(bS&D zJ_#|-&>h^O7d)acT~`#OW||s{XcsqhW%cv;lEr;XZNbQ3-cEW~P2sy8@5krsieV5j zV?}s&Ra;(&DK^qla)mYeeBd=3xw{PSva%&x2Y)IlEtub<;Qd9R8GMp7VgGm_b#a z1482C_h%USD`|0?{@8v|9pzlB2V>F2-1+#_%o!)$hPPk!r)5`#zUo(vfq6V13FzFm zMkH}M#%8Fy(*+H)ydiKkJ8qin0CLcVZ-5F?7rQxj6S*E}l-_64iThk11PWmw_UpMU zgeC6bzhYTkKyCzH?&b&sEKF|cHq?l7vXxaZ0z7k|sX-gj^)Uk;>M>?N(Dmud+NAR< zXd-pDawXw0&z`FdG_W!5r2osYlOUn+{=Z~l7;vqYW+hE)^VMHtZ@X`>5IAzqpJt`~ zxm``Ua2Un>mQtJ{z;wP{4=4ScJ&9&W=dlU{^UbKW9lw;eAMp=My^LnUpXjfuIPr*n zt(9Gmtpv3&qtL4bK~mf~YikbfV5gO%h1=7^8?aB|>N>-V({9p3>11ca8wAu#ai0xO z`4~*(di%$^84kDJHTtq!jNNh!pE9HxiG_CIkMbDdb{{{Er|VvSW`x z2d)deF<|lz*b{!PD0jjnjdxJVn*Bx*cEbSelt~j!p3r#5$l%uh||U|wiZ zMiee6jr|7xOo&YIv<~k6m0)>K*eIiGegEm<;K}IJGn(ZzzohVcTWg`41nU{FqFwdu zF`x`Zk$Y0`^E9IGwZkT8g{hD!uTqzSpBs6ga_-uqEs{r15GQ?<6{keU?ZPL z--&_bwbiTz%|Cm%+})*leLMU+gu%^%a@C(rKnB<|coK7dF(4>|T-Vgxn@jhLm*ZWu(VI87}{$43mH|EadfaRE6}Nj)fuW|zP7xaZ>{feb}ANlnsu5Y2^9udew*avDYW}%ts8+$j~=^n3RE{_%?n`+i? zsxfNHUGBG7-a-8q5)+=pA6_{n1BVeFC!-e{2#%DAZ{X^ePp$D($qQpQ&xY}o%w~IiDFQPRA3uI zo?|4QUj=MQspff;fKs3T?jEwTPr3)pL$t0MNh1*Y*;XPx9xY!5aZ3>a|Pfp^})%muQ=XQ@Vpr?dS!a=`8V8#*F0N;HiC z8I;dQWrW^jUW`dIQ>rNXxM$S%q^f-js#r_6ZX0B<2{mlD;KzmmeQQG86+x{QZ)A4z z5*KHkaoKgY@aQI;)t3sk_8y_Rd&c3S_qd9+J(mg3pR)CNxnk}#J>~u$IHK;w-une# zvxDRveZ><2YKm+qF48pS|qR!2=%M7=cE$&DP~!NZt9(s1!Lc*ZX*2o1zRTB zc@J1)oywWfr&KAr@)rW^_VR?u&hem99;n$%plr)17ZL5(h=njb%$7znhFu zmldpLGO4d*F-C4G|Lir<>-qN6sot*&(Ta*(7OM7TI9?D1NJJ_gT=uV&wq-3$9qyG0 z)1j4_OFAhaP$-mZylAfhPtZ)bhJGV(<|n>POSu3a!`4q4nb$|Exm}Obq6TYY!dCI2 zgZm`vcpk-TP!DajofN3o(aEzldw9rwo85Anji6j6uC4|%Fxy-RaB%89h;2tjhJTK) zn172{JTF+2eU9|Xp4&Ij+kB|Ot6>l0_E%mP{>%jm?bDoavS^RJA+x?$BwQVtWV%w4fH08x zoj!L^N(*JKSmO;SLi_jzjWF=@^3+onPv=HFnG?Z|6RM>Uv649^I#q2iv+zO@>^Q51 zi&Wux5#DKq{MMpAAM&qc`c;WjHIiL{8D7R%Qy8LjYJQ- zVm#L5jl@XS>fU(RYGk!TsiCF|PZgiN)^tXWDUs979MC$qU|0}VFAQB~=J9hJ83*ej&u$_uxPhWn@UHetwtHNW ztLC{sPYND4Npc6i3;fLWPD?nlJhpF4@oIs&f(zSgv)RC1ot=4Turn)mTFHZ;t2TkK zy8D5tCRk+>jPBg0V~Za79@64b-|qRwQI=y{dah2^^Y)(_^L)d5YhZtwDfrE>t(03< zve^w;pi&l?d?C2Oih6V5P)AWp?p^`7#6(u=V@A}Q{rsHa-q$_DScosOJ`7~m2kr)0 zAKIPUyVmn?8)A(o?c<_2>|iv>oQNDvt}-Wz(zWd(Yw!a~QZFt`PF?lHIP5)>pD;+5 zVch@a)?am_!i=K2cRXW*NUTsLMVMYLc%gBTe zgLJr#jQAq7LzSy;0yn!Wd|ofLv7n|_%MbobhOpzX|Mcf#P81r6Q9)CN*L}OXnRPi} zERsF3_y(Jb@a}nhz>bp@-$H={tAC@<~l-@(JU{Yew2puS7U$! z2d)|8UcFlLeCy&s?;fOa8i}4Mi+k!35`j`XIPl6$gAX|U3IAQ33>z<@(yRl8zwf31 ztKgh2+#5_D!DDx8ylW8Pasa_64oXt5c9nEE?w{zhkrWaUfZxFQ*&8H@0{m~e_%&#e zbJH@T0{R8wiCxLdOK+n9Q&Fl0!%FOT5oWrQ6pYX3*Gsqnfd20?y4wx@K63wa*MR}m z`XDGW({KTP|RhN-iek zbu(zUR;!Z{XGw^IPC714AchNERM^iU*I-iB=hk1#2nnP>@*bXTpQ)l{9SFUX;ZEh6 z(+P2T;Xg<8M=#>o&HYh^d6q~q4nwMS(U-NLZ;C&()Xzv)f|*}l4+|1!d@%pXU_+ql zRQCgW)7KgrO0UBjO8*CU!q)xfXG=XrP8QbgKhXAvM-@jUQm?ZFKaJNEkx<`HQCLy2 zdCoZew%Gex%Y!>Db)yK2Z)tAz?ir39`RgnUm^E70B%&5FAvax;jN*+>KUQl%1D=)e zKI7FP-h^vx6clsIk~MS>m1xCmNqeT)kDI>gA`>PVEXwh1wcAonCUFT!7POsfaIZH` zLYO|*OTdYd)||U1`08W}OOHuY{m%UWka7HsrDvw^#fcNfg$wlMMa^Qp2WrAdf4Q?= z$>0Of6CjrplJp7R0b9bm+_BYP=zcz9KH9Z=Kbss4RXrEo9(}g`nvPtucD|v?Nh-+v zR9eW;bp)01yE?*Ke*N$%9)7Ule5wiJ1=g)pbdc+fhJ#$M{RKCn%U=~Bmk#N+U4(}z zhFx@smWxG2@2Qsp z6G4&nE--kDpV!I1b1v}i#~W$wr7hEmHG7Hnxn}BeU9uj?y(Gh+0{w4K7hZr`x8n_; z(n@%42ONC+|LqZ#- zfH5(y;G*Q{`LLZfwBS$qak&6P{Bi0m82VM7$#cJT{mfodJIFEqie(=7KlT@0?w*76 zh%<-r((ZQ9%pQ2lJg-9InPUjCIoio!U)%gSq;jB0Ju{bkUm zo+hKZ*X6ag3U7a)raW0GEO2-9@Z|CAW?^4HyKyfJo=OXo2<<<>FB1O9#+my)*6+{A zF&tAYhhR5GvE6m&SI}L!G9T6?%uRjMBYJaLXb81lsJaNX1T7>`LpV zu7_`WA7iunMGGLm?m?{x1+Rtw++*RMUx$~ch&VmoanOj!=ZX@V%d)l!#?uU!r85sn z5}9`ngzujT-8fH5fAPt1`=U2Alz>XK;UPgIQgaw{e9JdU`mtDx)`l{2AIMx!a63F3 z+C#)8762xGT9=(7(C=QYkRRXnyxt75KzleLxhaKA2ARFv4-@g4b+H=TN2K3N*Li9E z>?Ba%+d;`=Lxw5K*YiJ6fqUe2&41CSY3pUqZgHwWa2IryXC9o5MJ?5v%519!sGnG%(2qxQCGV*-Gq({r}SD z)}UQ9xe-};Hh9=TgA^qWvlV}6bjLauPg94Q+db`@N?rOshMts~IG;Q_pbhxnhJMPm zh9`B*HAnlN#tYvbBWvAWZwNGV7Bd;?bk~Fz0@O#yhmRe8`iba-?8~9utnfXSD2Qwo zJjzUvy;p|;>B=K{3#`v~9o9*ARLeLNv1Vr(`v>1$ly-EzF^ zge?Z5E30b@^~q!U?zGPA;u29*dnCr{?zB!B;tYpv5B&S5@$unad4{Jy8BGMb`^WSq z-!Ok@LdqNJ81_MVtf@M9(WB)X7f^^*1<>Zct*lT$9pu#U8s|Yb5ZBs&!a#h z!m#!V76nDhXqRn0nk9PZ!c%MEs4D+4?n@GP(}KwgVH{#PB&RS)<|C;PPI*}6ki8Pi zmvmZnC{QI&^r{-?YP?nG`fF2oH#{jL5wZmB*&LRFe-9@!D2E&ox6Vp$=J9#*4=!rw zj6px!Du*#~O(!`|Uy*t`aUWB(jB_C-5-{I4E!7jR4AZ=0jE< zP;IfnMJTrZo#wZ~hWY>!4dDyrsPA?@!5YfuV>wLURx>$a@Z`8aIs7PD3mT&vMn9uz zEx3(5{imkRW_Tv7%i%_HUj6&~awj9^(BMETFZa~H{qCN@i^X3J$RMv4f7(b!1X%pp zyQkWC`C%_#e2%3}ma?c3p9lg*q(x+hrTL*}o;;(N;mLkKk&mR@e~$dZRF?l6M%W!; zsJY|+eDl}447=q4jT6W>ggzoZ!b^O>c4+fOIVdzGn@H*8lY}MT>p*GD`KqzXaAMhB zS0+Zi`NsL{z0vTH6#G-ofyP??21t;A@W3G!RW{exf#9XRY4+WJZT>9K1y{c7SZj)z z4UC5RZg7SoGrwC$UuTYxpooil*w=wu#-YO&4}*OHe*W1ZT`)!xj=b~?!Z7a*okeIN`!C%i1J2R?hsI3uM+%x+jK6=#l;_BC*|lMvspT(`4nSvJj#-LDDw;v0h(Bh=|vF+~U!BTWv?o;F0Zux83N7mWqvr zYV)TV_MO+T5sPnrWJqi{oxtMu?&yw3bF>YNp}lE)tsls-8oE8dRodXT%nf3+XFZS5 z%bpfK{ju%aYlCSzWy{7}G%Fs?`EyiGmV(cssq;Fwzw@Nb{$R};2GE&m0ZrX!(zZD@ z571h-AISqY*9$MOYGc3_G6oEWd+TH%U)u@ALck~AKO?(jFj$W3!o65=miBGYAWRWK zbgdzQy_qdZTk4+)?9ZY=#FoM-J^Hxo7`+87j(TlgN$wd<-el{bW8F8;SKiBJ`^Gld z_F&i*Qr}(wg#i9&QRZ-tfbAQ{@(bqeKgVJ08-W1)5wTM=O~k4Gw|RA=C;0c8ZT(Lw z`(BUc*GQA+GaK6KuYc6p4lM5gZf>%4$>i!wkg|R1(7eel;SqO0qKoHo@br`Tr*?I( z<>^&&kxtYjFaLzm48+0c7hD2pI-<{H!s#;`Yk%m_LjSAT1;&^%Q3brk#N)%kfX-L5 z^5g}jCWOL9i?PXT<@S#K+g~3!nnv75M6a)-p&y2OcAeE*((KGZukBmd%}Yjn4HCd> z3bvQ5HnLH*%0Y6z2DDv((PPHfKM|xX`tP8cV=FA5L$I6e-XS1??!4rKVLw&FzM_5+AUSOcgvvE3*Z$B$(V1? zYIrh~d5zi4PexC6AwgX~60AY!MK{<$6?w*bCyOa_R`n;(tIL!Q^u1Tw2F*Wjn7e{M zF`Y%#ro+}+($THnmd)4{K1v(u)YMt&SBLA4-RAWYbEELR;i4e*f?7v#F`$?D>1=#q z^aEMk?UB+LJ*CN!PW05bBiwVC)gB+fFb&sPpMZbgZh-k&!RxESh57ajsJk z)>>h0dRHyQk>KX%YrvubxGt96;kCZ6Y^ZV+qI4gkLSDis02RUXExh44ETMMUNek&W!0*pphNa&fdlU+_vf6mjTf#Dxe{xK83WFo)AVIGT@f;utv3Y66!1U3}D0^}O^pxZZ0Wm~*`{~cl z`M(ki_&%=fH$Pzd7+0GIU}%L68i32H&kuYA4-S!p zdy}2)IzM+1#>vQC=s3Zz2d+-281QAHtR|JvvaUK%HnA95x>q4rzBF3kr68(_!~m6U zRkT1*?*4mAVW<%KxG*cK+zB`UxMh&hHTQF{P84TJoAPE0IQ;ne17Zyir1#@=E~W&! z-ofC?exU!2DtE|j#)#{UrgLJ`d}9X1v2Z8T5Z1`L%3WGF?8!(QwU-W9T7j^-8} z1nZI(?j8g_+0_wWt&R~yc#ka80slm|tX?<(w4ibx_md;v4k(-q(K?4A3+LeLO8YLT zn1fGWgSC(JfsoYFq6ffA@+@OcEO*(a2VM{2g9=*KmxPNqf_$~8yEyVac}|~#d?^Nc z@dJ488si>2;7DTIznD<_+vzkws3i6Sa7qv6!~gnABf@ut6>KlQ1W%k$iMzxOuyzN@ zzOtff*R{*%?So70iXGg(eo$^SCyjPT-6}_G2;etiS6`N3!H@KSC~?>^aFA}x%{@@z zA->3Mh_7;+zZDvYFUB5I{>Gi%`la1ETPZaC@1!dY8sEdSD8jru?nDj_xA9TtH38$N zCvognPI{93BSo~4%#Rh(eJYBgUcufN0-ru*6buzd27r&-Nsn4Z8vOun9e}a-z0&oI znMbN@4;qez=evK*mafiv2@e2omJ?av@j13OZqnqvs{F0`wk+8Zi?!1MfySIDam zU>l#Hp_A&X*Y{^q3}S8EGZ)gt#1?7`q?03+uZ@f#hG!26NPnbyj8rnoc+OSDz5IX` zNw?IDKIV4)w5cRr1{DDMxJ4vL=^yHpd%fVDyz!_2VL|q|U!~06eFM6dY{xEj+to8R z<%bwoMCR%0&Nq*V1&hOJ^a#Z%xs*~q!bsg;L57y}>G1>|%8R47TaM8=pW5l0p1!ex z@8`Vul)AaB2m0N=H0-0rqT(RGr0H9wdM!WRw2^JOP3h-GvMyC+lDxIQe0E=SH#==Q z6m^=w>Tn#CwAXT$CtHXXTUIYO{Y(ZZe%EK~O?FlB0xk)j6|E~%;(oH04Ci-=XZ%wp z+`60*JgmmZN)CvVv|>LpS}pSK0lBc1O&PoSG_5!WNC6%l9N!a$+l2;XCa?q)qGM#6 zhcx5N=`Sv-Ep9i-q>Vc@4)S>Gk{o(ts>u*G?ZGKif}Hg49c%n?LnO9midBcqi3hO$ z{Bo%^M6;E1Ivy!Cn zib(wDjJ?hsk9{Mgxr6k92AyV3pH$72+kXoZJ|o!PMTNo!PQYQi8>nn@YeU=88)gY2 z%MQ6|uB;$<&HOo3e$IY@Jm6GZUGRX`@}tcb4Ji;z?J zlL8fR#e2$}UCW+(Jzff`-N+E>X*_GIt=&2_e6d!u_a6r6Ua`o~XF{bjB+KfBqO8^Z zo@!0Cn$imj=#1-UdSDwZ3PJMg!Mva7STFO8#Ci~j6(j@HclBW_qbMHT(!Upa1R^@q z@rJ7;KlNy>;TiMp;nZC+B@73M9PU|N1x*w?SqwsCD&9?2T8f898 zU!RG((cb&wY;S#)qlvidHQZfN!^!YOGsY8Z3fFfqVH0K@7QH7^0UFazi5h2u2sc(2 zMeW=af@jNPGSHUzKj4_ZK(Qy4XZY?2AU!eRd4463jbOvR;B+FRrG}J}!{FId(z$|n zqwP-ujF$v6iLmQeCGR#q7Q03iNF)`{drqMSNqEn2zGdpN;v<`^Ig)?_qx3=oogUpd zEgsy)?o4e;1mS9Ywsk>Nr{&pTHi42-I?@y8v78bLPRq;||!D9iqJdJsd78I6B zvxU2x^gNJne83C}Yi*!dK}9xvj(_iT&cssuq-{I8Eci$osFoyLbiF5$gR|&gj_*Fx z;VvFpBcV`0a-`TwtxF9b&0EU$7a?3|99%+unIs3#ZbTKQrEP6`k6 zKRqEnN>um=JDc~oIg0aOVD99vK-n=hE+L$ZC43ENpFFu`-PNV0Hmyaen-5`KyV`Cl zSG*@%xoxrb(@J*4DfG*m_j4DepQGZRHYy0i*7DHZrsr{f8^8Kt3ec&mde1{-xu@Js z#H<{ITO@yxPxPy4IPeVrdl$N*nwNOYQl=aw$J(6_qoY3fTtC;=o-q5e8$Caqqf zw@5yF$-w(|!h95o!V0!q$1lfs@p3z56i?@LymoWLThdqut5vaMyDi#jXq*U21X<NtDrJoIi`|9wZ30~~w&viFUn#+C`_psC;Wl!0uzDEBCVa*rmm-1Fye zxyJ-eo|u7(E+lkM{Yjp1ZvueDdzQ7I681xx-VqK#pPN1`fQ;2N9fv)*NWy4uJHv8n zf}!Hlf_TBrZ_HsHFbf6v_c)lzJVHaO>sZqb`7`cedUd2bY>UP4x5kq=bN~yzfP;Qd zwKn@H@?YSf7MyhoIW_wpp!lsC80$67LU|ai?|^|y5vrE&eL@LVX76XfSZ;n5 z*E5o3_uP6&$#V`^Y(VaD;k71njF=2WFRX8Af ze?@!>7izQ(S@u6k_)ChH8M${Zy?ZBxuJ^(N0_;#+1S-)-O{81$ftM!WZhG=;(Da}S zl=>V9H{63Zido$+Eb$oJJ z?)mVa>7da68y%Fgb$P3jYdKBn$sfPyJ40!IEC&KmDajjID3no@cPX{dXFo1#4Ri#z z;eh}6w2YeP`+YZ8K5mFv^THW$_O-%YkWFAi)AbzJxCNH|@Z-ha#h~mP``Ub4agW!b z=9`}56MXw9n+S`9QA8ZPC)qQQJRoy~dd0N6-DBzCQx1@e=be`TCC!UPzjiknu`xsQ zzm>a@b3lx%IpCGw1LlCJp4=(d%MxbNMj}8ecx8WR-{hg*UhxFy~8WUNOg|qdpt%~#hdrq2f zUJ7&4HLbUG3!4)-WQne&7p7v&TX4U?*o|skcFkgw(1behleCZ(VhSiaYbw!B94Jr; z_A^b$#5smobK~4TO66Nh5SU%2}_dm|-#?@p9CD}rwa268qHE>Nm% zy#wZdZNJzmRd0%IkuN?JJ4*H_D;57l9c9rwP4LI2%!QJSyaW?HndCkYh##WUB7#0q zQ(8f~Tfl{fwyS6nVM`dEv}6u3(A6w}Rm#-1=~U-tKCtqfCaG6w!UIX!^G>P`X}Z&K z|5*x6nX=xtkb=e!ki>_l5)@*$s`k3SJpamOXmSY$wMM0|ly7PUq1+{QpwLB6h!U_s zQ*It?q9u7{MCm=4|2d04^3GwGd?QsGZ;yWo+tjQcbbxC0ta) zW|vk~G?XD+zqtk%NXMex&mY_Ii%PI$l9A|wID)FmGl6R%BsFm3%i{Q`KB+?oonM0u zsDLB3FLJ|Q8VK|1rO(tKtj|3Z317>t_Yo+SHA`B`zkLoN%ALR11-|;0uzc`HN!1lF zLc3^Y^4jz$kI?X25=$^Or_rjBYumIkgGNX6x`VYoQPiV*vTU*`VbqF2&S z@hQ`qcJy^JJq$vVTaat> z^WpjYluS{&C00!y1U|1jfRDA${CZv$4Y1_DAqk*q zC4Eb1K?+BWkN$uNl`HoZyp-%()!9Wie4E#I1qbuUlRnhwawUjFL;)@V0EOP#Jx&N< zu*sfj;!~lxV@@zh^hAy0|0^i;5WK5#a%3;ut9tKlP6cbqAQC%ZX(R8sonGuQM7PG6 z6w=}b&)W=wP>{ncRlGbFLpU}TAB`t0*U!;p0ecI^a~E+DBL0zFJmrh+EiVH!0~cLn zFZ>~tGPoi^UMnuP4XBur++Gd!Eun!GA0Ia<$NGhBMrkW%!2|Dn^kO2QF>% zSjsbaujp(ZcJP1$3SIjC+5z?tF?3f6R)$2g+kJn6yw_PHLU!-w&J#yu+6PvHE##;F zAVZM?(j6c}?;C~n9$(A`b@qS(H$^Fl9O_A#iK#+T&cRMlP#1>#~1(25j@X`q-+k^s&1&m|HgyRw$lc)kYGS5qHvy!yKcjR3gp^3*PL9(G*-!s_wIOLL z+r9+t>=mnTkWnAWAn?L}M~B+x^$q_IgT()SJ6Km_W}DTo2D_RLk_hrn`u*rwa2B0J zgZXm55e?KKF$!nZG3lee^M@vJBXz^(iw1y2E$`LfRp&iGGUspOP;DpukAlRHcKce} zos8}6G^aktR=DY}m_$AAwTge%(YfjPR)g^0#)GL+o+1yf#)JPykf=WN(5K4e$G_;I zHUEJg%A80jhtzTa9SZD6sq+&Tpy;Z$PYh<#FK32;I!Z{~b;7wXLO|`IJPe#fu@J0- z^={4sz%J9D%;Ddkvf{nXj2eAv$#l>kc$n4X9vkUh?TP1+S-!dTh%~}mhz;)Xl<$cO z31EYIqTyr|-**|fy~i2h{eZu~_4z>!xVRWsgDZ>v5euT)9rc=24>MlJFB;ED79JJ) zWp}d@->txkoKsnr3~? zQioWc*p=X+#66~nqJYi^St2y;A)hx!f_|)Z-wO@3DIne8u5eUPRK$5eA{%P>h=v?< z=e}pT>o{ROU0=|SF_HM3aKlS$n&s?B%y|L5s(Fs>C$4#38r-4Z2WjZb6orII_D9=e z)Xm3OMTzuBW8J!{Pin`z$RJ+L(@go_gN=Dh;)6QKlaxFgn-$V-pFJ6plXA~+VLWfU zRf%iCMi=eL{0(!w@#}g6o%gu%&$KsYKiK|QVQngVEb~xV%Z@X*g@6ByNsxU*9T#nr zO^#YYJAc{(l_*|+pHD<9=C;G(N(1Ndl(d;R2f$WxGYlC^&T zwX({`a-(#$6nYBla`Ix4q5bQj&j{-8bW{-I1q3XY@;Q^ph(qc~*8I_u!|s$TjWm!h zO^SeT?fKpZ_7eo#CO0i$c9P6ktI^H%?T-)EJg_S{YP-tM;^N8z7+{inPzaqHJ&c}W zg|jW_)0bTaqp|rSQ%DqC^nLQ~JDS=8U|qhf&F35^-?fKHn$3DFy#XLni>@r#7gF~E zPs#eAim}oUJj^MBnbPBGczTDi;Mp(9zL56DGZlC3lRO%dG|<03|1B2k(k?ygg8%D4 zY;8>bg-lW0ao?@wTKJIgL%Zp!-%R@aeB{ zsCBmY+Ep3{-OpwB7i+6tYy?O8b5Va^zZM;N2+o?@X;9#gkW)?3hfIVDPZ4=}%`OUm zo^qw+u6eVnxRavS?jBOw$y_s?!-S*B1);=~5VqM8zkzMbt=JqV8AGKywpe9f7Xg za3E}0wZEVGxO)85C&onkbYU-SSWwUd>zztN&O4rp2%bHwHRq#p6snb@RsHHZ#R<1=Y!%Bu}%mc^`=0?uyh()9&g3mp?rti*JGqglrNR;bPP9OFMoi z=328F4s*%3Qz(yEWnI1LET(be$PO*0f6)NS7uz`$lB5+MrsKQ9@}2>|G12lDG=rj* zh1@njXO^Pp`Z4+MVT@lIyveClCMr)&@CwmUdEbV8Qa;w)Sz`684td3g&yQ2)q!g&H z&Dto1JTm{=B;&HN08y_8s7JTFlO92PdHT&vKNQP2(Lh!9>k{$sXb z0^>Aoyz^Xal;BMf@lJnNCef&(6OJhe)`EKqO2#C0^-V{pKVyD zTkf___XN?6Pz#D(nwC5tI(yK1+IILjv4pn;pOvIH2>1BT4-!|Uv;@=(Qbi;EuGcaD zPQUOllh<)IkDgNjFGgRmMK3X07dUmuj3OiTuZoES%z9km@c zpwG_e8Az_q{tRj^HsPb&c7S?QcWYKo9rGALcN(AMbDOQ4XN005ITc$TUFfcNI-B-) zD{`}U9|pCkKjDzBF57>nks9=5?2LA(x|#1@tox4LHEgfuePSc6N7iiyDsSFZC_$%Y z`Wj9TjdRVV&~SFdRUepVa-%Z5)iEWaN_9JzT>FYk7!aW_t%m#R!JoDqZn=>cYJ!GQ zVm=f8aqiSMhgO?D14AV$`2`OrHHijGs!7W}u)4ILtq$}Ml_bqQk zqufRkB8pSZU9wg)$Uf2t=2jJe@ZRzcffJ~lkUTojBS(eb9u7P3_?ggMoLti)k14r| z8n1p*VRq#4!;gX26WvSFRbUC4g9u1nX^Rsw}7foSb)& zq7iM$Dl3mSA#Wr7eC~@5x@U_d<8ORw_c@4wtui|CQsGl=z^llV^ZkLnt`bceRxMs_ zwXhrCAJa02Yf9dLJ^{r#Sis&KtyS1#Il7UglAl-mzgT0s9Na;qT8$?NwR-~kn?v|47W*9i%8}xmj_qX@i`<%Uh|M;1id+vZo zpLJd9T5DZMqAl~sARaaNXI@ona;muzO!A0o4zQ^Af)?4vUAS>Q0BFALdj5&n9_qJ;cd!wzEN z&2+qV?t!pZiiJ^u)2|lb-OsjAB)S>)8TqeaBgCt_==V(RkFKeopuOh}8!^=p=VVPk z23v0RQ zzytGLNvB!KpI+?*N%d{DZ2~V>tf$Fzq!KB{8zYn=XrE=7>#i;EKe7#) z`|`vil?wZDDU?iV8AL-FCOTD+N_780Y|aMt%(Bl5^w)#kuudHDvf8}Ejw>w`@WF>Q zYHWmuqhU2H4`-hv?PLmXK7cDkIt|6RG_P^2h-3yO_borrT&Xd*MGRs|n?k^vqZ5oY z5!8>0rpx22yf~^DUp-f@dY<@ti=?N4q*0Jes)(`@KKwi|75WkiICd6G>tAUI?~w|j^*q(9ctZ1`L?{-eG*(AC^>{|gh-99` zlQ8jzih|btX*`@%lmW2dy<_H=ak^K8Z^lv-3(WdzaTAx*wqOWY=T}M5K^>SuEaBvkbYBZN?kJ zij60Goke94Ugi3d$5NxSdWQr9=C zkJJ$FMWX!grog*~6;Axe^7{)TiCP?<&q_sjpcYm^eOuw z=MgSiz^>->tT)QwBg@o?`_H70X{s0e_YHWyvde$)DyU}0M9t_N*Q>rdN}tD8v3~dQ zhX>ZtYm4^$M(17Z3HE+_3+?@dw)DPFgB^>E)x^3|8qkMzZo@`k3tk7S*by1^Q{1Mk zHEacjc&;rt_q-;}{eW`t|9VwIcO|BKKarh-A&V zz$g*B7SD#F$FWr00MWug=&v1e^rW+PSxF$t_(oc?Kf_4jb>U}pykEO0 z#84gQ^aA<`Ego{)UkN~c-Uf%t#1W$Jp-w(de1UH9Xh^|DdRLc3AXpH+Qo?VrxGD6y8Y=|VWs>IT*L}(oL&CT zHnGEniA1~|>F#x)?CWM2^)?t~8Os}@<+5z=ZTeDBHEtiETT1F zdq>&jV;S{O^w-^ZZv%~Eiv-x4B1+*6)(@0NYeoh;*qwepO<{{qXsmzg;|W>@SPj1ExmEN1cV#_4?_J2| zFe`JMvMPHld!n*_+m9XVSd5bld1mHp z35viUKcO9$dQ|d*LQ*XGph{d{^|E16?O#s=Rin=w0r3W1pvv`>J{EHaE&)qWCI&q$ zd=STu;OlOoJ{U`WsC7n$H(3g5#;$!A^8@Q7_Q39;tx3DN=5DJ~U~)*hs1b*APTGfK zab^aBq4YApZ(&RrcM@lt?U*KA>Yh$K=+5G6RN=rq)Zu-I4 zT_BM-&-XMeRk-%KgUIw=yYbj~N{E4fG?{TO`xBrsn1PIu75qB~Wh!WB>k8 zU30|fK^#;Oof++qnDw&R&bM+mX?FSzYQ)r2b;)KHlQ8WXE;>qzwW=rw%`fh84ls(F z91lzOIk*lnTcHGdZJ}SGcqv4|w6zWV(N=gm7qP3YWpXFpi$3{_pM+peK_NSMFG*%6 zUI`*t?DB=y@i1>W+U&YMB2B+rIi^^x?!q>uQ^Z)xSiX>-&BQH@$@1;p=CuF!l=SaJ zw@VA>C_eYaVk=R;%=7Y6F`KF-5?n;f!ks^%d2=QH>aMN%x;xt^6wVR(y}5;oF+|of zf<7w1cIDl5j;yppll`GsRl1uAmYvB5v?NW|Aq_SrKOdvnT8MGV1pm6}=gI&KoqLR8 z9!mE_Wjz|VGP$e6>RBRwfc=*dQqMeX_KU7-o}{{NCHs@ z{(;{twyNtMe)X;A%*Yn|OR6IIwa;8l-K@^2$c}kqJ<-%7QWgz1?L`!%?9}t}ol~u^ zz?IEav+O8w4F#7+j%v-Pucl{ea4V-+Xp5FAqUVAA3roh{5$-2#68Cic@&OXyLd2{Vjp9Qbv=^i=jO^Q2F2N|n(LCXZg{V}H0rW>V72UFwaGrS zqF9JQ&!Oi?z`?NBcm4*%&;g0NbUtO;-*WNOFTcBwQcrtyhs)~YRsPz?$^w7aP|6_ksOa07exFe7?3RQKMAp+{h%O{EwOwt5Pi(mH!S zr|IAa>0yD$4@=5xu+pB;Jxn{R6j0X{T$x73{3#Wi=F@H!_lrgde2L>HZQ=7;!QLx) zF$mJ)qe_f|p)0Y)Ck9;kc@HY@qFOk6vqwZttFWT2JB<)@(pUAD`(~c&E_WEK834Pf zaMZNUw9cns3Qv5>CC#$jqR_LoCwrq4Iw0E&^^0Q{*j;ahed*_LN0L)xA-j2G+BNr?^) zpM%7F^^WutZwF;itxmUYnq&{NnqRHe6-D3sE?pQH=*%;O%5(GJ_Pl5mjA4~+EMbd~ zx0hM6Gd-#bUE?r{aroip z;x?jv;xj>XCGw$8*=orNdqv_;$FFt|V{RND_)oC%d;BdLZ>)$g^5?{H22JC*HOmQ{ zE;EHfR@vR3GVPlUw;5-LhomEENq#m z7Up2k;h1ute@6=a&WySN2Irg+p4vogCRfR&#iWpLWC%Z)b9hk4VwCdd!_c>5Xs-UH z6#ue|@0xe1ah5doUJ&R!5xW*MQKG&c5vu%@^NegkF3SQ)6AV_{^d%cDFRsUUq(0hfeCK4`sc%gRxg4BB!)!#)Z*}I zQMC3#S-5<8wAECMwQcplQbSaNW`@^g}qqJ)I9LSS{K5vcl;8c;%vp5 z%!To2z4-@m5$%}wQNNjEs*BTK9u8}{V&SAH+Ee_ztBMT4kgcR~m=k6YK#^zax`P@* zB3c?a?@hvI0OTz}yM@>N#!LvvEu*xzPw^E$!`cUGhHWOLRtmfQJv|n$97x!j(BHyn z;khX8dXIbd_Jl(oDE>M!xj5I$z$S{DQDJvc;?dbBASyieanyb+^X^4gbcW9{G3&<8 zm;=x)GEy&p4P;p5XVSF3C1|`VH3OdQjhP79XA$jt;;U;rch{?7XpVDDFSP}md+rYu zc26V`313!dHKT-^@&SfArAGpnMcNxPb>tRJ)w_!#4G?*p(!nDGc1^>@q6-W1)+y@j zx0@ZJXGcJ7w53H`ecg#rU}R$oP=Sb^PS-f#br7$5`6J(X&peDe>DgV#>!2#YjCVUa zBLk|YE^9TTs)*H_-I4AWjNAvt8f22=6l2?ErRI6Z!e5!?coq~+G*)p{eh;-oREI@r zyPK#d&sa@#h{En354_}UNulO@0O-JtNJEk74yov}uN1W41MVjJ=eMMVnSXz`@tGxX zT@Ry;U4Vb4+i(Su8Mf|S3BoicRU>Srk$|l`Jp~2ZUPF8i&?P#%!+Bgc6UbIPdTk7% zrmcq}NyW2W$;YHc_=^7Yc^2!#|F->+$# zu+(c=g;7W)P>w<@;Ca%MbQ+Oa=Q&Q`b3tU<>rC;wzDhrTxl6BwJGth>CwEiOQE-r2 z--oP>sv=Rx7(sZD;y^{=d#I8?HYI)S?alN?1VQYgV}V#WY3Kci7sXj9#=T^CkpTSn z#(l|^=NbNA-jNp06M6N=a4+;2Rg}0#O4h_8wcX>^h{nRwWoI&*O|>v7XY@jHK@=Io zbac#+W}6NE%itG*vYzRhBss5R0(p7}RnU37b)Sr?`Wdfkl^c9?%O^>KQS)YN(=^Hzlzp7!N|1cJ$me3XUa$CP=v0#jMQH}8!P=U`tHO8if zz}=%gl(@qRDztcJd{y63?leT$0*nEbx9z!Ca;xkea3`f%MSWUopVy*l3Y(fN(?Qj4 zI&t|`Gd0db?-da~50`TcXPrQ01nQ{nu_&tP(YYXZk3E&HH}Pv*pyn#Qow{e!WKpWj z%kR3nP=f-6#n$gVt*&`Pf3C3iqO-!=AJNb#j}4RTpTv8A_|anv14lvJ`q~Op&?bu{yut7iYVH1 zWoW`|+AN%xCewO?D%#Uq3-OdxY0V%W{>bV5!cvx`?Ki6B}d9m=c_I|r!{UT4kJ*N*c2L8e8epPn2VZpt~Z8@Sc*;IN65 z=mB4X2o#o4WT(!GirG!1V3OS3gAP0nh%^xV56p1C1nxp2Rw=}H~@0D zpie!(^`H|NXQf3|QK7Z~3#+-PQV2${N%K;cS z4ysaFz=bYO*p^Q_LA}8J{u((_CEY*S8^IVVi!kW2y)~~%l|pp9vNyqxbpRHYpydWr zC;~^sQuhc`nlt?17L}uy1Pf|k3^)I2lxx3R{kA! zeDv(S30gSDJpm+=HY6{off*G^hCcaHw_KpcPFjp;R6>xp9iCi{1Lk~~q&*tN#9cY? zoAJqyNqai=hvINT`*IDvFiKx4VrTSknii~H)Cqr2yE@?y=GvlcOk=AKlz_ zcD@-3By0{2MfB9lD>rj}95HUX(%m#k!t0$aT?QZ%hf%7n##d@U6)*dS*|^PLs|3Cv z{$_CG3d|TYeVsieO|Gq3b3MW^4|D9Ms)d9C&w~!!u|Tdd{4BMpZ8VxXOWP-itpelE z9-ZbF5YDcc=dg$qTvrku8@`bnPUERNUF80A`@NiCI75osaHzIT*SDR6NbRqm^geze zMNk1pWFc(cVbl?OJzQ6g_f4*vcK90*eK->8&!8Y!ipj3VCqL-%h>xdn_pT5iL$0rx z(N+6AL5F`afwLDGP@cu>bs_B$4OUHZ0t!hAO&5xw zF)tIuZuIY?RbH^d7w@;9{Ow~4NcWYA9xURZX0f^Egi)feX{C2m%*z?U8e7tO)-K|K6>@pXqL zJMcIE&j9XcDWT|>#h{{#@!Kz<;s=BtEZ+e>Y0+K*n62QkP%YK|p`#Xp?D9+ry;(qh z*u65AyVF{$JZF@>D7>SUl)5#Rl@OL?pJ}%lsW9jKgDlhS zm*6!kFqq?p;v=;14)GWPP*XVTPE5CJ#!n zPIq6@_O^C}{~=cF1tNW^PSGs^&{qr zfexXz1HT3O^KVY0>vgdYVG05L3JXvBU3P>$(`C0y4*SoN^&2^wH;`{7nG%VDja{GL zkK7z2WU6?;$>7J~?`}8P#nQf~N}Y7@jWRuXs0g3j;jn8WnaAEe)=4j+r{?xMlh4We z0lo0e?p8k9^b@Bi&kZ|@ca=>(~xcOY>N{(oyzgS(a$Nehs=N$C_MK3w(riO8OQ z!M9>Ysx-&TH$lO7ETQR*IB$hz4Oi9ob~Hv4g#;&_rr#djPUbI+JIq1zpRS5+BZNWt zy`uqR?Rst{7|mZ0i$I$PtDP~&rM6Gn-<%;eH=Po-A(20(?d|BAU&m>pt|AoVf&1I z{1(EnQm$YOvM~euXUbwAs|oTM&f@^^KcWM9Rs7S0A{pSg%A)xN8vjqhv>$K^&XPfP zxzN@2hyakkyyf~og?HdW>;o=DfTu=Lo*C{N015w`;CA&RTx>e`FNBW#Nyxf^I(Y2Q zdhw8n7-VyRBtW3xd~`oB0yU5GHuy{9eikB+7PM&64Y1o(hXvRkTS_jHsf19$S59X& zK+x7cxY_LSJoNdj7bp}KiFDU7mju5+-b3in<%JFi*7NF>f!KxFAr?R_#oGu^5o?jS z?-jr9;h4(M7*l*5%L=Oy4rV@6`NlBq61&&gGvfanQOldbC z^E;xoIP#eQoId`R-)tN+)$+l1>)+~~%T{|P1*4Qsz#z+xjCEd2KG*snKHKd6%bxq| z-EiGTCRAaBpQ*-1YL`eKs4cj0Oz*|8B#x!~x!Bx}(fTm@jIZ&aEXc9)n<{}CHE5*S zf_Zm%B$f3jEYa4JJFq{o`dswc4y-v(e%NFX>sC~Bpcd)}AUVw-NF6<2m1kjC#G$Fr zlp6D=vTZwMlwtHbj21WeWM;Al1wFP)bryQXyKH|hsn%(hJ@rmM{GHQdSB>Id{Y}@j zvs}>B1H&M1Q9r!nePQE|90A|8=}T`hq$HJ17d$mJY1by z*qJ#nypa$oJSqaZor_*u(R9c@24fF36$BA>;5y9E69_+dqdmO(41dTis-CELi9d=) z2wN9H>uAYX9-G|I^N&V*8T0V=X5{>@DgkHS4Vu!jGu$;{se|-j4LP0w>eSShiV$cB zaVeLHLbnoc&H8u>y5^Vg1`TK)0vij#`qL#BE(gGN51sq$fYyfk1LZt=jGprVH#-U< z1Ny+YP>(oPvzU*4mS6ck!0z#3pE)@=UX6d=znbhUk#R)9VQco~G$c-Y4a)%F`b+o^ ztzhnej{41~ZLf8H^S1mQi5STot2SqS-T_Y|TD!eV{e5c)^T9EJ79w`~dFR{1IRYyk z)ULTNiI1cYw5ofPpJg@($~tbWcq_-b!Y8;FrrWKyDrXk>db$;&qo*T5*L~#VIcGwo z&yz$DQ_W}D16u6Eq=1Ql^@^NY8Ia$`^E_j;<|w5v;OdHhNJb}fQ&NN#QjHK1J~%r6 z({bw#3bpTpg6lI|A8^rLbvZy;rw8DjbR^|O2VhQ)q*K<9(dP{}0AF=c?>U)M6U?UF{(Q;dQ zD(OqPF#Kf#LO~-APK^&r7q1}6Hvv%sKf2!$ebNavd~~ar+kTjk+ZWj*DR&yzMBBp6 zba5w@A8cD{avWY5A5xBr@^Dq;bA_arN-+ z{-0J`ob76Y;(6zvMtfJUx@JD~Tf^q_t#KwPcO+2Hn185xFAd}_Ab&e%ajtI_#+)rk z(Z&ow8j6v0d2khU#I{4q7yzj+TWu|vVIao4*kKSMxp0vt;4(4?(ga?7+8GB_qS9o7 z;JV-q&>{bAw1HVY`44b+0N|$e0Z229dk@43;O?8K)wi5L7z_mmVE*G3`s)`AsBcfG zqe15lV}f2?Ocww!&s_HdaPEBO!<4pl3~qDu(+{-YM{WT5tGgg%7dj`yt5wV(itxM+ zjSxUyz@FD;t0#c>LA@Di&>A2<3<3*(DfSJlW5$2=!<3WnfSd$eA2grEFwh~_v=EXi zO;wbKFM)n}@Hhd$CpZLQ{10&8qKm!+Rq!bf>GkEWNh?ryjf7fRijGT|2N-Tj1Of>z zP6RzOMEgUw{~UJ>@S8|Q09gHV!Zb!Mtf%4?v@7Jlw&&oPp_EG|RIoNq_ks(Mgc^RZ zHV!&~q>2Wuv*=}^04M{8gUjYWYFZ-r>DN=}JA(UA2mU)6YRm(%$w6)Phr9N;$8p%EHP!)D$DTbDi_%?HNfxXZ^YQ6ZyJRvqK#SXzdO=Zlj#J&&G$r%OIBE1L@yG< zJ{4zhvBREos7xF!fxrCC;HLgu=YQyK0dkuO`7@MUnu(|wCb5HFP>y~5zq@rda&n;H~s=RKp$dnG3leK)OZ zgBZ+I**d?0C?J{Z=CEp2{53)*k5Mv0E$-4!3Rz*hZ#~tC(=K%)cbv(5Hmu45B{hXl$(~G4`tQm%0rriv9l}9 zPi~nL_>Q&%ZK_!QY;~Sr`nvcF%t2^{E#fAVLWDRB%&y-ao7CU1w-A z7fVwhP&@Pow$eqy8Yn&?f$ve6X^GAD)J5@#YG3Yd_~d!)mq<6APhFf z+yKda=pxbV58ksUzp{T7HC}7F?J%Jz$D_V`EWj)|#fYf0Ln)uuTfDFQn1f<9tsulfc03{;HUfZ3W94Z*Y~QHGK{*8&Yamr1^Kqju!8692VvKFr_KSxy zo|p9mRE4C5!VX1U5O1uLq}%dOE!9lVcw0g(xdL&W!XNRkp3eyPnE~<~q%;oQ|JK!N z2V#h<;>=0bDsLGbjQ0EgTf1N+)nH<xs{7k0#!9&fpjgC^VRvH3|~$gc<5YZGbo?=5}N<7vOqR^!)UvA??dl8)$F%OSQE zrt{QW2T8_6>Harzp&X_<`4lhrJ=zIN(FesmBBO_5jzk3P-NKK-J`RUgivW1=^#Uit zD>N-w>ndqP&jr~lK62)DrN*LBo($X)%DX^Jj3d0hK%Lc}LK}3)+F1GlWU)mm&tawegB~di2rlYC*U*E?5A=SX(QgfT`@f@_KV1B$Q{2P{rp=Zk@@fLT52aGzaAr zzmAx}Q(9)OunrO?c!Rn!nZp=BJ`O-}{H8x-xCm>5+sr9H=86f5pJgq%e#KoLjNu!t zP7gCDEVnmU{OAIVZsFJOV_cJ%J#6_x=6Lr#kHNKX$$<=?)x^0~3LO=?qCIU5u9ZMp zKL$682O^h{H=*ooj?ewVqk4YAFp%&pwYk{Tuy==dBr$)q_TNl+_lZxGa$$^pV-?-X zA2n)=(;HE)v*7RH`{8X`rwf+~1Rz_rIbPD$zITjO*Wr$8`$%@%d+~>}dmFWr{x07+ z&z?2pg^B=PD9moi3*{ohc^Ka*=`de;(P1mD8_J=z|A+@&?#7EC@aNP;;E!dE3240m zM1zj|-w^#?EfcQn5{IEu@mm2A7J!4pMhV3|(+|TVKxcZ%g(vI#OQ8h~@j&z~Fff51 zSINWpnp^%qx@!QuN*8_he{|OX?_%(ohZP@91mU4;X>j~&l=T>nKwD8 zApS%HL8tuy*S#dbe-zbSH0OZ#{zrEWm~jy816}FjN$D={z2gdgH;WX|n~xAZz?bR< zHT*){ARXxxHUB$`yA+tY_d}%q%W4SMB@tMDIZem@VCK6&{Rg9A4`4s1G_4abN+({^ z?JZuV1^>~LB}(DiCmhd7m9`O;xmNgq>sGuAeB3jajq|5$tD<2h)n1VSCc-8NA2HpP zAEshJYh3|r4J#@l75zI^MshKru7{8(OMbgcgG~TJ_d0FeU!+(_`Z1-!8uXb9S(foZ ze|=@4Rz~NWzJ5C(!zbKYrey-VmKvE+En+(|%GWdSoR9+ zsNiQD6!lfrx+Vp-3(3R{E>_u{S&!NTPrObQT`cccbdaxony{a{>n=KZvV6Onf9cCd z`~FW#Qi9(SVtgYXO-ZN_bp;q&%$7vIQjjXi{P6AI#x2)-U2~b^x85Q;HYP|&mGz@B zdKrgR3Y6(#138Jq1P@OierJP`*Gs^k{Tv#K>=MvWQivYZtRbC_Ib6Zs->G~vi5eAb zXm|H%?WEhWeX~Wz)#5^0HszxhK4q76gYMjqp)-Bl)YkhXLiq!c zoS&1)s#XZ1_WgF7U>_$7VIj+51lqpCgs&gEEn8*movpHHbnP3Iq3R1W z&NR<6K8+2S&gf9J6QmA%yg_B^vcp?=K7baKq4xwgq{U@1STDwITSer3pqlyXGBE@? zB_rjlLh=2K-A9!JmO}X3W9heB&-$DU9}Kxqtk7S$V+2IsQ5nyILf{k&DJbhF0E#OD~1xRVoVGS(Hed1hGDPro4p&L17e* z7?)G>1Bt4cVf|#A=qtl-2%+9ROFVO6;`m}&JW&V*fka@~gj3A}wlZoiFoNgt^L4pf zvI-FcBGI7Q*ca%#vnkvl3u*^F#B2U2(~!;~bM2Cz2Px>>(1M8QN5c$Bon1eDt9;LZX&+wJvbAkBvTW6|c^Qf?2+EisV}lg-7i6QJc;a z^AcXIX%by$et8u&HDn!5rXJj%?Iiz53FPVORCuk1g6Hi;;J^X;pp6h!1 z;~D)K{nhK468pH{K)3Gpz)QB;8TUNlr^)LUCE%!8!r*DF2QHKoylWDlp8Q(>alEUX zFnLgRt5NA7WMS&Kc32jI118Gf0dK)Om`^NI}r+GD>;jWO7b(sv!m z9QE-(Vh!E6;-{QC`gG9ch8EB-UQ`!XRqz)~I(sGzErt%%o5NIpIoh6<&H@rGLxB>YvURm=@a-=q#_4dDtIIA^2_^XZRyd4R!_D zH@T(_yr!C&1moo7xH#wY>J;Xg?)_X4cH z7lvYQte1Yc&e@(^?(93jfo;AKm!Gfae3QoM z=Z($WIxT9lp5c}7j~)Y5d}d&4>n+g?!3!4*_tA)WPmuw){M%t%PI0SK<4S9s)#;Mebv4MuQV{}H9xf7oEo)0i6G z&jViKW9vIMrg&O1gKfjKiJ_JA;EzQP>L~8=`@Fw*n|6S*@%mC;g4&}IFN5$?|KIXv zVra?a`9WZkUKT)1p6>oB3au};#i`S6s^sKOyqn%yhI1WawQh=L#vRfKVAQ4~WF2a- z4n^yVu0eD4daJ!NWy-{*YTPC4J*RQ-1yd`{MHt(|P{LZy@#iWSRHP=Q$U~mJ{Fi zHQ%+Pl^);hk@K#GKEj23FsMs9up(f75!KdVhW~Y=oal(7jHM9N9CZB3)#jl`>Ac<7 zA;xfbWgZw}(AOVtvwn-a$v}tt@m`RhNvGdCT00!EamM9mQ|otY@5G|mCxo5TNNx7! z&tCQX`Vb|Tc5Pj8S1=DFjg?t50zSN&a1E^|Rej4O+0?1wukGgVon_{ZLs9lZB8`2) zIxl#T?V>o!3*idYOd0pb4)nr|hO*JS>SjN~9=p76kM?=XOc0%A#W`0+7u{90P)~xU zU~xBzNpP7A&#I*)^u-ROytoE0fyF=RH} zifuSMGod5yDE&rypBeY~qp|R-!474gqioz>iC3SH?2+Cmv!_E9mGok~k>jjcohr&A z*jC4SNc9j)nP@ZJn^w{fJxzBVDK{V8Z{=vWK*&Y16HYK8s$`;`-3tt&$)#y^UHcMj zJ;oaqDigEYtIhk7r0`tL(C52ePa#R!y9}Q&^DG0CZ%u~m8nDA0e@4xEnjG5dJjcqK z1WaqCHsizci$>IJY0(rFx2aHm?GtSFOpQt?S?4B8vS`^(7 z-%0vGf?rlKD>5gvtS*KW`^@Ek9m_H2LSs3&H0ttsd<pc#E{NgKe9Wi!X8jvwDyq64bIqy*aNkz-)8 zQh2l(IWTj{F3IY>G>Zkw#E{ugT_bsu8;f5acZVj9@3T#DV>TH*p2(^>0OXV;#4n{) zRwoyddM`G2uAi))u_F2GAi-tT2Ja6cb2) z>5cwMq4(ImwekHz|?U(P`z~q2U({7>GmcqDHh)U+w|i!ADZ1&hpZg@YHwfCFA=U z`VvS?^0j$ka-1^|qc`wFh3ZMOa#b2u>8)Ihv__jwzPBiT-YLTIrpqpp$Cbhu-XC{V+OtEMV2J@1L2upd4T7Bm<-;CByx z03X5xE^EjX167N|H?Bll-A_Jhg<6#2kU)mY6ft0@aS9=y2r=T5cdS-#ZYEa0$v}A$ zdXSZnNcj~h1&4GUpX@jW9HxsKeLCi}5DFZqzhw+Xo@_IBSt5P5V`M_4%EY!s&RaLt z`q#f52$KuRK8|U|(D&fd!F0UA)wTyhdxXhXM<@-abe62}T%tEawQIRTh9~e(X2UIx z^F@_%kp;S62v1MkZN5+KR2~^<-kB40)#BNF{wiLgZ+`sk@Mf@oOA~AyC_$c6(&Umv z9|y!DW;qsVwj-VEp>fhZ8mAb^H^lebp6b+c6%MbuleLzGAb=r;t`%adCQsr$mfch= z%aYxr`PEVm-lCCzt2`FI5!gfZkz>n%nMs-f8I;E!eRnyjjEwfe5Yvm$VlMK4y)dQS z#ZzCARsSz`nAq#NhfyCk4U#m?HzlMot?Ml_U_`Ee?JzszN^y=)9&UE86maFKY4lo} zZ}o4GSZs zXwWeo_+JPOMN@Ba=;{QeDsG{j#I|)dz(uy1<-UL!7V1fCbW>>>rLt2!*0u2W;Ny9E4R{R%7?pHWV(FPR^s4}uw2Oaa$& zp5g&*u5c?CiY<#wyO)c`vA(~1pyv9d4$eBTYO>S2-;Q)zhMdkos`8!kh>n=L_e|h3 zpQ1C+tE6!SUh_fR{AclKL!bl9H2-wOY@Nv@d!QI*Q$ocSWt(o+^nbO)%z;Zl4(c?n zgz@Xapl+QrYp9VZ!!AH4+6pqLdR+Vi_-6XSmo8((N=KV z!+3q*pT@@h{e+h0A9FIhs>58)sOnyy&0` z*Lb-BGEsktAB@vabq}9E99|Q&+(wH)MR(78zmM7Ns-~0Cjr9^}Up({4=7ud0QD;+M zHY-QbE3sJg(xAtiKXe4A9AmN|Fpex%tn5^Dc3h{Il!a0;%$b4K2JD1wM30A^e%`FS z@KN_T8EWWkK{lgp-EhvPZM6IaCHHy(cE#5r6o^)iDEj|KQ;bT01=|146eDzxP%HA+ zov{-aFw0ZjI3$;o7E#?%YyPTNBP8;g3;A#Z+h6O_79$;B;aj;8B9Z;^K;u2I#lV|G zoD_ObtM_KU0OMk9E$bH5-Q}%RD0=67JOmhH{yp+rpk3Ih z(f-(}|8RR}u@Ro|54Ol|!|YE{7GI>rvfB@wvfVyn2aJN4@Qgbv6&3!s0HOHtH&$TJ z%4vxzFvIZiTq%-B{!t8+wzsX?`{tE|v&8{HNX?WsHrrd7S|)?`)t%zm%2Ie(L4+q~ zZqCd%VtlT@{N+DfF-;Hx*VxXO*X;nV^~RyZw~38b$5}x!za3AHSc$&^rZG0gbi3mi z?S@d<7_CJLr(NJQ*lh2mE#mM|i+hh;yEgHfXbHB&rwUyDBUYx-R~HIiZWYst6M_~V zjI~SWjyUfdqkh@yDw)&f?F#`gUF^coqoS*|56`z(Rd@NJ+79SnoUrF|E( zDMz07!lY0^NTQ@b5iCC}kAG?03A!)Y@-eYEguSQM4v34Y4vQzQ0kH;`TJM4XqQtb% zQ1QI+EmubojMwQTwFQScDc}b>b6cu~ix>)f^l+y^3t(0Cr3!&Yd-}Bi4_Nr z-+ueR7%n21aR|lcKmj~83ac*$cDMbK&4G+p<%FOs1FFc*qbrKATQs)a5t@5+Gt6Op zDo3tNMmEASF3|qkA8~+ST(Go)?@S31v{3(k;rmdFJW)Km3Nk!j5{$8iA2<|*_!M_{ zfr?1)ib)DsBlk-{IZb=~tvo0l?Vts;5XBf*fG8mXlSUy$^oDUfQr~6~rMsho+pWM` zEgCbu)J(uy>oqJp^J?EHt3qN9D=*>N>lVfEgADVhg$r)m{kCQgIl)ir?KZf zyl65Skw)V8qFe71?mYf6CziH8?9@qfz&dsryrb!E#8?=KO&2C^CwQWahnHOJH2C?Y zu%h$byn}L$*wJ+{-d{g>ck1-m@7N}JlIkwyt}5XwLy{sec@%Gos5S$ZC?F8lTY5G8 znnaf^lX!wDD+;Osv2(pBpE5ayuH$`eP*BicB7Pm^ts)~X6m?Ec_5mdCL;+F}3nCmj z6U`SUZt$o=9-7+pvx;^GYW)k34=|+3<@swhJ;p~By_yajL->G&?AZ|%wodURJ)#O? z@LKkdqeRd3Dg#4O4f^{p1>r+)De^|vh3r;JcnJj zR8d*8pWSM3ueYGe;L8`knF8wxp5W@}7O($T0`h;1;bAfNI_XD4{&Ek!IgE}B4W5ud zvTGz9xOr#4XGSjXvz(wepbH#`-da|a3v}80eD?136IYSZZd1+PY3EFFry+Eq)IGku z+-eqG0tx*StW&og)1KNF$g8s5CMU|LZZd1R!r%+hBhL=q$UlAFIDVYFxpYu-ty%u- zB1MfRa{kG#e1$GEnwVa>^nnQ512=JL5dMfh9r-kp{Xau^p6aZEDl%cEV{z9=Xw%GH zwLj>Jp!Hhhc~3Pv!IQLpZ`I=dnk;gXh8v|^s*u!q;amA&jU0;()nS?`N|f3N&6(|6v>5|!$7K!7vxJfb zoW|&;-@aj|Z{~I1a&D?i6ZBL_Ai zs%gRd&{;+46x#Ms zg-7|(NtyM1!HroR3^cET_xTrZ6^M*ax@;F5+;(RoT0A@DH?Zpy9WYLI40Wqxrt3N& z{UWQ+>~QO5F2SFC9SihOjQckEq1fKR!CaqOf=uwcy4?|i>i3fA8JMZ%cLIgpXsZ^D z=D`N=CRZFJh&_~wRI;>{M)C>g_H4N|{2W7V;bR(@eEtuP(`u5wCKq!=5gE_VtvjbU zj~d%YWO=iXNs)CnG#a4}*bzRluJOEb{E>(G@#31hN)OzXf^n9w zM=AJ)I2AhDQC;jHBB)XEI!%V z$6Se>gEDg>22P|ylUs-tZ~vO+2XEa@-dq*zqWCe}2tsq9Tt}?IS>0F4jr9lW2Tvdk z+kuz;_T1eWp+I)`dw{NdwCE2!$2n)ifzy}sXM!2NWw%>E;09&xJRw`D%Gjj@iXAYw zE{HJCPbE0n1<8z!31IgMwuQn=XNn;Zq}J@#$_A#%#jsqOrt~%ETj=3%dVfRQFr%1d zhC(1zADPWQj({R}*rqrvhC%L$F5g9zBmM&XFeV*mIc%NsO`XX_F)1wK@U!)u4j4IK zn7UuvsLGXnm%8G!h$2^O5Har7a=2T3cty`z?)SXB({7^$H~Go-Mx`F{;r8#eQOg`Y z?)d2MOO^FJ!GK@P)S?RupQ7c9{lhL&zOtfz3F@s2d)Ul_o0csL`i&RTa*k8pN^dCyEm-8#loV2kEy$oj*deS6emBP63ukCXwN?1#FHkkOlkorez zzICFNUGpS?INZf>qQ_(RG@t(URPZ!=H%Zg1%XQ*2{z&P~lBC8t<8f!0Z&`+7f#&+M zd9mBKL+p}uixR#Q(p5|bw=j2(Dlry@1FpB7ve-s4t(vduH6lg{_dkr#n~c{I4%Up; z_{d|t(@8|Q6Za!08N)8CBxb)sPNFjV7RHm%zVXOd@Y>RkvKu8WdPl?C!p5Eq1tU+FBfKwa zIIL65dZklDo`4NJoc|ig2a11cXUp~!-^{u2oK5~x_SSr5r&FvV$>M>cm^2TW%C=3j z%lT<^u`EN+JE*qI0bXQD{V_F#uB%FDz*S~nZzu91?+y>vnAfWjBKJb?hTdblL^27g z6%!}{2t8L1WQtyYP2J_;BZdr-<7wQJxO3G&<<|?0Z3&$c8`I5;4R?0PBnXEBDs72`p2)Th0L#Pd`WK zOH=IFkj3U^FXx=-onlZw>&a*qWIUf-qKeB~-!0Bfxm+|!-eP6@i8H-?uIxnoLr!I2 zX(IgV(I?OxUpeTa)LJ>HkF1sD1Ff>Xv22iBGYy z)AqY_b9G#M_qm36)&P#DH2tl^O!HIKbgy4^QKH)=7|AB`%X&t^4^ca6YVGq{@Q|Rg z&mK5S)B-z%#(ERFxXj~)ny@eLDc2^0s?yPM=#yrh9vl%7(MCx#*CeG?`%=3Y5`-38 z>0?{`c=j#Cy{ddqG?Q7FqvI!exL3uRw@l^!-C3VLKr=7RS#b4mSyl{ewaC_Ulr=TW z<_>~#b(D!*LyW8aoEFU-;rkL!q6u@dPUa&lE+476Pnhw}meXL;IL~d1hKOj_^*hNF z7xOlX?bsFfouSG?DK$MCIa`T4#AOEVZDy#-1@HA+r1{OCArwmZFwOit1%vCg?Tx5uReVQ;C9lx zX`v#q=kacgU zYbwmWOy)0wrWfnCGq+(-27z+GZSj{U*I}6WE*79QZr4m?EGimHw@}o(zo%aC4K-4P za_Q4od0Gz1leEwgc_(1FD1HOTVWz3k?&7x;je!B-=@sGA1of#+=}jvyj+Y2%-nQ3y z71GR@sM&``20^cFDr^>kDB`W`TWXH3SMx^i&6W1HDdsFO8lG&jkdVmX<122T za)%dj6lBPu;k~Zciq6oWv5)2}G1yc;v4r7oc!rTT)eVcGWxKx|Ug%zuGBP>FKs*&* z(*}EIIB#&>`GeY#fKh7X6EI~qGkg2oJz?t#TBuG5JBkVXfbq4+R#bjS!LLpkB=v)_ zCAzeKeWzX+z1UM}0_csaV~j_%#{j!y(20K3=d1=`LX(p&F6E3?#M0VEp?iS3gOkE_ zg@GZOlprs}*hnvt)|bKR>nK;Y^23l#H6!g$1)i469GM|47^{hG8BO~v*!@zD-uOMH z@PryWy-!v#e4X~?GS=!@R)ZZE!Y|G+P(zJ@%I>QvP8w3tYu*r5aD+mS|EEHr zQ8-g-y!`#~Yf*ml=gOr%=^GWQ$-Bue5|k=iI_XDPYkb` zMb2f2&;9y$fB!2e7KrRTNOHM1{hWkRf%Ix~Mz+4P)wMSRWzI^> z6xtw+CZe!lbwOAHw(@!dK3$&xY`rF8C_s9hG7}{TkLe2*zLS>Y-;P-~_rp(zlxpO>~>QnhU=;J{zxvrukT8s_Q07b-4_r+C$- zE5Kzs>}b=)d%x&r3tyeAUuKy~Y9@0Tk4l}fWPlKhXOscfw4!d#^~-u^9SFrtjc`5@*$b~b1*Yiu ztpvBs5z76fRz8PNs8Jnn%U_{JgPjj7l0gS?{_1)ADhlhwBh;Mna}hQ|@iWB+4K!tR z6>AuwV=26Nz1b7f6h#EWGZ%WB1Dm(3t|gn-#T4S`v`cPwSc2Y(_XLClinn|%ygwoQ z{V&ddzt!oxT@Q9QJA*I$^^exszPRhp-Bx)lA_iuRLW+!XtsC7Hi-!>5o2|ZK=0)P9 zxY*bzdCEEx2V_Sn=1DjM7a#K6Jm3Ap?`d~P9Ik|Kh&_D27jkgsj*8MDzC&jnpOOqDw>B&>I$Pa02z5Y!X_vT@e4 z(w%zRMBN z9%0Y0#ZyE+@t^iSiJmOX9dljvyy=!p9KEv8*5ouTQHLx#E`n+X7%G-ah~7{5*Vk&s$r(j)XLVb=8@BHf%mPYdqWp!x;L&KLArK z$H;u)#;lME@~)_SghBo`VI2ZBqF=OM1%w{@GgEFMBI^TqQI?ut1Ym}5ERR|`gHUelD`vs28|Q_tb>I!qKMz%ZQ|^LFyj|+%gHi_R${NZ0#b^WvlY4j3#u`&9||;nr$?AU ziALMQp~PfByV3L1I%KNR3LacX{{XM&&G68#69CuNc-klf zCmPythS-lZV_7J+_it8XUc>)ytj2N)N}IRHwe*78zt_@hMbGzWPA<)kAot?4C5lcg zdjz^4{C7y1xtUc~%8Dx3tE=nPf&e**^P$cRm|6azHIBM9o)mx{=rzPh^g>xxy&5vw zhL6Z?qx>O*>MHuR$hg-cdURBgw< zV1VEFcb9~oYGu8szxiTug5)mNat>w5EkjJ&&Z-LAqlSCOD}Nl4 zZBe&JMmdw%D7yuvED*h(S8X5nFYs&+f-@3c{Ai?hN)obem5CfO5{aHGy~nh-p4yRG z6qk2d{(PRu60KwCGpyO#Z#9>RrDojeXmre4=2!>fPp-*rpBUVn>d?gDcwI=n3=6>D zBkT936ZYosWKEBD(F8sj+F75cZKOMzpGEUCLTgPo3|u+#)HL8X71v_Ng-sqKUQKKE zd&@Z7vv-j5UZ^{bzjWFQ+Nxq_niY0$PxmMdX*%>;YqdjAOZ`o1bi|ZDaocTk`@IzI ze_ax-h@p!}_RUQldB1_|pf(S6RPXmvUWxXjvPw3{PdsYpb*Il%<8WWATo34(iS?6# zmpGWIQEtkMtB3`DE7e~$B?T{wPt?;n?ZTf}EQcXDbm`pCpuk1?Oq&~@mCrL)^%St4 zZOZ@DTNdu5OA__?9He93_GCa8nUTFv2H+>L3sc8yQ^u0uxoed$uJ()O5K7jtndzi< zo8B5SPPa=7{3U!}P8wcp|GfK>5$4DJIl@DlJCDUfF#yj=!7Gt9belf2-}cH4`AbjZ z@k4u16%Qkp!f#KrSeUr!saQ348}Zyv+R!iTA!ZxvoL~1-oH+O8Kij)88L2%}=U*Z4 z>SZnmb)D1%S#7{}bI!*|OwZShp5g(hYuCqj`#(S@PVMt1R})}G(NK(fXT;Ro8V4gm z5k0x?Ph?I2scT~$Ft3?KR_}q>U5?f(lvstu?cf?N!xI!S8)k4vOasq(37=2C2!-38 zgTdroHvlsc1GyBQoicaj1i{3!l;Ff*m1MX5R;^e#z&Z_Z?Ob~&r4&j6x*)Wt{lJxS ze3x!AtWv@ZW^x791}UK?(lV-Q|Ds8x+KD7GUUa$|ftUmzCwh=-mGAFN%2WlH=DmW+ zUENo!4^?Log$whqj!=+@juBNeQ?<<9KU}ADOx=Ji7${d)UHGwH?08L{gJkS-H>pwU zNn9ddgL^hl$exS{wEon>E^0{&cyKGZ@*Pah0fo(O8_RGWwN6I>%L=Uj8)Sth<%!Vj z^PE-V7n>@SlsJu{QXwtVhu94-`NTh231;_D`y`-lSwQg@^|O1-W<9zbu%4j#-PXc> zoPtLrJ@zUzzx%~cTqd??F^U}h(Ts}_NeeS-G14>sp=ML~PWC5&D_ZrPd&qm2VykLR z-^TC#?#o;D0|I2u)H3zQp8z95tiJamYQ?)-we_BKXTl@J-ltJdRxrT#whyP9tq4B2 zN^R^t!<=HP#W(*K-O1$VeN!uk!LQe5&L5`&zSE_L)9& zs6K}{TSl&AA^cJm{-ISh2kvN%f?Nl{F_H%3tM%vB7AP6eJjFA(@OUC{O}f$g{t>S$ekP`fB397 zYJMW&8>w5F7@2gE(2g~h+r6IQHFY{7)GKm-~7)g`JmngTIhraq|kUwQW z9OMB#2uQ>xK*>~`+vx_w!aY-fo!IH(9icb}nyq4V986qZ7n2CR#vnR2+6$i0+)AlJ zhahelp+*7(qe*WCsGIn_@CPr1K2S`p_Fyui#uG;3K`5yt*3?2l`iU&dnECWa$j%st z@q)j0OB12KiYhm~jF0)7IFM_&lAp9{jR({z&$8ABN*JnK_Y%qTJ@mz%bH`2iAY_~| zHBWI-h$kmk{nf5+u6ZGXW zopLQHf*$F3%>)q+Ghbx|;66+Qt;Pz_XKwMR8hoc>LT^T9^pc|do}ICtumRpcGy!lT zx=Zz#(506ttO48sz@EU9=lvV@6advxiHTI-|Cc)I{~hcpc5=5!fBG_!D%g%9T3^#= z4%XA1GfulNi2A-(4fyDdl#Uv z`J2s%#5jTL>xC|he`Y>nemiNN(TL^kx@q+3^}13l z&NzcYk9zux=WaDf(pjf6XDu*34a6=$fS`Hg zJx)W0&&?v|-MzqzJoW8O6OfQlu#TbiAkihyk88u;9T~KNR*9S)aQCN1`tjSlW*^Ix z661ax2&ok?@DBW(3-EBynQ-x&K`6FS4Fxne&0E+jbx^3 zc&PHh#+_8JNSIRS(#S{d#5V8B!5gljvsV|b3%n0K>zgKCk>3>x5y+r^G~)i1 z;bG+wujC2Gm8gmhWCrbLNLX9Yc3}9I*Pe9G5=8`CjWvHE$X_R(Q+GDm+We^4WS2`b^=x{J&wNp-9gw-!LpS7N~O;PQol+s48hWpv=iiIx*;8Hm}O;D%gq`_Dr zn|>G^#BC84*2}iM!l3RDeGq|KIqK`NGL(HiS|dEmqIrnbE+)9g zeGff<+J&^iL8cF7(PC{)C0z8AJ`BWg#?}@izX}QVZbmK)cV~Hi>DPdpqiR*GU28SC zEbu?(Zf3S6G5^{A6ae-!j!Ww*@&T$~b56b_V&vfZgN#1y|*_Je2q{ z6A%#^0HCQY*hAa1U@Z~05h=;YM4BEWqaA8eR9Uo7m^hYY*qOt%$_W9Z{j_G*qNQ?_ zXqE-0MSprw05GMr<>5pK1dQIgHVCECI3fd*^FBOXEu!Y*AA%K*NSXMJLwkF{VPj(|9IWB2E}asS3=pW&^z( z;`oJ-EdXMTXG9IC332Zqe?mW$S;=Mfihy z>+^*hjs<3X#xch}o^Sfq?q^TRzry)w&=V(`Mt2n&9kF!W3MG-~%5c6B_*@3j{)j!U z=<1qEL+IX+w^kw5M{cL!Qh>Yq5=8u|X}?fv_|OrTL~={BQRB)(Fg*&s@r#p#;=LDs zTp?&a#9Xn#gB_tswzJ&@ZVwO|TSb$kks;jr5_5Y*YP_juXle_d+$48t9Jg0l10qv4 z5$>8}N*dW`u>f@v(h7I2K|&N{w)LjNblX>WS26 ztH!o%E`hW+b(qgD=tf9elk9GK4-1gf5HUo4ZOTg&;O4BXBeQ&aXW;4mwecA^#Vi#Z zju?e!-sv_Iov<{TP`jMCUq|8|&RBiNRq4Ut?HbaTLXV?ex4fdP0x*tr5z(F0_$|sq zFca#|ExPKm6*QsQ$Z7@ze!G#A6&8lKXpsH61v{ldjNP|bM-A|+S|6~Fu8~&-9jTYz zUOmKAv`g4|3(b!%5G)M)R_2Itn`PKv?$3z9x9nzuU$J3>I9v-|a{e$YE6Eq#*j5xo zKlpyZVr2tP29`3kJw$&bPQ%oVwN`-zB)KWQ8dfG3=-kbz?j5whU#R1L0v~#uUVD`5 zSxkhU$u&mrNloIlD-T7{h|i*Ef~Pt!nfm;n=xsaGE?Hd%b0c-{h(oWEV*ms>e-vZa zPU!M$nC|qov)0upadWJEAgz#Rr+qGMVe}qc#^yE+Ze{GhN5#JX@$Z14}}>^8I|oeUatUy$a_Of1>_{jpb7Baw3lfHG_MB zt>j;drmFY@V72epn?;En5Y^h}jY$W{n+$>bZL;%!=-?*95cIdnfme=a!jG-R(e5SK z%30lAYgODt)fuejJl(;H@txVttg32`IvfqL_jWC%buOb&GZm3_D(zlz2`W?kBA+7y z>9|qJ%*2l^oI^Urlj6#dsxKj(vL3>uT+&fcqy=WdwCZ5)#$FM9)g zRt8|l2o-ey(!sqg^4`1NY`#wVpG2B6@WBc56N=N0$tsh;Qv&G!hY^mL>MtW)!e2(X z$EU+_+AX@cH)7(5ca*ok@G>fL-Cj52^zFODwYNn{E6{AOlT+Uv9zd%bRPvmSPx=y` z%(^@@FY1~z*h6K~+Fk42xR@>socL5hb=a+ZAF|~)TL&{RtL!l`rR$u&Pq0H3US=fb zu6I^oZx<{pbHKyNSNbbL9^KV?`$h`XVb>pHW}c3rf?pC~(^wBWv2 z(R!4;)3HnM@WjH^d`=D_>!GsV?KYZTbbWt+*Yd3a6LnMw+|d{35Nq*G80UQsZ)T1l zyNLJw{c_R4RDEM_#2C~F#b5n|laXVpss|b<=ql6C&D>I>ynShI_&rZL=HONe31)El zTF~Y_(}059@yc$JC^BP>R6c+A?6{6ZlLsinD_RD|oe-VBCfQ!kOOkrgjB4pJm0g$`66-X(RiDV{YRM3~ep zFPXo-dX=wFWtHjZUf0P3-Tk^j+#AF7VsfFw;aA73b*wD{t>g9#wXGc6d%M$;Zp0c_ zs{2D;I6LsEY?I!11?DH)4eRN+qgL;8D^<_0uAI;^6^>0Vnv94{SMQw& zR}SpNbTb1G>PVDSFf~uJcF<42MiYG%Mg4wEa`Lc@gGAC?$-)DNkWLs(pg{eVzMx^` zfi2iyOZ061)Qx0Blbqh|tm!)UA_-I;2+XE3{U-vzZBH_pY^R(H6fSPQ}9FnvD_{~SuJ9YP)m zk}?WcRYTV=PF-kiOy3jLIT8(~&rVof(V7JEw;+#o#rW3HTs_CP-m+5MNXv<1w4eU9 zsIWfTgU~6%U`P@iymnKl`Q;wn3!`h(&Un23l!k0Qz!QuSo?rjOjira0(70#+&SU)N zN0oS-SV!m7Fcb)*xjz#0*E`lvNcs9H3+~-Y*sGR9TxPt&*puL+F%*=v4 zZ+3@FXjO6i34xK~Dt8UrpQh`3P&N&=$26&q%JBzv-&ipLzu4}sE zC1QxPdiPIRL6zc{RrG(Ft~e1+XLrNRD*nA~!-2$MyXQsHzl*LZA>L5Y_1F#UBvD0I z0a@TJE}6tM3Ohy;<{qwnCxx%%lTLZo5S=v@k|^UCT#m3yac(sZWus7YD3H5=9OZTwT0p}<#p#B%O$CD*G%EoOqvCrVfYNdezTzTjR?2IS z3BLkW7L=8m!b&a$>y+5tIE_8Npd;Hm_?#~h z6`T2hao4`hJ7&iGn;VQI+1$X+VZ@x?+@PKh(S23agmLv0<_l(#r;Y!Jp!J3-#WF*R zw|`e$C;uYmMMn8uBEz|JKV!c+4;{zi-KM&CXV?3Z^vgJTN4sSa^Pi{2<76>d!v+qt zglm{1tLQUpwU^?O@I0{r(cZ;?^}$&0?3`*UNT3PhEZFqsnZ{!}*~ckn&3KWXew4sq zeajmX{mK$wqXG5SfX@buIswE_91H9W#Z2aQJ-qt`!VA4Z2JJZugPmWvl zd#dKlFp+!=#V?7VukuVHc`2=>bjFh#@(fmc(*LriN=Q zW*m7w)FDtSs)L;(SCFsRN~mLk-tGjgP`$u|x}`3n8l$o*ntUe7HrrWN_G8Bt!WJon zBL~nDan`F%;w1BO`-3{41jgog%2a|Y03NU3;v;9VlT)}Yz53;KA;66^lvwj$NUQ@d zkcSPEBx?!deLJD@CihBJrpfk=*PpD)5ihbn#8`*^xmV%7*)P@M&NtHi4V%XZxj9P-;F&@S_R-Zh+u2VJs3tJB4lfea_`<>3Djj=hShtGk5A*@ z8Un=l$@1rF8mFfAg+V84;H{t(yk>7!N?|{p(Z%Ykj9@Ungdsqi|2}uLW0Inf?#**`58dl-y!BPz!5*+X|>_j*HDgL^;Mmazypu=JNrmcM7UsIOH#Ux6fx zdbaC8|b8L-D-@a?NgoELlBVKzUn@$_tLdW6wm>=@+ zvOmfrOt`dOy{>%%HfcU}9u>sy^0~kicl27jwS{KeXL0!OV27t69cj#ku0UeU*JU=d z+mE}2yc?*=i_Uy*?!HyWI=-EVi>L>;G^rEcDM!Y%9~Sv$adsh%Zpf=r#OJmF}8l?GEtk(wB$EsgX@wu0BqMWa8!R`7TNc-sif698)7ie(UdUA_YTTy>ZZ-l3tP z9a!Zg>OrLWN0G7^DHnHf%csEK0<*7CS1Bbq@rF;g0B06}eCRWgc3Uv;0toj_!Sg>f z{@`noa+tC|av1Qd{|mkrVA9XTAA(sLCgcu7r<}q z;y}K%t&2rSqY83gxbfjX`$A$u9OfMnmngq2ZSX&!y+?Z{fWhz_mN>)S3Z7;L+U68F|K`)LI@Uwa>H84y-=|Z>ch4QY z?_RPB`kRpZ=QUnKU|QrIqA(Vs-|_-PE;;miuss2OsNrhZDi#GK`!P`hS>I=c9IuJfzP|oZOZd|49PgH^Qs9VdB{geWuke zLQyNM6Kwh>{_Od1Q!6!;_Yv!9m^-Iu&KH2LLb^M{>2l{JHEozd6SZF)+B(C>l}c&;}WbqqRoIFVeLB~_{(GS zF_6RT{wU;ZSs!ug{r5=>YJ;(U>6_V8Ej`AKBg(T5)&(pzU21G8CSo>}XpbTn5-yPrht~Cik!-79h-Z0l${IjBu1`qKlf0(JU>F-0_F( z-vgRPCkuC-xQKGEzIfl@bhIG6IIw`+GJQq0+#vc#Gax~t)Z8Ku3h4gKLVj9P zHqL}Ftn9>vhW%$NGr0vL#=DQ6?ohI%a=>!F8vKY(X)KD?@i`KLVm}bVAvD8o_tU=I z$XU2rAn7;`B7Pwu4*OgxY|a?iWv`B1p=O@n(|tKyP44JTswxuXUnWg#T&9W#i+%!;QJFPJ1<52XI}WZ)@poeHSH=yCgd!31joW4Bj`w1sBhJvW>BQ}%p_1sa(VrAC zJUDgL$r5s+lueS}NLxwWh5Nqt;Yv2HI9H3#d%<2;*%0dzV0}HIzdX6BOQY@eb)C1CC=E=LoX!BH*jpN+XQ9UPB;#ox>+(S3t*jY6Dpx<**aGu<`-+yuU?$NUx5NfHFx5Q z>~#Q==W=>w=}Ydhk8$Y!hxirchZ|@%3`Qwmx>fOh2EU0UpfIjb2jaqsN?2_*l<#4b zyy)B#r(je-7tx zU}`x#oWa>UjG8`tHUl{xV4VkvAFLE0g2Ot>f02lR$Uq8SK=coh!2ljZN?*`<0nF#j zzuJxTukx{O=nyOeuMB=8pr#9-f+HJgeertS2y`w;>8c^D7$_{#jS^S`IwCTMK~$;% zit~UYUj^inn}9Oy(nW9(os94mf@?w+AY=V?<~Du?ELD_NjX~uLedd>aaISV7x@=s5 z&Pzd~?f><_-9SFdAR|F%kf>h!=d?9GJ1(Vx(e)8F@}vf5FzT~Ecxgal1*w{KN1#r6 z^7`-N8Hsy`SoeRcRt^85S|$EXnnxX~zg4TqGa02?MZF~zaijo78YzH5s@w9B>Nap3 zr;7QNlV`5?yodHq0AD}T41TmX!bg;mA8VI^8P{*HB`Sr{l%5&ukBeXaR4+@m4GsY^V8!&Jd;74w+Lg$Wdul~EHbsGxe(3uNS zvfx;NtnVcgC88dgn`+T-dmYM95|}uzyulOOP5C0st-DP_a<$Rxfx58b6}L^y&C;oK zdDG!Z0ev(dyCKo{f`cRhWd)gO2iY>*CnFB&%+E(xt3&t&C{~QNA;@~mA{Ef%9Fh1C0K=}2H28sq%ACZfEfHtVo#M<@w2}Q@iRm(Dowh9wed{+v`(`WvK}73aF9CXk%_IiNm0f7DwoWov~=B1xSJTsb?8Mwersm7lrVJZOD;1{p(V z6k3rEm>ag^b01B_=t&jg)3%%MG`!AeyO9j2Nw-PIcTavF&*bb0%Atsug|iqgg=9!~ zc#l)8+#YHv;Sl2NG`Oda^1p11bg1a0c|?9h`;I>B6O=aA2Di3}-v&SZDM-!)2<}pg zZ>xOxSlaf%q9Gj#Sc?34f9;234puebD}nBlR{Wc3U{p1@_dOKw+qKxMaXT27{XjD0 zcl*id{RdH{dBS?f@r7yp19zZV)lXu}xDST>2AA4MTtsOSQWP5CXAYP+e)(`=a=VQa zCOf0`hWY}%kd5KrDcqQ?8uiE&l4Zo3Guc~cNV{z9FYw|uE$#YY4_nOy(uP-wp`;Cz zW@)s45W?16)jrw>@-Tmz^nm1EW2hfNo0S6MET|an=a>Z6CJ?E00^t;BL(%nIB0n6c z+4N4{{Sl%ISASp>uH<+aGr0j8^ma$hGR@#^f!r>rKm~`b4PAoqt;P6FaHWZ)YOq;M zaIS8z-eFlYDjMhJv>RR(M?-#Wu3EL77PcStK4u7PiPw-+kWZF6kcjJf@;`8;?(!r_M0?$7mnRo zLT^kxnbLJ6|6$U0!9*hyP&t>Vj>Oi|s)(7;B%jI9X8S|}RFe3a2u9b6<{L7Bo1^p* z!wH_2N%{_#bX%Pl`~oSol88y247HY^e|+o3EdG}sLpZP6RdS?fm2fub`M`=cDFE2+ z-eM7X5f1Q80LST@@@i}CQQkSI4{r?;z*d)MKWFYg@lAKSEUD7O;~xmcRd7G<@}wG^ zeR|#_AqGlxDfknMggoCW^3HH$qz0zrt#!$Jp~^!r;!A;8?4zyjH^my02t-Jihqqbg z5en`@@Y@2hJ7C*j`u%$zCy3S-9R-AM^&W2UG)z#3hl!Ol+^V~^#ut8?*8iBv^AqRE zL;d3tcB38pXS&1Qso!KlTZu;2ixqWBN3Qk{8LXX+j{otyaN#+vR2zt|fU zGc@Oc)WATZ)u3D8P#!NQ0bl=k+Q7r9|MIkTv}&9RXM!B)Kw%ZAAQ=OTRq{r?)eO}AJm6VW`LTFsqS~^7JQNfq1y+`kjiD296A7z78HxfDFgZ6Li8A> zhkpst!_S21(U8}i=ifqf2di&Re?0c{PiJv1Q=`pv3!yVSl`OPA+JHsi9EhDN+74piYC(K z2I9LTGtj{dg>I2T^sxU3(Y1i5^=~11)^D3@YZ&+u5TdKTyr;$voziYVNeZ3PXCI<} z&}W)4Q0p)65dZ~@_Xw3B7y^g-f3X$1O^=T7P5qxa+3&KKedqqq!)zZHy_xmzn+Ps$ zT6EGa_Np4U)SL)8@u3-ex?YQ$(i}K>AG;YO-ej0Pwf9L7z_BoQTDr{^(8o(Q8|`QN z*e+zI`p5SQl&Gz|d9{T%u~ZJDTJYxUFzfp-2f!`QC3V{KFg*9!Kjbgq^LwA04->k` zSQd44j2|nEo4V-2_0s#S9cec1JO$)H0#i`&^Gi+6t*cwSBrNr7$l+Gu`7NW0Eoz+owo4_&x#VNjq(OWkj-SBdh#tiu|-?KQiG z5_`LN4Akz;tjm=o3~RV15-iO{dyJvSbOH~|z^6$s1kwXzKf!S7Jn`w;sLpD~+Jf@6 zMm5Lr2d_9K91#QVEf1;VD-@|mjovcseg5L27OoM$tpmFljQ06^;;0dW_Bi&1qU*!Y z4*Ei4!hNdbogC615MpUKy=;E}10S zl^;V-ou~PL@AVl%HA{CPA2=?_fv@!z#b=6I+PI+Wv9y;eT1(B5GPrX}S@UZ@043;G zudrAn@k&rvu93~D=w%L63uylar4}O=0hn|`kVbQuWS=z|M-u6ma*>2uL7;)5p-_u4 zYITLl|9p1<9PP(mZAcZ&0V95D7x~=l-{FS2#Y}C-I%aCOkGqsHEY;d%{DE6GC{$wz zpz&A$!!WSZBVjxrP4L=7B#T6!5=*Ke8`KH%FZ;Z^Nv{q?IOhUXeK|rDTtwiMl zh)J9&U|8U4s^QQpAr&xc@}2AG>%bjT>?mzHo-z-$tobL3hiHL2Cgp)EaK$uFBMt3{ zPL6t`3TWn!QovxHDPU6gI>Vx1gIG#i*CqsGXio7&r$PAVH=mI;?S$Jz!eKfZYEQG) z_pa(WY^7q0>EW}7Q6uZq!eVUww9#%~XIC1*odg;Oc;3qymvepVHclexzhEBp3W1-$ zUsp%gS?TSox}5PXo#-lbPEXfbQK!7sBHOD&?#}X+5$YN;d|kWx zXO$Qd?eY&jZn$4y>d?9KdMcm&9_C|kS2&=>Aiq=F+1|Cztqwk^)4u2SyG#Y-=siY+ zL_eC*!AS5;szf(+hm#aSs^H%80B+bU}NbJ*wD4sm$uf*ggSA-sLk0nE>#wG&I z=NWk;Ui~h3I+13BT(=8IW7JoIW}P2K4d9v@hHb`HW;b`-@iH6GJ6+g{+~a1OH-@(! zn>bTyxel$Dh})UOTvuYuB`4p~e8{vFqXcrgJF+D&L+-lVylJELxm3R903;PkA#<#z zUfmLb%w+RgOVj$vQJve_+`#-Lo6GS!c1IAkuRaa+t~p3Zv`QPN>Nj`Je9igC%-{pr z1!Y}Efu*8#l=poG^1dSn`ieygOK-bmzqgLb07cA${}PHV%0KU0!fyBfCKHR@$?0fp zXzR`1chBnmRQ7lk2u7H!>#97fBhWQjU&}8)-cZ}o)1QE=&2pzK432Z_==|7tz`vFx zJrM%(4@g6d{)t7gE$!cim^{6{$)sbfLQ?%e;grTt=sSG>1T-p#j-NXNG&0N(SY@8< zcn~Adr_is%*AsS_a#zYeV1UHzjnzX_vDY@zXY`#7uf9prMp(cdypY9f8{6%#@18!{ zRk65rJ|!r_Aj!oKNUzHvo$i&OB%Q_|m+~aHZe#r~|c9 z#+%&o@7k5GvJf7!HApDCS!b7s!x>7~qUq!X73wa=G_UZGBFPQ_G-4oY zR2XM9Dq_DQ=yw-jeF4ZrpC(ohKp8#_?L zFgM}872oWS-opq&bK-hcJNM#q)>Se$%*^ZDd`eipm?KPR&Vgt<6^5}1>Vp@=nc&9! z_eZF8u`Xg}7Mk+&Q_Q{5e_gTv4>lvfG@=vxQFUvF{KOHDERoZ!z3i7z8806sjposk zNc6q~p{}`sBVMbB#;Vya3qSldTvI%#vn9V3-9sNWbjbzAn`Y9UL-A2LkeD&GGk2_n zEVVd{*MBc-Z&SnJ@dig`TGOjM9tD1t+vipix~)<}HW}dtZmYixLO7Kpg|-8?O{F#H z<>AcMV?3vReR9aAQXStrwbdeG!@~Gw>`XY)z7&DNh$lt!P@c~n^a7nb*F;;3Yg8%`8Nvg~eU`mc4QkNv|3O%W$ zU|QRn=Gl{UFeS094#{G2kOOEM#)#IkU0`Y%;ip#6rsll*LNwrAi2MzwF_&C9c^ zn5F0K>mHHXxJ3rf*xVgeS;!79P(r=vZ^of_$J_2yN;G+53IL;T3w^+GzQ(13?_2AW z0=7TLs2uBhX*!Exdor5kKG) zBmOBDmN)_Tzko9{RkFn%q&n~4ZWM1 zM<0G(X);^X&||0t-+t)UD+@YdcyMLjBR!IDLjl!K+CXZ3o#{(bU)~nsvjx|(`8teO zt@6E6`GU}$ar-t6nCN63_rCM;jBM-aw)-^mB6d=EMdjO@j?{g~=nK{@5^L63S^F?c zjRTm}62fC?xroT`NucGCgWTw3*m<7`oQc_lr>wE3PudM$jX>m@erv)f>(a20{SGbs zbM0RWDctVWl1`2UVfB3Yez{(cbQpEt(s_4XR1NH7z;6YNW%AZ5o6ZhK+|D+-kK-=yMM2}O5s1XdRM5Xzqj;A;PmwQ)hwdxG_3`)$=PRaYEFZ?))~G(7 z)+FPlpqCk`Dce359?GqocR>`zhZo>k#~x9)^|paWvcH>)Yv&hWVFwt9gDuMo!DdNX zSPe)tv;Nq_hFI8JtM~7d(Zjk=wv6K~;pb55y}YZIudw~YD2@WOABSe$EgTa$2J$IJ zpz#Iq2X!&WmLA2DwaWqD;BQ7)>?$6gB8NBl`>3cWB~R-1!)+kegSIJeEWLawwZ6e+ zM;=(O&7m$(om$@dCWZ=3C-g(ad-YQDYOnf#S-w&P?D5$^rvgk9E9L(15zv zHVuvBrI4=mbusGMQ57P;C9j*Ekqcd*D2>*Tf=3j@eqUi?@@Tjj z-8*j%4#8`DgF&?Dq`jI=T-3aSIcOdwax~(7dOGcvw{k{g#S1Xwes_y?-2G zqBB!^&idBKp+RW|%uLiR#3~I9beef^#34o9fg^_ML}f+y0ys-?qKb>$qtU?7hUl0U zgC26zEp_7{r!r_7Fls}3G|2vop=xk%mliz_Smfl<-iMiS5`pOqsNX!oP+jm15k-D$ zM23#cOQ3;PaWZD6TLxScLltywV$n2E&bc8$^gO_sIgobrUGQC{L4#&W7^4PGAk z-jD=8U8di!ScCk5Zwo!z!1r$Gji7#C+n+T0qxj+lu{ z>^1Z}LTb6NJE>?pr(ASsh{-cMn(oowQ5y1m2KL_n(32s1FGNqS|4ZCPeFM!VTrpnC zbBkdG^BhJGLQbc!Vyd*1j|NS-CZeLzhW)0BJ7%WDkw~rQwIbdt9Ow(?g$LyZPGomk z+UU>>@QB|W-n_hnBmVOSS_C^skUREkC52)cwCa)kpjlQj{bOx_XO@0e_NDbG=j`_I zcS|J-?W6A}BEQE9%4T{A1J?3mzl74pUMkF_E{S`{v}Lp^mDXDuD(tI@~&@-C%U$R;kCU#kURJK5?X%GAB)tykL*>cmEW>IkTvMo;{J z-%785S+yd(y+KBmZZw3_GeTTphCXqpM*6wKXWxj<<3lVB#T?Yxe1m0bo4PqTljshC5c zwFfCXp;lZu!ST>gwvO?K|A)1=jEZu9-@a)?L8K9+OB5LzX%wUpL=Z$uKtvRf?vn2A z77zsKZfWU~7Erp8j$z>bUW4xc{{8Ofe%895^}N|@_BC_G_`*3o&g1wT>iLJsEED&` zLn9em@a!ga8eCP&`R&OD9y<@_RuN=}L?TdXlM534K6Amf4Ic}YVX}Uj#8vgF34X-F zS=MOwq03Fi^$MUT-%%4A+0bQyS6{Rb?52mfe|c$K=WOE#%- zjWP=6c(5;BAbIWhhcJX;L#4=apo53>-Wje^5sgU_>Ak@ddO@x79JgidfU~gOYX3IH zt9_GRNP>!zUJ$YSna*ZuZesCo%X3trLi+0-6T(?g8trW`|6(*IO~y+^Aba1@yNm%{Oya@f4D56 zege!JhogX`EXtUg8IIE#jM$^o`B6?DYwjvD&iA4Na4{U|eGT7+7(6#3a=HM8Z7B)( z)90byI}gtWJ{~r3Ff>}SRW7$_XV?a%PrT+Cw28z$HNyvGzO0oR&m3V#k0R?fVo68Z z5v`;Z{UHUui+26tSib~NrXV28o3N;?q7t}iUBw4{0GEWp-_Y%TZJf!T1 zJc0_<;%-iiDpJq;)ZJ=}DuD9IrrWk+cbU`A@{(8=J~CrYxUE)Iud|7TP-fTw$Hw)w zBcsK7h<;~}0h^6+yPl;2wkc9%=AbzP`;LEH(sMvL1_MPO==60U7~dXCVIXRUr~Yse zxvw;(uvZLHF2PUg2-r5lRWrJb_O@FoKc!VAtvLHnxG_U&4scSk@vW_vfwDKmX}VcT zd#`y{zW(PGggtsIM8aFTgSE$#0dmcVWfhualOe15rGiq?#$WjiI48z>>iaW)2M5+$ ziOjt+^>w^v)DTa3OR#%%m-2mm5uVG{Ymru-)HnGZg~?B!uQFyvhamqT(tlNP{wU1d zR|!-~nw1eNPhAlbfWLS%4cENurFU_z*Z4WyQkJ#Yf=)rki{zDV0YO9>w_FM{5-Rrr|xI_ntAqOH=1d8NX^7G0Q=<`O@A^*B@R0o1@@ zIplaNQeC#=C@w4inWSjU1lhXN!?GJuAKIcn|&qI{;9Ht@8lAB z60}Jk@yX@k?z5?F6=D!)SzVliUGXuhml$WO1f??qkM3?TZqWMBOEzlfO~qbH$e06S52HIWr=t@%8*o>Ul3=R33pLUO-%_a`3n1W z?oFZ3#Bq1SPiWg>@7EvUx2rSrQjDT6cARBYouqt;1XShU!qmwO257~Nv4vd&5LNlo6GB+%qNLFG`TV@0NEA#gOhOI76|(1A z9nXe4rLz?{b#P{}lM7{@y`}VoauA6wsQ(^XsyB?;f|aAtm9Y2NA?Wh4Hh|8w^no(+XKZ)pb_+p42h@MUmrKalj%O{TYH zI_lwi@%bDD@ReV)ZQ6vNGPE1UC7fq!qZ2r|MhmCHwFi(Ak2A7`qw?K5nj)VE&P<1R z$0wSmWRr~wTjGZRnTK`=hNa1)jD5BEA8Z@TM7qt4*V@)^0mM4I>sbm-Z$8Cl-w6M- zxiW}8*RnYQVxIS5fsa_e8{RqyKjQ>H%x)8;2*m#oB`mpTqixOFj<)hP4R|>N#7-~E z-0-bgi?E+u4dZ^Ia=oY9gdU`Tt4646h{p}=)uAR1`t2bRp!4`6G&b5kEIEn4lZ2Xp zNxhFY(@0!ozZ^@(>g#&KX?~7HG(e~Nzz(U%oCX|72Jlz5D_n4hu~t+zXi%QBLV#r^ zsb&VMWn>ZXZhsq2#VNLaBS8&u2dDvdZ!k7{3*9^@n-kpJbJPRdzO6Wk1soYS|G?h% zPm!B{FjVALyj`_$}3nZ~V-V4P5Pj`Aa)$%mJA07T!%HxpcJsyU8uS0|pR( zV#d{2k?(t7!Kq~;Q?dfTQ9)h6e5DET<9f5`CkQ6+K-a{vaQD^jt-nnb6T0E@Y(r=Z z+>(BkJsc~w|!kYT>d0nUI9KN z2=escSAcRiHf-x5g|rJ|nB zFpjlK){(Ef$C1EEcg6k^^F04e%!79ziFq|=tc0^;l9!T?GnQfU;|(!BHFe#aPv|Oe zl%04amxwX1F<-Pg;L&Ou^;xl6unMu~sj8ov)8=>BIb2mQkaB+bh}oKDg#xQhGXp5{)+@jdo-oDUn?q#5ms7443MGlI&@-M*TV{y6Q$l79Q9 z5S}lFr`yLt@nsjO7j%qi7rNY_&<$DyLVler^TJu#+>a+Y>sS>PI{&V7!zW-onIB<5 z8f}qgpU`$G;K-?UIPJli>VMMbjHL&yik8Zbt7m(MMnq4v#Aa$yT{HR(v<4bQZTUg|dlB7NL z{lVIqym?YDvG`P!kx!;!&~R09F5EVw7bA%=?8U{1!JOju%X*ZvI1tA?V&$iHAem_m>g@$x^yGXM&T%+*(QyZrPJU<3p$O=BdVemc%rA*9& z^WkABtK0c~Xs1T)1BqTZKKfRiCDxH=VL)2~Tf$BIk}c}hxNsD)Hn8-&9$#|b267r< zPNo83YoNeE>sz0}N8H9ZVqQp}ks1-huZ3fP z;sYzj(!KPJ^Bewxq2PB8p#GR#WvJ~eX{;^@%e4?UM|tCJIbQXj81tb-+Zv;$MKtcD zBNCaDo46ouAqt!SyqI+|Ks4{IXRP6eC1JL72pZhpc90V)4b{ytrymo6sq%h|tXOdC z^0?KbatpEIwy&@4DtwKGt=d)qS9ul5RaRhat&^T}hr}qfJxNxr{NB)iM#^5Qsc5_H zaGd$e?zS6KENxDV*X>P1Z$jn2T1naZGYl4AkxEoZ>BEM*$uGCdp*ix#RzhFe0KQ$l z^p@WxQ~BMSVXkg6Bu59?-exI4E2qo6J^>k%5K1!*)cY{8URh^@h{%f}3(q;cx`;|? z`cFpLmEOn*HE<4-Fdf{p2?MGUBt<;nP9I>O+r;YbwIM%ULPR3n&^*WcsA18btKYvbI zy?Y;y(_g9>f0=H*3_};Ch;tB6^*30C7|4L48(TIoM;1hDaj3?hvFZ1vR)h8$Xlgvj zw7eU_sXE>ER9i(x`TB?I2tJy+dHIzYrC(qt_@E&JmpSyrw~T#>2o+G4O~^1w9WqZk zX8Y7Vl4aBsKc%LV%Uys#w0_vlYl|kQ_ugEzV*6s3m$0AW^%~V&;N7A>HB48o2RJm`u2@= zc6!j+#$cg0K_i-4cFD_JdE=x1=;E;a&n}MF$S#h{Q8DY?>Ti{#e^qg)LscAxwT%mY!+m-``cwg#|DENUZ=lYgY$@vxpkEqrcnR$YhdSf37W8TMq}NF88HN! z5zP}<0)OWPlEr$DVfn63Cdz*tDiQ2zMc(+p6;aRXVx zp>XcMM^S{;u9Xt`Mu?mJZdvk8Z0^u)eLQtDxqH;#_DMl$Tj>#LkE|$cA^+4y;?3?f zjJm+B@rQ1@X<8vydREEA5m8f80pDk5`U8tHxNS)4(}iT4S1FvevTKg*?>^dk-km-< z4wgbWbxR;{KR5r=g$AI?h{q2}dZokDHo^MO>w{=|ni2}KFsF^K#!1MP->$qK z;`CguBXf{1ug0P9IJbZMC5HlX56(uVNh5r6BL;7{g6{;I=c2FPq|+5`?~7aU?H@Dx zmX1=~Og|UZSG}k+4BrbOSWViqqt94euCrM)lJM416%L&`p5P~YtY0B|+GBEAz!BH; z^m{k_J8b-0Ut6W~7v)jD0hyA>-lE^O_or4AMdw9^>X*h3BfLlJFyRnM-f3IvQs})x13%CC|LYt9+WlB zaq(kPa8SRBYRb*VsNHF4TW|e-UU*Pe0sc+CO?tBcZL$z@~ z-qqq&#=9yF!Jo?zjh@!lpxw=-%)0#N_aeWP>aXxlDYHC2gg?S&t}-djbj$2GGsNY| zU2BUf(z0o@(F2-}z?c3`n+)~k`rId~&AIZsG25V3|HR z8z?D{`}`06Ss^60A&Et64hL!c%1M}cgx*J%4rGtXzLp!HR)bylN*wX^BC!||0;t*d zWlqdfxkvo|v-ZUSEaUhj-^CdOPu5$_zcyMGw7Sa3-Eu2=xg5BQtOd3ewU*guz6Ms6 z+>rE`K$F1RFryH#0{;VmHU#Cq0mkzFEi(>ia(_%ve^CP>oDi^atwSGXlAPxBssseFEaG`S_*^L-(c9= zvd2bm$AGi^XHvq=NZj2*P4&KDg(WuVgfp+o>o|zOD3Mt}&B+MlR|N=Y{X!uX46us? zG#j8a?rJ*-b53}kAnoKv1ut*JGPEItH~*T)@GS(mw;tsoSDh%ow!#fvmjc#An&mGW z+}K}~S_0uvs&cIP(t7@pTHgg+I%$1xbc5!sd&N2Ws69A!7Wl_>?(gyFxT24pTUoBu zFN=KCm_PHWFGN|kXlwo{^b?{p3gZcXC?#Y3wmQeowSQLivKzGf{{&}Qg)+| za>Vba8cStp{Bu6j*D>@wof(Q?c@uUWN7#V}B6QN@M_XPva?fLigP*uXbS zzzlgTua+Tm+|+J{T{z4Bvp_afdD5p+i?v-7kWTq4WkA0YeIyN^#gMeK&4SYUJgJ#V z!mf6d7D#;PxnLgjo3%_WF8s8&oK?U`rB9?ML$C3T*kJo#fw4P0!Gdl}*Y#GOW#+P9 z)8x!;=i`2bZ0}72ilWSOyGA3C4o*p+D27Q14rzwgTq=sY5-N@a!XOC-VA05%y%b}- z>LJm&1EtIUEhjcyBjhS?*jw&!_=8GRqLr-bU30Prh1Le`cZ`H6fgjyVF9-27@a(>; zYZ6rdJIX;keNVckw9)_P9LI1&q?|`J;k{=CE}^{t2RTuJg??f%+<&#z`+o!FxE+?h zkSPo9I0fD=BtW`wa`%m9mvuS_MwLDc868^GrEDQp2eSh;dB0fwZzbr zNlt-|xy1&Q|4Dx@%`&i7a0s-Vf_-YMw1-xA70h0A#a}pjd7f)%TLMVcGjf6H3*o`3b4R+1)CPsE}P8<@fV^;Ja| z?IA|EY|!MTnix0qjq+ZwAc5Iu(#(obk5Y+;#6lHmx~|2I@kuLli?H)yryMWpZJi&wKdp zX;@IV86m^3@DQsz!VM^{!ToK;5TLQuH3Q&jig8=-q`?xVC<4J&cK%HeX#YsF`H2d- z#(;LnbeM>|isp*c>4$25U@a?r=C!>eSJ$7PI0Yb%bRiYPVqxf*+?m%y%+W^hSMoGR z0M{|1^wl2pMf@7k9r%z^=4%g9@VsZ9F>h&IFy(L|Mor!m3l}k+&n<;thscV)ShPyP zslRQ*2D9$#7|-Luxkqvv_)bgF2VWo9XPLQTU0LODovwhbZu8aVU?0ZjZRPGyEqqKX7pc zCx;>zW9-+26T(mu?X+AeMWUT+-$)XzCh@ywUZD(EHi)81q$ZwkSP^P%9o`}wu-!5^ zxS7W+B@ficEruu|mwuCGK)``Q`s?onB;(|XyGdomJDU1G3=mm$2VfEojB-}_8MRfW z=KOC(969cQ$8EdPQOKAk_v%()%n>qUZ~`(0`F}G8B1xNM?EFH-+=oDT#E*10;aOaK z8q=ucP+#(+KEnNK^0eNj@RM%`>i8=glZxVSMm2g$TRA@$R^zd{qw~B`TPP5Ck0$Ed z(y#R9XTW)8YQgEqe1F;H^7C8S=t4-)U>V|OPM<-G;yZv7s#k z(gUy~wX(T$Ca~hH%N77;q#6hOr?_)c`&An8ZI!?-_Wp5i5R?aeBDyKh1kFXMzenlP z-NF}pXFM~90iHT_Ie%3~Kr`CbZ zZ(pXN;mOVYKS6-d%%bpiiEU_JZhnQ9$he{XDrKS^=VGgU$ zJ?zX}{zdek(?sGs3F}Lr0s}u-^`3^^jdkpc++LLRNV9U=M8kea8h)S6d(`pRhA#BR zCw<+-qb)f6&OZVE6=p))^9@*ASRI`tiEbi331qAPjrLXd23m&o-^uCC@ZL*o?-GZ&Jg^| zB^5^nH<~BNyv-Bp*2VsC7WSQu`jZnsa%{VT4_x~jz7+bjH!Z1w(~KAj^yhqS1~LDF zM`5QTk*`YDK#)-fA9`>Sn$3SAZ3 zWJj4Jyyiv_(Mr19;DW}rbg=-NcVL4X8`xH1{E!0iA9gdDgCdF@u8Cj&1``&l%CF5B z1}}{L;T1Nl&3Bon+xB%YR5AbO`gU1Xmagvid)>I>+hK2SLZ&m3@a$b@t$bRu?iv>f zcF@0ptm$ZpX9AcN%>Z8TUq>JC+N|L<$O^`ey?xScA1nvkcqU9p7 zf~{T{#6dy^gvw!W#bnWP|Lk1Nk}-%2v$+(#$FA}egKCchbv(ch6q8503Ow~7%nv?# z^#J(_{hcP1_(!JuFBAXfsy|Dql|bzWFD|(3@3Ysk;!S(OASV|e4B~T_F9kb5-hKbX zJ3KCR);SV9DzcyhV|mK8r0eE`96 zI{yXSft>Fk*LTPZ(QS-%AvTXM)nB*`q6J(I=vCx6q1H)H>o4>9AU&^fcp0z`|V8}55dh4OnICu_ZXmDJt4qP?${~EUg zF$wNB+DC&dA_OF;Iavq<4?X7r^83s9dYhOlLSOM30SBgb9`D(n*9moH7uLb}jgYDn*iD!@HDl#V!!drU; z7T}-PT@z9}T@O$NZN4R|JQYZ`Ai3MUsNpdC|3j~aoUN+lX1ySr6Hotq##F8sJaDUr zfKWxhka#d-pe87g5LBv8)tFwH!(V&kAcnscm}lAGdi__owX8sJBSV{}{?ln~(VST6 zHB)RE_Q>8|)p^&wgW;Q%{*M;|DlQsgfAf8M-1Wq?@Vvxa;p*?KPgbm}_B*~$b%&LY zw8zzqYs>Pn*%R%HZ^E_pgy;lUncMVQ9fsIVDi5s1MSbp)Z{X}93pJ=V#YS)PccKUG z+&X!0de;6djOF(^Xu+s9`MlwbN|2&Ci5(Cxc|Db6z+Z;Xzkhq6k+h8JXwm`11{c2p zuIjrYzJz`>77S~xkL*Ue?fgqWFvC1Jj6L+#m{~w~hWpRncl7}pPUpce=w$M- zH+g{U@Os=KmAzn3#{hMB_3H(F$zbQJPLs7Dn))N-XtH(t=LP32cwFWNA0oz=_Q(9+ zrz6<~Bh5-~E6!|S|1o*K;VhG*IA+290Uw+S%<6jAKBOlkQHK2Z&q57);f=~ zJEZ4q_*zQ8nYI*#WrVr{;~BvHd^nE0Bc$}L_h~mM)L?19)};JKOu^TRz0Vg6Cu0SP z_=|fjX5)&u&yV5(>5uLG20K$fLD*`$;L~x@7YPN=K70QwH8`SI$N>Z~g#5Mr^)pta z=}hAer55;sU0GUFt+G;Hbz(T`k!gY!dz^u+SQZTM;;Fj$)=DT4_-EwEd7*=Aq63nB zP!E{sacooOZKqHfoDNFbAH2zP_PP^}p|?pv2#|aMy?f3?{r9c#h`)szb%D2PiNLfn zea`Y)cl%|^Ga@^j$b&^>+AzI&mf?A{mrRe<9uHDLB56AjjQ$1aPY#PyDvsnE|>GDpaMB9;ewKAV`?4D+YCd)lnQJ z$(ZhfM24d#C$XQa?YD{9BFF9Zx5ds=M{$t}A?vH`X(W~YpGAJHr`11Ywqe*5WO@r0 zdHk*IubdYfO(JXjQ_JGrx!zyZk!6h95Us49Gou|iROL*{*?7BVr;T}uO3pgkY!%u4 zI>~$+;jDOSnUhmyhS;5MXzZ?NGQ-YArFs0b#4YcDo_W2z!oaxE%uU+6jHgQ+*8+e7 zJkLMeXyh%a^$&?^J>OGN*Pdf?Pk&pStx-?U!HG5b`760aQ<$*g!5kGor!^DaO@GRh zPj8?8PiSzBC!s$7Ek@L95W%x{B4dI|G@#9(YR?7Z)jl{~0JI4FBLbCOS!e-=fXmEh z9NG+~QD_7XoGH7ibytIQh5k(#54sVr$B`S(>h|={YBC!j#z5mm0_7GGfh=|fC!?}H z_K(sNzmqIbFn;7K7BG?f_ZV=JWl1sBo=U^f7W`u7F#COXP9ylYMmwcg3`>?E?DBtU zKZm+`eKP#)OY^1-l1mzSPP$j_XhW3buZOQQ%AI6W5KNV;~zKSKJKVqkYtT!!;9g_9{6Wrc6-$Jx2vnOJ(H02I>MmEcp^Y|+8C`BzV)cOe6ulW; z@No9ts*=LQYb}g}Y(t63y-ruDsQ^g*sVSxY3HmYa1|{;K{$CboxWaU1UL7Tv*I?fz zK)G6~SaS5BNj()vKM}$^R5wZD3B5D-QWx#%sd6gHPcQyy&`>;f4!>;B&{4Qc|Nk{C zI6E+(C3xu|3qTfD@E_W<1}R$WVD6)z)IdzynH}>j5tWf{Pd@=ABK{#V z+6NHHnG(k~(+wDn#^-sZ*vvGUP>XEl(;fXN_C}Pql+D_@3b<<_m+vPkeJCeHc6jj3 zd4zGxfm4uprCjsTzqKB20L1)dQQ74Jb~y7+$b#CK41D|Z_-xPZuS9#onD^!5=z37m z$7=8!-e$}Xaobq5bWC(<$@_%wg{Vf5EtHCC=V-K#9qnKTndMkP4QGGNkQFlyxBh}9YcwldLYC&F2lm?vbt2fTEh z7qZFh8Rr{v@AOT*Z^(AxoPKghql_fP?RA=1RMJE@h+V$X$r{p4k3jU?zx`1#h)Jt@ zV&SX(DQRVc*tnkVjOjE88y0}_aO}27fd@H<+fzp%Y$(*YRy2M)+75BLlk-AMA=%um zzjIm6?R6@>dEvTUZ9aE|OMt&5{8p<|kDM0@&(F)9U3yj_44*L9STw*MxoG^GH8d*( zVF&a7&N5Jq9nDSM8CESc0$D@6gR7<8?6KzLAojQ1WZ_hFzhjZu7e!TpNi$dD-llm! z7Yho)n3un6F;8R*6RaCQOE9b73-W=7Mu9yc8tRH=>Bj82AvP(FIDW7Wvw+!^>N2oc zG&GCCYl}MkaoGs+XQg?7BMz93MDBd%6*`T6+$Hubx~6p2EGWHEn(Byeo>JlLey_?m z4{(c#zxn?2$Xu=;TcRzq6SI(=K*xpVb`QB8ZrL`v?x!cXl&57+=K4g)>a{pM$r=THcQ1%a)f}%OGr; z?*aw{pxm`s3kC~@f+)d9M8Dp~C+n;z-Oy$B_CExOK-~=QwO=iYP++kT7-8^7?W8+k zW%B`;XF`Q^VvKj1Y)4K2f$`bkIp9A$)K8U{o(_6d*yroce#M8cx?Tm48lYYaF`AMT zF=O&Iz8QR@Sgi?BsHwtCOUgB;X6hLW;Mf0tw=Td~o36opZ$x!iZCA=@4}=wPoCXiy z$(r0AvEhc&13F^OVRa(vbBaJ?^6EF_yVdRZ++ubgr1q#;Yz^S=Ku|ZShg}|#OjbDm zCp#b@AUIkljS}!Dbhs*NCv4wmW^H9N38pxU7jjtn#_%pv1@cagm#lFuI zoc_sf`OH(YomLnEHD_K=eZ6d%kCp?6YL_>#Iw%LKc#}6y?W=EzyoMUl5+8`(NRapR zIGVp?FMF(PS?(lF|2$Bdsi7__J@buINLW~C{0|4G(Dw?;Xd!{A-q<;dM-FTf=bm{A>h!Ob^J^;K zIVpMJ&<71|JX@mS?;X{zT!0`It8It5L@(=`U3UG)GDal}%kWU^J@Ix8f^men^bN{| zKA-cB7vqLHX2Yj?PW*JXtWj-G^B?~nRnE)C3KxpU`*6N}VvtFihS=Dlm%I^JDE=de zXNGyV{UaaN7{Pf;OZIXTqBmPX+IN^!pcu2B(@1hOJ{AGWYathvQHX z{byLsQVeSGFq4<0?J8w7dRLCQKcq|U-3p28@i(o}2!wPQeQ5@9|87*~cH>5Wnywz- z=rmc8Nmtw_VpgA^B;q%pv#>Lrt!Uy7PE}CxsxM=7O2^zjUVi06dZodpB7_@hxvXe9(sIpU$Dj=$|R12sa%E%?l zk(##&=8+V2FC7ZzE+vus!xL0lEEin^G-cXGPSo2`Pz3R|7^2SqOo)V2c6F&G17jYDCh>HUND0HZ2Fwe4w#{myb#04B9ZHxCINdM8=WhQ@MXe<^RM~#Q(5#iN; zGXwsgf5$gB!LziNS1qg|+`YS- zXm0x@4Em61(05)sW-+^9cyDSZ8>zQU+$l3x3*4I#tWqOd;BevH8`o7EC3R5>&3Bk{ z@gFpeh}4&0!jAhcx*gff%o6qpW|2N&!AADD@D@u~IBBJX^)E?*ZXF3s#NxB6IDxV6 z5{dPkR}Ul6U;WzL5e&6Eox{%Me=f_PT`8fKx*^|Vk5DG_T3}=Aj+_e$uBz#n%>7iCw5fj&(Vcl;aHhjfT`q3 zrb!5@4G*6u2Py7>3ygN2p~^~A!9^oBC+24sGtqiEp90G3_q??CA-vREK`}<75S-F( z4@s)Tb81%j)#_<;`H=nlm0;{+HW9csqW;Umc(LN;4pu`N|406M}ofpp*OH|E) zeSE!xyz6KxOG#b!eLh^lR-#zp7N4l(c6jLOyW|mE=Zc7F$+soT>^D2CP(ICaelxAm z&3-;<#VA)3*VCE!Q~1e`hHd;u;72QKiyCBh<#|qXoMj6ZP^M=IeVO6c`;ntX5v35#jke9- zb0R91V8c}H1Ikjjut!zEV#2nTg2O8^Oc3JVuGH~l1AHFRLf5xSc<|N=b04ch? zkK}EZ!qIT1&xQOZm|BePHPf=ITb9cWg0rn$bb8OFT_dMLMEk&#AXic@^S#5MGxe;_ zddo~y4jhd<^HG;3yc%v(YpU}40zBUGo3fqJ4;XZlxra8HE;FT+M)2%i%6I%=k>#p0 zgF$Mu-8&4nSYXWX@}7(o0|ZR~v;2K!MwGyT%7n#n+{`wAfkT+i$xSHKDZ3HYRq5oy zQE9$SI=^bne62c83YYLqhK0NB_@Hs!1VOo%&0b6M4X;T2uzZ<6m8{fxbm^ceB*dt-;^Mp%|!J?5dCm8VBl3Um0+ z_g>kGnGX08&3)Z%m@*e^XvgJtQelBhck~~tKWlfA($oJU1%H5k9#oZNSvaduU7_@A z4QM{pC46fNK_0HO6o(SAm2IqZRWxYiXqV1$=-9}^mpe;!G#>$B>UP&IU{-pNp_E^F zC@OGsY=#-&G#uHkadBd-;b2H?_H=Z7zYH9@g5e{7!6)6hF1bsfam*VUJ`_N8JR@ei zuEn(L=QYlhwYOyASWQ~~I;uLueFh@7kbB&sAv!FSR0Yj7Vyn`m;{1#AVvd69U&Y9A16|-pRo$a{Vbak}FsPKw z3k?^H&%)ReY={WAXT_kSufX^+pZU|0;FP}uZOQK$QYLDTcx^XF59_x)h)G{X7l;hmWj|>LNhm#0SVXd z48bO>KZndVjjpo=obI{A9pK7PH!*%H<%$Wz_4v``6*v)}x@{0$xw;Xh6nnmCwcJaU zUe$c7*{%<2fp`4grFXnC7V?fWwP)j5P`Z zxbx84tPtC!fo~@6wilmr3vGi+#{=(FrPHQklcQ7(hX$$ZO+$@l{aEC>yUwJav$sxK zWA(0+P4BT<_)5->-S-(@&W_yfFkRV7q`v+L)xGQEcFEWSk9(1YnqrFvh+8*}N#qC# z6MWe7w0THrvi;)c+TI3Xa*T@W7`$lN4DBl`S!6PZ=1t*7C8XXZqjl%2(Ejo6JMaiS z_j;6u|Mfc~t%HNsSkH3(9av-=*)g@k8NITDM}t7Ho$YTN2iY&*Zq8TAETYdV?Yx!M zp*)b+lIXjCfwp&tmL_`E6hU}DcB)<7AuLN=8l6)hV*J!kq@FPAfWg z1!f+kYpN53)5a>w*7-KW)n8;W7*WVqIkXkPaFMx-7NPjK^hu+n8`3{c@FpY_B>r4G zVQrmvbe2bZH(6cpg-cDX&|GQJY$9*`O5Ego+w~rFojge$gNwZ0=}slo!JBP`Q>RR= z#+U|YCSx~MR5XHgD-Yzcs{KTBfiox~7K=a!++%@ylfJo-UFQZu{{ls3NuXECZIp4B zVxH`q@4Q8SNgdx><)ej1$0MtrYc#;_got?12E_~?xCZReX{uX2(Xq61!uh4npPE@t zNNYX?PMGt!!5w42hpp*^x_ijh4W6o2QpZbIyDqK#7A-74ayP-{6z}`I?mXUS#i(Bh z73&SqqBY>{f1B0gOU_630GE9BN9VF8%?URL*_HL{X7926Sl7{<#N#^Jds}5$Ix^?c)6sQ$u6H=uY&tE&?^1;owx&AG`hisdsr8_)!^ra#j59X+^|PN- z&GX(pdANl!*kEUEQMgXz)YI@nZq!6>TBk~9U^8^~0v~{-8lj5S^?w8(5HQU7cygQT z8lW?|JbaL#-Ulk3tbQ$}pTmA-}D1IVc{@ z4G8MUJ!e3fHe^8+sMLB*NeYI+X7lyUmz#GXQ~M?V>W`lsAi{CP7xS*OZ+@u=n>x?! z(I1pUJVu$s)wWO#x!cPd?GY5De7n-o_ih1wbl}fOcgJ`P)$iB!UrCCtj<|4sLAY=* zr^yR7=sjqs4j=}OYN`e0InFzU*tWo+83-|Tg+Y1c|_ zII{8?aP!L+ZtZFl&+oB*!gEg5TgfNwX9Q&)(VxZ?UAjdkEh=M`-ekPYNpK*03tgUk zvLXc27jSjfA-gGS*n5U^<<7{(a&#MBK^#2*aRA-`$`gCQmQhN8e>wFN(u&R}F z;DoxAhBRL1WBh0ivw)#BevQzjC;OXE>o++u3II<~d;ThhQ~1h|6{7$UW!`N#i)-0p<(DC~ zAKQYakZx~r9l6BsrEZ`9h&=l+eW@U-dPog&m;OB}v#@_=kjc<_asW+qwZ&GCs`*sa zXF~aVpt}2zOrMtUqYbRZ(;o>U`>^Exy^U!r+xcYx2hT7cT|;X>!8@)i!*MIGqXE&q ztM93^zbtn?9mueiSbmcR#xJiho=}>4T_uAG0Qcl9qHF=fS3{Iy>QkLy{+=_R<=5V6 zqBR^Y>hT&N?13W^F3|_-(o;8o$QTV zIgGInsko(UK+1a(Lt`GgLkx5TKbAY0!?iq{Vr~)gP62aR`{+Mfc4|cOh;wmYl+3St z+Tp=k_P+as-Q{7~wt49H>Kpz-+mAi{o=3bR8OJnON8D^Ixk9RhEU3Bf`O-1e@z9g)PW*n9^U zpO3i61EI0#WG@O3+*|k)+#8kqHjye(5OK?FD?^l@7Ag=6Dn_~x<`r`tn-i? z&{Ki^2LK!l(#Z>yu$e2iqKoxLe++2Ued#7cH1Sq%>Fyc#hkBDhO3ub{U)f!wGqS}~ z1sx|hwlCvtc{R=x9lVs=o%3RXkhVhz8y5}Wf2OoBI~ZOz?dZm)VA9Jt#zlQC1-~RE zyTpZdGnPNgwDf=n=XRk_rY0TgVp~@fFwyATYa;}QQqrMAOHPpC$DtlNZf5EaP~sx& zI4kURf_ACQs3Rjk00|pRK+LG#U;?Uq3^{+;#6C`SL(ZQu&bZv6k*i)E84iF5?h0Hy zv`9Ai|GYZinBOzneTww{>;mu4!xP~B0U{7gb>+};V0lkQ`~kAhLo{{&1q&)>Kd=go zY)&9+Jj@l)0@iNIAj}XdZ_q%_ zA>>O??YS8^H%7Rc0pX_50)XiN*lE^4Q^wW(^xk}k=l$QOK(Y>S0U24~H&&_XC|pP_F$U@onx`=JCS%%3-gM4lVzO=&?gTOIGY!e4A>K+= z-fCa`AephGMzVM_pYFq~R6G*Vk8>kt^Xju&Relrg)^Q^-gqe8_UN_^jzngCl)B0-0 z=(Et=jVj0FiP$jYW~)ms5M2AFUMGEebZbh7P-QOGMDqG)D@rB*TRCK6GzNkA-^ZSM z8^}%eF)g}~vxX#QTfTb{--|BfAbtIN$7HC;Gcr?)rw(6Ck-RBMmSP3Im=|_-=`kni zRa3j>a09M{kdWX6xtWZo_@g$yUGEyt((mwH*Qbw^xx3L_FYcD9@x&avy96sSL%eY* zkjwIk#n~=)TIK#b(JCrUAw<;;kBY0=G;1HmyKKvP0Y;qu$jtXJv#`ncfZ;|_(>76a z*3Y`x#xsx!i^#dRMXj<#)}uY8Gss>eqf>@{eMI4m%l3?mO?Kq^DpTl2cdz&bfPu5t z6L#PGo-t4U(eaukM{5iDcgzXg0sLjhoBW)u$XQ|FKB)uceWj|_H-KI#8h{8J4rh%ume?FFbtdCMr2ew3qH~<1`2=(iQ0WtuF&%u0iQ%Wfz0s zZ+u`sHfkyUG9J5-e{|*L@B5sI4|-XsoQb+q7%IM6p;XMiT;{XnN&gN{sZFDSKLs+! zvVXM0?;m`hU!SSe4vw(X1dCw@tL`nPEVHkSE$a5Phft~rsO82$qXk5-%s9(S)@Vr7 zl0pC(W|^fc6chX=+#5<-3iDn71}c-}Yzh5Y$EozwWPD`^6G<&Wm` z82gjlsFSVdC{pt2ThQS+SOpL%3cKJ;uGG%wM1(QACYOt-g8PNCvGKBqgV;&D0RD~1 ztjUMF}`t@`$1wR$n&(m=W{7Hf; zasUUiba?9<9n8Cj{{m4Ry@&Ce^%|642J?X6GqINY6YI> z=4d5s8?QsjCf>NXPASCnZQBg)JF@qG$3AJ*8o0vt2_0;12V^M@he3ZB9{bSQakzzR z@J+py#M>XSp<*x70o@-QjEhRW`D^!mw#YiS-SlK)%ukcEcS{9{4AN-)ut0^_z_UqK zp=DVGR3Dz_W7&aeScRwcbBv98$jJm`!iXvqNS}0YVw~Z&DOcN;58i!jgbB?hN|c8Z zyGE1p_ZyGM^!&iy2_lvokK^;sdY&}QlYamrkl&`S208l2Ce2nn3Asw0t3r*-A&{8! z4%fpGZAT(|qFCLQJBHJMq%<{{PWkR&U)JJKs)0JEp-9a0W@W`=VYwO+JO7_+`=67M znXvjVT0)`a_CZL*R5B0RV(N*sMPtf#1W~`b$ljZf%_T|p4%xG8va@B6xNOMv>iBy@_j*DJjJr#8J$es=rQq=XRV zLD?Z{EJ%Yjyv*hb9_suwv$@}{KH?h8SRK!Qhkt-roZQ#R^t&C7z4a?pA=i4R`*pJ~ zFN@P{*r4Kc`K$Q8vwWBdr&mUC%fL2EfAY=FL$;ju9Ur{oUngWUTKJ1R^$TFu(=pJo zixb27{@8oxkTQiQf=VxH9M(4QlBCKDV|PU#fjUOuDn!H7MLI{+Wm~K4eF&=4qqbv0 zw$Uv}Tht6@-lP;wZHTq2oir4CdM`(%zdcX)5^XR=4=$2=Y4r=5^-z+Wdc<`lc-0nx zuUq{|m4Da&+VOq>lB;P*nEagK{8~yrlxf-u7ta@$rQ&r-=59?)UF<+-g)u zcYQ#md{+9fz{<5#y)I)J-7|b9+!gzpOln+agOw}TZQ12ftsq3GqWr?qB4gW~dtlRf zJCRJ(jJhlC?1-SPaFUgTK^If&l!(}tz*)Ewh=Wl=aj+e*jhZ8q5*EhUN9}OR_7H)A ziApN_IYKtc3k8DGJeU%gE9Gf79qvZCBx&+gVjY!>QCMer zQ4{sRQ&NUndAz%@778?@M-|T^>x{coQr;a?pI=`XLq5SmaUOUN)SoW0gZqK>!=Tkr zkyL9rc*;AlD>1cij6=XHn*pciJ>Xw9=WAm7BW1Xt%Q8cl|AuRYuy9U73aS_%a#+;n z4jzEdQ*TG~4KzD~QQedJwS%WTK|r~)>MyDt5qm21`l||03I;U$naZsNe(mr0*P%-Y zzZu61cQ$yg!@mzo)VG(JfJtb`KD#zmvCEu$m8V>$o&R2rLgF_!Oj7qKEuz;?XE47g zE<5qfh{0rFI5`<+T(g3!=?qdmX^~avIqsdSa8?4mvYFQ>n)LNWzR>swNA~EdOp+qS z>3Xh>^zEm46ByY-@w5(sZ^{2hCd~2P{WD>+jg(CT9JRuVpZ7+11&W0~)>XXHucB#n>VZOfg|dc=lsD;pe5a?FdiHH=}JiJF{Tv+xWXL)v`K26ECO zhm+bPhc5bMM0_A8IsC7aTvzwfNlwpk0JP;l<*f%$r~2jW2l&e&5EZCF?0ezPrN+ND z{>U6;!9siSyOthuJ)#A`sJU4u1-V5r;3Idvz24ETQo*wj`KErffphoCPj&?O^KZ?? zjtV-*4;4T~V&Y^w-TSS=dW|LWO)u-lVj2$%vCxC?H}%FbvoA$Eu;;76;=^b%yU`yG>kPUyHs< zQdP6*I7}c;3O>)|vIwoFw2M|a9I0zN^gY-3W%@8Jxx$%?4TmV8*3V_)F@@Db`+W*mLOn>G`Za7IvDw zJly@$jM^%!rH+~E^6Po+6W(sFFE4bUx*5BN!yX<8*y}dW^r#6MKPhUpGLhGj9h28} zuZ=jPb(Qw1K4G;h4_cwGw3)fin6!+!KvgE}$RErVE^h2oa5pujCDBcwUb9N%^-iCr z!VgDV@~=idbrrR+twJ)_pFeA3Ch7Sih7BIu@qe^4!0WKwI+6G_rtMCC3L^Ve>dwv+ z{whCf@lXv&+(7Q>5|NZnc)~0?7#3$nhQR zRIAe$vJBNa(Or?-LBh(}x$PpNhRfxi=R&LOl-<>BgPSW20^S@YsIoc_@Oz0G&NQHQ zS*g>QdSWKmzhX0d>wI|f%#l{>ax%5E%sp<)8wvqX&y;%oGMlRE9Vo@UZsoab%CSEy zf^#zSa4f+6&Ub+sdj@7_g7i?#1!C zlJ!}YnGIJzN`4+1KY{TSCZaK&SoVP+mFMfO$Iue!mJI@77}F3(`V(2#>uhNh+d2xyxZqMT^pq` z^lV_6IpA8_^Hk(=(=wuy@?A6;YdCv4o_-K!Y}@f0%U;}Sa-B{%?}bs+c7?g;7q3`$ z9v1?stHVt%PW0*M`p&WRMboYyg9fe+bO$`%1}6_scK6s0)iP*vfV;Yb?Pf9X6nOd;13<>UlcpBm0v*#APVKicec0EbkJe+oA#T}P{8tNpRn3#y7c;xq4yB@s03cZ|S3qP2JE< zM^v!s^AEo{wMAfHcy(_OOj(PMZYuF9iO50l_fozF5NosbqKc~XlJ`4f!k zO6Er)(Z6G%j+xkK%cHK5hIZ*#uh(!54iZ(bC8~+te7D+^cC?HTSts_mkM&jI zMQDP6L;5Gh_T*|wgK$LK@;j(w#!z3yq1h1ll63d6Qks9gcr>GvOps0TdEyb9FpMuvxUK%LUQ@H(cAkbu_AnZ@AKkXJoE|1z3H`ohzXr2E`VOG_i1XF_q}^YT>= z!ZYpEhssnlqtjT!Kj=2Qhi&X@_B1C2+K>e^7Qa8{=NlhAH*@|jKP`)1#r;)8x5jJX zKrL#YL4j}`LP}M}-qG_r9sWY!z=6Qay*Wwl`pC}?y~Fm&2-;#6$)3+4mry6l0#6kX zib|aWWy?e?w<)AVcLw1J9r)Pz*&7WSktx~sjmN~{DUsLA;Y@3{wSl{Y<=M|VU>i58 zz5gDL^-sghuT>KOr9xQOYMydI#dYW&%=2>RG=s)+3D92LgF-Jk0)MzIBJ6XUyh z-uXu#{^WTl6zKV{JbXLz10L4&Lt^>4h!AxHSil`gT2Am?h~QYfK62D(7{BTEXB*h~ zcN=*4`Ja-RE>JSFsWy>4GqD*J?C|2jUPRTk#`~d*i6&XF&T95}ytPyGVxFIY+mi{0 zc^iY9XJWros9M)1tE&VXi=uaTfOFhFwiuLqRUa`bBeH96cSDNxKYL~hz*oqgnO|7v zw|^j_J0@TONJojyoAGX`p&Egn zU8n3?8nXzDXXEuHDOAI)c*@;rJ8$`z!JTJJ?nd32(Tb*R7IfAFJHZ~lqxW0Q-YA4) zsH^EeMk(mGKV@E4&BQ)Zq25t?>l?pS8q|ii!4px{04h~8OT)O+emJ+9x)yB-vx;_6Pxx_6?WvOF>4uu~N|e?si) zt{n%qf)mzB+wYUC_#Vov9#qEw@_k1z%AVIBWK`MS{ysm>^D?~nfQFs_=cV95Jrjjt z$VQcs2ueIWds*EhMqMccTZH^k_*2w+uqs?-rFOQ zI+ZA)w@pq3iluq8RyW5hb6Z_)?@Z?6*r(RVyRH}Ci&FTt^Q%};sg~^_pNz^kE9c0a zpuS~Kl_SPSBqZ?Szzj5?z#o8IVhwFb8ZYScY5F zs?n^nOu>)MrZvB6>P+q7AJmWRqgITbGGa|zTp4+r<%?Ob#9kIm_13(djbK)mp`zS( zl4AL7m1Xy%a&b39(TP_vaG2JENxQ3#zp-|LS$Q(fyqVagSR058eR!5RF!tJ-35uvz z-s;^YRCcq2@K8uuc#lFT^jlbi;wk1Sf7Y+lzQ?ZS!FSq$r`-FTiT(49SsT7Fwtw+Z za*AvrnL&`FOs5$pbF9wj69Iknj6Vz5(|>vOEL|2FdYyJ6lzDjs_mkTDQd&VLa-{f= z9qD`y=j5R~0^^_tXLMOybPeIN&I!=)xRg1jKw2`OT>lA<+wXKc z0mbho%Dc>Y3Jh91lali;*BkfvF{^s=2kzcfSW0ZzeGB`e5W6;;o9?ai)&QD8-&cn| zvAO(%C)i1l!u!~2g=r_AzjVR`ztIE$Q+FT)DQTh+4=<$Clw2HT%uI)EJcYL@X|9Iy zlxIoh_tC+1im5N<+us9IjNq{Re z>jJAgvYl{++%&nZ+ZHx-9-HuN2s9~I7D8~TW9qnVomwyx9CvZ=#Lz#k@^?HtU21n0 zjGNJ`nO)@B+AVL&jo+dCRsw2}cT1UPGl-6H-TxZYZxlZ#=BsuaFN~&m-)W4nU$#5k zJ2XZ(72(UJyi3))AC0lWGBCj>?4o5gtp>d4t__2MQ}_#*Kd9X&^4hHsgWFstu3mKg zA43m3_qSQAu&Sh-P>!iEj70lv*>#K>Dv6UE6K75mz8iIJ)^+W8diSZH)k|36?$w(f zf&t=V8kl@p`$p)z<#!Zu{B(a}NUMoF`Uyz&x8~HZ@i*8yh+}h4Gd=WA!(th?3hoD< zuizV%BzYJQ%RlbAYoh=cnelO7-j5p}A>aC=pKxqcV;B3ekBgB9z@-js>6;@tmnO3x z_>Oc*`Rk1D-=rXH)PjKx9@=4!CXcEzT3+SW2X79fsh~122F zbA%(ioA9c2#e~nU#MfH&*54O4!t5AO_u!TIfGBXq{Pq&RM<%3%F$1F_l_t7^ZK|Fd zgdNl$@Ar3iS&qBrx3f}cpL6sce%L-WJ*U|SL`aD6he__IugD;EA#X~N*rhIHpFw1( zx3^HAoD~1Ei{q-;2L`YA`Uev#peuc`epPw1(PqFG86#UVJ_^o4|M)0jo zD!etP?Gjc{hO9ED9ldk0q~1u;FLx;o?Kgf?s8>QIJCITA$VN)Y|KLJH0QIc6Nz*X2 zUCfQGP2MP!!J5*L=B)uU4^W0`w{ZuS`UMg@g@xIO`^5ciT+4}H*;P96W8IQGLkN9$ z!=w+_iyYJ-lNa$9i6qea-kW-;zpS-K=oGSs^58E@3QG$&jBSzf)Pt%*DdyK<=kkrJ z6bfb|13dd*&Q9B;^1kh6>3LOjC7k^q#fg6;akMjhFP9bG#~b%0Z?mM~qw3zFtFBuo z<{xL{5VH0M1wGGaUwV&pWVi;CgMDeqEo$MfsVVhEojv;^uzC64-luO^6jZOd)^oJq z4HrH+s*O7(P8d3nyk(cI2s8NlQCf-VuTO05k54R&81jj=`QeIQ^Er~cW6lW^`h_*0 zH|1rph#(WikiV!FB-iuk+y%n$=yG%jY+|l|ZDR6s#WhNko`cP4cTtoz_OuW9?tU@e zdA^pFT#!PCULY1ACN|h-TprXmH&4u=TI&KZqitjzmR6Qu&-&wDRMZ;fBRQij;^%1e zeQgy%2_eS}He5kpu=h}Z#ADF2`5{SCi^iM?v>BgHU5tBdeLPv)$bD?UOuHf=nl(uuktE>1T!^%24qruM^T^`th>P{E_XEuX*HuJ z>6eE3f_4U|n=HXSCO>Hdj%X`hx-Nj|_X}i=t-#}f*X$Gx@k-#gMhw_ESNPXrH}H8X zpBY|?!fet{aInp_6Ovf7VC|B>^-UfdC_v;!cLFHD8~E=Mi(3+e`@o#A(o_SCJ0}=+ zXirz?t`sbyxSA(@7+oKY6eVHI$fPex53Ig>P!75}m~wC| zO(beW0=8idUtSftn>&*9Ng8?|By`NQ95UZqO|PoQT$vCq=hId@>SwT38+7wo`78xk zqZmJY?Qk#`>b~zV{R@x6-7szY_8snA{Qf?VCSZ+ve9zy+Hz|5BITG?33<^& zKN2D(VT0I7qq?yexv^KgL|%#iX#N6Tm7(m(bU$#X)z%e?P#qr#`sH?hlhmqgx4IC1 zhw;ct3hnq`fD{mfvd{g)RDK5?{|74)bj0pFN~S zwLVmw{Y6VPN%5Q;$Lw+bQZ>SZ1I~aNt-1S5BmcQC4IoV@Pe?C_TVyC!(WiDD8&c^G z)&Ch5u0XC~v^a^jdpIiCeOM&;hp@hY`#EBOWr;=;*Q)$t|ec~bLz*UjjjVmqdM{IMFS7r93HBKhBoH#Tt%X-ReGI5 zb*7fd8dOrP7FLOex?q0h&LGbkb%oP9$e(*HC!nb(eDvpGr?2m>hNqR->MY?H{7gju>5^^k;PsB-(ee{xH=iO|CHv&p zPc*}07|qd(%^(9Csl^N7qOl-otqf*_K^&=g>3a?@2@@OqaRlN)MfJ54nqm^og#b%hWE-;@zIjo1RD*TF_P=Typ+ClQJe{C?JZQv7#TSk)h`2-eH< zmxIDAH#(AbC)KN0(wiyAPRI*|+o}t#Z&fC}w&IJQ?xkWDFaNT^X6q%@{gY?=&A_eQ z;@{PEnpa=0!>D;$-dE^q3ehLdIE?0-5XKn@WMyVL)9QMa^J3Pst#)FkdT~%MTv_y} z1Mbs#NvD^~Z-t9w4k#j?&Ab1!5{ zduj6shlnc2RzL}41#rs1DDpH;YJuFpm+jBMa78nwwyBMD11nu$_(N5uoZvE?8U^GP z>6C-F*fGIRw}GtxXTx41Gsyc!Yy`y>-Vrt^+PlO#9cf}`w^AaM?j}Y0A=0=nI zwDlsB1m9uazBKChX^i^rZ-1Tq8bGsF9K7Mj{+{vM&(Z5ef?YL@k0%%%KBdYn%gxQ_ z$GcOm%II)Zrj zWMIMC*y+W>Xqc~T&$Tef*fvb%u_4v%1LWbp;r2W2+FW@Pk0MT>HP2M4rYI6x8g+#) zx6YuR`hmUAi(z`UogMWz|1muL{l#XV_}}4SHU$;EIvgrp^w23Ft1edWz1~9*XJ}1j zNHb(!9F#C)7>S+#it}(`_G)-$ID8FzqeCz~@nv9WCR&ts3>XoXCfj*Yx%ETsMUP^B z8ob^JmCXNe42M+Whi9Vlyj#~0l@M^WUUxxp^I0>A(=tS<$Co3_ti#VOrgCd_bG5JO zyPO@Cq|e6llkyL|d_VKfslC=G=}|aTVdRDb1Czr7eX8y~Iu|zn#_NbYeOZ_swjr%B zV`CEwX4?+=!%Q)Rtk-*?l-e*3OX_gld~z6ZhmtG~is-w}Z)DWS*d%d6Fa_Huv$)=SVK)#YO85FiX0KSCT?(ydFrua#$J!?EQ+fq7EbwjC73NL z!S~FAv7ZwLi|gWdt+nmx+PyEwInZ$OS^5hhO*bYPIgo{S8^fK;VXKG$2cw_ze^<)i z9x>q4m;}bDfL3ZSGAvgV+m<$cd2NAVIsJxH>P7?=ian!TSH#VHZm{MYsUWzO2Fn2( zJ7C$v`#I{OOL5{_)a5=H_D-vTHO5$sG@Ig4gO;4*ctyB4RQg%sDvnK=~Cv|9{Dd_@wwc>i?V(hITat|BHy= z(yICaAtGYRE|a6ooy#G$(NB4_!0!0GFbo1j7+UAI=ode|mzSf&l{sM>$v1PJ90iZo znp``EVx>-+rnUOgaWQUOQ?B`hpl$N#(u{BRYYi%+9&Zwi!+>4_(D}P7L~qU=-2syU zAn75LDCocx0R`0;*r+QLCiRv>(f*IQsZkzO*iRUKAtNh$=B^j~jbyLCIU2KsAD)I6Zg*~MQtf*#bwY(KOQ7$&K$k|}^-Poqq?^Q2I)#*{RjoS?F zjR?2Qfk5<3Sct3L$eQo}G9Bbc%@%n4>}8OZ?BI#or`!Ai4>?Vr7FOISd~%aoHOxcR zf?4gNFEq9YRw4jWv!IvSO}KGLef_KDheOFCt6llhS$hX}xnYWi$D;fcWIKrH&2&9}q4Cwwk*#BIR)4mF5t7pKgiP}pyo@YUZc9>+i_d$f z?)u5E&e2Gc)r(JPZL^JGc0Zom5^Xfj7C%+(to;N$gqpp&^)wcK41>5QdiPem&MfqwRqUGPKn=iY6Yq>>RN2?7c zLt1!j61zPPfg{8@6If$Hoaepq=t~lpp!T1G^q!o-MeDoEbD&xXq&-Q+?O)0&OoIqM z7{S>*j@b{h4N`(@*A|vKngB8cZ{DNDsAX22zxmCQ;-|ERoXe-5NQw--y1GGxv)GL} zA3)uY8<7(@<(%j4vBdDP5S!^{3rxEVq#=*4;~Ov6L&n<+y8DBofdHcL3f7b-e!j() zr<^`;0EiF3lUMm!^={TEA_f^2FnQR4rKoBgxkC|=Rw&hjlwJZ0*Huf&8aK4dCVtrRuTMg1wfu$LbQJ!FJaYX1A63*uTn-D1Tq+&L zO0M>^eXf;Ujg9*F^D>4>HiZUkYddzOsa~d>48Bs3*DSVkpILuh@%3YHrNWxel!vk$ zPnOT5*wBLJ!FaAmta1-_YKl%TI<%qnKQt)tC|@}`)?3n24cl;33q~irI$JnfqF!Vc zi{-0ih*Vpz&|>W$*91OpQ1UjwCU}9AKN0}vr8V>d2PT==9_|!yQJ5erdeyhA`;6Sq z8&p9mkq6%}s)X?zM!ZUP!Pi?UoHhQOzv!d39=v)vq}wtbca4$X4|nuPL4!7~^jS3q zOqG}RJ`iFaYPQnn)GehFZ-hg)lS=5tzxJ+)_4i{iokJxx_*ZK^x^tJxMB+8FC9B5!>AjAU%d-(9U5fCN9XFyMN*99Oud`N*!OPn)7 zfAt=eSVMpEK5fIhSuLmnkPT2`0EJixqDCBfd}eEfL#@_AGvVOcyvfukSKviq(m_>Q zporT2&K~HJPI)XXH9-VG3M>Gfa18WG3N?yvg)|H_R%a(28{c>%cBVpeg&qPXkneZX zqxcpF&CP<(xtd}Df7?$I>-s)K{3Xoc8yl_2+v0%Uyz@ke+5lBMpU*;U1?Y3bi_ahk z!wS_$jMQrN1LW1~&V)ek_8D8mGI-bj#77VpIW)-q#YfB~h%9F8K<(2Ibi(X6{#ntT zKeUS6UHpIO4%a~kqRtuyGLHb7ut|`2ghO{kT=FLX-6D6eJ?QT{{_Gu*lnGa$oK8U! z(E}>H7GMY5j$H_40dx(3RFJSiz>B91d8)3r62M8jZ~;Pd?h14$<^RASzQF_wRt_FN zmPF~A5O34wAE>lN>pL~)weGY+>$@ypIer&YUoRk&oqppDAsn33|MtXe41;reW52RR z=})1I$ORonYC#X@ZI(8btW;D~v-*6icL*~kC5w9rD6jW~daT>j8aDyANyW%TPV3K3vifDQKN(u*d&;@4<+8v8m9C61C^GOy zDZ8Uk?iT{1jR76jf0m7xYC)L{zKN0A(|40@Kl?FVkaL_$p7UK@%(2LdMv|)4yXlWc zpS`bQRI6g3$hALt_7r?}lkiPf(? zHPJk#{<^om3}?^MFH0^h;G5h16{c92C!=L^!8{2QN}YL7fC``O7pI;ztW7zOUoe%3 zrBK~^R7y`_VkfJYivR}C))Vz|mES}asI8C14lf*GTf`7<7Pl;N$2P zeEfOJAR>^H3djrVez}@76prVdoQl9A70bl#r0NES!O~7PZ6!=labGze3tTK)-Hzzb z`5!%wnzjn+D7cXZD;j3Ci34CqLGIv|#oxwzCh%OI;Ef=1IETyD_91!Hcib>_$Q05a!S;KcX$*IYZO!Re3M*iA!W`n@w( za$US9>}4xL9h1^}$`tbN^XH5`a0^`#=TZFLb}+W{h`qW#Z}i{eTaMf{cEj!Woa3MM z*%EwSvB%-vmFg-!7Yy6$_u5{ZElz@2h~cf$+b!2V#S_Fb(*J@8On=y%H5G~^g3{qW ze+*V%gX&{Lk;9UobS_*;lU83n4k>3Jh4Oqi3CC|~%ad(H&Q>t0jGgSY`uI0xPTf-vNI?62bnf2+9F~liL~7j+c(fLSgep z$)A&ZQSeS21Gv(Ek4{!IohG7}SIrp_*NQ?j<%YdWtROcRz%@<33|CgiOW=v((hB== zt@KP4ajk+JYII?0`EAN#Suxr~?u330-z^nm(2_~1lYSfm@fr>TYEz_b`O=-#a70>( z;&^nta+eMkC{_MPZYfxf-;wgcS?sGN#me} zS2K>5RLbmdqw9`TU>YbIK^F^$CMDEldnA=4_is(~q;-x*E0B_vVY3dcu|K^k*zw@= zUxSqmY2^F0AL<})H{;fGol=6P4jA;A$MGcqaX~M8yJBiDX$D#I+;`aeQo|RV`%vyL z`(@%ihhOTQTIldj*;TUhF|7lL0_VK@2V=GMP5Ah}L3<_MLdN+Mi0fn^ zPv#c?-)DFg!g-M%US~zZD1^K4vdxgj!K2TYsK#|0!$X+jIeJ|djz|@v4iKCuds%M0 z*|A^-04LY|tI(0{0mntX%T`n=0Z#G)aFXwQX{STE^T6rbB;fv3$Jc=4(9C(S#BoTk z@QfZcySKgM)Zc~;dRbdA`qMq_0+Ces^8dFZoDuJ)OOYSAf^suEBZ}|k!JYC;etS0s z9J_EHaE1=^0^Cy*8N5FI`VbSg$k3oqvu8aVnL)mFc3sh#ouIsR8qoBus7 zbD&eOUl=+Zi`S7?m;X)7-m76v10BqOnv~=P9$`r8j1xy>o9{3WoU_MR5SOVQ=b6ww zBy?$C9&jYj`!2>sQ7p1x8bEklKvDyw`2e$N>;9L8az$|HLue-`^#{?Qf`LRzNP$pN zm+$vPGMFjr(IslsMyN^LH5hz zJA?pal{Z1bN9^(=)Rj?>LE=d|6ysH&dNxg}?{$SU8wn_n)PlkSt7{^;(E2`JChz|} z!Yw2ufCzwo;l>4*^qSBC$KZ^Pm;CA9({!&v45ga#ySt-4O*GW>b|yj19R_O=f_~+G zsk9eU!Y8;yB7mmMTem{Y^ecO-mjT6k=$7t=coscl6-KJ}DPtsac}Y6BFD~kew^fIl z!D5LdTAyQD|GM-$!&4)0fJfb7ea^sb>-FE^d?8f8{KiM?lQEy>e~Q-kEo~qdr1iU( zEp;rq$ zS9y#b`o|Va#SOXn4~~;5HFsN12s0+=nc}QNDD2sJgSMxpM?_1u9#nAghi>3@#m>k2 z`EOSG7`6t->ldZHJx_GgEt~iP8FIFgsd&1?qq_60tB<@_6`oAt2i1|+;z7O{Y9>Ni zti*;lm;!Dr)A+d@@PsY$BcX4~{Jaxw7ks}a9EDz0o#pgYVMvvT2x(mZu<1u0)A_pH zH9fH;UzW7y3ma?3*)L$oVJ~}X5|lVkigxMKel5yA#BWRskj4Kn1crYc{5+LZ7bu1( zPV0UPW3c|<$A9eBdck^T@h=oYl!2m~!7X+(?DyY3gbTP5gH0gVLi#>kqRQ{lS*j{NJ&DQwe}tPD6F)#VKRW81zeOj4IB z`}>5SZMpsYLoClX*L1B8In~mmGyV-s_^{}FuW0LGf61y~r1~Y=DZAV0(Go8wsrH|0 zV2ZenX$S-L$Cslr`(Yz)f%7l=vEY{xcR;cR>=+6Hz5xOOD^uYSM}ZsQQF2+lfSTVN z&R`Wwb*^NWdzlM+n_|^T)fv`C0vebuufIF0C*$vZcO>!Pq7uY}S}^gY(1N zY5>rrytqOqP-cq1n4lHNr%Z5W&E^$u&zx;lH*Sue1 zY>TfQcDaIrLcsBccmm#fW;~m1?!767vw$ZcOeFs0h1jX`Ze5I1a^nXm{ujee4_D0E zCpFA=3(h(ozY;FWu9i*`JzBP_9;W@c`qVISlX)HiKNTOpxf}4ti85$avj4`q9xaEb z1E77o(eku&o?UGPPB%VA%($7@w>gq-##U<$UM#_um*Kv=a}hEugI}ew?M>C%wfSKG zVhS#GV$VbP`}$wJ6973an5}U8AOOi};UAJyf>--!o@#%$q5gV?UZJtTEdeScL8Zmx zuPf#wxwFOL{|RzZ@9Np~{y#uYm-ZaEhe_}L;C^%3Ch}paZYp}KH5Q}emuG{hB7ao45#03fiu-( zIDB16Rtn&!Kdy(0fOTJtcP%gcFC3?RtN(@LWYS;M1~xI*7Rt}NFIJx1*VNh2D%(!P z3Ev8DKtU}l-k1ZpfdI`OS{5`M~UE^5l8xQs7NW8o7_Ik`~OMR3& z{`3IfqayVR)Rl)4cynZbdVmqxr(j)(nnT>sv?kg118>OSebS`BCdZZbgn zYdR$No+9IXkNmfwdypFh0)LH*=w8qnI(6LgBTxk#)d8x2sX-O6Ah3aF&)kY2nN`ce z&-Fq+MDm-!r^lcMm>94F3zyPsGy9&49S!#|nHOMmOjNKGg}6|+1T##ZdXMP5slB`a zYXr&ew>cM4OI{J3mrRRXCwt^Tm?wZ7-~T_16U$8G;Rdd7^}>e5OIw1eA+w&BaVRzH ztl!?$#%i3mEcCfdV`IOFv(rce#O{v>1nbDFMU%W%^tiC{{j+cD<-QZu5jMxKu2B!? zRI6gB+AD9&RBo!7QT@R~M zBek{Lo&aC6x@*WE<#p8hYoWYF8O7NfZ*Z#)6*l*T$b*3*^b!57jGgRMiWZCV=;XyI zb{P@XKob*+qYuhng?Gh^nb+O!K&z*yQL*>-EVl+ zr2JFx+9n+DA*WLA%!1kEUbuE(5>yO)i$8$E_dwx3gFTH%#aZ3$8@kxkU8|hgw<;Gs z42d?Z2N)JPHKhZ~Tk73vwXvy{)@JT&*vGMin`=sxiH;_(a*u^&w^Xl9NS!>2{VHaz zAU(L0W|tI6Kwfx-s3&xnB=u2lT+2qd`IlCmS6OF=SE`@YH|dbahziqK1YDKYUuF|Q zbsN0?@(RP4UMV`H4vz*lilfPR6}7M^wMST8m6`M_-qd0?c!9xBq=%}USJJwv=z@x+ z@$b)kIfZxl>lHEe1VNp-xNc5&*_;dY+dTJof>M4{>*%eLI|<6wR-8VZ*(;L;g;#X_{K>N*0b zpxnKFb0Zs)HK%C@lokMSo?H2M+!SK?*;49*KL7iCK>KViUjNbX?D{mFoydHPjaABn zm|Yb`=cfxr4Z)Of)Q_-s>dMZ|z~+1$jUBeSV9LJ`2vt`)m*1Rj0%}+x{8-US-oJTQ zfq@&arh@0%M(H!%!mRL?hrWL_3irDCp>sK5x#OK3v@a6lkCINC{@wkLRp$W-Rcx&^ z>@DQEUO;~!`%y|zn(W>DHRQM{$3=&W8_2l7%Od=jt<{|`f3cMVXOG!@QAB22N)8*? zQx#ISSz%Tg%lUo2vT*JA_V$7sLAX!KFA^ww<&Jm3sY?uyGjoC6iYTkG#*XBzi$5MQ2~@WLmq z9SOtXxY5bf59*|w{!E&#?hd+MYfmt^OK|6)V|wP*8OMmDb?MiQ6XG&F>xI5VLcE1{ z3W_IHWiABx!Pkz>eSUl$lV(*>>7@!S!WUwlOC#BMG7RXq7cY4B(vv?(uu6U>HZ0{^ z0kj92LZW-k;kS#61=oD=-}kDqT_);f*Bt)nCN4)5Z>|Dq^*m#eA8EDj+zX*3r0gTO)`DH4 z+2Bfi&m?mPY;;7sIKD;^X?6Mh!9twg{-&(*;JI7xCRG*)^sTVYFl2q%fn8 z@@;H%MN|0O0+Ru3Y#cnb!963S>)()5C#!!mePTYdUw)p}D}YSj0W#C~j(DYyyv2gG zjnnD!B})bj@$ECGg;U;J(3>=ym4yhHJ6sCs|AhM9-b=b45LRkIR$sEex!u1=HRbT) zd+SgNqWwT1k8*RlxY5jK*X^Uo`sU(a{J7pqn86()pY=^1=bUOYgSG#_KIEOJ3I;Go z{+BlgXv33}B#G*;{~77yYn9IXACW#qStBWOwu%24>3hKGYMfIVw7A}PHG+5Kfa8|f z9pV}ngdk%;BQBGJ5@j!nEH0upv@bMqcVS57HT}(x>m{eVod*g zR6DiPzK}ax2EH3sx!lxG6fTCmaYVcJmdH2h{zy7O2w_%XG2je9alWYX-4aQEqt+fn z7D>wc@r6s*+d|7?X4TTBI5zc|RNiWlhX)PFZzTk?nJX;+SC&th;T=Z=6_K9)Ep$Uf z$ZeIh(@bIU6s76*BO@lrlH*C-g|y^I_-!-Po$l>20^}9igjXrOFyp#Gm(uagV~>*L z{&LzsWKS2N+nc!a@-NZ^9WORg-&t*+d+R*eE(W< zOgjnwSaLoei%;k4m5=4<+LPR9q8&m;_+HX(HbD`-je)zw!TRgzE{$tzA~T6?{FW!d zwSa>DLw(tD>j)I@MgXP);b|KTMhs!m(RNS~Kz@B=dpR+Jz!G^8xV=^aW7gy|LlQk3 zi)QN|`#_w~xJtUwq99}H7f)S9*B2iFJJ1f}eB#Y;XVls`^AeS(ZksKw!vOtgQubtx02+w5saMNtq|L6q>= zyWt8lOZXk-b_jA|##l;L3Zi?yNcYS(S~#kz>qFqN?oYX~N{#~=Y94|o-&(7NyhW!# z1O6l!LCn#lJ_%D$f0t-KT6rY5P{N!)_phw zN_1|sOm2C>RX0#A;B=vqP|wyhM*?Dd0yv3*u?qAVU@d7w@aD6rYDs4$`xhCM>L-P0 z0mJ5Zf`t7 z&YFWh2=;sg!5Hyf9UW< znOior+V(}+e>VFuvcf^ul}ajbekq4y;)Tg>qvCV~9;(4cyGbpc26Y~D*y2OU&yQb4 ztxFe%OBNU$8^Fv5%A>i&cD45u`J7(vV`?tTaNMY=;>qe7%hB0IiB#jq(0cGie4WV<0#CUyBLRyeLiSzsTuOm?^Cpqz z<7@E`5k*mFTCLT0JWf6Y!>v3kuWC?CSKtM{Pury?f5I1*#?8C;HHYo$p5los>Dx14 z6*|Z;`SDJo1vC*ulCYJu&sQq7>O_U^vWXasMeNlylqTtSjCp>}xKc^NvOnBWgfo(u zj=w_|%RocNj#QFn3(KE?{Z0$m@6T(7N_9WRybp~E^_F%pya~d4^rnifwYwx7+pTU# z&N|{S8P;s7Z*_mz@#`Kd8^mmJ+L2bkzYW3TpVRf_Q>K^flBk{&fL-KSC8!c!z#o?+ zDvj>LseVi~*9Q7xlJT!_H~n5#3q;Y_{6ABCm#P(@)r`q?uC{)BPl6^ zlfNdSlmNNoW(XNC6a{o-p3{Ub(Po78tepW5dP-8^2c>B`$yNvf51?Rk^d5X4Z%m!{ zcCQo*FD@#)N>-O2%`CPlJu9jt2cobDfZz*16!phK%Rv^WhyLWg!&Wb$VwgW6zSoq_ zOb&mCg)6$(H}?4!c?YPqYtuqB2O}_hUeSU{U4JV%tcmWLB?~^P+K}-?n(MLD7 z>D0@9nTNbTRMe&+qqoR>VFa<_r{BE*6^7K3fhxikHm<^#wjtLB-1Z$H4KHomy>cn7 z20iXZO~~cr@uhG32+^d;pTL!~cA-+k(F-PonIDvYB?pTquDuVv|-k`(Ho`Uvj{9#>77PZAcyGdP>d!Q7Cu9F)}WR zeNcqY%F}(mp=6^JKsYq1Ltbev{x!^&N7Llc2lI=llYi`JQfEI{F4ic#S8{N>0oQqA z@|$FDNc3V}TP!t2P{$~1ze+2KheDU?1J}hi*U`n;Ny+|@>kkN}sYE(S=Qg=(I@JzsxDS~5hAn#r@{piHB&g-+7X{CAQ z9A@ot@j+)8|IoFgEjlgS6CKXoxg*Ml&3%g+)Avy5XoFEv&)-J+T8(_mnJ4Xn5uPm# zllarbtJ0V0`-X9hTz`hn@m5d9ol2Id9d3@b!E|szT9BrY zYR+JN74^rO;qmzR7N>^0$7wygjzhDjUFCz#J*+Fn z0?7&arh+hCbt;m>@kpwfs`9@n4vi}aQk`XDq)*-2J!=uNA4dX<;kg7k)*z`x5uED7asgBZOJZ{lV z|C|Ljg4P5mp{Mc`}q?-Ty#O&-uPo%1CTp zpH5{9xOujA-?1L^P`I(^CRE>NcWrY;MGv352<;g43>5fzH~l=81Jp31Pk`Aq@u!e^ zb{kN`JXk}$8r=684#>52b0A5H>e)XzqP||nc3a8tHS-s&Jaqi6K*K5-Q1e$jvjANs z74$UYElr~p57w7qQ&kghI?Mwi1REpPVj$3!LlH^Pm23$I@mDm9p%!HZ)9xkcX{44I z>Cheq>Q-*Z@BC=pj|Sq>;Tr2~eD}dr1mpJs-|hR`dy5bA>{^9Res>(s#}2-#MKNj= znF$1qguABv>2RiMVmKT{gBeUn4;aqs#9|HHQAQgXt`Y}?95BrI-O6~4xWagXaU^Nf z5xOQ{ze%ngxE!TdfB~K(9~v?4`f!0OP&JO@^*Nhq=#p;$SQw^u;QST!ZvEr8jw%s9 zOlLY&30femi!#vRr3Sr}9aJ&)YF9q!0iWFR$b{W9TvBSV=1cEeb1)?1`VoBRltmO`bXH3QV%Ve5dPr6pukOo zwj2XEJo)hcehwPiQbst+GsV|#jqajSxk4yM)-rRB>sdf4EXXwxat^Y6?7w>kD9;V->kQP zlV}kX)vHw$k&xa$64XX}F8CtKDpECu)>HP;-W>@nbnO0n(2J2|uJt1A<>8xZVHp3$ zqZ6Xd_6-fg%8g8|amyg#M|F(GiHc7~v(}7o<{^syk5`r!$m0sa?54Xr47jhT$g3H? zB}E)8#p}O8$hGB>4h=#wHe7kk2xa@0KAHy6@^0A7oXM!ihFR!mFbXm`JI7^w<+q5; zt?fBZcjH|(cHBdhr0nK|2H47TvM1PuzfXGfT`uP^GdAM>h8;P(4%N4f)NDI{cL{`Y zbcY{H1GC8jyF!x8p2z7F-%pIrUbpQb-S4$%F7B9KSX&+Ua`zA|pF z$MV=e-u$%!m=|;~i%7=9I2Il@{z~%gh8vOka2Kf=mc#qzn^NahIHR(s1D@|!3T8Un zA6c7vthIE?7)jCilv&FyZwGIEZeuXvYeBuZnR$r{Vy-pev?>NDPun)x1E;0tM-#A!B{ z$V5ijSpTYSnW{>z()(HVcKb)^hbNuTL9av56mbNaB4mrBTs54FDC^nivG(b?}; zw7ZJfgID9!*o*s5B7#r&xGb!S*wxGYmSo6xYa+bXIslgl3L~^cwvfCoS53(`YAd(m zx9{?=RsmI7WJ^L}$LPM2?6E2Qrp^zXo;7QQ)BcE_$XGhFZjA+%_d_9MuVBb041vu9 zT0<90zE?@Or<1LPHUsbaTv3jl~g2YwSH)yFHrGZT(~e9(ZM#7j|;_*u^$ZP z<^0eab!8k|vOL{9^eH(CQfA3Pi$U$qpo*Oup678-r^+EtwAHGz7wNrfv7q3DkXod% zzK*-kTq9p5VIJT?frKVQjfWECohP3WeRCeljChdX>tN@gU7|M2^WvT*@W`b}+Gd{= zW3&xMR4u7?F-`u|53WG|p%ct4pvwE0s3DO-&yYl6{iN|Oi-w6PmQsio9b1RsOZmH} zPlY^AlN7{=KtT2qJDSEfpHEk0dQ&Q#L zycpn?OX~*ZW4Pludz>98MWVRaK9L&0=A7wPi zWQq=O45NG6kPe}&?}_i;cQH8Yr07>kO=SM%xNL;r3nSX9B3XuM^=CbprC2JtK85Pm zt!8Zny)<|J2JshRu#P&=4Vx$C3I^|VhwaW-w_nvgGbuWt-<1bobB2R$r+lSe;Pnps z%X#`W)w&sC4)`vjh=9y!td})|W%Rb~Ko3;6bPU_(@lpdWe1#~ltCK0-L0!S#$G^6E zjW150i6XWkycv!xJ4Ns&ei}S_+%&0F@4W>1JQ_NoTpr^Uz|65gSIEVzI*>Ae99XCy zipT=R2ueT6$r_KWgFX6~5QN7fufT7|D4n(YA#M#ION0^xwyD`D_yUo$Z|qug1~h0R zE0RjI{_Tjgwkh@dXR}{kGTO;C41Oj=4SuOFfdAPn%3+n*xCCpd9yc*;<#wXlm;9Wr z!;);#9=j;l&J1;UWeh=w`bt(+A@16P@FRaQhArh_vYxb#yP!;y1hv7^;;G=x=!(nJ zE7BK}6S16)G%D^=m{eaIdpoErAk~o7`K3+Ex;LpWx0-k4E~Za2g}(Z}3V7&r?03Sj zo#JkCMZj{x5QNFA9k?qu_39?_LVv!y9t$&>h0-BqDu?6w%WKC9X@gdY^9So@iT;Z!yXE^w zbkOK0V0&m7e;3*aV|NL%lohuaVg4rRNj-Zlzs}2+2Jlf^=Y19a^TK%7U(t&;$-Hq}c(eZbJ1VN~W@m-B= zCng%BZ8lKM^`$Vo#3H(P&vTQ5-egLBc>CULYzj9RYl)6T1|jg^!B@17cSUUIRS z6(o|OM~x5Y-Bq!WI^zj<)6jrW$e`{%{!9RUgrRw~<@?=WvS+*h{Kyxqe@R`X%Pzz1%4dUDy(Bj3eGDho@NLzJtQ_op-q`pyFNQGR2hE&t{V@A z2E0V^2PZX(ek;w>37p@T5Y%RgB&z+fd@duH$%4g$Ho@rAQ1+@}j zqDN z;KE$m({zU|ZH~O&D9Cp9khuHYgrh?0FAWia(~vdc4_!MeiuR*&LxsVuCq@~ZaSTeK zE{b6e5`8PE*o0s5NI*K$&nJzA3oIO%oBYT|wy1Pfs)2_G9c=(l+QYqqna@GwjcGT)m z>M!L+_Y(vf7@w1%(qAGY74Vn*>J7W8C*=#mo|5c!)`;PyS_@L)sI`Bqh@5VOSAnd7 ztIhk_n+~Mxn+o63q-h(KU6N1YTwV^XS1Utlc(nZ`GsY@sR3G6ucyFZ%GvwamTlGV7fnhDMP=>LJkQ#fCJ6^)uny@ zafCyZ;M@DBq!Buhj9wvjjoF^+q9_WX8#dfuewFIwWVQ{sQIyJ_#~K`BTB{m3$;AD{ zdgt$Mp`$MuBiE;fcoO_G_}Pa;?Co@10dCbuSG7MCe)&o5LUVWBSP9yh$6yC;#wFov z{RHDzY;fGDmoqXTJ3mW1c(^9)eg#*o1vwQ@d-I>KVZD7)i;7~cLKs^@5h-?+Y_t~O zHd$!dMOE#kA2(%*lTGR_V6f!IXaTJoR8=mdO(!D;C1tN>h}sQ9k>~Z zANJ5&noJgOtmxnW(Q(yA+%TYQvvg`ZVcWjG_t0a@5!)tySUzHrzIylL{q)Xj#ZSP? zxcC*nu)khBFmP>C#@klj{)yBFVgTK0oN?r^7kw3yq&IxlIzYQbHD@>Fje_6GUhK&t za5AE7g&9tVi9-Y%j?`vp^S4hkmfyK7EnLyRLyk64`5#1!rFt&ssgr5 z-APt=*Iw(7ClJvK7pnxr^2jmHNfziJ{B);h3y&n9@va;4i&y$A-POjnY41LehaJyU zfveRz7!k&%o7zRgUsg95!$s>WJ_4t`nX0`55OG}a*GZ!PZuyf}L2@$}l0-xBqT90S z0=|)yH?`%o3Z8GxL{P-_m4bDt`HoCKqLaal)k^YrOS>hp@cE`I4AIaStoLhZ^_&(> zyVMYtl_`q2*ckAold?JSk_ptFKiS22Xlauwm@!Xp(2KZq7nLY{vsmNA zBP#t9~;I#SQ(HDHa&VC2OESpQ>r8}%n1t)@9b_3wK>WPseb~tN@=qngZnSEsR z){w)7K={)$1CH+;Hc84pL7amCdcusLjBoaYHoNxY}eLw$H6oTl1txu$oghyj;+UXS$( zOjzQ#Gh4hQ7Pcz%)?s|3paK4$^`>C4QloWnYy5Z%SzqEEDq1dD91H5V4@I=vb4ux_ zQcC?-={*p22on$atkxPuGGu9Z^-$pcy7})0c$tLl8S_^HXNe-fi=HbLEa`>coShid zeSHSF#?uB4H8|G@D8wW5jj%D5R$2#$+b#U7pyO(=?IgN6P%n@V{LGRI#KQGrZo_T)Na1#r*LxC{Coafa#*ze_#FR| zdi6e zHSk%2ky{{WGQV`f^lyuVCZ)qvY{FwfTU|g>E@zN5vQ3{ThF_d3)D0BIPXnFYS$hsR z7fnf7jEjok++x^9e0c$!TLi5V?(6Pvk_zE~3%siK?uUds{Io=by{lwTBu#mh-dfx? z65CVIK}5Elk9U~{Z<|GUqLXDgT-xyB{AtLa4v4>!HS|`pHu@u3SF&#?-a^2pDPOxG z;)49@93ahqx!GI=q@wo*R@W<3J(@?6x4jc!f}nyp%kq0^1Nb6;h4F$F4rnuPuHc7q z%e1fE&%0}KF}I{W8$h!d%TI#gXyjB?-G6H&)CiO-a{}6xr7%Tcw5p8K=C5_JjhEeHO{YD!GQ<{|F_R~@ zODVx)x~vP|W#1rwd~+~)ex~!$);WtdS$to)zh>b{jB>;4V{Vw1D0dc=?!@+oTk7EU zd&AizrOUO`U2n};$Gw8ByGFhJHZw+idg50Wz03RpV3+_U1>-5`g*g7B2oDZ_8`sCr zlSh)r=Z9xO!R{m>2(rLQMT~z)#lKY&jot`{_9Fp)$^oN{W}szuyarNYVoqjBis!Lo z(`TY7y}Ilhj_~Xx?#&Y#9szuO4~JM(^XeFvrP6SO@)Td22!mQWS#S@oJAx`x9uILt z8{0s_>NU>N;~ZLHIT|dKl#l@@H*WcZX?an2;q8A_&0-LEJmMI3;>GizKRDW`sT#=G zxBIxe=8?`&SZTl;o)l5)-Z<6zq9&Bhw7`noRYsLX&94|O0-CcXrd2WccQG~ zK8u{PUGQk0Oa*b9178B#41;vZ*(i+x=1#L0oy41&uUG1*{Izq&zkk<|Ki9Mn&lPpA zy950pT`lQKdO6e4g>{sJS}QTOxbL*D-0r{BGnoDX-+)a z-a@K#KMnUWODF*w)0QbEsWkJD+_eC+@c`3dqUZIeMjo8$u-kdQJbKhZbLQ)&Us>22 z8-=2N+T2nT_ddJ|FPoP6R1h!1(8K!U_eQJ;!_Na0;fMtX0oytce+d>t>0e)hVtibW zoa2IHe{j6gk5eD8tL=|kaZ9wpi2gR@hC2qs>bRrU|2uP3mPfnGe^S<)>dniqfNU}6 zyH>50e8jj9=Mr;B9zT5A2$2P?v$cXC^zU+^JL5de_ND+-Duaki4)LTzWT^gnY>CwG zf>E4IB%ff(A?;~S+S`*QpeoT82Vw9j12~in^cm{RJ|MwwV;+QUxiMzL_}LRrgd2mD zyo~5z68$SS2gL3IV2=Qy1GJ2RG7ieas~LM+0ouUYG>2b)T4ZHfv$E7PWHu5-KUHI7 zNA=nJi5&=YS2964#-7dh?d<)nnZC1d#+|?^dlL0N_sUm*gB*j>t5~tVotpiSw^l8* z^oK*NIMYbcQE)ncg%z^IgD}2Jvizd&oV)r^(-W2mAzB71bxto$;?$Vy5?bF6&pT@= zXRj&8xTs>>0XWmYuY$eU@ilz*1;2PkhQ{<#2QBP6lU1WatKW7BOjo7ZOK|s>vZwbA z11UPdNp{V3Zy#@euB!QhS#tq2%{n|vV1xt83Mwslm?dgtJ!gx5QK0UIX=?oA^~%yk z?%oOy(vydl9(PV8K4mw%yg9i=eJsGZD5m5h8C6k+P7bFMZ^=WWC*|@oW5N`G2GrF4 z`riGyoNHJ^I~c|ExUHK_fVFQSrCp+F7Ux*9oA2Vae_7^Av!|6LExyo=I*`NR1)159 z0Au!bog{OU*n`Weg&s)s{7-8d03VN5zKttt5kj80 zNB4eLsr}0w=JG??Vk}RtQyx;bVQpBSD=b3@VjpC~l$h6!-^9${J9r^HnGO^EF12Jhb9;RTF0Gr>C z9`fFR|AoGBIVwqBVjy?-T>(G^f@Zx?5~;$-#DGm|UpCP^dJS`-Zt==ud}93+a!@r} zM&mnbpIK{_Py8V93bb?jS2rS2h0)Z&Pj&Mv;m*uLu^vrU_g_fecLbYH^^(={^FFG)oBQ2i;+f&iS8%k2-g;mY#F9Hk=m1MQ58b&58J5 z;}DqkrJm;H*f*P{myVj&kYeR;sYX$@Yk)RvBq46Ru5q4DsUkELKwCIAX&dHmWTGrZ(vop3yy(OQ*q_w+rN~Ax}BTrj8 zqmBP8BU_LW9XA@1^*0waV@k2&D(v@Engp`5BR?{}gjM$j5S=MSDD6N0)^pfDcgD71 zQ}#}@Ay1LTl9H$ED%?2mNc&yI=(v0Cd^+)Fa;^Kwe@2c?**6-5NfN(kohuMCMqY<6 z5dbazeDdInViEc|8F4lGIdbVU(+4*0`k`-9+&69N^0Isl7(M)&D;2Kga-A?TgG{zU0z=I-_$`H;OD z5;pPH(S1>xBP?j=I=D_)cfjmnYxC7w+1k6s<#@JxqR1XnsRR2bubNfqDJrgG!j4Y5 zJP1kONEj1Nu`5TcA5gybHNk{F??75NODWz{ZQalRqdrTK4#Xkg;hdp|3zCJsV|_6d zTlIsmh59SHj#*@Q15$(8_0`Ug*q&u9HynERh|dj8b4YmgFP%O%*v;wx9}$EpXmEmX zc+q`b;T9OS7VlMa-(GZrT|Zcxm%Srn5t}0BuwtmefX^`aiak+d$i;eDJd2%jiqId( zyT?5wOR;=my*BVv%YQM16(SGK)7>dE_SN(+y;AS6>77<&6o(u?#)F1{%hX0SB9%V% zg`d+k^p_&!Wc@=CCJ4uZ2=U&b;VThZ@Rdi0`>EiSuqEurI3C7YlrPT99t@3>Gzvl< zhE2yDfk(4XV{a+$f7E+@tD@U6s|OFS5ib{WQ|N)#*-hye%?G!wvl=Xj=Py{dZl?(J zwVt`_fFaTON|(VDf`k(AJXZF9=;pDJn_R<%FD&2#A#}yhl-yuqMMwvU^wU9&Gc!;f* zy4~wNR_o{@CdsJm@2?#@erGnm`NO$@T&HLrjr%uNB4rk$Pn zfHn*p7Y|7Ohqk+>qfPlJnM39jYT&+)Mw>EOsbG!2a*zx4EX!r=&!Mu}&rT=vVgcQXB0~lt+yqlKRBRO(}mj*f>pl`#KEl z2OpQA;t#I&xSj|@r}Q~1G$z}-EzccX{5>jnrt}GdL%VGyy21@|_SInV1H=Z_2)ARZr4^E*+rzN{>z5e8R6Bmr2iCS!1z(0=&Nxq5!2iL07|G5ZQyAZ;(k+Ysw#dm;z~Gi5lnue8 z`A3c>`Ti?tDk}aUmCOwe45fRje=fJ%`gB-BtlOK6`~-xzlh!Z~0V_;-X-ipXXV9WIL#p}#^@jHO} z;~MAi@3D*@&D!8^k-kNR$V)O9IN#E90Raf7IZ085K zLt5b(z2i%Hq^S{H9d}jWBc@?wZ(zt*zZR>bKDfeWJmy7V$_nT368-q>CWi~7^5ey$L{$@O*vmmO zosZ$@@AIPz4~%v&@pzA-dWc=kP<<|MQg+|+^iPrHw{r6bF9-@WO(E{Qa*v1_+lp1} z|IlwdaGj#gCp)t>ZLp)$_z^-H{1N4Cce0HhK4cpDVX$BEqrl~$dPGW_04u$NQz3oIR+RteF=_bN)!clw!EpsDS|vz1Gy4 z9;pXqU3qrYcO_|`3v{Rg`516W-nE*d0`s66H@#k_s)nKU`oUlXTc-z1J8K8Ywc7%gd}9<1>@s6BR@yUW zJ+)V!31?16Hvck&=v7OB7tVzR0^2|$24b?SxpQ$Ci=2M^*exgol5v$lprzT?5@tEW zeyZfmGV5IH$)8}0wYCHj1>v`(Y#S)$Y2Az)6I0CzUs=zO!}#73n*#P{Unl5#cjFQj zi<-l(Xal3CTaJ$Ki_qlyGlIqx1Q#rZiL1CPT(0;okFW(PUnQe2G%08!38BPE2TxVO z9>Mxi1HVRnLbmM-=P6AuW`=PW%mDphksm& zn1^L+&xk;&BmmtsJtAJjUT)+}40NpFHNEdnN78HAXR$%*woubp_~2vJ`hF zlakB}0&Op6&EHo_S(dA}*2J}`p5YJ9`?9e(iU=vV(;3YIj2Au;cQhi&=4g;x{Dr(K z?CK92NM+tPKPJs0w`2N)4UgDw0BPt3mDIK`F7`gAoDZ*K1dFEC8I792_SaU}kP7UI zzQl0e(0}*Kt%K09Nd_K!-Y4EjWB=EgXl)0zV>*6bb%O|dya80!05d1?SR_}3Qt~W{ z!Flrw1tCZ9IgZC4e27nz8d21f`}-8>^tk|WXXAYRIsQe+U?w+cpG7?swbdXff#bsv z_#^4q|3uWXW+nCqB;av;igd|8zC>#9Gq=9PZQHHYV}!;S|8(<1oQ%+4*ud%+-*$+6 zt_-kQI<$MTl&6Mp;^XPda3ioHV6JVWrSHkse(kyXKtekJ?_*$_z=Z;H5nT=8lFH%+ zmg<-YKx>Z67m%Xj(RM7}xv!9X)gR+x?v*s>ZfVkc@VzQs_+^IY^MM)jxM}$#0^Dmk zgZLO;MEkXp>fPZFypJ_$>}L&@c1%ffUKRK$mhE{Bw=o3c1J(GJn zAKBXXkp6Or62HoJ2OQ6N1iSIwn_y_`@Dqcayt=Ju&5S#5sdOuZt3I|W-{m7%9~UmCXWQ895%v@ zh$y2B6^GkLpEH<0p?sq4fMYY}b)YHJrntM+fj_UEpr1}R{z%Ul>)Jv{Q=vGRWy&A& zasW<@Gv<2e7FSL!OoKlt__W{!&PlJgH*JcirrT4OB!dp%O&s6IIV%YD+x1EDN3qi$ z{63^*ks(6|?g{{*v)?sfnvi${U(}9t!AgH=P$HTu3BOUhSLiAWf381%$lFImG~Bxs zLCW(^!Xc4d$(_Y{VY0i-8CPcPlf2&Wb;RSf`M#v6IR!>RYde&Vd0e95&Dw^@BHmR> zA4&pkD4nEylsMo1Pz$1anQ-Iv;o9ArCF1Hs=uWtXTumpxkBjxWa-6wK?)cI4VmLB8 zraD73cE!fzWa|kIk)HUOla)BV8O^LiDJSV`cL|1_?n0yGU#F|8xPqIS{SixE2>rb-Nto`)OKEA*GJOamGuYfIJz`7_<(_)yB#7@%KXkX? zB-43_HthkFhv`MYNSa#3(RkF754u4>gFoTfa$`CAl=ga$v>9pg5TE3u@+kX__4hw) z8k|teG&~xr9IOa0Tag1($frO*P7G%K^I6)9RI=n;5_c9K_^?`goQ){i1bf@!D>derG{2R4k&CjI43QFl}?9+RZAkCYD|z*}-0 z2y`Vz0WryOSigRh7fP&$^sOK34`4L=XxgSktzCrh$BjrA7qnd)sxLv9FL-emj2+~K zAh1ko@l+4(_{!# zD!3Xu3xBp%|4oIhqttaxc<_E34*!v3Z3ct_ll{mNyi1azMx^8y2{9QTV=ipVv64*l`+%0N1)sFg^ zy!}>HChS>WO{sgzQhNDWv;qzrb^5Xg@A*Mw16}!zIbHbBf1Z;DJ?#vCm;C(*Pn%X7#ZA=SWpM;?OUx6 z;{o-#aQL`XAist4WsYXL<(5>;p86sxMeiyAKDYbBE1Kp_?1lp5XXk2Ir`bx$X4d0k zzr}AO{tvIX_MAHzo^rw4iRkJ+QD%qBz(80&t=3EZ6i;7wD@+%Og6XU8d}E}}p)w?E z=V{L`@-M|S%3El_bKf@S*88uTcwM3uUG+@=*!vnb-T~s!H0t7!Pdv@}4HZ(ZfMGHz zyIK6{JQnX~evK=)Bh5OXNH0|3t#Dbnr%lL~m(Bq-y5DjU2|^Yt)huJNQf-eo3m8aX zM%;wv)-70<a8+XYmUKD|adNx0}Nh zZ^5Kzg4u4DWqZKV#Ydw^|5K~@dh&ynF57pATW#IZSEb~DSo;Y@H&rjPP1Ly<{JMowLBa1Y`U7JG2+pG$L zyV#v)E0HyvG!~WUpeGkh6TI^ak%T8;V3|`D6jD9YF$c5-2=I@B?{J_Ed0xuro*XYB zfm%LYlEn)E9zQo#+`+G0ot)*^rvH;-@jOB~4;^F0@8N-2ye0hWImG7;8`7ho-|{`y z?{Z-+^G)5*;hxjOj(#z)caMoS2MwfH`q9}>BY9)r!h3SUP0T)a+h3;^*u<%NG=#PP zN^7PLW4$?TJ!3BaBP|~!YPa*Up;afxiZ6($zj(9-Si%l7iz@b=ik13n!7ItG*1*_{ zmh-Br=|6np-Uanp6pLT|4Dnd!A6dD(Z(_ve-0~Q;7q74lD*}h$D3kl<9;8pE{}rGj zL5Ah?A6fY}!}2=R$EaAYhPv&)=tRZO@QH#Czx5#))>&HG#WdwKl|+S^I`9aKq^$#( z28TY9Hzwc1`rO+psO{CVo`FW7)%!YaZDCC_SkV)IGgVm4;5F-aKqn$7AZmWCb-dzp zOD-rKh}y!_O^$RLLMl&jGd`5wf_8KtBu@mj5Hg!c>WJjGloKOeyq&Eg0ue?p+br zNV0BJ2(%i=6R+K+?)-<>aPF_ykft4Y4PUlh5aI!|q2&L8*|1c87M^3VabF_2x0B42 zc`U~;Z)eT;06`HG8q?LIKx&6r~9;^_r2G2LcZ{#Xt5|9@Bw3;tLQEC0V(4GaHo ztcLJp^nVkH?aL`}t6{k8=K@Yxvpfnh=cW4aILP6&loXWQpc+^N3u6BSEM^SciwL(G z=Kf^!md-C3S?b}5AOzr{BU z<%ioVuY`!ygF{YP;0?z>T1Ew<1P}puX`*|bfYkq#CbCl@Y~O9nnosWYQUpT!!7WJdULp1(CWNDX| zt~U&taeNRC>(m_YEREd}gov4$tHmU}Rf6lw`$CUH8hZlj{;#z-@YD(d{{)pSJp#W@ zHaq7uKwVLT9_54}1td&n}~0mAv~23CaOj3zz1@=7MvRY)gJW zfzqohx&@+BzGnGf;#kLt46+3NrBv+a%W3=zX5`fMYc^Cgs&KL~5|@L8E;12)_pHM_11Zwhh~5R!hpr1 z9CFb8X8%IAIw1A0POE9Zl^Fx(39R8{oIG~@ug=MU`0DyUDs5g&d3iiZO|y}WC~*(0 ze6VV_x@GHc&ZAFkxz7N$pW-wAk6ABo^p~4+(Qn@4>@+wTxAOkwyD%4vne|n;Rd4W6 zM}^Tfj1s+*wFq!=x=$*vem@#Q|DJos8IbIrd*&iQ0O!ok0*uM=L!a71n0o8Q5dv?m zc3)mYa?FvF!noXkK)e4z*=?Ap7+6zQq ztw?V>{b&mbY)G1VRe@AqW-G4p z?0&YNoN}iksz{_u9XzPu31D9Dyvg1V#l2a!n7trZ+x`69B4e!JpV&r4?N;8w8X6 z@VZwn)F>c|17E1n<1j0y_nYpETyh5KNb&L_tGXuDpx;Q^XvLzFA&GMiR#k zloXC}`t31L>-*OuS4iM-8=Cm7jz}bpk|OA?k0hURQ}|y;|0E?I<9Q%m!IuiIx$xmf za8Dfn#1*)Y&g~Y#TynVv0|M#^7d^s{#L2I(5ioZwf!lqY$AS{U@FX@pag5#`3z4x2 zEqoqy67MpElid;IyuU+-a0M7EF3_RuIw1rqfuW!Pt?5xEuE&(IHX9=2Z+>tXI7eRh z3jXT&dCj%aADxh{2$A4F&zXSCNdGnPeAMO?d86rCu+<}{{6ZC zIK?UXLJKSyTp`CI5O#7g|D^WSmIlE9_&vY+JqG>8Q?b$rfmf~dw}*C5-v1t60PIqa zmp?pm5DQ-p*nxK@CtHJG?m^jtXoWW3pIhd@b;m|(@L2=cl6VJub$#v%-%3~kJ;Cv0j4# zAc>6~K^1~QPNYGyex|_wnxqvOguGyZ@4B9O8uE8);4##dpFS1yafidy zD7+p-=oQ@jg>bdj6>+(@8L_uX;PIzkSX`gx-NUEgpJ&S#km8GX=7)N~{G}$=NC3$k z{#qXm`bS2V$Bhp8XQgDpU;g)Loe2dkxRFOb&;VxsDSR887Zf;0P?8;S!g+@+grXy|p7-`h7)eBC{$Ho&M+t z4clAWv*!eT_t(W3hG?d_Lj(Aj(BLru>P5Z(mly!aZ496U!~hVMKaZfR zaV8>-Czhek8zL^8d;01LY-Hf5eK>==QdSh586PUi%DX^ujK1wNlBL=9Q%&$?09Q$~ z%Ek0v3sIBB=7wQOTha|{n#1pcLmj}TAL%IsPs6acH-b##lbrEh2qPvlTp+z#(Rj*4 zxQ#zF@M1!>@(BhVgy>yvUceO4TMWk-(vnrJCZ0G?PS9f$eP7Vr&(?-!rg+ZMwGv`dky zdl*;JhS8Gog}HpIz^ISrZzapX<*II}1s4VD76M-hq!@gs>ozF5`Mf0dO{}l)`Kh&< za@4-e$?#lj7#W~yX2y}13O-TPSJVRs7w~@xXw0e(+KRMr&;9mEX2~<<;dMK>75+d5 z05^6de{vk|QG-)8uIt+6GhrVp*TA(q1}rZxeQCU$zc4m>Zb`(Oa*mwLxO@Rzjiz`c z)}E!w$}PT7347l_Oq+Y=D0^`2@<0VXG5O7ssmt=`wKtyzY*_;|Z2xqONRC#3gcvyg z`~yi?69}AL`wV_pb^9Piz~U3G?y9gs-=(6ro6l49hA*y+%)MmUghWJE8!3$Pb<0l@ zlxyoRaSJHKeUPx4%;dtwsdO1!m^HfN@e{54;|d z+GAqx@}k2h(!B0tnaaG8U-_~}w1JaZ zXU8=}gZ&(BCb31Jwr5r^|ca*v8e)z>%TWQVB zlSvxbKQVxq`6>MJo9`6QlKt2z=wT-d7mL2u*5KVpviUP0^qu{Bb~U#5SN#L=P>YAK zyc77sxQ&SP-Xg0QJRSP;VCGofj-5YlIR|I{@5Ta@YX4PZ*V_;`P0mbHo_E^4om=Yu zy(I$dP%0$^G-~Vbj17QrLjhO1tIw>RQeiL;Q4ptUpnL~=;B?y z|8+Drg^{gS+g#FFyn zS`(fM{f%@U+tbt12#GZyoo{S9q&s04(5SSz30o}Z zYM%Z%J&12+!;Skh6zAHXjJAGnRf1R6Y@S!hCg|7qe~ueo496ipc*c7v#Rsh}Fa;b> z!-HEN{~{_S()-)<(;*{wZs(jJ$Re3{8jIjx12owkBNQPn0LCZsb$ig8noFbta|vQ- zGgy-Zfd~*Jun@o)llt7?L83_cVv$M`3{`;5ab#6j-SaG~+YemE|^w$zw+^kY-Kl4yLS2nvk*--qr0 zL_%vA_MkS1&r39unI&NiTXx;s_HTdDObvF`ggnrf`+``>sph5Y%*twMscB(E%z+pG!27iB` zxipfgNWDboX&1vyuf;+9_O+|VI!T0k%zU19t)yXoKsQ9cH8ddzMkFS*KQJzJl`DTI zHs6ryZ0!RH*0=l9=L;9meL3PT$h_lWxb1ll_1T)3+OI6_h@(XSnJ8cvxW{8@ zJ!x+L-Y0wW+px?B94B>(BJz{UA11X*bnM~X)57kOai|-a>Fh(HP)2ubZ8N&e*Ov-$ z>#231;+6^(ad|S+()yK$6klxsOEQ7z)^W1U$EhORE7nj3&*&OzRK&E99^E?rNlF&8 z*zKpXhPO3#l7qz1VZFsbzS&>u4M55J&hhR>Ig#C?G!;EbOpI(N<(+^`WlQdQOHLD+ z8AHQ*t;Sfd*8K_-eY^?T2f=fV`CA`G*S~&DA?Mo~TF)GC)@ihg=3pi_FMMFRbfO(e z;WZHD<yMAL`noM@@$3j}Cc4D?&zw=^^#vSBB{a?n1b?OfWz;YF<9!pDj3VFR# z2Ab)#TEEh*#VecwbI13~q7x^3s`8*52Fh7#!YI2>0(%-wpwib_-VO;?EcPWO;y~vs zX5|3T03rr$sQ)z69^N(JzdVH#y=1Ot!xgi)jHdTiCZ$@V+%>she;v(cnruy2+efwE z`N=vE`i9EzvH91cJHG!J$O6S7R?l2&q64MqX}OLE{6wr(MnkXUi?p;}%(e~Q<)H;$ zt^BaL3m?d9wC&up!9s(<3PZ_gKswDzqlIuDj!Au}Eb8~ur2hyTOao0Jr!6Ow=~D`m z&Y^9H1Bj9-E_4AYAkny=4c$-&H}8+@lRuqMrtbdV0E6p8~xzhf=X4@(B*_~bYz>}j1?zc1peI`=?uXU19rd4zfALo*~ z0yM`-C5oyS&O#sP<4)O#7pYmgwbEgb`vuQ{Z@sFScBbXI>x=&V`TWVC9m7RGia$eG zE_i(-B4>B28tUAOEbG1{y^ox~Gam7NTlBo|;@}x&T0P~NEvfqvCC0bpdH;?O#>Q&u zg;4W`c(8~Wx6IXIpP@s2$$Jc*``{UUi!F8aKD5L`{qOVU$FPg~lyBsAx$!-n%Byq8A^W``US%+n zoBj1x1;bFcf++gIT~v42){`VV=3POwMDeTn%lFSW?~$bO5nr?r`Bs68#mH7#D) zO#tL!xEX6k6zl@ow~9o6Tb@eFFIMLl43oUUG+QGU%%wCW?j<1Q^0@=`Si{^ zSu@0N=1;z}AQ~6@xl8=(5m{_&eWJ!$eBaWDqb(WY9=+yv3$gjAz>n4VaX3%hx<{mM zblm8c(siH9SM@_|w0pWYeHy}02kc6Do`5Xp$1~GTHhb^ucfIgqWXlF0`nteu!i=6u%c}YIaA+P2&z|62 z3KtC_mVu8ZlyM0b`}%4C94tcq(!gvS#?|i3q<^|ua_Dw#HkoNy9>;EKJ8nesQZ8dt z%Foq?{&uqv^P6|wEb1(y*@uqN5CnC&g8uyLp&{03x&D8GwvKyEsl9)Kwn0^WYKeTG zjsvxHG1_*cL96c+SjV>HhB(J}Q5(JGdzy5gD~IOb8zi8&&+>HF`CeBi(+{-ESQi|6 zhg;%$D7UEZ4Kw9~jUvoCu}#~tNl_zwKRoIk%7bf5YqD{u{vPP&x+fFmH0S&VjWgY+ zewG~$)Uv*_;7V^lO84nG`u2M77M2)U!UF_t7a(*boXS3+vp>aotP>8U=)>QS=Ee?} zxat6Yxu-^Z=!V7Qu)AP&?+zGedk&j#8tI)#IMyUHz}XRxLqW`Pq8?RzMReqCPVm8f zJKRmIK-N|q{oyWab2ILL5fJRdUC!59%0#U<+~~)@0W71S0f&0x@A*K$R!xnkQwene zKn<%5^Is7MdIKqyzCn)q46J{!1{*U9{{ohRBgQ%ZZSC9omr9r8wLebh{5tbB*z1&O z*)og+{ohs=g2;B7v|ttePb*8JeDME5i(9mM-u4nuY?|pfN zc=>0M;JXXeV;BV%T zKWSmijbVmjxd_B+ffxg!IAes;J6H|8eS1Way}2J&j9kX-U&$maT`+0`&3!~WjDflv zZWPYZafDe01a4Hih`=qzwM;x=$rX9r;Y*8AiU#B96hD3VWgoRp(mC?gLxi4FR%!V2SZp8($B|-We-~jb_Buqw1Wg-4kaH0tg=wx4rFWV~EtPAjW?XQZ&-j zyq)`N-9s(csu$TT@@s!ercv8U+KW=;?7mqy4hD|Zu2r0o&({Rm_SfvdI*MF0vf+sn z{5$s!80*BLI~(I&Q^?xg8l_n|f)G7C)-2>J-qqxt>Dl-_#YPt46@ORA+IH`I$n&_% zOUB`4dGnOm=I5#9*{?_7kFHd2#1vpR5WC*7b4SArm4-~Q>H=BoBKnrX6 z}$MAUF-Y_UsO@=X@X4{fJ=En6E1<=A$6*)FE zu+_@=`5J^GC@1>4S~dT5>?g+b#aXxq_01I8nf;$e*7C>U!*ttk=FwDjioW>a zCv550aCUpY?@H+@=b3BIlOG8h3L{VM7FpG|a!S0dzRvFflv0oB?V2YYt=;xW<<1$D zq4{GPiz!dmROIZ%QMMM#E2n)ea)s05B`xDJ%@Jnw#rMofiMSZYaOSY+A7m$>clGx8 zl2Zj(lJVSpdERpIW+&4BcH(ti+<&amupocBtHk$wS|5y)7spBBVnno*NCD!S^LBXd zk^lJJu%k#cB)+#J9C)boCx2U2D^`LH#zIn=tWt*dRsu)uR3EfK-V?@9+ByK>1g>jCh46(+G5kCXNmP%IZJYkZ( z?7HuSuY)g!YzG^bw3(S2W@0?ZpAm8X4CL@3jwJg!Bj)VzYJGh)xtuMeQD&E1a&hCu z*g1(*1^>BHNwSHKz^$N$@|q-}uBQS2xElap1LKsB4gjItmyQYNdaMaVMLy?siCYw- zELkkN8%Z)t{9`rK_e&l$p0n-FD{4yu8=mT6@y)Wjc5cEiqvcZcyYNryIR+mLMkG1D z^dj|EY8ZejjE&M;tCj7Gcm33<2y&VR^0~`|S9Z~p9-_aI?yb!z@KZnR6cMr+xZ`Mm zEWs3BZjnwDU6eM6`N_Q4A+99>HNHPRr)8xSg^v8Q?&4cyzMvt=|b7;;L%Rv&V|^?bdiyM)yiTbqz&|UVE=j#L@BH~0u6OZMXJA<-ZXU9o zGj)E!wk-hDkA<(nuu;XH6nwT|R|Oby0=TJp$lSA~y-&wpXTxRXL4#jjFKumjIkB5% z<i8a$K={}ozeVS@Mc#a zW%$J|sKOkj%hsC|u1+~ky=G9Ag8ks z^Rj+dk}@M~#0ui3E^dG5l^{6YVAFdSqCTKfQ!Hhh%WP(13=5f~= z^4Wl5u<@8?BU?bkHg=pGUu=m_1nWyd*8;AV*rC--=kQXv zcs;}JlP82{9r(+4$HWkXjI*Nx!V7KpAB|r2_YUjoCgRU7>y{MhAMv|kE`T>eCH-sf zbDoPTjB1S^?YnYSCM6b8iF$&+oagtk2$~@zR_%I$jOfcyTR)*WVFNjo$Nl@oQ4p9j z=8Fmm6!!}Xzv{R;CSuiL_Wcy$$C%!5qM@#yGJ%t?O^=LzsfEXh zemO6Pf^)*p3_P4yK*2e_`wI2FE*FQqb7-ERe)_6k(&X_iWYdPvvyr9 z+VO||DqY||zf)R;IeC-d}3WFb#(K0@vF&M4TfC zc4WcMPdQzUfuz1QL_Yc^BnN6kj4aBc0Q(`tI6vRL|}!n#PSG6GHz;E}9P$PXTD3o`>X+(*Pii|XFL zX2`a7*E2_H=QBRJd8LZ15aveoS4V#IFNVuqrtz2&99*3KoG5nwL}km${ZO>oeNHVZBb4$JSJe}BbZ z#OqHv-J>5D^;N6T2`|q_tum}fv767jpZE2Tv*plN@_t7JMb~h(3EDRxIL0)#rB=}m zvAcZ>1gmo90=>{E1)Q&hC`o&6I-YMfZ!!<})YtuZquZ;g%6M>OT9iXEk9>y38qVl8 zy)o8qo=$n3^Fv`(3jP|)J0Dmb&N#7w8(Yx^!T7^oNchF~^{Aul%bXNBakZr0qwtrx z^(6ek^JsUao}Mfn@3PC~cH2Lt9`W26av`w43=vSeeo8Jx(F}j}do<-Qej&%(Vt7mV z1HjD!JRG27?UF|tTrY3jOSUkN4kUPQXuibT4a;6}-^m%EblqelyEBny>d3MJ+PyXI1nUuin?!QH^4x zK6wu8Bh`nRM9o+<1M!)MRQY6D2!j3^r>V2$YCD@=FX;Jv@ln+=F}`~w5s==s94yN? z%=G&t78wAa?`;CS{LBwmz#SVSMcV*w;V=0$*4(Q=@Q$*D5d@$c-tq(|-G_VMA-S~h zV7~60RJyK_tfZy*_Kx`8`tc*1Jrk9{Sl;j3`@7o)7YV&JG0%GP5KLBARBGiq*~}8u z)#9^de692P%vr?;;cy_ldqMvtFBnEy z7opKR(8xV_?+oy45Yz^aRsP_(I}jK0yy(5FfuTdV8N}!91$o22# zOEvmBE;aRAi?^6wwN$~?m{2*o)HBY90LdZr{;C_cW`OuaH>%>{g5opj_pB#zmMZvE zsd-V~vMmUy=Gj(iz#^?3WcTWhMSlw_uJ@om3{Vh~czJIomo5N}+;0Qv=Huw~ktDE~6c2yd z!DQh)QE0&&#U0O5-7(D4%v&C1-KKPUFA<$p;QwCxu#xZ1W^_-vxi@zWT>E)8!BZj1(_=x#G1j?Zu zAy!CX8qtyJ)unH=C&-Qt8%XILiv|_Jat~?{(|W$UxWaz1^?6w4kcB|~(gkVW3TifO zMc+@2^5BJ~(NEj!izVhD6l@1ErI+RfoXB)2#pOZaYV~*XdO=b>#at8p_K5nmiuAOO zGOvD|kQdOu-bvY#FIyM4+WDODuHM5_LHSRX_k6gx-lU?UVNrImZkg1L1;xQy6_hqk zBXFa>?6pxeUHupL3Za5U9)>bBAaJikx^42^#pq#_KzFHvG+*q=5Mk;>orB2Ge0I0U zP+D}(@D&Mrv+l1n17MK=t+0^^)KcEZSb-yw8u%vu@P7loMD74z`1^$a#rIO&PSb7> zn@Cu?;xX28_xUxiZ>%zR?Uwz$;UC0T@vK;?Lco>eRuV^>0tV#!`&a<*Wv3ndcT~?L z^I2w;)L+&sY4I&*R?GMs!#O(03jCIwbf zRdK4TNnD1Um((Lf3`Zjwt$)5v6pVcC}c9bIkUuPC#=s!O> z-}r{{FN7S<>e2E||4+zQ0gWjDa;Oe_@LX%6gFkq)>sT3ZUS3`i!;K?c7XE)BUu0!P z*nqi1>>z*+WOs)jfn7^9NW)E__s8ac^1d~5NEE^1gfnnKAiW!){^A++zomQJ-1$QP zBi)k+z^*}<5(D|^K;Ulull-$giI2^eHVJV@q5S_7i=zcQCsDh4Muu@0q3#Qf8mXQ;3=G5j1e{ zn7e-!#P?i+v7mD@)(m2;6mO*cyAOP0YGnjp6_9cWS+3}BNu$JkTSeeV(pXISZ@dR@ zMz65-&m+W)eHq_8JCIBpcjJl3_dJ)hc7c5FyDUGohLcDAVcIg3#KGYAPad=JLAKP@ zxtFJ2m*1+;%aUoj7nH+-(p(h=J~EjDMixv@1jIz_Nyh{ylzuLmad(Ed*7{VjX} z6M9Ix*9ti-BZjX_D2X6uCMjvJwuB}N0nir){parYmVlI$jaeR8%;vbOBd`*$CyVuB)9i)3i<&(3Zx>9;=5LryV$LrG__jkMB?t8M zUG!3P77H$mpOeg>rj7?%bv0W%Pupnr;F`ithrnuP;_jOpiqBzcKf4a9U#o4kbAAq{ z?%ggId!R-HN;SA7B}2>qzmOf&h-jzl9(B&d;#X9-Oo@(Y1fcTwcyHh;6~@1ZH+0Es zG_ak{DW-;)ecEbM>pA?6Dt+mo;c9izf@Lvis#~~>tE3j>!)B3ZDwdU?(RoNO*lH6J z6ZT1c_;_exj^LG0Rmbqgh5w_eI{8xu{7B9(C9Cwx+fUe5%uqk9(-t>j&1Yi+?e)X={!ZSyKt7D!6diTRW2MpgGSs55D-@hnnKl$$XIcYJD!88*mFzs z@luNA_9B@N&IiliG7kuPM2D{{6d60pBAjVOlDN{Ro`GAELt(8iPSn z=8H4Gh(DVGGJM$9jeFA103NJB+viMPDrc$$(eXQt2eiRyhT=zzM?A9gfo`}XzF%E( z+H*g%?I~bn@8BlS4on!v!$fA?X8<(6AK5N^&J>CH)%QBlgA;nki>+VM)7|>=px>+C zJ}Z=ewi?S@|24`*`@UT!y6^dGOz*a*4@H^?6(YFblUMQhih3$ir^8R5*?UGN zzLE3lef2AZ;*R?Yfzp~jvMs&P8MMb^EkYyOZ5N0}`W^L)3}DaJk&1^TRfDh62B3blh*lR+CwE72o3}n2?kW7U zYO3Z4v1)3=!?FX!xBz!!yFjS>6(@do7$b|u|AcU%T7V=l1Efu`$+;mI4;f|F zTwBTeI%OUEjXh<8sCa%n!!W_Kc*aop*k&%QzuUdK3A#O4_+xN8q$r<~-)8nH{W8hg zB@5$*c8O-JZ1fnM;rRyNCE4_q_JI;hcr-U;avA8HB|kT1k554sJeF&TDE8~$ z@6w}I>0%^nI&*xZ=J><0ynvm*8nfKy`zBBD?cTM1Q8@?SXQmNo<-~)dt2bKt#N3Cz zXWks++GI(+4(gO-f+b-A%-p+lgXrD&o?hUl;xGSXvYkVJ(pA1iH~1+y9Hl<~Q2*fl z5QW?0!Oot78+oY@El(zQ`2!g{afa&;AjV|;P+8i0g1&`E?IS!`F%oMJ=5v*PmoAN| zamk@$G{$Ll{U|ZFSk53THt|GObj0SAnb>Ou6`8*7`Y}+Cl>Z%0Fs4b*&COXm-YF@L z?&L~C($;FW-MO5#EKYmxaOyefU^H$sZt$u;vunOZ!&jjcAqnaqyf_mn+@#pu)yQ?M z&1mx`b!3^9PU#O6a;+$hb$eo%x^L?Xk z!xpn3K1d26WO^mTB4qe_{9w`np;K&$S7}Z&hr=xv2_DIT$}}$%{dJezZKo*O!C#`p zO^;_%lLpp1^7hxpGmxu^J(rB5zIFoBGnEjW$@rz4;1IE0!96Y|?Lqjzbqr z%b$ynX*iX0xz}g;o`;+=|b(oAdP`%sKf>_;Ozj3-yVyd8CRSx#S|qlmJi z771}i?&n>YxCF+_go@vL_vk-(o#qdtg(9^kva(`!zU9re?oIeIM(=*VJFCG|4FuOk z+5dG?%LdKH3^T-gPk0b+;X~D(B-``>b7CRkJmi`C{TT}3TaeGw!$#=~;t^HxNEElB zI-CQ{^Z8oO;K#G+vgKY#MmgF(XHUWOj8(s!1s)iJK|bMw9pzUuabS8Vh5P-hXA6Z$ zP}UmWjHkT`MR}K7v8vR^)UN5JlL?L%NiZgu72+yG`us~|?Z1VmGd-&n&xf)s()7q? zP_H`{(v_w&y=Z;Sa799{lRy`!aAx)+;AUbf-&!BDMq#2mlH7wN=0dOHIR!k%#UqWc z(pM>zTB}9+J}7+UQXm7!N*$b(I^ps&vHNjwZ`%|36eyBWD`ehZ)4SGUFxNj#@0c}W z5J{VDeBP@sq5p#qaE36%(g+2^0daRC>Bey!&{iX0ZCSCtc7?Kc&p!Te){9iMYT{Pg z?~kD~qnN}rVXxChI|$QHQO=8XS3dyHx-kl)?zll2bzp_2zwFK0?Kv}^4DX!H=Cj8< zjmfIqsP&|GldwCLV zMZ}GQd_vIo`?Q>4)fxr@b*MT{Z)*nbv6G=4U%q>def~r1gcbPu*Lo;3?#b7}{Tgx5 z84`*hCu8`>d!e-H;R}{8RvYU#2%bV9hUR+>JxND14&VR2rYa@c=-rnEV&IPu>Ojhz zMggpRmUxF0DVF-fCgr&&cHAJ4-@T3+8OoeW?FJ|MT)Ba0vqNdm7{2tUes;v*HKqvV zqH-iTh7f|9xccTNwLH@$^P3Jgk_z5)toc_sn--N{EW#CA3SX6Ht+b^CvFslSI!<5c ztezDTN9W{I|Gp>hl^u0tMlrTVmDv4ovq5?wGIC52*&hyL7ihWPN|F#luvjBha3Q$r z-X$Q{B@wPaVJ{@Wl7Q0Q)R!PnPvRV_l*&;{({aJwWepakwPV#DtR1`6{JKWQ!Zu0} z!*aB4$^Wpc)qb;o4~~M%mUsOwuglw>uxkFPq1pHKS<=XlE@K22*B4HXXAm)vO=u`F z3qtWF~qGL*jub^yq@q~B(roW zOcS-#ihm!4d4Ydsf-W^>@m`JO;?|2e&mE+op%zEra`54cVvlv&uZU;63HtA<4(Z_E zcOf)9vuFw7dA*wnv7DX{o;i%7A{;*Dg<&rBtt>65IqdRKFI^ZI3e`xOqZg1)n+sRT z5cDwa^fjgQ#fs>^>@nGnTFL-Ue@YFzzvtp3&k;4l*0m3VKO3jJEpj2_uRr$L7OV>R zX-a(hHiqFz@&w_Yv9+*@(zCLuj81mJ27x+&oQl_4h1h7-O2*dBeE9vkDaz1X#m$W* zh-5WuWNTq>VH`hV4B6g9)kl=H>3KaDEVYDkr}B&G0>4ab-KapFv!CO;8WrPpuyOM? zbf`JsVSfTxPT=Y+S2rLL@n+_e@1wojhPE3FqS{<_n+8D^OiakfYy70i3&^PRU`UFe z9)H6$(US?TgT9!_15HBPIbfsJ?-uGR&WMaBj|7C%1y^hrVw*&W4;c-hJyf&6r2^yu zF0CuAihE$KO&RpfI6WTRVehqYgU}0~tU|q`cc(@v^2?!cR(HGY&H>vUxQt5ji|~Z` z*7c60&hQ^QMg7RpUxRI+3P`;z(5?F6X#kX%1n#bdmbb0A{2FR2;ZT`ORYY<%B7`? zodgoN63rq+cW7HY`lUa5<1q*5EJ(u0iO%ZNANbbU5-^hC^ zk$8=n)Iz*Ts~5Zd9sY9CKP~_gIFa*<`yQ1jruZPOL(Q zDJ#H>H8l+tAURtg(=J$7IEU4sj;BYec0I6u8KOy5)=S`QL8tY>G-JPOq^WfjkfhqE zr%I?t;WbUmDch=H(+|H%_VwLXVCP2oy0lW%NNz6LLz`8oP+TxJuw=WCtR@NEmO2X0 z_XZnOg;1S>ECVM6F|bDIyV1=J2Cb{1DpVDFeUpM{Ti8;8v)6`s%_`u|W6k&A&QUt; zC$F64TwYvC#|qmZerP!>vn7qUw-^_?1n*O()gP@q6Q4phW_n7kzm*ULPDSjn;`dEn z&n^GzBX_O300$PkhW2)#a=K?hgO$Kl;bNSbbJj$s@^|(aU27Qv^Bvc0Z@`PJ- za6flT_A(gt(?T~m+v-)U*e1>LKKBLx@BE>Zlk{t=qg_+4P@?=d79axliyt?3sm zVuY06ytC&%(S(2(JOru$p?7khs|Kq3K4*?h_D239rzKfdFOD-B+^X%<RrL7{|bihm&}R zpJ+7>M4^Pfxt^=_>|r#?=1950VfQW|SsW%^RoweUKzBWMfs2EMcm7j*?L+7(yYxBl zIJlMOv`e55Zu6=It%}qCSc`@5u@AEaZ6xpy^{k-5`2GNAcisz{Oy_D5nBtx-A;a}p zM{Lz=l=B><3_#tAnqotn&V9!Xk)VGrGT{%-h6?)lB3l*Q?CG>bENSN0OT8nx=L)@_ zf8mQ&R{O($2lk$?An`dOxOdix6~So_OFa}~g+%|z%#7})qqm;|8{l{3bC z-Z?i|y~&Yp*&QX8r%!rOtmE;`$bcMxOCYfhSb^}vbW&q2g+@3%EQCe~-L<-ml}k_M z4=WjL%gq3|gokb0qYZU*yRixU9GTktUk7fBy~Pw}TJ_yhLaJnkE7w4e7=q6;y@_Kn|*k zQ)&!hAbZVjj{yR0V%zI5?XRMQh^l} zt&?X4k%5>fkJ|&LZZsX%PMKV3(|h8cY$uMw)Wyiqs>X_#^s=V==gI)7h>X(kLTZ~$ z2MxK{EIHL_V7KL^E)w$32%&;^WvPW@?}`4^h}MWN<1UW?g-DzrWv-c46P@(%u|uLX zi6fEf6i-MtPY;oZ|H4SbG;dyr^^0IWhpuR+F+~FOpjV_sdD$!RB;oroHCaZc^}&=; z_f;3O_%i{&4)s?$wdNt#1Ormwir1%>de|}aoEa~d;`{|uvwH(epBkd;w*}PzpjxW5 zgdAISX&J4G%zc&%w}@r~A~oZLC4a(Ag%p)w090EO?+AcuRqFgqYMo}Hgg?RLH<)?D z>uj=4I$weJV#&4)5?3Dg-v&nSR5(LK8e}EV)WFt|nffVQnbT4Csm8`1Vu$ z@v|;|_1J``wa(Z-qtD=z>#zy@(^ukG#_XAGjU?$QlbMZD)x%TQ==2&kxQ2yqkIE0G zHFfeOBF*$a-59n3%Mjbv>xzlbMTaw5bq=?7%2A;|IZHPtU`;IOyKn19yM=rN*e9%W zOFj_5nJtqB>BtXwOazviz%Fr zxN|jBgx1{Dx+cvQF5NTRjQvQgwbX=%aE?-{?IBj5ho^h$f#YR~O5a=9N6D4?A$I$l z(#x)?UrdcE13$@UIoXjNFOx&8KTOt#zi1KOO!7^gAH=;Z7g=3Z=6Z>je0tf%?A9&< z<`31TBI3trZosM?Bp`s`U9t0(Uk4;_X@>0j8SsZDf8C4?gOz4M@;qFTOkapCj?ra! z6`ai$bhaV0ZNl-HY?Ni2sKW?c=h)#0i3oZjgq7Tjc_;JMC@{S1H(2Kf2ndKU_I(`A zPFe+HGuJ=$!P`obK0%S&=NJxO?+wT>BT<|=%^CUpVD!@;cJuIp*nchQ>?x8aKVNk< zz@wsG$l;h+AKlS{CCwyBhK=mN0gZUv9z0UC#=mtGZG6e<*3Zu*tjIndqA(RJR z-N~MU>9=7NZQxaN_Wr^Iev+Z;1->DF6VSGp>T6i`w5xMQ_VWHwS@}`pG_T zj3AGfjP9u-l*`wYmgF?4W<68$7G?qyM}4plHDVjiq0>+GcJ&>WMs7aSU_RPvl;1+< zGmf1jAjfPFhs?`h2b!W_ROeiaKfv>ClKf1zre7_RgI?Ovcpg^6+3B9xlD!MsZ}YT7 zifcZK?VC$WXow3y(`c&=lkR-jWz4=8;6XRBjop}1fni-I$T6?{{1wi=b>!5x;YMqR zJ=}i_OQnm|YRHg?O2NZl!OqsBznU^#QgISF=0dY}x$6KyzSIbJgE1GGyCkc1Oo zecbNlcl{XW9(svA&7&EZ9i`#8N8KJb{V-kfLn!Wzv@ha$L=}?X!;f^6chv*)Q|#5L z7B|U_@MkiPdR7=~j*iq&s(Cin)R-Y1>gm zqSi^iv$k^y++Ghx66%$Aqc%pJShYTUR{3BX=-Lu8Wg{O*zdLQ9QETqAx1ppr?V)Bv z^klfNxB9I7Yu`oN<*M_lC|ibn{M1U9C43^W1vRUtTjc&rB7Z=z{*`6 zySKl$%lPW|xpJUI;5+CIsweUhd5UT5YwbIod^D<^e-uOhL~8vzYKXxsJhfNe3`akO zCAHKalxb>c|0=vYUP}>~>_hDO;p!-C%XRVu4~aG-9COn*rydQ0MNdM`TPaBGGJwwU zhGo#C=pix5k%N`B@Ufb!Cma7_WS+;gYikY+YnC&HU_EX{viZ0%N_*h#$3TnB!upYV zh81qZETg%HCi)-sDfJ;LmlHNQ{Ij^jQ`)&y!zpj`8nUi~fYiG#qV4{Jk_Q%24QsSE zpqs>mQInfC^lPUkX8sA(n{dv0OgL)U^Iu}aOr;r~w72!EN5HZ{Kqk&x0i@blv5)r0 zT(?N?gN{{NgPQ^_u@O44)m#L0YufU*<>s8^YjJxG@>yx(Q$gtTJp3f*81NM@LvPTp z6Y;sA6c*(~a?)&``V+|_ftpJvs z(jwiDf#sQeK2*+H{Sx&y1kCll0cnlm!0Nh-W;5kAAJnu22jhBz7%50LmId9{?BmVX zqek=#;!54;8}n&M7Ro3~34tGe?%Aq)%M)VtkWEwL-O#gNpu^UP_UGE1&zV|KXgIoR zFb2hjz>4JRfR^LN|2)Q$A&fLhuu6CUwY?zLtV8&CNJ#I>ZuazAq~u(4mXmQxIn$w? z>r0c@*1drG`kYir$kLEOf<*|AGI3wj{eB;+A0Y}tbIKFuBRYs6Ye{Wb zAu7fkE_CHApipINNnZ5{GMu>x)~M`7d)S6060(e`>VXV@4ZH>A3t}HGLoc;;PSDdp z817c~Bfv6Eq2f*qj+$<#njA!Ow2iU)$oy^wQZh36(p;}Qa79**O1co6P?h8<_dATw z?F89-Oe(LFAe=+q^4Fzu@4*zj!}?&8n1zQ?f+^a%)**ARn=&yN-K18di4*B?n4`{~ z9m(Jkg)hq>RrDVBVfQ|{rc^a^W*;AK`)_wq^(@@(JYDr{mJ^?N4JpIF`>ZY0#;Bx3 z{pV=EP*ANr6ctT#m?JUOR&5G#ARXZ_LRuD(Vs=j4Y4612owvofwde~8$@?8^!~M{{lSP;=igExS>BTC`8Ri z6cbrlzA3myF z6Ukp8Ix?so$$d?@@hinOOwWaA3GoVq2fuVu%!@l z#*7^8l+e!;jvuKy%^t)dX@tfmCpqr*@!C5mJ=1HYLO_!Oev;_rmlBk65uoMYSg`xV ziqd$jpeDjA+H%eHEM4*9LQ%J(?V;v0hb1Qu{xgzOZ6hJ%J!134!Z|P!@(SO)@UaYD z=XWd23fj}>NhM0|jhN4J?ho-ve&fVoiiFGB!(#kgDFub@eJGLSW=d2Avp3t9b8?~XT5XUI(@hxUZOmVM(gxXZ zL=YT0;q^*9a2GDJ=-Crbu$T}Q`oWMw)lg^k04I_Pjz9eY5P)$>ZX;7E+eCv}zAmZ2 ziDhF$J3M})*8tc8))p&zCPmP zvWBMkAz@Frs+(P<3b@8n7|m4NsaqtUxqS}&O{OOzF!k&(>I5!cDXH}dUhTLph_>SL z{jgCO8n&zYoVQNNVE}Quna{ z4NBSKHx+hv+rZ|lCP7Aha|h9BN@YUed>_;xy^&zd+=AGtwqnX1+b^b3gm{C^4m%6u z;UzLZ`+4!;u=AqnZoowx-t}=fJy{SuI(g~ey6AiM#z!(3D!XLk`a?Qaun#Z@C+Ew8 zQ=atpY(oZ%_Uy%g-!%C9b^U$85oaNZMLloV0gbt!pQcqAc)H4Hz)DSxm6(F?4gFr& zQ*c6kowF4{6bhL8wysw=ToJKP7FUiBK%Dk~Dy$`AJh#n_K40|hn7+Wb1#HHo2SSvO z)*Gw+!2AogsVNUUf9@H;4z^HUyv%ABV{s5x+!&1Oq_BZo`HTHos1k#3kP=68bU@CFMydmRXGtpCrVk&yDz6-IC|sp(brT1|T-ZG5 zp9d$)Xb_C_4p}ym)237YOj<5as;OKL)$b>1h@Z|#*(a329+KQ}T_RHB=G5U#ke1b0 zwOvcpNPt*YJdW{tU_XzcSHZ<6&~C}>mC(o2|7M2ko+xB7xrBHW6&tE5|!f!U?i5APYXR2hx(kY z--iG>Z&jVslc+b_Ug(0#GgLGAT$MvHsKoSh0_scQzVnDu1! zUr;-DH*lKF&=pB)o#^L>06*el4To>#ik?HG(!xRvwM#Y=ILp5PJQRDcb&~6no_9C) z9$Jy%>-#3YQ@~~~a#bZ2k8U8Gt|A-P28>2Ygwc3-|LUqzTtJNbkPJwimEPI70#Wp8 z?x~S0&pl@5!})(?Bj7diTN#u?eT0i}mnBpG)siPq4&mqM@3MdjWe@n^J-IE1+xFhK z2PL1Bes2O=^o?;AsN}6M*|RQ;pGE5h!jvCoV2yJP^%fJdY%Ia$HVKY&jG*$+gn85{ zS#1=Sau$_Aq;5ht!|#C@-5&VKx;RZuN&V<8>4Fu2Y7{|*$VIJlgHix3nT|Cr5~|G_ z3^0}*IgpqY8on>&zfrZ3-jb<=r9$|P0VH9mS*Y$ThC#Ul{A!GVB@_(Lq)ro*KdCxBzMq+_c-ybR2);M zWRwrii|iAXQ=XDyL_nP(#DIRuazw?uLo>?7m}}j79b3`{e`nUOcB`Zpa+SAGq6_HE z#D&y`8=cng4L1yN^IHy0_D`ptH0e0ZQ4cjq)JUwnhIJX|mOy3J6IKcuzOCr||(g2k$`7gZ9PHY2Ntnb;CoziK&B ztk}nODk_oMom-i`gvh0ls`20SaAIK25kjSWUcn1PS;UL|VcXUH`=lqn zNY533ryz1^iHj4RHAF6b8M*`p^6%~_q81Z{xPXmVW+zL)*me)j*EOFzDhd67$-KK9C# zG|>;jd|zlm;3T^t4)Yn01Z}(nm8|KY!E=L?fbO>M`MI&CHf!4g&dhA}tEMbS$)j z*sn7BwZrbq`J87xpO8xWVO+n%-bZza^zHIQDxDam8HpW!tMPs7%0`isb6pCq@a7wTCeF1`G0fv-N?&ABo7>9oI{k~&-mTsb9v-s}QdwL40&x_TPI#FNm=0f^aVQCaH3SulY?UdYtB3FZ|xQx9&4uh5MLv543dqYc`#uLLQ0 zO&OsnUzJwCYOVPUSM zvYWQ;zIvdmOMvVofplNnn}Ng0HbP&ob)p(chc_{sNd{8QR8&hBkB3@pgyU@a_bvfB znbaw%O4^%V2o+NSSBB|EeAlBa;ZxV5#^g+qo`8OwMyT;-f;7-(RROU}DyMIumoda<@y7 z|It^oeGFXclpj*(!T4KYoz>peNDnx>hgK`Be?{gD(3v)+pL9ZjFniU(*bKwQ4iJt5 zCvLnRbp!B}hFUk*^n4d@lXZUgrFKieJ`~-zy`O33Aqj{{@^yY7UZ#&ZkY@F^+m<2A z^W}KqA+F%<$n-K66KXSg{IS>epkZ;9e`vsPAV&GDZ46xrMhVD8|4#c_FIQ)aM|sFg zsU(NITj6-3S}gd>KStOEt|))9uj@8qy}7#bn_lIu41zKqm!J}CR;U)gTr=5vDdp=K z|Lt=eQ^$KuG$%hugfwMzhU5B`-|xnA)8tLVCnFCV)NWIDG3Xteg(9)AhgyPY%)=R` z2U0m5e(4TW{g@D%r@60){{dKltQo&S9}rphh=TKTz(S(mfi&}5gkGGs%jDSGd|_*x zP+KAy`l9JxXxg1E$YjA8M9{&x%+ffKAu!afB>YJ*+u-270~7Iks;pfI?*c;*LCS;~ z&-}pPEHYJ$?#g^^?=r=K+`E;-vOl4<2t&f^$&p{;p7FQhZK7%()xhUNvEKMwM2!d= zQld7gv1KNY09i=V*+0(&!uvjOz{_$U_?1h$01%k%Rgy|ns6}nMXvl9;NHN~TdSw-F z4+*w}smX&D4EU0@JkD673c$U}^0({^%$qD;Ja%bhqQXfw9rz|FMkw0X8yVSV_(d- zGZ4oy2V=Zr;zCB|=DR(oJuJ7d30Cb7o!X4F6BrAb$HbnIi@^5O&S$&-Cez?YZU0H8 zHMux$v46-S-y#wDMNF(HW3>8o9=vK5Lt;utx@RbP0lIPQTUS2EY>=O5nfPT$R`27F z9e{n#vip@d`o<*NNAlVq{%7tu-KSW_nw>`V2W<`U48|S_9JH@#4q&MH^z10C6^}4!! zA4qqVB+*X@SH%AnjNk11F1t>VA)k%!1Y6XBLf8M=Wt`rM6$E2=K3E{@sObd6Va$n! zETRwTvEbWc3?9e=bX<37`DONis6`3oA+9kX7u8#)nLP7-ss@WgcYSY+?NphedR2rg z)KjEeG*|q-FwAphM6wKHGVhzt_n{@kS!1S0;!#G_DIHFW5O*Zr$NL3hzym(Gz#frwfY zaipc4CQK`B^a5A4F9ZHjkS(x=bv`TW7p)Kk72s`Ch>)mv-~#CI@kC8Kwr zWdq?(?(*9{KQ}}7ms_F?0w!x%{~vGX9ZzNB`2Ay(vNMuZSqVi()**!K6$wYlUfJ6r zM9Byl$=+nk<|up1-em7_%)=Sab#&kN_x}B!=lA^eyq99No=_&@H?{asePL&U~>~S)fY}rW!rm!|eXD7sQElCljPf^BMdqCj9ud!-nRVbH zh=}P8trIr(YCD>dFMeWE_c#oeqW7$Iwz(czaxQjVH1vOUa}#1E(S83>R)@SlG)q{s z(^D|q+PUDM_*xKqWM#P&JaOGIKgMAPKPa}dRrQS6Tqi%Mi}bju_mwOKOoP8WrplD6 zE*w9)aoBKAU^{WNo-_Rn!7BU=k{56DzKtyECRqYQ|H@>q1Ujb0sM2(AuYMT2k zd=op;qw>Zxq>5QJz16>A##7gbbL zG~?)qWI3~wVdzmawF@A>6FnesT0$5V`gy(#S-f51UN!E~2^4LBB;)d&ZVi3K zQaW$DY|q~Qco;3YnYp`2{Wx3u)H1>-&@GuPJ7#=ksUuz1WtTR7j zpp5-ql~7pxcacut>Jj#~DJW<5L8qOM&_Talx!T?a0cs)z4(FifBovExj8~Fe0+Ne2 z3$+*9(_XQ;2s{Yu+Fh%A4o`T9SEWB#Fu$+j+!1~Na6=4#wWY^l;qbAQi$NGOvhL-2 z;HTv4cOo^&ZW{Ylumb8)V5Z~>9p4v)iTVFZ8_SV)d*n}p-HcI?3eoq`%2kg$s7rvA zW>S0}rzeB4-n8x?`4e|y)A%U%r5|kAeDRmDvx43iSQ~Ww%^KgR+!CEY5!uv50hT=Fq(5;A7yYG6nQZT2v9`s>)N)AOQ#hw61pCBXPY%%UCQ)kM+W*pT!=pRsg1Ggev#_fJWLdr>03GSm$G6FkS2h$bcuC`3C{a}<$OeqOxVcuXmW#%Ix5sAyb zi}!+kYVsr1?cKjsBfuU{>R$PQy%;uKcU%MPMs9Zjt(f?y%lr=Ho<{dP2mfm?rq-#t z-zMhf@f=o88bpno3eZU~Rz6ATu5j!~QG(@8WByGaEz81^u=J50_lv2y)6rEBGHQ+e zYh|?H29`e7VCmymEPXVW#KTpLLf;p~(no*dDW?C>$2$OhY|gvGvAR5Vs64fiY<;F> z557SzewuI(RuWD$I>BFz*TUnpQ9bdZKf6=*;jht|2l~&a_6y(4KH&F+r1xH#c;|)* zJx`7OEkavaS#}TGks)&lL3W&(ks5Z~r_(hj_!#VBN9id0d!GIq7C)|I@nbE3AAd(* zT*X%&KIg1+F?$a^Zy>>d_Wg@d-`LUbxs=~US|hbf*@}Q!W=FeV=u-HV+2`bg;6#Td zx=873vahBHXTTdbdQ03e@3YZ~SUnkF^c|?r2nI;HqAH|=T~P{Lu+bHdrDx~v95>nB zbt_brE!c5`e_F->igJI9lYsJX{wVz~{y2-_&!`>Sz)i5}E+I+b&rtBn9rcIkR^A$7 zsyXQ-N@O1f;ZJeuXWMnh&&UV4Pn zK7bUu`>}~!@Pzr=8`+W{xhG!)R++GL8nsh>73s zZR|CzC?CEegPX#m*oYz|*tUm?($aub4(!5BQ_U(BVZ)d!J&%Xeq^xpu|Y()(> zbO6N4G&JAX6Ti;?0qP2GUI^5|>QjOInt#0OumG9U7XDw5z?P04td!(}8TTOHqJ>xg zJm&x}uTjI#_pdX%@pZ@W{4Xt;FF*CxCsI6fMny=MnIXj$2Wwt)G>hQN(s^qwaMGLf^}HgBlw!C&_d_8f;!$*wALNOb zM28-4Nc8W{Z-Sk5uHMgf#gAdv;D%=hU$rZ}#&l;bbX+_1!c#`n4;U)$bR2CbVyN`ygqjmCRnm`dPbAPq*)ktZ(5 zD~2p|vamv5$Q}f`(EtybO)q?wA^ZRYy1s0m$yztNlbD1Dx=UL=o79uQ8Lf9NKm_Vb z)g2nPRgQgY2pY636jVu`N%6W396<^sP1ly5rVAQ;7JAdR_(+Zvl=gh!S1WZqo&_gx zZ0yPSPl3`dKYR-4NYK%pna~+tkhCfH_?_qkJpY`p9Uss&68U^90lgn7K4ukWCfszq zTL-=ScR^+dNkR5mUcKv4=Il?`rt6QC$g;OrlW5R=>rqni5UaVdZs@d}^LNfw+&FuHOcY67x6}z6qNZdB6rrH!V zJr4F_OVzg}UZmTUbj)9;u&#aj1;9SdOdq_CZ-Rc!m(N9f?w&@!mO`>w^FRav<+FFdoEN4-j}|Ody*_WK}N#a(MbAta`76| zZL!$U+H>z?v#qnc{rW->;p>?{rCdWTEIfjCqTU#Hd7f(ZAgZ~l9wqo zZP#Wc3L9Ybpbqy|6AR*GLOeiI&S|@E7efJ8`r;l3!&$gfueZ0?n`TjZD zC1fPy&smwQ5h^D{f7BxtEXUbbu$Gvq;gUl}9kz|#bH=_Dqj~Ymh4{wr=`dH1=H)+1 za;L`%3Gdy0H3e`>7a_x^Gm=zg+fhW-e`1o+GR5oa<5y&7!!l0&urbKX|4O&{|P^OAg=is_sh5L{>Cx>vWz8>6d&WJ4q9G_h^pbqE^QNV zzj9A@TOy*%o&2jCbJj4xd43o|L}L>@|7QE!Ej3u77ocGYJFNU`*5vM_Cmsv!*KOqT zcXup5wnkWco*pe;3Q0cxgFWKJCa*HgeFiS2Wv1I^hKXIcK_*ld)p$(-_E8l(!-xBo zWk6amOxg1mytS~A@v{ADP2rW7=Z~n8R(qmvIE-q|c;agcRuvK^TVfB1ruPZINGo`V5dy82$9QSI z?;;}H{nTEP6nwJS(8&EQJo+FTNKE<$iIs*Let!jRhY zz>|;b8rvDJL-UNG`L8UF#B@qplg-6)D)HEX94}|B*6wWTbe33asbF$DJ2qrFLDtqU zp5M9qBQ`(z<@(?UrdM0^gKQc=1yJmEeBt6uE?LoD&oclrQiqZWsn?Zl0{-=Z53u(0 zf$WC?3Bx$T&bj77&|LyzHf3KR`}5v?rpPj~wswo%1~-x{yw;~j3hj$Nkxj0>;R-1YmCws?>)>#iP;u zI)(Cmv;mCju~1b{=L5x)1$Z&^rs7Swp+1BzX=+Sa8`D%?JTcFo!gO&d7c;w@WEtHj z2Owu;UPkl-*h{UR{avC~YTT;R5nryoU#7`AzBoWIK=`~<+w)-QXyQ5l@7ky<=@s|i zmu1a4@yTgyFRq?SpHRm&cS#)hWPeN{&rl1s_54or#oXFhlZ;^Qa$HuqbY(~(n zDDQ+f52owIm;=9t8UHMP$&{u_dKq}UCP8j^C6a%Ik3=G=@us@#BWCU23FA4mX>`&KeeoPeszhXx?qn zt7!f<2zZiZ!@P(!sJ{{Hlk=_TE(z6Q6{1g<p%{zLqZn6W8~+6A3W?S`f+z#j?Q@MyY2ntJAl2y7C4 zM$cbJjm_W2qsf+L>;K|Bwvk%bZ$I-o@qAF-)ClB!?M#SZLueCli@OXFA5A$xt+Hr5 z>9p{1z8nDdCFrsY$+MFCkKJMQd*m^`4QR#q_sgWViUDbfl83F&JTxguvRIM{|#(Ju*40);-wR>{rgz{c>K)p zW<5+5!44;--zuS{Gu3b`V7Y9wba`E&pN8;O4ef^A#$+LJ(^RqEw45J~DT;lG(kdbn z+pl2{Wa(~Xn;p4uIE%f_Dvd@*~{yc2l68|Qz zpL2H+AXYhCTc}1D*W^fdGb6IBP&uQF#(#GZMCnE)1akZ#$=M!-GTW|V}626oyY=^pC0QO>p z2)CbpwT-+IXi)b7PIVZ(kpp=PTfQ;q!9fm*aRYhF`P&L5I?+mYw{Z93GyY^8uRc+d zdEG{0ol#dZn%xOjQq_O)q>?0-e(jW$^sp}e8F1m%5jsnl99r2n)#B|J%irEfQMN}K~qpMs6<;Vnb%>ls@N2quIR?K;u#J?|298czc1 zG0X#X#g6T^GWO34xx;VaoF?!3AQ!^%@kbo~Tg=h)_DMI^A|}B0WAKm4O7sBAXk2pI z2F0c!v01}&2^^e0?v!-Mp;=ogkZfdS65Ug|@*w>sKCZ$0lb`~yw`VH>&S%cqDIF;r zHEV1pawyS-k$z0;7T{WYJ`bCFm@7DG8tA`^hwtLZ3N|b!#+@pZZ>X);5Y(>#;eH`` zbpAOOrd9m+0kOOjdu*=bHDwA7c?G8q;IA%Mx}ts=>6K2!vVi}TV!EAkKRw^QH)QG6 zl@5B)jk_2dJL8mbU}U@*nzf9qjWH;h>F#$NRzhk@;6E7->Tw+uh zin`gY-is4o%=!K7c$XjgCb%;_H|qyNXRxUzsQHsQ>?UaHJ+BxUEi!Qy@>*`CYT~ud zPce?b20$1Bj8LEW>o%I|#^5p1tSm|SP`TO z0z+RRv8zrWDrN)Sc>Rw1O=N~oTwOk{M@1z^puFolxrUZEDD*n~?}bVhb>=#`rT)bZ zx#HE6Q}(DU!&I9u>(2|}%e6Bo`6m((`Dwu9c1pC(8RgAA+2|SD*Zo>%?Z$PV;zrx- zg}|WDW&4^fm0wW83)$?@+;m7h$##(QXlWXp zlzWOjxUF%eUUtX^8EYI2-axcSFkk6tsVDk*Ngc8E>F1E#*KSsaW3HCrH=~s%;)CJC zgTOm-tu2#=L}k0zFQ*F=44*xrbnWq_~__4{ij5)Y>{Yf`Z) zQW_~49p>2L>w&!iY*2nsb&TF+X~K4=C;Xm^HA*_%#7fgzsSj-$ zj}nLi>QG9cxC0(iZU6C*(U?hzVf^!ex9c0}vO3XgEc9`k;h@Q}*IxvoE*2_`D}B8RB3{ zz8K9LS7hdFs%ttx5u>2euZ{B6E`yQMon$1xVl2nMF*myYjTo^t>XoI>#=dK7!e-VM z{$vlZjFA;!jOm*i4GUsCyXYB?0RSi_is5gO;1gFbqzGNX=6@k=M`pH6xZkNVWc?t# zD>H~%)x@R3iKgCYvf$t+OOGu=`k9igl)crvuf1aTdR}`X_00JZSRdA~YarxF^SlrI zIM6;5n%;=LR>-X=CZ>dhh<{;5w$scru_`hF7z=mmcmsz?#oxm5GU3STqgfk!@uy3j zgY8mZGR9qNReWj|56s%nb8L$yX{ttA{^pqqJOe0LN8L7n)2T4FB^3(6_io3pWjOkF z0)sv_Iscj8876#tqHiJE)w^$qUyoXiYSm{Gqhr35jyh@r+E~-tXXQ@$d4qqL^>QPj z8gJV*zFiLI0RG&#%MBh7h{R4pk^EjCJ4lWqu{rOLYyE~qTWLVC69TF?j=lsT&tYW!nDSj+@za< zsUWW1>j2DasMqE-BZAc`D?~892G>X7t~sJ?s0PJLo7X5w0cjep)=&Q`%zT0PYUPre z6yw0+pvYfyR%VCFs|Ehd1aMXr&v+F)3QLZ4{-n!Nby%VLW6!~`X#7@w^1Uy!^Et?9 zO4BZRJBtIMj<~6Ctm`CM*ylcy?Ytt1$KxES5KT|xcOn*)B zutabR_M~I*zO@laRPUPA#iV5V7UhfJmT*sm0kuOTZwK1_pnIs z5bVFeMj%&|kw55xLJmRRiiV#|a;yTd0W@1G8unSy4%a2_|6@@GkdVvkHN{T=1(oJ+ zszw@-F-?dwi$`o(Ki*%6A=M|qv7=KT@M-!|{Q~I9d~p*&9Uym<{tsI`se%68?=|lw z9|jB6rUo;9GA&bkMe88C!_c-IN=cmeiZQ7e+W=w~AYNb0&Sa%KvPNiWyb!m&9hUye z=G0$4OtnT#?4pVFi8p8uaqCJiWU5wehNi9_Moipkrxx9X{{CG2X5rnV&c6Fl3n!WB zU6;IW-Fwaj{WxJCVwBEL4g!rIb@fy%=_HzUDQ@rc+WwK@m@Tvn*pF{#k8zaxJ^o?JRocp3KSb|qs zDmzzpuU&;tXp)YrZcdGX5=dQ*yy)CP3vdIusmd4OA@+qSUT;o;Ri#y+^Q;@poNA<( zS$}GFRc+g29dU!aC@7%HPMi^=~8&r`Y}wWr*XcJn9U`7KEO5^`S&mw>+GJLB%*aNr@9;k8baQY|m}+@}#g zb8X3@19lk4uK_(3w`US=Mst82i~~K~QYu%Jvhu)n(xJ-JQzn!gmYE1{kLQJH1|AksqHrg#S?|AZcSi%_V~cyh+IuJmuwuR zP)aY7#k1%t8#?DU^8gM@A}{jQu&w+BfVPcrbw=k;ZH5kgCofJe~gm7EAYwJ`dtwk)yO)~4ZZe@K9fYaLy}2YW!| zYKrYo4=Ws8+P9EmG0yK{vV^Wn<1@5>jT#0FZy2GXaGsB2w+o{;<|ns4AW(yy>~Y)w z7`L1$M%^MI4SXuAxXYn&NP^)f2dmcM$O}H_v4&%oeZzzat|%J@EQ%}olq+DzY8(HQ zZoE#6j}AXJY5oNc&I;nGGHcq5!3TB<4P(g`Dq=2?`3hXz?w+lp0DriX4e&{c*`)yg zcEhfHc~@X<;*T0KrO>F^{U{?XQ{2c$%=MQFvS+}j8Giu$7_WJj_6c~sX6R2KsfYQ( znid5Gp3sb`V@>nF{0Ka#%JX0Etq8voPRmZU#hRw9rR5DgdJy}(QtYGu+ec|oOi}fu zF%kZV2}>-xjDvU`J1AIAhFg~v%x6oCdj&i3LQBjQON0o%CL;|L8fb~vqYFs<@3FJ` z6$SeL#Imj*0jW9k=Ft(#hjZf2Q3Y;LoyGZd}lt?d1 z*@(He0hIPW>W$n7=K}1@TCwN@=W1|P4%~PNWcPY-af0C!gv9H@E5L_FLq9K*bT&-* zG?zsX3XRHv#s|dfv^#j0FNxs*6cCK$(rR3ZC&9h4Tn1#O05V5_{W^RnD6r3Cg8^@o z-+->gypXhXH7A6FIIkZ9e2I1P-tB}qZ3mM;0RQqFbvPsce5pftcb{y)!>~8HuwO<; zOwwC_drj=Q*8Mvcr$V8z%`Z%VGn?X*e310s)FjZq0A>LImKb8--}BN|tS7{|MuG}6 zolW)^$HOs;h<6_wJ^DC_i?5Rxp}a;dOEH-CUuRPAaFQLS{`DsQKlNQlmXS}nvf710 z01|YT_gl2?#wnF6(0x_$q7`?mtV3TV$JhBVOY89Dr)~6?eQD{Q-0|e;q5IimUqxBd z%m#{lgs;_ShXQB3i-WHtp0)lc5_l8ek@GF`m=lq#uf)X_qbZDVY4Gwi|BC_v1nLhE z8c7|Hk=EWc82B3M>Xg<_onOzP$tIFg-A99}J;at5c8H(dkM94NQIV5znwXey>yg5j zHo60)DgUagKb3qE<3)wb+HqOKxx^;4R!@p&`Yr4Ia(fWu+z8jqv|XO8%)VC{LVSqg zCv6eYMDDjz8V0sT<_h?^VUW+E_vDZFBNR7p2Y(eA&J*72lmVDHQlsNSTs^DQH_kmS-Y+9YYrR|-G2Qj3mWFlJs7Zw?F)!&g+@%)9)emg?Uchkz z6a;t7vhGSHrEz+q1>zsVM7M7FdTq_12xuwooQoNSCtPxO{Okhfc-be_e*%koZJDU8 z$z7R;`7?6mT@$Xvswes$*iF3*J_mTYdzpGO3tV8{(}&7O4kQQ6>VX_LnW|4o#(w7T zO^)#DAc!=xZg{@jd-esAN7v`o@;rvFxjIXht>nD?Wt9#7nJgCW0OJsa1~b(cVJ`kN z9%8N7Uai=2($k98f1E$}sCy}i4K+=iAUTtH&!FuniH~~cU9;F=S;n8n>}l6NN4fVx znZhA}hp3p~h6r`BdLm{#qeGwTz`6=mSjzUVU4Gi-GJ;FAKdbiGG7BESc`P#T&-xk@ViRc` z%RRV7Kdt(f;q>Cnw<^^x;SeZ2=CL_B9jO-9Jsju1%>-8^W!vkM0_uZ(uc=SWX5nT( zuIeEDjK75gku=++9TvCpT#g63l8sT!9Uxn*^3V!qtlnGT%Nj?#Rs;I3a@^1J6wTw6 z=LcK^O44ZHBY#7B!RY3o0=s9t92sKneIJ;qTSs0K z95=ZzQ?Fm50McnK7pV=tl9rG!lWNB&0FmmS*H|1Y$!@n><#4%l9EHoA<<(h5>p}tP z18nVGmKkIbyE&e3{C}Ps&NpBQk;mvkTm9euA$_JSbV)Qk1{l~|IZ(BZld5qwjh^4% zRD67IcY}}|SeO2jM~m7e%~jxV-NSn>vOQ<4hzRFXTUr*`M<}M<;OPM>4$bot;ygj; zbVD1zJFFIz=KNw~rS68-IlH2cLSB0gJ|7Hh1ajItNt=7xGe!x39t)$otoTUC2qyCi`LGH);8eD&s7#2*aQoI(j|&CpTV;LDw=yR0oJepMFL zyUeKJjg>NOs>B3`C8uhG#PGMTj#3s!X#RBTWQ=hzs3$ti2AC4XFj<-F)lx!hK>qXx z>KS!lzdiX)wi>DC zJ=&|MmO=&_JTpxrzV}8zT>`?Lx%MEB=@V~B+}nV=_ZQf$){j0_BXJHTjc2W`JrI$Fx8JCsm_`z^<$A)ihs73xsi;(-9Uy>VR z^fUzD#7!lr5^Q4Jtm!Iy_&%OKb`g%VQrQ3RX5tT|HXOCWT7zWF%)&+Ea1k<<|@6PK^8t9gNxr*<4ZW*6{Eg{l?D8nPm-Cz=FeJV)bp#rK5LK1RIZU_oRI@`?py@@EzARu10KijIe`CQ3+(t^>Qs@*auXeqPwtHll~) z7qGW72q2O%?dA!zb=hY($V~+2O8mJK*5mujNW=mCnRbR}iau|4V>VsK&=U&_=I@iH5Ja(1M|HT`e za|kV*j~o*I%RWq@v)5*7uwWnPY|NfIZLgQg?G)eYmNKnkt^PI|%cuS&SbUbD;s;}D z_;tq5L;IuT%n}|>WCZ7x{M1pp#Dno%&;}HWrLS?N8Y8ejya%0E$2j!OUj;MqR`QVg z3|cG(t7RWky8BFOM zL;tNo)PP^;cL%xg&D%F=3^qCO*N@EdwP4fM?4;dmn;`>IX-BpN;+yezH^HM2C>}pLF7cz{IS+c(e3fD+w!1Iy42_Q+3up^yA)D0(Wse{PVzbA zKsFJ1lQsfIx{>|qG0b2uh(|=3xwEt~GUnLYZsjoEGBvke@@zx!;JijTRq9j_!F&UHfPlt)bFvoPgJH<~SF06|=d-0!^IZSHVqoYRr->_^|js zK98lHwB^Pbmw@%PEna!qIF?3<(Zblx;J6Xq;k~fJJnER48!fQ65=dZ<h((E-0w?d}N$w?v+?Wa-&$am+a(A)(73EZ;y+RpD ziHDWygP;$y^mkP^G;^I#OCbzgVHW#@4{g-T?b`Oin2*Su#TdArB#Ln3hr4fGOTAo1vd-tk*`?+7`?)BjP82@Q#$*^kNUFbtGdeM;BnWGpKq#ZlLgaHz2~{tfnqu1 zOr^RAUl8x%5%A0xyV*APkf%jg-oxN}4_=kFsMgoVg&GBU=HQj9Me@x9h+fxEk5cGsg8s-7z7GUN}V-D_K>HD zKYMn>@`0Qg$sWBE2=VJaT#y~;;@`S{9(xhRu~M3 zvE7pzM|3G11=9v2H02Xmw1N?BAMV4{rGNSyQl}6N)IJN!KS5;>wU@OC9>gs+Bsh6) zCWph$7DW6i)~1`5TVN-gfzyICqIvVf@6FH;)bFDC&qhL^Cv)l~FigkXp4R}6)Ne0F ztw$oCyR(rb2T!3IEO|0PhV-;?Xw4Oa)0Tk`zVbJ}6E%O^V(~IK9uNBjJ|68aVISNl zXV$Phv+ybq9Z^7%dmM2>UVUfk-;4Q*@bz>V;VURUUi}?ggoZpqw5IwhosB zo>gO7M)!(U4u`c@F6y3-Nv){Dw{YjrBr)5^FjhP`pF|ZQsSD9oi?S=ifb%Iy}y)m!kCYq zJ+-@0U88-h@ z>xKL$nO@*r-`>vXW5ENHzC_|L{c_8mg47=rylRE1pKd>joHjo4XQ*cA>o4^EY+s+D z_~iX;>`E4)ortyNJO>VkcRL!r2k|-WBll%JLxJ7T1HkB^J)d9JGf%}wym`OdZE2sR z=SmvLoxJakMUjv>fX}azIIQKjSb*<$Qi0DhAOq-q7T?a#)tv!#wwbrx~xc_FHm&_*Ri}kizveEgNQ-Rc5EVWV^kITjLko?98rf0vk zKmBykorE0DXn*puI2LTXkt-IQV*h5qFdyDFpUU%NZ3d6M`Jj18?=3mW2P%mUjknS$ zQ}{S4qm+fc(=HFcDVVBZm6;1CLVy`Y)i7z3hRotq9q^-f*39d{)i+`d*O;U4dAp)hpI?o5fGO#9yC{Oou7urT@olLdF?BY2UNEXOscG#qr0}gwlVmo@ofp3J%Py_d}V3-(XRki zcvj(NNH3s$sMmhpZRkFtm|>wmdX~}};#ZC)+M{i%MU8?ni6!291yJv2TQVYfoUdMt zudT)Y0_Tq1YkI2jmRREa%%Ll?(ELCve|jf=EBR;CRm@SqgN>gs3l{qEb*Y!SB#AMB zTaTYTRa0-RW*J7!`Pic=ZS4IJr(H9>bO-a^fRERN+RjwZZ`gzpHtq0tW6&6sDS|hy z=ZAV>cH3wh>K1iv(-WR|NqSO=L+Erp-?5m{arD4XB4gx_)Hgmod#J1wQs1kpQY$OD z1E}UmOh=4fY~~)i5_zC5?02j#(yN|&;c0ePO83EqpC*_o{G7kr!L!FE3*q837ieea z%TR?5)a#Wkxi6(B31c{E+b{& zaE*~cW1i0E$zH8q;~jW%>Mozu*@U>U&7{AS>P)o&qpxQfk+8L6mT$fyU%-wO4FUQaC`@W~pUWDcs%`ZpZR_d(P0yq4&tDBIp#^DQ9yR~`@*S>a1 ziU|L`m82#(Q^`dM%asf0nGI&C8Y#C7-#J_j{_caRH$L7PKn}(XH105^{zlP3PLp9` z4#xVu2O)1cA%`h@F@9%TP_EOs$mLEaoc>z{!jwl;x8Hd^(u^yAtt->fO9L* zp}-eig4{`JP4!%@_TzR%X@f&KwtQI{P>L9vI~&slunXt;{cD)BKFe|`@BKc=MF?hi z{`&mk6sH#Xyi|X=`BJ`+#S%;;Ieb*NV&a+Ll{zHpuj=}hr&}*y{%C7?)|kKhqnd}j z(10Djn;vaz^Snx!fjo2ecZ;9A<5kqtL`fmoF$~%ggE2k4Xxt;iOu9>S`gU#NT)+Ri zky~^6%=tDk>>$uRb(d<677-BH=EsR*U~IRLt8=*jx%fr7!QHtoS}>WS$n@g;!^4Y% zS}To~$&~&eSR~id%%i5=02zuSy*7SS@Nhhu{}apkf;RLp?L=h0Ni5?{wl>q)H#%Zt zrhFR0%qF+DIr2^42#bP4vNfT$WybsLeW#eI5HL3Mf10^8Z>B%0UuTEQH9 z<|gY#qA}Wsv?i`*T~qgWckx3O_@;%*ej?mm^09|f!4P=Xltco9>`Pq3;d)ADF19F^2Cv$6`u-S z$Q^xq;lR<)K}2Q%k@N;#1{ngzQ*g57xisx`PmIyM>)iJ2*Rr3aA0lu2wdXgBf$28 zr!ZH;`ohk%yS1Bk;hU`r$&PIw&TmAn2Wsi)X1q>K+|cr9PgE?*{7g-?gk^Tf;o9ba zi#d{^_;BwGO6MP%9|ZlHidW=K5}ExAodLR$HvjTM-jmp)>%fg4ubJ1HXY?^2`r)(! zm9TInLFm8_28sx1y(?Uyl?8DTi5B&eHk|JfvNR-dQ%q-k;;FfSJQ&9aNBF#8JLe4M zCgR6!CFezo<3q?8?uQ}urdRwTY{5PgRWF$w?4o$O+G!qXhv*B|V8HGzlQ^$ONl?zU zNRdx8#0N>=(AMGSsa8GYE8lxLOpaIMwC*&E8mukVcFjSQJ<;X-a){@*9)dGoIcVZg z1zhO82ht`~2wkUr*-zU(!Ig~f+o(T|$PMjmz6e2uCALB3IEbNKF?$-ga13h)5JR|ns7aC6jY8Y56VUJ5#l4fvxl(lI)Aree&H6NQ`b#;Y@$2{ z-l<6S-FrxaaU6%S7r{84zRtrsQ%%2lTJxAQRC4hL>O5Qg9qNFG-sVMD-9G0e=ij#w z&v2CUH&()XP0o9SM>il1O3}Iu~%=tU>pr@c}>tosMr}oti4WFuhZ0+$Bi*g z1lP^fNWZGcN9}>{ol8Q|ut)dqo-V&T#QA*|wlKUqJ^x1kp&F$^>kTjlwp7Z6g5v1B zAXJEbF}JI%H^p;B+sEb8`9=DNP+rp_=0*Axp1<`S43tPG5lxyV#;X+0 z^g)P^Qi?^9t_}AE@>KTt!f+WwR**af71!w~!icAJBfT|H)#6f=0q9dPDOd?Ns$l8x z!mbPA>f@K1g1zA_hAfO2*xTqR0Y2}3>dzgTn%gA8-%PVSpiO?BwX>fGk(+xJ(6&l> zaf-@OKeF;(2oV+^xbaya=oQD*vk}@7Wvl!{mUU_~gd_^X>zncFC-JRm5r9u@QuqBf zL3?)YkIM=kY+!Huo-Yg!LMzpeyycONz8P)JxIu)Vz{-c^uHO+W4LMTH@pa-~#L@8X z&yX*QOijr@T^@XiZ_qwN@E!DG$;}R-ni%_3>MlZ@0A{go%^+u zZSB3Z$V#d^nzKJK`;tWN_h~O@I`VWFb6p%}+k{qZiN!3bZSniQhZe}0>(I+;NSE`{ zxIfc)r+Z{_!C8GFgCmGBWnURs&4W7exV>eT4r7JplFARi)y&EzTBUO>#X+gbJ39>H zvvs{Py0eQ{=A-UYaGF|d`HBR!;>B^YXS6t=E6D!aKCMY?REbVY=S&!2-Kg5>i=y}F zO1L_m;CNtAz}ZWjR~?|zUqAOq^@ALLN++*_xy+?B-*di1rX?VDuHBr!E(jBefviG* ztIStBpad}9*SjFAGEfV&Lfeo-FZ$xu#;NYu-qYkkY0NXzh%H#v^(6G+4l&r0i6fTq zzUPv|Ue%dZ<5IPT)uG)r)+z(WX?mQ;IZ~|BVw9Un2@($mQ;jLjEw0i-H}{Z_+%Ppe zB(zBBBtqOL8ES4xp0ahlYy9!&O%Af}!hQg$-KFdOobah=)%-YAv3vvdk9v&?Q~63p}Gn+|qQ1Np7}g!`^Gj zpkE!EN^E2x20Si`7Hz%!zL@6YGv>0e4x>qjnkT! zTQNE2Z*np~iZcfGMQ&^pNIP(}pGU0vQ#@5TlPxmRR*F+KhEZ>py6V<4#cLzR&#MQ) z_DdpO7soRW4^Q=aUaOZYoXbvTq76=<8n2L&t_jFA?A~} zXVfZ~CsrtLBcJ(C7pa4772pwqIR`H=y3dpvV|>_qN+gResUPvD@;jNFuN!INr2DKi zUwXCZHK8KD-BBL~@m>A=JpNa%9`8{X5T5Al3jNU{;az9uLE`w5pc%&K50lHw73ZpP z()Oat&U~A|s(}#Qm0AFs>f-s{P8 zaQy;Q`M^5lzsj_e%siWu+xM(XprwwSiGi> zSdnqHh3764L`yl?qU5`wU{AC4~HAQQM8se!6FXh5ulJBMdgqS zVR~^0w5sKeXdlC`h=t{SDB}<`rY)oLp$$4OJcQ-CBCHPSy@wJ57l;U*pu+6qN zi*J~vA1OOM%cx#15fJ86Y?pohrCMzF7JXHSK$_Xn$<9tk!w+G5b-tRK8ZKU5UcQ_U zj9Nn@BRZOiNy*nqsC43EqYLu$HR&eB#4<>n-Q1cQ8_iV17kGJi1oM@Ol@%2=3=E7T z!opfSPd>)PQ1f`gfvIOf!NXTv4ibGMtTe*HRiUAs{|iAtzQ5(=C5?)zDkvLii%CgF z20rU9A$Dtaw%=7s$}@zh9tt`-6P7EGc9%IF6|L|LR*tvwJJ4^yP}9@X`3)Jc2nor^ zAY$+C@9Q+IWn>VJJ=!vwXD#raJ%d3+45Eq)Afyys$|{Qb^`u7Q@b7|BWpBIW?7ybW%vK)3qG2s7kd) zZO%#xNzts_D5N{s-AE*qO37a6nf>>X3tDg^axB&2vMSK3GO`EpPI~BqEm(@UD6}-3 zcQvj8c3`2qW3I#JmK+))b0z}3)*h(4wlFJ5eX4p8k= zFlcjdbX4yx9vd6eXIfrb`gBP%g)J1Ow`Oa<;P* zC=oq1bk?XgJ{}Fi6g>jV99c%sn{ign;Es7|a1hEloQ{V>W8-=eToV~RSnl;BE-N}h zET@q+sj%ii(QKswSAK zbQ8JbD$?8&Krn)Y)ci*1)AU}9=u7%&`f3IcAkd<3%-8j(IR^#?whqnxnGyJ3MON$v z0xS9f%bBo@ltflsY&5;5H*jWUb@P{&S488L$i3O98YR zif1kuVa}v6fF)AnkClo%czxUN3S6knOPX>f#fUEiF>QLW8-W zB`k?TCf^>B`15S`hS0x5J(XP_RKdf;^9K&Hmg3Sx21BiM7)5Zu*xPuxH?rb7tMQWF zm!e92KkiUs_g>mJ{ouLc!2GEnLlb!?1wvCp10R!u=Z4>M0<{h@vIIDI{%8B;^>xAp zdE&~w!f5gk7>BKXcwgVIYil~$qS?|8l*HQE3gQ9UtOd-gxXTKHrk-phOp z3{*5UGDR~VcTzYxA;`!uOibq!6YD3Elk4{P6LOp_EYvA3ld+48O-!8aCg$c%v9YiY zPaCM6P4kTHCdz3P5a8{r1&_lJ@bD9rlte|3!bnKAswER9<%?v@s}`i*sT}%GR55x| z&X}YM+bfN8GU}_QMbwd|{ zIeE9X#wZ~{+19oi?cc>Etrpg%R5Hsi(N3&j%fwvmN%ivO%OLBu>1m5hM7bqZmAPxmV?)C@ zjIfu{8-zR1Yzq6*D9)yMF&mCE;7JH90i38bGr$dvkcI3vaPset4r@ZE)IB|q^CmJf z9>T`a2Z#?^n+h+kmj^KK(WxRORR-SiIzsX`+>Anp!c+E{g-2D>M{W-hsW-RKYHQ2Z z)i^4}>8V347z*yI65l!FoJnPhXK4PzeF>wq`%jP zwJnZ!%y{DO@Q1r&V7tWL0QBayzQ3QGW;HlIK0G$obuty?AF{Pw+pb`Ly>cBFhk8#l zR&y6V@qwt@$19y`q`k*cWpdX%3`yU(s%1g1w0bLWdk!VKD-l&qR^CO9l)=Ip&)gi_ z+y>vq;+c&ZR&fbVX&D|%Dx{?aL~#iu74?09iW1au4h?ZHxD{tbe6i8hF>6F1^9A zF>td@$ehW>+FJjrUG`&bM9e^ANocQ+MPGLMpesx#oKyrd!qc};GEEVj7nn_V{9(@f zsTPkGkF#^mQCZ4XSN9a(kjG=_BloczIBrPLV0apJ6WP1rlJlm=HhV=+ZA>a2A$%lM zN7J<5WoPBU7DaB<&ml)zc}JJA(~4m4Mfm*m5PJg%pWCf7BsV`FrB#qBFgci&h)Cbb zDPCDOWPgb1K=|#1>4Jxj2wU&apoAmYCJZw75vVxBb}17b3L^*?_A{Ibe%hRnb>)d8 zhV00$fLkL?Mn6z46%NCJK;i|Sqg>%&2?S zNkqW?s5Lx1tf7%2adm!v{^E-sNYNan zZ;AuYtF$w05;Sy|CK8JB8CB|I^iY0vd#*^MNjwBIgD+`+bxy6i3l0LjZy^rL}> zPF@wUs}J0Aj>I9XY@o!4Q(g%UeXg-A?`hXZ#2HqX36xLs)cpXo_JUIb6(w6-a+vrw zIW^UoUk?PqPo{Hf-^ttCdmG@8z!|_=uEK~;lVFH7u9WxI3+2Yg$Ls6sicsXK85whC$rN929~^KdNOCbSWGj%4y|195x22&iqo*yS zrCV~=?_qKKu3f_(x+!A*+$gWM%r22V`z(75Mi5d^CZ-momYi;4auI^v zE?q&uV-ioEoMgOu)d-8ZLa%!T10`o-v>g#HPEehcl+&-VxQ(TC}1YP9TY8E9UUg?x#?$(XP3^uF8A`|xF_NB7I7Yo@P{dLC1J(mW!f zYOC5V}uqcM=UJ z-n&^7yF8yj8xZaF19vXv>;l!}mNdvdnY59lTMl8A96$TC0ZN{rgXQgA?K*gWWpsih zK_hS{%f4}XN`QfpuSC^kuGS}ytmk#NUjQ)KAf8YUBGKejatrc)^}f-ehQh)0%&OpV zLIp@+AX0JfGG33&V9!T}E=Btr)>O1~SJx;P=ZK5Tn3JV#mrWdmSkIlJV3B=%56T!B z7Y~yKR=9K_L!sK}%ZLS;J#5|wRaMoY&8i$j!!9>8h62mHVDcL&jC|e1)gfD5M27f{N%OQ?LXtL0pM~G6 z_j2h=NtMLKg&7*cDk@5ij9AukyQ?1Q>93xhF`ZNN`w|gdlZ>C%J6&tue?D`Zc4Seo zB{1j17Ok>)^G2wt$+%E7E+x*exV)V7K9F^w%~v=8%-7BBtrrxcOs(V!v}{B~#H+_I zgfvqNQ&WPnD?CoeN8%O7`edgcd@Eb1+j6CO*x2Y3PnrDTD29|$jOEiCT# za%7c?mC9H_XAhYb6&#w_EG#tc@2w9Hub(|@9#3yEsnG`&Ut>#5YCwZI-p$m_%bv}D zKU#WurQ!F+kU~|p!PF#CBwyA7F`t2xn}&xIxrw_|pB~(?(9Re#mR#x6bp**x0x?#C z_aKHU`ZWVr3jjm#g?I9+0o@CNlZ#54Ga;mf=0A=y0=Hz%g39; z?g|;UAU}~S58@FgESnd!&xn8&>A~-SUGK*R{?rE=&%?T}8N!-hPpv-#9A}0sS$QsL@S}S~Z08xDu+d^dpGFWn-llo3QloWVj#^ zrv*-5lObh*scUI>>6DDP;K!bK;RwI$Ct1BI8%qx`=(zXvf|=U@4(rfqrU01(bB?|o^~M2lK!yw$<6orhW~w)liPZqLQsWRR$O$- z^NN;bCU&!ry+gk1;a;ywdSATjb%lh4MCC8WYY_;}_~V9AzcLdG}rQ&-4tJvu>{vbs7@g*V3R z1%!m&tgPvU`jStSmX!3QZY?f~f@wJIfXvOz1S2CDqTPV`_89gECr^Y_IkCGEx$uiU z=VvSjoqN5wsJGb<_MgVkog zKE-Z|w{i#wk50OZGEGd@}}B&ov@a=xSAIqsq3 zVpiMA&#nQMA30D%Q#&;++A5b2v4;|$3YZ{_g>yQ@4rm2mO>P1Gy;vSE^RywT;Z}}T z8(X~mAj!eNWKw)QlqfP%FFqC=1R^5h4eD{XPGVwWU{H`DcO~#jmo%u;&d!b?b7WMV zmADT>2m9=FWg;ruywV3BQ%h{4Q=77Psmq6Z>0`4IT+}$Os`ak(v?@~XOzPY1ZV&b2 zL(sbS3DZE>5*k4u{bJgVN2N6vt?s=iD!Uo^8#v%Fpm!oj`#LN zmzSECmRp)z?mavqC+q8Fr1#(4BW7^J#yFjq8@j%%usQwb915$uga8*lv186H|id=*y`F?#jZuYLx!>ouo|K5N@GMzm3}FE<#e5d zt&(A?1hEf6(R-Cf|_jXwpN1TymQ z-k$Kx2R?2VC3zEzPghsRN2gltE!;Is%x&B}bu2HMSU8%vIat}|*p}Er;nQ$2%}$up z5cCs3Cz_HutZ4NM`4`6vkH?JTDSLHMAKxIvS=*+kbc@8mfBCY@XG)x`=UI|Q217WA z1Entk`_@4`FTkY>j6$tHu;fhaONB{N{992`F{lv;2#B{zWbFbz5n;g*Aq^2xFIZTL z-=wBW&K2a72b&usH1NU&k#~sv!eh50 zJ~T9h<%WWp9pBq4{P_!tevD|kOlq2yT!{p*vxar^ZXcM!!VAL=Y-CjuKq60)7@O7YXd!)sPnmUk==Ma9tQ<75*i;bU0`>|?xSp3 z1(M7F(TacV`eukgfSm7_8)UBV$hqgwpTjCs!As_4OjTi_=WVhO@OYW|F1}W9xloGo zxq2?_#e$es4~>Hn&pFgy)0BXPhm~5{`Ys%VU=C{Vt(7SWOv_DgXJ;q1YB@uCcO?&f zX}6yOk)bhIoNG36FfN844Ha-N)zG8pSi#BhVNsbmg_MppjYf=j8`y-t!G{ke&^?t& zF)^RL&F@u*UxyRd21A}fhN>B#-jz=HfaUlN@=6gjp`mB_s~&8|c{GJ-^T)lyP`oo? zf>8qt(AU>DHZ~p)S0Kmg%WQ6Hf|hc})rVo!U>MseIfQMCIP5R1x~M%`d%TJqPrMr6 z89$jT&$v3txEe2?yNWc?X!g*crW%HwVTRY0(vh9>FFB3rxC3tSlI9G+?cb9c(GRc2 zqas-QXgFfAjg z@3GJc*xL$^Jb9a=)y@ z&aktv#7p-rw&UyS)xNV@%3Us&UZk71#e0`9w2VHq{DR}WB1C>;EWnWfzh2(Asg0c( z#+sN3!%#kya}oi4GV?`kFrnIoKA4|Ty|amvfffjIdRhu@T?7ng8LEl~SWJ8=u_?%6 z4_019{E{Z(UF)MJ?dDQnUtdf|7zPno()01&$OhXFfip>l@%O%!wyh=Z)h(A;OH7ON zAsjKsogu@hyEg97yLA2~U@lsyU`fP}h|=R9_F>C%cNswRpJhz6jZR$aiULH1gX7+Cnr zVbZfr+Sq!?EEsqhX?fw^)#YFZ(jSQoc!dDa*6YCS}50r)~(^E0mDAt@0 z%oQM_%ZP$S5XPGV;4Ai|IBm?%lavvLv#C z#DY@Cxr`WmtiA*(E^h-aJV98K1O!O`ckhR{{c&SuI_$%VPfkv>oPw%)m2&g)lE+LO z$nq2x*VYi~3}zcd^pN>8olodrkzb*30+^nZloYf-3JOYNP}8%<_=AH3pIb{^^iX!$ z_fW3a3~UY2nhk>7JS1(c*%S{CTOc5tJlwg;CnxWeyu1u-01n%odGG4j&h`|`^*U>% zb!F^$?2_xymF<+1w}NjXWIECt56kne@exWN4lBJ<;_JIdQO02}ttJOjW@g3bqO}WF ztR~=!k_xsASpC~ycTgWX(22ROLy{a%*ili$q{-wQkSkLF+(--QbFN^er|hF@Wkdvg z4kI}&?SR>+NKtN{gt4Tgi-kqKV#^H0L19<4yn=$g?xQk>7`I1n4LP)2!TY#K46HhM zDO<{A0MBco-DtqiGza!TP*6D9OUrmNJ}j( zJw5YndMbAwCm%-#`wNa2YkUlx>{iLiTXMRcUJj5bqjo|d6sGWuVqhOCQsp5AED#n0 zfs~A{vmb7{p|&vgJKlew5Dlq4I6UOLKdR~P?_XWjE>nR`+TY(#NJ!|-sc~dZe~C(~ zJYDvJ*}6b>+0vAw^1wh-J)`WMS8KUeJQS^_P$8W2nY$0>jgEa=qHdj4yc?>=rh7IFfd7*V#0p*D!zpadqN29}bLP?eg znK{VjaBZKew47R{RjI(RoWr%4TBV$|@p@x1WwT9Q`YZ>d8Z9hO!ZJ_dFoBZGxH;l= z#^)RYL;Kyf_DnMscyicUN7P1g((_x}T31w*)wmdWfpOl`c+;Emrh_Yf0T{W+?o`RF1>Io)ET*8K;Mv)kxD{nf zb2CQL4o+B7@w5w7n1==qgeFd4>LCQqsQ1gdhsFN0QWn&YY=wcj-Cs&m<^tb|I{JFQ zbTv;YV{&$^yp|KKitlA5UV@M_ki)>sEcecn9_Di-UF#udGhNQkj$K;X86D-WX@V{* zGB>k5wKg-O2JoHo@&YUCmaZ23&FE|#!x*GC<%$(p)^TJN#2|FH*ep*#bL8SO1-*rR^1(^_);t-Npp=Nm6n|jHZ4A`LJ_+aH102xjgHQP>#Xz`lr25dsxmIxd=+anMCRz z%haf?Z*oPPTuO~m#YC30@Wt@G8Vegs^Xdwk>ROu0X!-JLn2aq6a#sAYWIk^fwzX+b zgd{~zx!v+@Mv+_?fmsnDBQNiaZ0_%G9OEIO=6GJO%C@%k&}%!~-)x0#Y)}Ps+nub` zQLA#>en4<=gw6WggZSRv%|ACEO{>+(-p)(UL)in-*TY@oE@k5*_-FOKkO@jaE}-O< z<#l`Zk>z$?xbJ;9z@I6Sna}E|&YnK(OvlfprLuw2>o}cXM$8?;Zf-?b)Kz6?Q_@#t zmzS4hWmSW{QCOy=GI11p`O?$f-B3rz-PxI%c5yMUsmYj3(OX^~-dj@YaCoGO(>ftx z3>|$;L}ZqO!#E&d)=Eu#HE=3fS!s0VYSX|`UmrbvUzC8=6qoAuHo@2!9wtC1XK2>U zLFr&d`lYGRT+U?I{zvqE0Wu|I`%O}Q)CR)Gytg^MDfnMsr|>rw6@?VOY7LbV)^1&X z#fJzRc6AYcaS{IMI_ms$NW0JKhh?s%dA7M_F3G|mF?L!V9eG|}MjM+hclTSama{0` z;jdHv6}p<<8>gOklJ20`eF0?^6>*$k;NT)6B8F-G zFxUzD@$%|Od0Lf<<}uC8I`{XH8XKd}&(u<(rNpD1gzmk11tn_8$jzPcZsq_@bk1x_ zP|zSW%(6Ff0Tyq8m4;^AY*e*qicYH$9k+A_$Kj!Eb5@{i_TyNc^Hhb_7A{n2NR0$o zSXh|-=Pc;DtLaB7+0#%>h;MqBBSh#d>h(xc&Gq^>0 zdA;J{Ax3>gP!Qs(>8dKuQcpd-G?i4>t^P9lHN+RsjZJoqFfcIYW@eBSKrzgSBj;n< z6&lS0fFW$kA(Ft=s`6_|aB!|pNd$W1z8D^?t(BkGLxthK4V$dMAbTZ_#sy#)fIKu$ zp{TXBwG!8@VYKwZUv7HVQGasMf~|qjtkHd%K#TytT%MvfFRyMv9M{#yM?^p%VMr;6 zBoJSV;V~U1%+2Bp7isPk@w3k}jkc`4oYfdJYEn51(c`t1p`29L6;za6TT+_9g+~v^ zTmC^pE*4f+4o0<{!+aII=Ut7)`qtWauE>QBtz6fF-QfFsdr+{j)b#Y^dUif!;Iia& zcD4i${@VfA-XWG3&M-k@aFV$q0S-=1@mUd^D*o=pjH;xfN*P}VQN!HsUG@^Fb=KBm z7#Rbjk(8~h6huTw(gdPj?Jo|uH{VLg0+^X_Se|m-9`o^3c23kel?N}j*a<2|et58W zX!um1f8U|Op#}3*2SnevwsGjft` z<;)M=Z+LFahyWZL6e&H9Lf9?mg~_dIFNtY3qU6N1zLNYh1XXc-(1yCK}~Dyi2bOC}1(V zq9G&VRT9DV$J&Y;jA7Vi`F$a9aw39O->@yUcl zolTl$DzTurJRGHtH{dzW0n-WQmUWA%&K#QK8ksfPnfEX$HLKAL)A1dOsdd_k4h7;3 z7LtpFBWo6etBW7b&Bhje9Jn=KB;$N63VYL5k7=v~q@k%922PsJ=i}nc`7r>yZR#8>BKt(>s;q-c^!Am9P#wWPI9UXui;QF@<78);n`E6@Vp^HEtO{T1FGVd~n!oLvWhL@0dW3}@ z&n+pT1|%_Iw`KKNf;u6S0B%zbQWSDyfRQsPE=b!h5+iA1LWW5}PcKUX8xax`A{^u& zGNT^GRbEuo1s67{lP+%+sPLGKBX1zgn8&iDI>N*w)DR~hd(?Dm4pFPte}9*!i-27t zVe39VHdLX+J^wZDB7m=ABgOHAh=^zb;Y)1WeToqQ zJlWOdB|HMcrg0Xkbd|Lhla;1`05Hq^tOVcd0b`Fhfe?X|t5qiq|auwDH1 zPe&!PGWj2qxF)NrLLMKhGVn(_JKv6xJ*XfUoL;~~vpo+-dBe)Wvd;gO{yx;UrWGzn zvt@bNlS{MO=EHK^*S(FLfhbpkmF1=mvHLdzQ4{x3_(wdg@0arG5DZz z9-r_ulHX-rR7KTOi_}(hQ?UD)C@P{}L%#x{zKnbE9AxbC=b?8*IA&K@8e(F3ISKn{ z+U@!q#CuMh;UM-islXIx-QfnGcE}2L%M?cvlSxNvg;YzKN2)p5vMsk9$0Ocf>!*nv zUVNFM;g~65pu**u)7ZXbze9!Y!&O0L2@0~dTbw3&c+MP_y}EXqijfaN_gS93e13zc zUBI1Dw7{fbm)ukZEkY5WlxJ-*=XIZu5BLLb6DY5{_Zr7umhGb*zka6bc$O}2iCQil zCvLHidrn3`4f3qkVqacgk|7#y!141!!fnFP&cvgUL>+Okl=%AzG~S1cto`V`JW|2* z!9np8<=(YB(Lq=yPBvyfu7+z8!=392(PDG~-pAsFn~UvQ7HvsEX)W)Brsow5tlY(A z@0u9M`H0BY3S}ur$8%zBqVKpX)XlNi9@{Y=H!;KbSAUYe z(_uv&Dc=R%VX0y-rSwN*P@y-gZ9F^88lq~;YNvZgjV*PHeC!iTYxQj{%nb~>+KOWa zvbq%$Ywc@~uOHiAKW40DAdeJMy}bVT;lbpwA_1Ua6@R!8;n!x;43c5qt1+AFv78)8 zWHlA6GA9qTlpoG+4JbLhva%0D|CQPfhvgb_KEc@nB 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 Xw{Am<4gd25zNPhCU+trcO~n5I$U%e; From 8a9d3089fce7e7b7ada1b6770fc364459fb76219 Mon Sep 17 00:00:00 2001 From: hrntsm Date: Sat, 3 Sep 2022 13:43:13 +0900 Subject: [PATCH 65/65] Update README --- CHANGELOG.md | 2 +- README.md | 85 ++++++++++++++++++++++++++-------------------------- 2 files changed, 44 insertions(+), 43 deletions(-) diff --git a/CHANGELOG.md b/CHANGELOG.md index 4d5b65f7..4d132709 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -6,7 +6,7 @@ The format is based on [Keep a Changelog](http://keepachangelog.com/) and this p Please see [here](https://github.com/hrntsm/Tunny/releases) for the data released for each version. -## [UNRELEASED] +## [0.5.0] -2022-09-03 ### Added diff --git a/README.md b/README.md index 8d0d8cf3..d66247b3 100644 --- a/README.md +++ b/README.md @@ -65,6 +65,10 @@ Please see PYTHON_PACKAGE_LICENSE for more license information. https://user-images.githubusercontent.com/23289252/178105107-5e9dd9f7-5680-40d4-97b0-840a4f1f329c.mp4 +### :fish_cake: Select sampler flow chart + +image + ### :anchor: Component location Tunny can be found in the Tunny tab if it has been installed. @@ -103,7 +107,10 @@ The nickname of the ConstructFishAttribute component input is stored paired with The Geometry input has a special meaning; what is entered here will be displayed as a Geometry when the results are sorted in the FishMarket component described below. - +Constraint inputs are also special inputs.**(new in v0.5.0)** The values entered here are the constraints in the optimization. +When this value is less than 0, the constraint is considered satisfied. Constraint conditions are supported by TPE, GP and NSGAII. + +image ### :octopus: Other components @@ -128,24 +135,26 @@ On the other hand, it is possible to save the learning status, and even after th On the other hand, Running the Dashboard function, which charts the results, starts a server that handles the results and allows you to see the optimization results in real time in your browser. This feature is useful for analyzing post-optimization results, as it allows the user to not only see the results in real time, but also to view several figures at once. -It is recommended that optimization be performed a small number of times, and after completion, the results should be reviewed to determine if continued optimization should be performed. - #### :sailboat: Optimize Tab -image +image Values that can be set and their meanings are as follows. - Sampler - Sets the algorithm to perform the optimization. The following types are available. - All are optimization algorithms provided by Optuna. - 1. TPE (Bayesian optimization) - 1. NSGA-II (Genetic algorithm) - 1. CMA-ES (Evolution strategy) - 1. Random - 1. Grid + 1. Bayesian optimization(TPE) + 2. Bayesian optimization(GP) **(new in v0.5.0)** + 3. Genetic algorithm(NSGA-II) + 4. Evolution strategy(CMA-ES) + 5. Quasi-MonteCarlo **(new in v0.5.0)** + 6. Random + 7. Grid - Number of trial - This number of trials will be performed. + - Bayesian optimization first performs random sampling to create a surrogate model. This is the setting for how many trials random sampling is performed. + - The original paper recommends “number of variables” \* 11-1. - If the grid sampler is selected, the calculation is performed by dividing each entered Variable by this number. - **Note** that the number of calculations is (Number of trial) to the power of (Number of Variable). - Timeout(sec) @@ -163,7 +172,7 @@ Values that can be set and their meanings are as follows. #### :boat: Visualize Tab -image +image Values that can be set and their meanings are as follows. @@ -181,12 +190,15 @@ Values that can be set and their meanings are as follows. 6. param importance 7. pareto front 8. slice -- Show selected type of plots - - Show the plot selected in Visualize type above. + 9. hypervolume **(new in v0.5.0)** + - Show selected type of plots + - Show the plot selected in Visualize type above. +- k-means clustering + - Cluster the results of the Pareto front when performing multi-objective optimization.Any number of clusters can be specified. #### :fishing_pole_and_fish: Output Tab -image +image Values that can be set and their meanings are as follows. @@ -197,11 +209,8 @@ Values that can be set and their meanings are as follows. - All trials - Output all trials. - Use model number - - Multiple values can be entered separated by commas, such as "1,3,42". - - Output - - The model with the number entered here is restored from the optimization results file and is the output of the component. - The model number can be found on each plot. - In the example below, model number 424 with a value of -11.49 for the first objective function is selected. @@ -213,36 +222,28 @@ Values that can be set and their meanings are as follows. #### :droplet: Settings Tab -image - -Tunny stores the optimize settings in json. -Detailed settings in optimization can now also be configured in Json. - -- **IMPORTANT**: The default hyperparameter for each optimization contain Optuna defaults. - - These are not necessarily the best values for your optimization. - - Pay particular attention to the initial population or trial. - - the recommended initial trial for TPE is "the number of Variable" x 11 - 1. -- Open API page - - Open Optuna's API page with the meaning of each value in the advanced optimization settings. -- Save settings to json - - Save the settings to Json. - - Settings are also saved when the window is closed with the X button. -- Load settings from json - - Loads a settings file. -- Open Settings.Json folder - - Open the folder where the settings files are stored. - - The file Settings.json is Tunny's settings file. Edit it with any text editor. +image + +**(new in v0.5.0)** +Allows detailed optimization settings to be performed in the UI. +See below for the meaning of each setting. + +[Guideline for selecting optimization algorithms](https://graceful-stag-dae.notion.site/Guidelines-for-Selecting-a-Optimization-Algorithm-8505b2e020ee4af2a77272f25acc6094) #### :turtle: File Tab -image +image + +- Result + - Open result file folder + - Open the folder where the file containing the optimization results is located. + - Results are saved as "Tunny_Opt_Result.db" by default. + - This can be made to be anything you want by rewriting the Setting.json file. + - Clear result file + - Deletes the optimization result file. +- License **(new in v0.5.0)** + - You can check license to push each button. -- Open result file folder - - Open the folder where the file containing the optimization results is located. - - Results are saved as "Tunny_Opt_Result.db" by default. - - This can be made to be anything you want by rewriting the Setting.json file. -- Clear result file - - Deletes the optimization result file. ## :surfer: Contact information