calculateVoteStatistics function

[MagnusLii]

Vote Result Analytics Function

Goal

This function receives a JSON object detailing vote distribution retrieved from a database query. Its purpose is to process this data, calculate various statistics, and compile them into a structured JSON object.

Statistics to calculate

• Majority: Determines whether the yes or no votes obtained more than 50% + 1 of the total votes.
• Vote Rates: Includes percentages of yes, no, and abstain votes.
• Various Majority Types: Simple, absolute, and supermajority conditions.
• Consensus: Flags indicating whether yes or no votes achieved consensus.

Various Majorities

• Simple Majority: Requires 50% + 1 of counted votes (abstain votes are not taken into account).
• Absolute Majority: Requires 50% + 1 of ALL votes (abstain votes are counted).
• Super majority: Contains conditions:
  • "2 3": Flags if a vote received two-thirds of the vote.
  • "3 4": Flags if a vote received three-fourths of the vote.
  • "4 5": Flags if a vote received four-fifths of the vote.

Return JSON format

{
  "total votes":99,
  "yes":33,
  "no":33,
  "pass":33,
  "percentages":{
    "yes":33.3,
    "no":33.3,
    "pass":33.3
  },
  "majority":{
    "simple majority":{
      "yes":false,
      "no":true,
      "pass":false
    },
    "absolute majority":{
      "yes":false,
      "no":false
    },
    "supermajority":{
      "2 3":{
        "yes":false,
        "no":false
      },
      "3 4":{
        "yes":false,
        "no":false
      },
      "4 5":{
        "yes":false,
        "no":false
      }
    }
    
  },
  "consensus":{
    "yes":false,
    "no":false
  }
}

Arguments

• JSON Object: Contains the count of voters and the count of specified votes (yes, no, abstain).

Returns

• JSON Object: Contains all calculated statistics pertinent to the specified vote.

Function Name: calculateVoteStatistics