Skip to content

A-Good-System-for-Smart-Cities/kite-dashboard

Repository files navigation

KiTE-dashboard Streamlit App

This dashboard a user-friendly interface for non-programmers to use KiTE -- a tool that validates and calibrates supervised classification models against bias.

We hope to empower general users to audit models and develop diagnostic plots that help identify and quantify bias in supervised ML models.

  • Policy-makers and general users can use this site to generate the following visualizations:
    1. A calibration curve to compare the calibration of the model's probabilistic predictions.
    2. Model Bias quantification curves, where you can plot Prediction Bias against a set of features (trust_features) in the data provided.
    3. Model Trustworthiness hypothesis testing curve based on $ELCE^2$ -- a test statistic that quantifies bias in a set of features (trust_features) the user specifies

How to use this site?

  1. Collect and pre-process your data as a CSV.
    • Make sure your CSV has your features, labels, and probabilities.
    • Make sure your CSV has your features, labels, and probabilities.
    • Your CSV MUST have the following column:
      • probability -- Accepted values are decimal values $\in [0,1]$
        • What does this mean? -- probability represents the prediction probability for the feature set.
    • Need an Example?
  2. Upload your cleaned data!
  3. Label which columns are your target (y-label) and which set of features you want to use to evaluate trustworthiness.
  4. Generate + Download your plots of interest!

How can I submit feedback/issues?

You can submit any feedback, questions, or issues in the Issues Tab of this Repository. One of our team members will promptly respond to help you out!


How can I safely update this site?

  1. Fork this Repo
  2. Clone the Repo onto your computer
  3. Create a branch (git checkout -b new-feature)
  4. Make Changes
  5. Run necessary quality assurance tools (Formatter, Linter, etc).
  6. Test the site on your local machine with streamlit run app.py
  7. Add your changes (git commit -am "Commit Message" or git add . followed by git commit -m "Commit Message")
  8. Push your changes to the repo (git push origin new-feature)
  9. Create a pull request

About

User-friendly dashboard for users to identify and quantify bias

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published