bulc_set_simulation_time
Destructive
Configure FDS simulation duration and time step parameters to control fire simulation runtime and computational accuracy in building design.
Instructions
Set FDS simulation time parameters. Controls simulation duration and time step settings.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| duration | Yes | Total simulation time in seconds. Required. | |
| dtInit | No | Initial time step in seconds. Default: auto (FDS calculates) | |
| dtMax | No | Maximum time step in seconds. Default: auto |
Implementation Reference
- src/tools/simulation.ts:175-182 (handler)Handler logic for the 'bulc_set_simulation_time' tool. Validates input parameters using Zod's SetSimulationTimeSchema and sends a 'set_simulation_time' command with the validated params to the BULC client via getBulcClient().
case "bulc_set_simulation_time": { const validated = SetSimulationTimeSchema.parse(args); result = await client.sendCommand({ action: "set_simulation_time", params: validated, }); break; } - src/tools/simulation.ts:132-136 (schema)Zod schema for validating the tool's input: required 'duration' (positive number), optional 'dtInit' and 'dtMax' (positive numbers).
const SetSimulationTimeSchema = z.object({ duration: z.number().positive(), dtInit: z.number().positive().optional(), dtMax: z.number().positive().optional(), }); - src/tools/simulation.ts:23-50 (schema)Tool definition object including name, description, inputSchema (JSON schema), and annotations. Used for tool listing and basic validation.
{ name: "bulc_set_simulation_time", description: "Set FDS simulation time parameters. " + "Controls simulation duration and time step settings.", inputSchema: { type: "object" as const, properties: { duration: { type: "number", description: "Total simulation time in seconds. Required.", }, dtInit: { type: "number", description: "Initial time step in seconds. Default: auto (FDS calculates)", }, dtMax: { type: "number", description: "Maximum time step in seconds. Default: auto", }, }, required: ["duration"], }, annotations: { readOnlyHint: false, destructiveHint: true, }, }, - src/index.ts:102-109 (registration)Registration/dispatch in main CallToolRequestSchema handler: routes calls to 'bulc_set_simulation_time' (and related simulation tools) to the 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); } - src/index.ts:47-47 (registration)Inclusion of simulationTools array (containing the tool definition) into the allTools list provided in ListToolsRequestSchema response.
...simulationTools, // 4 tools: get_settings, time, output, ambient