Paddle/doc/design/scope.md

Scope

Define

Scope is a context to manage Variables. It mainly contains a map from Variable name to Variable. Net will get and update variable throw scope.

class Scope {
    Variable GetVar();

private:
    // var_name -> var
    std::map<string, Variable> var_map_;
    Scope* parent_scope_;
}

You need to specify a scope to run a Net. One net can run in different scopes and update different variable in the scope. If you did not specify one, It will run in a default scope.

with ScopeGuard(scope)：
    Net net = Net();
    Net.run()

Chain structure

Scope has a pointer point to it's parent scope, this is mainly used in RNN when it need to create many stepNet.

Scope Guard