Package: netcdfella
NetcdFellaThe easy as duck duck netcdf converter to ASCII, JPEG and more...Explore the docs »·Report Bug·Request FeatureTable of ContentsAbout The ProjectBuilt WithGetting StartedPrerequisitesInstallationUsageRoadmapContributingLicenseContactAcknowledgmentsAbout The ProjectNetcdfella is a command line interface (cli) tool for converting netcdf files to ASCII and JPG/PNG format, as well as creating graphs based on the vectors of the file.Netcdfella supports two ways for converting documents at the time being:single/multi convertconversion upon creationDuring the run of the cli the output types, the mapping dimension and variable can be selected aling with other options.single/multi convertYou can convert a single file or all netcdf files in a directory on your command. This is the case of the single/multi select.conversion upon creationA directory can be selected to be watched by netcdfella. WHen a new netcdf file is created in that directory, it is automatically converted in the selected formats.qnotifyIn order to handle any amount of input documents in the case of watch. A producer-consumer queue is created in the module qnotify using the inotify library. In this case the producers are the directory events. This creates a buffer that can handle the set amount of concurrent document creations.Use theREADME.mdto get started.(back to top)Built WithThis section should list any major frameworks/libraries used to bootstrap your project. Leave any add-ons/plugins for the acknowledgements section. Here are a few examples.(back to top)Getting StartedThis is an example of how you may give instructions on setting up your project locally.
To get a local copy up and running follow these simple example steps.PrerequisitesThis software and tested for Python version 3.10.4.If you need to manually install packages:requirementspipinstall-rrequirements.txtIf you wish to make use of the pyproject.toml you need to install poetry:poetrycurl-sSLhttps://install.python-poetry.org|python3-InstallationYou can install from source or from pypiSourceClone the repogitclonehttps://github.com/nikfot/netcdfella.gitInstall using poetrypoetryinstallRunnetcdfellato see the help with available choices:netcdfellaornetcdfella--helpPYPIUse PYPI to pip install the project:```sh
pip install netcdfella
```(back to top)UsageYou can use the netcdfella to get a better description of the available choices:```sh
netcdfella
```

or

```sh
netcdfella --help
```convertUse netcdfella to convert a single document or all documents in a directory:```sh
netcdfella convert "/path/to/documents" -k "ascii,graph,scatter,marks" -md "flashes" -mv "radiance"
```All choices for convert subcommand:
Options:
-o, --output-dir TEXT set the output directory for converted files.
-k, --output-kinds TEXT set the output kind for conversion.
-md, --map-dimension TEXT set the dimenion to use for mapping.
-mv, --map-variable TEXT set the variable to use for mapping.
-e, --exclude-variables TEXT comma separated list of variables to be
excluded from conversion.
--help Show this message and exit.watchUse netcdfella to watch over a directory and convert files upon creation:```sh
netcdfella watch "/path/to/documents" -k "ascii,graph,scatter,marks" -md "flashes" -mv "radiance"
```Options:
-o, --output-dir TEXT set the output directory for converted files.
-k, --output-kinds TEXT set the output kind for conversion.
-md, --map-dimension TEXT set the dimenion to use for mapping.
-mv, --map-variable TEXT set the variable to use for mapping.
-e, --exclude-variables TEXT comma separated list of variables to be
excluded from conversion.
--help Show this message and exit.(back to top)RoadmapAdd cli conversionAdd ascii,jpg/png, graphsAdd docker supportCheck compatibility with more netcdf filetypes (current test METEOSAT 4th gen)Add REST API ServerAdd gui(back to top)ContributingThere are still a lot to be done, so if you find the project usefull please contribute you comments, ideas and code. It isgreatly appreciated.If you have a suggestion that would make this better, please fork the repo and create a pull request. You can also simply open an issue with the tag "enhancement".
Don't forget to give the project a star! Thanks again!Fork the ProjectCreate your Feature Branch (git checkout -b feature/AmazingFeature)Commit your Changes (git commit -m 'Add some AmazingFeature')Push to the Branch (git push origin feature/AmazingFeature)Open a Pull Request(back to top)LicenseDistributed under the GPL License. SeeLICENSE.mdfor more information.(back to top)ContactNikos Fotiou -@workaround18-nik_fot@hotmail.grNetcdfella:https://github.com/nikfot/netcdfella(back to top)AcknowledgmentsThis tool is created as part of my postgrad studies "Space Technologies Applications and Services - STAR" programm at the National and Kapodestrian University of Athens Greece (NKUA). It was a semester project for the class "Space Image Processing" by professor Stavros Kolios.(back to top)