initial commit

README.md

@@ -1,13 +1,13 @@
 ---
-title: Probability Basics Pt1
-emoji: 🚀
-colorFrom: indigo
-colorTo: indigo
+title: Probability Basics (Pt. 1)
+emoji: 🎲
+colorFrom: pink
+colorTo: blue
 sdk: gradio
-sdk_version: 4.21.0
+sdk_version: 4.20.1
 app_file: app.py
-pinned: false
+pinned: true
 license: apache-2.0
 ---
 
-Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference
+Learn about the basics of Probability Theory, including concepts like: `sample spaces`, `outcomes`, and `events`. See how these concepts come together to calculate the `probability of an event` occurring.

app.py

@@ -0,0 +1,134 @@
+import random
+import gradio as gr
+
+OUTCOMES = [1, 2, 3, 4, 5, 6]
+
+
+# Function to simulate a simple die roll experiment
+def roll_die():
+    result = random.choice(OUTCOMES)
+    return result
+
+# Roll the die and check if the result is even
+def test_event():
+    result = roll_die()
+    return result, "Yes" if result % 2 == 0 else "No"
+
+# Compute the probability of an event
+def compute_event_probability(favorable_outcomes, possible_outcomes):
+    if favorable_outcomes == "" or possible_outcomes == "":
+        return "Please input the set of favorable and possible outcomes"
+    
+    favorable_outcomes = favorable_outcomes.split(",")
+    possible_outcomes = possible_outcomes.split(",")
+    
+    try:
+        favorable_outcomes = list(map(int, favorable_outcomes))
+    except ValueError:
+        return "Please input a valid set of favorable outcomes"
+
+    try:    
+        possible_outcomes = list(map(int, possible_outcomes))
+    except ValueError:
+        return "Please input a valid set of possible outcomes"
+    
+    if not set(favorable_outcomes).issubset(set(possible_outcomes)):
+        return "Favorable outcomes should be a subset of possible outcomes"
+
+    probability = len(favorable_outcomes) / len(possible_outcomes)
+    return f"The probability of the event is: {probability:.0%}"
+
+# Produce randomized favorable and possible outcomes
+def randomize_outcomes():
+    n_favorable_outcomes = random.randint(1, 6)
+    favorable_outcomes = random.sample(OUTCOMES, n_favorable_outcomes)
+    possible_outcomes = OUTCOMES
+    return ",".join(map(str, favorable_outcomes)), ",".join(map(str, possible_outcomes))
+
+
+
+# Create a Gradio interface
+css = """
+.gradio-container {
+    width: 40%!important;
+    min-width: 800px;
+}
+"""
+with gr.Blocks(css=css) as demo:
+    gr.Markdown(
+        """
+        # Probability Basics (Pt. 1)
+        <div align="center">
+        <br>
+        <img src="https://media.giphy.com/media/UThpUbZef3ulWxgvfn/giphy.gif?cid=790b7611d3ky210i43bt6fubpzql9nu8ilbsnhma17ozfas7&ep=v1_gifs_search&rid=giphy.gif&ct=g" />
+        <p>Let's explore some basics of Probability theory!</p>
+        <br>
+        </div>
+
+        In probability theory, `sample spaces`, `outcomes`, and `events` are fundamental concepts that provide the foundation
+        for understanding and working with probabilities. Let's explore these concepts and how they relate to each other.
+        """
+    )
+    gr.Markdown(
+        """
+        ## Sample Spaces and Outcomes
+        The `sample space` is the **set of all possible `outcomes`** of a random experiment or random process.
+
+        For example, if you roll a `six-sided die`, the sample space would be `{1, 2, 3, 4, 5, 6}`, as these are all outcomes that can occur.
+        """
+    )
+    with gr.Row():
+        die_roll = gr.Button(value="Roll the Die! 🎲🎲")
+        die_roll_output = gr.Textbox(label="You have rolled a..", placeholder="", interactive=False)
+    die_roll.click(roll_die, [], [die_roll_output])
+
+    gr.Markdown(
+        """
+        ## Events
+
+        An `event` is any **subset of the `sample space`**, representing a specific outcome or a combination of outcomes.
+        <br>
+        Events are events of interest or events we want to analyze in terms of their probability.
+
+        Continuing with our example, an event like `rolling an even number` would correspond to the subset: `{2, 4, 6}`
+        
+        """
+    )
+
+    with gr.Row():
+        event = gr.Button(value="Try to roll an even number! 🎲🎲")
+        with gr.Row():
+            event_die_roll_output = gr.Textbox(label="You have rolled a..", placeholder="", interactive=False)
+            event_test_output = gr.Textbox(label="Did the event occur?", placeholder="", interactive=False)
+    event.click(test_event, [], [event_die_roll_output, event_test_output])
+
+    gr.Markdown(
+        r"""
+        ## Probability
+
+        The `probability` of an `event` is expressed as a **ratio between** the number of `favorable` and `possible outcomes`.
+        $$ P(\text{Event}) = \frac{\text{Number of (Favorable Outcomes)}}{\text{Number of (Possible Outcomes)}} $$
+        
+        - `Favorable outcomes` are those that satisfy the condition of the `event`.
+        - `Possible outcomes` are all outcomes, regardless of whether they are part of the event or not.
+
+        You can use the space below to calculate the probability of an event.
+        <br>
+        Play around with different sets of favorable and possible outcomes to see how the probability changes.
+        """
+    )
+
+    with gr.Column():
+        with gr.Row():
+            randomize = gr.Button(value="Randomize the favorable and possible outcomes")
+            probability = gr.Button(value="Calculate the probability")
+        with gr.Row():
+            with gr.Column():
+                favorable_outcomes = gr.Textbox(label="Favorable Outcomes", value="2, 4, 6")
+                possible_outcomes = gr.Textbox(label="Possible Outcomes", value="1, 2, 3, 4, 5, 6")
+            probability_output = gr.Textbox(label="Probability", placeholder="", interactive=False)
+    randomize.click(randomize_outcomes, [], [favorable_outcomes, possible_outcomes])
+    probability.click(compute_event_probability, [favorable_outcomes, possible_outcomes], [probability_output])
+
+# Launch the Blocks interface
+demo.launch()

requirements.txt

@@ -0,0 +1,198 @@
+#
+# This file is autogenerated by pip-compile with Python 3.10
+# by the following command:
+#
+#    pip-compile requirements.in
+#
+aiofiles==23.2.1
+    # via gradio
+altair==5.2.0
+    # via gradio
+annotated-types==0.6.0
+    # via pydantic
+anyio==4.3.0
+    # via
+    #   httpx
+    #   starlette
+attrs==23.2.0
+    # via
+    #   jsonschema
+    #   referencing
+certifi==2024.2.2
+    # via
+    #   httpcore
+    #   httpx
+    #   requests
+charset-normalizer==3.3.2
+    # via requests
+click==8.1.7
+    # via
+    #   typer
+    #   uvicorn
+colorama==0.4.6
+    # via typer
+contourpy==1.2.0
+    # via matplotlib
+cycler==0.12.1
+    # via matplotlib
+exceptiongroup==1.2.0
+    # via anyio
+fastapi==0.110.0
+    # via gradio
+ffmpy==0.3.2
+    # via gradio
+filelock==3.13.1
+    # via huggingface-hub
+fonttools==4.49.0
+    # via matplotlib
+fsspec==2024.2.0
+    # via
+    #   gradio-client
+    #   huggingface-hub
+gradio==4.19.2
+    # via -r requirements.in
+gradio-client==0.10.1
+    # via gradio
+h11==0.14.0
+    # via
+    #   httpcore
+    #   uvicorn
+httpcore==1.0.4
+    # via httpx
+httpx==0.27.0
+    # via
+    #   gradio
+    #   gradio-client
+huggingface-hub==0.21.4
+    # via
+    #   gradio
+    #   gradio-client
+idna==3.6
+    # via
+    #   anyio
+    #   httpx
+    #   requests
+importlib-resources==6.1.3
+    # via gradio
+jinja2==3.1.3
+    # via
+    #   altair
+    #   gradio
+jsonschema==4.21.1
+    # via altair
+jsonschema-specifications==2023.12.1
+    # via jsonschema
+kiwisolver==1.4.5
+    # via matplotlib
+markdown-it-py==3.0.0
+    # via rich
+markupsafe==2.1.5
+    # via
+    #   gradio
+    #   jinja2
+matplotlib==3.8.3
+    # via gradio
+mdurl==0.1.2
+    # via markdown-it-py
+numpy==1.26.4
+    # via
+    #   altair
+    #   contourpy
+    #   gradio
+    #   matplotlib
+    #   pandas
+orjson==3.9.15
+    # via gradio
+packaging==23.2
+    # via
+    #   altair
+    #   gradio
+    #   gradio-client
+    #   huggingface-hub
+    #   matplotlib
+pandas==2.2.1
+    # via
+    #   altair
+    #   gradio
+pillow==10.2.0
+    # via
+    #   gradio
+    #   matplotlib
+pydantic==2.6.3
+    # via
+    #   fastapi
+    #   gradio
+pydantic-core==2.16.3
+    # via pydantic
+pydub==0.25.1
+    # via gradio
+pygments==2.17.2
+    # via rich
+pyparsing==3.1.2
+    # via matplotlib
+python-dateutil==2.9.0.post0
+    # via
+    #   matplotlib
+    #   pandas
+python-multipart==0.0.9
+    # via gradio
+pytz==2024.1
+    # via pandas
+pyyaml==6.0.1
+    # via
+    #   gradio
+    #   huggingface-hub
+referencing==0.33.0
+    # via
+    #   jsonschema
+    #   jsonschema-specifications
+requests==2.31.0
+    # via huggingface-hub
+rich==13.7.1
+    # via typer
+rpds-py==0.18.0
+    # via
+    #   jsonschema
+    #   referencing
+ruff==0.3.1
+    # via gradio
+semantic-version==2.10.0
+    # via gradio
+shellingham==1.5.4
+    # via typer
+six==1.16.0
+    # via python-dateutil
+sniffio==1.3.1
+    # via
+    #   anyio
+    #   httpx
+starlette==0.36.3
+    # via fastapi
+tomlkit==0.12.0
+    # via gradio
+toolz==0.12.1
+    # via altair
+tqdm==4.66.2
+    # via huggingface-hub
+typer[all]==0.9.0
+    # via gradio
+typing-extensions==4.10.0
+    # via
+    #   altair
+    #   anyio
+    #   fastapi
+    #   gradio
+    #   gradio-client
+    #   huggingface-hub
+    #   pydantic
+    #   pydantic-core
+    #   typer
+    #   uvicorn
+tzdata==2024.1
+    # via pandas
+urllib3==2.2.1
+    # via requests
+uvicorn==0.27.1
+    # via gradio
+websockets==11.0.3
+    # via gradio-client