Package: nwc-safer
NWC-SAFerAn awesome CLI tool simplifying NetCDF data extraction of NWC-SAF products and transformation to different file formats!Report Bug·Request FeatureTable of ContentsTable of ContentsAbout the ProjectTech StackGetting StartedPrerequisitesInstallationPyPi (recommended)SourceRun LocallyUsageWatch directory and convert incoming filesManual file conversionCheck compatible productsLaunch Github repositoryRoadmapLicenseContactAbout the ProjectThis is a modern and simplified Command Line Interface tool created to extract info and metadata from NetCDF files and convert them into different file formats such as Csv, Excel, plain text, etc.Its aim is to simplify data extraction from NWC SAFproductsand their transformation to different file formats, more readable and easier to access and edit. ΝWC-SAF is an initiative ofEUMETSATto provide operational services ensuring the optimum use of meteorological satellite data in Nowcasting and Very Short Range Forecasting.Tech StackThe tech stack of this project consists of the following main technologies/frameworks/tools:Python Queues and thread handling is applied to enhance user experienceNetCDF4, Pandas, xarray libraries are used for file manipulationGetting StartedPrerequisitesYou just need to have installed Python language preferrably > 3.10 version and a Python package/dependency management tool like Pip, Poetry, Conda etc.The tool is compatible with all popular OS.Better used along with CLIs that support emojis and Unicode characters for a better user experience.InstallationPyPi (recommended)Install it from PyPi using pip or any other python package managerpipinstall--usernwc-saferEnable auto-completion by executing the following commandnwc-safer--install-completionSourceClone the Git repogitclonehttps://github.com/fotioudim/nwc-safer.gitInstall using poetry in the corresponding directorypoetryinstallRun LocallyJust run it usingnwc-safer. Get help for the available commandsnwc-safer--helpUsageRunnwc-saferornwc-safer -- helpin your CLI to get a better description of the available commands and options.Watch directory and convert incoming filesConstantly watch a directory for incoming NetCDF files, in order to extract the desired data and export them in the form of Csv/Excel/Text files.nwc-saferwatch[OPTIONS][INPUT_PATH][OUTPUT_PATH]Arguments:input_path: The path (relative/absolute) for the directory desired to be watched [default: .]output_path: The path (relative/absolute) for the output directory [default: .\output]Options:--lat-la: The latitude coordinate range in ascending order, given in the form of two int values (min & max)--lon-lo: The longitude coordinate range in ascending order, given in the form of two int values (min & max)--format-f: The output file format [default: csv]--recursive-r: Watch for incoming files recursively in all the subdirectories of the specified directory--existing-e: Convert pre-existing files in the specified directoryManual file conversionProcess a single or multiple NetCDF file(s), by extracting the desired data
and exporting them in a new file format (eg. Csv, Excel).nwc-saferconvert[OPTIONS][FILE_PATHS]...Arguments:file_paths: The path(s) (relative/absolute) for the file(s) desired to be converted [default: None] [required]Options:--lat-la: The latitude coordinate range in ascending order, given in the form of two int values (min & max)--lon-lo: The longitude coordinate range in ascending order, given in the form of two int values (min & max)--output-o: The path (relative/absolute) for the output directory [default: .\output]--format-f: The output file format [default: csv]Check compatible productsCheck which NWC-SAF products are currently supported by the toolnwc-safercompatibilityLaunch Github repositoryLaunch NWC-SAF NetCDF Data Exporter Github repository in the web browsernwc-saferrepoRoadmapAdd continuous watching & conversion operationSingle conversion operationOS agnostic functionalityMultiple conversion operationSubset dataset based on coordinates rangeSupport 3 output file formats (.csv, .xlsx, txt)Generalize solution for a bigger set ofNWC SAF productsLicenseDistributed under the MIT License. SeeLICENSE.mdfor more information.ContactYou can reach me at:Personal website:https://www.dfotiou.grStackOverflow profile:https://stackoverflow.com/users/11680294/fotiou-dLinkedin profile:https://www.linkedin.com/in/dimitris-fotiou-4141a8197/Email:fotioudimitris93@gmail.com