Het handboek van SSCd

Het handboek van SSCd
Peter H. Grasch
Het handboek van SSCd
2
Inhoudsopgave
1
Inleiding
6
2
SSCd gebruiken
7
2.1
Basismap . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
7
2.2
Configuratie . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
7
2.3
2.4
Database . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Vergrendelde modus . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
8
8
2.5
Verzamelde samples uitpakken . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
9
3
Vragen en antwoorden
10
4
Dankbetuigingen en licentie
11
A Installatie
12
Het handboek van SSCd
Lijst van tabellen
2.1
Basismap van SSC . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
4
7
Samenvatting
SSCd is de servercomponent van het hulpmiddel voor het verkrijgen van SSC-samples.
Het handboek van SSCd
Hoofdstuk 1
Inleiding
SSCd is de servercomponent van het hulpmiddel voor het verkrijgen van SSC-samples.
Het beheert gegevens van sprekers (gebruikers, instituten) evenals metagegevens van samples
met behulp van een database en slaat de samples op.
Het ontvangt invoer van de SSC client(s) die via TCP/IP zich verbindt met de server.
Voor meer informatie over de algemene architectuur van de Simon suite kijk op Handleiding
Simon. Voor informatie over de SSC-client, kijk op de Handleiding SSC.
6
Het handboek van SSCd
Hoofdstuk 2
SSCd gebruiken
SSCd is een toepassing voor de opdrachtregel die geen gebruikersinterface heeft. Er zijn geen
speciale opstartparameters.
2.1
Basismap
De basismap van SSCd bevat het configuratiebestand sscd.conf en een foutenlog in geval er iets
fout gaat. Deze map bevat ook de submap samples waar alle samples zijn opgeslagen.
De locatie van de SSCd-map hangt af van uw besturingssysteem:
Microsoft Windows
GNU/Linux
Installatiemap van sscd.exe
(gebruikelijk: C:\Program Files\simon /usr/share/sscd
0.3\bin\sscd.exe)
Tabel 2.1: Basismap van SSC
2.2
Configuratie
Er is geen grafische configuratie van SSCd, maar er is een configuratiebestand (sscd.conf) opgeslagen in de SSCd map.
Het standaard configuratiebestand is zwaar van commentaar voorzien en zou zelfverklarend
moeten zijn.
Voordat u SSCd uitvoert, zult u tenminste de items DatabaseUser en DatabasePassword in het
configuratiebestand willen wijzigen. Zie de database-sectie voor meer informatie.
;
;
;
;
;
;
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
7
Het handboek van SSCd
[ General ]
; 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 =127.0.0.1
; 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 =127.0.0.1
2.3
Database
SSCd slaat de spreker- en sample-gegevens op (maar niet de samples zelf) in een database. Op
dit moment zijn alleen MySQL databases volledig ondersteund. Ondersteuning voor een nieuwe
database is echter triviaal. Neem contact op met het Team van Simon als u wilt helpen.
Om de vereiste tabellen in te stellen biedt SSCd een toepasselijk script voor het aanmaken mysql
_create_script.sql geïnstalleerd in de basismap van SSCd.
Databasefouten zijn te vinden in de error.log die zich ook bevindt in de basismap.
2.4
Vergrendelde modus
SSCd heeft een optie op de opdrachtregel met het argument ´´-l´´ (of ´´--locked´´) om modus
´´vergrendeld´´ in te schakelen (standaard uit).
In modus vergrendeld kunnen clients nog steeds verbinden en samples uploaden evenals nieuwe
microfoons en geluidskaarten aanmaken maar hebben geen toegang (lezen of schrijven) tot persoonlijke gegevens of die van instituten naast de gebruikersnaam en id. Dit kan helpen bij het
beperken van de hoeveelheid privé patiëntinformatie getoond aan teams voor opnemen.
8
Het handboek van SSCd
Tijdens een actieve modus vergrendeld is er ook geen mogelijkheid te zoeken naar gebruikers ga
dus na dat uw team voor opnamen beschikt over een lijst met gebruikers-id’s.
2.5
Verzamelde samples uitpakken
Om modellen te bouwen met de samples verzamelt met SSCd moet u deze eerst uit de database
halen.
WAARSCHUWING
Omdat SSCd ontworpen is voor verzamelen van samples op grote schaal is dit niet gebruikersvriendelijk voor de eindgebruiker. De onderstaande documentatie is hoofdzakelijk geleverd voor technisch
onderlegde professionals.
De meeste onderstaande scripts vereisen de GNU-tools (gebruikelijk standaard beschikbaar op GNU/Linux).
U kunt de volgende query gebruiken (minimale aanpassing zal nodig zijn afhankelijk van welke
samples u exact nodig hebt):
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) ;
Deze query zal een lijst maken van alle samples uit instituut 3 die zijn opgenomen met microfoon
1.
U kunt daarna bijvoorbeeld dit script gebruiken om een bestand met prompts aan te maken:
#!/ 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
Dit bestand met prompts kan dan worden geïmporteerd in Simon.
Om het toepasselijke woordenboek te bouwen om het model te compileren zou u ook een lijst
met alle zinnen in het bestand met prompts willen maken. U kunt dat doen met dit script:
#!/ bin / bash
cat $1 | sed -e ’s /[0 -9\/]* // ’ | sort | uniq
9
Het handboek van SSCd
Hoofdstuk 3
Vragen en antwoorden
In een poging om deze sectie altijd up-to-date te houden is deze beschikbaar op onze online wiki.
10
Het handboek van SSCd
Hoofdstuk 4
Dankbetuigingen en licentie
SSCd
Programma copyright 2008-2010 Peter Grasch [email protected]
Documentatie copyright (c) 2009-2010 Peter Grasch [email protected]
Op- of aanmerkingen over de vertalingen van de toepassing en haar documentatie kunt u melden
op http://www.kde.nl/bugs.
Dit document is vertaald in het Nederlands door Freek de Kruijf [email protected].
Deze documentatie valt onder de bepalingen van de GNU vrije-documentatie-licentie.
Deze toepassing valt onder de bepalingen van de GNU General Public License.
11
Het handboek van SSCd
Bijlage A
Installatie
Kijk op onze wiki voor instructies over installatie.
12