《OpenFOAM用户指南》勘误

[Tong]

关于OpenFOAM模板类"List"的翻译:

---

虽然在STL中list对应的数据结构是链表，但是OpemFOAM中List对应的数据结构是数组容器，在OF List的基类UList的定义中有：

//- Number of elements in UList
       label size_;

       //- Vector of values of type T
       T* __restrict__ v_;


   // Private Member Functions

       //- Disallow default shallow-copy assignment
       //

List中对v_的内存分配操作为：

template<class T>
inline void Foam::List<T>::alloc()
{
    if (this->size_ > 0)
    {
        this->v_ = new T[this->size_];
    }
}

实际在堆上为v_分配了大小为(this->size)*(size_of(T))的连续空间，因此能够根据下标访问元素，插入时先重新分配size+1的空间之后拷贝，复杂度O(n)

实际OpenFOAM中链表容器的基类为DLListBase(双向链表)和SLListBase(单向链表)，位于src\OpenFOAM\containers\LinkedLists目录下

以单向链表为例

void Foam::SLListBase::insert(SLListBase::link* a)
{
    nElmts_++;

    if (last_)
    {
        a->next_ = last_->next_;
    }
    else
    {
        last_ = a;
    }

    last_->next_ = a;
}

插入时将链表尾部指针指向新元素，复杂度为常数。访问使用内部迭代器遍历，复杂度O(n)，

在《OpenFOAM用户指南-5.0》中东岳老师将继承自List模板的类翻译成链表，个人建议将其翻译成数组或者列表更合理，这样能够减少使用者定义底层数据时的困惑。

[李东岳]

@Tong 多谢，非常严谨，已更新

[李东岳]

@bestucan 想把用户指南7更新一下，不过没实践做了，你是否感兴趣？我可以把你的名字放在这里：

7.0版修订（2019年9月发布）：贡献者

[bestucan]

@东岳 翻译还是校对，如果是翻译我可能比较慢

[李东岳]

@bestucan 就是对照OpenFOAM-6的中文版和OpenFOAM-7英文版的差异，然后更正6需要改正的地方，从之前更新的内容来看区别应该不大，

[bestucan]

@东岳 好的，这就开始做。

[李东岳]

@bestucan 好嘞，谢谢，你帮我在OpenFOAM-7英文版中标记出来有变动的地方就可以，到时候给我发一个你标记的pdf就行

[bestucan]

@东岳

[bestucan]

@东岳 已发送邮箱li.dy at dyfluid.com，请老师查收

[李东岳]

@bestucan 一直没空弄，最近我处理一下

[李东岳]

我这周末必须更新完

[李东岳]

可算弄完了，明晚上检查下，后天大后天可以发了

[yfclark]

@Tong OpenFoam有没有动态列表，那种不用一开始给定大小，有一个元素添加一个元素的，（不确定容器的大小），HashTable用起来不太顺手

[Tong]

@yfclark
dynamicList 分配连续* 2大小的内存，用完后*2重新分配
LinkedList是动态链表
这两个容器详细的方法可以参考相关声明

[yfclark]

@Tong 非常谢谢，DynamicList应该是连续空间分配，一开始还要给定空间大小，LinkedList动态链表可以不用先声明大小，非常好用

[Tong]

@yfclark
嗯，对性能不高的数据可以放进去。

[Frank0514]

第7.1.2 传递模型小节，热导率刚开始写的是kappa,后面就变成epsilon了。

[Frank0514]

第20页脚注13，关于库朗数的那个链接，挂了。。。

[bronzecraft]

• 51页2.2.1.5，“可以即用稳态又用瞬态来进行计算”， 应为 “可以既用稳态又用瞬态来进行计算”。
• 109页 4.3，“这个controlDict文件彩玉\$FOAM_ETC文件目录下”，“这个controlDict文件在于$FOAM_ETC文件目录下”。
• 109页4.3.1，“但最好还是在单独的算例文件中的controlDict设置更好”，语义重复，任意删除一个即可。
  *136页表5.1，“表5.1 不同网格形状的点、面、边的数量”，应当是“不同形状网格的点、面、边的编号顺序”。英文版是numbering，应当翻译成编号。
• 146页5.3.1.1，“表5.4中的block顶点这样定“，这里表5.4应当是表5.3。同样5.3.1.2“图5.4中的block我们指”图5.4应当是图5.3。
• 148页5.3.1.4，“剩下 60% 网格单元分配给2区间”，应当是“40%“。
• 155页5.4.1，“snappyHexMesh生成网格的步骤可以用图5.8这个简图来表示”，应当是“图5.7”。
• 157页5.4.3，“网格切分控制通过snappyHexMesh中的”，应当是“snappyHexMeshDict”。
  后面“surfaceFeatureExtractDict字典文件范例可以”应当是“surfaceFeaturesDict”。“surfaceFeature”应为“surfaceFeatures”，接着的“参见图5.11中指定的面”应为“图5.10”。
• 159页5.4.4中的“参见图5.12”应为”图5.12“。

[李东岳]

@bronzecraft 非常感谢，我们最近在大幅度更新《OpenFOAM用户指南》，之前是word排版的，现在变成了latex，工作量宏大，我会把这些东西直接更新在新版里，处理之后给你反馈。