Tracktable 1.7.0

THIS RELEASE HAS BEEN SUPERSEDED

The packaging code in this release has fatal flaws that result in wheels that can't be imported. Don't use it. Use 1.7.1 (coming very soon) instead.

Tracktable 1.7.0

Welcome back!

Updates

Most of the work in this release is in the build and test infrastructure to make our development practices more sustainable. We've added the following user-facing features:

• Maps in Folium can now be created with the attr and crs
  parameters. The attr argument is used to pass an attribution string
  for custom tile sets. The crs argument names a coordinate transform
  to project geographical points into pixel coordinates and back. The
  functions tracktable.render.render_trajectories.render_trajectories()
  and tracktable.render.render_heatmap.render_heatmap() both support these
  new arguments.

• Trajectory maps in Folium can be animated. See the arguments animate,
  anim_display_update_interval, anim_trail_duration, and use_markers
  in tracktable.render.render_trajectories.render_trajectories().

• New function tracktable.rw.load.load_trajectories() that will load a
  .traj, .csv, or .tsv file and assemble points into trajectories.
  An optional flag will cause it to return points instead of trajectories.
  Examples that load trajectories or points have been updated to use this
  feature.

• Sea ports and airports can be rendered into maps for both the Cartopy
  and Folium back ends.

• Docs and data have been separated out into their own repositories
  implemented as submodules. Note that you will need to git clone --recursive
  when cloning the source code. The tracktable-data package should be installed
  as a dependency when you install with pip or from conda-forge.

Full details are available in the https://tracktable.readthedocs.io.

Files in this release

Here's what's in this release:

• Wheels
  • Windows: Python 3.8 - 3.11
  • MacOS Intel: Python 3.8 - 3.11
  • MacOS Arm64: Python 3.9 - 3.11
  • Linux: Python 3.6 - 3.11
  • Remember to grab the tracktable-data wheel as well
• Pre-Built Documentation
  • For this, you want the file tracktable-1.7.0-docs.tar.gz (or .tar.bz2 or .zip). The file tracktable-1.7.0-src-docs.tar.gz is NOT the user-facing documentation.
• Source Code: Source plus sample data is getting big so we split the repository. Here are your options:
  • Everything at once: tracktable-1.7.0-src-everything.tar.gz (or .tar.bz2 or .zip)
  • Just the source code (not enough to build): tracktable-1.7.0-src.tar.gz (or .tar.bz2 or .zip)
  • Documentation source repository: tracktable-1.7.0-src-docs.tar.gz (or .tar.bz2 or .zip)
  • Sample data: tracktable-1.7.0-data.tar.gz (or .tar.bz2 or .zip)

We expect the source to change much more quickly than the sample data and documentation, which is why we split the repositories.

For any questions, please write to tracktable-questions at sandia dot gov or open an issue in this repository.