/* Copyright 2017 Leon Merten Lohse Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. */ /* * MegEngine is Licensed under the Apache License, Version 2.0 (the "License") * * Copyright (c) 2020-2021 Megvii Inc. All rights reserved. * * Unless required by applicable law or agreed to in writing, * software distributed under the License is distributed on an * "AS IS" BASIS, WITHOUT ARRANTIES OR CONDITIONS OF ANY KIND, either express or * implied. */ #ifndef NPY_H #define NPY_H #include #include #include #include #include #include #include #include #include #include #include #include namespace npy { /* Compile-time test for byte order. If your compiler does not define these per default, you may want to define one of these constants manually. Defaults to little endian order. */ #if defined(__BYTE_ORDER) && __BYTE_ORDER == __BIG_ENDIAN || \ defined(__BIG_ENDIAN__) || defined(__ARMEB__) || defined(__THUMBEB__) || \ defined(__AARCH64EB__) || defined(_MIBSEB) || defined(__MIBSEB) || \ defined(__MIBSEB__) const bool big_endian = true; #else const bool big_endian = false; #endif const char magic_string[] = "\x93NUMPY"; const size_t magic_string_length = 6; const char little_endian_char = '<'; const char big_endian_char = '>'; const char no_endian_char = '|'; constexpr char host_endian_char = (big_endian ? big_endian_char : little_endian_char); /* npy array length */ typedef unsigned long int ndarray_len_t; inline void write_magic( std::ostream& ostream, unsigned char v_major = 1, unsigned char v_minor = 0) { ostream.write(magic_string, magic_string_length); ostream.put(v_major); ostream.put(v_minor); } inline void read_magic( std::istream& istream, unsigned char& v_major, unsigned char& v_minor) { char buf[magic_string_length + 2]; istream.read(buf, magic_string_length + 2); if (!istream) { fprintf(stderr, "io error: failed reading file"); } if (0 != std::memcmp(buf, magic_string, magic_string_length)) { fprintf(stderr, "this file does not have a valid npy format."); } v_major = buf[magic_string_length]; v_minor = buf[magic_string_length + 1]; } // typestring magic struct Typestring { private: char c_endian; char c_type; int len; public: inline std::string str() { const size_t max_buflen = 16; char buf[max_buflen]; std::sprintf(buf, "%c%c%u", c_endian, c_type, len); return std::string(buf); } Typestring(const std::vector&) : c_endian{host_endian_char}, c_type{'f'}, len{sizeof(float)} {} Typestring(const std::vector&) : c_endian{host_endian_char}, c_type{'f'}, len{sizeof(double)} {} Typestring(const std::vector&) : c_endian{host_endian_char}, c_type{'f'}, len{sizeof(long double)} {} Typestring(const std::vector&) : c_endian{no_endian_char}, c_type{'i'}, len{sizeof(char)} {} Typestring(const std::vector&) : c_endian{host_endian_char}, c_type{'i'}, len{sizeof(short)} {} Typestring(const std::vector&) : c_endian{host_endian_char}, c_type{'i'}, len{sizeof(int)} {} Typestring(const std::vector&) : c_endian{host_endian_char}, c_type{'i'}, len{sizeof(long)} {} Typestring(const std::vector&) : c_endian{host_endian_char}, c_type{'i'}, len{sizeof(long long)} {} Typestring(const std::vector&) : c_endian{no_endian_char}, c_type{'u'}, len{sizeof(unsigned char)} {} Typestring(const std::vector&) : c_endian{host_endian_char}, c_type{'u'}, len{sizeof(unsigned short)} {} Typestring(const std::vector&) : c_endian{host_endian_char}, c_type{'u'}, len{sizeof(unsigned int)} {} Typestring(const std::vector&) : c_endian{host_endian_char}, c_type{'u'}, len{sizeof(unsigned long)} {} Typestring(const std::vector&) : c_endian{host_endian_char}, c_type{'u'}, len{sizeof(unsigned long long)} {} Typestring(const std::vector>&) : c_endian{host_endian_char}, c_type{'c'}, len{sizeof(std::complex)} {} Typestring(const std::vector>&) : c_endian{host_endian_char}, c_type{'c'}, len{sizeof(std::complex)} {} Typestring(const std::vector>&) : c_endian{host_endian_char}, c_type{'c'}, len{sizeof(std::complex)} {} }; inline void parse_typestring(std::string typestring) { std::regex re("'([<>|])([ifuc])(\\d+)'"); std::smatch sm; std::regex_match(typestring, sm, re); if (sm.size() != 4) { fprintf(stderr, "invalid typestring"); } } namespace pyparse { /** Removes leading and trailing whitespaces */ inline std::string trim(const std::string& str) { const std::string whitespace = " \t"; auto begin = str.find_first_not_of(whitespace); if (begin == std::string::npos) return ""; auto end = str.find_last_not_of(whitespace); return str.substr(begin, end - begin + 1); } inline std::string get_value_from_map(const std::string& mapstr) { size_t sep_pos = mapstr.find_first_of(":"); if (sep_pos == std::string::npos) return ""; std::string tmp = mapstr.substr(sep_pos + 1); return trim(tmp); } /** Parses the string representation of a Python dict The keys need to be known and may not appear anywhere else in the data. */ inline std::unordered_map parse_dict( std::string in, std::vector& keys) { std::unordered_map map; if (keys.size() == 0) return map; in = trim(in); // unwrap dictionary if ((in.front() == '{') && (in.back() == '}')) in = in.substr(1, in.length() - 2); else { fprintf(stderr, "Not a Python dictionary."); } std::vector> positions; for (auto const& value : keys) { size_t pos = in.find("'" + value + "'"); if (pos == std::string::npos) { fprintf(stderr, "Missing %s key.", value.c_str()); } std::pair position_pair{pos, value}; positions.push_back(position_pair); } // sort by position in dict std::sort(positions.begin(), positions.end()); for (size_t i = 0; i < positions.size(); ++i) { std::string raw_value; size_t begin{positions[i].first}; size_t end{std::string::npos}; std::string key = positions[i].second; if (i + 1 < positions.size()) end = positions[i + 1].first; raw_value = in.substr(begin, end - begin); raw_value = trim(raw_value); if (raw_value.back() == ',') raw_value.pop_back(); map[key] = get_value_from_map(raw_value); } return map; } /** Parses the string representation of a Python boolean */ inline bool parse_bool(const std::string& in) { if (in == "True") return true; if (in == "False") return false; fprintf(stderr, "Invalid python boolan."); return false; } /** Parses the string representation of a Python str */ inline std::string parse_str(const std::string& in) { if ((in.front() == '\'') && (in.back() == '\'')) return in.substr(1, in.length() - 2); fprintf(stderr, "Invalid python string."); return ""; } /** Parses the string represenatation of a Python tuple into a vector of its items */ inline std::vector parse_tuple(std::string in) { std::vector v; const char seperator = ','; in = trim(in); if ((in.front() == '(') && (in.back() == ')')) in = in.substr(1, in.length() - 2); else { fprintf(stderr, "Invalid Python tuple."); } std::istringstream iss(in); for (std::string token; std::getline(iss, token, seperator);) { v.push_back(token); } return v; } template inline std::string write_tuple(const std::vector& v) { if (v.size() == 0) return ""; std::ostringstream ss; if (v.size() == 1) { ss << "(" << v.front() << ",)"; } else { const std::string delimiter = ", "; // v.size() > 1 ss << "("; std::copy( v.begin(), v.end() - 1, std::ostream_iterator(ss, delimiter.c_str())); ss << v.back(); ss << ")"; } return ss.str(); } inline std::string write_boolean(bool b) { if (b) return "True"; else return "False"; } } // namespace pyparse inline void parse_header(std::string header, std::string& descr) { /* The first 6 bytes are a magic string: exactly "x93NUMPY". The next 1 byte is an unsigned byte: the major version number of the file format, e.g. x01. The next 1 byte is an unsigned byte: the minor version number of the file format, e.g. x00. Note: the version of the file format is not tied to the version of the numpy package. The next 2 bytes form a little-endian unsigned short int: the length of the header data HEADER_LEN. The next HEADER_LEN bytes form the header data describing the array's format. It is an ASCII string which contains a Python literal expression of a dictionary. It is terminated by a newline ('n') and padded with spaces ('x20') to make the total length of the magic string + 4 + HEADER_LEN be evenly divisible by 16 for alignment purposes. The dictionary contains three keys: "descr" : dtype.descr An object that can be passed as an argument to the numpy.dtype() constructor to create the array's dtype. For repeatability and readability, this dictionary is formatted using pprint.pformat() so the keys are in alphabetic order. */ // remove trailing newline if (header.back() != '\n') fprintf(stderr, "invalid header"); header.pop_back(); // parse the dictionary std::vector keys{"descr"}; auto dict_map = npy::pyparse::parse_dict(header, keys); if (dict_map.size() == 0) fprintf(stderr, "invalid dictionary in header"); std::string descr_s = dict_map["descr"]; parse_typestring(descr_s); // remove descr = npy::pyparse::parse_str(descr_s); return; } inline void parse_header( std::string header, std::string& descr, bool& fortran_order, std::vector& shape) { /* The first 6 bytes are a magic string: exactly "x93NUMPY". The next 1 byte is an unsigned byte: the major version number of the file format, e.g. x01. The next 1 byte is an unsigned byte: the minor version number of the file format, e.g. x00. Note: the version of the file format is not tied to the version of the numpy package. The next 2 bytes form a little-endian unsigned short int: the length of the header data HEADER_LEN. The next HEADER_LEN bytes form the header data describing the array's format. It is an ASCII string which contains a Python literal expression of a dictionary. It is terminated by a newline ('n') and padded with spaces ('x20') to make the total length of the magic string + 4 + HEADER_LEN be evenly divisible by 16 for alignment purposes. The dictionary contains three keys: "descr" : dtype.descr An object that can be passed as an argument to the numpy.dtype() constructor to create the array's dtype. "fortran_order" : bool Whether the array data is Fortran-contiguous or not. Since Fortran-contiguous arrays are a common form of non-C-contiguity, we allow them to be written directly to disk for efficiency. "shape" : tuple of int The shape of the array. For repeatability and readability, this dictionary is formatted using pprint.pformat() so the keys are in alphabetic order. */ // remove trailing newline if (header.back() != '\n') fprintf(stderr, "invalid header"); header.pop_back(); // parse the dictionary std::vector keys{"descr", "fortran_order", "shape"}; auto dict_map = npy::pyparse::parse_dict(header, keys); if (dict_map.size() == 0) fprintf(stderr, "invalid dictionary in header"); std::string descr_s = dict_map["descr"]; std::string fortran_s = dict_map["fortran_order"]; std::string shape_s = dict_map["shape"]; // TODO: extract info from typestring parse_typestring(descr_s); // remove descr = npy::pyparse::parse_str(descr_s); // convert literal Python bool to C++ bool fortran_order = npy::pyparse::parse_bool(fortran_s); // parse the shape tuple auto shape_v = npy::pyparse::parse_tuple(shape_s); if (shape_v.size() == 0) fprintf(stderr, "invalid shape tuple in header"); for (auto item : shape_v) { ndarray_len_t dim = static_cast(std::stoul(item)); shape.push_back(dim); } } inline std::string write_header_dict( const std::string& descr, bool fortran_order, const std::vector& shape) { std::string s_fortran_order = npy::pyparse::write_boolean(fortran_order); std::string shape_s = npy::pyparse::write_tuple(shape); return "{'descr': '" + descr + "', 'fortran_order': " + s_fortran_order + ", 'shape': " + shape_s + ", }"; } inline void write_header( std::ostream& out, const std::string& descr, bool fortran_order, const std::vector& shape_v) { std::string header_dict = write_header_dict(descr, fortran_order, shape_v); size_t length = magic_string_length + 2 + 2 + header_dict.length() + 1; unsigned char version[2] = {1, 0}; if (length >= 255 * 255) { length = magic_string_length + 2 + 4 + header_dict.length() + 1; version[0] = 2; version[1] = 0; } size_t padding_len = 16 - length % 16; std::string padding(padding_len, ' '); // write magic write_magic(out, version[0], version[1]); // write header length if (version[0] == 1 && version[1] == 0) { char header_len_le16[2]; uint16_t header_len = static_cast(header_dict.length() + padding.length() + 1); header_len_le16[0] = (header_len >> 0) & 0xff; header_len_le16[1] = (header_len >> 8) & 0xff; out.write(reinterpret_cast(header_len_le16), 2); } else { char header_len_le32[4]; uint32_t header_len = static_cast(header_dict.length() + padding.length() + 1); header_len_le32[0] = (header_len >> 0) & 0xff; header_len_le32[1] = (header_len >> 8) & 0xff; header_len_le32[2] = (header_len >> 16) & 0xff; header_len_le32[3] = (header_len >> 24) & 0xff; out.write(reinterpret_cast(header_len_le32), 4); } out << header_dict << padding << '\n'; } inline std::string read_header(std::istream& istream) { // check magic bytes an version number unsigned char v_major, v_minor; read_magic(istream, v_major, v_minor); uint32_t header_length = 0; if (v_major == 1 && v_minor == 0) { char header_len_le16[2]; istream.read(header_len_le16, 2); header_length = (header_len_le16[0] << 0) | (header_len_le16[1] << 8); if ((magic_string_length + 2 + 2 + header_length) % 16 != 0) { // TODO: display warning } } else if (v_major == 2 && v_minor == 0) { char header_len_le32[4]; istream.read(header_len_le32, 4); header_length = (header_len_le32[0] << 0) | (header_len_le32[1] << 8) | (header_len_le32[2] << 16) | (header_len_le32[3] << 24); if ((magic_string_length + 2 + 4 + header_length) % 16 != 0) { // TODO: display warning } } else { fprintf(stderr, "unsupported file format version"); } auto buf_v = std::vector(); buf_v.reserve(header_length); istream.read(buf_v.data(), header_length); std::string header(buf_v.data(), header_length); return header; } inline ndarray_len_t comp_size(const std::vector& shape) { ndarray_len_t size = 1; for (ndarray_len_t i : shape) size *= i; return size; } template inline void SaveArrayAsNumpy( const std::string& filename, bool fortran_order, unsigned int n_dims, const unsigned long shape[], const std::vector& data) { Typestring typestring_o(data); std::string typestring = typestring_o.str(); std::ofstream stream(filename, std::ofstream::binary); if (!stream) { fprintf(stderr, "io error: failed to open a file."); } std::vector shape_v(shape, shape + n_dims); write_header(stream, typestring, fortran_order, shape_v); auto size = static_cast(comp_size(shape_v)); stream.write(reinterpret_cast(data.data()), sizeof(Scalar) * size); } template inline void LoadArrayFromNumpy( const std::string& filename, std::vector& shape, std::vector& data) { bool fortran_order; LoadArrayFromNumpy(filename, shape, fortran_order, data); } template inline void LoadArrayFromNumpy( const std::string& filename, std::vector& shape, bool& fortran_order, std::vector& data) { std::ifstream stream(filename, std::ifstream::binary); if (!stream) { fprintf(stderr, "io error: failed to open a file."); } std::string header = read_header(stream); // parse header std::string typestr; parse_header(header, typestr, fortran_order, shape); // check if the typestring matches the given one Typestring typestring_o{data}; std::string expect_typestr = typestring_o.str(); if (typestr != expect_typestr) { fprintf(stderr, "formatting error: typestrings not matching"); } // compute the data size based on the shape auto size = static_cast(comp_size(shape)); data.resize(size); // read the data stream.read(reinterpret_cast(data.data()), sizeof(Scalar) * size); } inline void LoadArrayFromNumpy( const std::string& filename, std::string& type_str, std::vector& shape, std::vector& data) { std::ifstream stream(filename, std::ifstream::binary); if (!stream) { fprintf(stderr, "io error: failed to open a file."); } std::string header = read_header(stream); bool fortran_order; // parse header parse_header(header, type_str, fortran_order, shape); // check if the typestring matches the given one std::string size_str = type_str.substr(type_str.size() - 1); size_t elem_size = atoi(size_str.c_str()); // compute the data size based on the shape auto byte_size = elem_size * static_cast(comp_size(shape)); data.resize(byte_size); // read the data stream.read(reinterpret_cast(data.data()), byte_size); } } // namespace npy #endif // NPY_H