...
Tip |
---|
You can deploy it on your render farm to use it in a post-render process for labeling of elements. |
How To
Simple usage
Code Block | ||
---|---|---|
| ||
classifier {file} |
...
Info |
---|
Valid file paths are …
|
Multiple files
You can pass multiple file paths to the software.
...
Code Block | ||
---|---|---|
| ||
classifier /path/to/files.#.exr /path/to/another/file.mov # result: {"/path/to/files.#.exr": [{"label": "fire", "description": "rapid oxidation of a material", "value": "Q3196"}], "/path/to/another/file.mov": [{"label": "torch", "description": "stick with a flaming end used as a source of light", "value": "Q327954"}]} |
Multiple results
Get the top X predicted categories by using the flag: --top {number}
Code Block | ||
---|---|---|
| ||
classifier -top 3 /path/to/file.mov # result: {"/path/to/file.mov": [ {"label": "torch", "description": "stick with a flaming end used as a source of light", "value": "Q327954"}, {"label": "fire", "description": "rapid oxidation of a material", "value": "Q3196"}, {"label": "flame", "description": "visible, gaseous part of a fire", "value": "Q235544"} ]} |
Python Example
Here is an example code snippet that you could use in your python code.
Code Block | ||
---|---|---|
| ||
# print the top 3 label predictions for a given file path import json import subprocess path = '/path/to/file.mov' command = ['./classifier', '--top', '3', path] process = subprocess.Popen(command, stdout=subprocess.PIPE, stderr=subprocess.PIPE) output, error = process.communicate() if process.returncode != 0: print('Something went wrong: {} - Error: {}'.format(path, error)) else: result = json.loads(output) for path, predictions in result.items(): wikidata_ids = [item['value'] for item in predictions] # list of IDs from wikidata readable_labels = [item['label'] for item in predictions] # list of human readable labels print('For path: "{}" predicted the labels: {}'.format(path, ', '.join(readable_labels))) # result: # For path: "/path/to/file.mov" predicted the labels: torch, flame, fire |
Software info
Get information about the current software version and the categories that can be classified.
...
key | description |
---|---|
| the identifier for the class from Wikidata |
| meaningful readable label |
| a list of different words for this class |
Result Format
For each file path you get an list of predictions for labels.
...
key | description |
---|---|
| identifier value - see here for more details |
| human readable text of this category |
| description text for this category |
| the parent labels based on the category hierarchy structure |
Flags
These are the flags that can be set
flag | description | ||
---|---|---|---|
| Shows information the software. | ||
| Get the top X predictions of labels.
| ||
| File path to another model file (.wit) | ||
| Set the number of frames of a filmstrip for a sequence of images or movie file.
| ||
| debugging mode |
Troubleshooting
issue | solution |
---|---|
MacOS shows unidentified developer for 'ffprobe' | For MacOS you should add the ffprobe to your trusted applications if you want to use the software. |
...