Ccn admin: 2 revisions

2014-01-16T03:13:08Z

2 revisions

← Older revision	Revision as of 03:13, 16 January 2014
(No difference)

Mscohen: /* Compress Files using [http://www.brainmapping.org/SmallTime SmallTime] */

2006-09-12T00:04:11Z

Compress Files using [http://www.brainmapping.org/SmallTime SmallTime]

← Older revision		Revision as of 00:04, 12 September 2006
Line 5:		Line 5:
	{\| width="90%" border="1" cellpadding="8"		{\| width="90%" border="1" cellpadding="8"
	\|		\|
	This utility cuts the file ~~sies~~ of time seires files down by a factor of approximately two and operates extremely fast. The theory can be found at [http://www.brainmapping.org/SmallTime/ www.brainmapping.org/SmallTime] and is in press in ''Human Brain Mapping''. This "HowTo" note explains its use.		This utility cuts the file sizes of time seires files down by a factor of approximately two and operates extremely fast. The theory can be found at [http://www.brainmapping.org/SmallTime/ www.brainmapping.org/SmallTime] and is in press in ''Human Brain Mapping''. This "HowTo" note explains its use.

	SmallTime exists in two forms: as a command line tool under [http://airto.bmap.ucla.edu/BMCweb/HowTo/SmallTime.html#Anchor-unix-49575 unix] and as a standalone [http://airto.bmap.ucla.edu/BMCweb/HowTo/SmallTime.html#Anchor-Macintosh-47857 Macintosh] program. The files they create are mutually compatible.		SmallTime exists in two forms: as a command line tool under [http://airto.bmap.ucla.edu/BMCweb/HowTo/SmallTime.html#Anchor-unix-49575 unix] and as a standalone [http://airto.bmap.ucla.edu/BMCweb/HowTo/SmallTime.html#Anchor-Macintosh-47857 Macintosh] program. The files they create are mutually compatible.

Mscohen at 00:03, 12 September 2006

2006-09-12T00:03:29Z

New page

=Compress Files using [http://www.brainmapping.org/SmallTime SmallTime]=

<center>

{| width="90%" border="1" cellpadding="8"
|
This utility cuts the file sies of time seires files down by a factor of approximately two and operates extremely fast. The theory can be found at [http://www.brainmapping.org/SmallTime/ www.brainmapping.org/SmallTime] and is in press in ''Human Brain Mapping''. This "HowTo" note explains its use.

SmallTime exists in two forms: as a command line tool under [http://airto.bmap.ucla.edu/BMCweb/HowTo/SmallTime.html#Anchor-unix-49575 unix] and as a standalone [http://airto.bmap.ucla.edu/BMCweb/HowTo/SmallTime.html#Anchor-Macintosh-47857 Macintosh] program. The files they create are mutually compatible.

SmallTime is available as both source and executable at the [http://www.brainmapping.org/SmallTime/ Small Time web site].
|}

</center><div align="left">

==unix==

===compressing files===
To compress a file called, e.g., ''filename'', type:

</div>

SmallTime -c ''filename''
The file can be any of the standard types recognized at UCLA, but compression will only occur for a file having multiple time points, such as a bshort, bfloat, buchar, APD or Analyze4D file. For more on file types, see the [http://airto.bmap.ucla.edu/BMCweb/HowTo/FileFormats.html File Format HowTo]. The compressed file will be named as the input, followed by '.ST'. In the above example, the output file would be ''filename.ST.'' SmallTime will append the header to the compressed file, so this does not have to be saved separately.

<div align="left">

===uncompressing files===
To ucompress a file called, e.g., ''filename.ST'', type:

</div>

SmallTime -u ''filename.ST''
The resulting output will be the same as the original compressed file and will include a corresponding header, if appropriate.

===''options''<nowiki>:</nowiki>===
{| border="4" cellpadding="3" bgcolor="#ffffcc"
! bgcolor="#ffff66" |
===Option===
! bgcolor="#0099ff" |
===Meaning===
|-
! bgcolor="#ffff66" | -z
| Base compression on changes from the first image in the time series. By default, compression is basedon sequential changes in the images.
|-
! bgcolor="#ffff66" | -f
|
Do not compress names of APD images (otherwise, the long APD names will be shortened, according to the same rules as "[http://airto.bmap.ucla.edu/BMCweb/HowTo/FixAPDName.html FixAPDName]")
|-
! bgcolor="#ffff66" | -p
| Preserve the file path with the file name. When files are uncompressed, they will be returned to their origiunal directories. Dangerous and not recommended.
|-
! bgcolor="#ffff66" | -d
| Delete the original file after compression.
|-
! bgcolor="#ffff66" | -P
| Create a processing record file with a name of the form "''filename.''SmallTime.proc"
|-
! bgcolor="#ffff66" | -v
| Print somewhat tedious statistics concerning file compressions efficiency
|-
! bgcolor="#ffff66" | -o
| ''followed by the selected name for the output file''. Over-ride SmallTime's naming convention and choose a name for the output file. Since SmallTime does not look at the name of the file for decompression, this can be any name you like. Files ending in '.ST' are only a convenience.
|}

==Macintosh==

The Macintosh version of SmallTime can be found at this link: [http://www.brainmapping.org/SmallTime/ [[Image:SmallTimeLogo.gif]] <nowiki>[http://www.brainmapping.org/SmallTime/]</nowiki>]

You may compress and decompress files by 'dragging and dropping' them onto the program icon (if they are of recognized formats) or you may start SmallTime by double-clicking it and using the menus.

After opening SmallTime, you must press return or enter to dismiss the startup screen.

===compression===

To compress a file, go to the '''File''' menu and select, "'''Compress...'''"
<center>
[[Image:SmallTimeFileMenu.gif]]
</center>
You will be presented with a standard Macintosh file selection dialog. Find the file you wish to compress and select "'''Open'''". SmallTime will then ask you to confirm that you wish to save the file to its default name and location. Change these as you wish.

===uncompression===
From the '''File''' menu, select "'''Expand...'''"
You will be presented with a standard Macintosh file selection dialog. Find the file you wish to uncompress and select "'''Open'''". SmallTime will then ask you to confirm that you wish to save the file (and its header) to its default name and location. Change these as you wish.

===''options''===
Options in the Macintosh version are accessed through the '''Preferences...''' option in the '''File''' menu, which opens a dialog box as shown below:
<center>
[[Image:SmallTimePrefs.gif]]
</center>
''The options are as described above for the unix version''.
'''Sequential''' vs. '''Based on First Image''' refers to which image in the time series is used as a reference for the compression process.
Checking '''Delete original after compression''' forces SmallTime to automatically delete the original file when compression is completed.
'''Delete compressed file after expansion''' will cause SmallTime to remoce the compressed file after the expansion is completed.
The grayed out menu will someday allow you to use SmallTime for data format conversion as well. Stay tuned.
The '''Batch Options''' control what SmallTime does when multiple files are dropped onto the program icon. If '''Automatically name (with *.ST)''' is selected, the compression process will proceed through all files without stopping. Otherwise, you will be asked to confirm the name for each file before it is saved.
The preferences are not stored across SmallTime sessions (they return to the defaults shown when you restart the program.

===verifying===
The Macintosh version of SmallTime allows you to compare two files. This may be useful if your suddenly fantasize that SmallTime has damaged your original file (it hasn't happened yet...). To compare two files, select "'''Compare...'''" from the '''File''' menu.

Compress files using SmallTime - Revision history

Ccn admin: 2 revisions

Mscohen: /* Compress Files using [http://www.brainmapping.org/SmallTime SmallTime] */

Mscohen at 00:03, 12 September 2006