Changes for page FDSN Guide

Last modified by robert on 2025/03/24 12:02

From version 2.3
edited by robert
on 2025/03/24 10:21
Change comment: There is no comment for this version
To version 4.4
edited by robert
on 2025/03/24 12:02
Change comment: There is no comment for this version

Summary

Details

Page properties
Content
... ... @@ -4,8 +4,17 @@
4 4  
5 5  = [[How to Install ObsPy>>url:https://github.com/obspy/obspy/wiki#installation]] =
6 6  
7 -= [[Seed-Vault>>https://github.com/AuScope/seed-vault]] =
7 += FDSN Tools =
8 8  
9 +(% class="wikigeneratedid" id="HSeed-Vault" %)
10 +[[Seed-Vault>>https://github.com/AuScope/seed-vault]]
11 +
12 +[[PyWeed>>https://github.com/iris-edu/pyweed]]
13 +
14 +[[ObsPy get_waveforms_bulk>>https://docs.obspy.org/packages/autogen/obspy.clients.fdsn.client.Client.get_waveforms_bulk.html]]
15 +
16 +[[IRISfetch.m>>https://ds.iris.edu/ds/nodes/dmc/software/downloads/irisfetch.m/]]
17 +
9 9  = Connecting to an FDSN Server =
10 10  
11 11  == How to connect to AusPass with & without authenticated access ==
... ... @@ -27,24 +27,51 @@
27 27  
28 28  = Station Metadata =
29 29  
30 -Information such as site locations, sensor and data logger types, response information, etc are in the station metadata. This can be accessed directly(link) or via the obspy get_stations (link) tool.
39 +Information such as site locations, sensor and data logger types, response information, etc are in the station metadata. This can be accessed [[directly>>http://auspass.edu.au/fdsnws/station/1/builder]] or via the [[ObsPy get_stations>>https://docs.obspy.org/packages/autogen/obspy.clients.fdsn.client.Client.get_stations.html]] code.
31 31  
32 32  
33 -== Sub-paragraph ==
42 +== How to download event, station, instrument response ==
34 34  
35 -Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.
36 36  
37 -=== Sub-sub paragraph ===
45 +{{code language="python"}}
46 +import obspy
47 +from obspy.clients.fdsn import Client
38 38  
39 -Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.
49 +# Use AusPass client for station, waveform, and earthquake information
50 +client = Client("AUSPASS")
40 40  
41 41  
53 +# Download station information for AUMTC station in S1 network at the response level
54 +inv = client.get_stations(network="S1", station="AUMTC", location="*",
55 + channel="*", level="response")
56 +
57 +# Inventory metadata is stored in a Inventory > Network > Station > Channel hierarchy
58 +
59 +print(inv) #inventory level
60 +
61 +print(inv[0]) # network level (the first network in the inventory)
62 +
63 +print(inv[0][0]) # station level (the first station of the first network in the inventory)
64 +
65 +print(inv[0][0][0]) # channel level (the first channel of the first station of the first network in the inventoy)
66 +
67 +# you can also select items directly
68 +
69 +print(inv.select(station='AUMTC',channel='HHZ')[0][0][0])
70 +
71 +# instrument response is attached to a channel object
72 +
73 +response = inv.select(station='AUMTC',channel='HHZ')[0][0][0].response
74 +{{/code}}
75 +
42 42  = Waveform Data =
43 43  
44 -Waveform data (e.g. the actual seismic data) can be accessed directly (link) or via obspy's get_waveforms (link) tool. It can also be accessed via various tools such as seed-vault, pyweed, etc (add links).
78 +Waveform data (e.g. the actual seismic data) can be accessed [[directly>>https://auspass.edu.au/fdsnws/dataselect/1/builder]] or via [[ObsPy's get_waveforms>>https://docs.obspy.org/packages/autogen/obspy.clients.fdsn.client.Client.get_waveforms.html]] code. It can also be accessed via various tools such as seed-vault, pyweed, etc (add links).
45 45  
46 -== How to download waveform data ==
80 +== Downloading and Storing data ==
47 47  
82 +=== How to download waveform data ===
83 +
48 48  {{code language="python"}}
49 49  from obspy import UTCDateTime
50 50  from obspy.clients.fdsn import Client
... ... @@ -66,9 +66,75 @@
66 66  print("Downloaded and saved the MiniSEED file.")
67 67  {{/code}}
68 68  
69 -== How to remove instrument response ==
105 +=== How to download a LOT of waveform data ===
70 70  
71 71  {{code language="python"}}
108 +from obspy import UTCDateTime
109 +from obspy.clients.fdsn import Client
110 +import datetime
111 +
112 +# Initialize client and set parameters
113 +client = Client("IRIS")
114 +start_date = UTCDateTime("2023-07-01")
115 +end_date = UTCDateTime("2023-07-02")
116 +network = "S1"
117 +station = "AUMTS"
118 +channel = "BHZ"
119 +
120 +# Loop to download data one day at a time
121 +while start_date <= end_date:
122 + next_date = start_date + datetime.timedelta(days=1)
123 + try:
124 + st = client.get_waveforms(network, station, "*", channel, start_date, next_date)
125 + st.write(f"{start_date.date}.mseed", format="MSEED")
126 + except:
127 + print(f"Failed for {start_date} to {next_date}")
128 + start_date = next_date
129 +{{/code}}
130 +
131 +=== How to store and archive waveform data in SeisComP Data Structure (SDS) ===
132 +
133 +{{code language="python"}}
134 +import os
135 +from obspy import UTCDateTime, read
136 +from obspy.clients.fdsn import Client
137 +
138 +# Initialize the client
139 +client = Client("AUSPASS") # Replace with the correct client endpoint if different
140 +
141 +# Define event time and time window
142 +event_time = UTCDateTime("2021-09-21T23:15:53")
143 +starttime = event_time - 600 # 10 minutes before the event
144 +endtime = event_time + 1800 # 30 minutes after the event
145 +
146 +# Download the waveform data
147 +st = client.get_waveforms(network="S1", station="AUMTS", location="*", channel="*", starttime=starttime, endtime=endtime)
148 +
149 +# Create SDS structure: ROOT/YEAR/NET/STA/CHAN.TYPE/NET.STA.LOC.CHAN.YEAR.DAY
150 +sds_root = "." # Replace with your desired directory
151 +
152 +for tr in st:
153 + net = tr.stats.network
154 + sta = tr.stats.station
155 + loc = tr.stats.location
156 + chan = tr.stats.channel
157 + year = str(tr.stats.starttime.year)
158 + jday = str(tr.stats.starttime.julday).zfill(3)
159 +
160 + sds_path = os.path.join(sds_root, year, net, sta, f"{chan}.D", f"{net}.{sta}.{loc}.{chan}.{year}.{jday}")
161 +
162 + # Create directories if they don't exist
163 + os.makedirs(os.path.dirname(sds_path), exist_ok=True)
164 +
165 + # Save the trace as a MiniSEED file
166 + tr.write(sds_path, format="MSEED")
167 +{{/code}}
168 +
169 +== Common Data Operations ==
170 +
171 +=== How to remove instrument response ===
172 +
173 +{{code language="python"}}
72 72  from obspy import read
73 73  from obspy.core.util import AttribDict
74 74  
... ... @@ -90,7 +90,7 @@
90 90  st.write("Woodspoint_2021_corrected.mseed", format="MSEED")
91 91  {{/code}}
92 92  
93 -== How to apply a bandpass filter ==
195 +=== How to apply a bandpass filter ===
94 94  
95 95  {{code language="python"}}
96 96  from obspy import read
... ... @@ -110,7 +110,7 @@
110 110  st.write("Woodspoint_2021_filtered.mseed", format="MSEED")
111 111  {{/code}}
112 112  
113 -== How to slice a waveform ==
215 +=== How to slice a waveform ===
114 114  
115 115  {{code language="python"}}
116 116  from obspy import read, UTCDateTime, Stream # Importing Stream here
... ... @@ -132,7 +132,7 @@
132 132  sliced_st.write("Woodspoint_2021_filtered_sliced.mseed", format="MSEED")
133 133  {{/code}}
134 134  
135 -== How to save a waveform ==
237 +=== How to save a waveform ===
136 136  
137 137  {{code language="python"}}
138 138  # Save the sliced file as MiniSEED
... ... @@ -142,7 +142,7 @@
142 142  sliced_st.write("Woodspoint_2021_filtered_sliced.sac", format="SAC")
143 143  {{/code}}
144 144  
145 -== How to convert miniseed to sac ==
247 +=== How to convert miniSEED to SAC ===
146 146  
147 147  {{code language="python"}}
148 148  from obspy import read
... ... @@ -157,9 +157,9 @@
157 157  tr.write("Woodspoint_2021.sac", format="SAC")
158 158  {{/code}}
159 159  
160 -
161 161  = Earthquake Data =
162 162  
264 +Earthquake data can be accessed [[directly>>https://auspass.edu.au/fdsnws/event/1/builder]] or via [[ObsPy's get_events>>https://docs.obspy.org/packages/autogen/obspy.clients.fdsn.client.Client.get_events.html]] code
163 163  
164 164  == How to download an Earthquake Catalog ==
165 165