model documentation

#3
by nazneen - opened
Files changed (1) hide show
  1. README.md +176 -0
README.md ADDED
@@ -0,0 +1,176 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ ---
2
+ tags:
3
+ - feature-extraction
4
+ ---
5
+ # Model Card for code_trans_t5_large_code_comment_generation_java_transfer_learning_finetune
6
+
7
+
8
+ # Model Details
9
+
10
+ ## Model Description
11
+
12
+
13
+ - **Developed by:** Sebis (Software Engineering for Business Information Systems )
14
+ - **Shared by [Optional]:** More information needed
15
+ - **Model type:** Feature Extraction
16
+ - **Language(s) (NLP):** More information needed
17
+ - **License:** More information needed
18
+ - **Related Models:** [All T5 Checkpoints](https://huggingface.co/models?search=t5)
19
+ - **Parent Model:** T5
20
+ - **Resources for more information:**
21
+ - [Associated Paper](https://jmlr.org/papers/volume21/20-074/20-074.pdf)
22
+ - [Blog Post](https://ai.googleblog.com/2020/02/exploring-transfer-learning-with-t5.html)
23
+
24
+ # Uses
25
+
26
+
27
+ ## Direct Use
28
+
29
+ This model can be used for the task of Feature Extraction
30
+
31
+ ## Downstream Use [Optional]
32
+
33
+ More information needed
34
+
35
+ ## Out-of-Scope Use
36
+
37
+ The model should not be used to intentionally create hostile or alienating environments for people.
38
+
39
+ # Bias, Risks, and Limitations
40
+
41
+ Significant research has explored bias and fairness issues with language models (see, e.g., [Sheng et al. (2021)](https://aclanthology.org/2021.acl-long.330.pdf) and [Bender et al. (2021)](https://dl.acm.org/doi/pdf/10.1145/3442188.3445922)). Predictions generated by the model may include disturbing and harmful stereotypes across protected classes; identity characteristics; and sensitive, social, and occupational groups.
42
+
43
+
44
+ ## Recommendations
45
+
46
+ Users (both direct and downstream) should be made aware of the risks, biases and limitations of the model. More information needed for further recommendations.
47
+
48
+
49
+ # Training Details
50
+
51
+ ## Training Data
52
+
53
+ The model is pre-trained on the [Colossal Clean Crawled Corpus (C4)](https://www.tensorflow.org/datasets/catalog/c4), which was developed and released in the context of the same [research paper](https://jmlr.org/papers/volume21/20-074/20-074.pdf) as T5.
54
+
55
+ The model was pre-trained on a on a **multi-task mixture of unsupervised (1.) and supervised tasks (2.)**.
56
+
57
+ See the [t5-base model card](https://huggingface.co/t5-base?text=My+name+is+Wolfgang+and+I+live+in+Berlin) for further information.
58
+
59
+ ## Training Procedure
60
+
61
+
62
+ ### Preprocessing
63
+
64
+ More information needed
65
+
66
+ ### Speeds, Sizes, Times
67
+
68
+ More information needed
69
+
70
+ # Evaluation
71
+
72
+
73
+ ## Testing Data, Factors & Metrics
74
+
75
+ ### Testing Data
76
+
77
+ More information needed
78
+
79
+ ### Factors
80
+
81
+
82
+ ### Metrics
83
+
84
+ More information needed
85
+ ## Results
86
+
87
+ More information needed
88
+
89
+ # Model Examination
90
+
91
+ More information needed
92
+
93
+ # Environmental Impact
94
+
95
+
96
+ Carbon emissions can be estimated using the [Machine Learning Impact calculator](https://mlco2.github.io/impact#compute) presented in [Lacoste et al. (2019)](https://arxiv.org/abs/1910.09700).
97
+
98
+ - **Hardware Type:** More information needed
99
+ - **Hours used:** More information needed
100
+ - **Cloud Provider:** More information needed
101
+ - **Compute Region:** More information needed
102
+ - **Carbon Emitted:** More information needed
103
+
104
+ # Technical Specifications [optional]
105
+
106
+ ## Model Architecture and Objective
107
+
108
+ More information needed
109
+
110
+ ## Compute Infrastructure
111
+
112
+ More information needed
113
+
114
+ ### Hardware
115
+
116
+ More information needed
117
+
118
+ ### Software
119
+ More information needed
120
+
121
+ # Citation
122
+ **BibTeX:**
123
+ ```bibtex
124
+ @article{2020t5,
125
+ author = {Colin Raffel and Noam Shazeer and Adam Roberts and Katherine Lee and Sharan Narang and Michael Matena and Yanqi Zhou and Wei Li and Peter J. Liu},
126
+ title = {Exploring the Limits of Transfer Learning with a Unified Text-to-Text Transformer},
127
+ journal = {Journal of Machine Learning Research},
128
+ year = {2020},
129
+ volume = {21},
130
+ number = {140},
131
+ pages = {1-67},
132
+ url = {http://jmlr.org/papers/v21/20-074.html}
133
+ }
134
+ ```
135
+
136
+
137
+ **APA:**
138
+ ```
139
+ - Raffel, C., Shazeer, N., Roberts, A., Lee, K., Narang, S., Matena, M., ... & Liu, P. J. (2020). Exploring the limits of transfer learning with a unified text-to-text transformer. J. Mach. Learn. Res., 21(140), 1-67.
140
+ nformation needed
141
+ ```
142
+
143
+ # Glossary [optional]
144
+ More information needed
145
+
146
+ # More Information [optional]
147
+
148
+ More information needed
149
+
150
+ # Model Card Authors [optional]
151
+
152
+
153
+ Sebis (Software Engineering for Business Information Systems ) in collaboration with Ezi Ozoani and the Hugging Face team
154
+
155
+ # Model Card Contact
156
+
157
+ More information needed
158
+
159
+ # How to Get Started with the Model
160
+
161
+ Use the code below to get started with the model.
162
+
163
+ <details>
164
+ <summary> Click to expand </summary>
165
+
166
+ ```python
167
+ from transformers import AutoTokenizer, AutoModel
168
+
169
+ tokenizer = AutoTokenizer.from_pretrained("SEBIS/code_trans_t5_large_code_comment_generation_java_transfer_learning_finetune")
170
+
171
+ model = AutoModel.from_pretrained("SEBIS/code_trans_t5_large_code_comment_generation_java_transfer_learning_finetune")
172
+
173
+ ```
174
+ </details>
175
+
176
+