Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
MINC_MODIFY_HEADER(1)	       MINC User's Guide	 MINC_MODIFY_HEADER(1)

NAME
       minc_modify_header - modify the attributes in the header	of a minc file

SYNOPSIS
       minc_modify_header [<options>] <file>.mnc

DESCRIPTION
       Minc_modify_header  allows  the	modification, insertion	or deletion of
       attributes in a minc file. If possible, the file	is modified in	place,
       without	copying	 the data. This	will happen when inserting (modifying)
       an attribute that already exists	and that ends up being the same	length
       or  shorter  in the new file. If	an attribute is	deleted	or lengthened,
       then a complete copy of the data	is made, resulting in a	completely new
       file that replaces the original.

       If  the	file  is compressed, then it is	first decompressed into	a file
       whose name is either the	same as	that of	the original file  up  to  the
       ".mnc"  extension  or  the same minus the compression extension (".bz",
       ".bz2", ".gz", ".Z", ".z" or ".zip").  The new file will	not be re-com-
       pressed.

       Care  is	 taken to completely overwrite any existing attribute when in-
       serting a new attribute so that information is guaranteed to be removed
       from the	file.

OPTIONS
       Note that options can be	specified in abbreviated form (as long as they
       are unique) and can be given anywhere on	the command line.

       -sinsert	var:attr=value
	      Insert a string attribute	into the header. If the	attribute does
	      not  exist  or  the  new string is longer	than the existing one,
	      then all data in the file	will be	copied.

       -sappend	var:attr=value
	      Similar to -sinsert, but appends the string to  the  attribute's
	      value.   If  the	attribute  already exists it must be of	string
	      type.

       -dinsert	var:attr=value(,...)
	      Insert a double precision	attribute into the header. If the  at-
	      tribute  does  not exist or the new attribute is longer than the
	      existing one, then all data in the file will be copied. A	comma-
	      separated	array of values	can be specified.

       -dappend	var:attr=value(,...)
	      Similar  to  -dinsert,  but appends the list of double precision
	      values to	the attribute's	value.	If the attribute  already  ex-
	      ists it must be of double	precision type.

       -delete var:attr
	      Delete  an  attribute  from  the header. USE OF THIS OPTION WILL
	      FORCE A COMPLETE COPY OF ALL DATA	TO BE MADE. Use	-sinsert  with
	      an  empty	string to delete information without copying data (the
	      attribute	will continue to exist).

       -help  Print summary of command-line options and	exit.

       -version
	      Print the	program's version number and exit.

EXAMPLES:
       To replace the patient name with	an identifier string:

	      minc_modify_header	file.mnc	 -sinsert	  'pa-
	      tient:full_name=C02-F0023'

       To delete the patient name completely (forcing a	copy of	all data):

	      minc_modify_header file.mnc -delete 'patient:full_name'

       To  hide	 the  patient name without copying data, assuming that we know
       that the	attribute exists (the attribute	will remain in the  file,  but
       it will be empty):

	      minc_modify_header file.mnc -sinsert 'patient:full_name='

AUTHOR
       Peter Neelin

COPYRIGHTS
       Copyright (C) 1995 by Peter Neelin

			 $Date:	2004-05-25 21:33:11 $	 MINC_MODIFY_HEADER(1)

NAME | SYNOPSIS | DESCRIPTION | OPTIONS | EXAMPLES: | AUTHOR | COPYRIGHTS

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=minc_modify_header&sektion=1&manpath=FreeBSD+12.1-RELEASE+and+Ports>

home | help