- Removed online format support (online events, timeslices and summary slices) in favour of the KM3io.jl <https://git.km3net.de/common/KM3io.jl>`__ Julia Package.
- uproot 5 and awkward 2 are now required
- Python 3.7+ required
- A few astro helpers were added: azimuth(), zenith(), phi(), theta(), ...
- Deprecation fixes
- Minor changes
- API stabilised and v1 is now LTS
gSeaGen
reader removed, only supported until v0.29.2
- Hotfix for AwkwardArray 2.0 incompatibility, now restricted to be <2.0
- Added
codemeta.json
to the MANIFEST
- Update km3net-definitions to 3.0.0
- Update km3net-definitions to 2.2.0-16-gbef370c
- Fixed
km3io.tools.fitinf()
which always returned the 0th element
- Added dockerisation
- Fixes the issue where files procued with newer Jpp v17+ versions errored due to a header_uuid[16] field
- Adds the TimeConverter class to
src/km3io/tools.py
- Update km3net-dataformat requirement to version 0.3.6 or higher
- Update Black requirement to version 22.3.0 or higher, to prevent
ImportError: cannot import name '_unicodefun' from 'click'
- Remove
requirements
folder (all requirements are now configured insetup.cfg
)
- The warning from OpenMP/Numba is now silenced
- Added
km3io.tools.is_nanobeacon()
to check if the nanobeacon trigger bit is set - Added
km3io.tools.get_w2list_idx()
to get the w2list index according to the simulation program
- Fixes the version
- the
.counter
field formc_trks/mc_tracks
is now accessible
- uproot 4.2.2+ required, which fixes a regression problem when reading doubly nested structures
- Added a new, high-performance Summaryslice reader
km3io.online.SummarysliceReader
- The old
km3io.OnlineReader.summarslices
is now using the newSummarysliceReader
which has a slightly different API (but at least an order of magnitude better performance and much nicer high-level API thanks to AwkwardArrays)
- The
km3io.tools.is_bit_set()
and all the related trigger mask checkers (is_3dmuon()
...) are now compatible with Numba
- The field
.a
(amplitude) for Hits is now accessible
- KM3NeT Dataformat definition updated to 2.1.0+
km3io.acoustics
was added which providesRawAcousticsReader
to read -- wait for it -- raw acoustics data
- Added
km3io.tools.is_bit_set()
along with some special methods to check if a giventrigger_mask
(of an event or a hit) has a specific trigger bit set, viakm3io.tools.is_3dmuon
,km3io.tools.is_3dshower
andkm3io.tools.is_mxshower
km3net-dataformat
updated to v2.0.0-9-gbae3720- mother ID and status are now read out for MC tracks
- The fields
.tdc
,.pos_{xyz}
and.dir_{xyz}
in.hits
are now read by default.
- Improved header readout
- Adds access to
mc_event_time
- Fixed parsing error when a MC header contains invalid attribute names.
- Added
Branch.arrays()
for high-level access ofuproot.TBranch.arrays()
- Suppress FutureWarnings from uproot3
- Minor hotfixes and cosmetics
- Major update, coming closer to v1.0
- Now everything but the online-file access is based on uproot4 and awkward1
- Contact us if you encounter any problem after upgrading!
- Fixed imports due to the rename of uproot to uproot3, uproot4 to uproot, awkward to awkward0 and awkward1 to awkward
- Notice: the
best_track*()
functions are currently broken due to changes in awkward which has not been fixed yet
- A new tool
km3io.tools.is_cc()
has been added which can be used to check if the events are of type CC
- Requires
awkward1>=0.3.1
from now on (fixes an array-shape mismatch bug)
- Final ;)
km3io.tools.best_track
implementation which provides many different ways to chose the one and only "best track". - Similar to
km3net-dataformat/scripts/reconstruction.hh
, the following functions can be used to retrieve the best track according to the "standard definitions":km3io.tools.best_jmuon
,best_jshower
,best_dusjshower
andbest_aashower
- Adds
.uuid
attributes toOfflineReader
andOnlineReader
- Fixed a bug in
Branch.is_single
- Fixed the inconsistency of
len()
of mapped branches See https://git.km3net.de/km3py/km3io/-/issues/39#note_18429 - Introduced
Branch.is_single
to check if a single branch is selected
- Fixed a tiny bug in
km3io.tools.best_track
- Improved
km3io.tools.best_track
which now works nicely when passing events and improves the error reporting tracks.usr
is now hidden (again) from the user
- Updated KM3NeT definitions to v1.2.4
- Fixed a bug where the last bit of HRV or FIFO were incorrectly
masked when using
km3io.online.get_channel_flags
- Added wheel packages for faster installation
- Added reverse maps for index lookup of definitions
km3io.definitions.fitparameters_idx
etc.
- Improved caching for awkward arrays in pumps
- Improved caching for awkward arrays
events.mc_tracks.usr
andevents.mc_tracks.usr_names
are now correctly parsed
km3io.tools.unique
andkm3io.tools.uniquecount
were added to help working with unique elements (e.g. DOM IDs or channel IDs)- Internal restructuring of
.tools
, ROOT related stuff is moved to.rootio
- Added
.close()
to the Offline and Online reader classes - The Offline and Online reader classes now support context managers
(
with km3io.OfflineReader(filename) as r: ...
)
- DAQ was renamed to online
- Several improviements, bugfixes etc.
- The offline I/O has been refactored and now supports slicing à la numpy
- Added support for gSeaGen files
- Added support for the
usr
field of events
- The times of snapshot and triggered hits were parsed as big endian (standard) ROOT endianness, however, Jpp stores that as little endian with a custom streamer. This is now fixed...
- minor fixes
- update of reco data from offline files
- Documentation on how to read DAQ data
- Offline file headers are now accessible
- Reading of summary slice status information is now supported
- Bugfixes
- Fixes slicing of
OfflineTracks
- Minor cleanup
- Jpp things were renamed to DAQ things (;
- Reading of summary slices is done!
- Cosmetics
- Massive update of the aanet data format reader
- First timeslice frame readout prototype
- Preliminary Jpp timeslice reader prototype
- Updated
AanetReader
- Updated docs
- Updated docs
JppReader
added, which is able to read events!
- First release
- Prototype implementation of the
AanetReader