NCO

Manipulates and analyzes data stored in netCDF-accessible formats.
https://github.com/nco/nco

Category: Climate Change
Sub Category: Climate Data Processing and Analysis

Keywords

cesm climate cmip5 dap e3sm esgf gsl hdf hdf5 nco netcdf netcdf-operators opendap regrid

Keywords from Contributors

unidata unidata-netcdf conda package-management earth-system-model qt climate-model weather grib conda-packages

Last synced: about 17 hours ago
JSON representation

Repository metadata

netCDF Operators

README

          # $Header$ -*-text-*-

# Purpose: NCO README file

What is NCO?
The netCDF Operators, NCO, are a suite of programs known as operators. 
The operators facilitate manipulation and analysis of self-describing
data stored in the freely available netCDF and HDF formats 
(http://www.unidata.ucar.edu/packages/netcdf and
http://hdfgroup.org, respectively). 
Each NCO operator (e.g., ncks) takes netCDF or HDF input file(s),
performs an operation (e.g., averaging, hyperslabbing, or renaming),
and outputs information, usually a processed netCDF file  
Although most users of netCDF and HDF data are involved in scientific
research, these data formats, and thus NCO, are generic and are
equally useful in fields from agriculture to zoology.
The NCO Users Guide illustrates NCO use with examples from the field
of climate modeling and analysis. 
The NCO homepage is http://nco.sf.net.

Installation:
NCO runs on all major UNIX systems and MS Windows.
NCO (except ncap2) requires only an ANSI-compliant C99 compiler.
NCO can be built and installed with the standard GNU autotools
./configure mechanism or with a custom Makefile.
ncap2 requires an C++ compiler and can be hard to build.
Please submit patches to help simplify the build system!

Newer Autotools Configure Build Procedure:
Try the newer ./configure mechanism first by using the configure
command in the top-level NCO directory:

`cd ~/nco;./configure;make;make install'

or 

`cd ~/nco;./configure;make;make install-strip'

if you to strip the executables and libraries. In this case, NCO
will run at the same speed, but consume less memory and only about
half the disk space since all debugging information is "stripped". 

If autotools do not work, please look at the slightly more complex
(and realistic) examples that we use to test your machine architecture.
These are in the configure.eg file in the top-level NCO directory. 
The output of these commands from our test machines is available at 

http://dust.ess.uci.edu/nco/rgr

Please send us any modifications to the configure.ac script that 
might benefit other NCO users. 

Older Manual Makefile Build Procedure:
If configure does not work for you, try the older build mechanism:

`cd ~/nco/bld;make dir;make'
`cd ~/nco/src/nco_c++;make -f Makefile.old dir;make -f Makefile.old'

You must use GNU make, which reads `Makefile' by default.
Makefile has some hardcoded switches which may be only valid at UCI
or NCAR, but which can serve as a template for your environment. 
First, be sure to define NETCDF_INC and NETCDF_LIB variables either 
within your environment, or at the top of Makefile. 
Within Makefile, locate the block of code which corresponds
to your machine type as defined by $PVM_ARCH and the pvmgetarch command.
Within this block you may need to edit the CC, CPPFLAGS, and LDFLAGS
arguments so they reflect the names of the compilers and linkers.  

Read ./bld/Makefile for useful user-specified switches.
Compile with `make OPTS=D' to build debugging versions.  
Environment variables MY_OBJ_DIR, MY_INC_DIR, MY_LIB_DIR and
MY_BIN_DIR control locations of object files, include files,
libraries, and executables. 

Documentation and Bug Reports:
Please read the NCO manual before you submit a bug report!  
It is supplied in many formats: Postscript (nco.ps), Texinfo
(nco.texi), Info (nco.info), HTML (nco.html), and DVI (nco.dvi).
If you got NCO from a CVS snapshot, you must generate these formats
yourself with 'make nco.html', 'make nco.pdf', 'make nco.ps',
etc. from within the doc/ directory.
Sending me questions whose answers aren't in the manual is the best
way to motivate me to write more documentation.  
Let me also accentuate the contrapositive of that suggestion.

Good luck!
Charlie

        

Citation (CITATION)

NCO is three things: a geoscience data analysis toolkit, an
open-source software project, and an academic enterprise that embodies
fundamental new (research-level) algorithms for geoscience data
analysis. Successful academic research depends upon peer-evaluation,
dissemination, and explicit acknowledgement of prior work and original
results. The accepted way to convey acknowledgement to NCO for ideas
or assistance in workflow processing is to cite its peer-reviewed 
description and or its User Guide. We encourage users and data science 
researchers to cite NCO for another reason, too: it helps funding
agencies track the impact of the work they fund.

The recommended citation for NCO software is

Zender, C. S. (2008), Analysis of Self-describing Gridded Geoscience
Data with netCDF Operators (NCO), Environ. Modell. Softw., 23(10),
1338-1342, doi:10.1016/j.envsoft.2008.03.004. 

or

Zender, C. S. (2014), netCDF Operator (NCO) User Guide, Version 4.4.3,
http://nco.sf.net/nco.pdf. 

Use the former when referring to overall design, purpose, and
optimization of NCO, and use the latter when referring to specific
features and/or the Users Guide itself.

Additional information on citing NCO is in the User Guide at
http://nco.sf.net#ctt
A complete list of NCO publications and presentations is at
http://nco.sf.net#pub
This list links to the full papers and seminars themselves.

Owner metadata


GitHub Events

Total
Last Year

Committers metadata

Last synced: 2 days ago

Total Commits: 15,292
Total Committers: 42
Avg Commits per committer: 364.095
Development Distribution Score (DDS): 0.346

Commits in past year: 219
Committers in past year: 5
Avg Commits per committer in past year: 43.8
Development Distribution Score (DDS) in past year: 0.023

Name Email Commits
Charlie Zender z****r@u****u 10002
Pedro Vicente p****e@s****g 2567
Henry Butowsky h****b@h****m 1851
Daniel Wang d****w@s****u 163
Rorik Peterson f****1@u****u 144
Henry Butowsky h****k@s****u 135
Harry Mangalam h****m@t****m 118
Pedro Vicente p****e@g****e 104
Wenshan Wang w****w@u****u 49
FlyingWithJerome j****m@u****u 27
Bas Couwenberg s****c@x****l 12
Dingying Wei d****i@u****u 12
hbdch s****r@g****m 11
Henry Butowsky h****k@g****u 11
Gayathri Venkitachalam g****a@u****u 10
Filipe Fernandes o****f@g****m 10
Isuru Fernando i****f@g****m 9
Rostislav Kouznetsov r****v@f****i 7
Karen Schuchardt K****t@p****v 5
pvn p****n@m****e 5
tolento j****o@b****l 4
Rostislav Kouznetsov R****v@g****m 3
Scott Capps s****s@a****u 3
Dingying Wei d****i@g****e 3
Daniel Neumann d****n@i****e 3
David Forrest d****f@v****u 2
Jim Edwards j****s@u****u 2
Xylar Asay-Davis x****m@g****m 2
Ed Hill e****3@m****u 2
Henry Butowsky b****y@r****v 2
and 12 more...

Committer domains:


Issue and Pull Request metadata

Last synced: 1 day ago

Total issues: 148
Total pull requests: 144
Average time to close issues: about 1 month
Average time to close pull requests: 3 days
Total issue authors: 68
Total pull request authors: 24
Average comments per issue: 4.85
Average comments per pull request: 1.23
Merged pull request: 135
Bot issues: 0
Bot pull requests: 0

Past year issues: 6
Past year pull requests: 5
Past year average time to close issues: 4 days
Past year average time to close pull requests: about 5 hours
Past year issue authors: 5
Past year pull request authors: 4
Past year average comments per issue: 3.83
Past year average comments per pull request: 0.6
Past year merged pull request: 5
Past year bot issues: 0
Past year bot pull requests: 0

More stats: https://issues.ecosyste.ms/repositories/lookup?url=https://github.com/nco/nco

Top Issue Authors

  • czender (38)
  • sebastic (8)
  • rkouznetsov (7)
  • xylar (6)
  • EnlNovius (4)
  • kwilcox (4)
  • doutriaux1 (4)
  • hmb1 (3)
  • mathomp4 (3)
  • durack1 (3)
  • mt5555 (3)
  • sethmcg (2)
  • pnorton-usgs (2)
  • Saszalez (2)
  • rsignell-usgs (2)

Top Pull Request Authors

  • hmb1 (69)
  • sebastic (14)
  • FlyingWithJerome (13)
  • czender (9)
  • ocefpaf (8)
  • rkouznetsov (5)
  • hbdch (4)
  • neumannd (3)
  • isuruf (2)
  • jtolento (2)
  • xylar (2)
  • tenomoto (1)
  • drf5n (1)
  • jhamman (1)
  • kgerheiser (1)

Top Issue Labels

  • high priority (19)
  • medium priority (16)
  • bug (15)
  • low priority (7)
  • help wanted (6)
  • compiler warning (4)
  • documentation (2)
  • unreproducible (2)
  • enhancement (2)

Top Pull Request Labels

  • medium priority (2)

Score: 9.135832319801121