Download the PHP package macocci7/php-lorenz-curve without Composer

PHP Lorenz Curve

A PHP Library to draw a Lorenz Curve.

1. Features

PHP-LorenzCurve draws a Lorenz Curve and also calculates the Gini's coefficient.

2. Contents

• 1. Features
• 2. Contents
• 3. Requirements
• 4. Installation
• 5. Usage
  • 5.1. Basic Usage
  • 5.2. Adjusting the Appearance
    • 5.2.1. Drawing Grid Lines
    • 5.2.2. Drawing an Upward Convex Curve
    • 5.2.3. Setting the Image Size
    • 5.2.4. Setting the Attributes of Plotarea
    • 5.2.5. Setting Caption and Labels
    • 5.2.6. Setting Attributes with Array
    • 5.2.7. Setting Attributes with Neon File
    • 5.2.8. Customisable Attributes
  • 5.3. Gini's Coefficient
• 6. Examples
• 7. LICENSE

3. Requirements

• PHP 8.1 or later

• Imagick PHP Extension

  Check with commands:

• Composer

4. Installation

5. Usage

5.1. Basic Usage

To draw a Lorenz Curve, create an instance of LorenzCurve class at first.

Next, set the data, the class range and save the image into a file.

This results in the image below.

5.2. Adjusting the Appearance

5.2.1. Drawing Grid Lines

You can draw grid lines with grid() method specifying the width and the color.

Note: Specifying null as a color code results in transparent.

This results in the image below.

5.2.2. Drawing an Upward Convex Curve

You can create an upward convex Lorenz Curve by sorting the list of the classes in decending order with reverseClasses() method.

This results in the image below.

5.2.3. Setting the Image Size

PHP-LorenzCurve generates images with a width of 400 pixels and a height of 300 pixels by default.

You can change the image size with resize() method.

• format: resize(int $width, int $height)

This code results in as below:

5.2.4. Setting the Attributes of Plotarea

By default, PHP-LorenzCurve sets the Attributes of Plotarea:

• offsetX: 10% of the image width
• offsetY: 10% of the image height
• width: 80% of the image width
• height: 70% of the image height
• backgroundColor: null (transparent)

You can change them with plotarea() method.

• format:

Sample code:

This code results in as below:

5.2.5. Setting Caption and Labels

You can set the Caption and Labels with caption(), labelX() and labelY() methods.

• Format:

Sample code:

This code results in as below:

5.2.6. Setting Attributes with Array

You can set attributes with the config() method passing array as an argument.

This code results in as below:

See more: Customizable Attributes

5.2.7. Setting Attributes with Neon File

You can set attributes with config() method passing the neon file path as an argument.

First, create a Neon File.

Second, specify the path of the neon file as an argument of the config() method.

This code results in as below:

See more: Customizable Attributes

5.2.8. Customisable Attributes

5.3. Gini's Coefficient

You can get the Gini's Coefficient with getGinisCoefficient() method without generating an image.

This results in as below.

6. Examples

• BasicUsage.php >> results in:

• DrawGrid.php >> results in:

• UpwardConvexCurve.php >> results in:

• ResizeImage.php >> results in:

• SetPlotareaAttrs.php >> results in:

• CaptionLabels.php >> results in:

• ConfigFromArray.php >> results in:

• ConfigFromFile.neon >> results in:

• GinisCoefficient.php >> results in:

• GinisCoefficient0.php >> results in:

  ▼Gini's Coefficient:

• GinisCoefficientAlmost1.php >> results in:

  ▼Gini's Coefficient:

• GinisCoefficient1.php >> results in:

  ▼Gini's Coefficient:

7. LICENSE

MIT

Copyright 2024-2025 macocci7.