-
Notifications
You must be signed in to change notification settings - Fork 10
/
POLAR.README
95 lines (75 loc) · 5.55 KB
/
POLAR.README
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
-----------------------------------------------------------------------------------------------------------------------
Incorporated Research Institutions for Seismology (IRIS)
Data Management Center (DMC)
Data Products Team
Noise Toolkit PDF/PSD scripts package
v.2.1.1 2021-09-07
-----------------------------------------------------------------------------------------------------------------------
Copyright (C) 2021 Product Team, IRIS Data Management Center
This package is provided by the IRIS DMC Data Products Team WITHOUT ANY WARRANTY AND/OR SUPPORT
This is a free software; you can redistribute it and/or modify
it under the terms of the GNU Lesser General Public License as
published by the Free Software Foundation; either version 3 of the
License, or (at your option) any later version.
This script is distributed in the hope that it will be useful, but
WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
Lesser General Public License (GNU-LGPL) for more details. The
GNU-LGPL and further information can be found here:
http://www.gnu.org/
You should have received a copy of the GNU Affero General Public License
along with this program. If not, see <http://www.gnu.org/licenses/>.
DESCRIPTION:
This package contains a series of Python 3 scripts to:
- read waveforms for given network/station/location/channels from local files
- request/read waveforms for given network/station/location/channels using the obspy FDSN client
- compute and populate an hourly "Polarization database"
- extract PSDs and PDFs from the "Polarization database"
INSTALLATION:
see INSTALL.txt
RUNNING THE SCRIPTS:
see the package SeisCode Wiki page for instructions and examples:
https://github.com/iris-edu/noise-toolkit/wiki/Noise-Toolkit-Polarization-Attributes-package-V.2
NOTES
- for more information:
.visit data product's web page at:
http://ds.iris.edu/ds/products/noise-toolkit-polarization/
.visit data product's Wiki page at:
https://github.com/iris-edu/noise-toolkit/wiki/Noise-Toolkit-Polarization-Attributes-package-V.2
HISTORY
- 2021-09-07 v.2.1.1: The qc_3c_stream function now uses trace stats information directly. Still follows the
old code's QC logic but now records are created based on the trace stats.
- 2021-08-31 v.2.1.0: This patch addresses the output file naming issue when data were read from files.
The bug was causing output to be written under the same file name. This patch also makes
some PEP 8 style fixes and adds the script version to the log file.
- 2020-11-16 v.2.0.0: Python 3, use of Fedcatalog and adoption of PEP 8 style guide
- 2017-01-18 v.0.6.5: support for reading data and metadata from files only with no Internet requirement
- 2016-11-01 v.0.6.0: added support for obtaining channel responses from local station XML response files by
introducing the following two functions in tsLIB.py:
getResponseInventory - to build a list of response inventories under a given met directory
getResponseFromFile - to find response for a given Network, Station, Location and channel
added respDirectory to common.py parameter file to disable looking for response files on
local drives, set this parameter to None. Otherwise, set it to the response directory path
- 2016-01-25 v.0.5.1: added user and password parameters to common.par and ntk_computePSD.py in support of
restricted data access
- 2015-09-02 v.0.5.0: ready for release
- 2015-06-16: updated based on the latest ntk_computePSD.py
- 2015-04-07: added check for all parameter values to inform user if they are not defined. Corrected the instrument
correction for SAC files that would apply sensitivity in addition to instrument correction
- 2015-04-06: addressed the variable maximum period issue that was changing based on the smoothing window length
- 2015-04-02: based on feedback from Robert Anthony, in addition to nan values other non-numeric values may exist.
The write that contains a flot() conversion is placed in a try block so we can catch any non-numeric
conversion issue and report it as user-defined NAN
- 2015-03-30: added a check to number of samples to avoid log of zero (reported by Rob Anthony)
- 2015-03-17: added the "waterLevel" parameter to provide user with more control on how the ObsPy module shrinks
values under water-level of max spec amplitude when removing the instrument response.
- 2015-02-24: introduced two new parameters (performInstrumentCorrection, applyScale) to allow user avoid
instrument correction also now user can turn od decon. filter
- 2014-10-22: added support for Windows installation
- 2014-05-20: added some informative message about data retrieval
changed format to output each channel to a separate directory and save files
under DOY in preparation for PQLX-type output
- 2014-03-19: added option to read waveforms from file
- 2014-01-29: created as part of the Noise Toolkit product
COMMENTS/QUESTIONS:
Please contact [email protected]