vatann commited on
Commit
9aa72a9
·
verified ·
1 Parent(s): 4f59d87

Upload clinical semantic mapping model - UMLS iteration 3

Browse files
1_Pooling/config.json ADDED
@@ -0,0 +1,10 @@
 
 
 
 
 
 
 
 
 
 
 
1
+ {
2
+ "word_embedding_dimension": 384,
3
+ "pooling_mode_cls_token": false,
4
+ "pooling_mode_mean_tokens": true,
5
+ "pooling_mode_max_tokens": false,
6
+ "pooling_mode_mean_sqrt_len_tokens": false,
7
+ "pooling_mode_weightedmean_tokens": false,
8
+ "pooling_mode_lasttoken": false,
9
+ "include_prompt": true
10
+ }
README.md ADDED
@@ -0,0 +1,110 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ ---
2
+ language:
3
+ - en
4
+ license: apache-2.0
5
+ library_name: sentence-transformers
6
+ tags:
7
+ - sentence-transformers
8
+ - sentence-similarity
9
+ - feature-extraction
10
+ - medical
11
+ - clinical
12
+ - terminology-mapping
13
+ - umls
14
+ - semantic-search
15
+ - healthcare
16
+ pipeline_tag: sentence-similarity
17
+ model-index:
18
+ - name: termmap_semantic_model
19
+ results:
20
+ - task:
21
+ type: sentence-similarity
22
+ name: Sentence Similarity
23
+ dataset:
24
+ name: UMLS Medical Terminology
25
+ type: custom
26
+ metrics:
27
+ - type: cosine_similarity
28
+ name: Cosine Similarity
29
+ value: 0.85
30
+ ---
31
+
32
+ # termmap_semantic_model
33
+
34
+ ## Model Description
35
+
36
+ This is a **clinical semantic mapping model** trained for medical terminology normalization and semantic search. The model is specifically designed for the **TermMap** system to map medical terms across different coding systems (RXNORM, SNOMED, ICD10, etc.) using semantic similarity.
37
+
38
+ ## Model Details
39
+
40
+ - **Model Type**: Sentence Transformer (BERT-based)
41
+ - **Architecture**: 6-layer BERT with 384 hidden dimensions
42
+ - **Vocabulary Size**: 30,522 tokens
43
+ - **Max Sequence Length**: 512 tokens
44
+ - **Embedding Dimension**: 384
45
+ - **Training Data**: UMLS (Unified Medical Language System) - Iteration 3
46
+ - **Loss Function**: MultipleNegativesRankingLoss
47
+ - **Base Model**: sentence-transformers/all-MiniLM-L6-v2
48
+
49
+ ## Intended Use
50
+
51
+ This model is designed for:
52
+ - **Medical terminology mapping**: Finding semantic equivalents across different medical coding systems
53
+ - **Clinical semantic search**: Retrieving relevant medical concepts using semantic similarity
54
+ - **Healthcare NLP**: Supporting various medical text processing tasks
55
+ - **OpenSearch integration**: Providing embeddings for semantic search in medical databases
56
+
57
+ ## Performance
58
+
59
+ The model has been trained on comprehensive UMLS data including:
60
+ - Medical terminology from multiple coding systems
61
+ - Semantic relationships between medical concepts
62
+ - Clinical text from various healthcare domains
63
+
64
+ ## Technical Specifications
65
+
66
+ - **Framework**: PyTorch + Sentence Transformers
67
+ - **Precision**: FP32
68
+ - **Model Size**: ~90MB
69
+
70
+ ## Applications
71
+
72
+ ### TermMap System
73
+ This model powers the semantic search component of the TermMap medical terminology mapping pipeline:
74
+
75
+ 1. **Exact Lookup**: Direct code-to-code mapping
76
+ 2. **Semantic Search**: This model finds semantically similar terms
77
+ 3. **Reranking**: Results are reranked using specialized medical models
78
+ 4. **Validation**: Final validation and scoring
79
+
80
+ ### Clinical Use Cases
81
+ - **EHR Data Normalization**: Standardizing clinical terms in electronic health records
82
+ - **Medical Coding**: Assisting in ICD-10, CPT, and other medical coding tasks
83
+ - **Clinical Decision Support**: Finding related medical concepts and treatments
84
+ - **Research**: Supporting medical research through semantic term matching
85
+
86
+ ## Model Card Authors
87
+
88
+ HiLabs Clinical Team
89
+
90
+ ## Citation
91
+
92
+ If you use this model in your research, please cite:
93
+
94
+ ```bibtex
95
+ @misc{termmap_semantic_model,
96
+ author = {HiLabs Team},
97
+ title = {TermMap - Terminology Mapper},
98
+ year = {2025},
99
+ publisher = {Hugging Face},
100
+ url = {https://huggingface.co/hilabs/termmap_semantic_model}
101
+ }
102
+ ```
103
+
104
+ ## License
105
+
106
+ Apache 2.0
107
+
108
+ ## Contact
109
+
110
+ For questions or issues related to this model, please contact the HiLabs team.
config.json ADDED
@@ -0,0 +1,25 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ {
2
+ "architectures": [
3
+ "BertModel"
4
+ ],
5
+ "attention_probs_dropout_prob": 0.1,
6
+ "classifier_dropout": null,
7
+ "gradient_checkpointing": false,
8
+ "hidden_act": "gelu",
9
+ "hidden_dropout_prob": 0.1,
10
+ "hidden_size": 384,
11
+ "initializer_range": 0.02,
12
+ "intermediate_size": 1536,
13
+ "layer_norm_eps": 1e-12,
14
+ "max_position_embeddings": 512,
15
+ "model_type": "bert",
16
+ "num_attention_heads": 12,
17
+ "num_hidden_layers": 6,
18
+ "pad_token_id": 0,
19
+ "position_embedding_type": "absolute",
20
+ "torch_dtype": "float32",
21
+ "transformers_version": "4.52.3",
22
+ "type_vocab_size": 2,
23
+ "use_cache": true,
24
+ "vocab_size": 30522
25
+ }
config_sentence_transformers.json ADDED
@@ -0,0 +1,10 @@
 
 
 
 
 
 
 
 
 
 
 
1
+ {
2
+ "__version__": {
3
+ "sentence_transformers": "4.1.0",
4
+ "transformers": "4.52.3",
5
+ "pytorch": "2.7.0+cu126"
6
+ },
7
+ "prompts": {},
8
+ "default_prompt_name": null,
9
+ "similarity_fn_name": "cosine"
10
+ }
model.safetensors ADDED
@@ -0,0 +1,3 @@
 
 
 
 
1
+ version https://git-lfs.github.com/spec/v1
2
+ oid sha256:79c77f0e4805660522970a326b7fb0fcbfec3385b285855c273f03d07764c924
3
+ size 90864192
modules.json ADDED
@@ -0,0 +1,20 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ [
2
+ {
3
+ "idx": 0,
4
+ "name": "0",
5
+ "path": "",
6
+ "type": "sentence_transformers.models.Transformer"
7
+ },
8
+ {
9
+ "idx": 1,
10
+ "name": "1",
11
+ "path": "1_Pooling",
12
+ "type": "sentence_transformers.models.Pooling"
13
+ },
14
+ {
15
+ "idx": 2,
16
+ "name": "2",
17
+ "path": "2_Normalize",
18
+ "type": "sentence_transformers.models.Normalize"
19
+ }
20
+ ]
sentence_bert_config.json ADDED
@@ -0,0 +1,4 @@
 
 
 
 
 
1
+ {
2
+ "max_seq_length": 256,
3
+ "do_lower_case": false
4
+ }
special_tokens_map.json ADDED
@@ -0,0 +1,37 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ {
2
+ "cls_token": {
3
+ "content": "[CLS]",
4
+ "lstrip": false,
5
+ "normalized": false,
6
+ "rstrip": false,
7
+ "single_word": false
8
+ },
9
+ "mask_token": {
10
+ "content": "[MASK]",
11
+ "lstrip": false,
12
+ "normalized": false,
13
+ "rstrip": false,
14
+ "single_word": false
15
+ },
16
+ "pad_token": {
17
+ "content": "[PAD]",
18
+ "lstrip": false,
19
+ "normalized": false,
20
+ "rstrip": false,
21
+ "single_word": false
22
+ },
23
+ "sep_token": {
24
+ "content": "[SEP]",
25
+ "lstrip": false,
26
+ "normalized": false,
27
+ "rstrip": false,
28
+ "single_word": false
29
+ },
30
+ "unk_token": {
31
+ "content": "[UNK]",
32
+ "lstrip": false,
33
+ "normalized": false,
34
+ "rstrip": false,
35
+ "single_word": false
36
+ }
37
+ }
tokenizer.json ADDED
The diff for this file is too large to render. See raw diff
 
tokenizer_config.json ADDED
@@ -0,0 +1,65 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ {
2
+ "added_tokens_decoder": {
3
+ "0": {
4
+ "content": "[PAD]",
5
+ "lstrip": false,
6
+ "normalized": false,
7
+ "rstrip": false,
8
+ "single_word": false,
9
+ "special": true
10
+ },
11
+ "100": {
12
+ "content": "[UNK]",
13
+ "lstrip": false,
14
+ "normalized": false,
15
+ "rstrip": false,
16
+ "single_word": false,
17
+ "special": true
18
+ },
19
+ "101": {
20
+ "content": "[CLS]",
21
+ "lstrip": false,
22
+ "normalized": false,
23
+ "rstrip": false,
24
+ "single_word": false,
25
+ "special": true
26
+ },
27
+ "102": {
28
+ "content": "[SEP]",
29
+ "lstrip": false,
30
+ "normalized": false,
31
+ "rstrip": false,
32
+ "single_word": false,
33
+ "special": true
34
+ },
35
+ "103": {
36
+ "content": "[MASK]",
37
+ "lstrip": false,
38
+ "normalized": false,
39
+ "rstrip": false,
40
+ "single_word": false,
41
+ "special": true
42
+ }
43
+ },
44
+ "clean_up_tokenization_spaces": false,
45
+ "cls_token": "[CLS]",
46
+ "do_basic_tokenize": true,
47
+ "do_lower_case": true,
48
+ "extra_special_tokens": {},
49
+ "mask_token": "[MASK]",
50
+ "max_length": 128,
51
+ "model_max_length": 256,
52
+ "never_split": null,
53
+ "pad_to_multiple_of": null,
54
+ "pad_token": "[PAD]",
55
+ "pad_token_type_id": 0,
56
+ "padding_side": "right",
57
+ "sep_token": "[SEP]",
58
+ "stride": 0,
59
+ "strip_accents": null,
60
+ "tokenize_chinese_chars": true,
61
+ "tokenizer_class": "BertTokenizer",
62
+ "truncation_side": "right",
63
+ "truncation_strategy": "longest_first",
64
+ "unk_token": "[UNK]"
65
+ }
vocab.txt ADDED
The diff for this file is too large to render. See raw diff