Metadata-Version: 2.4
Name: shardhana
Version: 0.0.1.post4
Summary: Shardhana structural analysis core (experimental)
Author: Lee Seok
License: MIT
Requires-Python: >=3.9
Description-Content-Type: text/markdown
License-File: LICENSE
Dynamic: license-file

# 🏗️ Shardhana Project

**Shardhana** is an open-source structural analysis software applying the **Applied Element Method (AEM)** for **architectural structural engineering**.  
Launched on **August 15, 2025 — the 80th Korean Liberation Day**, this project aims to combine engineering expertise, open-source collaboration, and modern computing to create accurate, scalable, and innovative tools for simulating and understanding structural behavior.

---

## 🎯 Method

Shardhana ultimately aims to become an open-source platform  
driven by the HEM (Han Element Method) core, beyond FEM and AEM.

Here, “Han” carries layered meanings:
it represents “one” — the unity behind Shardhana —
as well as “Han” (恨), the condensed accumulation of human intent, experience, and inner tension.

Curious how the HEM core will bring the real world into computer simulation? ^^

---

샤드하나는 궁극적으로 FEM과 AEM을 넘어  
HEM(Han Element Method) 코어로 실행되는 오픈 소스 플랫폼을 지향합니다.

여기서 ‘한(Han)’은  
이 프로젝트 샤드하나의 ‘하나(one)’라는 의미와,  
사람의 마음속에 응축된 덩어리인 ‘한(恨)’의 의미를 함께 담고 있습니다.

HEM 코어가 현실 세상을 어떻게 컴퓨터 시뮬레이션 속에 담아낼지,  
궁금하지 않으신가요? ^^

## 🎯 Purpose

- **Build accessible FEM and AEM foundations toward HEM**
  for a global engineering community  
- **Encourage open collaboration** in structural analysis software development  
- **Bridge academic research and real-world engineering**  
- **Foster innovation** through shared knowledge and tools  

---

## 🚀 Vision

Our ultimate goal is to become the starting platform  
for designing every structure — not only on Earth, but across space.  
Like air, it should be free for everyone to use,  
without the cost barriers of specific organizations or corporations.  
Shardhana takes the first step toward this shared, open-source structural analysis platform.  

**🇰🇷 비전 (한국어)**  
우리의 궁극적인 목표는 지구뿐만 아니라 우주에 건설되는  
모든 구조물을 설계할 수 있는 출발 플랫폼이 되는 것입니다.  
공기처럼 누구나 자유롭게, 특정 집단이나 기업의 비용 장벽 없이  
사용할 수 있는 구조해석 환경을 만드는 것 —  
Shardhana는 그 첫걸음을 내딛습니다.

---

## 🧭 Development Direction

Shardhana is built on a **Local-first, Cloud-optional** architecture.

For detailed design principles, see:
👉 [Shardhana Development Vision](docs/shardhana-vision.md)

---

## 🌟 Project Goals

1. **Develop a core AEM engine** capable of realistic structural simulation under various loads and failure scenarios  
2. **Ensure scalability** from small experimental models to large architectural structures  
3. **Promote open-source culture** in structural engineering  
4. **Provide learning resources** for engineers, students, and researchers to understand AEM and structural mechanics  

---

## 🔐 License

Shardhana is released under the **GNU General Public License v3.0 (GPL-3.0)**,  
as published by the Free Software Foundation on **June 29, 2007**.

This license grants you the freedom to:
- use the software for any purpose,
- study how it works and modify it,
- redistribute original or modified versions,

as long as derivative works remain under the same GPL license.

See the [`LICENSE`](./LICENSE) file for the full license text.

---

### 👤 Maintainer

[michin-jjangddol](https://github.com/michin-jjangddol)


## Quick Start

```bash
pip install shardhana
python -m shardhana
```

---

## Links

- Website: https://shardhana.org
- YouTube: https://youtube.com/@Shardhana-lab

---

> This document was written with the assistance of Shana (GPT).
> 이 문서는 샤나(GPT)의 도움으로 작성된 문서입니다.
