load_macshapa_db()

load_macshapa_db()

load_macshapa_db(filename, write_to_gui, *ignore_vars)

Opens an old, closed MacSHAPA spreadsheet file and loads it into the current open spreadsheet.

Warning

load_macshapa_db() only reads in matrix and string columns. It does not yet support predicates, and queries are not imported. In order to be compatible with Datavyu, all times will be converted to milliseconds.

Parameter

Type

Description

filename

String

The full path to save the saved MacSHAPA file.

write_to_gui

Boolean

If true, the MacSHAPA file is read into the spreadsheet that is currently open in Datavyu’s GUI. If false, the MacSHAPA file is read into the Ruby interface.

Returns

$db, the spreadsheet data and $pj, the project data for that file.

Example

The following example loads the test.opf MacSHAPA file and into ruby variables called $db and $pj.

require 'Datavyu_API.rb'
begin
   $db,$pj = load_db("~/Desktop/test.opf", FALSE)
end

Example

In this example, the test.opf MacSHAPA file is read into the spreadsheet that is currently open in Datavyu’s GUI.

require 'Datavyu_API.rb'
begin
   $db, $pj = load_db("~/Desktop/test.opf", TRUE)
end