README.TXT for COREX version 5 December 22 2002 For those of you curious for the meta data vocabulary used we refer to the ISLE Metadata Initiative at http://www.mpi.nl/ISLE. For the MPI COREX team: Daan Broeder, Max-Planck Institute for Psycholinguistics --------------------------------------------------------------------------- --------------------------------------------------------------------------- INSTALLATION: This is version 5 of the COREX exploitation software for the CGN corpus release 4. This software was tested on Win2000, Win/NT, WIN98, WINXP, Sun Solaris (Sparc), Linux and MacOSX. For windows platforms the installation script copies a complete JAVA environment to the local computer in order to be independent from and avoid version mismatches with local JAVA installations. You need to have about 800 MB free disk space for the corex programme environment and all the CGN annotation files that are also installed by this install script. The annotation files need to be installed on your computer to leave the CD drive free for loading the CDs with audio files. Although the total number of textfragments is now near 10000 we managed to put the whole COREX release on one CD. This by compressing most annotation files. If however you need access to the transcription files themselves as is possible from COREX, you can decompress them. The COREX software will work with both compressed and uncompressed files. The special ".sea" files should remain uncompressed!!! You do not need to remove any older COREX releases if you have enough disk space available. This release should be installed (and does so by default) in its own directory. The install scripts copy lots of data so be patient! To install for Windows platforms: - Run the file install-win.bat. This will create a directory C:\COREX5 by default and copy all necessary files to this directory. If you want to install the software in another directory, for instance in d:\MYDIR, type: install-win.bat D:\MYDIR The install script will also create a bat file "corex.bat". This bat file starts up the corex programme. - Create a desktop icon that points to the file C:\COREX\corex.bat if you like. (Note) Installing on Windows98 might produce an error at the end of the procedure that can be ignored. The programme has still been installed correctly. To install for Unix platforms (only tested on Linux & Solaris): - Run the install-ux.pl perl script with as argument the desired installation directory. For instance to install in /usr/local perl install-ux.pl /usr/local/ The install script will create a command file "corex" that when executed will start up the COREX programme. It is expected that both java and perl executables are in your path!!! Some jars will be copied to the installation directory. However they might not be compatible with jour version of java, in that case you will have to experiment a bit with other versions! Linux configuration: SuSE-Linux 7.1 Java 1.3.0_2 Perl 5.6.0 xerces 1.4.2 jmf 2.1 Sparc Solaris configration: SunOS 5.8 Java 1.3.1 Perl 5.005 xerces 1.4.2 jmf 2.1 To install for MacOS X - Run the install-macosx.pl perl script with as argument the desired installation directory. For instance to install in /users/myname perl install-macosx.pl /users/myname/ The install script will create a command file "corex" that when executed will start up the COREX programme. It is expected that both java and perl executables are in your path!!! Some jars will be copied to the installation directory. Some jars will be copied to the installation directory. However they might not be compatible with jour version of java, in that case you will have to experiment a bit with other versions! We tested this release with java version 1.3.1 REQUIRED SOFTWARE: For the windows platforms all software is included and will be installed except other programmes as Praat that can serve as extensions for COREX. For the unix platforms. You need to supply Java, JMF, Perl or your platform already provides it. For a list with information what versions are required see our website http://www.mpi.nl/COREX REQUIRED HARDWARE: A pentium II 400 with 128 Mb is the very least you should have. You may try less powerful platforms but be prepared to be patient. AVAILABLE EXTENSIONS Using the COREX programme together with the "Praat" programme imposes more speed and memory requirements. Be sure to keep the list of data objects within Praat to a minimum. KNOWN BUGS: 0.1.0.0 The "OR" function in the search panel does not work correctly, it has been removed from the latest version. USER MANUAL: There is a (short) user manual: corexman.doc, updates will be placed on http://www.mpi.nl/COREX FURTHER INFORMATION: For the latest new on "known bugs", "installation problems", "sofware updates" see the website: http://www.mpi.nl/COREX BUGREPORTS: Reports on bugs not mentioned here or at http://www.mpi.nl/COREX can be sent to: cgn@let.kun.nl but be sure to write "COREX" in the subject field RIGHTS & RESTRICTIONS & GUARANTEES: This software version is for use with CGN annotation & audio data. All other use is unsupported. All commercial use is prohibited. This version is delivered as such and no claims are made concerning the functionality of the software except that we will try to remove bugs and provide a functioning version. Where the term functioning will be defined in consultation with the proper CGN staff. (C) Max Plank Institute for Psycholinguistics Wundtlaan 1 6525 XD Nijmegen