Skip to content

Getting Started

Jump to bottom
KFC edited this page Apr 25, 2025 · 1 revision

Getting Started with StructoPyre

This guide provides the essential steps to quickly launch the StructoPyre web application, import a model, and see the basic visualization concepts in action.

Overview

By following these steps, you'll be able to:

  1. Access and run the StructoPyre application.
  2. Import a 3D structural model (.obj format).
  3. Perform basic material mapping.
  4. Navigate the 3D environment.
  5. Place a conceptual fire source.
  6. Observe the initial state for the fire simulation visualization (based on default properties in this beta).

System Requirements

  • A modern web browser supporting WebGL (Latest Chrome, Firefox, or Edge recommended).
  • A stable internet connection (for the web version).
  • Mouse and Keyboard for navigation and interaction.
  • (Note: Performance may vary depending on your computer hardware and the complexity of the imported 3D model).

Accessing StructoPyre

  • Web Version:

  • Standalone Version:

    • A standalone application for both mobile and iOS is in the works. Stay tuned!

Quick Start Guide

  1. Launch the App:

    • Open the web version link provided above in your browser. You should see the Main Menu.

  2. Import Model:

    • Click the Import button on the Main Menu.
    • A file dialog will appear. Navigate to and select your .obj model file.
    • A second file dialog should appear immediately after. Select the corresponding .mtl material file (which typically has the same name as the .obj file).

  3. Map Materials:

    • The Material Mapper panel will appear, listing materials found in your model.
    • For each listed material, use the dropdown menu to select the most appropriate Real World Material (e.g., Carbonate Concrete, Siliceous Concrete).
    • Click Confirm Mappings. The model will load into the 3D view.

  4. Assign ACI Properties (Using Defaults for Beta):

    • Important Beta Note: The detailed User Interface for assigning specific ACI properties (like concrete cover, slab thickness, restraint conditions) to individual elements is currently under development.
    • For this beta version, the application automatically assigns predefined default values (e.g., 125mm default slab thickness, 25mm default cover) to elements based on their mapped material type. You can view (but not yet fully edit via UI) some properties using the Inspector Mode (see below).
    • Accurate simulation requires inputting specific project data. This feature will be expanded soon! See the User Guide for more details.

  5. Navigate the Scene:

    • Once the model loads, use the WASD keys to move forward, left, back, and right.
    • Use the Mouse to look around the environment.
    • Press C to toggle the mouse cursor visibility (freeing the mouse for looking vs. interacting with future UI).

  6. Place Fire Source (Placeholder):

    • Navigate to a location where you want to start a fire.
    • Press the X key. This will spawn a simple placeholder object (currently a grey cube) representing the fire source.

  7. Observe Initial State:

    • At this point, the simulation environment is set up.
    • (Simulation controls like Start/Pause/Reset are planned for the Simulator Mode UI, which is under development).
    • You can explore the model. In future versions, starting the simulation would begin the timer and the color-changing visualization based on calculated fire resistance times. Currently, elements will likely remain in their default (Green) state.

Next Steps

You've now successfully imported a model and set up a basic scene! For more detailed information on specific features, planned functionality, controls, and the underlying ACI concepts, please proceed to the User Guide.

Clone this wiki locally