Plot Line
Adds a line to an existing plot visualization.
Common Properties
- Name - The custom name of the node.
- Color - The custom color of the node.
- Delay Before (sec) - Waits in seconds before executing the node.
- Delay After (sec) - Waits in seconds after executing node.
- Continue On Error - Automation will continue regardless of any error. The default value is false.
info
If the ContinueOnError property is true, no error is caught when the project is executed, even if a Catch node is used.
Inputs
- Plot ID - The unique identifier for the plot to modify.
- Data Path - The file path to the input data in CSV format.
- Date Key - The column name to be used as the date (default: "date").
- Value Key - The column name to be used as the value (default: "value").
- Name - The name for the line.
- Color - The color for the line (default: "#ff0000").
Options
- Plot Mode - The display mode for the line. Currently supports:
- Lines
- Markers
- Lines + Markers
How It Works
The Plot Line node adds a line to an existing plot visualization. When executed, the node:
- Retrieves the plot using the provided Plot ID
- Reads the line data from the specified Data Path
- Adds a scatter trace to the plot with:
- X-axis values from the Date Key column
- Y-axis values from the Value Key column
- Line color as specified
- Display mode as selected (lines, markers, or both)
- Updates the plot with the new line
Requirements
- A valid Plot ID from a previously created plot
- A CSV file with line data at the specified Data Path
- Valid column names in the CSV file (date and value columns)
Error Handling
The node will return specific errors in the following cases:
- Empty or invalid Data Path
- Issues reading CSV files
- Missing required columns in the data
Usage Notes
- The line data should be formatted to match the coordinate system of the original plot
- Colors can be specified in various formats (hex, rgb, named colors)
- For best results, ensure your line data aligns properly with the existing plot data