data

type Artist ¶

type Artist struct {
	SpotifyID  string
	ImageURL   string
	Name       string
	Followers  int64
	Popularity int64
	Genres     []string `gorm:"-"`
}

Artists holds the artists we've found using Spotify's search API. We try to fetch the thousand first artists returned by a search for each genre.

Artists have many genres via the association table artist_genres.

Artists also have an rtree representing their bounds in genre-space. The 'id' column in artists_rtree references the automatically-generated 'rowid' column in artists.

type ArtistGenre ¶

type ArtistGenre struct {
	ArtistSpotifyID string
	GenreName       string
}

ArtistGenres represent a many-to-many relationship between artists and genres.

type ArtistRtree ¶

type ArtistRtree struct {
	ID int64

	MinEnergy, MaxEnergy                     int64
	MinDynamicVariation, MaxDynamicVariation int64
	MinInstrumentalness, MaxInstrumentalness int64
	MinOrganicness, MaxOrganicness           int64
	MinBounciness, MaxBounciness             int64
}

artists_rtree stores the bounds of each artist within 5-dimensional genre space, and can be used for geospatial-style range queries.

For each artist, spotify gives us a list of genres. We can imagine finding all of those genres on the everynoise website and drawing a bounding box around them. Then, we can point to a spot on the visualization and query for the artists whose boxes contain that point.

But actually: the visualization has more than two dimensions. In addition to x and y position, each genre has a color, and the three channels of that color (RGB) represent additional data.

type Genre ¶

type Genre struct {
	// like "pop"
	Name string

	// like "3nzVSyaYk0KNrahyNQS0Ur"
	Key string

	// like "https://p.scdn.co/mp3-preview/8d9a195ffd681f1e359219b39474b98d820c53c5"
	PreviewURL string

	// Like `Budapest Chorus "Let the Light Shine on Me"`
	//
	// We can't safely parse this into artist/track, because quote marks
	// -within- artist and track names are not guaranteed to be matched
	// properly.
	Example string

	// A value in the range [0, 4096], derived from the ENAO visualization.
	Energy, DynamicVariation, Instrumentalness int64

	// A value in the range [0, 4096], derived from the ENAO visualization.
	Organicness, Bounciness, Popularity int64
}

Genres holds the list of genres extracted from everynoise.com.

Genres have many artists via the association table artist_genres.