Last Release Before Refactor

Summary

This is the last release before the qcore refactor, and it covers about two years of changes since 1.3. Note that the tag 2025.12.01 points at a September 2025 commit. It changes cb_amp_multi, shared.get_stations and geo.oriented_bearing_wrt_normal, and removes several modules.

Breaking changes

• Site amplification was reworked (#357):
  • cb_amp_multi takes a dataframe of sites and no longer interpolates in frequency. Call cb2014_to_fas_amplification_factors afterwards.
  • The bandpass and passband filter options were removed from bwfilter.
• shared.get_stations(locations=True) returns latitudes before longitudes, the order the old workflow expects (#325).
• Removed modules:
  • gmt (#353). Its resources moved to pygmt_helper.
  • gsf (#345) and the bounding-box modules (#342).
  • mpl and shakemap_grid (#313).
  • wgs_nztm2000x (#308).
• Removed LFSeis (#347). Use timeseries.read_lfseis_directory, which returns an xarray Dataset.
• Removed geo.ll_cross_track_dist and geo.InputError (#313).
• Data files are no longer downloaded on install (#320, #348). They are fetched on demand with pooch, and the NHM model is downloaded automatically (#356).
• Enums were changed to StrEnum (#350).

Bug fixes

• Broadband failed with LF nstat != HF nstat: LF seis reading kept empty station rows (#340).
• geo.oriented_bearing_wrt_normal returned 0° where the answer was 180° (#326).
• validate_vm_bounds now checks SRF corners in NZTM rather than in lat/lon (#333).
• Fixes for numpy 2 (#332), the imp module removal (#309) and GMT 6.3 file naming (#291, #292).

Features

• Added the coordinates module for NZTM/WGS conversions, distances and bearing corrections (#310, #319, #330), plus spherical projections (#354).
• Added the grid module with mesh grids and patch grids (#312, #335, #337, #346).
• Source-to-site distances (src_site_dist) moved here from IM_calculation (#323).
• Added geo.point_to_segment_distance (#339) and cli.from_docstring (#344, #352).
• Added a new xyts timeslice API (#307, #355) and multi-site vectorised ampdeamp with FFTW (#357).

---

Contains all changes since the last update to the refactor.

What's Changed

• np.float deprecated, need to use np.float64 instead by @jpa198 in #286
• Adding common code by @joelridden in #287
• Set database by @jpa198 in #288
• Amplification uncertainty by @jpa198 in #289
• Fix for GMT-6.3 issue adding -0 suffix to file name in the output text by @sungeunbae in #291
• Fixed a bug introduced by GMT-6.3 related fix (#291) by @sungeunbae in #292
• Adding memory per node by @joelridden in #293
• Untied Empirical from rrup by @sungeunbae in #294
• Correct tool location for Nurion (/scratch) by @sungeunbae in #295
• Added a support for loading station file of random format by @sungeunbae in #296
• Point in Polygon by @joelridden in #297
• Add functions to compute the closest points between planes in 3D by @lispandfound in #300
• Custom filename by @joelridden in #302
• Add oriented bearing function by @lispandfound in #305
• Improve xyts module by @lispandfound in #307
• Add gsf module by @lispandfound in #303
• Delete wgs_nztm2000x by @lispandfound in #308
• Make coordinate transformations more flexible by @lispandfound in #310
• Fix "no module named imp" by @lispandfound in #309
• Add grid module by @lispandfound in #312
• General qcore cleanup by @lispandfound in #313
• Rewrite closest points code by @lispandfound in #311
• Add bounding box + tests + wiki by @lispandfound in #314
• Cleanup distributions module by @lispandfound in #315
• Fix GMT land optimisation by @lispandfound in #317
• Update install requires by @lispandfound in #318
• Add coordinate distance function by @lispandfound in #319
• Extract data download by @joelridden in #320
• Better docstrings by @lispandfound in #322
• Source to site calculation moved from IM_calculation repo by @sungeunbae in #323
• Updating rrup test by @sungeunbae in #324
• Swap latitude and longitude returns by @lispandfound in #325
• Improve documentation and raise errors for coords by @lispandfound in #321
• Use numpy<2 by @lispandfound in #327
• Fix the Oriented Bearing Function by @lispandfound in #326
• Optional[A | B] is not supported in old Python by @sungeunbae in #328
• Use raw strings for space separators by @lispandfound in #329
• Add Bearing Correction Functions for NZTM and Great-circle Geometry by @lispandfound in #330
• Support for Mahuika Milan nodes by @sungeunbae in #331
• Fix : np.unicode_ was removed in the Numpy2.0 release. by @sungeunbae in #332
• seis2txt() was renamed to timeseries_to_text() but still referenced by @sungeunbae in #334
• Validate vm bounds by @sungeunbae in #333
• New Workflow Changes by @lispandfound in #335
• Use find_packages to find packages by @lispandfound in #336
• Explicit gridpoints by @lispandfound in #337
• Changing order of (x, y, depth) in nztm_to_wgs_depth docstring for consistency by @AndrewRidden-Harper in #338
• Add the ability to compute point -> line segment distances by @lispandfound in #339
• Remove stations with an empty unicode name by @sungeunbae in #340
• Remove bounding box modules by @lispandfound in #342
• Scientific Data Registry by @lispandfound in #341
• Add requirements.txt check by @lispandfound in #343
• Add docstring extraction decorator by @lispandfound in #344
• Remove GSF Module by @lispandfound in #345
• Use pooch for downloaded data by @lispandfound in #348
• Patchgrid Improvement by @lispandfound in #346
• Use which instead of find_executable by @lispandfound in #349
• Change enum type to StrEnum by @lispandfound in #350
• Remove LFSeis by @lispandfound in #347
• Add kwargs to from_docstring decorator by @lispandfound in #352
• Remove gmt.py module by @claudio525 in #353
• Automatically download the NHM model if not already present by @lispandfound in #356
• Spherical coordinate projections by @lispandfound in #354
• Improve the timeslice functionality of qcore.xyts by @lispandfound in #355
• Vectorise and test broadband manipulation functions by @lispandfound in #357

New Contributors

• @lispandfound made their first contribution in #300
• @AndrewRidden-Harper made their first contribution in #338

Full Changelog: 1.3...2025.12.01