lymelib2db 2.2

lymelib2db.m is a utility for Sysquake and Matlab which lets you convert a set of LyME libraries to a PDB file ready to be uploaded to the Palm. It may be used on any computer which supports Sysquake or Matlab.

lymelib2db.c is the source code of a utility which does the same as lymelib2db.m, but without Sysquake or Matlab; it runs on Windows, Mac OS X, Linux and other unix computers.

Introduction

Sysquake and Matlab are desktop scientific applications running on desktop computers. LyME is a Matlab-compatible application running on Palm handheld computers. Programs for LyME are stored as source code (text) in the records of a database inside the Palm. This database may be created on the desktop computer by converting text files (one per record) using lymelib2db. Each file contains either a set of (related) functions, called a library, or a sequence of statements, called a script.

Because of limitations of the Palm OS text fields used by LyME, LyME cannot edit records larger than a few thousands characters. The available memory and the version of Palm OS also limit the size of libraries. However, the limit of the size of records is much higher (about 64000 characters).

Using lymelib2db.c

lymelib2db-* and lymelib2db.exe are versions of lymelib2db compiled for different platforms. Makefile-unix is a makefile for GNU Make which compiles lymelib2db and converts LyME standard libraries. Please open it with a text editor to update it to your needs. For help, run lymelib2db without any argument. To create stdlib.pdb, for instance, the following command has been typed on a Macintosh in the Terminal application:

cd pathOfDB
./lymelib2db-macosx -n stdlib ../Install/stdlib.pdb ../lib/stdlib.lml

Using lymelib2db.m

lymelib2db implements the following function:

lymelib2db({inputfile1, inputfile2, ...}, outputfile, databasename)

where the first argument is a list of paths (strings) to the input files (libraries and scripts), the second argument is the path of the PDB database file created by lymelib2db, and the third argument is the database name as a string. Since the database is merged with LyME main database the next time LyME is run, this name is not crucial; you should choose one which is unique to your library or set of libraries.

Here are ways to use lymelib2db:

With Matlab:

when a dialog box is displayed, type the file name and choose a location for the PDB file, which should end with a .pdb suffix.

With Sysquake (not Sysquake LE, which doesn't implement low-level file i/o):

To create the library databases provided with LyME, commands like the following one have been typed in the Command Window of Sysquake:

lymelib2db({getfile},putfile,'stdlib')

When dialog boxes appear, one of the files in folder "lib" was selected, then the corresponding database name was typed. Currently, libraries are distributed in separate databases to make their installation and upgrade more flexible.

Uploading the PDB file to the Palm

To install the databases, use the Install feature of the HotSync application. On next LyME startup, if you have installed a library which already exists, LyME will ask you if you want to discard the old one.

License

lymelib2db and its documentation: Copyright 2001-2006, Calerga Sarl. All rights reserved. lymelib2db may not be redistributed without LyME (consequently, you should comply with LyME's license).

The user assumes all the risks caused by the use of lymelib2db. Under no circumstance will Calerga or its resellers be responsible for any loss of money, time, data, goods, or lives.


Calerga Sarl
http://www.calerga.com
6 October 2006