{"id":13709180,"url":"https://github.com/tbeu/matio","last_synced_at":"2025-04-08T01:36:55.817Z","repository":{"id":3141794,"uuid":"48456015","full_name":"tbeu/matio","owner":"tbeu","description":"MATLAB MAT File I/O Library","archived":false,"fork":false,"pushed_at":"2024-10-24T20:28:48.000Z","size":5417,"stargazers_count":342,"open_issues_count":16,"forks_count":96,"subscribers_count":23,"default_branch":"master","last_synced_at":"2024-10-24T21:26:59.657Z","etag":null,"topics":["c","file-format","hdf5","mat-files","matlab","zlib"],"latest_commit_sha":null,"homepage":"https://matio.sourceforge.io","language":"C","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"bsd-2-clause","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/tbeu.png","metadata":{"files":{"readme":"README","changelog":"NEWS","contributing":null,"funding":".github/FUNDING.yml","license":"COPYING","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null},"funding":{"github":"tbeu"}},"created_at":"2015-12-22T21:59:57.000Z","updated_at":"2024-10-22T04:48:16.000Z","dependencies_parsed_at":"2023-09-24T06:51:53.522Z","dependency_job_id":"ec8a2ced-4a1a-4e49-9f8c-14f1ebf55f2b","html_url":"https://github.com/tbeu/matio","commit_stats":{"total_commits":1419,"total_committers":36,"mean_commits":"39.416666666666664","dds":0.3587033121916843,"last_synced_commit":"492ea83c98467ac0229976a65374f092d7545f71"},"previous_names":[],"tags_count":29,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tbeu%2Fmatio","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tbeu%2Fmatio/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tbeu%2Fmatio/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tbeu%2Fmatio/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/tbeu","download_url":"https://codeload.github.com/tbeu/matio/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247761051,"owners_count":20991531,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["c","file-format","hdf5","mat-files","matlab","zlib"],"created_at":"2024-08-02T23:00:36.539Z","updated_at":"2025-04-08T01:36:55.797Z","avatar_url":"https://github.com/tbeu.png","language":"C","readme":"MATIO - MATLAB MAT file I/O library\n\nTable of Contents\n~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~\n1.0 Introduction\n  1.1 Contact\n  1.2 Acknowledgements\n  1.3 Contributing\n  1.4 Questions and Reporting Bugs\n2.0 Building\n  2.1 Dependencies\n    2.1.1 zlib\n    2.1.2 HDF5\n  2.2 Building matio\n    2.2.1 Quick Build Guide\n    2.2.2 Configure Options\n    2.2.3 CMake build system\n    2.2.4 Visual Studio\n    2.2.5 Testsuite\n  2.3 Platforms\n3.0 License\n\n1.0 Introduction\n    Matio is an open-source C library for reading and writing binary MATLAB MAT\n    files.\n    This library is designed for use by programs/libraries that do not have\n    access or do not want to rely on MATLAB's shared libraries.\n\n    1.1 Contact\n        You can contact the maintainer through email at\n        t-beu@users.sourceforge.net.\n\n    1.2 Acknowledgements\n        The following people/organizations have helped in the development of\n        matio through patches, bug reports, and/or testing:\n          * Don Zimmer (https://github.com/dpzimmer)\n          * Greg Sjaardema (https://github.com/gsjaardema)\n          * Jacco van Beek (https://sourceforge.net/u/jabe)\n          * John Filo (https://github.com/jfilo)\n          * LTX Simulation (https://www.ltx.de/english.html)\n          * Maarten Bent (https://github.com/MaartenBent)\n          * Modelica Association (https://modelica.org/association)\n          * Nelson (https://nelson-lang.github.io/nelson-website/)\n          * Nils Jannasch (https://github.com/NJannasch)\n          * OpenMEEG ((http://openmeeg.github.io/)\n          * Scilab (http://www.scilab.org/)\n          * Sébastien Villemot (https://github.com/svillemot)\n          * SGI in support of Interactive Supercomputing, Inc.\n          * Steven Leibman \u003csleibman@alum.mit.edu\u003e\n\n    1.3 Contributing\n        If you are interested in collaborations, contact the maintainer via\n        email (see section 1.1).\n\n    1.4 Questions and Reporting Bugs\n        Questions can be asked using the forums on the sourceforge site hosting\n        matio (https://sourceforge.net/p/matio/discussion).\n\n        Bugs, enhancements, etc. should be submitted using one of the trackers\n        on the sourceforge page (https://sourceforge.net/p/matio/_list/tickets).\n\n2.0 Building\n    This section describes how to build matio. Section 2.1 describes the\n    dependencies, section 2.2 how to build/test matio, and section 2.3\n    documents the platforms matio has been tested on.\n\n    2.1 Dependencies\n        Matio has two optional dependencies. These are not required for the\n        software to work, but without them some files may be unreadable. Zlib\n        is required to read/write level 5 MAT files that use compression. HDF5\n        is required to work with newer MAT files that use the HDF5-format\n        files.\n\n        2.1.1 zlib\n            To support compressed MAT files, zlib 1.2.3 or greater is required.\n            The zlib software can be downloaded from http://zlib.net.\n\n        2.1.2 HDF5\n            Support for MAT file version 7.3 requires the HDF5 library. This\n            library can be downloaded from https://www.hdfgroup.org/. Matio\n            requires HDF5 version 1.8.x or greater. Neither deprecated HDF5\n            1.6.x API functions nor HDF5 higher-level functions are called.\n\n              * Building matio with HDF5 1.8.x requires configuration of HDF5\n                with default API version 1.8 (i.e.\n                '--with-default-api-version=v18').\n              * Building matio with HDF5 1.10.x requires configuration of HDF5\n                with either default API version 1.10 (i.e.\n                '--with-default-api-version=v110') or with deprecated API\n                version 1.8 (i.e. '--with-default-api-version=v18').\n              * Building matio with HDF5 1.12.x requires configuration of HDF5\n                with either default API version 1.12 (i.e.\n                '--with-default-api-version=v112'), or with deprecated API\n                version 1.10 (i.e. '--with-default-api-version=v110') or with\n                deprecated API version 1.8 (i.e. '--with-default-api-version=v18').\n              * Building matio with HDF5 1.14.x requires configuration of HDF5\n                with either default API version 1.14 (i.e.\n                '--with-default-api-version=v114'), or with deprecated API\n                version 1.12 (i.e. '--with-default-api-version=v112'), or with\n                deprecated API version 1.10 (i.e. '--with-default-api-version=v110')\n                or with deprecated API version 1.8 (i.e.\n                '--with-default-api-version=v18').\n\n            For Windows, the pre-compiled binaries can be used which also\n            include a DLL of zlib to satisfy the zlib dependency.\n            For Ubuntu, 'sudo apt install libhdf5-dev' should work fine.\n\n    2.2 Building matio\n        2.2.1 Quick Build Guide\n            The primary method for building the software is with is with GNU\n            autotools using 'configure' followed by 'make'. After building, the\n            testsuite can be executed to test the software using 'make check'.\n            The software can be installed using 'make install'. For example,\n                $ tar zxf matio-X.Y.Z.tar.gz\n                $ cd matio-X.Y.Z\n                $ ./configure\n                $ make\n                $ make check\n                $ make install\n\n            If any of the tests in the testsuite fail, you should report the failure\n            using the tracker (see section 1.4). You should attach the generated\n            testsuite.log file to the bug report.\n\n        2.2.2 Configure Options\n            The configure script used to build the software takes a number of\n            options. This section describes the key options.\n\n              * '--enable-mat73=yes'\n                This flag en/disables the support for version 7.3 MAT files.\n                The option only makes sense if built with HDF5 as support for\n                version 7.3 files. It will be disabled if HDF5 is not available.\n              * '--enable-extended-sparse=yes'\n                Enable extended sparse matrix data types not supported in\n                MATLAB. MATLAB only supports double-precision sparse data.\n                With this flag, matio will read sparse data with other types\n                (i.e. single-precision and integer types).\n              * '--with-matlab=DIR'\n                This option specifies the directory (DIR) with the 'matlab'\n                program. With this option, the testsuite will check that the\n                MAT files written by matio can be read into MATLAB. Without\n                this, the test will only check that matio can read the file\n                written and if successful the test will be skipped. If matio\n                can not read the file, the test will fail.\n              * '--with-zlib=DIR'\n                This option specifies the prefix where zlib is installed\n                (see section 2.1.1 for information about zlib).\n              * '--with-hdf5=DIR'\n                This option specifies the prefix where the HDF5 software is\n                installed (see section 2.1.2 for information about HDF5).\n              * '--with-default-file-ver=version'\n                This option sets the default MAT file version (4,5,7.3) that\n                will be used when writing. The default file version is used\n                by the Mat_Create macro and the Mat_CreateVer function when\n                MAT_FT_DEFAULT is used for the version argument.\n              * '--with-libdir-suffix=suffix'\n                This option specifies a suffix to apply to library\n                directories when installing and looking for dependent\n                libraries (i.e. HDF5 and zlib). For example, some multi-arch\n                Linux distributions install 64-bit libraries into lib64 and\n                32-bit libraries into lib.\n\n        2.3.3. CMake build system\n            The CMake build system is supported as an alternative build system,\n            which usually consists of three steps for configuration, build and\n            installation. By default, the CMake project is also configured for\n            testing with CTest. For example,\n\n                $ tar zxf matio-X.Y.Z.tar.gz\n                $ cd matio-X.Y.Z\n                $ cmake .\n                $ cmake --build .\n                $ ctest --test-dir .\n                $ cmake --install .\n\n            The following matio specific options for building with CMake are\n            available.\n\n              * 'MATIO_USE_CONAN:BOOL=OFF'\n                This option enables the Conan package manager to resolve the\n                library dependencies. Only Conan 1.x is supported.\n              * 'MATIO_DEFAULT_FILE_VERSION:STRING=5'\n                This option sets the default MAT file version (4,5,7.3) that\n                will be used when writing.\n              * 'MATIO_EXTENDED_SPARSE:BOOL=ON'\n                This option enables extended sparse matrix data types not\n                supported in MATLAB.\n              * 'MATIO_MAT73:BOOL=ON'\n                This flag enables the support for version 7.3 MAT files.\n              * 'MATIO_PIC:BOOL=ON'\n                This option enables position-independent code (PIC),\n                i.e., compilation with the '-fPIC' flag. It is ignored for\n                Visual Studio builds.\n              * 'MATIO_SHARED:BOOL=ON'\n                This option builds the matio library as shared object\n                (i.e., a dynamic link library on Windows).\n              * 'MATIO_WITH_HDF5:BOOL=ON'\n                This option enables CMake to check for availability of the\n                HDF5 library (see section 2.1.2 for information about HDF5).\n              * 'MATIO_WITH_ZLIB:BOOL=ON'\n                This option enables CMake to check for availability of the\n                zlib library (see section 2.1.1 for information about zlib).\n              * 'MATIO_BUILD_TESTING:BOOL=ON'\n                This option enables the matio testsuite for CTest.\n              * 'MATIO_ENABLE_CPPCHECK:BOOL=OFF'\n                This option enables CMake \u003e= 3.10 to perform static analysis\n                with Cppcheck.\n\n            To help CMake find the HDF5 libraries, set environment variable\n            HDF5_DIR to the 'cmake/hdf5' directory (containing 'hdf5-config.cmake')\n            inside the HDF5 build or installation directory, or call cmake with\n            -DHDF5_DIR=\"dir/to/hdf5/cmake/hdf5\". Alternatively call CMake with\n            -DCMAKE_PREFIX_PATH=\"dir/to/hdf5/cmake\". See the HDF5 instructions\n            (https://support.hdfgroup.org/HDF5/release/cmakebuild.html#compile)\n            for more information. Using 'hdf5-config.cmake' is recommended over\n            using CMake's built-in 'FindHDF5', especially for static builds.\n            CMake 3.10 or later is recommended.\n\n        2.2.4 Visual Studio\n            Visual Studio solutions are provided as visual_studio/matio_vs2008.sln\n            for VS2008 and as visual_studio/matio.sln for VS2010 (and newer).\n            The Debug and Release configurations of both solutions are set up to\n            build a DLL of the matio library (libmatio.dll) and the matdump tool\n            and assume HDF5 is available in the directory specified by the\n            HDF5_DIR environment variable. It is assumed that the shared libraries\n            of HDF5 (and zlib) are available. If the static libraries of HDF5 (and\n            zlib) are installed/built the macro 'H5_BUILT_AS_STATIC_LIB' needs to\n            be defined (instead of 'H5_BUILT_AS_DYNAMIC_LIB'). Furthermore, the\n            Release Lib configuration of the VS2010 solution is set up to build a\n            static LIB of the matio library (libmatio.lib) and assumes that the\n            static libraries of HDF5 (and zlib) are installed/built.\n\n        2.2.5 Testsuite\n            A testsuite is available when building with the GNU autotools. To\n            run the testsuite, first configure and build matio. After building\n            run 'make check' to run the testsuite. If matio was built without\n            zlib, the compressed variable tests will be skipped. If built\n            without HDF5, the tests for version 7.3 MAT files will be skipped.\n            If the path to the MATLAB application was not specified\n            ('--with-matlab'), the write tests will fail if matio cannot read\n            the file and skip if matio can read the file. The write tests will\n            pass if MATLAB is available and can also read the file.\n\n            To report matio testsuite failures, compress the testsuite.log file\n            in the test sub-directory of the build directory. Upload the\n            compressed log file along with a bug report (see section 1.4 for\n            information on reporting bugs).\n\n    2.3 Platforms\n        The library has been tested/used on Linux, Windows, and OS X\n        including both little-endian and big-endian architecture.\n\n3.0 License\n    This software is provided under a Simplified BSD license. See the COPYING\n    file for details on the license.\n","funding_links":["https://github.com/sponsors/tbeu"],"categories":["Math","C","Recently Updated"],"sub_categories":["[Who Wants to Be a Millionare](https://www.boardgamecapital.com/who-wants-to-be-a-millionaire-rules.htm)"],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftbeu%2Fmatio","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftbeu%2Fmatio","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftbeu%2Fmatio/lists"}