Name | sfisop-datamodels JSON |
Version |
1.0.1
JSON |
| download |
home_page | None |
Summary | Basic time series data models for the Smart Ocean platform |
upload_time | 2025-02-05 12:04:26 |
maintainer | None |
docs_url | None |
author | Smart Ocean WP3 |
requires_python | <4.0.0,>=3.9 |
license | None |
keywords |
|
VCS |
|
bugtrack_url |
|
requirements |
No requirements were recorded.
|
Travis-CI |
No Travis.
|
coveralls test coverage |
No coveralls.
|
# SmartOcean timeseries data model
The purpose of the data model is to support the exchange of time series data in particular exchange of fragments of data
associated with time series delivered by the SFI Smart Ocean Platform: https://smartoceanplatform.github.io/
The data model is implemented based on the Pydantic framework: https://docs.pydantic.dev/latest/
# Standards
The `parameter` and `unit` in the `Observation` class is to follow the Copernicus Marine in-situ TAC physical parameters list:
https://archimer.ifremer.fr/doc/00422/53381/
The `qualityCodes` is to follow the recommendations for in-situ data Near Real Time Quality Control:
https://archimer.ifremer.fr/doc/00251/36230/
The `time` object variable in the `Datapoint` class is to follow the ISO8601 standard and include timezone information.
# Example of use
The code below provides an example of ow to use the classes of the library.
```python
from sfisop.datamodels.tsdatamodel.timeseriesdata import *
a_location = Location(latitude=5.0, longitude=65)
meta_data = MetaData(description="test time series",
timeseries="timeseries_testdata",
origin="timeseries_testdata")
observation = Observation(source="test sensor",
source_id="test sensor id",
parameter="temperature",
value="5.0",
unit="celcius",
qualityCodes=[0])
data_point = DataPoint(dp_id="datapoint id",
source="test sensor hub",
source_id="test sensor hub id",
location=a_location,
time="2024-02-17T20:12:49.559547+01:00",
observations=[observation])
data_points = [data_point]
ts_data = TimeSeriesData(format="SMARTOCEAN_V1",
metadata=meta_data,
data=data_points)
```
The utility functions implemented in the `tsdata_utils.py` and `timeseriesdata.py` is to be used for serialisation and de-serialisation of time series data.
Further documentation can be found on the SFI Smart Ocean platform web pages: https://smartoceanplatform.github.io/interoperability/
Raw data
{
"_id": null,
"home_page": null,
"name": "sfisop-datamodels",
"maintainer": null,
"docs_url": null,
"requires_python": "<4.0.0,>=3.9",
"maintainer_email": null,
"keywords": null,
"author": "Smart Ocean WP3",
"author_email": null,
"download_url": "https://files.pythonhosted.org/packages/19/ee/94db776919903cf9317bf572c546efb9a65d8d6a03b02875dd79e19c9346/sfisop_datamodels-1.0.1.tar.gz",
"platform": null,
"description": "# SmartOcean timeseries data model\n\nThe purpose of the data model is to support the exchange of time series data in particular exchange of fragments of data \nassociated with time series delivered by the SFI Smart Ocean Platform: https://smartoceanplatform.github.io/ \n\nThe data model is implemented based on the Pydantic framework: https://docs.pydantic.dev/latest/\n\n# Standards\n\nThe `parameter` and `unit` in the `Observation` class is to follow the Copernicus Marine in-situ TAC physical parameters list:\n\nhttps://archimer.ifremer.fr/doc/00422/53381/\n\nThe `qualityCodes` is to follow the recommendations for in-situ data Near Real Time Quality Control:\n\nhttps://archimer.ifremer.fr/doc/00251/36230/\n\n\nThe `time` object variable in the `Datapoint` class is to follow the ISO8601 standard and include timezone information.\n\n# Example of use\n\nThe code below provides an example of ow to use the classes of the library.\n\n```python\nfrom sfisop.datamodels.tsdatamodel.timeseriesdata import *\n\na_location = Location(latitude=5.0, longitude=65)\n\nmeta_data = MetaData(description=\"test time series\",\n timeseries=\"timeseries_testdata\",\n origin=\"timeseries_testdata\")\n\nobservation = Observation(source=\"test sensor\",\n source_id=\"test sensor id\",\n parameter=\"temperature\",\n value=\"5.0\",\n unit=\"celcius\",\n qualityCodes=[0])\n\ndata_point = DataPoint(dp_id=\"datapoint id\",\n source=\"test sensor hub\",\n source_id=\"test sensor hub id\",\n location=a_location,\n time=\"2024-02-17T20:12:49.559547+01:00\",\n observations=[observation])\n\ndata_points = [data_point]\n\nts_data = TimeSeriesData(format=\"SMARTOCEAN_V1\",\n metadata=meta_data,\n data=data_points)\n```\n\nThe utility functions implemented in the `tsdata_utils.py` and `timeseriesdata.py` is to be used for serialisation and de-serialisation of time series data.\n\nFurther documentation can be found on the SFI Smart Ocean platform web pages: https://smartoceanplatform.github.io/interoperability/\n\n",
"bugtrack_url": null,
"license": null,
"summary": "Basic time series data models for the Smart Ocean platform",
"version": "1.0.1",
"project_urls": null,
"split_keywords": [],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "84e6ff7e4f9ad1a9b9988a732ee1e4bcead3691f1ee1250b57d070711d2a61f0",
"md5": "e2f2601301ae3fdbbc0420c172666211",
"sha256": "6e1195fbb2e3b395d75c0fa677c389dac52a64dab861d73cdd455c690b66df9b"
},
"downloads": -1,
"filename": "sfisop_datamodels-1.0.1-py3-none-any.whl",
"has_sig": false,
"md5_digest": "e2f2601301ae3fdbbc0420c172666211",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": "<4.0.0,>=3.9",
"size": 4734,
"upload_time": "2025-02-05T12:04:24",
"upload_time_iso_8601": "2025-02-05T12:04:24.602096Z",
"url": "https://files.pythonhosted.org/packages/84/e6/ff7e4f9ad1a9b9988a732ee1e4bcead3691f1ee1250b57d070711d2a61f0/sfisop_datamodels-1.0.1-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "19ee94db776919903cf9317bf572c546efb9a65d8d6a03b02875dd79e19c9346",
"md5": "a43c54d74d390ff392c302816d51c5ff",
"sha256": "77347f03088e99384afbb252a40b4d4c76eecf5be476ecf78070b251b9720c21"
},
"downloads": -1,
"filename": "sfisop_datamodels-1.0.1.tar.gz",
"has_sig": false,
"md5_digest": "a43c54d74d390ff392c302816d51c5ff",
"packagetype": "sdist",
"python_version": "source",
"requires_python": "<4.0.0,>=3.9",
"size": 3375,
"upload_time": "2025-02-05T12:04:26",
"upload_time_iso_8601": "2025-02-05T12:04:26.475591Z",
"url": "https://files.pythonhosted.org/packages/19/ee/94db776919903cf9317bf572c546efb9a65d8d6a03b02875dd79e19c9346/sfisop_datamodels-1.0.1.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-02-05 12:04:26",
"github": false,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"lcname": "sfisop-datamodels"
}