English | 简体中文
Introduction
To edit an ONNX model, One common way is to visualize the model graph, and edit it using ONNX Python API. This works fine. However, we have to code to edit, then visualize to check. The two processes may iterate for many times, which is time-consuming.
What if we have a tool, which allow us to edit and preview the editing effect in a totally visualization fashion?
Then onnx-modifier
comes. With it, we can focus on editing the model graph in the visualization pannel. All the editing information will be summarized and processed by Python ONNX automatically at last. Then our time can be saved!
onnx-modifier
is built based on the popular network viewer Netron and the lightweight web application framework flask.
Currently, the following editing operations are supported:
- Delete a single node.
- Delete a node and all the nodes rooted on it.
- Recover a deleted node.
- Rename the input/output name of a node.
Hope it helps!
Get started
Clone the repo and install the require Python packages by
git clone [email protected]:ZhangGe6/onnx-modifier.git
cd onnx-modifier
pip install onnx
pip install flask
Then run
python app.py
Click the url in the output info generated by flask (http://127.0.0.1:5000/
for example), then onnx-modifier
will be launched in the web browser.
Click Open Model...
to upload the ONNX model to edit. The model will be parsed and shown on the page.
Edit
top left buttons (Graph-level-operations) | sidebar buttons (Node-level-operations) |
Graph-level-operation elements are placed on the left-top of the page. Currently, there are three buttons: Preview
,Reset
and Download
. They can do:
Preview
: Preview the result model graph with all current modifications applied;Reset
: Reset the model graph to its initial state;Download
: Save the modified model into disk.
Node-level-operation elements are all in the sidebar, which can be invoked by clicking a specific node. Let's take a closer look.
Delete node
There are two modes for deleting node: Delete With Children
and Delete Single Node
. Delete Single Node
only deletes the clicked node, while Delete With Children
also deletes all the node rooted on the clicked node, which is convenient and nature if we want to delete a long path of nodes.
The implementation of
Delete With Children
is based on the backtracking algorithm.
The deleted nodes are in grey mode. The following figure shows a typical deleting process.
Recover node
By Recover Node
button, we can recover the node back to graph after deleting it.
Change the input/output name of node
By changing the input/output name of nodes, we can change the model forward routine. It can also be helpful if we want to rename the model output(s).
How can we do this using onnx-modifier
? Note that there is a RENAME HELPER
section in the node sidebar. All the original input/output names of a node (except weight parameters) are listed here, each following with a input field, where we can input the new name. After clicking the Preview
button, the graph will be rendered with the new name.
For example, Now we want remove the preprocess operators (Sub->Mul->Sub->Transpose
) shown in the following figure. We can
- click on the 1st
Conv
node, rename its input as serving_default_input:0. - click
Preview
, we can see that the model input has linked to the 1stConv
directly. And the preprocess operators have been split from the main routine. Then delete them. - we are done! click
Preview
to have a check (clickDownload
, then we can get the modified ONNX model).
Sample models
For quick testing, some typical sample models are provided as following. Most of them are from onnx model zoo
- squeezeNet Link (4.72MB)
- MobileNet Link (13.3MB)
- ResNet50-int8 Link (24.6MB)
- movenet-lightning Link (9.01MB)
- Converted from the pretrained tflite model using tensorflow-onnx;
- There are preprocess nodes and a big bunch of postprocessing nodes in the model.
onnx-modifier
is under active development
Credits and referred materials
- Netron
- flask
- ONNX Python API Official doc, Leimao's Blog
- ONNX IO Stream Leimao's Blog
- onnx-utils
- sweetalert
[https://github.com/onnx/models/blob/main/vision/classification/mobilenet/model/mobilenetv2-7.onnx]: