class detectron2．config．CfgNode（init＿dict＝None， key＿list＝None， new＿allowed＝False）

源代碼：https：／／detectron2．readthedocs．io／＿modules／detectron2／config／config．html＃CfgNode

基類：fvcore．common．config．CfgNode

與fvcore．common．config．CfgNode相同，但不同之處在于：

默認(rèn)情況下使用不安全的Yaml加載。

請(qǐng)注意，這可能會(huì)導(dǎo)致不安全代碼執(zhí)行：在手動(dòng)檢查文件內(nèi)容之前，切勿從不受信任的源中加載配置文件。

支持配置版本控制。

嘗試合并舊配置時(shí)，它將自動(dòng)轉(zhuǎn)換舊配置。

merge＿from＿file（cfg＿filename： str， allow＿unsafe： bool ＝ True） → None

dump（＊args， ＊＊kwargs）

返回值：str –配置的yaml字符串表示形式

DEPRECATED＿KEYS＝ ＇＿＿deprecated＿keys＿＿＇

IMMUTABLE＝ ＇＿＿immutable＿＿＇

NEW＿ALLOWED＝ ＇＿＿new＿allowed＿＿＇

RENAMED＿KEYS＝＇＿＿renamed＿keys＿＿＇

＿＿init＿＿（init＿dict＝None， key＿list＝None， new＿allowed＝False）

參數(shù)：

init＿dict（dict）–可能嵌套的字典，用于初始化CfgNode。

key＿list（list ［ str ］）–名稱列表，從根目錄索引此CfgNode。當(dāng)前僅用于記錄目的。

new＿allowed（bool）–與其他配置合并時(shí)是否允許添加新密鑰。

clear（） → None，從D刪除所有項(xiàng)目

clone（）

遞歸復(fù)制此CfgNode。

copy（） → D的淺副本

defrost（）

使此CfgNode及其所有子代可變。

freeze（）

使此CfgNode及其所有子代不變。

fromkeys（）

使用可迭代的鍵并將值設(shè)置為value創(chuàng)建一個(gè)新字典。

get（）

如果key在字典中，則返回key的值，否則返回默認(rèn)值。

is＿frozen（）

返回可變性。

is＿new＿allowed（）

items（） → 提供D的項(xiàng)目視圖的類集合對(duì)象

key＿is＿deprecated（full＿key）

測(cè)試是否不支持使用密鑰。

key＿is＿renamed（full＿key）

測(cè)試密鑰是否被重命名。

keys（） → 提供D鍵視圖的類集合對(duì)象

class method load＿cfg（cfg＿file＿obj＿or＿str）

加載cfg：param cfg＿file＿obj＿or＿str：支持從以下對(duì)象加載：

由YAML文件支持的文件對(duì)象

由Python源文件支持的文件對(duì)象，該文件對(duì)象導(dǎo)出dict或CfgNode屬性＂cfg＂

可以解析為有效YAML的字符串

static load＿yaml＿with＿base（filename： str， allow＿unsafe： bool ＝ False）

就像yaml．load（open（filename））一樣，但從其繼承屬性

參數(shù)：

filename（str）：當(dāng)前配置的文件名。將用于查找基本配置文件。

allow＿unsafe（bool）：是否允許使用yaml．unsafe＿load加載配置文件 。

返回值：（字典） 已加載的Yaml

merge＿from＿list（cfg＿list： list）

參數(shù)：   cfg＿list（list）：要合并的配置列表。

merge＿from＿other＿cfg（cfg＿other）

參數(shù)：   cfg＿other（CfgNode）要合并的配置。

pop（k［， d］） → v， remove specified key and return the corresponding value．

如果找不到鍵，則返回d（如果給出），否則引發(fā)KeyError

popitem（） → （k， v）， remove and return some （key， value） pair as a

2元組； 但如果D為空，則引發(fā)KeyError。

raise＿key＿rename＿error（full＿key）

register＿deprecated＿key（key）

注冊(cè)密鑰（例如FOO．BAR）已棄用的選項(xiàng)。合并不支持使用的密鑰時(shí)，將生成警告，并且該密鑰將被忽略。

register＿renamed＿key（old＿name， new＿name， message＝None）

將密鑰注冊(cè)從old＿name重命名為new＿name。合并重命名的密鑰時(shí)，會(huì)引發(fā)異常，警告用戶該密鑰已被重命名。

setdefault（）

如果key不在字典中，則插入具有默認(rèn)值的key。

如果key在字典中，則返回key的值，否則返回默認(rèn)值。

update（［E， ］＊＊F） → None． Update D from dict／iterable E and F．

如果E存在并且具有．keys（）方法，則執(zhí)行：for k in E： D［k］ ＝ E［k］

如果E存在并且沒有．keys（）方法，則執(zhí)行：for k， v in E： D［k］ ＝ v

在任一情況下，都跟著：for k in F： D［k］ ＝ F［k］

values（） → 提供D值視圖的對(duì)象

detectron2．config．get＿cfg（） → detectron2．config．config．CfgNode

源代碼：https：／／detectron2．readthedocs．io／＿modules／detectron2／config／config．html＃get＿cfg

獲取默認(rèn)配置的副本。

返回值：   一個(gè)detectron2 CfgNode實(shí)例。

detectron2．config．set＿global＿cfg（cfg： detectron2．config．config．CfgNode） → None

源代碼：https：／／detectron2．readthedocs．io／＿modules／detectron2／config／config．html＃set＿global＿cfg

讓全局配置指向給定的cfg。

假定給定的＂cfg＂具有鍵＂KEY＂，在調(diào)用 set＿global＿cfg（cfg）之后，可以通過以下方式訪問該鍵：

from detectron2．config import global＿cfg

print（global＿cfg．KEY）

通過使用hacky全局配置，你可以在任何地方訪問這些配置，而不必將配置對(duì)象或值傳遞到代碼中。這是為快速原型設(shè)計(jì)／研究探索而引入的一項(xiàng)功能強(qiáng)大的功能。

detectron2．config．downgrade＿config（cfg： detectron2．config．config．CfgNode， to＿version： int） → detectron2．config．config．CfgNode

源代碼：https：／／detectron2．readthedocs．io／＿modules／detectron2／config／compat．html＃downgrade＿config

將配置從當(dāng)前版本降級(jí)到舊版本。

參數(shù)：

cfg（CfgNode）

to＿version（int）

注意

由于不同版本中的功能不同，通常無法對(duì)任意配置進(jìn)行普遍降級(jí)。降級(jí)的目的僅是恢復(fù)舊版本中的默認(rèn)設(shè)置，從而允許它加載舊的部分Yaml配置，因此僅當(dāng)無法進(jìn)行一般降級(jí)時(shí)，實(shí)現(xiàn)才需要填寫舊版本中的默認(rèn)值。

detectron2．config．upgrade＿config（cfg： detectron2．config．config．CfgNode， to＿version： Optional［int］ ＝ None） → detectron2．config．config．CfgNode

源代碼：https：／／detectron2．readthedocs．io／＿modules／detectron2／config／compat．html＃upgrade＿config

將配置從當(dāng)前版本升級(jí)到更高版本。

參數(shù)：

cfg（CfgNode）

to＿version（int）默認(rèn)為最新版本。