exp_2017_03_07- creates a solid based on moved cvl

% exp_2017_03_07 - creates a solid based on moved cvl % (by Tim Lueth & Florian Schleich, VLFL-Lib, 2017-MÄR-07 as class: % EXPERIMENTS) % % exp_2017_03_07 %

copyplot- copies the content of one figure into a random one

% copyplot - copies the content of one figure into a random one % (by Tim Lueth, VLFL-Lib, 2017-MÄR-05 as class: USER INTERFACE) % % This fnctns helps to save figure content of figures that will be closed % into another one (Status of: 2017-03-05) % % See also: snapplot, PRplot % % copyplot %

RRkeyboardstring(inpstr)- processes a char array similar to an input scan process

% RRrun.RRkeyboardstring(inpstr) - processes a char array similar to an input scan process % (by Tim Lueth, RoundRobin, 2017-MÄR-03) % % This fnctns is required if keyboard sequences should be send to % Matlab's eval command % Some characters such as backspace (08) eliminate the preceding % character. (Status of: 2017-03-07) % % outstr=RRkeyboardstring(inpstr) % === INPUT PARAMETERS === % inpstr: input string including all control characters % === OUTPUT RESULTS ====== % outstr: some control characters are processed %

RRrun (RRtasklist.t0,RRmaxtime)- starts Round-Robin Task-List Realtime Environment in stopped state

% RRrun (RRtasklist.t0,RRmaxtime) - starts Round-Robin Task-List Realtime Environment in stopped state % (by Tim Lueth, RoundRobin, 2017-MÄR-02) % % Matlab is used to execute the task strings as command line and task % handles as fnctn call. % The user has the feeling to use the Matlab command interface but in % fact in parallel a set of fnctns runs as round robin task list. % Some commands are helpful to understand the environemnt: % whos - shows all variable used in this environment % RRprompt - Prompt string 'RRrun' % RRtasklist.t0 = cycle time % % Some command line commands are new or treated in a different way: % QUIT, EXIT - stops the shell; it can be restarted by RRrun, % persistent/global % LIST, SHOW shows the task list % ADD - appends a task at the end of the task list % STEP - executes the task list exactly one time % CONT, GO, START - starts the task execution % STOP, BREAK - stops the task execution % SAVE - saves the task in a file in the current directory % LOAD - load the task list from a file in the current directory % % KILLALL - deletes all tasks in the task list % KILL # - delete the task with the 3rd column has the unique nr # % % EXE, EXECUTE - reads in command text file and executes all commands, % requires START % % Have in mind that inter task communication is only possible by % variables declared as global! % (Status of: 2017-03-04) % % See also: RRshell % % RRrun([RRtasklist.t0,RRmaxtime]) % === INPUT PARAMETERS === % RRtasklist.t0: Clock cycle time; default is 0.1 % RRmaxtime: maximum duration time; default is 600 seconds % % EXAMPLE: start some tasks and see the result % BREAK % KILLALL % global PL; PL=[0 0 0]; % ADD global PL; PL=[PL; PL(end,:)+rand(1,3)]; % ADD global PL; VLplot(PL,'b.-',2); view(-30,30); grid on; % LIST % STEP % START % % %

RRLappendTask(RRL,command,rep)- appends a command at the end of the task list

% RRrun.RRLappendTask(RRL,command,rep) - appends a command at the end of the task list % (by Tim Lueth, RoundRobin, 2017-MÄR-02) % % See also: RRshell, RRkeyboardCallback, RRcreateTasklist, RRhelp % % RRL=RRLappendTask(RRL,command,[rep]) % === INPUT PARAMETERS === % RRL: Round-Robin Task List % command: command to execute % rep: number of repeats; default is inf % === OUTPUT RESULTS ====== % RRL: Extended RRL %

RRhelp- returns the help text for the Round-Robin realtime-environment

% RRhelp - returns the help text for the Round-Robin realtime-environment % (by Tim Lueth, RoundRobin, 2017-MÄR-02) % % The Round-Robin realtime-environment should help to understand how % simple realtime systems can be implemented in Matlab or on % Mikrocontroller without realtime operating systems. Round-Robin is a % sub-optimal realtime solution but should be understood before using % something such QNX or Kithara. It consists of two concepts: % a) A list of tasks (i.e. fnctn calls) that are executed sequentially % every nn milliseconds % b) A user shell that allow to modify dynamically this task list during % execution % % THE SHELL % - RRshell opens a figure, installs a new keyboard fnctn, collects data % and executes commands using the Matlab fnctn EVAL. RRshell stops after % a predefined period of time. The user has the feeling still to use the % Matlab command line. Only the different prompt shows the difference. % - RRkeyboardCallback is the keyboard callback fnctn installed by % RRshell to collect keyboard data similar to the Matlab command line. % The entered character lines are interpreted and executed by RRshell. % The fnctn is visible since maybe also other tasks should have access to % the keyboard chars. (Status of: 2017-03-05) % % See also: RRshell, RRkeyboardCallback, RRcreateTasklist % % RRhelp %

RRkeyboardCallback- this callback function collects keyboard character and stores it into two global variables

% RRrun.RRkeyboardCallback - this callback fnctn collects keyboard character and stores it into two global variables % (by Tim Lueth, USELESS, 2017-MÄR-02) % % This callback fnctn is called by RRshell after opening a figure as % entry window. It uses several global variables for exchange with % RRshell: % global RRwindow - handle to the RRShell figure % global RRkeyboardLine - command line to execute after CR % global RRkeyboardCurs - string to collect character before execution % (Status of: 2017-03-03) % % See also: RRshell, RRcreateTasklist, RRhelp % % RRkeyboardCallback %

RRshell (PROMPT,MAXTIME)- Runs an interpreter shell for a limited period of time to simulate a realtime system

% RRrun.RRshell (PROMPT,MAXTIME) - Runs an interpreter shell for a limited period of time to simulate a realtime system % (by Tim Lueth, RoundRobin, 2017-MÄR-02) % % RRshell opens a figure and installs a new keyboard callback fnctn % "RRkeyboardCallback". The "RRkeyboardCallback" fnctn writes pressed % keyboard character into global variables "RRkeyboardLine" and % "RRkeyboardCurs". As soon as CR is pressed, "RRkeyboardLine" contains % the char chain. RRshell now analyzes some master keyowrds such as % "STOP", EXIT', QUIT" and "END". In all other cases the "eval" fnctn of % Matlab is used to execute the string as command line. % The user has the feeling to control Matlab directly but in fact in % parallel a set of fnctns runs as round robin task list (Status of: % 2017-03-05) % % See also: RRkeyboardCallback, RRhelp, RRcreateTasklist % % RRshell([PROMPT,MAXTIME]) % === INPUT PARAMETERS === % PROMPT: Desired entry prompt; default is "RRshell" % MAXTIME: Maximum time before exit the shell; default is 60 seconds %

RRcreateTasklist(t0,funclist,twarn,tstop)- creates a Round Robin task list

% RRrun.RRcreateTasklist(t0,funclist,twarn,tstop) - creates a Round Robin task list % (by Tim Lueth, RoundRobin, 2017-MÄR-02) % % Matlab is an extreme powerful programming environment that allows to % create even simple round robin realtime systems for every body. It % makes sense to understand the principles of a round robin system before % using matlab threads on a not-realtime-operationg system and before % switching to realtime-OS such as QNX or Kithara. % This "Round Robin task list" class works with real fnctns handles and % persistent and global variables as well as with simple matlab command % line commands. (Status of: 2017-03-05) % % See also: RRshell, RRkeyboardCallback, RRhelp % % RRL=RRcreateTasklist([t0,funclist,twarn,tstop]) % === INPUT PARAMETERS === % t0: Clock cycle time % funclist: cell list of fnctn handles % twarn: optional warning time; default is INF % tstop: optional stop time; default is INF % === OUTPUT RESULTS ====== % RRL: Round Robin List struct % % EXAMPLE: % RRcreateTasklist(1,{' PL=[0 0 0]; PLplot(PL); show;';... % 'PL=[PL;PL(end,:)+rand(1,2)'}) %

RRexecuteTasklist- executes all tasks in the global RRtasklist one time

% RRrun.RRexecuteTasklist - executes all tasks in the global RRtasklist one time % (by Tim Lueth, RoundRobin, 2017-MÄR-02) % % Private fnctn in RRrun % The fnctn executes all tasks in the global RRtasklist one time if the % use counter is larger than 1. Afterwards the use counter is decreased % by 1. All tasks with use counter ==0 are deleted (Status of: 2017-03-07) % % RRexecuteTasklist %

helptextofcaller- returns the helptext of the calling function

% helptextofcaller - returns the helptext of the calling fnctn % (by Tim Lueth, VLFL-Lib, 2017-MÄR-01 as class: AUXILIARY PROCEDURES) % % This fnctn is usefull to create fnctn such as FMhelp that just return % their own helptext. % Does work only as part of a fnctn. (Status of: 2017-03-01) % % See also: titleofcaller % % htext=helptextofcaller % === OUTPUT RESULTS ====== % htext: help text % % EXAMPLE: FMhelp %

FMclose(conn)- closes a connection

% FMclose(conn) - closes a connection % (by Tim Lueth, FileMaker, 2017-MÄR-01) % % same as close(conn) % (Status of: 2017-03-01) % % See also: FMhelp, FMinitJDBC, FMopen, FMgetFieldTabs, FMsqlQuery % % LITERATURE: % Filemaker (2013): "SQL-Referenzhandbuch FM 13", % https://fmhelp.filemaker.com/docs/13/de/fm13_sql_reference.pdf % % FMclose(conn) % === INPUT PARAMETERS === % conn: Connection to FileMaker Database %

FMgetFieldTabs (conn)- returns structure of the FielMaker database

% FMgetFieldTabs (conn) - returns structure of the FielMaker database % (by Tim Lueth, FileMaker, 2017-FEB-28) % % FMsqlQuery(conn,'SELECT TableName FROM FileMaker_Tables') % FMsqlQuery(conn,'SELECT * FROM FileMaker_Tables') % FMsqlQuery(conn,'SELECT * FROM FileMaker_Fields') % (Status of: 2017-02-28) % % See also: FMhelp, FMinitJDBC, FMopen, FMsqlQuery % % LITERATURE: % Filemaker (2013): "SQL-Referenzhandbuch FM 13", % https://fmhelp.filemaker.com/docs/13/de/fm13_sql_reference.pdf % % FMgetFieldTabs(conn) % === INPUT PARAMETERS === % conn: Connector to Database %

FMsqlQuery(conn,sqlreq)- returns the answer to a SQL request to a FileMaker database

% FMsqlQuery(conn,sqlreq) - returns the answer to a SQL request to a FileMaker database % (by Tim Lueth, FileMaker, 2017-FEB-28) % % See also: FMhelp, FMinitJDBC, FMopen, FMgetFieldTabs % % LITERATURE: % Filemaker (2013): "SQL-Referenzhandbuch FM 13", % https://fmhelp.filemaker.com/docs/13/de/fm13_sql_reference.pdf % % ans=FMsqlQuery(conn,sqlreq) % === INPUT PARAMETERS === % conn: Connector to a FileMaker database % sqlreq: sql request % === OUTPUT RESULTS ====== % ans: answer % % EXAMPLE: Different helpful requests: % FMsqlQuery(conn,'SELECT TableName FROM FileMaker_Tables') % FMsqlQuery(conn,'SELECT * FROM FileMaker_Tables') % FMsqlQuery(conn,'SELECT * FROM FileMaker_Fields) %

FMgetData(conn,fieldname,tabname)- returns all field values from a table of an open FileMaker database

% FMgetData(conn,fieldname,tabname) - returns all field values from a table of an open FileMaker database % (by Tim Lueth, FileMaker, 2017-FEB-28) % % Uses the JDBC Driver Solution to access FileMaker from Matlab % % The Filemaker SQL Interface is documented in: (Status of: 2017-02-28) % % LITERATURE: % Filemaker (2013): "SQL-Referenzhandbuch FM 13", % https://fmhelp.filemaker.com/docs/13/de/fm13_sql_reference.pdf % % ans=FMgetData(conn,fieldname,tabname) % === INPUT PARAMETERS === % conn: Connector to Database % fieldname: Field Name % tabname: Table Name % === OUTPUT RESULTS ====== % ans: %

FMinitJDBC(cname)- checks the existance of the FileMaker JDBC driver and copies it into the javaclasspath

% FMinitJDBC(cname) - checks the existance of the FileMaker JDBC driver and copies it into the javaclasspath % (by Tim Lueth, FileMaker, 2017-FEB-28) % % This fnctn installs the FileMaker JDBC driver ("fmjdbc.jar") and must % be called before accessing the database the first time. It is not % automatically called by FMopen. It can be called several times without % any problem. The driver file name has the same name for PC and Mac. % Nevertheless the content differs with FileMaker version and platform. % (Status of: 2017-03-01) % % See also: FMhelp, FMopen, FMgetFieldTabs, FMsqlQuery % % LITERATURE: % Filemaker (2013): "SQL-Referenzhandbuch FM 13", % https://fmhelp.filemaker.com/docs/13/de/fm13_sql_reference.pdf % % FMinitJDBC([cname]) % === INPUT PARAMETERS === % cname: full path and filename to "fmjdbc.jar". default is searching in % searchpath % % EXAMPLE: % FMinitJDBC('fmjdbc.jar') % %

FMopen(fname,user,passw)- opens a FileMaker Database by the FileMaker Application

% FMopen(fname,user,passw) - opens a FileMaker Database by the FileMaker Application % (by Tim Lueth, FileMaker, 2017-FEB-28) % % Tries to find the database in the working director or globally and in % the desktopdir. Default extension is ".fmp12" (Status of: 2017-03-01) % % See also: FMhelp, FMinitJDBC, FMgetFieldTabs, FMsqlQuery % % conn=FMopen(fname,[user,passw]) % === INPUT PARAMETERS === % fname: filename % user: user name default is Admin % passw: password; default is '' % === OUTPUT RESULTS ====== % conn: connector. % % EXAMPLE: Open a database using the system and try to connect using JBDC % Driver % conn=FMopen('FileMakerTestBase.fmp12','user','passw') %

FMhelp- returns a help text for the FileMaker-Matlab interface

% FMhelp - returns a help text for the FileMaker-Matlab interface % (by Tim Lueth, FileMaker, 2017-FEB-28) % % Tobias Lüddemann did start the connection of FileMaker and Matlab using % 2012b and FileMaker Pro 11. There is a document dated 2014-11-27 at TUM % MIMED. % Tim Lueth capsulated the JDBC FileMaker interface using Matlab 2016b % and FileMaker 13 starting February 2017. The solution described here % works with Filemaker 13 and later. % % The Matlab Database Toolbox is required. You need a license for that. % The xDBC Drivers for Filemaker can be downloaded from the Filemaker % WWW-Site for your Filemaker Version % The JDBC Driver "fmjdbc.jar" is part of this package. % This driver file has to be added to the javaclasspath (which is done by % the fnctn FMinitJDBC) % % For connecting to the Filemaker App you have to: % SWITCH ON FILESHARING for ALL Users (Filemaker & Database) % SWITCH ON ODBC-JDBC-Sharing: for ALL Users (Filemaker & Database) % % Lueth's fnctns to support the connection to Filemaker are: % FMhelp - This fnctn % FMinitJDBC - Opens the Driver "fmjdbc.jar" % FMopen - to open a database with user name and password % FMgetFieldTabs - to get informations on the Database % FMsqlQuery - to send requests or data to the Databse % ...there are some fnctns all starting with capital letters "FM" % % (Status of: 2017-03-01) % % See also: FMhelp, FMinitJDBC, FMopen, FMgetFieldTabs, FMsqlQuery % % LITERATURE: % Filemaker (2013): "SQL-Referenzhandbuch FM 13", % https://fmhelp.filemaker.com/docs/13/de/fm13_sql_reference.pdf % % FMhelp % % EXAMPLE: How to use the library after copying "fmjdbc.jar" in a search % path directory: % FMinitJDBC('fmjdbc.jar') % conn=FMopen('Basename.fmp12','user','passw') % FMgetFieldTabs(conn) % FMsqlQuery(conn,'SELECT * FROM FileMaker_Tables') %

CPLoutercontour(CPL,out)- returns for a CPL the outer contour wrt cw/ccw-orientation

% CPLoutercontour(CPL,out) - returns for a CPL the outer contour wrt cw/ccw-orientation % (by Tim Lueth, VLFL-Lib, 2017-FEB-28 as class: CLOSED POLYGON LISTS) % % Uses PLoutercontour but returns only the outer CPL. The outer/inner % contoru decision is made by selecting the cw/ccw-orientation of each % contour. (Status of: 2017-04-15) % % See also: PLoutercontour, CPLgrow % % NCPL=CPLoutercontour([CPL,out]) % === INPUT PARAMETERS === % CPL: Closed Polygon Line; separated using NaN NaN % out: returns the FIRST outer contour if true; if false the first inner; % default is true % === OUTPUT RESULTS ====== % NCPL: New CPL % % EXAMPLE: % PLoutercontour(CPLgrow(CPLsample(19),4)) % CPLoutercontour(CPLgrow(CPLsample(13),2)) %

titleofcaller(n)- returns the name of the calling function plus date & time as string

% titleofcaller(n) - returns the name of the calling fnctn plus date & time as string % (by Tim Lueth, VLFL-Lib, 2017-FEB-28 as class: USER INTERFACE) % % This fnctn help to create titles for figures and axes (Status of: % 2017-03-19) % % See also: SGfigure, SGtitle, title, figure, helptextofcaller % % t=titleofcaller([n]) % === INPUT PARAMETERS === % n: hierarchy of calling fnctns; default is 0; % === OUTPUT RESULTS ====== % t: string with caller and date and clock % % EXAMPLE: Use at the end of your own fnctns: % if nargout==0 % SGfigure; view (0,90); title (titlefocaller); % end %