maialib 1.5.0__cp312-cp312-manylinux_2_17_x86_64.manylinux2014_x86_64.whl

maialib-1.5.0.dist-info/METADATA

@@ -0,0 +1,179 @@
+Metadata-Version: 2.1
+Name: maialib
+Version: 1.5.0
+Summary: A C++/Python library to manipulate sheet music data
+Home-page: https://github.com/nyckmaia/maialib
+Author: Nycholas Maia
+Author-email: nyckmaia@gmail.com
+License: GNU General Public License v3 or later (GPLv3+)
+Project-URL: Bug Tracker, https://github.com/nyckmaia/maialib/issues
+Keywords: music,score,sheet music,analysis
+Classifier: Development Status :: 3 - Alpha
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: C++
+Classifier: License :: OSI Approved :: GNU General Public License v3 or later (GPLv3+)
+Classifier: Operating System :: OS Independent
+Classifier: Intended Audience :: Science/Research
+Classifier: Natural Language :: English
+Classifier: Topic :: Software Development :: Libraries
+Requires-Python: >=3.8.0
+Description-Content-Type: text/markdown
+License-File: LICENSE.txt
+Requires-Dist: pandas
+Requires-Dist: plotly
+
+# Maialib - Music Analysis Library {#mainpage}
+
+![Maialib CI/CD](https://github.com/nyckmaia/maialib/actions/workflows/wheels.yml/badge.svg)
+
+This library is a multiplatform set of musical tools that enable musical score analisys and composition in a easy and fast way. <br>
+The project **core** was wrote in `C++17`, but it also has a `Python` wrapper that allows a greater number of people (ie musicians not trained in IT) to also have in their hands the same power and musical tools available in `maialib`.
+
+## Advantages
+
+- Easy to use to musicians and musical researchers
+- High computer perfomance and fast calculations
+- Read and write musical scores (MusicXML file format)
+
+## Get Python Package
+
+```python
+pip install maialib
+```
+Or, if you have a older `maialib` version installed on your system, please get the latest version running: `pip install maialib --upgrade`
+
+## Get Started
+
+You can easily import your sheet music (`*.xml` file) to Python environment using:
+
+```python
+import maialib as ml
+
+myScore = ml.Score('./Beethoven/Symphony_9th.xml')
+```
+
+Now you can explore some `maialib` features like:
+
+- Find musical patterns
+- Write your own scores from your custom algorithms
+- Analyse scores in a musical statistical data perspective
+- And much more!
+
+## Frequent Asked Questions
+
+### 1) Where can I find the XML file of a specific musical score?
+
+To import musical scores the file extensions must be: `*.xml`, `*.mxl` or `*.musicxml` <br>
+You can easily export your music files to these file formats above from score editors, like:
+
+- MuseScore (free!)
+- Sibelius
+- Finale
+- Others
+
+Many `MusicXML` files are avaliable for free in the internet for download.
+
+### 2) What can I do if I don't have a `*.xml` file of my target music?
+- First, make shure and look at different websites and online repositories trying to find the `*.xml` file
+- You can find on the internet the desired MIDI file and import it in a score editor (like MuseScore, Sibelius, Finale, etc.) and then export the `MusicXML` file from it
+- You can use scan the sheet music paper and get a PDF version of it, so:
+  - You can use a OMR software to try to convert the PDF file into a `*.xml` file
+  - You can pay for other people to type manually note-by-note the PDF into a musical software (link MuseScore, Sibelius, Finale, etc.)
+- You can type manually note-by-note the music paper into a musical software (link MuseScore, Sibelius, Finale, etc.)
+
+## Documentation (in development)
+
+This project have 2 documentation levels. One for each user type:
+
+- **Level 1 - User documentation:** for musicians, musical researchers and non-professional IT people (help me to do that!)
+- **Level 2 - Developer documentation:** A deeper information for professional C++ programmers (Doxygen)
+
+### Level 1: Python Tutorial
+
+You can explore `maialib` features looking at `python-tutorial` folder ([link here](https://github.com/nyckmaia/maialib/tree/main/python-tutorial)). <br>
+There you will learn how to use and mix `maialib` classes and functions to reach your musical goals
+If you are starting, please check these 3 basic `maialib` Python tutorials:
+- [Create Notes and Chords](https://github.com/nyckmaia/maialib/blob/main/python-tutorial/create_notes_chords.ipynb)
+- [Create a Score](https://github.com/nyckmaia/maialib/blob/main/python-tutorial/create_score.ipynb)
+- [Using Dataframes](https://github.com/nyckmaia/maialib/blob/main/python-tutorial/dataframe.ipynb)
+
+### Level 2: Developer Documentation
+
+[Maialib Documentation WebSite](https://maialib.com/)
+
+----------------------------
+
+Would you like to improve any maialib function?
+=============================================
+
+## Are you a C++ developer?
+
+### Requirements to build from C++ sources:
+
+- C++17 compatible compiler
+- CMake 3.26
+- Python 3.8
+- Make
+- Doxygen (Optional: To build documentation)
+- Buildcache (Optional: To accelerate the build process)
+- CppCheck (Optional: C++ Static Analyzer)
+
+## Are you a Python developer?
+
+### Python Dev-only dependencies
+
+```
+pip install pathlib
+pip install cpplint
+pip install wheel
+pip install mypy
+
+# To generate Python stubs
+pip install pybind11-stubgen
+# Mac users: May be you have to add the coverage and pybind11-stubgen on your `PATH` - /etc/paths
+
+pybind11_mkdoc (github)
+sudo apt install clang (pybind11_mkdoc dependency) - Linux/Mac Only
+```
+
+## Tested Environments
+
+| Operational System | Compilers                       |
+| ------------------ | ------------------------------- |
+| Windows 10 x64     | Clang 15.0 (MSYS2)              |
+| Linux Ubuntu 20.04 | GCC 9.3                         |
+| Apple OSX 10.15    | XCode 11.5 (Command Line Tools) |
+
+## Quick Start
+
+### Build Python module from C++ source
+
+Open a terminal (or CMD in Windows), enter inside of the `maialib` folder. <br>
+Type: `make` to build the Python module <br>
+When the build process finishes, type: `make install` <br>
+Done!
+
+## Known issues to build from source
+
+### All Platforms
+
+- Multiple Python versions installed, like: `Official Python`, `Microsoft Python`, `MSYS2 Python` and others can direct the build system to choose a wrong version to build and install the library. <br>
+  To check all Python versions installed on your system, open the `Terminal` (or `CMD` on Windows) and type: - Linux or Mac: - `which python` - `which python3` - Windows: - `where.exe python` - `where.exe python3`
+
+### Windows-Only
+
+- Disable your antivirus or create a exception (CMake permissions)
+
+## Contact
+
+Nycholas Maia - nyckmaia@gmail.com
+
+## Contributing
+
+- Fork this project
+- Make your custumizations and improvments
+- Please, send me a pull request
+
+## License
+
+Maialib is licensed under [GPLv3 License](https://www.gnu.org/licenses/gpl-3.0.html)

maialib-1.5.0.dist-info/RECORD

@@ -0,0 +1,26 @@
+maialib/setup.py,sha256=6Je6AH2kuRusn02fjJKIekGG8p6TjGH4uQNn-ZepGJM,2003
+maialib/__init__.py,sha256=qiIEL1ZDvpDK0bkGUdZRib3bG973EtKQDFYPFfvJKQA,122
+maialib/maiapy/__init__.pyi,sha256=L8YtZYJMw_9TrdejcKs2c5xTbu5WMRwlHhKz6Qzulf8,77
+maialib/maiapy/sethares_dissonance.pyi,sha256=DMZtrHTGSAaJwcBWX_G-sHF15_eETp1OeRr2L5vwdF0,1171
+maialib/maiapy/plots.py,sha256=laAt68-IiZ4vNLFPKcGCf4IcMDIIZ1uavJpROrS8tqs,23153
+maialib/maiapy/other.py,sha256=6IpzBGQIxCzcfqkFiuMp84GBF-YOmcrxYkevxEBpG6A,4033
+maialib/maiapy/sethares_dissonance.py,sha256=uRQLTQN55dk74hIFpzu9RlTWP0ZhRpVT3yTLI-su1ww,12830
+maialib/maiapy/other.pyi,sha256=5QOvpxb7l9TlDVCn0ACeFgjI14c_7CW0gUb7GoI3gn8,684
+maialib/maiapy/plots.pyi,sha256=7zchTew8-uvIvo0TmJXRd_SRlIX9w1AyOSplbL5YGNM,619
+maialib/maiapy/__init__.py,sha256=L8YtZYJMw_9TrdejcKs2c5xTbu5WMRwlHhKz6Qzulf8,77
+maialib/xml-scores-examples/Mozart_Requiem_Introitus.mxl,sha256=_wc4hMaPhtgocUoL94uVzfVN3TGb08z8Xa2BL4SHfgA,91112
+maialib/xml-scores-examples/Bach_Cello_Suite_1.mxl,sha256=0XGNlcW8o0W7kkeG8j2V_M4eggdOnrxvvvCkpf6x_z4,29622
+maialib/xml-scores-examples/Mahler_Symphony_8_Finale.mxl,sha256=F2-QBKNYjBv_sWT-z4LWi1rX84-P3msxtl-g6joA2FQ,229034
+maialib/xml-scores-examples/Beethoven_Symphony_5_mov_1.xml,sha256=iZ2uqqHWMkDtmQVKovT-H_-zZp1SixASi1R7L3TmuOI,4775525
+maialib/xml-scores-examples/Chopin_Fantasie_Impromptu.mxl,sha256=HkouQ_4bI6XDoGmzJITuU81CzQZE2lQjwl6WNlfZmJA,35727
+maialib/xml-scores-examples/Dvorak_Symphony_9_mov_4.mxl,sha256=s7FGUEmFmgcIdmkZ-bv4sOGGj5HYKc2nc760V79DMtM,261438
+maialib/xml-scores-examples/Strauss_Also_Sprach_Zarathustra.mxl,sha256=nOQra05RHHDe_dXFs5WBJG2l9R1KQk64urV7lWYC2vw,18863
+maialib/maiacore/maiacore.cpython-312-x86_64-linux-gnu.so,sha256=Isi6sdEqp2QRtGJ4Ei2x3gyf16JZCSlnUUidrSfmJPc,4144584
+maialib/maiacore/__init__.pyi,sha256=6ch7-K9458Bh_ReceKjaFGWROX9AbgKpJOI6t_4F3jk,1205
+maialib/maiacore/maiacore.pyi,sha256=SKUFFo8dVG8uFL-W7Dj7Qc1wmP6rbYlM_0Hl7om495I,47052
+maialib/maiacore/__init__.py,sha256=IW7E0LuzAttsn0b37SEthCA0LKuzSgkepSpq8DWExYQ,77
+maialib-1.5.0.dist-info/LICENSE.txt,sha256=ixuiBLtpoK3iv89l7ylKkg9rs2GzF9ukPH7ynZYzK5s,35148
+maialib-1.5.0.dist-info/WHEEL,sha256=B8ArxCF_7InJqP4ievx59sDebzJENUkfE_wbI31fy-8,151
+maialib-1.5.0.dist-info/top_level.txt,sha256=sZWQaa-Up2ba00WpAxBhOLKM6qQYTpUKJMXgSE0Nc48,17
+maialib-1.5.0.dist-info/RECORD,,
+maialib-1.5.0.dist-info/METADATA,sha256=IsX5RcPKJOVpFdslsGFK8rTRzVg05fWMnqN_4p3uyog,6654

maialib-1.5.0.dist-info/WHEEL

@@ -0,0 +1,6 @@
+Wheel-Version: 1.0
+Generator: setuptools (70.1.0)
+Root-Is-Purelib: false
+Tag: cp312-cp312-manylinux_2_17_x86_64
+Tag: cp312-cp312-manylinux2014_x86_64
+

maialib-1.5.0.dist-info/top_level.txt

@@ -0,0 +1,2 @@
+maiacore
+maialib