VisionHowl Documentation

Learn how to use VisionHowl to buy, sell, and create computer vision datasets

Introduction to VisionHowl

What is VisionHowl?

VisionHowl is a platform dedicated to buying, selling, and creating computer vision datasets. Whether you're a researcher looking for high-quality data, a company with proprietary datasets to monetize, or a developer building computer vision applications, VisionHowl provides the tools and marketplace to meet your needs.

Our platform supports various dataset formats, quality verification, and format conversion to ensure you can easily integrate the datasets with your existing workflows.

Key Features

  • Dataset Marketplace: Browse, search, and purchase from a wide variety of computer vision datasets.
  • Seller Platform: Upload and sell your own datasets with detailed metadata and versioning.
  • Format Conversion: Convert datasets between popular formats like COCO, YOLO, and Pascal VOC.
  • Quality Scoring: Evaluate dataset quality based on metadata completeness and content.
  • Versioning: Maintain multiple versions of your datasets with proper tracking.
  • Statistics: Track views, downloads, and purchases of your datasets.
  • Secure Payments: Integrated with Stripe for secure transactions.

Account Setup

Registration

To use VisionHowl, you'll need to create an account. Registration is simple and only requires basic information.

  1. Navigate to the Registration Page

    Click on the "Register" button in the top-right corner of the navigation bar.

  2. Fill Out the Registration Form

    Enter your username, email address, and password. Make sure your password is secure.

  3. Verify Your Email

    After registration, you'll receive a verification email. Click the link in the email to verify your account.

  4. Complete Your Profile

    Once verified, you can log in and complete your profile with additional information.

Note: Email verification is required before you can upload or purchase datasets. If you don't receive the verification email, check your spam folder or use the "Resend Verification" option on the login page.

Login

Once registered, you can log in to access your account.

  1. Navigate to the Login Page

    Click on the "Login" button in the top-right corner of the navigation bar.

  2. Enter Your Credentials

    Enter your username and password.

  3. Access Your Dashboard

    After logging in, you'll be redirected to your dashboard where you can manage your datasets and account.

Tip: If you forget your password, use the "Forgot Password" link on the login page to reset it.

Dashboard Overview

Dashboard Components

Your dashboard is the central hub for managing your datasets and account. Here's what you'll find:

Statistics Overview

At the top of your dashboard, you'll see key statistics:

  • Active Datasets: Number of your approved datasets available in the marketplace.
  • Pending Approval: Datasets waiting for admin review.
  • Total Downloads: How many times your datasets have been downloaded.
  • Total Views: How many times your datasets have been viewed.

Dataset Sections

Your datasets are organized into sections based on their status:

  • Processing Datasets: Datasets that are currently being processed.
  • Pending Approval: Datasets waiting for admin review.
  • Approved Datasets: Datasets that have been approved and are available in the marketplace.
  • Rejected Datasets: Datasets that were rejected, with reasons for rejection.
  • Failed Uploads: Datasets that failed during the upload process.

Quick Actions

The sidebar provides quick access to common actions:

  • Upload New Dataset: Start the process of uploading a new dataset.
  • Manage Metadata Templates: Create and manage templates for dataset metadata.
  • View Upload History: See a history of all your dataset uploads.

Dataset Tools

Additional tools to help you manage your datasets:

  • Upload Dataset: Share your dataset with the community.
  • Metadata Templates: Create and manage metadata templates.
  • Upload History: View your dataset upload history.
  • My Datasets: View and manage all your datasets.

Browsing Datasets

Dataset Catalog

The dataset catalog is the main page for browsing available datasets. You can access it by clicking on "Datasets" in the navigation bar.

The catalog displays datasets in a grid layout with key information:

  • Dataset Name: The name of the dataset.
  • Task Type: The computer vision task the dataset is designed for (e.g., Object Detection, Classification).
  • Format: The format of the dataset (e.g., COCO, YOLO).
  • Size: The size of the dataset in MB.
  • Price: The cost to purchase the dataset.
  • Preview: Sample images from the dataset.

Searching & Filtering

Search Options

VisionHowl provides several ways to find the datasets you need:

Keyword Search

Use the search bar at the top of the dataset catalog to search by keywords. This will match against dataset names, descriptions, and tags.

Filtering

Use the filters in the sidebar to narrow down results by:

  • Task Type: Filter by computer vision task (Object Detection, Classification, Segmentation, etc.).
  • Format: Filter by dataset format (COCO, YOLO, Pascal VOC, etc.).
  • Price Range: Filter by price, including free datasets.
  • Data Type: Filter by real or synthetic data.
  • Size: Filter by dataset size.

Sorting

Sort the results by:

  • Newest: Most recently added datasets.
  • Price (Low to High): Cheapest datasets first.
  • Price (High to Low): Most expensive datasets first.
  • Most Popular: Datasets with the most downloads.
  • Highest Rated: Datasets with the highest quality scores.

Dataset Details

Viewing Dataset Information

Clicking on a dataset in the catalog will take you to its detail page, where you can find comprehensive information:

Basic Information

  • Name & Description: Detailed information about the dataset.
  • Preview Images: Sample images from the dataset.
  • Price: Cost to purchase the dataset.
  • Uploader: The user who uploaded the dataset.
  • Upload Date: When the dataset was added to VisionHowl.
  • Version: Current version number and history.

Technical Details

  • Task Type: The computer vision task the dataset is designed for.
  • Format: The format of the dataset.
  • Size: The size of the dataset in MB.
  • Data Type: Whether the data is real or synthetic.
  • Number of Images/Files: Total count of images or files in the dataset.
  • Annotations: Information about the annotations included.
  • License: The license under which the dataset is distributed.

Quality Score

Each dataset has a quality score based on:

  • Metadata Completeness: How thoroughly the dataset is documented.
  • Preview Quality: Quality and representativeness of preview images.
  • Format Validation: Whether the dataset passes format validation checks.
  • Documentation: Quality of included documentation.

Adding to Cart

Adding Datasets to Your Cart

To purchase a dataset, you first need to add it to your cart:

  1. Navigate to the Dataset Detail Page

    Find a dataset you're interested in and click on it to view its details.

  2. Click "Add to Cart"

    On the dataset detail page, click the "Add to Cart" button. If the dataset is free, you'll see a "Download" button instead.

  3. View Your Cart

    Click on the cart icon in the navigation bar to view your cart and proceed to checkout.

Note: You can add multiple datasets to your cart before checking out. Each dataset can only be added once.

Managing Your Cart

From the cart page, you can:

  • Remove Items: Click the "Remove" button next to any dataset you no longer want.
  • View Dataset Details: Click on a dataset name to return to its detail page.
  • Apply Coupon Codes: Enter a coupon code to receive a discount (if available).
  • Proceed to Checkout: Click the "Proceed to Checkout" button to complete your purchase.

Checkout Process

Completing Your Purchase

VisionHowl uses Stripe for secure payment processing. Here's how to complete your purchase:

  1. Review Your Cart

    Make sure all the datasets you want to purchase are in your cart.

  2. Click "Proceed to Checkout"

    This will take you to the Stripe checkout page.

  3. Enter Payment Information

    Enter your credit card details or use another payment method supported by Stripe.

  4. Complete the Purchase

    After your payment is processed, you'll be redirected back to VisionHowl.

  5. Receive Purchase Confirmation

    You'll see a success message and receive a purchase receipt by email.

Note: VisionHowl does not store your credit card information. All payment processing is handled securely by Stripe.

Downloading Datasets

Accessing Your Purchased Datasets

After purchasing a dataset, you can download it from your dashboard:

  1. Go to Your Dashboard

    Click on "My Dashboard" in the navigation bar.

  2. Find the Purchased Datasets Section

    Scroll down to find the section showing your purchased datasets.

  3. Click "Download"

    Click the "Download" button next to the dataset you want to download.

Tip: You can also download datasets directly from their detail pages after purchasing them.

Format Conversion

Converting Dataset Formats

VisionHowl allows you to convert datasets between different formats:

  1. Start the Download Process

    Click the "Download" button for a dataset you've purchased.

  2. Select a Format

    You'll see a format selection page. Choose the format you want to convert to.

  3. Wait for Conversion

    The system will convert the dataset to your selected format. This may take some time for large datasets.

  4. Download the Converted Dataset

    Once the conversion is complete, the download will start automatically.

Note: Not all formats can be converted to all other formats. The format selection page will show only the compatible formats for each dataset.

Supported Format Conversions

VisionHowl currently supports the following format conversions:

Source Format Target Formats
COCO YOLO, Pascal VOC
YOLO COCO, Pascal VOC
Pascal VOC COCO, YOLO

Creating Datasets

Uploading Your Own Datasets

VisionHowl allows you to upload and sell your own datasets:

  1. Go to "Upload Dataset"

    Click on "Upload Dataset" in your dashboard or navigation bar.

  2. Fill Out the Dataset Information

    Enter the name, description, price, and other details about your dataset.

  3. Upload Dataset Files

    Upload your dataset files in a supported format (ZIP, TAR, etc.).

  4. Add Demo Images

    Upload sample images that showcase your dataset.

  5. Submit for Review

    Submit your dataset for review by the VisionHowl team.

Important: All datasets must be reviewed and approved before they appear in the marketplace. This process typically takes 1-2 business days.
Tip: Before uploading, review our Dataset Guidelines to ensure your dataset meets our quality standards and has the best chance of approval.

Metadata Templates

Using Metadata Templates

Metadata templates help you provide consistent and complete information about your datasets:

  1. Access Metadata Templates

    Click on "Metadata Templates" in your dashboard.

  2. Create a New Template

    Click "Create New Template" and define the fields you want to include.

  3. Use the Template

    When uploading a dataset, select your template from the dropdown menu.

  4. Fill in the Fields

    Complete all the fields defined in the template.

Tip: Using metadata templates can improve your dataset's quality score and make it more attractive to potential buyers.

Dataset Quality

Quality Scoring System

VisionHowl evaluates datasets based on several quality criteria:

Metadata Completeness (30%)

How thoroughly you've documented your dataset:

  • Basic information (name, description, task type)
  • Technical details (format, size, number of files)
  • Usage information (license, citation, limitations)

Preview Quality (25%)

The quality and representativeness of your preview images:

  • Number of preview images
  • Diversity of content
  • Image quality

Format Validation (25%)

Whether your dataset passes format validation checks:

  • File structure correctness
  • Annotation format validity
  • No missing references

Documentation (20%)

The quality of included documentation:

  • README file
  • Usage examples
  • Data collection methodology
Note: For detailed information on how to create high-quality datasets that meet these criteria, refer to our comprehensive Dataset Guidelines.

Improving Your Quality Score

To improve your dataset's quality score:

  • Fill out all metadata fields completely
  • Upload diverse and high-quality preview images
  • Ensure your dataset format is valid and consistent
  • Include comprehensive documentation
  • Use metadata templates to ensure completeness

Approval Process

Dataset Review

All datasets go through a review process before being published:

  1. Submit for Review

    After uploading your dataset, click "Submit for Review".

  2. Admin Review

    The VisionHowl team reviews your dataset for quality, content, and compliance.

  3. Approval or Rejection

    You'll receive a notification when your dataset is approved or rejected.

  4. Publication

    Approved datasets are published in the marketplace.

Note: If your dataset is rejected, you'll receive feedback on why it was rejected and how to improve it.

Versioning

Managing Dataset Versions

VisionHowl allows you to maintain multiple versions of your datasets:

  1. Create a New Version

    From your dataset detail page, click "Create New Version".

  2. Upload Updated Files

    Upload the new version of your dataset files.

  3. Describe Changes

    Provide a description of what changed in this version.

  4. Submit for Review

    New versions also go through the review process.

Tip: Regularly updating your datasets with improvements can increase their value and appeal to buyers.

Tracking Statistics

Monitoring Dataset Performance

VisionHowl provides detailed statistics for your datasets:

Views

Track how many times your dataset detail page has been viewed.

Downloads

See how many times your dataset has been downloaded.

Purchases

Track how many times your dataset has been purchased.

Conversion Rates

See the percentage of viewers who purchase your dataset.

Accessing Statistics

To view your dataset statistics:

  1. Go to Your Dashboard

    Click on "My Dashboard" in the navigation bar.

  2. Find Your Dataset

    Locate the dataset you want to view statistics for.

  3. Click "Stats"

    Click the "Stats" button next to the dataset.

Profile Settings

Managing Your Profile

You can update your profile information at any time:

  1. Go to Profile Settings

    Click on your username in the top-right corner and select "Profile".

  2. Edit Your Information

    Update your name, bio, profile picture, and other details.

  3. Save Changes

    Click "Save Changes" to update your profile.

Email Verification

Verifying Your Email

Email verification is required to use all features of VisionHowl:

  1. Register Your Account

    When you register, a verification email is sent to your email address.

  2. Check Your Email

    Open the verification email and click the verification link.

  3. Confirmation

    You'll see a confirmation message that your email has been verified.

Note: If you don't receive the verification email, check your spam folder or use the "Resend Verification" option on the login page.

Password Management

Changing Your Password

To change your password:

  1. Go to Profile Settings

    Click on your username in the top-right corner and select "Profile".

  2. Click "Change Password"

    Click the "Change Password" button.

  3. Enter Your Passwords

    Enter your current password and your new password twice.

  4. Save Changes

    Click "Change Password" to update your password.

Resetting Your Password

If you forget your password:

  1. Go to the Login Page

    Click on "Login" in the navigation bar.

  2. Click "Forgot Password"

    Click the "Forgot Password" link below the login form.

  3. Enter Your Email

    Enter the email address associated with your account.

  4. Check Your Email

    Open the password reset email and click the reset link.

  5. Set a New Password

    Enter your new password twice and click "Reset Password".

Dataset Formats

Supported Formats

VisionHowl supports several common dataset formats:

COCO

A popular format for object detection, segmentation, and keypoint detection:

  • JSON-based annotation format
  • Supports multiple annotation types
  • Hierarchical structure with categories

YOLO

A simple format optimized for real-time object detection:

  • Text-based annotation format
  • One annotation file per image
  • Normalized bounding box coordinates

Pascal VOC

A format used in the PASCAL Visual Object Classes challenge:

  • XML-based annotation format
  • One annotation file per image
  • Absolute bounding box coordinates

Best Practices

Creating High-Quality Datasets

Follow these best practices to create valuable datasets:

Documentation

  • Include a detailed README file
  • Document data collection methodology
  • Provide usage examples
  • List any limitations or biases

Organization

  • Use a consistent file structure
  • Name files and folders clearly
  • Separate training, validation, and test sets
  • Include a data schema or format description

Quality

  • Ensure annotations are accurate
  • Provide diverse and representative data
  • Balance class distributions when possible
  • Validate format correctness before uploading
View Complete Dataset Guidelines

For a comprehensive guide on creating high-quality datasets, check out our detailed Dataset Guidelines.

Troubleshooting

Common Issues and Solutions

Upload Issues

Problem: Dataset upload fails or times out.

Solution: Try uploading smaller files (under 1GB), check your internet connection, or compress your dataset more efficiently.

Format Conversion Issues

Problem: Format conversion fails or produces incorrect results.

Solution: Ensure your source dataset is in a valid format, check for missing files or annotations, and try converting to a different format.

Payment Issues

Problem: Payment fails or you're charged but don't receive access to the dataset.

Solution: Check your payment method, contact your bank if necessary, and reach out to VisionHowl support if you were charged but don't have access.

Account Issues

Problem: Can't log in or access your account.

Solution: Reset your password, check if your email is verified, and ensure you're using the correct username/email.

Getting Help

If you encounter issues not covered in this documentation:

  • Check the FAQ section on the VisionHowl website
  • Contact support at [email protected]
  • Use the feedback form in your dashboard