Upload 4 files
Browse files- README.md +95 -1
- config.json +16 -0
- iris_classifier.joblib +3 -0
- requirements.txt +4 -0
README.md
CHANGED
|
@@ -1,3 +1,97 @@
|
|
| 1 |
---
|
| 2 |
-
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 3 |
---
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 1 |
---
|
| 2 |
+
pipeline_tag: tabular-classification
|
| 3 |
+
tags:
|
| 4 |
+
- classification
|
| 5 |
+
- iris
|
| 6 |
+
- random-forest
|
| 7 |
+
- scikit-learn
|
| 8 |
+
- open-arc
|
| 9 |
+
metrics:
|
| 10 |
+
- accuracy
|
| 11 |
+
- precision
|
| 12 |
+
- recall
|
| 13 |
+
- f1
|
| 14 |
---
|
| 15 |
+
|
| 16 |
+
# Model Card for InfinitodeLTD/IFSCM-OPEN-ARC
|
| 17 |
+
|
| 18 |
+
Repository: https://github.com/Infinitode/OPEN-ARC/
|
| 19 |
+
Project: https://github.com/Infinitode/OPEN-ARC/tree/main/Project-15
|
| 20 |
+
|
| 21 |
+
## Model Description
|
| 22 |
+
|
| 23 |
+
The Iris Flower Species Classification Model is a scikit-learn RandomForestClassifier developed as part of Infinitode's OPEN-ARC initiative. It classifies iris flowers as setosa, versicolor, or virginica using sepal and petal measurements.
|
| 24 |
+
|
| 25 |
+
**Architecture**:
|
| 26 |
+
|
| 27 |
+
- **RandomForestClassifier**: `n_estimators=100`, `random_state=42`.
|
| 28 |
+
- **Framework**: scikit-learn; serialized with joblib.
|
| 29 |
+
- **Training setup**: Trained on an 80% split of the dataset.
|
| 30 |
+
- **Model file**: `iris_classifier.joblib`, copied from Project 15 at Git commit `cc4760dbce70898cd05994f6398afb7b3d5f8a0d`.
|
| 31 |
+
|
| 32 |
+
## Uses
|
| 33 |
+
|
| 34 |
+
- Educational demonstrations of multiclass tabular classification.
|
| 35 |
+
- Experimentation with the Iris dataset and random forests.
|
| 36 |
+
- Predicting the three dataset species from measurements in centimetres.
|
| 37 |
+
|
| 38 |
+
## Limitations
|
| 39 |
+
|
| 40 |
+
- A small, classic dataset does not represent all iris species or real-world conditions. The reported test performance does not guarantee performance on new populations.
|
| 41 |
+
- Inputs must use the same measurements, units, and column order as the training data.
|
| 42 |
+
- The project describes its models as learning and research resources, not intended for commercial use. Review the [Project 15 terms](https://github.com/Infinitode/OPEN-ARC/tree/main/Project-15) before use. No Hugging Face license has been declared here because the applicable license for this artifact could not be verified.
|
| 43 |
+
|
| 44 |
+
## Training Data
|
| 45 |
+
|
| 46 |
+
- Dataset: [Iris Species](https://www.kaggle.com/datasets/uciml/iris).
|
| 47 |
+
- Content: Sepal and petal lengths and widths, with species labels.
|
| 48 |
+
- Size: 150 rows, 50 per species, as reported by the notebook.
|
| 49 |
+
- Preprocessing: Drop missing rows and exclude `Id` and `Species` from features.
|
| 50 |
+
|
| 51 |
+
## Training Procedure
|
| 52 |
+
|
| 53 |
+
- Train/test split: 80% / 20%, `random_state=42`.
|
| 54 |
+
- Metrics: Accuracy, and weighted precision, recall and F1.
|
| 55 |
+
|
| 56 |
+
## Evaluation Results
|
| 57 |
+
|
| 58 |
+
The Project 15 notebook reports the following on its 30-row test split. These are notebook results, not an independent evaluation of the uploaded artifact.
|
| 59 |
+
|
| 60 |
+
| Metric | Value |
|
| 61 |
+
| ------ | ----- |
|
| 62 |
+
| Accuracy | 1.0000 |
|
| 63 |
+
| Weighted precision | 1.0000 |
|
| 64 |
+
| Weighted recall | 1.0000 |
|
| 65 |
+
| Weighted F1 | 1.0000 |
|
| 66 |
+
|
| 67 |
+
## How to Use
|
| 68 |
+
|
| 69 |
+
Install dependencies with `pip install -r requirements.txt`. This example assumes the model is uploaded as `InfinitodeLTD/IFSCM-OPEN-ARC`; change the repository ID if you choose a different name.
|
| 70 |
+
|
| 71 |
+
```python
|
| 72 |
+
import joblib
|
| 73 |
+
import pandas as pd
|
| 74 |
+
from huggingface_hub import hf_hub_download
|
| 75 |
+
|
| 76 |
+
repo_id = "InfinitodeLTD/IFSCM-OPEN-ARC"
|
| 77 |
+
# Request the Hub's default download-counting file as well as the model.
|
| 78 |
+
hf_hub_download(repo_id=repo_id, filename="config.json")
|
| 79 |
+
model_path = hf_hub_download(repo_id=repo_id, filename="iris_classifier.joblib")
|
| 80 |
+
model = joblib.load(model_path)
|
| 81 |
+
|
| 82 |
+
flowers = pd.DataFrame(
|
| 83 |
+
[[5.1, 3.5, 1.4, 0.2], [5.9, 3.0, 4.2, 1.5]],
|
| 84 |
+
columns=["SepalLengthCm", "SepalWidthCm", "PetalLengthCm", "PetalWidthCm"],
|
| 85 |
+
)
|
| 86 |
+
print(model.predict(flowers))
|
| 87 |
+
```
|
| 88 |
+
|
| 89 |
+
Only load joblib files from sources you trust: deserialization can execute arbitrary code. The artifact records scikit-learn version 1.9.1; matching the training version is recommended because cross-version loading is unsupported.
|
| 90 |
+
|
| 91 |
+
## Download Statistics
|
| 92 |
+
|
| 93 |
+
The root `config.json` is provided as the Hub's default download-counting query file. A client must request that file for its request to be counted; downloading only the joblib file will not necessarily increment the counter. GET and HEAD requests can count separately, and cached or offline usage may not generate a request. Counts are not unique users or guaranteed successful model loads. Library-specific Hub counting rules may override the default. See [Hugging Face's documentation](https://huggingface.co/docs/hub/models-download-stats).
|
| 94 |
+
|
| 95 |
+
## Contact
|
| 96 |
+
|
| 97 |
+
For questions or issues, open a GitHub issue or reach out at https://infinitode.netlify.app/forms/contact.
|
config.json
ADDED
|
@@ -0,0 +1,16 @@
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 1 |
+
{
|
| 2 |
+
"model_name": "Iris Flower Species Classification Model",
|
| 3 |
+
"model_file": "iris_classifier.joblib",
|
| 4 |
+
"framework": "scikit-learn",
|
| 5 |
+
"estimator": "RandomForestClassifier",
|
| 6 |
+
"sklearn_version": "1.9.1",
|
| 7 |
+
"feature_names": [
|
| 8 |
+
"SepalLengthCm",
|
| 9 |
+
"SepalWidthCm",
|
| 10 |
+
"PetalLengthCm",
|
| 11 |
+
"PetalWidthCm"
|
| 12 |
+
],
|
| 13 |
+
"feature_unit": "cm",
|
| 14 |
+
"classes": ["Iris-setosa", "Iris-versicolor", "Iris-virginica"],
|
| 15 |
+
"source": "https://github.com/Infinitode/OPEN-ARC/tree/cc4760dbce70898cd05994f6398afb7b3d5f8a0d/Project-15"
|
| 16 |
+
}
|
iris_classifier.joblib
ADDED
|
@@ -0,0 +1,3 @@
|
|
|
|
|
|
|
|
|
|
|
|
|
| 1 |
+
version https://git-lfs.github.com/spec/v1
|
| 2 |
+
oid sha256:96f3e293d7ea2107d6837c06696c306d1b36742b55e50ff857197e46a838f22f
|
| 3 |
+
size 187409
|
requirements.txt
ADDED
|
@@ -0,0 +1,4 @@
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 1 |
+
scikit-learn==1.9.1
|
| 2 |
+
joblib
|
| 3 |
+
pandas
|
| 4 |
+
huggingface_hub
|