endpoint = 'http://senpy.gsi.upm.es/api'

"""
Explanation: Tutorial
This short tutorial will teach you how to consume senpy services for several tasks, and how to take advantage of the features of the framework.
In particular, it covers:

Annotating text with sentiment and emotion using interoperable services
Switching to different services (service interoperability)
Getting results in different formats (Turtle, XML, text...)
Asking for specific emotion models (automatic model conversion)

The tutorial is originally published as an interactive jupyter notebook (ipynb file) that you can download and run locally.
The on-line documentation contains a static version of the notebook.
Requirements
We will use the demo server at http://senpy.gsi.upm.es and the requests library.
We will use a variable for our endpoint.
To try these examples on other instances simply change the value of this variable and re-run the query:
End of explanation
"""


import requests
from IPython.display import Code
     
def query(endpoint, **kwargs):
    '''Query a given Senpy endpoint with specific parameters, and prettify the output'''
    res = requests.get(endpoint,
                       params=kwargs)
    if res.status_code != 200:
        raise Exception(res)
    return Code(res.text, language=kwargs.get('outformat', 'json-ld'))

"""
Explanation: We will also add a little helper function (query) to simplify our queries and pretty-print the results with syntax highlighting:
End of explanation
"""


query(f'{endpoint}/sentiment140', input="Senpy is awesome")

"""
Explanation: Sentiment Analysis of Text
To start, let us analyse the sentiment in the following sentence: senpy is awesome.
For now, we will use the sentiment140 service, through the sentiment140 plugin.
We will later cover how to use a different service.
End of explanation
"""


query(f'{endpoint}/sentiment140',
      input="Senpy is awesome",
      outformat="turtle")

"""
Explanation: Senpy services always return an object of type senpy:Results, with a list of entries.
You can think of an entry as a self-contained textual context (nif:Context and senpy:Entry).
Entries can be as short as a sentence, or as long as a news article.
Each entry has a nif:isString property that contains the original text of the entry, and several other properties that are provided by the plugins.
For instance, sentiment annotations are provided through marl:hasOpinion.
The annotations are semantic.
This is clear if we request a different semantic format, such as turtle.
The output format is controlled with the outformat parameter:
End of explanation
"""


query(f'{endpoint}/sentiment-basic',
      input="Senpy is awesome")

"""
Explanation: Moving to a different service
All senpy plugins use the same API, which makes moving from one service to another a breeze.
Let us modify the earlier example, which uses the sentiment140 service, to use a different service (e.g. the sentiment-basic plugin).
We can do it just by changing the URL of the service:
End of explanation
"""


query(f'{endpoint}/emotion-depechemood',
      input="Senpy is a wonderful that service")

"""
Explanation: As you can see, the structure and annotation schema of the response is the same.
This makes it very easy to compare and migrate to different services.
Service interoperability is not only useful for users.
It is also key for other features such as automated evaluation.
This is a compelling reason to adapt existing services to use the Senpy API.
In fact, the sentiment140 senpy service is proxy to the public Sentiment 140 service.
Emotion analysis
Senpy uses the onyx vocabulary to represent emotions, which incorporates the notion of EmotionSet's, an emotion that is composed of several emotions.
In a nutshell, an Entry is linked to one or more EmotionSet, which in turn is made up of one or more Emotion.
Let's illustrate it with an example, using the emotion-depechemood plugin.
End of explanation
"""


query(f'{endpoint}/emotion-depechemood',
      input="Senpy is a wonderful service",
      maxemotion=True)

"""
Explanation: As you have probably noticed, there are several emotions in this result, each with a different intensity.
We can also tell senpy to only return the emotion with the maximum intensity using the maxemotion parameter:
End of explanation
"""


query(f'{endpoint}/emotion-anew',
      input="Senpy is a wonderful service and I love it")

"""
Explanation: Emotion conversion
Sometimes the model used by a plugin is not right for your application. Senpy ships with emotion conversion capabilities: you can ask for a specific emotion model in your request and the service will try to automatically convert the results.
For example, the emotion-anew plugin uses the dimensional pad (or VAD, valence-arousal-dominance) model, as we can see here:
End of explanation
"""


query(f'{endpoint}/emotion-anew',
      input="Senpy is a wonderful service and I love it",
      emotionmodel="emoml:big6")

"""
Explanation: If we need a category level, we can ask for the equivalent results in the big6 model:
End of explanation
"""


query(f'{endpoint}/emotion-anew',
      input="Senpy is a wonderful service and I love it",
      emotionmodel="emoml:big6",
      conversion="nested")

"""
Explanation: Because we don't usually care about the original emotion, the conversion can be presented in three ways:

full: the original and converted emotions are included at the same level
filtered: the original emotion is replaced by the converted emotion
nested: the original emotion is replaced, but the converted emotion points to it

For example, here's how the nested structure would look like:
End of explanation
"""


