Humdrum Extras - Revision history

Craig: /* Random melody generator */

2020-05-19T20:17:55Z

Random melody generator

← Older revision		Revision as of 20:17, 19 May 2020
Line 2,528:		Line 2,528:
	#include <time.h> /* for time(NULL) function */		#include <time.h> /* for time(NULL) function */

	~~#ifndef OLDCPP~~		using namespace std;
	~~#define SSTREAM stringstream~~
	~~#define CSTRING str().c_str()~~
	using namespace std;
	~~#else~~
	~~#ifdef VISUAL~~
	~~#include <strstrea.h>~~
	~~#else~~
	~~#include <strstream.h>~~
	~~#endif~~
	~~#define SSTREAM strstream~~
	~~#define CSTRING str()~~
	~~#endif~~

	void getRandomMelody(HumdrumFile& datafile, int notecount, int seed) {		void getRandomMelody(HumdrumFile& datafile, int notecount, int seed) {
	~~SSTREAM~~ output;		stringstream output;
	output << "!!!seed:\t" << seed << endl;		output << "!!!seed:\t" << seed << endl;
	output << "**kern\n";		output << "**kern\n";
Line 2,556:		Line 2,544:
	output << ends;		output << ends;
	// It is possible to print to ostream:		// It is possible to print to ostream:
	// cout << output.~~CSTRING~~ << flush;		// cout << output.str().c_str() << flush;
	datafile.read(output);		datafile.read(output);
	}		}

Craig: /* humecho3.cpp (Accessing spine data) */

2015-04-21T17:49:58Z

humecho3.cpp (Accessing spine data)

← Older revision		Revision as of 17:49, 21 April 2015
Line 156:		Line 156:
	#include "humdrum.h"		#include "humdrum.h"
	using namespace std;		using namespace std;

	int main(int argc, char** argv) {		int main(int argc, char** argv) {
	HumdrumFile hfile;		HumdrumFile hfile;
Line 162:		Line 162:
	else { hfile.read(cin); }		else { hfile.read(cin); }
	for (int i=0; i<hfile.getNumLines(); i++) {		for (int i=0; i<hfile.getNumLines(); i++) {
	~~std::~~cout ~~<< "\t"~~ << hfile[i][0];		cout << hfile[i][0];
	for (int j=1; j<hfile[i].getFieldCount(); j++) {		for (int j=1; j<hfile[i].getFieldCount(); j++) {
	cout << "\t" << hfile[i][j] ~~<< endl~~;		cout << "\t" << hfile[i][j];
	}		}
	~~std::~~cout << ~~std::~~endl;		cout << endl;
	}		}
	return 0;		return 0;

Craig at 17:41, 21 April 2015

2015-04-21T17:41:38Z

← Older revision		Revision as of 17:41, 21 April 2015
Line 13:		Line 13:
	Humdrum Extras is most conveniently downloaded and updated using the [http://en.wikipedia.org/wiki/Git_(software) git] command (or an interface program which uses git). Type 'which git' in a terminal to see if it is installed. In linux it should be easy to install with either 'sudu apt-get install git' or 'sudo yum install git', depending on your flavor of linux. In OS X, [http://brew.sh Homebrew] is the most convenient unix package manager. If you install that, then it installs git at the same time.		Humdrum Extras is most conveniently downloaded and updated using the [http://en.wikipedia.org/wiki/Git_(software) git] command (or an interface program which uses git). Type 'which git' in a terminal to see if it is installed. In linux it should be easy to install with either 'sudu apt-get install git' or 'sudo yum install git', depending on your flavor of linux. In OS X, [http://brew.sh Homebrew] is the most convenient unix package manager. If you install that, then it installs git at the same time.

	If you have the <tt>git</tt> program installed on your computer, then you can use that system to download [http://github.com/craigsapp/humextra humextra] from GitHub ~~with~~ this terminal ~~command~~:		If you have the <tt>git</tt> program installed on your computer, then you can use that system to download [http://github.com/craigsapp/humextra humextra] from GitHub; otherwise, download the [http://github.com/craigsapp/humextra/archive/master.zip zip file] and unzip it. When using git, type this command in the terminal:
	git clone https://github.com/craigsapp/humextra		git clone https://github.com/craigsapp/humextra
	To compile the library and example programs:		To compile the library and example programs:

Craig: convert langauge="humdrum" to language="text" to avoid problem with syntax highlighting in mediawiki upgrade.

2015-04-16T08:45:40Z

convert langauge="humdrum" to language="text" to avoid problem with syntax highlighting in mediawiki upgrade.

Show changes

Craig: /* Using the Humextras Library */

2015-04-16T07:05:08Z

Using the Humextras Library

← Older revision		Revision as of 07:05, 16 April 2015
Line 51:		Line 51:
	== Using the Humextras Library ==		== Using the Humextras Library ==

	You can place your source code in the Humdrum Extras source code, but this will cause problem when updating, or possible accidental deletion. Instead, it may be wise to create a parallel directory with symbolic links to the important components.		You can place your source code directly into the Humdrum Extras source-code directory, but this will cause problem when updating with git, or possible accidental deletion. Instead, it may be wise to create a parallel directory structure with symbolic links to the important components of the main humextra installation.

	Go to the ~~parent~~ directory ~~of humdrum-tools (or~~ humextra ~~if installed by itself)~~. ~~Then create~~ a ~~project directory and create symbolic links~~ to ~~the necessary files~~:		Here is a short bash shell script to create a linked installation of humextra in the current directory, provided that humextra can be found in the command path. Copy and paste into a terminal to set up a linked copy of humextra:

	~~cd humdrum~~-~~tools~~		HUMDIR=`echo $PATH \| tr : '\n' \| grep humextra \| head -n 1 \| sed 's/\/bin$//'`
	cd ..		if <nowiki>[[</nowiki> -z $HUMDIR <nowiki>]]</nowiki>
	mkdir myhum		then
	cd myhum		echo "Humdrum Extras not found in PATH variable: not creating linked installation."
	ln -s ~~../humdrum-tools/humextra~~/include .		else
	ln -s ~~../humdrum-tools/humextra~~/external .		echo "Creating myhum directory, linked to $HUMDIR."
	ln -s ~~../humdrum-tools/humextra~~/lib .		mkdir myhum
	ln -s ~~../humdrum-tools/humextra~~/bin .		cd myhum
	ln -s ~~../humdrum-tools/humextra~~/Makefile .		ln -s $HUMDIR/include .
	ln -s ~~../humdrum-tools/humextra~~/Makefile.programs .		ln -s $HUMDIR/external .
	mkdir src-programs		ln -s $HUMDIR/lib .
			ln -s $HUMDIR/bin .
			ln -s $HUMDIR/Makefile .
			ln -s $HUMDIR/Makefile.programs .
			mkdir src-programs
			fi

	You should then be able to place your code in myhum/src-programs, such as myprog.cpp, then compile them within the myhum directory with the command:		You should then be able to place your code in myhum/src-programs, such as myprog.cpp, then compile them within the myhum directory with the following command in the myhum directory:
	make myprog		make myprog
	where "src-programs/myprog.cpp" is the source code. This will create an executable in the bin directory: "bin/myprog". You can run it with the command "bin/myprog" or just "myprog" if the Humdrum Extras bin directory is in the $PATH environment variable.		where "src-programs/myprog.cpp" is the source code. This will create an executable in the bin directory: "bin/myprog". You can run it with the command "bin/myprog" or just "myprog" if the Humdrum Extras bin directory is in the $PATH environment variable.

Craig: /* Using the Humextras Library */

2015-04-15T20:06:22Z

Using the Humextras Library

← Older revision		Revision as of 20:06, 15 April 2015
Line 67:		Line 67:
	mkdir src-programs		mkdir src-programs

	You should then be able to place your code in myhum/src-programs, then compile them within the myhum directory with the command:		You should then be able to place your code in myhum/src-programs, such as myprog.cpp, then compile them within the myhum directory with the command:
	make myprog		make myprog
	where "src-programs/myprog.cpp" is the source code. This will create an executable in the bin directory: "bin/myprog". You can run it with the command "bin/myprog" or just "myprog" if the Humdrum Extras bin directory is in the $PATH environment variable.		where "src-programs/myprog.cpp" is the source code. This will create an executable in the bin directory: "bin/myprog". You can run it with the command "bin/myprog" or just "myprog" if the Humdrum Extras bin directory is in the $PATH environment variable.

Craig: /* Example Programs */

2015-04-15T19:33:39Z

Example Programs

← Older revision		Revision as of 19:33, 15 April 2015
Line 4:		Line 4:
	= Example Programs =		= Example Programs =

	The primary intent of the Humdrum Extras package is for user-based processing of Humdrum files as an auxiliary to the [[Humdrum Toolkit]]. Since the programs are compiled from C++ code, they process data much faster than programs written in interpreted languages, such as [http://en.wikipedia.org/wiki/AWK AWK] which is the main development language for the Humdrum Toolkit.		The primary intent of the Humdrum Extras package is for user-based processing of Humdrum files as an auxiliary to the [https://github.com/humdrum-tools/humdrum-tools Humdrum Toolkit]. Since the programs are compiled from C++ code, they process data much faster than programs written in interpreted languages, such as [http://en.wikipedia.org/wiki/AWK AWK] which is the main development language for the Humdrum Toolkit.

	Documentation for example programs can be found on the web at [http://extras.humdrum.org/man extras.humdrum.org/man]. The source code for these programs is found in this [http://github.com/craigsapp/humextra/archive/master.zip zip file], within the <tt>src-programs</tt> directory, or they can be viewed [http://github.com/craigsapp/humextra/tree/master/src-programs online].		Documentation for example programs can be found on the web at [http://extras.humdrum.org/man extras.humdrum.org/man]. The source code for these programs is found in this [http://github.com/craigsapp/humextra/archive/master.zip zip file], within the <tt>src-programs</tt> directory, or they can be viewed [http://github.com/craigsapp/humextra/tree/master/src-programs online].

Craig: /* Installing Humdrum Extras (only) */

2015-04-15T19:31:48Z

Installing Humdrum Extras (only)

← Older revision		Revision as of 19:31, 15 April 2015
Line 10:		Line 10:

	== Installing Humdrum Extras (only) ==		== Installing Humdrum Extras (only) ==

			Humdrum Extras is most conveniently downloaded and updated using the [http://en.wikipedia.org/wiki/Git_(software) git] command (or an interface program which uses git). Type 'which git' in a terminal to see if it is installed. In linux it should be easy to install with either 'sudu apt-get install git' or 'sudo yum install git', depending on your flavor of linux. In OS X, [http://brew.sh Homebrew] is the most convenient unix package manager. If you install that, then it installs git at the same time.

	If you have the <tt>git</tt> program installed on your computer, then you can use that system to download [http://github.com/craigsapp/humextra humextra] from GitHub with this terminal command:		If you have the <tt>git</tt> program installed on your computer, then you can use that system to download [http://github.com/craigsapp/humextra humextra] from GitHub with this terminal command:
Line 21:		Line 23:
	To periodically receive updates, go into the humextra directory, and type:		To periodically receive updates, go into the humextra directory, and type:
	git pull		git pull
	make clean # optional		make clean # optional, but a good idea
	make		make

	This will download the most recent changes in the library source code and recompile the library and example programs. To update only the library file without recompiling the example programs:		This will download the most recent changes in the library source code and recompile the library and example programs. To update only the library file without recompiling the example programs:
	make libupdate		make libupdate


	== Installing Humdrum Tools (which includes Humdrum Extras) ==		== Installing Humdrum Tools (which includes Humdrum Extras) ==

Craig: /* Using the Humextras Library */

2015-04-08T20:09:12Z

Using the Humextras Library

← Older revision		Revision as of 20:09, 8 April 2015
Line 59:		Line 59:
	cd myhum		cd myhum
	ln -s ../humdrum-tools/humextra/include .		ln -s ../humdrum-tools/humextra/include .
			ln -s ../humdrum-tools/humextra/external .
	ln -s ../humdrum-tools/humextra/lib .		ln -s ../humdrum-tools/humextra/lib .
	ln -s ../humdrum-tools/humextra/bin .		ln -s ../humdrum-tools/humextra/bin .

Craig: /* Example Programs */

2015-04-08T19:57:09Z

Example Programs

@@ Line 8: / Line 8: @@
 Documentation for example programs can be found on the web at [http://extras.humdrum.org/man extras.humdrum.org/man].  The source code for these programs is found in this [http://github.com/craigsapp/humextra/archive/master.zip zip file], within the <tt>src-programs</tt> directory, or they can be viewed [http://github.com/craigsapp/humextra/tree/master/src-programs online].
-If you have the <tt>git</tt> program installed on your computer (or related software), then you can use that system to download [http://github.com/craigsapp/humextra humextra] from GitHub:
        git clone https://github.com/craigsapp/humextra
 To compile the library and example programs:
@@ Line 16: / Line 19: @@
        make library
-You can place your program source code into humextra/src-programs and then in the humextra directory, type:
+To periodically receive updates, go into the humextra directory, and type:
      git pull
-     make update
+     make clean # optional
 This will download the most recent changes in the library source code and recompile the library and example programs.   To update only the library file without recompiling the example programs:
      make libupdate
 <br><br><br>
 = Programming Examples =