Annexure & Sources
1. Methodology
Formula derivations, thresholds and missing-data treatment for version v0.1 (demo baseline).
mv-2026-09-demoEffective from 2026-09-01Baseline weights proposed in the product brief. Critic reviews are excluded from v1. All weights are configurable and versioned.Scope and eligibility
- A person counts as a Hero only for films where they are a verified principal or genuine co-principal male lead. Lead status is an editorially approved credit, never inferred from cast order.
- A genuine multi-hero film counts once for every verified principal lead.
- Excluded credits: supporting roles, cameos, guest/special appearances, song-only, narration/voice-only, and re-release screenings.
- Eligible titles: feature-length films from 1 January 2000, originally released in Telugu or with an identifiable Telugu-dubbed release. Theatrical and full-length direct-to-OTT features are both included.
- Excluded formats: web/TV series, YouTube films, short films, anthology segments, music videos, promotional sketches.
- The default roster shows heroes with at least 3 verified eligible lead films. Include emerging heroes reveals those with 1–2.
Telugu-version rule for dubbed titles
For a dubbed title, the all-language worldwide gross is never assigned to the Telugu version. Telugu-version collections are used only when a source reports them separately; otherwise Telugu commercial evidence is unknown.
IMDb/TMDb ratings are stored as film-wide reception evidence and are never labelled as a Telugu-audience-only rating.
Film Success Score
Film Success Score = 0.35 × Audience Reception Score + 0.35 × Commercial / Platform Performance Score + 0.20 × Evidence Quality Score + 0.10 × Legacy / Cultural Impact Score
Missing components are never converted to zero. Their weight is redistributed across available components and the film's evidence coverage drops. Each film carries a scoring status:
- scored — audience and commercial/platform evidence both available.
- provisional — only one of them available.
- insufficient_evidence — neither available; no score is calculated.
- not_yet_final — released within 120 days; excluded from ratios until the run is reconciled.
A film succeeds when its score is at least 60.
Audience Reception Score
Source priority: licensed/permitted IMDb rating + votes → TMDb vote average + count → authorised editorial source.
Adjusted rating = (v / (v + m)) × R + (m / (v + m)) × C R = film rating, v = vote count C = vote-weighted baseline rating of the title universe (fallback 6.2) m = minimum-vote threshold = 2,500
The adjusted rating is mapped linearly from 3–9 onto 0–100 only after raw rating, vote count, source and retrieval date are stored. The hero-level Audience Reception Index is the average of film scores weighted by vote confidence v/(v+m).
Commercial / Platform Performance Score
Theatrical titles, in order of preference:
- Recovery ratio = Telugu distributor share ÷ Telugu theatrical business, both in the same version scope and currency (money handled as integer minor units). 1.0× recovery = 60; 2.0× = 95; 0.3× = 10.
- Release-time trade verdict (stored separately from the calculated score): disaster 5 · flop 20 · below average 35 · average 50 · above average 62 · hit 75 · super hit 87 · blockbuster 97.
Disputes: when approved claims for the same metric differ by more than 15%, the film is flagged disputed, the conservative (lowest) value is used and confidence drops to low. All claims are kept in the Annexure.
OTT titles: Platform Performance replaces theatrical outcome only when credible official platform evidence exists (official releases, top-10 lists, disclosed views/hours). Editorial bands: weak 30 · moderate 55 · strong 78 · exceptional 92. Without evidence, platform outcome is unknown — not zero.
Evidence quality and legacy
Evidence Quality Score (0–100): up to 40 for confident audience evidence, up to 40 for commercial/platform evidence by confidence (high 40, medium 28, low 15, disputed 5), plus 20 when two or more independent sources corroborate.
Legacy / cultural impact is editorially reviewed and source-backed — never auto-generated from social chatter. Values: none 50 · reappraised 70 · enduring popularity 82 · cult favourite 88 · not reviewed unavailable. A theatrical underperformer that is later reappraised keeps both records; one never overwrites the other.
Star Score (the headline number)
| Success ratio | 20% |
| Hit films | 15% |
| Total box office | 15% |
| Blockbusters | 10% |
| Recent success | 10% |
| Social media reach | 10% |
| Biggest film | 5% |
| Box office per film | 5% |
| Films as lead | 10% |
| Fans' votes (only when the fans' ranking is on) | 5% |
part score = percentile rank among the heroes compared (0–100) for counts and money
= blended ratio × 100, (hits + p·k) / (judged + k) success ratio k=5, recent k=2,
p = pooled hit rate of all heroes
= social reach index (log scale, see below) for followers
Star Score = Σ weight × part score / Σ weight over parts the hero has data for
withheld when the parts with data carry < 50% of the weight
money parts count only with ≥ 3 films, and ≥ 25% of films, having a reported grossThe Star Score combines every KPI into one number for people who want a single ranking. Missing parts are never zero: their weight is shared among the parts a hero has. Each hero page shows his Star Score part by part.
Hero Performance Index (film-quality index, secondary)
| Film Success Index | 35% |
| Audience Reception Index | 25% |
| Consistency Index | 15% |
| Verified Public Social Reach Index | 15% |
| Recent Career Momentum | 10% |
The HPI is a transparent, configurable benchmark — not objective fact. It is withheld when Film Success or Audience indices are unavailable; other missing components have their weight redistributed and the result is marked as a smaller sample.
Hero KPIs
- Star Score (higher is better)
- One number out of 100 that combines every KPI: success ratio 20%, hit films 15%, total box office 15%, blockbusters 10%, recent success 10%, social media reach 10%, biggest film 5%, box office per film 5%, films as lead 10% (fans' votes join at 5% when that is switched on). Missing parts are left out, never counted as zero; box-office parts need at least 3 films with a reported gross.
- Success ratio (higher is better)
- Out of every 100 films with a known box-office result, how many were hits (earned at least 2× their budget, or were reported as hits).
- Hit films (higher is better)
- How many of the hero's films were box-office hits or blockbusters.
- Films as lead hero (higher is better)
- Number of feature films released in Telugu with this hero as a lead.
- Average audience rating (higher is better)
- Simple average of the audience ratings (out of 10) of the hero's films.
- Recent success ratio (last 5 films) (higher is better)
- Share of hits among the hero's latest five films with a known box-office result.
- Most films in one year (higher is better)
- The highest number of the hero's films released in any single calendar year.
- Average gap between films (lower is better)
- Typical number of months between one release and the next. Shorter means more frequent releases.
- Films per year (higher is better)
- Films divided by the number of years between the first and latest release.
- Years active (higher is better)
- Years from the first to the latest counted release (from 2000).
- Blockbusters (higher is better)
- Films that earned at least 3× their budget worldwide, or were reported as blockbusters.
- Total box office (higher is better)
- Worldwide gross of all his films added together, in ₹ crore (as reported; all languages).
- Biggest box-office film (higher is better)
- Worldwide gross of his highest-grossing film, in ₹ crore.
- Average box office per film (higher is better)
- Average worldwide gross of his films that have a reported gross, in ₹ crore.
- ₹100-crore films (higher is better)
- Films that grossed ₹100 crore or more worldwide.
- X (Twitter) followers (higher is better)
- Followers on his official X account (millions), as last recorded on Wikidata with a date.
- Instagram followers (higher is better)
- Followers on his official Instagram account (millions), as reported in the press with a date. Only heroes named in that report have a value.
- Overall score (higher is better)
- One combined score out of 100: film results 35%, audience ratings 25%, consistency 15%, social media reach 15%, recent form 10%.
- Average film score (higher is better)
- Average of the hero's film scores (each film scored out of 100 from audience rating and box office / OTT result).
- Audience-approved ratio (higher is better)
- Share of films that audiences rated well (adjusted rating of about 6.6/10 or more).
- Audience score (higher is better)
- Audience ratings turned into a score out of 100, giving more weight to films with many votes.
- Consistency (higher is better)
- How steady the results are from film to film. 100 = every film does about equally well.
- Social media reach (higher is better)
- Followers on his official X and Instagram accounts added up and put on a log scale: 10 thousand = 0, 100 million = 100. Not a fan count.
- Recent form (higher is better)
- Latest five films compared with the hero's usual level. 50 = usual, above 50 = doing better lately.
Consistency = 100 − min(100, stdev(Film Success Scores) / 25 × 100) [needs 3+ scored films] Momentum = 50 + (recency-weighted mean of last 5 scores − career mean) / 20 × 50 Social = (log10(sum of official followers, latest per platform) − 4) / 4 × 100 Films/yr = eligible films ÷ (last year − first year + 1)
Confidence grade: high with 8+ films and 75%+ evidence coverage, medium with 5+ and 50%+, low otherwise when any evidence exists.
What is deliberately not used in v1
- Critic reviews and critic-score aggregation (the data model leaves room for a later module).
- Scraped IMDb pages or any unlicensed scraping. IMDb integration stays disabled until a permitted source exists.
- BookMyShow ratings (no public official API; optional later only under a valid licence).
- “Fan counts”. Social reach is official-profile public followers with a snapshot date.