Sciplot 项目使用教程

1. 项目的目录结构及介绍

Sciplot 是一个用于科学绘图的 C++ 库，其目录结构如下：

sciplot/
├── CMakeLists.txt
├── LICENSE
├── README.md
├── include/
│   └── sciplot/
│       ├── Colors.hpp
│       ├── Defaults.hpp
│       ├── Figure.hpp
│       ├── Plot.hpp
│       ├── Style.hpp
│       ├── Types.hpp
│       ├── Utils.hpp
│       └── sciplot.hpp
├── src/
│   └── sciplot/
│       ├── Colors.cpp
│       ├── Defaults.cpp
│       ├── Figure.cpp
│       ├── Plot.cpp
│       ├── Style.cpp
│       ├── Types.cpp
│       ├── Utils.cpp
│       └── sciplot.cpp
├── tutorials/
│   ├── CMakeLists.txt
│   ├── tutorial-basics.cpp
│   ├── tutorial-colors.cpp
│   ├── tutorial-custom-ticks.cpp
│   ├── tutorial-filled-curves.cpp
│   ├── tutorial-logarithmic-axes.cpp
│   ├── tutorial-multiple-plots.cpp
│   ├── tutorial-sine-function.cpp
│   ├── tutorial-style.cpp
│   └── tutorial-trigonometric-functions.cpp
└── tests/
    ├── CMakeLists.txt
    ├── test-colors.cpp
    ├── test-defaults.cpp
    ├── test-figure.cpp
    ├── test-plot.cpp
    ├── test-style.cpp
    ├── test-types.cpp
    ├── test-utils.cpp
    └── test-sciplot.cpp

目录结构介绍

• include/: 包含 Sciplot 库的头文件。
• src/: 包含 Sciplot 库的源文件。
• tutorials/: 包含示例教程代码。
• tests/: 包含测试代码。

2. 项目的启动文件介绍

Sciplot 项目的启动文件通常是 tutorials/ 目录下的示例教程文件。例如，tutorial-basics.cpp 是一个基本的教程文件，展示了如何使用 Sciplot 进行基本的绘图操作。

启动文件示例

#include <sciplot/sciplot.hpp>

int main() {
    using namespace sciplot;

    // Create a vector with values from 0 to pi divived into 200 uniform intervals
    Vec x = linspace(0.0, PI, 200);

    // Create a Plot object
    Plot plot;

    // Set the x and y ranges
    plot.xrange(0.0, PI);
    plot.yrange(-1.0, 1.0);

    // Set the x and y labels
    plot.xlabel("x");
    plot.ylabel("sin(x)");

    // Draw the sine function
    plot.drawCurve(x, std::sin(x)).label("sin(x)");

    // Show the plot in a pop-up window
    plot.show();

    // Save the plot to a file
    plot.save("sine-function.png");
}

3. 项目的配置文件介绍

Sciplot 项目的配置文件主要是 CMakeLists.txt 文件，用于配置项目的构建过程。

CMakeLists.txt 文件示例

cmake_minimum_required(VERSION 3.10)
project(sciplot)

# Set the C++ standard
set(CMAKE_CXX_STANDARD 14)
set(CMAKE_CXX_STANDARD_REQUIRED ON)

# Include the directory for header files
include_directories(include)

# Add the library
add_library(sciplot
    src/sciplot/Colors.cpp
    src/sciplot/Defaults.cpp
    src/sciplot/Figure.cpp
    src/sciplot/Plot.cpp
    src/sciplot/Style.cpp
    src/sciplot/Types.cpp
    src/sciplot/Utils.cpp
    src/sciplot/sciplot.cpp
)

# Add the tutorials
add_subdirectory(tutorials)

# Add the tests
add_subdirectory(tests)

配置文件介绍

• cmake_minimum_required(VERSION 3.10): 指定所需的 CMake 最低版本。