refine docstring of get_buffer

Author: HydrogenSulfate

source/api_cc/include/DeepPotPD.h

@@ -235,14 +235,20 @@ class DeepPotPD : public DeepPotBase {
   void get_type_map(std::string& type_map);
 
   /**
-   * @brief Get the type map (element name of the atom types) of this model.
-   * @param[out] type_map The type map of this model.
+   * @brief Get the buffer of this model.
+   * @param[in] buffer_name Buffer name.
+   * @param[out] buffer_array Buffer array.
    **/
   template<typename BUFFERTYPE>
-  void get_buffer(const std::string &buffer_name, std::vector<BUFFERTYPE> &buffer_arr);
+  void get_buffer(const std::string &buffer_name, std::vector<BUFFERTYPE> &buffer_array);
 
+  /**
+   * @brief Get the buffer of this model.
+   * @param[in] buffer_name Buffer name.
+   * @param[out] buffer_scalar Buffer scalar.
+   **/
   template<typename BUFFERTYPE>
-  void get_buffer(const std::string &buffer_name, BUFFERTYPE &buffer_arr);
+  void get_buffer(const std::string &buffer_name, BUFFERTYPE &buffer_scalar);
 
   /**
    * @brief Get whether the atom dimension of aparam is nall instead of fparam.

source/api_cc/src/DeepPotPD.cc

@@ -379,23 +379,6 @@ template void DeepPotPD::compute<float, std::vector<ENERGYTYPE>>(
     const std::vector<float>& aparam,
     const bool atomic);
 
-/* general function except for string buffer */
-template<typename BUFFERVTYPE>
-void DeepPotPD::get_buffer(const std::string &buffer_name, std::vector<BUFFERVTYPE> &buffer_arr) {
-  auto buffer_tensor = predictor->GetOutputHandle(buffer_name);
-  auto buffer_shape = buffer_tensor->shape();
-  int buffer_size = std::accumulate(buffer_shape.begin(), buffer_shape.end(), 1, std::multiplies<int>());
-  buffer_arr.resize(buffer_size);
-  buffer_tensor->CopyToCpu(buffer_arr.data());
-}
-
-template<typename BUFFERTYPE>
-void DeepPotPD::get_buffer(const std::string &buffer_name, BUFFERTYPE &buffer) {
-  std::vector<BUFFERTYPE> buffer_arr(1);
-  DeepPotPD::get_buffer<BUFFERTYPE>(buffer_name, buffer_arr);
-  buffer = buffer_arr[0];
-}
-
 /* type_map is regarded as a special string buffer
 that need to be postprocessed */
 void DeepPotPD::get_type_map(std::string& type_map) {
@@ -410,6 +393,23 @@ void DeepPotPD::get_type_map(std::string& type_map) {
   }
 }
 
+/* general function except for string buffer */
+template<typename BUFFERTYPE>
+void DeepPotPD::get_buffer(const std::string &buffer_name, std::vector<BUFFERTYPE> &buffer_array) {
+  auto buffer_tensor = predictor->GetOutputHandle(buffer_name);
+  auto buffer_shape = buffer_tensor->shape();
+  int buffer_size = std::accumulate(buffer_shape.begin(), buffer_shape.end(), 1, std::multiplies<int>());
+  buffer_array.resize(buffer_size);
+  buffer_tensor->CopyToCpu(buffer_array.data());
+}
+
+template<typename BUFFERTYPE>
+void DeepPotPD::get_buffer(const std::string &buffer_name, BUFFERTYPE &buffer_scalar) {
+  std::vector<BUFFERTYPE> buffer_array(1);
+  DeepPotPD::get_buffer<BUFFERTYPE>(buffer_name, buffer_array);
+  buffer_scalar = buffer_array[0];
+}
+
 // forward to template method
 void DeepPotPD::computew(std::vector<double>& ener,
                          std::vector<double>& force,