Kshell-utilities

- `partition_editor`: Proton and neutron configurations are sorted by lexicographical order.

- `compare.py` has been implemented (thanks to johashei !) for various comparisons of different KSHELL runs. See the Wiki for how-to: [KSHELL wiki](https://github.com/GaffaSnobb/kshell/wiki/Compare-data-from-different-KSHELL-runs)
- `edit_and_queue_executables` now supports entering new parameters once and applying it to several .sh files instead of having to re-enter the parameters for every .sh file.
- `partition_editor` has been implemented, letting the user edit existing .ptn files to analyse existing configurations or to add new configurations.
- `mixing_ratio` has been implemented. It calculated the mixing of E2 and M1.
- Imports annotations from `future` so that Python versions older than 3.11 are supported.

- Add `inspect_log` function.
- `loadtxt(path)` now automatically calls `collect_logs` if no summary is located in `path`. Thus, `path` should now point to the directory containing the log files, not point to a specific file.
- `loadtxt` no longer returns a list, but instead just a single object.

- Incorporate `collect_logs` with input handling and support for new and old log file syntax
- Default values to gsf, and some changes to default plotting, like legend, units and grid, and added `save_plot` option.
- `save_plot` option for nld
- Status print for `collect_logs`
- Add option for using total level density instead of partial in gsf
- Implement warnings for when "wrong" function parameters are chosen
- Pass `initial_or_final` and `partial_or_total` through all the wrappers
- `include_only_nonzero_in_average` parameter in gsf function and all wrappers
- Implement global debug parameter and flags dict. loadtxt and gsf prints time usage
- Write a README to the `tmp/` directory which explains the contents
- Bar plot for `get_timing_data`
- loadtxt `is_directory` is currently deprecated due to lack of testing after other implementations and changes
- Script editing functionality with `edit_and_queue_executables`
- `include_n_states` in gsf. Update loadtxt to include `idx_i` and `idx_f`
- Progress printing with timing when loading from summary file to .npy
- Shell model diagram plot with `nuclear_shell_model` function
- Option to return Porter-Thomas counter from `gamma_strength_function_average` function
- Implement transit and level read test for JEM syntax summaries
- Save gsf, bins, n_transitions to .npy. Move plotting from `general_utilities` to `kshell_utilities`.
- Spin and parity filter for NLD
- Implement angular momentum distribution method
- Add nucleus_latex property
- Implement Porter-Thomas analysis over j values
- Implement B_distribution plot method
- Implement B_distribution save to file
- Implement index filter in B_distribution
- BXL values for a given level are now normalised by the mean of only the BXL values of that level. Previously, all BXL values were normalised to the mean of all BXL values.

- Read the total memory usage during calculation from a collection of log files with `get_memory_usage`.
- Generate a unique SHA identifier for all saved `.npy` files to differentiate between several similar runs of, for example, V50 in the GXPF1A interaction. The SHA identifier is generated based on the entire `.sh` file generated by `kshell_ui.py`.
- Get all the KSHELL Fortran parameters from the `.sh` file with the `get_parameters` function.
- KSHELL Fortran parameters are included as a property to the `ReadKshellOutput` class. `res.parameters`
- `ReadKshellOutput` attribute `Ex` is removed. Slice `levels` instead.
- `ReadKshellOutput` attribute `transitions` is removed. Transitions of different multipolarity must be treated independently, so there is no point in storing them all in a large array.
- `ReadKshellOutput` attribute `BM1` and `BE2` are removed. Slice `transitions_BXY` instead.
- Parallel reading of summary files. BE1, BM1, BE2 values are read in parallel for a (modest) speedup of reading huge summary files.
- Update summary file read to accommodate changes in `collect_logs` and `transit.F90` in the KSHELL repo.
- Implement `old_or_new` parameter to `loadtxt` to support old style syntax summary files.
- Update tests according to these changes.

- Add `gamma_strength_function_average_plot` wrapper method to the `ReadKshellOutput` class. Add `gsf` method alias.
- Add `_get_timing_data` which extracts and returns the total run time (in seconds) from a single KSHELL log file. Add `get_timing_data` which is a wrapper for `_get_timing_data` which handles path to a directory or path to a single summary file. Also read trunc log files.
- Add a reduced version of `count_dim.py` from the KSHELL repo to this package to be able to count dimensions.
- Add tests for `spin_parity_list` and tests for checking all values in `res.transitions`.