bulc_set_ambient
Destructive
Configure ambient conditions for fire simulations by setting temperature, pressure, humidity, and gas concentrations to model realistic environmental scenarios.
Instructions
Set FDS ambient conditions including temperature, pressure, and species.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| temperature | No | Ambient temperature in Celsius. Default: 20 | |
| pressure | No | Ambient pressure in Pa. Default: 101325 | |
| humidity | No | Relative humidity (0-100%). Default: 40 | |
| o2MassFraction | No | Oxygen mass fraction. Default: 0.232 | |
| co2MassFraction | No | CO2 mass fraction. Default: 0.000595 | |
| gravity | No | Gravity vector [gx, gy, gz] in m/s². Default: [0, 0, -9.81] |
Implementation Reference
- src/tools/simulation.ts:193-200 (handler)Handler logic for the 'bulc_set_ambient' tool: validates input parameters using SetAmbientSchema and sends a 'set_ambient' command to the BULC client.
case "bulc_set_ambient": { const validated = SetAmbientSchema.parse(args); result = await client.sendCommand({ action: "set_ambient", params: validated, }); break; } - src/tools/simulation.ts:90-128 (schema)Tool schema definition for 'bulc_set_ambient', including input schema with properties for temperature, pressure, humidity, etc., description, and annotations.
{ name: "bulc_set_ambient", description: "Set FDS ambient conditions including temperature, pressure, and species.", inputSchema: { type: "object" as const, properties: { temperature: { type: "number", description: "Ambient temperature in Celsius. Default: 20", }, pressure: { type: "number", description: "Ambient pressure in Pa. Default: 101325", }, humidity: { type: "number", description: "Relative humidity (0-100%). Default: 40", }, o2MassFraction: { type: "number", description: "Oxygen mass fraction. Default: 0.232", }, co2MassFraction: { type: "number", description: "CO2 mass fraction. Default: 0.000595", }, gravity: { type: "array", description: "Gravity vector [gx, gy, gz] in m/s². Default: [0, 0, -9.81]", items: { type: "number" }, }, }, }, annotations: { readOnlyHint: false, destructiveHint: true, }, }, - src/tools/simulation.ts:147-154 (schema)Zod validation schema (SetAmbientSchema) used in the handler for input validation of 'bulc_set_ambient' tool parameters.
const SetAmbientSchema = z.object({ temperature: z.number().optional(), pressure: z.number().positive().optional(), humidity: z.number().min(0).max(100).optional(), o2MassFraction: z.number().min(0).max(1).optional(), co2MassFraction: z.number().min(0).max(1).optional(), gravity: z.array(z.number()).length(3).optional(), }); - src/index.ts:102-109 (registration)Registration/dispatch logic in main server handler: routes calls to 'bulc_set_ambient' (and related simulation tools) to handleSimulationTool.
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); }