https://github.com/mohamedelashri/root
Repository to build ROOT versions
https://github.com/mohamedelashri/root
colab colab-notebook colaboratory root root-cern
Last synced: 4 months ago
JSON representation
Repository to build ROOT versions
- Host: GitHub
- URL: https://github.com/mohamedelashri/root
- Owner: MohamedElashri
- Created: 2023-07-04T21:58:22.000Z (over 2 years ago)
- Default Branch: main
- Last Pushed: 2025-02-27T18:41:49.000Z (7 months ago)
- Last Synced: 2025-03-03T08:26:25.744Z (7 months ago)
- Topics: colab, colab-notebook, colaboratory, root, root-cern
- Language: Shell
- Homepage: http://melashri.net/ROOT/
- Size: 78.1 KB
- Stars: 1
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# ROOT for Google Colab
This repository provides optimized ROOT binaries specifically for Google Colab environments. It aims to simplify the process of using ROOT in Colab notebooks by providing lightweight, ready-to-use builds that match Colab's Python versions.
## 🎯 Purpose
Google Colab frequently updates its runtime environment, which can break ROOT installations. This repository automatically builds and provides compatible ROOT versions for different Python versions, ensuring you can always use ROOT in your Colab notebooks.
## 🔧 Available Builds
The following ROOT versions are available:
- ROOT 6.30.04
- ROOT 6.32.04
Each ROOT version is built for Python versions:
- Python 3.11
- Python 3.12
## 📥 Available Downloads
| ROOT Version | Python Version | Download Link |
|-------------|----------------|---------------|
| 6.30.04 | 3.11 | [Download](https://github.com/MohamedElashri/ROOT/releases/download/root-v6.30.04-python3.11/root_v6.30.04_Ubuntu_Python3.11.zip) |
| 6.30.04 | 3.12 | [Download](https://github.com/MohamedElashri/ROOT/releases/download/root-v6.30.04-python3.12/root_v6.30.04_Ubuntu_Python3.12.zip) |
| 6.32.04 | 3.11 | [Download](https://github.com/MohamedElashri/ROOT/releases/download/root-v6.32.04-python3.11/root_v6.32.04_Ubuntu_Python3.11.zip) |
| 6.32.04 | 3.12 | [Download](https://github.com/MohamedElashri/ROOT/releases/download/root-v6.32.04-python3.12/root_v6.32.04_Ubuntu_Python3.12.zip) |
## 🚀 Quick Start
1. First, check your Colab Python version:
```python
!python --version
```
2. Download and install the appropriate ROOT build:
```python
# Example for Python 3.11 with ROOT 6.32.04
# Check Python version and install ROOT
!python --version
# Step 1: Download the pre-built ROOT tarball from GitHub Releases
!wget -q --show-progress https://github.com/MohamedElashri/ROOT/releases/download/ubuntu/root_v6.30.04_Ubuntu_Python3.11.zip
# Step 2: Extract the ROOT files
!unzip -q root_v6.30.04_Ubuntu_Python3.11.zip
# Step 3: Install missing system dependencies for ROOT
!sudo ldconfig & apt-get install -y git dpkg-dev cmake g++ gcc binutils libx11-dev libxpm-dev libxft-dev libxext-dev tar gfortran subversion libpython3.11-dev
# Step 4: Remove the tarball to free up space
!rm -f root_v6.30.04_Ubuntu_Python3.11.zip
# Step 5: Install Compatible libssl
!wget http://archive.ubuntu.com/ubuntu/pool/main/o/openssl/libssl1.1_1.1.1f-1ubuntu2_amd64.deb
!sudo dpkg -i libssl1.1_1.1.1f-1ubuntu2_amd64.deb
!rm -f libssl1.1_1.1.1f-1ubuntu2_amd64.deb
```
3. Set up the environment:
```python
import sys
import ctypes
# Append ROOT paths to Python
sys.path.append("root_build/")
sys.path.append("root_build/bin/")
sys.path.append("root_build/include/")
sys.path.append("root_build/lib/")
# Load the required shared libraries (.so files)
ctypes.cdll.LoadLibrary("root_build/lib/libCore.so")
ctypes.cdll.LoadLibrary("root_build/lib/libThread.so")
ctypes.cdll.LoadLibrary("root_build/lib/libTreePlayer.so")
print("ROOT Libraries Loaded Successfully!")
```
4. Import ROOT and verify installation:
```python
import ROOT
print(ROOT.gROOT.GetVersion())
```
## 📋 Example Usage
Here's a complete example for current Colab (Python 3.11):
```python
# Check Python version and install ROOT
!python --version
# Install ROOT
!wget https://github.com/MohamedElashri/ROOT/releases/download/root-v6.32.04-python3.11/root_v6.32.04_Ubuntu_Python3.11.zip
!unzip root_v6.32.04_Ubuntu_Python3.11.zip -d /usr/local
!rm root_v6.32.04_Ubuntu_Python3.11.zip
# Step 5: Install Compatible libssl
!wget http://archive.ubuntu.com/ubuntu/pool/main/o/openssl/libssl1.1_1.1.1f-1ubuntu2_amd64.deb
!sudo dpkg -i libssl1.1_1.1.1f-1ubuntu2_amd64.deb
!rm -f libssl1.1_1.1.1f-1ubuntu2_amd64.deb
# Step 6: Configure Python paths and load libraries
import sys
import ctypes
# Append ROOT paths to Python
sys.path.append("root_build/")
sys.path.append("root_build/bin/")
sys.path.append("root_build/include/")
sys.path.append("root_build/lib/")
# Load the required shared libraries (.so files)
ctypes.cdll.LoadLibrary("root_build/lib/libCore.so")
ctypes.cdll.LoadLibrary("root_build/lib/libThread.so")
ctypes.cdll.LoadLibrary("root_build/lib/libTreePlayer.so")
print("ROOT Libraries Loaded Successfully!")
# Import ROOT and create a simple histogram
import ROOT
h = ROOT.TH1F("gauss","Example histogram",100,-4,4)
h.FillRandom("gaus")
h.Draw()
```
## 🛠 Build Features
These optimized ROOT builds include essential features for data analysis:
**Included Components**:
- ✅ Python bindings (PyROOT)
- ✅ RooFit statistical analysis package
- ✅ MathMore libraries
- ✅ Multithreading support (IMT)
- ✅ SSL and XML support
- ✅ XRootD support (built-in)
- ✅ ROOT 7 features
- ✅ 3D Graphics (graf3d)
- ✅ PYTHIA8 integration
- ✅ Fortran support
- ✅ Thread support
**Excluded for Optimization**:
- ❌ OpenGL support
- ❌ Vector Detection Technology (VDT)
- ❌ SQLite support
- ❌ GDML support
- ❌ Davix
- ❌ FITS I/O
- ❌ Table support
- ❌ Testing modules
- ❌ Debug symbols (using MinSizeRel build)
## ⚠️ Known Issues
1. If you encounter SSL-related errors:
```python
!wget http://archive.ubuntu.com/ubuntu/pool/main/o/openssl/libssl1.1_1.1.1f-1ubuntu2_amd64.deb
!sudo dpkg -i libssl1.1_1.1.1f-1ubuntu2_amd64.deb
!rm libssl1.1_1.1.1f-1ubuntu2_amd64.deb
```
2. If ROOT fails to import after installation, try restarting your Colab runtime
3. If you need any of the excluded features, You will need to build ROOT with them
***Building ROOT in the same colab runtime will take most of the runtime allocation time because it takes long time to build***
5. If you encounter any issues, please open a new issue on this repository
## 🙏 Acknowledgments
- CERN ROOT team for the amazing ROOT framework
- Google Colab team for providing free GPU resources
- All contributors and users of this project