# Tutorial Instalasi QM Komputasi 2.4.0-r8

## Ubuntu atau WSL Ubuntu

```bash
sudo apt install ./qm-komputasi_2.4.0-8_amd64.deb
qm-komputasi
```

Buka `http://localhost:8801` jika browser tidak terbuka otomatis.

Pemeriksaan dependensi:

```bash
qm-komputasi-doctor
```

## Menjalankan kode Python

```bash
python3 -m venv qm-komputasi-env
source qm-komputasi-env/bin/activate
python -m pip install --upgrade pip
python -m pip install "streamlit>=1.63.0" numpy pandas rdkit pyscf scipy geometric pyberny ase py3Dmol
streamlit run qm-komputasi_2.4.0-r8.py --server.port=8801
```

## macOS

1. Ekstrak `QM-Komputasi-2.4.0-r8-macOS-Universal.zip`.
2. Klik kanan `INSTALL_QM_KOMPUTASI.command` dan pilih **Open/Buka**.
3. Tunggu pemasangan selesai.
4. Buka `QM Komputasi.app` dari `~/Applications`.

## Menggunakan visualisasi orbital 3D

1. Pilih backend **PySCF** dan jalankan perhitungan sampai selesai.
2. Buka hasil molekul, kemudian pilih tab **Orbital**. Alternatifnya, buka
   **Pusat Hasil → Elektronik**.
3. Pada tabel **Orbital frontier 3D interaktif**, klik baris **HOMO** atau
   **LUMO**.
4. Seret mouse untuk memutar struktur.
5. Gunakan roda mouse atau gerakan pinch untuk memperbesar dan memperkecil.
6. Atur slider **Isovalue** untuk mengubah luas lobus orbital.
7. Gunakan tombol unduh untuk menyimpan cube orbital terpilih.

Warna biru dan merah adalah fase berbeda dari fungsi gelombang orbital, bukan
muatan listrik positif dan negatif.

Jika cube tidak tersedia, periksa `progress.log`. Backend selain PySCF mungkin
menyediakan energi orbital tetapi tidak menghasilkan cube HOMO/LUMO melalui
adapter aplikasi ini.
