Skip to content

Latest commit

 

History

History
111 lines (95 loc) · 4.51 KB

USER_MANUAL.md

File metadata and controls

111 lines (95 loc) · 4.51 KB

User Manual

Info ...
Created by Yanqing Wu yanqing.wu@nxp.com
Updated by Yanqing Wu yanqing.wu@nxp.com
Last Updated Dec. 17th, 2018

This file introduces the new features which added for AIRunner on Netron.

If you experience bugs using Netron, please report to Yanqing yanqing.wu@nxp.com.

Content

Load Configuration

  • Allows users to load own configuration files
    • Important: Please ensure file name ended with {your_filename}_config.json
    • Important: In the config JSON, please ensure the first key value matches with {your_filename}
  • Clear Cache (on top menu) every time before loading *_config.json
  • The *_config.json file will auto create upon Export/Save on Group Nodes Mode
    • The file combines {}_custom_attributes.json and {}_subgraph_grouping.json, which can be modified separately
  • For developers
    • There are script's methods to merge/split user's configuration JSON in {Netron root}/src/json-manipulate.json
    • When being loaded, *_config.json will be splitted into *_custom_attributes.json and *_subgraph_grouping.json for further operations

Export Text File

alt text

Features

  • Allows user to exports the configuration of input model to text file (.txt or .json) to local machine
  • Able to support more models if corresponding Python executable is available (user need NOT Python installed)
  • Supported models:
    • .pb

To Use

  • File -> Export Text File (or Ctrl/Cmd + Shift + J)

Custom Attributes

alt text

Features

  • Allows user to set custom attributes of specific nodes, and automatically saves custom setting to local .json file
  • Allows users to modify available attributes in the configuration file:
    • {Netron root}/user_json/config_json/airunner_custom_attributes.json
  • Allows users to modify the unsupported combinations of custom attribute in the configuration file:
    • {Netron root}/user_json/config_json/airunner_check_list.json
  • Supported models:
    • ALL models

To Use

  • Use mouse to right-click on your target node

Group Nodes Mode

alt text

Features

  • Allows user to group nodes (i.e. layers) into subgraphs, and exports/saves the group setting to local .json file
  • Allows user to edit group settings on Netron
    • Add/Delete/Rename sub-graphs
    • Add/Delete a node (layer) in a sub-graph
    • Add nodes in a sub-graph (after user specifies the start-node and end-node)
  • Supported models:
    • .pb, .caffemodel, .h5, .onnx
    • May supports other models but not guaranteed

To Use

  • Open: Edit -> Group Nodes Mode (or Ctrl/Cmd + G)
  • Add a new group: click New Subgraph
  • Delete a group: click on the X on the right side
  • Rename a group: click on the N on the right side
    • Subgraph naming only supports
      • English alphabet ([A-Z]+[a-z])
      • Arabic numerals ([0-9])
      • Underscores (_)
  • Add a node to a group:
    • click on target group to select it
    • click on any nodes to add it to the group
    • click targeted group again to de-select it
  • Delete a node in a group:
    • click on the target node on the leftside panel (this action cannot be undone)
  • Add a series of ndoes to a group
    • click on target group to select it
    • click Start Node
    • choose your start-node on the graph
    • click End Node
    • choose your end-node on the graph
    • click Traverse to automatically add nodes which are between start-node and end-node
      • If undesired node(s) is added, can delete it by click on the node name on the leftside panel
  • Save group settings:
    • click Export (for first time grouping) or Save (to overwrite old settings)
  • Color groups:
    • After you saved your group settings, press F5

Hide Node

  • Allows user to only render (show) supported operations on GUI
    • Config: {Netron root}/user_json/config_json/airunner_supported_operations.json
  • Unsupported operations will be shown in a message box