File size: 3,193 Bytes
0ae49b9
 
 
 
 
 
 
e790e03
 
 
 
0ae49b9
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
90cefa9
0ae49b9
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
<h1 align="center">
  <a href="https://github.com/GitsSaikat/Pavement-App">
    <img src="Pavement.jpg" width="215" /></a><br>
  <b>🛣️ Mechanistic-Empirical Pavement Design Tool</b><br>
</h1>


Welcome to the **Mechanistic-Empirical Pavement Design Tool for Highways and Airports**! This application is designed to assist engineers and researchers in designing and evaluating pavement structures based on traffic, material, and environmental data. 

**The app is available at:** [https://pavement-design-app.streamlit.app/](https://pavement-design-app.streamlit.app/)


---

## 🚀 Features

- **Input Data**: Upload or manually input traffic, climate, subgrade, and material data.
- **Pavement Design**: Define pavement layers, material properties, and costs.
- **Simulation**: Analyze pavement performance under various conditions.
- **Lifecycle Cost Analysis (LCCA)**: Evaluate the economic efficiency of pavement designs.
- **Results Visualization**: View performance predictions, cost analysis, and pavement design details with interactive charts.
- **Report Generation**: Create and download detailed reports in PDF format.

---

## 🛠️ Installation

   ```bash
   git clone https://github.com/GitsSaikat/Pavement-App.git
   cd pavement-design-tool
   pip install -r requirements.txt
   streamlit run app.py
  ```

## Project Structure


-   `app.py`: Main Streamlit application file.
-   `Pavement.jpg`: Image used in the application.
-   `src/`: Source code directory.
    -   `models.py`: Contains data model classes.
    -   `performance.py`: Includes functions for pavement performance simulation.
    -   `lcca.py`: Functions for life cycle cost analysis.
    -   `reporting.py`: Functions for report generation.
    -   `design.py`: Functions for designing the pavement structure.
    -   `utils/`: Contains utility scripts.
        -   `helpers.py`: Helper functions for file reading and saving.
        -   `logger.py`: Setting up logging.
-   `README.md`: This file, contains project documentation

## Usage

**Input Data**: Either upload your data using an Excel file or manually enter all the required data to proceed with the design.
    -   **Excel File**: Make sure your Excel file contains sheets named 'Traffic', 'Climate', 'Subgrade' and 'Materials' with the correct columns. See instructions on the page.
    -   **Manual Entry**: Alternatively, fill the forms with the respective data fields, in which the comma separated values are supported in axle loads inputs.

**Design Pavement**: Define the pavement layers by entering the number of layers and then configure the type and thickness of each one.

**Run Simulation**: Set initial costs, maintenance costs, discount rate, and analysis period to run the pavement simulation and LCCA.

**View Results**: Analyze the simulation results, lifecycle cost, and pavement design details through tables and charts.

**Generate Report**: Create a comprehensive PDF report of your analysis.

## Contributing

Contributions are welcome! If you find a bug or have suggestions for new features, please open an issue or submit a pull request.

## License

This project is licensed under the [MIT License](LICENSE).