Song Sheet:
The PlenioSongSheet node serves as a central hub for managing and editing the documents that condition the music model within the Plenio Music Production System. It provides a user-friendly interface to inspect, edit, or replace these documents, ensuring that manual text inputs take precedence over automated drafts. This node is particularly beneficial for maintaining consistency and control over the creative process, as it prevents conflicts by halting execution if an edited draft changes unexpectedly. The node is designed to facilitate a seamless workflow where each song in a series can have its unique draft, while ensuring that any modifications are preserved and carried forward to the music model without alteration. This makes it an essential tool for artists looking to fine-tune their musical compositions with precision and clarity.
Song Sheet Input Parameters:
context_style
This parameter allows you to input a style draft that is owned by another sheet. It is used to influence the token budget for the music model, providing a stylistic context that can guide the composition process. There are no specific minimum, maximum, or default values, as it is dependent on the user's input.
context_lyrics
The context_lyrics parameter is used to input lyrics that are owned by another sheet. This input is crucial for managing the token budget and ensuring that the lyrical content aligns with the musical sections. Like context_style, it does not have predefined values and relies on user input.
context_score
This parameter accepts a score draft from another sheet, which is used to manage the token budget and verify the alignment of lyrical sections with the musical score. It is essential for maintaining the structural integrity of the composition. There are no specific constraints on values, as it is user-defined.
timeline
The timeline input provides bar and section times from the source score, which are displayed in the editor. This helps in visualizing the structure and timing of the composition, aiding in precise editing and arrangement. It is optional and does not have predefined values.
reference_audio
This parameter allows you to input a reference audio file from which the score was transcribed. It is used for playback in the editor, enabling A/B comparison with the notes. The reference audio is for display purposes only and does not affect the model directly. It is optional and user-provided.
Song Sheet Output Parameters:
arrangement
The arrangement output provides information on what changes the creative mode made to the score or why the score remained as planned. This output is shown in the editor and is crucial for understanding the impact of creative decisions on the final composition.
song_form
This output details how the planned score was adjusted to fit the lyrics' song form. It is essential for ensuring that the musical sections align with the lyrical content, and it is kept in the release record for reference. This output helps in maintaining consistency and coherence in the composition.
Song Sheet Usage Tips:
- Regularly update and review the drafts in the Song Sheet to ensure that your manual edits are preserved and accurately reflected in the music model.
- Utilize the reference audio feature to compare your transcribed score with the original recording, ensuring that your composition stays true to the intended sound.
Song Sheet Common Errors and Solutions:
PlenioConflictError
- Explanation: This error occurs when there is a conflict between the edited draft and the current run, indicating that the draft has changed unexpectedly.
- Solution: Review the changes made to the draft and ensure that they are intentional. Resolve any discrepancies before proceeding with the run.
PlenioValidationError
- Explanation: This error indicates that there is an issue with the validation of the input parameters or the draft content.
- Solution: Check all input parameters for correctness and ensure that the draft content adheres to the expected format and guidelines. Make necessary corrections and try again.