v2.4.0

webknossos

Breaking Changes

• Dataset.shallow_copy_dataset does not symlink layers, mags and attachments anymore. Instead mags and attachments are referenced by their path. #1290
• Deprecated a number of methods #1290:
  • Dataset.add_symlink_layer, use Dataset.add_layer_as_ref instead.
  • Dataset.add_remote_layer, use Dataset.add_layer_as_ref instead (renamed).
  • Dataset.add_copy_layer, use Dataset.add_layer_as_copy instead (renamed).
  • Layer.add_symlink_mag, use Layer.add_mag_as_ref instead.
  • Layer.add_remote_mag, use Layer.add_mag_as_ref instead (renamed).
  • Layer.add_copy_mag, use Layer.add_mag_as_copy instead (renamed).
  • Attachments.add_symlink_attachments, use Attachments.add_attachment_as_ref instead (note the singular form).
  • Attachments.add_attachments, use Attachments.add_attachment_as_ref instead (note the singular form).
  • Attachments.add_copy_attachments, use Attachments.add_attachment_as_copy instead (note the singular form).
• Dataset.add_layer and Dataset.add_layer_like as well as derived methods do not eagerly create a folder for the layer anymore. Folders will be created, if necessary, when mags or attachments are added. #1290

Changed

• Changed the default path type to UPath #1326
• All mags now store their path in the datasource-properties.json file. This eliminates the need for symlinks and removes the need to check multiple possible mag paths (e.g. 1-1-1 or 1). It also unifies local and remote mags. #1290
• Dataset-local mags and attachments use the ./ prefix for their path in compliance with IETF RFC1808. #1290