mlpack 4.6.2__cp38-cp38-win_amd64.whl → 4.7.0__cp38-cp38-win_amd64.whl

{mlpack-4.6.2.dist-info → mlpack-4.7.0.dist-info}/WHEEL

@@ -1,5 +1,5 @@
 Wheel-Version: 1.0
-Generator: setuptools (75.3.2)
+Generator: setuptools (75.3.3)
 Root-Is-Purelib: false
 Tag: cp38-cp38-win_amd64
 

mlpack/include/mlpack/core/data/format.hpp

@@ -1,31 +0,0 @@
-/**
- * @file core/data/format.hpp
- * @author Ryan Curtin
- *
- * Define the formats that can be used by mlpack's Load() and Save() mechanisms
- * via cereal.
- *
- * mlpack is free software; you may redistribute it and/or modify it under the
- * terms of the 3-clause BSD license.  You should have received a copy of the
- * 3-clause BSD license along with mlpack.  If not, see
- * http://www.opensource.org/licenses/BSD-3-Clause for more information.
- */
-#ifndef MLPACK_CORE_DATA_FORMATS_HPP
-#define MLPACK_CORE_DATA_FORMATS_HPP
-
-namespace mlpack {
-namespace data {
-
-//! Define the formats we can read through cereal.
-enum format
-{
-  autodetect,
-  json,
-  xml,
-  binary
-};
-
-} // namespace data
-} // namespace mlpack
-
-#endif

mlpack/include/mlpack/core/data/image_info.hpp

@@ -1,102 +0,0 @@
-/**
- * @file core/data/image_info.hpp
- * @author Mehul Kumar Nirala
- *
- * An image information holder.
- *
- * mlpack is free software; you may redistribute it and/or modify it under the
- * terms of the 3-clause BSD license.  You should have received a copy of the
- * 3-clause BSD license along with mlpack.  If not, see
- * http://www.opensource.org/licenses/BSD-3-Clause for more information.
- */
-
-#ifndef MLPACK_CORE_DATA_IMAGE_INFO_HPP
-#define MLPACK_CORE_DATA_IMAGE_INFO_HPP
-
-#include <mlpack/prereqs.hpp>
-#include "extension.hpp"
-
-namespace mlpack {
-namespace data {
-
-/**
- * Checks if the given image filename is supported.
- *
- * @param fileName Name of the image file.
- * @param save Set to true to check if the file format can be saved, else loaded.
- * @return Boolean value indicating success if it is an image.
- */
-inline bool ImageFormatSupported(const std::string& fileName,
-                                 const bool save = false);
-
-/**
- * Implements meta-data of images required by data::Load and
- * data::Save for loading and saving images into arma::Mat.
- */
-class ImageInfo
-{
- public:
-  /**
-   * Instantiate the ImageInfo object with the given image width, height,
-   * number of channels and quality parameter.
-   *
-   * @param width Image width.
-   * @param height Image height.
-   * @param channels Number of channels in the image.
-   * @param quality Compression of the image if saved as jpg (0 - 100).
-   */
-  ImageInfo(const size_t width = 0,
-            const size_t height = 0,
-            const size_t channels = 3,
-            const size_t quality = 90);
-
-  //! Get the image width.
-  const size_t& Width() const { return width; }
-  //! Modify the image width.
-  size_t& Width() { return width; }
-  //! Get the image height.
-
-  const size_t& Height() const { return height; }
-  //! Modify the image height.
-  size_t& Height() { return height; }
-
-  //! Get the image channels.
-  const size_t& Channels() const { return channels; }
-  //! Modify the image channels.
-  size_t& Channels() { return channels; }
-
-  //! Get the image quality.
-  const size_t& Quality() const { return quality; }
-  //! Modify the image quality.
-  size_t& Quality() { return quality; }
-
-  template<typename Archive>
-  void serialize(Archive& ar, const uint32_t /* version */)
-  {
-    ar(CEREAL_NVP(width));
-    ar(CEREAL_NVP(channels));
-    ar(CEREAL_NVP(height));
-    ar(CEREAL_NVP(quality));
-  }
-
- private:
-  // To store the image width.
-  size_t width;
-
-  // To store the image height.
-  size_t height;
-
-  // To store the number of channels in the image.
-  size_t channels;
-
-  // Compression of the image if saved as jpg (0 - 100).
-  size_t quality;
-};
-
-} // namespace data
-} // namespace mlpack
-
-// Include implementation of Image.
-#include "image_info_impl.hpp"
-
-#endif

mlpack/include/mlpack/core/data/image_info_impl.hpp

@@ -1,84 +0,0 @@
-/**
- * @file core/data/image_info_impl.hpp
- * @author Mehul Kumar Nirala
- *
- * An image information holder implementation.
- *
- * mlpack is free software; you may redistribute it and/or modify it under the
- * terms of the 3-clause BSD license.  You should have received a copy of the
- * 3-clause BSD license along with mlpack.  If not, see
- * http://www.opensource.org/licenses/BSD-3-Clause for more information.
- */
-
-#ifndef MLPACK_CORE_DATA_IMAGE_INFO_IMPL_HPP
-#define MLPACK_CORE_DATA_IMAGE_INFO_IMPL_HPP
-
-namespace mlpack {
-namespace data {
-
-inline const std::vector<std::string> LoadFileTypes()
-{
-  return std::vector<std::string>({"jpg", "png", "tga", "bmp", "psd", "gif",
-      "hdr", "pic", "pnm", "jpeg"});
-}
-
-inline const std::vector<std::string> SaveFileTypes()
-{
-  return std::vector<std::string>({"jpg", "png", "tga", "bmp", "hdr"});
-}
-
-} // namespace data
-} // namespace mlpack
-
-// In case it hasn't been included yet.
-#include "image_info.hpp"
-
-namespace mlpack {
-namespace data {
-
-inline bool ImageFormatSupported(const std::string& fileName, const bool save)
-{
-  if (save)
-  {
-    // Iterate over all supported file types that can be saved.
-    for (auto extension : SaveFileTypes())
-    {
-      if (extension == Extension(fileName))
-        return true;
-    }
-  }
-  else
-  {
-    // Iterate over all supported file types that can be loaded.
-    for (auto extension : LoadFileTypes())
-    {
-      if (extension == Extension(fileName))
-        return true;
-    }
-  }
-
-  return false;
-}
-
-} // namespace data
-} // namespace mlpack
-
-namespace mlpack {
-namespace data {
-
-inline ImageInfo::ImageInfo(const size_t width,
-                            const size_t height,
-                            const size_t channels,
-                            const size_t quality) :
-    width(width),
-    height(height),
-    channels(channels),
-    quality(quality)
-{
-  // Do nothing.
-}
-
-} // namespace data
-} // namespace mlpack
-
-#endif

mlpack/include/mlpack/core/data/load_image_impl.hpp

@@ -1,171 +0,0 @@
-/**
- * @file core/data/load_image_impl.hpp
- * @author Mehul Kumar Nirala
- *
- * An image loading utility implementation via STB.
- *
- * mlpack is free software; you may redistribute it and/or modify it under the
- * terms of the 3-clause BSD license.  You should have received a copy of the
- * 3-clause BSD license along with mlpack.  If not, see
- * http://www.opensource.org/licenses/BSD-3-Clause for more information.
- */
-#ifndef MLPACK_CORE_DATA_LOAD_IMAGE_IMPL_HPP
-#define MLPACK_CORE_DATA_LOAD_IMAGE_IMPL_HPP
-
-// In case it hasn't been included yet.
-#include "load_image.hpp"
-#include "image_info.hpp"
-
-namespace mlpack {
-namespace data {
-
-// Image loading API.
-template<typename eT>
-bool Load(const std::string& filename,
-          arma::Mat<eT>& matrix,
-          ImageInfo& info,
-          const bool fatal)
-{
-  Timer::Start("loading_image");
-
-  // STB loads into unsigned char matrices, so we may have to convert once
-  // loaded.
-  arma::Mat<unsigned char> tempMatrix;
-  const bool result = LoadImage(filename, tempMatrix, info, fatal);
-
-  // If fatal is true, then the program will have already thrown an exception.
-  if (!result)
-  {
-    Timer::Stop("loading_image");
-    return false;
-  }
-
-  matrix = arma::conv_to<arma::Mat<eT>>::from(tempMatrix);
-  Timer::Stop("loading_image");
-  return true;
-}
-
-// Image loading API for multiple files.
-template<typename eT>
-bool Load(const std::vector<std::string>& files,
-          arma::Mat<eT>& matrix,
-          ImageInfo& info,
-          const bool fatal)
-{
-  if (files.size() == 0)
-  {
-    std::ostringstream oss;
-    oss << "Load(): vector of image files is empty." << std::endl;
-
-    if (fatal)
-      Log::Fatal << oss.str();
-    else
-      Log::Warn << oss.str();
-
-    return false;
-  }
-
-  arma::Mat<unsigned char> img;
-  bool status = LoadImage(files[0], img, info, fatal);
-
-  if (!status)
-    return false;
-
-  // Decide matrix dimension using the image height and width.
-  arma::Mat<unsigned char> tmpMatrix(
-      info.Width() * info.Height() * info.Channels(), files.size());
-  tmpMatrix.col(0) = img;
-
-  for (size_t i = 1; i < files.size() ; ++i)
-  {
-    arma::Mat<unsigned char> colImg(tmpMatrix.colptr(i), tmpMatrix.n_rows, 1,
-        false, true);
-    status = LoadImage(files[i], colImg, info, fatal);
-
-    if (!status)
-      return false;
-  }
-
-  matrix = arma::conv_to<arma::Mat<eT>>::from(tmpMatrix);
-  return true;
-}
-
-inline bool LoadImage(const std::string& filename,
-                      arma::Mat<unsigned char>& matrix,
-                      ImageInfo& info,
-                      const bool fatal)
-{
-  unsigned char* image;
-
-  if (!ImageFormatSupported(filename))
-  {
-    std::ostringstream oss;
-    oss << "Load(): file type " << Extension(filename) << " not supported. ";
-    oss << "Currently it supports:";
-    auto x = LoadFileTypes();
-    for (auto extension : x)
-      oss << " " << extension;
-    oss << "." << std::endl;
-
-    if (fatal)
-    {
-      Log::Fatal << oss.str();
-    }
-    else
-    {
-      Log::Warn << oss.str();
-    }
-
-    return false;
-  }
-
-  // Temporary variables needed as stb_image.h supports int parameters.
-  int tempWidth, tempHeight, tempChannels;
-
-  // For grayscale images.
-  if (info.Channels() == 1)
-  {
-    image = stbi_load(filename.c_str(), &tempWidth, &tempHeight, &tempChannels,
-        STBI_grey);
-  }
-  else
-  {
-    image = stbi_load(filename.c_str(), &tempWidth, &tempHeight, &tempChannels,
-        STBI_rgb);
-  }
-
-  if (!image)
-  {
-    if (fatal)
-    {
-      Log::Fatal << "Load(): failed to load image '" << filename << "': "
-          << stbi_failure_reason() << std::endl;
-    }
-    else
-    {
-      Log::Warn << "Load(): failed to load image '" << filename << "': "
-          << stbi_failure_reason() << std::endl;
-    }
-
-    return false;
-  }
-
-  info.Width() = tempWidth;
-  info.Height() = tempHeight;
-  // Only set the new number of channels if we didn't force grayscale loading.
-  if (info.Channels() != 1)
-    info.Channels() = tempChannels;
-
-  // Copy image into armadillo Mat.
-  matrix = arma::Mat<unsigned char>(image, info.Width() * info.Height() *
-      info.Channels(), 1, true, true);
-
-  // Free the image pointer.
-  stbi_image_free(image);
-  return true;
-}
-
-} // namespace data
-} // namespace mlpack
-
-#endif

mlpack/include/mlpack/core/data/load_model_impl.hpp

@@ -1,115 +0,0 @@
-/**
- * @file core/data/load_model_impl.hpp
- * @author Ryan Curtin
- *
- * Implementation of model-specific Load() function.
- *
- * mlpack is free software; you may redistribute it and/or modify it under the
- * terms of the 3-clause BSD license.  You should have received a copy of the
- * 3-clause BSD license along with mlpack.  If not, see
- * http://www.opensource.org/licenses/BSD-3-Clause for more information.
- */
-#ifndef MLPACK_CORE_DATA_LOAD_MODEL_IMPL_HPP
-#define MLPACK_CORE_DATA_LOAD_MODEL_IMPL_HPP
-
-// In case it hasn't already been included.
-#include "load.hpp"
-
-#include "extension.hpp"
-
-#include <cereal/archives/xml.hpp>
-#include <cereal/archives/binary.hpp>
-#include <cereal/archives/json.hpp>
-
-namespace mlpack {
-namespace data {
-
-// Load a model from file.
-template<typename T>
-bool Load(const std::string& filename,
-          const std::string& name,
-          T& t,
-          const bool fatal,
-          format f,
-          std::enable_if_t<HasSerialize<T>::value>*)
-{
-  if (f == format::autodetect)
-  {
-    std::string extension = Extension(filename);
-
-    if (extension == "xml")
-      f = format::xml;
-    else if (extension == "bin")
-      f = format::binary;
-    else if (extension == "json")
-      f = format::json;
-    else
-    {
-      if (fatal)
-        Log::Fatal << "Unable to detect type of '" << filename << "'; incorrect"
-            << " extension?" << std::endl;
-      else
-        Log::Warn << "Unable to detect type of '" << filename << "'; load "
-            << "failed.  Incorrect extension?" << std::endl;
-
-      return false;
-    }
-  }
-
-  // Now load the given format.
-  std::ifstream ifs;
-#ifdef _WIN32 // Open non-text in binary mode on Windows.
-  if (f == format::binary)
-    ifs.open(filename, std::ifstream::in | std::ifstream::binary);
-  else
-    ifs.open(filename, std::ifstream::in);
-#else
-  ifs.open(filename, std::ifstream::in);
-#endif
-
-  if (!ifs.is_open())
-  {
-    if (fatal)
-      Log::Fatal << "Unable to open file '" << filename << "' to load object '"
-          << name << "'." << std::endl;
-    else
-      Log::Warn << "Unable to open file '" << filename << "' to load object '"
-          << name << "'." << std::endl;
-
-    return false;
-  }
-  try
-  {
-    if (f == format::xml)
-    {
-      cereal::XMLInputArchive ar(ifs);
-      ar(cereal::make_nvp(name.c_str(), t));
-    }
-    else if (f == format::json)
-    {
-     cereal::JSONInputArchive ar(ifs);
-     ar(cereal::make_nvp(name.c_str(), t));
-    }
-    else if (f == format::binary)
-    {
-      cereal::BinaryInputArchive ar(ifs);
-      ar(cereal::make_nvp(name.c_str(), t));
-    }
-
-    return true;
-  }
-  catch (cereal::Exception& e)
-  {
-    if (fatal)
-      Log::Fatal << e.what() << std::endl;
-    else
-      Log::Warn << e.what() << std::endl;
-
-    return false;
-  }
-}
-
-} // namespace data
-} // namespace mlpack
-
-#endif

mlpack/include/mlpack/core/data/load_vec_impl.hpp

@@ -1,154 +0,0 @@
-/**
- * @file core/data/load_vec_impl.hpp
- * @author Ryan Curtin
- *
- * Implementation of templatized load() function defined in load.hpp for
- * vectors.
- *
- * mlpack is free software; you may redistribute it and/or modify it under the
- * terms of the 3-clause BSD license.  You should have received a copy of the
- * 3-clause BSD license along with mlpack.  If not, see
- * http://www.opensource.org/licenses/BSD-3-Clause for more information.
- */
-#ifndef MLPACK_CORE_DATA_LOAD_VEC_IMPL_HPP
-#define MLPACK_CORE_DATA_LOAD_VEC_IMPL_HPP
-
-// In case it hasn't already been included.
-#include "load.hpp"
-
-namespace mlpack {
-namespace data {
-
-// Load column vector.
-template<typename eT>
-bool LoadCol(const std::string& filename,
-             arma::Col<eT>& vec,
-             TextOptions& opts,
-             std::fstream& stream)
-{
-  // First load into auxiliary matrix.
-  arma::Mat<eT> tmp;
-  opts.NoTranspose() = true; // false Transpose
-  bool success = LoadDense(filename, tmp, opts, stream);
-  if (!success)
-  {
-    vec.clear();
-    return false;
-  }
-
-  // Now check the size to see that it is a vector, and return a vector.
-  if (tmp.n_cols > 1)
-  {
-    if (tmp.n_rows > 1)
-    {
-      // Problem: invalid size!
-      if (opts.Fatal())
-      {
-        Log::Fatal << "Matrix in file '" << filename << "' is not a vector, but"
-            << " instead has size " << tmp.n_rows << "x" << tmp.n_cols << "!"
-            << std::endl;
-      }
-      else
-      {
-        Log::Warn << "Matrix in file '" << filename << "' is not a vector, but "
-            << "instead has size " << tmp.n_rows << "x" << tmp.n_cols << "!"
-            << std::endl;
-      }
-
-      vec.clear();
-      return false;
-    }
-    else
-    {
-      /**
-       * It's loaded as a row vector (more than one column).  So we need to
-       * manually modify the shape of the matrix.  We can do this without
-       * damaging the data since it is only a vector.
-       */
-      arma::access::rw(tmp.n_rows) = tmp.n_cols;
-      arma::access::rw(tmp.n_cols) = 1;
-
-      /**
-       * Now we can call the move operator, but it has to be the move operator
-       * for Mat, not for Col.  This will avoid copying the data.
-       */
-      *((arma::Mat<eT>*) &vec) = std::move(tmp);
-      return true;
-    }
-  }
-  else
-  {
-    // It's loaded as a column vector.  We can call the move constructor
-    // directly.
-    *((arma::Mat<eT>*) &vec) = std::move(tmp);
-    return true;
-  }
-}
-
-// Load row vector.
-template<typename eT>
-bool LoadRow(const std::string& filename,
-             arma::Row<eT>& rowvec,
-             TextOptions& opts,
-             std::fstream& stream)
-{
-  arma::Mat<eT> tmp;
-  opts.NoTranspose() = true; // false Transpose
-  bool success = LoadDense(filename, tmp, opts, stream);
-  if (!success)
-  {
-    rowvec.clear();
-    return false;
-  }
-
-  if (tmp.n_rows > 1)
-  {
-    if (tmp.n_cols > 1)
-    {
-      // Problem: invalid size!
-      if (opts.Fatal())
-      {
-        Log::Fatal << "Matrix in file '" << filename << "' is not a vector, but"
-            << " instead has size " << tmp.n_rows << "x" << tmp.n_cols << "!"
-            << std::endl;
-      }
-      else
-      {
-        Log::Warn << "Matrix in file '" << filename << "' is not a vector, but "
-            << "instead has size " << tmp.n_rows << "x" << tmp.n_cols << "!"
-            << std::endl;
-      }
-
-      rowvec.clear();
-      return false;
-    }
-    else
-    {
-      /**
-       * It's loaded as a column vector (more than one row).  So we need to
-       * manually modify the shape of the matrix.  We can do this without
-       * damaging the data since it is only a vector.
-       */
-      arma::access::rw(tmp.n_cols) = tmp.n_rows;
-      arma::access::rw(tmp.n_rows) = 1;
-
-      /**
-       * Now we can call the move operator, but it has to be the move operator
-       * for Mat, not for Col.  This will avoid copying the data.
-       */
-      *((arma::Mat<eT>*) &rowvec) = std::move(tmp);
-      return true;
-    }
-  }
-  else
-  {
-    // It's loaded as a row vector.  We can call the move constructor directly.
-    *((arma::Mat<eT>*) &rowvec) = std::move(tmp);
-    return true;
-  }
-}
-
-} // namespace data
-} // namespace mlpack
-
-#endif