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
- 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
-
Clone the Repository 📥: Download VLBInspect.jl to any location on your computer
git clone https://github.com/aplavin/VLBInspect.jl.git cd VLBInspect.jl -
Install Julia 💎: Ensure you have Julia 1.11 installed
Note: Julia 1.10 is also supported. For Julia 1.10, checkout commit
0dac183100adcaa56eb744250c4cb6f52679fc59of VLBInspect.jl -
Initialize the Environment 🔧: Start Julia with the project environment
julia --project
-
Install Dependencies 📦: In the Julia REPL, run:
julia> using Pkg; Pkg.instantiate()
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)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)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)- Julia 💎: Version 1.10+ (1.11 recommended)
- Operating System 💻: Cross-platform (Windows, macOS, Linux)
- Dependencies 📦: Automatically managed via Project.toml
VLBInspect.jl is built on top of several powerful Julia packages:
- VLBIData.jl 🔧: Visibility data manipulation and calculations
- VLBIFiles.jl 📁: Reading visibility files in various formats
- Makie.jl & VLBIPlots.jl 📊: Interactive plotting and visualization
- DataManipulation.jl ⚡: Efficient visibility table manipulation
VLBInspect.jl is actively under development. Contributions, bug reports, and feature requests are welcome!