Skip to main content

A minimal ply conversion tools

Project description

About ply_convert

ply_convert is a command line tool to manipulae ply meshes 

Developed by Serge Dmitrieff.


Installing with pip3 (recommended)

$ pip3 install ply_convert

Required packages

ply_convert requires Sklearn, Numpy, plyfile, and sio_tools. They will be downloaded when installed with pip3.




Options are to be written as opt=value or -option  
Unless mentioned otherwise, options are not applied by default  

Supported options :  
    out=            : name of output file (single file job) // extension of output file (multiple files)  
    scale=          : scale to be applied to points (float or 3x1 vector)  
    length=         : length of object on dimension of maximal variance  
    thickness=      : adds to each point a vector thickness*normal  
    batch=          : apply to all files of a certain type  
    path=           : path in which to look for files for batch operation  
    label=          : label of mesh, added when saving mesh files  
    orientation=    : orientation of normals (+1 : towards outside, -1 : towards inside)  
    prefix=         : add a prefix to output file name (multiple files)  
    suffix=         : add a suffix to output file name (multiple files)  
    -center         : center the data around [0,0,0]  
    -align          : aligns data to dimension x  
    -normals        : computes normals from faces  
    -verbose        : verbose output  
    -fixnorms       : makes sure normals are inwards (equivalent to option orientation=-1)  
    -fixuint        : fixes format to meshlab-friendly  

    batch=          : extension of files to process in batch (support multiple)  
    ** batch only **  
    path=            : folder in which to look for files (support multiple)  
    include=         : string that *must* be included in file name (support multiple)  
    exclude=         : string that *must not* be included in file name (support multiple)  
    -recursive       : searches recursively for files  


            ply_convert file.ply out=file.mesh  

converts a ply file file.ply to a mesh file file.mesh

   file.mesh normals=1 out=file.ply  

converts a mesh file to a ply file, and computes the normal at each point

            ply_convert file_1.ply file_2.ply file_3.ply out=.mesh  

converts file_1.ply file_2.ply file_3.ply into mesh files

            ply_convert file.ply -center -align -normals length=7 -verbose thickness=0.15 scale='1.0 1.0 2.0'
                                verbose=1 out=thickened.mesh out=thickened.ply  

converts a ply file to a ply and a mesh file after centering, aligning, computing normals, scaling the object to a length of 7, and adding an extra thickness of 0.15, then scaling the z axis with a factor 2

   batch=.ply path='/home/user/simulations/' out='.ply' scale=0.1 -recursive prefix=scaled_   

Recursively find ply files in '/home/user/simulations/', scales them to a factor of 0.1, and saves them to FOLDER/suffix_NAME.ply with NAME the filename and FOLDER the folder name

   file.ply out=fixed_file.ply -fixuint  

fixes the header of a mesh file saved by tinyply (C++) so that it doesn't crash with meshlab.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for ply-convert, version 0.0.3
Filename, size File type Python version Upload date Hashes
Filename, size ply_convert-0.0.3.tar.gz (26.6 kB) File type Source Python version None Upload date Hashes View
Filename, size ply_convert-0.0.3-py3-none-any.whl (42.7 kB) File type Wheel Python version py3 Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Huawei Huawei PSF Sponsor Microsoft Microsoft PSF Sponsor NVIDIA NVIDIA PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page