Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

The accuracy of nccopy documentation, NUG entries need to be verified #2031

Open
WardF opened this issue Jul 13, 2021 · 1 comment
Open

The accuracy of nccopy documentation, NUG entries need to be verified #2031

WardF opened this issue Jul 13, 2021 · 1 comment

Comments

@WardF
Copy link
Member

WardF commented Jul 13, 2021

As reported by @lesserwhirls:

PR #1087 introduced an alternative form for per-variable chunking, as described below:

So using nccopy, you can set a chunkspec based on dimensions like so:

-c dim1/chunkSize2,dim2/chunkSize2,dim3/chunkSize3

According to this PR, it looks like the chunkspec was extended to allow a per-variable chunking, using

-c var:c1,c2,...ck

where var is the name of the variable and ci is the chunksize for the ith dimension of that variable. However, I don't see this second form documented in the man page of nccopy , and the entry in the NUG describing the chunkspec option says that you cannot use nccopy to chunk variables independently.

It is unclear if this new form was added and the supporting documentation was never updated, or if the new form was removed at some point. Either way, we just need to verify that the documentation is accurate. Tagging @DennisHeimbigner in as well.

@lesserwhirls
Copy link
Contributor

It looks like the man page is updated and correct - the issue was that I was looking at the output of nccopy -h, which does not show an example of the variable level chunking syntax (might be too much text to add there, though). The NUG page should be updated. @ethanrd

@WardF WardF modified the milestones: 4.8.1, 4.8.2 Dec 13, 2021
@WardF WardF modified the milestones: 4.8.2, 4.9.1 Jun 15, 2022
@WardF WardF modified the milestones: 4.9.1, 4.9.2 Feb 13, 2023
@WardF WardF modified the milestones: 4.9.2, 4.9.3 May 16, 2023
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

No branches or pull requests

2 participants