Handbok SSCd. Peter H. Grasch

Transkript

1 Peter H. Grasch

2 2

3 Innehåll 1 Inledning 6 2 Använda SSCd Baskatalog Inställning Databas Låst läge Extrahera insamlade samplingar Frågor och svar 10 4 Tack till och licens 11 A Installation 12

4 Tabeller 2.1 Baskatalog för SSC

5 Sammanfattning SSCd är serverkomponenten i verktyget för insamling av samplingar, SSC.

6 Kapitel 1 Inledning SSCd är serverkomponenten i verktyget för insamling av samplingar, SSC. Programmet hanterar information om inläsare (användarnamn, institutioner) samt metadata för samplingar med användning av en databas, och lagrar samplingarna. Det tar emot indata från SSC-klienter, som ansluter till servern via TCP/IP. För mer information om den allmänna arkitekturen för Simon-programvaran, se Handbok Simon. För information om SSC-klienten, se Handbok SSC. 6

7 Kapitel 2 Använda SSCd Programmet SSCd är ett kommandoradsprogram, som inte har något användargränssnitt. Det finns inga speciella väljare vid start. 2.1 Baskatalog Baskatalogen för SSCd innehåller inställningsfilen sscd.conf och en fellogg om något går fel. Katalogen innehåller också underkatalogen samples där alla samplingar lagras. Platsen för katalogen SSCd beror på operativsystemet: Microsoft Windows GNU/Linux Installationskatalogen för sscd.exe (oftast C:\Program Files\simon /usr/share/sscd 0.3\bin\sscd.exe) Tabell 2.1: Baskatalog för SSC 2.2 Inställning Det finns ingen grafisk inställning av SSCd, men det finns en inställningsfil (sscd.conf) som lagras i katalogen för SSCd. Standardversionen av inställningsfilen har en mängd kommentarer och bör vara självförklarlig. Innan SSCd körs, bör du åtminstone ändra posterna DatabaseUser och DatabasePassword i inställningsfilen. Se avsnittet om databasen för mer information. ; This is an example config file and displays the built - in defaults ; SSCd will look for this file in: ; Linux: ; /usr/share/sscd/sscd.conf ; Windows: ; <sscd installation path >\ sscd. conf [General] 7

8 ; Change this to use a different database; Because SSCd uses db - specific ; commands in places, only QMYSQL is supported at the moment. ; Support for other DBMS can be added extremely easily, though so please ; feel free to request support through kde - accessibility@kde. org DatabaseType = QMYSQL ; The host of the DBMS DatabaseHost = ; The port of the DBMS; 3306 is the default port of MySQL DatabasePort =3306 ; The database to use; Make sure that you run the supplied create script ; before you use SSCd DatabaseName = ssc ; The username to use when connecting to the DBMS DatabaseUser = sscuser ; Database password. The default one will obviously not work in most cases DatabasePassword = CHANGE ME NOW ; Database options. Refer to Qts documentation of QSqlDatabase for details DatabaseOptions = MYSQL_OPT_RECONNECT =1 ; The port the server will listen to; Default: 4440 Port =4440 ; Bind the server to a specific client IP; If this is true, the server ; will ignore requests from all but the BoundHost ( see below) Bind=false ; IP of the bound host ( if Bind is active) BindHost = Databas SSCd lagrar inläsare och information om samplingar (men inte själva samplingarna) i en databas. För närvarande stöds bara MySQL-databaser fullständigt. Att lägga till stöd för en ny databas är dock mycket enkelt. Kontakta Simon-gruppen om du vill hjälpa till. För att skapa nödvändiga tabeller, levereras SSCd med ett lämpligt skript mysql_create_script.sql installerat i baskatalogen för SSCd. Databasfel kan hittas i error.log som också finns i baskatalogen. 2.4 Låst läge SSCd kan valfritt använda kommandoradsväljaren -l (eller --locked ) för att aktivera låst läge (normalt inaktivt). I låst läge kan klienter fortfarande ansluta och ladda upp samplingar samt skapa nya mikrofoner och ljudkort, men kan inte komma åt (läsa eller skriva) någon personlig eller institutionsdata förutom användarnas namn och id. Det kan vara till hjälp för att begränsa den mängd privat patientinformation som visas för inspelningsteam. 8

9 När låst läge är aktivt finns det inte heller någon sökning av användare, så försäkra dig om att en lista med användar-id tillhandahålls till inspelningsteamet i förväg. 2.5 Extrahera insamlade samplingar För att bygga modeller med samplingarna som samlats in med SSCd måste du först extrahera dem från databasen. VARNING Eftersom SSCd är konstruerat för insamling av samplingar i stor skala, är det inte användarvänligt. Dokumentationen nedan tillhandahålls i huvudsak för tekniskt skickliga proffs. De flesta skript nedan kräver GNU-verktygen (oftast standardmässigt tillgängliga på GNU/Linux). Du kan använda följande förfrågan (mindre justeringar är nödvändiga beroende på exakt vilka samplingar du behöver): use ssc; select s. Path, s. Prompt from Sample s inner join User u on s. UserId = u. UserId inner join UserInInstitution uii on u. UserId = uii. UserId inner join SampleType st on s. TypeId = st. SampleTypeId inner join Microphone m on m. MicrophoneId = s. MicrophoneId WHERE st. ExactlyRepeated =1 and uii. InstitutionId = 3 and (m. MicrophoneId = 1); Denna förfrågan listar samplingar från institution 3 som spelades in med mikrofon 1. Därefter kan du exempelvis använda detta skript för att skapa en frågefil: #!/ bin/bash sed 1d $1 > temp_out sed -e s /\\\\/\//g -e s/.* Samples \///g -e s/\. wav\t/ / temp_out > $1 rm temp_out Denna frågefil kan därefter importeras i SImon. För att bygga den lämpliga ordlistan för att kompilera modellen, kan du också behöva lista alla meningar som finns i frågefilen. Du kan göra det med detta skript: #!/ bin/bash cat $1 sed -e s/[0-9\/]* // sort uniq 9

10 Kapitel 3 Frågor och svar För att alltid försöka hålla avsnittet uppdaterat är det tillgängligt på vår wiki. 10

11 Kapitel 4 Tack till och licens SSCd Program copyright Peter Grasch peter.grasch@bedahr.org Dokumentation Copyright (c) Peter Grasch peter.grasch@bedahr.org Översättning Stefan Asserhäll stefan.asserhall@bredband.net Den här dokumentationen licensieras under villkoren i GNU Free Documentation License. Det här programmet licensieras under villkoren i GNU General Public License. 11

12 Bilaga A Installation Se vår wiki för installationsinstruktioner. 12