[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M71KH8TPR45PEH7FRRY0C9MG":3,"skill-same:01M71KH8TPR45PEH7FRRY0C9MG":70},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":18,"publishedAt":33,"linkOnly":34,"markdownContent":35,"markdownBody":36,"frontMatter":37,"refName":41,"commitSha":42,"skillDirectory":43,"forksCount":44,"repositoryHtmlUrl":45,"repositoryHomepageUrl":6,"ownerHtmlUrl":46,"ownerBlogUrl":47,"ownerDescription":48,"updatedAt":49,"install":50,"resources":63},"01M71KH8TPR45PEH7FRRY0C9MG","tiledbvcf",null,"Efficient storage and retrieval of genomic variant data using TileDB. Scalable VCF\u002FBCF ingestion, incremental sample addition, compressed storage, parallel queries, and export capabilities for population genomics.","iDorgham\u002FWorkspace-Factory","iDorgham","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F136521493?v=4","01M6CNGBDAHE4ARW3YJEF4X2FD","Dorgham","01M71E8H3CXZ7DJX59MTM9JEB2",1,"MIT","https:\u002F\u002Fgithub.com\u002FiDorgham\u002FWorkspace-Factory\u002Fblob\u002Fmaster\u002Ffactory\u002Flibrary\u002Fskills\u002Fgithub_imports\u002Ftiledbvcf\u002FSKILL.md",[],[5,19,20,21,22,23,24,25,26,27,28,29,30,31,32],"ingestion","vcf","capabilities","sample","storage","Scalable","export","data","parallel","for","variant","queries","genomics","retrieval","2026-11-10 10:12:30",false,"---\nname: tiledbvcf\ndescription: Efficient storage and retrieval of genomic variant data using TileDB. Scalable VCF\u002FBCF ingestion, incremental sample addition, compressed storage, parallel queries, and export capabilities for population genomics.\nlicense: MIT license\nmetadata:\n    skill-author: Jeremy Leipzig\n---\n\n# TileDB-VCF\n\n## Overview\n\nTileDB-VCF is a high-performance C++ library with Python and CLI interfaces for efficient storage and retrieval of genomic variant-call data. Built on TileDB's sparse array technology, it enables scalable ingestion of VCF\u002FBCF files, incremental sample addition without expensive merging operations, and efficient parallel queries of variant data stored locally or in the cloud.\n\n## When to Use This Skill\n\nThis skill should be used when:\n- Learning TileDB-VCF concepts and workflows\n- Prototyping genomics analyses and pipelines\n- Working with small-to-medium datasets (\u003C 1000 samples)\n- Need incremental addition of new samples to existing datasets\n- Require efficient querying of specific genomic regions across many samples\n- Working with cloud-stored variant data (S3, Azure, GCS)\n- Need to export subsets of large VCF datasets\n- Building variant databases for cohort studies\n- Educational projects and method development\n- Performance is critical for variant data operations\n\n## Quick Start\n\n### Installation\n\n**Preferred Method: Conda\u002FMamba**\n```bash\n# Enter the following two lines if you are on a M1 Mac\nCONDA_SUBDIR=osx-64\nconda config --env --set subdir osx-64\n\n# Create the conda environment\nconda create -n tiledb-vcf \"python\u003C3.10\"\nconda activate tiledb-vcf\n\n# Mamba is a faster and more reliable alternative to conda\nconda install -c conda-forge mamba\n\n# Install TileDB-Py and TileDB-VCF, align with other useful libraries\nmamba install -y -c conda-forge -c bioconda -c tiledb tiledb-py tiledbvcf-py pandas pyarrow numpy\n```\n\n**Alternative: Docker Images**\n```bash\ndocker pull tiledb\u002Ftiledbvcf-py     # Python interface\ndocker pull tiledb\u002Ftiledbvcf-cli    # Command-line interface\n```\n\n### Basic Examples\n\n**Create and populate a dataset:**\n```python\nimport tiledbvcf\n\n# Create a new dataset\nds = tiledbvcf.Dataset(uri=\"my_dataset\", mode=\"w\",\n                      cfg=tiledbvcf.ReadConfig(memory_budget=1024))\n\n# Ingest VCF files (must be single-sample with indexes)\n# Requirements:\n# - VCFs must be single-sample (not multi-sample)\n# - Must have indexes: .csi (bcftools) or .tbi (tabix)\nds.ingest_samples([\"sample1.vcf.gz\", \"sample2.vcf.gz\"])\n```\n\n**Query variant data:**\n```python\n# Open existing dataset for reading\nds = tiledbvcf.Dataset(uri=\"my_dataset\", mode=\"r\")\n\n# Query specific regions and samples\ndf = ds.read(\n    attrs=[\"sample_name\", \"pos_start\", \"pos_end\", \"alleles\", \"fmt_GT\"],\n    regions=[\"chr1:1000000-2000000\", \"chr2:500000-1500000\"],\n    samples=[\"sample1\", \"sample2\", \"sample3\"]\n)\nprint(df.head())\n```\n\n**Export to VCF:**\n```python\nimport os\n\n# Export two VCF samples\nds.export(\n    regions=[\"chr21:8220186-8405573\"],\n    samples=[\"HG00101\", \"HG00097\"],\n    output_format=\"v\",\n    output_dir=os.path.expanduser(\"~\"),\n)\n```\n\n## Core Capabilities\n\n### 1. Dataset Creation and Ingestion\n\nCreate TileDB-VCF datasets and incrementally ingest variant data from multiple VCF\u002FBCF files. This is appropriate for building population genomics databases and cohort studies.\n\n**Requirements:**\n- **Single-sample VCFs only**: Multi-sample VCFs are not supported\n- **Index files required**: VCF\u002FBCF files must have indexes (.csi or .tbi)\n\n**Common operations:**\n- Create new datasets with optimized array schemas\n- Ingest single or multiple VCF\u002FBCF files in parallel\n- Add new samples incrementally without re-processing existing data\n- Configure memory usage and compression settings\n- Handle various VCF formats and INFO\u002FFORMAT fields\n- Resume interrupted ingestion processes\n- Validate data integrity during ingestion\n\n\n### 2. Efficient Querying and Filtering\n\nQuery variant data with high performance across genomic regions, samples, and variant attributes. This is appropriate for association studies, variant discovery, and population analysis.\n\n**Common operations:**\n- Query specific genomic regions (single or multiple)\n- Filter by sample names or sample groups\n- Extract specific variant attributes (position, alleles, genotypes, quality)\n- Access INFO and FORMAT fields efficiently\n- Combine spatial and attribute-based filtering\n- Stream large query results\n- Perform aggregations across samples or regions\n\n\n### 3. Data Export and Interoperability\n\nExport data in various formats for downstream analysis or integration with other genomics tools. This is appropriate for sharing datasets, creating analysis subsets, or feeding other pipelines.\n\n**Common operations:**\n- Export to standard VCF\u002FBCF formats\n- Generate TSV files with selected fields\n- Create sample\u002Fregion-specific subsets\n- Maintain data provenance and metadata\n- Lossless data export preserving all annotations\n- Compressed output formats\n- Streaming exports for large datasets\n\n\n### 4. Population Genomics Workflows\n\nTileDB-VCF excels at large-scale population genomics analyses requiring efficient access to variant data across many samples and genomic regions.\n\n**Common workflows:**\n- Genome-wide association studies (GWAS) data preparation\n- Rare variant burden testing\n- Population stratification analysis\n- Allele frequency calculations across populations\n- Quality control across large cohorts\n- Variant annotation and filtering\n- Cross-population comparative analysis\n\n\n## Key Concepts\n\n### Array Schema and Data Model\n\n**TileDB-VCF Data Model:**\n- Variants stored as sparse arrays with genomic coordinates as dimensions\n- Samples stored as attributes allowing efficient sample-specific queries\n- INFO and FORMAT fields preserved with original data types\n- Automatic compression and chunking for optimal storage\n\n**Schema Configuration:**\n```python\n# Custom schema with specific tile extents\nconfig = tiledbvcf.ReadConfig(\n    memory_budget=2048,  # MB\n    region_partition=(0, 3095677412),  # Full genome\n    sample_partition=(0, 10000)  # Up to 10k samples\n)\n```\n\n### Coordinate Systems and Regions\n\n**Critical:** TileDB-VCF uses **1-based genomic coordinates** following VCF standard:\n- Positions are 1-based (first base is position 1)\n- Ranges are inclusive on both ends\n- Region \"chr1:1000-2000\" includes positions 1000-2000 (1001 bases total)\n\n**Region specification formats:**\n```python\n# Single region\nregions = [\"chr1:1000000-2000000\"]\n\n# Multiple regions\nregions = [\"chr1:1000000-2000000\", \"chr2:500000-1500000\"]\n\n# Whole chromosome\nregions = [\"chr1\"]\n\n# BED-style (0-based, half-open converted internally)\nregions = [\"chr1:999999-2000000\"]  # Equivalent to 1-based chr1:1000000-2000000\n```\n\n### Memory Management\n\n**Performance considerations:**\n1. **Set appropriate memory budget** based on available system memory\n2. **Use streaming queries** for very large result sets\n3. **Partition large ingestions** to avoid memory exhaustion\n4. **Configure tile cache** for repeated region access\n5. **Use parallel ingestion** for multiple files\n6. **Optimize region queries** by combining nearby regions\n\n### Cloud Storage Integration\n\nTileDB-VCF seamlessly works with cloud storage:\n```python\n# S3 dataset\nds = tiledbvcf.Dataset(uri=\"s3:\u002F\u002Fbucket\u002Fdataset\", mode=\"r\")\n\n# Azure Blob Storage\nds = tiledbvcf.Dataset(uri=\"azure:\u002F\u002Fcontainer\u002Fdataset\", mode=\"r\")\n\n# Google Cloud Storage\nds = tiledbvcf.Dataset(uri=\"gcs:\u002F\u002Fbucket\u002Fdataset\", mode=\"r\")\n```\n\n## Common Pitfalls\n\n1. **Memory exhaustion during ingestion:** Use appropriate memory budget and batch processing for large VCF files\n2. **Inefficient region queries:** Combine nearby regions instead of many separate queries\n3. **Missing sample names:** Ensure sample names in VCF headers match query sample specifications\n4. **Coordinate system confusion:** Remember TileDB-VCF uses 1-based coordinates like VCF standard\n5. **Large result sets:** Use streaming or pagination for queries returning millions of variants\n6. **Cloud permissions:** Ensure proper authentication for cloud storage access\n7. **Concurrent access:** Multiple writers to the same dataset can cause corruption—use appropriate locking\n\n## CLI Usage\n\nTileDB-VCF provides a command-line interface with the following subcommands:\n\n**Available Subcommands:**\n- `create` - Creates an empty TileDB-VCF dataset\n- `store` - Ingests samples into a TileDB-VCF dataset\n- `export` - Exports data from a TileDB-VCF dataset\n- `list` - Lists all sample names present in a TileDB-VCF dataset\n- `stat` - Prints high-level statistics about a TileDB-VCF dataset\n- `utils` - Utils for working with a TileDB-VCF dataset\n- `version` - Print the version information and exit\n\n```bash\n# Create empty dataset\ntiledbvcf create --uri my_dataset\n\n# Ingest samples (requires single-sample VCFs with indexes)\ntiledbvcf store --uri my_dataset --samples sample1.vcf.gz,sample2.vcf.gz\n\n# Export data\ntiledbvcf export --uri my_dataset \\\n  --regions \"chr1:1000000-2000000\" \\\n  --sample-names \"sample1,sample2\"\n\n# List all samples\ntiledbvcf list --uri my_dataset\n\n# Show dataset statistics\ntiledbvcf stat --uri my_dataset\n```\n\n## Advanced Features\n\n### Allele Frequency Analysis\n```python\n# Calculate allele frequencies\naf_df = tiledbvcf.read_allele_frequency(\n    uri=\"my_dataset\",\n    regions=[\"chr1:1000000-2000000\"],\n    samples=[\"sample1\", \"sample2\", \"sample3\"]\n)\n```\n\n### Sample Quality Control\n```python\n# Perform sample QC\nqc_results = tiledbvcf.sample_qc(\n    uri=\"my_dataset\",\n    samples=[\"sample1\", \"sample2\"]\n)\n```\n\n### Custom Configurations\n```python\n# Advanced configuration\nconfig = tiledbvcf.ReadConfig(\n    memory_budget=4096,\n    tiledb_config={\n        \"sm.tile_cache_size\": \"1000000000\",\n        \"vfs.s3.region\": \"us-east-1\"\n    }\n)\n```\n\n\n## Resources\n\n## Getting Help\n\n### Open Source TileDB-VCF Resources\n\n**Open Source Documentation:**\n- TileDB Academy: https:\u002F\u002Fcloud.tiledb.com\u002Facademy\u002F\n- Population Genomics Guide: https:\u002F\u002Fcloud.tiledb.com\u002Facademy\u002Fstructure\u002Flife-sciences\u002Fpopulation-genomics\u002F\n- TileDB-VCF GitHub: https:\u002F\u002Fgithub.com\u002FTileDB-Inc\u002FTileDB-VCF\n\n### TileDB-Cloud Resources\n\n**For Large-Scale\u002FProduction Genomics:**\n- TileDB-Cloud Platform: https:\u002F\u002Fcloud.tiledb.com\n- TileDB Academy (All Documentation): https:\u002F\u002Fcloud.tiledb.com\u002Facademy\u002F\n\n**Getting Started:**\n- Free account signup: https:\u002F\u002Fcloud.tiledb.com\n- Contact: sales@tiledb.com for enterprise needs\n\n## Scaling to TileDB-Cloud\n\nWhen your genomics workloads outgrow single-node processing, TileDB-Cloud provides enterprise-scale capabilities for production genomics pipelines.\n\n**Note**: This section covers TileDB-Cloud capabilities based on available documentation. For complete API details and current functionality, consult the official TileDB-Cloud documentation and API reference.\n\n### Setting Up TileDB-Cloud\n\n**1. Create Account and Get API Token**\n```bash\n# Sign up at https:\u002F\u002Fcloud.tiledb.com\n# Generate API token in your account settings\n```\n\n**2. Install TileDB-Cloud Python Client**\n```bash\n# Base installation\npip install tiledb-cloud\n\n# With genomics-specific functionality\npip install tiledb-cloud[life-sciences]\n```\n\n**3. Configure Authentication**\n```bash\n# Set environment variable with your API token\nexport TILEDB_REST_TOKEN=\"your_api_token\"\n```\n\n```python\nimport tiledb.cloud\n\n# Authentication is automatic via TILEDB_REST_TOKEN\n# No explicit login required in code\n```\n\n### Migrating from Open Source to TileDB-Cloud\n\n**Large-Scale Ingestion**\n```python\n# TileDB-Cloud: Distributed VCF ingestion\nimport tiledb.cloud.vcf\n\n# Use specialized VCF ingestion module\n# Note: Exact API requires TileDB-Cloud documentation\n# This represents the available functionality structure\ntiledb.cloud.vcf.ingestion.ingest_vcf_dataset(\n    source=\"s3:\u002F\u002Fmy-bucket\u002Fvcf-files\u002F\",\n    output=\"tiledb:\u002F\u002Fmy-namespace\u002Flarge-dataset\",\n    namespace=\"my-namespace\",\n    acn=\"my-s3-credentials\",\n    ingest_resources={\"cpu\": \"16\", \"memory\": \"64Gi\"}\n)\n```\n\n**Distributed Query Processing**\n```python\n# TileDB-Cloud: VCF querying across distributed storage\nimport tiledb.cloud.vcf\nimport tiledbvcf\n\n# Define the dataset URI\ndataset_uri = \"tiledb:\u002F\u002FTileDB-Inc\u002Fgvcf-1kg-dragen-v376\"\n\n# Get all samples from the dataset\nds = tiledbvcf.Dataset(dataset_uri, tiledb_config=cfg)\nsamples = ds.samples()\n\n# Define attributes and ranges to query on\nattrs = [\"sample_name\", \"fmt_GT\", \"fmt_AD\", \"fmt_DP\"]\nregions = [\"chr13:32396898-32397044\", \"chr13:32398162-32400268\"]\n\n# Perform the read, which is executed in a distributed fashion\ndf = tiledb.cloud.vcf.read(\n    dataset_uri=dataset_uri,\n    regions=regions,\n    samples=samples,\n    attrs=attrs,\n    namespace=\"my-namespace\",  # specifies which account to charge\n)\ndf.to_pandas()\n```\n\n### Enterprise Features\n\n**Data Sharing and Collaboration**\n```python\n# TileDB-Cloud provides enterprise data sharing capabilities\n# through namespace-based permissions and group management\n\n# Access shared datasets via TileDB-Cloud URIs\ndataset_uri = \"tiledb:\u002F\u002Fshared-namespace\u002Fpopulation-study\"\n\n# Collaborate through shared notebooks and compute resources\n# (Specific API requires TileDB-Cloud documentation)\n```\n\n**Cost Optimization**\n- **Serverless Compute**: Pay only for actual compute time\n- **Auto-scaling**: Automatically scale up\u002Fdown based on workload\n- **Spot Instances**: Use cost-optimized compute for batch jobs\n- **Data Tiering**: Automatic hot\u002Fcold storage management\n\n**Security and Compliance**\n- **End-to-end Encryption**: Data encrypted in transit and at rest\n- **Access Controls**: Fine-grained permissions and audit logs\n- **HIPAA\u002FSOC2 Compliance**: Enterprise security standards\n- **VPC Support**: Deploy in private cloud environments\n\n### When to Migrate Checklist\n\n✅ **Migrate to TileDB-Cloud if you have:**\n- [ ] Datasets > 1000 samples\n- [ ] Need to process > 100GB of VCF data\n- [ ] Require distributed computing\n- [ ] Multiple team members need access\n- [ ] Need enterprise security\u002Fcompliance\n- [ ] Want cost-optimized serverless compute\n- [ ] Require 24\u002F7 production uptime\n\n### Getting Started with TileDB-Cloud\n\n1. **Start Free**: TileDB-Cloud offers free tier for evaluation\n2. **Migration Support**: TileDB team provides migration assistance\n3. **Training**: Access to genomics-specific tutorials and examples\n4. **Professional Services**: Custom deployment and optimization\n\n**Next Steps:**\n- Visit https:\u002F\u002Fcloud.tiledb.com to create account\n- Review documentation at https:\u002F\u002Fcloud.tiledb.com\u002Facademy\u002F\n- Contact sales@tiledb.com for enterprise needs","# TileDB-VCF\n\n## Overview\n\nTileDB-VCF is a high-performance C++ library with Python and CLI interfaces for efficient storage and retrieval of genomic variant-call data. Built on TileDB's sparse array technology, it enables scalable ingestion of VCF\u002FBCF files, incremental sample addition without expensive merging operations, and efficient parallel queries of variant data stored locally or in the cloud.\n\n## When to Use This Skill\n\nThis skill should be used when:\n- Learning TileDB-VCF concepts and workflows\n- Prototyping genomics analyses and pipelines\n- Working with small-to-medium datasets (\u003C 1000 samples)\n- Need incremental addition of new samples to existing datasets\n- Require efficient querying of specific genomic regions across many samples\n- Working with cloud-stored variant data (S3, Azure, GCS)\n- Need to export subsets of large VCF datasets\n- Building variant databases for cohort studies\n- Educational projects and method development\n- Performance is critical for variant data operations\n\n## Quick Start\n\n### Installation\n\n**Preferred Method: Conda\u002FMamba**\n```bash\n# Enter the following two lines if you are on a M1 Mac\nCONDA_SUBDIR=osx-64\nconda config --env --set subdir osx-64\n\n# Create the conda environment\nconda create -n tiledb-vcf \"python\u003C3.10\"\nconda activate tiledb-vcf\n\n# Mamba is a faster and more reliable alternative to conda\nconda install -c conda-forge mamba\n\n# Install TileDB-Py and TileDB-VCF, align with other useful libraries\nmamba install -y -c conda-forge -c bioconda -c tiledb tiledb-py tiledbvcf-py pandas pyarrow numpy\n```\n\n**Alternative: Docker Images**\n```bash\ndocker pull tiledb\u002Ftiledbvcf-py     # Python interface\ndocker pull tiledb\u002Ftiledbvcf-cli    # Command-line interface\n```\n\n### Basic Examples\n\n**Create and populate a dataset:**\n```python\nimport tiledbvcf\n\n# Create a new dataset\nds = tiledbvcf.Dataset(uri=\"my_dataset\", mode=\"w\",\n                      cfg=tiledbvcf.ReadConfig(memory_budget=1024))\n\n# Ingest VCF files (must be single-sample with indexes)\n# Requirements:\n# - VCFs must be single-sample (not multi-sample)\n# - Must have indexes: .csi (bcftools) or .tbi (tabix)\nds.ingest_samples([\"sample1.vcf.gz\", \"sample2.vcf.gz\"])\n```\n\n**Query variant data:**\n```python\n# Open existing dataset for reading\nds = tiledbvcf.Dataset(uri=\"my_dataset\", mode=\"r\")\n\n# Query specific regions and samples\ndf = ds.read(\n    attrs=[\"sample_name\", \"pos_start\", \"pos_end\", \"alleles\", \"fmt_GT\"],\n    regions=[\"chr1:1000000-2000000\", \"chr2:500000-1500000\"],\n    samples=[\"sample1\", \"sample2\", \"sample3\"]\n)\nprint(df.head())\n```\n\n**Export to VCF:**\n```python\nimport os\n\n# Export two VCF samples\nds.export(\n    regions=[\"chr21:8220186-8405573\"],\n    samples=[\"HG00101\", \"HG00097\"],\n    output_format=\"v\",\n    output_dir=os.path.expanduser(\"~\"),\n)\n```\n\n## Core Capabilities\n\n### 1. Dataset Creation and Ingestion\n\nCreate TileDB-VCF datasets and incrementally ingest variant data from multiple VCF\u002FBCF files. This is appropriate for building population genomics databases and cohort studies.\n\n**Requirements:**\n- **Single-sample VCFs only**: Multi-sample VCFs are not supported\n- **Index files required**: VCF\u002FBCF files must have indexes (.csi or .tbi)\n\n**Common operations:**\n- Create new datasets with optimized array schemas\n- Ingest single or multiple VCF\u002FBCF files in parallel\n- Add new samples incrementally without re-processing existing data\n- Configure memory usage and compression settings\n- Handle various VCF formats and INFO\u002FFORMAT fields\n- Resume interrupted ingestion processes\n- Validate data integrity during ingestion\n\n\n### 2. Efficient Querying and Filtering\n\nQuery variant data with high performance across genomic regions, samples, and variant attributes. This is appropriate for association studies, variant discovery, and population analysis.\n\n**Common operations:**\n- Query specific genomic regions (single or multiple)\n- Filter by sample names or sample groups\n- Extract specific variant attributes (position, alleles, genotypes, quality)\n- Access INFO and FORMAT fields efficiently\n- Combine spatial and attribute-based filtering\n- Stream large query results\n- Perform aggregations across samples or regions\n\n\n### 3. Data Export and Interoperability\n\nExport data in various formats for downstream analysis or integration with other genomics tools. This is appropriate for sharing datasets, creating analysis subsets, or feeding other pipelines.\n\n**Common operations:**\n- Export to standard VCF\u002FBCF formats\n- Generate TSV files with selected fields\n- Create sample\u002Fregion-specific subsets\n- Maintain data provenance and metadata\n- Lossless data export preserving all annotations\n- Compressed output formats\n- Streaming exports for large datasets\n\n\n### 4. Population Genomics Workflows\n\nTileDB-VCF excels at large-scale population genomics analyses requiring efficient access to variant data across many samples and genomic regions.\n\n**Common workflows:**\n- Genome-wide association studies (GWAS) data preparation\n- Rare variant burden testing\n- Population stratification analysis\n- Allele frequency calculations across populations\n- Quality control across large cohorts\n- Variant annotation and filtering\n- Cross-population comparative analysis\n\n\n## Key Concepts\n\n### Array Schema and Data Model\n\n**TileDB-VCF Data Model:**\n- Variants stored as sparse arrays with genomic coordinates as dimensions\n- Samples stored as attributes allowing efficient sample-specific queries\n- INFO and FORMAT fields preserved with original data types\n- Automatic compression and chunking for optimal storage\n\n**Schema Configuration:**\n```python\n# Custom schema with specific tile extents\nconfig = tiledbvcf.ReadConfig(\n    memory_budget=2048,  # MB\n    region_partition=(0, 3095677412),  # Full genome\n    sample_partition=(0, 10000)  # Up to 10k samples\n)\n```\n\n### Coordinate Systems and Regions\n\n**Critical:** TileDB-VCF uses **1-based genomic coordinates** following VCF standard:\n- Positions are 1-based (first base is position 1)\n- Ranges are inclusive on both ends\n- Region \"chr1:1000-2000\" includes positions 1000-2000 (1001 bases total)\n\n**Region specification formats:**\n```python\n# Single region\nregions = [\"chr1:1000000-2000000\"]\n\n# Multiple regions\nregions = [\"chr1:1000000-2000000\", \"chr2:500000-1500000\"]\n\n# Whole chromosome\nregions = [\"chr1\"]\n\n# BED-style (0-based, half-open converted internally)\nregions = [\"chr1:999999-2000000\"]  # Equivalent to 1-based chr1:1000000-2000000\n```\n\n### Memory Management\n\n**Performance considerations:**\n1. **Set appropriate memory budget** based on available system memory\n2. **Use streaming queries** for very large result sets\n3. **Partition large ingestions** to avoid memory exhaustion\n4. **Configure tile cache** for repeated region access\n5. **Use parallel ingestion** for multiple files\n6. **Optimize region queries** by combining nearby regions\n\n### Cloud Storage Integration\n\nTileDB-VCF seamlessly works with cloud storage:\n```python\n# S3 dataset\nds = tiledbvcf.Dataset(uri=\"s3:\u002F\u002Fbucket\u002Fdataset\", mode=\"r\")\n\n# Azure Blob Storage\nds = tiledbvcf.Dataset(uri=\"azure:\u002F\u002Fcontainer\u002Fdataset\", mode=\"r\")\n\n# Google Cloud Storage\nds = tiledbvcf.Dataset(uri=\"gcs:\u002F\u002Fbucket\u002Fdataset\", mode=\"r\")\n```\n\n## Common Pitfalls\n\n1. **Memory exhaustion during ingestion:** Use appropriate memory budget and batch processing for large VCF files\n2. **Inefficient region queries:** Combine nearby regions instead of many separate queries\n3. **Missing sample names:** Ensure sample names in VCF headers match query sample specifications\n4. **Coordinate system confusion:** Remember TileDB-VCF uses 1-based coordinates like VCF standard\n5. **Large result sets:** Use streaming or pagination for queries returning millions of variants\n6. **Cloud permissions:** Ensure proper authentication for cloud storage access\n7. **Concurrent access:** Multiple writers to the same dataset can cause corruption—use appropriate locking\n\n## CLI Usage\n\nTileDB-VCF provides a command-line interface with the following subcommands:\n\n**Available Subcommands:**\n- `create` - Creates an empty TileDB-VCF dataset\n- `store` - Ingests samples into a TileDB-VCF dataset\n- `export` - Exports data from a TileDB-VCF dataset\n- `list` - Lists all sample names present in a TileDB-VCF dataset\n- `stat` - Prints high-level statistics about a TileDB-VCF dataset\n- `utils` - Utils for working with a TileDB-VCF dataset\n- `version` - Print the version information and exit\n\n```bash\n# Create empty dataset\ntiledbvcf create --uri my_dataset\n\n# Ingest samples (requires single-sample VCFs with indexes)\ntiledbvcf store --uri my_dataset --samples sample1.vcf.gz,sample2.vcf.gz\n\n# Export data\ntiledbvcf export --uri my_dataset \\\n  --regions \"chr1:1000000-2000000\" \\\n  --sample-names \"sample1,sample2\"\n\n# List all samples\ntiledbvcf list --uri my_dataset\n\n# Show dataset statistics\ntiledbvcf stat --uri my_dataset\n```\n\n## Advanced Features\n\n### Allele Frequency Analysis\n```python\n# Calculate allele frequencies\naf_df = tiledbvcf.read_allele_frequency(\n    uri=\"my_dataset\",\n    regions=[\"chr1:1000000-2000000\"],\n    samples=[\"sample1\", \"sample2\", \"sample3\"]\n)\n```\n\n### Sample Quality Control\n```python\n# Perform sample QC\nqc_results = tiledbvcf.sample_qc(\n    uri=\"my_dataset\",\n    samples=[\"sample1\", \"sample2\"]\n)\n```\n\n### Custom Configurations\n```python\n# Advanced configuration\nconfig = tiledbvcf.ReadConfig(\n    memory_budget=4096,\n    tiledb_config={\n        \"sm.tile_cache_size\": \"1000000000\",\n        \"vfs.s3.region\": \"us-east-1\"\n    }\n)\n```\n\n\n## Resources\n\n## Getting Help\n\n### Open Source TileDB-VCF Resources\n\n**Open Source Documentation:**\n- TileDB Academy: https:\u002F\u002Fcloud.tiledb.com\u002Facademy\u002F\n- Population Genomics Guide: https:\u002F\u002Fcloud.tiledb.com\u002Facademy\u002Fstructure\u002Flife-sciences\u002Fpopulation-genomics\u002F\n- TileDB-VCF GitHub: https:\u002F\u002Fgithub.com\u002FTileDB-Inc\u002FTileDB-VCF\n\n### TileDB-Cloud Resources\n\n**For Large-Scale\u002FProduction Genomics:**\n- TileDB-Cloud Platform: https:\u002F\u002Fcloud.tiledb.com\n- TileDB Academy (All Documentation): https:\u002F\u002Fcloud.tiledb.com\u002Facademy\u002F\n\n**Getting Started:**\n- Free account signup: https:\u002F\u002Fcloud.tiledb.com\n- Contact: sales@tiledb.com for enterprise needs\n\n## Scaling to TileDB-Cloud\n\nWhen your genomics workloads outgrow single-node processing, TileDB-Cloud provides enterprise-scale capabilities for production genomics pipelines.\n\n**Note**: This section covers TileDB-Cloud capabilities based on available documentation. For complete API details and current functionality, consult the official TileDB-Cloud documentation and API reference.\n\n### Setting Up TileDB-Cloud\n\n**1. Create Account and Get API Token**\n```bash\n# Sign up at https:\u002F\u002Fcloud.tiledb.com\n# Generate API token in your account settings\n```\n\n**2. Install TileDB-Cloud Python Client**\n```bash\n# Base installation\npip install tiledb-cloud\n\n# With genomics-specific functionality\npip install tiledb-cloud[life-sciences]\n```\n\n**3. Configure Authentication**\n```bash\n# Set environment variable with your API token\nexport TILEDB_REST_TOKEN=\"your_api_token\"\n```\n\n```python\nimport tiledb.cloud\n\n# Authentication is automatic via TILEDB_REST_TOKEN\n# No explicit login required in code\n```\n\n### Migrating from Open Source to TileDB-Cloud\n\n**Large-Scale Ingestion**\n```python\n# TileDB-Cloud: Distributed VCF ingestion\nimport tiledb.cloud.vcf\n\n# Use specialized VCF ingestion module\n# Note: Exact API requires TileDB-Cloud documentation\n# This represents the available functionality structure\ntiledb.cloud.vcf.ingestion.ingest_vcf_dataset(\n    source=\"s3:\u002F\u002Fmy-bucket\u002Fvcf-files\u002F\",\n    output=\"tiledb:\u002F\u002Fmy-namespace\u002Flarge-dataset\",\n    namespace=\"my-namespace\",\n    acn=\"my-s3-credentials\",\n    ingest_resources={\"cpu\": \"16\", \"memory\": \"64Gi\"}\n)\n```\n\n**Distributed Query Processing**\n```python\n# TileDB-Cloud: VCF querying across distributed storage\nimport tiledb.cloud.vcf\nimport tiledbvcf\n\n# Define the dataset URI\ndataset_uri = \"tiledb:\u002F\u002FTileDB-Inc\u002Fgvcf-1kg-dragen-v376\"\n\n# Get all samples from the dataset\nds = tiledbvcf.Dataset(dataset_uri, tiledb_config=cfg)\nsamples = ds.samples()\n\n# Define attributes and ranges to query on\nattrs = [\"sample_name\", \"fmt_GT\", \"fmt_AD\", \"fmt_DP\"]\nregions = [\"chr13:32396898-32397044\", \"chr13:32398162-32400268\"]\n\n# Perform the read, which is executed in a distributed fashion\ndf = tiledb.cloud.vcf.read(\n    dataset_uri=dataset_uri,\n    regions=regions,\n    samples=samples,\n    attrs=attrs,\n    namespace=\"my-namespace\",  # specifies which account to charge\n)\ndf.to_pandas()\n```\n\n### Enterprise Features\n\n**Data Sharing and Collaboration**\n```python\n# TileDB-Cloud provides enterprise data sharing capabilities\n# through namespace-based permissions and group management\n\n# Access shared datasets via TileDB-Cloud URIs\ndataset_uri = \"tiledb:\u002F\u002Fshared-namespace\u002Fpopulation-study\"\n\n# Collaborate through shared notebooks and compute resources\n# (Specific API requires TileDB-Cloud documentation)\n```\n\n**Cost Optimization**\n- **Serverless Compute**: Pay only for actual compute time\n- **Auto-scaling**: Automatically scale up\u002Fdown based on workload\n- **Spot Instances**: Use cost-optimized compute for batch jobs\n- **Data Tiering**: Automatic hot\u002Fcold storage management\n\n**Security and Compliance**\n- **End-to-end Encryption**: Data encrypted in transit and at rest\n- **Access Controls**: Fine-grained permissions and audit logs\n- **HIPAA\u002FSOC2 Compliance**: Enterprise security standards\n- **VPC Support**: Deploy in private cloud environments\n\n### When to Migrate Checklist\n\n✅ **Migrate to TileDB-Cloud if you have:**\n- [ ] Datasets > 1000 samples\n- [ ] Need to process > 100GB of VCF data\n- [ ] Require distributed computing\n- [ ] Multiple team members need access\n- [ ] Need enterprise security\u002Fcompliance\n- [ ] Want cost-optimized serverless compute\n- [ ] Require 24\u002F7 production uptime\n\n### Getting Started with TileDB-Cloud\n\n1. **Start Free**: TileDB-Cloud offers free tier for evaluation\n2. **Migration Support**: TileDB team provides migration assistance\n3. **Training**: Access to genomics-specific tutorials and examples\n4. **Professional Services**: Custom deployment and optimization\n\n**Next Steps:**\n- Visit https:\u002F\u002Fcloud.tiledb.com to create account\n- Review documentation at https:\u002F\u002Fcloud.tiledb.com\u002Facademy\u002F\n- Contact sales@tiledb.com for enterprise needs",{"name":5,"license":38,"metadata":39,"description":7},"MIT license",{"skill-author":40},"Jeremy Leipzig","master","c2e410e11df4d80d885e0ecf0583ef3c926df736","factory\u002Flibrary\u002Fskills\u002Fgithub_imports\u002Ftiledbvcf",0,"https:\u002F\u002Fgithub.com\u002FiDorgham\u002FWorkspace-Factory","https:\u002F\u002Fgithub.com\u002FiDorgham","Dorgham.me","hey I'm Dorgham \r\nI code, I create, and AI codes back. \r\nMaybe we can give AI the chance!! now we begin. 🚀🤖\r\n... . . . git commit -m \"Hello, Future\" ","2026-05-04 18:39:09",{"source":8,"skillName":5,"commands":51,"prompt":61,"zipAvailable":62},[52,55,58],{"tool":53,"command":54},"npx","npx skills add iDorgham\u002FWorkspace-Factory --skill tiledbvcf",{"tool":56,"command":57},"bunx","bunx skills add iDorgham\u002FWorkspace-Factory --skill tiledbvcf",{"tool":59,"command":60},"pnpm","pnpm dlx skills add iDorgham\u002FWorkspace-Factory --skill tiledbvcf","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002FiDorgham\u002FWorkspace-Factory\u002Fblob\u002Fmaster\u002Ffactory\u002Flibrary\u002Fskills\u002Fgithub_imports\u002Ftiledbvcf\u002FSKILL.md",true,[64],{"path":65,"resourceType":66,"resourceTypeDesc":67,"sizeBytes":68,"sourceHtmlUrl":69},"_AIWF_IMPORT.json","REFERENCE","参考文档",347,"https:\u002F\u002Fgithub.com\u002FiDorgham\u002FWorkspace-Factory\u002Fblob\u002Fmaster\u002Ffactory\u002Flibrary\u002Fskills\u002Fgithub_imports\u002Ftiledbvcf\u002F_AIWF_IMPORT.json",[71,104,126,147,167,190],{"skillNo":72,"name":73,"nameZh":6,"description":74,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":75,"categories":76,"keywords":82,"publishedAt":103},"01M71P8WVBMB2X3D24R0YT0B0E","vercel-react-view-transitions","Guide for implementing smooth, native-feeling animations using React's View Transition API (`\u003CViewTransition>` component, `addTransitionType`, and CSS view transition pseudo-elements). Use this skill whenever the user wants to add page transitions, animate route changes, create shared element animations, animate enter\u002Fexit of components, animate list reorder, implement directional (forward\u002Fback) navigation animations, or integrate view transitions in Next.js. Also use when the user mentions view transitions, `startViewTransition`, `ViewTransition`, transition types, or asks about animating between UI states in React without third-party animation libraries.","https:\u002F\u002Fgithub.com\u002FiDorgham\u002FWorkspace-Factory\u002Fblob\u002Fmaster\u002Ffactory\u002Flibrary\u002Fskills\u002Fofficial_vercel_labs_react_view_transitions\u002Fskill.md",[77],{"categoryNo":78,"categoryName":79,"taxonomyType":80,"taxonomyTypeDesc":81},"01JBSEEDCAT000000000000009","前端开发","SCENARIO","使用场景",[83,84,85,86,87,88,89,90,91,92,93,94,95,96,97,98,99,100,101,102],"react","vercel react view transitions","view","react view transitions","vercel","transitions","shared","back","Animation","css","types","states","element","implementing","when","components","api","route","create","libraries","2026-11-10 13:02:02",{"skillNo":105,"name":106,"nameZh":6,"description":107,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":108,"categories":109,"keywords":111,"publishedAt":103},"01M71P8TDGHZ289TSAC5VTG2EW","vercel-react-native-skills","React Native and Expo best practices for building performant mobile apps. Use when building React Native components, optimizing list performance, implementing animations, or working with native modules. Triggers on tasks involving React Native, Expo, mobile performance, or native platform APIs.","https:\u002F\u002Fgithub.com\u002FiDorgham\u002FWorkspace-Factory\u002Fblob\u002Fmaster\u002Ffactory\u002Flibrary\u002Fskills\u002Fofficial_vercel_labs_react_native_skills\u002Fskill.md",[110],{"categoryNo":78,"categoryName":79,"taxonomyType":80,"taxonomyTypeDesc":81},[83,112,113,87,114,115,116,117,96,118,97,119,98,120,121,122,123,124,125,28],"react native","native","vercel react native skills","react native skills","modules","performance","apps","tasks","mobile","expo","list","mobile performance","platform","animations",{"skillNo":127,"name":128,"nameZh":6,"description":129,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":130,"categories":131,"keywords":133,"publishedAt":103},"01M71P8QK4JF5BYRGYDDGPZQG9","vercel-react-best-practices","React and Next.js performance optimization guidelines from Vercel Engineering. This skill should be used when writing, reviewing, or refactoring React\u002FNext.js code to ensure optimal performance patterns. Triggers on tasks involving React components, Next.js pages, data fetching, bundle optimization, or performance improvements.","https:\u002F\u002Fgithub.com\u002FiDorgham\u002FWorkspace-Factory\u002Fblob\u002Fmaster\u002Ffactory\u002Flibrary\u002Fskills\u002Fofficial_vercel_labs_react_best_practices\u002Fskill.md",[132],{"categoryNo":78,"categoryName":79,"taxonomyType":80,"taxonomyTypeDesc":81},[83,134,135,87,136,117,137,97,138,119,98,139,140,141,142,26,143,144,145,146],"react best practices","vercel react best practices","best practices","writing","code","data fetching","react components","next","refactoring","patterns","Optimization","guidelines","triggers",{"skillNo":148,"name":149,"nameZh":6,"description":150,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":151,"categories":152,"keywords":154,"publishedAt":103},"01M71P8HVEA70K5N6ZVJCG2ED3","vercel-composition-patterns","React composition patterns that scale. Use when refactoring components with boolean prop proliferation, building flexible component libraries, or designing reusable APIs. Triggers on tasks involving compound components, render props, context providers, or component architecture. Includes React 19 API changes.","https:\u002F\u002Fgithub.com\u002FiDorgham\u002FWorkspace-Factory\u002Fblob\u002Fmaster\u002Ffactory\u002Flibrary\u002Fskills\u002Fofficial_vercel_labs_composition_patterns\u002Fskill.md",[153],{"categoryNo":78,"categoryName":79,"taxonomyType":80,"taxonomyTypeDesc":81},[155,87,156,143,157,158,159,160,146,161,162,163,97,164,119,98,165,166,99,83],"Composition","composition patterns","vercel composition patterns","react composition patterns","react 19","render","boolean","component architecture","use","reusable","architecture","react composition",{"skillNo":168,"name":169,"nameZh":6,"description":170,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":171,"categories":172,"keywords":176,"publishedAt":103},"01M71P60XXKKP222ZFJRG7R373","supabase-postgres-best-practices","Postgres performance optimization and best practices from Supabase. Use this skill when writing, reviewing, or optimizing Postgres queries, schema designs, or database configurations.","https:\u002F\u002Fgithub.com\u002FiDorgham\u002FWorkspace-Factory\u002Fblob\u002Fmaster\u002Ffactory\u002Flibrary\u002Fskills\u002Fofficial_supabase_supabase_postgres_best_practices\u002Fskill.md",[173],{"categoryNo":174,"categoryName":175,"taxonomyType":80,"taxonomyTypeDesc":81},"01JBSEEDCAT000000000000010","后端与接口",[177,178,179,180,136,181,182,183,28,144,117,184,185,137,186,163,187,188,189,97],"postgres best practices","supabase","postgres","supabase postgres best practices","categories","postgres performance","advanced","correct","schema","impact","Rules","critical","database",{"skillNo":191,"name":192,"nameZh":6,"description":193,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":194,"categories":195,"keywords":197,"publishedAt":213},"01M71P2ZCEJD0PKC458YTP1FJW","portable-text-serialization","Render and serialize Portable Text to React, Svelte, Vue, Astro, HTML, Markdown, and plain text. Use when implementing Portable Text rendering in any frontend framework, building custom serializers for non-standard block types, converting Portable Text to HTML strings server-side, converting Portable Text to Markdown, extracting plain text from Portable Text, or troubleshooting rendering issues with marks, blocks, lists, or custom types.","https:\u002F\u002Fgithub.com\u002FiDorgham\u002FWorkspace-Factory\u002Fblob\u002Fmaster\u002Ffactory\u002Flibrary\u002Fskills\u002Fofficial_sanity_io_portable_text_serialization\u002Fskill.md",[196],{"categoryNo":78,"categoryName":79,"taxonomyType":80,"taxonomyTypeDesc":81},[198,199,200,201,202,93,203,160,204,96,205,206,97,83,207,208,209,210,211,212],"text","portable text serialization","portable","serialization","extracting","strings","issues","frontend","svelte","sanity","astro","server","markdown","rendering","vue","2026-11-10 10:56:23"]