API Reference — Kindle¶

embers.kindle contains a set of command-line (cli) tools or executable script to process data in various ways

embers.kindle.waterfall_single.main()¶

Saves a single waterfall plot with a raw RF data file using the single_waterfall() function.

$ waterfall_single --help

embers.kindle.waterfall_batch.main()¶

Create a set of waterfall plots for all rf_files within a date interval using the waterfall_batch() function.

$ waterfall_batch --help

embers.kindle.colormaps.main()¶

Preview EMBERS two beautiful custom colormaps - spectral() & jade(). The spectral colormap is non-linear and is just used to visualise raw data and maximize dynamic range, while jade is perceptually uniform and sequential and is suitable for science. To get a preview of how amazing they are

$ colormaps --help

embers.kindle.align_single.main()¶

Temporally align reference and tile data using the plot_savgol_interp() function.

$ align_single --help

embers.kindle.align_batch.main()¶

Temporally align all RF files within a date interval using the align_batch() function.

$ align_batch --help

embers.kindle.download_tle.main()¶

Download tle files with the download_tle() from space-tracks.org

$ download_tle --help

embers.kindle.ephem_single.main()¶

Analyse TLE data file and create a sky coverage plot created with the save_ephem() function.

$ ephem_single --help

embers.kindle.ephem_batch.main()¶

Analyse a batch of TLE files is with the ephem_batch() function.

Determine satellite ephemeris data: rise time, set time, alt/az arrays at a given time cadence. This is saved to a npz file which will be used to plot the satellite sky coverage over the geographic location supplied.

$ ephem_batch --help

embers.kindle.ephem_chrono.main()¶

Collate ephemeris data generated above by ephem_batch for multiple satellites and determine all satellites present in each 30 minute observation and what their trajectories at the geographic location. The save_chrono_ephem() function saves chronological ephemeris data to json files in ./embers_out/sat_utils/ephem_chrono.

$ ephem_chrono --help

embers.kindle.sat_channels.main()¶

Determine satellite transmission channels using the batch_window_map() function.

$ sat_channels --help

embers.kindle.mwa_pointings.main()¶

Download MWA pointing metadata using the mwa_point_meta() function.

$ mwa_pointings --help

embers.kindle.mwa_dipoles.main()¶

Check MWA antenna dipole flagging using the mwa_flagged_dipoles() function.

$ mwa_dipoles --help

embers.kindle.mwa_fee.main()¶

Create MWA Fully Embedded Element (FEE) beam models healpix maps at the given nside using the mwa_fee_model() function.

$ mwa_fee --help

embers.kindle.ref_models.main()¶

Convert FEKO models on the reference antennas into healpix maps using the ref_healpix_save() function.

$ ref_models --help

embers.kindle.rfe_calibration.main()¶

Determine the RF Explorer gain calibration solution using the rfe_batch_cali() function.

$ rfe_calibration

embers.kindle.tile_maps.main()¶

Create tile beam maps using the tile_maps_batch().

$ tile_maps --help

embers.kindle.null_test.main()¶

Perform a null test of the reference antennas using the null_test() function.

$ null_test --help

embers.kindle.compare_beams.main()¶

Compare measured MWA beam maps with MWA FEE models using the batch_compare_beam() function.

$ compare_beams --help