On this page |
ML Example Raw writes a set of labeled examples to a file to directly use with ML Train Regression. ML Example Raw expects an input geometry consisting exclusively of packed primitives, each of which represents a single labeled example. See
ML Example for more details about representing examples using geometry.
This node can be referenced from TOPs using a ROP Fetch to make writing out the data set part of a recipe for doing ML.
See Machine Learning documentation for more general information.
Parameters ¶
Save to Disk
Saves the geometry to disk with the last control settings.
Save to Disk in Background
Starts another copy of Houdini in the background and instructs that copy to cook and save the geometry. This allows you to continue working and load the .raw files as they complete.
Controls…
Opens the control dialog to allow adjustments of the render parameters before rendering.
Valid Frame Range
Controls whether this render node outputs the current frame or the image sequence specified in the Start/End/Inc parameters.
Render Current Frame
Export only the current frame.
Render Frame Range
Export the frames in the Start/End/Inc frame range, but also allow exporting of frames referenced by in-range frames.
Render Frame Range Only (Strict)
Only export the frames in the Start/End/Inc frame range. Do not allow exporting of other frames, including frames referenced by in-range frames.
Start/End/Inc
Specifies the range of frames to render (start frame, end frame, and increment). All values may be floating point values. The range is inclusive.
These parameters determine the values of the local variables for the output driver.
$NRENDER
The number of frames to be rendered by the output driver.
$N
The current frame being rendered (starting at 1 and going to $NRENDER
).
Render with Take
Uses the settings in a particular take while rendering. Choose Current for the current take when rendering.
SOP Path
The SOP node, object, or SOP subnet to render from.
Output File
The file to save the binary data. The extension doesn’t matter so it depends on what system reads it. A .raw
is often used to make it clear it isn’t a defined format.
Transform
Specifies if the geometry should be transformed into world space before being written.
Labeled Examples ¶
Number of Inputs ¶
Type
Type of input contribution: either a point attribute or a volume.
Point Attribute
Name of a point float attribute.
Volume Name
The name of a volume.
Number of Targets ¶
Type
Type of target contribution: either a point attribute or a volume.
Point Attribute
Name of a point float attribute.
Volume Name
The name of the volume.
Render Settings ¶
Create Intermediate Directories
When turned on, creates intermediate parent directories for output files as needed. Currently only applies to generated scripts, images, and shadow maps.
Initialize Simulation OPs
Forces all simulation OPs to be reset. This includes DOP Networks, POP SOPs, and other OPs that cache their results.
This is the safest way to render out a simulation because it starts the simulation from scratch and discards any partial simulations with different parameters.
Alfred Style Progress
A percentage complete value is printed out as files are written. This is expected by Pixar’s Alfred render queue.
Report Network Use
The number of bytes sent or received by the distributed simulation primitives during the cooks triggered by this geometry output is printed.
This does not track used by. For example, saving a file to an NFS mount.
It only tracks the network communication of nodes such as the Gas Exchange Border DOP.
Save Retries
Sets the number of times Houdini re-attempts to save. Houdini usually errors the output node immediately when saving the geometry to disk fails due to a disk writing error. For most cases, this works because it’s an illegal path which is not recoverable. However, it sometimes failes due to network issues. The console outputs the failure to save and waits five seconds for the network to clear up.
Save in Background
When saving more than one frame, save in a background thread. Faster for large file sizes but may use more memory since it retains the output geometry until the save completes.
Scripts ¶
A script command can be specified for execution at various execution points. The expression language selected for the script parameter determines whether the command is in hscript or python.
Prior to execution, this node is automatically set as the global current node.
To run statements from a file, specify the path to the file with
either a .cmd
extension (when the language is set to Hscript) or a .py
extension (when the language is set to Python). Additional arguments to the
script can also be supplied. They will be parsed in a shell-like manner.
Pre-Render Script
Run this script before any rendering.
Pre-Frame Script
Run this script before each frame.
Post-Frame Script
Run this script after each frame.
Post-Write Script
Run this script after each frame’s data finishes writing to disk.
Post-Render Script
Run this script after all rendering.
Post-Write Script
Run this HScript
after each frame’s data has finished
writing to disk. This is always after the corresponding Post-Frame Script
and always before the Post-Render
script, but the order is undefined. When Save in Background is on,
allows delaying script actions until the file has finished
saving.
Locals ¶
N
Frame being rendered.
NRENDER
Total number of frames being rendered.
See also |