đ CodeTrans model for source code summarization in Python
A pre - trained model for Python source code summarization using the T5 small model architecture.
This model is a pre - trained one on the Python programming language, leveraging the t5-small
model architecture. It was initially released in this repository. Trained on tokenized Python code functions, it performs optimally with such tokenized functions.
đ Quick Start
The CodeTrans model can be used to generate descriptions for Python functions or be fine - tuned for other Python code - related tasks. It can handle unparsed and untokenized Python code, but tokenized code generally yields better performance.
Here is an example of using this model to generate Python function documentation with the Transformers SummarizationPipeline
:
from transformers import AutoTokenizer, AutoModelWithLMHead, SummarizationPipeline
pipeline = SummarizationPipeline(
model=AutoModelWithLMHead.from_pretrained("SEBIS/code_trans_t5_small_source_code_summarization_python_multitask_finetune"),
tokenizer=AutoTokenizer.from_pretrained("SEBIS/code_trans_t5_small_source_code_summarization_python_multitask_finetune", skip_special_tokens=True),
device=0
)
tokenized_code = '''with open ( CODE_STRING , CODE_STRING ) as in_file : buf = in_file . readlines ( ) with open ( CODE_STRING , CODE_STRING ) as out_file : for line in buf : if line == " ; Include this text " : line = line + " Include below " out_file . write ( line ) '''
pipeline([tokenized_code])
You can run this example in colab notebook.
⨠Features
Model description
This CodeTrans model is built upon the t5-small
model and comes with its own SentencePiece vocabulary model. It underwent multi - task training on 13 supervised tasks in the software development domain and 7 unsupervised datasets. Subsequently, it was fine - tuned for the source code summarization task of Python code snippets.
Intended uses & limitations
The model can generate descriptions for Python functions or be fine - tuned for other Python code tasks. It can work on unparsed and untokenized Python code, though tokenized code will lead to better performance.
đĻ Installation
No installation steps were provided in the original document, so this section is skipped.
đģ Usage Examples
Basic Usage
from transformers import AutoTokenizer, AutoModelWithLMHead, SummarizationPipeline
pipeline = SummarizationPipeline(
model=AutoModelWithLMHead.from_pretrained("SEBIS/code_trans_t5_small_source_code_summarization_python_multitask_finetune"),
tokenizer=AutoTokenizer.from_pretrained("SEBIS/code_trans_t5_small_source_code_summarization_python_multitask_finetune", skip_special_tokens=True),
device=0
)
tokenized_code = '''with open ( CODE_STRING , CODE_STRING ) as in_file : buf = in_file . readlines ( ) with open ( CODE_STRING , CODE_STRING ) as out_file : for line in buf : if line == " ; Include this text " : line = line + " Include below " out_file . write ( line ) '''
pipeline([tokenized_code])
đ Documentation
Training data
The supervised training tasks datasets can be downloaded from Link
Training procedure
Multi - task Pretraining
The model was trained on a single TPU Pod V3 - 8 for a total of 500,000 steps, using a sequence length of 512 (batch size 4096). It has approximately 220M parameters in total and was trained with the encoder - decoder architecture. The optimizer used was AdaFactor with an inverse square root learning rate schedule for pre - training.
Fine - tuning
This model was then fine - tuned on a single TPU Pod V2 - 8 for a total of 600 steps, using a sequence length of 512 (batch size 256), using only the dataset containing Python code.
Evaluation results
For the source code summarization tasks, different models achieve the following results on different programming languages (in BLEU score):
Test results:
Language / Model |
Python |
SQL |
C# |
CodeTrans - ST - Small |
8.45 |
17.55 |
19.74 |
CodeTrans - ST - Base |
9.12 |
15.00 |
18.65 |
CodeTrans - TF - Small |
10.06 |
17.71 |
20.40 |
CodeTrans - TF - Base |
10.94 |
17.66 |
21.12 |
CodeTrans - TF - Large |
12.41 |
18.40 |
21.43 |
CodeTrans - MT - Small |
13.11 |
19.15 |
22.39 |
CodeTrans - MT - Base |
13.37 |
19.24 |
23.20 |
CodeTrans - MT - Large |
13.24 |
19.40 |
23.57 |
CodeTrans - MT - TF - Small |
12.10 |
18.25 |
22.03 |
CodeTrans - MT - TF - Base |
10.64 |
16.91 |
21.40 |
CodeTrans - MT - TF - Large |
12.14 |
19.98 |
21.10 |
CODE - NN |
-- |
18.40 |
20.50 |
đ License
No license information was provided in the original document, so this section is skipped.
Created by Ahmed Elnaggar | LinkedIn and Wei Ding | LinkedIn