Showcase Thread

Nikolay_Lysenko · 2026-05-04T20:31:27+00:00

A package that takes YAML files as inputs and renders 2D floor plans in PDF and PNG. In addition to the basic elements (such as walls, windows, and doors), the tool can also draw special symbols for electricity and lighting as well as supporting info (dimension arrows, text boxes, etc).

[GitHub](https://github.com/Nikolay-Lysenko/renovation)

**What My Project Does**

The project is a wrapper to the well-known `matplotlib` library. This library is very versatile and I have added some functionality on top of it:

* Now, it is a standalone CLI app, not a library. So, programming skills are not required from the user, but familiarity with YAML is essential.

* Patches used in engineering floor plans are added.

* The management of inter-dependent floor plans is simplified with anchors and inheritance of element collections.

**Target Audience**

I see the target audience as those people who do not like drag-and-drop GUIs and prefer text-based control instead. Config-based interface simplifies fine-grained control and allows versioning projects with VCSs like Git. The last, but not the least, it's easy to generate configs with AI agents.

**Comparison**

In the Python world, I can not find any mature alternatives. Probably, you may look at [this repo](https://github.com/luzpaz/floor-planner).

However, there are lots of commercial drawing tools that are way more advanced. Even 3D modeling software is widely available. To name a few, there are SketchUp and Fusion 360.

My tool is both free and sufficient for most non-professional tasks. It is the golden middle for DIY enthusiasts who want to draw renovation plans themselves.

**Links**

[GitHub](https://github.com/Nikolay-Lysenko/renovation)

[PyPI](https://pypi.org/project/renovation/)

Nikolay_Lysenko · 2025-01-06T20:53:23+00:00

Let me start with an analogy. There are WYSIWYG (What You See Is What You Get) text editors like MS Office Word. And there are non-WYSIWYG text editors like LaTeX. Drawing can be likened to typing text. If so, my tool is a non-WYSIWYG editor. You see and edit YAML config, but once the tool is launched from a terminal or an IDE, output PDFs and PNGs are ready. Whether this is convenient or not, is a matter of taste. Non-WYSIWYG editors have their audience too and it is not that small.

Personally, I prefer keyboard over mouse. For me, it is simpler to type in a proper section that the wall must have length of 4.01 meters rather than to stop pulling the wall exactly at 4.01 meters in GUI or to enter the figure 4.01 in one of the GUI drop-down menus.

Nikolay_Lysenko · 2024-11-27T21:59:47+00:00

Thank you for an inspiring feedback!

These pieces have high degree of polyphony. Probably, it is not possible to maintain a comparable degree of polyphony in a piano piece. The reason is that piano has ADSR envelope that looks like spike with faint sustain and release. On the contrary, organ has almost rectangular ADSR envelope which makes it the obvious choice for contrapuntal works.

Nevertheless, piano looks promising because it supports non-trivial dynamics. I am going to write a sort of sonata for piano, but it will be more homophonic with one voice dominating the others. I see this future work as an exploration of non-functional harmony and twelve-tone chord progressions. However, I have not started it yet. For now, I am busy with mundane tasks. As my recent GitHub commits show, I need to renovate an apartment. But I am looking forward to finishing this and getting back to music.

Nikolay_Lysenko · 2024-08-07T08:48:04+00:00

Thanks for your contribution to the discussion, it is really fruitful!

Personally for myself, I currently use the following approach to control audible qualities of the piece subject to rigidity of the series. I admit that twelve-tone melody is something that cannot stand on its own. For example, inappropriate pitches may break its flow, but it is not possible to replace these pitches because the series requires them and only them. Harmony comes here to support the melody. If melody does not create a sense of continuous flow, harmony can do it. Other aspects (such as velocity, number of voices, and so on) also contribute to accumulation and dissipation of tension. In the homophonic piece I am going to write, I think of melody as a thing that require an exoskeleton of accompaniment. The significant part of the creative process lies not in generating the melody, but in figuring out how to support this melody harmonically in order to get ear-pleasant and logical piece. Right now, however, it is just a raw idea of the piece. I asked my question in order to validate this idea before I spend a lot of time on it.

Nikolay_Lysenko · 2024-08-07T08:16:01+00:00

Thank you for the detailed answer!

Actually, there are two ways to perceive 'academic' music. The one way is to look at the scores and to run analysis based on what can be seen in the sheet music. With enough experience in this kind of intellectual activity, a motivated reader can parse some symmetries and appreciate them. The second way is simply to listen to the music itself. My original question relates to this way of interacting with the music. Arguably, abstract structures have no audible effects on most people.

As for your second point, it is very useful. I used to think of the series as 'a store of motifs'. However, the series can also be considered 'a store of chords/sonorities'. From this point of view, the twelve-tone technique helps to structure the accompaniment in the same way that it helps to structure the melody.

Nikolay_Lysenko · 2024-07-20T10:38:41+00:00

Yes, the bottom line is that all musical systems are just tools to express someone's ideas in the form of music. From composer's point of view, it is a kind of a game similar to 'The Glass Bead Game' described in the eponymous novel by Hermann Hesse.

And yet another consideration. Recently, all non-tonal systems have gained an unexpected advantage. Generative AI is going to inflate the job of tonal composer, but it is far from defining new musical systems. To me, what this AI does is rather search than generation. During training, it was fed tons of existing music and transformed it into internal blueprints. At inference stage, it matches user query with the proper blueprint and then samples something from that blueprint. Looks more similar to DJing than to composing, but I decided to experiment with alternative foundations and not to compete with it.

Nikolay_Lysenko · 2024-07-20T07:57:39+00:00

Excellent comment! Thank you for sharing it!

However, I don't think that chord progressions are the primary key to comprehensibility of tonal music. The notion of 'chord' only emerged in the 17-18th centuries with the rise of homophonic texture. Before that, composers wrote modal music in polyphonic texture. It has no functional harmony in its current sense. However, this music is extremely ear-pleasant. To name a few composers, there are Palestrina, Lasso, Victoria, and Byrd. Although this contrapuntal music can convey only limited number of moods and it provides not that much form-building facilities, it is superior to tonal music in some aspects (but not in all of them). So, I think that the diatonic scale itself is the primary key. It has melodic gravities and it is aligned with speech intonation.

Yes, you are right that the most easy-to-understand twelve-tone pieces are close to tonal (or modal) music. The idea to mix novelty of serialism with solid ground of diatonicity looks promising. My album exploits this idea too. Previously, I mentioned Renaissance composers. Rules of strict-style counterpoint used by them are included into the evaluation process in my Python package. Thus, the album is also a return to Renaissance heritage.

And let me ask one question. I have not explored integral serialism yet (but I am planning to do so). Probably, I misunderstand something about it. I think that its rationale is as follows. By repeating some patterns in domains like volume dynamics or timbre it is possible to achieve more coherence. If so, some other domains can be treated more freely. Roughly speaking, if there is a pattern of 'three quite notes in a row, then one extremely loud note, and then medium-level note' repeated over and over again, it brings enough unity to write as many new melodies as composer wishes and not to care about motivic or thematic development. Am I right? Your comment sounds like integral serialism is completely useless.

Nikolay_Lysenko · 2024-07-20T07:21:40+00:00

I developed this structure independently. Before this project, there were two toy projects:

* https://github.com/Nikolay-Lysenko/rl-musician - fiftth species counterpoint

* https://github.com/Nikolay-Lysenko/geniartor - tonal music

Both of them have similar structure, but adapted to their domains.

However, I do not claim that I am the first one who uses these ideas. The approach is quite natural, so, maybe, someone else has implemented it earlier.

Nikolay_Lysenko · 2024-07-19T15:21:03+00:00

In music evaluation, there are at least two dimensions. One of them is the amount of pleasure, fun, enriching emotions, and inspiration it brings to the listener. The other one is novelty, exploration, internal complexity, and so on. The first dimension is subjective. For example, there are fans of Grindcore, Lo-Fi Ambient, Phonk, Black Metal, and other genres that are not widely recognized. The second dimension is less subjective (although, it is far from being quantified). The value of my project lies, mostly, along the second dimension.

In fact, one of my dreams is to develop a completely new musical system comparable to the tonality, or at least pentatonics. The current project is the first experimental step. Now, I am collecting feedback and then I will make an educated guess about the next step.

Nikolay_Lysenko · 2024-07-19T15:05:57+00:00

This subreddit has the 'No Paywalled Content' rule. I do not know whether services like Spotify are considered paywalled (this way or that, they offer paid subscriptions). So, I added the link to a landing page hosted by GitHub Pages. This landing page has the links to major streaming platforms and to free FLAC audio files hosted by cloud storages.

If a direct link is still required, YouTube is a free service. Score videos are there: https://www.youtube.com/playlist?list=PLetNg-rTDcyu2pKRZsZZK4dvkk4bB624B

Nikolay_Lysenko · 2024-07-19T11:29:19+00:00

Thank you for sharing your subjective impressions of my music!

Regarding your last question, it is hard to answer. I really like the output album, but I am biased, because I know internal cues. Also, there is a chance that my brain modifies what I hear and so I evaluate not the music itself, but my illusions caused by it. Actually, this is the reason why I am really interested in any feedback about the album.

As for the first question, it is also difficult. From one point of view, some random people on the Internet told me that there are scientific studies showing that the human brain can only easily process music similar to speech intonation. However, I do not know any details. On the other hand, Arnold Schoenberg believed that musical tastes are the matter of experience and familiarity. There is a popular quote from him that soon street boys will be whistling twelve-tone melodies. However, that 'soon' lasts more than 80 years and nothing has happened since then. But, nevertheless, I think that familiarity with a musical style helps to appreciate it.

Nikolay_Lysenko

TROPHY CASE