File System Utility Functions for 'NeuroAnatomy Toolbox'

Utility functions that may be of general interest but are specifically required by the 'NeuroAnatomy Toolbox' ('nat'). Includes functions to provide a basic make style system to update files based on timestamp information, file locking and 'touch' utility. Convenience functions for working with file paths include 'abs2rel', 'split_path' and 'common_path'. Finally there are utility functions for working with 'zip' and 'gzip' files including integrity tests.

CRAN_Status_Badge Release Version Build Status Coverage Status

An R package containing utility functions to support the NeuroAnatomy Toolbox (nat)


This package provides support functions for the nat NeuroAnatomy Toolbox package. Some functions may nevertheless be of general interest. See the reference manual on CRAN for a for full function listing.


Released versions

From CRAN- the recommended option for simplicity and since this package is not under heavy development:


Bleeding Edge

Straight from github with Hadley Wickham's devtools package:

if(!require("devtools")) install.packages("devtools")

Note: Windows users need Rtools to install in this way.


nat.utils 0.5

  • fixes gzip.crc bug on solaris (#8, thanks to Brian Ripley)
  • dev: simplify gzip.crc test and therefore no longer depend on digest

nat.utils 0.5

  • new function common_path finds common prefix of multiple paths
  • new function split_path breaks a path into its components, optionally including file separators.
  • file.hardlink is now defunct
  • dev: imports utils::read.table
  • dev: extra tests and code coverage support

nat.utils 0.4.3

  • bugfix: abs2rel handles multiple paths without a warning
  • bugfix: zipinfo quotes files
  • dev: upgrade to roxygen2 v4.0.2 and better rstudio settings

nat.utils 0.4.2

  • bugfix: export is.gzip
  • bugfix: test error

nat.utils 0.4.1

  • add is.gzip function
  • RunCmdForNewerInput now has a Force option (FALSE by default) that can be used to override mtime checks and run the command if possible.
  • dev: upgrade to roxygen2 v4

nat.utils 0.4

  • RunCmdForNewerInput can now evaluate expressions in the context of the caller (so that variables can be used properly)
  • tests: fix a test failure for latest version of testthat
  • dev: add travis continuous integration, update docs with roxygen2 v3.1

nat.utils 0.3

  • deprecate file.hardlink in favour of
  • prepare CRAN release

nat.utils 0.2

  • add zipinfo() and zipok() functions (and tests)

nat.utils 0.1

  • First version on github
  • translates main functions from AnalysisSuite Utils/OSUtils.R

Reference manual

It appears you don't have a PDF plugin for this browser. You can click here to download the reference manual.


0.5.1 by Gregory Jefferis, 6 years ago

Browse source code at

Authors: Gregory Jefferis

Documentation:   PDF Manual  

GPL-3 license

Suggests testthat, roxygen2

Imported by nat.

See at CRAN