Sclip(sound clip) is a software that cut out a part of sound in a wav
format according to time information.
Sclip is a java application. The environment sclip requires is JRE
newer than version 1.4.

#############
Usage 1:
sclip [sound data] [start time] [end time] [output file]

Time information is indicated in a form of [hh:mm:ss] or a total
second. The second is indicated in real numbers. This style of time
information is feasible in all the following usages.

#############
Usage 2:
sclip -f [batch file]

Time information is indicated in a CSV format. White space is not
permitted in this batch file.

Each Record:
[sound data],[start time],[end time],[output file]

Example:
sample1.wav,10,0:20:10.5,test1.wav
sample1.wav,20,00:12:20,test2.wav
sample2.wav,30,00:20:30.5,test3.wav

If there is no output file information, the file name is automatically
given by sclip.

In this usage, the batch file can be made in a GIST format (General
Time Information for Linguistics), which is defined by Ohya 2015,
ICLDC4.

#############

If you want use a shared sound data as an input data in every record
in a batch file, the following usages are easier and faster than the
previous usages.

#############
Usage 3:
sclip -a [shared sound data] [time information file]

The shared sound data is divided into parts of sound data according to
the time information file, which consists of records in a CSV format.

Each Record:
[start time],[end time],[output file]

Example:
10,0:20:10.5,test1.wav
20,00:12:20,test2.wav
30,00:20:30.5,test3.wav

In this record, it is prohibited to use a white space.
If there is no output file information in a record, the file name is
automatically given with a sound data file name and three-digit
numbers.
In this time information file, GIST(General Time Information
for Linguistics) format can be used(cf. Ohya 2015, ICLDC4).

#############
Usage 4:
sclip -c [shared sound data] [time information file]

The shared sound data is divided into parts of sound data according to
the time information file, which consists of records in a CSV format
with a white space delimiter.

Example:
00:04:39.3 00:05:15.0 01.wav
00:07:25.8 00:08:07.4 02.wav
00:11:08.7 00:12:11.1 03.wav

If there is no output file information in a record, the file name is
automatically given with a sound data file name and three-digit
numbers.

#############
Usage 5:
sclip -s [shared sound data] [time information file]

The shared sound data is divided into parts of sound data according to
the time information file, which consists of records in a CSV format
with a white space delimiter. Unlike in the previous case of option
-c, an output file name must be givenn in each record.

Example:
00:04:39.3 00:05:15.0 01
00:07:25.8 00:08:07.4 02
00:11:08.7 00:12:11.1 03
00:13:46.2 00:14:57.5 04
00:01:23.2 00:02:28.6 05
00:01:23.2 00:02:28.6 06

As this time information file, a file made by Sony Sound Forge can be
used.

Example of Sound Forge:
start_region_table
00:04:39.3 00:05:15.0 01.wav
00:07:25.8 00:08:07.4 02.wav
end_region_table

The lines of "start_region_table" and "end_region_table" will be
neglected in sclip, thus we do not need to be care of them.

#############
Usage 6:
sclip -e [shared sound data] [time information file]

This time information file is made by ELAN that is a software
implemented by MPI. This file is called an EAF file.
Please note that sclip uses ID data of each time period that is
automatically given by ELAN, not use label information that can be
added on ELAN.

#############
Usage 7:
sclip -o [shared sound data] [time information file]

This time information file is made by Audacity that is a very famous
free software for sound editing.
Sclip uses labels in this file as names of an output file, thus please
be careful not to use the same name in different parts. Sclip
overwrites a file with the same name on the existing file with the
name.

#############
Usage 8:
sclip -p [shared sound data] [time information file]

This time information file is made by Praat that is a famous academic
free software for sound analysis.
Sclip uses label information as a cue to save a part of sound data and
as a part of an output file name.

#############
Usage 9:
sclip -v

It shows a version of sclip.


#############

This software sclip was made with support of LingDy Project in Tokyo
University of Foreign Studies,
(https://sites.google.com/site/lingdytextarchive/)
and has been managed with support of Japan Grant-in-Aid for Scientific
Research(B)(Grant Number 23401025) and (C)(Grant Number 26370512).
This software is for academic activities, thus it is a very
unfriendly software, so please be patient in a case of being visited
by errors.


2014-01-28 OHYA Kazushi <!-- 大矢一志 -->
oya-k@tsurumi-u.ac.jp
