Downloads · 30 days
46
28% of all-time downloads
pandalin98/ITFormer-3B
ITFormer-3B is a machine learning model from pandalin98. Use it for the machine learning task on the model card, and read the license before you ship it in a product.
ITFormer-3B is a state-of-the-art multi-modal framework that bridges time-series data and natural language for dynamic question answering (QA). Built using the Instruct Time Transformer (ITFormer) architecture, this m…
Downloads · 30 days
46
28% of all-time downloads
All-time downloads
167
Public
Parameters
3.2B
13.1 GB on disk
Likes
1
Public
Click a slice to open those files.
.safetensors12.7 GB · 97%
From the Hugging Face model README
ITFormer-3B is a state-of-the-art multi-modal framework that bridges time-series data and natural language for dynamic question answering (QA). Built using the Instruct Time Transformer (ITFormer) architecture, this model is specifically designed to handle complex multi-task, temporal-textual QA tasks. It is trained on the EngineMT-QA dataset, which focuses on real-world aircraft engine operational and maintenance data.
ITFormer-3B excels in integrating time-series data (such as sensor readings from engines) with natural language queries, enabling real-time, intelligent decision-making across several key areas: understanding, perception, reasoning, and decision-making.
ITFormer-3B integrates several key components to enhance multi-modal reasoning:
ITFormer-3B integrates a time-series encoder with a frozen large language model (LLM). The encoder extracts semantic features from the time-series data, and the LLM processes the corresponding textual query. The fused representation is then passed through the LLM’s decoder to generate the final answer.
ITFormer-3B is capable of answering questions across four primary tasks:
ITFormer-3B is trained on the EngineMT-QA dataset, a large-scale, multi-task dataset specifically created for time-series question answering. The dataset contains over 110k question-answer pairs based on real-world engine operational and maintenance scenarios.
ITFormer-3B outperforms existing models across all QA tasks, achieving:
These results highlight the model's capability to handle complex temporal-textual reasoning and its robustness across different task types.
To use the ITFormer-3B model, you need to install the transformers library and the Hugging Face model hub interface:
pip install transformers
pip install huggingface_hub
You can load the model using the transformers library:
from transformers import AutoModelForCausalLM, AutoTokenizer
# Load the model and tokenizer
model_name = "your_username/ITFormer-3B"
model = AutoModelForCausalLM.from_pretrained(model_name)
tokenizer = AutoTokenizer.from_pretrained(model_name)
# Example input query
query = "What is the status of the High-Pressure Turbine (HPT)?"
# Tokenize and generate output
inputs = tokenizer(query, return_tensors="pt")
outputs = model.generate(inputs["input_ids"])
# Decode the output
decoded_output = tokenizer.decode(outputs[0], skip_special_tokens=True)
print(decoded_output)
To perform multi-modal question answering with the ITFormer-3B model, you can provide both the time-series data and textual query. For instance:
# Example question with engine signal data and query
time_series_data = "path_to_time_series_data" # Example: "engine_signal_data.csv"
query = "What is the condition of the engine?"
# Process the data and make predictions
# Assuming you have preprocessed the time-series data into the correct format
inputs = tokenizer(query, return_tensors="pt")
outputs = model.generate(inputs["input_ids"])
# Decode and output the result
decoded_output = tokenizer.decode(outputs[0], skip_special_tokens=True)
print(decoded_output)
ITFormer-3B is optimized for efficient deployment, requiring minimal computational overhead due to its small number of trainable parameters. You can fine-tune or directly use the model for specific temporal-textual tasks, such as fault detection or predictive maintenance.
If you use ITFormer-3B in your research, please cite the following:
@article{ITFormer,
title={ITFormer: Bridging Time Series and Natural Language for Multi-Modal QA with Large-Scale Multitask Dataset},
author={Yilin Wang, Peixuan Lei, Jie Song, Haoyu Zhe,Tao Chen, Yuxuan Zhang, Lei Jia, Yuanxiang Li, Zhongyu Wei},
journal={ICML 2025},
year={2025},
url={https://huggingface.co/papers/2506.20093}
}
This model is released under the MIT License.
We would like to acknowledge the development of the EngineMT-QA dataset and the contributions of the researchers involved in time-series and multi-modal AI. Special thanks to Hugging Face for providing a platform for model sharing and research collaboration.