/kent-notasyonu

Primary LanguageJavaScriptMIT LicenseMIT

Kent Notasyonu (City Notation)

Kent Notasyonu is a web-based application that transforms urban textures into musical compositions. Inspired by the work of Delfin Gunay Ercan, this project aims to provide a unique auditory perspective on urban morphology.

Description

This application analyzes urban textures, particularly focusing on road networks and intersections, and converts them into musical notations. By doing so, it offers a novel way to perceive and understand city structures through sound.

Features

  • Interactive map interface for selecting urban areas
  • Analysis of road networks and intersections
  • Conversion of urban textures to musical notations
  • Playback of generated music
  • Visualization of the notation process

Installation

To set up the project locally, follow these steps:

  1. Clone the repository: 
    git clone https://github.com/cansakirt/kent-notasyonu.git
  2. Navigate to the project directory: 
    cd kent-notasyonu
  3. Open index.html in a web browser.

Note: This project uses client-side JavaScript and doesn't require a server to run. However, due to CORS restrictions, you may need to use a local server to load some resources properly.

Usage

  1. Open the application in a web browser.
  2. Use the map interface to select a neighborhood or urban area.
  3. Adjust the music parameters as desired.
  4. Click the "Play" button to listen to the generated music based on the selected urban texture.

Technologies Used

  • HTML5
  • CSS3 (with Tailwind CSS)
  • JavaScript (ES6+)
  • Leaflet.js for mapping
  • Tone.js for sound generation
  • Proj4.js for coordinate transformations
  • Turf.js for geospatial analysis

Contributing

Contributions to Kent Notasyonu are welcome! Please follow these steps to contribute:

  1. Fork the repository
  2. Create a new branch (git checkout -b feature/AmazingFeature)
  3. Commit your changes (git commit -m 'Add some AmazingFeature')
  4. Push to the branch (git push origin feature/AmazingFeature)
  5. Open a Pull Request

License

This project is licensed under the MIT License - see the LICENSE.md file for details.

Acknowledgments

  • Delfin Gunay Ercan for the original concept of "Kent Notasyonu" (City Notation)
  • OpenStreetMap contributors for map data
  • All contributors and open-source libraries used in this project

Contact

Can Sakirt

Project Link: https://github.com/cansakirt/kent-notasyonu