CoreViz – Studio

Upload & Organization

Learn how to efficiently upload and organize your visual content in CoreViz

Upload & Organization

CoreViz makes it easy to upload and organize large amounts of visual content. This guide covers everything you need to know about getting your images and videos into CoreViz and keeping them organized.

Getting Started with Uploads

Prerequisites

Before uploading content, you'll need:

  • A CoreViz account (sign up at lab.coreviz.io)
  • An organization set up
  • At least one dataset created

Supported File Formats

CoreViz supports a wide range of image and video formats:

Image Formats:

  • JPEG (.jpg, .jpeg)
  • PNG (.png)
  • GIF (.gif)
  • WebP (.webp)
  • TIFF (.tiff, .tif)
  • BMP (.bmp)
  • SVG (.svg)

Video Formats:

  • MP4 (.mp4)
  • MOV (.mov)
  • AVI (.avi)
  • MKV (.mkv)
  • WebM (.webm)
  • FLV (.flv)
  • WMV (.wmv)

File Size Limits

Maximum file sizes vary by plan:

  • Free: 10MB per file
  • Pro: 100MB per file
  • Enterprise: Custom limits available

Organization Structure

Understanding CoreViz's organization structure helps you plan your uploads effectively:

Organization
├── Dataset 1
│   ├── Entity A
│   │   ├── Media Item 1
│   │   ├── Media Item 2
│   │   └── ...
│   └── Entity B
│       ├── Media Item 3
│       └── ...
└── Dataset 2
    └── Entity C
        └── ...

Organizations

Your top-level workspace containing all datasets and configurations.

Datasets

Collections of related content, typically organized by:

  • Project or campaign
  • Content type or category
  • Time period
  • Source or department

Entities

Specific types of content within a dataset, such as:

  • "Product Photos"
  • "Security Footage"
  • "Medical Images"
  • "Marketing Assets"

Upload Methods

1. Web Interface Upload

The web interface provides the most user-friendly upload experience:

Single File Upload

  1. Navigate to your dataset
  2. Select an entity or create a new one
  3. Click "Upload" or drag and drop files
  4. Select files from your computer
  5. Wait for processing to complete

Bulk Upload

  1. Select multiple files (up to 100 at once)
  2. Drag and drop or use the file picker
  3. Monitor upload progress in the interface
  4. Review processing status

Folder Upload

  1. Use the "Upload Folder" option
  2. Select an entire folder from your computer
  3. CoreViz maintains folder structure as entities
  4. All files are processed automatically

2. API Upload

Coming soon.

3. CLI Upload (Coming Soon)

Coming soon.

Upload Best Practices

File Organization

Before Upload:

  • Organize files into logical folders
  • Use consistent naming conventions
  • Remove unnecessary files
  • Compress large files when possible

Naming Conventions:

product_001_red_shirt.jpg
security_cam_2024_01_15_14_30.mp4
medical_xray_patient_12345.png

Batch Processing

Large Datasets:

  • Upload in batches of 100-500 files
  • Monitor processing status between batches
  • Use the API for automated batch uploads
  • Consider upload scheduling for off-peak hours

Video Content:

  • Compress videos before upload when possible
  • Split very long videos into segments
  • Use consistent video formats within a dataset

Metadata Preparation

Custom Metadata:

  • Prepare metadata files (CSV/JSON) for bulk import
  • Include relevant tags and categories
  • Add descriptive information for better searchability

Example metadata file:

{
  "files": [
    {
      "filename": "product_001.jpg",
      "tags": ["clothing", "red", "shirt"],
      "category": "apparel",
      "description": "Red cotton t-shirt, size M"
    }
  ]
}

Processing and Indexing

Automatic Processing

Once uploaded, CoreViz automatically:

  1. Validates file format and integrity
  2. Extracts basic metadata (size, format, creation date)
  3. Generates thumbnails and previews
  4. Analyzes content using AI models
  5. Indexes for search and retrieval
  6. Stores in optimized format

Processing Status

Monitor upload and processing status:

  • Uploading: File is being transferred
  • Processing: AI analysis in progress
  • Indexed: Ready for search and analysis
  • Error: Processing failed (check error details)

Processing Time

Typical processing times:

  • Images: 2-10 seconds per image
  • Videos: 1-2x real-time (e.g., 1-minute video takes 1-2 minutes)
  • Large batches: Processing happens in parallel

Organization Strategies

By Project

Organization: "E-commerce Platform"
├── Dataset: "Product Catalog 2024"
│   ├── Entity: "Clothing"
│   ├── Entity: "Electronics"
│   └── Entity: "Home & Garden"
└── Dataset: "Marketing Assets"
    ├── Entity: "Banner Images"
    └── Entity: "Product Videos"

By Content Type

Organization: "Security Company"
├── Dataset: "Surveillance Footage"
│   ├── Entity: "Entrance Cameras"
│   ├── Entity: "Parking Lot"
│   └── Entity: "Interior Cameras"
└── Dataset: "Evidence"
    ├── Entity: "Photos"
    └── Entity: "Videos"

By Time Period

Organization: "Research Lab"
├── Dataset: "Q1 2024 Experiments"
├── Dataset: "Q2 2024 Experiments"
└── Dataset: "Q3 2024 Experiments"

Troubleshooting Upload Issues

Common Problems

Upload Failures:

  • Check file format compatibility
  • Verify file size limits
  • Ensure stable internet connection
  • Check available storage quota

Processing Errors:

  • Corrupted or invalid files
  • Unsupported codecs in videos
  • Insufficient processing resources
  • Network interruptions during upload

Slow Uploads:

  • Compress large files
  • Upload during off-peak hours
  • Use wired internet connection
  • Consider API uploads for automation

Getting Help

If you encounter issues:

  1. Check the FAQ for common solutions
  2. Review error messages in the interface
  3. Contact support (team@coreviz.io) with specific error details
  4. Check system status at status.coreviz.io

Next Steps

Now that you understand upload and organization:

Pro Tip

Start with a small test dataset to familiarize yourself with the upload process and organization structure before uploading large amounts of content.