Skip to content

About

No description, website, or topics provided.

Resources

Stars

1 star

Watchers

1 watching

Forks

Latest commit

 

History

37 Commits

Folders and files

Repository files navigation

VLBInspect.jl 📡👁️

A powerful interactive tool for quick inspection of Very Long Baseline Interferometry (VLBI) visibility datasets.

Screen.Recording.2025-05-21.at.17.00.39.mov

Features ✨

  • Interactive Visualization 📊: Real-time exploration of VLBI visibility data with an intuitive graphical interface
  • Universal File Format Support 📁: Compatible with any format supported by VLBIFiles.jl
  • Flexible Data Loading ⚡: Support for single files, multiple files, and glob pattern matching
  • Advanced Filtering 🔍: Filter and inspect specific data subsets with powerful query capabilities
  • Multi-Window Support 🪟: Open multiple datasets in separate windows for comparative analysis

Installation & Setup 🚀

  1. Clone the Repository 📥: Download VLBInspect.jl to any location on your computer

    git clone https://github.com/aplavin/VLBInspect.jl.git
    cd VLBInspect.jl
  2. Install Julia 💎: Ensure you have Julia 1.11 installed

    Note: Julia 1.10 is also supported. For Julia 1.10, checkout commit 0dac183100adcaa56eb744250c4cb6f52679fc59 of VLBInspect.jl

  3. Initialize the Environment 🔧: Start Julia with the project environment

    julia --project
  4. Install Dependencies 📦: In the Julia REPL, run:

    julia> using Pkg; Pkg.instantiate()

Quick Start 🚀

Load VLBInspect and start exploring your VLBI datasets:

# Load the package
julia> using VLBInspect

# Option 1: Sample Data 🎯 - Get started immediately with example data
julia> f = download("http://www.cv.nrao.edu/2cmVLBA/data/1226+023/1999_04_04/1226+023.u.1999_04_04.uvf");
julia> uvtbl = uvtable(VLBI.load(f), stokes=UniversalSet);

# Option 2: Single File 📄 - Load your own VLBI data file
julia> uvtbl = uvtable(VLBI.load("yourfile.uvf"), stokes=UniversalSet);

# Option 3: Multiple Files 📚 - Combine data from multiple files
julia> uvtbl = vcat(
    uvtable(VLBI.load("yourfile_A.uvf"), stokes=UniversalSet),
    uvtable(VLBI.load("yourfile_B.uvf"), stokes=UniversalSet),
)

# Option 4: Batch Loading ⚡ - Load multiple files using glob patterns
julia> uvtbl = flatmap(readdir(glob"some*/glob/pattern*.uvf", "/your/base/directory")) do f
    uvtable(VLBI.load(f), stokes=UniversalSet)
end

# Launch the interactive inspector 🎮
julia> inspect_uv(uvtbl)

Advanced Features ⚡

Multi-Window Support 🪟

Open datasets in separate windows for comparative analysis:

# Open in a dedicated new window
julia> inspect_uv(uvtbl; new_window=true)

# Compare multiple datasets simultaneously
julia> inspect_uv(dataset1; new_window=true)
julia> inspect_uv(dataset2; new_window=true)

Advanced Data Filtering 🔍

Inspect specific data subsets using powerful filtering capabilities:

# Exclude specific antennas (e.g., FD antenna)
julia> inspect_uv(@p uvtbl filter(any(a -> a.name != :FD, antennas(_))))

# Filter by custom criteria and inspect the subset
julia> filtered_data = @p uvtbl filter(your_custom_condition(_))
julia> inspect_uv(filtered_data)

Requirements 📋

  • Julia 💎: Version 1.10+ (1.11 recommended)
  • Operating System 💻: Cross-platform (Windows, macOS, Linux)
  • Dependencies 📦: Automatically managed via Project.toml

Built On 🏗️

VLBInspect.jl is built on top of several powerful Julia packages:

Contributing 🤝

VLBInspect.jl is actively under development. Contributions, bug reports, and feature requests are welcome!

About

No description, website, or topics provided.

Resources

Stars

1 star

Watchers

1 watching

Forks

Releases

Packages

Used by

Contributors

Languages