Upload README.md with huggingface_hub

README.md

@@ -89,7 +89,33 @@ The dataset is organized by temperature ranges:
 
 ## Usage Examples
 
-### Main Task - Regression
+### Option 1: Download and Use Locally
+
+1. **Download the dataset** from [https://huggingface.co/datasets/johnpolat/CrysMTM](https://huggingface.co/datasets/johnpolat/CrysMTM)
+2. **Use the provided loading script**:
+
+```python
+# Download load_dataset.py from the repository and place it in your data directory
+from load_dataset import load_dataset
+
+# Load the dataset
+dataset = load_dataset(".")
+
+# Access splits
+train_dataset = dataset["train"]      # 5,064 samples
+test_id_dataset = dataset["test_id"]  # 1,380 samples
+test_ood_dataset = dataset["test_ood"] # 6,588 samples
+
+# Get a sample
+sample = train_dataset[0]
+print(f"Phase: {sample['phase']}")
+print(f"Temperature: {sample['temperature']}K")
+print(f"Image: {sample['image']}")
+print(f"Regression labels: {sample['regression_labels']}")
+```
+
+### Option 2: Use with Original Dataloaders
+
 ```python
 from dataloaders.regression_dataloader import RegressionLoader