bulc_set_output_settings
Destructive
Configure FDS visualization data output settings to control slice files, 3D smoke, and device intervals for fire simulation analysis.
Instructions
Configure FDS output settings for visualization data. Controls slice files, 3D smoke, and device output intervals.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| sliceInterval | No | Interval for slice file output in seconds. Default: 1.0 | |
| smoke3dInterval | No | Interval for 3D smoke output in seconds. Default: 1.0 | |
| deviceInterval | No | Interval for device output in seconds. Default: 1.0 | |
| plot3dInterval | No | Interval for Plot3D output in seconds. Default: 10.0 | |
| viscosityOutput | No | Include viscosity in output. Default: false | |
| massFluxOutput | No | Include mass flux in output. Default: false |
Implementation Reference
- src/tools/simulation.ts:184-190 (handler)Handler logic for the 'bulc_set_output_settings' tool: validates input arguments using Zod schema and sends a command to the BULC client with action 'set_output_settings'.
case "bulc_set_output_settings": { const validated = SetOutputSettingsSchema.parse(args); result = await client.sendCommand({ action: "set_output_settings", params: validated, }); break; - src/tools/simulation.ts:51-89 (schema)MCP tool schema definition for 'bulc_set_output_settings', including input schema and annotations.
{ name: "bulc_set_output_settings", description: "Configure FDS output settings for visualization data. " + "Controls slice files, 3D smoke, and device output intervals.", inputSchema: { type: "object" as const, properties: { sliceInterval: { type: "number", description: "Interval for slice file output in seconds. Default: 1.0", }, smoke3dInterval: { type: "number", description: "Interval for 3D smoke output in seconds. Default: 1.0", }, deviceInterval: { type: "number", description: "Interval for device output in seconds. Default: 1.0", }, plot3dInterval: { type: "number", description: "Interval for Plot3D output in seconds. Default: 10.0", }, viscosityOutput: { type: "boolean", description: "Include viscosity in output. Default: false", }, massFluxOutput: { type: "boolean", description: "Include mass flux in output. Default: false", }, }, }, annotations: { readOnlyHint: false, destructiveHint: true, }, }, - src/tools/simulation.ts:138-145 (schema)Zod schema for validating inputs to the 'bulc_set_output_settings' tool in the handler.
const SetOutputSettingsSchema = z.object({ sliceInterval: z.number().positive().optional(), smoke3dInterval: z.number().positive().optional(), deviceInterval: z.number().positive().optional(), plot3dInterval: z.number().positive().optional(), viscosityOutput: z.boolean().optional(), massFluxOutput: z.boolean().optional(), }); - src/index.ts:102-109 (registration)Registration and routing logic in main server handler: dispatches 'bulc_set_output_settings' calls to the specific handleSimulationTool function.
if ( name === "bulc_get_simulation_settings" || name === "bulc_set_simulation_time" || name === "bulc_set_output_settings" || name === "bulc_set_ambient" ) { return await handleSimulationTool(name, safeArgs); }