# plplot-lib

**Repository Path**: zoziha/plplot-lib

## Basic Information

- **Project Name**: plplot-lib
- **Description**: 公告：本项目将在 2022 年 6 月 20 日删除，欢迎使用 https://github.com/zoziha/easy_plplot ！
- **Primary Language**: FORTRAN
- **License**: LGPL-2.1
- **Default Branch**: main
- **Homepage**: https://github.com/zoziha/easy_plplot
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2022-03-09
- **Last Updated**: 2022-05-20

## Categories & Tags

**Categories**: Uncategorized

**Tags**: Fortran, fpm, plplot, Plot, plotting

## README

# PlPlotLib

<div align="center">
<img src="doc/logo.svg" alt="PlPlotLib" width="100">
</div>

PlPlotLib is a wrapper for PlPlot inspired by the interface of 
matplotlib. It is intended to fill the need for rapid feedback while 
developing numerical simulations, and does not replace more 
sophisticated packages such as
matplotlib or even direct use of PlPlot.

While it is possible that the output from PlPlotLib may be considered 
as publication quality, no assertion is made along those lines. This 
software has been written in the hope that it will be useful, 
especially for students in numerical analysis courses based on Fortran.

Documentation can be found [here](http://hornekyle.github.io/PlPlotLib).

## Getting Started

### Supported Compilers

The following combinations are supported:

|Name|Vesrion|Platform|Architecture|  
|:-:|:-:|:-:|:-:|  
|GCC Fortran(MSYS2)|11|Windows 10|x86_64|

### Dependencies

- PlPlot
- libgd
- [Fortran-lang/fpm](https://github.com/fortran-lang/fpm)

#### Build Environment in MSYS2

```sh
pacman -S <arch>64/mingw-w64-<arch>-x86_64-plplot
pacman -S <arch>64/mingw-w64-<arch>-x86_64-libgd
```

### Build with [Fortran-lang/fpm](https://github.com/fortran-lang/fpm)

Fortran Package Manager (fpm) is a package manager and build system for Fortran.<br>
You can build `PlPlotLib` using provided `fpm.toml`:

```sh
fpm run --list
fpm run <executable_name, see `fpm.toml` or run list>
```

To use `PlPlotLib` within your `fpm` project, add the following lines to your `fpm.toml` file:

```toml
[dependencies]
PlPlotLib = { git="https://github.com/zoziha/PlPlotLib" }
```

### Usage

See [more usage](http://hornekyle.github.io/PlPlotLib/page/index.html)🎯.

```fortran
program logo_prg
        !! Create the project logo
    use kinds_mod
    use utilities_mod
    use plplotlib_mod
    implicit none

    call setup(device='svg', fileName='build/logo-%n.svg', figSize=[600, 500])
    call makeLogo
    call show()

contains

    subroutine makeLogo
        real(wp), dimension(:), allocatable :: x, y1, y2, y3

        x = linspace(0.0_wp, 1.0_wp, 100)
        y1 = x**2 - 1.0_wp
        y2 = 2.0_wp*x - 1.0_wp
        y3 = x
        y3 = cos(2.0_wp*PI*x)

        call figure()
        call subplot(1, 1, 1)
        call xylim(mixval(x), mixval([y1, y2, y3])*1.1_wp)

        call plot(x, y1, lineColor='b', lineWidth=1.2_wp)
        call plot(x, y2, lineColor='r', lineWidth=1.2_wp)
        call plot(x, y3, lineColor='c', lineWidth=1.2_wp)

        call ticks(lineWidth=1.2_wp)
        call labels('', '', '')
    end subroutine makeLogo

end program logo_prg
```

<div align="center">
<img src="doc/logo-1.svg" alt="PlPlotLib" width="600">
</div>

## Links

- [PlPlot](http://PlPlot.sourceforge.net/)
- [hornekyle/PlPlotLib](https://github.com/hornekyle/PlPlotLib) 

Thanks to `PlPlot` written by Alan W. Irwin and other contributors.<br>
Thanks to the Fortran interface of `PlPlot` written by Arjen Markus.<br>
Thanks to the `PlPlotLib` high-level interfaces written by Dr Kyle Horne.

Thanks for your all contributions. Salute!