### Navigazione

- indice
- moduli |
- successivo |
- pywws 13.12.dev1118 documentazione »

# pywws

Software Python per Stazione Meteo USB senza filo
http://pythonhosted.org/pywws
http://jim-easterbrook.github.com/pywws/
http://github.com/jim-easterbrook/pywws/

Questo documento è tradotto nelle seguenti lingue (Le versioni diverse dall’ inglese possono non essere complete o aggiornate):

> - Inglese – scritto da jim Easterbrook

> - Francese – tradotto da Jacques Desroches

> - Italiano – tradotto da Edoardo

## Introduzione

pywws è un programma sviluppato in Python per leggere, memorizzare ed elaborare i dati delle stazioni meteo USB senza filo per i seguenti tipi Elecsa AstroTouch 6975, Watson W-8681, WH-1080PC, WH1080, WH1081, WH3080 ecc. Suppongo che tutti i modelli che funzionano con il software EasyWeather per Windows siano compatibili, ma non posso garantirlo.

Il programma è concepito per funzionare con bassi consumi, piccole memorie come un router. Il suo scopo è creare grafici e pagine Web con i dati letti dalla stazione meteo, generalmente aggiornati ad ogni ora. Si possono inviare i dati a servizi come Weather Underground e postare i messaggi su Twitter.

Ho scritto il programma per le mie necessità, ma ho fatto in modo che sia adattabile alle necessità altrui. Voi potete modificare alcuni o tutti i moduli, o scriverne dei nuovi, per ottenere esattamente quello che desideri.La ragione per cui è stato scelto Python è che rende le modifiche facili. Non abbiate paura, mettetevi alla prova..

## Requisiti

Il software necessario per eseguire pywws dipende da cosa si intende fare con esso. È necessario Python 2.5 o successiva – Python 3 è parzialmente supportato, alcune funzionalità dipendono dalle librerie che non sono ancora state portate in Python 3.

Per ulteriori dettagli, vedi Dipendenze.

## Scaricare una copia di pywws

Semplicemente per installare pywws usate il comando `pip` scaricando direttamente dal sito Python Package Index (PyPI). Nota questo metodo richiede i privilegi di ‘root’, usate il comando `sudo`:

    sudo pip install pywws

Se non hai i privilegi di root, o non vuoi installare pywws nel sistema, si può scaricare il file zip o tar.gz da PyPI ed estrarre i file in una qualsiasi directory del tuo computer.

I file di PyPI contengono una versione istantanea del software - una nuova versione viene emessa ogni pochi mesi. Se si desidera mantenere aggiornati con gli sviluppi più recenti della pywws, è consigliabile utilizzare `git` per clonare il repository pywws:

    git clone https://github.com/jim-easterbrook/pywws.git

Dopo averlo fatto è possibile compilare i file di localizzazione della documentazione e lingua (che richiederanno le dipendenze `sphinx` e `gettext`):

    cd pywws
    python setup.py msgfmt
    python setup.py build_sphinx

Questo è facoltativo- - la documentazione è disponibile online se preferisci utilizzare pywws in Inglese.

Per ulteriori dettagli, vedi Come iniziare con pywws.

### Aggiornare pywws

Il metodo utilizzato per aggiornare pywws dipende da come originariamente l’ hai ottenuta. Se hai scaricato un file zip o tar. gz, hai solo bisogno di fare la stessa cosa di nuovo, con la nuova versione, quindi eliminare il vecchio download quando hai finito di impostare quella nuova. (Si noti che l’aggiornamento è molto più facile se non conservate i template, moduli utente e dati meteo nella stessa directory del file scaricato). Gli utenti `git` hanno bisogno del comando `git pull`.Se si è utilizzato `pip` è necessario utilizzare l’opzione di aggiornamento:

    sudo pip install pywws -U

Alcune nuove versioni di pywws hanno cambiato ciò che è memorizzato nei file di dati di riepilogo oraria, giornaliera o mensile. Queste nuove versioni non sono compatibili con i dati elaborati da versioni precedenti. Il `pywws.Reprocess` Rigenera tutti i dati di riepilogo. Questo dovrebbe essere eseguito dopo ogni aggiornamento importante.

## Documentazione

La documentazione è inclusa con pywws ed è anche disponibile online. Un buon punto di partenza è Come iniziare con pywws che descrive in dettaglio come installare pywws.

Se avete domande o non risposte nella documentazione, unitevi alla pywws Google mailing list / discussion group e chiedete lì. Si noti che il primo messaggio del gruppo non apparirà immediatamente - nuovi poster devono essere approvati da un moderatore, per evitare messaggi di spam.

### Contenuto

- Licence
- Dependencies
  - Indispensabile
  - Disegnare grafici
  - Trasferimento sicuro di file (sftp)
  - Postare su Twitter
  - Per creare nuove traduzioni di lingua
  - Per ‘compilare’ la documentazione
- Change log
- User guides
  - Come iniziare con pywws
  - Come impostare ‘hourly’ per la registrazione oraria con pywws
  - Come impostare una registrazione ‘live’ con pywws
  - Come integrare pywws con vari servizi meteorologici
  - Come configurare pywws per pubblicare messaggi su Twitter
  - Come utilizzare pywws in un altra lingua
  - weather.ini - configurazione del formato del file
  - status.ini - formato del file di stato
  - Indice di umidità (Humidex)
- Python modules
  - pywws.Hourly
  - pywws.LiveLog
  - pywws.Reprocess
  - pywws.TwitterAuth
  - pywws.SetWeatherStation
  - pywws.TestWeatherStation
  - pywws.USBQualityTest
  - pywws.EWtoPy
  - pywws.Tasks
  - pywws.LogData
  - pywws.Process
  - pywws.calib
  - pywws.Plot
  - pywws.WindRose
  - pywws.Template
  - pywws.Forecast
  - pywws.ZambrettiCore
  - pywws.Upload
  - pywws.ToTwitter
  - pywws.toservice
  - pywws.YoWindow
  - pywws.WeatherStation
  - pywws.device_ctypes_hidapi
  - pywws.device_cython_hidapi
  - pywws.device_pyusb1
  - pywws.device_pyusb
  - pywws.DataStore
  - pywws.TimeZone
  - pywws.Localisation
  - pywws.calib
  - pywws.conversions
  - pywws.Logger

### Indici e tabelle

- Indice
- Indice dei Moduli
- Cerca

## Ringraziamenti

Non sarei stato in grado di ottenere tutte le informazioni dalla stazione meteo senza avere accesso ai sorgenti di Michael Pendec’s programma “wwsr”. Sono anche grata alla Dave Wells per la decodifica del weather station’s “fixed block” data.

Infine, un grande ringraziamento a tutti gli utenti pywws che hanno aiutato con domande e suggerimenti e soprattutto a coloro che hanno tradotto pywws e la relativa documentazione in altre lingue.

## Licenze

pywws - Python software per Stazione Meteo USB senza filo.
http://github.com/jim-easterbrook/pywws
Copyright (C) 2008-13 Jim Easterbrook jim@jim-easterbrook.me.uk

Questo programma è software libero; può essere redistribuito e/o modificarlo secondo i termini della GNU General Public License come pubblicata dalla Free Software Foundation; versione 2 della licenza, o (a tua scelta) qualsiasi versione successiva.

Questo programma è distribuito nella speranza che sia utile, ma senza alcuna garanzia; senza neppure la garanzia implicita di commerciabilità o idoneità per uno scopo particolare. Vedi la GNU General Public License per maggiori dettagli.

Dovresti aver ricevuto una copia del GNU General Public License insieme a questo programma; in caso contrario, scrivete a Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA

### Navigazione

- indice
- moduli |
- successivo |
- pywws 13.12.dev1118 documentazione »