Speed Polars

The Speed Polars app is designed for Vsk5 sailors to analyze polar data efficiently. It allows users to upload CSV files containing polar data (TWS, TWA and BS) for different sail configurations (Jib, Genoa, and Spinnaker) and visualize them through an interactive chart.

This app integrates seamlessly with both the Vsk5 Polar Data Recorder, enabling quick manual data collection, and the Vsk Revolution Voice to CSV Data Recorder, enabling voice automated data collection and real-time analysis.

Quick Start Guide

1. Uploading Polar Data

1. Download the CSV Templates.

2. Format your data correctly (True Wind Speed, True Wind Angle, Boat Speed). A CSV file editor is located below.

3. Click on one of the upload buttons.

4. Select and upload CSV files for Jib, Genoa, and Spinnaker.

5. The chart will update automatically.
   
   

2. Interpreting the Chart

• The scatter plot visualizes boat speed vs. true wind angle, with colors distinguishing sail types.
  
  

3. Interacting with the Chart

• Zoom & Pan: Scroll or pinch to zoom, click and drag to pan.

• Tooltips: Hover over a data point to see wind speed, angle, and boat speed details.
  
  

Detailed User Guide

File Format Specifications

Each CSV file must follow this structure:

TWS,TWA,BS

6,45,5.8

6,60,6.2

10,45,7.1

• TWS (True Wind Speed) – Knots

• TWA (True Wind Angle) – Degrees

• BS (Boat Speed) – Knots

Starboard tack and port tack TWA values are assumed to be asymmetric and do not need to be entered as positive (+) or negative (-) values.

Each file represents data for a specific sail configuration.

Step-by-Step Usage Instructions

1. Uploading Files

• Click the "Jib Polars", "Genoa Polars", or "Spin Polars" upload buttons.

• Select the respective CSV file from your system.

• The tool will parse the data and update the chart & table dynamically.

2. Understanding the Chart

• X-Axis: Boat speed (knots)

• Y-Axis: True wind angle (°)

• Color Coding:

  • Red: Jib

  • White: Genoa

  • Blue: Spinnaker
    
    

3. Zooming & Panning

• Scroll to zoom in/out

• Reset by refreshing the page

The Speed Polar CSV File Editor is a web-based tool that allows users to upload, edit, and manage CSV files containing polar data. It simplifies the process of modifying and downloading polar CSV files for different sail configurations (Jib, Genoa, Spinnaker).

Supported CSV Format

The CSV file should follow this format:

TWS,TWA,BS

6,45,5.8

6,60,6.2

10,45,7.1

• TWS (True Wind Speed) – Knots

• TWA (True Wind Angle) – Degrees

• BS (Boat Speed) – Knots

Starboard tack and port tack TWA values are asymmetric and do not need to be entered as positive (+) or negative (-) values.

Each file should contain values for a specific sail configuration: Jib, Genoa, or Spinnaker.

Using the CSV File Editor

1. Uploading a CSV File

1. Click the "Choose File" button.

2. Select a valid CSV file from your system.

3. The file will be processed, and the data will be displayed in a table format.
   
   

2. Editing Table Data

• Click on any cell in the table to edit its value.

• The changes will be automatically saved in the table.

• The first row (headers) is not editable.
  
  

3. Adding a New Row

1. Click the "Add Row" button.

2. A new blank row will be added at the bottom.

3. Click on the new row and enter the required values.
   
   

4. Clearing All Data

• Click the "Clear Data" button to remove all data from the table.

• This will also reset the uploaded file.
  
  

5. Downloading the Edited CSV File

After making changes, you can download the modified file in different formats:

1. Click "Download as Jib Polars" to save the file as jib_polars.csv.

2. Click "Download as Genoa Polars" to save the file as genoa_polars.csv.

3. Click "Download as Spin Polars" to save the file as spin_polars.csv.
   
   

Each button saves the current table data into a CSV file named according to the selected sail configuration.

Quick Start Guide – Voice to CSV Data Recorder

The Voice to CSV Data Recorder simplifies collecting polar data by automatically formatting and saving your spoken values into a CSV file, ready for upload to Speed Polars apps—no templates needed. The app features a real-time data preview chart and an editable table for quick corrections.

How to Use

1. Open Vsk5 in windowed mode or on a second monitor for easy access.

2. Start a race and monitor TWS (True Wind Speed), TWA (True Wind Angle), and BS (Boat Speed) from your instrument panel.

3. Click “Start Dictation” and clearly say the values in order: TWS, TWA, BS.

4. After the third value, the app records the data, updates the live preview, and adds it to the CSV table.

5. If needed, edit values directly in the table; all changes will update in the preview and final CSV file.
   
   

Best Practice: Create a race with no wind shifts, and minimal wave height for steadier, more accurate polar readings and easier data collection.

Complete User Guide – Voice to CSV Data Recorder

Introduction

The Voice to CSV Data Recorder is a tool designed to streamline the collection of polar data from Virtual Skipper 5 (Vsk5). With built-in voice recognition, the app eliminates the need for manual data entry, allowing you to focus on sailing while automatically generating a correctly formatted CSV file.

Key Features

• No Templates Needed – The app automatically formats data into a CSV file, ready for use with Speed Polars apps.

• Live Data Preview – A real-time chart updates as data is collected, showing trends instantly.

• Editable Table – Easily correct mistakes within the app before saving the final CSV.

• Simple Operation – Just dictate values, and the app does the rest.
  
  

Step-by-Step Instructions

1. Setup

• Open Vsk5 in windowed mode or on a second monitor so you can access both the game and the recorder.

• Ensure you have a race environment with steady wind conditions for the most accurate data.
  
  

2. Start Recording

• Monitor your instrument panel for TWS (True Wind Speed), TWA (True Wind Angle), and BS (Boat Speed).

• Click “Start Dictation” and clearly say the three values in order:
  
  

  • TWS (e.g., “12.5”)

  • TWA (e.g., “135”)

  • BS (e.g., “8.2”)
    
    

• After speaking the third value, the app will automatically record the data and display it in the CSV preview and table.
  
  

3. Reviewing & Editing Data

• The table allows you to review and edit any incorrectly recognized values.

• Changes made in the table are automatically reflected in the CSV preview and the downloadable file.
  
  

4. Saving & Using the CSV File

• Once you’ve collected all necessary data, simply download the CSV file.

• The file is formatted and ready for direct upload into Speed Polars apps.
  
  

Best Practices for Accurate Data Collection

• Use Steady Conditions – Set up a race with no wind shifts and minimal waves for better TWS readings.

• Speak Clearly – Ensure background noise is minimal for accurate dictation.

• Verify Before Saving – Use the editable table to fix any errors before downloading the CSV.
  
  

With this simple process, you can efficiently collect and format polar data without needing spreadsheets or manual entry.