You can deploy this model and start earning money today!

aisingapore/
SPANBert

Name: SPANBert
Availability: InStock

Views

No views yet

Causal Span Detection

You can test the model at Casual Span Extraction | SGNLP-Demo.
If you want to find out more information, please contact us at sg-nlp@aisingapore.org.

Model Details
How to Get Started With the Model
Training
Model Parameters
Other Information

Model Details

Model Name: Span Extraction

Description: This is a causal span extraction model based on SPANBert which recognises that causes of emotions in conversations. Given 4 sets of inputs: target utterance, target utterance's emotion, evidence utterance and conversational history, it returns arrays of start and end logits which can be postprocessed to obtain the span which caused the emotion in the target utterance.
Paper: Recognizing emotion cause in conversations. arXiv preprint arXiv:2012.11820., Dec 2020.
Author(s): Poria, S., Majumder, N., Hazarika, D., Ghosal, D., Bhardwaj, R., Jian, S.Y.B., Hong, P., Ghosh, R., Roy, A., Chhaya, N., Gelbukh, A. and Mihalcea, R. (2020).
URL: https://arxiv.org/abs/2012.11820/

How to Get Started With the Model

Install Python package

SGnlp is an initiative by AI Singapore's NLP Hub. They aim to bridge the gap between research and industry, promote translational research, and encourage adoption of NLP techniques in the industry.

Various NLP models, other than aspect sentiment analysis are available in the python package. You can try them out at SGNLP-Demo | SGNLP-Github.

python

pip install sgnlp

Examples

For more full code (such as Causal Span Detection), please refer to this SGNLP-Docs.
Alternatively, you can also try out the Casual Span Extraction | SGNLP-Demo for Causal-Span-Detection.

Example of Causal Span Detection (for surprise):

python

from sgnlp.models.span_extraction import (
    RecconSpanExtractionConfig,
    RecconSpanExtractionModel,
    RecconSpanExtractionTokenizer,
    RecconSpanExtractionPreprocessor,
    RecconSpanExtractionPostprocessor,
)

# Load model
config = RecconSpanExtractionConfig.from_pretrained(
    "https://storage.googleapis.com/sgnlp-models/models/reccon_span_extraction/config.json"
)
tokenizer = RecconSpanExtractionTokenizer.from_pretrained(
    "mrm8488/spanbert-finetuned-squadv2"
)
model = RecconSpanExtractionModel.from_pretrained(
    "https://storage.googleapis.com/sgnlp-models/models/reccon_span_extraction/pytorch_model.bin",
    config=config,
)
preprocessor = RecconSpanExtractionPreprocessor(tokenizer)
postprocessor = RecconSpanExtractionPostprocessor()

# Model predict
input_batch = {
    "emotion": ["surprise", "surprise"],
    "target_utterance": [
        "Hi George ! It's good to see you !",
        "Hi George ! It's good to see you !",
    ],
    "evidence_utterance": [
        "Linda ? Is that you ? I haven't seen you in ages !",
        "Hi George ! It's good to see you !",
    ],
    "conversation_history": [
        "Linda ? Is that you ? I haven't seen you in ages ! Hi George ! It's good to see you !",
        "Linda ? Is that you ? I haven't seen you in ages ! Hi George ! It's good to see you !",
    ],
}

tensor_dict, evidences, examples, features = preprocessor(input_batch)
raw_output = model(**tensor_dict)
context, evidence_span, probability = postprocessor(
    raw_output, evidences, examples, features)

Training

The train and evaluation datasets were derived from the RECCON dataset. The full dataset can be downloaded from the author's github repository.

Training Results

Training Time: ~3 hours for 12 epochs on a single V100 GPU.

Model Parameters

Model Weights: link
Model Config: link
Model Inputs: Target utterance, emotion in target utterance, evidence utterance and conversational history.
Model Outputs: Array of start logits and array of end logits. These 2 arrays can be post processed to detemine the start and end of the causal span.
Model Size: ~411MB
Model Inference Info: ~ 2 sec on Intel(R) Core(TM) i7-8750H CPU @ 2.20GHz.
Usage Scenarios: Recognizing emotion cause for phone support satisfaction.

Other Information

Original Code: link

aisingapore/SPANBert