680680 </ span >
681681 </ a >
682682
683+ </ li >
684+
685+ < li class ="md-nav__item ">
686+ < a href ="#trace-header-modification " class ="md-nav__link ">
687+ < span class ="md-ellipsis ">
688+ Trace header modification
689+ </ span >
690+ </ a >
691+
683692</ li >
684693
685694 < li class ="md-nav__item ">
@@ -1292,6 +1301,26 @@ <h2 id="header-info-from-command-line">Header Info from Command Line</h2>
12921301< a id ="__codelineno-1-13 " name ="__codelineno-1-13 " href ="#__codelineno-1-13 "> </ a > Picks< span class ="w "> </ span > < span class ="p "> |</ span > < span class ="w "> </ span > None< span class ="w "> </ span > < span class ="p "> |</ span > < span class ="w "> </ span > None< span class ="w "> </ span >
12931302< a id ="__codelineno-1-14 " name ="__codelineno-1-14 " href ="#__codelineno-1-14 "> </ a > References< span class ="w "> </ span > < span class ="p "> |</ span > < span class ="w "> </ span > None< span class ="w "> </ span > < span class ="p "> |</ span > < span class ="w "> </ span > None
12941303</ code > </ pre > </ div > </ p >
1304+ < h2 id ="trace-header-modification "> Trace header modification</ h2 >
1305+ < p > If you need to modify the header of your traces, I recommend that you use < em > quick</ em > or < em > process_daily</ em > command and use the < strong > rename</ strong > process. This process simply maps the original traces header information into the new one. Here, you will find an example of config file with the process of mapping network, station, location and channel codes.</ p >
1306+ < div class ="highlight "> < pre > < span > </ span > < code > < a id ="__codelineno-2-1 " name ="__codelineno-2-1 " href ="#__codelineno-2-1 "> </ a > Analysis:
1307+ < a id ="__codelineno-2-2 " name ="__codelineno-2-2 " href ="#__codelineno-2-2 "> </ a > < span class ="w "> </ span > process_1:
1308+ < a id ="__codelineno-2-3 " name ="__codelineno-2-3 " href ="#__codelineno-2-3 "> </ a > < span class ="w "> </ span > name:< span class ="w "> </ span > < span class ="s1 "> 'rename'</ span >
1309+ < a id ="__codelineno-2-4 " name ="__codelineno-2-4 " href ="#__codelineno-2-4 "> </ a >
1310+ < a id ="__codelineno-2-5 " name ="__codelineno-2-5 " href ="#__codelineno-2-5 "> </ a > < span class ="w "> </ span > networks:
1311+ < a id ="__codelineno-2-6 " name ="__codelineno-2-6 " href ="#__codelineno-2-6 "> </ a > < span class ="w "> </ span > IM:< span class ="w "> </ span > IH< span class ="w "> </ span > < span class ="c1 "> # Replace network XX → YY</ span >
1312+ < a id ="__codelineno-2-7 " name ="__codelineno-2-7 " href ="#__codelineno-2-7 "> </ a > < span class ="w "> </ span > IK:< span class ="w "> </ span > IN
1313+ < a id ="__codelineno-2-8 " name ="__codelineno-2-8 " href ="#__codelineno-2-8 "> </ a >
1314+ < a id ="__codelineno-2-9 " name ="__codelineno-2-9 " href ="#__codelineno-2-9 "> </ a > < span class ="w "> </ span > stations:
1315+ < a id ="__codelineno-2-10 " name ="__codelineno-2-10 " href ="#__codelineno-2-10 "> </ a > < span class ="w "> </ span > IL02:< span class ="w "> </ span > XX02
1316+ < a id ="__codelineno-2-11 " name ="__codelineno-2-11 " href ="#__codelineno-2-11 "> </ a > < span class ="w "> </ span > ARNO:< span class ="w "> </ span > MELI
1317+ < a id ="__codelineno-2-12 " name ="__codelineno-2-12 " href ="#__codelineno-2-12 "> </ a >
1318+ < a id ="__codelineno-2-13 " name ="__codelineno-2-13 " href ="#__codelineno-2-13 "> </ a > < span class ="w "> </ span > channels:
1319+ < a id ="__codelineno-2-14 " name ="__codelineno-2-14 " href ="#__codelineno-2-14 "> </ a > < span class ="w "> </ span > SHZ:< span class ="w "> </ span > BHZ< span class ="w "> </ span > < span class ="c1 "> # Entire channel replacement</ span >
1320+ < a id ="__codelineno-2-15 " name ="__codelineno-2-15 " href ="#__codelineno-2-15 "> </ a >
1321+ < a id ="__codelineno-2-16 " name ="__codelineno-2-16 " href ="#__codelineno-2-16 "> </ a > < span class ="w "> </ span > components:
1322+ < a id ="__codelineno-2-17 " name ="__codelineno-2-17 " href ="#__codelineno-2-17 "> </ a > < span class ="w "> </ span > Z:< span class ="w "> </ span > E< span class ="w "> </ span > < span class ="c1 "> # Only the last component letter (Z → E, N → Z, etc.)</ span >
1323+ </ code > </ pre > </ div >
12951324< h2 id ="surfquake-extended-header-fields "> SurfQuake-Extended Header Fields</ h2 >
12961325< p > These fields are dynamically added during processing or interactive analysis:</ p >
12971326< h3 id ="tracestatspicks-list-of-dicts "> < code > trace.stats.picks</ code > (list of dicts)</ h3 >
@@ -1301,12 +1330,12 @@ <h3 id="tracestatspicks-list-of-dicts"><code>trace.stats.picks</code> (list of d
13011330- < code > phase</ code > (str): Picked phase (e.g., < code > P</ code > , < code > S</ code > , < code > Lg</ code > )
13021331- < code > amplitude</ code > (float): Measured amplitude at pick time
13031332- < code > polarity</ code > (str): < code > U</ code > (up), < code > D</ code > (down), or < code > ?</ code > </ p >
1304- < div class ="highlight "> < pre > < span > </ span > < code > < a id ="__codelineno-2 -1 " name ="__codelineno-2 -1 " href ="#__codelineno-2 -1 "> </ a > < span class ="p "> {</ span >
1305- < a id ="__codelineno-2 -2 " name ="__codelineno-2 -2 " href ="#__codelineno-2 -2 "> </ a > < span class ="w "> </ span > < span class ="nt "> "time"</ span > < span class ="p "> :</ span > < span class ="w "> </ span > < span class ="mf "> 1727123830.321</ span > < span class ="p "> ,</ span >
1306- < a id ="__codelineno-2 -3 " name ="__codelineno-2 -3 " href ="#__codelineno-2 -3 "> </ a > < span class ="w "> </ span > < span class ="nt "> "phase"</ span > < span class ="p "> :</ span > < span class ="w "> </ span > < span class ="s2 "> "P"</ span > < span class ="p "> ,</ span >
1307- < a id ="__codelineno-2 -4 " name ="__codelineno-2 -4 " href ="#__codelineno-2 -4 "> </ a > < span class ="w "> </ span > < span class ="nt "> "amplitude"</ span > < span class ="p "> :</ span > < span class ="w "> </ span > < span class ="mf "> 3.21e-05</ span > < span class ="p "> ,</ span >
1308- < a id ="__codelineno-2 -5 " name ="__codelineno-2 -5 " href ="#__codelineno-2 -5 "> </ a > < span class ="w "> </ span > < span class ="nt "> "polarity"</ span > < span class ="p "> :</ span > < span class ="w "> </ span > < span class ="s2 "> "U"</ span >
1309- < a id ="__codelineno-2 -6 " name ="__codelineno-2 -6 " href ="#__codelineno-2 -6 "> </ a > < span class ="p "> }</ span >
1333+ < div class ="highlight "> < pre > < span > </ span > < code > < a id ="__codelineno-3 -1 " name ="__codelineno-3 -1 " href ="#__codelineno-3 -1 "> </ a > < span class ="p "> {</ span >
1334+ < a id ="__codelineno-3 -2 " name ="__codelineno-3 -2 " href ="#__codelineno-3 -2 "> </ a > < span class ="w "> </ span > < span class ="nt "> "time"</ span > < span class ="p "> :</ span > < span class ="w "> </ span > < span class ="mf "> 1727123830.321</ span > < span class ="p "> ,</ span >
1335+ < a id ="__codelineno-3 -3 " name ="__codelineno-3 -3 " href ="#__codelineno-3 -3 "> </ a > < span class ="w "> </ span > < span class ="nt "> "phase"</ span > < span class ="p "> :</ span > < span class ="w "> </ span > < span class ="s2 "> "P"</ span > < span class ="p "> ,</ span >
1336+ < a id ="__codelineno-3 -4 " name ="__codelineno-3 -4 " href ="#__codelineno-3 -4 "> </ a > < span class ="w "> </ span > < span class ="nt "> "amplitude"</ span > < span class ="p "> :</ span > < span class ="w "> </ span > < span class ="mf "> 3.21e-05</ span > < span class ="p "> ,</ span >
1337+ < a id ="__codelineno-3 -5 " name ="__codelineno-3 -5 " href ="#__codelineno-3 -5 "> </ a > < span class ="w "> </ span > < span class ="nt "> "polarity"</ span > < span class ="p "> :</ span > < span class ="w "> </ span > < span class ="s2 "> "U"</ span >
1338+ < a id ="__codelineno-3 -6 " name ="__codelineno-3 -6 " href ="#__codelineno-3 -6 "> </ a > < span class ="p "> }</ span >
13101339</ code > </ pre > </ div >
13111340< h3 id ="tracestatsreferences-list-of-float "> < code > trace.stats.references</ code > (list of float)</ h3 >
13121341< p > Stores timestamps marking user-defined reference lines during plotting (e.g., using keypress < code > w</ code > ). These are used for alignment, cross-checking picks, or beamforming time tags.</ p >
@@ -1343,16 +1372,16 @@ <h3 id="tracestatsgeodetic"><code>trace.stats.geodetic</code></h3>
13431372</ tbody >
13441373</ table >
13451374< h3 id ="example "> Example:</ h3 >
1346- < div class ="highlight "> < pre > < span > </ span > < code > < a id ="__codelineno-3 -1 " name ="__codelineno-3 -1 " href ="#__codelineno-3 -1 "> </ a > < span class ="n "> trace</ span > < span class ="o "> .</ span > < span class ="n "> stats</ span > < span class ="o "> .</ span > < span class ="n "> geodetic</ span > < span class ="o "> =</ span > < span class ="p "> {</ span >
1347- < a id ="__codelineno-3 -2 " name ="__codelineno-3 -2 " href ="#__codelineno-3 -2 "> </ a > < span class ="s2 "> "distance"</ span > < span class ="p "> :</ span > < span class ="mf "> 254.7</ span > < span class ="p "> ,</ span >
1348- < a id ="__codelineno-3 -3 " name ="__codelineno-3 -3 " href ="#__codelineno-3 -3 "> </ a > < span class ="s2 "> "baz"</ span > < span class ="p "> :</ span > < span class ="mf "> 123.4</ span > < span class ="p "> ,</ span >
1349- < a id ="__codelineno-3 -4 " name ="__codelineno-3 -4 " href ="#__codelineno-3 -4 "> </ a > < span class ="s2 "> "az"</ span > < span class ="p "> :</ span > < span class ="mf "> 303.4</ span > < span class ="p "> ,</ span >
1350- < a id ="__codelineno-3 -5 " name ="__codelineno-3 -5 " href ="#__codelineno-3 -5 "> </ a > < span class ="s2 "> "incidence"</ span > < span class ="p "> :</ span > < span class ="mf "> 31.5</ span > < span class ="p "> ,</ span >
1351- < a id ="__codelineno-3 -6 " name ="__codelineno-3 -6 " href ="#__codelineno-3 -6 "> </ a > < span class ="s2 "> "arrivals"</ span > < span class ="p "> :</ span > < span class ="p "> {</ span >
1352- < a id ="__codelineno-3 -7 " name ="__codelineno-3 -7 " href ="#__codelineno-3 -7 "> </ a > < span class ="s2 "> "P"</ span > < span class ="p "> :</ span > < span class ="mf "> 1727123829.20</ span > < span class ="p "> ,</ span >
1353- < a id ="__codelineno-3 -8 " name ="__codelineno-3 -8 " href ="#__codelineno-3 -8 "> </ a > < span class ="s2 "> "S"</ span > < span class ="p "> :</ span > < span class ="mf "> 1727123844.03</ span >
1354- < a id ="__codelineno-3 -9 " name ="__codelineno-3 -9 " href ="#__codelineno-3 -9 "> </ a > < span class ="p "> }</ span >
1355- < a id ="__codelineno-3 -10 " name ="__codelineno-3 -10 " href ="#__codelineno-3 -10 "> </ a > < span class ="p "> }</ span >
1375+ < div class ="highlight "> < pre > < span > </ span > < code > < a id ="__codelineno-4 -1 " name ="__codelineno-4 -1 " href ="#__codelineno-4 -1 "> </ a > < span class ="n "> trace</ span > < span class ="o "> .</ span > < span class ="n "> stats</ span > < span class ="o "> .</ span > < span class ="n "> geodetic</ span > < span class ="o "> =</ span > < span class ="p "> {</ span >
1376+ < a id ="__codelineno-4 -2 " name ="__codelineno-4 -2 " href ="#__codelineno-4 -2 "> </ a > < span class ="s2 "> "distance"</ span > < span class ="p "> :</ span > < span class ="mf "> 254.7</ span > < span class ="p "> ,</ span >
1377+ < a id ="__codelineno-4 -3 " name ="__codelineno-4 -3 " href ="#__codelineno-4 -3 "> </ a > < span class ="s2 "> "baz"</ span > < span class ="p "> :</ span > < span class ="mf "> 123.4</ span > < span class ="p "> ,</ span >
1378+ < a id ="__codelineno-4 -4 " name ="__codelineno-4 -4 " href ="#__codelineno-4 -4 "> </ a > < span class ="s2 "> "az"</ span > < span class ="p "> :</ span > < span class ="mf "> 303.4</ span > < span class ="p "> ,</ span >
1379+ < a id ="__codelineno-4 -5 " name ="__codelineno-4 -5 " href ="#__codelineno-4 -5 "> </ a > < span class ="s2 "> "incidence"</ span > < span class ="p "> :</ span > < span class ="mf "> 31.5</ span > < span class ="p "> ,</ span >
1380+ < a id ="__codelineno-4 -6 " name ="__codelineno-4 -6 " href ="#__codelineno-4 -6 "> </ a > < span class ="s2 "> "arrivals"</ span > < span class ="p "> :</ span > < span class ="p "> {</ span >
1381+ < a id ="__codelineno-4 -7 " name ="__codelineno-4 -7 " href ="#__codelineno-4 -7 "> </ a > < span class ="s2 "> "P"</ span > < span class ="p "> :</ span > < span class ="mf "> 1727123829.20</ span > < span class ="p "> ,</ span >
1382+ < a id ="__codelineno-4 -8 " name ="__codelineno-4 -8 " href ="#__codelineno-4 -8 "> </ a > < span class ="s2 "> "S"</ span > < span class ="p "> :</ span > < span class ="mf "> 1727123844.03</ span >
1383+ < a id ="__codelineno-4 -9 " name ="__codelineno-4 -9 " href ="#__codelineno-4 -9 "> </ a > < span class ="p "> }</ span >
1384+ < a id ="__codelineno-4 -10 " name ="__codelineno-4 -10 " href ="#__codelineno-4 -10 "> </ a > < span class ="p "> }</ span >
13561385</ code > </ pre > </ div >
13571386< hr />
13581387< h2 id ="trace-header-management-in-surfquake "> Trace Header Management in SurfQuake</ h2 >
@@ -1377,8 +1406,8 @@ <h2 id="best-practices">Best Practices</h2>
13771406< li > Pick and reference data are stored in-memory and optionally exported to CSV.</ li >
13781407< li > Ensure that when traces are saved or passed between steps, < code > trace.stats</ code > is retained.</ li >
13791408< li > You can inspect or modify these attributes using standard Python syntax:
1380- < div class ="highlight "> < pre > < span > </ span > < code > < a id ="__codelineno-4 -1 " name ="__codelineno-4 -1 " href ="#__codelineno-4 -1 "> </ a > < span class ="n "> trace</ span > < span class ="o "> .</ span > < span class ="n "> stats</ span > < span class ="o "> .</ span > < span class ="n "> picks</ span > < span class ="o "> .</ span > < span class ="n "> append</ span > < span class ="p "> ({</ span > < span class ="o "> ...</ span > < span class ="p "> })</ span >
1381- < a id ="__codelineno-4 -2 " name ="__codelineno-4 -2 " href ="#__codelineno-4 -2 "> </ a > < span class ="n "> trace</ span > < span class ="o "> .</ span > < span class ="n "> stats</ span > < span class ="o "> .</ span > < span class ="n "> references</ span > < span class ="o "> =</ span > < span class ="p "> []</ span >
1409+ < div class ="highlight "> < pre > < span > </ span > < code > < a id ="__codelineno-5 -1 " name ="__codelineno-5 -1 " href ="#__codelineno-5 -1 "> </ a > < span class ="n "> trace</ span > < span class ="o "> .</ span > < span class ="n "> stats</ span > < span class ="o "> .</ span > < span class ="n "> picks</ span > < span class ="o "> .</ span > < span class ="n "> append</ span > < span class ="p "> ({</ span > < span class ="o "> ...</ span > < span class ="p "> })</ span >
1410+ < a id ="__codelineno-5 -2 " name ="__codelineno-5 -2 " href ="#__codelineno-5 -2 "> </ a > < span class ="n "> trace</ span > < span class ="o "> .</ span > < span class ="n "> stats</ span > < span class ="o "> .</ span > < span class ="n "> references</ span > < span class ="o "> =</ span > < span class ="p "> []</ span >
13821411</ code > </ pre > </ div > </ li >
13831412</ ul >
13841413< hr />
0 commit comments