ZDF PROGRAM PACKAGE

      Trace manipulation and plotting of seismograms and travel times windowed output

      A program sequence written by

      B.L.N. Kennett
      Seismology Group, Research School of Earth Sciences,
      Australian National University


      Index:

      ZDF format description

      ZDF Program suite

      1. Format conversion programs
      2. Display
      3. Analysis
      4. Utilities
      5. Stacking procedures
      6. Software Access

      Command files



      The ZDF suite of programs are designed to provide a simple and convenient means of working with multistation and multi-component data in an event oriented format.

      The ZDF format uses Unix i/o routines and is thus accessible to both Fortran and C routines. The data is stored as real*4 values do that both 16-bit and 24 bit information can be handled.

      The ZDF format specification and standard data structures are given in zdfhelp.
      Routines are available for displaying seismograms and record sections with the option of superimposed travel time information and run-time filtering. Seismograms are plotted in a range and time window with user specified reduction slowness. In addition windowed travel time plots can be made, either separately or superimposed on the seismograms.


      PROGRAMS

      The ZDF program suite is built on a set of modules so that
      • Travel time calculation
      • Event file and trace selection
      • Time windowing
      • Frequency filtering
      • Spectral ratio calculations
      follow the same pattern in each of the rotuines in which they appear.

      The following programs are currently implemented

      Format conversion programs   further details

      For conversion to ZDF format
      • a) SAC - skipzdf
        • multiple SAC files to a single ZDF file to facilitate record section plotting (skipzdf1 handles day crossing!)
      • b1) CDF - cdfzdf
        • single CDF file to a single ZDF file conversion of RSES 16-bit data format
      • b2) CDF- wrazdf
        • single CDF file to a single ZDF file conversion of WRA 16-bit data format (5 channel data)
      • c) ZST - zstzdf
        • single ZST file to a single ZDF file conversion of synthetic seismograms
      Index

      Display etc   further details

      The current routines have been designed to provide access to convenient record sections for data from the SKIPPY project and other RSES data sources.

      • zdf_tsm/zdf_ysm
        Record section plotting with superimposed travel times using iasp software and run-time filtering also travel times from specified velocity model options for trace selection and depth corrections
        • tsm: time on vertical axis, distance on horizontal axis
        • ysm: time on horizontal axis distance on vertical axis
      • zdf_dsm
        Seismogram display with optional superimposed travel times using iasp software also travel times from specified velocity model options for trace selection and depth corrections
      • zdf_dwin
        Display of time windows around selected phases
      • zdf_dtw
        Windows around the expected arrivals of P, PP, S and SS
      • zdf_filt
        Offline band pass filtering of ZDF format records
      Index

      Analysis routines   further details

      • zdf_spec
        Display of trace and spectra for ZRT and P, SV, SH components scans a full ZDF file with a plotpage per station
      • zdf_specrat
        Display of trace, spectra for P, SV, SH components and spectral ratios, slope. Scans a full ZDF file with a plotpage per station
      • zdf_spr
        Calculation of spectra for P, SV, SH components and spectral ratios, slope. Scans a full ZDF file - no displays
      Index

      ZDF Utilities  further details

      • zdf_check/zdf_check2
        Rapid check of contents of ZDF file (.zb) more extensive output with zdf_check2
      • zdf_mcheck
        Summary information for multiple ZDF files
      • zdf_edit
        Editing of contents of ZDF files e.g. change of source information, with recalculation of distances etc
      • zdf_chyp
        Introduction of EHB hypocentre parameters recalculation of distances etc rerotation of horizontal components
      • zdf_chyp1
        Introduction of hypocentre parameters from a general source recalculation of distances etc rerotation of horizontal components
      • zdf_samp
        Resampling (currently converts 20 samp/sec data to 25 samp/sec)

      Index

      Stacking of ZDF traces  further details

      • zdf_stack    - trace stacking by distance bin
      • zdf_phstack - slowness stacking
      • zdf_p3stack - 3-component slowness stacking: phase based
      • zdf_s3stack - 3-component slowness stacking: semblance based

      The slowness stacking programs generate output in a stackfile format which depends on the particular procedure.
      Conversion to zdf traces is achieved with the routines

      • stkzdf - Single component slowness stacks
      • sp3zdf - 3-component slowness stacks: phase based
      • ss3zdf - 3-component slowness stacks: semblance based

      Index


      COMMAND FILES:

      Each of the programs is run with the aid of a command file which provides convenient mnenomics for editing.

      The command files have a fixed syntax:

      • commands are read with a2
      • file names are read with a30
      • titles, labels with a72
      • numbers are read free formatted
      • for each instruction a brief explanation is given
        • in columns 41-80 for commands,
        • numbers in columns 72-80 for titles etc