{ "info": { "author": "e-WindLidar", "author_email": "e-windlidar@googlegroups.com", "bugtrack_url": null, "classifiers": [], "description": "[![PyPI version](https://badge.fury.io/py/lidaco.svg)](https://badge.fury.io/py/lidaco)\n\n# Lidaco \n\nLidaco (Wind **Li**dar **Da**ta **Co**nverter) is a library and executable that enables a modular writing of data converters. \n\nFollowing the configurations that are specified by the user on a config.yml(s), a Reader module is selected to import the data from input files.\nSimilarly, a Writer is also selected to write the output file(s).\n\n \nLidaco works on datasets that can be described using the unidata [Common Data Model](https://www.unidata.ucar.edu/software/thredds/current/netcdf-java/CDM/). It can be used to process single files or entire folders. \n\n\n##### Available Readers\n * AQ500\n * Galion\n * WLS70\n * Windcubev1\n * Windcubev2\n * Windscanner\n * ZephIR300\n * Triton\n \n##### Available Writers\n * MetadataCard\n * NcML\n * NetCDF4\n\n\n## Getting started\n\n##### Install\n```bash\npip install lidaco\n```\n\n##### Run in the command line (shell)\n```bash\nlidaco --config-file=samples/Windscanner/config.yaml\n```\n\n##### Use as a library\n```python\nfrom lidaco.core.Builder import Builder\n\nbuilder = Builder(config_file = 'path/to/config.yaml')\nbuilder.build()\n```\n\n## Converting data\n\n####\n\n\n\n#### Writing conversion files\n\nEach conversion requires a configuration file written in [YAML](http://yaml.org/). This file contains four (optional) main groups of configurations:\n###### Parameters\n\nThis section allows you to specify the parameters for the converter itself, the selected reader and or writer.\nThe converter parameters are: \n```yaml\nparameters:\n input: \n path: ./path/to/input/folder/\n format: Windscanner # The name should match \n output: \n path: ./path/to/output/folder # optional, defaults to ./output/\n format: NetCDF4\n \n # Optional, and specifies the number of input files to be concatenated per output file.\n # If not specified defaults to 1 (1 output per input file). The last output will contain <= output_block_size input files.\n # If the parameter is specified with None (the same as without any value), all input files will be concatenated into a single output file.\n output_block_size: 3\n```\nSome of these parameters can be overridden using the command arguments, run `lidaco --help` to know them.\n\nWhen specifying relative paths, the configuration file location wherein these are specified, or the current directory when specifying them as command arguments, is the one used to resolve its absolute value.\n\nAdditional parameters might be necessary depending on the specific reader/writer in use. Read the respective module documentation available, or try to take a look at its source code.\n \n###### Attributes\nThis section specify the global attributes that will be added to the dataset. You can add all attributes you desire. \n```yaml\nattributes:\n # e.g.,\n lidar_technology: 'pulsed'\n lidar_scanning_type: 'vertical profiling'\n data_processing_history: 'data taken from .scn files generated by ...'\n```\n###### Variables\n\nThis section is similar to *Attributes* but instead of reading being used to specify Attributes, it is used to specify variables.\n```yaml\nvariables: \n # e.g.,\n pitch:\n data_type: 'f4'\n units: 'degrees'\n long_name: 'lidar_pitch_angle'\n comment: ''\n accuracy: ''\n accuracy_info: 'No information on pitch accuracy available.'\n value: 0\n```\n\n\n###### Imports\nLidaco configuration system is built to motivate the configurations reusability, so each config file can import others. With this mechanism you can to split your configurations into devices, scenarios, campaigns and so on.\nIn case of multiple definitions of an attribute or variable, the definitions in the file prevail over the others that are imported.\n\n```yaml\nimports: # read in order\n - ./general/NEWA_Kassel_general_dataset.yaml\n - ./instruments/Windcubev2_general_instrument_description.yaml\n - ./processing/NEWA_Kassel_data_processing_history.yaml\n```\n\n\nFor more examples on how to setup your config files, take a look at the available\n[Samples](https://github.com/e-WindLidar/Lidaco/tree/master/samples).\n\n\n--------------\n\n\n### Contributing\nIf you would like to add, or see being added, some change to the converter you can:\n\n * [Open an issue](https://github.com/e-WindLidar/Lidaco/issues) so that it is discussed by everyone.\n * And/or also [Submit a pull request](https://github.com/e-WindLidar/Lidaco/pulls) with the desired changes. ([About pull requests](https://help.github.com/articles/about-pull-requests/))\n\n##### To submit a new Reader/Writer\n * Create a python class at lidaco.readers or lidaco.writers, if you are writing a reader or writer respectively.\n * The file and class should have the same name, that will be used in the config files. \n * It should extend core.reader or core.writer.\n \n Take a look at the existing [readers](https://github.com/e-WindLidar/Lidaco/blob/master/lidaco/readers/) and [writers](https://github.com/e-WindLidar/Lidaco/blob/master/lidaco/writers/).", "description_content_type": "text/markdown", "docs_url": null, "download_url": "", "downloads": { "last_day": -1, "last_month": -1, "last_week": -1 }, "home_page": "https://github.com/e-WindLidar/Lidaco", "keywords": "wind,lidar,data,converter", "license": "", "maintainer": "", "maintainer_email": "", "name": "lidaco", "package_url": "https://pypi.org/project/lidaco/", "platform": "", "project_url": "https://pypi.org/project/lidaco/", "project_urls": { "Homepage": "https://github.com/e-WindLidar/Lidaco" }, "release_url": "https://pypi.org/project/lidaco/0.0.28/", "requires_dist": null, "requires_python": "", "summary": "Wind Lidar Data Converter.", "version": "0.0.28" }, "last_serial": 4387976, "releases": { "0.0.12": [ { "comment_text": "", "digests": { "md5": "d15eeec96fe71dfcb4da6eb83380987f", "sha256": "6c3f28898f2a972cadacc9b320755db79d96f50654d9c79193eb288dab9fa511" }, "downloads": -1, "filename": "lidaco-0.0.12.tar.gz", "has_sig": false, "md5_digest": "d15eeec96fe71dfcb4da6eb83380987f", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 13280, "upload_time": "2018-04-11T15:01:08", "url": "https://files.pythonhosted.org/packages/d1/93/5199f98c63cc149782666eeca4dba1f68c8d6ce6a58e56e14ae73f06c7fc/lidaco-0.0.12.tar.gz" } ], "0.0.13": [ { "comment_text": "", "digests": { "md5": "90401bb7e45fd54aeb2c30c69472bcdc", "sha256": "b32a993af48481953eb6c94aba2222b7581f3412089148809cf40d4a21296d6d" }, "downloads": -1, "filename": "lidaco-0.0.13.tar.gz", "has_sig": false, "md5_digest": "90401bb7e45fd54aeb2c30c69472bcdc", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 13314, "upload_time": "2018-04-11T15:22:09", "url": "https://files.pythonhosted.org/packages/6c/2e/e921bee3d92295dd3bc8fd49767954c6dc3e170a36ecf04c9a53718eae96/lidaco-0.0.13.tar.gz" } ], "0.0.14": [ { "comment_text": "", "digests": { "md5": "5c3b89178557caa256e64ce0415fcc35", "sha256": "4882e13be82b8e88e2105cd510a7bc50a9150654e2ba917ac9aaeeee16fedeaa" }, "downloads": -1, "filename": "lidaco-0.0.14.tar.gz", "has_sig": false, "md5_digest": "5c3b89178557caa256e64ce0415fcc35", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 13311, "upload_time": "2018-04-11T15:25:46", "url": "https://files.pythonhosted.org/packages/32/50/9e241aa7d24de3b943fa7613334752b07f3ba3e83a81860c46e80ecf53a2/lidaco-0.0.14.tar.gz" } ], "0.0.15": [ { "comment_text": "", "digests": { "md5": "ae7bb455adbdac784dfe43484e0528bc", "sha256": "0902fa0b5c907c566921b7ceb97cccce8b1eb5307e55045aee18d624f3a7cc77" }, "downloads": -1, "filename": "lidaco-0.0.15.tar.gz", "has_sig": false, "md5_digest": "ae7bb455adbdac784dfe43484e0528bc", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 13440, "upload_time": "2018-04-11T15:35:36", "url": "https://files.pythonhosted.org/packages/35/49/bb38c70c0acca9708a112712f0f515b58ab3a0f6d28f89b3a4a4c4781e50/lidaco-0.0.15.tar.gz" } ], "0.0.16": [ { "comment_text": "", "digests": { "md5": "2172da67a2fe19902b72512753eaf620", "sha256": "506da5a98ea28056d15a5546c54f159af75633db02f633dccbc8ae9841a10a68" }, "downloads": -1, "filename": "lidaco-0.0.16.tar.gz", "has_sig": false, "md5_digest": "2172da67a2fe19902b72512753eaf620", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 18181, "upload_time": "2018-06-28T14:39:05", "url": "https://files.pythonhosted.org/packages/17/22/0f1e13ede1bdf5f1c94711ebad8f518b4c773c8a7406b003f3e364733bd3/lidaco-0.0.16.tar.gz" } ], "0.0.17": [ { "comment_text": "", "digests": { "md5": "cc99197f082cf6d9450c2d211184277f", "sha256": "a36a6834a4162b6e66c2efa5cabb437ae5912fe6b71424f456b7585f8b6a1eb3" }, "downloads": -1, "filename": "lidaco-0.0.17.tar.gz", "has_sig": false, "md5_digest": "cc99197f082cf6d9450c2d211184277f", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 19995, "upload_time": "2018-06-28T14:47:18", "url": "https://files.pythonhosted.org/packages/bd/1f/ef0eb564e7d4240ca40720b8e1ed21fa26496855f3afeaf4807060d91e9a/lidaco-0.0.17.tar.gz" } ], "0.0.18": [ { "comment_text": "", "digests": { "md5": "5d61d832252c739fc75fda9adbffa1f6", "sha256": "ae2a9e17626ae9814cf00d3d2f91e4b16f20778a6cd9fe330f9fc7cec1b06be2" }, "downloads": -1, "filename": "lidaco-0.0.18.tar.gz", "has_sig": false, "md5_digest": "5d61d832252c739fc75fda9adbffa1f6", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 19994, "upload_time": "2018-06-28T15:01:06", "url": "https://files.pythonhosted.org/packages/a4/68/0b811db6659a8ef8548c6821134815821b78e1a707fee0b1b20e9b46692e/lidaco-0.0.18.tar.gz" } ], "0.0.20": [ { "comment_text": "", "digests": { "md5": "1e9a8149ef1d7d9e4bc224a9c37ce4dc", "sha256": "c983bb17d2b84588576af9d410a4e4268724f3e893385c8260c886c8dde60c3b" }, "downloads": -1, "filename": "lidaco-0.0.20.tar.gz", "has_sig": false, "md5_digest": "1e9a8149ef1d7d9e4bc224a9c37ce4dc", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 22630, "upload_time": "2018-08-06T12:34:54", "url": "https://files.pythonhosted.org/packages/d3/aa/75ff1285fc5e1cc1984f79890c8fef7a679a578258ba9979074e0c9a8d7e/lidaco-0.0.20.tar.gz" } ], "0.0.21": [ { "comment_text": "", "digests": { "md5": "2fffddae2cc8185a20d70fed80a7777a", "sha256": "2debca09e031d7ef07f75613f6bfbc5d467d0eb02b2b779886f3754319b413d1" }, "downloads": -1, "filename": "lidaco-0.0.21.tar.gz", "has_sig": false, "md5_digest": "2fffddae2cc8185a20d70fed80a7777a", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 22138, "upload_time": "2018-10-16T22:06:10", "url": "https://files.pythonhosted.org/packages/7f/af/9d26f453418d9569366f8ef65d61fb0d15276b85abca3c34f784a5dc15ba/lidaco-0.0.21.tar.gz" } ], "0.0.22": [ { "comment_text": "", "digests": { "md5": "753acbbbfec80e747ad40ad8dacb4a38", "sha256": "6896c176d35400e7f734b4a304ee732893aadc374743db37b644080e923aa510" }, "downloads": -1, "filename": "lidaco-0.0.22.tar.gz", "has_sig": false, "md5_digest": "753acbbbfec80e747ad40ad8dacb4a38", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 22139, "upload_time": "2018-10-16T22:09:22", "url": "https://files.pythonhosted.org/packages/ba/24/00b9943a7ca800f09420c93d8e4ef7b266855c0187f4e16465b7e3549f6d/lidaco-0.0.22.tar.gz" } ], "0.0.23": [ { "comment_text": "", "digests": { "md5": "801be086899999f586645b6750d5de45", "sha256": "4e5c780b4a95a5529d69669df46471ada9afc262092f39bd673f5d914e9ee40f" }, "downloads": -1, "filename": "lidaco-0.0.23.tar.gz", "has_sig": false, "md5_digest": "801be086899999f586645b6750d5de45", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 22140, "upload_time": "2018-10-16T22:12:36", "url": "https://files.pythonhosted.org/packages/c6/32/f4058510b52db1f690d92628c1d4a9d2614bbf8a02f8b9034ae4984713d3/lidaco-0.0.23.tar.gz" } ], "0.0.24": [ { "comment_text": "", "digests": { "md5": "d9c0ec82620ba9a5e71dde7bd53bbe14", "sha256": "fc9c764a03a246554da0344b61e9709ab3a663f2b6b0ea19f39c688574ed6aba" }, "downloads": -1, "filename": "lidaco-0.0.24.tar.gz", "has_sig": false, "md5_digest": "d9c0ec82620ba9a5e71dde7bd53bbe14", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 22152, "upload_time": "2018-10-17T21:54:38", "url": "https://files.pythonhosted.org/packages/9d/07/ee1ae8770b674e99508e74204e6496f83bc4b43fcb95ec25ca46e3b0c149/lidaco-0.0.24.tar.gz" } ], "0.0.25": [ { "comment_text": "", "digests": { "md5": "5893ce0699655cd78d2cd556988d2985", "sha256": "a8f2523c7672aebcb8ebf6056ad7511f528be71da2d6f0d0df3d76085cf298b4" }, "downloads": -1, "filename": "lidaco-0.0.25.tar.gz", "has_sig": false, "md5_digest": "5893ce0699655cd78d2cd556988d2985", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 22148, "upload_time": "2018-10-17T22:04:39", "url": "https://files.pythonhosted.org/packages/25/69/64c823197a1e6bb11842f39b73c7765bd9753de39b1268f03fda71b9a864/lidaco-0.0.25.tar.gz" } ], "0.0.26": [ { "comment_text": "", "digests": { "md5": "0a5994541974e9dd1f9396b831bf8bbe", "sha256": "12c56ce7b7ad27cedab33c48435fb5c255125eb6cef93fda9fb301df4560cafe" }, "downloads": -1, "filename": "lidaco-0.0.26.tar.gz", "has_sig": false, "md5_digest": "0a5994541974e9dd1f9396b831bf8bbe", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 22847, "upload_time": "2018-10-17T22:24:42", "url": "https://files.pythonhosted.org/packages/45/0c/2bba380d21dea67db8f6291bdb24a38e4fcd4a6a19c7028650c6bebb0443/lidaco-0.0.26.tar.gz" } ], "0.0.28": [ { "comment_text": "", "digests": { "md5": "597ac0acca4ad1a2c773a2c1cb3abfd0", "sha256": "200ce358302e93c953428ea3d25161eb1ef5d4cef18c26ab732ebdf8fe868cf6" }, "downloads": -1, "filename": "lidaco-0.0.28.tar.gz", "has_sig": false, "md5_digest": "597ac0acca4ad1a2c773a2c1cb3abfd0", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 22850, "upload_time": "2018-10-17T22:32:09", "url": "https://files.pythonhosted.org/packages/15/64/91acfc0b27634cb94cd1963ac3ea5e44ed784597cb8c877b85bcd46b9f53/lidaco-0.0.28.tar.gz" } ] }, "urls": [ { "comment_text": "", "digests": { "md5": "597ac0acca4ad1a2c773a2c1cb3abfd0", "sha256": "200ce358302e93c953428ea3d25161eb1ef5d4cef18c26ab732ebdf8fe868cf6" }, "downloads": -1, "filename": "lidaco-0.0.28.tar.gz", "has_sig": false, "md5_digest": "597ac0acca4ad1a2c773a2c1cb3abfd0", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 22850, "upload_time": "2018-10-17T22:32:09", "url": "https://files.pythonhosted.org/packages/15/64/91acfc0b27634cb94cd1963ac3ea5e44ed784597cb8c877b85bcd46b9f53/lidaco-0.0.28.tar.gz" } ] }