Skip to content

Commit 0ce2ee7

Browse files
Update docs
1 parent c131d74 commit 0ce2ee7

File tree

98 files changed

+1069
-91
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

98 files changed

+1069
-91
lines changed

docs/_static/doctools.js

Lines changed: 52 additions & 20 deletions
Original file line numberDiff line numberDiff line change
@@ -154,9 +154,7 @@ var Documentation = {
154154
this.fixFirefoxAnchorBug();
155155
this.highlightSearchWords();
156156
this.initIndexTable();
157-
if (DOCUMENTATION_OPTIONS.NAVIGATION_WITH_KEYS) {
158-
this.initOnKeyListeners();
159-
}
157+
this.initOnKeyListeners();
160158
},
161159

162160
/**
@@ -269,6 +267,13 @@ var Documentation = {
269267
window.history.replaceState({}, '', url);
270268
},
271269

270+
/**
271+
* helper function to focus on search bar
272+
*/
273+
focusSearchBar : function() {
274+
$('input[name=q]').first().focus();
275+
},
276+
272277
/**
273278
* make the url absolute
274279
*/
@@ -291,27 +296,54 @@ var Documentation = {
291296
},
292297

293298
initOnKeyListeners: function() {
299+
// only install a listener if it is really needed
300+
if (!DOCUMENTATION_OPTIONS.NAVIGATION_WITH_KEYS &&
301+
!DOCUMENTATION_OPTIONS.ENABLE_SEARCH_SHORTCUTS)
302+
return;
303+
294304
$(document).keydown(function(event) {
295305
var activeElementType = document.activeElement.tagName;
296306
// don't navigate when in search box, textarea, dropdown or button
297307
if (activeElementType !== 'TEXTAREA' && activeElementType !== 'INPUT' && activeElementType !== 'SELECT'
298-
&& activeElementType !== 'BUTTON' && !event.altKey && !event.ctrlKey && !event.metaKey
299-
&& !event.shiftKey) {
300-
switch (event.keyCode) {
301-
case 37: // left
302-
var prevHref = $('link[rel="prev"]').prop('href');
303-
if (prevHref) {
304-
window.location.href = prevHref;
305-
return false;
306-
}
307-
break;
308-
case 39: // right
309-
var nextHref = $('link[rel="next"]').prop('href');
310-
if (nextHref) {
311-
window.location.href = nextHref;
312-
return false;
313-
}
314-
break;
308+
&& activeElementType !== 'BUTTON') {
309+
if (event.altKey || event.ctrlKey || event.metaKey)
310+
return;
311+
312+
if (!event.shiftKey) {
313+
switch (event.key) {
314+
case 'ArrowLeft':
315+
if (!DOCUMENTATION_OPTIONS.NAVIGATION_WITH_KEYS)
316+
break;
317+
var prevHref = $('link[rel="prev"]').prop('href');
318+
if (prevHref) {
319+
window.location.href = prevHref;
320+
return false;
321+
}
322+
break;
323+
case 'ArrowRight':
324+
if (!DOCUMENTATION_OPTIONS.NAVIGATION_WITH_KEYS)
325+
break;
326+
var nextHref = $('link[rel="next"]').prop('href');
327+
if (nextHref) {
328+
window.location.href = nextHref;
329+
return false;
330+
}
331+
break;
332+
case 'Escape':
333+
if (!DOCUMENTATION_OPTIONS.ENABLE_SEARCH_SHORTCUTS)
334+
break;
335+
Documentation.hideSearchWords();
336+
return false;
337+
}
338+
}
339+
340+
// some keyboard layouts may need Shift to get /
341+
switch (event.key) {
342+
case '/':
343+
if (!DOCUMENTATION_OPTIONS.ENABLE_SEARCH_SHORTCUTS)
344+
break;
345+
Documentation.focusSearchBar();
346+
return false;
315347
}
316348
}
317349
});

docs/_static/documentation_options.js

Lines changed: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -8,5 +8,7 @@ var DOCUMENTATION_OPTIONS = {
88
LINK_SUFFIX: '.html',
99
HAS_SOURCE: true,
1010
SOURCELINK_SUFFIX: '.txt',
11-
NAVIGATION_WITH_KEYS: false
11+
NAVIGATION_WITH_KEYS: false,
12+
SHOW_SEARCH_SUMMARY: true,
13+
ENABLE_SEARCH_SHORTCUTS: true,
1214
};

docs/_static/searchtools.js

Lines changed: 2 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -172,10 +172,6 @@ var Search = {
172172
}
173173
// stem the word
174174
var word = stemmer.stemWord(tmp[i].toLowerCase());
175-
// prevent stemmer from cutting word smaller than two chars
176-
if(word.length < 3 && tmp[i].length >= 3) {
177-
word = tmp[i];
178-
}
179175
var toAppend;
180176
// select the correct list
181177
if (word[0] == '-') {
@@ -276,7 +272,7 @@ var Search = {
276272
setTimeout(function() {
277273
displayNextItem();
278274
}, 5);
279-
} else if (DOCUMENTATION_OPTIONS.HAS_SOURCE) {
275+
} else if (DOCUMENTATION_OPTIONS.SHOW_SEARCH_SUMMARY) {
280276
$.ajax({url: requestUrl,
281277
dataType: "text",
282278
complete: function(jqxhr, textstatus) {
@@ -293,7 +289,7 @@ var Search = {
293289
}, 5);
294290
}});
295291
} else {
296-
// no source available, just display title
292+
// just display title
297293
Search.output.append(listItem);
298294
setTimeout(function() {
299295
displayNextItem();

docs/contents.html

Lines changed: 10 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -84,6 +84,7 @@
8484
<li class="toctree-l2"><a class="reference internal" href="generated/adapt.parameter_based.RegularTransferNN.html">RegularTransferNN</a></li>
8585
<li class="toctree-l2"><a class="reference internal" href="generated/adapt.parameter_based.FineTuning.html">FineTuning</a></li>
8686
<li class="toctree-l2"><a class="reference internal" href="generated/adapt.parameter_based.TransferTreeClassifier.html">TransferTreeClassifier</a></li>
87+
<li class="toctree-l2"><a class="reference internal" href="generated/adapt.parameter_based.TransferForestClassifier.html">TransferForestClassifier</a></li>
8788
</ul>
8889
</li>
8990
<li class="toctree-l1"><a class="reference internal" href="#adapt-metrics">Metrics</a><ul>
@@ -262,7 +263,7 @@ <h1>ADAPT<a class="headerlink" href="#adapt" title="Permalink to this headline">
262263
<img alt="alternate text" src="_images/feature_based.png" />
263264
</figure>
264265
<p class="rubric">Methods</p>
265-
<table class="longtable docutils align-default">
266+
<table class="autosummary longtable docutils align-default">
266267
<colgroup>
267268
<col style="width: 10%" />
268269
<col style="width: 90%" />
@@ -317,7 +318,7 @@ <h1>ADAPT<a class="headerlink" href="#adapt" title="Permalink to this headline">
317318
<img alt="alternate text" src="_images/instance_based.png" />
318319
</figure>
319320
<p class="rubric">Methods</p>
320-
<table class="longtable docutils align-default">
321+
<table class="autosummary longtable docutils align-default">
321322
<colgroup>
322323
<col style="width: 10%" />
323324
<col style="width: 90%" />
@@ -358,7 +359,7 @@ <h1>ADAPT<a class="headerlink" href="#adapt" title="Permalink to this headline">
358359
<img alt="alternate text" src="_images/parameter_based.png" />
359360
</figure>
360361
<p class="rubric">Methods</p>
361-
<table class="longtable docutils align-default">
362+
<table class="autosummary longtable docutils align-default">
362363
<colgroup>
363364
<col style="width: 10%" />
364365
<col style="width: 90%" />
@@ -377,15 +378,18 @@ <h1>ADAPT<a class="headerlink" href="#adapt" title="Permalink to this headline">
377378
<td><p>FineTuning : finetunes pretrained networks on target data.</p></td>
378379
</tr>
379380
<tr class="row-odd"><td><p><a class="reference internal" href="generated/adapt.parameter_based.TransferTreeClassifier.html#adapt.parameter_based.TransferTreeClassifier" title="adapt.parameter_based.TransferTreeClassifier"><code class="xref py py-obj docutils literal notranslate"><span class="pre">parameter_based.TransferTreeClassifier</span></code></a>([...])</p></td>
380-
<td><p>TBA</p></td>
381+
<td><p>TransferTreeClassifier: Modify a source Decision tree on a target dataset.</p></td>
382+
</tr>
383+
<tr class="row-even"><td><p><a class="reference internal" href="generated/adapt.parameter_based.TransferForestClassifier.html#adapt.parameter_based.TransferForestClassifier" title="adapt.parameter_based.TransferForestClassifier"><code class="xref py py-obj docutils literal notranslate"><span class="pre">parameter_based.TransferForestClassifier</span></code></a>([...])</p></td>
384+
<td><p>TransferForestClassifier: Modify a source Random Forest on a target dataset.</p></td>
381385
</tr>
382386
</tbody>
383387
</table>
384388
</section>
385389
<section id="adapt-metrics-metrics">
386390
<span id="adapt-metrics"></span><h2><a class="reference internal" href="#adapt-metrics"><span class="std std-ref">adapt.metrics</span></a>: Metrics<a class="headerlink" href="#adapt-metrics-metrics" title="Permalink to this headline"></a></h2>
387391
<p>This module contains functions to compute adaptation metrics.</p>
388-
<table class="longtable docutils align-default">
392+
<table class="autosummary longtable docutils align-default">
389393
<colgroup>
390394
<col style="width: 10%" />
391395
<col style="width: 90%" />
@@ -424,7 +428,7 @@ <h1>ADAPT<a class="headerlink" href="#adapt" title="Permalink to this headline">
424428
<section id="adapt-utils-utility-functions">
425429
<span id="adapt-utils"></span><h2><a class="reference internal" href="#adapt-utils"><span class="std std-ref">adapt.utils</span></a>: Utility Functions<a class="headerlink" href="#adapt-utils-utility-functions" title="Permalink to this headline"></a></h2>
426430
<p>This module contains utility functions used in the previous modules.</p>
427-
<table class="longtable docutils align-default">
431+
<table class="autosummary longtable docutils align-default">
428432
<colgroup>
429433
<col style="width: 10%" />
430434
<col style="width: 90%" />

docs/examples/Classification.html

Lines changed: 3 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -84,6 +84,7 @@
8484
<li class="toctree-l2"><a class="reference internal" href="../generated/adapt.parameter_based.RegularTransferNN.html">RegularTransferNN</a></li>
8585
<li class="toctree-l2"><a class="reference internal" href="../generated/adapt.parameter_based.FineTuning.html">FineTuning</a></li>
8686
<li class="toctree-l2"><a class="reference internal" href="../generated/adapt.parameter_based.TransferTreeClassifier.html">TransferTreeClassifier</a></li>
87+
<li class="toctree-l2"><a class="reference internal" href="../generated/adapt.parameter_based.TransferForestClassifier.html">TransferForestClassifier</a></li>
8788
</ul>
8889
</li>
8990
<li class="toctree-l1"><a class="reference internal" href="../contents.html#adapt-metrics">Metrics</a><ul>
@@ -477,8 +478,8 @@
477478
</style>
478479
<section id="Classification">
479480
<h1>Classification<a class="headerlink" href="#Classification" title="Permalink to this headline"></a></h1>
480-
<div class="btn btn-notebook" role="button"><p><img alt="a966f76b77f24009aa977763ca649bb9" src="../_images/colab_logo_32px.png" /> <a class="reference external" href="https://colab.research.google.com/drive/1ANQUix9Y6V4RXu-vAaCFGmU979d5m4bO?usp=sharing">Run in Google Colab</a></p>
481-
</div><div class="btn btn-notebook" role="button"><p><img alt="4335e175433742a2ad920bb842514876" src="../_images/github_logo_32px.png" /> <a class="reference external" href="https://github.com/adapt-python/notebooks/blob/d0364973c642ea4880756cef4e9f2ee8bb5e8495/Classification.ipynb">View on GitHub</a></p>
481+
<div class="btn btn-notebook" role="button"><p><img alt="8273b5f76d024ec6a6fcb2ab2aebdbe4" src="../_images/colab_logo_32px.png" /> <a class="reference external" href="https://colab.research.google.com/drive/1ANQUix9Y6V4RXu-vAaCFGmU979d5m4bO?usp=sharing">Run in Google Colab</a></p>
482+
</div><div class="btn btn-notebook" role="button"><p><img alt="aa92149bf8224e3db01a5eb7c66fbfa8" src="../_images/github_logo_32px.png" /> <a class="reference external" href="https://github.com/adapt-python/notebooks/blob/d0364973c642ea4880756cef4e9f2ee8bb5e8495/Classification.ipynb">View on GitHub</a></p>
482483
</div><p>You will find here the application of DA methods from the ADAPT package on a simple two dimensional DA classification problem.</p>
483484
<p>First we import packages needed in the following. We will use <code class="docutils literal notranslate"><span class="pre">matplotlib</span> <span class="pre">Animation</span></code> tools in order to get a visual understanding of the mselected methods:</p>
484485
<div class="nbinput nblast docutils container">

docs/examples/Multi_fidelity.html

Lines changed: 3 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -84,6 +84,7 @@
8484
<li class="toctree-l2"><a class="reference internal" href="../generated/adapt.parameter_based.RegularTransferNN.html">RegularTransferNN</a></li>
8585
<li class="toctree-l2"><a class="reference internal" href="../generated/adapt.parameter_based.FineTuning.html">FineTuning</a></li>
8686
<li class="toctree-l2"><a class="reference internal" href="../generated/adapt.parameter_based.TransferTreeClassifier.html">TransferTreeClassifier</a></li>
87+
<li class="toctree-l2"><a class="reference internal" href="../generated/adapt.parameter_based.TransferForestClassifier.html">TransferForestClassifier</a></li>
8788
</ul>
8889
</li>
8990
<li class="toctree-l1"><a class="reference internal" href="../contents.html#adapt-metrics">Metrics</a><ul>
@@ -477,8 +478,8 @@
477478
</style>
478479
<section id="Multi-Fidelity">
479480
<h1>Multi-Fidelity<a class="headerlink" href="#Multi-Fidelity" title="Permalink to this headline"></a></h1>
480-
<div class="btn btn-notebook" role="button"><p><img alt="30ffe81bd05f45ea916075bb1f6386f1" src="../_images/colab_logo_32px.png" /> <a class="reference external" href="https://colab.research.google.com/drive/1Cc9TVY_Tl_boVzZDNisQnqe6Qx78svqe?usp=sharing">Run in Google Colab</a></p>
481-
</div><div class="btn btn-notebook" role="button"><p><img alt="d04db52ebb1f471a93a750710c96c5a7" src="../_images/github_logo_32px.png" /> <a class="reference external" href="https://github.com/adapt-python/notebooks/blob/d0364973c642ea4880756cef4e9f2ee8bb5e8495/Multi_fidelity.ipynb">View on GitHub</a></p>
481+
<div class="btn btn-notebook" role="button"><p><img alt="5c37e0cb0ad6424498510522707778b7" src="../_images/colab_logo_32px.png" /> <a class="reference external" href="https://colab.research.google.com/drive/1Cc9TVY_Tl_boVzZDNisQnqe6Qx78svqe?usp=sharing">Run in Google Colab</a></p>
482+
</div><div class="btn btn-notebook" role="button"><p><img alt="a0b0bb598cc04871a485e6428870fcdb" src="../_images/github_logo_32px.png" /> <a class="reference external" href="https://github.com/adapt-python/notebooks/blob/d0364973c642ea4880756cef4e9f2ee8bb5e8495/Multi_fidelity.ipynb">View on GitHub</a></p>
482483
</div><p>The following example is a 1D regression multi-fidelity issue. Blue points are low fidelity observations and orange points are high fidelity observations. The goal is to use both datasets to learn the task on the [0, 1] interval.</p>
483484
<p>To tackle this challenge, we use here the parameter-based method: <a class="reference external" href="#RegularTransferNN">RegularTransferNN</a></p>
484485
<div class="nbinput nblast docutils container">

docs/examples/Regression.html

Lines changed: 3 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -84,6 +84,7 @@
8484
<li class="toctree-l2"><a class="reference internal" href="../generated/adapt.parameter_based.RegularTransferNN.html">RegularTransferNN</a></li>
8585
<li class="toctree-l2"><a class="reference internal" href="../generated/adapt.parameter_based.FineTuning.html">FineTuning</a></li>
8686
<li class="toctree-l2"><a class="reference internal" href="../generated/adapt.parameter_based.TransferTreeClassifier.html">TransferTreeClassifier</a></li>
87+
<li class="toctree-l2"><a class="reference internal" href="../generated/adapt.parameter_based.TransferForestClassifier.html">TransferForestClassifier</a></li>
8788
</ul>
8889
</li>
8990
<li class="toctree-l1"><a class="reference internal" href="../contents.html#adapt-metrics">Metrics</a><ul>
@@ -477,8 +478,8 @@
477478
</style>
478479
<section id="Toy-Regression">
479480
<h1>Toy Regression<a class="headerlink" href="#Toy-Regression" title="Permalink to this headline"></a></h1>
480-
<div class="btn btn-notebook" role="button"><p><img alt="b653644c0aeb42a582c3f958545c1ad0" src="../_images/colab_logo_32px.png" /> <a class="reference external" href="https://colab.research.google.com/drive/1adhqoV6b0uEavLDmMfkiwtRjam0DrXux?usp=sharing">Run in Google Colab</a></p>
481-
</div><div class="btn btn-notebook" role="button"><p><img alt="0048eac286214a80b6c3a06c47700b07" src="../_images/github_logo_32px.png" /> <a class="reference external" href="https://github.com/adapt-python/notebooks/blob/d0364973c642ea4880756cef4e9f2ee8bb5e8495/Regression.ipynb">View on GitHub</a></p>
481+
<div class="btn btn-notebook" role="button"><p><img alt="24f5f2e739b444989256c3c562f8b73f" src="../_images/colab_logo_32px.png" /> <a class="reference external" href="https://colab.research.google.com/drive/1adhqoV6b0uEavLDmMfkiwtRjam0DrXux?usp=sharing">Run in Google Colab</a></p>
482+
</div><div class="btn btn-notebook" role="button"><p><img alt="d6b14d0fd0c248da88ca9a4a8df02df8" src="../_images/github_logo_32px.png" /> <a class="reference external" href="https://github.com/adapt-python/notebooks/blob/d0364973c642ea4880756cef4e9f2ee8bb5e8495/Regression.ipynb">View on GitHub</a></p>
482483
</div><p>You will find here the application of DA methods from the ADAPT package on a simple one dimensional DA regression problem.</p>
483484
<p>First we import packages needed in the following. We will use <code class="docutils literal notranslate"><span class="pre">matplotlib</span> <span class="pre">Animation</span></code> tools in order to get a visual understanding of the selected methods:</p>
484485
<div class="nbinput nblast docutils container">

docs/examples/Rotation.html

Lines changed: 3 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -84,6 +84,7 @@
8484
<li class="toctree-l2"><a class="reference internal" href="../generated/adapt.parameter_based.RegularTransferNN.html">RegularTransferNN</a></li>
8585
<li class="toctree-l2"><a class="reference internal" href="../generated/adapt.parameter_based.FineTuning.html">FineTuning</a></li>
8686
<li class="toctree-l2"><a class="reference internal" href="../generated/adapt.parameter_based.TransferTreeClassifier.html">TransferTreeClassifier</a></li>
87+
<li class="toctree-l2"><a class="reference internal" href="../generated/adapt.parameter_based.TransferForestClassifier.html">TransferForestClassifier</a></li>
8788
</ul>
8889
</li>
8990
<li class="toctree-l1"><a class="reference internal" href="../contents.html#adapt-metrics">Metrics</a><ul>
@@ -477,8 +478,8 @@
477478
</style>
478479
<section id="Rotation">
479480
<h1>Rotation<a class="headerlink" href="#Rotation" title="Permalink to this headline"></a></h1>
480-
<div class="btn btn-notebook" role="button"><p><img alt="3f548eeb62484142857cf0d514cc73f7" src="../_images/colab_logo_32px.png" /> <a class="reference external" href="https://colab.research.google.com/drive/1XePW12UF80PKzvLu9cyRJKWQoZIxk_J2?usp=sharing">Run in Google Colab</a></p>
481-
</div><div class="btn btn-notebook" role="button"><p><img alt="51599fe3c6584045a915b0fe378ac67b" src="../_images/github_logo_32px.png" /> <a class="reference external" href="https://github.com/adapt-python/notebooks/blob/d0364973c642ea4880756cef4e9f2ee8bb5e8495/Rotation.ipynb">View on GitHub</a></p>
481+
<div class="btn btn-notebook" role="button"><p><img alt="d070dd883a0740a69ea6a3a324092a24" src="../_images/colab_logo_32px.png" /> <a class="reference external" href="https://colab.research.google.com/drive/1XePW12UF80PKzvLu9cyRJKWQoZIxk_J2?usp=sharing">Run in Google Colab</a></p>
482+
</div><div class="btn btn-notebook" role="button"><p><img alt="5af0949e32964106a7d1530f5fba2cda" src="../_images/github_logo_32px.png" /> <a class="reference external" href="https://github.com/adapt-python/notebooks/blob/d0364973c642ea4880756cef4e9f2ee8bb5e8495/Rotation.ipynb">View on GitHub</a></p>
482483
</div><div class="nbinput nblast docutils container">
483484
<div class="prompt highlight-none notranslate"><div class="highlight"><pre><span></span>[2]:
484485
</pre></div>

0 commit comments

Comments
 (0)