JohanBeytell commited on
Commit
4ee0d1c
·
verified ·
1 Parent(s): 0e7c601

Upload 4 files

Browse files
Files changed (4) hide show
  1. README.md +95 -1
  2. config.json +16 -0
  3. iris_classifier.joblib +3 -0
  4. requirements.txt +4 -0
README.md CHANGED
@@ -1,3 +1,97 @@
1
  ---
2
- license: mit
 
 
 
 
 
 
 
 
 
 
 
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