lowerated 0.3.4

Lowerated is an opensource library that allows you to rate any item in a statistically accurate way

Lowerated's Rating Algorithm

The Best Way to Rate & Recommend Movies

• An algorithm that provides accurate ratings for any entity.
• Uses diverse sources: reviews, links, documents, and other resources.
• Completely unbiased.
• Combines AI and human evaluation to determine the true rating of an entity.

What is an Entity?

• Anything that can be rated.
• Examples include films, cars, books, music, furniture, even your partner.
• In the case of Lowerated, we're dealing with "Movies".

How Does It Work?

• We have predefined research attributes that, when measured, give a comprehensive understanding of the item. Let's use a movie as an example.

Movie Rating Attributes

We evaluate a movie based on seven attributes:

1. Cinematography - Visual appeal and camera work.
2. Direction - How well the director conveys the story.
3. Story - Plot coherence and engagement.
4. Characters - Depth and development of characters.
5. Production Design - Quality of the sets and overall look.
6. Unique Concept - Originality of the idea.
7. Emotions - Emotional impact on the audience.

We gather reviews from multiple critics and users. Our AI extracts information from the text inputs and assigns numerical values to each attribute. This process is repeated for all reviews, and we average the results.

Each attribute is given a percentage value from 0-100%, reflecting its presence in the movie.

We have identified key attributes for multiple entities, detailed in the listed Entities & Attributes.

How do I use it?

Check out the steps to use Lowerated here.

Prerequisites

Before using the Entity class, ensure you have the required libraries installed:

• lowerated

You can install these libraries using pip:

pip install lowerated

Setup

1. Import the necessary modules and classes:

from lowerated.rate import Entity
from lowerated.rate.utils import entities, find_attributes

2. Define the Entity class with its methods.

Usage

See Available Entities & their Attributes

Get a list of available entities and their attributes:

entities = entities()
print(entities)

To see a specific entity's attributes, use the code below:

entity_name = "Movie"
attributes = find_attributes(entity_name)
print(attributes)

Initializing an Available Entity or Creating a Custom Entity

Create an instance of the Entity class by specifying the entity name and optionally its attributes:

entity_name = "Movie"
attributes = ['Cinematography', 'Direction', 'Story', 'Characters', 'Production Design', 'Unique Concept', 'Emotions']
movie_entity = Entity(entity_name, attributes)

Example 1: Using a List of Reviews

Rate the attributes of an entity using a list of textual reviews:

reviews_list = ["Great movie!", "Not worth the price.", "Excellent cinematography."]
rating = movie_entity.rate(reviews=reviews_list)
print(rating)

Example 2: Using a File Path

Rate the attributes of an entity using a file containing reviews. Supported file formats are CSV, Excel (XLSX), and TXT.

file_path = "reviews.csv"  # Can be .csv, .xlsx, or .txt
rating = movie_entity.rate(file_path=file_path)
print(rating)

Example 3: Using a Download Link

Rate the attributes of an entity using a URL to download the file containing reviews:

download_link = "https://example.com/reviews.xlsx"  # Can be .csv, .xlsx, or .txt
rating = movie_entity.rate(download_link=download_link)
print(rating)

License

Apache 2.0

Copyright (2024) FACT-RATED MEDIA (PVT-LTD)