Skip to content
This repository has been archived by the owner on Sep 18, 2024. It is now read-only.

update doc: NNI core capacities in Overview.md, standalone mode in Trials.md #1821

Merged
merged 7 commits into from
Dec 10, 2019

Conversation

QuanluZhang
Copy link
Contributor

@QuanluZhang QuanluZhang commented Dec 5, 2019

describe core capacities of NNI, including hyperparameter tuning, neural architecture search, model compression, and feature engineering.

describe standalone mode, in which trial code can run without NNI experiment for easy debug.

@QuanluZhang QuanluZhang changed the title update doc: overview.md update doc: NNI core capacities in Overview.md, standalone mode in Trials.md Dec 5, 2019
docs/en_US/Overview.md Outdated Show resolved Hide resolved
docs/en_US/Overview.md Outdated Show resolved Hide resolved
docs/en_US/Overview.md Outdated Show resolved Hide resolved
docs/en_US/Overview.md Outdated Show resolved Hide resolved
@xuehui1991 xuehui1991 closed this Dec 5, 2019
@xuehui1991 xuehui1991 reopened this Dec 5, 2019
docs/en_US/Overview.md Show resolved Hide resolved
docs/en_US/TrialExample/Trials.md Outdated Show resolved Hide resolved
@@ -127,6 +127,23 @@ In the YAML configure file, you need to set *useAnnotation* to true to enable NN
useAnnotation: true
```

## Standalone mode for debug
Copy link
Member

Choose a reason for hiding this comment

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

Add this to "Overview>Key Concepts" section too?

docs/en_US/Tutorial/HowToDebug.md Show resolved Hide resolved
docs/en_US/Tutorial/HowToDebug.md Outdated Show resolved Hide resolved
@@ -127,6 +127,23 @@ In the YAML configure file, you need to set *useAnnotation* to true to enable NN
useAnnotation: true
```

## Standalone mode for debug

NNI supports standalone mode for trial code to run without starting an NNI experiment. This is for finding out bugs in trial code more conveniently. NNI annotation natively supports standalone mode, as the added NNI related lines are comments. For NNI trial APIs, the APIs have changed behaviors in standalone mode, some APIs return fake/empty values, and some APIs do not really report values. Details are shown below.
Copy link
Member

Choose a reason for hiding this comment

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

"standalone mode" sounds confusing... may we call it "single trial debug mode" or something more clear connect to "trial".

@@ -127,6 +127,23 @@ In the YAML configure file, you need to set *useAnnotation* to true to enable NN
useAnnotation: true
```

## Standalone mode for debug

NNI supports standalone mode for trial code to run without starting an NNI experiment. This is for finding out bugs in trial code more conveniently. NNI annotation natively supports standalone mode, as the added NNI related lines are comments. For NNI trial APIs, the APIs have changed behaviors in standalone mode, some APIs return fake/empty values, and some APIs do not really report values. Details are shown below.
Copy link
Member

Choose a reason for hiding this comment

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

For NNI trial APIs, the APIs have changed behaviors in standalone mode, some APIs return fake/empty values, and some APIs do not really report values. Details are shown below.

In trial debug model, experiment related fields are filled with dummy values, please refer to the following table for the full lists of these fields.

@@ -46,6 +46,33 @@ For each experiment, user only needs to define a search space and update a few l

More details about how to run an experiment, please refer to [Get Started](Tutorial/QuickStart.md).

## Core Features
Copy link
Member

Choose a reason for hiding this comment

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

I'm thinking to replace this or put this ahead of the current "easy-to-use", "scalability", etc. section. let's discuss more in our scrum today.

@scarlett2018 scarlett2018 mentioned this pull request Dec 6, 2019
44 tasks
Copy link
Member

@scarlett2018 scarlett2018 left a comment

Choose a reason for hiding this comment

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

Approved for quick iterative update.

@QuanluZhang QuanluZhang merged commit 522f847 into microsoft:master Dec 10, 2019
@QuanluZhang QuanluZhang deleted the doc-update-overview branch February 20, 2020 13:58
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

5 participants