璁粌妯″瀷
========

褰撴垜浠噯澶囧ソ璁粌鏁版嵁闆�( ``.npz`` 鎴� ``.h5`` 鏂囦欢)銆佸喅绛栨祦鍥炬弿杩版枃浠�( ``.yaml`` ) 鍜屽鍔卞嚱鏁�( ``reward.py`` )鍚庛€�
鎴戜滑鍙互浣跨敤 ``python train.py`` 鍛戒护寮€鍚櫄鎷熺幆澧冩ā鍨嬪拰绛栫暐妯″瀷璁粌銆傝鑴氭湰灏嗗疄渚嬪寲 ``revive.server.ReviveServer`` 骞跺紑鍚缁冦€�

**璁粌鑴氭湰绀轰緥**

.. code:: bash
 
 python train.py -df <璁粌鏁版嵁鏂囦欢璺緞> -cf <鍐崇瓥娴佸浘鏂囦欢璺緞> -rf <濂栧姳鍑芥暟鏂囦欢璺緞> -vm <璁粌铏氭嫙鐜妯″紡> -pm <璁粌绛栫暐妯″瀷妯″紡> --run_id <璁粌瀹為獙鍚嶇О>


杩愯 ``train.py`` 鑴氭湰鍙畾涔夌殑鍛戒护琛屽弬鏁板涓�:

- -df: 璁粌鏁版嵁鐨勬枃浠惰矾寰�( ``.npz`` 鎴� ``.h5`` 鏂囦欢)銆�

- -vf: 楠岃瘉鏁版嵁鐨勬枃浠惰矾寰�(鍙€�)銆�

- -cf: 鍐崇瓥娴佸浘鐨勬枃浠惰矾寰�( ``.yaml`` )銆� 

- -rf: 瀹氫箟鐨勫鍔卞嚱鏁扮殑鏂囦欢璺緞( ``reward.py`` )(浠呭湪璁粌绛栫暐鏃堕渶瑕�)銆�

- -rcf: 鏀寔杩涜瓒呭弬閰嶇疆鐨� ``.json`` 鏂囦欢(鍙€�)銆�

- -tpn: 绛栫暐鑺傜偣鐨勫悕绉般€傚繀椤绘槸鍐崇瓥娴佸浘涓畾涔夌殑鑺傜偣锛涘鏋滄湭鎸囧畾锛屽湪榛樿鎯呭喌涓嬶紝鎺掑湪鎷撴墤椤哄簭绗竴浣嶇殑鑺傜偣灏嗕綔涓虹瓥鐣ヨ妭鐐广€�

- -vm: 璁粌铏氭嫙鐜鐨勪笉鍚屾ā寮�, 鍖呮嫭:
  ``once``\ ,\ ``tune``\ ,\ ``None``銆�

  - ``once`` 妯″紡: REVIVE SDK灏嗕娇鐢ㄩ粯璁ゅ弬鏁拌缁冩ā鍨嬨€�

  - ``tune`` 妯″紡: REVIVE SDK灏嗕娇鐢ㄨ秴鍙傛暟鎼滅储鏉ヨ缁冩ā鍨嬶紝闇€瑕佹秷鑰楀ぇ閲忕殑绠楀姏鍜屾椂闂达紝浠ユ悳瀵昏秴鍙傛暟鏉ヨ幏寰楁洿浼樼殑妯″瀷缁撴灉銆�
 
  - ``None`` 妯″紡: REVIVE SDK涓嶄細璁粌铏氭嫙鐜锛屽畠閫傜敤浜庤皟鐢ㄥ凡鏈夎櫄鎷熺幆澧冭繘琛岀瓥鐣ヨ缁冦€�

- -pm: 绛栫暐妯″瀷鐨勮缁冩ā寮�, 鍖呮嫭:
  ``once``\ ,\ ``tune``\ ,\ ``None``銆�

  - ``once`` 妯″紡: REVIVE SDK灏嗕娇鐢ㄩ粯璁ゅ弬鏁拌缁冩ā鍨嬨€�

  - ``tune`` 妯″紡: REVIVE SDK灏嗕娇鐢ㄨ秴鍙傛暟鎼滅储鏉ヨ缁冩ā鍨嬶紝闇€瑕佹秷鑰楀ぇ閲忕殑绠楀姏鍜屾椂闂达紝浠ユ悳瀵昏秴鍙傛暟鏉ヨ幏寰楁洿浼樼殑妯″瀷缁撴灉銆�
 
  - ``None`` 妯″紡: REVIVE SDK涓嶄細璁粌绛栫暐锛屽畠閫傜敤浜庡彧璁粌铏氭嫙鐜鑰屼笉杩涜绛栫暐璁粌鐨勬儏鍐点€�


- \--run_id: 鐢ㄦ埛涓鸿缁冨疄楠屾彁渚涚殑鍚嶇О銆俁EVIVE灏嗗垱寤� ``logs/<run_id>`` 浣滀负鏃ュ織鐩綍銆傚鏋滄湭鎻愪緵锛孯EVIVE灏嗛殢鏈虹敓鎴愬悕绉般€�

**璁粌铏氭嫙鐜鍜岀瓥鐣ユā鍨�**

::
 
 python train.py -df test_data.npz -cf test.yaml -rf test_reward.py -vm once -pm once --run_id once

 python train.py -df test_data.npz -cf test.yaml -rf test_reward.py -vm tune -pm tune --run_id tune


**鍙缁冭櫄鎷熺幆澧�**

::

 python train.py -df test_data.npz -cf test.yaml -vm once -pm None --run_id venv_once

 python train.py -df test_data.npz -cf test.yaml -vm tune -pm None --run_id venv_tune

.. note:: 闇€瑕佸畾涔夌殑濂栧姳鍑芥暟浠呭湪绛栫暐璁粌鐨勬椂鍊欓渶瑕佽鎻愪緵銆�


**鍦ㄥ凡鏈夌殑鐜妯″瀷鍩虹涓婅缁冪瓥鐣ユā鍨�**

.. important:: 褰撳崟鐙缁冪瓥鐣ユ椂锛孯EVIVE SDK灏嗘牴鎹储寮� ``run_id`` 鏌ユ壘瀹屾垚璁粌鐨勮櫄鎷熺幆澧冩ā鍨嬨€�

.. code:: bash

 python train.py -df test_data.npz -cf test.yaml -rf test_reward.py -vm None -pm once --run_id venv_once

 python train.py -df test_data.npz -cf test.yaml -rf test_reward.py -vm None -pm tune --run_id venv_tune



.. note::  ``train.py`` 鏄竴涓皟鐢≧EVIVE SDK杩涜妯″瀷璁粌鐨勯€氱敤鑴氭湰銆� 鎴戜滑涔熷彲浠ュ熀浜� ``recovery.server.ReviveServer`` 绫昏繘琛岃嚜瀹氫箟璁粌鏂规硶鐨勫紑鍙戙€�

璇峰弬闃匒PI涓殑 ``revive.server.ReviveServer`` 锛� :doc:`REVIVE API <../revive_server_cn>` 锛� 浜嗚В鏇村淇℃伅銆�

鍦ㄨ缁冭繃绋嬩腑锛屾垜浠彲浠ラ殢鏃朵娇鐢╰ensorboard鎵撳紑鏃ュ織鐩綍浠ョ洃鎺ц缁冭繃绋嬨€傚綋REVIVE SDK瀹屾垚铏氭嫙鐜妯″瀷璁粌鍜岀瓥鐣ユā鍨嬭缁冨悗銆�
鎴戜滑鍙互鍦ㄦ棩蹇楁枃浠跺す锛� ``logs/<run_id>``锛変笅鎵惧埌淇濆瓨鐨勬ā鍨嬶紙 ``.pkl`` 鎴� ``.onnx``锛夈€�


REVIVE鎻愪緵浜嗕竴涓秴鍙傛暟璋冧紭宸ュ叿锛屼娇鐢� ``tune`` 妯″紡寮€濮嬭缁冨皢鍒囨崲鍒拌秴鍙傝皟浼樻ā寮忋€�
鍦ㄨ妯″紡涓嬶紝REVIVE灏嗕粠棰勮瓒呭弬鏁扮┖闂翠腑閲囨牱澶氱粍瓒呭弬鏁扮敤浜庢ā鍨嬭缁冿紝閫氬父浣跨敤瓒呭弬璋冧紭妯″紡鍙互鑾峰緱鏇村ソ鐨勬ā鍨嬨€�
鏈夊叧瓒呭弬璋冧紭妯″紡鐨勮缁嗚鏄庯紝璇峰弬闃呮枃妗ｄ腑鐨凴EVIVE API锛�:doc:`revive.conf <../revive_conf_cn>`锛夐儴鍒嗐€�
鎴戜滑涔熷彲浠ラ€氳繃淇敼 ``config.json`` 涓殑鐩稿叧閰嶇疆鏉ヨ皟鏁磋秴鍙傛悳绱㈢┖闂村拰鎼滅储鏂规硶銆�

.. code:: bash

 python train.py -df test_data.npz -cf test.yaml -rf test_reward.py -rcf config.json --run_id test

.. note:: 绀轰緥鏁版嵁 ``test_data.npz``, ``test.yaml``, ``test_reward.py`` 鍜� ``config.json`` 瀛樺偍鍦� ``revive/data`` 鏂囦欢澶逛腑銆�