fix conversion for round parameter so it is converted to integer if isnumeric is true. Added some extra comments to make it more clear to the user how to interact with the Gradio UI

app.py

@@ -1,4 +1,5 @@
 import gradio as gr
+import pandas as pd
 
 # Local modules
 import fastf1_tools
@@ -17,8 +18,8 @@ iface_driver_championship_standings = gr.Interface(
         gr.Dropdown(label="Driver", choices=DRIVER_NAMES)
     ],
     outputs="text",
-    title="Driver Championship Standings",
-    description="Get the driver championship standings"
+    title="World Driver Championship Standings",
+    description="Get the world driver championship standings for a specific driver"
 )
 
 iface_constructor_championship_standings = gr.Interface(
@@ -28,20 +29,20 @@ iface_constructor_championship_standings = gr.Interface(
         gr.Dropdown(label="Constructor", choices=CONSTRUCTOR_NAMES)
     ],
     outputs="text",
-    title="Constructor Championship Standings",
-    description="Get the constructor championship standings"
+    title="World Constructor Championship Standings",
+    description="Get the world constructor championship standings for a specific constructor"
 )
 
 iface_event_info = gr.Interface(
     fn=fastf1_tools.get_event_info,
     inputs=[
         gr.Number(label="Calendar year", value=CURRENT_YEAR, minimum=1950, maximum=CURRENT_YEAR),
-        gr.Textbox(label="Grand Prix", placeholder="Ex: Monaco", info="The name of the GP/country/location (Fuzzy matching supported)"),
+        gr.Textbox(label="Grand Prix", placeholder="Ex: Monaco", info="The name of the GP/country/location (Fuzzy matching supported) or round number"),
         gr.Radio(["human", "LLM"], label="Display format", value="human")
     ],
     outputs="text",
     title="Event Info",
-    description="Get the Grand Prix event info for a specific race week"
+    description="Get information about a specific Grand Prix event. Example: (2025,Monaco,human)"
 )
 
 iface_season_calendar = gr.Interface(
@@ -51,32 +52,36 @@ iface_season_calendar = gr.Interface(
     ],
     outputs="text",
     title="Season Calendar",
-    description="Get the season calendar information for the given year"
+    description="Get the season calendar for the given year"
 )
 
 iface_track_visualization = gr.Interface(
     fn=fastf1_tools.track_visualization,
     inputs=[
         gr.Number(label="Calendar year", value=CURRENT_YEAR, minimum=1950, maximum=CURRENT_YEAR),
-        gr.Textbox(label="Grand Prix", placeholder="Ex: Monaco", info="The name of the GP/country/location (Fuzzy matching supported)"),
-        gr.Radio(["speed", "corners", "gear"], label="Visualization type", value="speed"),
-        gr.Dropdown(DRIVER_NAMES)
+        gr.Textbox(label="Grand Prix", placeholder="Ex: Monaco", info="The name of the GP/country/location (Fuzzy matching supported) or round number"),
+        gr.Radio(["speed", "corners", "gear"], label="Visualization type", value="speed", info="What type of track visualization to generate"),
+        gr.Dropdown(label="Driver", choices=DRIVER_NAMES, info="Only applied for speed visualization. gear uses fastest lap during race.")
     ],
     outputs="image",
     title="Track Visualizations",
-    description="Get the track visualization for the given Grand Prix"
+    description="Get the track visualization for the given Grand Prix. Example: (2025,Monaco,speed,Leclerc)"
 )
 
 iface_session_results = gr.Interface(
     fn=fastf1_tools.get_session_results,
     inputs=[
         gr.Number(label="Calendar year", value=CURRENT_YEAR, minimum=1950, maximum=CURRENT_YEAR),
-        gr.Textbox(label="Grand Prix", placeholder="Ex: Monaco", info="The name of the GP/country/location (Fuzzy matching supported)"),
-        gr.Dropdown([session_type for session_type in DROPDOWN_SESSION_TYPES if "practice" not in session_type], label="Session type", value="race")
+        gr.Textbox(label="Grand Prix", placeholder="Ex: Monaco", info="The name of the GP/country/location (Fuzzy matching supported) or round number"),
+        gr.Dropdown([session_type for session_type in DROPDOWN_SESSION_TYPES if "practice" not in session_type], label="Session type", value="race", info="The session type to get results for. Dataframe's columns vary depending on session type.")
     ],
-    outputs=gr.DataFrame(),
+    outputs=gr.Dataframe(
+        headers=None,              # Let it infer from returned DataFrame
+        row_count=(0, "dynamic"),  # Start empty, allow it to grow
+        col_count=(0, "dynamic")   # Let columns adjust too
+    ),
     title="Session Results",
-    description="Get the session results for the given Grand Prix"
+    description="Get the session results for the given Grand Prix. Example: (2025,Monaco,qualifying)"
 )
 
 iface_driver_info = gr.Interface(
@@ -86,7 +91,7 @@ iface_driver_info = gr.Interface(
     ],
     outputs="text",
     title="Driver Info",
-    description="Get information about a specific driver"
+    description="Get background information about a specific driver"
 )
 
 iface_constructor_info = gr.Interface(
@@ -96,7 +101,7 @@ iface_constructor_info = gr.Interface(
     ],
     outputs="text",
     title="Constructor Info",
-    description="Get information about a specific constructor"
+    description="Get background information about a specific constructor"
 )
 
 

fastf1_tools.py

@@ -48,6 +48,9 @@ def get_session(year: int, round: gp, session_type: session_type) -> Session:
     if isinstance(session_type, str):
         if session_type.lower() not in AVAILABLE_SESSION_TYPES:
             return f"Session type {session_type} is not available. Supported session types: {AVAILABLE_SESSION_TYPES}"
+    
+    if isinstance(round, str) and round.isnumeric():
+        round = int(round)
 
     return fastf1.get_session(year, round, session_type)
 
@@ -75,6 +78,9 @@ def get_event_info(year: int, round: gp, format: str) -> str:
         str: Formatted event information based on the specified format
     """
 
+    if isinstance(round, str) and round.isnumeric():
+        round = int(round)
+
     event = fastf1.get_session(year, round, "race").event # Event object is the same for all sessions, so hardcode "race"
     if format == "human":
         data_interval = f"{event['Session1DateUtc'].date()} - {event['Session5DateUtc'].date()}"
@@ -173,6 +179,8 @@ def track_visualization(year: int, round: gp, visualization_type: str, driver_na
     Returns:
         Image.Image: A PIL Image object containing the visualization
     """
+    if isinstance(round, str) and round.isnumeric():
+        round = int(round)
 
     session = get_session(year, round, "race")
     session.load()
@@ -196,17 +204,21 @@ def get_session_results(year: int, round: gp, session_type: session_type) -> pd.
         pd.DataFrame: DataFrame containing the session results
         
     Raises:
-        gr.Error: If the session type is not supported for the specified round
+        ValueError: If the session type is invalid
     """
+    if isinstance(round, str) and round.isnumeric():
+        round = int(round)
 
     try:
         session = get_session(year, round, session_type)
         session.load(telemetry=False)
-        results = session.results
+        # Create a proper copy of the results DataFrame
+        df = session.results[['DriverNumber', 'Abbreviation', 'FullName', 'Position', 
+                            'GridPosition', 'Points', 'Status', 'Q1', 'Q2', 'Q3']].copy()
     except ValueError as e:
         raise gr.Error(f"Session type {session_type} is not supported for the specified round. This Grand Prix most likely did not include a sprint race/quali.")
 
-    df = results[["DriverNumber", "Abbreviation", "FullName", "Position", "GridPosition", "Points", "Status", "Q1", "Q2", "Q3"]]
+    # Now we can safely modify the DataFrame
     df["Name"] = df.apply(lambda row: f"{row['FullName']} ({row['Abbreviation']} • {row['DriverNumber']})", axis=1)
     df = df.drop(columns=["FullName", "Abbreviation", "DriverNumber"])
     df = df.rename(columns={"Position": "Pos", "GridPosition": "Grid Pos"})

todo.txt

@@ -2,6 +2,4 @@
     * Solution is to have a static json file that maps drivers for each season/year
 - Same applies for constructor championship standings but instead Constructor dropdown
     * Similar solution to above
-- Implement a tab for the OpenF1 tools but it might not be that user friendly :/
-- Add some helpful info for each Gradio Tab to help user understand what they are able to do
-- for session result remove the default placeholder value
+- Implement a tab for the OpenF1 tools but it might not be that user friendly :/