Frequently Asked Questions (FAQ)

General Questions

What is Biobuntu?

A comprehensive platform for running genomic analysis pipelines with CLI, GUI, and web interfaces. Perfect for researchers, labs, and bioinformatics teams.

Who should use Biobuntu?

BioBuntu is ideal for:

Is BioBuntu free?

Yes! BioBuntu is completely free and open-source.

What is the license for BioBuntu?

BioBuntu is released under the MIT License. You are free to use, modify, and distribute the software for both personal and commercial purposes.

Installation and Setup

How do I install BioBuntu?

You can install BioBuntu in several ways:

  1. From VS Code Marketplace:
    • Open VS Code
    • Go to Extensions (Ctrl+Shift+X / Cmd+Shift+X)
    • Search for "Bio-Data-Hub"
    • Click Install
  2. Using Command Palette:
    • Press Ctrl+Shift+P / Cmd+Shift+P
    • Type `ext install Mubashir-Ali.bio-data-hub`
    • Press Enter
  3. Direct Link:

What are the system requirements for BioBuntu?

Does Biobuntu work on all platforms?

Yes! BioBuntu is compatible with:

How do I update BioBuntu?

BioBuntu updates automatically through VS Code. You can also manually update by:

  1. Going to Extensions in VS Code
  2. Searching for "Bio-Data-Hub"
  3. Clicking the Update button if available
  4. Check our Release Notes for new features

Features and Functionality

What features does BioBuntu offer?

BioBuntu provides:

Can BioBuntu handle large datasets?

Yes! BioBuntu is optimized for large datasets. It includes:

For optimal performance with very large files (>1GB), we recommend:

What file formats does BioBuntu support?

BioBuntu currently supports:

More formats are coming in future releases!

How do I use PCA analysis in BioBuntu?

PCA (Principal Component Analysis) is a statistical technique used to reduce data dimensionality:

  1. Open your dataset in BioBuntu
  2. Select the PCA option
  3. Choose numeric columns for analysis
  4. BioBuntu will compute principal components
  5. Visualize results in 2D or 3D plots
  6. Export PCA results for further analysis

How do I perform K-means clustering?

K-means clustering groups similar data points together:

  1. Load your dataset
  2. Select the Clustering option
  3. Specify the number of clusters (K)
  4. Choose columns for clustering
  5. BioBuntu will compute cluster assignments
  6. Visualize clusters and export results

Data Management

How do I load a dataset into BioBuntu?

Method 1: Drag and Drop

  1. Open the BioBuntu panel in VS Code
  2. Drag your CSV file into the panel
  3. BioBuntu will automatically load and preview it

Method 2: File Browser

  1. Click the file browser icon in BioBuntu
  2. Navigate to your dataset
  3. Click to open

Method 3: Command Palette

  1. Press Ctrl+Shift+P / Cmd+Shift+P
  2. Type "BioBuntu: Open Dataset"
  3. Select your file

Can I import data from databases?

Currently, BioBuntu supports importing from files. Database integration is planned for future releases. For now, you can:

How do I export data from BioBuntu?

You can export your data in multiple formats:

  1. Click the Export button in BioBuntu
  2. Choose your desired format (CSV, JSON, Excel, etc.)
  3. Select output location
  4. Click Export

Can I filter or subset my data?

Yes! BioBuntu provides filtering capabilities:

  1. Click the Filter option
  2. Select columns and conditions
  3. Apply filters
  4. Visualize or export filtered data

How do I handle missing data?

BioBuntu handles missing data by:

Can I edit data directly in BioBuntu?

Currently, BioBuntu is designed for visualization and analysis. Direct editing is not available in the current version. For data editing:

  1. Use the original CSV file or spreadsheet editor
  2. Save changes
  3. Reload in BioBuntu

Visualization and Analysis

What visualization types are available?

BioBuntu supports:

Can I customize chart appearance?

Yes! You can customize:

How do I save visualizations?

You can export visualizations as:

What statistical analyses are available?

BioBuntu provides:

Performance and Optimization

Why is BioBuntu running slowly?

Performance can be affected by:

Solutions:

  1. Close unnecessary applications
  2. Increase available RAM
  3. Break large files into smaller chunks
  4. Use filtering to work with subsets
  5. Simplify visualizations

How do I improve performance with large files?

  1. Use filtering: Work with relevant columns only
  2. Subset data: Analyze smaller time periods or samples
  3. Upgrade RAM: More memory improves performance
  4. Close other apps: Free up system resources
  5. Update VS Code: Ensure you're on the latest version

Does BioBuntu cache data?

Yes, BioBuntu implements intelligent caching for performance optimization. Cached data is stored locally and automatically invalidated when needed.

Troubleshooting

BioBuntu is not appearing in my VS Code sidebar

Solutions:

  1. Ensure BioBuntu is installed: Extensions → search "Bio-Data-Hub"
  2. Reload VS Code: Ctrl+R / Cmd+R
  3. Check if the extension is enabled
  4. Try reinstalling the extension

I'm getting an error when importing a file

Common causes and solutions:

Visualizations are not displaying correctly

Try:

  1. Refresh the view (F5)
  2. Clear browser cache
  3. Restart VS Code
  4. Check if you're using a supported browser
  5. Update BioBuntu to the latest version

I can't export my data

Check:

  1. File permissions: Ensure write access to output directory
  2. Disk space: Ensure sufficient storage available
  3. File format compatibility
  4. File paths don't exceed system limits

BioBuntu crashed or stopped responding

Recovery steps:

  1. Close VS Code completely
  2. Reopen VS Code
  3. Reload the BioBuntu extension
  4. Try with a smaller dataset first
  5. Check your system RAM usage

Advanced Questions

How do I report bugs or issues?

Report bugs on our GitHub Issues page:

  1. Click "New Issue"
  2. Describe the problem clearly
  3. Include reproduction steps
  4. Attach screenshots or sample data if relevant
  5. Include your system information

How do I request new features?

We love feature requests! Submit them on our GitHub Issues page:

  1. Click "New Issue"
  2. Select "Feature request" template
  3. Describe your desired feature
  4. Explain the use case
  5. Suggest implementation if possible

Can I contribute to BioBuntu?

Yes! We welcome contributions:

  1. Fork the GitHub repository
  2. Create a feature branch
  3. Make your improvements
  4. Submit a pull request
  5. Our team will review and merge

How do I stay updated on BioBuntu?

Follow us on:

Are there tutorials available?

Yes! Check out:

Legal and Support

What is the privacy policy?

Read our detailed Privacy Policy to understand how we handle your data.

What are the terms of service?

Review our Terms of Service for usage guidelines and legal information.

How do I contact support?

Email: mubashirali1837@gmail.com
Response time: Usually within 24-48 hours

Social Media:

Is there a community forum?

Yes! Join our community at:

How do I submit feedback?

We value your feedback! Send it to:

Additional Resources

Can't find your answer? Feel free to reach out to us directly!