# Translating The editor, the command line and the messages of the library show their text in the language [chosen as Getting started describes](getting-started.md#language). English is the text in the code; each other language has a catalog, `src/acoustic_spaces/locale/.po` (gettext's format, which translation tools such as Poedit and Weblate read). Spanish (`es.po`), Catalan (`ca.po`), Italian (`it.po`), German (`de.po`) and Dutch (`nl.po`) cover the editor, its plots and the examples' descriptions. What stays in English in every language: scene files (their keys and values), command and option names, the choices options take (`--early ray_tracing`), the files the commands write (JSON, CSV, WAV and their column names), material ids and log files. Scripts that read the command line's output keep working whatever the language. ## Marking text Text a person reads goes through `acoustic_spaces.i18n`: ```python from acoustic_spaces.i18n import N_, _, ngettext, pgettext label = _("Air temperature") message = _("Cannot open {path}: {reason}").format(path=path, reason=reason) rooms = ngettext("{count} room", "{count} rooms", n).format(count=n) band = pgettext("frequency band", "Band") # where English uses one word for two things LABELS = [N_("Open"), N_("Save")] # module constants: marked here, _() where shown ``` - Fields have names (`{path}`, not `{}`), so a translation can put them in another order. An f-string inside `_()` cannot be translated: the catalog tool refuses it. - Whole sentences, never pieces joined together: word order differs between languages. - A comment starting with `Translators:` on the line just above goes into the catalog for the translator. - `_` is the translation: a function that also names a variable `_` (`path, _ = ...`) cannot call it, and the catalog tool says so. Name the variable otherwise. - The code never compares shown text: it keeps a value (a scene-file value, a level) and shows its translated label. A list of choices keeps the value as each entry's data (`combo.addItem(_(label), value)`, read with `currentData()`); the English label of a scene-file value is the value itself (`ray_tracing`), the Spanish one words (*trazado de rayos*), and the tips that name the choices use the same words. - In the editor, numbers in a text go through `acoustic_spaces.gui.numbers`: `fmt(_("{time:.1f} s"), time=t)` writes them with the computer's decimal mark, and `parse_number` reads what a person typed in a table or field either way. ## The catalogs ```sh python tools/catalog.py update # collect the marked text into every catalog python tools/catalog.py check # what CI runs ``` `update` adds new text untranslated and drops text the code no longer has; text close to some that is gone comes with the old translation marked `fuzzy`, to review. `check` fails when a catalog is out of date, has text untranslated or fuzzy, or a translation whose fields (`{name}`, `%s`) or menu shortcut (`&`) differ from the English. Both need only Python's standard library. The example scenes' titles (`name`) and descriptions (the comment at the top of `examples/*/scene.yaml`) are collected too, in the context `example`; the editor shows them with `pgettext("example", text)`. `ACOUSTIC_SPACES_LANG=pseudo` shows every translatable text as ⟦text⟧, so text without brackets in the editor or the command line is text not yet marked. A test opens the editor in it and fails on any menu, panel title, tab, button, form label, list entry or tip that shows without brackets. ## Spanish The Spanish is neutral, for readers in Spain and Latin America alike, and follows the Spanish editions of the standards (UNE-EN ISO 3382 for room acoustic parameters, UNE-EN ISO 354 for absorption, UNE-EN ISO 17497 for scattering). It translates terms of the field as the field says them, not word for word. Style: - Actions (buttons, menu entries) in the infinitive: *Abrir*, *Guardar como…*, *Calcular*. - Tooltips and messages describe; where they must address the reader they use impersonal forms (*se*, *hace falta*) rather than *tú* or *usted*. - Words common to both sides of the Atlantic: *archivo* (not *fichero*), *equipo* for a computer (not *ordenador* or *computadora*). - Sentence case and no full stop at the end of a label or tooltip, as in English. - Quotation marks « ». Units and their symbols as in English (m², °C, kPa, dB, Hz), with a space before the unit. The editor writes numbers as the computer's regional settings do (0,85 in Spain, 0.85 in Mexico); the command line keeps the decimal point. - Symbols of parameters stay as they are (T20, T30, EDT, C50, C80, D50, Ts, G, STI, STIPA, IACC, SPL) and acronyms take no plural *s* (*las RIR*). - Scene-file values shown in the editor stay as written, in code format: `ray_tracing`. - One shortcut (`&`) per menu entry, on a letter no other entry of that menu uses. Glossary: | English | Spanish | Notes | |---|---|---| | room (the space simulated) | recinto | as UNE-EN ISO 3382; kinds of rooms by their names: *sala de conciertos*, *estudio*, *iglesia* | | box room | recinto rectangular | | | scene | escena | | | model, model file | modelo, archivo de modelo | | | floor plan | planta | the architectural term | | corner (of a plan) | vértice | | | wall, floor, ceiling | pared, suelo, techo | | | up axis | eje vertical | | | audience area | zona de público | | | audience seating | butacas | | | leak (a gap rays escape through) | fuga | | | closed (model) | cerrado | | | surface, face, mesh | superficie, cara, malla | | | source | fuente | point, line, surface source: *fuente puntual, lineal, superficial* | | listener | receptor | the term of room acoustics, not *oyente* | | sound power | potencia acústica | | | directivity, directivity index | directividad, índice de directividad | | | balloon (directivity) | globo de directividad | | | loudspeaker, loudspeaker layout | altavoz, configuración de altavoces | 5.1, 7.1.4 as they are | | array (of loudspeakers) | array | the usual word in Spanish sound engineering | | gain, delay, equalizer | ganancia, retardo, ecualizador | | | speech spectrum (male, female) | espectro de voz (masculina, femenina) | | | absorption (coefficient) | absorción (coeficiente de absorción) | | | scattering (coefficient) | dispersión (coeficiente de dispersión) | UNE-EN ISO 17497-1 | | diffusion | difusión | not the same as scattering | | sound reduction index R | índice de reducción sonora R | | | partition, opening | elemento separador, abertura | | | air absorption | absorción del aire | | | run (a simulation) | calcular, cálculo | the button *Calcular*; a run that went: *cálculo* | | early reflections | primeras reflexiones | | | late reverberation, late tail | reverberación tardía, cola reverberante | | | ray tracing (stochastic) | trazado de rayos (estocástico) | | | image sources | fuentes imagen | the method: *método de las fuentes imagen* | | diffuse rain | lluvia difusa | | | secondary sources | fuentes secundarias | | | edge diffraction | difracción en aristas | | | wave solver | método ondulatorio | FDTD as it is | | low frequencies | bajas frecuencias | | | in pressure (coherent sum) | en presión | | | seed (random) | semilla | | | device (CPU, GPU) | dispositivo | CPU and GPU as they are, feminine: *la GPU* | | impulse response | respuesta al impulso | RIR, BRIR as they are | | echogram, decay curve | ecograma, curva de caída | | | octave band, third-octave band | banda de octava, banda de tercio de octava | | | sample rate | frecuencia de muestreo | | | reverberation time | tiempo de reverberación | T20, T30 | | early decay time | tiempo de caída inicial | EDT | | clarity, definition | claridad, definición | C50, C80; D50 | | centre time | tiempo central | Ts | | sound strength | fuerza sonora | G | | speech transmission index | índice de transmisión del habla | STI | | sound pressure level | nivel de presión sonora | SPL | | just noticeable difference | diferencia apenas perceptible | JND | | background noise | ruido de fondo | | | coverage map | mapa de cobertura | | | binaural, Ambisonics, HRTF, SOFA, VBAP | as they are | *orden* for an Ambisonics order | | spherical head | cabeza esférica | | | head tracking | seguimiento de cabeza | | | auralization | auralización | | | convolution, deconvolution | convolución, deconvolución | | | dry recording | grabación anecoica | | | sweep (exponential sine) | barrido (senoidal exponencial) | | | recording, playback | grabación, reproducción | | | walkthrough | recorrido | | | results, messages | resultados, mensajes | the editor's panels | | command line | línea de comandos | | | warning, error (message levels) | aviso, error | | | outdoors, outdoor scene | al aire libre, escena al aire libre | | | ground, sky | terreno, cielo | *terreno*, not *suelo*, which is a room's floor | | building, roof, footprint | edificio, cubierta, huella | | | barrier (noise barrier) | pantalla acústica, pantalla | | | margin, extent | margen, extensión | | ## Catalan The Catalan catalog covers the same text as Spanish. Select **Català** under **View > Language**, or set `ACOUSTIC_SPACES_LANG=ca`. System locale names such as `ca_ES.UTF-8`, `ca-AD` and `ca_ES@valencia` also select it. Style: - Actions in the infinitive: *Obrir*, *Desar*, *Calcular*, *Cancel·lar*. - Tooltips and messages use impersonal forms, sentence case and no final full stop on labels or tooltips, as in English. - Use *fitxer*, *ordinador* and *per defecte*. Keep the product name Acoustic Spaces, file patterns, format names, units and parameter symbols (T20, C80, STI) as written. - Use « » for quotation marks. Numbers follow the computer's regional settings; the command line keeps the decimal point. - Each menu entry has one `&` shortcut, distinct from the others in that menu. - Catalan uses two plural forms: singular for 1, plural for all other counts. Glossary: | English | Catalan | |---|---| | room, box room | recinte, recinte rectangular | | scene, model file | escena, fitxer de model | | floor plan, corner | planta, vèrtex | | wall, floor, ceiling | paret, terra, sostre | | source, listener | font, receptor | | sound power, sound pressure level | potència acústica, nivell de pressió sonora | | directivity, loudspeaker | directivitat, altaveu | | absorption, scattering, diffusion | absorció, dispersió, difusió | | sound reduction index | índex de reducció sonora | | early reflections, late reverberation | primeres reflexions, reverberació tardana | | ray tracing, image sources | traçat de raigs, fonts imatge | | wave solver, edge diffraction | mètode ondulatori, difracció en arestes | | impulse response, reverberation time | resposta impulsional, temps de reverberació | | early decay time, decay curve | temps de decaïment inicial, corba de decaïment | | clarity, definition, sound strength | claredat, definició, força sonora | | speech transmission index | índex de transmissió de la parla | | octave band, third-octave band | banda d'octava, banda de terç d'octava | | sample rate, background noise | freqüència de mostreig, soroll de fons | | coverage map, leak | mapa de cobertura, fuita | | auralization, dry recording | auralització, enregistrament anecoic | | playback, head tracking | reproducció, seguiment del cap | | gain, delay, equalizer | guany, retard, equalitzador | | results, messages, warning | resultats, missatges, avís | | outdoors, ground, sky | a l'aire lliure, terreny, cel | | building, roof, footprint | edifici, coberta, petjada | | barrier, margin, extent | pantalla acústica, marge, extensió | ## Italian The Italian catalog covers the same text as Spanish and Catalan. Select **Italiano** under **View > Language**, or set `ACOUSTIC_SPACES_LANG=it`. System locale names such as `it_IT.UTF-8` and `it-CH` also select it, as does the Italian display language on Windows or macOS. Style: - Actions use the conventional Italian imperative: *Apri*, *Salva*, *Calcola*, *Annulla*. - Tooltips use infinitives or impersonal descriptions, sentence case and no final full stop on labels or tooltips, as in English. - Use *file*, *computer* and *predefinito*. Keep the product name Acoustic Spaces, file patterns, scene-file values, format names, units and parameter symbols as written. - Use « » for quotation marks. Numbers follow the computer's regional settings; the command line keeps the decimal point. - Each menu entry has one `&` shortcut, distinct from the others in that menu. - Italian uses two plural forms: singular for 1, plural for all other counts. Glossary: | English | Italian | |---|---| | room, box room | ambiente, ambiente rettangolare | | scene, model file | scena, file di modello | | floor plan, corner | pianta, vertice | | wall, floor, ceiling | parete, pavimento, soffitto | | source, listener | sorgente, ricevitore | | sound power, sound pressure level | potenza sonora, livello di pressione sonora | | directivity, loudspeaker | direttività, altoparlante | | absorption, scattering, diffusion | assorbimento, dispersione, diffusione | | sound reduction index | potere fonoisolante | | early reflections, late reverberation | prime riflessioni, riverberazione tardiva | | ray tracing, image sources | tracciamento di raggi, sorgenti immagine | | wave solver, edge diffraction | solutore ondulatorio, diffrazione sugli spigoli | | impulse response, reverberation time | risposta all'impulso, tempo di riverberazione | | early decay time, decay curve | tempo di decadimento iniziale, curva di decadimento | | clarity, definition, sound strength | chiarezza, definizione, intensità sonora | | centre time | tempo baricentrico | | speech transmission index | indice di trasmissione del parlato | | octave band, third-octave band | banda d'ottava, banda di terzo d'ottava | | sample rate, background noise | frequenza di campionamento, rumore di fondo | | coverage map, leak | mappa di copertura, fuga | | auralization, dry recording | auralizzazione, registrazione anecoica | | playback, head tracking | riproduzione, tracciamento della testa | | gain, delay, equalizer | guadagno, ritardo, equalizzatore | | yaw, pitch, roll | imbardata, beccheggio, rollio | | results, messages, warning | risultati, messaggi, avviso | | outdoors, ground, sky | all'aperto, terreno, cielo | | building, roof, footprint | edificio, copertura, impronta | | barrier, margin, extent | barriera acustica, margine, estensione | ## German The German catalog covers the same text as Spanish, Catalan and Italian. Select **Deutsch** under **View > Language**, or set `ACOUSTIC_SPACES_LANG=de`. System locale names such as `de_DE.UTF-8`, `de-AT` and `de_CH.UTF-8` also select it, as does the German display language on Windows or macOS. Style: - Actions use infinitives: *Öffnen*, *Speichern*, *Berechnen*, *Abbrechen*. - Tooltips use infinitives or impersonal descriptions. Capitalize nouns according to German spelling, with no final full stop on labels or tooltips, as in English. - Use *Datei*, *Computer* and *Standard*. Keep the product name Acoustic Spaces, file patterns, scene-file values, format names, units and parameter symbols as written. - Use „ “ for quotation marks. Numbers follow the computer's regional settings; the command line keeps the decimal point. - Each menu entry has one `&` shortcut, distinct from the others in that menu. - German uses two plural forms: singular for 1, plural for all other counts. Glossary: | English | German | |---|---| | room, box room | Raum, Quaderraum | | scene, model file | Szene, Modelldatei | | floor plan, corner | Grundriss, Ecke | | wall, floor, ceiling | Wand, Boden, Decke | | source, listener | Quelle, Empfänger | | sound power, sound pressure level | Schallleistung, Schalldruckpegel | | directivity, directivity index | Richtcharakteristik, Richtwirkungsmaß | | loudspeaker, loudspeaker layout | Lautsprecher, Lautsprecheranordnung | | absorption coefficient, scattering coefficient | Absorptionsgrad, Streugrad | | scattering, diffusion | Streuung, Diffusion | | sound reduction index | Schalldämmmaß | | early reflections, late reverberation | frühe Reflexionen, später Nachhall | | ray tracing, image sources | Strahlenverfolgung, Spiegelquellen | | wave solver, edge diffraction | Wellensolver, Kantenbeugung | | impulse response, reverberation time | Impulsantwort, Nachhallzeit | | early decay time, decay curve | frühe Abklingzeit, Abklingkurve | | clarity, definition, sound strength | Klarheitsmaß, Deutlichkeitsgrad, Stärkemaß | | centre time | Schwerpunktzeit | | speech transmission index | Sprachübertragungsindex | | octave band, third-octave band | Oktavband, Terzband | | sample rate, background noise | Abtastrate, Hintergrundgeräusch | | coverage map, leak | Versorgungskarte, Undichtigkeit | | auralization, dry recording | Auralisation, reflexionsfreie Aufnahme | | playback, head tracking | Wiedergabe, Kopfverfolgung | | gain, delay, equalizer | Verstärkung, Verzögerung, Equalizer | | yaw, pitch, roll | Gierwinkel, Nickwinkel, Rollwinkel | | results, messages, warning | Ergebnisse, Meldungen, Warnung | | outdoors, ground, sky | im Freien, Gelände, Himmel | | building, roof, footprint | Gebäude, Dach, Grundfläche | | barrier, noise barrier | Schallschirm, Lärmschutzwand | | margin, extent | Rand, Ausdehnung | ## Dutch The Dutch catalog covers the same text as Spanish, Catalan, Italian and German. Select **Nederlands** under **View > Language**, or set `ACOUSTIC_SPACES_LANG=nl`. System locale names such as `nl_NL.UTF-8` and `nl-BE` also select it, as does the Dutch display language on Windows or macOS. Style: - Use neutral Dutch for readers in the Netherlands and Belgium. - Actions use infinitives: *Openen*, *Opslaan*, *Berekenen*, *Annuleren*. - Tooltips use infinitives or impersonal descriptions, sentence case and no final full stop on labels or tooltips, as in English. - Use *bestand*, *computer* and *standaard*. Keep the product name Acoustic Spaces, file patterns, scene-file values, format names, units and parameter symbols as written. - Use ‘ ’ for quotation marks. Numbers follow the computer's regional settings; the command line keeps the decimal point. - Each menu entry has one `&` shortcut, distinct from the others in that menu. - Dutch uses two plural forms: singular for 1, plural for all other counts. Glossary: | English | Dutch | |---|---| | room, box room | ruimte, rechthoekige ruimte | | scene, model file | scène, modelbestand | | floor plan, corner | plattegrond, hoek | | wall, floor, ceiling | wand, vloer, plafond | | source, listener | bron, ontvanger | | sound power, sound pressure level | geluidsvermogen, geluidsdrukniveau | | directivity, directivity index | richtingskarakteristiek, richtingsindex | | loudspeaker, loudspeaker layout | luidspreker, luidsprekeropstelling | | absorption, scattering, diffusion | absorptie, verstrooiing, diffusie | | sound reduction index | geluidreductie-index | | early reflections, late reverberation | vroege reflecties, late nagalm | | ray tracing, image sources | straaltracering, spiegelbronnen | | wave solver, edge diffraction | golfsolver, randdiffractie | | impulse response, reverberation time | impulsrespons, nagalmtijd | | early decay time, decay curve | vroege uitsterftijd, uitsterfcurve | | clarity, definition, sound strength | helderheid, definitie, geluidsterkte | | centre time | zwaartepunttijd | | speech transmission index | spraaktransmissie-index | | octave band, third-octave band | octaafband, tertsband | | sample rate, background noise | samplefrequentie, achtergrondgeluid | | coverage map, leak | dekkingskaart, lek | | auralization, dry recording | auralisatie, anechoïsche opname | | playback, head tracking | afspelen, hoofdtracking | | gain, delay, equalizer | versterking, vertraging, equalizer | | yaw, pitch, roll | gierhoek, stamphoek, rolhoek | | results, messages, warning | resultaten, meldingen, waarschuwing | | outdoors, ground, sky | buiten, grond, hemel | | building, roof, footprint | gebouw, dak, grondvlak | | barrier, margin, extent | geluidsscherm, marge, omvang |