maciek-g commited on
Commit
adb02cc
·
verified ·
1 Parent(s): 24ade06

Update README.md

Browse files
Files changed (1) hide show
  1. README.md +18 -0
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..)