Content:File relations: Difference between revisions

Latest revision as of 21:06, 14 May 2023

Overview

File relations, like the name implies, are relations between files on AniDB. There are two types of file relations; File-File and File-Ep. The former tells how two different files relate and the later tells how a file relates to different episodes.

File-Ep Relations

Imagine yourself with a file that spans two, or more, episodes. Until the introduction of file relations the only way to add this file to AniDB was to create a special episode that would hold your file. Now, for those kinds of files you can add file-ep relations.

How to create a File-Ep relation

To create a file relation between a file and an episode you just need to follow these steps.

Add the file to the first episode it belongs
Open the file information page for your file, by clicking in it's fid
Click on "new episode relation" on the lower part of the page
On the Add File-Ep Relation page fill the percentage of the given episode the file covers and select the episode
Press "Add" and you are done.

Percentage ranges for file-ep relations

File-episode relations follow the rules of number lines for all integer numbers in the inclusive range [0,100]. In simpler terms, ranges should be directly connected. Examples:

 2 file release, each covering 1/2 of the episode:
 [0,50] --> 0% to 50% for part 1
 [50,100] --> 50% to 100% for part 2

 3 file release, each covering 1/3 of the episode:
 [0,33] --> 0% to 33% for part 1
 [33,67] --> 33% to 67% for part 2
 [67,100] --> 67% to 100% for part 3

 4 file release, each covering 1/4 of the episode:
 [0,25] --> 0% to 25% for part 1
 [25,50] --> 25% to 50% for part 2
 [50,75] --> 50% to 75% for part 3
 [75,100] --> 75% to 100% for part 4

Explanation of number lines when used for AniDB episode ranges

Correct: Ranges cover the entire number line when they are directly connected, as is the case with [0,25], [25,50], [50,75], and [75,100]; there are no gaps in the number line.

Incorrect: If the ranges are not directly connected, as in the case with [0,25], [26,50], [51,75], and [76,100], the values in the range (25,26) (e.g. 25.00000000001 to 25.99999999999), (50,51), and (75,76) would be incorrectly excluded.

File-File Relations

Often you find yourself with files that are meant be together, for example you have a subtitle file for a video file. Until the introduction of file-relations the only way you had to show this connection was to add a file comment. Users would then have to open the file information page to be able to read your comment. Currently the new system allows you a greater degree of file relation possibilities.

Types of file relations

Currently there are the following possible file relations:

external-sub-for; to relate a subtitle file to its respective video file.
newer-ver-of; to indicate that there's a newer version of a given file (kind of like the current versioning system).
bundle; to indicate that a group of two, or more, files are related, and normally, needed in group. Deprecated
op/end-for; indicates that a given video file is an opening or ending to another video file.
external-audio-for ; to relate an audio file to it's respective video file.
uses material from; to relate a reencoded, remuxed, or other compiled file, to original source files. For example, if a remuxed file uses subs from file X and video from file Y, link the remuxed file to files X and Y.
chapter-linker for; to relate "play-all" files to the associated video files.
other; covers file relations that don't fit the other categories.

Rules

These are the rules for using file relations:

external-sub-for; can only be used to relate a subtitle file to a video file (as in, you need to select the subtitle file and add a file relation to the video file from within the subtitle file page).
newer-ver-of; can only be used to relate files of the same type (video-video), that are from the same episode and from the same, or related, groups.
bundle; this kind of relation could be used, for example, to relate an idx to a srt file.
op/end-for; can only be used to relate video files that belong to a Opening/Ending/Credits or an Other Episode to video files that belong on a Normal or Special Episode
external-audio-for; can only be used to relate a audio file to a video file (as in, you need to select the audio file and add a file relation to the video file from within the audio file page).
uses material from; can link most filetypes together.
chapter-linker for; can link most filetypes together. Example: "Suzumiya Haruhi no Yuuutsu" chapter linker by [Hitsuji]
other; this one covers every other cases. Though if in doubt it's best to ask in IRC or in forum.

Note	You can not relate generic files, create a relation between the same file or link files from different anime.

How to create a File-File relation

To create a file relation between two files you just need to follow these steps.

If you haven't so, add both files
Open the file information page for the file that is related to the other file (for a external-sub-for you go to the subtitle file page)
Click on new file relation on the lower part of the page
On the Add File-File Relation page select the type of relation and the related file
Press Add and you are done

@@ Line 1: / Line 1: @@
 {{TOCright}}
+==Overview==
 File relations, like the name implies, are relations between files on AniDB. There are two types of file relations; [[#File-File Relations|File-File]] and [[#File-Ep Relations|File-Ep]].
 The former tells how two different files relate and the later tells how a file relates to different episodes.
@@ Line 17: / Line 18: @@
 === Percentage ranges for file-ep relations ===
-File-episode relations follow the rules of [https://en.wikipedia.org/wiki/Number_line number lines] for all [https://en.wikipedia.org/wiki/Integer integer numbers] in the inclusive range <code>[0,100]</code>. In simpler terms, ranges should overlap. Examples:
+File-episode relations follow the rules of [https://en.wikipedia.org/wiki/Number_line number lines] for all [https://en.wikipedia.org/wiki/Integer integer numbers] in the inclusive range <code>[0,100]</code>. In simpler terms, ranges should be directly connected. Examples:
 file release, each covering 1/2 of the episode:
    [0,50] --> 0% to 50% for part 1
@@ Line 32: / Line 33: @@
    [50,75] --> 50% to 75% for part 3
    [75,100] --> 75% to 100% for part 4
+==== Explanation of number lines when used for AniDB episode ranges ====
 [[File:Number line 4 inclusive.png|border]]<br>
-Ranges cover the entire number line when they overlap, as is the case with <code>[0,25]</code>, <code>[25,50]</code>, <code>[50,75]</code>, and <code>[75,100]</code>.
+'''Correct:''' Ranges cover the entire number line when they are directly connected, as is the case with <code>[0,25]</code>, <code>[25,50]</code>, <code>[50,75]</code>, and <code>[75,100]</code>; there are no gaps in the number line.<br><br>
 [[File:Number line 4 exclusive.png|border]]<br>
-If the ranges does not overlap, as in the case with <code>[0,25]</code>, <code>[26,50]</code>, <code>[51,75]</code>, and <code>[76,100]</code>, the values in the range <code>(25,26)</code> (e.g. 25.00000000001 to 25.99999999999), <code>(50,51)</code>, and <code>(75,76)</code> would be incorrectly excluded.
+'''Incorrect:''' If the ranges are not directly connected, as in the case with <code>[0,25]</code>, <code>[26,50]</code>, <code>[51,75]</code>, and <code>[76,100]</code>, the values in the range <code>(25,26)</code> (e.g. 25.00000000001 to 25.99999999999), <code>(50,51)</code>, and <code>(75,76)</code> would be incorrectly excluded.
 ==File-File Relations==