pylexis 0.1.1

Quickly and easily draw basic Lexis diagrams

PyLexis

PyLexis is a tool to easily plot Lexis Diagrams within Python. It is based on matplotlib and inspirated in LexisPlotR.

What is a Lexis Diagram?

In demography a Lexis diagram (named after economist and social scientist Wilhelm Lexis) is a two dimensional diagram that is used to represent events (such as births or deaths) that occur to individuals belonging to different cohorts. Calendar time is usually represented on the horizontal axis, while age is represented on the vertical axis. (https://en.wikipedia.org/wiki/Lexis_diagram)

Installation

pip install pylexis

Using PyLexis

First import the package and create a Diagram object with the following arguments:

initial year, final_year, first_age, last_age

import pylexis
diagram = pylexis.Diagram(1910, 1920, 0, 10)

This returns a basic diagram:

Then you have a few methods to interact with the graph:

Diagram.titles(x_label, y_label, title)

Add title and axis labels.

Diagram.lexis_fill(target, value, color)

Highlight a certain age, year or cohort in the grid.

    Parameters
    ----------
    target: {'age', 'year' or 'cohort'}
    value: int with the value of the target selected.
    color: str with the colour to fill.

Diagram.add_births(year, value)

Draw number of births in a specific year.

Diagram.add_deaths(year, value)

Draw number of deaths in a specific year for a specific cohort.

    Parameters
    ----------
    cohort: Year of the cohort.
    year: Year of deaths.
    age: Age at the time of deaths. Deaths can be before or after birthdays.
    value: Deaths.

FAQ

Just ask me what you need!