gleason_score_calculator: Gleason Score and ISUP Grade Group for Prostate Cancer

In cliot: Clinical Indices and Outcomes Tools

Gleason Score and ISUP Grade Group for Prostate Cancer

Description

Calculates the Total Gleason Score and the corresponding International Society of Urological Pathology (ISUP) Prognostic Grade Group. The score is derived from the two most prevalent histologic patterns of the tumor, graded 1 to 5.

Usage

gleason_score_calculator(primary_grade, secondary_grade)

Arguments

primary_grade	Numeric (1-5). The histologic pattern that is most prevalent in the biopsy sample.
secondary_grade	Numeric (1-5). The histologic pattern that is the second most prevalent in the biopsy sample.

Value

A list containing:

Total_Gleason_Score	The sum of the primary and secondary grades (Range 2-10).
ISUP_Grade_Group	The prognostic grade group (1-5) based on the 2014 ISUP consensus.
Prognosis_Description	Text description of the grade group.

References

Epstein JI, Egevad L, Amin MB, et al. The 2014 International Society of Urological Pathology (ISUP) Consensus Conference on Gleason Grading of Prostatic Carcinoma. Am J Surg Pathol. 2016;40(2):244-252. doi:10.1097/PAS.0000000000000530

Examples

# Example 1: Grade Group 1
# Primary 3, Secondary 3
gleason_score_calculator(3, 3)

# Example 2: Grade Group 2 (3+4)
# Primary 3, Secondary 4
gleason_score_calculator(3, 4)

# Example 3: Grade Group 3 (4+3)
# Primary 4, Secondary 3
gleason_score_calculator(4, 3)

cliot documentation built on Dec. 1, 2025, 1:06 a.m.