X-Git-Url: https://git.kaliko.me/?a=blobdiff_plain;f=data%2Fman%2Fsimadb_cli.1.xml;fp=data%2Fman%2Fsimadb_cli.1.xml;h=6bab00402194cb068e2b9746a8fd5d3dbd9bb17d;hb=d906b7f06726d9dd34ac9a6873bdf8fe683059d4;hp=5448f862d17fa8f41adff99f1533f3e0f0e8be3f;hpb=9b222e0c1e8d21c04da83da597da92eff271e1e5;p=mpd-sima.git diff --git a/data/man/simadb_cli.1.xml b/data/man/simadb_cli.1.xml index 5448f86..6bab004 100644 --- a/data/man/simadb_cli.1.xml +++ b/data/man/simadb_cli.1.xml @@ -60,25 +60,6 @@ man(1), man(7), http://www.tldp.org/HOWTO/Man-Page/ &dhutils; is a command line interface editor for the sima user DB. - - &dhutils; - similarity_string - - - - - db_file - - - - - - mpd_host - - - mpd_port - - &dhutils; artist @@ -89,16 +70,6 @@ man(1), man(7), http://www.tldp.org/HOWTO/Man-Page/ - - &dhutils; - "main artist,similar artist" - - db_file - - - - - &dhutils; @@ -106,13 +77,6 @@ man(1), man(7), http://www.tldp.org/HOWTO/Man-Page/ db_file - - &dhutils; - - - db_file - - &dhutils; @@ -172,33 +136,12 @@ man(1), man(7), http://www.tldp.org/HOWTO/Man-Page/ This manual page documents briefly the &dhutils; commands. simadb_cli is a command line interface to get and edit users - similarities and blacklist database used with MPD_sima. The default + blacklist database used with MPD_sima. The default database file (see ) can be overridden if you want. - Consider reading to understand the - structure and relation of similarities within the database. EXAMPLE - - Similarity edition - Here follows some simple examples on how to deal with similarity database. - Pay attention, the following examples set one-way similarities in the DB! Read more about it in . - Adding a similarity between two artists. In the following example "Pelican" will point - to "Russian Circles" with a match score of 88% (ie. "Russian Circles" - 88% similar to Pelican, not reciprocal), it will also check against MPD - the presence of both artists in the music library. - &dhutils; --add "Pelican,Russian Circles:80" --check_names - Similarity string use comma "," as artists separator and semi colon ":" for - artist/similarity score separator, cf. . - Adding a similarity between multiple artists. In the following example "Rage - Against The Machine" will point to "Tool" and "Audioslave" as similar - artists and controls artists names are actually in MPD music library. - &dhutils; --add "Rage Against The Machine,Tool:70,Audiosalve:80" --check_names - Viewing similarit(y|ies) for an artist. In the - following example we are looking for entries for "Rage Against The Machine" - &dhutils; --view_artist "Rage Against The Machine" - Black list edition Adding to black list. You can add a single @@ -242,20 +185,6 @@ man(1), man(7), http://www.tldp.org/HOWTO/Man-Page/ Print version and exit. - - - - - Add similarity to the database.For more details about the similarity_string see . - - - - - - - Use with in order to check artists names used in similarity_string. &dhutils; will control presence of artists names in MPD library. Default is to look for MPD server on localhost:6600 or environment variables MPD_HOST and MPD_PORT if set.You can as well give &dhutils; host/port on the command line using respectively and . - - @@ -282,53 +211,18 @@ man(1), man(7), http://www.tldp.org/HOWTO/Man-Page/ Purge history, you may supply an alternative DB file with --dbfile option. - - - - - Use with an editing options in order to edit reciprocal similarity as well. and are supporting reciprocal edition. - N.B: this option has to appear after the editing option on the command line. - See for further information about reciprocity notion. - - - - - - Use to remove an artist entry (as main artist) with its associated similarities. To remove artist where it appears as a similar artist use the option. - - Use to remove a black list entry. To get the row_id to suppress use option. - - - - Use to remove a single similarity between a main artist and an associated similarity. Give the main artist first, use comma (",") to separate it from similar artist.Use of is possible here, see . - This option is useful in case you want to remove only a specific similarity between two artists, to remove completely an artist use instead. - - - - - - - Get entries for "artist name" in the data base (print to stdout). - - Get all entries in the black list. - - - - Get all entries in the data base (print to stdout). - - @@ -356,54 +250,6 @@ man(1), man(7), http://www.tldp.org/HOWTO/Man-Page/ - - SIMILARITY FORMAT - The similarity_string has to be formatted following a special pattern in order for simadb_cli to extract similarity relations between artists names. Usually a similarity entry is defined as a main artist, lets say main_art, followed by a list of similar artists which you want to be related to that main_art, each artist of that list with a specific similarity value, a match score, quantifying the similarity relation with the main_art. The match score value is an integer in [0 ,100] with 100 corresponding to a perfect match. - similarity_string is then to be formatted as follow: - main_art,first artist:<score>,second artist:<score> - Each artist group are separated with commas (",") and inside each group the artist name and the match score is colon (":") separated. Obviously the first artist group, as the main artist, does not have a match score. - Lets see how it works with an example. I consider "Led Zeppelin" to be similar to "Tool" with a match score of 25, I also want to have "Audioslave" related to "Led Zeppelin" with a score of 20. Then the similarity_string will be the following: - Led Zeppelin,Tool:25,Audiosalve:20 - See for more details about how similarities are handled - - - A WORD ABOUT SIMA DATA BASE - The similarity database is defined from the point of view of a main artist which is declared related to a list of similar artists. That means when you define main_art to be similar to sim_art A and sim_art B the reciprocal won't be true, sim_art A and sim_art B are not similar to main_art. At least this is the default behavior when you edit entries with simadb_cli, this is also the way last.fm is working concerning similar artists. This documentation is using that particular terminology to specify which kind of artist we are dealing with : "main artist" or "similar artist".The option allows one to add reciprocal relation where sim_art A and sim_art B become respectively the main_art. Using you will then edit two more entries in the database. To summarize here is what you'll end up with in your data base adding similarity with this string main_art,sim_art A:34,sim_art B:45. - simadb_cli --reciprocal --add_similarity=main_art,sim_art A:34,sim_art B:45 - main_art similar to sim_art A:34 and sim_art B:45sim_art A similar to main_art:34sim_art B similar to main_art:45 - Without the reciprocal option you would have add only the first similarity. Usually using the reciprocal option is the desired behavior, at least what users have in mind when thinking of similarity relation between to artists but keep in mind that it may lead to have MPD_sima more sensible to loop over the same two artist (ASSERTION TO BE CONFIRMED). - -