KonradSzafer commited on
Commit
627b1eb
1 Parent(s): b6abe24

Create README.md

Browse files
Files changed (1) hide show
  1. README.md +217 -0
README.md ADDED
@@ -0,0 +1,217 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ ---
2
+ license: mit
3
+ datasets:
4
+ - AutonLab/Timeseries-PILE
5
+ metrics:
6
+ - accuracy
7
+ - mse
8
+ - mae
9
+ - f1
10
+ tags:
11
+ - time series
12
+ - forecasting
13
+ - classification
14
+ - anomaly detection
15
+ - imputation
16
+ - transformers
17
+ - pretrained models
18
+ - foundation models
19
+ - time-series
20
+ ---
21
+ # MOMENT-Large
22
+
23
+ MOMENT is a family of foundation models for general-purpose time-series analysis. The models in this family (1) serve as a building block for diverse **time-series analysis tasks** (e.g., forecasting, classification, anomaly detection, and imputation, etc.), (2) are effective **out-of-the-box**, i.e., with no (or few) task-specific exemplars (enabling e.g., zero-shot forecasting, few-shot classification, etc.), and (3) are **tunable** using in-distribution and task-specific data to improve performance.
24
+
25
+ For details on MOMENT models, training data, and experimental results, please refer to the paper [MOMENT: A Family of Open Time-series Foundation Models](https://arxiv.org/pdf/2402.03885.pdf).
26
+
27
+
28
+ ## Model Details
29
+
30
+ ### Model Description
31
+
32
+ - **Developed by:** [Auton Lab](https://autonlab.org/), [Carnegie Mellon University](https://www.cmu.edu/) and [University of Pennsylvania](https://www.upenn.edu/)
33
+ - **Funded by [optional]:** [More Information Needed]
34
+ - **Model type:** Time-series Foundation Model
35
+ - **License:** MIT License
36
+
37
+ ### Model Sources
38
+
39
+ <!-- Provide the basic links for the model. -->
40
+
41
+ - **Repository:** https://github.com/moment-timeseries-foundation-model/
42
+ - **Paper:** https://arxiv.org/abs/2402.03885
43
+ - **Demo:** https://github.com/moment-timeseries-foundation-model/
44
+
45
+ ## Uses
46
+
47
+ <!-- Address questions around how the model is intended to be used, including the foreseeable users of the model and those affected by the model. -->
48
+
49
+ ### Direct Use
50
+
51
+ <!-- This section is for the model use without fine-tuning or plugging into a larger ecosystem/app. -->
52
+
53
+ [More Information Needed]
54
+
55
+ ### Downstream Use [optional]
56
+
57
+ <!-- This section is for the model use when fine-tuned for a task, or when plugged into a larger ecosystem/app -->
58
+
59
+ [More Information Needed]
60
+
61
+ ### Out-of-Scope Use
62
+
63
+ <!-- This section addresses misuse, malicious use, and uses that the model will not work well for. -->
64
+
65
+ [More Information Needed]
66
+
67
+ ## Bias, Risks, and Limitations
68
+
69
+ <!-- This section is meant to convey both technical and sociotechnical limitations. -->
70
+
71
+ [More Information Needed]
72
+
73
+ ### Recommendations
74
+
75
+ <!-- This section is meant to convey recommendations with respect to the bias, risk, and technical limitations. -->
76
+
77
+ Users (both direct and downstream) should be made aware of the risks, biases and limitations of the model. More information needed for further recommendations.
78
+
79
+ ## How to Get Started with the Model
80
+
81
+ Use the code below to get started with the model.
82
+
83
+ [More Information Needed]
84
+
85
+ ## Training Details
86
+
87
+ ### Training Data
88
+
89
+ <!-- This should link to a Dataset Card, perhaps with a short stub of information on what the training data is all about as well as documentation related to data pre-processing or additional filtering. -->
90
+
91
+ [More Information Needed]
92
+
93
+ ### Training Procedure
94
+
95
+ <!-- This relates heavily to the Technical Specifications. Content here should link to that section when it is relevant to the training procedure. -->
96
+
97
+ #### Preprocessing [optional]
98
+
99
+ [More Information Needed]
100
+
101
+
102
+ #### Training Hyperparameters
103
+
104
+ - **Training regime:** [More Information Needed] <!--fp32, fp16 mixed precision, bf16 mixed precision, bf16 non-mixed precision, fp16 non-mixed precision, fp8 mixed precision -->
105
+
106
+ #### Speeds, Sizes, Times [optional]
107
+
108
+ <!-- This section provides information about throughput, start/end time, checkpoint size if relevant, etc. -->
109
+
110
+ [More Information Needed]
111
+
112
+ ## Evaluation
113
+
114
+ <!-- This section describes the evaluation protocols and provides the results. -->
115
+
116
+ ### Testing Data, Factors & Metrics
117
+
118
+ #### Testing Data
119
+
120
+ <!-- This should link to a Dataset Card if possible. -->
121
+
122
+ [More Information Needed]
123
+
124
+ #### Factors
125
+
126
+ <!-- These are the things the evaluation is disaggregating by, e.g., subpopulations or domains. -->
127
+
128
+ [More Information Needed]
129
+
130
+ #### Metrics
131
+
132
+ <!-- These are the evaluation metrics being used, ideally with a description of why. -->
133
+
134
+ [More Information Needed]
135
+
136
+ ### Results
137
+
138
+ [More Information Needed]
139
+
140
+ #### Summary
141
+
142
+
143
+
144
+ ## Model Examination [optional]
145
+
146
+ <!-- Relevant interpretability work for the model goes here -->
147
+
148
+ [More Information Needed]
149
+
150
+ ## Environmental Impact
151
+
152
+ <!-- Total emissions (in grams of CO2eq) and additional considerations, such as electricity usage, go here. Edit the suggested text below accordingly -->
153
+
154
+ We train multiple models over many days resulting in significant energy usage and a sizeable carbon footprint. However, we hope that releasing our models will ensure that future time-series modeling efforts are quicker and more efficient, resulting in lower carbon emissions.
155
+
156
+ We use the Total Graphics Power (TGP) to calculate the total power consumed for training MOMENT models, although the total power consumed by the GPU will likely vary a little based on the GPU utilization while training our model. Our calculations do not account for power demands from other sources of our compute. We use 336.566 Kg C02/MWH as the standard value of CO2 emission per megawatt hour of energy consumed for [Pittsburgh](https://emissionsindex.org/).
157
+
158
+ - **Hardware Type:** NVIDIA RTX A6000 GPU
159
+ - **GPU Hours:** 404
160
+ - **Compute Region:** Pittsburgh, USA
161
+ - **Carbon Emission (tCO2eq):**
162
+
163
+ ## Technical Specifications [optional]
164
+
165
+ ### Model Architecture and Objective
166
+
167
+ [More Information Needed]
168
+
169
+ ### Compute Infrastructure
170
+
171
+ #### Hardware
172
+
173
+ All models were trained and evaluated on a computing cluster consisting of 128 AMD EPYC 7502 CPUs, 503 GB of RAM, and 8 NVIDIA RTX A6000 GPUs each with 49 GiB RAM. All MOMENT variants were trained on a single A6000 GPU (with any data or model parallelism).
174
+
175
+ #### Software
176
+
177
+
178
+
179
+ ## Citation [optional]
180
+
181
+ <!-- If there is a paper or blog post introducing the model, the APA and Bibtex information for that should go in this section. -->
182
+
183
+ **BibTeX:**
184
+ If you use MOMENT please cite our paper:
185
+
186
+ ```bibtex
187
+
188
+ @article{
189
+ goswami2024moment,
190
+ title={{MOMENT: A Family of Open Time-series Foundation Models}},
191
+ author={Goswami, Mononito and Szafer, Konrad and Choudhry, Arjun and Cai, Yifu and Li, Shuo and Dubrawski, Artur},
192
+ journal={arXiv preprint arXiv:2402.03885},
193
+ year={2024},
194
+ }
195
+ ```
196
+
197
+
198
+ **APA:**
199
+
200
+ Goswami, M., Szafer, K., Choudhry, A., Cai, Y., Li, S., & Dubrawski, A. (2024).
201
+ MOMENT: A Family of Open Time-series Foundation Models. arXiv preprint arXiv:2402.03885.
202
+
203
+ ## Glossary [optional]
204
+
205
+ <!-- If relevant, include terms and calculations in this section that can help readers understand the model or model card. -->
206
+
207
+ [More Information Needed]
208
+
209
+ ## More Information [optional]
210
+
211
+ [More Information Needed]
212
+
213
+ ## Model Card Authors [optional]
214
+
215
+ [More Information Needed]
216
+
217
+ ## Model Card Contact