---
name: "nxtranslate"
section: "1"
platform: "linux"
package: "nexus-tools"
version: "4.3.2-svn1921-2+b2"
release: "Debian 8 (Jessie)"
platforms: ["linux"]
url: "https://new.carta.tech/nxtranslate"
---

# nxtranslate(1)

convert anything into a NeXus file

## NAME

nxtranslate - convert anything into a NeXus file

## SYNOPSIS

**nxtranslate** \[options\] \[--hd4\|--hdf5\|--xml\] \[*infile*\] \[-o\|--append *outfile*\]

## DESCRIPTION

**nxtranslate** is an anything to NeXus converter. This is accomplished by using translation files and a plugin style of architecture where  **nxtranslate** can read from new formats as plugins become available. This document describes the usage of **nxtranslate** by three types of individuals: the person using existing translation files to create NeXus files, the person creating translation files, and the person writing new Retrievers. All of these concepts are discussed in detail.

## OPTIONS

The following options are supported

- **--help**

  Print out the help message and exit

- **--version**

  Print out the version and exit

- **-o outfile**

  Specify output file. The default is the translation file with ".nxs" appended.

- **--append outfile**

  Specify appending to the output file.

- **--hdf4**

  Write file using the hdf4 base.

- **--hdf5**

  Write file using the hdf5 base.

- **--xml**

  Write file using the xml base.

- **-D macro**

  Specify a macro. The macro should be in the form of "FILE=old\_nexus.nxs". The "=" is required.

## SEE ALSO

**[nxconvert(1)](/nxconvert/1.md),** [**nxdir**(1)](/nxdir/1.md), **http://www.nexusformat.org**

## AUTHOR

**nxtranslate** was originally written by Peter Peterson  \<petersonpf@ornl.gov\> and may be used by others.