v5

Author: wilsonmar

README.md

@@ -141,9 +141,11 @@ Column "_Source"
 
    * https://cgit.freedesktop.org/xorg/app/rgb/tree/rgb.txt
 
-   * "duo" is noted for where there are two color names for the same color, 
-   such as "aqua" and "cyan"; "fuchia" and "magenta". 
-   The first of names alphabetically is returned.
+   * Pantone (proprietary).
+
+   * https://en.wikipedia.org/wiki/Crayola#Colors
+
+
 
 Column "_SVG" is used to designate names in SVG. Color numbers differs between SVG and X11 for
 "gray", "gray", "green", "maroon" and "purple".
@@ -152,21 +154,27 @@ SVG has "darkgray" while X11 does not.
 
    * "SVG" is from https://www.w3.org/TR/SVG/types.html#ColorKeywords
 
+   "diff" is in the column if it's different than X11.
 
-## Design alternatives #
+   * "duo" is noted for where there are two color names for the same color, 
+   such as "aqua" and "cyan"; "fuchia" and "magenta". 
+   The first of names alphabetically is returned.
 
-Additional columns may be added because there are other color names, such as:
+TOOL NOTE: To remove diacritical (Non-ASCII) characters from a file, consider:
+http://utils.paranoiaworks.org/diacriticsremover/
 
    * <a target="_blank" href="http://us.labelpartners.com/pantone_coated_table.html">Pantone</a> (proprietary).
 
-   * https://en.wikipedia.org/wiki/Crayola#Colors
+## Design alternatives #
+
+Add more color name sources (Sherwine Williams, etc.) - visit Home Depot
 
 The pandas library for Python
 http://pandas.pydata.org/
 
 http://pandas.pydata.org/pandas-docs/dev/generated/pandas.DataFrame.from_csv.html
 
-can load a Dataframe from the csv file.
+Load a Dataframe from the csv file.
 
 <pre>
 df = DataFrame.from_csv(rgb_combined.csv', sep='\t')
@@ -176,11 +184,12 @@ array = df.values # the array you are interested in
 Columns can be removed within the program using this call:
 
 <pre>
-# RGB= np.delete(A, np.s_[3:5], axis=1) # remove columns 3 to 5.
+ RGB= np.delete(A, np.s_[3:5], axis=1) # remove columns 3 to 5.
 </pre>
 
-# Based on https://algorithmia.com/algorithms/deeplearning/CaffeNet/edit
-# Consider https://github.com/spotify/annoy/ for sharing memory.
+Based on https://algorithmia.com/algorithms/deeplearning/CaffeNet/edit
+
+Consider https://github.com/spotify/annoy/ for sharing memory.
 
 
 ## Clean-up #

algorithmia.wilsonmar.rgb2colorname.desc.htm

@@ -0,0 +1,44 @@
+<p>This algorithm returns the name of the color that most closely matches the three numbers specifying a color (RGB).</p>
+<p>This API makes it easier for artists to identify color names so they have a way to use English words to describe colors.&nbsp;</p>
+<p style="color: rgb(85, 85, 85);background-color: rgb(255, 255, 255);"><span>This capability I also needed for a finger camera (IoT device) I'm working on which speaks the color name.</span><br></p>
+<h1><span style="color: inherit;"><b>Inputs and Outputs:</b></span><br></h1>
+<p>Colors are defined by 3 integers for RGB (Red Green Blue).&nbsp;<span>The program returns black if any number is larger than the 255 maximum value for each color.</span></p>
+<p>Additional information on colors is available on&nbsp;this author's decades of maniacal obsession with colors on computers at&nbsp;<a target="_blank" href="http://wilsonmar.com/1colors.htm" style="color: rgb(153, 99, 255);background-color: rgb(255, 255, 255);">http://wilsonmar.com/1colors.htm</a>.<br></p>
+<p><b>Example 1: SVG and X11</b><br></p>
+<h2><img src="https://cloud.githubusercontent.com/assets/300046/18149649/a88d4c6e-6f9e-11e6-9797-78618ae963f5.jpg"></h2>
+<pre><b>["221","184","137"]&nbsp;</b></pre>
+<p>is close to the color named "burlywood", a brownish color defined by the X11 standard.</p>
+<pre>{"burlywood",[222,184,135],"#DEB887","(+1,+0,-2)"}<br></pre>
+<p>"#DEB887" is the hex value used in CSS for display on <b>computer monitors</b>. Such colors may not be available in physical paint from a hardware store.</p>
+<p>"(+1,+0,+2)" is how far away the input color is from the named color returned.</p>
+<h3>Example 2: Pantone<br></h3>
+<pre><b>["123","163","217"]</b></pre>
+<p>is close to one of 1340 colors in the Pantone gamut output:</p>
+<pre><b>{"Pantone 659 C",[123,164,219],"#7BA4DB","(+0,+1,-2)"}</b></pre>
+<p>which is proprietary because of the work that went into figuring out what pigments paint stores need to mix to duplicate it accurately. For a fee, Pantone offers tools pros use to specify and measure a wide number of colors, such as <a target="_blank" href="https://www.visualnews.com/2016/06/15/worlds-ugliest-color)">"the world's ugliest color"</a> Pantone 448 C at ["74","65",42"]</p>
+<h3>Example 3: Company<br></h3>
+<pre><b>["0","119","181"]</b></pre>
+<p>is close to one of 29 corporate colors the algorithm can output:</p>
+<pre><b>{"Company LinkedIn blue",[0,119,181],"#0077B5","(+0,+0,+0)"}</b></pre>
+<p>The "(+0,+0,+0)" reflects a direct hit.<br></p>
+<h2>Credits:</h2>
+<p>The bulk of the work on this is to reconcile duplicate colors and color names from a variety of sources.&nbsp;</p>
+<ul>
+	<li>The X11 and SVG standards were created to name colors that can best be displayed by display monitor hardware with minimal processing (at a time when displays had a smaller gamut than today).&nbsp;</li>
+	<li>19 "Metro" colors are defined by Microsoft for Windows 8 from&nbsp;https://www.materialui.co/metrocolors</li>
+	<li>18 Material Flat colors from&nbsp;<a target="_blank" href="https://www.materialui.co/flatuicolors" style="color: rgb(153, 99, 255);text-align: left;background-color: rgb(255, 255, 255);">https://www.materialui.co/flatuicolors</a></li>
+	<li> 29 Company colors from&nbsp;https://www.materialui.co/socialcolors</li>
+	<li>Pantone colors from&nbsp;http://us.labelpartners.com/pantone_coated_table.html</li>
+	<li>US Federal Standard 595 from&nbsp;http://www.fed-std-595.com/FS-595-Paint-Spec.html</li>
+</ul>
+<p><span>Thanks to Ayush Pareek for his Python numpy genius.</span><br></p>
+<h2>Future enhancements:</h2>
+<ul>
+	<li><p style="color: rgb(85, 85, 85);background-color: rgb(255, 255, 255);">Future uses of this API can identify colors that are printable on specific printers. Inclusion of additional color names will make this more useful to specify colors more accurately throughout the design lifecycle.</p></li>
+	<li><span>Process JSON from another Algorithmia API as&nbsp;</span><span>part of a toolchain such as a follow-up to identification of predominant colors identified in a photograph by the&nbsp;<a href="https://github.com/fengsp/color-thief-py" style="color: rgb(153, 99, 255);background-color: rgb(255, 255, 255);">https://github.com/fengsp/color-thief-py</a>&nbsp;library</span></li>
+	<li style="color: rgb(85, 85, 85);background-color: rgb(255, 255, 255);"><span>filter to respond only from specific gamuts (X11, SVG, Pantone)</span></li>
+	<li><span>accept a wider range of input formats, such as "(0,175,219)"</span></li>
+	<li><span>return a number of colors in the database</span></li>
+	<li><span>input and return HCL color numbers (a different API)</span></li>
+	<li><span>An app that reports the name of the color at the location tapped on a photo</span></li>
+</ul>

algorithmia_RGB2ColorName.py

@@ -0,0 +1,9 @@
+Google Red,#D62D20,214,45,32
+Google Green,#008744,0,135,68
+Google Blue,#0057E7,0,87,231
+Google Orange,#FFA700,255,167,0
+Amazon Red,#F84603,248,70,3
+Amazon Organge,#FF9616,255,150,22
+Amazon Yeallow,#FFCB00,255,203,0
+Amazon Blue,#003BB2,0,59,178
+Amazon Turquoise,#00FFDC,0,255,220

algorithmia_RGB2ColorName_v02.py

@@ -1171,7 +1171,9 @@
 
 # TODO: Test calls using variety of RGB input values
 # TODO: Change to call argument with the point to find
-pt = [221,183,134] # approximate to
+# pt = [221,183,134] # approximate to
+#pt = [0,0,0] # example needing zerofill
+pt = [221,182,137] # = "burlywood","#DEB887"] 
 # pt = [222,184,135] # = "burlywood","#DEB887"] 
 # pt = [154,205,50] # = OliveDrab 
 
@@ -1181,14 +1183,22 @@
 # TODO: Calculate Hex from pt. (upper case letters)
 # Instead of str(hex(pt[0])[2:]) in Python2, this is Python3 compatible:
 s = '#' \
-    + format(NearestRGB[0],'x') \
-    + format(NearestRGB[1],'x') \
-    + format(NearestRGB[2],'x')
+    + format(NearestRGB[0],'x').zfill(2) \
+    + format(NearestRGB[1],'x').zfill(2) \
+    + format(NearestRGB[2],'x').zfill(2)
 ColorHex = s.upper() # "#8B7355"  # "#8B7355" 
-ColorDiff = '('+ str(pt[0]-NearestRGB[0])+','+str(pt[1]-NearestRGB[1])+','+str(pt[1]-NearestRGB[2])+')'
+ColorDiff = \
+     '('+'{0:+d}'.format(NearestRGB[0]-pt[0]) \
+    +','+'{0:+d}'.format(NearestRGB[1]-pt[1]) \
+    +','+'{0:+d}'.format(NearestRGB[2]-pt[2]) \
+    +')'
+try: ## TODO: try catch block per https://wiki.python.org/moin/HandlingExceptions
+    ColorName=HexNameDict[ColorHex]
+except:
+	ColorName="not found"
 print 'Nearest color name to input RGB ' \
     + str(pt) \
-    + ' is "'+ HexNameDict[ColorHex] +'"' \
+    + ' is "'+ ColorName +'"' \
     +' '+ ColorHex  \
     +' '+ str(NearestRGB) \
     +', '+ ColorDiff \

algorithmia_RGB2ColorName_v03.py

@@ -25,18 +25,18 @@ def program(*args):
    except IndexError: # getopt.GetoptError:
       # print "Usage: " + sys.argv[0] + ' -i <inputfile> -o <outputfile>'
       # sys.exit(2)
-      file_in = 'rgb_combined_v02.csv'
+      file_in = 'rgb_combined_v03.csv'
 
 # Exit if file_in not found:
 if os.path.exists(file_in) and os.access(file_in, os.R_OK):
     import csv, time
     with open(file_in, 'rU') as f:
         reader = csv.reader(f, delimiter=',')
         for i in reader:
-            header_rows = '# '+time.strftime('%Y-%m-%d-%H:%M (local time)')+" "+sys.argv[0]+' START: inrowcount='+ str( sum(1 for _ in f) ) +'.'
+            header_rows = '# '+time.strftime('%Y-%m-%d %H:%M (local time)')+" "+sys.argv[0]+' START: inrowcount='+ str( sum(1 for _ in f) ) +'.'
             print(header_rows)
 else:
-    print('# '+time.strftime('%Y-%m-%d-%H:%M (local time)')+' '+sys.argv[0]+" ABORTED. Either file "+file_in+" is missing or is not readable.")
+    print('# '+time.strftime('%Y-%m-%d %H:%M (local time)')+' '+sys.argv[0]+" ABORTED. Either file "+file_in+" is missing or is not readable.")
     exit(2)
 
 # Provide default file_out name argument if not provided:
@@ -81,13 +81,12 @@ def program(*args):
           rownum=rownum+1
     print("}") # end with NewLine
 
-footer_rows="# "+ time.strftime('%Y-%m-%d-%H:%M (local time)') +' '+ sys.argv[0] +" Output "+ str(rownum)+ ' rows.'
-print(footer_rows)
+footer_row1="# "+ time.strftime('%Y-%m-%d %H:%M (local time)') +' '+ sys.argv[0] +' '+ file_out +" output "+ str(rownum)+ ' rows.'
+print("    "+footer_row1)
 # Close the file every time:
 sys.stdout.close()
 
 sys.stdout = stdout # Restore regular stdout.
-# End timer:
-elapsed = timeit.default_timer() - start_time
-print("# "+ time.strftime('%Y-%m-%d-%H:%M (local time)') +' '+ sys.argv[0] +" END: ran for "+ "{:.2f}".format(elapsed * 1000 )+ ' secs.')
-print(footer_rows)
+print(footer_row1)
+elapsed = timeit.default_timer() - start_time # End timer:
+print("# "+ time.strftime('%Y-%m-%d %H:%M (local time)') +' '+ sys.argv[0] +" END: ran for "+ "{:.2f}".format(elapsed * 1000 )+ ' secs.')

algorithmia_RGB2ColorName_v05.py

@@ -1,5 +1,5 @@
 #!/usr/bin/env python
-# rgbcvs2colorarray.py
+# rgbcvs2rgbarray.py
 # by [email protected]
 # Usage: rgbcvs2colorarray.py  rgb_combined.csv
 # Oputput: A = array([[222,43,221],[2,11,222], ... ])
@@ -24,7 +24,7 @@ def program(*args):
    except IndexError: # getopt.GetoptError:
       # print "Usage: " + sys.argv[0] + ' -i <inputfile> -o <outputfile>'
       # sys.exit(2)
-      file_in = 'rgb_combined_v02.csv'
+      file_in = 'rgb_combined_v05.csv'
 
 # Exit if file_in not found:
 if os.path.exists(file_in) and os.access(file_in, os.R_OK):
@@ -39,20 +39,18 @@ def program(*args):
     exit(2)
 
 # Provide default file_out name argument if not provided:
-if __name__ == "__main__":
-#def main(argv):
+if __name__ == "__main__": #def main(argv):
+   # Name output file by appending .txt to the name:
    try:
       arg1 = sys.argv[2]
-      file_out = sys.argv[2]
+      file_out = sys.argv[2] +'.'+ file_in + '.txt'
    except IndexError: # getopt.GetoptError:
-   	  # Name output file by appending .txt to the name:
       file_out = file_in + '.txt'
 
 # Send STDOUT to a file:
 stdout = sys.stdout  # remember the handle to the real standard output.
 sys.stdout=open( file_out,"w")
 
-
 # Print in yml format:
 import csv
 # 'rU' means open in universal-newline mode needed on Macs:
@@ -82,7 +80,7 @@ def program(*args):
           rownum=rownum+1
     print("])") # with NewLine
 
-footer_rows="# "+ time.strftime('%Y-%m-%d-%H:%M (local time)') +' '+ sys.argv[0] +" Output "+ str(rownum)+ ' rows.'
+footer_rows="    # "+ time.strftime('%Y-%m-%d-%H:%M (local time)') +' '+ sys.argv[0] +" Output "+ str(rownum)+ ' rows.'
 print(footer_rows)
 # Close the file every time:
 sys.stdout.close()
@@ -91,4 +89,4 @@ def program(*args):
 # End timer:
 elapsed = timeit.default_timer() - start_time
 print("# "+ time.strftime('%Y-%m-%d-%H:%M (local time)') +' '+ sys.argv[0] +" END: ran for "+ "{:.2f}".format(elapsed * 1000 )+ ' secs.')
-print(footer_rows)
+print('    '+footer_rows)