CRE Method Library (makelibrary, load, unload, list)

Synopsis

makelibrary

loadvolume volume_id method_file

unloadvolume volume_id

listvolumes

listmethods

Description

CRE stores methods in a database. It is maintained in a number of CSV files, which are also called volumes (which may be edited in Excel).

CRE comes with the following volumes:

plain - Plain methods (treble plain hunts)

principle - Principles: all bells do the same work

trebledodging - treble-bob, delight and surprise

These volumes exist as CSV files in the methods folder of the CRE folder structure

Creating the Database

On the first time that CRE run, the library database is automatically created with the default volumes. The library is retained and available for subsequent runs. To recreate the library at anytime, use the command makelibrary.

Listing available volumes

To list volumes in the library, use the listvolumes command. It only shows the name of the volume, and not the contents. For example:

CRE> listvolumes
default
plain
principle
trebledodging

N.B. there is a volume called default which consists of plain hunting on all the available numbers of bells. It cannot be changed or removed.

Making changes to volume and reloading

In order to make changes, for example to add a new method, the volume CSV file must be edited and reloaded into the library. To reload a particular volume, use the loadvolume command; for example:

CRE> loadvolume trebledodging trebledodging.csv

Removing a volume

To remove a volume, use the unloadvolume command; for example

CRE> unloadvolume trebledodging

Structure of a volume

The comma separated value (CSV) file for the volume has the following columns, which are also used by the method command:

Method Name (A) - name of method, without the suffix

Number of Bells (B) - number of bells

Plain Lead (C) - place notation for a plain lead. Excel will output the value in quotes if it contains any commas

Call Row (D) - row of plain lead where call takes effect (0 is the leadend, -1 is the penultimate row etc)

Bob (E) - place notation of the rows to be substituted for a bob (blank if bobs not used)

Single (F) - place notation of the rows to be substituted for a single (blank if singles not used)

Volumes can contain any number of methods, provided the method name (for a particular number of bells) is unique. Also the method name must be unique across all volumes; for example it is not possible to call a 6 bell method "Fred" in both the plain and trebledodging volumes. In this example, Plain Bob Minimus, Grandsire Doubles and Plain Bob Doubles are defined.

Method Name,Number of Bells,Plain Lead,Call Row,Bob,Single
Plain Bob,4,"&x14x14,12",0,,
Grandsire,5,"3,&1.5.1.5.1",-1,3.1,3.123
Plain Bob,5,"&5.1.5.1.5,125",0,145,123