pywws 13.10 - en to it translation catalogue (376 entries)

en: DataStore.py - stores readings in easy to access files
it: DataStore.py - memorizza le letture in file di facile accesso

en: Introduction
it: Introduzione

en: This module is at the core of pywws. It stores data on disc, but without the overhead of a full scale database system. I have designed it to run on a small memory machine such as my Asus router. To minimise memory usage it only loads one day's worth of raw data at a time into memory.
it: Questo modulo è il cuore del mio software per la stazione meteo. Esso memorizza i dati su disco, ma senza il sovraccarico di un complesso database. L'ho progettato per funzionare su una macchina con poca memoria come il mio router Asus. Per ridurre al minimo l'utilizzo della memoria, carica solo l'equivalente di un giorno di dati alla volta in memoria.

en: From a "user" point of view, the data is accessed as a cross between a list and a dictionary. Each data record is indexed by a :py:class:`datetime.datetime` object (dictionary behaviour), but records are stored in order and can be accessed as slices (list behaviour).
it: Da un punto di vista "user", i dati vengono eseguiti come un incrocio tra un elenco e un dizionario. Ogni record di dati è indicizzato da un oggetto :py:class:`datetime.datetime` (comportamento di dizionario), ma i record vengono archiviati in ordine ed è possibile accedervi come fogli (comportamento di elenco).

en: For example, to access the hourly data for Christmas day 2009, one might do the following::
it: Ad esempio, per accedere ai dati orari per il giorno di Natale 2009, uno potrebbe effettuare le seguenti operazioni::

en: Some more examples of data access::
it: Alcuni esempi di accesso dati::

en: Note that the :py:class:`datetime.datetime` index is in UTC. You may need to apply an offset to convert to local time.
it: Si noti che l'indice :py:class:`datetime.datetime`  è in formato UTC. Potrebbe essere necessario applicare un offset per convertire in ora locale.

en: The module provides five classes to store different data. :py:class:`data_store` takes "raw" data from the weather station; :py:class:`calib_store`, :py:class:`hourly_store`, :py:class:`daily_store` and :py:class:`monthly_store` store processed data (see :py:mod:`pywws.Process`). All three are derived from the same ``core_store`` class, they only differ in the keys and types of data stored in each record.
it: Il modulo fornisce cinque classi per archiviare dati diversi. :py:class:`data_store` prende i dati "raw" dalla stazione meteo; :py:class:`calib_store`, :py:class:`hourly_store`, :py:class:`daily_store` e :py:class:`monthly_store` memorizza i dati elaborati (vedi :py:mod:`pywws.Process`).Tutti e tre sono derivati dallo stessa classe  ``core_store``, differiscono solo per le chiavi e i tipi di dati memorizzati in ogni record.

en: Detailed API
it: Dettagli API

en: Functions
it: Funzioni

en: Classes
it: Classi

en: Stores 'calibrated' weather station data.
it: Memorizza i dati 'calibrati' della Stazione Meteo.

en: Stores daily summary weather station data.
it: Memorizza i dati giornalieri di riepilogo della Stazione Meteo.

en: Stores raw weather station data.
it: Memorizza i dati grezzi Stazione Meteo.

en: Stores hourly summary weather station data.
it: Memorizza i dati orari di riepilogo della Stazione Meteo.

en: Stores monthly summary weather station data.
it: Memorizza i dati mensili di riepilogo della Stazione Meteo.

en: Parameters are stored in a file "weather.ini" in root_dir.
it: I parametri sono memorizzati in un file "weather.ini"  in root_dir.

en: Status is stored in a file "status.ini" in root_dir.
it: Lo stato viene memorizzato in un file "status.ini" in root_dir.

en: Difference between two datetime values.
it: Differenza tra due valori datetime.

en: Get a parameter value and return a string.
it: Ottiene un dato di parametro e restituisce una stringa.

en: If default is specified and section or option are not defined in the file, they are created and set to default, which is then the return value.
it: Se si specifica default e la sezione o l'opzione non sono definite nel file, sono creati e impostati su default, che è poi il valore restituito.

en: Set option in section to string value.
it: Impostare l'opzione nella sezione valore stringa.

en: Remove option from section.
it: Rimuovere l'opzione dalla sezione.

en: Return datetime of newest existing data record whose datetime is < idx.
it: Ritorno data ora dell'ultimo record di dati esistenti cui data ora è < idx.

en: Might not even be in the same year! If no such record exists, return None.
it: Potrebbe anche non essere nello stesso anno! Se non esiste nessun record, restituisce None.

en: Return datetime of oldest existing data record whose datetime is >= idx.
it: Restuisce data ora del record di dati esistente più antico cui data ora è >= idx.

en: Return datetime of record whose datetime is nearest idx.
it: Restuisce data ora del record cui data ora è più vicina di idx.

en: Convert EasyWeather.dat data to pywws format ::
it: Converte i dati EasyWeather.dat in formato pywws ::

en: This program converts data from the format used by the EasyWeather program supplied with the weather station to the format used by pywws. It is useful if you've been using EasyWeather for a while before discovering pywws.
it: Questo programma converte i dati dal formato utilizzato dal programma EasyWeather fornito con la stazione meteo nel formato utilizzato da pywws. È utile se hai usato EasyWeather per un po' prima di scoprire pywws.

en: The ``EasyWeather.dat`` file is only used to provide data from before the start of the pywws data. As your weather station has its own memory, you should run :py:mod:`pywws.LogData` before :py:mod:`pywws.EWtoPy` to minimise use of the EasyWeather.dat file.
it: Il file ``EasyWeather.dat`` è utilizzato solo per recuperare i dati prima dell'installazione di pywws. Siccome la tua stazione meteo ha la propria memoria, è necessario eseguire :py:mod:`pywws.LogData` prima di :py:mod:`pywws.EWtoPy` per ridurre al minimo l'utilizzo del file EasyWeather.dat.

en: :py:mod:`pywws.EWtoPy` converts the time stamps in EasyWeather.dat from local time to UTC. This can cause problems when daylight savings time ends, as local time appears to jump back one hour. The program attempts to detect this and correct the affected time stamps, but I have not been able to test this on a variety of time zones.
it: :py:mod:`pywws.EWtoPy` converte i timestamp di EasyWeather.dat da ora locale in UTC. Questo può causare problemi quando l'ora legale finisce, con l'ora solare sembra tornare indietro un'ora. Il programma tenta di rilevare questo e correggere il timestamp errato, ma non ho potuto testare questo su una varietà di fusi orari.

en: Predict future weather using recent data ::
it: Previsione meteo utilizzando dati recenti ::

en: Get weather data, process it, prepare graphs & text files and upload to a web site.
it: Ottenere dati meteo, elaborarli, preparare grafici i file di testo e caricare su un sito web.

en: Typically run every hour from cron. ::
it: In genere sono eseguiti ogni ora da cron. ::

en: This script does little more than call other modules in sequence to get data from the weather station, process it, plot some graphs, generate some text files and upload the results to a web site.
it: Questo script fa poco più che chiamare altri moduli in sequenza per ottenere i dati dalla stazione meteo, elabora, disegna alcuni grafici, genera alcuni file di testo e carica i risultati su un sito web.

en: For more information on using ``Hourly.py``, see :doc:`../guides/hourlylogging`.
it: Per ulteriori informazioni sull'utilizzo di ``Hourly.py``, vedi :doc:`../guides/hourlylogging`.

en: Get weather data, store it, and process it.
it: Ottenere dati meteo, memorizzarli ed elaborarli.

en: Run this continuously, having set what tasks are to be done. ::
it: Eseguire questo continuamente, avendo impostato quali sono i compiti da fare.

en: For more information on using ``LiveLog.py``, see :doc:`../guides/livelogging`.
it: Per ulteriori informazioni sull'utilizzo di ``LiveLog.py``, see :doc:`../guides/livelogging`.

en: Localisation.py - provide translations of strings into local language
it: Localisation.py - effetua le traduzioni di stringhe in lingua locale

en: Some of the pywws modules, such as WindRose.py, can automatically use your local language for such things as wind directions. The Localisation.py module, mostly copied from examples in the Python documentation, enables this.
it: Alcuni dei moduli pywws, come WindRose.py, può utilizzare automaticamente la lingua locale per cose come la direzione del vento. Il modulo Localisation.py, per lo più copiato da esempi nella documentazione di Python, permette questo

en: Localisation of pywws is done in two parts - translating strings such as 'rising very rapidly', and changing the 'locale' which controls things like month names and number representation (e.g. '23,2' instead of '23.2'). On some computers it may not be possible to set the locale, but translated strings can still be used.
it: Localizzazione di pywws è fatta in due parti - tradurre le stringhe come 'rising very rapidly', e cambiando le impostazioni internazionali che controlla le diciture come i nomi dei mesi e la rappresentazione dei numeri (e.g. '23,2' cambiando in '23.2'). Su alcuni computer potrebbe non essere possibile impostare le impostazioni internazionali, ma è possibile utilizzare le stringhe tradotte.

en: Using a different language
it: Usare un linguaggio diverso

en: The language used by pywws is set in the ``[config]`` section of the ``weather.ini`` file. This can be a two-letter language code, such as ``en`` (English), or can specify a national variant, such as ``fr_CA`` (Canadian French). It could also include a character set, for example ``de_DE.UTF-8``.
it: Il linguaggio utilizzato da pywws e definito nel file ``weather.ini`` alla sezione ``[config]``. Questo può essere un codice di due lettere della lingua, ad esempio  ``it`` (Italiano), o si può specificare una variante nazionale, come ``fr_CA`` (Canadian French). Potrebbe anche includere un set di caratteri, ad esempio ``de_DE.UTF-8``.

en: The choice of language is very system dependant, so Localisation.py can be run as a standalone program to test language codes. A good starting point might be your system's ``LANG`` environment variable, for example::
it: La scelta della lingua è a carico del sistema operativo, così Localisation.py può essere eseguito come programma autonomo per testare i codici di lingua. Un buon punto di partenza potrebbe essere la variabile di ambiente di sistema ' LANG ', ad esempio::

en: In most cases no more than a two-letter code is required::
it: Nella maggior parte dei casi è richiesto un codice di non più di due lettere::

en: If you try an unsupported language, pywws falls back to English::
it: Se impostate una lingua non supportata, pywws usa per default l'Inglese::

en: Once you've found a suitable language code that works, you can configure pywws to use it by editing your ``weather.ini`` file::
it: Dopo aver trovato un codice di lingua adatto che funziona, è possibile configurare pywws per usarlo modificando il file ``weather.ini``::

en: Creating a new translation
it: Creazione di una nuova traduzione

en: If there is no translation file for your preferred language then you need to create one. See :doc:`../guides/language` for detailed instructions.
it: Se non c'è nessun file di traduzione per la lingua preferita, allora avete bisogno di crearne uno. Vedi :doc:`../guides/language` per istruzioni dettagliate.

en: Set the locale and translation for a pywws program.
it: Impostare le impostazioni internazionali e la traduzione di un programma pywws.

en: Set the 'locale' used by a program.
it: Impostare le impostazioni locali utilizzate dal programma.

en: Set the translation used by (some) pywws modules.
it: Impostare la traduzione utilizzata da (alcuni) moduli pywws.

en: This affects the entire application, changing the way dates, currencies and numbers are represented. It should not be called from a library routine that may be used in another program.
it: Questo riguarda l'intera applicazione, cambiando il modo in cui le date, valute e numeri sono rappresentati. Essa non deve essere chiamata da una routine di libreria che può essere utilizzata in un altro programma.

en: The ``lang`` parameter can be any string that is recognised by ``locale.setlocale()``, for example ``en``, ``en_GB`` or ``en_GB.UTF-8``.
it: Il parametro ``lang`` può essere qualsiasi stringa che è riconosciuto da ``locale.setlocale()``, per esempio ``it``, ``it_IT`` or ``it_IT.UTF-8``.

en: language code.
it: codice della lingua.

en: success status.
it: eseguito con successo.

en: This sets the translation object ``Localisation.translation`` to use a particular language.
it: Questo imposta l'oggetto di traduzione ``Localisation.translation`` per utilizzare una particolare lingua.

en: The ``lang`` parameter can be any string of the form ``en``, ``en_GB`` or ``en_GB.UTF-8``. Anything after a ``.`` character is ignored. In the case of a string such as ``en_GB``, the routine will search for an ``en_GB`` language file before searching for an ``en`` one.
it: Il parametro ``lang`` può essere qualsiasi stringa nel formato ``it``, ``it_IT`` o ``it_IT.UTF-8``. Tutto ciò dopo un carattere ``.`` viene ignorato. Nel caso di una stringa come ``it_IT``, la routine cercherà un file di lingua ``it_IT`` prima di cercare un file ``it``.

en: This function reads the language from the configuration file, then calls :func:`SetLocale` and :func:`SetTranslation`.
it: Questa funzione legge la lingua dal file di configurazione, quindi chiama :func:`SetLocale` e :func:`SetTranslation`.

en: Save weather station history to file ::
it: Salva i dati della stazione meteo nel file ::

en: This program / module gets data from the weather station's memory and stores it to file. Each time it is run it fetches all data that is newer than the last stored data, so it only needs to be run every hour or so. As the weather station typically stores two weeks' readings (depending on the logging interval), LogData.py could be run quite infrequently if you don't need up-to-date data.
it: Questo programma / modulo riceve i dati dalla memoria della stazione meteo e li memorizza in un file. Ogni volta che viene eseguito recupera tutti i dati che sono più recenti rispetto agli ultimi dati memorizzati, quindi ha bisogno di essere eseguito solo ogni ora circa. Siccome la stazione meteorologica tipicamente memorizza le letture di due settimane (a seconda dell'intervallo di registrazione), LogData.py potrebbe essere eseguito molto raramente, se non hai bisogno di dati aggiornati in tempo reale.

en: There is no date or time information in the raw weather station data, so LogData.py creates a time stamp for each reading. It uses the computer's clock, rather than the weather station clock which can not be read accurately by the computer. A networked computer should have its clock set accurately by `ntp <http://en.wikipedia.org/wiki/Network_Time_Protocol>`_.
it: Se non c'è nessuna informazione data o ora nei dati raw grezzi nella Stazione Meteo , quindi LogData.py crea un timestamp per ogni lettura. Esso utilizza l'orologio del computer, piuttosto che l'orologio della stazione meteo che non può essere letta con precisione dal computer. Un computer in rete dovrebbe avere il suo orologio impostato con precisione da `ntp <http://en.wikipedia.org/wiki/Network_Time_Protocol>`_.

en: Synchronisation with the weather station is achieved by waiting for a change in the current data. There are two levels of synchronisation, set by the config file or a command line option. Level 0 is quicker, but is only accurate to around twelve seconds. Level 1 waits until the weather station stores a new logged record, and gets time stamps accurate to a couple of seconds. Note that this could take a long time, if the logging interval is greater than the recommended five minutes.
it: La sincronizzazione con la stazione meteo è realizzata in attesa di un cambiamento nei dati attuali. Ci sono due livelli di sincronizzazione, impostate nel file ``weather.ini`` la sezione ``[config]`` l'opzione ``logdata sync =``. Il livello 0 è più veloce, ma è poco preciso scarta circa dodici secondi. Livello 1 attende dalla stazione meteo che memorizza un nuovo record di dati e ottiene il timestamp accurato di un paio di secondi. Si noti che questo potrebbe richiedere molto tempo, se l'intervallo di registrazione supera i cinque minuti consigliati.

en: Common code for logging info and errors.
it: Codice comune per la registrazione di informazioni ed errori.

en: Plot graphs of weather data according to an XML recipe ::
it: Tracciare i grafici dei dati meteo secondo un file di comandi XML ::

en: Like Template.py this is one of the more difficult to use modules in the weather station software collection. It plots a graph (or set of graphs) of weather data. Almost everything about the graph is controlled by an XML file. I refer to these files as templates, but they aren't templates in the same sense as Template.py uses to create text files.
it: Come Template.py questo è uno dei più difficili moduli software da utilizzare della stazione meteo. Traccia un grafico o set di grafici di dati meteo. Quasi tutto ciò che riguarda il grafico è controllato da un file XML. Mi riferisco a questi file come modelli, ma non sono modelli nello stesso modo come Template.py viene utilizzato per creare file di testo.

en: Before writing your own graph template files, it might be useful to look at some of the examples in the example_graph_templates directory. If (like I was) you are unfamiliar with XML, I suggest reading the W3 Schools XML tutorial.
it: Prima di scrivere i propri file di template grafici, potrebbe essere utile dare un'occhiata ad alcuni degli esempi nella directory example_graph_templates. Se (come me) non si ha familiarità con XML, vi suggerisco di leggere il W3 Schools XML tutorial.

en: XML graph file syntax
it: Sintassi di file grafico XML

en: Here is the simplest useful graph template. It plots the external temperature for the last 24 hours. ::
it: Qui è il più semplice modello grafico. Esso riporta la temperatura esterna per le ultime 24 ore. ::

en: In this example, the root element graph has one plot element, which has one subplot element. The subplot element contains a title element and a ycalc element. To plot more data on the same set of axes (for example dew point and temperature), we can add more subplot elements. To plot more than one set of axes (for example wind speed is measured in different units from temperature) in the same file we can add more plot elements.
it: In questo esempio, l'elemento radice è un elemento grafico, che ha un elemento secondario. Il tracciato secondario contiene un elemento title e un elemento ycalc. Per tracciare più dati sullo stesso sistema di assi (per esempio punto di rugiada e temperatura), possiamo aggiungere più elementi secondari. Per tracciare più di una serie di assi (per esempio la velocità del vento è misurata in unità diverse dalla temperatura) nello stesso file possiamo aggiungere ulteriori elementi del grafico.

en: The complete element hierarchy is shown below. ::
it: La gerarchia degli elementi è mostrata di seguito. ::

en: This is the root element of the graph XML file. It does not have to be called "graph", but there must be exactly one root element.
it: Questo è l'elemento principale del file grafico  XML. Essa non deve essere chiamato "graph", ma ci deve essere esattamente un elemento radice.

en: Every graph element should contain at least one plot element. A separate graph is drawn for each plot element, but all share the same X axis.
it: Ogni grafico deve contenere almeno un elemento grafico. Un grafico è disegnato per ogni elemento grafico, ma tutti condividono lo stesso asse X.

en: This element sets the date & time of the start of the X axis. It is used in the constructor of a Python datetime object. For example, to start the graph at noon (local time) on Christmas day 2008: ``<start>year=2008, month=12, day=25, hour=12</start>``. The default value is (stop - duration).
it: Questo elemento imposta la data e ora di inizio dell'asse X. È utilizzato nel costruttore di un oggetto Python data e ora. Ad esempio, per avviare il grafico a mezzogiorno (Ora locale) del giorno di Natale 2008: ``<start>year=2008, month=12, day=25, hour=12</start>``. Il valore predefinito è (stop - duration).

en: This element sets the date & time of the end of the X axis. It is used in the constructor of a Python datetime object. For example, to end the graph at 10 am (local time) on new year's day: ``<stop>year=2009, month=1, day=1, hour=10</stop>``. The default value is (start + duration), unless start is not defined in which case the timestamp of the latest weather station hourly reading is used.
it: Questo elemento imposta la data e ora della fine dell'asse X. È utilizzato nel costruttore di un oggetto Python data e ora. Ad esempio, per terminare il grafico a 10 am (ora locale) del giorno di capodanno: ``<stop>year=2009, month=1, day=1, hour=10</stop>``. Il valore predefinito è (start + duration), a meno che l'inizio non è definito in questo caso la data l'ultima lettura oraria della stazione meteo viene utilizzata.

en: This element sets the extent of the X axis of the graph, unless both start and stop are defined. It is used in the constructor of a Python timedelta object. For example, to plot one week: ``<duration>weeks=1</duration>``. The default value is hours=24.
it: Questo elemento imposta la misura dell'asse X del grafico, a meno che non sono definite sia di inizio che fine . È utilizzato nel costruttore di un oggetto Python timedelta . Ad esempio, per tracciare una settimana: ``<duration>weeks=1</duration>``. Il valore predefinito è ore=24.

en: Controls the layout of the plots. Default is a single column. The layout element specifies rows and columns. For example: ``<layout>4, 2</layout>`` will use a grid of 4 rows and 2 columns.
it: Controlla il layout dei grafici. Predefinita è una singola colonna. L'elemento layout specifica le righe e colonne. Ad esempio: ``<layout>4, 2</layout>`` verrà utilizzata una griglia di 4 righe e 2 colonne.

en: Sets the overall dimensions of the image file containing the graph. Default (in a single column layout) is a width of 600 pixels and height of 200 pixels for each plot, so a graph with four plot elements would be 600 x 800 pixels. Any size element must include both width and height. For example: ``<size>800, 600</size>`` will produce an image 800 pixels wide and 600 pixels high.
it: Imposta le dimensioni dell' immagine contenente il grafico. Valore predefinito (in un layout a colonna singola) è una larghezza di 600 pixel e l'altezza di 200 pixel per ogni tracciato, così un grafico con i quattro elementi della trama sarebbe 600 x 800 pixel. Qualsiasi elemento deve includersi sia in larghezza che in altezza. Ad esempio: ``<size>800, 600</size>`` produrrà un'immagine di 800 pixel di larghezza e 600 pixel di altezza.

en: Sets the image format of the file containing the graph. Default is png. Any string recognised by your installation of gnuplot should do. For example: ``<fileformat>gif</fileformat>`` will produce a GIF image.
it: Imposta il formato del del file contenente l'immagine del grafico. Predefinito è png. Dovrebbe fare qualsiasi stringa riconosciuta dalla vostra installazione di gnuplot. Ad esempio: ``<fileformat>gif</fileformat>`` produrrà un'immagine GIF.

en: Allows complete control of gnuplot's 'terminal' settings. You may want to use this if you are plotting to an unusual image format. Any string recognised by your installation of gnuplot's 'set terminal' command should do. For example: ``<terminal>svg enhanced font "arial,9" size 600,800 dynamic rounded</terminal>``. This setting overwrites both size and fileformat.
it: 'terminal' permette un controllo completo delle impostazioni di gnuplot . È possibile utilizzare questa opzione se si traccia con un insolito formato immagine. Qualsiasi stringa riconosciuta dall'installazione di gnuplot in 'terminal' viene eseguita. Ad esempio: ``<terminal>svg enhanced font "arial,9" size 600,800 dynamic rounded</terminal>``. Questa impostazione sovrascrive le dimensioni del carattere e la dimensione del grafico.

en: Sets the left margin of the plots, i.e. the distance from the left hand axis to the left hand edge of the image area. According to the gnuplot documentation the units of lmargin are character widths. The default value is 5, which should look OK in most circumstances.
it: Imposta il margine sinistro dei tracciati, cioè la distanza dall'asse sinistro dal bordo sinistro della zona di immagine. Secondo la documentazione di gnuplot le unità di lmargin sono le larghezze di carattere. Il valore di default è 5, che dovrebbe apparire su OK nella maggior parte dei casi.

en: Sets the right margin of the plots, i.e. the distance from the right hand axis to the right hand edge of the image area. According to the gnuplot documentation the units of rmargin are character widths. The default value is -1, which sets automatic adjustment.
it: Imposta il margine destro dei tracciati, cioè la distanza tra l'asse di destra e il bordo destro dell'area immagine. Secondo la documentazione di gnuplot le unità di rmargin sono le larghezze di carattere. Il valore predefinito è -1, che imposta la definizione automatica.

en: Sets the format of the time / date xtic labels. The value is a strftime style format string. Default depends on the graph duration: 24 hours or less is "%H%M", 24 hours to 7 days is "%a %d" and 7 days or more is "%Y/%m/%d".
it: Imposta il formato delle etichette xtic data / ora. Il valore è una stringa in formato strftime. Dipende dalla durata grafico: se 24 ore o meno è "%H%M", da 24 ore a 7 giorni è "%a %d" e 7 giorni o più  è "%Y/%m/%d".

en: Sets the X axis label. The value is a strftime style format string. Default depends on the graph duration: 24 hours or less is "Time (%Z)", 24 hours to 7 days is "Day" and 7 days or more is "Date". The datetime used to compute this is start, which may produce unexpected results when a graph spans DST start or end.
it: Imposta l'etichetta dell'asse X. Il valore è una stringa in formato strftime. Dipende dalla durata grafico: Se 24 ore o meno è "Time (%Z)", da 24 ore a 7 giorni è "Day" e 7 giorni o più  è "Date".

en: Sets the format of the date labels at each end of X axis. The value is a strftime style format string. Default is "%Y/%m/%d". The right hand label is only drawn if it differs from the left. To have no labels, set an empty format: ``<dateformat></dateformat>``
it: Imposta il formato delle etichette di data ad ogni estremità dell'asse X. Il valore è una stringa in formato strftime. L'impostazione predefinita è "%Y/%m/%d". L'etichetta a destra del grafico è elaborato solo se diversa dalla sinistra. Per non avere etichette, impostare un formato vuoto: ``<dateformat></dateformat>``

en: Sets the spacing of the "tic" marks on the X axis. The value is an integer number of hours. The default is to allow gnuplot to set an appropriate interval.
it: Imposta la spaziatura dei "tic" i segni sull'asse X. Il valore è un numero intero di ore. L'impostazione predefinita è di consentire a gnuplot di impostare un intervallo appropriato.

en: Sets the title of the graph. A single line of text, for example: ``<title>Today's weather</title>``. This title appears at the very top of the graph, outside any plot area.
it: Imposta il titolo del grafico. Una singola linea di testo, per esempio: ``<title>Today's weather</title>``. Questo titolo appare al vertice del grafico, fuori di qualsiasi area del tracciato.

en: Every plot element should contain at least one subplot element. A separate trace is drawn for each subplot element, but all share the same X and Y axes.
it: Ogni elemento grafico deve contenere almeno un elemento sottotrama. Una traccia a parte è disegnata per ogni elemento sottotrama, ma tutti condividono gli stessi assi X e Y.

en: Sets the bottom margin, i.e. the spacing between the lower X axis and the edge of the graph (or the next plot). The default is to let gnuplot adjust this automatically, which works OK most of the time but you may wish to fine tune the value to suit your installation.
it: Imposta il margine inferiore, ossia la distanza tra l'asse X e il bordo inferiore del grafico (o la trama successiva). L'impostazione predefinita è quella di lasciare a gnuplot di regolare automaticamente, che funziona bene per la maggior parte dei casi, ma si potrebbe desiderare di mettere a punto il valore per soddisfare la vostra installazione.

en: The permitted value is any non-negative real number. On my setup 0.9 is a good value, set as follows: ``<bmargin>0.9</bmargin>``.
it: Il valore ammesso è un qualsiasi numero reale non negativo. Sulla mia configurazione 0.9 è un buon valore, impostare la seguente: ``<bmargin>0.9</bmargin>``.

en: Sets the lower and upper limits of the (left hand) Y axis. The value is anything understood by gnuplot, typically a pair of numbers. The default is to allow gnuplot to set appropriate values, which is unlikely to be what you want. For example, to plot typical UK temperatures with no value going off the graph: ``<yrange>-10, 30</yrange>``. Note that commas are converted to colons, so ``<yrange>-10:30</yrange>`` would be equivalent.
it: Imposta i limiti inferiore e superiore dell' asse Y  (sinistra). Il valore compreso da gnuplot, è tipicamente una coppia di numeri. L'impostazione predefinita è quella di consentire a gnuplot di impostare i valori appropriati, ed è improbabile che è quello che volete. Ad esempio, per tracciare il tipico grafico UK temperature senza nessun valore fuori del grafico: ``<yrange>-10, 30</yrange>``. Nota che le virgole sono convertiti in due punti, in modo che `` <yrange> -10:30 </ YRange> `` è equivalente.

en: You can use an asterisk to have gnuplot choose a suitable value. For example, to have the upper value auto scale whilst fixing the lower value at zero, use ``<yrange>0:*</yrange>``.
it: È possibile utilizzare un asterisco per lasciare a gnuplot scegliere un valore adeguato. Ad esempio, per avere la scala automatica del valore superiore mentre fissa il valore inferiore a zero, usare ``<yrange>0:*</yrange>``.

en: Sets the lower and upper limits of the right hand Y axis. Default is for the right hand Y axis to be the same as the left, but setting a different range is useful in dual axis plotting.
it: Imposta i limiti inferiore e superiore dell' asse Y di destra. Predefinito per il lato dell'asse Y destro è essere uguale all'asse di sinistra, ma per impostare un diverso range è utile in un grafico a doppio tracciato.

en: Controls the "tic" marks on the left hand Y axis. The value can be anything that's understood by gnuplot. For example, to set the tic spacing to 45 use ``<ytics>45</ytics>``. More complex things are also possible, e.g. to label a wind direction graph with compass points, use ``<y2tics>('N' 0, 'E' 90, 'S' 180, 'W' 270, 'N' 360)</y2tics>``.
it: Controlla il "tic" segni sulla asse Y di sinistra. Il valore può essere tutto ciò che è compreso da gnuplot. Ad esempio, per impostare la spaziatura di 45 punti uso ``<y2tics>('N' 0, 'E' 90, 'S' 180, 'W' 270, 'N' 360)</y2tics>``.

en: Controls the "tic" marks on the right hand axis. The format is the same as that for ytics. Default behaviour is to copy the left hand tic marks, but without labels.
it: Controlla il "tic" dei segni sul proprio asse. Il formato è lo stesso di quello per ytics. Comportamento predefinito è di copiare i segni di sinistra, ma senza etichette.

en: Adds a label to the (left hand) Y axis. For example, when plotting temperature: ``<ylabel>°C</ylabel>``. If you use ylabel you will probably want to adjust lmargin.
it: Aggiunge un'etichetta a (sinistra) asse Y. Per esempio, quando la temperatura: ``<ylabel>°C</ylabel>``.  Se si utilizza ylabel probabilmente si desidera regolare lmargin.

en: Adjust the angle of the (left hand) Y axis label, if your version of gnuplot supports it. For example, to write the label horizontally: ``<ylabelangle>90</ylabelangle>``.
it: Regola l'angolo (lato sinistro) etichetta asse Y, se dalla versione di gnuplot è supportato. Ad esempio, per scrivere l'etichetta orizzontalmente: ``<ylabelangle>90</ylabelangle>``.

en: Adds a label to the right hand Y axis. For example, when plotting humidity: ``<y2label>%</y2label>``. This is mostly used when plotting dual axis graphs. If you use y2label you will probably want to adjust rmargin.
it: Aggiunge un'etichetta a destra asse Y. Per esempio, quando riportando l'umidità: ``<y2label>%</y2label>``.  Questo è usato soprattutto per la stampa a doppi assi grafici. Se si utilizza y2label sarà probabilmente necessario regolare rmargin.

en: Adjust the angle of the right hand Y axis label, if your version of gnuplot supports it. For example, to write the label horizontally: ``<y2labelangle>90</y2labelangle>``.
it: Regola l'angolo della etichetta a destra asse Y, se è supportato dalla versione di gnuplot. Ad esempio, per scrivere l'etichetta orizzontalmente: ``<y2labelangle>90</y2labelangle>``.

en: Adds a grid to the plot. In most situations gnuplot's default grid is suitable, so no value is needed: ``<grid></grid>``. More control is possible using any of the options understood by gnuplot's set grid command. For example, to have horizontal grid lines only: ``<grid>ytics</grid>``.
it: Aggiunge una griglia di osservazione. Nella maggior parte dei casi la griglia predefinita di gnuplot è adatta, quindi non è necessario: ``<grid></grid>``. Il controllo della griglia è possibile utilizzando una qualsiasi delle opzioni usate da gnuplot. Ad esempio, per le linee della griglia orizzontali è: ``<grid>ytics</grid>``.

en: Select the weather data to be plotted. Permitted values are ``<source>raw</source>``, ``<source>hourly</source>``, ``<source>daily</source>`` and ``<source>monthly</source>``. Default is raw. Note that the different sources have different data dictionaries, so this choice affects ycalc.
it: Selezionare i dati meteo da tracciare. I valori consentiti sono ``<source>raw</source>``, ``<source>hourly</source>``, ``<source>daily</source>`` e ``<source>monthly</source>``. L' impostazione predefinita è ``raw``. Nota che le diverse fonti hanno diversi dizionari di dati, tale scelta ha effetto su ycalc.

en: Sets the width of the "boxes" used when drawing bar graphs. The value is an integer expression yielding a number of seconds. Default depends on source: raw is 240, hourly is 2800 and daily is 2800 * 24.
it: Imposta la larghezza del "boxes"  con i grafici a barre. Si tratta di un valore espressione intero producendo un numero di secondi. Il valore predefinito dipende dalla fonte: raw è 240, hourly è 2800 e ogni daily è 2.800 * 24.

en: Sets the title of the plot. A single line of text, for example: ``<title>Temperature (°C)</title>``. This title appears within the plot area, above any subplot titles.
it: Imposta il titolo della trama. Una singola riga di testo, ad esempio: ``<title>Temperatura (°C)</title>``. Questo titolo viene visualizzato all'interno dell'area del tracciato, sopra qualsiasi titolo del tracciato.

en: Execute any gnuplot command, just before the main "plot" command. This option allows advanced users to have greater control over the graph appearance. The value is any valid gnuplot command, typically beginning with the word set. For example: ``<command>set key tmargin center horizontal width 1 noreverse enhanced autotitles box linetype -1 linewidth 1</command>``. (Don't ask me what this example does — I'm not an advanced user).
it: Esegue qualsiasi comando di gnuplot, subito prima del principale comando "plot". Questa opzione consente agli utenti avanzati di avere maggiore controllo sull'aspetto grafico. Il valore è qualsiasi comando valido gnuplot, iniziando in genere con il set di comandi. Ad esempio: ``<command>set key tmargin center horizontal width 1 noreverse enhanced autotitles box linetype -1 linewidth 1</command>``. (Non mi chiedete che cosa fa questo esempio — io non sono un utente avanzato)

en: Controls the X axis positioning of plotted data values. The default value of data['idx'] is correct for most data, but there are some exceptions. For example, when plotting bar charts of hourly rainfall, it's nice to centre the bars on 30 minutes past the hour: ``<xcalc>data['idx'].replace(minute=30, second=0)</xcalc>``.
it: Controlla il posizionamento dei valori sull'asse X  dei dati tracciati. Il valore predefinito dei dati ['idx'] è corretto per la maggior parte dei casi, ma ci sono alcune eccezioni. Ad esempio, durante la stampa dei grafici a barre di pioggia oraria, è bello centrare le barre sui 30 minuti dell'ora: ``<xcalc>data['idx'].replace(minute=30, second=0)</xcalc>``.

en: Selects the data to be plotted. Any one line Python expression that returns a single float value can be used. At its simplest this just selects one value from the "data" dictionary, for example: ``<ycalc>data['temp_out']</ycalc>`` plots the external temperature. More complex expressions are possible, and some helper functions are provided. For example: ``<ycalc>dew_point(data['temp_out'], data['hum_out'])</ycalc>`` plots the external dew point, and ``<ycalc>wind_mph(data['wind_ave'])</ycalc>`` plots the average wind speed in miles per hour.
it: Seleziona i dati da stampare. Può essere utilizzata una qualsiasi linea di espressione Python che restituisce un singolo valore a virgola mobile . Nella sua forma più semplice questo seleziona solo un valore dalla "data" del dizionario, per esempio: ``<ycalc>data['temp_out']</ycalc>`` traccia la temperatura esterna. Espressioni più complesse sono possibili, e alcune funzioni di supporto sono fornite. Ad esempio:  ``<ycalc>dew_point(data['temp_out'], data['hum_out'])</ycalc>`` traccia la temperatura esterna del punto di rugiada, e ``<ycalc>wind_mph(data['wind_ave'])</ycalc>`` traccia la velocità media del vento in miglia all'ora.

en: Cumulative plots are also possible. The result of each ycalc computation is stored and made available to the next computation in the variable last_ycalc. This can be used with any data, but is most useful with rainfall: ``<ycalc>data['rain'] + last_ycalc</ycalc>``.
it: Tracciati cumulativi sono anche possibili. Il risultato di ogni calcolo ycalc sono conservati e messi a disposizione per il successivo calcolo dalla variabile last_ycalc. Questo può essere utilizzato con qualsiasi tipo di dati, ma è più utile con le precipitazioni:``<ycalc>data['rain'] + last_ycalc</ycalc>``.

en: Selects which Y axis the data is plotted against. Default is the left hand axis, but the right hand axis can be chosen with: ``<axes>x1y2</axes>``. This can be used in conjunction with y2range to plot two unrelated quantities on one graph, for example temperature and humidity.
it: Seleziona quale asse Y i dati è in funzione. Per impostazione predefinita è sull' asse sinistro, ma l'asse di destra può essere scelto con: ``<axes>x1y2</axes>``. Questo può essere utilizzato in combinazione con y2 per tracciare due grandezze indipendenti su un grafico, ad esempio la temperatura e l'umidità.

en: Sets the line style for the graph. Default is a smooth continuous line, thickness 1. To select a bar graph use: ``<style>box</style>``. To select points without a connecting line use: ``<style>+</style>`` or ``<style>x</style>``. To select a line thickness 3 (for example) use: ``<style>line 3</style>``. The thickness of points can be set in a similar fashion. For complete control (for advanced users) a full gnuplot style can be set: ``<style>smooth unique lc 5 lw 3</style>``.
it: Imposta lo stile della linea del grafico. Impostazione predefinita è una linea continua, liscia, spessore 1. Per selezionare un grafico a barre: ``<style>box</style>``. Per selezionare i punti senza una linea di collegamento: ``<style>+</style>`` o ``<style>x</style>``. Per selezionare uno spessore di linea 3 (per esempio) usate: ``<style>line 3</style>``. Lo spessore dei punti può essere impostato in un modo simile. Per un controllo completo (per utenti avanzati) un pieno stile gnuplot può essere impostato: ``<style>smooth unique lc 5 lw 3</style>``.

en: Sets the colour of the subplot line or boxes. Any integer value is accepted. The mapping of colours to numbers is set by gnuplot. Default value is the previous colour plus one.
it: Imposta il colore del subtracciato a linea o barre. Qualsiasi valore intero è accettato. La mappatura dei colori in numeri è impostato da gnuplot. Valore di default è il colore precedente più uno.

en: Sets the title of the subplot. A single line of text, for example: ``<title>Temperature (°C)</title>``. This title appears within the plot area, next to a short segment of the line colour used for the subplot.
it: Imposta il titolo del secondario. Una singola riga di testo, ad esempio: ``<title>Temperature (°C)</title>``. Questo titolo viene visualizzato nell'area di stampa, accanto a un breve tratto di linea del colore utilizzato per il tracciato.

en: Compute apparent temperature (real feel), using formula from
it: Calcola la temperatura apparente (sensazione reale), con formula da

en: Calculate Humidity Index as per Canadian Weather Standards
it: Calcolo Indice di umidità come per gli standard Canadian Weather Standards

en: Compute dew point, using formula from
it: Calcola il punto di rugiada, usando la formula da

en: Approximate conversion of illuminance in lux to solar radiation in W/m2
it: Conversione approssimativa di illuminazione in lux a radiazione solare in W/m2

en: Convert pressure from hectopascals/millibar to inches of mercury
it: Converte la pressione da ettopascal/millibar in pollici di mercurio

en: Convert pressure trend to a string, as used by the UK met
it: Convertire in una stringa carattere l'andamento della pressione, come utilizzata dal UK met office.

en: Convert rainfall from millimetres to inches
it: Converte le precipitazioni da millimetri a pollici

en: Convert temperature from Celsius to Fahrenheit
it: Converte la temperatura da gradi Celsius a Fahrenheit

en: Calculate Heat Index as per USA National Weather Service Standards
it: Calcolare l'indice di calore secondo Standards USA National Weather Service

en: Convert wind from metres per second to Beaufort scale
it: Converte i metri al secondo del vento in scala Beaufort

en: Compute wind chill, using formula from
it: Calcola il vento gelido, usando la formula di

en: Convert wind from metres per second to kilometres per hour
it: Converte il vento da metri al secondo a chilometri orari

en: Convert wind from metres per second to knots
it: Converte il vento da metri al secondo a nodi

en: Convert wind from metres per second to miles per hour
it: Converte il vento da metri al secondo a miglia all'ora

en: Convert wind direction from 0..15 to degrees
it: Convertire la direzione del vento a 0..15 in gradi

en: Convert wind direction from 0..15 to compass point text
it: Convertire direzione del vento da 0 .. 15 per i punti della bussola

en: Generate hourly, daily & monthly summaries of raw weather station data ::
it: Generare tracciati orari, giornalieri & riepiloghi mensili dei dati meteorologici stazione ::

en: This module takes raw weather station data (typically sampled every five or ten minutes) and generates hourly, daily and monthly summary data, which is useful when creating tables and graphs.
it: Questo modulo memorizza i dati grezzi della stazione meteo(tipicamente campionati ogni cinque o dieci minuti) e genera i dati orari, giornalieri e mensili di riepilogo, che è utile per la creazione di tabelle e grafici

en: Before computing the data summaries, raw data is "calibrated" using a user-programmable function. See :doc:`pywws.calib` for details.
it: Prima di calcolare i riepiloghi dei dati, i dati grezzi sono "calibrated" utilizzando una funzione programmabile dall'utente. Vedere :doc:`pywws.calib` per i dettagli

en: The hourly data is derived from all the records in one hour, e.g. from 18:00:00 to 18:59:59, and is given the index of the last complete record in that hour.
it: Il dato hourly deriva da tutti i record in un'ora, per esempio dalle 18.00 alle 18:59:59 è l'indice dell'ultimo record completo in quell'ora

en: The daily data summarises the weather over a 24 hour period typically ending at 2100 or 0900 hours, local (non DST) time, though midnight is another popular convention. It is also indexed by the last complete record in the period. Daytime and nightime, as used when computing maximum and minimum temperatures, are assumed to start at 0900 and 2100 local time, or 1000 and 2200 when DST is in effect, regardless of the meteorological day.
it: La cartella dati giornalieri (daily) riassume il tempo in un periodo di 24 ore in genere fino alle 21:00 o alle 09:00, ora locale (non DST), anche se la mezzanotte è un altra popolare convenzione. È inoltre indicizzata dall' ultimo record nel periodo. Durante le ore diurne e notturne, utilizzato per calcolare le temperature massima e minima, si presume che l'inizio 09:00 o 21:00 dell'ora solare, o 10.00 e 22.00 quando L'ORA LEGALE è in vigore, indipendentemente dal giorno della meteorologia.

en: To adjust the meteorological day to your preference, or that used by your local official weather station, edit the "day end hour" line in your ``weather.ini`` file, then run Reprocess.py to regenerate the summaries.
it: Regola la giornata meteorologica con le vostre preferenze, che viene utilizzata dalla stazione meteo ufficiale locale, modificare la linea "day end hour" nel vostro file ``weather.ini``, eseguire quindi Reprocess.py per rigenerare la sintesi.

en: Monthly summary data is computed from the daily summary data. If the meteorological day does not end at midnight, then each month may begin and end up to 12 hours before or after midnight.
it: I dati di riepilogo mensile viene calcolato dal riepilogo giornaliero dei dati. Se la giornata meteorologica non finisce a mezzanotte, ogni mese può iniziare e terminare fino a 12 ore prima o dopo la mezzanotte.

en: Wind speed data is averaged over the hour (or day) and the maximum gust speed during the hour (or day) is recorded. The predominant wind direction is calculated using vector arithmetic.
it: I dati di velocità media del vento è l'ora (o giorno) e la raffica massima velocità durante l'ora (o giorno) è registrato. La direzione predominante del vento è calcolato utilizzando il vettore medio aritmetico.

en: Rainfall is converted from the raw "total since last reset" figure to a more useful total in the last hour, day or month.
it: Le precipitazioni sono state convertite dal raw "total since last reset" rappresenta un più utile totale dell'ultima ora, giorno o mese.

en: Generate summaries from raw weather station data.
it: Genera i dati riepilogativi della stazione meteorologica.

en: 'Calibrate' raw data, using a user-supplied function.
it: 'Calibrare', corregge i dati grezzi (raw), utilizzando una funzione fornita dall'utente

en: Generate daily summaries from calibrated and hourly data.
it: Genera i riepiloghi orari da dati calibrati.

en: Generate hourly summaries from calibrated data.
it: Generare i riepiloghi orari (hourly)  da dati calibrati.

en: Generate monthly summaries from daily data.
it: Genera i riepiloghi mensili dai dati giornalieri.

en: Compute average of multiple data values.
it: Calcola la media di più valori di dati.

en: Calibration class that implements default or user calibration.
it: Classe di taratura che implementa il default o la calibrazione da parte dell'utente.

en: 'Accumulate' weather data to produce daily summary.
it: ìAccumula' dati meteo per produrre un riepilogo giornaliero.

en: 'Accumulate' raw weather data to produce hourly summary.
it: 'Accumula' i dati meteorologici per produrre un riepilogo ogni ora.

en: Compute maximum value and timestamp of multiple data values.
it: Calcola il  valore massimo e data ora di più valori di dati.

en: Compute minimum value and timestamp of multiple data values.
it: Calcola il valore minimo e data ora di più valori di dati.

en: 'Accumulate' daily weather data to produce monthly summary.
it: Accumula giornalmente i dati meteo di produrre riepilogo mensile.

en: Compute average wind speed and maximum wind gust, find dominant wind direction and compute total rainfall.
it: Calcola la velocità media del vento e la raffica di vento massima, trova la direzione del vento dominante e calcola la piovosità totale.

en: Compute average wind speed, maximum wind gust and daytime max & nighttime min temperatures, find dominant wind direction and compute total rainfall.
it: Calcola la velocità media del vento, la raffica massima del vento e max temperatura diurne & min notturna, trova la direzione del vento dominante e calcola la piovosità totale.

en: Daytime is assumed to be 0900-2100 and nighttime to be 2100-0900, local time (1000-2200 and 2200-1000 during DST), regardless of the "day end hour" setting.
it: Il giorno si suppone sia dalle 09:00-21:00 e notturno dalle 21:00-09:00 durante l'ora solare, (10:00-22:00 e 22:00-10:00 durante l'ora legale), a prescindere dall'impostazione "day end hour".

en: Compute daytime max & nighttime min temperatures.
it: Calcola le temperature max diurne min notturna.

en: The meteorological day end (typically 2100 or 0900 local time) is set in the preferences file ``weather.ini``. The default value is 2100 (2200 during DST), following the historical convention for weather station readings.
it: La fine del giorno meteorologico (tipicamente 21:00 o 09:00 ora solare) è impostata nel file delle preferenze ``weather.ini``. Il valore predefinito è 21:00 (22:00 durante l'ora legale), seguendo la storica convenzione per letture della stazione meteo.

en: Regenerate hourly and daily summary data ::
it: Rigenera i dati di riepilogo orari e giornalieri ::

en: This program recreates the calibrated, hourly, daily and monthly summary data that is created by the :py:mod:`pywws.Process` program. It should be run whenever you upgrade to a newer version of pywws (if the summary data format has changed), change your calibration module or alter your pressure offset.
it: Il programma ricrea i dati di riepilogo orari, giornalieri e mensili che sono creati dal programma :py:mod:`pywws.Process`. Esso deve essere eseguito ogni volta che si esegue l'aggiornamento a una versione più recente di pywws.

en: Set some weather station parameters ::
it: Imposta alcuni parametri della stazione meteo ::

en: Routines to perform common tasks such as plotting gaphs or uploading files.
it: Routine per eseguire attività comuni quali disegnare grafici o caricare i file.

en: Upload weather data to weather services such as Weather
it: Carica dati meteo a servizi meteorologici quali Meteo

en: Create text data file based on a template ::
it: Creare file di dati di testo basato su un modello ::

en: This is probably the most difficult to use module in the weather station software collection. It generates text files based on a "template" file plus the raw, hourly, daily & monthly weather station data. The template processing goes beyond simple substitution of values to include loops, jumps forwards or backwards in the data, processing of the data and substitution of missing values.
it: Questo è probabilmente il modulo più difficile da utilizzare dell'insieme di software della stazione meteo. Genera file di testo basati su un file "template" dai dati raw, hourly, daily & monthly  della stazione meteo. L'elaborazione del modello va al di là della semplice sostituzione di valori da includere in cicli, salti in avanti o indietro dei dati, l'elaborazione dei dati e la sostituzione di valori mancanti.

en: A template file can be any sort of text file (plain text, xml, html, etc.) to which "processing instructions" have been added. These processing instructions are delimited by hash ('#') characters. They are not copied to the output, but cause something else to happen: either a data value is inserted or one of a limited number of other actions is carried out.
it: Un file di modello può essere qualsiasi tipo di file di testo (testo normale, xml, html, ecc.) in cui sono stati aggiunti "processing instructions". Queste istruzioni di elaborazione sono delimitate da caratteri di hash ('#'). Essi non vengono copiati all'uscita, ma accade qualcos'altro: o viene inserito un valore di dati o viene effettuato un numero limitato di altre azioni.

en: Before writing your own template files, it might be useful to look at some of the examples in the example_templates directory.
it: Prima di scrivere il proprio file di template, potrebbe essere utile esaminare alcuni esempi nella directory example_templates.

en: Processing instructions
it: Istruzioni di elaborazione

en: output a single '#' character.
it: output di un singolo carattere '#'.

en: ``#! comment text#``
it: ``#! testo di commento#``

en: a comment, no output generated. ``comment text`` can be any text without a line break.
it: Il commento, non genera nessun output. ``testo di commento`` può essere qualsiasi testo senza un'interruzione di riga.

en: switch to "monthly" summary data. The index is reset to the most recent value.
it: ritorna i dati "monthly" di riepilogo. L'indice viene reimpostato sul valore più recente.

en: switch to "daily" summary data. The index is reset to the most recent value.
it: ritorna i dati "daily" di riepilogo. L'indice viene reimpostato sul valore più recente.

en: switch to "hourly" summary data. The index is reset to the most recent value.
it: ritorna i dati "hourly" di riepilogo. L'indice viene reimpostato sul valore più recente.

en: switch to "raw" data. The index is reset to the most recent value.
it: ritorna i dati "raw" di riepilogo. L'indice viene reimpostato sul valore più recente.

en: convert all datetime values to time zone ``name`` before output. Permitted values for name are ``utc`` or ``local``.
it: Converte tutti i valori data e ora del fuso orario ``name`` prima dell'output. I valori consentiti per nome sono ``utc`` o ``local``.

en: switch time rounding on or off, according to ``expr``. When time rounding is on, 30 seconds is added to each time value used. This is useful if you are only printing out hours and minutes, e.g. with a "%H:%M" format, and want time values such as 10:23:58 to appear as "10:24". Use ``"True"`` or ``"False"`` for expr.
it: Interruttore arrotondamento tempo on/off, secondo ``expr``.  Quando l'arrotondamento del tempo è attivo, 30 secondi vengono aggiunti a ciascun valore di tempo. Questo è utile se si stampa solo in ore e minuti, ad esempio con un formato " %H: %M", e che i valori di tempo come ad esempio 10:23:58 di apparire come "10:24 ". Usare ``"True"`` o ``"False"`` per ``expr``.

en: jump ``count`` values. The data index is adjusted by ``count`` hours or days. Negative values jump back in time.
it: Salta i valori ``count``. L'indice dei dati è regolata da ``count`` ore o giorni. Con valori negativi salta indietro nel tempo.

en: It is a good idea to put jumps within a loop at the end, just before the ``#endloop#`` instruction. The loop can then terminate cleanly if it has run out of data.
it: È una buona idea inserire salti all'interno di un loop alla fine, poco prima dell'istruzione ``#endloop#``. Il ciclo può poi terminare in modo pulito se ha esaurito i dati.

en: go to ``date-time``. The data index is adjusted to the record immediately after ``date-time``. This can be in UTC or your local time zone, according to the setting of ``timezone``, and must exactly match the ISO date format, for example ``"2010-11-01 12:00:00"`` is noon on 1st November 2010.
it: va alla ``date-time``'. L'indice di dati è impostato al record immediatamente dopo ``date-time``.Questo può essere in UTC o il fuso orario locale, secondo l'impostazione di ``timezone``, E deve corrispondere esattamente al formato data ISO, per esempio ``"2010-11-01 12:00:00"`` è mezzogiorno a partire dal 1° novembre 2010.

en: Parts of ``date-time`` can be replaced with strftime style % format characters to specify the current loop index. For example, ``"%Y-%m-01 12:00:00"`` is noon on 1st of this month.
it: Parti di ``date-time`` possono essere sostituite con strftime % stile caratteri di formattazione per specificare l'attuale indice del ciclo. Ad esempio, ``"%Y-%m-01 12:00:00"`` è mezzogiorno a partire dal giorno 1 del mese.

en: start a loop that will repeat ``count`` times. ``count`` must be one or more.
it: avvia un ciclo che si ripete ``count`` volte. ``count`` deve essere uno o più.

en: end a loop started by ``#loop count#``. The template processing will go back to the line containing the ``#loop count#`` instruction. Don't try to nest loops.
it: finisce un ciclo avviato da ``#loop count#``. L'elaborazione del modello torna alla riga contenente le istruzioni ``#loop count#``. Non provare a nido loop.

en: output a data value. ``key`` is the data key, e.g. ``temp_out`` for outdoor temperature. ``fmt_string`` is a printf-like format string (actually Python's % operator) except for datetime values, when it is input to datetime's ``strftime()`` method. ``no_value_string`` is output instead of ``fmt_string`` when the data value is absent, e.g. if the station lost contact with the outside sensor. ``conversion`` is a Python expression to convert the data, e.g. to convert wind speed from m/s to mph you could use ``"x * 3.6 / 1.609344"``, or the more convenient provided function ``"wind_mph(x)"``.
it: ricava un valore di dati. `key`` è la chiave dei dati, es. `temp_out`` per la temperatura esterna. ``fmt_string`` è un printf come stringa di formattazione (in realtà l'operatore  % di Python's) tranne che per i valori data e ora, quando si ha data e ora usare il metodo ``strftime()``. ``no_value_string`` risulta al posto di ``fmt_string`` quando il valore dei dati è assente, ad esempio, se la stazione ha perso il contatto con il sensore esterno. ``conversion`` è un espressione Python per convertire i dati, ad esempio per convertire la velocità da m/s a mph è possibile utilizzare ``"x * 3.6 / 1.609344"``, o la funzione più conveniente prevista ``"wind_mph(x)"``.

en: All these values need double quotes " if they contain spaces or other potentially difficult characters. All except ``key`` are optional, but note that if you want to specify a conversion, you also need to specify ``fmt_string`` and ``no_value_string``.
it: Tutti questi valori tra virgolette " contengono spazi e altri caratteri potenzialmente difficili. Tutti tranne ``key`` sono facoltativi, ma si noti che se si desidera specificare una conversione, inoltre, è necessario specificare ``fmt_string`` e ``no_value_string`` .

en: output a value computed from one or more data items. ``expression`` is any valid Python expression, e.g. ``"dew_point(data['temp_out'], data['hum_out'])"`` to compute the outdoor dew point. ``fmt_string``, ``no_value_string`` and ``conversion`` are as described above. Note that it is probably more efficient to incorporate any conversion into expression.
it: restituisce un valore calcolato da uno o più elementi di dati. ``expression`` è una espressione valida in Python, ad es. ``"dew_point(data['temp_out'], data['hum_out'])"`` per calcolare il punto di rugiada all'aperto. ``fmt_string``, ``no_value_string`` e ``conversion`` sono come descritti sopra. Si noti che, probabilmente, è più efficiente incorporare qualsiasi conversione nell'espressione stessa.

en: Example
it: Esempio

en: Here is an example snippet showing basic and advanced use of the template features. It is part of the 6hrs.txt example template file, which generates an HTML table of 7 hourly readings (which should span 6 hours). ::
it: Ecco un esempio di base e utilizzo avanzato del modello. E' parte della 6hrs.txt del file di esempio del modello, che genera una tabella HTML di 7 letture orarie (che deve coprire 6 ore). ::

en: The first three lines of this snippet do the following: select hourly data, jump back 6 hours, start a loop with a count of 7. A jump forward of one hour appears just before the end of the repeated segment. As this last jump (of one hour) happens each time round the loop, a sequence of 7 data readings will be output. The last line marks the end of the loop — everything between the ``#loop 7#`` and ``#endloop#`` lines is output 7 times.
it: Le prime tre righe di questo frammento: seleziona i dati orari, salta indietro di 6 ore, avvia un loop con un conteggio di 7. un salto in avanti di un'ora appare poco prima della fine del segmento ripetuto. A quest'ultimo salto (di un'ora) accade ogni volta nel ciclo, una sequenza di 7 letture dei dati sarà il risultato. L'ultima riga indica la fine del ciclo - tutto tra le linee ``#loop 7#`` e ``#endloop#`` è ripetuta 7 volte.

en: The ``#temp_out ...#``, ``#hum_out ...#``, ``#rain ...#`` and ``#rel_pressure ...#`` instructions show basic data output. They each use a ``fmt_string`` to format the data appropriately. The ``#wind_ave ...#`` and ``#wind_gust ...#`` instructions show how to use a conversion expression to convert m/s to mph.
it: Le istruzioni ``#temp_out ...#``, ``#hum_out ...#``, ``#rain ...#`` e ``#rel_pressure ...#`` mostrano dati di base. Ognuno di essi con un ``fmt_string`` per formattare i dati in modo appropriato. Le istruzioni ``#wind_ave ...#`` e ``#wind_gust ...#`` mostra come utilizzare un'espressione di conversione per convertire m/s a mph.

en: The ``#wind_dir ...#`` and ``#pressure_trend ...#`` instructions show use of the built-in functions ``winddir_text`` and ``pressure_trend_text`` to convert numerical values into text.
it: Le istruzioni ``#wind_dir ...#`` e ``#pressure_trend ...#`` mostrano l'uso della funzione incorporata ``wind_dir_text`` e la funzione ``pressure_trend_text`` convertono i valori numerici in testo.

en: Finally we get to datetime values. The ``#idx "%H%M"#`` instruction simply outputs the time (in HHMM format) of the data's index. The ``#idx "%Y/%m/%d" "" "[None, x][x.hour == 0 or loop_count == 7]"#`` instruction is a bit more complicated. It outputs the date, but only on the first line or if the date has changed. It does this by indexing the array ``[None, x]`` with a boolean expression that is true when ``loop_count`` is 7 (i.e. on the first pass through the loop) or ``x.hour`` is zero (i.e. this is the first hour of the day).
it: Finalmente arriviamo ai valori di datetime. L'istruzione ``#idx "%H%M"#`` emette semplicemente l'ora (in formato HHMM) dell'indice dei dati meteo. L'istruzione``#idx "%Y/%m/%d" "" "[None, x][x.hour == 0 or loop_count == 7]"#`` è un po' più complicato. Esso emette la data, ma solo sulla prima riga o se la data è cambiata. Ciò è reso possibile dall'indicizzazione dell'array ``[None, x]`` con un'espressione booleana che è vera quando ``loop_count`` è 7 (Cioè il primo passo del ciclo) o ``x.hour`` è pari a zero (Vale a dire che questa è la prima ora del giorno).

en: Test connection to weather station.
it: Testare la connessione alla stazione meteo.

en: This is a simple utility to test communication with the weather station. If this doesn't work, then there's a problem that needs to be sorted out before trying any of the other programs. Likely problems include not properly installing the USB libraries, or a permissions problem. The most unlikely problem is that you forgot to connect the weather station to your computer! ::
it: Si tratta di una semplice utilità per verificare la comunicazione con la stazione meteo. Se questo non funziona, allora c'è un problema che va risolto prima di altri programmi. Problemi che potrebbero includere la non corretta installazione delle librerie USB, o un problema di autorizzazioni. Il problema più improbabile è che hai dimenticato di collegare la stazione meteo al computer ! ::

en: Provide a couple of :py:class:`datetime.tzinfo` objects representing local time and UTC.
it: :py:class:`datetime.tzinfo` sono paio di oggetti che rappresentano l'ora locale e UTC

en: This module provides two :py:class:`datetime.tzinfo` objects representing UTC and local time zones. These are used to convert timestamps to and from UTC and local time. The weather station software stores data with UTC timestamps, to avoid problems with daylight savings time, but the template and plot programs output data with local times.
it: Questo modulo fornisce due :py:class:`datetime.tzinfo` gli oggetti che rappresentano l'ora UTC e l'ora locale. Questi sono utilizzati per convertire timestamp da e verso l'ora UTC e l'ora locale. Il software della stazione meteo  archivia i dati con data e ora UTC, per evitare problemi con l'ora legale, ma i programmi modelli template e i grafici usano l'ora locale.

en: The module is copied directly from the :py:class:`datetime.tzinfo` module documentation.
it: Il modulo viene copiato direttamente dalla documentazione :py:class:`datetime.tzinfo`.

en: Local time
it: Ora locale

en: Abstract base class for time zone info objects.
it: Classe base astratta per informazioni oggetti di fuso orario.

en: Post a message to Twitter ::
it: Postare messaggi su Twitter ::

en: This module posts a brief message to `Twitter <https://twitter.com/>`_. Before posting to Twitter you need to set up an account and then authorise pywws by running the :py:mod:`TwitterAuth` program. See :doc:`../guides/twitter` for detailed instructions.
it: Questo modulo invia un breve messaggio a `Twitter <https://twitter.com/>`_. Prima di pubblicare su Twitter è necessario configurare un account e quindi autorizzare pywws eseguendo il programma :py:mod:`TwitterAuth`. Vedere :doc:`../guides/twitter` per le istruzioni dettagliate.

en: Authorise pywws to post to your Twitter account ::
it: Autorizzare pywws per inviare al vostro account Twitter ::

en: This program authorises :py:mod:`pywws.ToTwitter` to post to a Twitter account. You need to create an account before running :py:mod:`TwitterAuth`. It opens a web browser window (or gives you a URL to copy to your web browser) where you log in to your Twitter account. If the login is successful the browser will display a 7 digit number which you then copy to :py:mod:`TwitterAuth`.
it: Questo programma autorizza :py:mod:`pywws.ToTwitter` per postare su un account Twitter. È necessario creare un account prima di eseguire :py:mod:`TwitterAuth`.  Si apre una finestra del browser web (o un URL da copiare nel il browser web) che consente di accedere al tuo account Twitter. Se il login ha successo il browser visualizzerà un numero di 7 cifre, numero che poi copia in :py:mod:`TwitterAuth`.

en: See :doc:`../guides/twitter` for more detail on using Twitter with pywws.
it: Vedere :doc:`../guides/twitter` per ulteriori dettagli su come usare Twitter con pywws.

en: Test quality of USB connection to weather station
it: Verificare la qualità della connessione USB della stazione meteo

en: The USB link to my weather station is not 100% reliable. The data read from the station by the computer is occasionally corrupted, perhaps by interference. I've been trying to solve this by putting ferrite beads around the USB cable and relocating possible interference sources such as external hard drives. All without any success so far.
it: Il collegamento USB per la mia stazione meteo non è affidabile al 100%. La lettura dei dati della stazione dal computer è occasionalmente corrotto, forse per interferenza. Ho cercato di risolvere questo problema mettendo ferrite intorno al cavo USB e trasferire possibili sorgenti di interferenza, come dischi rigidi esterni. Tutti senza successo finora.

en: This program tests the USB connection for errors by continuously reading the entire weather station memory (except for those parts that may be changing) looking for errors. Each 32-byte block is read twice, and if the two readings differ a warning message is displayed. Also displayed are the number of blocks read, and the number of errors found.
it: Questo programma mette alla prova la connessione USB per gli errori per leggere in modo continuo tutta la memoria della stazione meteo (ad eccezione di quelle parti che possono variare) alla ricerca di errori. Ogni blocco di 32-byte viene letto due volte, e se i due valori differiscono viene visualizzato un messaggio di avviso. Sono visualizzati anche il numero di blocchi letti, e il numero di errori riscontrati.

en: I typically get one or two errors per hour, so the test needs to be run for several hours to produce a useful measurement. Note that other software that accesses the weather station (such as :doc:`pywws.Hourly` or :doc:`pywws.LiveLog`) must not be run while the test is in progress.
it: In genere sono uno o due errori per ora, quindi il test deve essere eseguito per diverse ore per produrre una misura utile. Nota che un altro software che permette di accedere alla stazione meteo (come :doc:`pywws.Hourly` or :doc:`pywws.LiveLog`) non deve essere eseguito mentre il test è in corso.

en: If you run this test and get no errors at all, please let me know. There is something good about your setup and I'd love to know what it is!
it: Se si esegue questo test e non trovate gli errori, per favore fatemelo sapere. C'è qualcosa di miracoloso nella configurazione e mi piacerebbe sapere cosa è!

en: Upload files to a web server by ftp or copy them to a local directory ::
it: Carica i file su un server web tramite ftp o li copia in una directory locale ::

en: Login and ftp site details are read from the weather.ini file in data_dir.
it: I dettagli login e ftp vengono letti dal file weather.ini in data_dir.

en: This module uploads files to (typically) a website *via* ftp/sftp or copies files to a local directory (e.g. if you are running pywws on the your web server). Details of the upload destination are stored in the file ``weather.ini`` in your data directory. The only way to set these details is to edit the file. Run :py:mod:`pywws.Upload` once to set the default values, which you can then change. Here is what you're likely to find when you edit ``weather.ini``::
it: Questo modulo che carica il file (in genere) di un sito Web *tramite* ftp/sftp o copia i file in una directory locale (ad esempio se si esegue pywws sul proprio server web). Dettagli della destinazione upload sono memorizzati nel file ``weather.ini`` nella directory dati. L'unico modo per impostare questi dettagli è modificare il file. Eseguire :py:mod:`pywws.Upload` una volta per impostare i valori predefiniti, che poi possono cambiare. Ecco cosa è probabile trovare quando si modifica la ``weather.ini``::

en: These are, I hope, fairly obvious. The ``local site`` option lets you switch from uploading to a remote site to copying to a local site. If you set ``local site = True`` then you can delete the ``secure``, ``site``, ``user`` and ``password`` lines.
it: Queste sono, spero, abbastanza ovvie. Il ``local site`` consente di passare dal caricamento in un sito remoto alla copia di un sito locale. Se si imposta ``local site = True`` quindi è possibile eliminare le linee ``secure``, ``site``, ``user`` e ``password``.

en: ``directory`` is the name of a directory in which all the uploaded files will be put. This will depend on the structure of your web site and the sort of host you use. Your hosting provider should be able to tell you what ``site`` and ``user`` details to use. You should have already chosen a ``password``.
it: ``directory``è il nome di una directory in cui verranno messi tutti i file caricati. Ciò dipenderà dalla struttura del sito web e l'ordinamento dell'host che si utilizza. Il provider di hosting dovrebbe essere in grado di dirvi quali dettagli ``site`` and ``user`` utilizzare. Si dovrebbe già aver scelto una ``password``.

en: The ``secure`` option lets you switch from normal ftp to sftp (ftp over ssh). Some hosting providers offer this as a more secure upload mechanism, so you should probably use it if available.
it: L'opzione ``secure`` consente di passare da ftp normale a sftp (ftp sopra ssh). Alcuni fornitori di hosting offrono questo come un meccanismo di caricamento più sicuro, quindi si dovrebbe probabilmente usare se disponibile.

en: Get data from WH1080/WH3080 compatible weather stations.
it: Ottenere i dati da stazioni meteo compatibili con WH1080/WH3080.

en: Derived from wwsr.c by Michael Pendec (michael.pendec@gmail.com), wwsrdump.c by Svend Skafte (svend@skafte.net), modified by Dave Wells, and other sources.
it: Derivato da wwsr.c by Michael Pendec (michael.pendec@gmail.com), wwsrdump.c by Svend Skafte (svend@skafte.net), modificato da Dave Wells, e altre fonti.

en: This is the module that actually talks to the weather station base unit. I don't have much understanding of USB, so copied a lot from Michael Pendec's C program wwsr.
it: Questo è il modulo che in realtà comunica con l'unità di base della stazione meteo. Non ho molta comprensione dell' USB, quindi copiato molto dal programma in C wwsr di Michael Pendec's

en: The weather station memory has two parts: a "fixed block" of 256 bytes and a circular buffer of 65280 bytes. As each weather reading takes 16 bytes the station can store 4080 readings, or 14 days of 5-minute interval readings. (The 3080 type stations store 20 bytes per reading, so store a maximum of 3264.) As data is read in 32-byte chunks, but each weather reading is 16 or 20 bytes, a small cache is used to reduce USB traffic. The caching behaviour can be over-ridden with the ``unbuffered`` parameter to ``get_data`` and ``get_raw_data``.
it: La memoria della stazione meteo è divisa in due parti: "fixed block" di 256 byte e un buffer circolare di 65280 byte. Siccome ogni stringa prende 16 byte la stazione può immagazzinare 4080 letture, o 14 giorni di letture di intervallo di 5 minuti. (Le stazioni tipo 3080 memorizzano 20 byte per la stringa, quindi memorizzano un massimo di 3264). Siccome lettura dei dati è in blocchi di 32 byte, ma ogni lettura meteo è 16 o 20 byte, una piccola cache viene utilizzata per ridurre il traffico USB. Il comportamento di memorizzazione nella cache può essere esclusa con il parametro  ``unbuffered`` in ``get_data`` e ``get_raw_data``.

en: Decoding the data is controlled by the static dictionaries ``reading_format``, ``lo_fix_format`` and ``fixed_format``. The keys are names of data items and the values can be an ``(offset, type, multiplier)`` tuple or another dictionary. So, for example, the reading_format dictionary entry ``'rain' : (13, 'us', 0.3)`` means that the rain value is an unsigned short (two bytes), 13 bytes from the start of the block, and should be multiplied by 0.3 to get a useful value.
it: La decodifica dei dati è controllato da dizionari statici  ``reading_format``, ``lo_fix_format`` e ``fixed_format``. Le chiavi sono i nomi di elementi di dati e i valori possono essere di tipo ``(offset, type, multiplier)`` o un altro dizionario. Così, per esempio, la voce del dizionario reading_format  ``'rain' : (13, 'us', 0.3)`` significa che il valore di pioggia è un breve short senza segno (due byte), 13 byte dall'inizio del blocco e deve essere moltiplicato per 0,3 per ottenere un valore utile.

en: The use of nested dictionaries in the ``fixed_format`` dictionary allows useful subsets of data to be decoded. For example, to decode the entire block ``get_fixed_block`` is called with no parameters::
it: L'uso di dizionari annidati nel dizionario ``fixed_format`` permette utili sottoinsiemi di dati per essere decodificati. Ad esempio, per decodificare l'intero blocco ``get_fixed_block`` viene chiamato senza parametri ::

en: To get the stored minimum external temperature, ``get_fixed_block`` is called with a sequence of keys::
it: Per ottenere la temperatura esterna minima memorizzata, è chiamato ``get_fixed_block``  con una sequenza di comandi::

en: Often there is no requirement to read and decode the entire fixed block, as its first 64 bytes contain the most useful data: the interval between stored readings, the buffer address where the current reading is stored, and the current date & time. The ``get_lo_fix_block`` method provides easy access to these.
it: Spesso non non c'è nessun obbligo di leggere e decodificare l'intero blocco, siccome i primi 64 byte contengono i dati più utili: l'intervallo dei valori memorizzati, l'indirizzo del buffer dove è memorizzata la lettura corrente e l'ora della data corrente. Il metodo ``get_lo_fix_block`` fornisce facile accesso a questi dati.

en: For more examples of using the WeatherStation module, see the TestWeatherStation program.
it: Per ulteriori esempi di utilizzo del modulo WeatherStation, consultare il programma TestWeatherStation.

en: Low level interface to weather station via USB.
it: Interfaccia di basso livello della stazione meteo tramite USB.

en: Low level USB device access via hidapi library.
it: Basso livello di accesso al dispositivo USB tramite la libreria hidapi.

en: Class that represents the weather station to user program.
it: Classe che rappresenta la stazione meteorologica nel programma utente.

en: Loosely modeled on a C++ class obtained from http://site.ambientweatherstore.com/easyweather/ws_1080_2080_protocol.zip. I don't know the provenance of this, but it looks as if it may have come from the manufacturer.
it: Liberamente ispirato su una classe C++ ottenuta da http://site.ambientweatherstore.com/easyweather/ws_1080_2080_protocol.zip.Non so la provenienza di questo, ma sembra che siano venuti dal produttore.

en: Read 32 bytes from the weather station.
it: Legge 32 byte dalla stazione meteo.

en: If the read fails for any reason, :obj:`None` is returned.
it: Se la lettura non riesce per qualche motivo, :obj:`None` viene restituito.

en: address to read from.
it: Indirizzo di lettura da.

en: the data from the weather station.
it: I dati della stazione meteo.

en: list(int)
it: elenco(int)

en: Write a single byte to the weather station.
it: Scrive un singolo byte sulla stazione meteo.

en: address to write to.
it: Indirizzo di scrittura su.

en: the value to write.
it: il valore da scrivere.

en: Connect to weather station and prepare to read data.
it: Connettersi alla stazione metereologica e preparare per la lettura dei dati.

en: Get next circular buffer data pointer.
it: Ottenere il puntatore ai dati successivi del buffer circolare.

en: Get previous circular buffer data pointer.
it: Ottenere il puntatore ai dati precedenti nel buffer circolare.

en: Get raw data from circular buffer.
it: Ottiene i dati grezzi (raw) dal buffer circolare.

en: If unbuffered is false then a cached value that was obtained earlier may be returned.
it: Se 'unbuffered' è false, potrebbe essere restituito un valore memorizzato nella cache, che è stato ottenuto in precedenza.

en: Get decoded data from circular buffer.
it: Ottiene i dati decodificati dal buffer circolare.

en: Get circular buffer location where current data is being written.
it: Ottiene la posizione del buffer circolare dove sono scritti dati correnti.

en: Get the raw "fixed block" of settings and min/max data.
it: Ottiene il grezzo (raw) "fixed block" di impostazioni e dati di min/max.

en: Get the decoded "fixed block" of settings and min/max data.
it: Ottiene decodificato "fixed block" di impostazioni e dati di min/max.

en: A subset of the entire block can be selected by keys.
it: Per selezionare un sottoinsieme di tutto il blocco tasti.

en: Write a set of single bytes to the weather station. Data must be an array of (ptr, value) pairs.
it: Scrive una serie di byte singoli sulla stazione meteo. Dati devono essere una matrice di coppie (ptr, value).

en: Plot a "wind rose"
it: Traccia una "rosa dei venti"

en: This routine plots one or more "wind roses" (see `Wikipedia <http://en.wikipedia.org/wiki/Wind_rose>`_ for a description). Like :py:mod:`pywws.Plot` almost everything is controlled by an XML "recipe" / template file.
it: Questa routine traccia uno o più "wind roses" (vedi `Wikipedia <http://en.wikipedia.org/wiki/Wind_rose>`_ per una descrizione). Come :py:mod:`pywws.Plot` quasi tutto è controllato da un modello di file XML "recipe" / template.

en: Before writing your own template files, it might be useful to look at some of the examples in the example_graph_templates directory. If (like I was) you are unfamiliar with XML, I suggest reading the `W3 Schools XML tutorial <http://www.w3schools.com/xml/>`_.
it: Prima di scrivere i file di modello, potrebbe essere utile a guardare alcuni esempi nella directory example_graph_templates. Se (come ero) non si ha dimestichezza con XML, vi suggerisco di leggere la `W3 Schools XML tutorial <http://www.w3schools.com/xml/>`_.

en: Here is the simplest useful wind rose template. It plots wind over the last 24 hours. ::
it: Questo è il modello più semplice rosa dei venti. Esso disegna un grafico del vento nel corso delle ultime 24 ore. ::

en: In this example, the root element graph has one windrose element which contains nothing more than a ycalc element.
it: In questo esempio, l'elemento radice grafico ha una rosa dei venti che non contiene più di un elemento ycalc.

en: A separate plot is drawn for each windrose element, but all share the same time period.
it: Una traccia separata è disegnata per ogni elemento della rosa dei venti, ma tutti condividono lo stesso periodo di tempo.

en: This element sets the date & time of the wind roses. It is used in the constructor of a Python datetime object. For example, to start at noon (local time) on Christmas day 2008: ``<start>year=2008, month=12, day=25, hour=12</start>``. The default value is (stop - duration).
it: Questo elemento imposta la data & ora della rosa dei venti. È usato nel costruttore dell'oggetto datetime di Python. Ad esempio, per iniziare a mezzogiorno (ora locale) il giorno di Natale 2008: ``<start>year=2008, month=12, day=25, hour=12</start>``. Il valore predefinito è (stop - durata).

en: This element sets the date & time of the end of the wind roses. It is used in the constructor of a Python datetime object. For example, to end at 10 am (local time) on new year's day 2009: ``<stop>year=2009, month=1, day=1, hour=10</stop>``. The default value is (start + duration), unless start is not defined in which case the timestamp of the latest weather station hourly reading is used.
it: Questo elemento imposta la data di fine della rosa dei venti. È usato nel costruttore dell'oggetto datetime di Python. Ad esempio, per finire alle 10:00 (ora locale) il giorno di Capodanno 2009: ``<stop>year=2009, month=1, day=1, hour=10</stop>``. Il valore predefinito è (start + durata), a meno che l'inizio non è definito in questo caso viene utilizzato il timestamp dell'ultima lettura oraria della stazione meteo.

en: This element sets the duration of wind roses, unless both start and stop are defined. It is used in the constructor of a Python timedelta object. For example, to plot one week: ``<duration>weeks=1</duration>``. The default value is hours=24.
it: Questo elemento imposta la durata della rosa dei venti, a meno che non siano definiti start e stop. È usato nel costruttore dell'oggetto timedelta Python. Ad esempio, traccia una settimana: ``<duration>weeks=1</duration>``. Il valore predefinito è ore 24.

en: Controls the layout of the plots. Default is a grid that is wider than it is tall. The layout element specifies rows and columns. For example: ``<layout>4, 2</layout>`` will use a grid of 4 rows and 2 columns.
it: Controlla il layout delle tracce. Predefinita è una griglia che è più largo che alto. L'elemento layout specifica di righe e colonne. Ad esempio: ``<layout>4, 2</layout>`` verrà utilizzata una griglia di 4 righe e 2 colonne.

en: Sets the overall dimensions of the image file containing the graph. Default is a height of 600 pixels and a width that depends on the layout. Any size element must include both width and height. For example: ``<size>800, 600</size>`` will produce an image 800 pixels wide and 600 pixels high.
it: Imposta le dimensioni di ingombro del file immagine contenente il grafico. Predefinito è un'altezza di 600 pixel e una larghezza che varia a seconda del layout. Qualsiasi elemento di dimensioni deve includere sia la larghezza che l'altezza. Ad esempio: ``<size>800, 600</size>`` produrrà un'immagine di 800 pixel di larghezza e 600 pixel di altezza.

en: Sets the image format of the file containing the plots. Default is png. Any string recognised by your installation of gnuplot should do. For example: ``<fileformat>gif</fileformat>`` will produce a GIF image.
it: Imposta il formato dell'immagine del file contenente le tracce. Predefinito è png. Qualsiasi stringa riconosciuta dalla vostra installazione di gnuplot dovrebbe funzionare. Ad esempio: ``<fileformat>gif</fileformat>`` produrrà un'immagine GIF.

en: Over-rides the automatically computed left, right, top or bottom margin. Supply any positive real number, for example ``<lmargin>1.3</lmargin>``. Some experimentation may be necessary to find the best values.
it: Esclude il calcolo automaticamente a sinistra, a destra, margine superiore o inferiore. Ogni numero reale positivo, per esempio ``<lmargin>1.3</lmargin>``. Alcune sperimentazioni possono essere necessarie per trovare i migliori valori.

en: Sets the overall title of the plots. A single line of text, for example: ``<title>Today's weather</title>``. This title appears at the very top, outside any plot area.
it: Imposta il titolo assoluto. Una singola riga di testo, ad esempio: ``<title>Il Meteo oggi</title>``. Questo titolo viene visualizzato nella parte superiore, al di fuori di qualsiasi area del grafico.

en: Selects if data is included in the wind rose. The value should be a valid Python logical expression. For example, to plot a rose for afternoon winds only: ``<xcalc>data['idx'].hour &gt;= 12</xcalc>``. This allows aggregation of afternoon wind data over several days. Remember that data is indexed in UTC, so you need to use an expression that takes account of your time zone. The default value is 'True'.
it: Seleziona i dati inclusi nella rosa dei venti. Il valore deve essere un'espressione logica valida di Python. Ad esempio, per tracciare una rosa dei venti solo per il pomeriggio: ``<xcalc>data['idx'].hour &gt;= 12</xcalc>``. Questo permette l'aggregazione dei dati del vento pomeridiano per diversi giorni. Ricordo che dati sono indicizzati in UTC, quindi è necessario utilizzare un'espressione che tiene conto del tuo fuso orario. Il valore predefinito è 'True'.

en: Selects the data to be plotted. Any one line Python expression that returns a single float value can be used. At its simplest this just selects one value from the "data" dictionary, for example: ``<ycalc>data['wind_ave']</ycalc>``. To convert to mph use: ``<ycalc>data['wind_ave'] * 3.6 / 1.609344</ycalc>``. You are unlikely to want to use anything other than 'wind_ave' here.
it: Seleziona i dati da tracciare. Può essere utilizzato una qualsiasi linea espressione Python che restituisce un valore a virgola mobile. Nella sua forma più semplice questo seleziona un valore dal dizionario "data", per esempio: ``<ycalc>data['wind_ave']</ycalc>``. Per la conversione in mph: ``<ycalc>data['wind_ave'] * 3.6 / 1.609344</ycalc>``. È improbabile che desidera utilizzare altro qui che 'wind_ave'.

en: Sets the thresholds for each colour on the rose petals. Defaults are based on the Wikipedia example. The values should be a correctly ordered list of real numbers, for example: ``<threshold>0.5, 3.5, 7.5, 12.5, 18.5, 24.5, 31.5</threshold>`` approximates to the Beaufort scale, if ycalc has been set to convert windspeeds to mph.
it: Fissa le soglie per ogni colore dei petali di rosa. Valori predefiniti sono basati su Wikipedia. I valori devono essere una lista correttamente ordinata di numeri reali, ad esempio: ``<threshold>0.5, 3.5, 7.5, 12.5, 18.5, 24.5, 31.5</threshold>`` si avvicina alla scala di Beaufort, se ycalc è stato impostato per convertire la velocità del vento in km/h.

en: Sets the colours of the threshold petal segments. Any sequence of integer values is accepted. The mapping of colours to numbers is set by gnuplot. Default value is 0, 1, 2, 3, etc.
it: Imposta la soglia dei colori nei segmenti del petalo. Ogni sequenza di valori interi è accettata. La mappatura dei colori ai numeri è impostato da gnuplot. Valore di default è 0, 1, 2, 3, ecc.

en: Sets the upper limits of the axes. The rose shows what percentage of the time the wind came from a particular direction. For example, if you live somewhere with a very steady wind you might want to allow higher percentages than normal: ``<yrange>91</yrange>``. Auto-scaling is also possible, using an asterisk: ``<yrange>*</yrange>``
it: Imposta il limite superiore degli assi. La rosa rappresenta la percentuale del tempo che il vento proveniva da una particolare direzione. Per esempio, se vivi in un posto con un vento molto stabile è possibile consentire a percentuali più elevate del normale: ``<yrange>91</yrange>``. Ridimensionamento automatico è inoltre possibile, utilizzando un asterisco: ``<yrange>*</yrange>``

en: Sets the text of the compass points. The defaults are 'N', 'S', 'E' & 'W'. For graphs in another language you can over-ride this, for example: ``<points>'No', 'Zu', 'Oo', 'We'</points>``. (The preferred way to do this is to create a language file, see Localisation.py.)
it: Imposta il testo dei punti cardinali. Le impostazioni predefinite sono 'N', 'S', 'E' & 'W'. Per i grafici in un'altra lingua è possibile sovrascrivere questo, ad esempio: ``<points>'No', 'Zu', 'Oo', 'We'</points>``. (Il modo migliore per farlo è di creare il file della lingua, vedi Localisation.py.)

en: Sets the title of the plot. A single line of text, for example: ``<title>Morning winds</title>``. This title appears within the plot area, above the threshold colour key.
it: Imposta il titolo della grafico. Una singola riga di testo, ad esempio: ``<title>Venti mattutini</title>``. Questo titolo viene visualizzato all'interno dell'area di stampa, al di sopra della soglia chiave del colore.

en: Generate YoWindow XML file ::
it: Generare file XML YoWindow

en: Class to write YoWindow XML file.
it: Classe YoWindow per scrivere il file XML

en: Class to write YoWindow XML file. For file spec see http://yowindow.com/doc/yowindow_pws_format.xml
it: Classe YoWindow per scrivere il file XML. Specifiche per il file per vedere http://yowindow.com/doc/yowindow_pws_format.xml

en: Simple implementation of Zambretti forecaster algorithm.
it: Semplice implementazione dell'algoritmo previsioni del tempo di Zambretti.

en: Simple implementation of Zambretti forecaster algorithm. Inspired by beteljuice.com Java algorithm, as converted to Python by honeysucklecottage.me.uk, and further information from http://www.meteormetrics.com/zambretti.htm
it: Semplice implementazione dell'algoritmo previsioni del tempo di Zambretti. Ispirato dall'algoritmo Java di beteljuice.com, e convertito in Python da honeysucklecottage.me.uk, ulteriori informazioni da http://www.meteormetrics.com/zambretti.htm

en: Calibrate raw weather station data
it: Calibra i dati grezzi stazione meteo

en: This module allows adjustment of raw data from the weather station as part of the 'processing' step (see :doc:`pywws.Process`). For example, if you have fitted a funnel to double your rain gauge's collection area, you can write a calibration routine to double the rain value.
it: Questo modulo permette l'adattamento dei dati grezzi(raw) della stazione meteo come parte del passo 'processing' (vedi: doc:`pywws.Process`). Ad esempio, se abbiamo montato un imbuto a doppia zona di raccolta del pluviometro, è possibile scrivere una routine di calibrazione per raddoppiare il valore di pioggia.

en: The default calibration does two things:
it: La calibrazione di default fa due cose:

en: Generate relative atmospheric pressure.
it: Generare la pressione atmosferica relativa.

en: Remove invalid wind direction values.
it: Rimuovere i valori della direzione del vento non validi.

en: Any user calibration you write must also do these.
it: Qualsiasi calibrazione si scriva deve anche fare di questi.

en: Writing your calibration module
it: Scrivendo il vostro modulo di calibrazione

en: Firstly, decide where you want to keep your module. Like your text and graph templates, it's best to keep it separate from the pywws code, so it isn't affected by pywws upgrades. I suggest creating a ``modules`` directory in the same place as your ``templates`` directory.
it: In primo luogo, decidere dove si desidera salvare il vostro modulo. Come i modelli di testo e grafici, è meglio tenerlo separato dal codice pywws, quindi esso non è influenzato da aggiornamenti pywws. Vi suggerisco di creare una directory ``modules`` nello stesso luogo come la directory ``templates``.

en: You could start by copying one of the example calibration modules, or you can create a plain text file in your ``modules`` directory, e.g. ``calib.py`` and copy the following text into it::
it: Si potrebbe iniziare copiando uno dei moduli calibrazione di esempio, oppure è possibile creare un file di testo nella directory ``modules``, ad esempio ``calib.py`` e copiare il seguente testo in esso::

en: The :class:`Calib` class has two methods. :py:meth:`Calib.__init__` is the constructor and is a good place to set any constants you need. It is passed a reference to the raw data storage which can be useful for advanced tasks such as spike removal. :py:meth:`Calib.calib` generates a single set of 'calibrated' data from a single set of 'raw' data. There are a few rules to follow when writing this method:
it: La classe :class:`Calib` ha due metodi. :py:meth:`Calib.__init__` è il costruttore ed è un buon posto per impostare tutte le costanti necessarie. E' un riferimento passato per la memorizzazione dei dati grezzi, che può essere utile per attività avanzate come la rimozione picchi. :py:meth:`Calib.calib` genera un singolo set di dati 'calibrato' da un singolo set di dati 'raw'. Ci sono alcune regole da seguire quando si scrive questo file:

en: Make sure you include the line ``result = dict(raw)``, which copies all the raw data to your result value, at the start.
it: Assicurati di includere la riga ``result = dict(raw)``, che copia tutti i dati grezzi(raw) per il risultato valido, dall'inizio.

en: Don't modify any of the raw data.
it: Non modificare i dati grezzi(raw).

en: Make sure you set ``result['rel_pressure']``.
it: Assicurarsi di impostare ``result['rel_pressure']``.

en: Don't forget to ``return`` the result at the end.
it: Non dimenticate ``return`` situato alla fine del file.

en: When you've finished writing your calibration module you can get pywws to use it by putting its location in your ``weather.ini`` file. It goes in the ``[paths]`` section, as shown in the example below::
it: Quando hai finito di scrivere il tuo modulo di calibrazione è possibile ottenere da pywws che la utilizzi mettere la sua posizione nel vostro file ``weather.ini`` Va in sezione ``[paths]``, come mostrato nell'esempio di seguito::

en: Note that the ``user_calib`` value need not include the ``.py`` at the end of the file name.
it: Si noti che il valore ``user_calib`` non comprende l'estenzione ``.py`` alla fine del nome del file.

en: Default calibration class.
it: Classe di calibrazione predefinita.

en: This class sets the relative pressure, using a pressure offset originally read from the weather station, and 'sanitises' the wind direction value. This is the bare minimum 'calibration' required.
it: Questa classe definisce la pressione relativa, utilizzando il parametro di pressione originariamente letto dalla stazione meteo, e 'sanitises' la direzione del vento. Questo è il minimo richiesto per la 'calibrazione'.

en: Other pywws modules use this method to create a calibration object. The constructor creates either a default calibration object or a user calibration object, depending on the ``user_calib`` value in the ``[paths]`` section of the ``params`` parameter. It then adopts the calibration object's :py:meth:`calib` method as its own.
it: Altri moduli pywws utilizzano questo metodo per creare un oggetto di taratura. Il costruttore crea un oggetto predefinito calibrazione o un oggetto di calibrazione dell'utente, secondo il valore di ``user_calib`` nella sezione ``[paths]`` dei parametri ``params``. Allora adotta la calibrazione oggetto :py:meth:`calib` metodo come propri.

en: conversions.py - a set of functions to convert pywws native units (Centigrade, mm, m/s, hPa) to other popular units
it: conversions.py - è un insieme di funzioni per convertire l'unità nativa di pywws (gradi centigradi, mm, m/s, hPa) ad altre unità popolari

en: Convert pressure trend to a string, as used by the UK met office.
it: Converte in una stringa, la tendenza barometrica sono usati per la UK met office.

en: Compute dew point, using formula from http://en.wikipedia.org/wiki/Dew_point.
it: Calcola il punto di rugiada, usando la formula da http://en.wikipedia.org/wiki/Dew_point.

en: See http://en.wikipedia.org/wiki/Heat_index, formula 1. The formula is not valid for T < 26.7C, Dew Point < 12C, or RH < 40%
it: Vedi http://en.wikipedia.org/wiki/Heat_index, formula 1. La formula non è valida per T < 26.7C, Dew Point < 12C, or RH < 40%

en: Compute wind chill, using formula from http://en.wikipedia.org/wiki/wind_chill
it: Calcola il vento gelido, usando la formula da http://en.wikipedia.org/wiki/wind_chill

en: Compute apparent temperature (real feel), using formula from http://www.bom.gov.au/info/thermal_stress/
it: Calcola la temperatura apparente (temperatura percepita), con formula da http://www.bom.gov.au/info/thermal_stress/

en: Low level USB interface to weather station, using ctypes to access hidapi.
it: Interfaccia di basso livello USB della stazione meteo, utilizzando ctypes per accedere a hidapi.

en: This module handles low level communication with the weather station via `ctypes <http://docs.python.org/2/library/ctypes.html>`_ and the `hidapi <https://github.com/signal11/hidapi>`_ library. Alternative modules, :doc:`pywws.device_cython_hidapi` and :doc:`pywws.device_pyusb`, use other libraries. The choice of which module to use depends on which libraries are available for you computer.
it: Questo modulo gestisce la comunicazione di livello basso con la stazione meteo tramite la libreria `ctypes <http://docs.python.org/2/library/ctypes.html>`_ e `hidapi <https://github.com/signal11/hidapi>`_. Un modo alternativo utilizza la libreria, :doc:`pywws.device_cython_hidapi`, e :doc:`pywws.device_pyusb`. La scelta di quale modo utilizzare dipende da quali librerie sono disponibili per il tuo computer.

en: Users of recent versions of Mac OS have less choice. The operating system makes it very difficult to access HID devices (such as the weather station) directly, so the ``hidapi`` library has to be used.
it: Gli utenti delle recenti versioni di Mac OS non hanno altra scelta. Il sistema operativo rende molto difficile accedere direttamente, ai dispositivi HID (come la stazione meteorologica) così la libreria ``hidapi`` deve essere usata.

en: Users of OpenWRT and similar embedded Linux platforms will probably not be able to install ``ctypes`` or ``cython-hidapi``, so are constrained to use ``libusb`` and its ``PyUSB`` Python interface.
it: Gli utenti di OpenWRT e simili piattaforme Linux embedded probabilmente non sono in grado di installare ``ctypes`` o ``cython-hidapi``, così sono costretti ad usare ``libusb`` e la sua interfaccia Python ``PyUSB``.

en: Installation
it: Installazione

en: Some of this software may already be installed on your machine, so do check before downloading sources and compiling them yourself.
it: Alcuni di questi software potrebbero essere già installati sulla vostra macchina, quindi controllare prima di scaricare i sorgenti e compilarli da te.

en: Install hidapi.
it: Installazione hidapi

en: Create a local copy of the git repository, change to the new directory and then follow the instructions in ``README.txt``::
it: Creare una copia locale del repository git, passare alla nuova directory e quindi seguire le istruzioni in ``README.txt``::

en: Install ctypes.
it: Installare ctypes.

en: This should be available as a package for your operating system. For example::
it: Questo dovrebbe essere disponibile come pacchetto per il sistema operativo. Ad esempio::

en: Testing
it: Collaudo

en: Run ``TestWeatherStation.py`` with increased verbosity so it reports which USB device access module is being used::
it: Eseguire ``TestWeatherStation.py`` con un livello di dettaglio maggiore così segnala quale modulo USB di accesso al dispositivo viene usato::

en: the USB "vendor ID" number, for example 0x1941.
it: the USB "vendor ID" number, per esempio 0x1941.

en: the USB "product ID" number, for example 0x8021.
it: the USB "product ID" number, per esempio 0x8021.

en: Receive data from the device.
it: Riceve i dati dalla stazione meteo.

en: If the read fails for any reason, an :obj:`IOError` exception is raised.
it: Se la lettura non riesce per qualche motivo, :obj:`IOError` l'eccezione è restituita.

en: the number of bytes to read.
it: il numero di byte da leggere.

en: the data received.
it: i dati ricevuti.

en: Send data to the device.
it: Inviare dati al dispositivo.

en: the data to send.
it: i dati da inviare.

en: Low level USB interface to weather station, using cython-hidapi.
it: Interfaccia di basso livello USB della stazione meteo, tramite cython-hidapi.

en: This module handles low level communication with the weather station via the `cython-hidapi <https://github.com/gbishop/cython-hidapi>`_ library. An alternative module, :doc:`pywws.device_pyusb`, uses the `PyUSB <http://sourceforge.net/apps/trac/pyusb/>`_ library. The choice of which module to use depends on which libraries are available for you computer.
it: Questo modulo gestisce la comunicazione di livello basso con la stazione meteo tramite la libreria `cython-hidapi <https://github.com/gbishop/cython-hidapi>`_. Un modulo alternativo, :doc:`pywws.device_pyusb`, utilizza la libreria `PyUSB <http://sourceforge.net/apps/trac/pyusb/>`_. La scelta di quale modulo utilizzare dipende da quali librerie sono disponibili per il tuo computer.

en: Users of recent versions of Mac OS have no choice. The operating system makes it very difficult to access HID devices (such as the weather station) directly, so the ``hidapi`` library has to be used. ``cython-hidapi`` is a Python interface to that library.
it: Gli utenti delle recenti versioni di Mac OS non hanno altra scelta. Il sistema operativo rende molto difficile accedere direttamente, ai dispositivi HID (come la stazione meteorologica) così la libreria ``hidapi`` deve essere usata.  ``cython-hidapi`` è un'interfaccia Python per quella libreria.

en: Users of OpenWRT and similar embedded Linux platforms will probably not be able to install ``cython-hidapi``, so are constrained to use ``libusb`` and its ``PyUSB`` Python interface.
it: Gli utenti di OpenWRT e simili piattaforme Linux embedded probabilmente non sono in grado di installare ``cython-hidapi``, così sono costretti ad usare ``libusb`` e la sua interfaccia Python ``PyUSB``.

en: Install cython.
it: Installare cython.

en: Install cython-hidapi.
it: Installare cython-hidapi.

en: This also needs to be downloaded and built::
it: Anche questo va scaricato e installato::

en: Replace ``setup.py`` with ``setup-mac.py`` or ``setup-windows.py`` if you are using Mac OS or Windows.
it: Sostituire ``setup.py`` con ``setup-mac.py`` o ``setup-windows.py`` se si utilizza Mac OS o Windows.

en: Low level USB device access via cython-hidapi library.
it: Basso livello di accesso al dispositivo USB tramite libreria cython-hidapi.

en: Low level USB interface to weather station, using PyUSB.
it: Interfaccia di basso livello USB della stazione meteo tramite PyUSB.

en: This module handles low level communication with the weather station via the `PyUSB <http://sourceforge.net/apps/trac/pyusb/>`_ library. An alternative module, :doc:`pywws.device_cython_hidapi`, uses the `cython-hidapi <https://github.com/gbishop/cython-hidapi>`_ library. The choice of which module to use depends on which libraries are available for you computer.
it: Questo modulo gestisce la comunicazione di livello basso con la stazione meteo tramite la libreria `PyUSB <http://sourceforge.net/apps/trac/pyusb/>`_. Un modulo alternativo utilizza la libreria, :doc:`pywws.device_cython_hidapi`. La scelta di quale modulo utilizzare dipende da quali librerie sono disponibili per il computer.

en: Install libusb and PyUSB.
it: Installazione di libusb e PyUSB.

en: These should be available as packages for your operating system, but their names may vary. For example, on Ubuntu Linux::
it: Questi dovrebbero essere disponibili come pacchetti per sistema operativo, ma i loro nomi possono variare. Ad esempio, su Ubuntu Linux::

en: On some embedded linux systems::
it: Su alcuni sistemi embedded di linux::

en: Low level USB device access via PyUSB library.
it: Basso livello di accesso al dispositivo USB tramite libreria PyUSB.

en: If the write fails for any reason, an :obj:`IOError` exception is raised.
it: Se la lettura non riesce per qualche motivo, :obj:`IOError` l'eccezione è restituita.

en: This module handles low level communication with the weather station via the `PyUSB <http://sourceforge.net/apps/trac/pyusb/>`_ library (version 1.0). Alternative modules, :doc:`pywws.device_pyusb`, :doc:`pywws.device_ctypes_hidapi`, and :doc:`pywws.device_cython_hidapi`, use different libraries. The choice of which module to use depends on which libraries are available for your computer.
it: Questo modulo gestisce la comunicazione di livello basso con la stazione meteo tramite la libreria `PyUSB <http://sourceforge.net/apps/trac/pyusb/>`_ (versione 1.0). Un modulo alternativo utilizza la libreria, :doc:`pywws.device_ctypes_hidapi`, e :doc:`pywws.device_cython_hidapi`. La scelta di quale modulo utilizzare dipende da quali librerie sono disponibili per il computer.

en: Low level USB device access via PyUSB 1.0 library.
it: Basso livello del dispositivo di accesso USB tramite libreria PyUSB 1.0.

en: Post weather update to services such as Weather Underground ::
it: Posta gli aggiornamenti delle condizioni meteo a servizi come Weather Underground ::

en: Several organisations allow weather stations to upload data using a simple HTTP 'POST' or 'GET' request, with the data encoded as a sequence of ``key=value`` pairs separated by ``&`` characters.
it: Diverse organizzazioni consentono alle stazioni meteorologiche di caricare i dati utilizzando un semplice HTTP 'POST' o 'GET' richiesta, con i dati codificati come una sequenza di coppie ``key=value`` separate dal carattere &.

en: This module enables pywws to upload readings to these organisations. It is highly customisable using configuration files. Each 'service' requires a configuration file and two templates in ``pywws/services`` (that should not need to be edited by the user) and a section in ``weather.ini`` containing user specific data such as your site ID and password.
it: Questo modulo permette a pywws di caricare letture a queste organizzazioni. E 'altamente personalizzabile utilizzando i file di configurazione. Ogni 'servizio' richiede un file di configurazione e di due modelli in ``pywws/services`` (Che non dovrebbe essere necessario modificare dall'utente) e una sezione in ``weather.ini`` contenente i dati specifici dell'utente, quali l'ID del sito e la password.

en: There are currently six services for which configuration files have been written.
it: Attualmente ci sono sei servizi per i quali i file di configurazione sono stati scritti.

en: organisation
it: ente

en: service name
it: nome del servizio

en: config file
it: file di configurazione

en: Configuration
it: Configurazione

en: If you haven't already done so, visit the organisation's web site and create an account for your weather station. Make a note of any site ID and password details you are given.
it: Se non lo hai già fatto, visitate il sito web dell'organizzazione e creare un account per la vostra stazione meteo. Prendere nota di qualsiasi ID del sito e la password che vi vengono dati.

en: Stop any pywws software that is running and then run ``toservice`` to create a section in ``weather.ini``::
it: Interrompere qualsiasi software Pywws che è in esecuzione, quindi esegui ``toservice`` per creare una sezione in ``weather.ini``::

en: ``service_name`` is a single word service name, such as ``metoffice``, ``data_dir`` is your weather data directory, as usual.
it: ``service_name`` è un nome (singola parola) del servizio, ad esempio ``metoffice``, ``data_dir`` è la directory dei dati meteo, come al solito.

en: Edit ``weather.ini`` and find the section corresponding to the service name, e.g. ``[underground]``. Copy your site details into this section, for example::
it: Modificare ``weather.ini`` e trovare la sezione corrispondente al nome del servizio, ad esempio ``[underground]``. Copiare i dettagli del  tuo sito in questa sezione, ad esempio::

en: Now you can test your configuration::
it: Ora si può verificare la configurazione::

en: This should show you the data string that is uploaded. Any failure should generate an error message.
it: Questo dovrebbe mostrare la stringa di dati che viene caricata. Qualsiasi inconveniente dovrebbe generare un messaggio di errore.

en: Upload old data
it: Carica i dati vecchi

en: Now you can upload your last 7 days' data, if the service supports it. Edit your ``status.ini`` file and remove the appropriate line from the ``last update`` section, then run ``toservice`` with the catchup option::
it: Ora potete caricare il vostri ultimi 7 giorni di dati, se il servizio lo supporta. Modifica il tuo file ``status.ini`` e cancella la riga relativa nella sezione ``last update``, quindi eseguire di nuovo ``toservice`` con l'opzione 'catchup'::

en: This may take 20 minutes or more, depending on how much data you have.
it: Questo può durare 20 minuti o più, a seconda della quantità di dati.

en: Add service(s) upload to regular tasks
it: Aggiungere servizi di upload ad intervalli regolari

en: Edit your ``weather.ini`` again, and add a list of services to the ``[live]``, ``[logged]``, ``[hourly]``, ``[12 hourly]`` or ``[daily]`` section, depending on how often you want to send data. For example::
it: Modificare nuovamente il file ``weather.ini`` e aggiungere un elenco dei servizi per nella sezione ``[live]``, ``[logged]``, ``[hourly]``, ``[12 hourly]`` o ``[daily]`, a seconda di quante volte si desidera inviare i dati. Ad esempio::

en: Note that the ``[live]`` section is only used when running :py:mod:`~pywws.LiveLog`. It is a good idea to repeat any service selected in ``[live]`` in the ``[logged]`` or ``[hourly]`` section in case you switch to running :py:mod:`~pywws.Hourly`.
it: Si noti che la sezione ``[live]`` viene utilizzata solo quando si esegue :py:mod:`~pywws.LiveLog`. È una buona idea di ripetere qualsiasi servizio selezionato in ``[live]`` nella sezione ``[logged]`` o ``[hourly]`` nel caso in cui si passa all' esecuzione di :py:mod:`~pywws.Hourly`.

en: Restart your regular pywws program (:py:mod:`~pywws.Hourly` or :py:mod:`~pywws.LiveLog`) and visit the appropriate web site to see regular updates from your weather station.
it: Riavviare il programma pywws (:py:mod:`~pywws.Hourly` o :py:mod:`~pywws.LiveLog`) e visitare il sito web appropriato per vedere gli aggiornamenti per la tua stazione meteo.

en: Upload weather data to weather services such as Weather Underground.
it: Carica dati meteo a servizi meteorologici come Weather Underground.

en: pywws configuration.
it: Configurazione pywws

en: pywws status store.
it: Stato dell' archivio pywws.

en: name of service to upload to.
it: nome del servizio per caricare in.

en: Encode a weather data record.
it: Codificare un record di dati meteo.

en: The :obj:`data` parameter contains the data to be encoded. It should be a 'calibrated' data record, as stored in :class:`pywws.DataStore.calib_store`.
it: Il parametro :obj:`data` contiene i dati da codificare. Dovrebbe essere un record di dati 'calibrato', memorizzato in :class:`pywws.DataStore.calib_store`.

en: the weather data record.
it: il record di dati meteo.

en: urlencoded data.
it: Url dati codificati

en: string
it: srtinga

en: Upload a weather data record.
it: Carica un set di dati meteo.

en: The :obj:`coded_data` parameter contains the data to be uploaded. It should be a urlencoded string.
it: Il parametro :obj:`coded_data` contiene i dati da caricare. Dovrebbe essere una stringa url codificata.

en: the data to upload.
it: I dati da caricare.

en: success status
it: esito positivo

en: Get weather data records to upload.
it: Riceve i record di dati meteo da caricare .

en: This method returns either the most recent weather data record, or all records since a given datetime, according to the value of :obj:`start`.
it: Questo metodo restituisce i record meteo più recenti oppure tutti i record di un oggetto datetime, secondo il valore di :obj:`start`.

en: datetime of first record to get, or None to get most recent data only.
it: data-ora del primo record da leggere, o None per ottenere solo i dati più recenti.

en: a current 'live' data record, or None.
it: Il corrente record di dati 'live' , o None.

en: yields weather data records.
it: restituisce i record di dati meteo.

en: Get datetime of first 'catchup' record to send.
it: Ottiene data e ora del primo 'catchup' record per inviare.

en: Upload one or more weather data records.
it: Caricare uno o più record di dati meteorologici.

en: This method uploads either the most recent weather data record, or all records since the last upload (up to 7 days), according to the value of :obj:`catchup`.
it: Questo metodo carica o il più recente record di dati meteo, o tutti i record dopo l'ultimo caricamento (fino a 7 giorni), secondo il valore di :obj:`catchup`.

en: It sets the ``last update`` configuration value to the time stamp of the most recent record successfully uploaded.
it: Imposta il valore di configurazione ``last update`` il timestamp del record più recente correttamente caricato.

en: upload all data since last upload.
it: carica tutti i dati dall'ultimo caricamento.
