Help file for ezCon260622a

D:\ezRABase\LRO>py ../ezRA/ezCon260622a.py -h

         For help, run

            ezCon.py -help

=================================================

 Local time = Sat Jul 25 13:46:41 2026

 programRevision = ezCon260622a.py

 This Python command = ../ezRA/ezCon260622a.py  -h

   ezConArgumentsFile(D:\ezRABase\ezRA\ezDefaults.txt) ===============

   ezConArgumentsFile(ezDefaults.txt) ===============

   ezConArgumentsCommandLine ===============

##################################################################################

USAGE:

  Windows:   py      ezCon.py [optional arguments] radioDataFileDirectories

  Linux:     python3 ezCon.py [optional arguments] radioDataFileDirectories

  Easy Radio Astronomy (ezRA) ezCon data Condenser program

  to read ezCol format .txt radio data file(s),

  analyse them, optionally creating many .png plot files,

  and maybe write one Gal.npz Galaxy crossing velocity data file.

  “radioDataFileDirectories” may be one or more .txt radio data files:

         py  ezCon.py  bigDish220320_05.txt

         py  ezCon.py  bigDish220320_05.txt bigDish220321_00.txt

         py  ezCon.py  bigDish22032*.txt

  “radioDataFileDirectories” may be one or more directories:

         py  ezCon.py  bigDish2203

         py  ezCon.py  bigDish2203 bigDish2204

         py  ezCon.py  bigDish22*

  “radioDataFileDirectories” may be a mix of .txt radio data files and directories

  Arguments and “radioDataFileDirectories” may be in any mixed order.

  Arguments are read first from inside the ezCon program,

  then in order from the ezDefaults.txt in the ezCon.py’s directory,

  then in order from the ezDefaults.txt in current directory,

  then in order from the command line.  For duplicates, last read wins.

EXAMPLES:

  py ezCon.py -help                  (print this help)

  py ezCon.py -h                     (print this help)

    -ezRAObsName   Lebanon Kansas    (Observatory Name)

    -ezRAObsLat    39.8282           (Observatory Latitude  (degrees))

    -ezRAObsLon    -98.5696          (Observatory Longitude (degrees))

    -ezRAObsAmsl   563.88            (Observatory Above Mean Sea Level (meters))

    -ezConAddMHz           0.4       (add MHz to all data file’s frequencies)

    -ezConAzDeg            180.4     (force Azimuth   (degrees)

    -ezConElDeg            35.7      (force Elevation (degrees)

    -ezConAddAzDeg         9.4       (add to data file’s recorded Azimuth   (degrees))

    -ezConAddElDeg         -2.6      (add to data file’s recorded Elevation (degrees))

    -ezConInputdB          1         (interpret power values as dB

    -ezConRawSamplesUseL   0 100     (first Raw sample number    last Raw sample number)

    -ezConRawFreqBinTrimL  0 512    1.1 (force freqBin range to value 1.1)

    -ezConRawFreqTrimL     0 1418.2 0.4 (force frequency range (MHz) to value 0.4)

    -ezConRawFreqBinHide   125       (hide Raw freqBin 125 by copying from weaker of freqBin 124 or 126)

    -ezConRawFreqBinHideL  125 127   (hide Raw freqBins 125 thru 127 by copying from weaker neighbor)

    -ezConRawFreqBinHideL  127 125   (hide Raw freqBins 127 thru 125 by copying from weaker neighbor)

    -ezConRefMode                    (Dicke Reference sample creation method, default = 10)

    -ezConRefMode N < 1: REF = spectrum from -Nth ANT sample

    -ezConRefMode -1403: REF = spectrum from ANT sample number 1403

    -ezConRefMode     0: REF = spectrum from first ANT sample, sample number 0

    -ezConRefMode     1: REF = 1.0 (no REF, neutral spectrum)

    -ezConRefMode     2: REF = spectrum from rawByFreqBinAvg spectrum average

    -ezConRefMode     5: REF = the one ant spectrum at sample of minimum of antAvg

    -ezConRefMode     7: REF = the one antB spectrum at sample of minimum of antBAvg

    -ezConRefMode    10: REF = last REF sample marked in data, if none will use sample 0

    -ezConRefMode30L  freqAnt  freqRef  bwAnt   = Ant beside Ref in each Raw sample

    -ezConRefMode31 11.5 REF = the one antB spectrum closest to Right Ascension 11.5 hours

    -ezConRefMode    40: REF = spectrum from antAvgByFreqBinAvg spectrum average

    -ezConRefMode    41: REF = spectrum from antMaxByFreqBinAvg spectrum average

    -ezConRefMode    44: REF = spectrum from antBAvgByFreqBinAvg spectrum average

    -ezConRefMode    45: REF = spectrum from antBMaxByFreqBinAvg spectrum average

    -ezConAntMaxPluckValL  .01   .03

         (Pluck (ignore) AntMax samples with Values below .01 or above .03)

    -ezConAntSamplesUseL    25   102  (first Ant sample number    last Ant sample number)

    -ezConAntPluck          29        (Pluck (ignore) Ant sample number)

    -ezConAntAvgPluckQtyL    3    5

         (Pluck (ignore) Ant samples with the 3 Quantity lowest, and 5 highest, sorted AntAvg values)

    -ezConAntAvgPluckFracL  .02  .03

         (Pluck (ignore) Ant samples with the lowest 2% and highest 3% AntAvg values (antLen Fractions))

    -ezConAntFreqBinHide  125        (hide Ant freqBin 125 by copying from weaker of freqBin 124 or 126)

    -ezConAntFreqBinHideL 125 127    (hide Ant freqBins 125 thru 127 by copying from weaker neighbor)

    -ezConAntFreqBinHideL 127 125    (hide Ant freqBins 127 thru 125 by copying from weaker neighbor)

    -ezConAntFreqBinSmooth  1.1        (RFI spur limiter: maximum muliplier over 4 neighboring freqBin of same Ant sample)

    -ezConRefAvgPluckQtyL    3    5

         (Pluck (ignore) Ref samples with the 3 Quantity lowest, and 5 highest, sorted RefAvg values)

    -ezConRefAvgPluckFracL  .02  .03

         (Pluck (ignore) Ref samples with the lowest 2% and highest 3% RefAvg values (antLen Fractions))

    -ezConRefFreqBinHide  125        (hide Ref freqBin 125 by copying from louder of freqBin 124 or 126)

    -ezConRefFreqBinHideL 125 127    (hide Ref freqBins 125 thru 127 by copying from louder neighbor)

    -ezConRefFreqBinHideL 127 125    (hide Ref freqBins 127 thru 125 by copying from louder neighbor)

    -ezConAntBaselineFreqBinsFracL   0  0.2344  0.7657  1

         (AntBaseline        FreqBin bands: start stop start stop (as fractions of bandwidth))

    -ezConAntRABaselineFreqBinsFracL 0  0.2344  0.7657  1

         (AntRABaseline      FreqBin bands: start stop start stop (as fractions of bandwidth))

    -ezConAntXInput    6             (AntX choice: default -1 for Auto, 0/2/4/5/6 for Ant/Ref/AntB/AntRA/AntRB)

    -ezConAntXTFreqBinsFracL            0.2344  0.7657

         (AntXTFreqBinsFrac FreqBin band:  start stop            (as fractions of bandwidth))

    -ezConUseVlsr      1             (use VLSR for AntXTV and further processing)

    -ezConAntXTVTFreqBinsFracL          0.4     0.6

         (AntXTVTFreqBinsFrac FreqBin band:  start stop          (as fractions of bandwidth))

    -ezConAntXTVTMaxPluckQtyL   3    5

         (Pluck (ignore) AntXTVTMax samples with the 3 Quantity lowest, and 5 highest, sorted AntXTVTMax)

    -ezConAntXTVTMaxPluckValL  .01   .03

         (Pluck (ignore) AntXTVTMax samples with Values below .01 or above .03)

    -ezConAntXTVTAvgPluckQtyL   3    5

         (Pluck (ignore) AntXTVT    samples with the 3 Quantity lowest, and 5 highest, sorted AntXTVT)

    -ezConAntXTVTAvgPluckValL  .01   .03

         (Pluck (ignore) AntXTVT    samples with Values below .01 or above .03)

    -ezConAntXTVTPluck          33

         (Pluck (ignore) AntXTVTMax and AntXTVT sample 33)

    -ezConAntXTVTClipL         .01   .03

         (Clip all AntXTVT values to be between .01 and .03)

    -ezConAntXTVTSmooth         2

         (smooth antXTVT heatmap data as an image, with choice of filters)

    -ezConAntXTVTFreqBinsClipL  203  407

         (reduce AntXTVT to only FreqBin from 203 to 407)

    -ezConAntXTVTIntegrate      1

         (integrate AntXTVT into one day’s drift-scan, 1 for RA, 4 for GLon)

    -ezCon087Csv         1           (create CSV file of ezCon087 for 3d plots with rinearn.com/en-us/graph3d)

    -ezCon087Csv         2           (… and also write out ezCon087 as one directory of ifAvg format files)

    -ezCon087Csv         4           (create simpler CSV file format for plotly)

    -ezConPlotRangeL     0  300      (save only this range of ezCon plots to file, to save time)

    -ezConRawDispIndex   1           (also Display the Raw sample Index on x axis)

    -ezConDispGrid       1           (turn on graphical display plot grids)

    -ezConDispFreqBin    1           (1 for display FreqBin numbers on Y axis, 2 for 0.0 to 1.0)

    -ezConHeatVMinMaxL   1.0 1.4     (heat map z scale)

    -ezConAstroMath      0           (astroMath choice)

      -ezConAstroMath  0:    no math (good for faster plots of most signals, but AntXTV is wrong)

      -ezConAstroMath  1:    using math from MIT Haystack SRT

      -ezConAstroMath  2:    using math from authoritative slower AstroPy library

    -ezConVelGLonEdgeFrac         0.5

         (velGLon level fraction for plotEzCon430velGLonEdges)

    -ezConGalCrossingGLatCenter   2.4

         (add spectra to Gal.npz, the center of GLat crossing, in Galactic Latitude degrees)

    -ezConGalCrossingGLatCenterL  -5.2  6.3  11

         (adds centers of GLat crossings in Galactic Latitude degrees, as np.linspace(-5.2, 6.3, num=11))

    -ezConGalCrossingGLatNear     2.3

         (defines “close to GLat crossing” in Galactic Latitude degrees)

    -ezConGalCrossingGLonCenter   72.4

         (add spectra to GLon.npz, the center of GLon crossing, in Galactic Longitude degrees)

    -ezConGalCrossingGLonCenterL  69.6  82.4  13

         (adds centers of GLon crossings in Galactic Longitude degrees, as np.linspace(69.6,  82.4, num=13))

    -ezConGalCrossingGLonNear     2.7

         (defines “close to GLon crossing” in Galactic Longitude degrees)

    -ezConGalRaDecNearNearL       0.8  41.3  0.1  0.2

         (add spectra to RGal.npz, from RaDec span 0.8 +/-0.1 hours, 41.3 +/-0.2 degrees)

    -ezConGalNormalize            2

         (normalize each .npz file, 0/1/2 for None/Average/Maximum of its AntXTVT samples)

    -ezCon399SignalSampleByFreqBinL     18  1423

         (plot antenna sample 1423 spectrum By FreqBin of signal 18 (of ezbMenu columns 10, 12, 14, 16, 18))

    -ezDefaultsFile ../bigDish8.txt     (additional file of ezRA arguments)

    -ezDefaultsEnd                      (ignore the rest of this ezDefaults file

    -eXXXXXXXXXXXXXXzIgonoreThisWholeOneWord

         (any one word starting with -eX is ignored, handy for long command line editing)

 programRevision = ezCon260622a.py

       The Society of Amateur Radio Astronomers (SARA)

                    radio-astronomy.org

By Admin

Leave a Reply

Your email address will not be published. Required fields are marked *


This site uses Akismet to reduce spam. Learn how your comment data is processed.