pyIRDG docprinter.py output

------
Genres
------
The genres of this title. A title can have multiple genres.

1147102 genre entries exist.
All the possible genres: (genre, amount of titles with that genre)
'Short', '254109'
'Drama', '186314'
'Comedy', '142932'
'Documentary', '119752'
'Adult', '51607'
'Romance', '37497'
'Action', '35860'
'Animation', '34242'
'Thriller', '30568'
'Family', '29525'
'Crime', '28163'
'Adventure', '23364'
'Music', '22741'
'Horror', '21285'
'Fantasy', '16636'
'Mystery', '14599'
'Sci-Fi', '14033'
'Western', '12286'
'Musical', '12135'
'Biography', '10551'
'Sport', '10466'
'War', '9843'
'History', '9543'
'Reality-TV', '6266'
'Talk-Show', '4546'
'News', '4160'
'Game-Show', '3592'
'Film-Noir', '486'

genre(t101034, 'Crime').
genre(t101034, 'Drama').
genre(t101034, 'Thriller').

--------
BirthDay
--------
The day of the month of birth of the Person.

birth_day(p100116, 20).
birth_day(p1001358, 21).
birth_day(p1002308, 31)
------------
Certificates
------------
The certificates of this title.
418839 entries in the database.

certificate(t100441, 'Australia', 'M').
certificate(t100441, 'Finland', 'K-16').
certificate(t100441, 'Italy', 'VM14').
certificate(t100441, 'Sweden', '15').
certificate(t100441, 'UK', '15').
certificate(t100441, 'UK', 'X').
certificate(t100441, 'USA', 'R').
certificate(t100441, 'West Germany', '18').

Format in database:
u'UK:15::(re-rating) (2006) (uncut)',
u'Philippines:PG-13',
u'France:U::(with warning)',
u'Belgium:KT',
-----------------
FirstMarriageYear
-----------------
Year of this persons first marriage.

first_marriage_year(p1000776, 1992).
first_marriage_year(p1001122, 1943).
first_marriage_year(p1001156, 1989).

-----------------
AlternateVersions
-----------------
The amount of alternate versions. 16936 entries total.
An integer.

A list of strings in the db:
[u'The FOX televised version omits the "There is no spoon" scene...',
u"In the DVD version that was released in Israel, you don't see ...",...]

alternate_version_amount(t101034, 1).
alternate_version_amount(t10201, 5).

---------
Countries
---------
The countries where this title was produced.
220 different countries.

country(t245377, 'Czech Republic').
country(t245377, 'France').
country(t245377, 'Italy').
country(t245377, 'UK').

964469 countries in the whole database.
Multiple possible countries for a movie.
'countries': [u'USA', u'Australia'],

The 50 most encountered countries shown in list:
"USA";395968
"UK";90067
"France";51369
"Germany";37668
"Canada";34390
"Japan";33543
"Italy";29873
"India";24930
"Spain";22178
"Mexico";19958
"Australia";18368
"Argentina";14884
"West Germany";14680
"Brazil";11897
"Denmark";9746
"Greece";8634
"Netherlands";8463
"Belgium";8363
"Portugal";8302
"Philippines";7819
"Finland";7697
"Soviet Union";7398
"Hong Kong";7302
"Sweden";7114
"Yugoslavia";6898
"Austria";6499
"Turkey";6484
"Hungary";5196
"Poland";4929
"South Korea";4863
"Switzerland";4093
"Czechoslovakia";3905
"Russia";3347
"Nigeria";3257
"East Germany";3249
"Israel";2972
"Norway";2955
"China";2711
"Ireland";2697
"Czech Republic";2652
"Romania";2161
"Egypt";2062
"Taiwan";2038
"Iran";1912
"Bulgaria";1838
"New Zealand";1833
"Chile";1610
"Cuba";1555
"Indonesia";1352
"Croatia";1248

----------
BirthState
----------
State/province of birth.

state_of_birth(p1006640, 'British Columbia').
state_of_birth(p1006666, 'Ontario').
state_of_birth(p1007023, 'New York').

------
Rating
------
The rating this title got from the IMDb users.
Movies have been rated on a scale from 1 to 10,
10 being good and 1 being bad.

358612 titles with a rating.

rating(t101367, 7.30).
rating(t101370, 7.50).
---------
BirthName
---------
The name given at birth. 114156 entries.
--------------
CompanyCountry
--------------
Saved IMDbPY string looks like '[us]'. The square brackets are
removed for the output.

company_country(co1, 'us').
company_country(co10, 'us').
company_country(co100, 'au').
company_country(co1000, 'us').
company_country(co10001, 'gb').
-----------
AspectRatio
-----------
RAT   Aspect Ratio, width to height (_.__ : 1)

aspect_ratio(t10201, '1.37 : 1', '(negative ratio)').
aspect_ratio(t10201, '1.66 : 1', '(intended ratio)').
aspect_ratio(t103127, '1.37 : 1', '').
aspect_ratio(t103127, '1.85 : 1', '(theatrical ratio)').

'RAT', '295984'
------
Height
------
The height of the person in centimeters.
110257 people have this attribute.
The output is a number, excpressed in centimeters.

height(p1006220, 180).
height(p1006640, 188).
height(p1007023, 183).

The stored data is like this:
"6' 0 1/2""
"5' 2""
"168 cm"
"5' 5 1/2""
"193.5 cm"
"5'1"
"6'"
inches and centimeters are both used.
---------
DeathCity
---------
City of death.
------------
WeekendGross
------------
Gross income of a given weekend.
94816 entries in the database.

weekend_gross(t625127, 491184, '$', 'USA', 23, december, 2007, 32).
weekend_gross(t625127, 50926, '$', 'USA', 7, january, 2007, '').

'$1,194 (USA) (13 February 2011) (1 screen)'
'$66 (USA) (6 February 2011) (1 screen)'
u'$1,011,566 (USA) (27 June 1999) (1,139 screens)'

gross
country
date opening weekend
number of screens in opening weekend
------
Budget
------
The budget of the movie.
80764 entries in the database.
Multiple budgets are possible.

budget(t102248, 30000000, '$').
budget(t102812, 30000, '$').
budget(t103003, 6349, '$').

'AUD 1,000'
'$1,000'
'£180'
'FFR 50,000'
---------
BirthYear
---------
The Birth year of the Person.
324041 people have a birth date.

birth_year(p1001122, 1922).
birth_year(p1001156, 1947).
birth_year(p100116, 1945).

Irregular dates will be ignored:
"18??"
"15 June 19??"
"3 October ????
-----------
FilmingDays
-----------
Amount of days of filming the movie.
See ProductionDays.

filmingdays(t101034, 118).
filmingdays(t10201, 182).
filmingdays(t102248, 120).

28760 entries in the database.
---------
TitleKind
---------
The kind of title is one of the following:
'movie',
'tv series',
'tv movie',
'video movie',
'tv mini series',
'video game',
'episode'

type(t100526, 'movie').
type(t101028, 'video movie').

The attribute is available for each title.
---------
BirthCity
---------
City of birth.

city_of_birth(p1001156, 'The Bronx').
city_of_birth(p100116, 'New York City').
city_of_birth(p1001358, 'Wilmington').
city_of_birth(p1002308, 'Boston').

----------
Laboratory
----------
LAB   Laboratory (Syntax: Laboratory name, Location, Country)

laboratory(t102812, 'General Labs, California, USA', '').
laboratory(t103078, 'DeLuxe', '').
laboratory(t103816, 'Technicolor, USA', '(color)').
laboratory(t103832, 'Technicolor', '').

'LAB', '36209'
-------------
SeriesEndYear
-------------
The end year of the series. No end year if still running.
71507 titles have this value.
The result is a number.

Some data examples from the db:
"1965-1966,1969-1970"
"2004-????"
"1997"
"1964-1967"

Nothing if end year is "????".

-----
Votes
-----
The amount of votes for this title.

Value only available if the title has more than 5 votes.
358612 titles with a vote amount.

votes(t98638, 8).
votes(t98941, 122).
-------------
CharacterName
-------------
Name of the character. (Often 'Himself').

character_name(id, 'name').
---------
Languages
---------
The language(s) used for a title.
912304 language entries.
334 different languages.

25 most used languages are shown:
"English";535688
"Spanish";57227
"German";51336
"French";47034
"Japanese";31566
"Italian";26071
"Portuguese";17769
"Dutch";10367
"Russian";9625
"Hindi";9212
"Greek";8420
"Danish";7920
"Filipino";7059
"Tagalog";6828
"Serbo-Croatian";6810
"Finnish";6656
"Turkish";6618
"Mandarin";6225
"Swedish";5887
"Czech";5030
"Cantonese";4957
"Korean";4908
"Polish";4609
"Hungarian";4243
"Arabic";3737

language(t101370, 'English').
language(t101370, 'French').
language(t101370, 'Spanish').

---------
ColorInfo
---------
The color of the movie. Can have multiple values.
913715 titles have this info.

There are two possible values:
"Color";683600
"Black and White";249669

Sometimes some extra info is added:
"Color";"";635982
"Black and White";"";246964
"Color";"(Technicolor)";12771
"Color";"(Eastmancolor)";11335
"Color";"(HD)";3985
"Color";"(NTSC Color)";3030
"Color";"(MiniDV)";1809
"Color";"(Metrocolor)";1332
"Color";"(Fujicolor)";1151
"Color";"(HDCAM)";1107
"Color";"(PAL)";951
"Color";"(35 mm version)";772
"Color";"(High Definition)";667
"Black and White";"(archive footage)";600
"Color";"(16 mm version)";546

color_info(t481744, blackandwhite, '').
color_info(t481744, color, '(Eastmancolor)').

----------
DeathMonth
----------
The month of death of the Person. See death_year.
---------
DeathYear
---------
The year of death of the Person. See birth_year.
96828 people have a death date.
--------
SoundMix
--------
89 records different records, but usually just Mono or Stereo

sound_mix(id, 'Mono', '(RCA Sound System)').
sound_mix(id, 'Silent', '').
sound_mix(id, 'Dolby Digital', '').

385541 entries in the database.

'70 mm 6-Track'
'Afifa Ton-Kopie'
'AGA Sound System'
'Animatophone'
'Mono::(Western Electric Sound System) (A Victor Recording)'
'Mono::(Westrex Recording System)'

-----------
CameraModel
-----------
CAM   Camera model and Lens information

camera_model(t239210, 'Panavision Cameras and Lenses', '(segment "Death Proof")').
camera_model(t239210, 'Panavision Genesis HD Camera', '').

'CAM', '29801'

1114008 Tech entries in the database.
(CAM, MET, OFM, PFM, RAT, PCS, LAB)
-----------------
VotesDistribution
-----------------
The vote distribution uses a single character to represent
the percentage of votes for each ranking.
The following characters codes can appear:

"." no votes cast
"0"  1-9%  of the votes
"1" 10-19% of the votes
"2" 20-29% of the votes
"3" 30-39% of the votes
"4" 40-49% of the votes
"5" 50-59% of the votes
"6" 60-69% of the votes
"7" 70-79% of the votes
"8" 80-89% of the votes
"9" 90-99% of the votes
"*" 100%   of the votes

358612 titles with a vote distribution.

votes_distribution(t100441, '0', '0', '0', '1', '1', '1', '1', '0', '0', '1').
votes_distribution(t641145, '6', '0', '0', '0', '0', '0', '0', '0', '0', '1').

-----------
CompanyName
-----------
The name of the company.
Available for each entity.

company_name(co1, 'E! Entertainment Television').
company_name(co10, 'National Broadcasting Company (NBC)').
company_name(co100, 'Nine Network Australia').
company_name(co1000, 'Passport Video').
company_name(co10001, 'Ideal').
----------
PersonName
----------
The name of the person.
--------
Keywords
--------
General keywords associated with a title.

keywords(t100441, 'acid-trip').
keywords(t100441, 'actor-playing-multiple-roles').
--------
Children
--------
The amount of children if the couple has children.
The zero value (probably) won't be used here.

104259 spouse records exist, but even less with children.
Range constraint for the amount of children is for the children
of ALL the spouses together.

children(p100116, 'Louise Bergman', 2).
children(p1002308, 'Atsuko Remar', 2).
children(p1003416, 'Genevieve Reno', 2).

---------
TitleName
---------
The name this title has.
The attribute is available for each title.

title_name(t101028, 'Cape and Cowl').
title_name(t101034, 'Cape Fear').
-----
Gross
-----
Gross on a given day up until given date.
130853 entries in the database.

gross(t101034, 8125975, 'AUD', 'Australia', '', '', 1992).
gross(t10201, 1010300000, 'ITL', 'Italy', '', '', 1983).
gross(t10201, 1362322, '?', 'UK', 26, march, 2000).
gross(t10201, 1675124, '?', 'UK', 2, april, 2000).

u'$175,400,000 (Worldwide) (15 August 1999) (except USA)',
u'DEM 50,400,000 (Germany)',
u'\u20ac 10,695,801 (Spain) (10 March 2003)',

-------
Spouses
-------
The names of the spouses and whether or not that person has an entry
in the IMDb database too. 104259 people have spouse info.

spouse(p2081292, 'Jim Simpson', true).
true: whether or not the person has an IMDb id too

This way in the database:
"'Susan Isaacs (II)' (qv) (11 August 1968 - present)"
"'Jennifer Abram' (15 October 1997 - present); 2 children"
"'Lynn Lempert' (20 January 2001 - 25 December 2010) (his death); 2 children"
"'Deborah O'Grady' (? - ?); 2 children"
"'?' (? - ?)"
"'Loni Ackerman' (qv) (? - ?)"
"'John Reid (XII)' (qv) (2002 - present)"
"'?' (? - present); 2 children"
"'Zélia Afonso' (? - 23 February 1987) (his death); 2 children"
"'Nicole Kidman' (qv) (24 December 1990 - 8 August 2001) (divorced); 2 (adopted) children"

Possible options for separation:
divorced
filed for divorce
annulled
separated
his death
her death
------------
ReleaseDates
------------
A title can have multiple release dates.

IMDbPY structure of its result:
Country:date::optional info -> 'Canada:September 2010'

Countries with the largest amount of release dates:
'USA', '763179'
'UK', '232519'
'Germany', '106889'
'France', '98756'
'Spain', '89275'

158 countries
2173855 entries in the database.

release_date(t100441, 'Italy', 1970, february, 4, '(Rome) (premiere)').
release_date(t100441, 'Italy', 1970, february, 5, '').
release_date(t100441, 'Japan', 1970, september, 5, '').
release_date(t10201, 'France', 2001, september, '', '(Deauville Film Festival)').

'USA:1 March 1936',
'Denmark:17 August 1936',
'Finland:28 February 1937',
'Portugal:29 March 1938',
'USA:27 March 1948::(re-release)'
------------
DeathCountry
------------
Country of death. 84119 entries
--------------
OpeningWeekend
--------------
Same as weekend gross, but only for the opening weekends.
15667 entries in the database.

opening_weekend(t103529, 181494, '$', 'USA', 12, april, 1992, 11).
opening_weekend(t103529, 34698, '?', 'UK', 9, july, 1992, 1).
opening_weekend(t103827, 34528, '$', 'USA', 19, december, 2010, 7).
--------
DeathDay
--------
The day of death of the Person. See death_year.
------------------
FilmNegativeFormat
------------------
OFM   Film negative format in mm or "Video" with an additional
attribute for the TV standard

film_negative_format(t33635, '35 mm', '').
film_negative_format(t102248, '35 mm', '(Eastman)').
film_negative_format(t102812, '16 mm', '').
film_negative_format(t116406, 'Video', '(PAL)').
film_negative_format(t117312, 'Video', '(HDTV)').
film_negative_format(t209047, 'Digital', '').

'OFM', '249530'
----------
Admissions
----------
The number of tickets that were actually sold at the box office in a
specific country as of the specified date. The figure is cumulative,
i.e., it represents all tickets that have been sold up to
and including that date.

admissions(t103816, 126427, '', 'Netherlands', 1, january, 1997).
admissions(t103816, 126540, '', 'Netherlands', 31, december, 1997).
admissions(t103816, 1364638, '', 'France', 16, april, 1996).
admissions(t103816, 181323, '', 'Portugal', 18, april, 1996).
admissions(t103816, 528921, '', 'Germany', 31, december, 1996).
admissions(t103816, 530204, '', 'Germany', 20, january, 1997).

'12,172 (Spain)'
'937,365 (Netherlands) (1950)'

29140 entries in the database.
----------
BirthMonth
----------
The month of birth of the Person. See birth_year.

birth_month(p100116, february).
birth_month(p1001358, may).
birth_month(p1002308, december).

----------------------
CinematographicProcess
----------------------
PCS   Cinematographic process or video system

cinematographic_process(t54904, 'CinemaScope', '').
cinematographic_process(t10201, 'Spherical', '').
cinematographic_process(t102248, 'Panavision', '(anamorphic)').
cinematographic_process(t106227, 'Digital Intermediate', '(2K) (master format)').

'PCS', '148588'
---------------
LastDivorceYear
---------------
Year of this persons last divorce/separation/death.

last_divorce_year(p1001122, 2008).
last_divorce_year(p1001156, 1979).
last_divorce_year(p1003416, 1995).
----------
DeathState
----------
State/province of death.
------------
BirthCountry
------------
Country of birth. 299548 entries.

country_of_birth(p1003290, 'USA').
country_of_birth(p1003338, 'UK').
country_of_birth(p1003416, 'French Protectorate of Morocco').

Data looks like this:
'Leningrad, USSR [now St. Petersburg, Russia]'
'British Guiana (now Guyana)'
'Dearborn, Michigan, USA'
'Brooklyn, New York City, New York, USA'
'Aubervilliers, Seine [now Seine-Saint-Denis], France'

Part after the last comma without the comments is used.
-------
Rentals
-------
1819 entries in the database.

rentals(t170702, 23840000, '$', 'Worldwide').
rentals(t170702, 6435000, '$', 'USA').

Country not always available.
'PTE 95,000 (Portugal)'
'$940,872 (USA)'

-------
Runtime
-------
The runtime of this title in minutes.
620330 entries in the database.

runtime(t100296, 115, '', '').
runtime(t100296, 99, 'Spain', '(DVD edition)').
runtime(t100441, 113, 'Portugal', '').
------------
Bottom10Rank
------------
Place of the movie on the bottom 10 list.
----------
FilmLength
----------
MET   Length of a film in meter

film_length(t33635, '300 m', '(1 reel)').
film_length(t103827, '2.978 m', '(Portugal, 35 mm)').
film_length(t103832, '3597.86 m', '').
film_length(t143065, '', '(10 reels)').
film_length(t579828, '3220 m', '(Finland) (1954)').

film_length(t590979, '4150 m', '(Sweden)').
film_length(t590979, '4230 m', '(Finland)').

'MET', '108500'

Film length is generally measured in feet (in the US) to where 2100 feet
of film roughly equals one hour of content.
-----------------
PrintedFilmFormat
-----------------
PFM   Printed film format in mm or "Video" with an additional
attribute for the TV standard

printed_film_format(t33635, '35 mm', '').
printed_film_format(t102812, '35 mm', '(blow-up)').
printed_film_format(t128032, 'HDTV', '').

'PFM', '245395'
--------------
ProductionDays
--------------
Amount of days the movie was in production.
14155 entries in the database.
Many of them aren't usable.
Will assume first of the month when no day is given.
See also FilmingDays.

Two dates from when the movie was in production.
'August 1896 - August 1896'
'17 March 1897 -'
'1893 - 1893'
'? - 21 May 1913'
"19 September 2010 - 10 January 2011 (EP Films)"

productiondays(t135368, 128).
productiondays(t135428, 162).
productiondays(t135492, 122).

It will only work when we have two valid dates.
----------
Top250Rank
----------
Position in the top 250 list.

TOP 250 MOVIES (3000+ VOTES)

The formula used to calculate the top 250 movies is:

weighted rank = (v/(v+k))*X + (k/(v+k))*C

where:

X = average for the movie (mean)
v = number of votes for the movie
k = minimum votes required to be listed in the top 250 (currently 3000)
C = the mean vote across the whole report (currently 6.90)

note: for this top 250, only votes from regular voters are considered.

top_250_rank(t10201, 56).
top_250_rank(t103529, 17).

----
Year
----
Release year of the title.
The attribute is available for most titles.

year(t100296, 1976).
year(t100441, 1968).