OsdagBridge

Getting Started

A quick tour of the desktop app, web app, and CLI — pick whichever fits your workflow.

1. Launch the desktop application

The fastest way to get productive if you installed via the Windows or Linux installer.

  1. Open OsdagBridge

    Use the desktop shortcut created by the installer, or run it manually from a source checkout:

    python -m osdagbridge.desktop

  2. Create a new bridge project

    Choose a bridge type (currently Plate Girder Bridge), then fill in the input form covering geometry, materials, and loading.

  3. Run the analysis

    Select an analysis backend — the native solver, OpenSeesPy, or OspGrillage — and run the analysis and design checks.

  4. Generate a report

    Export a full design report (PDF) once the design passes all IRC code checks.

2. Use the command-line interface

Ideal for scripting, batch runs, and CI pipelines.

# Run an analysis from a project definition
osdagbridge analyze project.yaml --solver native

# Generate a PDF report from the analyzed project
osdagbridge report project.yaml report.pdf

Project files are plain YAML, so they're easy to version-control and diff alongside your other engineering artifacts.

3. Run the web application

The Django + React stack for browser-based, multi-user access.

Backend

python src/osdagbridge/web/backend/manage.py runserver

Frontend

cd src/osdagbridge/web/frontend
npm install
npm start

Next steps

Dig deeper into how OsdagBridge is put together.

Architecture

How the shared core, bridge types, and components fit together.

Read the architecture guide

Developer Guide

Contributing workflow, code locations, and testing.

Read the developer guide

User Guide

In-depth usage notes for the desktop, web, and CLI interfaces.

Read the user guide