这不是Rust语言或Cargo的教程。因此，请查阅他们在 rust-lang.org 提供的优秀资源和文档。

讨论

默认情况下，CLI使用Robert Heaton在其博客文章中描述的海、陆、海岸示例。这在上面的字符映射演示中可以看到。我认为这种介绍算法的方法非常有意义。它以实际的方式易于理解和掌握。它基于sample.txt源文件，该文件位于wavefccrate中。在编译时将其嵌入到程序中以提供此功能，尽管其大小微不足道。

在源代码中，CLI和核心逻辑已被分为两个包：wavefc-cli和wavefc。为了创建您自己的自定义适配器和编写自己的CLI，我建议使用wavefc-cli源代码作为模板，然后在此基础上构建wavefc类型。在开发过程中，我个人发现使用Cargo的--release模式构建和运行非常有用。两种模式之间的构建时间差异可以忽略不计，而在这种优化模式下实际的折叠速度要快得多。

程序需要提供宽度和高度来设置输出的大小。您可以随意调整这些值以创建不同形状的输出。请注意，输出的大小越大，函数通常需要的时间越长，因为它自我矛盾的几率增加。理论上，如果指定的输出大小低于或等于样本的大小，则存在有效结果。指定的输出大小必须是瓦片大小的乘积。瓦片大小将在下一段中探讨。

尝试相对于微小的样本一个相对较大的瓦片大小

在wavefc的版本1和版本2中，仅实现了算法的简单瓦片模型。这严重限制了其“创意”能力，产生了相当单调的输出。在当前版本的算法中，使用重叠瓦片模型。这产生了更好的输出，并且在某些情况下也更快。尽管如此，这种模型通常比简单瓦片模型需要更长的时间。幸运的是，新的重叠逻辑只是原始方法的一个更高级的子集。这意味着，通过指定瓦片大小为1，您实际上是在使用简单瓦片模型。

算法选择下一个折叠的瓦片（叠加）的方式是基于特定位置的Shannon熵。这是通过计算原始样本中每个可能值的出现的概率来计算的。所有这些共同形成给定叠加的集体熵。

由于算法的顺序性质，wavefc库目前是单线程的。然而，我确实认识到可以通过添加一些多线程来提高很多性能优化。这是项目的长期目标，目前我经常关注rayon这个特定的项目。

CLI有一系列标志可以调整程序设置。详细说明太多了，而且这样做也没有意义。然而，通过使用clap库，支持帮助标志以显示所有可用的标志列表。

在您的代码中使用此项目

此项目在crates.io上有两个包：wavefc和wavefc-cli。如果您只想尝试程序，wavefc-cli可能是您的最佳选择来安装。如果您想在您的代码中使用此算法，只需将wavefc添加到您的Cargo.toml中即可。作为替代方案，您可以通过手动复制其源代码或在Cargo工作空间中包含它来使用此项目。

要熟悉源代码的好地方是 wavefc/src/lib.rs，它包含了大多数实际的 Wave 代码。要在 Rust 中包含此代码，请使用 use wavefc::prelude::*; 预导入。

版权所有 © Zachary Morden 2022