Metadata-Version: 2.1
Name: pyaxis
Version: 0.4.3
Summary: Library to handle PC-Axis data in python using pandas DataFrames.
Home-page: https://github.com/icane/pyaxis
Author: Instituto Cántabro de Estadística & Swiss Data Science Center
Author-email: icane@cantabria.es
License: Apache License 2.0
Keywords: pcaxis,json-stat,statistics,dataframe,converter
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Science/Research
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Operating System :: MacOS :: MacOS X
Classifier: Operating System :: Microsoft :: Windows
Classifier: Operating System :: POSIX
Classifier: Programming Language :: Python
Classifier: Topic :: Scientific/Engineering :: Information Analysis
Classifier: Topic :: Software Development :: Libraries
License-File: LICENSE.txt

=======
pyaxis
=======

**pyaxis** is a python library for **PC-Axis (or PX)** formatted data manipulation
which allows reading and writing PC-Axis [1]_ format with python, using the
DataFrame structures provided by the widely accepted pandas library [2]_.
PX is a standard format for statistical files used by a large number of
statistical offices (Spain, Switzerland, Sweden). A package of software has been developed for this format: 
PX-Win, PX-Web and PX-Edit. **pyaxis** eases reading and parsing of PX files data 
and metadata into a pandas Dataframe and a dict structure, allowing their manipulation
in a tabular and pythonic manner. It supports both monolingual and multilingual PX files. The package was initially developped by the [Instituto Cántabro de Estadistica](https://www.icane.es) and is now jointly maintained by ICANE and the [Swiss Data Science Center](https://datascience.ch).  
**pyaxis** is provided under the Apache License 2.0.

.. [1] https://www.scb.se/px-en for PC-Axis information  
.. [2] https://pandas.pydata.org for Python Data Analysis Library information   

Installation
============

For installation::

    pip install pyaxis

Usage
=====

From PX to pandas DataFrame
-----------------------------------

Typical usage often looks like this::

    from pyaxis import pyaxis

    EXAMPLE_URL = 'https://www.ine.es/jaxiT3/files/t/es/px/2184.px'
    
    px = pyaxis.parse(EXAMPLE_URL, encoding='ISO-8859-2')
    print(px['DATA'])
    print(px['METADATA'])

For Multilingual PX files
-----------------------------------

Typical usage often looks like this::

    from pyaxis import pyaxis

    EXAMPLE_URL = 'https://www.pxweb.bfs.admin.ch/DownloadFile.aspx?file=px-x-0602000000_107'
    
    # Swiss PX files are in German(de), French(fr), Italian(it), and English(en)
    px = pyaxis.parse(EXAMPLE_URL, encoding='ISO-8859-2', lang='fr')
    print(px['DATA'])
    print(px['METADATA'])
    print(px['TRANSLATION'])
