Update README.md
Browse files
README.md
CHANGED
|
@@ -1,3 +1,9 @@
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 1 |
# AnalysisObjectTransformer Model
|
| 2 |
|
| 3 |
This repository contains the implementation of the AnalysisObjectTransformer model, a deep learning architecture designed for event classification with reconstructed-object inputs. MultiHeadAttention is used to extract the correlation between jets (hadrons) in the final state. Achieves state-of-the-art performance on final states which can be summarized as jets accompanied by missing transverse energy.
|
|
@@ -15,7 +21,19 @@ The AnalysisObjectTransformer model is structured to process jet-level features
|
|
| 15 |
|
| 16 |
## Usage
|
| 17 |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 18 |
```python
|
| 19 |
from particle_transformer import AnalysisObjectTransformer
|
| 20 |
|
| 21 |
model = AnalysisObjectTransformer(input_dim_obj=..., input_dim_event=..., embed_dims=..., linear_dims1=..., linear_dims2=..., mlp_hidden_1=..., mlp_hidden_2=..., num_heads=...)
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 1 |
+
---
|
| 2 |
+
license: apache-2.0
|
| 3 |
+
language:
|
| 4 |
+
- en
|
| 5 |
+
library_name: transformers
|
| 6 |
+
---
|
| 7 |
# AnalysisObjectTransformer Model
|
| 8 |
|
| 9 |
This repository contains the implementation of the AnalysisObjectTransformer model, a deep learning architecture designed for event classification with reconstructed-object inputs. MultiHeadAttention is used to extract the correlation between jets (hadrons) in the final state. Achieves state-of-the-art performance on final states which can be summarized as jets accompanied by missing transverse energy.
|
|
|
|
| 21 |
|
| 22 |
## Usage
|
| 23 |
|
| 24 |
+
Firstly, clone the repository:
|
| 25 |
+
```bash
|
| 26 |
+
git clone https://huggingface.co/maciek-g/AnalysisObjectTransformer
|
| 27 |
+
```
|
| 28 |
+
You can then import the model object and use within standard PyTorch and PyTorch lightning training workflows.
|
| 29 |
+
|
| 30 |
```python
|
| 31 |
from particle_transformer import AnalysisObjectTransformer
|
| 32 |
|
| 33 |
model = AnalysisObjectTransformer(input_dim_obj=..., input_dim_event=..., embed_dims=..., linear_dims1=..., linear_dims2=..., mlp_hidden_1=..., mlp_hidden_2=..., num_heads=...)
|
| 34 |
+
```
|
| 35 |
+
|
| 36 |
+
## Parameter definitions
|
| 37 |
+
|
| 38 |
+
`input_dim_obj`: The number of features associated with each event object (features per jet, lepton etc..)
|
| 39 |
+
`input_dim_events`: The number of features associated with the event (Number of jets, total hadronic energy, total missing transverse energy etc..)
|