deepcontrail-core 0.1.0__tar.gz

deepcontrail_core-0.1.0/LICENSE

@@ -0,0 +1,211 @@
+Copyright (c) 2026 EUROCONTROL
+
+# European Union Public Licence v. 1.2
+
+EUPL © the European Union 2007, 2016
+
+This European Union Public Licence (the *EUPL*) applies to the Work (as defined below) which is provided under the
+terms of this Licence. Any use of the Work, other than as authorised under this Licence is prohibited (to the extent such
+use is covered by a right of the copyright holder of the Work).
+The Work is provided under the terms of this Licence when the Licensor (as defined below) has placed the following
+notice immediately following the copyright notice for the Work:
+
+*Licensed under the EUPL or has expressed by any other means his willingness to license under the EUPL.*
+
+## 1. Definitions
+
+In this Licence, the following terms have the following meaning:
+
+* *The Licence*:this Licence.
+* *The Original Work*:the work or software distributed or communicated by the Licensor under this Licence, available
+as Source Code and also as Executable Code as the case may be.
+* *Derivative Works*:the works or software that could be created by the Licensee, based upon the Original Work or
+modifications thereof. This Licence does not define the extent of modification or dependence on the Original Work
+required in order to classify a work as a Derivative Work; this extent is determined by copyright law applicable in
+the country mentioned in Article 15.
+* *The Work*:the Original Work or its Derivative Works.
+* *The Source Code*:the human-readable form of the Work which is the most convenient for people to study and
+modify.
+* *The Executable Code*:any code which has generally been compiled and which is meant to be interpreted by
+a computer as a program.
+* *The Licensor*:the natural or legal person that distributes or communicates the Work under the Licence.
+* *Contributor(s)*:any natural or legal person who modifies the Work under the Licence, or otherwise contributes to
+the creation of a Derivative Work.
+* *The Licensee* or *You*:any natural or legal person who makes any usage of the Work under the terms of the
+Licence.
+* *Distribution* or *Communication*:any act of selling, giving, lending, renting, distributing, communicating,
+transmitting, or otherwise making available, online or offline, copies of the Work or providing access to its essential
+functionalities at the disposal of any other natural or legal person.
+
+## 2. Scope of the rights granted by the Licence
+
+The Licensor hereby grants You a worldwide, royalty-free, non-exclusive, sublicensable licence to do the following, for
+the duration of copyright vested in the Original Work:
+
+* use the Work in any circumstance and for all usage,
+* reproduce the Work,
+* modify the Work, and make Derivative Works based upon the Work,
+* communicate to the public, including the right to make available or display the Work or copies thereof to the public
+and perform publicly, as the case may be, the Work,
+* distribute the Work or copies thereof,
+* lend and rent the Work or copies thereof,
+* sublicense rights in the Work or copies thereof.
+Those rights can be exercised on any media, supports and formats, whether now known or later invented, as far as the
+applicable law permits so.
+In the countries where moral rights apply, the Licensor waives his right to exercise his moral right to the extent allowed
+by law in order to make effective the licence of the economic rights here above listed.
+The Licensor grants to the Licensee royalty-free, non-exclusive usage rights to any patents held by the Licensor, to the
+extent necessary to make use of the rights granted on the Work under this Licence.
+
+## 3. Communication of the Source Code
+
+The Licensor may provide the Work either in its Source Code form, or as Executable Code. If the Work is provided as
+Executable Code, the Licensor provides in addition a machine-readable copy of the Source Code of the Work along with
+each copy of the Work that the Licensor distributes or indicates, in a notice following the copyright notice attached to
+the Work, a repository where the Source Code is easily and freely accessible for as long as the Licensor continues to
+distribute or communicate the Work.
+
+## 4. Limitations on copyright
+
+Nothing in this Licence is intended to deprive the Licensee of the benefits from any exception or limitation to the
+exclusive rights of the rights owners in the Work, of the exhaustion of those rights or of other applicable limitations
+thereto.
+
+## 5. Obligations of the Licensee
+
+The grant of the rights mentioned above is subject to some restrictions and obligations imposed on the Licensee. Those
+obligations are the following:
+
+**Attribution right**: The Licensee shall keep intact all copyright, patent or trademarks notices and all notices that refer to
+the Licence and to the disclaimer of warranties. The Licensee must include a copy of such notices and a copy of the
+Licence with every copy of the Work he/she distributes or communicates. The Licensee must cause any Derivative Work
+to carry prominent notices stating that the Work has been modified and the date of modification.
+
+**Copyleft clause**: If the Licensee distributes or communicates copies of the Original Works or Derivative Works, this
+Distribution or Communication will be done under the terms of this Licence or of a later version of this Licence unless
+the Original Work is expressly distributed only under this version of the Licence — for example by communicating
+*EUPL v. 1.2 only*. The Licensee (becoming Licensor) cannot offer or impose any additional terms or conditions on the
+Work or Derivative Work that alter or restrict the terms of the Licence.
+
+**Compatibility clause**: If the Licensee Distributes or Communicates Derivative Works or copies thereof based upon both
+the Work and another work licensed under a Compatible Licence, this Distribution or Communication can be done
+under the terms of this Compatible Licence. For the sake of this clause, *Compatible Licence* refers to the licences listed
+in the appendix attached to this Licence. Should the Licensee's obligations under the Compatible Licence conflict with
+his/her obligations under this Licence, the obligations of the Compatible Licence shall prevail.
+
+**Provision of Source Code**: When distributing or communicating copies of the Work, the Licensee will provide
+a machine-readable copy of the Source Code or indicate a repository where this Source will be easily and freely available
+for as long as the Licensee continues to distribute or communicate the Work.
+Legal Protection: This Licence does not grant permission to use the trade names, trademarks, service marks, or names
+of the Licensor, except as required for reasonable and customary use in describing the origin of the Work and
+reproducing the content of the copyright notice.
+
+## 6. Chain of Authorship
+
+The original Licensor warrants that the copyright in the Original Work granted hereunder is owned by him/her or
+licensed to him/her and that he/she has the power and authority to grant the Licence.
+Each Contributor warrants that the copyright in the modifications he/she brings to the Work are owned by him/her or
+licensed to him/her and that he/she has the power and authority to grant the Licence.
+Each time You accept the Licence, the original Licensor and subsequent Contributors grant You a licence to their contributions
+to the Work, under the terms of this Licence.
+
+## 7. Disclaimer of Warranty
+
+The Work is a work in progress, which is continuously improved by numerous Contributors. It is not a finished work
+and may therefore contain defects or *bugs* inherent to this type of development.
+For the above reason, the Work is provided under the Licence on an *as is* basis and without warranties of any kind
+concerning the Work, including without limitation merchantability, fitness for a particular purpose, absence of defects or
+errors, accuracy, non-infringement of intellectual property rights other than copyright as stated in Article 6 of this
+Licence.
+This disclaimer of warranty is an essential part of the Licence and a condition for the grant of any rights to the Work.
+
+## 8. Disclaimer of Liability
+
+Except in the cases of wilful misconduct or damages directly caused to natural persons, the Licensor will in no event be
+liable for any direct or indirect, material or moral, damages of any kind, arising out of the Licence or of the use of the
+Work, including without limitation, damages for loss of goodwill, work stoppage, computer failure or malfunction, loss
+of data or any commercial damage, even if the Licensor has been advised of the possibility of such damage. However,
+the Licensor will be liable under statutory product liability laws as far such laws apply to the Work.
+
+## 9. Additional agreements
+
+While distributing the Work, You may choose to conclude an additional agreement, defining obligations or services
+consistent with this Licence. However, if accepting obligations, You may act only on your own behalf and on your sole
+responsibility, not on behalf of the original Licensor or any other Contributor, and only if You agree to indemnify,
+defend, and hold each Contributor harmless for any liability incurred by, or claims asserted against such Contributor by
+the fact You have accepted any warranty or additional liability.
+
+## 10. Acceptance of the Licence
+
+The provisions of this Licence can be accepted by clicking on an icon *I agree* placed under the bottom of a window
+displaying the text of this Licence or by affirming consent in any other similar way, in accordance with the rules of
+applicable law. Clicking on that icon indicates your clear and irrevocable acceptance of this Licence and all of its terms
+and conditions.
+Similarly, you irrevocably accept this Licence and all of its terms and conditions by exercising any rights granted to You
+by Article 2 of this Licence, such as the use of the Work, the creation by You of a Derivative Work or the Distribution
+or Communication by You of the Work or copies thereof.
+
+## 11. Information to the public
+
+In case of any Distribution or Communication of the Work by means of electronic communication by You (for example,
+by offering to download the Work from a remote location) the distribution channel or media (for example, a website)
+must at least provide to the public the information requested by the applicable law regarding the Licensor, the Licence
+and the way it may be accessible, concluded, stored and reproduced by the Licensee.
+
+## 12. Termination of the Licence
+
+The Licence and the rights granted hereunder will terminate automatically upon any breach by the Licensee of the terms
+of the Licence.
+Such a termination will not terminate the licences of any person who has received the Work from the Licensee under
+the Licence, provided such persons remain in full compliance with the Licence.
+
+## 13. Miscellaneous
+
+Without prejudice of Article 9 above, the Licence represents the complete agreement between the Parties as to the
+Work.
+If any provision of the Licence is invalid or unenforceable under applicable law, this will not affect the validity or
+enforceability of the Licence as a whole. Such provision will be construed or reformed so as necessary to make it valid
+and enforceable.
+The European Commission may publish other linguistic versions or new versions of this Licence or updated versions of
+the Appendix, so far this is required and reasonable, without reducing the scope of the rights granted by the Licence.
+New versions of the Licence will be published with a unique version number.
+All linguistic versions of this Licence, approved by the European Commission, have identical value. Parties can take
+advantage of the linguistic version of their choice.
+
+## 14. Jurisdiction
+
+Without prejudice to specific agreement between parties,
+
+* any litigation resulting from the interpretation of this License, arising between the European Union institutions,
+bodies, offices or agencies, as a Licensor, and any Licensee, will be subject to the jurisdiction of the Court of Justice
+of the European Union, as laid down in article 272 of the Treaty on the Functioning of the European Union,
+* any litigation arising between other parties and resulting from the interpretation of this License, will be subject to
+the exclusive jurisdiction of the competent court where the Licensor resides or conducts its primary business.
+
+## 15. Applicable Law
+
+Without prejudice to specific agreement between parties,
+
+* this Licence shall be governed by the law of the European Union Member State where the Licensor has his seat,
+resides or has his registered office,
+* this licence shall be governed by Belgian law if the Licensor has no seat, residence or registered office inside
+a European Union Member State.
+
+## Appendix
+
+*Compatible* Licences according to Article 5 EUPL are:
+
+* GNU General Public License (GPL) v. 2, v. 3
+* GNU Affero General Public License (AGPL) v. 3
+* Open Software License (OSL) v. 2.1, v. 3.0
+* Eclipse Public License (EPL) v. 1.0
+* CeCILL v. 2.0, v. 2.1
+* Mozilla Public Licence (MPL) v. 2
+* GNU Lesser General Public Licence (LGPL) v. 2.1, v. 3
+* Creative Commons Attribution-ShareAlike v. 3.0 Unported (CC BY-SA 3.0) for works other than software
+* European Union Public Licence (EUPL) v. 1.1, v. 1.2
+* Québec Free and Open-Source Licence — Reciprocity (LiLiQ-R) or Strong Reciprocity (LiLiQ-R+).
+The European Commission may update this Appendix to later versions of the above licences without producing
+a new version of the EUPL, as long as they provide the rights granted in Article 2 of this Licence and protect the
+covered Source Code from exclusive appropriation.
+All other changes or additions to this Appendix require the production of a new EUPL version.

deepcontrail_core-0.1.0/PKG-INFO

@@ -0,0 +1,149 @@
+Metadata-Version: 2.4
+Name: deepcontrail-core
+Version: 0.1.0
+Summary: DeepContrail core — torch-free dataset config, spectral bands, composites, splits and metrics.
+Keywords: contrails,remote-sensing,satellite,GOES
+Author: EUROCONTROL
+License-Expression: EUPL-1.2
+License-File: LICENSE
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Science/Research
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Scientific/Engineering :: Image Processing
+Requires-Dist: numpy>=1.24
+Requires-Dist: pillow>=10.0
+Requires-Dist: pydantic>=2.0
+Requires-Dist: pyyaml>=6.0
+Requires-Python: >=3.11
+Project-URL: Homepage, https://github.com/eurocontrol-asu/deepcontrail
+Project-URL: Documentation, https://github.com/eurocontrol-asu/deepcontrail/tree/main/packages/core#readme
+Project-URL: Repository, https://github.com/eurocontrol-asu/deepcontrail
+Project-URL: Issues, https://github.com/eurocontrol-asu/deepcontrail/issues
+Project-URL: Changelog, https://github.com/eurocontrol-asu/deepcontrail/blob/main/CHANGELOG.md
+Description-Content-Type: text/markdown
+
+# deepcontrail-core
+
+Torch-free foundations of [DeepContrail](https://github.com/eurocontrol-asu/deepcontrail): the
+**dataset format** every task reads, its validation, false-colour composites built from named
+bands, the train/validation/fold partition, and Dice/IoU metrics.
+
+Depends only on numpy, Pillow, pydantic and PyYAML. `import deepcontrail.core` never imports torch.
+
+```bash
+pip install deepcontrail-core
+```
+
+## The DeepContrail dataset format (version 1)
+
+The library reads this layout and nothing else. Any producer can write it; for OpenContrails
+the [converter](https://github.com/eurocontrol-asu/deepcontrail/tree/main/tools/opencontrails) does.
+
+```
+<root>/
+├── metadata/dataset_info.json               required: source, record counts, labels, pixel shift
+├── spectral_bands/bands.json                required: what each channel of the arrays holds
+├── spectral_bands/{train,test}/<id>.npy     required: (H, W, C) float32, e.g. brightness temperatures (K)
+├── semantic_masks/{train,test}/<id>.png     binary consensus mask: 0 background, 255 contrail (1 accepted)
+├── probability_masks/{train,test}/<id>.npy  (H, W) float32 annotator agreement in [0, 1]
+├── annotator_masks/{train,test}/<id>.npy    (H, W, A) uint8 {0, 1}, one mask per annotator
+├── instance_masks/{train,test}/<id>.npy     (N, H, W, A) int8: 1 = pixel of instance n for annotator a,
+│                                             0 = not, -1 = instance not drawn by that annotator
+├── images_semantic/{train,test}/<id>.jpg    optional preview for people; never read by the library
+└── splits_{train,test}.txt                  optional: the labelled ids of each split
+```
+
+- **Splits.** `test/` is a holdout. The validation set is drawn from `train/` at load time:
+  the sorted ids are shuffled with the seed and the first `val_fraction` go to validation (or
+  k-fold with `fold` / `num_folds`). Training runs record the exact lists and their fingerprints.
+- **Ids** are unique across splits and used as written: any file name is a valid id.
+- **Context frames** (unlabelled neighbouring time steps of a scene) exist only in a dataset
+  that declares `"temporal": true` in `dataset_info.json`. There, `<id>_b<k>.npy` /
+  `<id>_a<k>.npy` (k steps before / after scene `<id>`, which must exist) are context frames
+  and need no labels. In any other dataset every file is a scene, so an id such as `tile_a1`
+  is an ordinary scene.
+- **Labels** are only required for the task at hand: `semantic` for segmentation, `instance`
+  for instance segmentation. Every label kind declared in `dataset_info.json` must cover every
+  labelled scene, at the size of its spectral array.
+
+All JSON and text files (`bands.json`, `dataset_info.json`, `splits_*.txt`) must be UTF-8 encoded.
+
+### `spectral_bands/bands.json`
+
+```json
+{
+  "format_version": 1,
+  "sensor": "GOES-16 ABI",
+  "dtype": "float32",
+  "channels": [
+    {"index": 0, "key": "data_10um", "units": "K", "sensor_band": "13", "wavelength_um": 10.33},
+    {"index": 1, "key": "data_11um", "units": "K", "sensor_band": "14", "wavelength_um": 11.19}
+  ]
+}
+```
+
+`key` (unique, snake_case) is the name configs use; `index` is the channel's position. The
+optional `sensor_band`, `wavelength_um`, `name` and `derived_from` (`[a, b]` for a channel
+stored as `a - b`) describe the band for people; the library never interprets them. Another
+sensor declares its own keys (for example `ir_105`, `ir_123` for MTG FCI).
+
+### `metadata/dataset_info.json`
+
+```json
+{
+  "format_version": 1,
+  "source": "OpenContrails GOES-16 ABI TFRecords",
+  "records": {"train": 20088, "test": 1879},
+  "labels": ["semantic", "probability", "annotator", "instance"],
+  "recommended_pixel_shift": 0.0
+}
+```
+
+`recommended_pixel_shift` is the shift (pixels, right and down) that aligns the images with the
+masks, or `null` if unknown. The data config's `pixel_shift` should use it; a dataset warns when
+they differ.
+
+Optional fields:
+- `temporal` (`true`/`false`): whether the dataset stores context frames (see **Context
+  frames** above). Absent means `false`.
+- `export`, `naming`, `pixel_shift_note`: provenance notes for people (for OpenContrails: the
+  export date, how files are named, why the shift is what it is); the library does not read
+  them.
+
+Read both with `read_band_manifest(root)` and `read_dataset_info(root)`; a missing or invalid file
+raises `DatasetContractError` naming the file.
+
+Instance masks are read with `deepcontrail.core.readers.load_instance_masks(path)`, which raises
+`ValueError` on an array that is not in the format above; `extract_all_annotator_instances(raw)`
+turns one into each annotator's list of boolean contrail masks.
+
+## Composites
+
+A composite is three channels built from named bands, each one band or the difference of two,
+scaled from `bounds` to [0, 1]. The recipe lives in the experiment config:
+
+```yaml
+data:
+  false_color:
+    channels:
+      - {bands: [data_12um, data_11um], bounds: [-4, 2]}    # R
+      - {bands: [data_11um, cloud_top], bounds: [-4, 5]}    # G
+      - {bands: [data_11um],            bounds: [243, 303]} # B
+```
+
+`false_color_from_spectral(bands, recipe, manifest)` builds it; a band key the dataset does not
+declare is an error listing the available keys.
+
+## Validation
+
+```bash
+deepcontrail-validate <root> [--task segmentation|instance] [--deep]
+```
+
+The default checks read only the metadata and the file names (seconds): both metadata files,
+the task's labels, every labelled scene has its labels and no label lacks its scene, record
+counts and split lists. `--deep` also reads every file: arrays load with the declared channels
+and finite values, masks match their scene's size and hold valid values, all scenes share one
+size. It exits non-zero on any issue. From Python: `validate_dataset(root, task=..., deep=...)`.

deepcontrail_core-0.1.0/README.md

@@ -0,0 +1,123 @@
+# deepcontrail-core
+
+Torch-free foundations of [DeepContrail](https://github.com/eurocontrol-asu/deepcontrail): the
+**dataset format** every task reads, its validation, false-colour composites built from named
+bands, the train/validation/fold partition, and Dice/IoU metrics.
+
+Depends only on numpy, Pillow, pydantic and PyYAML. `import deepcontrail.core` never imports torch.
+
+```bash
+pip install deepcontrail-core
+```
+
+## The DeepContrail dataset format (version 1)
+
+The library reads this layout and nothing else. Any producer can write it; for OpenContrails
+the [converter](https://github.com/eurocontrol-asu/deepcontrail/tree/main/tools/opencontrails) does.
+
+```
+<root>/
+├── metadata/dataset_info.json               required: source, record counts, labels, pixel shift
+├── spectral_bands/bands.json                required: what each channel of the arrays holds
+├── spectral_bands/{train,test}/<id>.npy     required: (H, W, C) float32, e.g. brightness temperatures (K)
+├── semantic_masks/{train,test}/<id>.png     binary consensus mask: 0 background, 255 contrail (1 accepted)
+├── probability_masks/{train,test}/<id>.npy  (H, W) float32 annotator agreement in [0, 1]
+├── annotator_masks/{train,test}/<id>.npy    (H, W, A) uint8 {0, 1}, one mask per annotator
+├── instance_masks/{train,test}/<id>.npy     (N, H, W, A) int8: 1 = pixel of instance n for annotator a,
+│                                             0 = not, -1 = instance not drawn by that annotator
+├── images_semantic/{train,test}/<id>.jpg    optional preview for people; never read by the library
+└── splits_{train,test}.txt                  optional: the labelled ids of each split
+```
+
+- **Splits.** `test/` is a holdout. The validation set is drawn from `train/` at load time:
+  the sorted ids are shuffled with the seed and the first `val_fraction` go to validation (or
+  k-fold with `fold` / `num_folds`). Training runs record the exact lists and their fingerprints.
+- **Ids** are unique across splits and used as written: any file name is a valid id.
+- **Context frames** (unlabelled neighbouring time steps of a scene) exist only in a dataset
+  that declares `"temporal": true` in `dataset_info.json`. There, `<id>_b<k>.npy` /
+  `<id>_a<k>.npy` (k steps before / after scene `<id>`, which must exist) are context frames
+  and need no labels. In any other dataset every file is a scene, so an id such as `tile_a1`
+  is an ordinary scene.
+- **Labels** are only required for the task at hand: `semantic` for segmentation, `instance`
+  for instance segmentation. Every label kind declared in `dataset_info.json` must cover every
+  labelled scene, at the size of its spectral array.
+
+All JSON and text files (`bands.json`, `dataset_info.json`, `splits_*.txt`) must be UTF-8 encoded.
+
+### `spectral_bands/bands.json`
+
+```json
+{
+  "format_version": 1,
+  "sensor": "GOES-16 ABI",
+  "dtype": "float32",
+  "channels": [
+    {"index": 0, "key": "data_10um", "units": "K", "sensor_band": "13", "wavelength_um": 10.33},
+    {"index": 1, "key": "data_11um", "units": "K", "sensor_band": "14", "wavelength_um": 11.19}
+  ]
+}
+```
+
+`key` (unique, snake_case) is the name configs use; `index` is the channel's position. The
+optional `sensor_band`, `wavelength_um`, `name` and `derived_from` (`[a, b]` for a channel
+stored as `a - b`) describe the band for people; the library never interprets them. Another
+sensor declares its own keys (for example `ir_105`, `ir_123` for MTG FCI).
+
+### `metadata/dataset_info.json`
+
+```json
+{
+  "format_version": 1,
+  "source": "OpenContrails GOES-16 ABI TFRecords",
+  "records": {"train": 20088, "test": 1879},
+  "labels": ["semantic", "probability", "annotator", "instance"],
+  "recommended_pixel_shift": 0.0
+}
+```
+
+`recommended_pixel_shift` is the shift (pixels, right and down) that aligns the images with the
+masks, or `null` if unknown. The data config's `pixel_shift` should use it; a dataset warns when
+they differ.
+
+Optional fields:
+- `temporal` (`true`/`false`): whether the dataset stores context frames (see **Context
+  frames** above). Absent means `false`.
+- `export`, `naming`, `pixel_shift_note`: provenance notes for people (for OpenContrails: the
+  export date, how files are named, why the shift is what it is); the library does not read
+  them.
+
+Read both with `read_band_manifest(root)` and `read_dataset_info(root)`; a missing or invalid file
+raises `DatasetContractError` naming the file.
+
+Instance masks are read with `deepcontrail.core.readers.load_instance_masks(path)`, which raises
+`ValueError` on an array that is not in the format above; `extract_all_annotator_instances(raw)`
+turns one into each annotator's list of boolean contrail masks.
+
+## Composites
+
+A composite is three channels built from named bands, each one band or the difference of two,
+scaled from `bounds` to [0, 1]. The recipe lives in the experiment config:
+
+```yaml
+data:
+  false_color:
+    channels:
+      - {bands: [data_12um, data_11um], bounds: [-4, 2]}    # R
+      - {bands: [data_11um, cloud_top], bounds: [-4, 5]}    # G
+      - {bands: [data_11um],            bounds: [243, 303]} # B
+```
+
+`false_color_from_spectral(bands, recipe, manifest)` builds it; a band key the dataset does not
+declare is an error listing the available keys.
+
+## Validation
+
+```bash
+deepcontrail-validate <root> [--task segmentation|instance] [--deep]
+```
+
+The default checks read only the metadata and the file names (seconds): both metadata files,
+the task's labels, every labelled scene has its labels and no label lacks its scene, record
+counts and split lists. `--deep` also reads every file: arrays load with the declared channels
+and finite values, masks match their scene's size and hold valid values, all scenes share one
+size. It exits non-zero on any issue. From Python: `validate_dataset(root, task=..., deep=...)`.

deepcontrail_core-0.1.0/pyproject.toml

@@ -0,0 +1,54 @@
+[project]
+name = "deepcontrail-core"
+version = "0.1.0"
+description = "DeepContrail core — torch-free dataset config, spectral bands, composites, splits and metrics."
+readme = "README.md"
+requires-python = ">=3.11"
+license = "EUPL-1.2"
+license-files = ["LICENSE"]
+keywords = [
+    "contrails",
+    "remote-sensing",
+    "satellite",
+    "GOES",
+]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Intended Audience :: Science/Research",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Topic :: Scientific/Engineering :: Image Processing",
+]
+dependencies = [
+    "numpy>=1.24",
+    "pillow>=10.0",
+    "pydantic>=2.0",
+    "pyyaml>=6.0",
+]
+
+[[project.authors]]
+name = "EUROCONTROL"
+
+[project.scripts]
+deepcontrail-validate = "deepcontrail.core.validate:main"
+
+[project.urls]
+Homepage = "https://github.com/eurocontrol-asu/deepcontrail"
+Documentation = "https://github.com/eurocontrol-asu/deepcontrail/tree/main/packages/core#readme"
+Repository = "https://github.com/eurocontrol-asu/deepcontrail"
+Issues = "https://github.com/eurocontrol-asu/deepcontrail/issues"
+Changelog = "https://github.com/eurocontrol-asu/deepcontrail/blob/main/CHANGELOG.md"
+
+[dependency-groups]
+dev = [
+    "pytest>=7.4",
+    "pyright>=1.1",
+]
+
+[build-system]
+requires = ["uv_build>=0.10.2,<0.14.0"]
+build-backend = "uv_build"
+
+[tool.uv.build-backend]
+module-name = "deepcontrail.core"

deepcontrail_core-0.1.0/pyproject.toml.orig

@@ -0,0 +1,44 @@
+[project]
+name = "deepcontrail-core"
+version = "0.1.0"
+description = "DeepContrail core — torch-free dataset config, spectral bands, composites, splits and metrics."
+readme = "README.md"
+requires-python = ">=3.11"
+license = "EUPL-1.2"
+license-files = ["LICENSE"]
+authors = [{ name = "EUROCONTROL" }]
+keywords = ["contrails", "remote-sensing", "satellite", "GOES"]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Intended Audience :: Science/Research",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Topic :: Scientific/Engineering :: Image Processing",
+]
+dependencies = [
+    "numpy>=1.24",
+    "pillow>=10.0",
+    "pydantic>=2.0",
+    "pyyaml>=6.0",
+]
+
+[project.scripts]
+deepcontrail-validate = "deepcontrail.core.validate:main"
+
+[project.urls]
+Homepage = "https://github.com/eurocontrol-asu/deepcontrail"
+Documentation = "https://github.com/eurocontrol-asu/deepcontrail/tree/main/packages/core#readme"
+Repository = "https://github.com/eurocontrol-asu/deepcontrail"
+Issues = "https://github.com/eurocontrol-asu/deepcontrail/issues"
+Changelog = "https://github.com/eurocontrol-asu/deepcontrail/blob/main/CHANGELOG.md"
+
+[dependency-groups]
+dev = ["pytest>=7.4", "pyright>=1.1"]
+
+[build-system]
+requires = ["uv_build>=0.10.2,<0.14.0"]
+build-backend = "uv_build"
+
+[tool.uv.build-backend]
+module-name = "deepcontrail.core"

deepcontrail_core-0.1.0/src/deepcontrail/core/__init__.py

@@ -0,0 +1,49 @@
+"""Shared, torch-free foundations: dataset format, config, composites, splits, metrics."""
+
+from importlib.metadata import version
+
+from deepcontrail.core.config import DatasetConfig
+from deepcontrail.core.contract import (
+    BandChannel,
+    BandManifest,
+    DatasetContractError,
+    DatasetInfo,
+    read_band_manifest,
+    read_dataset_info,
+)
+from deepcontrail.core.false_color import (
+    FalseColorChannel,
+    FalseColorConfig,
+    check_false_color,
+    false_color_from_spectral,
+    load_spectral_false_color,
+)
+from deepcontrail.core.metrics import dice_coefficient, iou_score
+from deepcontrail.core.splits import context_frames, partition_stems, split_fingerprint
+from deepcontrail.core.validate import Issue, ValidationReport, validate_dataset
+
+__version__ = version("deepcontrail-core")
+
+__all__ = [
+    "BandChannel",
+    "BandManifest",
+    "DatasetConfig",
+    "DatasetContractError",
+    "DatasetInfo",
+    "FalseColorChannel",
+    "FalseColorConfig",
+    "Issue",
+    "ValidationReport",
+    "__version__",
+    "check_false_color",
+    "context_frames",
+    "dice_coefficient",
+    "false_color_from_spectral",
+    "iou_score",
+    "load_spectral_false_color",
+    "partition_stems",
+    "read_band_manifest",
+    "read_dataset_info",
+    "split_fingerprint",
+    "validate_dataset",
+]