Commandline interface
xoa comes with an executable script with the same name. Here is its help.
xoa
xoa interface
usage: xoa [-h] {info,reset_cf_cache} ...
xoa info
usage: xoa info [-h] [{all,paths,versions,options}]
Positional Arguments
- category
Possible choices: all, paths, versions, options
info category
Default: “all”
Examples
Print all info:
$ xoa info
# VERSIONS
- python: 3.11.4
- xoa: 0.7.2.dev0+g989c8bc.d20230721
- appdirs: 1.4.4
- cartopy: 0.21.1
- cmocean: 3.0.3
- configobj: 5.0.8
- matplotlib: 3.7.2
- numpy: 1.24.4
- pandas: 2.0.3
- scipy: 1.11.1
- xarray: 2023.7.0
- xesmf: NOT INSTALLED or UKNOWN
# FILES AND DIRECTORIES
- xoa library dir: /home/docs/checkouts/readthedocs.org/user_builds/xoa/conda/stable/lib/python3.11/site-packages/xoa
- user config file: /home/docs/.config/xoa/xoa.cfg [*]
- user CF specs file: /home/docs/.config/xoa/cf.cfg [*]
- user CF cache file: /home/docs/.cache/xoa/cf.pyk
- data samples: ibi-argo-7900573.nc gdp-6203641.csv hycom.cfg hycom.gdp.u.nc hycom.gdp.v.nc croco.south-africa.surf.nc croco.cfg argo-7900573.nc hycom.gdp.h.nc croco.south-africa.meridional.nc argo.cfg mercator.cfg croco.south-africa.zonal.nc gdp.cfg
*: file not present
# OPTIONS
[cf] # cf module
cache=boolean(default=True) # use the :mod:`~xoa.cf` in memory and file caches
[plot] # plot parameters
cmapdiv = string(default="cmo.balance") # defaut diverging colormap
cmappos = string(default="cmo.amp") # default positive colormap
cmapneg = string(default="cmo.tempo_r") # default negative colormap
cmapcyc = string(default="cmo.phase") # default cyclic colormap
Print only info about paths:
$ xoa info paths
- xoa library dir: /home/docs/checkouts/readthedocs.org/user_builds/xoa/conda/stable/lib/python3.11/site-packages/xoa
- user config file: /home/docs/.config/xoa/xoa.cfg [*]
- user CF specs file: /home/docs/.config/xoa/cf.cfg [*]
- user CF cache file: /home/docs/.cache/xoa/cf.pyk
- data samples: ibi-argo-7900573.nc gdp-6203641.csv hycom.cfg hycom.gdp.u.nc hycom.gdp.v.nc croco.south-africa.surf.nc croco.cfg argo-7900573.nc hycom.gdp.h.nc croco.south-africa.meridional.nc argo.cfg mercator.cfg croco.south-africa.zonal.nc gdp.cfg
*: file not present
xoa reset_cf_cache
usage: xoa reset_cf_cache [-h]