Skip to content

[Fix] docs links #201

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 4 commits into from
May 7, 2021
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
11 changes: 6 additions & 5 deletions .github/workflows/examples.yml
Original file line number Diff line number Diff line change
Expand Up @@ -30,8 +30,9 @@ jobs:
echo "::set-output name=BEFORE::$(git status --porcelain -b)"
- name: Run tests
run: |
python examples/tabular/20_basics/example_tabular_classification.py
python examples/tabular/20_basics/example_tabular_regression.py
python examples/tabular/40_advanced/example_custom_configuration_space.py
python examples/tabular/40_advanced/example_resampling_strategy.py
python examples/example_image_classification.py
python examples/20_basics/example_image_classification.py
python examples/20_basics/example_tabular_classification.py
python examples/20_basics/example_tabular_regression.py
python examples/40_advanced/example_custom_configuration_space.py
python examples/40_advanced/example_resampling_strategy.py
python examples/40_advanced/example_visualization.py
23 changes: 16 additions & 7 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -7,7 +7,7 @@ So far, Auto-PyTorch supports tabular data (classification, regression).
We plan to enable image data and time-series data.


Find the documentation [here](https://automl.github.io/Auto-PyTorch/refactor_development)
Find the documentation [here](https://automl.github.io/Auto-PyTorch/development)


## Installation
Expand All @@ -31,7 +31,7 @@ python setup.py install
If you want to contribute to Auto-PyTorch, clone the repository and checkout our current development branch

```sh
$ git checkout refactor_development
$ git checkout development
```


Expand Down Expand Up @@ -71,7 +71,20 @@ along with this program (see LICENSE file).

## Reference

Please refer to the branch `TPAMI.2021.3067763` to reproduce the paper *Auto-PyTorch Tabular: Multi-Fidelity MetaLearning for Efficient and Robust AutoDL*.

```bibtex
@article{zimmer-tpami21a,
author = {Lucas Zimmer and Marius Lindauer and Frank Hutter},
title = {Auto-PyTorch Tabular: Multi-Fidelity MetaLearning for Efficient and Robust AutoDL},
journal = {IEEE Transactions on Pattern Analysis and Machine Intelligence},
year = {2021},
note = {IEEE early access; also available under https://arxiv.org/abs/2006.13799},
pages = {1-12}
}
```

```bibtex
@incollection{mendoza-automlbook18a,
author = {Hector Mendoza and Aaron Klein and Matthias Feurer and Jost Tobias Springenberg and Matthias Urban and Michael Burkart and Max Dippel and Marius Lindauer and Frank Hutter},
title = {Towards Automatically-Tuned Deep Neural Networks},
Expand All @@ -81,14 +94,10 @@ along with this program (see LICENSE file).
booktitle = {AutoML: Methods, Sytems, Challenges},
publisher = {Springer},
chapter = {7},
pages = {141--156},
note = {To appear.},
pages = {141--156}
}
```

**Note**: Previously, the name of the project was AutoNet. Since this was too generic, we changed the name to AutoPyTorch. AutoNet 2.0 in the reference mention above is indeed AutoPyTorch.


## Contact

Auto-PyTorch is developed by the [AutoML Group of the University of Freiburg](http://www.automl.org/).
8 changes: 5 additions & 3 deletions docs/conf.py
Original file line number Diff line number Diff line change
Expand Up @@ -16,6 +16,7 @@
# add these directories to sys.path here. If the directory is relative to the
# documentation root, use os.path.abspath to make it absolute, like shown here.

import datetime
import os
import sys
import sphinx_bootstrap_theme
Expand Down Expand Up @@ -68,9 +69,9 @@

sphinx_gallery_conf = {
# path to the examples
'examples_dirs': ['../examples/tabular/20_basics', '../examples/tabular/40_advanced'],
'examples_dirs': '../examples',
# path where to save gallery generated examples
'gallery_dirs': ['basics_tabular', 'advanced_tabular'],
'gallery_dirs': 'examples',
#TODO: fix back/forward references for the examples.
#'doc_module': ('autoPyTorch'),
#'reference_url': {
Expand Down Expand Up @@ -107,7 +108,8 @@

# General information about the project.
project = u'AutoPyTorch'
copyright = u'2014-2019, Machine Learning Professorship Freiburg'
copyright = u"2014-{}, Machine Learning Professorship Freiburg".format(
datetime.datetime.now().year)

# The version info for the project you're documenting, acts as replacement for
# |version| and |release|, also used in various other places throughout the
Expand Down
10 changes: 5 additions & 5 deletions docs/manual.rst
Original file line number Diff line number Diff line change
Expand Up @@ -16,11 +16,11 @@ We expand the support to image processing tasks in the future.

Examples
========
* `Classification <examples/tabular/20_basics/example_tabular_classification.html>`_
* `Regression <examples/tabular/20_basics/example_tabular_regression.html>`_
* `Customizing the search space <examples/tabular/40_advanced/example_custom_configuration_space.html>`_
* `Changing the resampling strategy <examples/tabular/40_advanced/example_resampling_strategy.html>`_
* `Visualizing the results <examples/tabular/40_advanced/example_visualization.html>`_
* `Classification <examples/20_basics/example_tabular_classification.html>`_
* `Regression <examples/20_basics/example_tabular_regression.html>`_
* `Customizing the search space <examples/40_advanced/example_custom_configuration_space.html>`_
* `Changing the resampling strategy <examples/40_advanced/example_resampling_strategy.html>`_
* `Visualizing the results <examples/40_advanced/example_visualization.html>`_

Resource Allocation
===================
Expand Down
File renamed without changes.
Original file line number Diff line number Diff line change
Expand Up @@ -40,11 +40,12 @@
# Build and fit a classifier
# ==========================
api = TabularClassificationTask(
temporary_directory='./tmp/autoPyTorch_example_tmp_01',
output_directory='./tmp/autoPyTorch_example_out_01',
# To maintain logs of the run, set the next two as False
delete_tmp_folder_after_terminate=True,
delete_output_folder_after_terminate=True,
# To maintain logs of the run, you can uncomment the
# Following lines
# temporary_directory='./tmp/autoPyTorch_example_tmp_01',
# output_directory='./tmp/autoPyTorch_example_out_01',
# delete_tmp_folder_after_terminate=False,
# delete_output_folder_after_terminate=False,
seed=42,
)

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -48,13 +48,7 @@
############################################################################
# Build and fit a regressor
# ==========================
api = TabularRegressionTask(
temporary_directory='./tmp/autoPyTorch_example_tmp_02',
output_directory='./tmp/autoPyTorch_example_out_02',
# To maintain logs of the run, set the next two as False
delete_tmp_folder_after_terminate=True,
delete_output_folder_after_terminate=True
)
api = TabularRegressionTask()

############################################################################
# Search for an ensemble of machine learning algorithms
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -43,11 +43,6 @@
# Build and fit a classifier with default resampling strategy
# ===========================================================
api = TabularClassificationTask(
temporary_directory='./tmp/autoPyTorch_example_tmp_03',
output_directory='./tmp/autoPyTorch_example_out_03',
# To maintain logs of the run, set the next two as False
delete_tmp_folder_after_terminate=True,
delete_output_folder_after_terminate=True,
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

actually there are more tasks defined in this example. Could you also remove the temporary and output directory there?

# 'HoldoutValTypes.holdout_validation' with 'val_share': 0.33
# is the default argument setting for TabularClassificationTask.
# It is explicitly specified in this example for demonstrational
Expand Down Expand Up @@ -85,11 +80,6 @@
# Build and fit a classifier with Cross validation resampling strategy
# ====================================================================
api = TabularClassificationTask(
temporary_directory='./tmp/autoPyTorch_example_tmp_04',
output_directory='./tmp/autoPyTorch_example_out_04',
# To maintain logs of the run, set the next two as False
delete_tmp_folder_after_terminate=True,
delete_output_folder_after_terminate=True,
resampling_strategy=CrossValTypes.k_fold_cross_validation,
resampling_strategy_args={'num_splits': 3}
)
Expand Down Expand Up @@ -123,11 +113,6 @@
# Build and fit a classifier with Stratified resampling strategy
# ==============================================================
api = TabularClassificationTask(
temporary_directory='./tmp/autoPyTorch_example_tmp_05',
output_directory='./tmp/autoPyTorch_example_out_05',
# To maintain logs of the run, set the next two as False
delete_tmp_folder_after_terminate=True,
delete_output_folder_after_terminate=True,
# For demonstration purposes, we use
# Stratified hold out validation. However,
# one can also use CrossValTypes.stratified_k_fold_cross_validation.
Expand Down