# ti-acv

**Repository Path**: piteqiu/ti-acv

## Basic Information

- **Project Name**: ti-acv
- **Description**: 基于三维小扰动理论的全垫升气垫船运动与波浪载荷计算系统
（2022年9月进入缓慢开发阶段，预计2022年11月在trunk分支完成时域算法的基本开发）
- **Primary Language**: FORTRAN
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: https://ti-acv.netlify.app/
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 3
- **Created**: 2022-10-22
- **Last Updated**: 2022-10-22

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 全垫升气垫船波浪载荷计算系统 (ti-acv)

Wave Load Calculation System of Air Cushion Vehicle (WALCS-ACV)

本项目根据全垫升气垫船的运行机理，是针对全垫升气垫船的运动与波浪载荷计算系统。包含三个子命令：

- 气垫船静力学计算；
- 气垫船运动与波浪载荷频域计算；
- 气垫船运动与波浪载荷时域计算。

备注：此外，`crate` 文件夹中提供了一些可视化的 Matlab/Octave 脚本。

[![ti-acv](https://img.shields.io/badge/ti--acv-v0.5.2-blueviolet)][1]
[![ford](https://img.shields.io/badge/Docs-FORD-ff69b4)](https://ti-acv.netlify.app/)
[![license](https://img.shields.io/badge/License-closed--source-important)](LICENSE)
[![wakatime](https://wakatime.com/badge/user/ca8e3153-da86-47e8-ba89-1fac0c842c19/project/76d58f98-2ca6-4188-9bb6-d6f466763be5.svg)][4]
[![fpm](https://img.shields.io/badge/Fortran--lang/fpm-^0.6.0-blue)][3]
[![Compiler](https://img.shields.io/badge/Compiler-GFortran^10.3.0_|_Octave-brightgreen)](https://fortran-lang.org/compilers/)

[1]: https://gitee.com/ship-motions/ti-acv
[3]: https://github.com/fortran-lang/fpm
[4]: https://wakatime.com/@zoziha/projects/ajocikbwfm

## 开始

### 软件依赖

- Git
- [Fortran-lang/fpm][3] >= 0.6.0：用于构建代码；
- [GNU/GCC-Fortran](https://gcc.gnu.org) >= 10.3.0：用于编译代码；
- [OpenBLAS][5]：线性代数计算。

代码库依赖见`fpm.toml`中的`dependencies`。

备注：本库默认采用 Windows-MSYS2 环境进行开发。

[5]: https://www.openblas.net/

### 使用 MSYS2 环境安装依赖

如果你恰好使用 [Windows-MSYS2][9] 环境，可以使用以下命令便捷地安装依赖：

```sh
pacman -S mingw-w64-ucrt-x86_64-git
pacman -S mingw-w64-ucrt-x86_64-gcc-fortran
pacman -S mingw-w64-ucrt-x86_64-fpm
pacman -S mingw-w64-ucrt-x86_64-openblas
pacman -S mingw-w64-ucrt-x86_64-octave      # 可选
```

[9]: https://www.msys2.org/

### 获取代码

```sh
git clone https://gitee.com/ship-motions/ti-acv
cd ti-acv
```

### 使用 [Fortran-lang/fpm][3] 构建代码

Fortran 包管理器（fpm）是 Fortran-lang 社区驱动、为 Fortran 生态设计的包管理器和代码构建器。
可通过提供的 `fpm.toml` 构建代码：

```sh
fpm run ti-acv -- static -C example/case<N>    # 静力学计算
fpm run ti-acv -- motion -C example/case<N>    # 运动与波浪载荷频域计算
fpm run ti-acv -- motion -C example/case<N> -T # 运动与波浪载荷时域计算 (@WIP)
```

### 使用 [FORD][6] 构建文档

构建 FORD 文档：

```sh
ford FORD-project-file.md
start ./doc/API-html/index.html     # Windows 打开网页
```

[6]: https://github.com/Fortran-FOSS-Programmers/ford

## 链接

- [全垫升气垫船波浪载荷理论预报方法研究](https://www.jianshu.com/p/0405d7fad484)
- [Fortran 语言实战](https://fortran-fans.github.io/Fortran-in-Action/)